@hoangsonw/forge 0.1.0

package/bin/forge.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * Forge CLI entry point.
+ *
+ * This shim locates the compiled CLI and forwards argv.
+ * In production (installed via npm), dist/ is shipped.
+ * In development, we fall back to ts-node on src/cli/index.ts.
+ */
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+const projectRoot = path.resolve(__dirname, '..');
+const compiled = path.join(projectRoot, 'dist', 'cli', 'index.js');
+
+if (fs.existsSync(compiled)) {
+  require(compiled);
+} else {
+  // Development fallback
+  try {
+    require('ts-node/register');
+    require(path.join(projectRoot, 'src', 'cli', 'index.ts'));
+  } catch (err) {
+    console.error('[forge] Compiled output not found and ts-node is unavailable.');
+    console.error('[forge] Run `npm run build` or install ts-node.');
+    console.error(err && err.message ? err.message : err);
+    process.exit(1);
+  }
+}

package/dist/agents/architect.d.ts

@@ -0,0 +1,20 @@
+import { Agent } from './base';
+export interface ArchitectureOutput {
+    goal: string;
+    approach: string;
+    components: Array<{
+        name: string;
+        responsibility: string;
+        interactions: string[];
+    }>;
+    tradeoffs: Array<{
+        option: string;
+        pros: string[];
+        cons: string[];
+    }>;
+    recommendation: string;
+    risks: string[];
+    openQuestions: string[];
+}
+export declare const architectAgent: Agent;
+//# sourceMappingURL=architect.d.ts.map

package/dist/agents/architect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AA+B5C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpF,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAWD,eAAO,MAAM,cAAc,EAAE,KAiC5B,CAAC"}

package/dist/agents/architect.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.architectAgent = void 0;
+const router_1 = require("../models/router");
+const assembler_1 = require("../prompts/assembler");
+const loader_1 = require("../config/loader");
+const retrieval_1 = require("../memory/retrieval");
+const logger_1 = require("../logging/logger");
+/**
+ * Architect agent — produces a system-level design document (not a plan).
+ * Use this explicitly via `--mode architect` when the task is "how should we
+ * structure X". No file edits; the output is prose/diagram text the user
+ * can decide to feed back in as an approved plan seed.
+ */
+const architectSchema = `You are an Architect. You do NOT modify files — you only produce a design document.
+
+Output STRICT JSON:
+{
+  "goal": string,
+  "approach": string,            // 1–3 paragraphs
+  "components": [
+    { "name": string, "responsibility": string, "interactions": string[] }
+  ],
+  "tradeoffs": [
+    { "option": string, "pros": string[], "cons": string[] }
+  ],
+  "recommendation": string,
+  "risks": string[],
+  "openQuestions": string[]
+}`;
+const parse = (content) => {
+    const fence = /```(?:json)?\s*([\s\S]+?)\s*```/i.exec(content);
+    try {
+        return JSON.parse(fence ? fence[1] : content);
+    }
+    catch {
+        return null;
+    }
+};
+exports.architectAgent = {
+    name: 'architect',
+    description: 'Produces system-level design documents. No file edits.',
+    async run(ctx) {
+        const retrieved = (0, retrieval_1.retrieve)({
+            projectRoot: ctx.projectRoot,
+            query: `${ctx.task.title}\n${ctx.task.description ?? ''}`,
+            maxColdHits: 12,
+            maxWarmFiles: 10,
+        });
+        const prompt = (0, assembler_1.assembleTaskPrompt)({
+            mode: ctx.mode,
+            title: `Architect: ${ctx.task.title}`,
+            description: ctx.task.description,
+            globalInstructions: (0, loader_1.loadGlobalInstructions)(),
+            projectInstructions: (0, loader_1.loadProjectInstructions)(ctx.projectRoot),
+            contextBlocks: retrieved.blocks,
+            additionalUserText: `${architectSchema}\n\nREQUEST:\n${ctx.task.title}\n${ctx.task.description ?? ''}`,
+        });
+        try {
+            const { response } = await (0, router_1.callModel)('architect', ctx.mode, prompt.messages, {
+                jsonMode: true,
+                temperature: 0.2,
+                maxTokens: 3000,
+                timeoutMs: 90_000,
+            });
+            const parsed = parse(response.content);
+            return { success: Boolean(parsed), output: parsed ?? { raw: response.content }, prompt };
+        }
+        catch (err) {
+            logger_1.log.warn('architect failed', { err: String(err) });
+            return { success: false, message: String(err) };
+        }
+    },
+};
+//# sourceMappingURL=architect.js.map

