Skip to content
AftergraphPublic

About

Aftergraph Knowledge Plane — public developer & research portal. Provenance-stamped docs, contracts, claims + agent surfaces. Live: https://docs.aftergraph.org

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Aftergraph Knowledge Plane (Aftergraph/docs)

Live: docs.aftergraph.org

Public developer & research portal — a compiler/rendering/discovery layer, not an owner. Repositories own truth, after-graph-governance owns boundaries, evidence owns claim strength. This repo pins exact SHAs, renders with provenance + freshness, and fails the build on private-source leakage.

What's inside

  • Human surface: Quickstart, Tutorials, How-to guides, Reference (contracts/claims/glossary), Explanation, API reference (Scalar from canonical OpenAPI), Trust & Verification, FAQ, Troubleshooting, Contributing, Changelog, Brand.
  • Machine surfaces: llms.txt + scoped indexes, 27 ACC-shaped context packs (/context/), /status.json, /source-state.json, /build-manifest.json, and a read-only stdio Docs MCP (7 tools).
  • Verification: every page carries provenance (owner repo@full-SHA + semantic version + evidence cut); freshness distinguishes repository churn from semantic drift (ADR-004); claims render registry-verbatim, never reinterpreted.

Gates (build fails on any violation)

npm run build runs all nine: schema · links · ownership · provenance · private-leakage · OpenAPI · catalog · graph consistency · context packs. Plus: CRLF + private-source scan (scan-public.mjs), production smoke (14 routes) after deploy.

Development

npm ci
npm run build                      # all gates + 28 pages
npx astro preview                  # http://localhost:4321
node scripts/smoke.mjs http://localhost:4321
node scripts/freshness.mjs         # pinned SHAs vs live remote state
node scripts/adopt-source.mjs Aftergraph/<repo> <full-sha>   # explicit pin adoption (ADR-004)

Windows: repo is LF-only (hard gate) — strip before committing: sed -i 's/\r$//' <files>.

Decisions & state

  • Architecture decisions: docs/ADR-001..005
  • Parity feature list + DoD vs Claude/OpenAI/Hermes docs: docs/PARITY-FEATURES.md
  • Release history: CHANGELOG.md
  • Overnight program state: OVERNIGHT-STATE.md

Deploy

Direct-upload to Cloudflare Pages (project aftergraph-docs, custom domain docs.aftergraph.org) after green local gates; CI runs the same gates remotely on every push/PR and smoke-tests production after deploy. Scheduled verifier (6h) re-checks pins, commits an append-only history log, uploads immutable artifacts, and opens adoption issues on semantic drift — never auto-pins.

About

Aftergraph Knowledge Plane — public developer & research portal. Provenance-stamped docs, contracts, claims + agent surfaces. Live: https://docs.aftergraph.org

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages