forjajs 4.1.2 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +109 -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-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 +107 -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 +25 -25
- 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
|
@@ -12,5 +12,19 @@ export interface OpenHandoff {
|
|
|
12
12
|
readonly intent: string;
|
|
13
13
|
readonly slug: string;
|
|
14
14
|
}
|
|
15
|
-
/**
|
|
16
|
-
|
|
15
|
+
/**
|
|
16
|
+
* Handoffs `status='open'`, mais recentes primeiro (até `limit`). Nunca lança — `[]` em qualquer falha.
|
|
17
|
+
* Com `project`, só os carimbados com esse projeto (payload `project`, gravado pelo agent:route).
|
|
18
|
+
*/
|
|
19
|
+
export declare function openHandoffs(limit?: number, project?: string | null): Promise<OpenHandoff[]>;
|
|
20
|
+
export interface OrphanHandoff {
|
|
21
|
+
readonly id: number;
|
|
22
|
+
readonly project: string | null;
|
|
23
|
+
readonly reason: 'sem-projeto' | 'projeto-inexistente';
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Handoffs abertos que ninguém vai ver: sem carimbo de projeto (pré-v5) ou carimbados com um
|
|
27
|
+
* projeto que não existe mais no workspace. Foi assim que um handoff de produto apagado ficou meses
|
|
28
|
+
* aparecendo no briefing do framework. Nunca lança.
|
|
29
|
+
*/
|
|
30
|
+
export declare function orphanHandoffs(knownProjects: readonly string[]): Promise<OrphanHandoff[]>;
|
|
@@ -5,15 +5,19 @@
|
|
|
5
5
|
* de propósito (ADR-0021): sem `node_modules`, sem banco ou com ABI quebrado, degrada para `[]`
|
|
6
6
|
* em vez de derrubar quem chama. Somente leitura.
|
|
7
7
|
*/
|
|
8
|
-
/**
|
|
9
|
-
|
|
8
|
+
/**
|
|
9
|
+
* Handoffs `status='open'`, mais recentes primeiro (até `limit`). Nunca lança — `[]` em qualquer falha.
|
|
10
|
+
* Com `project`, só os carimbados com esse projeto (payload `project`, gravado pelo agent:route).
|
|
11
|
+
*/
|
|
12
|
+
export async function openHandoffs(limit = 10, project = null) {
|
|
10
13
|
try {
|
|
11
|
-
const { getWorkspaceDbPath } = await import(
|
|
14
|
+
const { getWorkspaceDbPath } = await import('./workspace.js');
|
|
12
15
|
const { default: Database } = await import('better-sqlite3');
|
|
13
16
|
const db = new Database(getWorkspaceDbPath(), { readonly: true });
|
|
14
17
|
const rows = db
|
|
15
|
-
.prepare(`SELECT id, from_agent, to_agent, intent, spec_slug FROM handoffs WHERE status='open'
|
|
16
|
-
|
|
18
|
+
.prepare(`SELECT id, from_agent, to_agent, intent, spec_slug FROM handoffs WHERE status='open'
|
|
19
|
+
${project ? "AND json_extract(payload_json, '$.project') = ?" : ''} ORDER BY id DESC LIMIT ?`)
|
|
20
|
+
.all(...(project ? [project, limit] : [limit]));
|
|
17
21
|
db.close();
|
|
18
22
|
return rows.map((r) => ({
|
|
19
23
|
id: r.id,
|
|
@@ -27,3 +31,26 @@ export async function openHandoffs(limit = 10) {
|
|
|
27
31
|
return [];
|
|
28
32
|
}
|
|
29
33
|
}
|
|
34
|
+
/**
|
|
35
|
+
* Handoffs abertos que ninguém vai ver: sem carimbo de projeto (pré-v5) ou carimbados com um
|
|
36
|
+
* projeto que não existe mais no workspace. Foi assim que um handoff de produto apagado ficou meses
|
|
37
|
+
* aparecendo no briefing do framework. Nunca lança.
|
|
38
|
+
*/
|
|
39
|
+
export async function orphanHandoffs(knownProjects) {
|
|
40
|
+
try {
|
|
41
|
+
const { getWorkspaceDbPath } = await import('./workspace.js');
|
|
42
|
+
const { default: Database } = await import('better-sqlite3');
|
|
43
|
+
const db = new Database(getWorkspaceDbPath(), { readonly: true });
|
|
44
|
+
const rows = db
|
|
45
|
+
.prepare(`SELECT id, json_extract(payload_json, '$.project') AS project FROM handoffs WHERE status IN ('open','in_progress') ORDER BY id`)
|
|
46
|
+
.all();
|
|
47
|
+
db.close();
|
|
48
|
+
const known = new Set(['forja', ...knownProjects]);
|
|
49
|
+
return rows
|
|
50
|
+
.filter((r) => !r.project || !known.has(r.project))
|
|
51
|
+
.map((r) => ({ id: r.id, project: r.project, reason: r.project ? 'projeto-inexistente' : 'sem-projeto' }));
|
|
52
|
+
}
|
|
53
|
+
catch {
|
|
54
|
+
return [];
|
|
55
|
+
}
|
|
56
|
+
}
|
package/dist/lib/llm/session.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
2
|
import { createHash } from 'node:crypto';
|
|
3
|
-
import { RESUME_PROVIDERS } from
|
|
3
|
+
import { RESUME_PROVIDERS } from '../../packages/llm/src/index.js';
|
|
4
4
|
export { RESUME_PROVIDERS };
|
|
5
5
|
export function profileFingerprint(profile) {
|
|
6
6
|
return createHash('sha256').update(JSON.stringify({ provider: profile.provider, model: profile.model,
|
|
@@ -3,7 +3,7 @@ import path from 'node:path';
|
|
|
3
3
|
import { createHash } from 'node:crypto';
|
|
4
4
|
import { Ajv } from 'ajv';
|
|
5
5
|
import { Ajv2020 } from 'ajv/dist/2020.js';
|
|
6
|
-
import { runLlm } from
|
|
6
|
+
import { runLlm } from '../../packages/llm/src/index.js';
|
|
7
7
|
const manifestSchema = {
|
|
8
8
|
type: 'object', required: ['version', 'checks'], additionalProperties: false,
|
|
9
9
|
properties: {
|
package/dist/lib/memory-audit.js
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
*/
|
|
12
12
|
import fs from 'node:fs';
|
|
13
13
|
import path from 'node:path';
|
|
14
|
-
import { domainsOf } from
|
|
14
|
+
import { domainsOf } from './code-context.js';
|
|
15
15
|
const defaultEnv = { fs };
|
|
16
16
|
/** Paths de código citados num mapa: tokens entre crases que terminam em `.ts` e têm ao menos um `/`. */
|
|
17
17
|
const CODE_REF_RE = /`([a-z][a-zA-Z0-9/._-]*\/[a-zA-Z0-9/._-]*\.ts)`/g;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/paths.ts — as duas raízes do Forja, resolvidas num lugar só (ADR-0086).
|
|
3
|
+
*
|
|
4
|
+
* O Forja roda de dois layouts:
|
|
5
|
+
*
|
|
6
|
+
* dev (checkout) publicado (node_modules/forjajs)
|
|
7
|
+
* <repo>/lib/paths.ts <pkg>/dist/lib/paths.js
|
|
8
|
+
* <repo>/scripts/*.ts <pkg>/dist/scripts/*.js
|
|
9
|
+
* <repo>/memory, docs, … <pkg>/memory, docs, … ← fora do dist/
|
|
10
|
+
*
|
|
11
|
+
* Por isso há duas raízes, e confundi-las foi a fonte recorrente de bugs "funciona no repo, quebra
|
|
12
|
+
* instalado" (v1.6.1 no spec-cli; v4.x no init-project, setup e 18 outros scripts, que faziam
|
|
13
|
+
* `path.resolve(__dirname, '..')` e no pacote acabavam em `dist/`):
|
|
14
|
+
*
|
|
15
|
+
* - `codeRoot` → onde vive o CÓDIGO executável (scripts, bins). Repo em dev; `dist/` publicado.
|
|
16
|
+
* Use com `script()` para spawnar um script sem cravar extensão.
|
|
17
|
+
* - `pkgRoot` → onde vivem os ASSETS versionados (memory/, docs/, prompts/, templates/,
|
|
18
|
+
* specs/_templates, .claude/, design-md/, boilerplates/, package.json).
|
|
19
|
+
* É a raiz do pacote nos dois layouts.
|
|
20
|
+
*
|
|
21
|
+
* Nenhum outro módulo deve calcular raiz a partir de `__dirname` — o teste `paths.test.js` vigia.
|
|
22
|
+
*/
|
|
23
|
+
import fs from 'node:fs';
|
|
24
|
+
/** Raiz do código: um nível acima de `lib/` (repo em dev, `dist/` no pacote). */
|
|
25
|
+
export declare const codeRoot: string;
|
|
26
|
+
/** Sobe a partir de `start` até o `package.json` do Forja. Fallback: `start`. */
|
|
27
|
+
export declare function findPkgRoot(start: string, fsImpl?: Pick<typeof fs, 'existsSync' | 'readFileSync'>): string;
|
|
28
|
+
/** Raiz dos assets versionados — a raiz do pacote nos dois layouts. */
|
|
29
|
+
export declare const pkgRoot: string;
|
|
30
|
+
/** Caminho de um asset versionado (ex.: `asset('memory', '90-decisions')`). */
|
|
31
|
+
export declare function asset(...segments: string[]): string;
|
|
32
|
+
/**
|
|
33
|
+
* Resolve um script/bin para o arquivo que existe, **agnóstico de extensão**: tenta o caminho
|
|
34
|
+
* dado e depois `.ts → .js → .mjs`. Em dev acha a fonte `.ts`; publicado, o `.js` sob `dist/`.
|
|
35
|
+
* Devolve o candidato original quando nada existe — o spawn então falha visível, não silencioso.
|
|
36
|
+
*/
|
|
37
|
+
export declare function resolveScript(root: string, rel: string): string;
|
|
38
|
+
/** Script do Forja relativo à raiz do código (ex.: `script('bin/create-memory-nest-kit')`). */
|
|
39
|
+
export declare function script(rel: string): string;
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/paths.ts — as duas raízes do Forja, resolvidas num lugar só (ADR-0086).
|
|
3
|
+
*
|
|
4
|
+
* O Forja roda de dois layouts:
|
|
5
|
+
*
|
|
6
|
+
* dev (checkout) publicado (node_modules/forjajs)
|
|
7
|
+
* <repo>/lib/paths.ts <pkg>/dist/lib/paths.js
|
|
8
|
+
* <repo>/scripts/*.ts <pkg>/dist/scripts/*.js
|
|
9
|
+
* <repo>/memory, docs, … <pkg>/memory, docs, … ← fora do dist/
|
|
10
|
+
*
|
|
11
|
+
* Por isso há duas raízes, e confundi-las foi a fonte recorrente de bugs "funciona no repo, quebra
|
|
12
|
+
* instalado" (v1.6.1 no spec-cli; v4.x no init-project, setup e 18 outros scripts, que faziam
|
|
13
|
+
* `path.resolve(__dirname, '..')` e no pacote acabavam em `dist/`):
|
|
14
|
+
*
|
|
15
|
+
* - `codeRoot` → onde vive o CÓDIGO executável (scripts, bins). Repo em dev; `dist/` publicado.
|
|
16
|
+
* Use com `script()` para spawnar um script sem cravar extensão.
|
|
17
|
+
* - `pkgRoot` → onde vivem os ASSETS versionados (memory/, docs/, prompts/, templates/,
|
|
18
|
+
* specs/_templates, .claude/, design-md/, boilerplates/, package.json).
|
|
19
|
+
* É a raiz do pacote nos dois layouts.
|
|
20
|
+
*
|
|
21
|
+
* Nenhum outro módulo deve calcular raiz a partir de `__dirname` — o teste `paths.test.js` vigia.
|
|
22
|
+
*/
|
|
23
|
+
import fs from 'node:fs';
|
|
24
|
+
import path from 'node:path';
|
|
25
|
+
import { fileURLToPath } from 'node:url';
|
|
26
|
+
const PKG_NAME = 'forjajs';
|
|
27
|
+
const here = path.dirname(fileURLToPath(import.meta.url));
|
|
28
|
+
/** Raiz do código: um nível acima de `lib/` (repo em dev, `dist/` no pacote). */
|
|
29
|
+
export const codeRoot = path.resolve(here, '..');
|
|
30
|
+
/** Sobe a partir de `start` até o `package.json` do Forja. Fallback: `start`. */
|
|
31
|
+
export function findPkgRoot(start, fsImpl = fs) {
|
|
32
|
+
let dir = path.resolve(start);
|
|
33
|
+
for (;;) {
|
|
34
|
+
const manifest = path.join(dir, 'package.json');
|
|
35
|
+
if (fsImpl.existsSync(manifest)) {
|
|
36
|
+
try {
|
|
37
|
+
if (JSON.parse(String(fsImpl.readFileSync(manifest, 'utf8'))).name === PKG_NAME)
|
|
38
|
+
return dir;
|
|
39
|
+
}
|
|
40
|
+
catch { /* manifest ilegível: segue subindo */ }
|
|
41
|
+
}
|
|
42
|
+
const parent = path.dirname(dir);
|
|
43
|
+
if (parent === dir)
|
|
44
|
+
return path.resolve(start);
|
|
45
|
+
dir = parent;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
/** Raiz dos assets versionados — a raiz do pacote nos dois layouts. */
|
|
49
|
+
export const pkgRoot = findPkgRoot(codeRoot);
|
|
50
|
+
/** Caminho de um asset versionado (ex.: `asset('memory', '90-decisions')`). */
|
|
51
|
+
export function asset(...segments) {
|
|
52
|
+
return path.join(pkgRoot, ...segments);
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Resolve um script/bin para o arquivo que existe, **agnóstico de extensão**: tenta o caminho
|
|
56
|
+
* dado e depois `.ts → .js → .mjs`. Em dev acha a fonte `.ts`; publicado, o `.js` sob `dist/`.
|
|
57
|
+
* Devolve o candidato original quando nada existe — o spawn então falha visível, não silencioso.
|
|
58
|
+
*/
|
|
59
|
+
export function resolveScript(root, rel) {
|
|
60
|
+
const direct = path.join(root, rel);
|
|
61
|
+
if (fs.existsSync(direct))
|
|
62
|
+
return direct;
|
|
63
|
+
const base = direct.replace(/\.(mjs|cjs|js|ts)$/, '');
|
|
64
|
+
for (const ext of ['.ts', '.js', '.mjs']) {
|
|
65
|
+
if (fs.existsSync(base + ext))
|
|
66
|
+
return base + ext;
|
|
67
|
+
}
|
|
68
|
+
return direct;
|
|
69
|
+
}
|
|
70
|
+
/** Script do Forja relativo à raiz do código (ex.: `script('bin/create-memory-nest-kit')`). */
|
|
71
|
+
export function script(rel) {
|
|
72
|
+
return resolveScript(codeRoot, rel);
|
|
73
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/project-wiring.ts — liga um projeto à inteligência do Forja (ADR-0086).
|
|
3
|
+
*
|
|
4
|
+
* Um projeto gerado só é "Forja" se a IA que o abre enxergar o processo: instruções nativas que
|
|
5
|
+
* cada ferramenta lê sozinha, hooks que trazem o estado na abertura da sessão, sub-agents por papel
|
|
6
|
+
* e o MCP do Forja. Antes da v5 nada disso era emitido — as instruções iam para `.ia-instructions/`
|
|
7
|
+
* (que nenhuma IA lê), copiadas do texto do FRAMEWORK (com `npm run` que não existe no projeto).
|
|
8
|
+
*
|
|
9
|
+
* Duas faces da mesma fonte de verdade:
|
|
10
|
+
* - `wireProject` escreve/atualiza (idempotente; preserva conteúdo do usuário).
|
|
11
|
+
* - `checkProjectWiring` verifica, incluindo que todo `forja <cmd>` citado existe no registry e
|
|
12
|
+
* que todo `node <arquivo>` dos package.json aponta para arquivo real.
|
|
13
|
+
*
|
|
14
|
+
* Conteúdo gerenciado em Markdown vive entre `<!-- forja:begin -->` e `<!-- forja:end -->`: o
|
|
15
|
+
* wire reescreve só o bloco, o resto do arquivo é do usuário.
|
|
16
|
+
*/
|
|
17
|
+
export declare const BEGIN = "<!-- forja:begin -->";
|
|
18
|
+
export declare const END = "<!-- forja:end -->";
|
|
19
|
+
export declare const SUPPORTED_AI: readonly ['claude', 'codex', 'gemini', 'copilot'];
|
|
20
|
+
/** Onde cada IA lê as instruções nativamente. */
|
|
21
|
+
export declare const INSTRUCTION_FILE: Readonly<Record<string, string>>;
|
|
22
|
+
export declare const ROLES: readonly ['orchestrator', 'product', 'sdd-architect', 'context-engineer', 'governance', 'marketing'];
|
|
23
|
+
/** Hooks do Claude Code. Guardados por `command -v`: sem `forja` no PATH, a sessão abre sem erro. */
|
|
24
|
+
export declare const HOOKS: Readonly<Record<string, string>>;
|
|
25
|
+
export declare function hookCommand(cmd: string): string;
|
|
26
|
+
export interface WireOptions {
|
|
27
|
+
/** IAs a conectar. AGENTS.md é sempre escrito (Codex, Copilot agent e Gemini o leem). */
|
|
28
|
+
ai?: readonly string[];
|
|
29
|
+
/** Registrar o codegraph no .mcp.json. Padrão: só se o binário estiver no PATH. */
|
|
30
|
+
codegraph?: boolean;
|
|
31
|
+
}
|
|
32
|
+
export interface WireChange {
|
|
33
|
+
readonly file: string;
|
|
34
|
+
readonly action: 'created' | 'updated' | 'unchanged';
|
|
35
|
+
}
|
|
36
|
+
/** Substitui (ou acrescenta) o bloco gerenciado preservando o resto do arquivo. */
|
|
37
|
+
export declare function upsertManagedBlock(existing: string | null, body: string): string;
|
|
38
|
+
/** IAs já conectadas a um projeto, deduzidas dos arquivos nativos (para `project:wire` sem `--ai`). */
|
|
39
|
+
export declare function detectWiredAi(dir: string): string[];
|
|
40
|
+
/** Escreve/atualiza a conexão do projeto. Idempotente. */
|
|
41
|
+
export declare function wireProject(dir: string, opts?: WireOptions): WireChange[];
|
|
42
|
+
export interface WiringCheck {
|
|
43
|
+
readonly id: string;
|
|
44
|
+
readonly status: 'ok' | 'warn' | 'fail';
|
|
45
|
+
readonly detail: string;
|
|
46
|
+
}
|
|
47
|
+
/** Todo `forja <comando>` citado num texto (blocos de código e inline). */
|
|
48
|
+
export declare function citedForjaCommands(text: string): string[];
|
|
49
|
+
/** `node <arquivo>` dos scripts de um package.json cujo arquivo não existe. */
|
|
50
|
+
export declare function brokenNodeScripts(pkgDir: string): string[];
|
|
51
|
+
export declare function checkProjectWiring(dir: string, { commands, ai }: {
|
|
52
|
+
commands: Record<string, unknown>;
|
|
53
|
+
ai?: readonly string[];
|
|
54
|
+
}): WiringCheck[];
|