@jaimevalasek/aioson 1.29.1 → 1.30.1

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.30.1] - 2026-06-23
+
+### Added
+- **AIOSON Play app compatibility docs.** Added curated `.aioson/docs/play/` guidance for agents building apps that target AIOSON Play, shipped through the install/update template. It covers manifest/runtime behavior, ports, ProductBridge, `/api/aioson-play`, LLM env injection, app-owned databases, Data Bindings, auth, services, and local testing.
+- **Framework integration docs surface.** Added `.aioson/docs/integrations/dashboard-app-form-publish-mapping.md` as a framework-managed integration reference and shipped it through the install/update template.
+
+### Fixed
+- **Preservative integration docs update.** `update` now has regression coverage proving official framework integration docs are refreshed while project-owned files in `.aioson/docs/integrations/` remain untouched.
+
+## [1.30.0] - 2026-06-22
+
+### Added
+- **Context intelligence and hygiene tooling.** Added the `context:brief` recall path, operational `context:guard` hook adapter/injection flow, guard rule attribution, and the read-only `hygiene:scan` diagnostic for stale session/context noise.
+- **Gate D proof hardening.** Added AC-to-test audit and evidence-gated Gate D expectations across SDD, QA, and agent contracts.
+
+### Changed
+- **Agent context loading now uses canonical context paths.** Gateway and agent prompts resolve `project-pulse.md`, `features.md`, `dev-state.md`, `last-handoff.json`, and `workflow.state.json` to `.aioson/context/`, preventing root or `.aioson/` misreads during activation recovery.
+- **Feature routing and recall are stricter.** Slug resolution, recall index isolation, `context:guard` salience, and selected-context loading were tightened across the spec chain.
+
+### Fixed
+- **Context intelligence safety fixes.** Hardened hook agent-name validation, tester test-plan/test-inventory scoping, Sheldon validation scoping, deleted-file recall cleanup, Windows temp-dir cleanup, and the context subsystem P1-P5 audit findings.
+- **Feature archive restore cleanup.** Retried empty archive-directory removal during restore to avoid leaving `.aioson/context/done/{slug}/` behind on transient Windows filesystem locks.
+
+## [1.29.2] - 2026-06-13
+
+### Fixed
+- **`aioson system:publish` crashava com `Error: archiver is not a function`.** O `archiver` tinha sido atualizado para `^8.0.0`, uma reescrita ESM que removeu a API chamável `archiver('zip', opts)` e passou a exportar só classes nomeadas (`Archiver`, `ZipArchive`, …) — sem função default. Fixado de volta em `^7.0.1` (CommonJS, API chamável que `createZipBuffer` em `src/commands/store-system.js` espera), o que também elimina o `ExperimentalWarning` de ESM-em-require no Node 23.
+
 ## [1.29.1] - 2026-06-12
 
 ### Docs

package/README.md

@@ -246,7 +246,7 @@ aioson context:monitor     # ASCII bars, warning/critical detection
 ```
 ```
 Context usage ████████████░░░░ 73%  ⚠ approaching threshold (SMALL: 65%)
-Agents recommend /clear before next phase
+Agents recommend /compact before the next same-feature phase; /clear is reserved for hard resets
 ```
 
 **FTS5 Search Index** — find anything across all your project artifacts in milliseconds:
@@ -730,10 +730,12 @@ aioson intake:ask [path] --agent=<agent> --schema=<questions.json> [--out=<answe
 
 ```bash
 aioson preflight [path] [--json]
-aioson classify [path] [--json]
-aioson gate:check [path] --gate=A|B|C|D [--json]
-aioson artifact:validate [path] --feature=<slug> [--json]
-aioson detect:test-runner [path] [--json]
+aioson classify [path] [--json]
+aioson gate:check [path] --gate=A|B|C|D [--json]
+aioson artifact:validate [path] --feature=<slug> [--json]
+aioson ac:test-audit [path] --feature=<slug> [--json]
+aioson sdd:benchmark [path] --feature=<slug> [--json]
+aioson detect:test-runner [path] [--json]
 aioson agent:audit [path] [--json]
 aioson brief:gen [path] --feature=<slug> [--json]
 aioson verify:gate [path] --feature=<slug> [--json]

