forjajs 4.1.1 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. package/.claude/settings.json +2 -2
  2. package/.gemini-instructions.md +1 -1
  3. package/.github/copilot-instructions.md +1 -1
  4. package/.openai-instructions.md +1 -1
  5. package/CHANGELOG.md +125 -0
  6. package/DOC-MAP.md +2 -2
  7. package/README.md +62 -10
  8. package/README.pt-BR.md +46 -7
  9. package/boilerplates/01-api-rest/README.md +1 -1
  10. package/boilerplates/06-clean-arch/README.md +5 -3
  11. package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
  12. package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
  13. package/boilerplates/06-clean-arch/backend/package.json +22 -24
  14. package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
  15. package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
  21. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
  22. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
  24. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
  26. package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
  27. package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
  28. package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
  29. package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
  30. package/boilerplates/README.md +24 -44
  31. package/dist/apps/cli/src/index.js +6 -6
  32. package/dist/apps/dashboard/next.config.d.mts +5 -5
  33. package/dist/apps/server/src/app.module.js +1 -1
  34. package/dist/apps/server/src/forja-nest.module.js +1 -1
  35. package/dist/apps/server/src/index.js +1 -1
  36. package/dist/apps/server/src/main.js +20 -20
  37. package/dist/apps/worker/src/main.js +4 -4
  38. package/dist/bin/create-memory-nest-kit.js +5 -5
  39. package/dist/bin/forja.js +28 -14
  40. package/dist/bin/init-project.d.ts +4 -9
  41. package/dist/bin/init-project.js +126 -182
  42. package/dist/lib/audit.js +1 -1
  43. package/dist/lib/context-builder.d.ts +6 -1
  44. package/dist/lib/context-builder.js +21 -12
  45. package/dist/lib/core/architecture-gate.js +2 -4
  46. package/dist/lib/core/checks.d.ts +1 -1
  47. package/dist/lib/core/drift-gate.js +2 -4
  48. package/dist/lib/core/gates.js +5 -5
  49. package/dist/lib/core/health.d.ts +0 -1
  50. package/dist/lib/core/health.js +33 -7
  51. package/dist/lib/core/journey.d.ts +30 -0
  52. package/dist/lib/core/journey.js +142 -0
  53. package/dist/lib/core/model-pricing.js +3 -5
  54. package/dist/lib/core/project-smoke.d.ts +6 -2
  55. package/dist/lib/core/project-smoke.js +60 -61
  56. package/dist/lib/core/registry.d.ts +1 -12
  57. package/dist/lib/core/registry.js +42 -32
  58. package/dist/lib/core/release.d.ts +1 -1
  59. package/dist/lib/core/release.js +31 -3
  60. package/dist/lib/core/risk-collect.js +4 -4
  61. package/dist/lib/drift-sentinel.js +1 -1
  62. package/dist/lib/generators/memory-generator.d.ts +30 -30
  63. package/dist/lib/generators/memory-generator.js +19 -8
  64. package/dist/lib/generators/nest-generator.js +192 -275
  65. package/dist/lib/generators/readme-generator.js +1 -1
  66. package/dist/lib/governance-report.js +4 -4
  67. package/dist/lib/handoffs-index.d.ts +16 -2
  68. package/dist/lib/handoffs-index.js +32 -5
  69. package/dist/lib/llm/session.js +1 -1
  70. package/dist/lib/llm/validation.js +1 -1
  71. package/dist/lib/memory-audit.js +1 -1
  72. package/dist/lib/paths.d.ts +39 -0
  73. package/dist/lib/paths.js +73 -0
  74. package/dist/lib/project-wiring.d.ts +54 -0
  75. package/dist/lib/project-wiring.js +391 -0
  76. package/dist/lib/specs-index.d.ts +1 -0
  77. package/dist/lib/specs-index.js +22 -3
  78. package/dist/lib/status-model.js +24 -8
  79. package/dist/lib/templates.d.ts +24 -0
  80. package/dist/lib/templates.js +77 -0
  81. package/dist/lib/validators/structure-validator.js +0 -1
  82. package/dist/lib/workspace.d.ts +7 -0
  83. package/dist/lib/workspace.js +33 -3
  84. package/dist/packages/adapter-git/src/index.js +2 -2
  85. package/dist/packages/context/src/index.js +1 -1
  86. package/dist/packages/core/src/index.js +1 -1
  87. package/dist/packages/evals/src/index.js +1 -1
  88. package/dist/packages/events/src/index.js +1 -1
  89. package/dist/packages/graph/src/index.js +1 -1
  90. package/dist/packages/mcp/src/index.d.ts +1 -1
  91. package/dist/packages/observability/src/index.js +1 -1
  92. package/dist/packages/orchestration/src/index.js +1 -1
  93. package/dist/packages/planner/src/index.js +1 -1
  94. package/dist/packages/policy/src/index.js +1 -1
  95. package/dist/packages/runtime/src/index.js +1 -1
  96. package/dist/packages/sandbox/src/index.js +1 -1
  97. package/dist/packages/validator/src/index.js +1 -1
  98. package/dist/scripts/adr.js +4 -4
  99. package/dist/scripts/agent-harness.js +30 -23
  100. package/dist/scripts/agent-router.js +22 -5
  101. package/dist/scripts/agent.js +5 -5
  102. package/dist/scripts/architecture.js +6 -6
  103. package/dist/scripts/audit-query.js +1 -1
  104. package/dist/scripts/audit-sync.js +1 -1
  105. package/dist/scripts/build-smart-context.d.ts +19 -1
  106. package/dist/scripts/build-smart-context.js +84 -68
  107. package/dist/scripts/check-standards.js +8 -3
  108. package/dist/scripts/code-context.js +1 -1
  109. package/dist/scripts/compress-memory.js +3 -2
  110. package/dist/scripts/compress-project-memory.js +2 -2
  111. package/dist/scripts/context-ops.js +13 -5
  112. package/dist/scripts/cost-economy.js +4 -4
  113. package/dist/scripts/demo-autonomy.js +11 -11
  114. package/dist/scripts/demo-workspace.js +12 -4
  115. package/dist/scripts/dev.js +8 -7
  116. package/dist/scripts/drift-check.js +5 -5
  117. package/dist/scripts/engineer.js +11 -11
  118. package/dist/scripts/evidence.js +4 -4
  119. package/dist/scripts/extract-global-knowledge.js +6 -4
  120. package/dist/scripts/forja-setup.js +2 -1
  121. package/dist/scripts/forja-status.d.ts +1 -1
  122. package/dist/scripts/forja-status.js +31 -3
  123. package/dist/scripts/gates.js +1 -1
  124. package/dist/scripts/generate-dashboard.js +6 -4
  125. package/dist/scripts/governance-dashboard.js +2 -2
  126. package/dist/scripts/hook-session-start.js +18 -9
  127. package/dist/scripts/hook-user-prompt.js +3 -2
  128. package/dist/scripts/incident.js +4 -4
  129. package/dist/scripts/llm-fit.js +11 -11
  130. package/dist/scripts/memory-audit.js +1 -1
  131. package/dist/scripts/memory-schema.js +3 -2
  132. package/dist/scripts/orchestrate.js +4 -5
  133. package/dist/scripts/project-smoke.js +13 -2
  134. package/dist/scripts/project-templates.d.ts +1 -0
  135. package/dist/scripts/project-templates.js +20 -0
  136. package/dist/scripts/project-upgrade.d.ts +13 -0
  137. package/dist/scripts/project-upgrade.js +107 -40
  138. package/dist/scripts/project-wire.d.ts +8 -0
  139. package/dist/scripts/project-wire.js +55 -0
  140. package/dist/scripts/provenance.js +3 -3
  141. package/dist/scripts/query-universal-memory.js +7 -4
  142. package/dist/scripts/release-check.js +1 -1
  143. package/dist/scripts/risk.js +4 -4
  144. package/dist/scripts/simulate.js +9 -9
  145. package/dist/scripts/spec-cli.d.ts +1 -0
  146. package/dist/scripts/spec-cli.js +25 -5
  147. package/dist/scripts/sprint-manager.js +21 -8
  148. package/dist/scripts/sync-universal-memory.js +50 -27
  149. package/dist/scripts/token-benchmark.js +4 -3
  150. package/dist/scripts/token-economy.js +4 -3
  151. package/dist/scripts/tools-doctor.d.ts +1 -1
  152. package/dist/scripts/tools-doctor.js +25 -3
  153. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  154. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  155. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  156. package/docs/glossary.md +4 -4
  157. package/docs/init-project.md +88 -444
  158. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  159. package/docs/modos-de-operacao.md +1 -1
  160. package/docs/processo-projeto.md +14 -11
  161. package/docs/produto/roteiro-demo.md +15 -18
  162. package/docs/publishing.md +5 -0
  163. package/docs/quick-reference.md +15 -23
  164. package/docs/structure.md +16 -30
  165. package/lib/core/model-pricing.json +19 -0
  166. package/memory/30-projects/README.md +1 -1
  167. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  168. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  169. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  170. package/memory/90-decisions/0088-templates-validados.md +55 -0
  171. package/package.json +25 -25
  172. package/templates/project/AGENTS.md +75 -0
  173. package/templates/project/CLAUDE.md +9 -0
  174. package/templates/project/agents/context-engineer.md +15 -0
  175. package/templates/project/agents/governance.md +15 -0
  176. package/templates/project/agents/marketing.md +15 -0
  177. package/templates/project/agents/orchestrator.md +15 -0
  178. package/templates/project/agents/product.md +15 -0
  179. package/templates/project/agents/sdd-architect.md +15 -0
  180. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  181. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -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
