forjajs 5.0.1 → 5.3.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 (268) hide show
  1. package/CHANGELOG.md +114 -2
  2. package/README.md +40 -5
  3. package/README.pt-BR.md +42 -4
  4. package/boilerplates/02-saas-starter/README.md +58 -293
  5. package/boilerplates/02-saas-starter/backend/.env.example +13 -0
  6. package/boilerplates/02-saas-starter/backend/.oxlintrc.json +8 -0
  7. package/boilerplates/02-saas-starter/backend/nest-cli.json +6 -0
  8. package/boilerplates/02-saas-starter/backend/package.json +32 -73
  9. package/boilerplates/02-saas-starter/backend/src/app.module.ts +16 -16
  10. package/boilerplates/02-saas-starter/backend/src/billing/adapters/http/billing.controller.ts +55 -0
  11. package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/orm-entities.ts +28 -0
  12. package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/typeorm-billing.repository.ts +46 -0
  13. package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.spec.ts +58 -0
  14. package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.ts +68 -0
  15. package/boilerplates/02-saas-starter/backend/src/billing/billing.module.ts +11 -0
  16. package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.spec.ts +23 -0
  17. package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.ts +36 -0
  18. package/boilerplates/02-saas-starter/backend/src/billing/domain/ports.ts +27 -0
  19. package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.spec.ts +28 -0
  20. package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.ts +47 -0
  21. package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/auth.dto.ts +22 -0
  22. package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/identity.controller.ts +59 -0
  23. package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/orm-entities.ts +25 -0
  24. package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/typeorm-identity.repository.ts +47 -0
  25. package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.spec.ts +72 -0
  26. package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.ts +63 -0
  27. package/boilerplates/02-saas-starter/backend/src/identity/domain/model.spec.ts +19 -0
  28. package/boilerplates/02-saas-starter/backend/src/identity/domain/model.ts +42 -0
  29. package/boilerplates/02-saas-starter/backend/src/identity/domain/password.spec.ts +17 -0
  30. package/boilerplates/02-saas-starter/backend/src/identity/domain/password.ts +26 -0
  31. package/boilerplates/02-saas-starter/backend/src/identity/identity.module.ts +12 -0
  32. package/boilerplates/02-saas-starter/backend/src/main.ts +19 -19
  33. package/boilerplates/02-saas-starter/backend/src/platform/auth/jwt-auth.guard.ts +17 -0
  34. package/boilerplates/02-saas-starter/backend/src/platform/auth/principal.ts +22 -0
  35. package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.spec.ts +23 -0
  36. package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.ts +20 -0
  37. package/boilerplates/02-saas-starter/backend/src/platform/auth/token.service.ts +54 -0
  38. package/boilerplates/02-saas-starter/backend/src/platform/config.spec.ts +18 -0
  39. package/boilerplates/02-saas-starter/backend/src/platform/config.ts +33 -0
  40. package/boilerplates/02-saas-starter/backend/src/platform/platform.module.ts +14 -0
  41. package/boilerplates/02-saas-starter/backend/tsconfig.build.json +6 -0
  42. package/boilerplates/02-saas-starter/backend/tsconfig.json +16 -21
  43. package/boilerplates/02-saas-starter/backend/vitest.config.ts +7 -0
  44. package/boilerplates/02-saas-starter/boilerplate.manifest.json +19 -14
  45. package/boilerplates/02-saas-starter/docker-compose.yml +10 -24
  46. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +15 -132
  47. package/boilerplates/02-saas-starter/memory/30-domains/identity/context.md +20 -0
  48. package/boilerplates/README.md +9 -10
  49. package/dist/apps/cli/src/index.d.ts +0 -1
  50. package/dist/apps/cli/src/index.js +43 -32
  51. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +34 -1
  52. package/dist/apps/dashboard/app/api/forja/capabilities.d.ts +26 -0
  53. package/dist/apps/dashboard/app/api/forja/capabilities.js +39 -0
  54. package/dist/apps/dashboard/app/dashboard-client.jsx +607 -42
  55. package/dist/apps/server/src/forja-nest.module.d.ts +6 -0
  56. package/dist/apps/server/src/forja-nest.module.js +55 -0
  57. package/dist/apps/server/src/main.d.ts +21 -4
  58. package/dist/apps/server/src/main.js +79 -57
  59. package/dist/apps/server/src/task-planning-service.d.ts +29 -0
  60. package/dist/apps/server/src/task-planning-service.js +195 -0
  61. package/dist/apps/server/src/task-runtime-coordinator.d.ts +57 -0
  62. package/dist/apps/server/src/task-runtime-coordinator.js +229 -0
  63. package/dist/bin/forja.js +3 -2
  64. package/dist/bin/init-project.js +1 -0
  65. package/dist/lib/agent-evals.d.ts +138 -0
  66. package/dist/lib/agent-evals.js +349 -0
  67. package/dist/lib/cli-output.js +14 -2
  68. package/dist/lib/code-context.d.ts +33 -5
  69. package/dist/lib/code-context.js +70 -5
  70. package/dist/lib/context-builder.d.ts +49 -4
  71. package/dist/lib/context-builder.js +114 -47
  72. package/dist/lib/core/coverage-gate.d.ts +59 -0
  73. package/dist/lib/core/coverage-gate.js +58 -0
  74. package/dist/lib/core/doc-graph.d.ts +38 -0
  75. package/dist/lib/core/doc-graph.js +83 -0
  76. package/dist/lib/core/health.js +286 -5
  77. package/dist/lib/core/journey.js +36 -0
  78. package/dist/lib/core/registry.js +81 -6
  79. package/dist/lib/docs-reference.d.ts +35 -0
  80. package/dist/lib/docs-reference.js +57 -0
  81. package/dist/lib/generators/memory-generator.d.ts +0 -11
  82. package/dist/lib/generators/memory-generator.js +5 -161
  83. package/dist/lib/generators/readme-generator.js +1 -1
  84. package/dist/lib/llm/json-output.d.ts +14 -0
  85. package/dist/lib/llm/json-output.js +77 -0
  86. package/dist/lib/project-wiring.d.ts +8 -0
  87. package/dist/lib/project-wiring.js +79 -3
  88. package/dist/lib/session-memory.d.ts +38 -0
  89. package/dist/lib/session-memory.js +206 -0
  90. package/dist/lib/spec-trace.d.ts +46 -0
  91. package/dist/lib/spec-trace.js +184 -0
  92. package/dist/lib/validators/structure-validator.js +0 -1
  93. package/dist/packages/adapter-nest/src/index.d.ts +2 -1
  94. package/dist/packages/adapter-nest/src/index.js +59 -1
  95. package/dist/packages/adapter-sqlite/src/index.d.ts +15 -1
  96. package/dist/packages/adapter-sqlite/src/index.js +61 -1
  97. package/dist/packages/context/src/index.d.ts +2 -0
  98. package/dist/packages/context/src/index.js +36 -15
  99. package/dist/packages/contracts/src/index.d.ts +64 -0
  100. package/dist/packages/core/src/index.d.ts +9 -1
  101. package/dist/packages/core/src/index.js +28 -3
  102. package/dist/packages/graph/src/index.js +14 -5
  103. package/dist/packages/llm/src/index.js +12 -2
  104. package/dist/packages/mcp/src/index.d.ts +8 -0
  105. package/dist/packages/mcp/src/index.js +12 -1
  106. package/dist/packages/observability/src/index.d.ts +11 -0
  107. package/dist/packages/observability/src/index.js +3 -0
  108. package/dist/packages/orchestration/src/index.d.ts +15 -1
  109. package/dist/packages/orchestration/src/index.js +127 -21
  110. package/dist/packages/planner/src/index.d.ts +7 -1
  111. package/dist/packages/planner/src/index.js +67 -10
  112. package/dist/packages/planner/src/proposal-store.d.ts +30 -0
  113. package/dist/packages/planner/src/proposal-store.js +109 -0
  114. package/dist/packages/policy/src/index.d.ts +9 -16
  115. package/dist/packages/policy/src/index.js +114 -31
  116. package/dist/packages/runtime/src/index.d.ts +16 -2
  117. package/dist/packages/runtime/src/index.js +176 -61
  118. package/dist/scripts/build-smart-context.d.ts +2 -0
  119. package/dist/scripts/build-smart-context.js +12 -3
  120. package/dist/scripts/code-context.d.ts +3 -1
  121. package/dist/scripts/code-context.js +13 -3
  122. package/dist/scripts/coverage-gate.d.ts +2 -0
  123. package/dist/scripts/coverage-gate.js +101 -0
  124. package/dist/scripts/eval-agents.d.ts +11 -0
  125. package/dist/scripts/eval-agents.js +96 -0
  126. package/dist/scripts/gen-commands-doc.d.ts +2 -0
  127. package/dist/scripts/gen-commands-doc.js +18 -0
  128. package/dist/scripts/hook-session-memory.d.ts +9 -0
  129. package/dist/scripts/hook-session-memory.js +20 -0
  130. package/dist/scripts/hook-session-start.js +34 -0
  131. package/dist/scripts/llm-fit.js +23 -1
  132. package/dist/scripts/spec-trace.d.ts +10 -0
  133. package/dist/scripts/spec-trace.js +73 -0
  134. package/dist/scripts/sync-universal-memory.js +69 -4
  135. package/dist/scripts/token-benchmark.d.ts +33 -1
  136. package/dist/scripts/token-benchmark.js +179 -5
  137. package/dist/scripts/token-economy.js +3 -1
  138. package/dist/scripts/tools-doctor.d.ts +16 -1
  139. package/dist/scripts/tools-doctor.js +58 -17
  140. package/docs/commands.md +155 -0
  141. package/docs/fluxo.md +11 -7
  142. package/docs/init-project.md +3 -1
  143. package/docs/llm-fit-loop.md +36 -0
  144. package/docs/manual-operacional-cli-sdd-gsd.md +3 -2
  145. package/docs/produto/factsheet-marketing.md +7 -5
  146. package/docs/produto/roteiro-demo.md +14 -5
  147. package/docs/quick-reference.md +3 -3
  148. package/docs/token-optimization.md +10 -6
  149. package/memory/90-decisions/0088-templates-validados.md +3 -0
  150. package/memory/90-decisions/0089-skills-do-projeto.md +51 -0
  151. package/memory/90-decisions/0090-adapters-de-agente-somente-leitura.md +47 -0
  152. package/memory/90-decisions/0091-memoria-de-sessao-por-hooks.md +40 -0
  153. package/memory/90-decisions/0092-criterios-de-aceite-ligados-a-testes.md +37 -0
  154. package/memory/90-decisions/0093-avaliacoes-com-agentes-reais.md +40 -0
  155. package/package.json +4 -2
  156. package/specs/avaliacoes-de-agentes/spec.md +52 -0
  157. package/specs/criterios-ligados-a-testes/spec.md +42 -0
  158. package/specs/memoria-de-sessao/spec.md +48 -0
  159. package/specs/skills-do-projeto/plan.md +40 -0
  160. package/specs/skills-do-projeto/spec.md +63 -0
  161. package/specs/skills-do-projeto/tasks.md +27 -0
  162. package/specs/v6-agent-runtime-portable/spec.md +83 -0
  163. package/specs/v6-core-consolidation/spec.md +70 -0
  164. package/specs/v6-docs-drift/spec.md +85 -0
  165. package/specs/v6-quality-gates/spec.md +99 -0
  166. package/specs/v6-token-economy/spec.md +84 -0
  167. package/templates/evals/agents/adr.json +25 -0
  168. package/templates/evals/agents/memoria.json +32 -0
  169. package/templates/evals/agents/proxima-acao.json +29 -0
  170. package/templates/evals/agents/spec-nova.json +26 -0
  171. package/templates/evals/agents/teste-do-criterio.json +29 -0
  172. package/templates/project/AGENTS.md +16 -0
  173. package/templates/project/CLAUDE.md +3 -2
  174. package/templates/project/agents/context-engineer.md +3 -0
  175. package/templates/project/agents/governance.md +3 -0
  176. package/templates/project/agents/marketing.md +3 -0
  177. package/templates/project/agents/orchestrator.md +3 -0
  178. package/templates/project/agents/product.md +3 -0
  179. package/templates/project/agents/sdd-architect.md +3 -0
  180. package/templates/project/skills/README.md +14 -0
  181. package/templates/project/skills/accessibility-review/SKILL.md +89 -0
  182. package/templates/project/skills/api-design/SKILL.md +77 -0
  183. package/templates/project/skills/architecture-decision-record/SKILL.md +92 -0
  184. package/templates/project/skills/backlog-slicing/SKILL.md +82 -0
  185. package/templates/project/skills/bounded-context-mapping/SKILL.md +88 -0
  186. package/templates/project/skills/ci-pipeline-review/SKILL.md +83 -0
  187. package/templates/project/skills/commit-message/SKILL.md +143 -0
  188. package/templates/project/skills/data-migrations/SKILL.md +88 -0
  189. package/templates/project/skills/dependency-upgrade/SKILL.md +75 -0
  190. package/templates/project/skills/docker-compose-review/SKILL.md +85 -0
  191. package/templates/project/skills/domain-modeling/SKILL.md +120 -0
  192. package/templates/project/skills/event-storming/SKILL.md +95 -0
  193. package/templates/project/skills/executive-writing/SKILL.md +99 -0
  194. package/templates/project/skills/frontend-architecture/SKILL.md +97 -0
  195. package/templates/project/skills/incident-postmortem/SKILL.md +93 -0
  196. package/templates/project/skills/lgpd-compliance/SKILL.md +108 -0
  197. package/templates/project/skills/llm-provider-routing/SKILL.md +18 -0
  198. package/templates/project/skills/observability/SKILL.md +93 -0
  199. package/templates/project/skills/product-evaluation/SKILL.md +130 -0
  200. package/templates/project/skills/prompt-spec/SKILL.md +83 -0
  201. package/templates/project/skills/pull-request/SKILL.md +101 -0
  202. package/templates/project/skills/query-performance/SKILL.md +83 -0
  203. package/templates/project/skills/release-checklist/SKILL.md +106 -0
  204. package/templates/project/skills/release-notes/SKILL.md +87 -0
  205. package/templates/project/skills/requirements-elicitation/SKILL.md +127 -0
  206. package/templates/project/skills/requirements-gathering/SKILL.md +134 -0
  207. package/templates/project/skills/technical-spike/SKILL.md +101 -0
  208. package/templates/project/skills/testing/SKILL.md +109 -0
  209. package/templates/project/skills/threat-modeling/SKILL.md +87 -0
  210. package/templates/project/skills/ts-async-patterns/SKILL.md +101 -0
  211. package/templates/project/skills/ts-code-review/SKILL.md +121 -0
  212. package/templates/project/skills/ts-module-layout/SKILL.md +104 -0
  213. package/templates/project/skills/ts-testing/SKILL.md +89 -0
  214. package/templates/project/skills/web-performance/SKILL.md +72 -0
  215. package/boilerplates/02-saas-starter/.env.example +0 -25
  216. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +0 -190
  217. package/boilerplates/02-saas-starter/INFO.md +0 -252
  218. package/boilerplates/02-saas-starter/QUICK_START.md +0 -194
  219. package/boilerplates/02-saas-starter/START-HERE.md +0 -259
  220. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +0 -3
  221. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +0 -6
  222. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +0 -23
  223. package/boilerplates/02-saas-starter/backend/src/config/database.ts +0 -26
  224. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +0 -46
  225. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +0 -25
  226. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +0 -145
  227. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +0 -30
  228. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +0 -24
  229. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +0 -19
  230. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +0 -42
  231. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +0 -13
  232. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +0 -67
  233. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +0 -52
  234. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +0 -36
  235. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +0 -16
  236. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +0 -13
  237. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +0 -34
  238. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +0 -40
  239. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +0 -36
  240. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +0 -13
  241. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +0 -91
  242. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +0 -42
  243. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +0 -14
  244. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +0 -13
  245. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +0 -48
  246. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +0 -227
  247. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +0 -141
  248. package/boilerplates/02-saas-starter/memory/00-global/index.md +0 -133
  249. package/boilerplates/02-saas-starter/memory/00-global/mission.md +0 -45
  250. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +0 -223
  251. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +0 -240
  252. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +0 -239
  253. package/boilerplates/02-saas-starter/memory/10-product/personas.md +0 -195
  254. package/boilerplates/02-saas-starter/memory/10-product/vision.md +0 -63
  255. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +0 -232
  256. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +0 -186
  257. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +0 -85
  258. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +0 -262
  259. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +0 -176
  260. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +0 -100
  261. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +0 -81
  262. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +0 -97
  263. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +0 -57
  264. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +0 -90
  265. package/boilerplates/02-saas-starter/memory/60-runs/index.md +0 -54
  266. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +0 -50
  267. package/boilerplates/02-saas-starter/memory/80-data/schema.md +0 -185
  268. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +0 -75
