forjajs 4.1.2 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/.claude/settings.json +2 -2
  2. package/.gemini-instructions.md +1 -1
  3. package/.github/copilot-instructions.md +1 -1
  4. package/.openai-instructions.md +1 -1
  5. package/CHANGELOG.md +109 -0
  6. package/DOC-MAP.md +2 -2
  7. package/README.md +62 -10
  8. package/README.pt-BR.md +46 -7
  9. package/boilerplates/01-api-rest/README.md +1 -1
  10. package/boilerplates/06-clean-arch/README.md +5 -3
  11. package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
  12. package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
  13. package/boilerplates/06-clean-arch/backend/package.json +22 -24
  14. package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
  15. package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
  21. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
  22. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
  24. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
  26. package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
  27. package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
  28. package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
  29. package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
  30. package/boilerplates/README.md +24 -44
  31. package/dist/apps/cli/src/index.js +6 -6
  32. package/dist/apps/dashboard/next.config.d.mts +5 -5
  33. package/dist/apps/server/src/app.module.js +1 -1
  34. package/dist/apps/server/src/forja-nest.module.js +1 -1
  35. package/dist/apps/server/src/index.js +1 -1
  36. package/dist/apps/server/src/main.js +20 -20
  37. package/dist/apps/worker/src/main.js +4 -4
  38. package/dist/bin/create-memory-nest-kit.js +5 -5
  39. package/dist/bin/forja.js +28 -14
  40. package/dist/bin/init-project.d.ts +4 -9
  41. package/dist/bin/init-project.js +126 -182
  42. package/dist/lib/audit.js +1 -1
  43. package/dist/lib/context-builder.d.ts +6 -1
  44. package/dist/lib/context-builder.js +21 -12
  45. package/dist/lib/core/architecture-gate.js +2 -4
  46. package/dist/lib/core/checks.d.ts +1 -1
  47. package/dist/lib/core/drift-gate.js +2 -4
  48. package/dist/lib/core/gates.js +5 -5
  49. package/dist/lib/core/health.d.ts +0 -1
  50. package/dist/lib/core/health.js +33 -7
  51. package/dist/lib/core/journey.d.ts +30 -0
  52. package/dist/lib/core/journey.js +142 -0
  53. package/dist/lib/core/model-pricing.js +3 -5
  54. package/dist/lib/core/project-smoke.d.ts +6 -2
  55. package/dist/lib/core/project-smoke.js +60 -61
  56. package/dist/lib/core/registry.d.ts +1 -12
  57. package/dist/lib/core/registry.js +42 -32
  58. package/dist/lib/core/release.d.ts +1 -1
  59. package/dist/lib/core/release.js +31 -3
  60. package/dist/lib/core/risk-collect.js +4 -4
  61. package/dist/lib/drift-sentinel.js +1 -1
  62. package/dist/lib/generators/memory-generator.d.ts +30 -30
  63. package/dist/lib/generators/memory-generator.js +19 -8
  64. package/dist/lib/generators/nest-generator.js +192 -275
  65. package/dist/lib/generators/readme-generator.js +1 -1
  66. package/dist/lib/governance-report.js +4 -4
  67. package/dist/lib/handoffs-index.d.ts +16 -2
  68. package/dist/lib/handoffs-index.js +32 -5
  69. package/dist/lib/llm/session.js +1 -1
  70. package/dist/lib/llm/validation.js +1 -1
  71. package/dist/lib/memory-audit.js +1 -1
  72. package/dist/lib/paths.d.ts +39 -0
  73. package/dist/lib/paths.js +73 -0
  74. package/dist/lib/project-wiring.d.ts +54 -0
  75. package/dist/lib/project-wiring.js +391 -0
  76. package/dist/lib/status-model.js +18 -7
  77. package/dist/lib/templates.d.ts +24 -0
  78. package/dist/lib/templates.js +77 -0
  79. package/dist/lib/validators/structure-validator.js +0 -1
  80. package/dist/lib/workspace.d.ts +7 -0
  81. package/dist/lib/workspace.js +20 -2
  82. package/dist/packages/adapter-git/src/index.js +2 -2
  83. package/dist/packages/context/src/index.js +1 -1
  84. package/dist/packages/core/src/index.js +1 -1
  85. package/dist/packages/evals/src/index.js +1 -1
  86. package/dist/packages/events/src/index.js +1 -1
  87. package/dist/packages/graph/src/index.js +1 -1
  88. package/dist/packages/mcp/src/index.d.ts +1 -1
  89. package/dist/packages/observability/src/index.js +1 -1
  90. package/dist/packages/orchestration/src/index.js +1 -1
  91. package/dist/packages/planner/src/index.js +1 -1
  92. package/dist/packages/policy/src/index.js +1 -1
  93. package/dist/packages/runtime/src/index.js +1 -1
  94. package/dist/packages/sandbox/src/index.js +1 -1
  95. package/dist/packages/validator/src/index.js +1 -1
  96. package/dist/scripts/adr.js +4 -4
  97. package/dist/scripts/agent-harness.js +30 -23
  98. package/dist/scripts/agent-router.js +22 -5
  99. package/dist/scripts/agent.js +5 -5
  100. package/dist/scripts/architecture.js +6 -6
  101. package/dist/scripts/audit-query.js +1 -1
  102. package/dist/scripts/audit-sync.js +1 -1
  103. package/dist/scripts/build-smart-context.d.ts +19 -1
  104. package/dist/scripts/build-smart-context.js +84 -68
  105. package/dist/scripts/check-standards.js +8 -3
  106. package/dist/scripts/code-context.js +1 -1
  107. package/dist/scripts/compress-memory.js +3 -2
  108. package/dist/scripts/compress-project-memory.js +2 -2
  109. package/dist/scripts/context-ops.js +13 -5
  110. package/dist/scripts/cost-economy.js +4 -4
  111. package/dist/scripts/demo-autonomy.js +11 -11
  112. package/dist/scripts/demo-workspace.js +12 -4
  113. package/dist/scripts/dev.js +8 -7
  114. package/dist/scripts/drift-check.js +5 -5
  115. package/dist/scripts/engineer.js +11 -11
  116. package/dist/scripts/evidence.js +4 -4
  117. package/dist/scripts/extract-global-knowledge.js +6 -4
  118. package/dist/scripts/forja-setup.js +2 -1
  119. package/dist/scripts/forja-status.js +5 -4
  120. package/dist/scripts/gates.js +1 -1
  121. package/dist/scripts/generate-dashboard.js +6 -4
  122. package/dist/scripts/governance-dashboard.js +2 -2
  123. package/dist/scripts/hook-session-start.js +11 -10
  124. package/dist/scripts/hook-user-prompt.js +3 -2
  125. package/dist/scripts/incident.js +4 -4
  126. package/dist/scripts/llm-fit.js +11 -11
  127. package/dist/scripts/memory-audit.js +1 -1
  128. package/dist/scripts/memory-schema.js +3 -2
  129. package/dist/scripts/orchestrate.js +4 -5
  130. package/dist/scripts/project-smoke.js +13 -2
  131. package/dist/scripts/project-templates.d.ts +1 -0
  132. package/dist/scripts/project-templates.js +20 -0
  133. package/dist/scripts/project-upgrade.d.ts +13 -0
  134. package/dist/scripts/project-upgrade.js +107 -40
  135. package/dist/scripts/project-wire.d.ts +8 -0
  136. package/dist/scripts/project-wire.js +55 -0
  137. package/dist/scripts/provenance.js +3 -3
  138. package/dist/scripts/query-universal-memory.js +7 -4
  139. package/dist/scripts/release-check.js +1 -1
  140. package/dist/scripts/risk.js +4 -4
  141. package/dist/scripts/simulate.js +9 -9
  142. package/dist/scripts/spec-cli.d.ts +1 -0
  143. package/dist/scripts/spec-cli.js +25 -5
  144. package/dist/scripts/sprint-manager.js +4 -3
  145. package/dist/scripts/sync-universal-memory.js +22 -15
  146. package/dist/scripts/token-benchmark.js +4 -3
  147. package/dist/scripts/token-economy.js +4 -3
  148. package/dist/scripts/tools-doctor.d.ts +1 -1
  149. package/dist/scripts/tools-doctor.js +25 -3
  150. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  151. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  152. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  153. package/docs/glossary.md +4 -4
  154. package/docs/init-project.md +88 -444
  155. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  156. package/docs/modos-de-operacao.md +1 -1
  157. package/docs/processo-projeto.md +14 -11
  158. package/docs/produto/roteiro-demo.md +15 -18
  159. package/docs/publishing.md +5 -0
  160. package/docs/quick-reference.md +15 -23
  161. package/docs/structure.md +16 -30
  162. package/lib/core/model-pricing.json +19 -0
  163. package/memory/30-projects/README.md +1 -1
  164. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  165. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  166. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  167. package/memory/90-decisions/0088-templates-validados.md +55 -0
  168. package/package.json +25 -25
  169. package/templates/project/AGENTS.md +75 -0
  170. package/templates/project/CLAUDE.md +9 -0
  171. package/templates/project/agents/context-engineer.md +15 -0
  172. package/templates/project/agents/governance.md +15 -0
  173. package/templates/project/agents/marketing.md +15 -0
  174. package/templates/project/agents/orchestrator.md +15 -0
  175. package/templates/project/agents/product.md +15 -0
  176. package/templates/project/agents/sdd-architect.md +15 -0
  177. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  178. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -1,5 +1,5 @@
