Skip to main content

Verify

Transaction audit trail for agentic commerce. Protocol conformance testing, Evidence Packs, and revenue attribution.

TL;DR: Run colter verify https://your-store.com --out ./evidence to execute conformance checks and generate an Evidence Pack. Use colter pack, colter replay, and colter diff when you only need pack creation, replay, or comparison.

Verify output is structured for agents, CI, and audit pipelines. The pack is the source of truth; the prose summary is secondary.

What Verify Covers

  • protocol discovery
  • schema validation
  • conformance checks
  • Evidence Pack generation

Install

npm install -g @getcolter/cli
colter --version

Run Verification

colter verify https://example-store.com --out ./evidence

Common Flags

FlagPurpose
--out DIRPack output directory
--protocols LISTRestrict to selected protocols
--schema-acp PATHOverride ACP schema
--schema-ucp PATHOverride UCP schema
--tests DIRCustom YAML tests
--batch FILEBatch verification
--concurrency NParallel verification count
--jsonMachine-readable result
--api-url URLOverride API base URL
-v, --verboseShow probed URLs

Create a pack without the full suite:

colter pack https://example-store.com --out ./evidence

Replay a pack:

colter replay ./evidence --json

Compare two packs:

colter diff ./pack-before ./pack-after --json

Verdicts

VerdictMeaning
AGENT-READYUCP and ACP both detected
PARTIALLY AGENT-READYOne protocol detected
NOT AGENT-READYNeither protocol detected

CI Example

steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-node@v4
    with:
      node-version: "20"
  - run: npm install -g @getcolter/cli
  - run: colter verify ${{ secrets.STORE_URL }} --out evidence --json > verification-result.json

Audit Trail

The hosted Verify add-on builds transaction audit records from Lens session and revenue data. CLI verification and hosted audit reporting are related, but the CLI pack is the portable artifact you can store, diff, and replay.

Next Steps