@@ -1,12 +1,12 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { fileURLToPath } from 'node:url';
4
- import { resolveProject, initWorkspace } from "../lib/workspace.js";
4
+ import { resolveProject, initWorkspace } from '../lib/workspace.js';
5
5
  const __filename = fileURLToPath(import.meta.url);
6
6
  const __dirname = path.dirname(__filename);
7
7
  const [project] = process.argv.slice(2);
8
8
  if (!project) {
9
- console.log('Uso: node scripts/compress-project-memory.js <projeto>');
9
+ console.log('Uso: forja memory:compress <projeto>');
10
10
  process.exit(0);
11
11
  }
12
12
  initWorkspace();
@@ -3,13 +3,15 @@ import fs from 'node:fs';
3
3
  import path from 'node:path';
4
4
  import Database from 'better-sqlite3';
5
5
  import { fileURLToPath } from 'node:url';
6
- import { ensureSchema, getDbPath } from "./memory-schema.js";
6
+ import { ensureSchema, getDbPath } from './memory-schema.js';
7
+ import { pkgRoot } from '../lib/paths.js';
8
+ import { isInsideFrameworkRepo } from '../lib/workspace.js';
7
9
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
8
10
  // `root` = recursos do FRAMEWORK (catalog: boilerplates/, design-md/) — resolvidos por __dirname.
