forjajs 4.1.2 → 5.0.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.
Files changed (178) hide show
  1. package/.claude/settings.json +2 -2
  2. package/.gemini-instructions.md +1 -1
  3. package/.github/copilot-instructions.md +1 -1
  4. package/.openai-instructions.md +1 -1
  5. package/CHANGELOG.md +109 -0
  6. package/DOC-MAP.md +2 -2
  7. package/README.md +62 -10
  8. package/README.pt-BR.md +46 -7
  9. package/boilerplates/01-api-rest/README.md +1 -1
  10. package/boilerplates/06-clean-arch/README.md +5 -3
  11. package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
  12. package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
  13. package/boilerplates/06-clean-arch/backend/package.json +22 -24
  14. package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
  15. package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
  21. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
  22. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
  24. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
  26. package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
  27. package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
  28. package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
  29. package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
  30. package/boilerplates/README.md +24 -44
  31. package/dist/apps/cli/src/index.js +6 -6
  32. package/dist/apps/dashboard/next.config.d.mts +5 -5
  33. package/dist/apps/server/src/app.module.js +1 -1
  34. package/dist/apps/server/src/forja-nest.module.js +1 -1
  35. package/dist/apps/server/src/index.js +1 -1
  36. package/dist/apps/server/src/main.js +20 -20
  37. package/dist/apps/worker/src/main.js +4 -4
  38. package/dist/bin/create-memory-nest-kit.js +5 -5
  39. package/dist/bin/forja.js +28 -14
  40. package/dist/bin/init-project.d.ts +4 -9
  41. package/dist/bin/init-project.js +126 -182
  42. package/dist/lib/audit.js +1 -1
  43. package/dist/lib/context-builder.d.ts +6 -1
  44. package/dist/lib/context-builder.js +21 -12
  45. package/dist/lib/core/architecture-gate.js +2 -4
  46. package/dist/lib/core/checks.d.ts +1 -1
  47. package/dist/lib/core/drift-gate.js +2 -4
  48. package/dist/lib/core/gates.js +5 -5
  49. package/dist/lib/core/health.d.ts +0 -1
  50. package/dist/lib/core/health.js +33 -7
  51. package/dist/lib/core/journey.d.ts +30 -0
  52. package/dist/lib/core/journey.js +142 -0
  53. package/dist/lib/core/model-pricing.js +3 -5
  54. package/dist/lib/core/project-smoke.d.ts +6 -2
  55. package/dist/lib/core/project-smoke.js +60 -61
  56. package/dist/lib/core/registry.d.ts +1 -12
  57. package/dist/lib/core/registry.js +42 -32
  58. package/dist/lib/core/release.d.ts +1 -1
  59. package/dist/lib/core/release.js +31 -3
  60. package/dist/lib/core/risk-collect.js +4 -4
  61. package/dist/lib/drift-sentinel.js +1 -1
  62. package/dist/lib/generators/memory-generator.d.ts +30 -30
  63. package/dist/lib/generators/memory-generator.js +19 -8
  64. package/dist/lib/generators/nest-generator.js +192 -275
  65. package/dist/lib/generators/readme-generator.js +1 -1
  66. package/dist/lib/governance-report.js +4 -4
  67. package/dist/lib/handoffs-index.d.ts +16 -2
  68. package/dist/lib/handoffs-index.js +32 -5
  69. package/dist/lib/llm/session.js +1 -1
  70. package/dist/lib/llm/validation.js +1 -1
  71. package/dist/lib/memory-audit.js +1 -1
  72. package/dist/lib/paths.d.ts +39 -0
  73. package/dist/lib/paths.js +73 -0
  74. package/dist/lib/project-wiring.d.ts +54 -0
  75. package/dist/lib/project-wiring.js +391 -0
  76. package/dist/lib/status-model.js +18 -7
  77. package/dist/lib/templates.d.ts +24 -0
  78. package/dist/lib/templates.js +77 -0
  79. package/dist/lib/validators/structure-validator.js +0 -1
  80. package/dist/lib/workspace.d.ts +7 -0
  81. package/dist/lib/workspace.js +20 -2
  82. package/dist/packages/adapter-git/src/index.js +2 -2
  83. package/dist/packages/context/src/index.js +1 -1
  84. package/dist/packages/core/src/index.js +1 -1
  85. package/dist/packages/evals/src/index.js +1 -1
  86. package/dist/packages/events/src/index.js +1 -1
  87. package/dist/packages/graph/src/index.js +1 -1
  88. package/dist/packages/mcp/src/index.d.ts +1 -1
  89. package/dist/packages/observability/src/index.js +1 -1
  90. package/dist/packages/orchestration/src/index.js +1 -1
  91. package/dist/packages/planner/src/index.js +1 -1
  92. package/dist/packages/policy/src/index.js +1 -1
  93. package/dist/packages/runtime/src/index.js +1 -1
  94. package/dist/packages/sandbox/src/index.js +1 -1
  95. package/dist/packages/validator/src/index.js +1 -1
  96. package/dist/scripts/adr.js +4 -4
  97. package/dist/scripts/agent-harness.js +30 -23
  98. package/dist/scripts/agent-router.js +22 -5
  99. package/dist/scripts/agent.js +5 -5
  100. package/dist/scripts/architecture.js +6 -6
  101. package/dist/scripts/audit-query.js +1 -1
  102. package/dist/scripts/audit-sync.js +1 -1
  103. package/dist/scripts/build-smart-context.d.ts +19 -1
  104. package/dist/scripts/build-smart-context.js +84 -68
  105. package/dist/scripts/check-standards.js +8 -3
  106. package/dist/scripts/code-context.js +1 -1
  107. package/dist/scripts/compress-memory.js +3 -2
  108. package/dist/scripts/compress-project-memory.js +2 -2
  109. package/dist/scripts/context-ops.js +13 -5
  110. package/dist/scripts/cost-economy.js +4 -4
  111. package/dist/scripts/demo-autonomy.js +11 -11
  112. package/dist/scripts/demo-workspace.js +12 -4
  113. package/dist/scripts/dev.js +8 -7
  114. package/dist/scripts/drift-check.js +5 -5
  115. package/dist/scripts/engineer.js +11 -11
  116. package/dist/scripts/evidence.js +4 -4
  117. package/dist/scripts/extract-global-knowledge.js +6 -4
  118. package/dist/scripts/forja-setup.js +2 -1
  119. package/dist/scripts/forja-status.js +5 -4
  120. package/dist/scripts/gates.js +1 -1
  121. package/dist/scripts/generate-dashboard.js +6 -4
  122. package/dist/scripts/governance-dashboard.js +2 -2
  123. package/dist/scripts/hook-session-start.js +11 -10
  124. package/dist/scripts/hook-user-prompt.js +3 -2
  125. package/dist/scripts/incident.js +4 -4
  126. package/dist/scripts/llm-fit.js +11 -11
  127. package/dist/scripts/memory-audit.js +1 -1
  128. package/dist/scripts/memory-schema.js +3 -2
  129. package/dist/scripts/orchestrate.js +4 -5
  130. package/dist/scripts/project-smoke.js +13 -2
  131. package/dist/scripts/project-templates.d.ts +1 -0
  132. package/dist/scripts/project-templates.js +20 -0
  133. package/dist/scripts/project-upgrade.d.ts +13 -0
  134. package/dist/scripts/project-upgrade.js +107 -40
  135. package/dist/scripts/project-wire.d.ts +8 -0
  136. package/dist/scripts/project-wire.js +55 -0
  137. package/dist/scripts/provenance.js +3 -3
  138. package/dist/scripts/query-universal-memory.js +7 -4
  139. package/dist/scripts/release-check.js +1 -1
  140. package/dist/scripts/risk.js +4 -4
  141. package/dist/scripts/simulate.js +9 -9
  142. package/dist/scripts/spec-cli.d.ts +1 -0
  143. package/dist/scripts/spec-cli.js +25 -5
  144. package/dist/scripts/sprint-manager.js +4 -3
  145. package/dist/scripts/sync-universal-memory.js +22 -15
  146. package/dist/scripts/token-benchmark.js +4 -3
  147. package/dist/scripts/token-economy.js +4 -3
  148. package/dist/scripts/tools-doctor.d.ts +1 -1
  149. package/dist/scripts/tools-doctor.js +25 -3
  150. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  151. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  152. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  153. package/docs/glossary.md +4 -4
  154. package/docs/init-project.md +88 -444
  155. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  156. package/docs/modos-de-operacao.md +1 -1
  157. package/docs/processo-projeto.md +14 -11
  158. package/docs/produto/roteiro-demo.md +15 -18
  159. package/docs/publishing.md +5 -0
  160. package/docs/quick-reference.md +15 -23
  161. package/docs/structure.md +16 -30
  162. package/lib/core/model-pricing.json +19 -0
  163. package/memory/30-projects/README.md +1 -1
  164. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  165. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  166. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  167. package/memory/90-decisions/0088-templates-validados.md +55 -0
  168. package/package.json +25 -25
  169. package/templates/project/AGENTS.md +75 -0
  170. package/templates/project/CLAUDE.md +9 -0
  171. package/templates/project/agents/context-engineer.md +15 -0
  172. package/templates/project/agents/governance.md +15 -0
  173. package/templates/project/agents/marketing.md +15 -0
  174. package/templates/project/agents/orchestrator.md +15 -0
  175. package/templates/project/agents/product.md +15 -0
  176. package/templates/project/agents/sdd-architect.md +15 -0
  177. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  178. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -0,0 +1,75 @@