package/docs/en/5-reference/cli-reference.md

@@ -677,23 +677,53 @@ aioson harness:check . --slug=checkout
 # Run only a subset of criteria
 aioson harness:check . --slug=checkout --criteria=C1,C3
 
-# Custom timeout and JSON output (exit 0 = pass)
-aioson harness:check . --slug=checkout --timeout=120000 --json
+# Custom timeout and JSON output (exit 0 = pass)
+aioson harness:check . --slug=checkout --timeout=120000 --json
+
+# Strict mode: binary criteria without verification block the result
+aioson harness:check . --slug=checkout --strict
 ```
 
 **Options:**
 - `--slug=<feature>` — feature slug matching the harness contract. If omitted, the active contract is auto-discovered.
-- `--criteria=C1,C2` — run only the listed criteria instead of all verifiable ones.
-- `--timeout=<ms>` — per-criterion timeout override.
-- `--json` — structured output; exit code propagated.
+- `--criteria=C1,C2` — run only the listed criteria instead of all verifiable ones.
+- `--timeout=<ms>` — per-criterion timeout override.
+- `--strict` — fail when binary criteria lack executable `verification` or no executable criterion exists.
+- `--json` — structured output; exit code propagated.
 
 **What it does:** the `verification` field is authored per criterion by `@sheldon` for every mechanically-checkable `binary: true` criterion (prefer the project test runner; deterministic; cross-platform; exit 0 = pass). `harness:check` is the standalone deterministic verification of those criteria — it never touches the circuit-breaker state (that stays exclusive to `harness:validate`/`apply-validation`). Legacy contracts without `verification` remain valid; `validateContract` only emits an advisory **warning** for `binary: true` criteria lacking it. `@validator` runs `harness:check` first and copies the exit-code verdicts verbatim into `results[].passed`, LLM-judging only the criteria without `verification`.
 
-See [Executable verification](./executable-verification.md) for the full theme.
-
----
-
-## harness:validate
+See [Executable verification](./executable-verification.md) for the full theme.
+
+---
+
+## ac:test-audit
+
+Map declared acceptance criteria to deterministic test evidence.
+
+```bash
+aioson ac:test-audit . --feature=checkout
+aioson ac:test-audit . --feature=checkout --json
+```
+
+**What it does:** extracts `AC-*` IDs from `requirements-{slug}.md`, `prd-{slug}.md`, and `conformance-{slug}.yaml`, then checks whether each ID appears in a test file or an executable harness criterion. Gate D treats missing evidence as blocking when ACs are declared.
+
+---
+
+## sdd:benchmark
+
+Generate a deterministic SDD quality snapshot for a feature.
+
+```bash
+aioson sdd:benchmark . --feature=checkout
+aioson sdd:benchmark . --feature=checkout --strict --json
+```
+
+**What it does:** combines artifact presence, `spec:analyze`, and `ac:test-audit` into a reproducible score and writes `.aioson/context/retro/sdd-benchmark-{slug}.md`.
+
+---
+
+## harness:validate
 
 Generate the `validator-prompt.txt` for the binary success contract and append a self-contained **review payload** so the validator can judge in a fresh, isolated context. Consumes the verdict back through the circuit breaker.
 

package/docs/pt/4-agentes/pm.md

@@ -117,7 +117,7 @@ aioson workflow:status .
 **Feature MEDIUM (pré-dev):**
 - **Vem de:** `@discovery-design-doc`
 - **Produz:** `implementation-plan-{slug}.md` (Gate C)
-- **Vai para:** STOP — desenvolvedor faz `/clear` e ativa `/dev`
+- **Vai para:** STOP — desenvolvedor faz `/compact` e ativa `/dev` quando continuar a mesma feature; usa `/clear` só para reset forte
 
 **Projeto MEDIUM (modo completo):**
 - **Vem de:** `@ux-ui`

package/docs/pt/5-referencia/autopilot-handoff.md

@@ -33,7 +33,7 @@ Sem essa flag (ou com `false`), o comportamento padrão é handoff manual — ca
         STOP — human entra com /dev
 ```
 