9
11
  // `projectRoot` = o PROJETO do usuário (.context/, specs/, memory/, .memoryrc.json) — onde foi invocado.
10
12
  // Cravar `root` para as superfícies do projeto auditava/gravava no PACOTE no consumidor (classe de bug
11
13
  // spec-cli v1.6.2 / check-standards v1.7.1). No repo do framework os dois coincidem (cwd = raiz).
12
- const root = path.resolve(__dirname, '..');
14
+ const root = pkgRoot;
13
15
  const projectRoot = process.cwd();
14
16
  const outDir = path.join(projectRoot, '.context');
15
17
  const defaultLimit = readTokenLimit();
@@ -143,7 +145,7 @@ function latestAdrs() {
143
145
  }
144
146
  function cmdBudget([target, limitArg]) {
145
147
  if (!target) {
146
- console.error('Uso: context-ops budget <slug|arquivo> [limite_tokens]');
148
+ console.error('Uso: forja context:budget <slug|arquivo> [limite_tokens]');
147
149
  process.exit(1);
148
150
  }
149
151
  const limit = Number(limitArg) || defaultLimit;
@@ -198,7 +200,7 @@ function cmdSprintPack() {
198
200
  }
199
201
  function cmdAgentBrief([role, slug]) {
200
202
  if (!role || !slug) {
201
- console.error('Uso: context-ops agent-brief <role> <slug>');
203
+ console.error('Uso: forja agent:brief <role> <slug>');
202
204
  process.exit(1);
203
205
  }
204
206
  ensureOutDir();
@@ -329,6 +331,11 @@ function readJsonIfExists(relPath) {
329
331
  }
330
332
  }
331
333
  function cmdGenerateManifests() {
334
+ // Manutenção do catálogo do PRÓPRIO framework: fora do repo, escreveria dentro do pacote instalado.
335
+ if (!isInsideFrameworkRepo(process.cwd())) {
336
+ console.error('catalog:manifests regenera os manifests do framework — rode no repositório do Forja.');
337
+ process.exit(1);
338
+ }
332
339
  let written = 0;
333
340
  const boilerRoot = path.join(root, 'boilerplates');
334
341
  if (fs.existsSync(boilerRoot)) {
@@ -434,7 +441,8 @@ function cmdAssetCatalog() {
434
441
  console.log(`Asset catalog gerado: ${path.relative(root, outFile)} (${assets.length} assets)`);
435
442
  }
436
443
  function help() {
437
- console.log(`Uso: node scripts/context-ops.mjs <command> [args]
444
+ console.log(`Script interno do Forja — use os comandos via core: forja help --all
445
+
438
446
 
439
447
  Comandos:
440
448
  budget <slug|arquivo> [limite] Mede tokens e falha se passar do limite
@@ -18,10 +18,10 @@
18
18
  */
19
19
  import fs from 'node:fs';
20
20
  import Database from 'better-sqlite3';
21
- import { SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
22
- import { getWorkspaceDbDir, getWorkspaceDbPath, getWorkspaceInfo } from "../lib/workspace.js";
23
- import { loadPricingTable, lookupPrice } from "../lib/core/model-pricing.js";
24
- import { emitOk } from "../lib/cli-output.js";
21
+ import { SqliteMigrationRunner, SqliteObservationStore } from '../packages/adapter-sqlite/src/index.js';
22
+ import { getWorkspaceDbDir, getWorkspaceDbPath, getWorkspaceInfo } from '../lib/workspace.js';
23
+ import { loadPricingTable, lookupPrice } from '../lib/core/model-pricing.js';
24
+ import { emitOk } from '../lib/cli-output.js';
25
25
  function main() {
26
26
  const json = process.argv.includes('--json');
27
27
  const info = getWorkspaceInfo();
@@ -4,17 +4,17 @@ import path from 'node:path';
4
4
  import { randomUUID } from 'node:crypto';
5
5
  import { spawnSync } from 'node:child_process';
6
6
  import Database from 'better-sqlite3';
7
- import { CapabilityRegistry } from "../packages/core/src/index.js";
8
- import { ContextEngine, GraphContextSource } from "../packages/context/src/index.js";
9
- import { SqliteApprovalStore, SqliteAuditStore, SqliteCheckpointStore, SqliteContextCache, SqliteEventStore, SqliteGraphStore, SqliteMigrationRunner, SqliteOrchestrationStore, SqliteSandboxStore, SqliteRuntimePersistence } from "../packages/adapter-sqlite/src/index.js";
10
- import { GitGraphDocumentSource, GitWorktreeBackend, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
11
- import { GraphExecutionMemory, GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
12
- import { EventBus } from "../packages/events/src/index.js";
13
- import { ApprovalLedger, PolicyEngine } from "../packages/policy/src/index.js";
14
- import { RuntimeEngine } from "../packages/runtime/src/index.js";
15
- import { SandboxEngine } from "../packages/sandbox/src/index.js";
16
- import { SprintEngine, TaskEngine, HandoffEngine } from "../packages/orchestration/src/index.js";
17
- import { DeterministicValidator } from "../packages/validator/src/index.js";
7
+ import { CapabilityRegistry } from '../packages/core/src/index.js';
8
+ import { ContextEngine, GraphContextSource } from '../packages/context/src/index.js';
9
+ import { SqliteApprovalStore, SqliteAuditStore, SqliteCheckpointStore, SqliteContextCache, SqliteEventStore, SqliteGraphStore, SqliteMigrationRunner, SqliteOrchestrationStore, SqliteSandboxStore, SqliteRuntimePersistence } from '../packages/adapter-sqlite/src/index.js';
10
+ import { GitGraphDocumentSource, GitWorktreeBackend, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
11
+ import { GraphExecutionMemory, GraphIndexer, GraphLoop } from '../packages/graph/src/index.js';
12
+ import { EventBus } from '../packages/events/src/index.js';
13
+ import { ApprovalLedger, PolicyEngine } from '../packages/policy/src/index.js';
14
+ import { RuntimeEngine } from '../packages/runtime/src/index.js';
15
+ import { SandboxEngine } from '../packages/sandbox/src/index.js';
16
+ import { SprintEngine, TaskEngine, HandoffEngine } from '../packages/orchestration/src/index.js';
17
+ import { DeterministicValidator } from '../packages/validator/src/index.js';
18
18
  const now = () => new Date().toISOString();
19
19
  const budget = { inputTokens: 600, outputTokens: 300, totalTokens: 900, usedTokens: 0 };
20
20
  function command(executable, args, cwd, input) {
@@ -4,9 +4,12 @@ import os from 'node:os';
4
4
  import path from 'node:path';
5
5
  import Database from 'better-sqlite3';
6
6
  import { randomUUID } from 'node:crypto';
7
- import { initWorkspace, getWorkspaceContextDir, getWorkspaceDbPath, getWorkspaceRoot } from "../lib/workspace.js";
8
- import { SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
9
- import { ObservabilityRecorder } from "../packages/observability/src/index.js";
7
+ import { initWorkspace, getWorkspaceContextDir, getWorkspaceDbPath, getWorkspaceRoot } from '../lib/workspace.js';
8
+ import { SqliteMigrationRunner, SqliteObservationStore } from '../packages/adapter-sqlite/src/index.js';
9
+ import { ObservabilityRecorder } from '../packages/observability/src/index.js';
10
+ import { execFileSync } from 'node:child_process';
11
+ import { wireProject } from '../lib/project-wiring.js';
12
+ import { script } from '../lib/paths.js';
10
13
  const PROJECT = 'atlas-pay';
11
14
  const SENTINEL = 'forja-demo.json';
12
15
  function usage() {
@@ -40,6 +43,7 @@ function createFiles(root) {
40
43
  write(path.join(project, 'docs', 'project-brief.md'), '# Briefing: Atlas Pay\n\nDemonstração de uma camada de aprovação para pagamentos empresariais.\n');
41
44
  write(path.join(project, 'memory', '20-architecture', 'stack.md'), '# Stack\n\n- API NestJS\n- SQLite local\n- Integração de pagamento simulada\n');
42
45
  write(path.join(project, 'memory', '20-architecture', 'design-brief.md'), '# Design brief\n\nDashboard operacional para aprovar pagamentos e revisar evidências.\n');
46
+ write(path.join(project, 'memory', '30-domains', 'pagamentos.md'), '# Domínio: pagamentos\n\nPagamentos via Pix e TED. Acima de R$ 50 mil, o pagamento exige aprovação explícita de um segundo operador antes da promoção.\n');
43
47
  write(path.join(project, 'memory', '40-delivery', 'current-sprint.md'), '# Sprint de demonstração\n\nObjetivo: aprovar pagamentos de alto valor com evidência e revisão.\n');
44
48
  write(path.join(root, 'specs', PROJECT, 'spec.md'), '# Spec: atlas-pay\n\n- **Status**: approved\n\n## Problema\nPagamentos empresariais de alto valor precisam de aprovação explícita.\n\n## Critérios de aceite\n- [x] Aprovação registrada antes da promoção.\n- [x] Auditoria consulta os handoffs da entrega.\n');
45
49
  write(path.join(root, 'specs', PROJECT, 'plan.md'), '# Plan: atlas-pay\n\n- **Status**: approved\n\nImplementar política de aprovação e trilha de auditoria.\n');
@@ -88,13 +92,17 @@ export async function createDemoWorkspace(args = process.argv.slice(2)) {
88
92
  throw new Error(`Recusado: ${root} não é um workspace demo. Escolha --path para um diretório vazio.`);
89
93
  initWorkspace();
90
94
  createFiles(getWorkspaceRoot());
95
+ // O projeto demo é um projeto Forja de verdade: conectado à IA e com a memória indexada.
96
+ const project = path.join(getWorkspaceRoot(), 'projects', PROJECT);
97
+ wireProject(project, { ai: ['claude', 'codex'], codegraph: false });
91
98
  await createDatabase();
99
+ execFileSync(process.execPath, [script('scripts/sync-universal-memory')], { env: { ...process.env, FORJA_WORKSPACE: root }, stdio: 'pipe' });
92
100
  const result = { workspace: getWorkspaceRoot(), project: PROJECT, handoffs: 3, observations: 3 };
93
101
  write(sentinel, `${JSON.stringify({ ...result, generatedAt: new Date().toISOString(), warning: 'Dados sintéticos para demonstração. Não use em produção.' }, null, 2)}\n`);
94
102
  if (json)
95
103
  console.log(JSON.stringify(result));
96
104
  else
97
- console.log(`Demo pronta em ${result.workspace}\nProjeto: ${PROJECT}\nHandoffs: 3 (2 concluídos, 1 em review)\nPróximo: FORJA_WORKSPACE="${result.workspace}" npm --prefix dashboard start`);
105
+ console.log(`Demo pronta em ${result.workspace}\nProjeto: ${PROJECT}\nHandoffs: 3 (2 concluídos, 1 em review)\n\nPróximo (o demo é um workspace à parte):\n export FORJA_WORKSPACE="${result.workspace}"\n cd "${project}" && forja status`);
98
106
  return result;
99
107
  }
100
108
  if (process.argv[1]?.endsWith('demo-workspace.ts'))
@@ -16,10 +16,11 @@ import fs from 'node:fs';
16
16
  import path from 'node:path';
17
17
  import { spawn } from 'node:child_process';
18
18
  import { fileURLToPath } from 'node:url';
19
- import { getDbPath, ensureSchema } from "./memory-schema.js";
19
+ import { getDbPath, ensureSchema } from './memory-schema.js';
20
+ import { pkgRoot, script } from '../lib/paths.js';
20
21
  const __filename = fileURLToPath(import.meta.url);
21
22
  const __dirname = path.dirname(__filename);
22
- const root = path.resolve(__dirname, '..');
23
+ const root = pkgRoot;
23
24
  const COMMANDS = {
24
25
  'context:build': {
25
26
  desc: 'Gerar contexto inteligente (global|domain|task)',
@@ -129,7 +130,7 @@ function runScript(scriptPath, args = []) {
129
130
  }
130
131
  function harnessCommand(command) {
131
132
  return async function runHarness(args = []) {
132
- await runScript(path.join(root, 'scripts', 'agent-harness.mjs'), [command, ...args]);
133
+ await runScript(script('scripts/agent-harness'), [command, ...args]);
133
134
  };
134
135
  }
135
136
  /**
@@ -143,7 +144,7 @@ async function contextBuild([mode, project, keyword] = []) {
143
144
  console.log(`Building ${mode} context for ${project}...`);
144
145
  try {
145
146
  ensureSchema({ silent: true });
146
- const builder = (await import("../lib/context-builder.js")).default;
147
+ const builder = (await import('../lib/context-builder.js')).default;
147
148
  const dbPath = getDbPath();
148
149
  const ctx = new builder(root, dbPath);
149
150
  ctx.connect();
@@ -169,7 +170,7 @@ async function contextBuild([mode, project, keyword] = []) {
169
170
  async function memoryVacuum() {
170
171
  console.log('Running memory vacuum...');
171
172
  try {
172
- await runScript(path.join(root, 'scripts', 'compress-memory.mjs'));
173
+ await runScript(script('scripts/compress-memory'));
173
174
  console.log('Memory vacuum complete');
174
175
  }
175
176
  catch (e) {
@@ -234,7 +235,7 @@ async function projectHealth() {
234
235
  }
235
236
  // 3. Check key files
236
237
  console.log('\nChecking key files...');
237
- const keyFiles = ['bin/create-memory-nest-kit.js', 'lib/context-builder.js'];
238
+ const keyFiles = ['bin/create-memory-nest-kit.ts', 'lib/context-builder.ts'];
238
239
  for (const file of keyFiles) {
239
240
  const exists = fs.existsSync(path.join(root, file));
240
241
  const status = exists ? 'OK ' : 'FAIL';
@@ -269,7 +270,7 @@ async function projectInit([projectName, ...flags] = []) {
269
270
  }
270
271
  console.log(`Initializing project: ${projectName}...\n`);
271
272
  try {
272
- await runScript(path.join(root, 'bin', 'create-memory-nest-kit.js'), [
273
+ await runScript(script('bin/create-memory-nest-kit'), [
273
274
  projectName,
274
275
  ...flags,
275
276
  ]);
@@ -21,11 +21,11 @@ import path from 'node:path';
21
21
  import { spawnSync } from 'node:child_process';
22
22
  import { fileURLToPath } from 'node:url';
23
23
  import Database from 'better-sqlite3';
24
- import { checkDrift } from "../lib/drift-sentinel.js";
25
- import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
26
- import { GraphLoop } from "../packages/graph/src/index.js";
27
- import { SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
28
- import { getWorkspaceDbDir, getWorkspaceDbPath, getProjectsDir, listProjects } from "../lib/workspace.js";
24
+ import { checkDrift } from '../lib/drift-sentinel.js';
25
+ import { GitGraphDocumentSource, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
26
+ import { GraphLoop } from '../packages/graph/src/index.js';
27
+ import { SqliteGraphStore, SqliteMigrationRunner } from '../packages/adapter-sqlite/src/index.js';
28
+ import { getWorkspaceDbDir, getWorkspaceDbPath, getProjectsDir, listProjects } from '../lib/workspace.js';
29
29
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
30
30
  function arg(name) {
31
31
  const i = process.argv.indexOf(name);
@@ -21,17 +21,17 @@ import fs from 'node:fs';
21
21
  import path from 'node:path';
22
22
  import { randomUUID } from 'node:crypto';
23
23
  import Database from 'better-sqlite3';
24
- import { ContextEngine, GraphContextSource } from "../packages/context/src/index.js";
25
- import { checkConstitution } from "../packages/engineering/architecture/src/index.js";
26
- import { assessRisk } from "../packages/engineering/risk/src/index.js";
27
- import { recommendAgent } from "../packages/engineering/identity/src/index.js";
28
- import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
29
- import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
30
- import { SqliteAgentProfileStore, SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
31
- import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
32
- import { buildRiskInput, changedFiles, graphRoot } from "../lib/core/risk-collect.js";
33
- import { incidentRecords, rankIncidentsByQuery, titleOf } from "../lib/core/incident-search.js";
34
- import { emitOk, emitError } from "../lib/cli-output.js";
24
+ import { ContextEngine, GraphContextSource } from '../packages/context/src/index.js';
25
+ import { checkConstitution } from '../packages/engineering/architecture/src/index.js';
26
+ import { assessRisk } from '../packages/engineering/risk/src/index.js';
27
+ import { recommendAgent } from '../packages/engineering/identity/src/index.js';
28
+ import { GitGraphDocumentSource, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
29
+ import { GraphIndexer, GraphLoop } from '../packages/graph/src/index.js';
30
+ import { SqliteAgentProfileStore, SqliteGraphStore, SqliteMigrationRunner } from '../packages/adapter-sqlite/src/index.js';
31
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
32
+ import { buildRiskInput, changedFiles, graphRoot } from '../lib/core/risk-collect.js';
33
+ import { incidentRecords, rankIncidentsByQuery, titleOf } from '../lib/core/incident-search.js';
34
+ import { emitOk, emitError } from '../lib/cli-output.js';
35
35
  const CONSTITUTION_PATH = '.context/architecture/constitution.json';
36
36
  const FLUXO_PATH = 'docs/fluxo.md';
37
37
  /** Parseia a tabela "Etapa → papel → comando → capacidade" de docs/fluxo.md — D2 do plan: uma fonte de verdade, não copiada aqui. */
@@ -11,10 +11,10 @@
11
11
  */
12
12
  import fs from 'node:fs';
13
13
  import Database from 'better-sqlite3';
14
- import { buildEvidenceLedger } from "../packages/engineering/evidence/src/index.js";
15
- import { ApprovalLedger } from "../packages/policy/src/index.js";
16
- import { SqliteApprovalStore, SqliteAuditStore, SqliteMigrationRunner, SqliteRuntimeRunStore } from "../packages/adapter-sqlite/src/index.js";
17
- import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
14
+ import { buildEvidenceLedger } from '../packages/engineering/evidence/src/index.js';
15
+ import { ApprovalLedger } from '../packages/policy/src/index.js';
16
+ import { SqliteApprovalStore, SqliteAuditStore, SqliteMigrationRunner, SqliteRuntimeRunStore } from '../packages/adapter-sqlite/src/index.js';
17
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
18
18
  function cmdShow([runId]) {
19
19
  if (!runId) {
20
20
  console.error('Uso: forja evidence:show <run-id>');
@@ -2,10 +2,10 @@ import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import Database from 'better-sqlite3';
4
4
  import { fileURLToPath } from 'node:url';
5
- import { getDbPath, ensureSchema } from "./memory-schema.js";
5
+ import { getDbPath, ensureSchema } from './memory-schema.js';
6
+ import { getWorkspaceMemoryDir } from '../lib/workspace.js';
6
7
  const __filename = fileURLToPath(import.meta.url);
7
8
  const __dirname = path.dirname(__filename);
8
- const root = path.resolve(__dirname, '..');
9
9
  ensureSchema({ silent: true });
10
10
  const dbPath = getDbPath();
11
11
  function extractGlobalLessons() {
@@ -24,13 +24,15 @@ function extractGlobalLessons() {
24
24
  knowledgeBase += `### [Proveniente de: ${adr.project}] ${adr.title}\n\n`;
25
25
  // Pega apenas o resumo ou contexto da decisão
26
26
  const contextMatch = adr.content.match(/## Contexto\n([\s\S]*?)(?=##|$)/);
27
- const decisionMatch = adr.content.match(/## Decisao\n([\s\S]*?)(?=##|$)/);
27
+ const decisionMatch = adr.content.match(/## Decis[aã]o\n([\s\S]*?)(?=##|$)/);
28
28
  if (contextMatch && decisionMatch) {
29
29
  knowledgeBase += `**Contexto:** ${contextMatch[1].trim().slice(0, 300)}...\n\n`;
30
30
  knowledgeBase += `**Padrao Adotado:** ${decisionMatch[1].trim()}\n\n`;
31
31
  }
32
32
  }
33
- const outFile = path.join(root, 'memory/00-global/shared-knowledge.md');
33
+ // Memória do workspace (ou do projeto, no embedded) — gravar em pkgRoot sujava o pacote do Forja.
34
+ const outFile = path.join(getWorkspaceMemoryDir(), '00-global', 'shared-knowledge.md');
35
+ fs.mkdirSync(path.dirname(outFile), { recursive: true });
34
36
  fs.writeFileSync(outFile, knowledgeBase, 'utf8');
35
37
  console.log(`✅ Base de conhecimento global atualizada em: ${outFile}`);
36
38
  db.close();
@@ -15,8 +15,9 @@ import { spawnSync } from 'node:child_process';
15
15
  import path from 'node:path';
16
16
  import readline from 'node:readline';
17
17
  import { fileURLToPath } from 'node:url';
18
+ import { script } from '../lib/paths.js';
18
19
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
19
- const forjaBin = path.resolve(__dirname, '..', 'bin', 'forja.ts');
20
+ const forjaBin = script('bin/forja');
20
21
  // Allowlist fixa. Não ler de config, não aceitar via argv. Ordem importa: o índice precede a busca.
21
22
  const STEPS = ['workspace:init', 'sync:universal'];
22
23
  function ask(question) {
@@ -8,4 +8,4 @@
8
8
  * Somente leitura. Sai 0 sempre que o modelo montou (subsistema indisponível não é falha do
9
9
  * comando). O dispatch por `status`/`next` vem do `args` do registry.
10
10
  */
11
- export {};
11
+ export declare function resolveRepoRoot(targetArg?: string): string;
@@ -8,12 +8,38 @@
8
8
  * Somente leitura. Sai 0 sempre que o modelo montou (subsistema indisponível não é falha do
9
9
  * comando). O dispatch por `status`/`next` vem do `args` do registry.
10
10
  */
11
+ import fs from 'node:fs';
11
12
  import path from 'node:path';
12
13
  import { fileURLToPath } from 'node:url';
13
- import { collectStatus, recommendNext } from "../lib/status-model.js";
14
- import { emitOk } from "../lib/cli-output.js";
14
+ import { collectStatus, recommendNext } from '../lib/status-model.js';
15
+ import { emitOk } from '../lib/cli-output.js';
16
+ import { getWorkspaceRoot, isInsideFrameworkRepo, resolveProject } from '../lib/workspace.js';
17
+ import { pkgRoot } from '../lib/paths.js';
15
18
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
16
- const repoRoot = path.resolve(__dirname, '..');
19
+ const frameworkRoot = pkgRoot;
20
+ export function resolveRepoRoot(targetArg) {
21
+ if (targetArg && targetArg !== '.' && targetArg !== 'root' && !targetArg.startsWith('-')) {
22
+ try {
23
+ const projDir = resolveProject(targetArg);
24
+ if (fs.existsSync(projDir))
25
+ return projDir;
26
+ }
27
+ catch { }
28
+ const direct = path.resolve(targetArg);
29
+ if (fs.existsSync(direct))
30
+ return direct;
31
+ }
32
+ const cwd = path.resolve(process.cwd());
33
+ if (isInsideFrameworkRepo(cwd)) {
34
+ return frameworkRoot;
35
+ }
36
+ if (fs.existsSync(path.join(cwd, 'specs')) ||
37
+ fs.existsSync(path.join(cwd, 'memory')) ||
38
+ fs.existsSync(path.join(cwd, 'package.json'))) {
39
+ return cwd;
40
+ }
41
+ return getWorkspaceRoot();
42
+ }
17
43
  function sub(s, render) {
18
44
  return s.available ? render(s.value) : [` indisponível: ${s.reason}`];
19
45
  }
@@ -55,6 +81,8 @@ function renderStatus(m) {
55
81
  const argv = process.argv.slice(2);
56
82
  const cmd = argv[0] === 'next' ? 'next' : 'status';
57
83
  const json = argv.includes('--json');
84
+ const targetArg = argv.find((a) => a !== 'status' && a !== 'next' && a !== '--json' && !a.startsWith('-'));
85
+ const repoRoot = resolveRepoRoot(targetArg);
58
86
  const model = await collectStatus(repoRoot);
59
87
  if (cmd === 'next') {
60
88
  const next = recommendNext(model);
@@ -11,7 +11,7 @@
11
11
  *
12
12
  * Não substitui os gates focados — os agrega. "A casa está coerente?" num comando só.
13
13
  */
14
- import { runGates, overallStatus } from "../lib/core/gates.js";
14
+ import { runGates, overallStatus } from '../lib/core/gates.js';
15
15
  const TAG = { ok: 'OK ', warn: 'AVISO', fail: 'FALHA', skipped: '— ' };
16
16
  async function main() {
17
17
  const full = process.argv.includes('--full');