1
1
  import { createHash, randomUUID } from 'node:crypto';
2
- import { CONTRACT_VERSION, } from "../../contracts/src/index.js";
2
+ import { CONTRACT_VERSION, } from '../../contracts/src/index.js';
3
3
  export class GraphError extends Error {
4
4
  constructor(message) {
5
5
  super(message);
@@ -69,7 +69,7 @@ export interface McpAuditEvent {
69
69
  export interface McpAuditSink {
70
70
  append(event: McpAuditEvent): void | Promise<void>;
71
71
  }
72
- export declare const MCP_RESOURCE_URIS: readonly ["forja://workspace/current", "forja://project/current", "forja://specs", "forja://decisions", "forja://graph", "forja://agent/agenda", "forja://executions"];
72
+ export declare const MCP_RESOURCE_URIS: readonly ['forja://workspace/current', 'forja://project/current', 'forja://specs', 'forja://decisions', 'forja://graph', 'forja://agent/agenda', 'forja://executions'];
73
73
  export type McpResourceUri = typeof MCP_RESOURCE_URIS[number];
74
74
  export interface McpServerDependencies {
75
75
  readonly registry: CapabilityRegistry;
@@ -1,5 +1,5 @@
1
1
  import { randomUUID } from 'node:crypto';
2
- import { CONTRACT_VERSION } from "../../contracts/src/index.js";
2
+ import { CONTRACT_VERSION } from '../../contracts/src/index.js';
3
3
  export class ObservabilityError extends Error {
4
4
  constructor(message) { super(message); this.name = 'ObservabilityError'; }
5
5
  }
@@ -1,5 +1,5 @@
1
1
  import { randomUUID } from 'node:crypto';
2
- import { CONTRACT_VERSION, validateTokenBudget, } from "../../contracts/src/index.js";
2
+ import { CONTRACT_VERSION, validateTokenBudget, } from '../../contracts/src/index.js';
3
3
  export class OrchestrationError extends Error {
4
4
  constructor(message) {
5
5
  super(message);
@@ -1,5 +1,5 @@
1
1
  import { createHash } from 'node:crypto';
2
- import { CONTRACT_VERSION, validateTokenBudget, } from "../../contracts/src/index.js";
2
+ import { CONTRACT_VERSION, validateTokenBudget, } from '../../contracts/src/index.js';
3
3
  export class PlannerError extends Error {
4
4
  constructor(message) {
5
5
  super(message);
@@ -1,5 +1,5 @@
1
1
  import { randomUUID } from 'node:crypto';
2
- import { CONTRACT_VERSION, isPathWithinRoot, } from "../../contracts/src/index.js";
2
+ import { CONTRACT_VERSION, isPathWithinRoot, } from '../../contracts/src/index.js';
3
3
  export class PolicyError extends Error {
4
4
  constructor(message) {
5
5
  super(message);
@@ -1,5 +1,5 @@
1
1
  import { createHash, randomUUID } from 'node:crypto';
2
- import { CONTRACT_VERSION, validateTokenBudget, } from "../../contracts/src/index.js";
2
+ import { CONTRACT_VERSION, validateTokenBudget, } from '../../contracts/src/index.js';
3
3
  const DEFAULT_LIMITS = {
4
4
  maxSteps: 20,
5
5
  maxTokens: 10000,
@@ -1,5 +1,5 @@
1
1
  import { createHash, randomUUID } from 'node:crypto';
2
- import { CONTRACT_VERSION, } from "../../contracts/src/index.js";
2
+ import { CONTRACT_VERSION, } from '../../contracts/src/index.js';
3
3
  export class SandboxError extends Error {
4
4
  constructor(message) { super(message); this.name = 'SandboxError'; }
5
5
  }
@@ -1,4 +1,4 @@
1
- import { CONTRACT_VERSION, } from "../../contracts/src/index.js";
1
+ import { CONTRACT_VERSION, } from '../../contracts/src/index.js';
2
2
  export class ValidatorError extends Error {
3
3
  constructor(message) {
4
4
  super(message);
@@ -17,10 +17,10 @@
17
17
  import fs from 'node:fs';
18
18
  import path from 'node:path';
19
19
  import Database from 'better-sqlite3';
20
- import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
21
- import { GraphIndexer, 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";
20
+ import { GitGraphDocumentSource, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
21
+ import { GraphIndexer, 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
24
  function normalizeAdrId(raw) {
25
25
  const digits = /(\d{4})/.exec(raw)?.[1];
26
26
  return digits === undefined ? raw : `ADR-${digits}`;
@@ -3,14 +3,14 @@ import fs from 'node:fs';
3
3
  import path from 'node:path';
4
4
  import { spawnSync } from 'node:child_process';
5
5
  import { fileURLToPath } from 'node:url';
6
- import { initWorkspace, getWorkspaceInfo, listProjects, resolveProject, getWorkspaceProjectsMemoryDir, } from "../lib/workspace.js";
7
- import { resolveScript } from "../lib/core/registry.js";
8
- import { isPathWithinRoot } from "../packages/contracts/src/index.js";
6
+ import { initWorkspace, getWorkspaceInfo, listProjects, resolveProject, getWorkspaceProjectsMemoryDir, } from '../lib/workspace.js';
7
+ import { isPathWithinRoot } from '../packages/contracts/src/index.js';
8
+ import { pkgRoot, script } from '../lib/paths.js';
9
9
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
10
10
  // `root` = recursos do FRAMEWORK (ex.: design:* lê design-md/) — resolvidos por __dirname.
11
11
  // `projectRoot` = o PROJETO do usuário (gsd:* opera em specs/ e .context/ dele) — onde foi invocado.
12
12
  // Sem essa separação o gsd escrevia no PACOTE no consumidor (classe spec-cli v1.6.2/check-standards v1.7.1).
13
- const root = path.resolve(__dirname, '..');
13
+ const root = pkgRoot;
14
14
  const projectRoot = process.cwd();
15
15
  const DESIGN_REQUIRED = [
16
16
  'Feature/superficie',
@@ -85,15 +85,17 @@ function readText(file) {
85
85
  return fs.readFileSync(full, 'utf8');
86
86
  }
87
87
  // --- Codegraph (ADR-0017): code intelligence como gate do GSD ---
88
+ // O índice é do código ONDE o usuário está (projeto ou repo do framework) — com `cwd: root`, um
89
+ // `code:impact` dentro de um projeto analisava o código do pacote do Forja.
88
90
  function runCodegraph(args) {
89
- const result = spawnSync('codegraph', args, { cwd: root, encoding: 'utf8' });
91
+ const result = spawnSync('codegraph', args, { cwd: process.cwd(), encoding: 'utf8' });
90
92
  if (result.error && result.error.code === 'ENOENT') {
91
93
  return { missing: true };
92
94
  }
93
95
  if (result.error && result.error.code === 'EPERM') {
94
96
  const quote = (value) => `'${String(value).replace(/'/g, `'\\''`)}'`;
95
97
  const fallback = spawnSync('/bin/sh', ['-lc', ['codegraph', ...args.map(quote)].join(' ')], {
96
- cwd: root,
98
+ cwd: process.cwd(),
97
99
  encoding: 'utf8',
98
100
  });
99
101
  return {
@@ -178,7 +180,7 @@ function cmdCodeCheck() {
178
180
  }
179
181
  function cmdCodeImpact([symbol, depthArg]) {
180
182
  if (!symbol)
181
- fail('Uso: agent-harness code:impact <simbolo> [profundidade]');
183
+ fail('Uso: forja code:impact <simbolo> [profundidade]');
182
184
  // `symbol` vira um elemento de argv passado direto para o binário `codegraph` — não há shell
183
185
  // envolvido no caminho normal, então não é injeção de comando, mas um valor começando com `-`
184
186
  // ainda pode ser lido como flag pelo `codegraph` em vez de símbolo posicional (injeção de
@@ -211,7 +213,7 @@ function cmdCodeImpact([symbol, depthArg]) {
211
213
  }
212
214
  function cmdDesignCheck([briefPath]) {
213
215
  if (!briefPath)
214
- fail('Uso: agent-harness design:check <brief.md>');
216
+ fail('Uso: forja design:check <brief.md>');
215
217
  const content = readText(briefPath);
216
218
  const missing = DESIGN_REQUIRED.filter((needle) => !content.includes(needle));
217
219
  const placeholders = (content.match(/<[^>\n]+>/g) || []).length;
@@ -243,7 +245,7 @@ function cmdDesignSelect([surface = 'agent-console', tone = 'tecnico']) {
243
245
  }
244
246
  function cmdHermesHandoff([jsonArg]) {
245
247
  if (!jsonArg)
246
- fail('Uso: agent-harness hermes:handoff \'<json ADR-0005>\'');
248
+ fail('Uso: forja hermes:handoff \'<json ADR-0005>\'');
247
249
  let payload;
248
250
  try {
249
251
  payload = JSON.parse(jsonArg);
@@ -255,9 +257,11 @@ function cmdHermesHandoff([jsonArg]) {
255
257
  const missing = required.filter((field) => !payload[field] || typeof payload[field] !== 'string');
256
258
  if (missing.length)
257
259
  fail(`Campos ADR-0005 ausentes: ${missing.join(', ')}`);
258
- const router = resolveScript(root, 'scripts/agent-router.mjs');
260
+ const router = script('scripts/agent-router.mjs');
261
+ // cwd do usuário: o router carimba o projeto e resolve o banco a partir dele. Com `cwd: root`
262
+ // (o pacote), todo handoff de produto entrava como handoff do framework.
259
263
  const result = spawnSync(process.execPath, [router, 'append', JSON.stringify(payload)], {
260
- cwd: root,
264
+ cwd: process.cwd(),
261
265
  encoding: 'utf8',
262
266
  });
263
267
  if (result.stdout)
@@ -267,9 +271,11 @@ function cmdHermesHandoff([jsonArg]) {
267
271
  process.exit(result.status ?? 1);
268
272
  }
269
273
  function appendHandoff(payload) {
270
- const router = resolveScript(root, 'scripts/agent-router.mjs');
274
+ const router = script('scripts/agent-router.mjs');
275
+ // cwd do usuário: o router carimba o projeto e resolve o banco a partir dele. Com `cwd: root`
276
+ // (o pacote), todo handoff de produto entrava como handoff do framework.
271
277
  const result = spawnSync(process.execPath, [router, 'append', JSON.stringify(payload)], {
272
- cwd: root,
278
+ cwd: process.cwd(),
273
279
  encoding: 'utf8',
274
280
  });
275
281
  if (result.stdout)
@@ -327,7 +333,7 @@ function cmdGsdPlan([slug = 'run', ...goalParts]) {
327
333
  }
328
334
  function cmdGsdHandoff([phase, slug, ...contextParts]) {
329
335
  if (!phase || !slug)
330
- fail('Uso: agent-harness gsd:handoff <spec|plan|implement|review> <slug> [contexto]');
336
+ fail('Uso: forja gsd:handoff <spec|plan|implement|review> <slug> [contexto]');
331
337
  const template = GSD_HANDOFFS[phase];
332
338
  if (!template)
333
339
  fail(`Fase invalida: ${phase}. Use: ${Object.keys(GSD_HANDOFFS).join('|')}`);
@@ -349,7 +355,7 @@ function cmdGsdHandoff([phase, slug, ...contextParts]) {
349
355
  }
350
356
  function cmdGsdCheck([slug, briefPath]) {
351
357
  if (!slug)
352
- fail('Uso: agent-harness gsd:check <slug> [brief.md]');
358
+ fail('Uso: forja gsd:check <slug> [brief.md]');
353
359
  const safeSlug = slug.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
354
360
  const checks = [];
355
361
  const runbook = path.join(projectRoot, '.context', `gsd-${safeSlug}.md`);
@@ -367,7 +373,7 @@ function cmdGsdCheck([slug, briefPath]) {
367
373
  // O spec:check tem de rodar no PROJETO do usuário (cwd), não no pacote, e resolver o script pela
368
374
  // extensão certa (`.ts` no dev, `.js` no dist publicado). Cravar `cwd: root` + `scripts/spec-cli.mjs`
369
375
  // auditava/carregava o pacote no consumidor (mesma classe spec-cli v1.6.2).
370
- const specCli = resolveScript(root, 'scripts/spec-cli');
376
+ const specCli = script('scripts/spec-cli');
371
377
  const specCheck = spawnSync(process.execPath, [specCli, 'check', safeSlug], {
372
378
  cwd: projectRoot,
373
379
  encoding: 'utf8',
@@ -437,19 +443,19 @@ function cmdWorkspaceInit() {
437
443
  console.log(` ${path.join(rootDir, 'specs')}`);
438
444
  console.log(` ${path.join(rootDir, '.context')}`);
439
445
  if (!infoBefore.exists) {
440
- console.log('\nPróximo passo: npm run dev -- project:new <nome>');
446
+ console.log('\nPróximo passo: forja project:new <nome>');
441
447
  }
442
448
  }
443
449
  function cmdProjectNew([name, ...rest]) {
444
450
  if (!name)
445
- fail('Uso: agent-harness project:new <nome> [--ai claude,copilot] [--skip-backend]');
451
+ fail('Uso: forja project:new <nome> [--ai claude,copilot] [--skip-backend]');
446
452
  const safeName = name.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
447
453
  const projectDir = resolveProject(safeName);
448
454
  if (fs.existsSync(projectDir)) {
449
455
  fail(`Projeto ja existe no workspace: ${projectDir}`);
450
456
  }
451
- // Repassa flags para init-project.js
452
- const result = spawnSync('node', [path.join(root, 'bin/init-project.js'), safeName, ...rest], {
457
+ // Repassa flags para o gerador (script() acha .ts em dev e .js publicado)
458
+ const result = spawnSync('node', [script('bin/init-project'), safeName, ...rest], {
453
459
  cwd: root,
454
460
  encoding: 'utf8',
455
461
  stdio: 'inherit',
@@ -501,8 +507,8 @@ function cmdProjectList() {
501
507
  }
502
508
  function cmdProjectCheck([name]) {
503
509
  if (!name)
504
- fail('Uso: agent-harness project:check <nome>');
505
- const result = spawnSync('node', [path.join(root, 'scripts/check-standards.js'), name], {
510
+ fail('Uso: forja workspace:project:check <nome>');
511
+ const result = spawnSync('node', [script('scripts/check-standards'), name], {
506
512
  cwd: root,
507
513
  encoding: 'utf8',
508
514
  stdio: 'inherit',
@@ -510,7 +516,8 @@ function cmdProjectCheck([name]) {
510
516
  process.exit(result.status ?? 1);
511
517
  }
512
518
  function showHelp() {
513
- console.log(`Uso: node scripts/agent-harness.mjs <command> [args]
519
+ console.log(`Script interno do Forja — use os comandos via core: forja help --all
520
+
514
521
 
515
522
  Workspace:
516
523
  workspace:init Cria estrutura base do workspace Forja
@@ -32,10 +32,12 @@ import path from 'node:path';
32
32
  import process from 'node:process';
33
33
  import { fileURLToPath } from 'node:url';
34
34
  import Database from 'better-sqlite3';
35
- import { getDbPath, ensureSchema } from "./memory-schema.js";
35
+ import { getDbPath, ensureSchema } from './memory-schema.js';
36
+ import { pkgRoot } from '../lib/paths.js';
37
+ import { currentProjectName } from '../lib/workspace.js';
36
38
  const __filename = fileURLToPath(import.meta.url);
37
39
  const __dirname = path.dirname(__filename);
38
- const root = path.resolve(__dirname, '..');
40
+ const root = pkgRoot;
39
41
  ensureSchema({ silent: true });
40
42
  const dbPath = getDbPath();
41
43
  const REQUIRED = ['from', 'to', 'intent', 'context', 'acceptance', 'constraints', 'return'];
@@ -118,6 +120,12 @@ function parsePayload(raw) {
118
120
  function cmdAppend(arg) {
119
121
  const raw = arg && arg !== '-' ? arg : readStdin();
120
122
  const h = parsePayload(raw);
123
+ // Carimba o projeto de origem (no payload, sem migração de schema) para o briefing filtrar.
124
+ if (!h.project) {
125
+ const p = currentProjectName();
126
+ if (p)
127
+ h.project = p;
128
+ }
121
129
  const db = openDb();
122
130
  const stmt = db.prepare(`
123
131
  INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, payload_json)
@@ -133,20 +141,29 @@ function cmdList(args) {
133
141
  const params = [];
134
142
  if (args.includes('--open'))
135
143
  filters.push("status = 'open'");
144
+ // --project <nome> filtra pelo carimbo; --mine = o projeto do cwd (ou o framework).
145
+ const projIdx = args.indexOf('--project');
146
+ const project = projIdx >= 0 ? args[projIdx + 1] : args.includes('--mine') ? currentProjectName() : null;
147
+ if ((projIdx >= 0 || args.includes('--mine')) && !project)
148
+ fail('--mine fora de um projeto: rode dentro dele ou use --project <nome>');
149
+ if (project) {
150
+ filters.push("json_extract(payload_json, '$.project') = ?");
151
+ params.push(project);
152
+ }
136
153
  const toIdx = args.indexOf('--to');
137
154
  if (toIdx >= 0 && args[toIdx + 1]) {
138
155
  filters.push('to_agent = ?');
139
156
  params.push(args[toIdx + 1]);
140
157
  }
141
158
  const where = filters.length ? `WHERE ${filters.join(' AND ')}` : '';
142
- const rows = db.prepare(`SELECT id, created_at, from_agent, to_agent, intent, status, spec_slug FROM handoffs ${where} ORDER BY id DESC LIMIT 50`).all(...params);
159
+ const rows = db.prepare(`SELECT id, created_at, from_agent, to_agent, intent, status, spec_slug, json_extract(payload_json, '$.project') AS project FROM handoffs ${where} ORDER BY id DESC LIMIT 50`).all(...params);
143
160
  if (!rows.length) {
144
161
  console.log('(sem handoffs)');
145
162
  db.close();
146
163
  return;
147
164
  }
148
165
  for (const r of rows) {
149
- console.log(`#${r.id} [${r.status}] ${r.from_agent} → ${r.to_agent} (${r.intent}) ${r.spec_slug || ''} — ${r.created_at}`);
166
+ console.log(`#${r.id} [${r.status}] ${r.project ? `{${r.project}} ` : '{sem projeto} '}${r.from_agent} → ${r.to_agent} (${r.intent}) ${r.spec_slug || ''} — ${r.created_at}`);
150
167
  }
151
168
  db.close();
152
169
  }
@@ -203,6 +220,6 @@ switch (subcmd) {
203
220
  cmdSchema();
204
221
  break;
205
222
  default:
206
- console.log('Uso: agent-router <append|list|show|done|in_progress|cancel|archive|schema> [args]');
223
+ console.log('Uso: forja agent:route <append|list [--open] [--mine|--project <nome>] [--to <papel>]|show|done|in_progress|cancel|archive|schema> [args]');
207
224
  process.exit(1);
208
225
  }
@@ -26,11 +26,11 @@
26
26
  */
27
27
  import fs from 'node:fs';
28
28
  import Database from 'better-sqlite3';
29
- import { computeReputationScore, recommendAgent } from "../packages/engineering/identity/src/index.js";
30
- import { detectAnomaly } from "../packages/engineering/monitoring/src/index.js";
31
- import { EvaluationEngine } from "../packages/evals/src/index.js";
32
- import { SqliteAgentProfileStore, SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
33
- import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
29
+ import { computeReputationScore, recommendAgent } from '../packages/engineering/identity/src/index.js';
30
+ import { detectAnomaly } from '../packages/engineering/monitoring/src/index.js';
31
+ import { EvaluationEngine } from '../packages/evals/src/index.js';
32
+ import { SqliteAgentProfileStore, SqliteMigrationRunner, SqliteObservationStore } from '../packages/adapter-sqlite/src/index.js';
33
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
34
34
  function flag(args, name) {
35
35
  const index = args.indexOf(name);
36
36
  return index === -1 ? undefined : args[index + 1];
@@ -16,12 +16,12 @@
16
16
  import fs from 'node:fs';
17
17
  import path from 'node:path';
18
18
  import Database from 'better-sqlite3';
19
- import { checkConstitution, compileConstitution, explainRule } from "../packages/engineering/architecture/src/index.js";
20
- import { ApprovalLedger } from "../packages/policy/src/index.js";
21
- import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
22
- import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
23
- import { SqliteApprovalStore, SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
24
- import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
19
+ import { checkConstitution, compileConstitution, explainRule } from '../packages/engineering/architecture/src/index.js';
20
+ import { ApprovalLedger } from '../packages/policy/src/index.js';
21
+ import { GitGraphDocumentSource, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
22
+ import { GraphIndexer, GraphLoop } from '../packages/graph/src/index.js';
23
+ import { SqliteApprovalStore, SqliteGraphStore, SqliteMigrationRunner } from '../packages/adapter-sqlite/src/index.js';
24
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
25
25
  const CONSTITUTION_PATH = '.context/architecture/constitution.json';
26
26
  function graphRoot() {
27
27
  return process.env.FORJA_GRAPH_ROOT ?? process.cwd();
@@ -5,7 +5,7 @@
5
5
  * forja audit:query --cmd release:check por comando
6
6
  * forja audit:query --since 7d janela de tempo (Nd/Nh/Nm)
7
7
  */
8
- import { queryAudit, defaultEnv } from "../lib/audit.js";
8
+ import { queryAudit, defaultEnv } from '../lib/audit.js';
9
9
  function parseArgs(argv) {
10
10
  const o = {};
11
11
  for (let i = 0; i < argv.length; i += 1) {
@@ -3,7 +3,7 @@
3
3
  * audit:sync — projeta o `.context/forja-runs.jsonl` na tabela consultável `audit_runs` (SPEC-014).
4
4
  * Idempotente. O `.jsonl` segue sendo a fonte de verdade; esta tabela é reconstruível.
5
5
  */
6
- import { syncAudit, defaultEnv } from "../lib/audit.js";
6
+ import { syncAudit, defaultEnv } from '../lib/audit.js';
7
7
  try {
8
8
  const r = await syncAudit(defaultEnv());
9
9
  if (r.total === 0) {
@@ -1 +1,19 @@
1
- export {};
1
+ /**
2
+ * forja context:smart — pack de contexto mínimo-suficiente nos 3 modos da ADR-0003.
3
+ *
4
+ * forja context:smart global (missão, padrões, ADRs)
5
+ * forja context:smart --mode domain + visão/design/regras do projeto
6
+ * forja context:smart --mode task --task pix + nós do projeto que casam com a tarefa (FTS5)
7
+ * forja context:smart <projeto> [keyword] forma posicional antiga (studio) — ainda aceita
8
+ *
9
+ * O projeto é inferido de onde o comando roda: no modo embedded é o próprio projeto; no studio,
10
+ * o projeto do workspace em que o cwd está. A lógica de montagem vive em lib/context-builder.ts —
11
+ * este script só resolve argumentos, projeto e destino. Antes da v5 o comando apontava para um
12
+ * script que ignorava `--mode` e exigia `<projeto>`, embora o help prometesse os três modos.
13
+ */
14
+ export declare function parseArgs(argv: readonly string[]): {
15
+ mode?: string;
16
+ task?: string;
17
+ project?: string;
18
+ positional: string[];
19
+ };
@@ -1,75 +1,91 @@
1
+ /**
2
+ * forja context:smart — pack de contexto mínimo-suficiente nos 3 modos da ADR-0003.
3
+ *
4
+ * forja context:smart global (missão, padrões, ADRs)
5
+ * forja context:smart --mode domain + visão/design/regras do projeto
6
+ * forja context:smart --mode task --task pix + nós do projeto que casam com a tarefa (FTS5)
7
+ * forja context:smart <projeto> [keyword] forma posicional antiga (studio) — ainda aceita
8
+ *
9
+ * O projeto é inferido de onde o comando roda: no modo embedded é o próprio projeto; no studio,
10
+ * o projeto do workspace em que o cwd está. A lógica de montagem vive em lib/context-builder.ts —
11
+ * este script só resolve argumentos, projeto e destino. Antes da v5 o comando apontava para um
12
+ * script que ignorava `--mode` e exigia `<projeto>`, embora o help prometesse os três modos.
13
+ */
1
14
  import fs from 'node:fs';
2
15
  import path from 'node:path';
3
- import Database from 'better-sqlite3';
4
- import { getDbPath, ensureSchema } from "./memory-schema.js";
5
- import { resolveProject, initWorkspace } from "../lib/workspace.js";
6
- initWorkspace();
7
- ensureSchema({ silent: true });
8
- const dbPath = getDbPath();
9
- const [project, taskKeyword = ''] = process.argv.slice(2);
10
- if (!project) {
11
- console.log('Uso: node scripts/build-smart-context.js <projeto> [keyword]');
12
- process.exit(0);
16
+ import { ContextBuilder } from '../lib/context-builder.js';
17
+ import { getDbPath, ensureSchema } from './memory-schema.js';
18
+ import { getForjaMode, getProjectsDir, getWorkspaceContextDir, getWorkspaceRoot, initWorkspace, resolveProject } from '../lib/workspace.js';
19
+ const MODES = ['global', 'domain', 'task'];
20
+ function fail(msg) {
21
+ console.error(msg);
22
+ console.error('Uso: forja context:smart [--mode global|domain|task] [--task <termo>] [--project <nome>]');
23
+ process.exit(1);
13
24
  }
14
- const db = new Database(dbPath, { readonly: true });
15
- function getSmartContext() {
16
- console.log(`🔍 Construindo contexto inteligente para: ${project} (Busca: ${taskKeyword || 'global'})...`);
17
- // 1. Pegar arquivos globais obrigatórios
18
- const globalNodes = db.prepare(`
19
- SELECT title, content, path FROM memory_nodes
20
- WHERE project_id IS NULL AND (path LIKE '%mission.md' OR path LIKE '%standards.md')
21
- `).all();
22
- // 2. Pegar arquivos do projeto por keyword ou gerais
23
- let projectNodes = [];
24
- if (taskKeyword) {
25
- projectNodes = db.prepare(`
26
- SELECT n.title, n.content, n.path
27
- FROM memory_nodes n
28
- JOIN projects p ON p.id = n.project_id
29
- JOIN search_idx s ON s.node_id = n.id
30
- WHERE p.name = ? AND search_idx MATCH ?
31
- LIMIT 10
32
- `).all(project, taskKeyword);
25
+ export function parseArgs(argv) {
26
+ const opts = { positional: [] };
27
+ for (let i = 0; i < argv.length; i++) {
28
+ const a = argv[i];
29
+ const val = () => { const v = argv[++i]; if (v === undefined || v.startsWith('--'))
30
+ fail(`${a} exige um valor`); return v; };
31
+ if (a === '--mode')
32
+ opts.mode = val();
33
+ else if (a === '--task' || a === '--domain' || a === '--keyword')
34
+ opts.task = val();
35
+ else if (a === '--project')
36
+ opts.project = val();
37
+ else if (a.startsWith('--'))
38
+ fail(`Opção desconhecida: ${a}`);
39
+ else
40
+ opts.positional.push(a);
33
41
  }
34
- // 3. Pegar ADRs e Summaries recentes do projeto
35
- const metadata = db.prepare(`
36
- SELECT n.title, n.content, n.path
37
- FROM memory_nodes n
38
- JOIN projects p ON p.id = n.project_id
39
- WHERE p.name = ? AND (n.kind = 'adr' OR n.kind = 'summary' OR n.path LIKE '%vision.md')
40
- ORDER BY n.updated_at DESC LIMIT 5
41
- `).all(project);
42
- const designIndex = db.prepare(`
43
- SELECT n.title, n.content, n.path
44
- FROM memory_nodes n
45
- JOIN projects p ON p.id = n.project_id
46
- WHERE p.name = ? AND n.kind = 'design' AND n.path LIKE '%/design-md/INDEX.md'
47
- ORDER BY n.updated_at DESC LIMIT 1
48
- `).all(project);
49
- const allNodes = [...globalNodes, ...projectNodes, ...metadata, ...designIndex];
50
- let contextPack = `# SMART CONTEXT PACK: ${project.toUpperCase()}\n\n`;
51
- contextPack += `> Gerado em: ${new Date().toISOString()}\n`;
52
- contextPack += `> Keyword de Tarefa: ${taskKeyword || 'N/A'}\n\n`;
53
- const seen = new Set();
54
- for (const node of allNodes) {
55
- if (seen.has(node.path))
56
- continue;
57
- seen.add(node.path);
58
- contextPack += `## FILE: ${node.path}\n\n${node.content}\n\n---\n\n`;
59
- }
60
- const outDir = path.join(resolveProject(project), '.context');
61
- if (!fs.existsSync(outDir))
62
- fs.mkdirSync(outDir, { recursive: true });
63
- const outFile = path.join(outDir, 'smart-context.md');
64
- fs.writeFileSync(outFile, contextPack, 'utf8');
65
- console.log(`✅ Contexto inteligente gerado: ${outFile} (${seen.size} arquivos incluídos).`);
66
- }
67
- try {
68
- getSmartContext();
42
+ return opts;
69
43
  }
70
- catch (e) {
71
- console.error('Erro ao gerar contexto inteligente:', e.message);
44
+ /** Projeto do workspace que contém `cwd` (studio), ou null. */
45
+ function projectFromCwd(cwd) {
46
+ const rel = path.relative(getProjectsDir(), cwd);
47
+ if (!rel || rel.startsWith('..') || path.isAbsolute(rel))
48
+ return null;
49
+ return rel.split(path.sep)[0] || null;
72
50
  }
73
- finally {
74
- db.close();
51
+ function main() {
52
+ const opts = parseArgs(process.argv.slice(2));
53
+ const embedded = getForjaMode() === 'embedded';
54
+ const [posProject, posKeyword] = opts.positional;
55
+ const project = opts.project
56
+ ?? (embedded ? path.basename(getWorkspaceRoot()) : posProject ?? projectFromCwd(process.cwd()))
57
+ ?? null;
58
+ const keyword = opts.task ?? (embedded ? posProject : posKeyword) ?? '';
59
+ const mode = (opts.mode ?? (keyword ? 'task' : project ? 'domain' : 'global'));
60
+ if (!MODES.includes(mode))
61
+ fail(`Modo inválido: ${mode} (use ${MODES.join(' | ')})`);
62
+ if (mode === 'task' && !keyword)
63
+ fail('Modo task exige --task <termo>.');
64
+ if (mode !== 'global' && !project)
65
+ fail('Modos domain/task exigem um projeto: rode dentro dele ou passe --project <nome>.');
66
+ initWorkspace();
67
+ ensureSchema({ silent: true });
68
+ const builder = new ContextBuilder(process.cwd(), getDbPath());
69
+ try {
70
+ const content = builder.build(mode, project ?? 'global', keyword);
71
+ const outDir = embedded
72
+ ? path.join(getWorkspaceRoot(), '.context')
73
+ : project ? path.join(resolveProject(project), '.context') : getWorkspaceContextDir();
74
+ if (!embedded && project && !fs.existsSync(resolveProject(project)))
75
+ fail(`Projeto não encontrado no workspace: ${project}`);
76
+ const outFile = path.join(outDir, 'smart-context.md');
77
+ builder.save(content, outFile);
78
+ const files = (content.match(/^\*\*Path\*\*:/gm) || []).length;
79
+ console.log(`✓ contexto ${mode}${keyword ? ` ("${keyword}")` : ''}${project ? ` de ${project}` : ''}: ${outFile}`);
80
+ console.log(` ${files} arquivo(s) · ~${Math.round(content.length / 4)} tokens`);
81
+ if (files === 0)
82
+ console.log(' nada indexado ainda — rode: forja sync:universal');
83
+ }
84
+ catch (e) {
85
+ fail(`Erro ao gerar contexto: ${e.message}`);
86
+ }
87
+ finally {
88
+ builder.close();
89
+ }
75
90
  }
91
+ main();
@@ -1,13 +1,17 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
- import { resolveProject, getWorkspaceInfo, initWorkspace } from "../lib/workspace.js";
3
+ import { resolveProject, getWorkspaceInfo, initWorkspace, isInsideFrameworkRepo } from '../lib/workspace.js';
4
4
  // O projeto a auditar é ONDE O USUÁRIO INVOCOU — `process.cwd()`, propagado pelo dispatcher desde a
5
5
  // v1.6.2. Cravar `__dirname/..` auditava a raiz do PACOTE (`node_modules/forjajs/dist`) no consumidor
6
6
  // e reportava tudo como faltando (bug da v1.7.0, mesma classe do spec-cli). No repo do framework,
7
7
  // invoca-se da raiz, então cwd = a raiz do framework — comportamento inalterado.
8
8
  const root = process.cwd();
9
9
  const [projectArg] = process.argv.slice(2);
10
- const project = projectArg || 'framework-root';
10
+ // Sem argumento: o repo do framework usa a lista do motor; qualquer outro cwd é um projeto. Antes
11
+ // todo cwd sem argumento era tratado como "FRAMEWORK-ROOT" — um projeto recém-gerado tirava 64% e
12
+ // falhava por arquivos (gsd-harness.md, specs/README.md) que só existem no repo do framework.
13
+ const isFramework = !projectArg && isInsideFrameworkRepo(root);
14
+ const project = projectArg || (isFramework ? 'framework-root' : path.basename(root));
11
15
  let projectDir;
12
16
  if (projectArg) {
13
17
  initWorkspace();
@@ -42,7 +46,7 @@ function check() {
42
46
  }
43
47
  process.exit(1);
44
48
  }
45
- const mandatoryFiles = projectArg ? PROJECT_MANDATORY_FILES : ROOT_MANDATORY_FILES;
49
+ const mandatoryFiles = isFramework ? ROOT_MANDATORY_FILES : PROJECT_MANDATORY_FILES;
46
50
  console.log(`\nAnalisando aderencia aos padroes: ${project.toUpperCase()}...\n`);
47
51
  if (projectArg) {
48
52
  const info = getWorkspaceInfo();
@@ -85,4 +89,5 @@ try {
85
89
  }
86
90
  catch (e) {
87
91
  console.error('Erro ao verificar padrões:', e.message);
92
+ process.exitCode = 1;
88
93
  }
@@ -10,7 +10,7 @@
10
10
  * Para o blast radius de um símbolo específico, componha com `forja code:impact <símbolo>`.
11
11
  */
12
12
  import path from 'node:path';
13
- import { buildContextPack, domainsOf } from "../lib/code-context.js";
13
+ import { buildContextPack, domainsOf } from '../lib/code-context.js';
14
14
  function arg(name) {
15
15
  const i = process.argv.indexOf(name);
16
16
  return i >= 0 ? process.argv[i + 1] ?? null : null;
@@ -13,9 +13,10 @@ import fs from 'node:fs';
13
13
  import path from 'node:path';
14
14
  import Database from 'better-sqlite3';
15
15
  import { fileURLToPath } from 'node:url';
16
- import { getDbPath, ensureSchema } from "./memory-schema.js";
16
+ import { getDbPath, ensureSchema } from './memory-schema.js';
17
+ import { pkgRoot } from '../lib/paths.js';
17
18
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
18
- const root = path.resolve(__dirname, '..');
19
+ const root = pkgRoot;
19
20
  // Configuração de defaults (pode ser sobrescrita por .memoryrc.json)
20
21
  const DEFAULT_CONFIG = {
21
22
  archiveAge: 30, // dias