1
+ # Forja — como operar este projeto
2
+
3
+ > Projeto criado pelo Forja. Este bloco vale para toda IA (Claude, Codex, Gemini, Copilot) e é
4
+ > mantido por `forja project:wire`, que pode reescrevê-lo. Suas anotações vão **fora** dos
5
+ > marcadores `forja:begin`/`forja:end`.
6
+
7
+ ## Regras
8
+
9
+ - Responda e documente em **pt-BR**.
10
+ - **Spec antes de código** em feature não trivial; **ADR antes de mudança estrutural**
11
+ (`memory/90-decisions/`, use `_template.md`).
12
+ - **Contexto sob demanda**: não leia `memory/` inteira. Busque primeiro e anexe só o que responde.
13
+ - Toda execução de `forja` fica auditada em `.context/forja-runs.jsonl`.
14
+
15
+ ## Contexto: do mais barato ao mais caro
16
+
17
+ ```bash
18
+ forja query:universal "<termo>" # busca FTS5 na memória do projeto
19
+ forja context:smart --mode task --task "<termo>" # pack mínimo da tarefa → .context/smart-context.md
20
+ forja context:smart --mode domain # visão, design e regras do projeto
21
+ forja sync:universal # reindexa depois de editar memory/, docs/ ou specs/
22
+ ```
23
+
24
+ Mais de ~2 arquivos de memória no contexto: use `context:smart`.
25
+
26
+ ## Fluxo de uma feature
27
+
28
+ ```bash
29
+ forja status # onde estamos: specs, corrida, handoffs
30
+ forja next # próxima ação recomendada, com o comando exato
31
+ forja spec:new <slug> # specs/<slug>/spec.md
32
+ forja spec:set-status <slug> spec approved # depois da revisão
33
+ forja spec:plan <slug> # plan.md (exige spec aprovada)
34
+ forja spec:tasks <slug> # tasks.md
35
+ forja spec:check <slug> # gate de completude
36
+ forja orchestrate "<objetivo>" --slug <slug> # corrida guardada por gates
37
+ forja orchestrate:advance # roda o gate da etapa aberta
38
+ ```
39
+
40
+ ## Antes de editar e antes de entregar
41
+
42
+ ```bash
43
+ forja code:check # índice de código confiável (codegraph, opcional)
44
+ forja code:impact <símbolo> # quem chama e o que quebra
45
+ forja project:check # documentação de fundação
46
+ forja tools:doctor # saúde do Forja e das ferramentas
47
+ forja project:wire --check # IA, hooks e MCP conectados a este projeto
48
+ ```
49
+
50
+ ## Onde fica cada coisa
51
+
52
+ ```
53
+ memory/00-global/ missão e padrões (leia primeiro)
54
+ memory/10-product/ visão, personas, growth
55
+ memory/20-architecture/ design técnico
56
+ memory/30-domains/ regras por domínio
57
+ memory/40-delivery/ roadmap, sprint, backlog
58
+ memory/50-orchestration/ topologia e handoffs
59
+ memory/70-summaries/ resumos compactos (prefira a arquivos brutos)
60
+ memory/90-decisions/ ADRs
61
+ specs/<slug>/ spec → plan → tasks
62
+ agents/, prompts/ papéis e prompts do projeto
63
+ ```
64
+
65
+ ## Papéis e handoffs
66
+
67
+ Orchestrator, product, sdd-architect, context-engineer, governance e marketing. No Claude Code
68
+ eles são sub-agents em `.claude/agents/`. Um handoff tem 7 campos: `from`, `to`, `intent`,
69
+ `context`, `acceptance`, `constraints`, `return`. Registre com:
70
+
71
+ ```bash
72
+ forja hermes:handoff '<json com os 7 campos>'
73
+ forja agent:route list --open --mine # handoffs em aberto deste projeto
74
+ forja agent:route done <id> # fecha um handoff entregue
75
+ ```
@@ -0,0 +1,9 @@
1
+ @AGENTS.md
2
+
3
+ ## Claude Code neste projeto
4
+
5
+ - Os hooks em `.claude/settings.json` abrem cada sessão com o estado do projeto (`forja hook:session-start`)
6
+ e anexam a spec citada no prompt (`forja hook:user-prompt`). Se o briefing não aparecer, rode
7
+ `forja project:wire --check`.
8
+ - O servidor MCP `forja` (`.mcp.json`) expõe as capacidades do Forja como ferramentas.
9
+ - Sub-agents de cada papel ficam em `.claude/agents/`. Delegue a eles quando a tarefa cruzar papéis.
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: context-engineer
3
+ description: Use antes de uma tarefa pesada (refator amplo, análise de vários arquivos, review profundo) ou quando o assunto for economia de tokens e memória. Entrega um pacote de contexto mínimo e suficiente.
4
+ tools: Read, Bash, Grep
5
+ ---
6
+
7
+ # Engenheiro de contexto
8
+
9
+ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência do usuário. Contexto entra sob demanda: `forja query:universal` e `forja context:smart` antes de abrir arquivos de memória.
10
+
11
+ ## Procedimento
12
+ Identifique a pergunta. `forja sync:universal` se a memória mudou; depois `forja context:smart --mode task --task "<termo>"` (ou `--mode domain` para uma área). O pack sai em `.context/smart-context.md`. Para medir, `forja context:budget`. Não remova nem compacte memória por tamanho ou idade.
13
+
14
+ ## Entrega esperada
15
+ Fontes com caminhos, resumo factual, lacunas e por que esse contexto foi escolhido.
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: governance
3
+ description: Use antes de aprovar merge ou release. Roda os gates do projeto, confere ADR para mudança estrutural, audita handoffs (7 campos), segurança e privacidade (LGPD/GDPR). Reprova com a lista do que falta.
4
+ tools: Read, Bash, Grep
5
+ ---
6
+
7
+ # Governança
8
+
9
+ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência do usuário. Contexto entra sob demanda: `forja query:universal` e `forja context:smart` antes de abrir arquivos de memória.
10
+
11
+ ## Procedimento
12
+ Leia o diff e os critérios de aceite. Rode `forja project:check`, `forja spec:check`, `forja tools:doctor` e `forja project:wire --check`, além dos testes do projeto. Ferramenta opcional ausente é limitação, não falha. Confira se cada mudança estrutural tem ADR e se dados pessoais seguem a política do projeto.
13
+
14
+ ## Entrega esperada
15
+ Parecer aprovado, reprovado ou inconclusivo, com evidência por critério, bloqueios concretos e limitações. Execução bem-sucedida de LLM não prova qualidade.
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: marketing
3
+ description: Use para copy, SEO, onboarding, métricas AARRR ou avaliação de tração de uma feature lançada. Atua antes (posicionamento) e depois (medição), não durante a implementação.
4
+ tools: Read, Write, WebSearch, Bash
5
+ ---
6
+
7
+ # Marketing
8
+
9
+ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência do usuário. Contexto entra sob demanda: `forja query:universal` e `forja context:smart` antes de abrir arquivos de memória.
10
+
11
+ ## Procedimento
12
+ Leia a dor descrita na spec e o que já foi entregue. Separe o que existe do que é roadmap. Use métricas só com fonte, período e método; hipótese é apresentada como hipótese. Publique apenas dentro da autorização vigente.
13
+
14
+ ## Entrega esperada
15
+ Texto pronto para revisão, público e objetivo, fonte de cada alegação e proposta de medição sem resultados inventados.
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: orchestrator
3
+ description: Use proativamente quando uma tarefa atravessa múltiplos papéis (produto → arquitetura → implementação → governança) ou quando o usuário pede para orquestrar, rotear ou coordenar trabalho. Decompõe a demanda em handoffs, escolhe os sub-agents e a ordem, e registra cada handoff.
4
+ tools: Read, Bash, Edit, Write
5
+ ---
6
+
7
+ # Orquestrador
8
+
9
+ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência do usuário. Contexto entra sob demanda: `forja query:universal` e `forja context:smart` antes de abrir arquivos de memória.
10
+
11
+ ## Procedimento
12
+ Comece por `forja status` e `forja next`. Para uma entrega com várias etapas, abra uma corrida com `forja orchestrate "<objetivo>" --slug <slug>` e avance com `forja orchestrate:advance`, que só abre a próxima etapa quando o gate da atual passa. Registre cada delegação com `forja hermes:handoff '<json>'` contendo os 7 campos (`from`, `to`, `intent`, `context`, `acceptance`, `constraints`, `return`). Não apague nem compacte memória como rotina.
13
+
14
+ ## Entrega esperada
15
+ Plano de execução, handoffs com os sete campos, evidências recebidas e pendências. Alegação de um agente não é validação: confirme pelo gate.
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: product
3
+ description: Use quando o usuário descreve uma necessidade ainda sem spec, quando há ambiguidade sobre o que construir, ou para decompor a visão em backlog priorizado. Escreve specs/<slug>/spec.md e atualiza memory/10-product/.
4
+ tools: Read, Write, Edit, Bash
5
+ ---
6
+
7
+ # Produto
8
+
9
+ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência do usuário. Contexto entra sob demanda: `forja query:universal` e `forja context:smart` antes de abrir arquivos de memória.
10
+
11
+ ## Procedimento
12
+ Leia `memory/10-product/` via `forja query:universal`. Para feature nova, `forja spec:new <slug>` e preencha problema, público, comportamento esperado, exclusões e critérios de aceite observáveis. Ao terminar a revisão, `forja spec:set-status <slug> spec approved`. Na priorização (RICE), separe dado medido, estimativa e hipótese; não invente KPIs.
13
+
14
+ ## Entrega esperada
15
+ Spec preenchida, critérios de aceite numerados, suposições e dúvidas que de fato bloqueiam a implementação.
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: sdd-architect
3
+ description: Use quando há spec aprovada para virar plan, quando uma decisão estrutural exige ADR, ou quando perguntam como construir algo. Não escreve código: escreve plan.md, tasks.md e ADRs.
4
+ tools: Read, Write, Edit, Bash, Grep
5
+ ---
6
+
7
+ # Arquiteto SDD
8
+
9
+ Siga o `AGENTS.md` da raiz do projeto. Comunique-se em pt-BR, salvo preferência do usuário. Contexto entra sob demanda: `forja query:universal` e `forja context:smart` antes de abrir arquivos de memória.
10
+
11
+ ## Procedimento
12
+ Leia a spec e `memory/20-architecture/`. Antes de propor mudança em código existente, `forja code:impact <símbolo>` (sem codegraph, busque chamadores com `rg`). Gere `forja spec:plan <slug>` e `forja spec:tasks <slug>`; descreva contratos, falhas, compatibilidade, testes e rollout. Decisão estrutural durável vira ADR em `memory/90-decisions/` a partir de `_template.md`.
13
+
14
+ ## Entrega esperada
15
+ Plan e tasks ligados aos critérios de aceite, arquivos afetados, decisões justificadas e como validar. Não marque aceite ainda não verificado.
@@ -1,28 +0,0 @@
1
- /**
2
- * lib/multi-ai-instructions.ts — as instruções nativas por IA de um projeto gerado (SPEC-047).
3
- *
4
- * Conteúdo canônico ÚNICO (ADR-0020): toda IA recebe a mesma explicação da estrutura Forja;
5
- * só o cabeçalho muda. Extraído de `bin/init-project.ts step02CopyInstructions` para (a) ser
6
- * chamável pelo smoke sem passar pelo `init-project.ts` (que não roda em dev), e (b) dar ao
7
- * check de coerência (`project:smoke --ai`) a mesma fonte de verdade que a geração.
8
- */
9
- export declare const CANONICAL_INSTRUCTIONS = ".gemini-instructions.md";
10
- export declare const AI_LABELS: Readonly<Record<string, string>>;
11
- /**
12
- * Remove as linhas de cabeçalho (as que diferem entre IAs) para comparar só o corpo.
13
- * Usado pelo check `aiInstructionsCoherent`: dois `<ai>.md` da mesma geração devem ter corpo
14
- * idêntico byte a byte depois disto.
15
- */
16
- export declare function stripInstructionHeader(text: string): string;
17
- export interface WriteAiInstructionsResult {
18
- readonly written: string[];
19
- readonly skipped: string[];
20
- }
21
- /**
22
- * Escreve `.ia-instructions/<ai>.md` (um por IA), `README.md` e `models.json` em `projectDir`,
23
- * todos derivados de `<kitRoot>/.gemini-instructions.md`. `kitRoot` é a raiz do framework.
24
- * Nunca lança por IA desconhecida — pula e reporta em `skipped`.
25
- */
26
- export declare function writeAiInstructions(projectDir: string, aiList: readonly string[], { kitRoot }: {
27
- kitRoot: string;
28
- }): WriteAiInstructionsResult;
@@ -1,83 +0,0 @@
1
- /**
2
- * lib/multi-ai-instructions.ts — as instruções nativas por IA de um projeto gerado (SPEC-047).
3
- *
4
- * Conteúdo canônico ÚNICO (ADR-0020): toda IA recebe a mesma explicação da estrutura Forja;
5
- * só o cabeçalho muda. Extraído de `bin/init-project.ts step02CopyInstructions` para (a) ser
6
- * chamável pelo smoke sem passar pelo `init-project.ts` (que não roda em dev), e (b) dar ao
7
- * check de coerência (`project:smoke --ai`) a mesma fonte de verdade que a geração.
8
- */
9
- import fs from 'node:fs';
10
- import path from 'node:path';
11
- export const CANONICAL_INSTRUCTIONS = '.gemini-instructions.md';
12
- export const AI_LABELS = {
13
- copilot: 'GitHub Copilot',
14
- claude: 'Claude',
15
- gemini: 'Gemini',
16
- codex: 'OpenAI Codex',
17
- };
18
- /** Linhas de cabeçalho que `writeAiInstructions` reescreve por IA — antes e depois. */
19
- const HEADER_LINE_RES = [
20
- /^# Instruções para .+ — Forja$/,
21
- /^> Guia para .+ multi-IA por design\.$/,
22
- ];
23
- /**
24
- * Remove as linhas de cabeçalho (as que diferem entre IAs) para comparar só o corpo.
25
- * Usado pelo check `aiInstructionsCoherent`: dois `<ai>.md` da mesma geração devem ter corpo
26
- * idêntico byte a byte depois disto.
27
- */
28
- export function stripInstructionHeader(text) {
29
- return text
30
- .split('\n')
31
- .filter((line) => !HEADER_LINE_RES.some((re) => re.test(line)))
32
- .join('\n');
33
- }
34
- /**
35
- * Escreve `.ia-instructions/<ai>.md` (um por IA), `README.md` e `models.json` em `projectDir`,
36
- * todos derivados de `<kitRoot>/.gemini-instructions.md`. `kitRoot` é a raiz do framework.
37
- * Nunca lança por IA desconhecida — pula e reporta em `skipped`.
38
- */
39
- export function writeAiInstructions(projectDir, aiList, { kitRoot }) {
40
- const instructionsDir = path.join(projectDir, '.ia-instructions');
41
- fs.mkdirSync(instructionsDir, { recursive: true });
42
- const canonicalPath = path.join(kitRoot, CANONICAL_INSTRUCTIONS);
43
- const canonical = fs.existsSync(canonicalPath) ? fs.readFileSync(canonicalPath, 'utf8') : null;
44
- const written = [];
45
- const skipped = [];
46
- for (const ai of aiList) {
47
- const label = AI_LABELS[ai];
48
- if (!label || !canonical) {
49
- skipped.push(ai);
50
- continue;
51
- }
52
- const others = Object.entries(AI_LABELS)
53
- .filter(([key]) => key !== ai)
54
- .map(([, name]) => name);
55
- const content = canonical
56
- .replace(/^# Instruções para .+ — Forja$/m, `# Instruções para ${label} — Forja`)
57
- .replace(/^> Guia para .+ multi-IA por design\.$/m, `> Guia para ${label} operar a Forja. O conteúdo é o mesmo para ${others.slice(0, -1).join(', ')} e ${others.at(-1)} — a Forja é multi-IA por design.`);
58
- fs.writeFileSync(path.join(instructionsDir, `${ai}.md`), content, 'utf8');
59
- written.push(ai);
60
- }
61
- const indexContent = `# IA Assistants Configuration
62
-
63
- Este diretório contém instruções específicas para cada IA assistant.
64
-
65
- ## Gestão de Cotas & Alternância
66
- Para trocar de IA (ex: se acabar a cota), use o arquivo [models.json](./models.json) para identificar o próximo motor na fila de fallback.
67
-
68
- ## IAs Configuradas
69
-
70
- ${aiList.map((ai) => `- [${ai.toUpperCase()}](./${ai}.md)`).join('\n')}
71
- `;
72
- fs.writeFileSync(path.join(instructionsDir, 'README.md'), indexContent);
73
- const modelsJson = {
74
- active_engine: aiList[0] || 'copilot',
75
- fallback_chain: [...aiList],
76
- engines: aiList.reduce((acc, ai) => {
77
- acc[ai] = { name: ai.toUpperCase(), instruction_file: `.ia-instructions/${ai}.md`, status: 'ready' };
78
- return acc;
79
- }, {}),
80
- };
81
- fs.writeFileSync(path.join(instructionsDir, 'models.json'), JSON.stringify(modelsJson, null, 2));
82
- return { written, skipped };
83
- }