forjajs 2.0.3 → 3.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 (160) hide show
  1. package/.claude/agents/release-auditor.md +19 -10
  2. package/AGENTS.md +1 -1
  3. package/CHANGELOG.md +80 -0
  4. package/DOC-MAP.md +9 -0
  5. package/README.md +85 -5
  6. package/README.pt-BR.md +34 -5
  7. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  8. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  9. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  10. package/dist/apps/server/src/forja-nest.module.js +9 -4
  11. package/dist/apps/server/src/main.js +10 -1
  12. package/dist/bin/forja.js +14 -2
  13. package/dist/lib/code-context.js +6 -0
  14. package/dist/lib/core/architecture-gate.d.ts +20 -0
  15. package/dist/lib/core/architecture-gate.js +60 -0
  16. package/dist/lib/core/doc-graph.js +6 -4
  17. package/dist/lib/core/drift-gate.d.ts +18 -0
  18. package/dist/lib/core/drift-gate.js +55 -0
  19. package/dist/lib/core/gates.d.ts +9 -2
  20. package/dist/lib/core/gates.js +13 -2
  21. package/dist/lib/core/health.js +15 -0
  22. package/dist/lib/core/incident-search.d.ts +19 -0
  23. package/dist/lib/core/incident-search.js +32 -0
  24. package/dist/lib/core/model-pricing.d.ts +31 -0
  25. package/dist/lib/core/model-pricing.js +74 -0
  26. package/dist/lib/core/registry.d.ts +248 -0
  27. package/dist/lib/core/registry.js +249 -0
  28. package/dist/lib/core/release.d.ts +247 -0
  29. package/dist/lib/core/release.js +5 -1
  30. package/dist/lib/core/risk-collect.d.ts +19 -0
  31. package/dist/lib/core/risk-collect.js +173 -0
  32. package/dist/lib/drift-sentinel.d.ts +59 -0
  33. package/dist/lib/drift-sentinel.js +126 -0
  34. package/dist/lib/generators/memory-generator.js +8 -6
  35. package/dist/lib/generators/nest-generator.js +24 -10
  36. package/dist/lib/project-upgrade.js +1 -1
  37. package/dist/lib/workspace.d.ts +7 -0
  38. package/dist/lib/workspace.js +34 -5
  39. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  40. package/dist/packages/adapter-git/src/index.js +11 -6
  41. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  42. package/dist/packages/adapter-nest/src/index.js +26 -1
  43. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  44. package/dist/packages/adapter-sqlite/src/index.js +49 -0
  45. package/dist/packages/contracts/src/index.d.ts +33 -0
  46. package/dist/packages/contracts/src/index.js +13 -0
  47. package/dist/packages/core/src/index.d.ts +12 -0
  48. package/dist/packages/core/src/index.js +29 -0
  49. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  50. package/dist/packages/engineering/architecture/src/index.js +131 -0
  51. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  52. package/dist/packages/engineering/evidence/src/index.js +31 -0
  53. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  54. package/dist/packages/engineering/identity/src/index.js +88 -0
  55. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  56. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  57. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  58. package/dist/packages/engineering/provenance/src/index.js +21 -0
  59. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  60. package/dist/packages/engineering/risk/src/index.js +120 -0
  61. package/dist/packages/graph/src/index.d.ts +23 -1
  62. package/dist/packages/graph/src/index.js +88 -15
  63. package/dist/packages/llm/src/index.d.ts +43 -0
  64. package/dist/packages/llm/src/index.js +131 -0
  65. package/dist/packages/mcp/src/index.js +27 -8
  66. package/dist/packages/orchestration/src/index.d.ts +11 -1
  67. package/dist/packages/orchestration/src/index.js +34 -7
  68. package/dist/packages/policy/src/index.d.ts +40 -0
  69. package/dist/packages/policy/src/index.js +39 -4
  70. package/dist/packages/runtime/src/index.js +3 -0
  71. package/dist/packages/sandbox/src/index.d.ts +47 -0
  72. package/dist/packages/sandbox/src/index.js +59 -0
  73. package/dist/packages/validator/src/index.d.ts +8 -0
  74. package/dist/packages/validator/src/index.js +21 -6
  75. package/dist/scripts/adr.d.ts +17 -0
  76. package/dist/scripts/adr.js +152 -0
  77. package/dist/scripts/agent-harness.js +14 -4
  78. package/dist/scripts/agent.d.ts +27 -0
  79. package/dist/scripts/agent.js +249 -0
  80. package/dist/scripts/architecture.d.ts +16 -0
  81. package/dist/scripts/architecture.js +186 -0
  82. package/dist/scripts/cost-economy.d.ts +2 -0
  83. package/dist/scripts/cost-economy.js +79 -0
  84. package/dist/scripts/demo-autonomy.js +15 -8
  85. package/dist/scripts/demo-workspace.d.ts +6 -0
  86. package/dist/scripts/demo-workspace.js +101 -0
  87. package/dist/scripts/drift-check.d.ts +17 -0
  88. package/dist/scripts/drift-check.js +63 -0
  89. package/dist/scripts/engineer.d.ts +20 -0
  90. package/dist/scripts/engineer.js +208 -0
  91. package/dist/scripts/evidence.d.ts +12 -0
  92. package/dist/scripts/evidence.js +55 -0
  93. package/dist/scripts/gates.d.ts +6 -2
  94. package/dist/scripts/gates.js +14 -4
  95. package/dist/scripts/incident.d.ts +19 -0
  96. package/dist/scripts/incident.js +103 -0
  97. package/dist/scripts/llm-fit.js +160 -0
  98. package/dist/scripts/provenance.d.ts +14 -0
  99. package/dist/scripts/provenance.js +114 -0
  100. package/dist/scripts/risk.d.ts +15 -0
  101. package/dist/scripts/risk.js +81 -0
  102. package/dist/scripts/simulate.d.ts +20 -0
  103. package/dist/scripts/simulate.js +150 -0
  104. package/dist/scripts/sync-universal-memory.js +19 -6
  105. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  106. package/docs/llm-fit-loop.md +41 -0
  107. package/docs/modos-de-operacao.md +52 -0
  108. package/docs/produto/factsheet-marketing.md +151 -0
  109. package/docs/produto/roteiro-demo.md +47 -0
  110. package/memory/40-delivery/current-sprint.md +3 -6
  111. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  112. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  113. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  114. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  115. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  116. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  117. package/package.json +9 -2
  118. package/specs/agent-identity-reputation/plan.md +133 -0
  119. package/specs/agent-identity-reputation/spec.md +125 -0
  120. package/specs/agent-identity-reputation/tasks.md +51 -0
  121. package/specs/agent-runtime-monitoring/plan.md +78 -0
  122. package/specs/agent-runtime-monitoring/spec.md +92 -0
  123. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  124. package/specs/ai-code-provenance/plan.md +71 -0
  125. package/specs/ai-code-provenance/spec.md +97 -0
  126. package/specs/ai-code-provenance/tasks.md +39 -0
  127. package/specs/architecture-constitution/plan.md +110 -0
  128. package/specs/architecture-constitution/spec.md +114 -0
  129. package/specs/architecture-constitution/tasks.md +58 -0
  130. package/specs/change-risk-engine/plan.md +130 -0
  131. package/specs/change-risk-engine/spec.md +119 -0
  132. package/specs/change-risk-engine/tasks.md +72 -0
  133. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  134. package/specs/drift-sentinel/spec.md +117 -0
  135. package/specs/engineer-facade-extension/plan.md +71 -0
  136. package/specs/engineer-facade-extension/spec.md +98 -0
  137. package/specs/engineer-facade-extension/tasks.md +36 -0
  138. package/specs/engineering-evidence-ledger/plan.md +121 -0
  139. package/specs/engineering-evidence-ledger/spec.md +90 -0
  140. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  141. package/specs/engineering-graph-extensions/plan.md +92 -0
  142. package/specs/engineering-graph-extensions/spec.md +101 -0
  143. package/specs/engineering-graph-extensions/tasks.md +60 -0
  144. package/specs/engineering-intelligence/spec.md +177 -0
  145. package/specs/learning-loop-incidents/plan.md +59 -0
  146. package/specs/learning-loop-incidents/spec.md +93 -0
  147. package/specs/learning-loop-incidents/tasks.md +36 -0
  148. package/specs/predictive-change-simulation/plan.md +109 -0
  149. package/specs/predictive-change-simulation/spec.md +107 -0
  150. package/specs/predictive-change-simulation/tasks.md +41 -0
  151. package/specs/release-auditor-health/plan.md +88 -0
  152. package/specs/release-auditor-health/spec.md +82 -0
  153. package/specs/release-auditor-health/tasks.md +72 -0
  154. package/specs/smart-agent-routing/plan.md +55 -0
  155. package/specs/smart-agent-routing/spec.md +85 -0
  156. package/specs/smart-agent-routing/tasks.md +26 -0
  157. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  158. package/dist/scripts/server-persistence-probe.js +0 -52
  159. package/dist/scripts/server-persistence-probe.mjs +0 -52
  160. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -111,7 +111,6 @@ export async function runAutonomyDemo() {
111
111
  cache: new SqliteContextCache(database),
112
112
  }).build({ objective: 'corrigir teste falhando math.test.js', budget, includeContent: true, requireEvidence: false, correlationId });
