forjajs 4.1.1 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +125 -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/specs-index.d.ts +1 -0
- package/dist/lib/specs-index.js +22 -3
- package/dist/lib/status-model.js +24 -8
- 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 +33 -3
- 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.d.ts +1 -1
- package/dist/scripts/forja-status.js +31 -3
- 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 +18 -9
- 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 +21 -8
- package/dist/scripts/sync-universal-memory.js +50 -27
- 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
package/dist/lib/workspace.js
CHANGED
|
@@ -22,6 +22,7 @@ import fs from 'node:fs';
|
|
|
22
22
|
import path from 'node:path';
|
|
23
23
|
import os from 'node:os';
|
|
24
24
|
import { fileURLToPath } from 'node:url';
|
|
25
|
+
import { pkgRoot } from './paths.js';
|
|
25
26
|
const __filename = fileURLToPath(import.meta.url);
|
|
26
27
|
const __dirname = path.dirname(__filename);
|
|
27
28
|
const DEFAULT_WORKSPACE_NAME = 'forja-workspace';
|
|
@@ -51,7 +52,7 @@ export function getForjaMode() {
|
|
|
51
52
|
if (process.env.FORJA_WORKSPACE)
|
|
52
53
|
return 'studio';
|
|
53
54
|
const cwd = path.resolve(process.cwd());
|
|
54
|
-
const frameworkRoot =
|
|
55
|
+
const frameworkRoot = pkgRoot;
|
|
55
56
|
if (cwd !== frameworkRoot && !cwd.startsWith(`${frameworkRoot}${path.sep}`) && fs.existsSync(path.join(cwd, 'package.json')))
|
|
56
57
|
return 'embedded';
|
|
57
58
|
return 'studio';
|
|
@@ -121,7 +122,19 @@ export function listProjects() {
|
|
|
121
122
|
return [];
|
|
122
123
|
return fs
|
|
123
124
|
.readdirSync(dir, { withFileTypes: true })
|
|
124
|
-
.filter((entry) =>
|
|
125
|
+
.filter((entry) => {
|
|
126
|
+
if (entry.isDirectory())
|
|
127
|
+
return true;
|
|
128
|
+
if (entry.isSymbolicLink()) {
|
|
129
|
+
try {
|
|
130
|
+
return fs.statSync(path.join(dir, entry.name)).isDirectory();
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
return false;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
return false;
|
|
137
|
+
})
|
|
125
138
|
.map((entry) => entry.name);
|
|
126
139
|
}
|
|
127
140
|
export function ensureDir(dir) {
|
|
@@ -192,7 +205,7 @@ Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo
|
|
|
192
205
|
return root;
|
|
193
206
|
}
|
|
194
207
|
export function isInsideFrameworkRepo(filePath) {
|
|
195
|
-
const frameworkRoot =
|
|
208
|
+
const frameworkRoot = pkgRoot;
|
|
196
209
|
const resolved = path.resolve(filePath);
|
|
197
210
|
return resolved === frameworkRoot || resolved.startsWith(frameworkRoot + path.sep);
|
|
198
211
|
}
|
|
@@ -201,3 +214,20 @@ export function assertOutsideFrameworkRepo(filePath, operation = 'operacao') {
|
|
|
201
214
|
throw new Error(`${operation} não pode ser executada dentro do repositório do framework Forja. Use o workspace externo (~/forja-workspace).`);
|
|
202
215
|
}
|
|
203
216
|
}
|
|
217
|
+
/**
|
|
218
|
+
* Nome do projeto em que o comando roda: `forja` no repo do framework, o próprio projeto no modo
|
|
219
|
+
* embedded, o projeto do workspace que contém o cwd no studio; `null` fora de qualquer projeto.
|
|
220
|
+
* Usado para carimbar e filtrar handoffs — antes, um handoff de produto aparecia no briefing do
|
|
221
|
+
* framework (e vice-versa), porque todos caíam no mesmo banco sem dono.
|
|
222
|
+
*/
|
|
223
|
+
export function currentProjectName(cwd = process.cwd()) {
|
|
224
|
+
const resolved = path.resolve(cwd);
|
|
225
|
+
if (isInsideFrameworkRepo(resolved))
|
|
226
|
+
return 'forja';
|
|
227
|
+
if (getForjaMode() === 'embedded')
|
|
228
|
+
return path.basename(getWorkspaceRoot());
|
|
229
|
+
const rel = path.relative(getProjectsDir(), resolved);
|
|
230
|
+
if (!rel || rel.startsWith('..') || path.isAbsolute(rel))
|
|
231
|
+
return null;
|
|
232
|
+
return rel.split(path.sep)[0] || null;
|
|
233
|
+
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
2
|
import path from 'node:path';
|
|
3
3
|
import { spawnSync } from 'node:child_process';
|
|
4
|
-
import { graphDocumentId } from
|
|
5
|
-
import { isPathWithinRoot } from
|
|
4
|
+
import { graphDocumentId } from '../../graph/src/index.js';
|
|
5
|
+
import { isPathWithinRoot } from '../../contracts/src/index.js';
|
|
6
6
|
export class SpawnCommandRunner {
|
|
7
7
|
run(command) {
|
|
8
8
|
const started = Date.now();
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createHash, randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, validateTokenBudget, } from
|
|
2
|
+
import { CONTRACT_VERSION, validateTokenBudget, } from '../../contracts/src/index.js';
|
|
3
3
|
export class GraphContextSource {
|
|
4
4
|
provider;
|
|
5
5
|
constructor(provider) { this.provider = provider; }
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, validateCapabilityDefinition, } from
|
|
2
|
+
import { CONTRACT_VERSION, validateCapabilityDefinition, } from '../../contracts/src/index.js';
|
|
3
3
|
export class CapabilityRegistryError extends Error {
|
|
4
4
|
constructor(message) {
|
|
5
5
|
super(message);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION } from
|
|
2
|
+
import { CONTRACT_VERSION } from '../../contracts/src/index.js';
|
|
3
3
|
export class EvaluationError extends Error {
|
|
4
4
|
constructor(message) { super(message); this.name = 'EvaluationError'; }
|
|
5
5
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createHash, randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, } from
|
|
2
|
+
import { CONTRACT_VERSION, } from '../../contracts/src/index.js';
|
|
3
3
|
export class GraphError extends Error {
|
|
4
4
|
constructor(message) {
|
|
5
5
|
super(message);
|
|
@@ -69,7 +69,7 @@ export interface McpAuditEvent {
|
|
|
69
69
|
export interface McpAuditSink {
|
|
70
70
|
append(event: McpAuditEvent): void | Promise<void>;
|
|
71
71
|
}
|
|
72
|
-
export declare const MCP_RESOURCE_URIS: readonly [
|
|
72
|
+
export declare const MCP_RESOURCE_URIS: readonly ['forja://workspace/current', 'forja://project/current', 'forja://specs', 'forja://decisions', 'forja://graph', 'forja://agent/agenda', 'forja://executions'];
|
|
73
73
|
export type McpResourceUri = typeof MCP_RESOURCE_URIS[number];
|
|
74
74
|
export interface McpServerDependencies {
|
|
75
75
|
readonly registry: CapabilityRegistry;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION } from
|
|
2
|
+
import { CONTRACT_VERSION } from '../../contracts/src/index.js';
|
|
3
3
|
export class ObservabilityError extends Error {
|
|
4
4
|
constructor(message) { super(message); this.name = 'ObservabilityError'; }
|
|
5
5
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, validateTokenBudget, } from
|
|
2
|
+
import { CONTRACT_VERSION, validateTokenBudget, } from '../../contracts/src/index.js';
|
|
3
3
|
export class OrchestrationError extends Error {
|
|
4
4
|
constructor(message) {
|
|
5
5
|
super(message);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createHash } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, validateTokenBudget, } from
|
|
2
|
+
import { CONTRACT_VERSION, validateTokenBudget, } from '../../contracts/src/index.js';
|
|
3
3
|
export class PlannerError extends Error {
|
|
4
4
|
constructor(message) {
|
|
5
5
|
super(message);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, isPathWithinRoot, } from
|
|
2
|
+
import { CONTRACT_VERSION, isPathWithinRoot, } from '../../contracts/src/index.js';
|
|
3
3
|
export class PolicyError extends Error {
|
|
4
4
|
constructor(message) {
|
|
5
5
|
super(message);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createHash, randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, validateTokenBudget, } from
|
|
2
|
+
import { CONTRACT_VERSION, validateTokenBudget, } from '../../contracts/src/index.js';
|
|
3
3
|
const DEFAULT_LIMITS = {
|
|
4
4
|
maxSteps: 20,
|
|
5
5
|
maxTokens: 10000,
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createHash, randomUUID } from 'node:crypto';
|
|
2
|
-
import { CONTRACT_VERSION, } from
|
|
2
|
+
import { CONTRACT_VERSION, } from '../../contracts/src/index.js';
|
|
3
3
|
export class SandboxError extends Error {
|
|
4
4
|
constructor(message) { super(message); this.name = 'SandboxError'; }
|
|
5
5
|
}
|
package/dist/scripts/adr.js
CHANGED
|
@@ -17,10 +17,10 @@
|
|
|
17
17
|
import fs from 'node:fs';
|
|
18
18
|
import path from 'node:path';
|
|
19
19
|
import Database from 'better-sqlite3';
|
|
20
|
-
import { GitGraphDocumentSource, SpawnCommandRunner } from
|
|
21
|
-
import { GraphIndexer, GraphLoop } from
|
|
22
|
-
import { SqliteGraphStore, SqliteMigrationRunner } from
|
|
23
|
-
import { getWorkspaceDbDir, getWorkspaceDbPath } from
|
|
20
|
+
import { GitGraphDocumentSource, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
|
|
21
|
+
import { GraphIndexer, GraphLoop } from '../packages/graph/src/index.js';
|
|
22
|
+
import { SqliteGraphStore, SqliteMigrationRunner } from '../packages/adapter-sqlite/src/index.js';
|
|
23
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
|
|
24
24
|
function normalizeAdrId(raw) {
|
|
25
25
|
const digits = /(\d{4})/.exec(raw)?.[1];
|
|
26
26
|
return digits === undefined ? raw : `ADR-${digits}`;
|
|
@@ -3,14 +3,14 @@ import fs from 'node:fs';
|
|
|
3
3
|
import path from 'node:path';
|
|
4
4
|
import { spawnSync } from 'node:child_process';
|
|
5
5
|
import { fileURLToPath } from 'node:url';
|
|
6
|
-
import { initWorkspace, getWorkspaceInfo, listProjects, resolveProject, getWorkspaceProjectsMemoryDir, } from
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
6
|
+
import { initWorkspace, getWorkspaceInfo, listProjects, resolveProject, getWorkspaceProjectsMemoryDir, } from '../lib/workspace.js';
|
|
7
|
+
import { isPathWithinRoot } from '../packages/contracts/src/index.js';
|
|
8
|
+
import { pkgRoot, script } from '../lib/paths.js';
|
|
9
9
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
10
10
|
// `root` = recursos do FRAMEWORK (ex.: design:* lê design-md/) — resolvidos por __dirname.
|
|
11
11
|
// `projectRoot` = o PROJETO do usuário (gsd:* opera em specs/ e .context/ dele) — onde foi invocado.
|
|
12
12
|
// Sem essa separação o gsd escrevia no PACOTE no consumidor (classe spec-cli v1.6.2/check-standards v1.7.1).
|
|
13
|
-
const root =
|
|
13
|
+
const root = pkgRoot;
|
|
14
14
|
const projectRoot = process.cwd();
|
|
15
15
|
const DESIGN_REQUIRED = [
|
|
16
16
|
'Feature/superficie',
|
|
@@ -85,15 +85,17 @@ function readText(file) {
|
|
|
85
85
|
return fs.readFileSync(full, 'utf8');
|
|
86
86
|
}
|
|
87
87
|
// --- Codegraph (ADR-0017): code intelligence como gate do GSD ---
|
|
88
|
+
// O índice é do código ONDE o usuário está (projeto ou repo do framework) — com `cwd: root`, um
|
|
89
|
+
// `code:impact` dentro de um projeto analisava o código do pacote do Forja.
|
|
88
90
|
function runCodegraph(args) {
|
|
89
|
-
const result = spawnSync('codegraph', args, { cwd:
|
|
91
|
+
const result = spawnSync('codegraph', args, { cwd: process.cwd(), encoding: 'utf8' });
|
|
90
92
|
if (result.error && result.error.code === 'ENOENT') {
|
|
91
93
|
return { missing: true };
|
|
92
94
|
}
|
|
93
95
|
if (result.error && result.error.code === 'EPERM') {
|
|
94
96
|
const quote = (value) => `'${String(value).replace(/'/g, `'\\''`)}'`;
|
|
95
97
|
const fallback = spawnSync('/bin/sh', ['-lc', ['codegraph', ...args.map(quote)].join(' ')], {
|
|
96
|
-
cwd:
|
|
98
|
+
cwd: process.cwd(),
|
|
97
99
|
encoding: 'utf8',
|
|
98
100
|
});
|
|
99
101
|
return {
|
|
@@ -178,7 +180,7 @@ function cmdCodeCheck() {
|
|
|
178
180
|
}
|
|
179
181
|
function cmdCodeImpact([symbol, depthArg]) {
|
|
180
182
|
if (!symbol)
|
|
181
|
-
fail('Uso:
|
|
183
|
+
fail('Uso: forja code:impact <simbolo> [profundidade]');
|
|
182
184
|
// `symbol` vira um elemento de argv passado direto para o binário `codegraph` — não há shell
|
|
183
185
|
// envolvido no caminho normal, então não é injeção de comando, mas um valor começando com `-`
|
|
184
186
|
// ainda pode ser lido como flag pelo `codegraph` em vez de símbolo posicional (injeção de
|
|
@@ -211,7 +213,7 @@ function cmdCodeImpact([symbol, depthArg]) {
|
|
|
211
213
|
}
|
|
212
214
|
function cmdDesignCheck([briefPath]) {
|
|
213
215
|
if (!briefPath)
|
|
214
|
-
fail('Uso:
|
|
216
|
+
fail('Uso: forja design:check <brief.md>');
|
|
215
217
|
const content = readText(briefPath);
|
|
216
218
|
const missing = DESIGN_REQUIRED.filter((needle) => !content.includes(needle));
|
|
217
219
|
const placeholders = (content.match(/<[^>\n]+>/g) || []).length;
|
|
@@ -243,7 +245,7 @@ function cmdDesignSelect([surface = 'agent-console', tone = 'tecnico']) {
|
|
|
243
245
|
}
|
|
244
246
|
function cmdHermesHandoff([jsonArg]) {
|
|
245
247
|
if (!jsonArg)
|
|
246
|
-
fail('Uso:
|
|
248
|
+
fail('Uso: forja hermes:handoff \'<json ADR-0005>\'');
|
|
247
249
|
let payload;
|
|
248
250
|
try {
|
|
249
251
|
payload = JSON.parse(jsonArg);
|
|
@@ -255,9 +257,11 @@ function cmdHermesHandoff([jsonArg]) {
|
|
|
255
257
|
const missing = required.filter((field) => !payload[field] || typeof payload[field] !== 'string');
|
|
256
258
|
if (missing.length)
|
|
257
259
|
fail(`Campos ADR-0005 ausentes: ${missing.join(', ')}`);
|
|
258
|
-
const router =
|
|
260
|
+
const router = script('scripts/agent-router.mjs');
|
|
261
|
+
// cwd do usuário: o router carimba o projeto e resolve o banco a partir dele. Com `cwd: root`
|
|
262
|
+
// (o pacote), todo handoff de produto entrava como handoff do framework.
|
|
259
263
|
const result = spawnSync(process.execPath, [router, 'append', JSON.stringify(payload)], {
|
|
260
|
-
cwd:
|
|
264
|
+
cwd: process.cwd(),
|
|
261
265
|
encoding: 'utf8',
|
|
262
266
|
});
|
|
263
267
|
if (result.stdout)
|
|
@@ -267,9 +271,11 @@ function cmdHermesHandoff([jsonArg]) {
|
|
|
267
271
|
process.exit(result.status ?? 1);
|
|
268
272
|
}
|
|
269
273
|
function appendHandoff(payload) {
|
|
270
|
-
const router =
|
|
274
|
+
const router = script('scripts/agent-router.mjs');
|
|
275
|
+
// cwd do usuário: o router carimba o projeto e resolve o banco a partir dele. Com `cwd: root`
|
|
276
|
+
// (o pacote), todo handoff de produto entrava como handoff do framework.
|
|
271
277
|
const result = spawnSync(process.execPath, [router, 'append', JSON.stringify(payload)], {
|
|
272
|
-
cwd:
|
|
278
|
+
cwd: process.cwd(),
|
|
273
279
|
encoding: 'utf8',
|
|
274
280
|
});
|
|
275
281
|
if (result.stdout)
|
|
@@ -327,7 +333,7 @@ function cmdGsdPlan([slug = 'run', ...goalParts]) {
|
|
|
327
333
|
}
|
|
328
334
|
function cmdGsdHandoff([phase, slug, ...contextParts]) {
|
|
329
335
|
if (!phase || !slug)
|
|
330
|
-
fail('Uso:
|
|
336
|
+
fail('Uso: forja gsd:handoff <spec|plan|implement|review> <slug> [contexto]');
|
|
331
337
|
const template = GSD_HANDOFFS[phase];
|
|
332
338
|
if (!template)
|
|
333
339
|
fail(`Fase invalida: ${phase}. Use: ${Object.keys(GSD_HANDOFFS).join('|')}`);
|
|
@@ -349,7 +355,7 @@ function cmdGsdHandoff([phase, slug, ...contextParts]) {
|
|
|
349
355
|
}
|
|
350
356
|
function cmdGsdCheck([slug, briefPath]) {
|
|
351
357
|
if (!slug)
|
|
352
|
-
fail('Uso:
|
|
358
|
+
fail('Uso: forja gsd:check <slug> [brief.md]');
|
|
353
359
|
const safeSlug = slug.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
|
|
354
360
|
const checks = [];
|
|
355
361
|
const runbook = path.join(projectRoot, '.context', `gsd-${safeSlug}.md`);
|
|
@@ -367,7 +373,7 @@ function cmdGsdCheck([slug, briefPath]) {
|
|
|
367
373
|
// O spec:check tem de rodar no PROJETO do usuário (cwd), não no pacote, e resolver o script pela
|
|
368
374
|
// extensão certa (`.ts` no dev, `.js` no dist publicado). Cravar `cwd: root` + `scripts/spec-cli.mjs`
|
|
369
375
|
// auditava/carregava o pacote no consumidor (mesma classe spec-cli v1.6.2).
|
|
370
|
-
const specCli =
|
|
376
|
+
const specCli = script('scripts/spec-cli');
|
|
371
377
|
const specCheck = spawnSync(process.execPath, [specCli, 'check', safeSlug], {
|
|
372
378
|
cwd: projectRoot,
|
|
373
379
|
encoding: 'utf8',
|
|
@@ -437,19 +443,19 @@ function cmdWorkspaceInit() {
|
|
|
437
443
|
console.log(` ${path.join(rootDir, 'specs')}`);
|
|
438
444
|
console.log(` ${path.join(rootDir, '.context')}`);
|
|
439
445
|
if (!infoBefore.exists) {
|
|
440
|
-
console.log('\nPróximo passo:
|
|
446
|
+
console.log('\nPróximo passo: forja project:new <nome>');
|
|
441
447
|
}
|
|
442
448
|
}
|
|
443
449
|
function cmdProjectNew([name, ...rest]) {
|
|
444
450
|
if (!name)
|
|
445
|
-
fail('Uso:
|
|
451
|
+
fail('Uso: forja project:new <nome> [--ai claude,copilot] [--skip-backend]');
|
|
446
452
|
const safeName = name.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
|
|
447
453
|
const projectDir = resolveProject(safeName);
|
|
448
454
|
if (fs.existsSync(projectDir)) {
|
|
449
455
|
fail(`Projeto ja existe no workspace: ${projectDir}`);
|
|
450
456
|
}
|
|
451
|
-
// Repassa flags para
|
|
452
|
-
const result = spawnSync('node', [
|
|
457
|
+
// Repassa flags para o gerador (script() acha .ts em dev e .js publicado)
|
|
458
|
+
const result = spawnSync('node', [script('bin/init-project'), safeName, ...rest], {
|
|
453
459
|
cwd: root,
|
|
454
460
|
encoding: 'utf8',
|
|
455
461
|
stdio: 'inherit',
|
|
@@ -501,8 +507,8 @@ function cmdProjectList() {
|
|
|
501
507
|
}
|
|
502
508
|
function cmdProjectCheck([name]) {
|
|
503
509
|
if (!name)
|
|
504
|
-
fail('Uso:
|
|
505
|
-
const result = spawnSync('node', [
|
|
510
|
+
fail('Uso: forja workspace:project:check <nome>');
|
|
511
|
+
const result = spawnSync('node', [script('scripts/check-standards'), name], {
|
|
506
512
|
cwd: root,
|
|
507
513
|
encoding: 'utf8',
|
|
508
514
|
stdio: 'inherit',
|
|
@@ -510,7 +516,8 @@ function cmdProjectCheck([name]) {
|
|
|
510
516
|
process.exit(result.status ?? 1);
|
|
511
517
|
}
|
|
512
518
|
function showHelp() {
|
|
513
|
-
console.log(`
|
|
519
|
+
console.log(`Script interno do Forja — use os comandos via core: forja help --all
|
|
520
|
+
|
|
514
521
|
|
|
515
522
|
Workspace:
|
|
516
523
|
workspace:init Cria estrutura base do workspace Forja
|
|
@@ -32,10 +32,12 @@ import path from 'node:path';
|
|
|
32
32
|
import process from 'node:process';
|
|
33
33
|
import { fileURLToPath } from 'node:url';
|
|
34
34
|
import Database from 'better-sqlite3';
|
|
35
|
-
import { getDbPath, ensureSchema } from
|
|
35
|
+
import { getDbPath, ensureSchema } from './memory-schema.js';
|
|
36
|
+
import { pkgRoot } from '../lib/paths.js';
|
|
37
|
+
import { currentProjectName } from '../lib/workspace.js';
|
|
36
38
|
const __filename = fileURLToPath(import.meta.url);
|
|
37
39
|
const __dirname = path.dirname(__filename);
|
|
38
|
-
const root =
|
|
40
|
+
const root = pkgRoot;
|
|
39
41
|
ensureSchema({ silent: true });
|
|
40
42
|
const dbPath = getDbPath();
|
|
41
43
|
const REQUIRED = ['from', 'to', 'intent', 'context', 'acceptance', 'constraints', 'return'];
|
|
@@ -118,6 +120,12 @@ function parsePayload(raw) {
|
|
|
118
120
|
function cmdAppend(arg) {
|
|
119
121
|
const raw = arg && arg !== '-' ? arg : readStdin();
|
|
120
122
|
const h = parsePayload(raw);
|
|
123
|
+
// Carimba o projeto de origem (no payload, sem migração de schema) para o briefing filtrar.
|
|
124
|
+
if (!h.project) {
|
|
125
|
+
const p = currentProjectName();
|
|
126
|
+
if (p)
|
|
127
|
+
h.project = p;
|
|
128
|
+
}
|
|
121
129
|
const db = openDb();
|
|
122
130
|
const stmt = db.prepare(`
|
|
123
131
|
INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, payload_json)
|
|
@@ -133,20 +141,29 @@ function cmdList(args) {
|
|
|
133
141
|
const params = [];
|
|
134
142
|
if (args.includes('--open'))
|
|
135
143
|
filters.push("status = 'open'");
|
|
144
|
+
// --project <nome> filtra pelo carimbo; --mine = o projeto do cwd (ou o framework).
|
|
145
|
+
const projIdx = args.indexOf('--project');
|
|
146
|
+
const project = projIdx >= 0 ? args[projIdx + 1] : args.includes('--mine') ? currentProjectName() : null;
|
|
147
|
+
if ((projIdx >= 0 || args.includes('--mine')) && !project)
|
|
148
|
+
fail('--mine fora de um projeto: rode dentro dele ou use --project <nome>');
|
|
149
|
+
if (project) {
|
|
150
|
+
filters.push("json_extract(payload_json, '$.project') = ?");
|
|
151
|
+
params.push(project);
|
|
152
|
+
}
|
|
136
153
|
const toIdx = args.indexOf('--to');
|
|
137
154
|
if (toIdx >= 0 && args[toIdx + 1]) {
|
|
138
155
|
filters.push('to_agent = ?');
|
|
139
156
|
params.push(args[toIdx + 1]);
|
|
140
157
|
}
|
|
141
158
|
const where = filters.length ? `WHERE ${filters.join(' AND ')}` : '';
|
|
142
|
-
const rows = db.prepare(`SELECT id, created_at, from_agent, to_agent, intent, status, spec_slug FROM handoffs ${where} ORDER BY id DESC LIMIT 50`).all(...params);
|
|
159
|
+
const rows = db.prepare(`SELECT id, created_at, from_agent, to_agent, intent, status, spec_slug, json_extract(payload_json, '$.project') AS project FROM handoffs ${where} ORDER BY id DESC LIMIT 50`).all(...params);
|
|
143
160
|
if (!rows.length) {
|
|
144
161
|
console.log('(sem handoffs)');
|
|
145
162
|
db.close();
|
|
146
163
|
return;
|
|
147
164
|
}
|
|
148
165
|
for (const r of rows) {
|
|
149
|
-
console.log(`#${r.id} [${r.status}] ${r.from_agent} → ${r.to_agent} (${r.intent}) ${r.spec_slug || ''} — ${r.created_at}`);
|
|
166
|
+
console.log(`#${r.id} [${r.status}] ${r.project ? `{${r.project}} ` : '{sem projeto} '}${r.from_agent} → ${r.to_agent} (${r.intent}) ${r.spec_slug || ''} — ${r.created_at}`);
|
|
150
167
|
}
|
|
151
168
|
db.close();
|
|
152
169
|
}
|
|
@@ -203,6 +220,6 @@ switch (subcmd) {
|
|
|
203
220
|
cmdSchema();
|
|
204
221
|
break;
|
|
205
222
|
default:
|
|
206
|
-
console.log('Uso: agent
|
|
223
|
+
console.log('Uso: forja agent:route <append|list [--open] [--mine|--project <nome>] [--to <papel>]|show|done|in_progress|cancel|archive|schema> [args]');
|
|
207
224
|
process.exit(1);
|
|
208
225
|
}
|
package/dist/scripts/agent.js
CHANGED
|
@@ -26,11 +26,11 @@
|
|
|
26
26
|
*/
|
|
27
27
|
import fs from 'node:fs';
|
|
28
28
|
import Database from 'better-sqlite3';
|
|
29
|
-
import { computeReputationScore, recommendAgent } from
|
|
30
|
-
import { detectAnomaly } from
|
|
31
|
-
import { EvaluationEngine } from
|
|
32
|
-
import { SqliteAgentProfileStore, SqliteMigrationRunner, SqliteObservationStore } from
|
|
33
|
-
import { getWorkspaceDbDir, getWorkspaceDbPath } from
|
|
29
|
+
import { computeReputationScore, recommendAgent } from '../packages/engineering/identity/src/index.js';
|
|
30
|
+
import { detectAnomaly } from '../packages/engineering/monitoring/src/index.js';
|
|
31
|
+
import { EvaluationEngine } from '../packages/evals/src/index.js';
|
|
32
|
+
import { SqliteAgentProfileStore, SqliteMigrationRunner, SqliteObservationStore } from '../packages/adapter-sqlite/src/index.js';
|
|
33
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
|
|
34
34
|
function flag(args, name) {
|
|
35
35
|
const index = args.indexOf(name);
|
|
36
36
|
return index === -1 ? undefined : args[index + 1];
|
|
@@ -16,12 +16,12 @@
|
|
|
16
16
|
import fs from 'node:fs';
|
|
17
17
|
import path from 'node:path';
|
|
18
18
|
import Database from 'better-sqlite3';
|
|
19
|
-
import { checkConstitution, compileConstitution, explainRule } from
|
|
20
|
-
import { ApprovalLedger } from
|
|
21
|
-
import { GitGraphDocumentSource, SpawnCommandRunner } from
|
|
22
|
-
import { GraphIndexer, GraphLoop } from
|
|
23
|
-
import { SqliteApprovalStore, SqliteGraphStore, SqliteMigrationRunner } from
|
|
24
|
-
import { getWorkspaceDbDir, getWorkspaceDbPath } from
|
|
19
|
+
import { checkConstitution, compileConstitution, explainRule } from '../packages/engineering/architecture/src/index.js';
|
|
20
|
+
import { ApprovalLedger } from '../packages/policy/src/index.js';
|
|
21
|
+
import { GitGraphDocumentSource, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
|
|
22
|
+
import { GraphIndexer, GraphLoop } from '../packages/graph/src/index.js';
|
|
23
|
+
import { SqliteApprovalStore, SqliteGraphStore, SqliteMigrationRunner } from '../packages/adapter-sqlite/src/index.js';
|
|
24
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
|
|
25
25
|
const CONSTITUTION_PATH = '.context/architecture/constitution.json';
|
|
26
26
|
function graphRoot() {
|
|
27
27
|
return process.env.FORJA_GRAPH_ROOT ?? process.cwd();
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* forja audit:query --cmd release:check por comando
|
|
6
6
|
* forja audit:query --since 7d janela de tempo (Nd/Nh/Nm)
|
|
7
7
|
*/
|
|
8
|
-
import { queryAudit, defaultEnv } from
|
|
8
|
+
import { queryAudit, defaultEnv } from '../lib/audit.js';
|
|
9
9
|
function parseArgs(argv) {
|
|
10
10
|
const o = {};
|
|
11
11
|
for (let i = 0; i < argv.length; i += 1) {
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
* audit:sync — projeta o `.context/forja-runs.jsonl` na tabela consultável `audit_runs` (SPEC-014).
|
|
4
4
|
* Idempotente. O `.jsonl` segue sendo a fonte de verdade; esta tabela é reconstruível.
|
|
5
5
|
*/
|
|
6
|
-
import { syncAudit, defaultEnv } from
|
|
6
|
+
import { syncAudit, defaultEnv } from '../lib/audit.js';
|
|
7
7
|
try {
|
|
8
8
|
const r = await syncAudit(defaultEnv());
|
|
9
9
|
if (r.total === 0) {
|
|
@@ -1 +1,19 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* forja context:smart — pack de contexto mínimo-suficiente nos 3 modos da ADR-0003.
|
|
3
|
+
*
|
|
4
|
+
* forja context:smart global (missão, padrões, ADRs)
|
|
5
|
+
* forja context:smart --mode domain + visão/design/regras do projeto
|
|
6
|
+
* forja context:smart --mode task --task pix + nós do projeto que casam com a tarefa (FTS5)
|
|
7
|
+
* forja context:smart <projeto> [keyword] forma posicional antiga (studio) — ainda aceita
|
|
8
|
+
*
|
|
9
|
+
* O projeto é inferido de onde o comando roda: no modo embedded é o próprio projeto; no studio,
|
|
10
|
+
* o projeto do workspace em que o cwd está. A lógica de montagem vive em lib/context-builder.ts —
|
|
11
|
+
* este script só resolve argumentos, projeto e destino. Antes da v5 o comando apontava para um
|
|
12
|
+
* script que ignorava `--mode` e exigia `<projeto>`, embora o help prometesse os três modos.
|
|
13
|
+
*/
|
|
14
|
+
export declare function parseArgs(argv: readonly string[]): {
|
|
15
|
+
mode?: string;
|
|
16
|
+
task?: string;
|
|
17
|
+
project?: string;
|
|
18
|
+
positional: string[];
|
|
19
|
+
};
|