-A cadeia pré-dev **sempre para antes do primeiro `@dev`**. O desenvolvedor faz `/clear` (limpa o contexto) e inicia a implementação numa janela de contexto fresca — `@dev` é pesado e se beneficia de contexto limpo.
+A cadeia pré-dev **sempre para antes do primeiro `@dev`**. O desenvolvedor faz `/compact` quando continua a mesma feature e inicia a implementação a partir do pacote/checkpoint de contexto — `@dev` é pesado e se beneficia de um handoff operacional compacto. Use `/clear` apenas para reset forte, troca de feature, contexto poluído ou reset sensível a segurança.
 
 ### Segmento 2 — Ciclo de revisão pós-dev (hub = @qa)
 
@@ -87,7 +87,7 @@ O autopilot interrompe a cadeia e emite o handoff manual normal quando:
 3. **Cap de correções atingido** — ciclo `@qa` ↔ `@dev` limitado a 2 rounds.
 4. **Finding crítico de segurança** — keywords auth/secret/credential/session/password/token/PII detectados pelo gate de segurança do `@qa` → STOP, requer intervenção humana.
 5. **Verdict não passou** — `@scope-check` não aprovado, `@architect` Gate B bloqueado, `@discovery-design-doc` readiness bloqueado, `@pm` Gate C bloqueado, `@validator` FAIL sem caminho seguro → STOP, roteamento manual.
-6. **Orçamento de contexto** — uso ≥ `context_warning_threshold`: grava checkpoint em `last-handoff.json`, STOP, recomenda `/clear`. A próxima sessão reentra no autopilot automaticamente.
+6. **Orçamento de contexto** — uso ≥ `context_warning_threshold`: grava checkpoint em `last-handoff.json`, STOP, recomenda `/compact` para continuidade na mesma feature. A próxima sessão reentra no autopilot automaticamente. Use `/clear` apenas para reset forte, troca de feature, contexto poluído ou reset sensível a segurança.
 7. **Ambiguidade** — estado do workflow indisponível ou qualquer decisão real requer input humano → STOP.
 
 O usuário pode interromper a qualquer momento com Ctrl+C. O autopilot nunca retenta uma invocação interrompida.
@@ -130,9 +130,9 @@ Você > /analyst  (start)
 @scope-check → pre-dev check → autopilot: invocando @architect
 @architect   → Gate B PASS → autopilot: invocando @discovery-design-doc
 @discovery-design-doc → readiness ok → autopilot: invocando @pm (MEDIUM)
-@pm          → Gate C PASS → STOP — "Recomendo /clear e /dev"
+@pm          → Gate C PASS → STOP — "Recomendo /compact e /dev"
 
-Você > /clear
+Você > /compact
 Você > /dev  (implementação manual — contexto limpo)
 
 @dev → testes ok → autopilot retoma: invocando @qa

package/docs/pt/5-referencia/comandos-cli.md

@@ -226,8 +226,10 @@ Scripts determinísticos que movem verificações de estado, validação de arte
 | `feature:archive` | Move artefatos de uma feature `done` para `.aioson/context/done/{slug}/` e atualiza o manifest | Chamado pelo `feature:close` automaticamente; também disponível para retroativo com `--dry-run` e `--restore` |
 | `feature:export` | **Copia** todos os artefatos de uma feature para um `--out` limpo, sem mexer na origem; gera `INDEX.md` | Exportar specs para analisar fora, entregar a cliente, ou usar o AIOSON só como gerador de specs. Veja [feature-export.md](./feature-export.md) |
 | `gate:check` | Valida pré-requisitos e artefatos de um phase gate (A/B/C/D); retorna PASS ou BLOCKED | Antes de avançar para o próximo agente |
