Skip to content

Aftergraph Knowledge Plane v1.0.0

Choose a tag to compare

@JonasAbde JonasAbde released this 07 Sep 01:51
· 74 commits to main since this release

Aftergraph Knowledge Plane v1.0.0 — production release

Live: https://docs.aftergraph.org

First tagged production release. A compiler/rendering/discovery layer over
canonical Aftergraph sources — repositories own truth, governance owns
boundaries, evidence owns claim strength. The plane resolves and renders;
it owns no truth.

What ships

Human surface (28 pages)

  • Quickstart: verify the plane itself in 10 minutes (dogfood loop)
  • Tutorials: trace a claim to its registry commit byte-for-byte; consume the plane via MCP
  • How-to guides: freshness verification, explicit source adoption, MCP wiring, context packs, adding canonical sources
  • Reference: 31 contract edges, C-001..C-008 claim register (verbatim audit statuses incl. STUDY-011 live reversals), glossary
  • Explanation: the four clocks, compiler-not-owner, two-status projection
  • Trust and Verification: 9 mechanical gates, what the plane will not do
  • API reference (Scalar, from canonical OpenAPI), FAQ, Troubleshooting, Contributing, Changelog, Brand

Machine surfaces

  • llms.txt + 5 scoped agent indexes (with freshness boundary)
  • 27 ACC-shaped context packs (/context/, ADR-005)
  • /status.json, /source-state.json, /build-manifest.json
  • Read-only Docs MCP: 7 tools, stdio, build-bounded answers

Verification machinery

  • 9 build gates + CRLF/private-leakage scan + 14-route production smoke
  • Every page provenance-bound to owner repo@full-SHA
  • Freshness policy (ADR-004): repository churn is not semantic drift; UNKNOWN never counts as CURRENT
  • Scheduled verifier (6h): append-only history, immutable artifacts, auto-report adoption issues, never auto-pins
  • Claims render registry-verbatim; projection can only weaken, never upgrade

Verification state at release

  • CI: green on main (all gates + production smoke)
  • Freshness: 8/9 CURRENT, 1 SOURCE_MOVED_CONTENT_UNCHANGED (benign churn), 0 semantic drift, 0 stale
  • Production smoke: 14/14 routes passing

Verify it yourself

git clone https://github.com/Aftergraph/docs && cd docs && npm ci
npm run build && node scripts/smoke.mjs http://localhost:4321