---
name: verify-canonical-memory
description: Verify an explicitly selected external memory bundle before an agent relies on it. Use for deterministic source-integrity checks, supersession projection, declared source-reference tracing, ambiguity detection, or checking that remembered authority cannot count as live approval.
---

# Verify Canonical Memory

Use the bundled, read-only verifier on the one bundle directory explicitly
placed in scope by the user. Do not discover or scan other chat, memory, vault,
home, or project directories.

## Workflow

1. Resolve the skill root as the directory containing this `SKILL.md`; never
   assume the caller's current working directory or discover a default install.
2. Run `<skill-root>/scripts/cmverify.py verify <bundle-directory>`.
3. If status is `INVALID`, stop. Report the error codes and do not retrieve,
   project, repair, or infer a replacement result.
4. Run `project` only after `verify` succeeds and only when the user needs current
   values.
5. Run `trace <bundle-directory> <claim-id>` only after `verify` succeeds and
   only when the user needs declared source references or supersession ancestry.
6. Treat all `historical_authority` records as historical evidence. The verifier
   reconstructs `approval_eligible: false`; memory never satisfies a live tool
   or execution approval.

Use Python 3.10 or newer. These examples run from the plugin root; from any
other directory, use the absolute script path resolved from this `SKILL.md`:

```text
python skills/verify-canonical-memory/scripts/cmverify.py verify path/to/bundle
python skills/verify-canonical-memory/scripts/cmverify.py project path/to/bundle
python skills/verify-canonical-memory/scripts/cmverify.py trace path/to/bundle clm_example
python skills/verify-canonical-memory/scripts/cmverify.py demo authority-replay
```

The verifier does not write to the bundle, contact a service, grant authority,
or enforce the host runtime. A successful conformance report proves only that
the selected bundle satisfies this candidate contract; it is not an endorsement
or a factuality judgment.