forjajs 4.1.2 → 5.0.1
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 +2 -2
- package/.gemini-instructions.md +1 -1
- package/.github/copilot-instructions.md +1 -1
- package/.openai-instructions.md +1 -1
- package/CHANGELOG.md +139 -0
- package/DOC-MAP.md +2 -2
- package/README.md +62 -10
- package/README.pt-BR.md +46 -7
- package/boilerplates/01-api-rest/README.md +1 -1
- package/boilerplates/06-clean-arch/README.md +5 -3
- package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
- package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
- package/boilerplates/06-clean-arch/backend/package.json +22 -24
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
- package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
- package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
- package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
- package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
- package/boilerplates/README.md +24 -44
- package/dist/apps/cli/src/index.js +6 -6
- package/dist/apps/dashboard/next.config.d.mts +5 -5
- package/dist/apps/server/src/app.module.js +1 -1
- package/dist/apps/server/src/forja-nest.module.js +1 -1
- package/dist/apps/server/src/index.js +1 -1
- package/dist/apps/server/src/main.js +20 -20
- package/dist/apps/worker/src/main.js +4 -4
- package/dist/bin/create-memory-nest-kit.js +5 -5
- package/dist/bin/forja.js +28 -14
- package/dist/bin/init-project.d.ts +4 -9
- package/dist/bin/init-project.js +126 -182
- package/dist/lib/audit.js +1 -1
- package/dist/lib/context-builder.d.ts +6 -1
- package/dist/lib/context-builder.js +21 -12
- package/dist/lib/core/architecture-gate.js +2 -4
- package/dist/lib/core/checks.d.ts +1 -1
- package/dist/lib/core/drift-gate.js +2 -4
- package/dist/lib/core/gates.js +5 -5
- package/dist/lib/core/health.d.ts +0 -1
- package/dist/lib/core/health.js +33 -7
- package/dist/lib/core/journey.d.ts +30 -0
- package/dist/lib/core/journey.js +142 -0
- package/dist/lib/core/model-pricing.js +3 -5
- package/dist/lib/core/project-smoke.d.ts +6 -2
- package/dist/lib/core/project-smoke.js +60 -61
- package/dist/lib/core/registry.d.ts +1 -12
- package/dist/lib/core/registry.js +42 -32
- package/dist/lib/core/release.d.ts +1 -1
- package/dist/lib/core/release.js +31 -3
- package/dist/lib/core/risk-collect.js +4 -4
- package/dist/lib/drift-sentinel.js +1 -1
- package/dist/lib/generators/memory-generator.d.ts +30 -30
- package/dist/lib/generators/memory-generator.js +19 -8
- package/dist/lib/generators/nest-generator.js +192 -275
- package/dist/lib/generators/readme-generator.js +1 -1
- package/dist/lib/governance-report.js +4 -4
- package/dist/lib/handoffs-index.d.ts +16 -2
- package/dist/lib/handoffs-index.js +32 -5
- package/dist/lib/llm/session.js +1 -1
- package/dist/lib/llm/validation.js +1 -1
- package/dist/lib/memory-audit.js +1 -1
- package/dist/lib/paths.d.ts +39 -0
- package/dist/lib/paths.js +73 -0
- package/dist/lib/project-upgrade.d.ts +0 -4
- package/dist/lib/project-upgrade.js +19 -1
- package/dist/lib/project-wiring.d.ts +54 -0
- package/dist/lib/project-wiring.js +391 -0
- package/dist/lib/status-model.js +18 -7
- package/dist/lib/templates.d.ts +24 -0
- package/dist/lib/templates.js +77 -0
- package/dist/lib/validators/structure-validator.js +0 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +20 -2
- package/dist/packages/adapter-git/src/index.js +2 -2
- package/dist/packages/context/src/index.js +1 -1
- package/dist/packages/core/src/index.js +1 -1
- package/dist/packages/evals/src/index.js +1 -1
- package/dist/packages/events/src/index.js +1 -1
- package/dist/packages/graph/src/index.js +1 -1
- package/dist/packages/mcp/src/index.d.ts +1 -1
- package/dist/packages/observability/src/index.js +1 -1
- package/dist/packages/orchestration/src/index.js +1 -1
- package/dist/packages/planner/src/index.js +1 -1
- package/dist/packages/policy/src/index.js +1 -1
- package/dist/packages/runtime/src/index.js +1 -1
- package/dist/packages/sandbox/src/index.js +1 -1
- package/dist/packages/validator/src/index.js +1 -1
- package/dist/scripts/adr.js +4 -4
- package/dist/scripts/agent-harness.js +30 -23
- package/dist/scripts/agent-router.js +22 -5
- package/dist/scripts/agent.js +5 -5
- package/dist/scripts/architecture.js +6 -6
- package/dist/scripts/audit-query.js +1 -1
- package/dist/scripts/audit-sync.js +1 -1
- package/dist/scripts/build-smart-context.d.ts +19 -1
- package/dist/scripts/build-smart-context.js +84 -68
- package/dist/scripts/check-standards.js +8 -3
- package/dist/scripts/code-context.js +1 -1
- package/dist/scripts/compress-memory.js +3 -2
- package/dist/scripts/compress-project-memory.js +2 -2
- package/dist/scripts/context-ops.js +13 -5
- package/dist/scripts/cost-economy.js +4 -4
- package/dist/scripts/demo-autonomy.js +11 -11
- package/dist/scripts/demo-workspace.js +12 -4
- package/dist/scripts/dev.js +8 -7
- package/dist/scripts/drift-check.js +5 -5
- package/dist/scripts/engineer.js +11 -11
- package/dist/scripts/evidence.js +4 -4
- package/dist/scripts/extract-global-knowledge.js +6 -4
- package/dist/scripts/forja-setup.js +2 -1
- package/dist/scripts/forja-status.js +5 -4
- package/dist/scripts/gates.js +1 -1
- package/dist/scripts/generate-dashboard.js +6 -4
- package/dist/scripts/governance-dashboard.js +2 -2
- package/dist/scripts/hook-session-start.js +11 -10
- package/dist/scripts/hook-user-prompt.js +3 -2
- package/dist/scripts/incident.js +4 -4
- package/dist/scripts/llm-fit.js +11 -11
- package/dist/scripts/memory-audit.js +1 -1
- package/dist/scripts/memory-schema.js +3 -2
- package/dist/scripts/orchestrate.js +4 -5
- package/dist/scripts/project-smoke.js +13 -2
- package/dist/scripts/project-templates.d.ts +1 -0
- package/dist/scripts/project-templates.js +20 -0
- package/dist/scripts/project-upgrade.d.ts +13 -0
- package/dist/scripts/project-upgrade.js +110 -40
- package/dist/scripts/project-wire.d.ts +8 -0
- package/dist/scripts/project-wire.js +55 -0
- package/dist/scripts/provenance.js +3 -3
- package/dist/scripts/query-universal-memory.js +7 -4
- package/dist/scripts/release-check.js +1 -1
- package/dist/scripts/risk.js +4 -4
- package/dist/scripts/simulate.js +9 -9
- package/dist/scripts/spec-cli.d.ts +1 -0
- package/dist/scripts/spec-cli.js +25 -5
- package/dist/scripts/sprint-manager.js +4 -3
- package/dist/scripts/sync-universal-memory.js +22 -15
- package/dist/scripts/token-benchmark.js +4 -3
- package/dist/scripts/token-economy.js +4 -3
- package/dist/scripts/tools-doctor.d.ts +1 -1
- package/dist/scripts/tools-doctor.js +25 -3
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
- package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
- package/docs/glossary.md +4 -4
- package/docs/init-project.md +88 -444
- package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
- package/docs/modos-de-operacao.md +1 -1
- package/docs/processo-projeto.md +14 -11
- package/docs/produto/roteiro-demo.md +15 -18
- package/docs/publishing.md +5 -0
- package/docs/quick-reference.md +15 -23
- package/docs/structure.md +16 -30
- package/lib/core/model-pricing.json +19 -0
- package/memory/30-projects/README.md +1 -1
- package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
- package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
- package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
- package/memory/90-decisions/0088-templates-validados.md +55 -0
- package/package.json +26 -26
- package/templates/project/AGENTS.md +75 -0
- package/templates/project/CLAUDE.md +9 -0
- package/templates/project/agents/context-engineer.md +15 -0
- package/templates/project/agents/governance.md +15 -0
- package/templates/project/agents/marketing.md +15 -0
- package/templates/project/agents/orchestrator.md +15 -0
- package/templates/project/agents/product.md +15 -0
- package/templates/project/agents/sdd-architect.md +15 -0
- package/dist/lib/multi-ai-instructions.d.ts +0 -28
- package/dist/lib/multi-ai-instructions.js +0 -83
|
@@ -55,7 +55,6 @@ export declare function defaultEnv(overrides?: {}): {
|
|
|
55
55
|
};
|
|
56
56
|
/** Estamos dentro do repo do framework, e não numa instalação do pacote? */
|
|
57
57
|
export declare function isFrameworkRepo(env: any): boolean;
|
|
58
|
-
/** @type {Check[]} */
|
|
59
58
|
export declare const CHECKS: Check[];
|
|
60
59
|
/**
|
|
61
60
|
* SPEC-043 (AC-7): em qual bloco cada resultado aparece no `tools:doctor` e no hook SessionStart.
|
package/dist/lib/core/health.js
CHANGED
|
@@ -35,18 +35,19 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
|
|
|
35
35
|
import fs from 'node:fs';
|
|
36
36
|
import path from 'node:path';
|
|
37
37
|
import { fileURLToPath } from 'node:url';
|
|
38
|
-
import { getWorkspaceDbPath, getWorkspaceInfo } from
|
|
39
|
-
import { runChecks as run, worstStatus, stripTemplateLiterals, asErrno } from
|
|
40
|
-
import { COMMANDS } from
|
|
41
|
-
import { scanCommands, scanLinks, projectCommands, scanAdrRefs, adrNumbers, commandCited } from
|
|
42
|
-
import { topologyIssues } from
|
|
43
|
-
import { CLI_INTERFACE_COMMANDS } from
|
|
38
|
+
import { getWorkspaceDbPath, getWorkspaceInfo } from '../workspace.js';
|
|
39
|
+
import { runChecks as run, worstStatus, stripTemplateLiterals, asErrno } from './checks.js';
|
|
40
|
+
import { COMMANDS } from './registry.js';
|
|
41
|
+
import { scanCommands, scanLinks, projectCommands, scanAdrRefs, adrNumbers, commandCited } from './doc-graph.js';
|
|
42
|
+
import { topologyIssues } from '../agent-topology.js';
|
|
43
|
+
import { CLI_INTERFACE_COMMANDS } from '../../apps/cli/src/index.js';
|
|
44
|
+
import { pkgRoot } from '../paths.js';
|
|
44
45
|
/** @typedef {import('./checks.ts').Status} Status */
|
|
45
46
|
// O runner vive em checks.mjs e é compartilhado com o catálogo de release (SPEC-010). Re-exportado
|
|
46
47
|
// aqui para que `tools:doctor` e o hook SessionStart sigam importando de um lugar só.
|
|
47
48
|
export { worstStatus };
|
|
48
49
|
const __filename = fileURLToPath(import.meta.url);
|
|
49
|
-
const repoRoot =
|
|
50
|
+
const repoRoot = pkgRoot;
|
|
50
51
|
/**
|
|
51
52
|
* Ambiente injetável. Existe para que os probes sejam testáveis sem mockar o loader de módulos
|
|
52
53
|
* do Node nem corromper `node_modules` de verdade — simular um ABI quebrado é passar um
|
|
@@ -597,6 +598,30 @@ const agentTopology = {
|
|
|
597
598
|
},
|
|
598
599
|
};
|
|
599
600
|
/** @type {Check[]} */
|
|
601
|
+
/** Handoffs abertos sem dono visível (sem projeto, ou de projeto que não existe mais). Higiene: avisa. */
|
|
602
|
+
const handoffOrphans = {
|
|
603
|
+
id: 'handoff-orphans',
|
|
604
|
+
title: 'todo handoff aberto pertence a um projeto existente',
|
|
605
|
+
severity: 'warn',
|
|
606
|
+
scope: 'runtime',
|
|
607
|
+
async probe(env) {
|
|
608
|
+
const info = env.workspace.info();
|
|
609
|
+
if (!info.exists)
|
|
610
|
+
return { status: 'skipped', detail: 'sem workspace', fix: null };
|
|
611
|
+
const { orphanHandoffs } = await import('../handoffs-index.js');
|
|
612
|
+
const { listProjects, getForjaMode, getWorkspaceRoot } = await import('../workspace.js');
|
|
613
|
+
const known = getForjaMode() === 'embedded' ? [path.basename(getWorkspaceRoot())] : listProjects();
|
|
614
|
+
const orphans = await orphanHandoffs(known);
|
|
615
|
+
if (!orphans.length)
|
|
616
|
+
return { status: 'ok', detail: 'nenhum handoff órfão', fix: null };
|
|
617
|
+
const ids = orphans.map((o) => `#${o.id}${o.project ? ` (${o.project})` : ''}`).join(', ');
|
|
618
|
+
return {
|
|
619
|
+
status: 'warn',
|
|
620
|
+
detail: `${orphans.length} handoff(s) aberto(s) sem projeto existente: ${ids}`,
|
|
621
|
+
fix: `revise com forja agent:route show <id> e feche com forja agent:route archive <id>`,
|
|
622
|
+
};
|
|
623
|
+
},
|
|
624
|
+
};
|
|
600
625
|
export const CHECKS = [
|
|
601
626
|
nativeAbi,
|
|
602
627
|
memoryDb,
|
|
@@ -610,6 +635,7 @@ export const CHECKS = [
|
|
|
610
635
|
docsLinks,
|
|
611
636
|
adrRefs,
|
|
612
637
|
agentTopology,
|
|
638
|
+
handoffOrphans,
|
|
613
639
|
];
|
|
614
640
|
const FIRST_RUN_CHECKS = new Set(['memory-db', 'memory-fresh', 'workspace']);
|
|
615
641
|
export function bucketFor(id) {
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/journey.ts — a jornada do usuário, executada de verdade (ADR-0086).
|
|
3
|
+
*
|
|
4
|
+
* Os checks de consumidor do release (spec:new, project:check, gsd:*) nasceram um por bug e
|
|
5
|
+
* provavam cada peça isolada. Nenhum provava o que o usuário de fato faz: criar um projeto e
|
|
6
|
+
* trabalhar nele com uma IA. Foi nessa lacuna que a v4 saiu com `project:new` gerando projetos
|
|
7
|
+
* sem instruções, scripts apontando para arquivos ausentes e `context:smart` sem modo task.
|
|
8
|
+
*
|
|
9
|
+
* `runJourney` cria workspace e projeto num HOME descartável e percorre o caminho feliz dentro do
|
|
10
|
+
* projeto — memória, contexto, specs, gates, hooks e MCP —, conferindo o EFEITO de cada passo, não
|
|
11
|
+
* só o exit code. Roda contra o fonte (`npm test`) e contra o pacote instalado (`release:check`).
|
|
12
|
+
*/
|
|
13
|
+
export interface JourneyStep {
|
|
14
|
+
readonly id: string;
|
|
15
|
+
readonly ok: boolean;
|
|
16
|
+
readonly detail: string;
|
|
17
|
+
}
|
|
18
|
+
export interface JourneyOptions {
|
|
19
|
+
/** Entry point do forja: `bin/forja.ts` (fonte) ou `<pkg>/dist/bin/forja.js` (instalado). */
|
|
20
|
+
readonly bin: string;
|
|
21
|
+
/** Raiz do pacote do Forja em teste: nada nela pode mudar durante a jornada. */
|
|
22
|
+
readonly pkgDir: string;
|
|
23
|
+
/** Versão esperada no handshake do MCP. */
|
|
24
|
+
readonly version: string;
|
|
25
|
+
/** Diretório base descartável; criado e removido se omitido. */
|
|
26
|
+
readonly baseDir?: string;
|
|
27
|
+
/** Mantém o diretório para inspeção (debug). */
|
|
28
|
+
readonly keep?: boolean;
|
|
29
|
+
}
|
|
30
|
+
export declare function runJourney(opts: JourneyOptions): JourneyStep[];
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/journey.ts — a jornada do usuário, executada de verdade (ADR-0086).
|
|
3
|
+
*
|
|
4
|
+
* Os checks de consumidor do release (spec:new, project:check, gsd:*) nasceram um por bug e
|
|
5
|
+
* provavam cada peça isolada. Nenhum provava o que o usuário de fato faz: criar um projeto e
|
|
6
|
+
* trabalhar nele com uma IA. Foi nessa lacuna que a v4 saiu com `project:new` gerando projetos
|
|
7
|
+
* sem instruções, scripts apontando para arquivos ausentes e `context:smart` sem modo task.
|
|
8
|
+
*
|
|
9
|
+
* `runJourney` cria workspace e projeto num HOME descartável e percorre o caminho feliz dentro do
|
|
10
|
+
* projeto — memória, contexto, specs, gates, hooks e MCP —, conferindo o EFEITO de cada passo, não
|
|
11
|
+
* só o exit code. Roda contra o fonte (`npm test`) e contra o pacote instalado (`release:check`).
|
|
12
|
+
*/
|
|
13
|
+
import fs from 'node:fs';
|
|
14
|
+
import os from 'node:os';
|
|
15
|
+
import path from 'node:path';
|
|
16
|
+
import { spawnSync } from 'node:child_process';
|
|
17
|
+
/** Assinatura (caminho → mtime+tamanho) dos arquivos do pacote — para provar que a jornada não o tocou. */
|
|
18
|
+
function snapshot(dir) {
|
|
19
|
+
const out = new Map();
|
|
20
|
+
const walk = (d) => {
|
|
21
|
+
for (const e of fs.readdirSync(d, { withFileTypes: true })) {
|
|
22
|
+
if (e.name === 'node_modules' || e.name === '.git' || e.name === '.context')
|
|
23
|
+
continue;
|
|
24
|
+
const p = path.join(d, e.name);
|
|
25
|
+
if (e.isDirectory())
|
|
26
|
+
walk(p);
|
|
27
|
+
else if (e.isFile()) {
|
|
28
|
+
const st = fs.statSync(p);
|
|
29
|
+
out.set(path.relative(dir, p), `${st.mtimeMs}:${st.size}`);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
};
|
|
33
|
+
walk(dir);
|
|
34
|
+
return out;
|
|
35
|
+
}
|
|
36
|
+
const LOADER_ERRORS = /ERR_MODULE_NOT_FOUND|ERR_DLOPEN_FAILED|Cannot find module|ERR_PACKAGE_PATH_NOT_EXPORTED|TypeError|ReferenceError/;
|
|
37
|
+
export function runJourney(opts) {
|
|
38
|
+
const base = opts.baseDir ?? fs.mkdtempSync(path.join(os.tmpdir(), 'forja-journey-'));
|
|
39
|
+
const home = path.join(base, 'home');
|
|
40
|
+
fs.mkdirSync(home, { recursive: true });
|
|
41
|
+
// Usuário real: HOME próprio, sem FORJA_* nem npm_* herdados (o mesmo isolamento do release).
|
|
42
|
+
const env = { ...process.env, HOME: home, USERPROFILE: home };
|
|
43
|
+
for (const k of Object.keys(env))
|
|
44
|
+
if (k.startsWith('FORJA_') || k.startsWith('npm_') || k === 'NODE_PATH')
|
|
45
|
+
delete env[k];
|
|
46
|
+
const steps = [];
|
|
47
|
+
const add = (id, ok, detail) => steps.push({ id, ok, detail });
|
|
48
|
+
const forja = (args, cwd, input) => {
|
|
49
|
+
const r = spawnSync(process.execPath, [opts.bin, ...args], { cwd, env, input, encoding: 'utf8', timeout: 180_000 });
|
|
50
|
+
const out = `${r.stdout || ''}${r.stderr || ''}`;
|
|
51
|
+
return { code: r.status ?? 1, out, stdout: r.stdout || '' };
|
|
52
|
+
};
|
|
53
|
+
const firstLine = (s) => s.trim().split('\n').filter(Boolean).slice(-3).join(' | ').slice(0, 300);
|
|
54
|
+
const clean = (r) => !LOADER_ERRORS.test(r.out);
|
|
55
|
+
const before = snapshot(opts.pkgDir);
|
|
56
|
+
try {
|
|
57
|
+
const ws = path.join(home, 'forja-workspace');
|
|
58
|
+
const proj = path.join(ws, 'projects', 'jornada');
|
|
59
|
+
let r = forja(['workspace:init'], home);
|
|
60
|
+
add('workspace:init', r.code === 0 && fs.existsSync(path.join(ws, 'projects')), firstLine(r.out));
|
|
61
|
+
r = forja(['project:new', 'jornada', '--ai', 'claude,codex,gemini,copilot', '--skip-backend'], home);
|
|
62
|
+
add('project:new', r.code === 0 && clean(r) && fs.existsSync(path.join(proj, 'AGENTS.md')), r.code === 0 ? 'projeto gerado' : firstLine(r.out));
|
|
63
|
+
if (!fs.existsSync(proj))
|
|
64
|
+
return steps;
|
|
65
|
+
r = forja(['project:wire', '--check', '--json'], proj);
|
|
66
|
+
let wiring = null;
|
|
67
|
+
try {
|
|
68
|
+
wiring = JSON.parse(r.stdout);
|
|
69
|
+
}
|
|
70
|
+
catch { /* reportado abaixo */ }
|
|
71
|
+
const wiringFails = (wiring?.checks ?? []).filter((c) => c.status === 'fail').map((c) => `${c.id}: ${c.detail}`);
|
|
72
|
+
add('project:wire', r.code === 0 && wiring?.ok === true, wiring ? (wiringFails.join('; ') || `${wiring.checks.length} checks ok`) : firstLine(r.out));
|
|
73
|
+
r = forja(['status'], proj);
|
|
74
|
+
add('status', r.code === 0 && /memória indexada: sim/.test(r.out), /memória indexada: sim/.test(r.out) ? 'memória indexada de nascença' : firstLine(r.out));
|
|
75
|
+
r = forja(['spec:new', 'pagamentos'], proj);
|
|
76
|
+
const spec = path.join(proj, 'specs', 'pagamentos', 'spec.md');
|
|
77
|
+
const specOk = fs.existsSync(spec) && /\*\*ID\*\*:\s*SPEC-001/.test(fs.readFileSync(spec, 'utf8'));
|
|
78
|
+
add('spec:new', r.code === 0 && specOk, specOk ? 'specs/pagamentos/spec.md (SPEC-001)' : firstLine(r.out));
|
|
79
|
+
r = forja(['sync:universal'], proj);
|
|
80
|
+
add('sync:universal', r.code === 0 && clean(r), firstLine(r.out));
|
|
81
|
+
r = forja(['query:universal', 'pagamentos'], proj);
|
|
82
|
+
add('query:universal', r.code === 0 && /\[Projeto: jornada\]/.test(r.out), /\[Projeto: jornada\]/.test(r.out) ? 'acha a spec do projeto' : firstLine(r.out));
|
|
83
|
+
r = forja(['context:smart', '--mode', 'task', '--task', 'pagamentos'], proj);
|
|
84
|
+
const pack = path.join(proj, '.context', 'smart-context.md');
|
|
85
|
+
const packOk = fs.existsSync(pack) && fs.readFileSync(pack, 'utf8').includes('specs/pagamentos/spec.md');
|
|
86
|
+
add('context:smart', r.code === 0 && packOk, packOk ? 'modo task inclui a spec' : firstLine(r.out));
|
|
87
|
+
r = forja(['spec:check'], proj);
|
|
88
|
+
add('spec:check', r.code === 0 && /pagamentos/.test(r.out), firstLine(r.out));
|
|
89
|
+
r = forja(['project:check'], proj);
|
|
90
|
+
add('project:check', r.code === 0, firstLine(r.out));
|
|
91
|
+
r = forja(['tools:doctor'], proj);
|
|
92
|
+
add('tools:doctor', r.code === 0 && /Projeto —/.test(r.out), firstLine(r.out));
|
|
93
|
+
r = forja(['hook:session-start'], proj, '{}');
|
|
94
|
+
let ctx = '';
|
|
95
|
+
try {
|
|
96
|
+
ctx = JSON.parse(r.stdout).hookSpecificOutput.additionalContext;
|
|
97
|
+
}
|
|
98
|
+
catch { /* reportado abaixo */ }
|
|
99
|
+
add('hook:session-start', r.code === 0 && ctx.includes('pagamentos'), ctx ? 'briefing cita a spec ativa' : firstLine(r.out));
|
|
100
|
+
r = forja(['hook:user-prompt'], proj, JSON.stringify({ prompt: 'implementar a spec pagamentos' }));
|
|
101
|
+
ctx = '';
|
|
102
|
+
try {
|
|
103
|
+
ctx = JSON.parse(r.stdout).hookSpecificOutput.additionalContext;
|
|
104
|
+
}
|
|
105
|
+
catch { /* reportado abaixo */ }
|
|
106
|
+
add('hook:user-prompt', r.code === 0 && ctx.includes('specs/pagamentos/spec.md'), ctx ? 'injeta a spec citada' : firstLine(r.out));
|
|
107
|
+
const init = JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2025-06-18', capabilities: {}, clientInfo: { name: 'journey', version: '1' } } });
|
|
108
|
+
r = forja(['mcp:start'], proj, `${init}\n`);
|
|
109
|
+
let version = '';
|
|
110
|
+
try {
|
|
111
|
+
version = JSON.parse(r.stdout.split('\n').find((l) => l.includes('"id":1')) ?? '').result.serverInfo.version;
|
|
112
|
+
}
|
|
113
|
+
catch { /* reportado abaixo */ }
|
|
114
|
+
add('mcp:start', version === opts.version, version ? `serverInfo.version ${version}` : firstLine(r.out));
|
|
115
|
+
// Handoff (ADR-0005) registrado no projeto chega ao `next` do projeto, carimbado com ele.
|
|
116
|
+
const handoff = { from: 'worker', to: 'governance', intent: 'review', context: 'specs/pagamentos', acceptance: 'ACs com evidência', constraints: 'jornada', return: 'orchestrator' };
|
|
117
|
+
r = forja(['hermes:handoff', JSON.stringify(handoff)], proj);
|
|
118
|
+
let hid = 0;
|
|
119
|
+
try {
|
|
120
|
+
hid = JSON.parse(r.stdout.trim().split('\n').pop() ?? '').id;
|
|
121
|
+
}
|
|
122
|
+
catch { /* reportado abaixo */ }
|
|
123
|
+
const next = forja(['next'], proj);
|
|
124
|
+
const mine = forja(['agent:route', 'list', '--mine'], proj);
|
|
125
|
+
const listed = mine.out.includes(`#${hid} [open] {jornada}`);
|
|
126
|
+
add('hermes:handoff', r.code === 0 && hid > 0 && next.out.includes(`agent:route show ${hid}`) && listed, hid ? `#${hid} → next: ${firstLine(next.out)}${listed ? '' : ` · list --mine: ${firstLine(mine.out)}`}` : firstLine(r.out));
|
|
127
|
+
// Comandos que escreviam no pacote quando rodados num projeto (v4): agora gravam no projeto.
|
|
128
|
+
r = forja(['project:dashboard'], proj);
|
|
129
|
+
add('project:dashboard', r.code === 0 && fs.existsSync(path.join(proj, 'DASHBOARD-PROGRESSO.md')), firstLine(r.out));
|
|
130
|
+
r = forja(['memory:extract'], proj);
|
|
131
|
+
add('memory:extract', r.code === 0 && fs.existsSync(path.join(proj, 'memory', '00-global', 'shared-knowledge.md')), firstLine(r.out));
|
|
132
|
+
return steps;
|
|
133
|
+
}
|
|
134
|
+
finally {
|
|
135
|
+
// Classe de bug da v1.6.1/v1.7.0/v4: comando rodado no projeto escrevendo dentro do pacote.
|
|
136
|
+
const after = snapshot(opts.pkgDir);
|
|
137
|
+
const touched = [...new Set([...before.keys(), ...after.keys()])].filter((k) => before.get(k) !== after.get(k));
|
|
138
|
+
add('pacote-intocado', touched.length === 0, touched.length ? `a jornada alterou o pacote: ${touched.slice(0, 8).join(', ')}` : 'nenhum arquivo do pacote mudou');
|
|
139
|
+
if (!opts.keep && !opts.baseDir)
|
|
140
|
+
fs.rmSync(base, { recursive: true, force: true });
|
|
141
|
+
}
|
|
142
|
+
}
|
|
@@ -10,11 +10,9 @@
|
|
|
10
10
|
* chama decide o que fazer com isso — normalmente: seguir a execução e avisar, nunca bloquear.
|
|
11
11
|
*/
|
|
12
12
|
import fs from 'node:fs';
|
|
13
|
-
import
|
|
14
|
-
|
|
15
|
-
const
|
|
16
|
-
const __dirname = path.dirname(__filename);
|
|
17
|
-
export const DEFAULT_PRICING_PATH = path.join(__dirname, 'model-pricing.json');
|
|
13
|
+
import { asset } from '../paths.js';
|
|
14
|
+
// Asset versionado (não código): o tsc não copia .json para o dist/, então lido da raiz do pacote.
|
|
15
|
+
export const DEFAULT_PRICING_PATH = asset('lib', 'core', 'model-pricing.json');
|
|
18
16
|
/** Dias após os quais um preço não revisado é considerado velho (risco do SPEC-029: "asOf > 90 dias"). */
|
|
19
17
|
export const STALE_PRICE_MAX_AGE_DAYS = 90;
|
|
20
18
|
export class ModelPricingError extends Error {
|
|
@@ -22,6 +22,8 @@ interface SmokeEnv {
|
|
|
22
22
|
full: boolean;
|
|
23
23
|
/** SPEC-047: lista de IAs. Presente ⇒ gera só-memória + instruções nativas; ativa `ai-instructions`. */
|
|
24
24
|
ai?: readonly string[];
|
|
25
|
+
/** ADR-0088: projeto gerado a partir de um template (backend vem do boilerplate). */
|
|
26
|
+
template?: string;
|
|
25
27
|
spawn: (cmd: string, args: string[], opts?: any) => {
|
|
26
28
|
stdout: string;
|
|
27
29
|
stderr: string;
|
|
@@ -34,17 +36,19 @@ interface SmokeEnv {
|
|
|
34
36
|
*/
|
|
35
37
|
export declare function withGeneratedProject<T>(fn: (ctx: {
|
|
36
38
|
projectDir: string;
|
|
37
|
-
}) => Promise<T> | T, { root, spawn, ai }: {
|
|
39
|
+
}) => Promise<T> | T, { root, spawn, ai, template }: {
|
|
38
40
|
root?: string;
|
|
39
41
|
spawn: SmokeEnv['spawn'];
|
|
40
42
|
ai?: readonly string[];
|
|
43
|
+
template?: string;
|
|
41
44
|
}): Promise<T>;
|
|
42
45
|
/** @type {Check[]} */
|
|
43
46
|
export declare const SMOKE_CHECKS: Check[];
|
|
44
47
|
export declare function defaultEnv(overrides?: Partial<SmokeEnv>): SmokeEnv;
|
|
45
48
|
/** Gera um projeto isolado, roda os checks, limpa. */
|
|
46
|
-
export declare function runProjectSmoke({ full, ai, env: overrides }?: {
|
|
49
|
+
export declare function runProjectSmoke({ full, ai, template, env: overrides }?: {
|
|
47
50
|
full?: boolean;
|
|
48
51
|
ai?: string[];
|
|
52
|
+
template?: string;
|
|
49
53
|
env?: Partial<SmokeEnv>;
|
|
50
54
|
}): Promise<import("./checks.ts").Result[]>;
|
|
@@ -16,39 +16,45 @@ import fs from 'node:fs';
|
|
|
16
16
|
import os from 'node:os';
|
|
17
17
|
import path from 'node:path';
|
|
18
18
|
import { fileURLToPath } from 'node:url';
|
|
19
|
-
import { runChecks as run, worstStatus } from
|
|
20
|
-
import { resolveScript } from
|
|
21
|
-
import {
|
|
19
|
+
import { runChecks as run, worstStatus } from './checks.js';
|
|
20
|
+
import { resolveScript } from './registry.js';
|
|
21
|
+
import { wireProject, checkProjectWiring } from '../project-wiring.js';
|
|
22
|
+
import { resolveTemplate, applyTemplate } from '../templates.js';
|
|
23
|
+
import { COMMANDS } from './registry.js';
|
|
22
24
|
// @ts-ignore — validador legado sem tipos exportados; usado só pela forma { isValid, errors }.
|
|
23
|
-
import { validateProjectStructure } from
|
|
25
|
+
import { validateProjectStructure } from '../validators/structure-validator.js';
|
|
26
|
+
import { pkgRoot, script } from '../paths.js';
|
|
24
27
|
export { worstStatus };
|
|
25
28
|
const __filename = fileURLToPath(import.meta.url);
|
|
26
|
-
const repoRoot =
|
|
29
|
+
const repoRoot = pkgRoot;
|
|
27
30
|
/** Placeholders do gerador: identificadores MAIÚSCULOS entre chaves duplas (`{{FEATURE}}`). */
|
|
28
31
|
const PLACEHOLDER_RE = /\{\{[A-Z][A-Z0-9_]*\}\}/;
|
|
29
32
|
/**
|
|
30
33
|
* Gera um projeto num diretório temporário isolado e entrega o caminho ao callback. Limpa o
|
|
31
34
|
* temporário **sempre**, inclusive quando o callback lança — o mesmo contrato do `withCleanInstall`.
|
|
32
35
|
*/
|
|
33
|
-
export async function withGeneratedProject(fn, { root = repoRoot, spawn, ai }) {
|
|
36
|
+
export async function withGeneratedProject(fn, { root = repoRoot, spawn, ai, template }) {
|
|
34
37
|
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'forja-smoke-'));
|
|
35
38
|
const projectDir = path.join(dir, 'smoke-proj');
|
|
36
39
|
const aiMode = Array.isArray(ai) && ai.length > 0;
|
|
37
40
|
try {
|
|
38
41
|
// resolveScript acha .ts em dev e .js no dist — cravar .ts quebrava no pacote publicado.
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
//
|
|
42
|
-
//
|
|
43
|
-
const
|
|
42
|
+
// Raiz padrão = pacote: o gerador é código (codeRoot, `dist/` publicado), não asset.
|
|
43
|
+
const gen = root === pkgRoot ? script('bin/create-memory-nest-kit') : resolveScript(root, 'bin/create-memory-nest-kit');
|
|
44
|
+
// Modo --ai (SPEC-047): só a memória + a conexão de lib/project-wiring.ts, a mesma que o
|
|
45
|
+
// gerador faz. Com --template, o backend vem do boilerplate (mesmo caminho do project:new).
|
|
46
|
+
const tpl = template ? resolveTemplate(template) : null;
|
|
47
|
+
const genArgs = aiMode || tpl
|
|
44
48
|
? [gen, projectDir, '--only-memory', '--force']
|
|
45
49
|
: [gen, projectDir, '--force'];
|
|
46
50
|
const res = spawn(process.execPath, genArgs, { cwd: dir });
|
|
47
51
|
if (res.code !== 0) {
|
|
48
52
|
throw new Error(`o gerador saiu com código ${res.code}:\n${(res.stderr || res.stdout).slice(0, 800)}`);
|
|
49
53
|
}
|
|
54
|
+
if (tpl)
|
|
55
|
+
applyTemplate(projectDir, tpl);
|
|
50
56
|
if (aiMode)
|
|
51
|
-
|
|
57
|
+
wireProject(projectDir, { ai: ai, codegraph: false });
|
|
52
58
|
return await fn({ projectDir });
|
|
53
59
|
}
|
|
54
60
|
finally {
|
|
@@ -172,8 +178,18 @@ const structure = {
|
|
|
172
178
|
dependsOn: 'generated',
|
|
173
179
|
probe(env) {
|
|
174
180
|
// Modo --ai (SPEC-047) é só-memória — não há backend NestJS para validar.
|
|
175
|
-
|
|
181
|
+
// Com template, o backend é do boilerplate: valida memória + um backend mínimo, não o layout do
|
|
182
|
+
// NestJS padrão do gerador.
|
|
183
|
+
const includeNest = !(Array.isArray(env.ai) && env.ai.length > 0) && !env.template;
|
|
176
184
|
const report = validateProjectStructure(env.projectDir, { includeNest });
|
|
185
|
+
if (env.template) {
|
|
186
|
+
for (const rel of ['backend/package.json', 'backend/src']) {
|
|
187
|
+
if (!env.fs.existsSync(path.join(env.projectDir, rel))) {
|
|
188
|
+
report.isValid = false;
|
|
189
|
+
report.errors.push(`template sem ${rel}`);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
}
|
|
177
193
|
if (!report.isValid) {
|
|
178
194
|
return {
|
|
179
195
|
status: 'fail',
|
|
@@ -208,7 +224,7 @@ const gateInherited = {
|
|
|
208
224
|
*/
|
|
209
225
|
const builds = {
|
|
210
226
|
id: 'builds',
|
|
211
|
-
title: 'o backend gerado instala e
|
|
227
|
+
title: 'o backend gerado instala, compila, testa e passa no lint (--full)',
|
|
212
228
|
severity: 'critical',
|
|
213
229
|
dependsOn: 'structure',
|
|
214
230
|
probe(env) {
|
|
@@ -227,7 +243,22 @@ const builds = {
|
|
|
227
243
|
if (build.code !== 0) {
|
|
228
244
|
return { status: 'fail', detail: `npm run build falhou no backend gerado:\n${(build.stderr || build.stdout).slice(0, 500)}`, fix: 'o código gerado não compila — confira os templates do nest-generator' };
|
|
229
245
|
}
|
|
230
|
-
|
|
246
|
+
// Compilar não basta: na v5 o backend gerado compilava, mas `npm test` não achava os tipos do
|
|
247
|
+
// jest (TS 6) e o lint nunca carregou (.eslintrc sem as deps). O projeto tem que rodar o que anuncia.
|
|
248
|
+
// test é obrigatório; test:e2e e lint, quando o projeto os declara (um template pode não ter e2e).
|
|
249
|
+
let scripts = {};
|
|
250
|
+
try {
|
|
251
|
+
scripts = JSON.parse(env.fs.readFileSync(path.join(backend, 'package.json'), 'utf8')).scripts ?? {};
|
|
252
|
+
}
|
|
253
|
+
catch { /* json-valid já reporta */ }
|
|
254
|
+
const ran = ['test', 'test:e2e', 'lint'].filter((name) => name === 'test' || name in scripts);
|
|
255
|
+
for (const script of ran) {
|
|
256
|
+
const res = env.spawn('npm', ['run', script], { cwd: backend });
|
|
257
|
+
if (res.code !== 0) {
|
|
258
|
+
return { status: 'fail', detail: `npm run ${script} falhou no backend gerado:\n${(res.stdout + res.stderr).slice(-600)}`, fix: 'confira os templates do nest-generator (testes, tsconfig, eslint.config.mjs)' };
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
return { status: 'ok', detail: `backend gerado instala, compila e passa em: ${ran.join(', ')}`, fix: null };
|
|
231
262
|
},
|
|
232
263
|
};
|
|
233
264
|
/**
|
|
@@ -238,59 +269,27 @@ const builds = {
|
|
|
238
269
|
*/
|
|
239
270
|
const aiInstructionsCoherent = {
|
|
240
271
|
id: 'ai-instructions',
|
|
241
|
-
title: '
|
|
272
|
+
title: 'o projeto está conectado às IAs pedidas (--ai): instruções, hooks, MCP, comandos citados',
|
|
242
273
|
severity: 'critical',
|
|
243
274
|
dependsOn: 'generated',
|
|
244
275
|
probe(env) {
|
|
245
276
|
const ai = env.ai;
|
|
246
277
|
if (!Array.isArray(ai) || ai.length === 0) {
|
|
247
|
-
return { status: 'skipped', detail: 'sem --ai (o smoke completo não
|
|
278
|
+
return { status: 'skipped', detail: 'sem --ai (o smoke completo não conecta IAs)', fix: null };
|
|
248
279
|
}
|
|
249
|
-
|
|
250
|
-
const bodies = new Map();
|
|
251
|
-
const missing = [];
|
|
252
|
-
for (const name of ai) {
|
|
253
|
-
const file = path.join(dir, `${name}.md`);
|
|
254
|
-
const src = readText(env, file);
|
|
255
|
-
if (src == null) {
|
|
256
|
-
missing.push(`${name}.md`);
|
|
257
|
-
continue;
|
|
258
|
-
}
|
|
259
|
-
bodies.set(name, stripInstructionHeader(src));
|
|
260
|
-
}
|
|
261
|
-
if (missing.length) {
|
|
262
|
-
return { status: 'fail', detail: `instrução ausente: ${missing.join(', ')}`, fix: 'confira writeAiInstructions / a lista --ai' };
|
|
263
|
-
}
|
|
264
|
-
const [first, ...rest] = [...bodies.entries()];
|
|
265
|
-
for (const [name, body] of rest) {
|
|
266
|
-
if (body !== first[1]) {
|
|
267
|
-
return {
|
|
268
|
-
status: 'fail',
|
|
269
|
-
detail: `o corpo de ${name}.md diverge de ${first[0]}.md — as instruções não são a mesma fonte`,
|
|
270
|
-
fix: 'toda IA parte de .gemini-instructions.md; só o cabeçalho muda (lib/multi-ai-instructions.ts)',
|
|
271
|
-
};
|
|
272
|
-
}
|
|
273
|
-
}
|
|
274
|
-
const modelsRaw = readText(env, path.join(dir, 'models.json'));
|
|
275
|
-
let models;
|
|
280
|
+
let checks;
|
|
276
281
|
try {
|
|
277
|
-
|
|
282
|
+
checks = checkProjectWiring(env.projectDir, { commands: COMMANDS, ai });
|
|
278
283
|
}
|
|
279
|
-
catch {
|
|
280
|
-
return { status: 'fail', detail:
|
|
281
|
-
}
|
|
282
|
-
if (JSON.stringify(models.fallback_chain) !== JSON.stringify([...ai])) {
|
|
283
|
-
return { status: 'fail', detail: `models.json fallback_chain ${JSON.stringify(models.fallback_chain)} ≠ --ai ${JSON.stringify(ai)}`, fix: 'sincronize a lista' };
|
|
284
|
+
catch (e) {
|
|
285
|
+
return { status: 'fail', detail: e.message, fix: 'use IAs suportadas: claude, codex, gemini, copilot' };
|
|
284
286
|
}
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
}
|
|
289
|
-
if (!(name in AI_LABELS)) {
|
|
290
|
-
return { status: 'fail', detail: `IA desconhecida na lista --ai: ${name} (conhecidas: ${Object.keys(AI_LABELS).join(', ')})`, fix: 'use uma IA suportada' };
|
|
291
|
-
}
|
|
287
|
+
// `forja-bin` depende da máquina, não do projeto gerado.
|
|
288
|
+
const failed = checks.filter((c) => c.status === 'fail' && c.id !== 'forja-bin');
|
|
289
|
+
if (failed.length) {
|
|
290
|
+
return { status: 'fail', detail: failed.map((c) => `${c.id}: ${c.detail}`).join('; '), fix: 'lib/project-wiring.ts (forja project:wire)' };
|
|
292
291
|
}
|
|
293
|
-
return { status: 'ok', detail: `${ai.length}
|
|
292
|
+
return { status: 'ok', detail: `${ai.length} IA(s) conectada(s): ${checks.filter((c) => c.status === 'ok').map((c) => c.id).join(', ')}`, fix: null };
|
|
294
293
|
},
|
|
295
294
|
};
|
|
296
295
|
/** @type {Check[]} */
|
|
@@ -319,8 +318,8 @@ export function defaultEnv(overrides = {}) {
|
|
|
319
318
|
};
|
|
320
319
|
}
|
|
321
320
|
/** Gera um projeto isolado, roda os checks, limpa. */
|
|
322
|
-
export async function runProjectSmoke({ full = false, ai, env: overrides = {} } = {}) {
|
|
321
|
+
export async function runProjectSmoke({ full = false, ai, template, env: overrides = {} } = {}) {
|
|
323
322
|
const aiList = ai && ai.length > 0 ? ai : undefined;
|
|
324
|
-
const base = defaultEnv({ full, ...(aiList ? { ai: aiList } : {}), ...overrides });
|
|
325
|
-
return withGeneratedProject(({ projectDir }) => run({ checks: SMOKE_CHECKS, env: { ...base, projectDir } }), { root: base.root, spawn: base.spawn, ai: base.ai });
|
|
323
|
+
const base = defaultEnv({ full, ...(aiList ? { ai: aiList } : {}), ...(template ? { template } : {}), ...overrides });
|
|
324
|
+
return withGeneratedProject(({ projectDir }) => run({ checks: SMOKE_CHECKS, env: { ...base, projectDir } }), { root: base.root, spawn: base.spawn, ai: base.ai, template });
|
|
326
325
|
}
|
|
@@ -13,17 +13,7 @@
|
|
|
13
13
|
* - workspace bloqueia se o workspace (ADR-0019) não existir
|
|
14
14
|
* - workspace-warn avisa se o workspace não existir, mas segue
|
|
15
15
|
*/
|
|
16
|
-
|
|
17
|
-
* Resolve o `node:` de um comando para o arquivo real, **agnóstico de extensão** (SPEC-012 D2).
|
|
18
|
-
* Tenta `.ts → .js → .mjs`: em dev acha a fonte `.ts`; no pacote publicado, o `.js` sob `dist/`.
|
|
19
|
-
* Desacopla o registry do runtime — a entrada pode manter `.mjs` que este resolver ainda acha o
|
|
20
|
-
* `.ts` renomeado. Sem isto, renomear um script quebraria o dispatch.
|
|
21
|
-
*
|
|
22
|
-
* @param {string} root Raiz onde os scripts vivem (repo em dev, `dist/` no publicado).
|
|
23
|
-
* @param {string} node Caminho do registry, com ou sem extensão.
|
|
24
|
-
* @returns {string} Caminho absoluto do arquivo que existe (ou o candidato original, que falha visível).
|
|
25
|
-
*/
|
|
26
|
-
export declare function resolveScript(root: any, node: any): string;
|
|
16
|
+
export { resolveScript } from '../paths.ts';
|
|
27
17
|
export declare const DOMAINS: {
|
|
28
18
|
workspace: string;
|
|
29
19
|
sdd: string;
|
|
@@ -34,7 +24,6 @@ export declare const DOMAINS: {
|
|
|
34
24
|
contexto: string;
|
|
35
25
|
llm: string;
|
|
36
26
|
governanca: string;
|
|
37
|
-
geracao: string;
|
|
38
27
|
};
|
|
39
28
|
export interface CommandArg {
|
|
40
29
|
readonly name: string;
|
|
@@ -13,29 +13,8 @@
|
|
|
13
13
|
* - workspace bloqueia se o workspace (ADR-0019) não existir
|
|
14
14
|
* - workspace-warn avisa se o workspace não existir, mas segue
|
|
15
15
|
*/
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
/**
|
|
19
|
-
* Resolve o `node:` de um comando para o arquivo real, **agnóstico de extensão** (SPEC-012 D2).
|
|
20
|
-
* Tenta `.ts → .js → .mjs`: em dev acha a fonte `.ts`; no pacote publicado, o `.js` sob `dist/`.
|
|
21
|
-
* Desacopla o registry do runtime — a entrada pode manter `.mjs` que este resolver ainda acha o
|
|
22
|
-
* `.ts` renomeado. Sem isto, renomear um script quebraria o dispatch.
|
|
23
|
-
*
|
|
24
|
-
* @param {string} root Raiz onde os scripts vivem (repo em dev, `dist/` no publicado).
|
|
25
|
-
* @param {string} node Caminho do registry, com ou sem extensão.
|
|
26
|
-
* @returns {string} Caminho absoluto do arquivo que existe (ou o candidato original, que falha visível).
|
|
27
|
-
*/
|
|
28
|
-
export function resolveScript(root, node) {
|
|
29
|
-
const direct = path.join(root, node);
|
|
30
|
-
if (fs.existsSync(direct))
|
|
31
|
-
return direct;
|
|
32
|
-
const base = direct.replace(/\.(mjs|cjs|js|ts)$/, '');
|
|
33
|
-
for (const ext of ['.ts', '.js', '.mjs']) {
|
|
34
|
-
if (fs.existsSync(base + ext))
|
|
35
|
-
return base + ext;
|
|
36
|
-
}
|
|
37
|
-
return direct;
|
|
38
|
-
}
|
|
16
|
+
// Resolução de script agnóstica de extensão (SPEC-012 D2) — vive em lib/paths.ts (ADR-0086).
|
|
17
|
+
export { resolveScript } from '../paths.js';
|
|
39
18
|
export const DOMAINS = {
|
|
40
19
|
workspace: 'Workspace & projetos',
|
|
41
20
|
sdd: 'Pipeline SDD (spec → plan → tasks → check)',
|
|
@@ -46,7 +25,6 @@ export const DOMAINS = {
|
|
|
46
25
|
contexto: 'Contexto & token economy',
|
|
47
26
|
llm: 'LLMs & execução supervisionada',
|
|
48
27
|
governanca: 'Governança & qualidade',
|
|
49
|
-
geracao: 'Geração de projetos',
|
|
50
28
|
};
|
|
51
29
|
export const COMMANDS = {
|
|
52
30
|
// --- Workspace & projetos ---------------------------------------------
|
|
@@ -67,7 +45,7 @@ export const COMMANDS = {
|
|
|
67
45
|
args: ['project:new'],
|
|
68
46
|
gates: ['workspace'],
|
|
69
47
|
tier: 'core',
|
|
70
|
-
usage: 'forja project:new <nome> [-- --ai claude,copilot]',
|
|
48
|
+
usage: 'forja project:new <nome> [-- --ai claude,copilot] [--template <nome>]',
|
|
71
49
|
cliArgs: [{ name: 'nome', required: true, desc: 'slug do projeto (kebab-case)' }],
|
|
72
50
|
examples: ['forja project:new meu-app -- --ai claude,copilot'],
|
|
73
51
|
next: ['workspace:project:check'],
|
|
@@ -91,8 +69,12 @@ export const COMMANDS = {
|
|
|
91
69
|
},
|
|
92
70
|
'project:upgrade': {
|
|
93
71
|
domain: 'workspace',
|
|
94
|
-
desc: 'Traz peças novas de scaffold
|
|
72
|
+
desc: 'Traz peças novas de scaffold e religa a IA num projeto (ou --all) — aditivo; --apply aplica',
|
|
95
73
|
node: 'scripts/project-upgrade.ts',
|
|
74
|
+
spec: 'SPEC-018, ADR-0086',
|
|
75
|
+
usage: 'forja project:upgrade [--apply] [--project <path> | --all] [--json]',
|
|
76
|
+
examples: ['forja project:upgrade', 'forja project:upgrade --all', 'forja project:upgrade --all --apply'],
|
|
77
|
+
next: ['project:wire'],
|
|
96
78
|
},
|
|
97
79
|
'workspace:project:check': {
|
|
98
80
|
domain: 'workspace',
|
|
@@ -722,6 +704,39 @@ export const COMMANDS = {
|
|
|
722
704
|
examples: ['forja tools:doctor', 'forja tools:doctor --json'],
|
|
723
705
|
next: ['setup'],
|
|
724
706
|
},
|
|
707
|
+
'project:templates': {
|
|
708
|
+
domain: 'workspace',
|
|
709
|
+
desc: 'Lista os boilerplates: quais são templates validados (project:new --template) e quais são referência',
|
|
710
|
+
node: 'scripts/project-templates.ts',
|
|
711
|
+
spec: 'ADR-0088',
|
|
712
|
+
readonly: true,
|
|
713
|
+
usage: 'forja project:templates [--json]',
|
|
714
|
+
examples: ['forja project:templates'],
|
|
715
|
+
next: ['project:new'],
|
|
716
|
+
},
|
|
717
|
+
'project:wire': {
|
|
718
|
+
domain: 'workspace',
|
|
719
|
+
desc: 'Conecta o projeto à inteligência do Forja: instruções nativas, hooks, sub-agents e MCP',
|
|
720
|
+
node: 'scripts/project-wire.ts',
|
|
721
|
+
spec: 'ADR-0086',
|
|
722
|
+
usage: 'forja project:wire [--check] [--ai claude,codex,gemini,copilot] [--json]',
|
|
723
|
+
examples: ['forja project:wire', 'forja project:wire --check'],
|
|
724
|
+
next: ['status'],
|
|
725
|
+
},
|
|
726
|
+
'hook:session-start': {
|
|
727
|
+
domain: 'governanca',
|
|
728
|
+
desc: 'Hook SessionStart: briefing de specs, handoffs e saúde do núcleo para a IA',
|
|
729
|
+
node: 'scripts/hook-session-start.ts',
|
|
730
|
+
spec: 'ADR-0086',
|
|
731
|
+
readonly: true,
|
|
732
|
+
},
|
|
733
|
+
'hook:user-prompt': {
|
|
734
|
+
domain: 'governanca',
|
|
735
|
+
desc: 'Hook UserPromptSubmit: injeta o contexto da spec citada no prompt',
|
|
736
|
+
node: 'scripts/hook-user-prompt.ts',
|
|
737
|
+
spec: 'ADR-0086',
|
|
738
|
+
readonly: true,
|
|
739
|
+
},
|
|
725
740
|
'demo:autonomy': {
|
|
726
741
|
domain: 'governanca',
|
|
727
742
|
desc: 'Executa a prova offline de autonomia supervisionada com Git worktree real',
|
|
@@ -743,7 +758,7 @@ export const COMMANDS = {
|
|
|
743
758
|
node: 'scripts/project-smoke.ts',
|
|
744
759
|
spec: 'SPEC-015, SPEC-047',
|
|
745
760
|
readonly: true,
|
|
746
|
-
usage: 'forja project:smoke [--full] [--ai claude,copilot,gemini,codex]',
|
|
761
|
+
usage: 'forja project:smoke [--full] [--ai claude,copilot,gemini,codex] [--template <nome>]',
|
|
747
762
|
examples: ['forja project:smoke', 'forja project:smoke --ai claude,copilot'],
|
|
748
763
|
},
|
|
749
764
|
'check:all': {
|
|
@@ -772,9 +787,4 @@ export const COMMANDS = {
|
|
|
772
787
|
node: 'scripts/governance-dashboard.ts',
|
|
773
788
|
},
|
|
774
789
|
// --- Geração ----------------------------------------------------------------------
|
|
775
|
-
'init:project': {
|
|
776
|
-
domain: 'geracao',
|
|
777
|
-
desc: 'Gera projeto direto num path (prefira project:new)',
|
|
778
|
-
node: 'bin/init-project.ts',
|
|
779
|
-
},
|
|
780
790
|
};
|