forjajs 4.1.1 → 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 (181) 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 +125 -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/specs-index.d.ts +1 -0
  77. package/dist/lib/specs-index.js +22 -3
  78. package/dist/lib/status-model.js +24 -8
  79. package/dist/lib/templates.d.ts +24 -0
  80. package/dist/lib/templates.js +77 -0
  81. package/dist/lib/validators/structure-validator.js +0 -1
  82. package/dist/lib/workspace.d.ts +7 -0
  83. package/dist/lib/workspace.js +33 -3
  84. package/dist/packages/adapter-git/src/index.js +2 -2
  85. package/dist/packages/context/src/index.js +1 -1
  86. package/dist/packages/core/src/index.js +1 -1
  87. package/dist/packages/evals/src/index.js +1 -1
  88. package/dist/packages/events/src/index.js +1 -1
  89. package/dist/packages/graph/src/index.js +1 -1
  90. package/dist/packages/mcp/src/index.d.ts +1 -1
  91. package/dist/packages/observability/src/index.js +1 -1
  92. package/dist/packages/orchestration/src/index.js +1 -1
  93. package/dist/packages/planner/src/index.js +1 -1
  94. package/dist/packages/policy/src/index.js +1 -1
  95. package/dist/packages/runtime/src/index.js +1 -1
  96. package/dist/packages/sandbox/src/index.js +1 -1
  97. package/dist/packages/validator/src/index.js +1 -1
  98. package/dist/scripts/adr.js +4 -4
  99. package/dist/scripts/agent-harness.js +30 -23
  100. package/dist/scripts/agent-router.js +22 -5
  101. package/dist/scripts/agent.js +5 -5
  102. package/dist/scripts/architecture.js +6 -6
  103. package/dist/scripts/audit-query.js +1 -1
  104. package/dist/scripts/audit-sync.js +1 -1
  105. package/dist/scripts/build-smart-context.d.ts +19 -1
  106. package/dist/scripts/build-smart-context.js +84 -68
  107. package/dist/scripts/check-standards.js +8 -3
  108. package/dist/scripts/code-context.js +1 -1
  109. package/dist/scripts/compress-memory.js +3 -2
  110. package/dist/scripts/compress-project-memory.js +2 -2
  111. package/dist/scripts/context-ops.js +13 -5
  112. package/dist/scripts/cost-economy.js +4 -4
  113. package/dist/scripts/demo-autonomy.js +11 -11
  114. package/dist/scripts/demo-workspace.js +12 -4
  115. package/dist/scripts/dev.js +8 -7
  116. package/dist/scripts/drift-check.js +5 -5
  117. package/dist/scripts/engineer.js +11 -11
  118. package/dist/scripts/evidence.js +4 -4
  119. package/dist/scripts/extract-global-knowledge.js +6 -4
  120. package/dist/scripts/forja-setup.js +2 -1
  121. package/dist/scripts/forja-status.d.ts +1 -1
  122. package/dist/scripts/forja-status.js +31 -3
  123. package/dist/scripts/gates.js +1 -1
  124. package/dist/scripts/generate-dashboard.js +6 -4
  125. package/dist/scripts/governance-dashboard.js +2 -2
  126. package/dist/scripts/hook-session-start.js +18 -9
  127. package/dist/scripts/hook-user-prompt.js +3 -2
  128. package/dist/scripts/incident.js +4 -4
  129. package/dist/scripts/llm-fit.js +11 -11
  130. package/dist/scripts/memory-audit.js +1 -1
  131. package/dist/scripts/memory-schema.js +3 -2
  132. package/dist/scripts/orchestrate.js +4 -5
  133. package/dist/scripts/project-smoke.js +13 -2
  134. package/dist/scripts/project-templates.d.ts +1 -0
  135. package/dist/scripts/project-templates.js +20 -0
  136. package/dist/scripts/project-upgrade.d.ts +13 -0
  137. package/dist/scripts/project-upgrade.js +107 -40
  138. package/dist/scripts/project-wire.d.ts +8 -0
  139. package/dist/scripts/project-wire.js +55 -0
  140. package/dist/scripts/provenance.js +3 -3
  141. package/dist/scripts/query-universal-memory.js +7 -4
  142. package/dist/scripts/release-check.js +1 -1
  143. package/dist/scripts/risk.js +4 -4
  144. package/dist/scripts/simulate.js +9 -9
  145. package/dist/scripts/spec-cli.d.ts +1 -0
  146. package/dist/scripts/spec-cli.js +25 -5
  147. package/dist/scripts/sprint-manager.js +21 -8
  148. package/dist/scripts/sync-universal-memory.js +50 -27
  149. package/dist/scripts/token-benchmark.js +4 -3
  150. package/dist/scripts/token-economy.js +4 -3
  151. package/dist/scripts/tools-doctor.d.ts +1 -1
  152. package/dist/scripts/tools-doctor.js +25 -3
  153. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  154. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  155. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  156. package/docs/glossary.md +4 -4
  157. package/docs/init-project.md +88 -444
  158. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  159. package/docs/modos-de-operacao.md +1 -1
  160. package/docs/processo-projeto.md +14 -11
  161. package/docs/produto/roteiro-demo.md +15 -18
  162. package/docs/publishing.md +5 -0
  163. package/docs/quick-reference.md +15 -23
  164. package/docs/structure.md +16 -30
  165. package/lib/core/model-pricing.json +19 -0
  166. package/memory/30-projects/README.md +1 -1
  167. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  168. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  169. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  170. package/memory/90-decisions/0088-templates-validados.md +55 -0
  171. package/package.json +25 -25
  172. package/templates/project/AGENTS.md +75 -0
  173. package/templates/project/CLAUDE.md +9 -0
  174. package/templates/project/agents/context-engineer.md +15 -0
  175. package/templates/project/agents/governance.md +15 -0
  176. package/templates/project/agents/marketing.md +15 -0
  177. package/templates/project/agents/orchestrator.md +15 -0
  178. package/templates/project/agents/product.md +15 -0
  179. package/templates/project/agents/sdd-architect.md +15 -0
  180. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  181. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -55,7 +55,6 @@ export declare function defaultEnv(overrides?: {}): {
55
55
  };
