forjajs 4.0.1 → 4.1.0
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.
- package/CHANGELOG.md +111 -7
- package/DOC-MAP.md +1 -0
- package/README.md +7 -2
- package/dist/apps/cli/src/index.d.ts +18 -1
- package/dist/apps/cli/src/index.js +161 -26
- package/dist/apps/cli/src/params.d.ts +44 -0
- package/dist/apps/cli/src/params.js +123 -0
- package/dist/bin/forja.js +234 -13
- package/dist/bin/init-project.js +11 -62
- package/dist/lib/cli-output.d.ts +29 -0
- package/dist/lib/cli-output.js +39 -0
- package/dist/lib/core/checks.d.ts +1 -1
- package/dist/lib/core/health.d.ts +9 -0
- package/dist/lib/core/health.js +9 -0
- package/dist/lib/core/project-smoke.d.ts +6 -2
- package/dist/lib/core/project-smoke.js +83 -7
- package/dist/lib/core/registry.d.ts +38 -571
- package/dist/lib/core/registry.js +174 -25
- package/dist/lib/core/release.d.ts +1 -571
- package/dist/lib/core/release.js +0 -3
- package/dist/lib/handoffs-index.d.ts +16 -0
- package/dist/lib/handoffs-index.js +29 -0
- package/dist/lib/llm/claude-output.d.ts +8 -0
- package/dist/lib/llm/claude-output.js +54 -0
- package/dist/lib/llm/context.d.ts +22 -0
- package/dist/lib/llm/context.js +39 -0
- package/dist/lib/llm/session.d.ts +6 -1
- package/dist/lib/llm/session.js +12 -2
- package/dist/lib/multi-ai-instructions.d.ts +28 -0
- package/dist/lib/multi-ai-instructions.js +83 -0
- package/dist/lib/orchestrate.d.ts +5 -0
- package/dist/lib/orchestrate.js +18 -0
- package/dist/lib/specs-index.d.ts +20 -0
- package/dist/lib/specs-index.js +51 -0
- package/dist/lib/sprint-index.d.ts +15 -0
- package/dist/lib/sprint-index.js +34 -0
- package/dist/lib/status-model.d.ts +64 -0
- package/dist/lib/status-model.js +180 -0
- package/dist/packages/evals/src/index.d.ts +2 -0
- package/dist/packages/evals/src/index.js +21 -0
- package/dist/packages/llm/src/index.d.ts +24 -3
- package/dist/packages/llm/src/index.js +51 -5
- package/dist/scripts/cost-economy.js +12 -10
- package/dist/scripts/drift-check.d.ts +2 -0
- package/dist/scripts/drift-check.js +57 -1
- package/dist/scripts/engineer.js +7 -4
- package/dist/scripts/forja-setup.d.ts +14 -0
- package/dist/scripts/forja-setup.js +58 -0
- package/dist/scripts/forja-status.d.ts +11 -0
- package/dist/scripts/forja-status.js +70 -0
- package/dist/scripts/hook-session-start.js +20 -46
- package/dist/scripts/llm-fit.js +113 -8
- package/dist/scripts/project-smoke.js +13 -3
- package/dist/scripts/simulate.js +18 -6
- package/dist/scripts/token-economy.js +34 -28
- package/dist/scripts/tools-doctor.js +14 -6
- package/docs/2x/CLI-CAPABILITIES.md +34 -10
- package/docs/agent-operating-contract.md +1 -1
- package/docs/cli-first-operacao.md +17 -0
- package/docs/contrato-saida-cli.md +79 -0
- package/docs/llm-evolution.md +2 -1
- package/docs/llm-fit-loop.md +74 -2
- package/docs/publishing.md +0 -11
- package/docs/quick-reference.md +13 -0
- package/docs/roadmap-v4.1.md +199 -0
- package/memory/90-decisions/0082-contrato-saida-cli.md +95 -0
- package/memory/90-decisions/0083-mcp-cobertura-declarativa.md +103 -0
- package/memory/90-decisions/0084-drift-sentinel-fecha.md +79 -0
- package/memory/90-decisions/0085-adaptador-claude-paridade.md +85 -0
- package/package.json +4 -1
- package/specs/cli-intuitiva-v1/plan.md +169 -0
- package/specs/cli-intuitiva-v1/spec.md +163 -0
- package/specs/cli-intuitiva-v1/tasks.md +224 -0
- package/specs/contrato-saida-cli/plan.md +162 -0
- package/specs/contrato-saida-cli/spec.md +157 -0
- package/specs/contrato-saida-cli/tasks.md +153 -0
- package/specs/drift-sentinel/spec.md +17 -8
- package/specs/forja-status-caminho-feliz/plan.md +149 -0
- package/specs/forja-status-caminho-feliz/spec.md +158 -0
- package/specs/forja-status-caminho-feliz/tasks.md +175 -0
- package/specs/llm-adaptador-claude/plan.md +117 -0
- package/specs/llm-adaptador-claude/spec.md +144 -0
- package/specs/llm-adaptador-claude/tasks.md +100 -0
- package/specs/llm-benchmark-recomendacao/plan.md +121 -0
- package/specs/llm-benchmark-recomendacao/spec.md +141 -0
- package/specs/llm-benchmark-recomendacao/tasks.md +88 -0
- package/specs/llm-contexto-e-sessoes/plan.md +143 -0
- package/specs/llm-contexto-e-sessoes/spec.md +139 -0
- package/specs/llm-contexto-e-sessoes/tasks.md +127 -0
- package/specs/mcp-cobertura-nucleo/plan.md +158 -0
- package/specs/mcp-cobertura-nucleo/spec.md +161 -0
- package/specs/mcp-cobertura-nucleo/tasks.md +169 -0
- package/specs/projeto-gerado-confiavel/plan.md +148 -0
- package/specs/projeto-gerado-confiavel/spec.md +142 -0
- 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`.
|