diff --git a/agent-context-kit/benchmarks/index.html b/agent-context-kit/benchmarks/index.html index 66ee8d7..8187063 100644 --- a/agent-context-kit/benchmarks/index.html +++ b/agent-context-kit/benchmarks/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/checkpoints/index.html b/agent-context-kit/checkpoints/index.html index bccba6d..bdac2e9 100644 --- a/agent-context-kit/checkpoints/index.html +++ b/agent-context-kit/checkpoints/index.html @@ -7,16 +7,16 @@ Checkpoints — ACKit 0.5.1 - + - + - + @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -55,8 +58,9 @@

Checkpoints / Resume / Handoff

Checkpoints snapshot task state with deterministic resume context and handoff packs, so work survives provider switches and interruptions.

ackit checkpoint create --next-objective "wire gate" --next-path src/core --next-command "pnpm test" --next-expected "green"
 ackit checkpoint show
 ackit checkpoint validate
-ackit checkpoint export
-ackit task resume
+ackit checkpoint export --format json --out .ackit/reviews/handoff.json +ackit checkpoint import .ackit/reviews/handoff.json +ackit task resume

Portable handoff v2

ackit.handoff.v2 binds task and workflow state, the checkpoint record, evidence presence, the verification binding (state and bundle digests) with the latest verdict trust summary, checkpoint staleness at export time, the canonical status snapshot (verbatim blockers plus derived next actions), a redaction manifest, and provider-neutral resume instructions. Imports validate against current disk state and stay read-only: fresh handoffs render resume context, moved state refuses with VERDICT-STATE-STALE, v1 markdown refuses with HANDOFF-V1-UNBOUND, malformed files with HANDOFF-INVALID, and unknown tasks with HANDOFF-TASK-UNKNOWN.

diff --git a/agent-context-kit/cli/index.html b/agent-context-kit/cli/index.html index c1fd2da..e9a11f2 100644 --- a/agent-context-kit/cli/index.html +++ b/agent-context-kit/cli/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -63,9 +66,11 @@ ackit task create | list | start | complete ackit workflow set | show | advance | verify ackit intent new | list | show | validate | fingerprint -ackit checkpoint create | show | validate | export +ackit checkpoint create | show | validate | export --format json +ackit checkpoint import <file> +ackit status [id] ackit evidence sync | show | verify | validate -ackit verification bundle | record | show +ackit verification bundle --format json | record --bundle | show ackit drift check --ci ackit role list | show | validate ackit skills list | validate | install | sync diff --git a/agent-context-kit/dashboard/index.html b/agent-context-kit/dashboard/index.html index 3590f3f..d00fe02 100644 --- a/agent-context-kit/dashboard/index.html +++ b/agent-context-kit/dashboard/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/diagnostics/index.html b/agent-context-kit/diagnostics/index.html index 90d7e21..836498f 100644 --- a/agent-context-kit/diagnostics/index.html +++ b/agent-context-kit/diagnostics/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/drift/index.html b/agent-context-kit/drift/index.html index fe22430..de88b94 100644 --- a/agent-context-kit/drift/index.html +++ b/agent-context-kit/drift/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/evidence/index.html b/agent-context-kit/evidence/index.html index 9addfc5..7b89337 100644 --- a/agent-context-kit/evidence/index.html +++ b/agent-context-kit/evidence/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/getting-started/index.html b/agent-context-kit/getting-started/index.html index 285f3af..0bfb119 100644 --- a/agent-context-kit/getting-started/index.html +++ b/agent-context-kit/getting-started/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/github-action/index.html b/agent-context-kit/github-action/index.html index c4ed435..e6bae95 100644 --- a/agent-context-kit/github-action/index.html +++ b/agent-context-kit/github-action/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/index.html b/agent-context-kit/index.html index f244ac5..786fbe4 100644 --- a/agent-context-kit/index.html +++ b/agent-context-kit/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -60,7 +63,7 @@ ackit scan --ci ackit sync --check ackit pack --profile codex --max-tokens 50000 -ackit dashboard --port 0 --open

Core capabilities

+ackit dashboard --port 0 --open

Core capabilities