56
56
  /** Estamos dentro do repo do framework, e não numa instalação do pacote? */
57
57
  export declare function isFrameworkRepo(env: any): boolean;
58
- /** @type {Check[]} */
59
58
  export declare const CHECKS: Check[];
60
59
  /**
61
60
  * SPEC-043 (AC-7): em qual bloco cada resultado aparece no `tools:doctor` e no hook SessionStart.
@@ -35,18 +35,19 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
35
35
  import fs from 'node:fs';
36
36
  import path from 'node:path';
37
37
  import { fileURLToPath } from 'node:url';
38
- import { getWorkspaceDbPath, getWorkspaceInfo } from "../workspace.js";
39
- import { runChecks as run, worstStatus, stripTemplateLiterals, asErrno } from "./checks.js";
40
- import { COMMANDS } from "./registry.js";
41
- import { scanCommands, scanLinks, projectCommands, scanAdrRefs, adrNumbers, commandCited } from "./doc-graph.js";
42
- import { topologyIssues } from "../agent-topology.js";
43
- import { CLI_INTERFACE_COMMANDS } from "../../apps/cli/src/index.js";
38
+ import { getWorkspaceDbPath, getWorkspaceInfo } from '../workspace.js';
39
+ import { runChecks as run, worstStatus, stripTemplateLiterals, asErrno } from './checks.js';
40
+ import { COMMANDS } from './registry.js';
41
+ import { scanCommands, scanLinks, projectCommands, scanAdrRefs, adrNumbers, commandCited } from './doc-graph.js';
42
+ import { topologyIssues } from '../agent-topology.js';
43
+ import { CLI_INTERFACE_COMMANDS } from '../../apps/cli/src/index.js';
44
+ import { pkgRoot } from '../paths.js';
44
45
  /** @typedef {import('./checks.ts').Status} Status */
45
46
  // O runner vive em checks.mjs e é compartilhado com o catálogo de release (SPEC-010). Re-exportado
46
47
  // aqui para que `tools:doctor` e o hook SessionStart sigam importando de um lugar só.
47
48
  export { worstStatus };
48
49
  const __filename = fileURLToPath(import.meta.url);
49
- const repoRoot = path.resolve(path.dirname(__filename), '..', '..');
50
+ const repoRoot = pkgRoot;
50
51
  /**
51
52
  * Ambiente injetável. Existe para que os probes sejam testáveis sem mockar o loader de módulos
52
53
  * do Node nem corromper `node_modules` de verdade — simular um ABI quebrado é passar um
@@ -597,6 +598,30 @@ const agentTopology = {
597
598
  },
598
599
  };
599
600
  /** @type {Check[]} */
