This guide walks you through generating a compliance report and submitting it to the public certification registry.

Compliance Tiers

Tier Scope Pass Rate Badge

Bronze

Schema + short-term memory

100%

agent—​memory—​tck Bronze F97316?logo=neo4j

Silver

Bronze + long-term + reasoning memory

100% Bronze, 100% Silver

agent—​memory—​tck Silver 22C55E?logo=neo4j

Gold

Silver + cross-memory + multi-agent

100% Bronze, 100% Silver, 80% Gold

agent—​memory—​tck Gold 6366F1?logo=neo4j
Note
 Bronze and Silver require 100% pass rate. Gold allows 80% because some Gold scenarios test optional SHOULD behaviors.

Step 1: Run the Test Suite

# Run all tiers and generate JSON output
uv run pytest \
  --json-report --json-report-file=results.json \
  -v

For cross-language implementations, use the bridge:

uv run pytest \
  --json-report --json-report-file=results.json \
  --bridge-url http://localhost:3001 \
  -v

Step 2: Generate the Compliance Report

uv run tck results.json \
  --name "My Implementation" \
  --version "1.0.0" \
  --output compliance-report.json \
  --html compliance-report.html

The report includes:

  • Per-tier pass/fail/skip counts and pass rates

  • Achieved tier (highest tier where all requirements are met)

  • Individual test results with SPEC clause references

Step 3: Submit to the Registry

  1. Fork the neo4j-labs/agent-memory-tck repository.

  2. Copy your compliance-report.json to certifications/submissions/your-implementation-name.json.

  3. Open a pull request with:

    • Your compliance report JSON

    • A brief description of your implementation (language, framework, target environment)

    • The tier you are claiming

A Neo4j Labs maintainer will review the report and, if valid, add an entry to certifications/registry.json.

Registry Entry Format

{
  "name": "My Implementation",
  "version": "1.0.0",
  "language": "TypeScript",
  "tier": "bronze",
  "tck_version": "1.0.0",
  "report_url": "certifications/submissions/my-implementation.json",
  "repository": "https://github.com/org/repo",
  "certified_at": "2026-03-29T00:00:00Z"
}

Maintaining Certification

  • Certification is tied to a specific TCK version.

  • When a new TCK version is released, re-run the suite and resubmit.

  • If your pass rate drops below the tier threshold after a TCK update, your registry entry will be flagged until updated.

See Also