diff --git a/agent-context-kit/instruction-graph/index.html b/agent-context-kit/instruction-graph/index.html index 1e62e2e..7ac2024 100644 --- a/agent-context-kit/instruction-graph/index.html +++ b/agent-context-kit/instruction-graph/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/intent/index.html b/agent-context-kit/intent/index.html index b94f9b8..6e9afec 100644 --- a/agent-context-kit/intent/index.html +++ b/agent-context-kit/intent/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/llms-full.txt b/agent-context-kit/llms-full.txt index 296d185..1313cb3 100644 --- a/agent-context-kit/llms-full.txt +++ b/agent-context-kit/llms-full.txt @@ -144,22 +144,24 @@ OpenCode, Copilot, Gemini, Cursor, Cline, any MCP-capable agent). 📊Agent Readinessackit readiness0–100 across 6 categories (25/25/20/10/10/10), weighted renormalization, ackit.readiness.v1 JSON + terminal tree, --fail-below/--strict/--baseline/--compare 🧩Instruction Graph v2ackit instructions --explainCodex/Claude/Gemini/Copilot+shared, nesting, includeScopes/excludeScopes/providerApplicability/provenance/shadowedBy/duplicateOf, applyTo globs, conflict/duplicate/shadow/dead, depth→precedence→id -🎭Provider Profilesackit pack --profile codex5 built-ins (codex/claude/copilot/gemini/generic), CLI --profile > ackit.yml > auto-detect > generic, budget/includePriority +🎭Provider Profiles + Surface Parityackit pack --profile codex5 built-ins (codex/claude/copilot/gemini/generic), CLI --profile > ackit.yml > auto-detect > generic, budget/includePriority; CLI ≡ SDK ≡ read-only MCP ≡ Action ≡ VS Code project the same canonical status snapshot (Codex/Claude/Gemini/Copilot distinctions in docs/reference/provider-surfaces.md) 📜Rule/Policy Packsackit policy checkschemas/rule-pack.schema.json v1 (presence|pattern|config|dependency|instruction), glob/scope/match, overrides/composition, ReDoS/size guards 🧹Optimize v2ackit optimize --explain8-class taxonomy, evidence[]/confidence/tokenWasteEstimate/provenance/plan, --fix --dry-run, terminal|json|markdown|sarif 📦Context Packsackit pack --max-tokens 50000Weighted deterministic ranking, manifest hash/reason/tokens per file -🔒Scanningackit scan --ciSecrets/assignments/private keys/connection strings/entropy/absolute-path/CI pinning/drift, redacted evidence, SARIF 2.1.0 +🔒Scanning + Containment Hardeningackit scan --ciSecrets/assignments/private keys/connection strings/entropy/absolute-path/CI pinning/drift, redacted evidence, SARIF 2.1.0; link-aware root-contained output guard (symlink/junction escape repair, T27), adversarial matrix, MCP stays read-only ✅Tasksackit taskdocs/tasks single-active, [ ]/[~]/[x]/[!], completion gate, task doctor 🧭Workflows + Intentackit workflow set --profile standardquick/standard/high-risk lifecycles with stage gates (ackit.workflow.v1), committed intent docs with fingerprints (ackit.intent.v1), artifact refs on tasks -🧾Evidence + Verificationackit evidence verify … && ackit verification record …criteria↔proof registry (ackit.evidence.v2), bounded verification bundles for fresh verifiers, append-only ackit.verdict.v1 verdicts, completion gate enforcement -⏸️Checkpoints + Resumeackit checkpoint create … && ackit task resume …ackit.checkpoint.v1 snapshots, staleness detection, deterministic resume context + handoff packs, task-aware context packs +🧾Evidence + State-Bound Verificationackit evidence verify … && ackit verification bundle … --format json && ackit verification record … --bundle …criteria↔proof registry (ackit.evidence.v2), state-bound bundles (ackit.verification-bundle.v2 with stateDigest/bundleDigest), persisted bound verdicts (ackit.verdict.v2, v1-authored) with verifier independence (reviewedBundleDigest, VERDICT-INDEPENDENCE-UNPROVEN), replay rejection (VERDICT-REPLAY-REJECTED) + staleness refusal (VERDICT-STATE-STALE/VERDICT-BUNDLE-MISMATCH), completion gate enforcement +⏸️Checkpoints + Portable Handoff v2ackit checkpoint create … && ackit checkpoint export … --format json && ackit checkpoint import …ackit.checkpoint.v1 snapshots + verification-bound portable handoff (ackit.handoff.v2 with verification binding, status snapshot, redaction manifest), checkpoint import read-only resume with stale refusal (VERDICT-STATE-STALE/HANDOFF-V1-UNBOUND/HANDOFF-INVALID), deterministic resume context + task-aware packs +🧭Canonical Statusackit status [id]read-only task/stage, verbatim blockers, verification + checkpoint freshness, derived next actions — human + stable ackit.status.v1 JSON; never mutates 🛰️Drift + Policy v2ackit drift check --ci8 deterministic finding codes, risk-tiered autonomy (tier0-4 × allow/ask/deny, deny wins) + review policy, declarative lifecycle gates (no executable hooks), portable role contracts 🔭Watch/Dashboardackit dashboardscan --watch debounced 400ms + cache; dashboard localhost-only 127.0.0.1, CSP + nosniff, /api/* paginated, <50KB vanilla JS 🩺Diagnosticsackit diagnostics bundleackit.diagnostics.v1 + deterministic bundle-manifest.json (sha256 + redaction count), 5-secret [REDACTED] proof ⚡Benchmarksbenchmarks/run.mjs7 deterministic fixtures, 8 metrics (coldScanMs/warmScanMs/incrementalMs/peakRssMb/filesPerSec/packMs/graphMs/cacheHitRatio), median-of-3 🔌SDK v1import { scanRepository } from "@cynrath/agent-context-kit"sideEffects:false, type:module, exports {".","./mcp"}, AbortSignal <200ms, AckitError -🧩VS Codeextensions/vscode0.4.1, Cynrath, lints Linters, onStartupFinished, readiness tree + Problems ACKITxxx, <2MB VSIX — Marketplace: Cynrath.ackit-vscode -🤖MCPackit mcp serveOfficial SDK stdio, 16 read-only tools (incl. task status, workflow status, intent, checkpoint, verification bundle, drift, roles), 5 resources, 4 prompts, InMemoryTransport cancellation +🧩VS Codeextensions/vscode0.5.1, Cynrath, lints Linters, onStartupFinished, readiness tree + Problems ACKITxxx + status-integrated Tasks view (canonical blockers/next actions, no mutation), <2MB VSIX — Marketplace: Cynrath.ackit-vscode +🤖MCPackit mcp serveOfficial SDK stdio, 16 read-only tools (incl. canonical ackit_status, workflow status, intent, checkpoint, verification bundle, drift, roles), 5 resources, 4 prompts, InMemoryTransport cancellation +🔐Trust-Flow Demodocs/guides/demo-trust-flow.mdreproducible offline proof: missing proof blocks → bound independent verdict enables → mutation stales → fresh re-verification restores → handoff exports → second process resumes (tests/e2e/trust-flow-demo.test.ts) @@ -172,11 +174,11 @@ OpenCode, Copilot, Gemini, Cursor, Cline, any MCP-capable agent). ```bash # global (recommended) npm install --global @cynrath/agent-context-kit -ackit --version # 0.4.1 +ackit --version # 0.5.1 # one-shot, pinned -npx --yes @cynrath/agent-context-kit@0.4.1 --version -npx --yes @cynrath/agent-context-kit@0.4.1 --help +npx --yes @cynrath/agent-context-kit@0.5.1 --version +npx --yes @cynrath/agent-context-kit@0.5.1 --help # from source pnpm install --frozen-lockfile && pnpm build @@ -217,8 +219,8 @@ ackit dashboard --port 0 --open # localhost-only 🧩ackit instructionsInstruction graph v2--provider --profile --for --explain --json 📦ackit packProvider-aware context pack--max-tokens --profile --include --changed 🛠️ackit skills / task / policy / configSkills, task workflow, policy and configurationskills list/validate/install/export · task create/list/start/complete/resume · policy check · config check -🧭ackit workflow / intent / checkpointWorkflow lifecycles, intent docs, resumeworkflow set/show/advance/verify · intent new/list/show/validate/fingerprint · checkpoint create/show/validate/export -🧾ackit evidence / verification / drift / role / journalEvidence registry, verifier bundles, drift, roles, journalevidence sync/show/verify/validate · verification bundle/record/show · drift check [--ci] · role list/show/validate · journal show/validate +🧭ackit workflow / intent / checkpoint / statusWorkflow lifecycles, intent docs, resume + canonical statusworkflow set/show/advance/verify · intent new/list/show/validate/fingerprint · checkpoint create/show/validate/export [--format json]/import · status [id] (read-only ackit.status.v1) +🧾ackit evidence / verification / drift / role / journalEvidence registry, state-bound verifier bundles, drift, roles, journalevidence sync/show/verify/validate · verification bundle [--format json] / record --bundle … / show (v2 state binding + independence) · drift check [--ci] · role list/show/validate · journal show/validate 🔧ackit cache / workspaces / hooks / report / mcpUtility commandscache clean · workspaces · hooks · report serve · mcp serve @@ -282,13 +284,31 @@ flowchart LR - **Determinism** — same repo+config → byte-identical JSON/fingerprints - **Offline-by-construction** — no network in product code +#### Trust chain (v0.5) + +```mermaid +flowchart LR + T[Task / Intent / Workflow] --> E[Evidence] + E --> V[Bound Verification
bundle v2 + verdict v2] + V --> I[Verdict Independence + Freshness
reviewed bundle + replay/stale refusal] + I --> S[Canonical Status
ackit.status.v1, read-only] + S --> H[Portable Handoff v2
export / import / resume] + H --> P[CLI / SDK / MCP / Action / VS Code] +``` + +Task/intent/workflow → evidence → bound verification → verdict +independence/freshness → status → handoff/resume → +CLI/SDK/MCP/Action/VS Code. Details: [`docs/guides/demo-trust-flow.md`](docs/guides/demo-trust-flow.md) · +[`docs/concepts/evidence-verification.md`](docs/concepts/evidence-verification.md) · +[`docs/concepts/checkpoints.md`](docs/concepts/checkpoints.md). + More: [`docs/architecture/overview.md`](docs/architecture/overview.md) --- ### 🤖 GitHub Action -Official `Cynrath/agent-context-kit@v0.4.1` (SHA-pinned for high-assurance): +Official `Cynrath/agent-context-kit@v0.5.1` (SHA-pinned for high-assurance): ```yaml permissions: @@ -298,7 +318,7 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@f548e57e544e1ff5a4c46bf1e1b8685f8e4a348a - - uses: Cynrath/agent-context-kit@v0.4.1 + - uses: Cynrath/agent-context-kit@v0.5.1 with: command: scan args: "--json" @@ -347,13 +367,13 @@ ESM-only, `sideEffects:false`, `AbortSignal` cancellable, no `process.exit`. Ref ### 🧩 VS Code -Extension is **published on the VS Code Marketplace** — [`Cynrath.ackit-vscode`](https://marketplace.visualstudio.com/items?itemName=Cynrath.ackit-vscode) (`0.4.1`, `<2MB` VSIX, offline-first, no telemetry). +Extension is **published on the VS Code Marketplace** — [`Cynrath.ackit-vscode`](https://marketplace.visualstudio.com/items?itemName=Cynrath.ackit-vscode) (`0.5.1`, `<2MB` VSIX, offline-first, no telemetry). From source: ```bash pnpm --filter vscode build -vsce package # → ackit-vscode-0.5.0-dev.0.vsix +vsce package # → ackit-vscode-0.5.1.vsix ``` Features: readiness tree, Problems `ACKITxxx`, graph “instructions for current file”, tasks/policy/optimize, palette `Refresh/Show Graph/Optimize/Diagnostics`, file watcher debounced, no telemetry. @@ -368,8 +388,8 @@ Guide: [`docs/guides/vscode.md`](docs/guides/vscode.md) |---|---| | Architecture | [`docs/architecture/overview.md`](docs/architecture/overview.md) | | Concepts | `instruction-graph` · `context-budget` · `provider-profiles` · `readiness` · [`workflows`](docs/concepts/workflows.md) · [`intent`](docs/concepts/intent.md) · [`checkpoints`](docs/concepts/checkpoints.md) · [`evidence-verification`](docs/concepts/evidence-verification.md) | -| Guides | [`getting-started`](docs/guides/getting-started.md) · [`readiness`](docs/guides/readiness.md) · [`optimize`](docs/guides/optimize.md) · [`provider-profiles`](docs/guides/provider-profiles.md) · [`instruction-graph`](docs/guides/instruction-graph.md) · [`rule-packs`](docs/guides/rule-packs.md) · [`ci`](docs/guides/ci.md) · [`watch-dashboard`](docs/guides/watch-dashboard.md) · [`diagnostics`](docs/guides/diagnostics.md) · [`sdk`](docs/guides/sdk.md) · [`vscode`](docs/guides/vscode.md) · [`monorepo`](docs/guides/monorepo.md) · [`workflow-adoption`](docs/guides/workflow-adoption.md) · [`workflow-example`](docs/guides/workflow-example.md) | -| Reference | `cli` · `config` · `rules` · `readiness` · `profile` · `rule-pack` · `instruction-graph` · `diagnostics` · `sdk` · `exit-codes` · `mcp` · `schemas` · [`drift`](docs/reference/drift.md) · [`policy`](docs/reference/policy.md) | +| Guides | [`getting-started`](docs/guides/getting-started.md) · [`readiness`](docs/guides/readiness.md) · [`optimize`](docs/guides/optimize.md) · [`provider-profiles`](docs/guides/provider-profiles.md) · [`instruction-graph`](docs/guides/instruction-graph.md) · [`rule-packs`](docs/guides/rule-packs.md) · [`ci`](docs/guides/ci.md) · [`watch-dashboard`](docs/guides/watch-dashboard.md) · [`diagnostics`](docs/guides/diagnostics.md) · [`sdk`](docs/guides/sdk.md) · [`vscode`](docs/guides/vscode.md) · [`monorepo`](docs/guides/monorepo.md) · [`workflow-adoption`](docs/guides/workflow-adoption.md) · [`workflow-example`](docs/guides/workflow-example.md) · [`demo-trust-flow`](docs/guides/demo-trust-flow.md) | +| Reference | `cli` · `config` · `rules` · `readiness` · `profile` · `rule-pack` · `instruction-graph` · `diagnostics` · `sdk` · `exit-codes` · `mcp` · `schemas` · [`drift`](docs/reference/drift.md) · [`policy`](docs/reference/policy.md) · [`status`](docs/reference/cli.md#cli-reference) · [`provider-surfaces`](docs/reference/provider-surfaces.md) | | Decisions | [`docs/decisions/`](docs/decisions/) · `v0.2.0`: [`docs/v0.2.0/`](docs/v0.2.0/) · `ADR-0025..0028`: workflow/evidence/checkpoint/policy-v2 | | Tasks | [`docs/tasks/active`](docs/tasks/active) | @@ -404,7 +424,7 @@ See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the docs-first workflow. ### 🔖 Versioning -Development: **`0.5.0-dev.0`** on `master` · Latest stable: **`0.4.1`** · [Changelog](CHANGELOG.md) · [Releases](https://github.com/Cynrath/agent-context-kit/releases/latest) · `latest → 0.4.1` via OIDC Trusted Publishing with provenance. Stable pointer: [`release-state.json`](release-state.json). Legacy `.NET/NuGet 1.0.0-rc.1` at `258918b` is frozen. +Development: **`0.5.1`** on `master` · Latest stable: **`0.5.1`** · [Changelog](CHANGELOG.md) · [Releases](https://github.com/Cynrath/agent-context-kit/releases/latest) · `latest → 0.5.1` via OIDC Trusted Publishing with provenance. Stable pointer: [`release-state.json`](release-state.json). Legacy `.NET/NuGet 1.0.0-rc.1` at `258918b` is frozen. --- diff --git a/agent-context-kit/llms.txt b/agent-context-kit/llms.txt index 8f87d02..f68b080 100644 --- a/agent-context-kit/llms.txt +++ b/agent-context-kit/llms.txt @@ -14,9 +14,10 @@ - [Rule Packs](https://cynrath.github.io/agent-context-kit/rule-packs/): Declarative offline repository policy checks. - [Workflows](https://cynrath.github.io/agent-context-kit/workflows/): Staged ACKit workflow lifecycles with deterministic gates. - [Intent](https://cynrath.github.io/agent-context-kit/intent/): Committed intent documents with fingerprints. -- [Checkpoints](https://cynrath.github.io/agent-context-kit/checkpoints/): Resumable checkpoints with handoff packs. +- [Checkpoints](https://cynrath.github.io/agent-context-kit/checkpoints/): Resumable checkpoints with verification-bound portable handoff. - [Evidence](https://cynrath.github.io/agent-context-kit/evidence/): Acceptance criteria linked to typed proof. -- [Verification](https://cynrath.github.io/agent-context-kit/verification/): Independent verification bundles and verdicts. +- [Verification](https://cynrath.github.io/agent-context-kit/verification/): State-bound verification bundles and independent verdicts. +- [Status](https://cynrath.github.io/agent-context-kit/status/): Canonical read-only task status with blockers and next actions. - [Drift](https://cynrath.github.io/agent-context-kit/drift/): Deterministic workflow drift detection. - [Policy](https://cynrath.github.io/agent-context-kit/policy/): Risk-tiered autonomy and review policy. - [Roles](https://cynrath.github.io/agent-context-kit/roles/): Portable data-only agent role contracts. @@ -25,6 +26,8 @@ - [GitHub Action](https://cynrath.github.io/agent-context-kit/github-action/): Run ACKit repository checks in GitHub Actions. - [MCP](https://cynrath.github.io/agent-context-kit/mcp/): Local Model Context Protocol integration for ACKit. - [SDK](https://cynrath.github.io/agent-context-kit/sdk/): Programmatic ACKit repository analysis. +- [Provider Surfaces](https://cynrath.github.io/agent-context-kit/provider-surfaces/): Canonical provider-surface mapping with CLI, SDK, MCP, Action and VS Code parity. +- [Trust Flow](https://cynrath.github.io/agent-context-kit/trust-flow/): Reproducible verification-bound trust flow from evidence to resume. - [Dashboard](https://cynrath.github.io/agent-context-kit/dashboard/): Local ACKit dashboard and live repository views. - [Diagnostics](https://cynrath.github.io/agent-context-kit/diagnostics/): ACKit environment and support diagnostics. - [VS Code](https://cynrath.github.io/agent-context-kit/vscode/): AgentContextKit VS Code extension. diff --git a/agent-context-kit/mcp/index.html b/agent-context-kit/mcp/index.html index 56cd9e7..df15fd7 100644 --- a/agent-context-kit/mcp/index.html +++ b/agent-context-kit/mcp/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -52,7 +55,7 @@ Migration GitHub -

MCP

ACKit exposes a local stdio MCP server for read-oriented repository inspection. No remote transport is required.

{ "mcpServers": { "ackit": { "command": "ackit", "args": ["mcp", "serve"] } } }
+

MCP

ACKit exposes a local stdio MCP server for read-oriented repository inspection (16 read-only tools including canonical ackit_status). No remote transport is required.

{ "mcpServers": { "ackit": { "command": "ackit", "args": ["mcp", "serve"] } } }
diff --git a/agent-context-kit/migration/index.html b/agent-context-kit/migration/index.html index 267ce3f..d6eb4c0 100644 --- a/agent-context-kit/migration/index.html +++ b/agent-context-kit/migration/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/optimize/index.html b/agent-context-kit/optimize/index.html index b0e5bcf..70f03d4 100644 --- a/agent-context-kit/optimize/index.html +++ b/agent-context-kit/optimize/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/policy/index.html b/agent-context-kit/policy/index.html index 7cb8768..0f56982 100644 --- a/agent-context-kit/policy/index.html +++ b/agent-context-kit/policy/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/profiles/index.html b/agent-context-kit/profiles/index.html index 8507edd..9c21256 100644 --- a/agent-context-kit/profiles/index.html +++ b/agent-context-kit/profiles/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/provider-surfaces/index.html b/agent-context-kit/provider-surfaces/index.html new file mode 100644 index 0000000..29b702b --- /dev/null +++ b/agent-context-kit/provider-surfaces/index.html @@ -0,0 +1,62 @@ + + + + + + + + + Provider Surfaces — ACKit 0.5.1 + + + + + + + + + + + + + + + +

Provider Surfaces

ACKit projects one canonical workflow, evidence, verdict, and status snapshot across every integration surface. Primary-source dates and caveats live with the product docs.

CLI (ackit status), SDK (buildStatusReport), read-only MCP (ackit_status), the GitHub Action (command: status), and the VS Code Tasks view all expose the same snapshot.

+ + + + diff --git a/agent-context-kit/readiness/index.html b/agent-context-kit/readiness/index.html index 83bcfa5..1df7124 100644 --- a/agent-context-kit/readiness/index.html +++ b/agent-context-kit/readiness/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/roles/index.html b/agent-context-kit/roles/index.html index dc9f12d..ebdc9f0 100644 --- a/agent-context-kit/roles/index.html +++ b/agent-context-kit/roles/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/rule-packs/index.html b/agent-context-kit/rule-packs/index.html index 7f81cee..742eb0b 100644 --- a/agent-context-kit/rule-packs/index.html +++ b/agent-context-kit/rule-packs/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/sdk/index.html b/agent-context-kit/sdk/index.html index d1a2d33..25ae9c1 100644 --- a/agent-context-kit/sdk/index.html +++ b/agent-context-kit/sdk/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -53,7 +56,7 @@ GitHub

SDK

The ESM SDK exposes the same deterministic repository analysis primitives used by the CLI.

import { scanRepository } from "@cynrath/agent-context-kit";
-const result = await scanRepository({ canonicalPath: process.cwd() });
+const result = await scanRepository({ canonicalPath: process.cwd() });

Read-model parity: buildStatusReport and renderStatusReport project the same ackit.status.v1 snapshot as ackit status; handoff and independence exports share the CLI contract.

diff --git a/agent-context-kit/security/index.html b/agent-context-kit/security/index.html index eacfde2..5edfd69 100644 --- a/agent-context-kit/security/index.html +++ b/agent-context-kit/security/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -52,7 +55,7 @@ Migration GitHub -

Security

Offline-first: product analysis is designed for zero outbound repository-data egress after installation.

+

Security

Offline-first: product analysis is designed for zero outbound repository-data egress after installation.

diff --git a/agent-context-kit/skills/index.html b/agent-context-kit/skills/index.html index 97332a1..0cd53b3 100644 --- a/agent-context-kit/skills/index.html +++ b/agent-context-kit/skills/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/status/index.html b/agent-context-kit/status/index.html new file mode 100644 index 0000000..6e92d3a --- /dev/null +++ b/agent-context-kit/status/index.html @@ -0,0 +1,64 @@ + + + + + + + + + Status — ACKit 0.5.1 + + + + + + + + + + + + + + + +

Status

ackit status [id] is the canonical read-only projection: task and stage, verbatim completion blockers, verification and checkpoint freshness, and derived next actions. Human output and stable ackit.status.v1 JSON describe the same snapshot; the command never mutates.

ackit status
+ackit status TASK-0007
+ackit --json status TASK-0007
+ + + + diff --git a/agent-context-kit/sync/index.html b/agent-context-kit/sync/index.html index e11605b..21cc7d3 100644 --- a/agent-context-kit/sync/index.html +++ b/agent-context-kit/sync/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/agent-context-kit/trust-flow/index.html b/agent-context-kit/trust-flow/index.html new file mode 100644 index 0000000..b4bee6f --- /dev/null +++ b/agent-context-kit/trust-flow/index.html @@ -0,0 +1,67 @@ + + + + + + + + + Trust Flow — ACKit 0.5.1 + + + + + + + + + + + + + + + +

Trust Flow

One reproducible offline arc: missing evidence and verdicts block completion, a bound independent verdict enables it, a state mutation stales it, fresh re-verification restores it, a checkpoint handoff exports it, and a second process resumes it with zero shared memory.

ackit task complete TASK-0007
+ackit verification bundle TASK-0007 --format json --out .ackit/reviews/bundle.json
+ackit verification record TASK-0007 --verdict .ackit/reviews/verdict.yaml --bundle .ackit/reviews/bundle.json
+ackit status TASK-0007
+ackit checkpoint export TASK-0007 --format json --out .ackit/reviews/handoff.json
+ackit checkpoint import .ackit/reviews/handoff.json

Executed by tests/e2e/trust-flow-demo.test.ts and walked through in the product guide docs/guides/demo-trust-flow.md.

+ + + + diff --git a/agent-context-kit/verification/index.html b/agent-context-kit/verification/index.html index 5e0899a..d0369d6 100644 --- a/agent-context-kit/verification/index.html +++ b/agent-context-kit/verification/index.html @@ -7,16 +7,16 @@ Verification — ACKit 0.5.1 - + - + - + @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -52,9 +55,9 @@ Migration GitHub -

Verification / Verdicts

Verification bundles give a fresh independent verifier everything needed to judge a task; verdicts are append-only: PASS, PASS_WITH_WARNINGS, REWORK_REQUIRED or BLOCKED.

ackit verification bundle
-ackit verification record --verdict ./verdict.yaml
-ackit verification show
+

Verification / Verdicts

Verification bundles (ackit.verification-bundle.v2) give a fresh independent verifier everything needed to judge a task, bound to the exact state via stateDigest and bundleDigest. The verifier authors ackit.verdict.v1; ACKit persists a state-bound ackit.verdict.v2. Legacy v1 files stay readable as history but never satisfy a state-bound completion.

ackit verification bundle --format json --out .ackit/reviews/bundle.json
+ackit verification record --verdict ./verdict.yaml --bundle .ackit/reviews/bundle.json
+ackit verification show

Independence and freshness

Independence is proven by reviewedBundleDigest: fresh claims without bundle proof refuse with VERDICT-INDEPENDENCE-UNPROVEN, replayed content refuses with VERDICT-REPLAY-REJECTED, stale bundles with VERDICT-BUNDLE-MISMATCH, and moved state with VERDICT-STATE-STALE. Completion rechecks freshness; no cryptographic verifier identity is claimed.

diff --git a/agent-context-kit/vscode/index.html b/agent-context-kit/vscode/index.html index 9d6442d..35c0016 100644 --- a/agent-context-kit/vscode/index.html +++ b/agent-context-kit/vscode/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code @@ -52,7 +55,7 @@ Migration GitHub -

VS Code

Cynrath.ackit-vscode surfaces readiness, findings, instructions, tasks, policy and diagnostics inside VS Code.

code --install-extension Cynrath.ackit-vscode
+

VS Code

Cynrath.ackit-vscode surfaces readiness, findings, instructions, tasks, policy and diagnostics inside VS Code. The Tasks view renders the canonical status snapshot (blockers plus next actions) with no write paths added.

code --install-extension Cynrath.ackit-vscode
diff --git a/agent-context-kit/workflows/index.html b/agent-context-kit/workflows/index.html index 994cd40..dec100e 100644 --- a/agent-context-kit/workflows/index.html +++ b/agent-context-kit/workflows/index.html @@ -36,6 +36,7 @@ Checkpoints Evidence Verification + Status Drift Policy Roles @@ -44,6 +45,8 @@ GitHub Action MCP SDK + Provider Surfaces + Trust Flow Dashboard Diagnostics VS Code diff --git a/index.html b/index.html index e286315..7ee7ca5 100644 --- a/index.html +++ b/index.html @@ -1 +1 @@ -Cynrath — Developer tooling, web systems & infrastructure
Developer tooling · web systems · infrastructure

Developer tools.
Web systems.
Infrastructure.

TypeScript and .NET for CLI tooling, admin platforms, databases, automation, CI/CD and infrastructure.

TypeScript / Node.js.NET / C#Docker / LinuxCloudflare / CI
ackit / localv0.4.1
$ackit readiness
Readiness88/100██████████████████░░threshold 80 · pass✓ Instructions 90/100✓ Security 90/100✓ Context Efficiency 70/100
$
14stars
1fork
0open issues
Stack
TypeScriptNode.js.NET / C#MSSQL / EF CoreDocker / LinuxCloudflare
02 / AgentContextKit

Repository context you can inspect.

ACKit runs locally and turns repository instructions, context, tasks, policies, workflow state, evidence, verification, diagnostics and integrations into deterministic commands and stable outputs.

Installnpm install -g @cynrath/agent-context-kit@0.4.1
01

Agent Readiness

Explainable 0–100 scoring across repository readiness categories with strict, baseline and compare modes.

ackit readiness
02

Instruction Graph v2

Resolve Codex, Claude, Gemini, Copilot and shared instructions with scope, precedence, provenance and conflict analysis.

ackit instructions --explain
03

Provider Profiles

Select deterministic provider-aware behavior for Codex, Claude, Copilot, Gemini or generic agent workflows.

ackit pack --profile codex
04

Context Packs

Build deterministic, token-budgeted repository context with weighted ranking and per-file manifest reasons.

ackit pack --max-tokens 50000
05

Skills Interop

Validate, install and export portable skills across supported provider layouts without replacing the repository workflow.

ackit skills export --provider claude
06

Managed Asset Sync

Preview, check and reconcile ACKit-owned AGENTS blocks, provider shims and builtin skills without overwriting user-owned content.

ackit sync --dry-run
07

Rule + Policy Packs

Apply machine-checkable presence, pattern, config, dependency and instruction rules with composition and scoped overrides.

ackit policy check
08

Optimize v2

Detect instruction waste, duplicates and conflicts with evidence, confidence, token estimates and dry-run fixes.

ackit optimize --explain
09

Security Scanning

Scan secrets, keys, connection strings, entropy, CI pinning and hygiene findings with redacted evidence and SARIF.

ackit scan --ci
10

Task System

Keep a single active task, explicit task states, artifact references, completion gates and doctor checks.

ackit task
11

Workflows + Intent

Run quick, standard or high-risk stage lifecycles backed by committed intent, plans and config-driven completion gates.

ackit workflow show
12

Evidence + Verification

Link acceptance criteria to typed evidence, generate bounded verification bundles and record append-only verifier verdicts.

ackit evidence validate
13

Checkpoints + Resume

Use atomic checkpoints, staleness detection, resume context and handoff packs across interruptions or provider switches.

ackit task resume
14

Drift + Policy v2

Detect deterministic workflow drift and enforce risk-tiered autonomy, review policy and declarative lifecycle gates.

ackit drift check --ci
15

Roles + Journal

Use portable role contracts and a sanitized append-only local execution journal without capturing hidden reasoning or conversations.

ackit role list
16

Watch + Dashboard

Watch repository changes and inspect local readiness, findings and workflow state through a localhost-only dashboard.

ackit dashboard
17

Diagnostics + Benchmarks

Produce deterministic diagnostic bundles and measure scan, pack, graph, cache and memory performance against fixtures.

ackit diagnostics bundle
18

SDK + MCP

Embed ACKit through its typed SDK or expose the read-only MCP surface for agent integrations.

ackit mcp serve
19

VS Code + GitHub Action

Bring ACKit checks into editor Problems/readiness views and CI with the VS Code extension and GitHub Action.

Cynrath.ackit-vscode
04 / Engineering principles

The rules behind the work.

01

Read before edit.

Architecture, instructions, local changes and task state come first.

Inspect AGENTS/CLAUDE files, docs, ADRs, git status/diff and the repository's real build/test workflow.
02

Plan before implementation.

Tasks, acceptance criteria and verification are written down before code starts.

The plan stays usable across long sessions, interruptions and handoffs.
03

Smallest safe change.

Fix the root cause without dragging unrelated architecture into the change.

Preserve conventions, dependencies and unrelated local work unless they are part of the actual problem.
04

Verify before done.

Builds, tests, E2E, CI and the final diff decide completion.

A change is complete only when the required checks pass and the final diff is clean.
\ No newline at end of file +Cynrath — Developer tooling, web systems & infrastructure
Developer tooling · web systems · infrastructure

Developer tools.
Web systems.
Infrastructure.

TypeScript and .NET for CLI tooling, admin platforms, databases, automation, CI/CD and infrastructure.

TypeScript / Node.js.NET / C#Docker / LinuxCloudflare / CI
ackit / localv0.5.1
$ackit readiness
Readiness88/100██████████████████░░threshold 80 · pass✓ Instructions 90/100✓ Security 90/100✓ Context Efficiency 70/100
$
14stars
1fork
0open issues
Stack
TypeScriptNode.js.NET / C#MSSQL / EF CoreDocker / LinuxCloudflare
02 / AgentContextKit

Repository context you can inspect.

ACKit runs locally and turns repository instructions, context, tasks, policies, workflow state, evidence, verification, diagnostics and integrations into deterministic commands and stable outputs.

Installnpm install -g @cynrath/agent-context-kit@0.5.1
01

Agent Readiness

Explainable 0–100 scoring across repository readiness categories with strict, baseline and compare modes.

ackit readiness
02

Instruction Graph v2

Resolve Codex, Claude, Gemini, Copilot and shared instructions with scope, precedence, provenance and conflict analysis.

ackit instructions --explain
03

Provider Profiles

Deterministic provider-aware behavior for Codex, Claude, Copilot, Gemini or generic workflows; CLI, SDK, MCP, Action and VS Code share one status snapshot.

ackit pack --profile codex
04

Context Packs

Build deterministic, token-budgeted repository context with weighted ranking and per-file manifest reasons.

ackit pack --max-tokens 50000
05

Skills Interop

Validate, install and export portable skills across supported provider layouts without replacing the repository workflow.

ackit skills export --provider claude
06

Managed Asset Sync

Preview, check and reconcile ACKit-owned AGENTS blocks, provider shims and builtin skills without overwriting user-owned content.

ackit sync --dry-run
07

Rule + Policy Packs

Apply machine-checkable presence, pattern, config, dependency and instruction rules with composition and scoped overrides.

ackit policy check
08

Optimize v2

Detect instruction waste, duplicates and conflicts with evidence, confidence, token estimates and dry-run fixes.

ackit optimize --explain
09

Security Scanning

Scan secrets, keys, connection strings, entropy, CI pinning and hygiene findings with redacted evidence and SARIF; link-aware containment hardens outputs.

ackit scan --ci
10

Task System

Keep a single active task, explicit task states, artifact references, completion gates and doctor checks.

ackit task
11

Workflows + Intent

Run quick, standard or high-risk stage lifecycles backed by committed intent, plans and config-driven completion gates.

ackit workflow show
12

Evidence + State-Bound Verification

Link criteria to typed evidence, verify against state-bound bundles and persist independent bound verdicts with replay and staleness refusal.

ackit verification record --bundle
13

Portable Handoff + Canonical Status

Resume anywhere with verification-bound handoff packs and the read-only status snapshot: blockers, freshness and next actions.

ackit checkpoint import
14

Drift + Policy v2

Detect deterministic workflow drift and enforce risk-tiered autonomy, review policy and declarative lifecycle gates.

ackit drift check --ci
15

Roles + Journal

Use portable role contracts and a sanitized append-only local execution journal without capturing hidden reasoning or conversations.

ackit role list
16

Watch + Dashboard

Watch repository changes and inspect local readiness, findings and workflow state through a localhost-only dashboard.

ackit dashboard
17

Diagnostics + Benchmarks

Produce deterministic diagnostic bundles and measure scan, pack, graph, cache and memory performance against fixtures.

ackit diagnostics bundle
18

SDK + MCP

Embed ACKit through its typed SDK or expose the read-only MCP surface for agent integrations.

ackit mcp serve
19

VS Code + GitHub Action

Bring ACKit checks into editor Problems, the status-integrated Tasks view and CI with the VS Code extension and GitHub Action.

Cynrath.ackit-vscode
20

Trust Flow Demo

Follow the reproducible offline arc from evidence to bound independent verification, status and second-process resume — no API key.

ackit status
04 / Engineering principles

The rules behind the work.

01

Read before edit.

Architecture, instructions, local changes and task state come first.

Inspect AGENTS/CLAUDE files, docs, ADRs, git status/diff and the repository's real build/test workflow.
02

Plan before implementation.

Tasks, acceptance criteria and verification are written down before code starts.

The plan stays usable across long sessions, interruptions and handoffs.
03

Smallest safe change.

Fix the root cause without dragging unrelated architecture into the change.

Preserve conventions, dependencies and unrelated local work unless they are part of the actual problem.
04

Verify before done.

Builds, tests, E2E, CI and the final diff decide completion.

A change is complete only when the required checks pass and the final diff is clean.
\ No newline at end of file diff --git a/scripts/sync-ackit-docs.mjs b/scripts/sync-ackit-docs.mjs index 5cff8a3..5e4995c 100644 --- a/scripts/sync-ackit-docs.mjs +++ b/scripts/sync-ackit-docs.mjs @@ -76,8 +76,9 @@ const nav = [ ['optimize','Optimize'],['profiles','Profiles'],['instruction-graph','Instruction Graph'], ['rule-packs','Rule Packs'],['workflows','Workflows'],['intent','Intent'], ['checkpoints','Checkpoints'],['evidence','Evidence'],['verification','Verification'], - ['drift','Drift'],['policy','Policy'],['roles','Roles'],['skills','Skills'], + ['status','Status'],['drift','Drift'],['policy','Policy'],['roles','Roles'],['skills','Skills'], ['sync','Managed Sync'],['github-action','GitHub Action'],['mcp','MCP'],['sdk','SDK'], + ['provider-surfaces','Provider Surfaces'],['trust-flow','Trust Flow'], ['dashboard','Dashboard'],['diagnostics','Diagnostics'],['vscode','VS Code'],['security','Security'], ['benchmarks','Benchmarks'],['migration','Migration'] ]; @@ -131,9 +132,9 @@ function template({ title, description, slug, version, body }) { function pages(version) { const install = `npm install --global @cynrath/agent-context-kit@${version}\nackit --version\nackit --help`; return [ - {slug:'',title:'AgentContextKit',description:'Offline-first deterministic toolkit for agent-ready repositories.',body:`

AgentContextKit ${esc(version)}

Turn repository context into something agents and humans can inspect. ACKit combines readiness scoring, instruction graphs, context packs, policy-as-code, security scanning, tasks, MCP, dashboard and editor tooling without sending repository data to a hosted analysis service.

Getting StartedCLI ReferenceGitHubnpm

Install

${esc(install)}

Quickstart

ackit init --dry-run\nackit readiness\nackit instructions --explain\nackit scan --ci\nackit sync --check\nackit pack --profile codex --max-tokens 50000\nackit dashboard --port 0 --open

Core capabilities

`}, + {slug:'',title:'AgentContextKit',description:'Offline-first deterministic toolkit for agent-ready repositories.',body:`

AgentContextKit ${esc(version)}

Turn repository context into something agents and humans can inspect. ACKit combines readiness scoring, instruction graphs, context packs, policy-as-code, security scanning, tasks, MCP, dashboard and editor tooling without sending repository data to a hosted analysis service.

Getting StartedCLI ReferenceGitHubnpm

Install

${esc(install)}

Quickstart

ackit init --dry-run\nackit readiness\nackit instructions --explain\nackit scan --ci\nackit sync --check\nackit pack --profile codex --max-tokens 50000\nackit dashboard --port 0 --open

Core capabilities

`}, {slug:'getting-started',title:'Getting Started',description:'Install and initialize AgentContextKit.',body:`

Getting Started

ACKit requires Node.js 22 or newer. Installation is global or via npx; repository analysis runs locally.

Install

${esc(install)}

First pass

ackit init --dry-run\nackit readiness\nackit scan --ci\nackit instructions --explain
`}, - {slug:'cli',title:'CLI Reference',description:'ACKit commands, options and exit behavior.',body:`

CLI Reference

The CLI favors stable terminal and JSON output so the same checks can be used interactively and in CI.

ackit init --dry-run\nackit sync --check\nackit readiness --fail-below 80 --strict --baseline --compare --json\nackit scan --ci --changed --staged --since --range --baseline --watch\nackit instructions --provider codex --profile codex --for <path> --explain --json\nackit pack --profile codex --max-tokens 50000 --include <glob> --changed\nackit optimize --explain --fix --dry-run --format json\nackit policy check\nackit task create | list | start | complete\nackit workflow set | show | advance | verify\nackit intent new | list | show | validate | fingerprint\nackit checkpoint create | show | validate | export\nackit evidence sync | show | verify | validate\nackit verification bundle | record | show\nackit drift check --ci\nackit role list | show | validate\nackit skills list | validate | install | sync\nackit journal show | validate\nackit diagnostics --json\nackit diagnostics bundle --out ./ackit-diag.zip --redact-check\nackit dashboard --host 127.0.0.1 --port 0 --open\nackit mcp serve

Exit codes

0 success, 1 threshold failure, 2 usage/configuration, 3 environment, 4 security, 5 internal error.

`}, + {slug:'cli',title:'CLI Reference',description:'ACKit commands, options and exit behavior.',body:`

CLI Reference

The CLI favors stable terminal and JSON output so the same checks can be used interactively and in CI.

ackit init --dry-run\nackit sync --check\nackit readiness --fail-below 80 --strict --baseline --compare --json\nackit scan --ci --changed --staged --since --range --baseline --watch\nackit instructions --provider codex --profile codex --for <path> --explain --json\nackit pack --profile codex --max-tokens 50000 --include <glob> --changed\nackit optimize --explain --fix --dry-run --format json\nackit policy check\nackit task create | list | start | complete\nackit workflow set | show | advance | verify\nackit intent new | list | show | validate | fingerprint\nackit checkpoint create | show | validate | export --format json\nackit checkpoint import <file>\nackit status [id]\nackit evidence sync | show | verify | validate\nackit verification bundle --format json | record --bundle | show\nackit drift check --ci\nackit role list | show | validate\nackit skills list | validate | install | sync\nackit journal show | validate\nackit diagnostics --json\nackit diagnostics bundle --out ./ackit-diag.zip --redact-check\nackit dashboard --host 127.0.0.1 --port 0 --open\nackit mcp serve

Exit codes

0 success, 1 threshold failure, 2 usage/configuration, 3 environment, 4 security, 5 internal error.

`}, {slug:'readiness',title:'Readiness',description:'Explainable ACKit repository readiness scoring.',body:`

Readiness

Readiness summarizes whether a repository exposes enough instructions, security controls, context discipline, task state, skills and policy for repeatable agent-assisted work.

ackit readiness\nackit readiness --fail-below 80 --strict\nackit readiness --baseline .ackit/readiness.json --compare

Score model

Six categories are weighted and renormalized when a category is not applicable. JSON output uses the stable ackit.readiness.v1 contract.

`}, {slug:'optimize',title:'Optimize',description:'Instruction and context hygiene advisor.',body:`

Optimize v2

Optimize finds redundant, conflicting or expensive repository instructions and produces evidence-backed recommendations.

ackit optimize --explain\nackit optimize --category instruction --min-severity medium --format json\nackit optimize --fix --dry-run
`}, {slug:'profiles',title:'Provider Profiles',description:'Provider-aware context profiles for coding agents.',body:`

Provider Profiles

ACKit ships profiles for Codex, Claude, Copilot, Gemini and a generic fallback.

ackit pack --profile codex --max-tokens 50000\nackit pack --profile claude\nackit pack --profile copilot\nackit pack --profile gemini
`}, @@ -141,21 +142,24 @@ function pages(version) { {slug:'rule-packs',title:'Rule Packs',description:'Declarative offline repository policy checks.',body:`

Rule / Policy Packs

Rule packs turn repository requirements into machine-checkable presence, pattern, config, dependency and instruction checks.

ackit policy check
`}, {slug:'workflows',title:'Workflows',description:'Staged ACKit workflow lifecycles with deterministic gates.',body:`

Workflows

Workflows run repository work through staged lifecycles (quick, standard, high-risk) with required artifacts and deterministic gates. Optional workflow: keys in ackit.yml tune the built-in profile minimums; repositories without them keep exact prior behavior.

ackit workflow set --profile standard\nackit workflow show\nackit workflow advance\nackit workflow verify --outcome pass
`}, {slug:'intent',title:'Intent',description:'Committed intent documents with fingerprints.',body:`

Intent

Intent documents capture the goal of a work item before implementation, with machine-path-independent fingerprints and secret-gated validation.

ackit intent new "ship offline packs"\nackit intent list\nackit intent validate\nackit intent fingerprint
`}, - {slug:'checkpoints',title:'Checkpoints',description:'Resumable checkpoints with handoff packs.',body:`

Checkpoints / Resume / Handoff

Checkpoints snapshot task state with deterministic resume context and handoff packs, so work survives provider switches and interruptions.

ackit checkpoint create --next-objective "wire gate" --next-path src/core --next-command "pnpm test" --next-expected "green"\nackit checkpoint show\nackit checkpoint validate\nackit checkpoint export\nackit task resume
`}, + {slug:'checkpoints',title:'Checkpoints',description:'Resumable checkpoints with verification-bound portable handoff.',body:`

Checkpoints / Resume / Handoff

Checkpoints snapshot task state with deterministic resume context and handoff packs, so work survives provider switches and interruptions.

ackit checkpoint create --next-objective "wire gate" --next-path src/core --next-command "pnpm test" --next-expected "green"\nackit checkpoint show\nackit checkpoint validate\nackit checkpoint export --format json --out .ackit/reviews/handoff.json\nackit checkpoint import .ackit/reviews/handoff.json\nackit task resume

Portable handoff v2

ackit.handoff.v2 binds task and workflow state, the checkpoint record, evidence presence, the verification binding (state and bundle digests) with the latest verdict trust summary, checkpoint staleness at export time, the canonical status snapshot (verbatim blockers plus derived next actions), a redaction manifest, and provider-neutral resume instructions. Imports validate against current disk state and stay read-only: fresh handoffs render resume context, moved state refuses with VERDICT-STATE-STALE, v1 markdown refuses with HANDOFF-V1-UNBOUND, malformed files with HANDOFF-INVALID, and unknown tasks with HANDOFF-TASK-UNKNOWN.

`}, {slug:'evidence',title:'Evidence',description:'Acceptance criteria linked to typed proof.',body:`

Evidence

The evidence registry links acceptance criteria to typed proof. Criteria sync from the task document; checkbox state is never copied, so implementation is never confused with verification.

ackit evidence sync\nackit evidence show\nackit evidence verify --criterion AC-001 --type test --ref "vitest run"\nackit evidence validate
`}, - {slug:'verification',title:'Verification',description:'Independent verification bundles and verdicts.',body:`

Verification / Verdicts

Verification bundles give a fresh independent verifier everything needed to judge a task; verdicts are append-only: PASS, PASS_WITH_WARNINGS, REWORK_REQUIRED or BLOCKED.

ackit verification bundle\nackit verification record --verdict ./verdict.yaml\nackit verification show
`}, + {slug:'verification',title:'Verification',description:'State-bound verification bundles and independent verdicts.',body:`

Verification / Verdicts

Verification bundles (ackit.verification-bundle.v2) give a fresh independent verifier everything needed to judge a task, bound to the exact state via stateDigest and bundleDigest. The verifier authors ackit.verdict.v1; ACKit persists a state-bound ackit.verdict.v2. Legacy v1 files stay readable as history but never satisfy a state-bound completion.

ackit verification bundle --format json --out .ackit/reviews/bundle.json\nackit verification record --verdict ./verdict.yaml --bundle .ackit/reviews/bundle.json\nackit verification show

Independence and freshness

Independence is proven by reviewedBundleDigest: fresh claims without bundle proof refuse with VERDICT-INDEPENDENCE-UNPROVEN, replayed content refuses with VERDICT-REPLAY-REJECTED, stale bundles with VERDICT-BUNDLE-MISMATCH, and moved state with VERDICT-STATE-STALE. Completion rechecks freshness; no cryptographic verifier identity is claimed.

`}, + {slug:'status',title:'Status',description:'Canonical read-only task status with blockers and next actions.',body:`

Status

ackit status [id] is the canonical read-only projection: task and stage, verbatim completion blockers, verification and checkpoint freshness, and derived next actions. Human output and stable ackit.status.v1 JSON describe the same snapshot; the command never mutates.

ackit status\nackit status TASK-0007\nackit --json status TASK-0007
`}, {slug:'drift',title:'Drift',description:'Deterministic workflow drift detection.',body:`

Drift

Drift detection reports deterministic findings when implementation diverges from the declared plan, with a managed pre-commit gate for the active workflow task.

ackit drift check\nackit drift check --ci\nackit drift check-active --ci
`}, {slug:'policy',title:'Policy',description:'Risk-tiered autonomy and review policy.',body:`

Policy

Policy v2 combines risk-tiered autonomy (tier0 through tier4, allow / ask / deny with deny winning across layers) with review policy on policy documents and configuration.

ackit policy check
`}, {slug:'roles',title:'Roles',description:'Portable data-only agent role contracts.',body:`

Roles

Role contracts describe researcher, architect, implementer, verifier, security-reviewer, documentation-reviewer and release-reviewer responsibilities as portable data-only documents.

ackit role list\nackit role show verifier\nackit role validate
`}, {slug:'skills',title:'Skills',description:'Open-standard agent skills management.',body:`

Skills

ACKit manages open-standard skills with lock-tracked installs, ownership and conflict handling, plus deterministic projections for Claude Code, Copilot and generic layouts.

ackit skills list\nackit skills validate\nackit skills install\nackit skills sync\nackit skills export --provider claude --out ./skills-out
`}, {slug:'sync',title:'Managed Sync',description:'Reconcile ACKit-owned managed assets after upgrades.',body:`

Managed Asset Sync

ackit sync reconciles ACKit-owned managed assets (instruction blocks and builtin skills) after upgrades. Write decisions are content-driven: upgrading the package alone never rewrites files.

ackit sync --dry-run\nackit sync --check\nackit sync\nackit sync --force
`}, {slug:'github-action',title:'GitHub Action',description:'Run ACKit repository checks in GitHub Actions.',body:`

GitHub Action

Use the official action for repeatable repository checks in CI with least-privilege permissions.

permissions:\n  contents: read\njobs:\n  ackit:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@f548e57e544e1ff5a4c46bf1e1b8685f8e4a348a\n      - uses: Cynrath/agent-context-kit@v${esc(version)}\n        with:\n          command: scan\n          args: "--json"\n          fail-threshold: high\n          upload-sarif: "false"
`}, - {slug:'mcp',title:'MCP',description:'Local Model Context Protocol integration for ACKit.',body:`

MCP

ACKit exposes a local stdio MCP server for read-oriented repository inspection. No remote transport is required.

{ "mcpServers": { "ackit": { "command": "ackit", "args": ["mcp", "serve"] } } }
`}, - {slug:'sdk',title:'SDK',description:'Programmatic ACKit repository analysis.',body:`

SDK

The ESM SDK exposes the same deterministic repository analysis primitives used by the CLI.

import { scanRepository } from "@cynrath/agent-context-kit";\nconst result = await scanRepository({ canonicalPath: process.cwd() });
`}, + {slug:'mcp',title:'MCP',description:'Local Model Context Protocol integration for ACKit.',body:`

MCP

ACKit exposes a local stdio MCP server for read-oriented repository inspection (16 read-only tools including canonical ackit_status). No remote transport is required.

{ "mcpServers": { "ackit": { "command": "ackit", "args": ["mcp", "serve"] } } }
`}, + {slug:'sdk',title:'SDK',description:'Programmatic ACKit repository analysis.',body:`

SDK

The ESM SDK exposes the same deterministic repository analysis primitives used by the CLI.

import { scanRepository } from "@cynrath/agent-context-kit";\nconst result = await scanRepository({ canonicalPath: process.cwd() });

Read-model parity: buildStatusReport and renderStatusReport project the same ackit.status.v1 snapshot as ackit status; handoff and independence exports share the CLI contract.

`}, + {slug:'provider-surfaces',title:'Provider Surfaces',description:'Canonical provider-surface mapping with CLI, SDK, MCP, Action and VS Code parity.',body:`

Provider Surfaces

ACKit projects one canonical workflow, evidence, verdict, and status snapshot across every integration surface. Primary-source dates and caveats live with the product docs.

CLI (ackit status), SDK (buildStatusReport), read-only MCP (ackit_status), the GitHub Action (command: status), and the VS Code Tasks view all expose the same snapshot.

`}, + {slug:'trust-flow',title:'Trust Flow',description:'Reproducible verification-bound trust flow from evidence to resume.',body:`

Trust Flow

One reproducible offline arc: missing evidence and verdicts block completion, a bound independent verdict enables it, a state mutation stales it, fresh re-verification restores it, a checkpoint handoff exports it, and a second process resumes it with zero shared memory.

ackit task complete TASK-0007\nackit verification bundle TASK-0007 --format json --out .ackit/reviews/bundle.json\nackit verification record TASK-0007 --verdict .ackit/reviews/verdict.yaml --bundle .ackit/reviews/bundle.json\nackit status TASK-0007\nackit checkpoint export TASK-0007 --format json --out .ackit/reviews/handoff.json\nackit checkpoint import .ackit/reviews/handoff.json

Executed by tests/e2e/trust-flow-demo.test.ts and walked through in the product guide docs/guides/demo-trust-flow.md.

`}, {slug:'dashboard',title:'Dashboard',description:'Local ACKit dashboard and live repository views.',body:`

Dashboard

The dashboard binds to localhost by default and provides local views for scan results, graph, readiness, tasks and policy.

ackit dashboard --port 0 --open\nackit report serve ./report.html --port 0
`}, {slug:'diagnostics',title:'Diagnostics',description:'ACKit environment and support diagnostics.',body:`

Diagnostics

Diagnostics describe the local environment, configuration, cache, policy and task state without exposing plaintext secrets.

ackit diagnostics --json\nackit diagnostics bundle --out ./ackit-diag.zip --redact-check
`}, - {slug:'vscode',title:'VS Code',description:'AgentContextKit VS Code extension.',body:`

VS Code

Cynrath.ackit-vscode surfaces readiness, findings, instructions, tasks, policy and diagnostics inside VS Code.

code --install-extension Cynrath.ackit-vscode
`}, - {slug:'security',title:'Security',description:'ACKit offline-first threat model and redaction guarantees.',body:`

Security

Offline-first: product analysis is designed for zero outbound repository-data egress after installation.

`}, + {slug:'vscode',title:'VS Code',description:'AgentContextKit VS Code extension.',body:`

VS Code

Cynrath.ackit-vscode surfaces readiness, findings, instructions, tasks, policy and diagnostics inside VS Code. The Tasks view renders the canonical status snapshot (blockers plus next actions) with no write paths added.

code --install-extension Cynrath.ackit-vscode
`}, + {slug:'security',title:'Security',description:'ACKit offline-first threat model and redaction guarantees.',body:`

Security

Offline-first: product analysis is designed for zero outbound repository-data egress after installation.

`}, {slug:'benchmarks',title:'Benchmarks',description:'Deterministic ACKit performance benchmarks.',body:`

Benchmarks

ACKit benchmarks cold scan, warm scan, incremental scan, memory, throughput, context-pack construction, instruction-graph construction and cache behavior.

node benchmarks/run.mjs --classes small --out /tmp/out\nnode benchmarks/check-thresholds.mjs
`}, {slug:'migration',title:'Migration',description:'Upgrade AgentContextKit to the current release.',body:`

Migration

Upgrade the package, GitHub Action and VS Code extension together so repository tooling stays on the same release line.

npm install --global @cynrath/agent-context-kit@${esc(version)}\nackit --version\nackit sync --check
`} ]; diff --git a/scripts/verify-site.mjs b/scripts/verify-site.mjs index 47ccaaf..8d08338 100644 --- a/scripts/verify-site.mjs +++ b/scripts/verify-site.mjs @@ -279,6 +279,71 @@ async function main() { } } + // 12. Root CURRENT surfaces track the generated docs version (derived, never pinned here). + const docsVersion = [...foundVersions.keys()][0]; + if (docsVersion !== undefined) { + const rootHtml = await fsp.readFile(path.join(siteRoot, "index.html"), "utf8").catch(() => null); + if (rootHtml === null) { + fail("root index.html is missing"); + } else { + for (const match of rootHtml.matchAll(/"softwareVersion":"(\d+\.\d+\.\d+)"/g)) { + if (match[1] !== docsVersion) { + fail(`root JSON-LD softwareVersion ${match[1]} != generated docs version ${docsVersion}`); + } + } + if (!rootHtml.includes(`"softwareVersion":"${docsVersion}"`)) { + fail(`root JSON-LD softwareVersion != generated docs version ${docsVersion}`); + } + for (const match of rootHtml.matchAll(/@cynrath\/agent-context-kit@(\d+\.\d+\.\d+)/g)) { + if (match[1] !== docsVersion) { + fail(`root install pin @${match[1]} != generated docs version ${docsVersion}`); + } + } + if (!rootHtml.includes(`@cynrath/agent-context-kit@${docsVersion}`)) { + fail(`root install pin != generated docs version ${docsVersion}`); + } + let rootVersionHits = 0; + for (const match of rootHtml.matchAll(/>v(\d+\.\d+\.\d+) null); + if (text === null) { + fail(`${posix(absolute)} is missing`); + return; + } + for (const marker of markers) { + if (!text.includes(marker)) fail(`${posix(absolute)}: missing marker ${marker}`); + } + } + await requireMarker("cli/index.html", ["ackit status", "checkpoint import"]); + await requireMarker("verification/index.html", [ + "verification-bundle.v2", + "reviewedBundleDigest", + "VERDICT-INDEPENDENCE-UNPROVEN", + ]); + await requireMarker("checkpoints/index.html", ["ackit.handoff.v2", "checkpoint import"]); + for (const page of ["status/index.html", "provider-surfaces/index.html", "trust-flow/index.html"]) { + if (!(await existsFile(path.join(docsRoot, page)))) fail(`agent-context-kit/${page} is missing`); + } + const llmsTxt = await fsp.readFile(path.join(docsRoot, "llms.txt"), "utf8").catch(() => null); + if (llmsTxt === null) { + fail("agent-context-kit/llms.txt is missing"); + } else { + for (const link of ["/status/", "/provider-surfaces/", "/trust-flow/"]) { + if (!llmsTxt.includes(link)) fail(`agent-context-kit/llms.txt: missing link ${link}`); + } + } + if (failures.length > 0) { for (const failure of failures) process.stdout.write(`FAIL ${failure}\n`); process.stdout.write(`docs-integrity: ${failures.length} failure(s)\n`); diff --git a/sitemap.xml b/sitemap.xml index 6af878a..4cbb9cd 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -72,6 +72,10 @@ https://cynrath.github.io/agent-context-kit/profiles/ 2026-09-06 + + https://cynrath.github.io/agent-context-kit/provider-surfaces/ + 2026-09-06 + https://cynrath.github.io/agent-context-kit/readiness/ 2026-09-06 @@ -96,10 +100,18 @@ https://cynrath.github.io/agent-context-kit/skills/ 2026-09-06 + + https://cynrath.github.io/agent-context-kit/status/ + 2026-09-06 + https://cynrath.github.io/agent-context-kit/sync/ 2026-09-06 + + https://cynrath.github.io/agent-context-kit/trust-flow/ + 2026-09-06 + https://cynrath.github.io/agent-context-kit/verification/ 2026-09-06