forjajs 4.0.1 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/CHANGELOG.md +170 -7
  2. package/DOC-MAP.md +1 -0
  3. package/README.md +10 -2
  4. package/README.pt-BR.md +3 -0
  5. package/dist/apps/cli/src/index.d.ts +18 -1
  6. package/dist/apps/cli/src/index.js +161 -26
  7. package/dist/apps/cli/src/params.d.ts +44 -0
  8. package/dist/apps/cli/src/params.js +123 -0
  9. package/dist/bin/forja.js +234 -13
  10. package/dist/bin/init-project.js +11 -62
  11. package/dist/lib/cli-output.d.ts +29 -0
  12. package/dist/lib/cli-output.js +39 -0
  13. package/dist/lib/core/checks.d.ts +1 -1
  14. package/dist/lib/core/health.d.ts +9 -0
  15. package/dist/lib/core/health.js +9 -0
  16. package/dist/lib/core/project-smoke.d.ts +6 -2
  17. package/dist/lib/core/project-smoke.js +83 -7
  18. package/dist/lib/core/registry.d.ts +38 -571
  19. package/dist/lib/core/registry.js +174 -25
  20. package/dist/lib/core/release.d.ts +1 -571
  21. package/dist/lib/core/release.js +0 -3
  22. package/dist/lib/handoffs-index.d.ts +16 -0
  23. package/dist/lib/handoffs-index.js +29 -0
  24. package/dist/lib/llm/claude-output.d.ts +8 -0
  25. package/dist/lib/llm/claude-output.js +54 -0
  26. package/dist/lib/llm/context.d.ts +22 -0
  27. package/dist/lib/llm/context.js +39 -0
  28. package/dist/lib/llm/session.d.ts +6 -1
  29. package/dist/lib/llm/session.js +12 -2
  30. package/dist/lib/multi-ai-instructions.d.ts +28 -0
  31. package/dist/lib/multi-ai-instructions.js +83 -0
  32. package/dist/lib/orchestrate.d.ts +5 -0
  33. package/dist/lib/orchestrate.js +18 -0
  34. package/dist/lib/specs-index.d.ts +20 -0
  35. package/dist/lib/specs-index.js +51 -0
  36. package/dist/lib/sprint-index.d.ts +15 -0
  37. package/dist/lib/sprint-index.js +34 -0
  38. package/dist/lib/status-model.d.ts +64 -0
  39. package/dist/lib/status-model.js +180 -0
  40. package/dist/packages/evals/src/index.d.ts +2 -0
  41. package/dist/packages/evals/src/index.js +21 -0
  42. package/dist/packages/llm/src/index.d.ts +24 -3
  43. package/dist/packages/llm/src/index.js +51 -5
  44. package/dist/scripts/cost-economy.js +12 -10
  45. package/dist/scripts/drift-check.d.ts +2 -0
  46. package/dist/scripts/drift-check.js +57 -1
  47. package/dist/scripts/engineer.js +7 -4
  48. package/dist/scripts/forja-setup.d.ts +14 -0
  49. package/dist/scripts/forja-setup.js +58 -0
  50. package/dist/scripts/forja-status.d.ts +11 -0
  51. package/dist/scripts/forja-status.js +70 -0
  52. package/dist/scripts/hook-session-start.js +20 -46
  53. package/dist/scripts/llm-fit.js +113 -8
  54. package/dist/scripts/project-smoke.js +13 -3
  55. package/dist/scripts/simulate.js +18 -6
  56. package/dist/scripts/token-economy.js +34 -28
  57. package/dist/scripts/tools-doctor.js +14 -6
  58. package/docs/2x/CLI-CAPABILITIES.md +34 -10
  59. package/docs/agent-operating-contract.md +3 -1
  60. package/docs/cli-first-operacao.md +17 -0
  61. package/docs/contrato-saida-cli.md +79 -0
  62. package/docs/llm-evolution.md +2 -1
  63. package/docs/llm-fit-loop.md +74 -2
  64. package/docs/publishing.md +13 -16
  65. package/docs/quick-reference.md +13 -0
  66. package/docs/roadmap-v4.1.md +199 -0
  67. package/memory/90-decisions/0082-contrato-saida-cli.md +95 -0
  68. package/memory/90-decisions/0083-mcp-cobertura-declarativa.md +103 -0
  69. package/memory/90-decisions/0084-drift-sentinel-fecha.md +79 -0
  70. package/memory/90-decisions/0085-adaptador-claude-paridade.md +85 -0
  71. package/package.json +4 -1
  72. package/specs/cli-intuitiva-v1/plan.md +169 -0
  73. package/specs/cli-intuitiva-v1/spec.md +163 -0
  74. package/specs/cli-intuitiva-v1/tasks.md +224 -0
  75. package/specs/contrato-saida-cli/plan.md +162 -0
  76. package/specs/contrato-saida-cli/spec.md +157 -0
  77. package/specs/contrato-saida-cli/tasks.md +153 -0
  78. package/specs/drift-sentinel/spec.md +17 -8
  79. package/specs/forja-status-caminho-feliz/plan.md +149 -0
  80. package/specs/forja-status-caminho-feliz/spec.md +158 -0
  81. package/specs/forja-status-caminho-feliz/tasks.md +175 -0
  82. package/specs/llm-adaptador-claude/plan.md +117 -0
  83. package/specs/llm-adaptador-claude/spec.md +144 -0
  84. package/specs/llm-adaptador-claude/tasks.md +100 -0
  85. package/specs/llm-benchmark-recomendacao/plan.md +121 -0
  86. package/specs/llm-benchmark-recomendacao/spec.md +141 -0
  87. package/specs/llm-benchmark-recomendacao/tasks.md +88 -0
  88. package/specs/llm-contexto-e-sessoes/plan.md +143 -0
  89. package/specs/llm-contexto-e-sessoes/spec.md +139 -0
  90. package/specs/llm-contexto-e-sessoes/tasks.md +127 -0
  91. package/specs/mcp-cobertura-nucleo/plan.md +158 -0
  92. package/specs/mcp-cobertura-nucleo/spec.md +161 -0
  93. package/specs/mcp-cobertura-nucleo/tasks.md +169 -0
  94. package/specs/projeto-gerado-confiavel/plan.md +148 -0
  95. package/specs/projeto-gerado-confiavel/spec.md +142 -0
  96. package/specs/projeto-gerado-confiavel/tasks.md +139 -0