-| `artifact:validate` | Verifica a cadeia completa de artefatos de uma feature (PRD → spec → plano → conformance) | A qualquer momento para checar completude |
-| `spec:analyze` | Irmão de **conteúdo** do `artifact:validate`: consistência cruzada entre os artefatos (rastreabilidade REQ/AC, staleness, readiness, sanidade do contrato, vínculo AC→contrato, overlap de waves) antes do gate de execução | No preflight do `@scope-check` — errors viram blockers, warnings viram evidência de drift |
+| `artifact:validate` | Verifica a cadeia completa de artefatos de uma feature (PRD → spec → plano → conformance) | A qualquer momento para checar completude |
+| `ac:test-audit` | Mapeia cada `AC-*` declarado em PRD/requisitos/conformance para evidência em testes ou critério executável do harness | Antes do Gate D; falha quando algum AC não tem prova de teste |
+| `sdd:benchmark` | Gera score determinístico de SDD usando cadeia de artefatos, `spec:analyze` e `ac:test-audit`; salva relatório em `.aioson/context/retro/` | Para medir a qualidade do harness sem depender de julgamento solto |
+| `spec:analyze` | Irmão de **conteúdo** do `artifact:validate`: consistência cruzada entre os artefatos (rastreabilidade REQ/AC, staleness, readiness, sanidade do contrato, vínculo AC→contrato, overlap de waves) antes do gate de execução | No preflight do `@scope-check` — errors viram blockers, warnings viram evidência de drift |
 | `forge:compile` | **Lane B:** compila os artefatos de uma feature MEDIUM num `forge-run.workflow.js` auditável e versionável (parallel por Wave → convergência no `harness:check` → revisão adversarial → validador fresh-context) | Quando quer execução compilada e reproduzível via `@forge-run`; nunca roda `feature:close`/publish |
 | `workflow:execute` | Monta e executa o plano de agentes baseado na classificação; aceita `--dry-run` e `--start-from` | Para orquestrar features sem o dashboard |
 | `runner:run` | Executa uma tarefa ou worker diretamente pelo runner | Quando quer executar fora do loop principal de sessão |
@@ -987,7 +989,7 @@ O manifest em `.aioson/context/done/MANIFEST.md` registra todas as features arqu
 # Verificar se está no safe zone (< 60%), warning (60–80%) ou critical (≥ 80%)
 aioson context:monitor . --budget=80000 --tokens=52000
 # ⚠ Context: 52,000 tokens (65%) — WARNING
-# Suggestion: /clear before next agent activation
+# Suggestion: /compact before next agent activation; use /clear only for a hard reset
 
 # Verificar com output JSON para integrar em scripts
 aioson context:monitor . --budget=80000 --tokens=67000 --json

package/docs/pt/5-referencia/fluxo-artefatos.md

@@ -52,7 +52,7 @@ O PRD produzido pelo @product é o **documento base vivo** — nenhum agente dow
 - `sheldon-enrichment-{slug}.md` (ou `sheldon-enrichment.md`) em `.aioson/context/` — log de cada rodada, decisões de gray areas, score e readiness
 
 **No Modo C (validação completa)**, gera adicionalmente:
-- `sheldon-validation.md` — relatório de auditoria com gate por agente (🟢/🟡/🔴)
+- `sheldon-validation-{slug}.md` (projeto: `sheldon-validation.md`) — relatório de auditoria com gate por agente (🟢/🟡/🔴)
 - `.aioson/plans/{slug}/checklist.md` — checklist de implementação por fase
 
 **Pesquisas web (RF-WEB)** ficam em:

package/docs/pt/5-referencia/memoria-e-contexto.md

@@ -229,13 +229,13 @@ aioson context:monitor . --budget=80000 --tokens=52000
 
 ```
   ⚠ Context: 52,000 tokens (65%) — WARNING
-  Suggestion: /clear before next agent activation
+  Suggestion: /compact before next agent activation; use /clear only for a hard reset
 ```
 
 | Zona | Faixa | Ação |
 |---|---|---|
 | safe | < 60% | Continuar normalmente |
-| warning | 60–80% | Planejar `/clear` antes do próximo agente |
+| warning | 60–80% | Planejar `/compact` antes do próximo agente; usar `/clear` só para reset forte |
 | critical | ≥ 80% | Rodar `context:health` e reduzir carga |
 
 **Thresholds por classificação** (para automonitoramento dos agentes, configurado em `.aioson/config.md`):

package/docs/pt/_arquivo/monitor-de-contexto.md

@@ -69,7 +69,7 @@ aioson context:monitor [path] --budget=<tokens-totais> --tokens=<tokens-atuais>
 | Zona | Faixa | Ícone | Ação sugerida |
 |---|---|---|---|
 | safe | < 60% | ✓ | Continuar normalmente |
-| warning | 60–80% | ⚠ | Planejar `/clear` antes do próximo agente |
+| warning | 60–80% | ⚠ | Planejar `/compact` antes do próximo agente; usar `/clear` só para reset forte |
 | critical | ≥ 80% | ! | Rodar `context:health` e reduzir carga |
 
 **Exemplos:**
@@ -82,7 +82,7 @@ aioson context:monitor . --budget=80000 --tokens=28000
 # Sessão em warning zone
 aioson context:monitor . --budget=80000 --tokens=52000
 #   ⚠ Context: 52,000 tokens (65%) — WARNING
-#   Suggestion: /clear before next agent activation
+#   Suggestion: /compact before next agent activation; use /clear only for a hard reset
 
 # Sessão em critical zone
 aioson context:monitor . --budget=80000 --tokens=67000

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaimevalasek/aioson",
-  "version": "1.29.1",
+  "version": "1.30.1",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",
@@ -46,8 +46,10 @@
     "ci": "npm run lint && npm test"
   },
   "dependencies": {
-    "archiver": "^8.0.0",
+    "archiver": "^7.0.1",
     "better-sqlite3": "^12.6.2",
+    "ignore": "^7.0.5",
+    "javascript-obfuscator": "^5.4.3",
     "terser": "^5.48.0"
   }
 }

package/src/cli.js

@@ -14,6 +14,7 @@ const { runAgentsList, runAgentPrompt } = require('./commands/agents');
 const { runContextValidate } = require('./commands/context-validate');
 const { runContextPack } = require('./commands/context-pack');
 const { runContextSelect } = require('./commands/context-select');
+const { runContextBrief } = require('./commands/context-brief');
 const { runRulesLint } = require('./commands/rules-lint');
 const { runContextLoad } = require('./commands/context-load');
 const { runChainAudit } = require('./commands/chain-audit');
@@ -148,15 +149,17 @@ const { runBackupLocal } = require('./commands/backup-local-cmd');
 const { runRecoveryGenerate, runRecoveryShow } = require('./commands/recovery');
 const { runContextMonitor } = require('./commands/context-monitor');
 const { runContextSearch, runContextSearchIndex } = require('./commands/context-search');
+const { runContextGuard } = require('./commands/context-guard');
 const { runContextCacheList, runContextCacheSave, runContextCacheRestore, runContextCacheCleanup } = require('./commands/context-cache');
 const { runSandboxExec } = require('./commands/sandbox');
 const { runAgentLoad, runAgentShardIndex } = require('./commands/agent-loader');
 const { runLearningEvolve, runLearningApply } = require('./commands/learning-evolve');
 const { runLearningRollback } = require('./commands/learning-rollback');