@@ -4,6 +4,7 @@
4
4
  * forja context:smart global (missão, padrões, ADRs)
5
5
  * forja context:smart --mode domain + visão/design/regras do projeto
6
6
  * forja context:smart --mode task --task pix + nós do projeto que casam com a tarefa (FTS5)
7
+ * forja context:smart --full-context nós inteiros, sem trecho (opt-out da SPEC-057)
7
8
  * forja context:smart <projeto> [keyword] forma posicional antiga (studio) — ainda aceita
8
9
  *
9
10
  * O projeto é inferido de onde o comando roda: no modo embedded é o próprio projeto; no studio,
@@ -14,12 +15,15 @@
14
15
  import fs from 'node:fs';
15
16
  import path from 'node:path';
16
17
  import { ContextBuilder } from '../lib/context-builder.js';
18
+ import { COMMANDS } from '../lib/core/registry.js';
17
19
  import { getDbPath, ensureSchema } from './memory-schema.js';
18
20
  import { getForjaMode, getProjectsDir, getWorkspaceContextDir, getWorkspaceRoot, initWorkspace, resolveProject } from '../lib/workspace.js';
19
21
  const MODES = ['global', 'domain', 'task'];
20
22
  function fail(msg) {
21
23
  console.error(msg);
22
- console.error('Uso: forja context:smart [--mode global|domain|task] [--task <termo>] [--project <nome>]');
24
+ // O usage do registro, não um texto à parte: foi assim que o help prometeu três modos que o comando
25
+ // ignorava — duas fontes da mesma frase, e só uma delas era verdade.
26
+ console.error(`Uso: ${COMMANDS['context:smart'].usage}`);
23
27
  process.exit(1);
24
28
  }