package/dist/agents/architect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architect.js","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":";;;AACA,6CAA6C;AAC7C,oDAA0D;AAC1D,6CAAmF;AACnF,mDAA+C;AAC/C,8CAAwC;AAExC;;;;;GAKG;AAEH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;EAetB,CAAC;AAYH,MAAM,KAAK,GAAG,CAAC,OAAe,EAA6B,EAAE;IAC3D,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAuB,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEW,QAAA,cAAc,GAAU;IACnC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,wDAAwD;IACrE,KAAK,CAAC,GAAG,CAAC,GAAG;QACX,MAAM,SAAS,GAAG,IAAA,oBAAQ,EAAC;YACzB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,KAAK,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE;YACzD,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE;SACjB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,8BAAkB,EAAC;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,cAAc,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;YACrC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW;YACjC,kBAAkB,EAAE,IAAA,+BAAsB,GAAE;YAC5C,mBAAmB,EAAE,IAAA,gCAAuB,EAAC,GAAG,CAAC,WAAW,CAAC;YAC7D,aAAa,EAAE,SAAS,CAAC,MAAM;YAC/B,kBAAkB,EAAE,GAAG,eAAe,iBAAiB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE;SACvG,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAA,kBAAS,EAAC,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAC3E,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/agents/base.d.ts

