forjajs 1.1.6 → 1.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.
- package/.claude/settings.json +7 -7
- package/CHANGELOG.md +62 -0
- package/README.en.md +33 -5
- package/README.md +35 -4
- package/boilerplates/06-clean-arch/README.md +48 -0
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +42 -0
- package/boilerplates/06-clean-arch/backend/package.json +43 -0
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -0
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -0
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -0
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -0
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -0
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -0
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -0
- package/boilerplates/README.md +20 -0
- package/dist/bin/create-memory-nest-kit.d.ts +2 -0
- package/dist/bin/create-memory-nest-kit.js +110 -0
- package/dist/bin/forja.d.ts +13 -0
- package/dist/bin/forja.js +136 -0
- package/dist/bin/init-project.d.ts +2 -0
- package/dist/bin/init-project.js +516 -0
- package/dist/lib/audit.d.ts +67 -0
- package/dist/lib/audit.js +143 -0
- package/dist/lib/context-builder.d.ts +58 -0
- package/dist/lib/context-builder.js +233 -0
- package/dist/lib/core/checks.d.ts +91 -0
- package/dist/lib/core/checks.js +119 -0
- package/dist/lib/core/doc-graph.d.ts +60 -0
- package/dist/lib/core/doc-graph.js +235 -0
- package/dist/lib/core/health.d.ts +103 -0
- package/dist/lib/core/health.js +538 -0
- package/dist/lib/core/registry.d.ts +296 -0
- package/dist/lib/core/registry.js +317 -0
- package/dist/lib/core/release.d.ts +334 -0
- package/dist/lib/core/release.js +465 -0
- package/dist/lib/generators/memory-generator.d.ts +83 -0
- package/{lib → dist/lib}/generators/memory-generator.js +107 -178
- package/dist/lib/generators/nest-generator.d.ts +15 -0
- package/{lib → dist/lib}/generators/nest-generator.js +47 -71
- package/dist/lib/generators/readme-generator.d.ts +15 -0
- package/{lib → dist/lib}/generators/readme-generator.js +9 -14
- package/dist/lib/governance-report.d.ts +49 -0
- package/dist/lib/governance-report.js +170 -0
- package/dist/lib/templates/harness/code-intel.d.mts +2 -0
- package/dist/lib/templates/harness/code-intel.mjs +126 -0
- package/dist/lib/utils/file-helpers.d.ts +9 -0
- package/dist/lib/utils/file-helpers.js +34 -0
- package/dist/lib/validators/structure-validator.d.ts +48 -0
- package/dist/lib/validators/structure-validator.js +232 -0
- package/dist/lib/workspace.d.ts +40 -0
- package/dist/lib/workspace.js +174 -0
- package/dist/scripts/agent-harness.d.ts +2 -0
- package/dist/scripts/agent-harness.js +556 -0
- package/dist/scripts/agent-router.d.ts +30 -0
- package/dist/scripts/agent-router.js +208 -0
- package/dist/scripts/audit-query.d.ts +2 -0
- package/dist/scripts/audit-query.js +43 -0
- package/dist/scripts/audit-sync.d.ts +2 -0
- package/dist/scripts/audit-sync.js +19 -0
- package/dist/scripts/build-smart-context.d.ts +1 -0
- package/dist/scripts/build-smart-context.js +75 -0
- package/dist/scripts/check-standards.d.ts +1 -0
- package/dist/scripts/check-standards.js +87 -0
- package/dist/scripts/compress-memory.d.ts +16 -0
- package/dist/scripts/compress-memory.js +157 -0
- package/dist/scripts/compress-project-memory.d.ts +1 -0
- package/dist/scripts/compress-project-memory.js +48 -0
- package/dist/scripts/context-ops.d.ts +2 -0
- package/dist/scripts/context-ops.js +464 -0
- package/dist/scripts/dev.d.ts +96 -0
- package/dist/scripts/dev.js +312 -0
- package/dist/scripts/extract-global-knowledge.d.ts +1 -0
- package/dist/scripts/extract-global-knowledge.js +43 -0
- package/dist/scripts/generate-dashboard.d.ts +1 -0
- package/dist/scripts/generate-dashboard.js +48 -0
- package/dist/scripts/governance-dashboard.d.ts +2 -0
- package/dist/scripts/governance-dashboard.js +36 -0
- package/dist/scripts/hook-guard-paths.d.ts +17 -0
- package/dist/scripts/hook-guard-paths.js +68 -0
- package/dist/scripts/hook-post-edit.d.ts +20 -0
- package/dist/scripts/hook-post-edit.js +70 -0
- package/dist/scripts/hook-session-start.d.ts +17 -0
- package/dist/scripts/hook-session-start.js +108 -0
- package/dist/scripts/hook-user-prompt.d.ts +22 -0
- package/dist/scripts/hook-user-prompt.js +193 -0
- package/dist/scripts/memory-schema.d.ts +6 -0
- package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
- package/dist/scripts/query-universal-memory.d.ts +1 -0
- package/dist/scripts/query-universal-memory.js +44 -0
- package/dist/scripts/release-check.d.ts +14 -0
- package/dist/scripts/release-check.js +48 -0
- package/dist/scripts/spec-cli.d.ts +29 -0
- package/dist/scripts/spec-cli.js +261 -0
- package/dist/scripts/sprint-manager.d.ts +1 -0
- package/dist/scripts/sprint-manager.js +187 -0
- package/dist/scripts/sync-universal-memory.d.ts +1 -0
- package/dist/scripts/sync-universal-memory.js +277 -0
- package/dist/scripts/token-benchmark.d.ts +20 -0
- package/dist/scripts/token-benchmark.js +181 -0
- package/dist/scripts/tools-doctor.d.ts +20 -0
- package/dist/scripts/tools-doctor.js +120 -0
- package/docs/personas/architect/README.md +4 -4
- package/docs/personas/developer/README.md +3 -3
- package/docs/personas/qa/README.md +3 -3
- package/docs/quick-reference.md +9 -9
- package/docs/structure.md +3 -3
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +95 -0
- package/memory/90-decisions/0027-clean-arch-calibrada.md +96 -0
- package/memory/90-decisions/0028-governanca-visivel.md +84 -0
- package/package.json +60 -56
- package/specs/clean-arch-boilerplate/plan.md +137 -0
- package/specs/clean-arch-boilerplate/spec.md +121 -0
- package/specs/clean-arch-boilerplate/tasks.md +70 -0
- package/specs/coerencia-do-sistema/plan.md +155 -0
- package/specs/coerencia-do-sistema/spec.md +15 -14
- package/specs/coerencia-do-sistema/tasks.md +115 -0
- package/specs/governanca-visivel/plan.md +122 -0
- package/specs/governanca-visivel/spec.md +112 -0
- package/specs/governanca-visivel/tasks.md +60 -0
- package/specs/ts-migration/plan.md +199 -0
- package/specs/ts-migration/spec.md +119 -0
- package/specs/ts-migration/tasks.md +110 -0
- package/bin/create-memory-nest-kit.js +0 -125
- package/bin/forja.mjs +0 -143
- package/bin/init-project.js +0 -612
- package/lib/context-builder.js +0 -257
- package/lib/core/checks.mjs +0 -138
- package/lib/core/health.mjs +0 -475
- package/lib/core/registry.mjs +0 -289
- package/lib/core/release.mjs +0 -452
- package/lib/templates/harness/code-intel.mjs +0 -119
- package/lib/templates/harness/mcp.json +0 -10
- package/lib/utils/file-helpers.js +0 -40
- package/lib/validators/structure-validator.js +0 -253
- package/lib/workspace.mjs +0 -213
- package/scripts/agent-harness.mjs +0 -578
- package/scripts/agent-router.mjs +0 -189
- package/scripts/build-smart-context.js +0 -87
- package/scripts/check-standards.js +0 -98
- package/scripts/compress-memory.mjs +0 -198
- package/scripts/compress-project-memory.js +0 -58
- package/scripts/context-ops.mjs +0 -463
- package/scripts/dev.mjs +0 -349
- package/scripts/extract-global-knowledge.js +0 -52
- package/scripts/generate-dashboard.js +0 -59
- package/scripts/hook-guard-paths.mjs +0 -75
- package/scripts/hook-post-edit.mjs +0 -79
- package/scripts/hook-session-start.mjs +0 -104
- package/scripts/hook-user-prompt.mjs +0 -185
- package/scripts/pre-commit.sh +0 -102
- package/scripts/query-universal-memory.js +0 -50
- package/scripts/release-check.mjs +0 -56
- package/scripts/spec-cli.mjs +0 -260
- package/scripts/sprint-manager.js +0 -200
- package/scripts/sync-universal-memory.js +0 -286
- package/scripts/token-benchmark.mjs +0 -203
- package/scripts/tools-doctor.mjs +0 -132
|
@@ -1,578 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
import fs from 'node:fs';
|
|
4
|
-
import path from 'node:path';
|
|
5
|
-
import { spawnSync } from 'node:child_process';
|
|
6
|
-
import { fileURLToPath } from 'node:url';
|
|
7
|
-
import {
|
|
8
|
-
initWorkspace,
|
|
9
|
-
getWorkspaceInfo,
|
|
10
|
-
listProjects,
|
|
11
|
-
resolveProject,
|
|
12
|
-
getProjectsDir,
|
|
13
|
-
getWorkspaceProjectsMemoryDir,
|
|
14
|
-
} from '../lib/workspace.mjs';
|
|
15
|
-
|
|
16
|
-
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
17
|
-
const root = path.resolve(__dirname, '..');
|
|
18
|
-
|
|
19
|
-
const DESIGN_REQUIRED = [
|
|
20
|
-
'Feature/superficie',
|
|
21
|
-
'Persona principal',
|
|
22
|
-
'Objetivo da UI',
|
|
23
|
-
'Referencia primaria',
|
|
24
|
-
'Principios aplicados',
|
|
25
|
-
'Tokens visuais',
|
|
26
|
-
'Componentes esperados',
|
|
27
|
-
'Estados obrigatorios',
|
|
28
|
-
'Criterios de aceite visual',
|
|
29
|
-
];
|
|
30
|
-
|
|
31
|
-
const SURFACE_MAP = {
|
|
32
|
-
'agent-console': ['linear.app', 'cursor', 'raycast', 'sentry', 'posthog', 'claude'],
|
|
33
|
-
ops: ['linear.app', 'cursor', 'raycast', 'sentry', 'posthog', 'claude'],
|
|
34
|
-
dashboard: ['stripe', 'linear.app', 'posthog', 'sentry', 'supabase'],
|
|
35
|
-
docs: ['mintlify', 'stripe', 'vercel', 'resend', 'supabase', 'hashicorp'],
|
|
36
|
-
landing: ['vercel', 'stripe', 'resend', 'cursor', 'x.ai', 'cohere'],
|
|
37
|
-
tool: ['figma', 'miro', 'notion', 'raycast', 'linear.app'],
|
|
38
|
-
fintech: ['wise', 'revolut', 'coinbase', 'stripe', 'kraken'],
|
|
39
|
-
premium: ['apple', 'bmw', 'ferrari', 'tesla', 'lamborghini'],
|
|
40
|
-
};
|
|
41
|
-
|
|
42
|
-
const GSD_HANDOFFS = {
|
|
43
|
-
spec: {
|
|
44
|
-
from: 'orchestrator',
|
|
45
|
-
to: 'product',
|
|
46
|
-
intent: 'spec',
|
|
47
|
-
acceptance: 'spec.md preenchido com problema, escopo dentro/fora, AC testaveis e metrica 30d.',
|
|
48
|
-
constraints: 'pt-BR; nao implementar codigo; registrar ambiguidades no proprio spec.md.',
|
|
49
|
-
return: 'orchestrator',
|
|
50
|
-
},
|
|
51
|
-
plan: {
|
|
52
|
-
from: 'product',
|
|
53
|
-
to: 'sdd-architect',
|
|
54
|
-
intent: 'plan',
|
|
55
|
-
acceptance: 'plan.md criado com abordagem, impactos, ADRs necessarias e riscos explicitos.',
|
|
56
|
-
constraints: 'exige spec.md em approved; nao implementar codigo.',
|
|
57
|
-
return: 'orchestrator',
|
|
58
|
-
},
|
|
59
|
-
implement: {
|
|
60
|
-
from: 'sdd-architect',
|
|
61
|
-
to: 'worker',
|
|
62
|
-
intent: 'implement',
|
|
63
|
-
acceptance: 'tasks.md executado com ownership claro, testes relevantes e sem alterar escopo fora da feature.',
|
|
64
|
-
constraints: 'respeitar arquivos de outros agentes; nao reverter mudancas externas.',
|
|
65
|
-
return: 'governance',
|
|
66
|
-
},
|
|
67
|
-
review: {
|
|
68
|
-
from: 'worker',
|
|
69
|
-
to: 'governance',
|
|
70
|
-
intent: 'review',
|
|
71
|
-
acceptance: 'project:check, spec:check e testes aplicaveis executados; riscos e pendencias reportados.',
|
|
72
|
-
constraints: 'bloquear release se faltar handoff, AC verificavel, seguranca ou conformidade basica.',
|
|
73
|
-
return: 'orchestrator',
|
|
74
|
-
},
|
|
75
|
-
};
|
|
76
|
-
|
|
77
|
-
function fail(message, code = 1) {
|
|
78
|
-
console.error(message);
|
|
79
|
-
process.exit(code);
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
function rel(file) {
|
|
83
|
-
return path.relative(root, file);
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
function readText(file) {
|
|
87
|
-
const full = path.resolve(root, file);
|
|
88
|
-
if (!full.startsWith(root)) fail(`Caminho fora do projeto: ${file}`);
|
|
89
|
-
if (!fs.existsSync(full)) fail(`Arquivo nao encontrado: ${file}`);
|
|
90
|
-
return fs.readFileSync(full, 'utf8');
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
// --- Codegraph (ADR-0017): code intelligence como gate do GSD ---
|
|
94
|
-
|
|
95
|
-
function runCodegraph(args) {
|
|
96
|
-
const result = spawnSync('codegraph', args, { cwd: root, encoding: 'utf8' });
|
|
97
|
-
if (result.error && result.error.code === 'ENOENT') {
|
|
98
|
-
return { missing: true };
|
|
99
|
-
}
|
|
100
|
-
if (result.error && result.error.code === 'EPERM') {
|
|
101
|
-
const quote = (value) => `'${String(value).replace(/'/g, `'\\''`)}'`;
|
|
102
|
-
const fallback = spawnSync('/bin/sh', ['-lc', ['codegraph', ...args.map(quote)].join(' ')], {
|
|
103
|
-
cwd: root,
|
|
104
|
-
encoding: 'utf8',
|
|
105
|
-
});
|
|
106
|
-
return {
|
|
107
|
-
missing: false,
|
|
108
|
-
status: fallback.status ?? 1,
|
|
109
|
-
stdout: (fallback.stdout || '').trim(),
|
|
110
|
-
stderr: (fallback.stderr || fallback.error?.message || '').trim(),
|
|
111
|
-
};
|
|
112
|
-
}
|
|
113
|
-
return {
|
|
114
|
-
missing: false,
|
|
115
|
-
status: result.status ?? 1,
|
|
116
|
-
stdout: (result.stdout || '').trim(),
|
|
117
|
-
stderr: (result.stderr || '').trim(),
|
|
118
|
-
};
|
|
119
|
-
}
|
|
120
|
-
|
|
121
|
-
// Lê `codegraph status --json` de forma tolerante. Retorna um diagnóstico
|
|
122
|
-
// normalizado que `code:check` e `gsd:check` reutilizam.
|
|
123
|
-
function codegraphStatus() {
|
|
124
|
-
const res = runCodegraph(['status', '--json']);
|
|
125
|
-
if (res.missing) return { missing: true };
|
|
126
|
-
let data = null;
|
|
127
|
-
try {
|
|
128
|
-
data = JSON.parse(res.stdout);
|
|
129
|
-
} catch {
|
|
130
|
-
return { missing: false, parseError: true, raw: res.stdout || res.stderr };
|
|
131
|
-
}
|
|
132
|
-
const pending = data.pendingChanges || {};
|
|
133
|
-
const pendingTotal = (pending.added || 0) + (pending.modified || 0) + (pending.removed || 0);
|
|
134
|
-
return {
|
|
135
|
-
missing: false,
|
|
136
|
-
initialized: Boolean(data.initialized),
|
|
137
|
-
worktreeMismatch: data.worktreeMismatch || null,
|
|
138
|
-
lastIndexed: data.lastIndexed || null,
|
|
139
|
-
fileCount: data.fileCount || 0,
|
|
140
|
-
pendingTotal,
|
|
141
|
-
reindexRecommended: Boolean(data.index && data.index.reindexRecommended),
|
|
142
|
-
};
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
function cmdCodeCheck() {
|
|
146
|
-
const s = codegraphStatus();
|
|
147
|
-
if (s.missing) {
|
|
148
|
-
console.log('Codegraph nao instalado no PATH. Gate de code intelligence ignorado.');
|
|
149
|
-
console.log('Instale com: npm i -g @codegraph/cli (ou veja docs/agent-harnesses.md)');
|
|
150
|
-
process.exit(0); // degradacao graciosa: nao bloqueia o fluxo
|
|
151
|
-
}
|
|
152
|
-
if (s.parseError) {
|
|
153
|
-
console.log('Codegraph respondeu, mas status --json nao pode ser lido.');
|
|
154
|
-
console.log(s.raw || 'sem saida');
|
|
155
|
-
fail('\nResultado: status do codegraph ilegivel.');
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
const lines = [];
|
|
159
|
-
let blocking = false;
|
|
160
|
-
|
|
161
|
-
if (!s.initialized) {
|
|
162
|
-
blocking = true;
|
|
163
|
-
lines.push('FAIL indice ausente: rode `npm run code:index` neste worktree.');
|
|
164
|
-
} else {
|
|
165
|
-
lines.push(`OK indice inicializado (${s.fileCount} arquivos).`);
|
|
166
|
-
}
|
|
167
|
-
|
|
168
|
-
if (s.worktreeMismatch) {
|
|
169
|
-
blocking = true;
|
|
170
|
-
lines.push(`FAIL indice pertence a outro worktree: ${s.worktreeMismatch}. Rode \`codegraph init -i\` aqui.`);
|
|
171
|
-
} else if (s.initialized) {
|
|
172
|
-
lines.push('OK indice pertence a este worktree.');
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
if (s.pendingTotal > 0 || s.reindexRecommended) {
|
|
176
|
-
lines.push(`WARN indice defasado (${s.pendingTotal} mudanca(s) pendente(s)). Rode \`npm run code:sync\`.`);
|
|
177
|
-
} else if (s.initialized) {
|
|
178
|
-
lines.push('OK indice em dia.');
|
|
179
|
-
}
|
|
180
|
-
|
|
181
|
-
console.log('Codegraph check:\n');
|
|
182
|
-
for (const line of lines) console.log(line);
|
|
183
|
-
if (blocking) fail('\nResultado: gate de code intelligence reprovado.');
|
|
184
|
-
console.log('\nResultado: code intelligence confiavel.');
|
|
185
|
-
}
|
|
186
|
-
|
|
187
|
-
function cmdCodeImpact([symbol, depthArg]) {
|
|
188
|
-
if (!symbol) fail('Uso: agent-harness code:impact <simbolo> [profundidade]');
|
|
189
|
-
const res0 = runCodegraph(['status', '--json']);
|
|
190
|
-
if (res0.missing) {
|
|
191
|
-
console.log('Codegraph nao instalado. Sem mapa de impacto automatico.');
|
|
192
|
-
console.log(`Fallback manual: grep -rn "${symbol}" . e leia os chamadores antes de editar.`);
|
|
193
|
-
process.exit(0);
|
|
194
|
-
}
|
|
195
|
-
const depth = String(parseInt(depthArg, 10) || 2);
|
|
196
|
-
console.log(`Mapa de impacto: ${symbol} (profundidade ${depth})\n`);
|
|
197
|
-
const impact = runCodegraph(['impact', symbol, '-d', depth]);
|
|
198
|
-
if (impact.stdout) console.log(impact.stdout);
|
|
199
|
-
if (impact.stderr) console.error(impact.stderr);
|
|
200
|
-
|
|
201
|
-
// Complemento: chamadores diretos, util quando impact vem vazio.
|
|
202
|
-
const callers = runCodegraph(['callers', symbol]);
|
|
203
|
-
if (callers.stdout) {
|
|
204
|
-
console.log('\n--- Chamadores diretos ---');
|
|
205
|
-
console.log(callers.stdout);
|
|
206
|
-
}
|
|
207
|
-
if (!impact.stdout && !callers.stdout) {
|
|
208
|
-
console.log('Nenhum no encontrado. Confirme o nome do simbolo ou rode `npm run code:sync`.');
|
|
209
|
-
}
|
|
210
|
-
}
|
|
211
|
-
|
|
212
|
-
function cmdDesignCheck([briefPath]) {
|
|
213
|
-
if (!briefPath) fail('Uso: agent-harness design:check <brief.md>');
|
|
214
|
-
const content = readText(briefPath);
|
|
215
|
-
const missing = DESIGN_REQUIRED.filter((needle) => !content.includes(needle));
|
|
216
|
-
const placeholders = (content.match(/<[^>\n]+>/g) || []).length;
|
|
217
|
-
|
|
218
|
-
console.log(`Design brief: ${briefPath}`);
|
|
219
|
-
if (missing.length) {
|
|
220
|
-
console.log('\nCampos ausentes:');
|
|
221
|
-
for (const item of missing) console.log(`- ${item}`);
|
|
222
|
-
}
|
|
223
|
-
if (placeholders) console.log(`\nPlaceholders restantes: ${placeholders}`);
|
|
224
|
-
|
|
225
|
-
if (missing.length || placeholders) {
|
|
226
|
-
fail('\nResultado: incompleto para handoff de implementacao.');
|
|
227
|
-
}
|
|
228
|
-
console.log('\nResultado: pronto para handoff visual.');
|
|
229
|
-
}
|
|
230
|
-
|
|
231
|
-
function cmdDesignSelect([surface = 'agent-console', tone = 'tecnico']) {
|
|
232
|
-
const normalized = surface.toLowerCase();
|
|
233
|
-
const refs = SURFACE_MAP[normalized] || SURFACE_MAP.tool;
|
|
234
|
-
console.log(`Superficie: ${surface}`);
|
|
235
|
-
console.log(`Tom: ${tone}`);
|
|
236
|
-
console.log('\nReferencias recomendadas:');
|
|
237
|
-
refs.forEach((name, index) => {
|
|
238
|
-
const file = path.join(root, 'design-md', name, 'README.md');
|
|
239
|
-
const status = fs.existsSync(file) ? rel(file) : 'sem cache local (use o conhecimento publico da referencia)';
|
|
240
|
-
console.log(`${index + 1}. ${name} - ${status}`);
|
|
241
|
-
});
|
|
242
|
-
console.log('\nProximo passo: preencher design-md/BRIEF-TEMPLATE.md com uma referencia primaria.');
|
|
243
|
-
}
|
|
244
|
-
|
|
245
|
-
function cmdHermesHandoff([jsonArg]) {
|
|
246
|
-
if (!jsonArg) fail('Uso: agent-harness hermes:handoff \'<json ADR-0005>\'');
|
|
247
|
-
let payload;
|
|
248
|
-
try {
|
|
249
|
-
payload = JSON.parse(jsonArg);
|
|
250
|
-
} catch (error) {
|
|
251
|
-
fail(`JSON invalido: ${error.message}`);
|
|
252
|
-
}
|
|
253
|
-
|
|
254
|
-
const required = ['from', 'to', 'intent', 'context', 'acceptance', 'constraints', 'return'];
|
|
255
|
-
const missing = required.filter((field) => !payload[field] || typeof payload[field] !== 'string');
|
|
256
|
-
if (missing.length) fail(`Campos ADR-0005 ausentes: ${missing.join(', ')}`);
|
|
257
|
-
|
|
258
|
-
const result = spawnSync('node', ['scripts/agent-router.mjs', 'append', JSON.stringify(payload)], {
|
|
259
|
-
cwd: root,
|
|
260
|
-
encoding: 'utf8',
|
|
261
|
-
});
|
|
262
|
-
if (result.stdout) process.stdout.write(result.stdout);
|
|
263
|
-
if (result.stderr) process.stderr.write(result.stderr);
|
|
264
|
-
process.exit(result.status ?? 1);
|
|
265
|
-
}
|
|
266
|
-
|
|
267
|
-
function appendHandoff(payload) {
|
|
268
|
-
const result = spawnSync('node', ['scripts/agent-router.mjs', 'append', JSON.stringify(payload)], {
|
|
269
|
-
cwd: root,
|
|
270
|
-
encoding: 'utf8',
|
|
271
|
-
});
|
|
272
|
-
if (result.stdout) process.stdout.write(result.stdout);
|
|
273
|
-
if (result.stderr) process.stderr.write(result.stderr);
|
|
274
|
-
return result.status ?? 1;
|
|
275
|
-
}
|
|
276
|
-
|
|
277
|
-
function cmdGsdPlan([slug = 'run', ...goalParts]) {
|
|
278
|
-
const goal = goalParts.join(' ') || 'execucao orientada por agentes';
|
|
279
|
-
const safeSlug = slug.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
|
|
280
|
-
const outDir = path.join(root, '.context');
|
|
281
|
-
fs.mkdirSync(outDir, { recursive: true });
|
|
282
|
-
const outFile = path.join(outDir, `gsd-${safeSlug}.md`);
|
|
283
|
-
const specPath = path.join(root, 'specs', safeSlug, 'spec.md');
|
|
284
|
-
const hasSpec = fs.existsSync(specPath);
|
|
285
|
-
|
|
286
|
-
const content = `# GSD Runbook: ${safeSlug}
|
|
287
|
-
|
|
288
|
-
- **Objetivo**: ${goal}
|
|
289
|
-
- **Spec**: ${hasSpec ? rel(specPath) : 'nao encontrada'}
|
|
290
|
-
- **Gerado em**: ${new Date().toISOString()}
|
|
291
|
-
|
|
292
|
-
## Gates
|
|
293
|
-
|
|
294
|
-
- [ ] 1. Briefing: nome, objetivo, contexto, usuarios/papeis, riscos, primeira entrega esperada e slug gerado.
|
|
295
|
-
- [ ] 2. Estrutura: pastas, memoria, specs, agentes, scripts, dashboard e dependencias conferidos.
|
|
296
|
-
- [ ] 3. Sprints: sprint atual, proxima sprint, backlog e metrica 30d definidos.
|
|
297
|
-
- [ ] 4. Contexto: \`npm run dev -- context:build task ${safeSlug} "<keyword>"\`.
|
|
298
|
-
- [ ] 5. Mapa de impacto: \`npm run code:check\` e \`npm run code:impact <simbolo>\` para o blast radius antes de planejar/editar (ADR-0017).
|
|
299
|
-
- [ ] 6. Spec: problema, escopo e AC testaveis em \`specs/${safeSlug}/spec.md\`.
|
|
300
|
-
- [ ] 7. Design: brief aprovado via \`npm run dev -- design:check <brief.md>\`.
|
|
301
|
-
- [ ] 8. Plano: plan/tasks aprovados quando houver impacto estrutural.
|
|
302
|
-
- [ ] 9. Desenvolvimento: ownership de arquivos definido antes do Worker.
|
|
303
|
-
- [ ] 10. Validacao: \`npm run dev -- gsd:check ${safeSlug} <brief.md>\` e \`npm test\`.
|
|
304
|
-
- [ ] 11. Governance: \`npm run project:check -- <projeto>\` quando houver projeto alvo.
|
|
305
|
-
|
|
306
|
-
## Hermes handoffs sugeridos
|
|
307
|
-
|
|
308
|
-
1. \`npm run gsd:handoff -- spec ${safeSlug}\`
|
|
309
|
-
2. \`npm run gsd:handoff -- plan ${safeSlug}\`
|
|
310
|
-
3. \`npm run gsd:handoff -- implement ${safeSlug}\`
|
|
311
|
-
4. \`npm run gsd:handoff -- review ${safeSlug}\`
|
|
312
|
-
|
|
313
|
-
## Notas
|
|
314
|
-
|
|
315
|
-
- Use Hermes para registrar cada passagem com os 7 campos do ADR-0005.
|
|
316
|
-
- Antes de editar codigo, rode \`npm run code:impact -- <simbolo>\` para ver chamadores e blast radius (ADR-0017).
|
|
317
|
-
- Use \`design-md/MATRIX.md\` para escolher referencia visual antes de construir UI.
|
|
318
|
-
- Rode \`npm run gsd:check -- ${safeSlug} <brief.md>\` antes de entregar para Governance.
|
|
319
|
-
`;
|
|
320
|
-
|
|
321
|
-
fs.writeFileSync(outFile, content, 'utf8');
|
|
322
|
-
console.log(`GSD runbook criado: ${rel(outFile)}`);
|
|
323
|
-
if (!hasSpec) console.log(`Aviso: spec nao encontrada em specs/${safeSlug}/spec.md`);
|
|
324
|
-
}
|
|
325
|
-
|
|
326
|
-
function cmdGsdHandoff([phase, slug, ...contextParts]) {
|
|
327
|
-
if (!phase || !slug) fail('Uso: agent-harness gsd:handoff <spec|plan|implement|review> <slug> [contexto]');
|
|
328
|
-
const template = GSD_HANDOFFS[phase];
|
|
329
|
-
if (!template) fail(`Fase invalida: ${phase}. Use: ${Object.keys(GSD_HANDOFFS).join('|')}`);
|
|
330
|
-
|
|
331
|
-
const safeSlug = slug.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
|
|
332
|
-
const specDir = path.join(root, 'specs', safeSlug);
|
|
333
|
-
const runbook = path.join(root, '.context', `gsd-${safeSlug}.md`);
|
|
334
|
-
const contextExtra = contextParts.join(' ').trim();
|
|
335
|
-
const context = [
|
|
336
|
-
fs.existsSync(specDir) ? `specs/${safeSlug}` : `specs/${safeSlug} (nao encontrado)`,
|
|
337
|
-
fs.existsSync(runbook) ? rel(runbook) : `.context/gsd-${safeSlug}.md (nao encontrado)`,
|
|
338
|
-
contextExtra,
|
|
339
|
-
].filter(Boolean).join('; ');
|
|
340
|
-
|
|
341
|
-
const payload = {
|
|
342
|
-
...template,
|
|
343
|
-
context,
|
|
344
|
-
spec_slug: safeSlug,
|
|
345
|
-
};
|
|
346
|
-
|
|
347
|
-
process.exit(appendHandoff(payload));
|
|
348
|
-
}
|
|
349
|
-
|
|
350
|
-
function cmdGsdCheck([slug, briefPath]) {
|
|
351
|
-
if (!slug) fail('Uso: agent-harness gsd:check <slug> [brief.md]');
|
|
352
|
-
const safeSlug = slug.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
|
|
353
|
-
const checks = [];
|
|
354
|
-
|
|
355
|
-
const runbook = path.join(root, '.context', `gsd-${safeSlug}.md`);
|
|
356
|
-
checks.push({
|
|
357
|
-
name: 'GSD runbook',
|
|
358
|
-
ok: fs.existsSync(runbook),
|
|
359
|
-
detail: rel(runbook),
|
|
360
|
-
});
|
|
361
|
-
|
|
362
|
-
const specDir = path.join(root, 'specs', safeSlug);
|
|
363
|
-
checks.push({
|
|
364
|
-
name: 'Spec directory',
|
|
365
|
-
ok: fs.existsSync(specDir),
|
|
366
|
-
detail: `specs/${safeSlug}`,
|
|
367
|
-
});
|
|
368
|
-
|
|
369
|
-
const specCheck = spawnSync('node', ['scripts/spec-cli.mjs', 'check', safeSlug], {
|
|
370
|
-
cwd: root,
|
|
371
|
-
encoding: 'utf8',
|
|
372
|
-
});
|
|
373
|
-
checks.push({
|
|
374
|
-
name: 'SDD spec check',
|
|
375
|
-
ok: specCheck.status === 0,
|
|
376
|
-
detail: (specCheck.stdout || specCheck.stderr || '').trim() || 'sem saida',
|
|
377
|
-
});
|
|
378
|
-
|
|
379
|
-
// Gate de code intelligence (ADR-0017): nao-bloqueante se codegraph ausente,
|
|
380
|
-
// bloqueante se o indice pertence a outro worktree.
|
|
381
|
-
const cg = codegraphStatus();
|
|
382
|
-
if (cg.missing) {
|
|
383
|
-
checks.push({ name: 'Codegraph', ok: true, detail: 'codegraph ausente; gate ignorado' });
|
|
384
|
-
} else if (cg.parseError) {
|
|
385
|
-
checks.push({ name: 'Codegraph', ok: true, detail: 'status ilegivel; verifique com npm run code:check' });
|
|
386
|
-
} else if (cg.worktreeMismatch) {
|
|
387
|
-
checks.push({ name: 'Codegraph', ok: false, detail: `indice de outro worktree (${cg.worktreeMismatch}); rode codegraph init -i` });
|
|
388
|
-
} else if (!cg.initialized) {
|
|
389
|
-
checks.push({ name: 'Codegraph', ok: true, detail: 'indice ausente; rode npm run code:index para habilitar blast radius' });
|
|
390
|
-
} else {
|
|
391
|
-
const stale = cg.pendingTotal > 0 || cg.reindexRecommended;
|
|
392
|
-
checks.push({ name: 'Codegraph', ok: true, detail: stale ? `indice defasado (${cg.pendingTotal} pend.); rode npm run code:sync` : 'indice em dia' });
|
|
393
|
-
}
|
|
394
|
-
|
|
395
|
-
if (briefPath) {
|
|
396
|
-
const fullBrief = path.resolve(root, briefPath);
|
|
397
|
-
let ok = false;
|
|
398
|
-
let detail = briefPath;
|
|
399
|
-
if (fullBrief.startsWith(root) && fs.existsSync(fullBrief)) {
|
|
400
|
-
const content = fs.readFileSync(fullBrief, 'utf8');
|
|
401
|
-
const missing = DESIGN_REQUIRED.filter((needle) => !content.includes(needle));
|
|
402
|
-
const placeholders = (content.match(/<[^>\n]+>/g) || []).length;
|
|
403
|
-
ok = missing.length === 0 && placeholders === 0;
|
|
404
|
-
detail = ok ? briefPath : `${briefPath}; missing=${missing.join(',') || 'none'}; placeholders=${placeholders}`;
|
|
405
|
-
} else {
|
|
406
|
-
detail = `${briefPath} nao encontrado`;
|
|
407
|
-
}
|
|
408
|
-
checks.push({ name: 'Design brief', ok, detail });
|
|
409
|
-
} else {
|
|
410
|
-
checks.push({ name: 'Design brief', ok: true, detail: 'nao aplicavel em fluxo CLI-only' });
|
|
411
|
-
}
|
|
412
|
-
|
|
413
|
-
console.log(`GSD check: ${safeSlug}\n`);
|
|
414
|
-
for (const check of checks) {
|
|
415
|
-
console.log(`${check.ok ? 'OK ' : 'FAIL'} ${check.name}: ${check.detail}`);
|
|
416
|
-
}
|
|
417
|
-
|
|
418
|
-
const failed = checks.filter((check) => !check.ok);
|
|
419
|
-
if (failed.length) fail(`\nResultado: ${failed.length} gate(s) pendente(s).`);
|
|
420
|
-
console.log('\nResultado: gates basicos prontos.');
|
|
421
|
-
}
|
|
422
|
-
|
|
423
|
-
function cmdWorkspaceInit() {
|
|
424
|
-
const infoBefore = getWorkspaceInfo();
|
|
425
|
-
const rootDir = initWorkspace();
|
|
426
|
-
const infoAfter = getWorkspaceInfo();
|
|
427
|
-
console.log(`Workspace inicializado: ${rootDir}`);
|
|
428
|
-
console.log(`Fonte da configuração: ${infoAfter.source}`);
|
|
429
|
-
console.log('Estrutura criada:');
|
|
430
|
-
console.log(` ${path.join(rootDir, 'projects')}`);
|
|
431
|
-
console.log(` ${path.join(rootDir, 'memory/sqlite')}`);
|
|
432
|
-
console.log(` ${path.join(rootDir, 'memory/30-projects')}`);
|
|
433
|
-
console.log(` ${path.join(rootDir, 'specs')}`);
|
|
434
|
-
console.log(` ${path.join(rootDir, '.context')}`);
|
|
435
|
-
if (!infoBefore.exists) {
|
|
436
|
-
console.log('\nPróximo passo: npm run dev -- project:new <nome>');
|
|
437
|
-
}
|
|
438
|
-
}
|
|
439
|
-
|
|
440
|
-
function cmdProjectNew([name, ...rest]) {
|
|
441
|
-
if (!name) fail('Uso: agent-harness project:new <nome> [--ai claude,copilot] [--skip-backend]');
|
|
442
|
-
const safeName = name.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
|
|
443
|
-
const projectDir = resolveProject(safeName);
|
|
444
|
-
if (fs.existsSync(projectDir)) {
|
|
445
|
-
fail(`Projeto ja existe no workspace: ${projectDir}`);
|
|
446
|
-
}
|
|
447
|
-
|
|
448
|
-
// Repassa flags para init-project.js
|
|
449
|
-
const result = spawnSync('node', [path.join(root, 'bin/init-project.js'), safeName, ...rest], {
|
|
450
|
-
cwd: root,
|
|
451
|
-
encoding: 'utf8',
|
|
452
|
-
stdio: 'inherit',
|
|
453
|
-
});
|
|
454
|
-
const status = result.status ?? 1;
|
|
455
|
-
if (status === 0) {
|
|
456
|
-
registerProjectCard(safeName, projectDir, rest);
|
|
457
|
-
}
|
|
458
|
-
process.exit(status);
|
|
459
|
-
}
|
|
460
|
-
|
|
461
|
-
// Ficha automática no workspace (ADR-0020): todo projeto nasce rastreado.
|
|
462
|
-
function registerProjectCard(name, projectDir, flags) {
|
|
463
|
-
try {
|
|
464
|
-
const cardsDir = getWorkspaceProjectsMemoryDir();
|
|
465
|
-
fs.mkdirSync(cardsDir, { recursive: true });
|
|
466
|
-
const cardPath = path.join(cardsDir, `${name}.md`);
|
|
467
|
-
if (fs.existsSync(cardPath)) return;
|
|
468
|
-
fs.writeFileSync(
|
|
469
|
-
cardPath,
|
|
470
|
-
`# Projeto: ${name}
|
|
471
|
-
|
|
472
|
-
- **Status**: ativo
|
|
473
|
-
- **Criado em**: ${new Date().toISOString().slice(0, 10)}
|
|
474
|
-
- **Path**: ${projectDir}
|
|
475
|
-
- **Origem**: forja project:new${flags.length ? ` (${flags.join(' ')})` : ''}
|
|
476
|
-
|
|
477
|
-
## Notas
|
|
478
|
-
|
|
479
|
-
- Ficha criada automaticamente pelo core (ADR-0020). Complete com objetivo, stack e métrica 30d.
|
|
480
|
-
`,
|
|
481
|
-
'utf8'
|
|
482
|
-
);
|
|
483
|
-
console.log(`Ficha registrada: ${cardPath}`);
|
|
484
|
-
} catch (error) {
|
|
485
|
-
console.error(`Aviso: não foi possível registrar a ficha do projeto (${error.message}).`);
|
|
486
|
-
}
|
|
487
|
-
}
|
|
488
|
-
|
|
489
|
-
function cmdProjectList() {
|
|
490
|
-
const info = getWorkspaceInfo();
|
|
491
|
-
const projects = listProjects();
|
|
492
|
-
console.log(`Workspace: ${info.root} (${info.source})`);
|
|
493
|
-
console.log(`Projetos: ${projects.length}`);
|
|
494
|
-
if (!projects.length) {
|
|
495
|
-
console.log(' (nenhum projeto ainda)');
|
|
496
|
-
} else {
|
|
497
|
-
for (const name of projects) {
|
|
498
|
-
console.log(` • ${name}`);
|
|
499
|
-
}
|
|
500
|
-
}
|
|
501
|
-
}
|
|
502
|
-
|
|
503
|
-
function cmdProjectCheck([name]) {
|
|
504
|
-
if (!name) fail('Uso: agent-harness project:check <nome>');
|
|
505
|
-
const result = spawnSync('node', [path.join(root, 'scripts/check-standards.js'), name], {
|
|
506
|
-
cwd: root,
|
|
507
|
-
encoding: 'utf8',
|
|
508
|
-
stdio: 'inherit',
|
|
509
|
-
});
|
|
510
|
-
process.exit(result.status ?? 1);
|
|
511
|
-
}
|
|
512
|
-
|
|
513
|
-
function showHelp() {
|
|
514
|
-
console.log(`Uso: node scripts/agent-harness.mjs <command> [args]
|
|
515
|
-
|
|
516
|
-
Workspace:
|
|
517
|
-
workspace:init Cria estrutura base do workspace Forja
|
|
518
|
-
project:new <nome> Cria projeto no workspace
|
|
519
|
-
project:list Lista projetos do workspace
|
|
520
|
-
project:check <nome> Valida padroes no projeto do workspace
|
|
521
|
-
|
|
522
|
-
Pipeline / Handoffs:
|
|
523
|
-
gsd:plan <slug> [objetivo] Cria runbook GSD em .context/
|
|
524
|
-
gsd:handoff <fase> <slug> Registra handoff GSD padronizado
|
|
525
|
-
gsd:check <slug> [brief.md] Valida gates basicos do runbook
|
|
526
|
-
hermes:handoff '<json>' Registra handoff ADR-0005 via agent-router
|
|
527
|
-
|
|
528
|
-
Design / Code intelligence:
|
|
529
|
-
design:check <brief.md> Valida brief visual local
|
|
530
|
-
design:select <surface> [tom] Sugere referencias design-md
|
|
531
|
-
code:check Valida indice codegraph (worktree + freshness)
|
|
532
|
-
code:impact <simbolo> [depth] Mostra chamadores e blast radius via codegraph
|
|
533
|
-
`);
|
|
534
|
-
}
|
|
535
|
-
|
|
536
|
-
const [command, ...args] = process.argv.slice(2);
|
|
537
|
-
|
|
538
|
-
switch (command) {
|
|
539
|
-
case 'workspace:init':
|
|
540
|
-
cmdWorkspaceInit();
|
|
541
|
-
break;
|
|
542
|
-
case 'project:new':
|
|
543
|
-
cmdProjectNew(args);
|
|
544
|
-
break;
|
|
545
|
-
case 'project:list':
|
|
546
|
-
cmdProjectList();
|
|
547
|
-
break;
|
|
548
|
-
case 'project:check':
|
|
549
|
-
cmdProjectCheck(args);
|
|
550
|
-
break;
|
|
551
|
-
case 'design:check':
|
|
552
|
-
cmdDesignCheck(args);
|
|
553
|
-
break;
|
|
554
|
-
case 'design:select':
|
|
555
|
-
cmdDesignSelect(args);
|
|
556
|
-
break;
|
|
557
|
-
case 'hermes:handoff':
|
|
558
|
-
cmdHermesHandoff(args);
|
|
559
|
-
break;
|
|
560
|
-
case 'gsd:plan':
|
|
561
|
-
cmdGsdPlan(args);
|
|
562
|
-
break;
|
|
563
|
-
case 'gsd:handoff':
|
|
564
|
-
cmdGsdHandoff(args);
|
|
565
|
-
break;
|
|
566
|
-
case 'gsd:check':
|
|
567
|
-
cmdGsdCheck(args);
|
|
568
|
-
break;
|
|
569
|
-
case 'code:check':
|
|
570
|
-
cmdCodeCheck(args);
|
|
571
|
-
break;
|
|
572
|
-
case 'code:impact':
|
|
573
|
-
cmdCodeImpact(args);
|
|
574
|
-
break;
|
|
575
|
-
default:
|
|
576
|
-
showHelp();
|
|
577
|
-
process.exit(command ? 1 : 0);
|
|
578
|
-
}
|