25
29
  export function parseArgs(argv) {
@@ -34,6 +38,8 @@ export function parseArgs(argv) {
34
38
  opts.task = val();
35
39
  else if (a === '--project')
36
40
  opts.project = val();
41
+ else if (a === '--full-context')
42
+ opts.full = true;
37
43
  else if (a.startsWith('--'))
38
44
  fail(`Opção desconhecida: ${a}`);
39
45
  else
@@ -67,7 +73,7 @@ function main() {
67
73
  ensureSchema({ silent: true });
68
74
  const builder = new ContextBuilder(process.cwd(), getDbPath());
69
75
  try {
70
- const content = builder.build(mode, project ?? 'global', keyword);
76
+ const content = builder.build(mode, project ?? 'global', keyword, { full: opts.full === true });
71
77
  const outDir = embedded
72
78
  ? path.join(getWorkspaceRoot(), '.context')
73
79
  : project ? path.join(resolveProject(project), '.context') : getWorkspaceContextDir();
@@ -76,8 +82,11 @@ function main() {
76
82
  const outFile = path.join(outDir, 'smart-context.md');
77
83
  builder.save(content, outFile);
78
84
  const files = (content.match(/^\*\*Path\*\*:/gm) || []).length;
85
+ const excerpts = /- \*\*Excerpts\*\*: (\d+)\/(\d+)/.exec(content);
86
+ const cortados = excerpts ? Number(excerpts[1]) : 0;
79
87
  console.log(`✓ contexto ${mode}${keyword ? ` ("${keyword}")` : ''}${project ? ` de ${project}` : ''}: ${outFile}`);
80
- console.log(` ${files} arquivo(s) · ~${Math.round(content.length / 4)} tokens`);
88
+ console.log(` ${files} arquivo(s) · ~${Math.round(content.length / 4)} tokens` +
89
+ (cortados ? ` · ${cortados} nó(s) em trecho (--full-context injeta inteiro)` : ''));
81
90
  if (files === 0)
82
91
  console.log(' nada indexado ainda — rode: forja sync:universal');
83
92
  }
@@ -3,7 +3,9 @@
3
3
  * code:context — entrega o pacote de contexto mínimo de um domínio (SPEC-016, ADR-0009).
4
4
  *
5
5
  * forja code:context <domínio> só o mapa (context.md) — o contexto barato
6
- * forja code:context <domínio> --code + o código da fatia (para editar)
6
+ * forja code:context <domínio> --code + o código da fatia (para editar), por relevância
7
+ * forja code:context <domínio> <termo> --code prioriza os arquivos que casam com o termo
8
+ * forja code:context <domínio> --code --full a fatia inteira, sem orçamento (SPEC-057)
7
9
  * forja code:context <domínio> --project <path> aponta para outro projeto
8
10
  *
9
11
  * O −61% do `token:economy` virado ferramenta: o mapa que substitui a exploração, pronto para colar.
@@ -3,7 +3,9 @@
3
3
  * code:context — entrega o pacote de contexto mínimo de um domínio (SPEC-016, ADR-0009).
4
4
  *
5
5
  * forja code:context <domínio> só o mapa (context.md) — o contexto barato
6
- * forja code:context <domínio> --code + o código da fatia (para editar)
6
+ * forja code:context <domínio> --code + o código da fatia (para editar), por relevância
7
+ * forja code:context <domínio> <termo> --code prioriza os arquivos que casam com o termo
8
+ * forja code:context <domínio> --code --full a fatia inteira, sem orçamento (SPEC-057)
7
9
  * forja code:context <domínio> --project <path> aponta para outro projeto
8
10
  *
9
11
  * O −61% do `token:economy` virado ferramenta: o mapa que substitui a exploração, pronto para colar.
@@ -29,8 +31,10 @@ function main() {
29
31
  positional.push(argv[i]);
30
32
  }
31
33
  const domain = positional[0];
34
+ const query = positional.slice(1).join(' ');
32
35
  const projectRoot = path.resolve(arg('--project') || process.cwd());
33
36
  const includeCode = process.argv.includes('--code');
37
+ const full = process.argv.includes('--full');
34
38
  const available = domainsOf(projectRoot);
35
39
  if (!domain) {
36
40
  if (!available.length) {
@@ -38,11 +42,11 @@ function main() {
38
42
  console.error('Rode dentro de um projeto gerado, ou aponte com --project <path>.');
39
43
  process.exit(1);
40
44
  }
41
- console.log('Uso: forja code:context <domínio> [--code] [--project <path>]\n');
45
+ console.log('Uso: forja code:context <domínio> [termo] [--code] [--full] [--project <path>]\n');
42
46
  console.log(`Domínios disponíveis: ${available.join(', ')}`);
43
47
  return;
44
48
  }
45
- const pack = buildContextPack({ projectRoot, domain, includeCode });
49
+ const pack = buildContextPack({ projectRoot, domain, includeCode, query, full });
46
50
  if (!pack.found) {
47
51
  console.error(`Domínio "${domain}" não tem context.md em ${projectRoot}.`);
48
52
  if (available.length)
@@ -65,6 +69,12 @@ function main() {
65
69
  console.error(''); // separa do stdout colável
66
70
  if (includeCode) {
67
71
  console.error(`— pacote completo: ${pack.totalTokens} tokens (mapa ${pack.mapTokens} + código ${pack.codeTokens}, ${pack.code.length} arquivos).`);
72
+ if (pack.codeOmitted.length) {
73
+ const omitidos = pack.codeOmitted.reduce((acc, c) => acc + c.tokens, 0);
74
+ console.error(`— fora do orçamento: ${pack.codeOmitted.length} arquivos (${omitidos} tokens) · --full traz a fatia inteira.`);
75
+ for (const c of pack.codeOmitted)
76
+ console.error(` ${c.path} (${c.tokens} tokens)`);
77
+ }
68
78
  }
69
79
  else {
70
80
  console.error(`— só o mapa: ${pack.mapTokens} tokens. Para editar, adicione o código com --code, ou o blast radius com \`forja code:impact <símbolo>\`.`);
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,101 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * quality:coverage — roda a suíte com a cobertura nativa do Node e cobra o piso versionado (SPEC-056).
4
+ *
5
+ * Sem c8/istanbul de propósito: `node --test --experimental-test-coverage` já produz a tabela, e o
6
+ * trabalho aqui é ler a linha "all files" e comparar com `coverageLineFloor` de
7
+ * `lib/core/quality-budget.json`. É o ratchet gêmeo do check `type-debt`: o piso só desce em commit
8
+ * explícito, e a suíte continua sendo a mesma — não há segunda máquina de teste.
9
+ *
10
+ * A saída do filho é capturada e reimpressa inteira: o CI precisa ver cada teste, e o parsing precisa
11
+ * da tabela. Piso abaixo do combinado → exit 2 (`emitRejected`): gate negativo, não falha operacional.
12
+ *
13
+ * Ler a tabela, ler o piso e decidir o código de saída vive em `lib/core/coverage-gate.ts` — aqui só
14
+ * a coleta e a emissão, porque um teste deste script rodaria a suíte dentro da suíte (AC-3).
15
+ *
16
+ * A régua só vale se se repetir: `test/isolate-workspace.mjs` retira `NODE_V8_COVERAGE` do ambiente para
17
+ * que os CLIs filhos não despejem blocos parciais na agregação do Node — antes disso o `all files`
18
+ * variava 1,6pp entre execuções idênticas e o piso era sorteio (ver Evidências da SPEC-056).
19
+ */
20
+ import fs from 'node:fs';
21
+ import path from 'node:path';
22
+ import { spawnSync } from 'node:child_process';
23
+ import { fileURLToPath } from 'node:url';
24
+ import { emitError, emitOk, emitRejected } from '../lib/cli-output.js';
25
+ import { asErrno } from '../lib/core/checks.js';
26
+ import { coverageFloorFrom, coverageSummary, decideCoverage, parseCoverageTotal } from '../lib/core/coverage-gate.js';
27
+ const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
28
+ const BUDGET_LABEL = 'lib/core/quality-budget.json';
29
+ const BUDGET = path.join(ROOT, 'lib', 'core', 'quality-budget.json');
30
+ const asJson = process.argv.includes('--json');
31
+ function floor() {
32
+ let text;
33
+ try {
34
+ text = fs.readFileSync(BUDGET, 'utf8');
35
+ }
36
+ catch (err) {
37
+ throw new Error(`orçamento ilegível (${BUDGET_LABEL}): ${asErrno(err).message}`);
38
+ }
39
+ return coverageFloorFrom(text, BUDGET_LABEL);
40
+ }
41
+ function testFiles() {
42
+ const dir = path.join(ROOT, 'test');
43
+ return fs.readdirSync(dir).filter((f) => f.endsWith('.test.js')).sort().map((f) => path.join('test', f));
44
+ }
45
+ let piso;
46
+ try {
47
+ piso = floor();
48
+ }
49
+ catch (err) {
50
+ const mensagem = asErrno(err).message;
51
+ if (asJson)
52
+ emitError(mensagem, { code: 'EBUDGET' });
53
+ console.error(mensagem);
54
+ process.exit(1);
55
+ }
56
+ const files = testFiles();
57
+ if (files.length === 0) {
58
+ if (asJson)
59
+ emitError('nenhum test/*.test.js encontrado', { code: 'ENOTEST' });
60
+ console.error('nenhum test/*.test.js encontrado');
61
+ process.exit(1);
62
+ }
63
+ const run = spawnSync(process.execPath, ['--test', '--experimental-test-coverage', '--import', './test/isolate-workspace.mjs', ...files], { cwd: ROOT, encoding: 'utf8' });
64
+ process.stdout.write(run.stdout ?? '');
65
+ process.stderr.write(run.stderr ?? '');
66
+ const total = parseCoverageTotal(run.stdout ?? '');
67
+ const outcome = decideCoverage({
68
+ spawnError: run.error !== undefined ? run.error.message : null,
69
+ total,
70
+ suiteStatus: run.status,
71
+ floor: piso,
72
+ });
73
+ if (run.error !== undefined) {
74
+ if (asJson)
75
+ emitError(`suíte não rodou: ${run.error.message}`, { code: outcome.code });
76
+ process.exit(outcome.exitCode);
77
+ }
78
+ if (total === null) {
79
+ if (asJson)
80
+ emitError('tabela de cobertura não encontrada na saída da suíte', { code: outcome.code });
81
+ console.error('não achei a linha "all files" da cobertura — o formato do Node mudou?');
82
+ process.exit(outcome.exitCode);
83
+ }
84
+ const payload = { lines: total.lines, branches: total.branches, funcs: total.funcs, floor: piso };
85
+ const resumo = coverageSummary(total, piso);
86
+ if (outcome.kind === 'suite-failed') {
87
+ if (asJson)
88
+ emitRejected({ ...payload, suiteExitCode: run.status ?? 'sinal' });
89
+ console.error(`suíte falhou (exit ${run.status ?? 'sinal'}) — ${resumo}`);
90
+ process.exit(outcome.exitCode);
91
+ }
92
+ if (outcome.kind === 'below-floor') {
93
+ if (asJson)
94
+ emitRejected({ ...payload, gap: Number((piso - total.lines).toFixed(2)) });
95
+ console.error(`ABAIXO DO PISO: ${resumo}`);
96
+ console.error('cubra o que o PR descobriu, ou desça o piso num commit próprio e justificado.');
97
+ process.exit(outcome.exitCode);
98
+ }
99
+ if (asJson)
100
+ emitOk(payload);
101
+ console.log(`OK ${resumo}`);
@@ -0,0 +1,11 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * eval:agents — avaliações com agentes reais em projeto descartável (SPEC-054, ADR-0093).
4
+ *
5
+ * forja eval:agents --agent claude|codex [--case a,b] [--model m] [--budget-usd n]
6
+ * [--timeout s] [--keep] [--list] [--json]
7
+ *
8
+ * Custa: cada caso é uma sessão real do agente. Exit 0 = todos passaram, 2 = algum falhou,
9
+ * 1 = agente ausente, caso inexistente ou argumento inválido.
10
+ */
11
+ export {};
@@ -0,0 +1,96 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * eval:agents — avaliações com agentes reais em projeto descartável (SPEC-054, ADR-0093).
4
+ *
5
+ * forja eval:agents --agent claude|codex [--case a,b] [--model m] [--budget-usd n]
6
+ * [--timeout s] [--keep] [--list] [--json]
7
+ *
8
+ * Custa: cada caso é uma sessão real do agente. Exit 0 = todos passaram, 2 = algum falhou,
9
+ * 1 = agente ausente, caso inexistente ou argumento inválido.
10
+ */
11
+ import fs from 'node:fs';
12
+ import path from 'node:path';
13
+ import { emitError, emitOk, emitRejected } from '../lib/cli-output.js';
14
+ import { ADAPTERS, appendHistory, compareRuns, loadCases, previousRun, runSuite } from '../lib/agent-evals.js';
15
+ import { asset, pkgRoot, script } from '../lib/paths.js';
16
+ import { getWorkspaceContextDir, getWorkspaceInfo } from '../lib/workspace.js';
17
+ const argv = process.argv.slice(2);
18
+ const json = argv.includes('--json');
19
+ const flag = (name) => { const i = argv.indexOf(name); return i >= 0 ? argv[i + 1] : undefined; };
20
+ const die = (msg, code = 'INVALID_ARGS') => {
21
+ if (json)
22
+ emitError(msg, { code });
23
+ console.error(msg);
24
+ process.exit(1);
25
+ };
26
+ const all = loadCases(asset('templates', 'evals', 'agents'));
27
+ if (argv.includes('--list')) {
28
+ if (json)
29
+ emitOk({ cases: all.map((c) => ({ id: c.id, title: c.title, checks: c.checks.length })) });
30
+ for (const c of all)
31
+ console.log(`${c.id.padEnd(20)} ${c.title} (${c.checks.length} checks)`);
32
+ process.exit(0);
33
+ }
34
+ // Sem padrão de propósito: rodar custa dinheiro, então o agente é sempre uma escolha explícita.
35
+ const agentName = flag('--agent') ?? die(`escolha o agente: --agent ${Object.keys(ADAPTERS).join('|')} (cada caso é uma sessão real e paga)`, 'MISSING_ARG');
36
+ const make = ADAPTERS[agentName];
37
+ if (!make)
38
+ die(`agente desconhecido: ${agentName} (suportados: ${Object.keys(ADAPTERS).join(', ')})`);
39
+ const adapter = make();
40
+ if (!adapter.version())
41
+ die(`${agentName} não está instalado ou não responde a --version`, 'AGENT_MISSING');
42
+ const wanted = flag('--case')?.split(',').map((s) => s.trim()).filter(Boolean);
43
+ const unknown = (wanted ?? []).filter((id) => !all.some((c) => c.id === id));
44
+ if (unknown.length)
45
+ die(`caso desconhecido: ${unknown.join(', ')} (veja forja eval:agents --list)`, 'NOT_FOUND');
46
+ const cases = wanted ? all.filter((c) => wanted.includes(c.id)) : all;
47
+ const budgetUsd = Number(flag('--budget-usd') ?? 1);
48
+ const timeoutS = Number(flag('--timeout') ?? 300);
49
+ if (!(budgetUsd > 0) || !(timeoutS > 0))
50
+ die('--budget-usd e --timeout precisam ser positivos');
51
+ const model = flag('--model');
52
+ const version = JSON.parse(fs.readFileSync(path.join(pkgRoot, 'package.json'), 'utf8')).version;
53
+ if (!json) {
54
+ console.log(`Avaliando ${agentName}${model ? ` (${model})` : ''} em ${cases.length} caso(s) — cada caso é uma sessão real do agente.`);
55
+ if (agentName === 'claude')
56
+ console.log(`Teto por caso: US$ ${budgetUsd.toFixed(2)} · timeout ${timeoutS} s\n`);
57
+ else
58
+ console.log(`Timeout por caso: ${timeoutS} s (o Codex não tem teto de custo por flag)\n`);
59
+ }
60
+ const line = (r) => {
61
+ const cost = r.costUsd != null ? ` · US$ ${r.costUsd.toFixed(3)}` : '';
62
+ console.log(`${r.pass ? '✓' : '✗'} ${r.id.padEnd(20)} ${(r.durationMs / 1000).toFixed(0)} s · ${r.commands} comando(s)${cost}`);
63
+ for (const k of r.checks)
64
+ if (!k.ok || !r.pass)
65
+ console.log(` ${k.ok ? '✓' : '✗'} ${k.desc} — ${k.detail}`);
66
+ if (r.error)
67
+ console.log(` ✗ agente: ${r.error}`);
68
+ if (!r.pass && r.answer)
69
+ console.log(` resposta: ${r.answer.replace(/\s+/g, ' ').slice(0, 200)}`);
70
+ };
71
+ const result = runSuite(cases, adapter, version, {
72
+ forjaBin: script('bin/forja'), model, budgetUsd, timeoutMs: timeoutS * 1000, keep: argv.includes('--keep'),
73
+ onCase: json ? undefined : (_c, r) => line(r),
74
+ });
75
+ const ws = getWorkspaceInfo();
76
+ const historyFile = ws.exists ? path.join(getWorkspaceContextDir(), 'agent-evals.jsonl') : null;
77
+ const prev = historyFile ? previousRun(historyFile, result.agent, result.model) : null;
78
+ const diff = compareRuns(prev, result);
79
+ if (historyFile)
80
+ appendHistory(historyFile, result);
81
+ if (json) {
82
+ const payload = { ...result, regressed: diff.regressed, fixed: diff.fixed, history: historyFile };
83
+ if (result.passed < result.cases.length)
84
+ emitRejected(payload);
85
+ emitOk(payload);
86
+ }
87
+ console.log(`\n${result.passed}/${result.cases.length} caso(s) passaram${result.costUsd != null ? ` · custo total US$ ${result.costUsd.toFixed(3)}` : ''}`);
88
+ if (prev) {
89
+ console.log(`Comparado com ${prev.ts.slice(0, 16).replace('T', ' ')} (Forja ${prev.forjaVersion}): ${prev.passed}/${prev.cases.length}`);
90
+ if (diff.regressed.length)
91
+ console.log(` ✗ passaram a falhar: ${diff.regressed.join(', ')}`);
92
+ if (diff.fixed.length)
93
+ console.log(` ✓ passaram a passar: ${diff.fixed.join(', ')}`);
94
+ }
95
+ console.log(historyFile ? `Histórico: ${historyFile}` : 'Sem workspace: o resultado não foi guardado (forja workspace:init).');
96
+ process.exit(result.passed === result.cases.length ? 0 : 2);
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,18 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * docs:gen — regenera docs/commands.md a partir do registry (SPEC-055).
4
+ *
5
+ * A referência completa de comandos é derivada, nunca escrita à mão: o registry é a fonte única e o
6
+ * check `commands-ref` do doctor compara o arquivo com o que este script produz. Rodar é idempotente.
7
+ */
8
+ import fs from 'node:fs';
9
+ import path from 'node:path';
10
+ import { fileURLToPath } from 'node:url';
11
+ import { COMMANDS } from '../lib/core/registry.js';
12
+ import { renderCommandsDoc, skillsCount } from '../lib/docs-reference.js';
13
+ const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
14
+ const TARGET = path.join(ROOT, 'docs/commands.md');
15
+ const skills = skillsCount(fs, path.join(ROOT, 'templates', 'project', 'skills'));
16
+ const doc = renderCommandsDoc(COMMANDS, skills);
17
+ fs.writeFileSync(TARGET, doc);
18
+ console.log(`docs/commands.md gerado: ${Object.keys(COMMANDS).length} comandos em ${new Set(Object.values(COMMANDS).map((c) => c.domain)).size} domínios, ${skills} skills.`);
@@ -0,0 +1,9 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Hook Stop / PreCompact — grava o checkpoint da sessão em memory/60-runs/sessions/ (SPEC-052, ADR-0091).
4
+ *
5
+ * stdin: `{ session_id, transcript_path, cwd, hook_event_name }` (Claude Code). Nunca derruba a
6
+ * sessão: qualquer falha sai com 0 e sem saída. Não escreve em stdout — no Stop, um JSON com
7
+ * `decision` bloquearia o fim do turno.
8
+ */
9
+ export {};
@@ -0,0 +1,20 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Hook Stop / PreCompact — grava o checkpoint da sessão em memory/60-runs/sessions/ (SPEC-052, ADR-0091).
4
+ *
5
+ * stdin: `{ session_id, transcript_path, cwd, hook_event_name }` (Claude Code). Nunca derruba a
6
+ * sessão: qualquer falha sai com 0 e sem saída. Não escreve em stdout — no Stop, um JSON com
7
+ * `decision` bloquearia o fim do turno.
8
+ */
9
+ import fs from 'node:fs';
10
+ import path from 'node:path';
11
+ import { writeCheckpoint } from '../lib/session-memory.js';
12
+ try {
13
+ const input = process.stdin.isTTY ? {} : JSON.parse(fs.readFileSync(0, 'utf8') || '{}');
14
+ const root = path.resolve(process.env.CLAUDE_PROJECT_DIR || input.cwd || process.cwd());
15
+ if (typeof input.session_id === 'string' && typeof input.transcript_path === 'string' && fs.existsSync(input.transcript_path)) {
16
+ writeCheckpoint(root, input.transcript_path, input.session_id, String(input.hook_event_name || 'Stop'));
17
+ }
18
+ }
19
+ catch { /* ADR-0091: o hook nunca derruba a sessão */ }
20
+ process.exit(0);
@@ -22,6 +22,7 @@ import { listSpecs } from '../lib/specs-index.js';
22
22
  import { openHandoffs } from '../lib/handoffs-index.js';
23
23
  import { getWorkspaceRoot, isInsideFrameworkRepo, currentProjectName } from '../lib/workspace.js';
24
24
  import { pkgRoot } from '../lib/paths.js';
25
+ import { findCheckpoint, latestCheckpoint, summarizeCheckpoint } from '../lib/session-memory.js';
25
26
  const __filename = fileURLToPath(import.meta.url);
26
27
  const __dirname = path.dirname(__filename);
27
28
  const frameworkRoot = pkgRoot;
@@ -31,6 +32,37 @@ const root = isInsideFrameworkRepo(cwd)
31
32
  : (fs.existsSync(path.join(cwd, 'specs')) || fs.existsSync(path.join(cwd, 'package.json')))
32
33
  ? cwd
33
34
  : getWorkspaceRoot();
35
+ /** stdin do Claude Code: `{ session_id, source: startup|resume|clear|compact }`. Ausente → {}. */
36
+ function hookInput() {
37
+ if (process.stdin.isTTY)
38
+ return {}; // rodado à mão no terminal: não espera stdin
39
+ try {
40
+ return JSON.parse(fs.readFileSync(0, 'utf8') || '{}');
41
+ }
42
+ catch {
43
+ return {};
44
+ }
45
+ }
46
+ const CHECKPOINT_CAP = 3000;
47
+ /** SPEC-052: depois de compactar, o checkpoint da própria sessão; senão, onde a última parou. */
48
+ function sessionMemory(input) {
49
+ try {
50
+ if (input.source === 'compact' && input.session_id) {
51
+ const file = findCheckpoint(root, input.session_id);
52
+ if (!file)
53
+ return [];
54
+ const text = fs.readFileSync(file, 'utf8').replace(/<!--[\s\S]*?-->\n?/g, '').trim();
55
+ return ['', `Checkpoint desta sessão antes da compactação (${path.relative(root, file)}):`, text.slice(0, CHECKPOINT_CAP)];
56
+ }
57
+ if (input.source === 'clear')
58
+ return [];
59
+ const last = latestCheckpoint(root, input.session_id);
60
+ return last ? ['', `Última sessão: ${summarizeCheckpoint(last)} (${path.relative(root, last)})`] : [];
61
+ }
62
+ catch {
63
+ return [];
64
+ }
65
+ }
34
66
  /**
35
67
  * Nunca lança e nunca trava a sessão: o hook reporta, o `tools:doctor` é que é gate. Se a própria
36
68
  * lib de health não carregar, seguimos com o resto do briefing em vez de abortar (ADR-0021).
@@ -44,6 +76,7 @@ async function coreHealth() {
44
76
  }
45
77
  }
46
78
  (async function main() {
79
+ const input = hookInput();
47
80
  const specs = listSpecs(root);
48
81
  const health = await coreHealth();
49
82
  const problemas = health.filter((c) => c.status === 'fail' || c.status === 'warn');
@@ -79,6 +112,7 @@ async function coreHealth() {
79
112
  for (const h of handoffs)
80
113
  lines.push(` - #${h.id} ${h.from} → ${h.to} (${h.intent}) ${h.slug || ''}`);
81
114
  }
115
+ lines.push(...sessionMemory(input));
82
116
  lines.push('\nFluxo SDD: `forja spec:new|spec:plan|spec:tasks|spec:check <slug>` · próximo passo: `forja next`');
83
117
  lines.push('Handoff: `forja hermes:handoff \'<json ADR-0005>\'`');
84
118
  lines.push('</framework-status>');
@@ -14,6 +14,7 @@ import { buildContextPrompt, buildEngineerBlock } from '../lib/llm/context.js';
14
14
  import { normalizeCodexResult } from '../lib/llm/codex-output.js';
15
15
  import { normalizeClaudeResult } from '../lib/llm/claude-output.js';
16
16
  import { LlmSessionStore, RESUME_PROVIDERS, validSessionId } from '../lib/llm/session.js';
17
+ import { normalizeGeminiResult, normalizeCursorResult } from '../lib/llm/json-output.js';
17
18
  import { prepareValidation, validateLlmResponse } from '../lib/llm/validation.js';
18
19
  const profilePath = () => path.join(getWorkspaceContextDir(), 'llm-profiles.json');
19
20
  function usage() {
@@ -90,6 +91,23 @@ function doctor(name) {
90
91
  compatible = helpOk && ['--output-format', '--print'].every((flag) => help.stdout.includes(flag));
91
92
  features = { resume: helpOk && help.stdout.includes('--resume'), outputSchema: false };
92
93
  }
94
+ // Compatibilidade dos adapters de agente: a CLI precisa oferecer o modo somente leitura que o
95
+ // adapter usa. Ausente, o adapter rodaria com permissões que o Forja não pediu.
96
+ const HELP_FLAGS = {
97
+ 'gemini-cli': ['--approval-mode', '--output-format'],
98
+ 'cursor-agent': ['--print', '--mode', '--output-format'],
99
+ copilot: ['--prompt', '--silent'],
100
+ };
101
+ if (available && compatible === null && HELP_FLAGS[value.provider]) {
102
+ const help = spawnSync(value.command, ['--help'], { encoding: 'utf8', timeout: 10_000, shell: false });
103
+ compatible = !help.error && help.status === 0 && HELP_FLAGS[value.provider].every((flag) => help.stdout.includes(flag));
104
+ features = { resume: false, outputSchema: false };
105
+ }
106
+ else if (available && compatible === null && value.provider === 'opencode') {
107
+ const help = spawnSync(value.command, ['run', '--help'], { encoding: 'utf8', timeout: 10_000, shell: false });
108
+ compatible = !help.error && help.status === 0 && help.stdout.includes('--agent');
109
+ features = { resume: false, outputSchema: false };
110
+ }
93
111
  return { name: profileName, provider: value.provider, model: value.model, enabled: value.enabled, executable: value.command, available, compatible,
94
112
  features, modelAccess: 'not-probed', detail: errorCode ?? (probe.status === 0 ? String(probe.stdout).trim().split('\n')[0] : String(probe.stderr).trim().split('\n')[0]), pricing };
95
113
  });
@@ -154,7 +172,11 @@ async function run() {
154
172
  ? normalizeCodexResult(raw)
155
173
  : selected.provider === 'claude'
156
174
  ? normalizeClaudeResult(raw)
157
- : raw;
175
+ : selected.provider === 'gemini-cli'
176
+ ? normalizeGeminiResult(raw)
177
+ : selected.provider === 'cursor-agent'
178
+ ? normalizeCursorResult(raw)
179
+ : raw;
158
180
  if (result.sessionId !== undefined && (!validSessionId(result.sessionId) || (resume !== undefined && result.sessionId !== resume))) {
159
181
  result = { ...result, exitCode: result.exitCode || 1, errorCode: 'SESSION_MISMATCH', sessionId: undefined };
160
182
  }
@@ -0,0 +1,10 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * spec:trace — critérios de aceite × testes que os citam (SPEC-053, ADR-0092).
4
+ *
5
+ * forja spec:trace [slug] [--strict] [--json]
6
+ *
7
+ * Sem `--strict` só informa (exit 0). Com `--strict`, spec approved/implementing/done com critério
8
+ * sem teste ou citação órfã → exit 2 (`rejected`, ADR-0082).
9
+ */
10
+ export {};
@@ -0,0 +1,73 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * spec:trace — critérios de aceite × testes que os citam (SPEC-053, ADR-0092).
4
+ *
5
+ * forja spec:trace [slug] [--strict] [--json]
6
+ *
7
+ * Sem `--strict` só informa (exit 0). Com `--strict`, spec approved/implementing/done com critério
8
+ * sem teste ou citação órfã → exit 2 (`rejected`, ADR-0082).
9
+ */
10
+ import path from 'node:path';
11
+ import { emitError, emitOk, emitRejected } from '../lib/cli-output.js';
12
+ import { GATED_STATUSES, strictFailures, traceSpecs } from '../lib/spec-trace.js';
13
+ const args = process.argv.slice(2);
14
+ const json = args.includes('--json');
15
+ const strict = args.includes('--strict');
16
+ const slug = args.find((a) => !a.startsWith('--'));
17
+ const root = path.resolve(process.cwd());
18
+ const report = traceSpecs(root);
19
+ let specs = report.specs;
20
+ if (slug) {
21
+ specs = specs.filter((s) => s.slug === slug || s.specId === slug.toUpperCase());
22
+ if (!specs.length) {
23
+ if (json)
24
+ emitError(`spec não encontrada: ${slug}`, { code: 'NOT_FOUND' });
25
+ console.error(`spec não encontrada: ${slug} (veja specs/)`);
26
+ process.exit(1);
27
+ }
28
+ }
29
+ const withCriteria = specs.filter((s) => s.criteria.length);
30
+ const failures = strict ? strictFailures(withCriteria) : [];
31
+ const total = withCriteria.reduce((n, s) => n + s.criteria.length, 0);
32
+ const covered = withCriteria.reduce((n, s) => n + s.criteria.length - s.uncovered.length, 0);
33
+ const ambiguous = slug ? [] : report.ambiguous;
34
+ if (json) {
35
+ const payload = {
36
+ totals: { specs: withCriteria.length, criteria: total, covered, testFiles: report.testFiles },
37
+ specs: withCriteria,
38
+ ambiguous,
39
+ ...(strict ? { failing: failures.map((s) => s.slug) } : {}),
40
+ };
41
+ if (failures.length)
42
+ emitRejected(payload);
43
+ emitOk(payload);
44
+ }
45
+ const where = (r) => `${r.file}:${r.line}`;
46
+ function print(s) {
47
+ const n = s.criteria.length - s.uncovered.length;
48
+ const mark = n === s.criteria.length && !s.orphans.length ? '✓' : GATED(s) ? '✗' : '·';
49
+ console.log(`${mark} ${s.specId ?? '—'} ${s.slug} [${s.status}] — ${n}/${s.criteria.length} critérios com teste`);
50
+ for (const c of s.criteria) {
51
+ if (c.tests.length)
52
+ console.log(` ✓ ${c.id} ${c.tests.slice(0, 3).map(where).join(', ')}${c.tests.length > 3 ? ` (+${c.tests.length - 3})` : ''}`);
53
+ else
54
+ console.log(` ✗ ${c.id} sem teste — ${c.text.slice(0, 80)}`);
55
+ }
56
+ for (const o of s.orphans)
57
+ console.log(` ⚠ ${o.ac} não existe na spec, mas ${where(o.ref)} o cita`);
58
+ }
59
+ function GATED(s) { return GATED_STATUSES.has(s.status); }
60
+ if (!withCriteria.length) {
61
+ console.log(slug ? `${slug}: a spec não tem critérios AC-N.` : 'Nenhuma spec com critérios AC-N em specs/.');
62
+ process.exit(0);
63
+ }
64
+ for (const s of withCriteria)
65
+ print(s);
66
+ console.log(`\n${covered}/${total} critérios com teste em ${withCriteria.length} spec(s) · ${report.testFiles} arquivo(s) de teste lidos`);
67
+ if (ambiguous.length)
68
+ console.log(`${ambiguous.length} citação(ões) AC-N sem spec identificável (motivo em --json): qualifique com SPEC-NNN AC-N.`);
69
+ console.log('Para ligar um teste: cite `SPEC-NNN AC-N` no nome ou num comentário do teste.');
70
+ if (strict && failures.length) {
71
+ console.log(`\n✗ --strict: ${failures.length} spec(s) com "pronto" prometido e lacuna de rastreio: ${failures.map((s) => s.slug).join(', ')}`);
72
+ process.exit(2);
73
+ }