@@ -0,0 +1,142 @@
1
+ # Spec: projeto-gerado-confiavel — smoke por `--ai` no CI + coerência multi-IA
2
+
3
+ - **ID**: SPEC-047
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-09-08
7
+ - **Sprint alvo**: <a definir>
8
+ - **ADRs relacionadas**: nenhuma — extensão de `project:smoke` (SPEC-015) e wiring de CI, sem
9
+ decisão estrutural. A geração multi-IA já parte de fonte única (`.gemini-instructions.md`).
10
+ - **Origem**: `docs/roadmap-v4.1.md`, Onda 3 (W7 + W8).
11
+
12
+ ## 1. Problema
13
+
14
+ **W7 — o smoke não varia por `--ai`.** `forja project:smoke` gera via
15
+ `bin/create-memory-nest-kit` direto (só memória) e roda no CI dentro do job `release-gate`, **sem
16
+ matriz e sem exercitar o `--ai`**. O caminho que um usuário de verdade usa — `init-project.ts`
17
+ com `--ai claude,copilot,…`, que escreve as instruções nativas por IA — nunca é validado
18
+ automaticamente. Uma quebra nesse caminho só aparece quando alguém gera um projeto à mão.
19
+
20
+ **W8 — não há check de que as instruções por IA concordam.** `init-project.ts step02` já deriva
21
+ cada `.ia-instructions/<ai>.md` de **uma** fonte (`.gemini-instructions.md`), trocando só o
22
+ cabeçalho. Mas nada verifica isso: uma edição que diverge o corpo de `claude.md` do de
23
+ `copilot.md`, ou um `models.json` com `fallback_chain` fora de sincronia com o `--ai` pedido,
24
+ passa batido. O check `agent-topology` que garante coerência existe **só para este repo**, não
25
+ para o projeto gerado.
26
+
27
+ **Como medimos hoje**: `ci.yml` roda `project:smoke` uma vez, tier barato, sem `--ai`. Nenhum
28
+ check de coerência multi-IA no gerado.
29
+
30
+ ## 2. Proposta de valor
31
+
32
+ `forja project:smoke --ai <lista>` gera pelo caminho real (`init-project.ts --skip-backend`) e
33
+ prova que o projeto sai coerente para aquela combinação de IAs — incluindo que as instruções
34
+ nativas derivam da mesma fonte. O CI roda isso numa matriz pequena de combinações a cada PR, no
35
+ tier barato (sem `npm install`). Uma quebra do gerador multi-IA falha o CI, não a máquina de
36
+ quem clona.
37
+
38
+ ## 3. User stories
39
+
40
+ - **Como** mantenedor do gerador, **quero** que um PR que quebra `init-project.ts --ai` falhe o
41
+ CI, **para que** eu não descubra pelo issue de um usuário.
42
+ - **Como** usuário que gera com `--ai claude,copilot`, **quero** garantia de que as duas
43
+ instruções têm o mesmo conteúdo, **para que** trocar de IA no meio do projeto não mude as regras.
44
+ - **Como** QA, **quero** `forja project:smoke --ai <lista>` rodável localmente, **para que** eu
45
+ reproduza o cenário do CI sem esperar o pipeline.
46
+
47
+ ## 4. Critérios de aceite (Definition of Done)
48
+
49
+ - [ ] **AC-1**: `runProjectSmoke({ ai?: string[] })` — quando `ai` é passado, gera via
50
+ `bin/init-project.ts <dir> --ai <lista> --skip-backend --force` em vez de
51
+ `create-memory-nest-kit` direto. Sem `ai`, comportamento atual inalterado.
52
+ - [ ] **AC-2**: `forja project:smoke --ai claude,copilot` (CLI) — parseia a lista, chama
53
+ `runProjectSmoke({ ai })`, mesma saída/veredito/exit code do smoke atual.
54
+ - [ ] **AC-3**: novo check `aiInstructionsCoherent` (só quando `ai` foi pedido): para cada `<ai>`
55
+ da lista, `.ia-instructions/<ai>.md` existe; o corpo (sem as 2 linhas de cabeçalho que
56
+ `step02` reescreve) é **idêntico** entre todos os `<ai>.md` da lista;
57
+ `.ia-instructions/models.json` tem `fallback_chain` === a lista pedida e uma entrada em
58
+ `engines` por IA. Falha crítica se divergir.
59
+ - [ ] **AC-4**: os checks existentes (`noPlaceholders`, `jsonValid`, `structure`,
60
+ `gateInherited`) rodam sobre a saída do `init-project.ts` também (não só a do
61
+ `create-memory-nest-kit`).
62
+ - [ ] **AC-5**: `.github/workflows/ci.yml` — job/step novo em **matriz** sobre 3 combinações
63
+ (`claude` · `copilot` · `claude,copilot,gemini,codex`) rodando
64
+ `node bin/forja.ts project:smoke --ai <combo>` no tier barato. Roda em PR e push.
65
+ - [ ] **AC-6**: `test/project-smoke.test.js` (ou novo) — `runProjectSmoke({ ai: ['claude','copilot'] })`
66
+ num tmp: gera, `aiInstructionsCoherent` verde; um teste que injeta divergência (edita um
67
+ `<ai>.md`) e vê o check reprovar.
68
+ - [ ] **AC-7**: `forja project:smoke --ai claude,copilot,gemini,codex` local passa (tier barato).
69
+ - [ ] **AC-8**: `tsc --noEmit`, `node --test test/*.test.js`, `forja spec:check`,
70
+ `forja project:check` verdes; `ci.yml` continua válido (lint de workflow / `act` se disponível,
71
+ senão revisão).
72
+
73
+ ## 5. Escopo
74
+
75
+ **Dentro**:
76
+ - `lib/core/project-smoke.ts` — opção `ai` em `withGeneratedProject`/`runProjectSmoke`; branch de
77
+ geração via `init-project.ts`; check `aiInstructionsCoherent`.
78
+ - `scripts/project-smoke.ts` — flag `--ai <lista>`.
79
+ - `.github/workflows/ci.yml` — matriz de combinações no tier barato.
80
+ - `lib/core/registry.ts` — `--ai` no `usage`/`examples` de `project:smoke`.
81
+ - Testes; nota em `docs/` (quick-reference / dev-workflow) sobre `project:smoke --ai`.
82
+
83
+ **Fora** (evita scope creep):
84
+ - Rodar `npm install && npm test` do projeto gerado no CI a cada PR (é o tier `--full`, minutos ×
85
+ matriz) — fica opt-in / pré-release, no máximo 1 combinação.
86
+ - Reescrever `init-project.ts` ou o modelo de geração multi-IA (já parte de fonte única).
87
+ - `project:upgrade`, boilerplates, `exemplo-v3`.
88
+ - Portar o `agent-topology` inteiro para o gerado — o check aqui é focado nas instruções nativas.
89
+
90
+ ## 6. NFRs / restrições
91
+
92
+ - **Performance**: o step de matriz roda `init-project.ts --skip-backend` (memória + instruções,
93
+ sem rede) — segundos por célula. 3 células.
94
+ - **Compatibilidade**: `project:smoke` sem `--ai` inalterado (o `release-gate` do CI segue igual).
95
+ - **Segurança**: geração em `mkdtemp` isolado, limpo sempre (contrato de `withGeneratedProject`).
96
+ - **Observabilidade**: o smoke já usa o runner de `checks.ts` (mesmo do doctor/release).
97
+
98
+ ## 7. Riscos e mitigação
99
+
100
+ | Risco | Probabilidade | Impacto | Mitigação |
101
+ |---|---|---|---|
102
+ | `init-project.ts` puxa rede mesmo com `--skip-backend` | M | A | Verificar no plan; se puxar, isolar o step de instruções ou usar `--only-memory` + chamada direta de `step02` |
103
+ | A "linha de cabeçalho" que `step02` reescreve muda de formato e o check de corpo-idêntico fica frágil | M | M | O check normaliza removendo linhas que casam os 2 regexes de `step02`, não um número fixo de linhas |
104
+ | Matriz de 3 células triplica o tempo de um job | B | B | Tier barato (segundos); célula isolada; `fail-fast: false` para ver todas |
105
+ | `init-project.ts` escreve fora do `projectDir` (ex.: `~/.forjarc`) | B | M | `HOME`/`FORJA_WORKSPACE` apontados para o tmp no `spawn` do smoke |
106
+
107
+ ## 8. Métricas de sucesso
108
+
109
+ 30 dias:
110
+
111
+ - Todo PR roda a matriz `project:smoke --ai`; um PR que quebra o gerador multi-IA fica vermelho
112
+ antes do merge (observado ao menos 1×, ou confirmado por um teste de regressão que injeta a quebra).
113
+ - Zero divergência de corpo entre `.ia-instructions/<ai>.md` num projeto gerado (medido pelo check).
114
+ - `forja project:smoke --ai <lista>` roda local em < 30 s.
115
+
116
+ ## Evidências e estado real
117
+
118
+ **Implementado em 2026-09-08** na branch `feat/projeto-gerado-smoke` (de `main`).
119
+ Bateria: `tsc --noEmit` limpo; `node --test test/*.test.js` **478/478** (+5 em `project-smoke.test.js`);
120
+ `forja spec:check` e `forja project:check` (100%) verdes; `ci.yml` parseia (3 jobs).
121
+
122
+ | AC | Onde | Verificado |
123
+ |---|---|---|
124
+ | AC-1 | `lib/core/project-smoke.ts` `withGeneratedProject`/`runProjectSmoke` | `runProjectSmoke({ ai })` gera só-memória + `writeAiInstructions`; sem `ai` inalterado (teste + `forja project:smoke` roda o projeto completo) |
125
+ | AC-2 | `scripts/project-smoke.ts` `parseAi` | `forja project:smoke --ai claude,copilot` → veredito/exit normais |
126
+ | AC-3 | `lib/core/project-smoke.ts` check `ai-instructions` | arquivos existem, corpo idêntico (via `stripInstructionHeader`), `models.json.fallback_chain` == lista; testes de divergência reprovam |
127
+ | AC-4 | `lib/core/project-smoke.ts` | `structure` roda `includeNest: !env.ai`; `generated`/`no-placeholders`/`json-valid`/`gate-inherited` agnósticos (todos `ok` no modo `--ai`) |
128
+ | AC-5 | `.github/workflows/ci.yml` | job `project-smoke-ai`, `fail-fast:false`, matriz `[claude, copilot, claude,copilot,gemini,codex]`, `npm ci` + `project:smoke --ai` |
129
+ | AC-6 | `test/project-smoke.test.js` | 5 testes: skipped sem `--ai`; ok da mesma fonte; corpo divergente reprova; `models.json` fora de sync reprova; integração `runProjectSmoke({ ai })` |
130
+ | AC-7 | — | `forja project:smoke --ai claude,copilot` local, exit 0, tier barato |
131
+ | AC-8 | — | bateria acima verde |
132
+
133
+ - **Desvio vs. o plan (D1 revisado)**: `init-project.ts` **não roda em dev** (hardcoda
134
+ `bin/create-memory-nest-kit.js` e `.mjs`; trata o path como projeto de workspace). Em vez de
135
+ consertar, a lógica de `step02CopyInstructions` foi extraída para
136
+ **`lib/multi-ai-instructions.ts`** `writeAiInstructions()` (+ `stripInstructionHeader`); o
137
+ `step02` passou a **delegar** para ela; o smoke gera com `create-memory-nest-kit --only-memory`
138
+ + `writeAiInstructions`. Ganho: a escrita multi-IA virou função `lib/` testada, o coração de W8.
139
+ - **Hipótese, não medição**: o valor de §8 depende de um PR real quebrar o gerador; o teste de
140
+ regressão que injeta a divergência é a evidência enquanto isso.
141
+ - **Pendências**: revisão de Governança; handoff `review` registrado. Independente das Ondas 1–2
142
+ (mas o `ci.yml` e o `registry.ts` podem conflitar levemente no merge com #61 — trivial).
@@ -0,0 +1,139 @@
1
+ # Tasks: projeto-gerado-confiavel
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: approved
6
+ - **Criado em**: 2026-09-08
7
+
8
+ > Decomposição executável. Cada task tem dono, critério de done e paths.
9
+
10
+ Grafo de dependência:
11
+
12
+ ```
13
+ T1 ─┬─ T2 ─┬─ T3 ─ T7 ─┐
14
+ └── T4 ─┘ │
15
+ T3,T4 ─────► T6 │
16
+ T4,T6 ─────► T8 │
17
+ todas ─────────────────► T9
18
+ ```
19
+
20
+ Ordem: T1 (gera via init-project) → T2 (checks existentes adaptam) + T4 (CLI) →
21
+ T3 (check novo) → T6 (CI) / T7 (testes) / T8 (docs) → T9.
22
+
23
+ ---
24
+
25
+ ## T1 — `runProjectSmoke({ ai })` gera via `init-project.ts`
26
+ - **Owner**: Worker · **Est**: M · **Depende de**: —
27
+ - **Paths**: `lib/core/project-smoke.ts`
28
+ - **Escopo**: `SmokeEnv.ai?: readonly string[]`. `withGeneratedProject` recebe `ai` e, quando
29
+ presente, `spawn(process.execPath, [resolveScript(root,'bin/init-project'), projectDir, '--ai',
30
+ ai.join(','), '--skip-backend', '--force'], { cwd: dir, env: { ...env, HOME: dir } })` em vez
31
+ de `create-memory-nest-kit`. `runProjectSmoke({ full?, ai?, env? })` propaga `ai` para o env
32
+ dos checks e para `withGeneratedProject`. **Validar**: `init-project.ts --skip-backend` não
33
+ puxa rede nem escreve fora de `dir` (rodar 1× e inspecionar); se puxar, aplicar o kill-criterion.
34
+ - **Done**:
35
+ - [ ] `runProjectSmoke()` (sem `ai`) idêntico ao de hoje
36
+ - [ ] `runProjectSmoke({ ai: ['claude'] })` gera um projeto com `AGENTS.md` + `.ia-instructions/claude.md`
37
+ - [ ] nenhum arquivo criado fora do tmp; sem acesso de rede
38
+
39
+ ## T2 — Checks existentes adaptam ao modo `--ai`
40
+ - **Owner**: Worker · **Est**: P · **Depende de**: T1
41
+ - **Paths**: `lib/core/project-smoke.ts`
42
+ - **Escopo**: `structure` roda `validateProjectStructure(dir, { includeNest: !env.ai })`.
43
+ Confirmar `gate-inherited`: se `scripts/check-memory-maps.mjs` **não** viaja no modo
44
+ `--skip-backend`, condicionar esse check a `!env.ai` (kill-criterion do plan). `generated`,
45
+ `no-placeholders`, `json-valid` já são agnósticos.
46
+ - **Done**:
47
+ - [ ] `runProjectSmoke({ ai: ['claude','copilot'] })` → todos os checks aplicáveis `ok`
48
+ - [ ] `runProjectSmoke()` sem `ai` → veredito inalterado (backend ainda validado)
49
+
50
+ ## T3 — Check `aiInstructionsCoherent`
51
+ - **Owner**: Worker · **Est**: M · **Depende de**: T2
52
+ - **Paths**: `lib/core/project-smoke.ts`
53
+ - **Escopo**: novo `Check` (`severity: 'critical'`, `dependsOn: 'generated'`). Quando `env.ai`:
54
+ (a) `.ia-instructions/<ai>.md` existe para cada IA; (b) normaliza cada arquivo removendo linhas
55
+ que casam os padrões de cabeçalho de `step02CopyInstructions` (original e reescrito) e afirma
56
+ que os corpos normalizados são idênticos entre si; (c) `.ia-instructions/models.json` parseia,
57
+ `fallback_chain` deep-equal a `env.ai`, `engines` tem chave por IA com `instruction_file`
58
+ correto. Sem `env.ai` → `status: 'skipped'`. Adicionar a `SMOKE_CHECKS`.
59
+ - **Done**:
60
+ - [ ] projeto gerado com `--ai claude,copilot` → `ai-instructions` `ok`
61
+ - [ ] `tsc --noEmit` verde
62
+
63
+ ## T4 — CLI: flag `--ai`
64
+ - **Owner**: Worker · **Est**: P · **Depende de**: T1
65
+ - **Paths**: `scripts/project-smoke.ts`, `lib/core/registry.ts`
66
+ - **Escopo**: `scripts/project-smoke.ts` parseia `--ai <lista>` (`--ai a,b` ou `--ai a --ai b`?
67
+ seguir o padrão do `init-project` = CSV) → `runProjectSmoke({ full, ai })`. Mesma renderização
68
+ de resultados/veredito/exit code. Registry: `usage`/`examples` de `project:smoke` citam `--ai`.
69
+ - **Done**:
70
+ - [ ] `forja project:smoke --ai claude,copilot,gemini,codex` roda no tier barato, exit 0
71
+ - [ ] `forja project:smoke` (sem `--ai`) inalterado
72
+ - [ ] `forja help project:smoke` mostra `--ai`
73
+
74
+ ## T5 — (dobrado em T4 — registry) — sem task própria
75
+
76
+ ## T6 — CI: matriz `project:smoke --ai`
77
+ - **Owner**: Worker · **Est**: P · **Depende de**: T3, T4
78
+ - **Paths**: `.github/workflows/ci.yml`
79
+ - **Escopo**: job novo `project-smoke-ai` (ou step no `release-gate`) com
80
+ `strategy: { fail-fast: false, matrix: { ai: ['claude', 'copilot', 'claude,copilot,gemini,codex'] } }`,
81
+ `node-version: 22.x`, `npm ci`, `node bin/forja.ts project:smoke --ai ${{ matrix.ai }}`.
82
+ Roda em `pull_request` e `push` (o `on:` atual já cobre).
83
+ - **Done**:
84
+ - [ ] `ci.yml` parseia (YAML válido); o job aparece com 3 células
85
+ - [ ] o `release-gate` e o `test` job seguem intactos
86
+
87
+ ## T7 — Testes
88
+ - **Owner**: Worker · **Est**: M · **Depende de**: T3, T4
89
+ - **Paths**: `test/project-smoke.test.js` (existente — estender)
90
+ - **Escopo**: (a) `runProjectSmoke({ ai: ['claude','copilot'] })` num tmp → sem `fail`,
91
+ `ai-instructions` `ok`; (b) gerar, **editar** `.ia-instructions/copilot.md` (mudar uma linha do
92
+ corpo), re-rodar só o check `aiInstructionsCoherent` → `fail`; (c) `models.json` adulterado
93
+ (`fallback_chain` fora de ordem) → `fail`. `{ concurrency: false }` se lento.
94
+ - **Done**:
95
+ - [ ] `node --test test/project-smoke.test.js` verde
96
+
97
+ ## T8 — Documentação + CHANGELOG
98
+ - **Owner**: Worker · **Est**: P · **Depende de**: T4, T6
99
+ - **Paths**: `docs/quick-reference.md` (ou `docs/dev-workflow.md`), `CHANGELOG.md`
100
+ - **Escopo**: `project:smoke --ai <lista>` no guia; CHANGELOG `[Unreleased]` — Adicionado
101
+ (`project:smoke --ai`, check de coerência multi-IA, matriz de CI).
102
+ - **Done**:
103
+ - [ ] `forja tools:doctor` → `docs-commands`, `commands-documented`, `docs-links` verdes
104
+
105
+ ## T9 — Validação final + fecho
106
+ - **Owner**: Worker → Governance · **Est**: P · **Depende de**: T1–T8
107
+ - **Paths**: `specs/projeto-gerado-confiavel/spec.md`
108
+ - **Escopo**: bateria; `spec.md` §Evidências; mover status; handoff `review`.
109
+ - **Done**:
110
+ - [ ] `tsc --noEmit`, `node --test test/*.test.js`, `forja spec:check`, `forja project:check` verdes — AC-8
111
+ - [ ] `spec:set-status projeto-gerado-confiavel spec implementing` no início; handoff `worker →
112
+ governance (review)` ao fim
113
+
114
+ ---
115
+
116
+ ## Mapa AC → task
117
+
118
+ | AC | Tasks | Verificação-chave |
119
+ |---|---|---|
120
+ | AC-1 | T1 | `runProjectSmoke({ ai })` via `init-project.ts` |
121
+ | AC-2 | T4 | `forja project:smoke --ai …` |
122
+ | AC-3 | T3 | check `aiInstructionsCoherent` |
123
+ | AC-4 | T2 | `structure` com `includeNest:!ai`; checks agnósticos |
124
+ | AC-5 | T6 | matriz `ci.yml` |
125
+ | AC-6 | T7 | verde + divergência injetada reprova |
126
+ | AC-7 | T4 | 4 IAs juntas, tier barato |
127
+ | AC-8 | T9 | bateria completa |
128
+
129
+ ## Handoffs entre agentes
130
+
131
+ SDD Architect (spec+plan+tasks) → **Worker** (T1–T8) → **Governance** (T9 + `project:check`).
132
+ Registrar via Hermes no início da implementação.
133
+
134
+ ## Evidências e estado real
135
+
136
+ - Nada executado — caixas `[ ]` abertas.
137
+ - **A validar já na T1**: `init-project.ts --skip-backend` sem rede / sem escrita fora do tmp;
138
+ `check-memory-maps.mjs` viaja (ou não) no modo memória-only.
139
+ - **Sem dependência de branch** — a partir de `main`.