-const { runToolRegistry } = require('./commands/tool-registry-cmd');
-const { runHealth } = require('./commands/health');
-const { runContextHealth } = require('./commands/context-health');
-const { runContextTrim } = require('./commands/context-trim');
+const { runToolRegistry } = require('./commands/tool-registry-cmd');
+const { runHealth } = require('./commands/health');
+const { runContextHealth } = require('./commands/context-health');
+const { runHygieneScan } = require('./commands/hygiene-scan');
+const { runContextTrim } = require('./commands/context-trim');
 const { runHooksEmit } = require('./commands/hooks-emit');
 const { runHooksInstall, runHooksUninstall } = require('./commands/hooks-install');
 const { runSessionGuard } = require('./commands/session-guard');
@@ -198,12 +201,15 @@ const { runOpMigrate } = require('./commands/op-migrate');
 const { runFeatureClose } = require('./commands/feature-close');
 const { runFeatureArchive, runFeatureSweep } = require('./commands/feature-archive');
 const { runFeatureExport } = require('./commands/feature-export');
+const { runFeatureCurrent } = require('./commands/feature-current');
 const { runDossierInit, runDossierShow, runDossierAddFinding, runDossierAddCodemap, runDossierLinkRule, runDossierCompact } = require('./commands/dossier');
 const { runDossierAddResearch } = require('./commands/dossier-add-research');
 const { runDossierAudit } = require('./commands/dossier-audit');
 const { runDevResumeData } = require('./commands/dev-resume');
-const { runRevisionOpen, runRevisionList, runRevisionResolve } = require('./commands/revision');
-const { runGateCheck } = require('./commands/gate-check');
+const { runRevisionOpen, runRevisionList, runRevisionResolve } = require('./commands/revision');
+const { runAcTestAudit } = require('./commands/ac-test-audit');
+const { runSddBenchmark } = require('./commands/sdd-benchmark');
+const { runGateCheck } = require('./commands/gate-check');
 const { runGateApprove } = require('./commands/gate-approve');
 const { runArtifactValidate } = require('./commands/artifact-validate');
 const { runWorkflowExecute } = require('./commands/workflow-execute');
@@ -258,6 +264,10 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'context-pack',
   'context:select',
   'context-select',
+  'context:brief',
+  'context-brief',
+  'context:guard',
+  'context-guard',
   'rules:lint',
   'rules-lint',
   'context:load',
@@ -278,6 +288,8 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'workflow-next',
   'workflow:status',
   'workflow-status',
+  'feature:current',
+  'feature-current',
   'harness:retro',
   'harness-retro',
   'harness:preview',
@@ -599,12 +611,16 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'recovery-show',
   'context:monitor',
   'context-monitor',
-  'context:health',
-  'context-health',
-  'context:trim',
+  'context:health',
+  'context-health',
+  'hygiene:scan',
+  'hygiene-scan',
+  'context:trim',
   'context-trim',
   'context:search',
   'context-search',
+  'context:index',
+  'context-index',
   'context:search:index',
   'context-search-index',
   'context:cache',
@@ -669,6 +685,8 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'feature-sweep',
   'feature:export',
   'feature-export',
+  'feature:current',
+  'feature-current',
   'dossier:init',
   'dossier-init',
   'dossier:show',
@@ -691,9 +709,13 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'revision-open',
   'revision:list',
   'revision-list',
-  'revision:resolve',
-  'revision-resolve',
-  'gate:check',
+  'revision:resolve',
+  'revision-resolve',
+  'ac:test-audit',
+  'ac-test-audit',
+  'sdd:benchmark',
+  'sdd-benchmark',
+  'gate:check',
   'gate-check',
   'gate:approve',
   'gate-approve',