601
+ /** Handoffs abertos sem dono visível (sem projeto, ou de projeto que não existe mais). Higiene: avisa. */
602
+ const handoffOrphans = {
603
+ id: 'handoff-orphans',
604
+ title: 'todo handoff aberto pertence a um projeto existente',
605
+ severity: 'warn',
606
+ scope: 'runtime',
607
+ async probe(env) {
608
+ const info = env.workspace.info();
609
+ if (!info.exists)
610
+ return { status: 'skipped', detail: 'sem workspace', fix: null };
611
+ const { orphanHandoffs } = await import('../handoffs-index.js');
612
+ const { listProjects, getForjaMode, getWorkspaceRoot } = await import('../workspace.js');
613
+ const known = getForjaMode() === 'embedded' ? [path.basename(getWorkspaceRoot())] : listProjects();
614
+ const orphans = await orphanHandoffs(known);
615
+ if (!orphans.length)
616
+ return { status: 'ok', detail: 'nenhum handoff órfão', fix: null };
617
+ const ids = orphans.map((o) => `#${o.id}${o.project ? ` (${o.project})` : ''}`).join(', ');
618
+ return {
619
+ status: 'warn',
620
+ detail: `${orphans.length} handoff(s) aberto(s) sem projeto existente: ${ids}`,
621
+ fix: `revise com forja agent:route show <id> e feche com forja agent:route archive <id>`,
622
+ };
623
+ },
624
+ };
600
625
  export const CHECKS = [
601
626
  nativeAbi,
602
627
  memoryDb,
@@ -610,6 +635,7 @@ export const CHECKS = [
610
635
  docsLinks,
611
636
  adrRefs,
612
637
  agentTopology,
638
+ handoffOrphans,
613
639
  ];
614
640
  const FIRST_RUN_CHECKS = new Set(['memory-db', 'memory-fresh', 'workspace']);
615
641
  export function bucketFor(id) {
@@ -0,0 +1,30 @@
1
+ /**
2
+ * lib/core/journey.ts — a jornada do usuário, executada de verdade (ADR-0086).
3
+ *
4
+ * Os checks de consumidor do release (spec:new, project:check, gsd:*) nasceram um por bug e
5
+ * provavam cada peça isolada. Nenhum provava o que o usuário de fato faz: criar um projeto e
6
+ * trabalhar nele com uma IA. Foi nessa lacuna que a v4 saiu com `project:new` gerando projetos
7
+ * sem instruções, scripts apontando para arquivos ausentes e `context:smart` sem modo task.
8
+ *
9
+ * `runJourney` cria workspace e projeto num HOME descartável e percorre o caminho feliz dentro do
10
+ * projeto — memória, contexto, specs, gates, hooks e MCP —, conferindo o EFEITO de cada passo, não
11
+ * só o exit code. Roda contra o fonte (`npm test`) e contra o pacote instalado (`release:check`).
12
+ */
13
+ export interface JourneyStep {
14
+ readonly id: string;
15
+ readonly ok: boolean;
16
+ readonly detail: string;
17
+ }
18
+ export interface JourneyOptions {
19
+ /** Entry point do forja: `bin/forja.ts` (fonte) ou `<pkg>/dist/bin/forja.js` (instalado). */
20
+ readonly bin: string;
21
+ /** Raiz do pacote do Forja em teste: nada nela pode mudar durante a jornada. */
22
+ readonly pkgDir: string;
23
+ /** Versão esperada no handshake do MCP. */
24
+ readonly version: string;
25
+ /** Diretório base descartável; criado e removido se omitido. */
26
+ readonly baseDir?: string;
27
+ /** Mantém o diretório para inspeção (debug). */
28
+ readonly keep?: boolean;
29
+ }
30
+ export declare function runJourney(opts: JourneyOptions): JourneyStep[];
@@ -0,0 +1,142 @@
1
+ /**
2
+ * lib/core/journey.ts — a jornada do usuário, executada de verdade (ADR-0086).
3
+ *
4
+ * Os checks de consumidor do release (spec:new, project:check, gsd:*) nasceram um por bug e
5
+ * provavam cada peça isolada. Nenhum provava o que o usuário de fato faz: criar um projeto e
6
+ * trabalhar nele com uma IA. Foi nessa lacuna que a v4 saiu com `project:new` gerando projetos
7
+ * sem instruções, scripts apontando para arquivos ausentes e `context:smart` sem modo task.
8
+ *
9
+ * `runJourney` cria workspace e projeto num HOME descartável e percorre o caminho feliz dentro do
10
+ * projeto — memória, contexto, specs, gates, hooks e MCP —, conferindo o EFEITO de cada passo, não
11
+ * só o exit code. Roda contra o fonte (`npm test`) e contra o pacote instalado (`release:check`).
12
+ */
13
+ import fs from 'node:fs';
14
+ import os from 'node:os';
15
+ import path from 'node:path';
16
+ import { spawnSync } from 'node:child_process';
17
+ /** Assinatura (caminho → mtime+tamanho) dos arquivos do pacote — para provar que a jornada não o tocou. */
18
+ function snapshot(dir) {
19
+ const out = new Map();
20
+ const walk = (d) => {
21
+ for (const e of fs.readdirSync(d, { withFileTypes: true })) {
22
+ if (e.name === 'node_modules' || e.name === '.git' || e.name === '.context')
23
+ continue;
24
+ const p = path.join(d, e.name);
25
+ if (e.isDirectory())
26
+ walk(p);
27
+ else if (e.isFile()) {
28
+ const st = fs.statSync(p);
29
+ out.set(path.relative(dir, p), `${st.mtimeMs}:${st.size}`);
30
+ }
31
+ }
32
+ };
33
+ walk(dir);
34
+ return out;
35
+ }
36
+ const LOADER_ERRORS = /ERR_MODULE_NOT_FOUND|ERR_DLOPEN_FAILED|Cannot find module|ERR_PACKAGE_PATH_NOT_EXPORTED|TypeError|ReferenceError/;
37
+ export function runJourney(opts) {
38
+ const base = opts.baseDir ?? fs.mkdtempSync(path.join(os.tmpdir(), 'forja-journey-'));
39
+ const home = path.join(base, 'home');
40
+ fs.mkdirSync(home, { recursive: true });
41
+ // Usuário real: HOME próprio, sem FORJA_* nem npm_* herdados (o mesmo isolamento do release).
42
+ const env = { ...process.env, HOME: home, USERPROFILE: home };
43
+ for (const k of Object.keys(env))
44
+ if (k.startsWith('FORJA_') || k.startsWith('npm_') || k === 'NODE_PATH')
45
+ delete env[k];
46
+ const steps = [];
47
+ const add = (id, ok, detail) => steps.push({ id, ok, detail });
48
+ const forja = (args, cwd, input) => {
49
+ const r = spawnSync(process.execPath, [opts.bin, ...args], { cwd, env, input, encoding: 'utf8', timeout: 180_000 });
50
+ const out = `${r.stdout || ''}${r.stderr || ''}`;
51
+ return { code: r.status ?? 1, out, stdout: r.stdout || '' };
52
+ };
53
+ const firstLine = (s) => s.trim().split('\n').filter(Boolean).slice(-3).join(' | ').slice(0, 300);
54
+ const clean = (r) => !LOADER_ERRORS.test(r.out);
55
+ const before = snapshot(opts.pkgDir);
56
+ try {
57
+ const ws = path.join(home, 'forja-workspace');
58
+ const proj = path.join(ws, 'projects', 'jornada');
59
+ let r = forja(['workspace:init'], home);
60
+ add('workspace:init', r.code === 0 && fs.existsSync(path.join(ws, 'projects')), firstLine(r.out));
61
+ r = forja(['project:new', 'jornada', '--ai', 'claude,codex,gemini,copilot', '--skip-backend'], home);
62
+ add('project:new', r.code === 0 && clean(r) && fs.existsSync(path.join(proj, 'AGENTS.md')), r.code === 0 ? 'projeto gerado' : firstLine(r.out));
63
+ if (!fs.existsSync(proj))
64
+ return steps;
65
+ r = forja(['project:wire', '--check', '--json'], proj);
66
+ let wiring = null;
67
+ try {
68
+ wiring = JSON.parse(r.stdout);
69
+ }
70
+ catch { /* reportado abaixo */ }
71
+ const wiringFails = (wiring?.checks ?? []).filter((c) => c.status === 'fail').map((c) => `${c.id}: ${c.detail}`);
72
+ add('project:wire', r.code === 0 && wiring?.ok === true, wiring ? (wiringFails.join('; ') || `${wiring.checks.length} checks ok`) : firstLine(r.out));
73
+ r = forja(['status'], proj);
74
+ add('status', r.code === 0 && /memória indexada: sim/.test(r.out), /memória indexada: sim/.test(r.out) ? 'memória indexada de nascença' : firstLine(r.out));
75
+ r = forja(['spec:new', 'pagamentos'], proj);
76
+ const spec = path.join(proj, 'specs', 'pagamentos', 'spec.md');
77
+ const specOk = fs.existsSync(spec) && /\*\*ID\*\*:\s*SPEC-001/.test(fs.readFileSync(spec, 'utf8'));
78
+ add('spec:new', r.code === 0 && specOk, specOk ? 'specs/pagamentos/spec.md (SPEC-001)' : firstLine(r.out));
79
+ r = forja(['sync:universal'], proj);
80
+ add('sync:universal', r.code === 0 && clean(r), firstLine(r.out));
81
+ r = forja(['query:universal', 'pagamentos'], proj);
82
+ add('query:universal', r.code === 0 && /\[Projeto: jornada\]/.test(r.out), /\[Projeto: jornada\]/.test(r.out) ? 'acha a spec do projeto' : firstLine(r.out));
83
+ r = forja(['context:smart', '--mode', 'task', '--task', 'pagamentos'], proj);
84
+ const pack = path.join(proj, '.context', 'smart-context.md');
85
+ const packOk = fs.existsSync(pack) && fs.readFileSync(pack, 'utf8').includes('specs/pagamentos/spec.md');
86
+ add('context:smart', r.code === 0 && packOk, packOk ? 'modo task inclui a spec' : firstLine(r.out));
87
+ r = forja(['spec:check'], proj);
88
+ add('spec:check', r.code === 0 && /pagamentos/.test(r.out), firstLine(r.out));
89
+ r = forja(['project:check'], proj);
90
+ add('project:check', r.code === 0, firstLine(r.out));
91
+ r = forja(['tools:doctor'], proj);
92
+ add('tools:doctor', r.code === 0 && /Projeto —/.test(r.out), firstLine(r.out));
93
+ r = forja(['hook:session-start'], proj, '{}');
94
+ let ctx = '';
95
+ try {
96
+ ctx = JSON.parse(r.stdout).hookSpecificOutput.additionalContext;
97
+ }
98
+ catch { /* reportado abaixo */ }
99
+ add('hook:session-start', r.code === 0 && ctx.includes('pagamentos'), ctx ? 'briefing cita a spec ativa' : firstLine(r.out));
100
+ r = forja(['hook:user-prompt'], proj, JSON.stringify({ prompt: 'implementar a spec pagamentos' }));
101
+ ctx = '';
102
+ try {
103
+ ctx = JSON.parse(r.stdout).hookSpecificOutput.additionalContext;
104
+ }
105
+ catch { /* reportado abaixo */ }
106
+ add('hook:user-prompt', r.code === 0 && ctx.includes('specs/pagamentos/spec.md'), ctx ? 'injeta a spec citada' : firstLine(r.out));
107
+ const init = JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2025-06-18', capabilities: {}, clientInfo: { name: 'journey', version: '1' } } });
108
+ r = forja(['mcp:start'], proj, `${init}\n`);
109
+ let version = '';
110
+ try {
111
+ version = JSON.parse(r.stdout.split('\n').find((l) => l.includes('"id":1')) ?? '').result.serverInfo.version;
112
+ }
113
+ catch { /* reportado abaixo */ }
114
+ add('mcp:start', version === opts.version, version ? `serverInfo.version ${version}` : firstLine(r.out));
115
+ // Handoff (ADR-0005) registrado no projeto chega ao `next` do projeto, carimbado com ele.
116
+ const handoff = { from: 'worker', to: 'governance', intent: 'review', context: 'specs/pagamentos', acceptance: 'ACs com evidência', constraints: 'jornada', return: 'orchestrator' };
117
+ r = forja(['hermes:handoff', JSON.stringify(handoff)], proj);
118
+ let hid = 0;
119
+ try {
120
+ hid = JSON.parse(r.stdout.trim().split('\n').pop() ?? '').id;
121
+ }
122
+ catch { /* reportado abaixo */ }
123
+ const next = forja(['next'], proj);
124
+ const mine = forja(['agent:route', 'list', '--mine'], proj);
125
+ const listed = mine.out.includes(`#${hid} [open] {jornada}`);
126
+ add('hermes:handoff', r.code === 0 && hid > 0 && next.out.includes(`agent:route show ${hid}`) && listed, hid ? `#${hid} → next: ${firstLine(next.out)}${listed ? '' : ` · list --mine: ${firstLine(mine.out)}`}` : firstLine(r.out));
127
+ // Comandos que escreviam no pacote quando rodados num projeto (v4): agora gravam no projeto.
128
+ r = forja(['project:dashboard'], proj);
129
+ add('project:dashboard', r.code === 0 && fs.existsSync(path.join(proj, 'DASHBOARD-PROGRESSO.md')), firstLine(r.out));
130
+ r = forja(['memory:extract'], proj);
131
+ add('memory:extract', r.code === 0 && fs.existsSync(path.join(proj, 'memory', '00-global', 'shared-knowledge.md')), firstLine(r.out));
132
+ return steps;
133
+ }
134
+ finally {
135
+ // Classe de bug da v1.6.1/v1.7.0/v4: comando rodado no projeto escrevendo dentro do pacote.
136
+ const after = snapshot(opts.pkgDir);
137
+ const touched = [...new Set([...before.keys(), ...after.keys()])].filter((k) => before.get(k) !== after.get(k));
138
+ add('pacote-intocado', touched.length === 0, touched.length ? `a jornada alterou o pacote: ${touched.slice(0, 8).join(', ')}` : 'nenhum arquivo do pacote mudou');
139
+ if (!opts.keep && !opts.baseDir)
140
+ fs.rmSync(base, { recursive: true, force: true });
141
+ }
142
+ }
@@ -10,11 +10,9 @@
10
10
  * chama decide o que fazer com isso — normalmente: seguir a execução e avisar, nunca bloquear.
11
11
  */
12
12
  import fs from 'node:fs';
13
- import path from 'node:path';
14
- import { fileURLToPath } from 'node:url';
15
- const __filename = fileURLToPath(import.meta.url);
16
- const __dirname = path.dirname(__filename);
17
- export const DEFAULT_PRICING_PATH = path.join(__dirname, 'model-pricing.json');
13
+ import { asset } from '../paths.js';
14
+ // Asset versionado (não código): o tsc não copia .json para o dist/, então lido da raiz do pacote.
15
+ export const DEFAULT_PRICING_PATH = asset('lib', 'core', 'model-pricing.json');
18
16
  /** Dias após os quais um preço não revisado é considerado velho (risco do SPEC-029: "asOf > 90 dias"). */
19
17
  export const STALE_PRICE_MAX_AGE_DAYS = 90;
20
18
  export class ModelPricingError extends Error {
@@ -22,6 +22,8 @@ interface SmokeEnv {
22
22
  full: boolean;
23
23
  /** SPEC-047: lista de IAs. Presente ⇒ gera só-memória + instruções nativas; ativa `ai-instructions`. */
24
24
  ai?: readonly string[];
25
+ /** ADR-0088: projeto gerado a partir de um template (backend vem do boilerplate). */
26
+ template?: string;
25
27
  spawn: (cmd: string, args: string[], opts?: any) => {
26
28
  stdout: string;
27
29
  stderr: string;
@@ -34,17 +36,19 @@ interface SmokeEnv {
34
36
  */
35
37
  export declare function withGeneratedProject<T>(fn: (ctx: {
36
38
  projectDir: string;
37
- }) => Promise<T> | T, { root, spawn, ai }: {
39
+ }) => Promise<T> | T, { root, spawn, ai, template }: {
38
40
  root?: string;
39
41
  spawn: SmokeEnv['spawn'];
40
42
  ai?: readonly string[];
43
+ template?: string;
41
44
  }): Promise<T>;
42
45
  /** @type {Check[]} */
43
46
  export declare const SMOKE_CHECKS: Check[];
44
47
  export declare function defaultEnv(overrides?: Partial<SmokeEnv>): SmokeEnv;
45
48
  /** Gera um projeto isolado, roda os checks, limpa. */
46
- export declare function runProjectSmoke({ full, ai, env: overrides }?: {
49
+ export declare function runProjectSmoke({ full, ai, template, env: overrides }?: {
47
50
  full?: boolean;
48
51
  ai?: string[];
52
+ template?: string;
49
53
  env?: Partial<SmokeEnv>;
50
54
  }): Promise<import("./checks.ts").Result[]>;
@@ -16,39 +16,45 @@ import fs from 'node:fs';
16
16
  import os from 'node:os';
17
17
  import path from 'node:path';
18
18
  import { fileURLToPath } from 'node:url';
19
- import { runChecks as run, worstStatus } from "./checks.js";
20
- import { resolveScript } from "./registry.js";
21
- import { writeAiInstructions, stripInstructionHeader, AI_LABELS } from "../multi-ai-instructions.js";
19
+ import { runChecks as run, worstStatus } from './checks.js';
20
+ import { resolveScript } from './registry.js';
21
+ import { wireProject, checkProjectWiring } from '../project-wiring.js';
22
+ import { resolveTemplate, applyTemplate } from '../templates.js';
23
+ import { COMMANDS } from './registry.js';
22
24
  // @ts-ignore — validador legado sem tipos exportados; usado só pela forma { isValid, errors }.
23
- import { validateProjectStructure } from "../validators/structure-validator.js";
25
+ import { validateProjectStructure } from '../validators/structure-validator.js';
26
+ import { pkgRoot, script } from '../paths.js';
24
27
  export { worstStatus };
25
28
  const __filename = fileURLToPath(import.meta.url);
26
- const repoRoot = path.resolve(path.dirname(__filename), '..', '..');
29
+ const repoRoot = pkgRoot;
27
30
  /** Placeholders do gerador: identificadores MAIÚSCULOS entre chaves duplas (`{{FEATURE}}`). */
28
31
  const PLACEHOLDER_RE = /\{\{[A-Z][A-Z0-9_]*\}\}/;
29
32
  /**
30
33
  * Gera um projeto num diretório temporário isolado e entrega o caminho ao callback. Limpa o
31
34
  * temporário **sempre**, inclusive quando o callback lança — o mesmo contrato do `withCleanInstall`.
32
35
  */
33
- export async function withGeneratedProject(fn, { root = repoRoot, spawn, ai }) {
36
+ export async function withGeneratedProject(fn, { root = repoRoot, spawn, ai, template }) {
34
37
  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'forja-smoke-'));
35
38
  const projectDir = path.join(dir, 'smoke-proj');
36
39
  const aiMode = Array.isArray(ai) && ai.length > 0;
37
40
  try {
38
41
  // resolveScript acha .ts em dev e .js no dist — cravar .ts quebrava no pacote publicado.
39
- const gen = resolveScript(root, 'bin/create-memory-nest-kit');
40
- // Modo --ai (SPEC-047): só a memória — `create-memory-nest-kit` roda em dev, `init-project.ts`
41
- // não (hardcoda `.js`) e trata o path como projeto de workspace. As instruções nativas vêm de
42
- // lib/multi-ai-instructions.ts, a mesma fonte que o gerador usa. Sem rede, sem backend.
43
- const genArgs = aiMode
42
+ // Raiz padrão = pacote: o gerador é código (codeRoot, `dist/` publicado), não asset.
43
+ const gen = root === pkgRoot ? script('bin/create-memory-nest-kit') : resolveScript(root, 'bin/create-memory-nest-kit');
44
+ // Modo --ai (SPEC-047): só a memória + a conexão de lib/project-wiring.ts, a mesma que o
45
+ // gerador faz. Com --template, o backend vem do boilerplate (mesmo caminho do project:new).
46
+ const tpl = template ? resolveTemplate(template) : null;
47
+ const genArgs = aiMode || tpl
44
48
  ? [gen, projectDir, '--only-memory', '--force']
45
49
  : [gen, projectDir, '--force'];
46
50
  const res = spawn(process.execPath, genArgs, { cwd: dir });
47
51
  if (res.code !== 0) {
48
52
  throw new Error(`o gerador saiu com código ${res.code}:\n${(res.stderr || res.stdout).slice(0, 800)}`);
49
53
  }
54
+ if (tpl)
55
+ applyTemplate(projectDir, tpl);
50
56
  if (aiMode)
51
- writeAiInstructions(projectDir, ai, { kitRoot: root });
57
+ wireProject(projectDir, { ai: ai, codegraph: false });
52
58
  return await fn({ projectDir });
53
59
  }
54
60
  finally {
@@ -172,8 +178,18 @@ const structure = {
172
178
  dependsOn: 'generated',
173
179
  probe(env) {
174
180
  // Modo --ai (SPEC-047) é só-memória — não há backend NestJS para validar.
175
- const includeNest = !(Array.isArray(env.ai) && env.ai.length > 0);
181
+ // Com template, o backend é do boilerplate: valida memória + um backend mínimo, não o layout do
182
+ // NestJS padrão do gerador.
183
+ const includeNest = !(Array.isArray(env.ai) && env.ai.length > 0) && !env.template;
176
184
  const report = validateProjectStructure(env.projectDir, { includeNest });
185
+ if (env.template) {
186
+ for (const rel of ['backend/package.json', 'backend/src']) {
187
+ if (!env.fs.existsSync(path.join(env.projectDir, rel))) {
188
+ report.isValid = false;
189
+ report.errors.push(`template sem ${rel}`);
190
+ }
191
+ }
192
+ }
177
193
  if (!report.isValid) {
178
194
  return {
179
195
  status: 'fail',
@@ -208,7 +224,7 @@ const gateInherited = {
208
224
  */
209
225
  const builds = {
210
226
  id: 'builds',
211
- title: 'o backend gerado instala e buildar (--full)',
227
+ title: 'o backend gerado instala, compila, testa e passa no lint (--full)',
212
228
  severity: 'critical',
213
229
  dependsOn: 'structure',
214
230
  probe(env) {
@@ -227,7 +243,22 @@ const builds = {
227
243
  if (build.code !== 0) {
228
244
  return { status: 'fail', detail: `npm run build falhou no backend gerado:\n${(build.stderr || build.stdout).slice(0, 500)}`, fix: 'o código gerado não compila — confira os templates do nest-generator' };
229
245
  }
230
- return { status: 'ok', detail: 'backend gerado instala e compila', fix: null };
246
+ // Compilar não basta: na v5 o backend gerado compilava, mas `npm test` não achava os tipos do
247
+ // jest (TS 6) e o lint nunca carregou (.eslintrc sem as deps). O projeto tem que rodar o que anuncia.
248
+ // test é obrigatório; test:e2e e lint, quando o projeto os declara (um template pode não ter e2e).
249
+ let scripts = {};
250
+ try {
251
+ scripts = JSON.parse(env.fs.readFileSync(path.join(backend, 'package.json'), 'utf8')).scripts ?? {};
252
+ }
253
+ catch { /* json-valid já reporta */ }
254
+ const ran = ['test', 'test:e2e', 'lint'].filter((name) => name === 'test' || name in scripts);
255
+ for (const script of ran) {
256
+ const res = env.spawn('npm', ['run', script], { cwd: backend });
257
+ if (res.code !== 0) {
258
+ return { status: 'fail', detail: `npm run ${script} falhou no backend gerado:\n${(res.stdout + res.stderr).slice(-600)}`, fix: 'confira os templates do nest-generator (testes, tsconfig, eslint.config.mjs)' };
259
+ }
260
+ }
261
+ return { status: 'ok', detail: `backend gerado instala, compila e passa em: ${ran.join(', ')}`, fix: null };
231
262
  },
232
263
  };
233
264
  /**
@@ -238,59 +269,27 @@ const builds = {
238
269
  */
239
270
  const aiInstructionsCoherent = {
240
271
  id: 'ai-instructions',
241
- title: 'as instruções nativas por IA derivam da mesma fonte (--ai)',
272
+ title: 'o projeto está conectado às IAs pedidas (--ai): instruções, hooks, MCP, comandos citados',
242
273
  severity: 'critical',
243
274
  dependsOn: 'generated',
244
275
  probe(env) {
245
276
  const ai = env.ai;
246
277
  if (!Array.isArray(ai) || ai.length === 0) {
247
- return { status: 'skipped', detail: 'sem --ai (o smoke completo não escreve .ia-instructions/)', fix: null };
278
+ return { status: 'skipped', detail: 'sem --ai (o smoke completo não conecta IAs)', fix: null };
248
279
  }
249
- const dir = path.join(env.projectDir, '.ia-instructions');
250
- const bodies = new Map();
251
- const missing = [];
252
- for (const name of ai) {
253
- const file = path.join(dir, `${name}.md`);
254
- const src = readText(env, file);
255
- if (src == null) {
256
- missing.push(`${name}.md`);
257
- continue;
258
- }
259
- bodies.set(name, stripInstructionHeader(src));
260
- }
261
- if (missing.length) {
262
- return { status: 'fail', detail: `instrução ausente: ${missing.join(', ')}`, fix: 'confira writeAiInstructions / a lista --ai' };
263
- }
264
- const [first, ...rest] = [...bodies.entries()];
265
- for (const [name, body] of rest) {
266
- if (body !== first[1]) {
267
- return {
268
- status: 'fail',
269
- detail: `o corpo de ${name}.md diverge de ${first[0]}.md — as instruções não são a mesma fonte`,
270
- fix: 'toda IA parte de .gemini-instructions.md; só o cabeçalho muda (lib/multi-ai-instructions.ts)',
271
- };
272
- }
273
- }
274
- const modelsRaw = readText(env, path.join(dir, 'models.json'));
275
- let models;
280
+ let checks;
276
281
  try {
277
- models = JSON.parse(modelsRaw ?? '');
282
+ checks = checkProjectWiring(env.projectDir, { commands: COMMANDS, ai });
278
283
  }
279
- catch {
280
- return { status: 'fail', detail: 'models.json ausente ou inválido', fix: 'writeAiInstructions deve gerá-lo' };
281
- }
282
- if (JSON.stringify(models.fallback_chain) !== JSON.stringify([...ai])) {
283
- return { status: 'fail', detail: `models.json fallback_chain ${JSON.stringify(models.fallback_chain)} ≠ --ai ${JSON.stringify(ai)}`, fix: 'sincronize a lista' };
284
+ catch (e) {
285
+ return { status: 'fail', detail: e.message, fix: 'use IAs suportadas: claude, codex, gemini, copilot' };
284
286
  }
285
- for (const name of ai) {
286
- if (models.engines?.[name]?.instruction_file !== `.ia-instructions/${name}.md`) {
287
- return { status: 'fail', detail: `models.json.engines.${name} sem instruction_file correto`, fix: 'writeAiInstructions' };
288
- }
289
- if (!(name in AI_LABELS)) {
290
- return { status: 'fail', detail: `IA desconhecida na lista --ai: ${name} (conhecidas: ${Object.keys(AI_LABELS).join(', ')})`, fix: 'use uma IA suportada' };
291
- }
287
+ // `forja-bin` depende da máquina, não do projeto gerado.
288
+ const failed = checks.filter((c) => c.status === 'fail' && c.id !== 'forja-bin');
289
+ if (failed.length) {
290
+ return { status: 'fail', detail: failed.map((c) => `${c.id}: ${c.detail}`).join('; '), fix: 'lib/project-wiring.ts (forja project:wire)' };
292
291
  }
293
- return { status: 'ok', detail: `${ai.length} instruções coerentes (mesmo corpo, models.json em dia)`, fix: null };
292
+ return { status: 'ok', detail: `${ai.length} IA(s) conectada(s): ${checks.filter((c) => c.status === 'ok').map((c) => c.id).join(', ')}`, fix: null };
294
293
  },
295
294
  };
296
295
  /** @type {Check[]} */
@@ -319,8 +318,8 @@ export function defaultEnv(overrides = {}) {
319
318
  };
320
319
  }
321
320
  /** Gera um projeto isolado, roda os checks, limpa. */
322
- export async function runProjectSmoke({ full = false, ai, env: overrides = {} } = {}) {
321
+ export async function runProjectSmoke({ full = false, ai, template, env: overrides = {} } = {}) {
323
322
  const aiList = ai && ai.length > 0 ? ai : undefined;
324
- const base = defaultEnv({ full, ...(aiList ? { ai: aiList } : {}), ...overrides });
325
- return withGeneratedProject(({ projectDir }) => run({ checks: SMOKE_CHECKS, env: { ...base, projectDir } }), { root: base.root, spawn: base.spawn, ai: base.ai });
323
+ const base = defaultEnv({ full, ...(aiList ? { ai: aiList } : {}), ...(template ? { template } : {}), ...overrides });
324
+ return withGeneratedProject(({ projectDir }) => run({ checks: SMOKE_CHECKS, env: { ...base, projectDir } }), { root: base.root, spawn: base.spawn, ai: base.ai, template });
326
325
  }
@@ -13,17 +13,7 @@
13
13
  * - workspace bloqueia se o workspace (ADR-0019) não existir
14
14
  * - workspace-warn avisa se o workspace não existir, mas segue
15
15
  */
16
- /**
17
- * Resolve o `node:` de um comando para o arquivo real, **agnóstico de extensão** (SPEC-012 D2).
18
- * Tenta `.ts → .js → .mjs`: em dev acha a fonte `.ts`; no pacote publicado, o `.js` sob `dist/`.
19
- * Desacopla o registry do runtime — a entrada pode manter `.mjs` que este resolver ainda acha o
20
- * `.ts` renomeado. Sem isto, renomear um script quebraria o dispatch.
21
- *
22
- * @param {string} root Raiz onde os scripts vivem (repo em dev, `dist/` no publicado).
23
- * @param {string} node Caminho do registry, com ou sem extensão.
24
- * @returns {string} Caminho absoluto do arquivo que existe (ou o candidato original, que falha visível).
25
- */
26
- export declare function resolveScript(root: any, node: any): string;
16
+ export { resolveScript } from '../paths.ts';
27
17
  export declare const DOMAINS: {
28
18
  workspace: string;
29
19
  sdd: string;
@@ -34,7 +24,6 @@ export declare const DOMAINS: {
34
24
  contexto: string;
35
25
  llm: string;
36
26
  governanca: string;
37
- geracao: string;
38
27
  };
39
28
  export interface CommandArg {
40
29
  readonly name: string;
@@ -13,29 +13,8 @@
13
13
  * - workspace bloqueia se o workspace (ADR-0019) não existir
14
14
  * - workspace-warn avisa se o workspace não existir, mas segue
15
15
  */
16
- import fs from 'node:fs';
17
- import path from 'node:path';
18
- /**
19
- * Resolve o `node:` de um comando para o arquivo real, **agnóstico de extensão** (SPEC-012 D2).
20
- * Tenta `.ts → .js → .mjs`: em dev acha a fonte `.ts`; no pacote publicado, o `.js` sob `dist/`.
21
- * Desacopla o registry do runtime — a entrada pode manter `.mjs` que este resolver ainda acha o
22
- * `.ts` renomeado. Sem isto, renomear um script quebraria o dispatch.
23
- *
24
- * @param {string} root Raiz onde os scripts vivem (repo em dev, `dist/` no publicado).
25
- * @param {string} node Caminho do registry, com ou sem extensão.
26
- * @returns {string} Caminho absoluto do arquivo que existe (ou o candidato original, que falha visível).
27
- */
28
- export function resolveScript(root, node) {
29
- const direct = path.join(root, node);
30
- if (fs.existsSync(direct))
31
- return direct;
32
- const base = direct.replace(/\.(mjs|cjs|js|ts)$/, '');
33
- for (const ext of ['.ts', '.js', '.mjs']) {
34
- if (fs.existsSync(base + ext))
35
- return base + ext;
36
- }
37
- return direct;
38
- }
16
+ // Resolução de script agnóstica de extensão (SPEC-012 D2) — vive em lib/paths.ts (ADR-0086).
17
+ export { resolveScript } from '../paths.js';
39
18
  export const DOMAINS = {
40
19
  workspace: 'Workspace & projetos',
41
20
  sdd: 'Pipeline SDD (spec → plan → tasks → check)',
@@ -46,7 +25,6 @@ export const DOMAINS = {
46
25
  contexto: 'Contexto & token economy',
47
26
  llm: 'LLMs & execução supervisionada',
48
27
  governanca: 'Governança & qualidade',
49
- geracao: 'Geração de projetos',
50
28
  };
51
29
  export const COMMANDS = {
52
30
  // --- Workspace & projetos ---------------------------------------------
@@ -67,7 +45,7 @@ export const COMMANDS = {
67
45
  args: ['project:new'],
68
46
  gates: ['workspace'],
69
47
  tier: 'core',
70
- usage: 'forja project:new <nome> [-- --ai claude,copilot]',
48
+ usage: 'forja project:new <nome> [-- --ai claude,copilot] [--template <nome>]',
71
49
  cliArgs: [{ name: 'nome', required: true, desc: 'slug do projeto (kebab-case)' }],
72
50
  examples: ['forja project:new meu-app -- --ai claude,copilot'],
73
51
  next: ['workspace:project:check'],
@@ -91,8 +69,12 @@ export const COMMANDS = {
91
69
  },
92
70
  'project:upgrade': {
93
71
  domain: 'workspace',
94
- desc: 'Traz peças novas de scaffold para um projeto gerado — aditivo (SPEC-018). --apply para copiar',
72
+ desc: 'Traz peças novas de scaffold e religa a IA num projeto (ou --all) — aditivo; --apply aplica',
95
73
  node: 'scripts/project-upgrade.ts',
74
+ spec: 'SPEC-018, ADR-0086',
75
+ usage: 'forja project:upgrade [--apply] [--project <path> | --all] [--json]',
76
+ examples: ['forja project:upgrade', 'forja project:upgrade --all', 'forja project:upgrade --all --apply'],
77
+ next: ['project:wire'],
96
78
  },
97
79
  'workspace:project:check': {
98
80
  domain: 'workspace',
@@ -722,6 +704,39 @@ export const COMMANDS = {
722
704
  examples: ['forja tools:doctor', 'forja tools:doctor --json'],
723
705
  next: ['setup'],
724
706
  },
707
+ 'project:templates': {
708
+ domain: 'workspace',
709
+ desc: 'Lista os boilerplates: quais são templates validados (project:new --template) e quais são referência',
710
+ node: 'scripts/project-templates.ts',
711
+ spec: 'ADR-0088',
712
+ readonly: true,
713
+ usage: 'forja project:templates [--json]',
714
+ examples: ['forja project:templates'],
715
+ next: ['project:new'],
716
+ },
717
+ 'project:wire': {
718
+ domain: 'workspace',
719
+ desc: 'Conecta o projeto à inteligência do Forja: instruções nativas, hooks, sub-agents e MCP',
720
+ node: 'scripts/project-wire.ts',
721
+ spec: 'ADR-0086',
722
+ usage: 'forja project:wire [--check] [--ai claude,codex,gemini,copilot] [--json]',
723
+ examples: ['forja project:wire', 'forja project:wire --check'],
724
+ next: ['status'],
725
+ },
726
+ 'hook:session-start': {
727
+ domain: 'governanca',
728
+ desc: 'Hook SessionStart: briefing de specs, handoffs e saúde do núcleo para a IA',
729
+ node: 'scripts/hook-session-start.ts',
730
+ spec: 'ADR-0086',
731
+ readonly: true,
732
+ },
733
+ 'hook:user-prompt': {
734
+ domain: 'governanca',
735
+ desc: 'Hook UserPromptSubmit: injeta o contexto da spec citada no prompt',
736
+ node: 'scripts/hook-user-prompt.ts',
737
+ spec: 'ADR-0086',
738
+ readonly: true,
739
+ },
725
740
  'demo:autonomy': {
726
741
  domain: 'governanca',
727
742
  desc: 'Executa a prova offline de autonomia supervisionada com Git worktree real',
@@ -743,7 +758,7 @@ export const COMMANDS = {
743
758
  node: 'scripts/project-smoke.ts',
744
759
  spec: 'SPEC-015, SPEC-047',
745
760
  readonly: true,
746
- usage: 'forja project:smoke [--full] [--ai claude,copilot,gemini,codex]',
761
+ usage: 'forja project:smoke [--full] [--ai claude,copilot,gemini,codex] [--template <nome>]',
747
762
  examples: ['forja project:smoke', 'forja project:smoke --ai claude,copilot'],
748
763
  },
749
764
  'check:all': {
@@ -772,9 +787,4 @@ export const COMMANDS = {
772
787
  node: 'scripts/governance-dashboard.ts',
773
788
  },
774
789
  // --- Geração ----------------------------------------------------------------------
775
- 'init:project': {
776
- domain: 'geracao',
777
- desc: 'Gera projeto direto num path (prefira project:new)',
778
- node: 'bin/init-project.ts',
779
- },
780
790
  };