@@ -0,0 +1,20 @@
+import { Mode, Task } from '../types';
+import { AssembledPrompt } from '../types';
+export interface AgentExecutionContext {
+    task: Task;
+    projectRoot: string;
+    mode: Mode;
+}
+export interface Agent {
+    readonly name: string;
+    readonly description: string;
+    run(ctx: AgentExecutionContext): Promise<AgentResult>;
+}
+export interface AgentResult {
+    success: boolean;
+    output?: unknown;
+    message?: string;
+    prompt?: AssembledPrompt;
+    filesChanged?: string[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/agents/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/agents/base.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base.js.map

package/dist/agents/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":""}

package/dist/agents/debugger.d.ts

@@ -0,0 +1,16 @@
+import { Agent } from './base';
+export interface DebugDiagnosis {
+    rootCause: string;
+    hypotheses: string[];
+    suggestedFix: string;
+    confidence: number;
+}
+export interface DebuggerInput {
+    failureMessage: string;
+    failureContext: string;
+    attemptsSoFar: number;
+    relevantFiles?: string[];
+}
+export declare const diagnose: (input: DebuggerInput, mode: import("../types").Mode) => Promise<DebugDiagnosis>;
+export declare const debuggerAgent: Agent;
+//# sourceMappingURL=debugger.d.ts.map

package/dist/agents/debugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../../src/agents/debugger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAM5C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AA0BD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,QAAQ,GACnB,OAAO,aAAa,EACpB,MAAM,OAAO,UAAU,EAAE,IAAI,KAC5B,OAAO,CAAC,cAAc,CAuDxB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAM3B,CAAC"}

package/dist/agents/debugger.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debuggerAgent = exports.diagnose = void 0;
+const router_1 = require("../models/router");
+const assembler_1 = require("../prompts/assembler");
+const logger_1 = require("../logging/logger");
+const index_db_1 = require("../persistence/index-db");
+const debuggerSchema = `You are a debugger agent. Given the failure context, output STRICT JSON:
+{
+  "rootCause": string,
+  "hypotheses": string[],
+  "suggestedFix": string,
+  "confidence": number
+}`;
+const parse = (content) => {
+    const fence = /```(?:json)?\s*([\s\S]+?)\s*```/i.exec(content);
+    try {
+        const obj = JSON.parse(fence ? fence[1] : content);
+        return {
+            rootCause: String(obj.rootCause ?? ''),
+            hypotheses: Array.isArray(obj.hypotheses) ? obj.hypotheses.map(String) : [],
+            suggestedFix: String(obj.suggestedFix ?? ''),
+            confidence: typeof obj.confidence === 'number' ? Math.max(0, Math.min(1, obj.confidence)) : 0.5,
+        };
+    }
+    catch {
+        return null;
+    }
+};
+const diagnose = async (input, mode) => {
+    const prompt = (0, assembler_1.assembleTaskPrompt)({
+        mode,
+        title: 'Diagnose a failure',
+        description: input.failureMessage,
+        contextBlocks: input.failureContext
+            ? [{ source: 'failure', content: input.failureContext }]
+            : undefined,
+        additionalUserText: `${debuggerSchema}
+
+Failure:
+${input.failureMessage}
+
+Attempts: ${input.attemptsSoFar}
+
+Context:
+${input.failureContext}`,
+    });
+    try {
+        const { response } = await (0, router_1.callModel)('debugger', mode, prompt.messages, {
+            jsonMode: true,
+            temperature: 0.2,
+            maxTokens: 900,
+            timeoutMs: 60_000,
+        });
+        const parsed = parse(response.content);
+        if (parsed && parsed.rootCause) {
+            // Opportunistic learning capture.
+            (0, index_db_1.upsertLearning)({
+                pattern: parsed.rootCause.slice(0, 200),
+                context: (input.relevantFiles ?? []).join(',').slice(0, 200),
+                fix: parsed.suggestedFix.slice(0, 400),
+                confidence: parsed.confidence,
+                success_count: 0,
+                failure_count: 1,
+                updated_at: new Date().toISOString(),
+            });
+        }
+        return (parsed ?? {
+            rootCause: 'unknown',
+            hypotheses: [],
+            suggestedFix: 'retry with narrower scope',
+            confidence: 0.3,
+        });
+    }
+    catch (err) {
+        logger_1.log.warn('debugger failed', { err: String(err) });
+        return {
+            rootCause: 'debugger unavailable',
+            hypotheses: [String(err)],
+            suggestedFix: 'retry with different tool or escalate to user',
+            confidence: 0.1,
+        };
+    }
+};
+exports.diagnose = diagnose;
+exports.debuggerAgent = {
+    name: 'debugger',
+    description: 'Performs root-cause analysis on failures.',
+    async run() {
+        return { success: false, message: 'debugger.run is a delegate; use diagnose()' };
+    },
+};
+//# sourceMappingURL=debugger.js.map

package/dist/agents/debugger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger.js","sourceRoot":"","sources":["../../src/agents/debugger.ts"],"names":[],"mappings":"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"}

package/dist/agents/executor.d.ts

@@ -0,0 +1,48 @@
+import { Agent } from './base';
+import { PlanStep, ToolResult } from '../types';
+import { PermissionFlags } from '../permissions/manager';
+export interface ExecutorStepOutput {
+    step: PlanStep;
+    toolResults: Array<{
+        tool: string;
+        args: unknown;
+        result: ToolResult<unknown>;
+    }>;
+    summary: string;
+    filesChanged: string[];
+    /** Number of model turns the executor consumed for this step. */
+    turns: number;
+    /** True when the model explicitly signalled `done`. */
+    completed: boolean;
+}
+export declare const executorAgent: Agent;
+export interface RunStepParams {
+    step: PlanStep;
+    projectRoot: string;
+    taskId: string;
+    projectId: string;
+    mode: import('../types').Mode;
+    flags: PermissionFlags;
+    runId?: string;
+    /** Optional override for testing. */
+    validate?: (projectRoot: string) => Promise<{
+        ok: boolean;
+        ran: string[];
+        message?: string;
+    }>;
+}
+export declare const runStep: (params: RunStepParams) => Promise<ExecutorStepOutput>;
+export declare const _parseExecutorOutputForTest: (content: string) => {
+    actions: Array<{
+        tool: string;
+        args: Record<string, unknown>;
+    }>;
+    summary: string;
+    done: boolean;
+};
+export declare const _digestToolResultForTest: (entry: {
+    tool: string;
+    args: unknown;
+    result: ToolResult<unknown>;
+}) => Record<string, unknown>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/agents/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/agents/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAgB,QAAQ,EAAe,UAAU,EAAE,MAAM,UAAU,CAAC;AAK3E,OAAO,EAAqB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;CACpB;AA8FD,eAAO,MAAM,aAAa,EAAE,KAS3B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,UAAU,EAAE,IAAI,CAAC;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED,eAAO,MAAM,OAAO,GAAU,QAAQ,aAAa,KAAG,OAAO,CAAC,kBAAkB,CA2R/E,CAAC;AAmDF,eAAO,MAAM,2BAA2B,YAza7B,MAAM,KACd;IACD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CAqa2C,CAAC;AAC5D,eAAO,MAAM,wBAAwB,UA5YJ;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC7B,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAwY8B,CAAC"}