@@ -810,9 +832,10 @@ function printHelp(t, logger) {
   logHelpLine(t, logger, 'cli.help_install');
   logHelpLine(t, logger, 'cli.help_setup');
   logHelpLine(t, logger, 'cli.help_update');
-  logHelpLine(t, logger, 'cli.help_info');
-  logHelpLine(t, logger, 'cli.help_doctor');
-  logHelpLine(t, logger, 'cli.help_i18n_add');
+  logHelpLine(t, logger, 'cli.help_info');
+  logHelpLine(t, logger, 'cli.help_doctor');
+  logHelpLine(t, logger, 'cli.help_hygiene_scan');
+  logHelpLine(t, logger, 'cli.help_i18n_add');
   logHelpLine(t, logger, 'cli.help_agents');
   logHelpLine(t, logger, 'cli.help_agent_prompt');
   logHelpLine(t, logger, 'cli.help_agent_help');
@@ -820,7 +843,10 @@ function printHelp(t, logger) {
   logHelpLine(t, logger, 'cli.help_agent_epilogue');
   logHelpLine(t, logger, 'cli.help_context_validate');
   logHelpLine(t, logger, 'cli.help_context_pack');
+  logHelpLine(t, logger, 'cli.help_context_search');
   logHelpLine(t, logger, 'cli.help_context_select');
+  logHelpLine(t, logger, 'cli.help_context_brief');
+  logHelpLine(t, logger, 'cli.help_context_guard');
   logHelpLine(t, logger, 'cli.help_context_load');
   logHelpLine(t, logger, 'cli.help_memory_status');
   logHelpLine(t, logger, 'cli.help_memory_summary');
@@ -1108,6 +1134,10 @@ async function main() {
       result = await runContextPack({ args, options, logger: commandLogger, t });
     } else if (command === 'context:select' || command === 'context-select') {
       result = await runContextSelect({ args, options, logger: commandLogger, t });
+    } else if (command === 'context:brief' || command === 'context-brief') {
+      result = await runContextBrief({ args, options, logger: commandLogger, t });
+    } else if (command === 'context:guard' || command === 'context-guard') {
+      result = await runContextGuard({ args, options, logger: commandLogger, t });
     } else if (command === 'rules:lint' || command === 'rules-lint') {
       result = await runRulesLint({ args, options, logger: commandLogger, t });
     } else if (command === 'context:load' || command === 'context-load') {
@@ -1510,13 +1540,20 @@ async function main() {
       result = await runRecoveryShow({ args, options, logger: commandLogger, t });
     } else if (command === 'context:monitor' || command === 'context-monitor') {
       result = await runContextMonitor({ args, options, logger: commandLogger, t });
-    } else if (command === 'context:health' || command === 'context-health') {
-      result = await runContextHealth({ args, options, logger: commandLogger });
-    } else if (command === 'context:trim' || command === 'context-trim') {
-      result = await runContextTrim({ args, options, logger: commandLogger });
+    } else if (command === 'context:health' || command === 'context-health') {
+      result = await runContextHealth({ args, options, logger: commandLogger });
+    } else if (command === 'hygiene:scan' || command === 'hygiene-scan') {
+      result = await runHygieneScan({ args, options, logger: commandLogger });
+    } else if (command === 'context:trim' || command === 'context-trim') {
+      result = await runContextTrim({ args, options, logger: commandLogger });
     } else if (command === 'context:search' || command === 'context-search') {
       result = await runContextSearch({ args, options, logger: commandLogger, t });
-    } else if (command === 'context:search:index' || command === 'context-search-index') {
+    } else if (
+      command === 'context:index' ||
+      command === 'context-index' ||
+      command === 'context:search:index' ||
+      command === 'context-search-index'
+    ) {
       result = await runContextSearchIndex({ args, options, logger: commandLogger, t });
     } else if (command === 'context:cache' || command === 'context-cache') {
       result = await runContextCacheList({ args, options, logger: commandLogger, t });
@@ -1596,6 +1633,8 @@ async function main() {
       result = await runFeatureSweep({ args, options, logger: commandLogger });
     } else if (command === 'feature:export' || command === 'feature-export') {
       result = await runFeatureExport({ args, options, logger: commandLogger });
+    } else if (command === 'feature:current' || command === 'feature-current') {
+      result = await runFeatureCurrent({ args, options, logger: commandLogger });
     } else if (command === 'dossier:init' || command === 'dossier-init') {
       result = await runDossierInit({ args, options, logger: commandLogger });
     } else if (command === 'dossier:show' || command === 'dossier-show') {
@@ -1618,10 +1657,14 @@ async function main() {
       result = await runRevisionOpen({ args, options, logger: commandLogger });
     } else if (command === 'revision:list' || command === 'revision-list') {
       result = await runRevisionList({ args, options, logger: commandLogger });
-    } else if (command === 'revision:resolve' || command === 'revision-resolve') {
-      result = await runRevisionResolve({ args, options, logger: commandLogger });
-    } else if (command === 'gate:check' || command === 'gate-check') {
-      result = await runGateCheck({ args, options, logger: commandLogger });
+    } else if (command === 'revision:resolve' || command === 'revision-resolve') {
+      result = await runRevisionResolve({ args, options, logger: commandLogger });
+    } else if (command === 'ac:test-audit' || command === 'ac-test-audit') {
+      result = await runAcTestAudit({ args, options, logger: commandLogger });
+    } else if (command === 'sdd:benchmark' || command === 'sdd-benchmark') {
+      result = await runSddBenchmark({ args, options, logger: commandLogger });
+    } else if (command === 'gate:check' || command === 'gate-check') {
+      result = await runGateCheck({ args, options, logger: commandLogger });
     } else if (command === 'gate:approve' || command === 'gate-approve') {
       result = await runGateApprove({ args, options, logger: commandLogger });
     } else if (command === 'artifact:validate' || command === 'artifact-validate') {

package/src/commands/ac-test-audit.js

@@ -0,0 +1,45 @@
+'use strict';
+
+const path = require('node:path');
+const { auditAcceptanceCriteriaTests } = require('../lib/ac-test-audit');
+
+async function runAcTestAudit({ args, options = {}, logger }) {
+  const targetDir = path.resolve(process.cwd(), args?.[0] || '.');
+  const slug = String(options.feature || options.slug || '').trim();
+
+  if (!slug) {
+    if (options.json) return { ok: false, error: 'missing_feature' };
+    logger.error('--feature=<slug> is required.');
+    return { ok: false, error: 'missing_feature' };
+  }
+
+  const report = await auditAcceptanceCriteriaTests(targetDir, slug);
+
+  if (options.json) {
+    logger.log(JSON.stringify(report, null, 2));
+    return report;
+  }
+
+  logger.log('');
+  logger.log(`AC test audit — ${slug}`);
+  logger.log('━'.repeat(45));
+  logger.log(`ACs: ${report.summary.covered}/${report.summary.acs_total} covered; tests scanned: ${report.summary.test_files_scanned}`);
+
+  if (report.summary.acs_total === 0) {
+    logger.log('No acceptance criteria IDs found in requirements, PRD, or conformance artifacts.');
+  } else {
+    for (const item of report.items) {
+      const mark = item.status === 'covered' ? '✓' : '✗';
+      const evidence = item.evidence.length
+        ? ` — ${item.evidence.map((e) => e.file).join(', ')}`
+        : '';
+      logger.log(`  ${mark} ${item.ac}: ${item.status}${evidence}`);
+    }
+  }
+
+  logger.log('');
+  logger.log(report.ok ? 'Result: PASS' : `Result: BLOCKED — missing tests for ${report.missing.join(', ')}`);
+  return report;
+}
+
+module.exports = { runAcTestAudit };