113
113
  const approvals = new ApprovalLedger(new SqliteApprovalStore(database));
114
- let approved = false;
115
114
  const policy = new PolicyEngine({
116
115
  rules: [{ id: 'demo-code-write', priority: 100, effect: 'REQUIRE_APPROVAL', reason: 'Alteração de código exige aprovação humana', scope: { agentIds: [agent.id], capabilityIds: ['fixture.code.write'], environments: ['local'], categories: ['write'] } }],
117
116
  approvalLedger: approvals,
@@ -133,7 +132,7 @@ export async function runAutonomyDemo() {
133
132
  if (!source.includes('assert.equal(add(1, 1), 3)'))
134
133
  throw new Error('Expected failing assertion was not found');
135
134
  fs.writeFileSync(worktreeFile, source.replace('assert.equal(add(1, 1), 3)', 'assert.equal(add(1, 1), 2)'));
136
- const testExecution = await sandbox.execute(session.id, { executable: 'npm', args: ['test'], cwd: session.root });
135
+ const testExecution = await sandbox.execute(session.id, { executable: process.execPath, args: ['--test'], cwd: session.root });
137
136
  if (testExecution.exitCode !== 0)
138
137
  throw new Error(`Fixture tests failed after edit: ${testExecution.stderr || testExecution.stdout}`);
139
138
  const validation = await sandbox.validate(session.id);
@@ -152,14 +151,23 @@ export async function runAutonomyDemo() {
152
151
  persistence: new SqliteRuntimePersistence(database),
153
152
  memory: new GraphExecutionMemory(graph),
154
153
  validator: { validate: (run, results) => {
155
- const plan = createPlan(run.runId, testFile, [...new Set([...context.references.map((item) => item.id), ...results.flatMap((result) => result.evidence.map((item) => item.id))])]);
154
+ const allEvidenceIds = results.flatMap((result) => result.evidence.map((item) => item.id));
155
+ const plan = createPlan(run.runId, testFile, [...new Set([...context.references.map((item) => item.id), ...allEvidenceIds])]);
156
156
  const successfulResults = results.filter((result) => result.status === 'succeeded');
157
157
  const testEvidenceIds = successfulResults.flatMap((result) => result.evidence.map((item) => item.id));
158
158
  const testPassed = successfulResults.length > 0;
159
- return new DeterministicValidator().validate({ plan, changedFiles: run.changedFiles, checks: [{ name: 'build', passed: true, evidenceIds: [] }, { name: 'tests', passed: testPassed, evidenceIds: testEvidenceIds }, { name: 'diff', passed: true, evidenceIds: testEvidenceIds }, { name: 'typecheck', passed: true, evidenceIds: [] }, { name: 'lint', passed: true, evidenceIds: [] }], acceptance: [{ criterion: 'npm test passa na fixture', passed: testPassed, evidenceIds: testEvidenceIds }, { criterion: 'diff contém somente o teste falho', passed: run.changedFiles.length === 1 && run.changedFiles[0] === testFile, evidenceIds: [] }], correlationId: run.correlationId });
159
+ const scopeRespected = run.changedFiles.length === 1 && run.changedFiles[0] === testFile;
160
+ // This fixture has no build/lint/typecheck step, so it only claims what it actually ran
161
+ // (the sandboxed `npm test`) — DeterministicValidator now requires evidence behind every
162
+ // "passed" claim, so fabricating the other checks would just get them rejected.
163
+ return new DeterministicValidator().validate({ plan, changedFiles: run.changedFiles, requiredChecks: ['tests'], checks: [{ name: 'tests', passed: testPassed, evidenceIds: testEvidenceIds }], acceptance: [{ criterion: 'npm test passa na fixture', passed: testPassed, evidenceIds: testEvidenceIds }, { criterion: 'diff contém somente o teste falho', passed: scopeRespected, evidenceIds: scopeRespected ? allEvidenceIds : [] }], correlationId: run.correlationId });
160
164
  } },
161
165
  });
162
- const started = await runtime.start({ objective: 'Corrigir teste falhando na fixture externa', agent, budget, policy: { authorize: (request) => approved ? { effect: 'ALLOW', reason: 'Aprovação humana registrada', policyId: 'demo-approved' } : policy.authorize(request) }, correlationId });
166
+ // `policy` is passed through unwrapped: the runtime tags every step of this run with the same
167
+ // stable correlationId (its own runId), so PolicyEngine.authorize() can recognize, on resume,
168
+ // that a human already decided the pending approval for this exact run — rather than needing a
169
+ // hand-rolled bypass that (incorrectly) would have granted ALLOW to every future request too.
170
+ const started = await runtime.start({ objective: 'Corrigir teste falhando na fixture externa', agent, budget, policy, correlationId });
163
171
  const awaiting = await runtime.execute(started.runId);
164
172
  if (awaiting.state !== 'awaiting_approval')
165
173
  throw new Error(`Expected approval gate, got ${awaiting.state}`);
@@ -167,13 +175,12 @@ export async function runAutonomyDemo() {
167
175
  if (approval === undefined)
168
176
  throw new Error('Approval was not persisted');
169
177
  approvals.decide(approval.id, { decision: 'approved', approverId: 'human.demo', decidedAt: now() });
170
- approved = true;
171
- const completed = await runtime.resume(started.runId);
178
+ const completed = await runtime.resume(started.runId, policy);
172
179
  if (completed.state !== 'completed' || completed.validation?.status !== 'accepted')
173
180
  throw new Error(`Runtime did not complete with accepted validation: ${completed.state}/${completed.validation?.status}`);
174
181
  const diff = await sandbox.diff(session.id);
175
182
  const promoted = await sandbox.promote(session.id, diff);
176
- const promotedTests = mustCommand('npm', ['test'], fixtureRoot);
183
+ const promotedTests = mustCommand(process.execPath, ['--test'], fixtureRoot);
177
184
  await sandbox.destroy(session.id);
178
185
  const graphAfter = await new GraphIndexer(graph).sync(graphSource);
179
186
  const audit = new SqliteAuditStore(database);
@@ -0,0 +1,6 @@
1
+ export declare function createDemoWorkspace(args?: readonly string[]): Promise<{
2
+ readonly workspace: string;
3
+ readonly project: string;
4
+ readonly handoffs: number;
5
+ readonly observations: number;
6
+ }>;
@@ -0,0 +1,101 @@
1
+ /** Creates a clearly labeled, isolated workspace for product demonstrations. */
2
+ import fs from 'node:fs';
3
+ import os from 'node:os';
4
+ import path from 'node:path';
5
+ import Database from 'better-sqlite3';
6
+ import { randomUUID } from 'node:crypto';
7
+ import { initWorkspace, getWorkspaceContextDir, getWorkspaceDbPath, getWorkspaceRoot } from "../lib/workspace.js";
8
+ import { SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
9
+ import { ObservabilityRecorder } from "../packages/observability/src/index.js";
10
+ const PROJECT = 'atlas-pay';
11
+ const SENTINEL = 'forja-demo.json';
12
+ function usage() {
13
+ console.error('Uso: forja demo:workspace [--path <diretório>] [--json]');
14
+ process.exit(1);
15
+ }
16
+ function options(args) {
17
+ let root = path.join(os.homedir(), 'forja-demo-workspace');
18
+ let json = false;
19
+ for (let index = 0; index < args.length; index += 1) {
20
+ if (args[index] === '--json') {
21
+ json = true;
22
+ continue;
23
+ }
24
+ if (args[index] === '--path' && args[index + 1]) {
25
+ root = path.resolve(args[index + 1]);
26
+ index += 1;
27
+ continue;
28
+ }
29
+ usage();
30
+ }
31
+ return { root, json };
32
+ }
33
+ function write(file, content) {
34
+ fs.mkdirSync(path.dirname(file), { recursive: true });
35
+ fs.writeFileSync(file, content, 'utf8');
36
+ }
37
+ function createFiles(root) {
38
+ const project = path.join(root, 'projects', PROJECT);
39
+ write(path.join(project, 'README.md'), '# Atlas Pay (Demonstração)\n\nProjeto fictício criado por `forja demo:workspace`. Não use estes dados em produção.\n');
40
+ write(path.join(project, 'docs', 'project-brief.md'), '# Briefing: Atlas Pay\n\nDemonstração de uma camada de aprovação para pagamentos empresariais.\n');
41
+ write(path.join(project, 'memory', '20-architecture', 'stack.md'), '# Stack\n\n- API NestJS\n- SQLite local\n- Integração de pagamento simulada\n');
42
+ write(path.join(project, 'memory', '20-architecture', 'design-brief.md'), '# Design brief\n\nDashboard operacional para aprovar pagamentos e revisar evidências.\n');
43
+ write(path.join(project, 'memory', '40-delivery', 'current-sprint.md'), '# Sprint de demonstração\n\nObjetivo: aprovar pagamentos de alto valor com evidência e revisão.\n');
44
+ write(path.join(root, 'specs', PROJECT, 'spec.md'), '# Spec: atlas-pay\n\n- **Status**: approved\n\n## Problema\nPagamentos empresariais de alto valor precisam de aprovação explícita.\n\n## Critérios de aceite\n- [x] Aprovação registrada antes da promoção.\n- [x] Auditoria consulta os handoffs da entrega.\n');
45
+ write(path.join(root, 'specs', PROJECT, 'plan.md'), '# Plan: atlas-pay\n\n- **Status**: approved\n\nImplementar política de aprovação e trilha de auditoria.\n');
46
+ write(path.join(root, 'specs', PROJECT, 'tasks.md'), '# Tasks: atlas-pay\n\n- **Status**: done\n\n- [x] Criar política de aprovação.\n- [x] Validar evidência antes de concluir.\n');
47
+ write(path.join(getWorkspaceContextDir(), `gsd-${PROJECT}.md`), '# GSD: atlas-pay\n\nCenário de demonstração, gerado localmente.\n');
48
+ write(path.join(getWorkspaceContextDir(), 'sprint-pack.md'), '# Contexto de demonstração\n\nAtlas Pay: aprovação de pagamento antes da promoção.\n');
49
+ write(path.join(getWorkspaceContextDir(), 'llm-profiles.json'), `${JSON.stringify({ version: 1, profiles: {
50
+ 'demo-ollama': { provider: 'ollama', model: 'qwen2.5-coder', command: 'ollama', roles: ['worker'], taskTypes: ['implementation'], privacy: 'local', enabled: false },
51
+ } }, null, 2)}\n`);
52
+ }
53
+ async function createDatabase() {
54
+ const db = new Database(getWorkspaceDbPath());
55
+ try {
56
+ new SqliteMigrationRunner(db).apply();
57
+ db.exec(`CREATE TABLE IF NOT EXISTS handoffs (
58
+ id INTEGER PRIMARY KEY AUTOINCREMENT, created_at TEXT NOT NULL, from_agent TEXT NOT NULL,
59
+ to_agent TEXT NOT NULL, intent TEXT NOT NULL, context TEXT NOT NULL, acceptance TEXT NOT NULL,
60
+ constraints TEXT NOT NULL, return_to TEXT NOT NULL, spec_slug TEXT, status TEXT DEFAULT 'open', payload_json TEXT
61
+ );`);
62
+ db.prepare('DELETE FROM handoffs WHERE spec_slug = ?').run(PROJECT);
63
+ const insert = db.prepare('INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, status, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)');
64
+ const now = new Date().toISOString();
65
+ const rows = [
66
+ ['product', 'sdd-architect', 'plan', 'specs/atlas-pay/spec.md aprovado', 'plan.md com política e riscos', 'cenário demo; nenhuma integração externa', 'orchestrator', 'done'],
67
+ ['sdd-architect', 'worker', 'implement', 'specs/atlas-pay/plan.md', 'política e validação implementadas', 'cenário demo; dados sintéticos', 'governance', 'done'],
68
+ ['worker', 'governance', 'review', 'diff e checks do cenário Atlas Pay', 'validação independente aprovada', 'cenário demo; não promover para produção', 'orchestrator', 'open'],
69
+ ];
70
+ for (const [from, to, intent, context, acceptance, constraints, returnTo, status] of rows) {
71
+ const payload = { from, to, intent, context, acceptance, constraints, return: returnTo, spec_slug: PROJECT, demo: true };
72
+ insert.run(now, from, to, intent, context, acceptance, constraints, returnTo, PROJECT, status, JSON.stringify(payload));
73
+ }
74
+ const recorder = new ObservabilityRecorder(new SqliteObservationStore(db));
75
+ for (const [outcome, durationMs, inputTokens, outputTokens] of [['succeeded', 1250, 820, 210], ['succeeded', 980, 740, 180], ['blocked', 110, 120, 0]]) {
76
+ await recorder.record({ traceId: `demo:${randomUUID()}`, model: 'demo:local', inputHash: randomUUID(), contextRefs: ['.context/sprint-pack.md'], inputTokens, outputTokens, durationMs, tools: ['demo'], commands: ['forja demo:workspace'], outcome });
77
+ }
78
+ }
79
+ finally {
80
+ db.close();
81
+ }
82
+ }
83
+ export async function createDemoWorkspace(args = process.argv.slice(2)) {
84
+ const { root, json } = options(args);
85
+ process.env.FORJA_WORKSPACE = root;
86
+ const sentinel = path.join(root, '.context', SENTINEL);
87
+ if (fs.existsSync(root) && !fs.existsSync(sentinel))
88
+ throw new Error(`Recusado: ${root} não é um workspace demo. Escolha --path para um diretório vazio.`);
89
+ initWorkspace();
90
+ createFiles(getWorkspaceRoot());
91
+ await createDatabase();
92
+ const result = { workspace: getWorkspaceRoot(), project: PROJECT, handoffs: 3, observations: 3 };
93
+ write(sentinel, `${JSON.stringify({ ...result, generatedAt: new Date().toISOString(), warning: 'Dados sintéticos para demonstração. Não use em produção.' }, null, 2)}\n`);
94
+ if (json)
95
+ console.log(JSON.stringify(result));
96
+ else
97
+ console.log(`Demo pronta em ${result.workspace}\nProjeto: ${PROJECT}\nHandoffs: 3 (2 concluídos, 1 em review)\nPróximo: FORJA_WORKSPACE="${result.workspace}" npm --prefix dashboard start`);
98
+ return result;
99
+ }
100
+ if (process.argv[1]?.endsWith('demo-workspace.ts'))
101
+ createDemoWorkspace().catch((error) => { console.error(error instanceof Error ? error.message : String(error)); process.exitCode = 1; });
@@ -0,0 +1,17 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * drift:check — "verified" continua verdade? (SPEC-030)
4
+ *
5
+ * forja drift:check reindexa o workspace e reporta drift estrutural
6
+ * forja drift:check --domain <d> restringe aos documentos cujo path passa por /<d>/
7
+ *
8
+ * Reindexa via o mesmo mecanismo de `graph:sync` (checksum de fonte + extração determinística) e,
9
+ * para cada documento cujo conteúdo mudou, compara as relações `verified` que ele produzia antes
10
+ * com as que produz agora. Uma relação que sumiu vira `stale` (validTo carimbado, sem inventar
11
+ * status novo — GraphLoop já suporta validade temporal). Determinístico, sem LLM, sem rede: é
12
+ * extração + diff, igual ao extrator que já indexa o grafo (AC-4).
13
+ *
14
+ * Não corrige nada sozinho — só sinaliza. Decidir se o código ou a ADR/spec está desatualizada é
15
+ * julgamento humano ou de agente (SPEC-030 §5, fora de escopo deste comando).
16
+ */
17
+ export {};
@@ -0,0 +1,63 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * drift:check — "verified" continua verdade? (SPEC-030)
4
+ *
5
+ * forja drift:check reindexa o workspace e reporta drift estrutural
6
+ * forja drift:check --domain <d> restringe aos documentos cujo path passa por /<d>/
7
+ *
8
+ * Reindexa via o mesmo mecanismo de `graph:sync` (checksum de fonte + extração determinística) e,
9
+ * para cada documento cujo conteúdo mudou, compara as relações `verified` que ele produzia antes
10
+ * com as que produz agora. Uma relação que sumiu vira `stale` (validTo carimbado, sem inventar
11
+ * status novo — GraphLoop já suporta validade temporal). Determinístico, sem LLM, sem rede: é
12
+ * extração + diff, igual ao extrator que já indexa o grafo (AC-4).
13
+ *
14
+ * Não corrige nada sozinho — só sinaliza. Decidir se o código ou a ADR/spec está desatualizada é
15
+ * julgamento humano ou de agente (SPEC-030 §5, fora de escopo deste comando).
16
+ */
17
+ import fs from 'node:fs';
18
+ import Database from 'better-sqlite3';
19
+ import { checkDrift } from "../lib/drift-sentinel.js";
20
+ import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
21
+ import { GraphLoop } from "../packages/graph/src/index.js";
22
+ import { SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
23
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
24
+ function arg(name) {
25
+ const i = process.argv.indexOf(name);
26
+ return i >= 0 ? process.argv[i + 1] ?? null : null;
27
+ }
28
+ function printReport(report, domain) {
29
+ console.log(`\nForja drift:check${domain ? ` --domain ${domain}` : ''} — o verified continua verdade?\n`);
30
+ console.log(`${report.documents} documento(s) verificado(s), ${report.unchanged} sem mudança, ${report.drifted} com drift detectado.\n`);
31
+ if (report.details.length === 0) {
32
+ console.log(report.changed > 0
33
+ ? `✓ ${report.changed} documento(s) mudaram, mas toda relação verified anterior continua reproduzível.`
34
+ : '✓ nenhum documento mudou desde a última indexação.');
35
+ return;
36
+ }
37
+ for (const drift of report.details) {
38
+ console.log(`✗ ${drift.sourceKey} — ${drift.stale.length} relação(ões) ficaram stale:`);
39
+ for (const relation of drift.stale)
40
+ console.log(` ${relation.type}: ${relation.from} → ${relation.to} — verified antes, não reproduzida pela extração atual`);
41
+ }
42
+ console.log(`\n${report.drifted} documento(s) com drift. As arestas acima ganharam validTo — somem de query()/path()/impact() por padrão, mas continuam auditáveis com o parâmetro --at de quem consultar o grafo.`);
43
+ console.log('drift:check só sinaliza — corrigir a ADR/spec desatualizada ou reverter o código é decisão humana/de agente, não deste comando.');
44
+ }
45
+ async function main() {
46
+ const domain = arg('--domain');
47
+ const graphRoot = process.env.FORJA_GRAPH_ROOT ?? process.cwd();
48
+ fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
49
+ const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
50
+ new SqliteMigrationRunner(database).apply();
51
+ const store = new SqliteGraphStore(database);
52
+ const graph = new GraphLoop(store);
53
+ const source = new GitGraphDocumentSource(graphRoot, new SpawnCommandRunner());
54
+ const report = await checkDrift(graph, store, source, domain === null ? {} : { domain });
55
+ database.close();
56
+ printReport(report, domain);
57
+ if (report.drifted > 0)
58
+ process.exit(1);
59
+ }
60
+ main().catch((error) => {
61
+ console.error(`\ndrift:check falhou: ${error instanceof Error ? error.message : String(error)}`);
62
+ process.exit(1);
63
+ });
@@ -0,0 +1,20 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * engineer (SPEC-035, estendida por SPEC-042) — façade que compõe o que os Sprints 1-9 já
4
+ * construíram.
5
+ *
6
+ * forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
7
+ *
8
+ * Ordem de composição (specs/engineering-evidence-ledger/plan.md, +SPEC-042):
9
+ * ContextEngine.build() → GraphLoop.contextRecords() filtrado a ADR/SPEC (SPEC-032) →
10
+ * architecture:check não escopado (SPEC-033) → RiskEngine.assess() só com --ref (SPEC-034,
11
+ * D1: sem diff ainda, não há arquivo pra escopar) → agentes recomendados só com --role
12
+ * (recommendAgent, SPEC-037) → incidentes parecidos (rankIncidentsByQuery, SPEC-041) → fluxo
13
+ * recomendado, parseado da tabela "Etapa → papel → comando" de docs/fluxo.md (D2 — uma fonte de
14
+ * verdade, não copiada aqui).
15
+ *
16
+ * Nenhuma lógica de negócio nova (AC-4/AC-3 de SPEC-035, reafirmado em AC-3 de SPEC-042): cada
17
+ * seção é exatamente o que o subsistema já produziu. Sem síntese de texto livre (AC-3) — não há
18
+ * chamada de LLM em nenhum ponto deste arquivo.
19
+ */
20
+ export {};
@@ -0,0 +1,208 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * engineer (SPEC-035, estendida por SPEC-042) — façade que compõe o que os Sprints 1-9 já
4
+ * construíram.
5
+ *
6
+ * forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
7
+ *
8
+ * Ordem de composição (specs/engineering-evidence-ledger/plan.md, +SPEC-042):
9
+ * ContextEngine.build() → GraphLoop.contextRecords() filtrado a ADR/SPEC (SPEC-032) →
10
+ * architecture:check não escopado (SPEC-033) → RiskEngine.assess() só com --ref (SPEC-034,
11
+ * D1: sem diff ainda, não há arquivo pra escopar) → agentes recomendados só com --role
12
+ * (recommendAgent, SPEC-037) → incidentes parecidos (rankIncidentsByQuery, SPEC-041) → fluxo
13
+ * recomendado, parseado da tabela "Etapa → papel → comando" de docs/fluxo.md (D2 — uma fonte de
14
+ * verdade, não copiada aqui).
15
+ *
16
+ * Nenhuma lógica de negócio nova (AC-4/AC-3 de SPEC-035, reafirmado em AC-3 de SPEC-042): cada
17
+ * seção é exatamente o que o subsistema já produziu. Sem síntese de texto livre (AC-3) — não há
18
+ * chamada de LLM em nenhum ponto deste arquivo.
19
+ */
20
+ import fs from 'node:fs';
21
+ import path from 'node:path';
22
+ import { randomUUID } from 'node:crypto';
23
+ import Database from 'better-sqlite3';
24
+ import { ContextEngine, GraphContextSource } from "../packages/context/src/index.js";
25
+ import { checkConstitution } from "../packages/engineering/architecture/src/index.js";
26
+ import { assessRisk } from "../packages/engineering/risk/src/index.js";
27
+ import { recommendAgent } from "../packages/engineering/identity/src/index.js";
28
+ import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
29
+ import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
30
+ import { SqliteAgentProfileStore, SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
31
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
32
+ import { buildRiskInput, changedFiles, graphRoot } from "../lib/core/risk-collect.js";
33
+ import { incidentRecords, rankIncidentsByQuery, titleOf } from "../lib/core/incident-search.js";
34
+ const CONSTITUTION_PATH = '.context/architecture/constitution.json';
35
+ const FLUXO_PATH = 'docs/fluxo.md';
36
+ /** Parseia a tabela "Etapa → papel → comando → capacidade" de docs/fluxo.md — D2 do plan: uma fonte de verdade, não copiada aqui. */
37
+ function recommendedFlow() {
38
+ const file = path.join(graphRoot(), FLUXO_PATH);
39
+ if (!fs.existsSync(file))
40
+ return [];
41
+ const rowPattern = /^\|\s*(\d+)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|$/gm;
42
+ const steps = [];
43
+ for (const match of fs.readFileSync(file, 'utf8').matchAll(rowPattern)) {
44
+ steps.push({ numero: match[1], etapa: match[2], papel: match[3], comandos: match[4], capacidade: match[5] });
45
+ }
46
+ return steps;
47
+ }
48
+ function relevantAdrs(graph, objective) {
49
+ return graph.contextRecords(objective)
50
+ .filter((record) => /\bADR-\d{4}\b|\bSPEC-\d{3,4}\b/.test(record.content))
51
+ .slice(0, 10)
52
+ .map((record) => ({ content: record.content, relevance: record.relevance }));
53
+ }
54
+ async function buildReport(objective, ref, role) {
55
+ fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
56
+ const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
57
+ new SqliteMigrationRunner(database).apply();
58
+ try {
59
+ const store = new SqliteGraphStore(database);
60
+ const graph = new GraphLoop(store);
61
+ await new GraphIndexer(graph).sync(new GitGraphDocumentSource(graphRoot(), new SpawnCommandRunner()));
62
+ const context = await new ContextEngine({
63
+ graph: new GraphContextSource({ searchContext: (o) => graph.contextRecords(o) }),
64
+ // maxItems: 10 — sem isto, um objetivo genérico contra um repositório grande devolve
65
+ // centenas/milhares de candidatos (achado real: "compilar a architecture constitution deste
66
+ // repositório" contra este próprio repositório trouxe 1013). `forja engineer` é pra orientar
67
+ // o início do trabalho, não substituir `context:smart`/`code:query` — os 10 mais relevantes
68
+ // (já ordenados por `ContextEngine.build`) bastam pro humano decidir se e como prosseguir
69
+ // (AC-3/métrica §8); a lista completa continua disponível via os comandos focados.
70
+ }).build({ objective, budget: { inputTokens: 20000, outputTokens: 0, totalTokens: 20000, usedTokens: 0 }, includeContent: true, requireEvidence: false, maxItems: 10 });
71
+ const constitutionFile = path.join(graphRoot(), CONSTITUTION_PATH);
72
+ let architectureCheck;
73
+ if (fs.existsSync(constitutionFile)) {
74
+ const { rules } = JSON.parse(fs.readFileSync(constitutionFile, 'utf8'));
75
+ const edges = store.listEdges().flatMap((edge) => {
76
+ if (edge.type !== 'DEPENDS_ON')
77
+ return [];
78
+ const fromNode = store.getNode(edge.from);
79
+ const toNode = store.getNode(edge.to);
80
+ return fromNode === undefined || toNode === undefined ? [] : [{ fromPath: fromNode.label, targetLabel: toNode.label }];
81
+ });
82
+ architectureCheck = checkConstitution(rules, edges);
83
+ }
84
+ else {
85
+ architectureCheck = { note: 'Constitution não compilada ainda — rode `forja architecture:compile`.' };
86
+ }
87
+ let risk;
88
+ if (ref !== undefined) {
89
+ const paths = changedFiles(ref);
90
+ if (paths.length > 0) {
91
+ const input = await buildRiskInput(paths, database);
92
+ risk = assessRisk(input, { id: randomUUID(), changeId: ref, now: new Date().toISOString() });
93
+ }
94
+ }
95
+ // Só com --role: nunca inventa um papel que o usuário não informou (AC-1 de SPEC-042).
96
+ const recommendedAgents = role === undefined ? undefined : recommendAgent(new SqliteAgentProfileStore(database).list(), { role });
97
+ // Sempre presente (mesmo vazio) — incidentes parecidos com o objetivo, mesma busca por
98
+ // palavra-chave de `incident:similar` (AC-2 de SPEC-042).
99
+ const similarIncidents = rankIncidentsByQuery(incidentRecords(store), objective)
100
+ .slice(0, 5)
101
+ .map((item) => ({ id: item.record.id, title: titleOf(item.record), relevance: item.relevance }));
102
+ return {
103
+ objective,
104
+ ...(ref === undefined ? {} : { ref }),
105
+ ...(role === undefined ? {} : { role }),
106
+ context: { references: context.references.length, content: context.content },
107
+ relevantAdrs: relevantAdrs(graph, objective),
108
+ architectureCheck,
109
+ ...(risk === undefined ? {} : { risk }),
110
+ ...(recommendedAgents === undefined ? {} : { recommendedAgents }),
111
+ similarIncidents,
112
+ recommendedFlow: recommendedFlow(),
113
+ };
114
+ }
115
+ finally {
116
+ database.close();
117
+ }
118
+ }
119
+ function printText(report) {
120
+ console.log(`objetivo: ${report.objective}`);
121
+ if (report.ref !== undefined)
122
+ console.log(`ref: ${report.ref}`);
123
+ console.log('');
124
+ console.log(`CONTEXTO (${report.context.references} referência(s) do grafo)`);
125
+ if (report.context.content.length === 0)
126
+ console.log(' (nenhuma referência encontrada — objetivo novo, sem histórico ainda)');
127
+ for (const line of report.context.content)
128
+ console.log(` ${line}`);
129
+ console.log('');
130
+ console.log(`ADRs/SPECs RELEVANTES (${report.relevantAdrs.length})`);
131
+ if (report.relevantAdrs.length === 0)
132
+ console.log(' (nenhuma)');
133
+ for (const adr of report.relevantAdrs)
134
+ console.log(` [${adr.relevance.toFixed(2)}] ${adr.content}`);
135
+ console.log('');
136
+ console.log('ARCHITECTURE CHECK');
137
+ if ('note' in report.architectureCheck) {
138
+ console.log(` ${report.architectureCheck.note}`);
139
+ }
140
+ else {
141
+ console.log(` ${report.architectureCheck.compliant} regra(s) active em conformidade, ${report.architectureCheck.violations.length} violação(ões)`);
142
+ for (const violation of report.architectureCheck.violations)
143
+ console.log(` ${violation.severity.toUpperCase()} ${violation.file} viola ${violation.ruleId}`);
144
+ }
145
+ console.log('');
146
+ console.log('RISCO');
147
+ if (report.risk === undefined) {
148
+ console.log(' sem --ref — nenhuma mudança ainda para avaliar (rode com --ref <commit> quando houver um).');
149
+ }
150
+ else {
151
+ console.log(` score ${report.risk.score}/100 → ${report.risk.autonomyBand} (confidence ${(report.risk.confidence * 100).toFixed(0)}%)`);
152
+ }
153
+ console.log('');
154
+ if (report.recommendedAgents !== undefined) {
155
+ console.log(`AGENTES RECOMENDADOS (role: ${report.role})`);
156
+ if (report.recommendedAgents.length === 0)
157
+ console.log(' (nenhum agente registrado — rode forja agent:register primeiro)');
158
+ for (const item of report.recommendedAgents)
159
+ console.log(` ${item.agentId} score:${item.score} ${item.reasons.join(', ')}`);
160
+ console.log('');
161
+ }
162
+ console.log(`INCIDENTES PARECIDOS (${report.similarIncidents.length})`);
163
+ if (report.similarIncidents.length === 0)
164
+ console.log(' (nenhum)');
165
+ for (const item of report.similarIncidents)
166
+ console.log(` [${item.relevance.toFixed(2)}] ${item.id} ${item.title}`);
167
+ console.log('');
168
+ console.log('FLUXO RECOMENDADO (docs/fluxo.md)');
169
+ for (const step of report.recommendedFlow)
170
+ console.log(` ${step.numero}. ${step.etapa} (${step.papel}) — ${step.comandos}`);
171
+ }
172
+ async function cmdEngineer(args) {
173
+ const json = args.includes('--json');
174
+ const refIndex = args.indexOf('--ref');
175
+ const roleIndex = args.indexOf('--role');
176
+ const ref = refIndex === -1 ? undefined : args[refIndex + 1];
177
+ const role = roleIndex === -1 ? undefined : args[roleIndex + 1];
178
+ // Cada índice só entra em `consumed` quando a flag correspondente foi de fato encontrada — achado
179
+ // real da primeira versão deste arquivo: computar `refIndex + 1` incondicionalmente, mesmo com
180
+ // `refIndex === -1` (valendo 0), engolia o próprio objetivo quando nenhuma flag era passada.
181
+ const consumed = new Set();
182
+ if (refIndex !== -1) {
183
+ consumed.add(refIndex);
184
+ consumed.add(refIndex + 1);
185
+ }
186
+ if (roleIndex !== -1) {
187
+ consumed.add(roleIndex);
188
+ consumed.add(roleIndex + 1);
189
+ }
190
+ const objective = args.find((arg, index) => arg !== '--json' && !consumed.has(index));
191
+ if (!objective) {
192
+ console.error('Uso: forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]');
193
+ process.exitCode = 1;
194
+ return;
195
+ }
196
+ const report = await buildReport(objective, ref, role);
197
+ if (json)
198
+ console.log(JSON.stringify(report, null, 2));
199
+ else
200
+ printText(report);
201
+ }
202
+ async function main() {
203
+ await cmdEngineer(process.argv.slice(2));
204
+ }
205
+ main().catch((error) => {
206
+ console.error(`\nengineer: falhou: ${error instanceof Error ? error.message : String(error)}`);
207
+ process.exitCode = 1;
208
+ });
@@ -0,0 +1,12 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * evidence:show (SPEC-035)
4
+ *
5
+ * forja evidence:show <run-id> view agregada de evidência de um run: intent, agente, testes,
6
+ * aprovações, arquivos alterados — tudo já persistido
7
+ *
8
+ * `packages/engineering/evidence` faz o mapeamento puro; este script busca o `RuntimeRun` real
9
+ * (`SqliteRuntimeRunStore`), os `AuditRecord`s cujo `aggregateId` é o run (`SqliteAuditStore`) e as
10
+ * `ApprovalRequest`s cujo `correlationId` é o run (`ApprovalLedger`) — nenhuma tabela nova.
11
+ */
12
+ export {};
@@ -0,0 +1,55 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * evidence:show (SPEC-035)
4
+ *
5
+ * forja evidence:show <run-id> view agregada de evidência de um run: intent, agente, testes,
6
+ * aprovações, arquivos alterados — tudo já persistido
7
+ *
8
+ * `packages/engineering/evidence` faz o mapeamento puro; este script busca o `RuntimeRun` real
9
+ * (`SqliteRuntimeRunStore`), os `AuditRecord`s cujo `aggregateId` é o run (`SqliteAuditStore`) e as
10
+ * `ApprovalRequest`s cujo `correlationId` é o run (`ApprovalLedger`) — nenhuma tabela nova.
11
+ */
12
+ import fs from 'node:fs';
13
+ import Database from 'better-sqlite3';
14
+ import { buildEvidenceLedger } from "../packages/engineering/evidence/src/index.js";
15
+ import { ApprovalLedger } from "../packages/policy/src/index.js";
16
+ import { SqliteApprovalStore, SqliteAuditStore, SqliteMigrationRunner, SqliteRuntimeRunStore } from "../packages/adapter-sqlite/src/index.js";
17
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
18
+ function cmdShow([runId]) {
19
+ if (!runId) {
20
+ console.error('Uso: forja evidence:show <run-id>');
21
+ process.exitCode = 1;
22
+ return;
23
+ }
24
+ fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
25
+ const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
26
+ new SqliteMigrationRunner(database).apply();
27
+ try {
28
+ const run = new SqliteRuntimeRunStore(database).get(runId);
29
+ if (run === undefined) {
30
+ console.error(`Run não encontrado: ${runId}.`);
31
+ process.exitCode = 1;
32
+ return;
33
+ }
34
+ const auditRecords = new SqliteAuditStore(database).list().filter((record) => record.aggregateId === runId);
35
+ const approvals = new ApprovalLedger(new SqliteApprovalStore(database)).list().filter((request) => request.correlationId === runId);
36
+ const record = buildEvidenceLedger({ run, auditRecords, approvals });
37
+ console.log(JSON.stringify(record, null, 2));
38
+ }
39
+ finally {
40
+ database.close();
41
+ }
42
+ }
43
+ async function main() {
44
+ const [subcommand, ...rest] = process.argv.slice(2);
45
+ switch (subcommand) {
46
+ case 'show': return cmdShow(rest);
47
+ default:
48
+ console.error('Uso: forja evidence:show <run-id>');
49
+ process.exitCode = 1;
50
+ }
51
+ }
52
+ main().catch((error) => {
53
+ console.error(`\nevidence: falhou: ${error instanceof Error ? error.message : String(error)}`);
54
+ process.exitCode = 1;
55
+ });
@@ -2,8 +2,12 @@
2
2
  /**
3
3
  * check:all — a bateria inteira de gates do framework, um veredito (SPEC-020).
4
4
  *
5
- * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
- * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
5
+ * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
+ * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
7
+ * forja check:all --with-drift + drift:check (SPEC-030) — opt-in, não roda por padrão (custo de
8
+ * reindexar o workspace inteiro não foi medido em repos grandes)
9
+ * forja check:all --with-architecture + architecture:check (SPEC-033) — mesmo custo de reindexar,
10
+ * mesmo motivo pra ser opt-in
7
11
  *
8
12
  * Não substitui os gates focados — os agrega. "A casa está coerente?" num comando só.
9
13
  */
@@ -2,8 +2,12 @@
2
2
  /**
3
3
  * check:all — a bateria inteira de gates do framework, um veredito (SPEC-020).
4
4
  *
5
- * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
- * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
5
+ * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
+ * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
7
+ * forja check:all --with-drift + drift:check (SPEC-030) — opt-in, não roda por padrão (custo de
8
+ * reindexar o workspace inteiro não foi medido em repos grandes)
9
+ * forja check:all --with-architecture + architecture:check (SPEC-033) — mesmo custo de reindexar,
10
+ * mesmo motivo pra ser opt-in
7
11
  *
8
12
  * Não substitui os gates focados — os agrega. "A casa está coerente?" num comando só.
9
13
  */
@@ -11,10 +15,16 @@ import { runGates, overallStatus } from "../lib/core/gates.js";
11
15
  const TAG = { ok: 'OK ', warn: 'AVISO', fail: 'FALHA', skipped: '— ' };
12
16
  async function main() {
13
17
  const full = process.argv.includes('--full');
14
- console.log(`\nForja check:all${full ? ' (--full)' : ''} — a bateria inteira, um veredito\n`);
18
+ const withDrift = process.argv.includes('--with-drift');
19
+ const withArchitecture = process.argv.includes('--with-architecture');
20
+ console.log(`\nForja check:all${full ? ' (--full)' : ''}${withDrift ? ' (--with-drift)' : ''}${withArchitecture ? ' (--with-architecture)' : ''} — a bateria inteira, um veredito\n`);
15
21
  if (full)
16
22
  console.log('Inclui os gates caros (empacota o tarball, builda o backend gerado) — leva minutos.\n');
17
- const groups = await runGates({ full });
23
+ if (withDrift)
24
+ console.log('Inclui drift:check (SPEC-030) — reindexa o workspace inteiro por extração determinística.\n');
25
+ if (withArchitecture)
26
+ console.log('Inclui architecture:check (SPEC-033) — mesmo custo de reindexação de drift:check.\n');
27
+ const groups = await runGates({ full, withDrift, withArchitecture });
18
28
  for (const g of groups) {
19
29
  console.log(`▚ ${g.name}`);
20
30
  for (const r of g.results) {
@@ -0,0 +1,19 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * incident:record / :list / :similar (SPEC-041)
4
+ *
5
+ * forja incident:record --title <t> [--description <d>] grava um incidente no Engineering Graph
6
+ * forja incident:list incidentes registrados, mais recentes primeiro
7
+ * forja incident:similar "<busca>" sugere incidentes parecidos por palavra-chave
8
+ *
9
+ * `GraphNode.type` já é vocabulário livre (`packages/graph`, já existente) — nenhum contrato novo,
10
+ * só um adapter que grava/consulta o tipo `Incident` via `GraphLoop.upsertNode`/`addEvidence`, no
11
+ * mesmo `SqliteGraphStore` compartilhado já usado por `adr:*`/`architecture:*`. Sem reindexação de
12
+ * documentos aqui — incidentes não vêm de arquivo, são escritos diretamente.
13
+ *
14
+ * `incident:similar` é sugestão por palavra-chave — determinístico, nunca aplica nada sozinho
15
+ * (AC-4). Matching local (D1 do plan): nós `Incident` desta versão não têm aresta nenhuma, então
16
+ * `GraphLoop.contextRecords` (que casa contra arestas) não encontraria nada — o estilo de scoring é
17
+ * o mesmo (sobreposição de termos), só a fonte é o nó, não a aresta.
18
+ */
19
+ export {};