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
@@ -32,6 +32,7 @@ export declare const DOMAINS: {
32
32
  code: string;
33
33
  memoria: string;
34
34
  contexto: string;
35
+ llm: string;
35
36
  governanca: string;
36
37
  geracao: string;
37
38
  };
@@ -186,6 +187,194 @@ export declare const COMMANDS: {
186
187
  capability: string;
187
188
  gates: string[];
188
189
  };
190
+ 'drift:check': {
191
+ domain: string;
192
+ desc: string;
193
+ node: string;
194
+ gates: string[];
195
+ };
196
+ 'adr:list': {
197
+ domain: string;
198
+ desc: string;
199
+ node: string;
200
+ args: string[];
201
+ gates: string[];
202
+ };
203
+ 'adr:show': {
204
+ domain: string;
205
+ desc: string;
206
+ node: string;
207
+ args: string[];
208
+ gates: string[];
209
+ };
210
+ 'adr:impact': {
211
+ domain: string;
212
+ desc: string;
213
+ node: string;
214
+ args: string[];
215
+ gates: string[];
216
+ };
217
+ 'adr:graph': {
218
+ domain: string;
219
+ desc: string;
220
+ node: string;
221
+ args: string[];
222
+ gates: string[];
223
+ };
224
+ 'architecture:compile': {
225
+ domain: string;
226
+ desc: string;
227
+ node: string;
228
+ args: string[];
229
+ };
230
+ 'architecture:check': {
231
+ domain: string;
232
+ desc: string;
233
+ node: string;
234
+ args: string[];
235
+ gates: string[];
236
+ };
237
+ 'architecture:status': {
238
+ domain: string;
239
+ desc: string;
240
+ node: string;
241
+ args: string[];
242
+ };
243
+ 'architecture:explain': {
244
+ domain: string;
245
+ desc: string;
246
+ node: string;
247
+ args: string[];
248
+ };
249
+ 'architecture:approve': {
250
+ domain: string;
251
+ desc: string;
252
+ node: string;
253
+ args: string[];
254
+ };
255
+ 'risk:assess': {
256
+ domain: string;
257
+ desc: string;
258
+ node: string;
259
+ args: string[];
260
+ gates: string[];
261
+ };
262
+ 'risk:explain': {
263
+ domain: string;
264
+ desc: string;
265
+ node: string;
266
+ args: string[];
267
+ };
268
+ 'evidence:show': {
269
+ domain: string;
270
+ desc: string;
271
+ node: string;
272
+ args: string[];
273
+ gates: string[];
274
+ };
275
+ engineer: {
276
+ domain: string;
277
+ desc: string;
278
+ node: string;
279
+ gates: string[];
280
+ };
281
+ 'agent:register': {
282
+ domain: string;
283
+ desc: string;
284
+ node: string;
285
+ args: string[];
286
+ gates: string[];
287
+ };
288
+ 'agent:list': {
289
+ domain: string;
290
+ desc: string;
291
+ node: string;
292
+ args: string[];
293
+ gates: string[];
294
+ };
295
+ 'agent:show': {
296
+ domain: string;
297
+ desc: string;
298
+ node: string;
299
+ args: string[];
300
+ gates: string[];
301
+ };
302
+ 'agent:score': {
303
+ domain: string;
304
+ desc: string;
305
+ node: string;
306
+ args: string[];
307
+ gates: string[];
308
+ };
309
+ 'agent:history': {
310
+ domain: string;
311
+ desc: string;
312
+ node: string;
313
+ args: string[];
314
+ gates: string[];
315
+ };
316
+ 'agent:recommend': {
317
+ domain: string;
318
+ desc: string;
319
+ node: string;
320
+ args: string[];
321
+ gates: string[];
322
+ };
323
+ 'agent:monitor': {
324
+ domain: string;
325
+ desc: string;
326
+ node: string;
327
+ args: string[];
328
+ gates: string[];
329
+ };
330
+ 'incident:record': {
331
+ domain: string;
332
+ desc: string;
333
+ node: string;
334
+ args: string[];
335
+ gates: string[];
336
+ };
337
+ 'incident:list': {
338
+ domain: string;
339
+ desc: string;
340
+ node: string;
341
+ args: string[];
342
+ gates: string[];
343
+ };
344
+ 'incident:similar': {
345
+ domain: string;
346
+ desc: string;
347
+ node: string;
348
+ args: string[];
349
+ gates: string[];
350
+ };
351
+ simulate: {
352
+ domain: string;
353
+ desc: string;
354
+ node: string;
355
+ gates: string[];
356
+ };
357
+ 'provenance:record': {
358
+ domain: string;
359
+ desc: string;
360
+ node: string;
361
+ args: string[];
362
+ gates: string[];
363
+ };
364
+ blame: {
365
+ domain: string;
366
+ desc: string;
367
+ node: string;
368
+ args: string[];
369
+ gates: string[];
370
+ };
371
+ sbom: {
372
+ domain: string;
373
+ desc: string;
374
+ node: string;
375
+ args: string[];
376
+ gates: string[];
377
+ };
189
378
  'code:context': {
190
379
  domain: string;
191
380
  desc: string;
@@ -303,6 +492,60 @@ export declare const COMMANDS: {
303
492
  desc: string;
304
493
  node: string;
305
494
  };
495
+ 'spec:set-status': {
496
+ domain: string;
497
+ desc: string;
498
+ node: string;
499
+ args: string[];
500
+ };
501
+ 'llm:profiles:init': {
502
+ domain: string;
503
+ desc: string;
504
+ node: string;
505
+ args: string[];
506
+ gates: string[];
507
+ };
508
+ 'llm:doctor': {
509
+ domain: string;
510
+ desc: string;
511
+ node: string;
512
+ args: string[];
513
+ gates: string[];
514
+ };
515
+ 'llm:probe': {
516
+ domain: string;
517
+ desc: string;
518
+ node: string;
519
+ args: string[];
520
+ gates: string[];
521
+ };
522
+ 'llm:recommend': {
523
+ domain: string;
524
+ desc: string;
525
+ node: string;
526
+ args: string[];
527
+ gates: string[];
528
+ };
529
+ 'llm:run': {
530
+ domain: string;
531
+ desc: string;
532
+ node: string;
533
+ args: string[];
534
+ gates: string[];
535
+ };
536
+ 'llm:eval': {
537
+ domain: string;
538
+ desc: string;
539
+ node: string;
540
+ args: string[];
541
+ gates: string[];
542
+ };
543
+ 'cost:economy': {
544
+ domain: string;
545
+ desc: string;
546
+ node: string;
547
+ gates: string[];
548
+ };
306
549
  'project:check': {
307
550
  domain: string;
308
551
  desc: string;
@@ -318,6 +561,11 @@ export declare const COMMANDS: {
318
561
  desc: string;
319
562
  node: string;
320
563
  };
564
+ 'demo:workspace': {
565
+ domain: string;
566
+ desc: string;
567
+ node: string;
568
+ };
321
569
  'release:check': {
322
570
  domain: string;
323
571
  desc: string;
@@ -44,6 +44,7 @@ export const DOMAINS = {
44
44
  code: 'Code intelligence (codegraph)',
45
45
  memoria: 'Memória',
46
46
  contexto: 'Contexto & token economy',
47
+ llm: 'LLMs & execução supervisionada',
47
48
  governanca: 'Governança & qualidade',
48
49
  geracao: 'Geração de projetos',
49
50
  };
@@ -203,6 +204,194 @@ export const COMMANDS = {
203
204
  capability: 'graph.sync',
204
205
  gates: ['workspace-warn'],
205
206
  },
207
+ 'drift:check': {
208
+ domain: 'code',
209
+ desc: 'Reindexa e sinaliza relações verified que a extração atual não reproduz mais (SPEC-030). --domain <d> restringe',
210
+ node: 'scripts/drift-check.ts',
211
+ gates: ['workspace-warn'],
212
+ },
213
+ 'adr:list': {
214
+ domain: 'code',
215
+ desc: 'Lista ADRs (memory/90-decisions/) com status, via Engineering Graph (SPEC-032)',
216
+ node: 'scripts/adr.ts',
217
+ args: ['list'],
218
+ gates: ['workspace-warn'],
219
+ },
220
+ 'adr:show': {
221
+ domain: 'code',
222
+ desc: 'Mostra uma ADR: status, arquivo, constraints (SPEC-032)',
223
+ node: 'scripts/adr.ts',
224
+ args: ['show'],
225
+ gates: ['workspace-warn'],
226
+ },
227
+ 'adr:impact': {
228
+ domain: 'code',
229
+ desc: 'Componentes/documentos alcançáveis a partir de uma ADR, via GraphLoop.impact (SPEC-032)',
230
+ node: 'scripts/adr.ts',
231
+ args: ['impact'],
232
+ gates: ['workspace-warn'],
233
+ },
234
+ 'adr:graph': {
235
+ domain: 'code',
236
+ desc: 'Subgrafo (JSON) de nós ADR/SPEC + vizinhança (SPEC-032)',
237
+ node: 'scripts/adr.ts',
238
+ args: ['graph'],
239
+ gates: ['workspace-warn'],
240
+ },
241
+ 'architecture:compile': {
242
+ domain: 'code',
243
+ desc: 'ADRs (## Constraints) → .context/architecture/constitution.json (SPEC-033)',
244
+ node: 'scripts/architecture.ts',
245
+ args: ['compile'],
246
+ },
247
+ 'architecture:check': {
248
+ domain: 'code',
249
+ desc: 'Verifica o código real contra a Architecture Constitution compilada (SPEC-033)',
250
+ node: 'scripts/architecture.ts',
251
+ args: ['check'],
252
+ gates: ['workspace-warn'],
253
+ },
254
+ 'architecture:status': {
255
+ domain: 'code',
256
+ desc: 'Resumo da Constitution: regras active/proposed, última compilação (SPEC-033)',
257
+ node: 'scripts/architecture.ts',
258
+ args: ['status'],
259
+ },
260
+ 'architecture:explain': {
261
+ domain: 'code',
262
+ desc: 'Explica uma regra da Constitution: ADR de origem, severidade, texto original (SPEC-033)',
263
+ node: 'scripts/architecture.ts',
264
+ args: ['explain'],
265
+ },
266
+ 'architecture:approve': {
267
+ domain: 'code',
268
+ desc: 'Promove uma regra proposed a active via ApprovalLedger (SPEC-033)',
269
+ node: 'scripts/architecture.ts',
270
+ args: ['approve'],
271
+ },
272
+ 'risk:assess': {
273
+ domain: 'code',
274
+ desc: 'Score de risco 0-100 (7 fatores) sobre o diff de um ref (default: working tree) (SPEC-034)',
275
+ node: 'scripts/risk.ts',
276
+ args: ['assess'],
277
+ gates: ['workspace-warn'],
278
+ },
279
+ 'risk:explain': {
280
+ domain: 'code',
281
+ desc: 'Reexibe um assessment de risco já calculado, com todos os fatores (SPEC-034)',
282
+ node: 'scripts/risk.ts',
283
+ args: ['explain'],
284
+ },
285
+ 'evidence:show': {
286
+ domain: 'code',
287
+ desc: 'View agregada de evidência de um run: intent, agente, testes, aprovações (SPEC-035)',
288
+ node: 'scripts/evidence.ts',
289
+ args: ['show'],
290
+ gates: ['workspace-warn'],
291
+ },
292
+ 'engineer': {
293
+ domain: 'code',
294
+ desc: 'Façade: contexto + ADRs relevantes + architecture:check + risco + fluxo recomendado (SPEC-035)',
295
+ node: 'scripts/engineer.ts',
296
+ gates: ['workspace-warn'],
297
+ },
298
+ 'agent:register': {
299
+ domain: 'code',
300
+ desc: 'Registra/atualiza um agente (role/provider/model/capabilities/domains) (SPEC-036)',
301
+ node: 'scripts/agent.ts',
302
+ args: ['register'],
303
+ gates: ['workspace-warn'],
304
+ },
305
+ 'agent:list': {
306
+ domain: 'code',
307
+ desc: 'Lista agentes registrados, com trustLevel se já pontuados (SPEC-036)',
308
+ node: 'scripts/agent.ts',
309
+ args: ['list'],
310
+ gates: ['workspace-warn'],
311
+ },
312
+ 'agent:show': {
313
+ domain: 'code',
314
+ desc: 'Detalhe de um agente registrado (SPEC-036)',
315
+ node: 'scripts/agent.ts',
316
+ args: ['show'],
317
+ gates: ['workspace-warn'],
318
+ },
319
+ 'agent:score': {
320
+ domain: 'code',
321
+ desc: 'Computa e persiste trustLevel/autonomyLevel a partir de Observation reais (SPEC-036)',
322
+ node: 'scripts/agent.ts',
323
+ args: ['score'],
324
+ gates: ['workspace-warn'],
325
+ },
326
+ 'agent:history': {
327
+ domain: 'code',
328
+ desc: 'Observations de um agente, mais recentes primeiro (SPEC-036)',
329
+ node: 'scripts/agent.ts',
330
+ args: ['history'],
331
+ gates: ['workspace-warn'],
332
+ },
333
+ 'agent:recommend': {
334
+ domain: 'code',
335
+ desc: 'Ranking de agentes registrados por adequação a um papel/domínio — informação, não atribuição (SPEC-037)',
336
+ node: 'scripts/agent.ts',
337
+ args: ['recommend'],
338
+ gates: ['workspace-warn'],
339
+ },
340
+ 'agent:monitor': {
341
+ domain: 'code',
342
+ desc: 'Compara comportamento recente de um agente contra a linha de base histórica — informação, não bloqueio (SPEC-040)',
343
+ node: 'scripts/agent.ts',
344
+ args: ['monitor'],
345
+ gates: ['workspace-warn'],
346
+ },
347
+ 'incident:record': {
348
+ domain: 'code',
349
+ desc: 'Grava um incidente no Engineering Graph (SPEC-041)',
350
+ node: 'scripts/incident.ts',
351
+ args: ['record'],
352
+ gates: ['workspace-warn'],
353
+ },
354
+ 'incident:list': {
355
+ domain: 'code',
356
+ desc: 'Incidentes registrados, mais recentes primeiro (SPEC-041)',
357
+ node: 'scripts/incident.ts',
358
+ args: ['list'],
359
+ gates: ['workspace-warn'],
360
+ },
361
+ 'incident:similar': {
362
+ domain: 'code',
363
+ desc: 'Sugere incidentes parecidos por palavra-chave — sugestão, nunca aplicação automática (SPEC-041)',
364
+ node: 'scripts/incident.ts',
365
+ args: ['similar'],
366
+ gates: ['workspace-warn'],
367
+ },
368
+ 'simulate': {
369
+ domain: 'code',
370
+ desc: 'Testa+arquitetura+risco de um ref num worktree isolado, nunca promove (SPEC-038)',
371
+ node: 'scripts/simulate.ts',
372
+ gates: ['workspace-warn'],
373
+ },
374
+ 'provenance:record': {
375
+ domain: 'code',
376
+ desc: 'Extrai proveniência (arquivo↔agente) de um RuntimeRun já persistido (SPEC-039)',
377
+ node: 'scripts/provenance.ts',
378
+ args: ['record'],
379
+ gates: ['workspace-warn'],
380
+ },
381
+ 'blame': {
382
+ domain: 'code',
383
+ desc: 'Histórico de proveniência de um arquivo — granularidade de arquivo, não linha (SPEC-039)',
384
+ node: 'scripts/provenance.ts',
385
+ args: ['blame'],
386
+ gates: ['workspace-warn'],
387
+ },
388
+ 'sbom': {
389
+ domain: 'code',
390
+ desc: 'AI-SBOM: relatório de proveniência agregado por agente (SPEC-039)',
391
+ node: 'scripts/provenance.ts',
392
+ args: ['sbom'],
393
+ gates: ['workspace-warn'],
394
+ },
206
395
  'code:context': {
207
396
  domain: 'code',
208
397
  desc: 'Pacote de contexto mínimo de um domínio: o mapa (context.md), + código com --code (ADR-0009)',
@@ -322,6 +511,61 @@ export const COMMANDS = {
322
511
  desc: 'Benchmark JSON determinístico de baseline, contexto mínimo, checksum e cache',
323
512
  node: 'scripts/context-benchmark.ts',
324
513
  },
514
+ 'spec:set-status': {
515
+ domain: 'sdd',
516
+ desc: 'Atualiza o status de um artefato SDD',
517
+ node: 'scripts/spec-cli.ts',
518
+ args: ['set-status'],
519
+ },
520
+ // --- LLMs & execução supervisionada -------------------------------------
521
+ 'llm:profiles:init': {
522
+ domain: 'llm',
523
+ desc: 'Cria perfis de adapters LLM no workspace',
524
+ node: 'scripts/llm-fit.ts',
525
+ args: ['profiles:init'],
526
+ gates: ['workspace'],
527
+ },
528
+ 'llm:doctor': {
529
+ domain: 'llm',
530
+ desc: 'Verifica adapters LLM configurados sem usar credenciais',
531
+ node: 'scripts/llm-fit.ts',
532
+ args: ['doctor'],
533
+ gates: ['workspace'],
534
+ },
535
+ 'llm:probe': {
536
+ domain: 'llm',
537
+ desc: 'Executa probe seguro de disponibilidade dos adapters LLM',
538
+ node: 'scripts/llm-fit.ts',
539
+ args: ['probe'],
540
+ gates: ['workspace'],
541
+ },
542
+ 'llm:recommend': {
543
+ domain: 'llm',
544
+ desc: 'Recomenda perfil LLM por papel, tarefa e evidência local',
545
+ node: 'scripts/llm-fit.ts',
546
+ args: ['recommend'],
547
+ gates: ['workspace'],
548
+ },
549
+ 'llm:run': {
550
+ domain: 'llm',
551
+ desc: 'Executa um perfil LLM e registra observação normalizada',
552
+ node: 'scripts/llm-fit.ts',
553
+ args: ['run'],
554
+ gates: ['workspace'],
555
+ },
556
+ 'llm:eval': {
557
+ domain: 'llm',
558
+ desc: 'Avalia execuções LLM com métricas determinísticas',
559
+ node: 'scripts/llm-fit.ts',
560
+ args: ['eval'],
561
+ gates: ['workspace'],
562
+ },
563
+ 'cost:economy': {
564
+ domain: 'llm',
565
+ desc: 'Custo real acumulado (USD) das execuções LLM registradas, por modelo — tabela de preço local (SPEC-029)',
566
+ node: 'scripts/cost-economy.ts',
567
+ gates: ['workspace'],
568
+ },
325
569
  // --- Governança & qualidade ---------------------------------------------------
326
570
  'project:check': {
327
571
  domain: 'governanca',
@@ -338,6 +582,11 @@ export const COMMANDS = {
338
582
  desc: 'Executa a prova offline de autonomia supervisionada com Git worktree real',
339
583
  node: 'scripts/demo-autonomy.ts',
340
584
  },
585
+ 'demo:workspace': {
586
+ domain: 'governanca',
587
+ desc: 'Cria um workspace isolado e rotulado para demonstração do produto',
588
+ node: 'scripts/demo-workspace.ts',
589
+ },
341
590
  'release:check': {
342
591
  domain: 'governanca',
343
592
  desc: 'Gate do tarball: instala limpo e prova que o pacote funciona (ADR-0024). --publish para o modo estrito',