goalforge-claude 1.0.0

package/dist/components/executor.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Executor = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../core/logger");
+const claude_cli_1 = require("./claude-cli");
+const SYSTEM_PROMPT = `You are a senior software engineer implementing a task as part of an autonomous development loop.
+Your output MUST be valid JSON matching this schema (no markdown wrapping):
+{
+  "explanation": "string — brief rationale for your approach",
+  "files": [
+    {
+      "path": "string — relative to workspace root",
+      "content": "string — full file content"
+    }
+  ],
+  "commands": [
+    "string — shell commands to run after files are written (e.g. npm install)"
+  ],
+  "summary": "string — one sentence describing what was done"
+}
+
+Rules:
+- Produce real, working code — no stubs or TODOs unless the task explicitly says so.
+- File paths must be relative to the workspace root (no leading slash).
+- Keep commands minimal and safe (no destructive operations).
+- If no commands are needed, return an empty array.`;
+class Executor {
+    constructor(workspaceDir, optimizer, memory, dryRun = false) {
+        this.workspaceDir = workspaceDir;
+        this.optimizer = optimizer;
+        this.memory = memory;
+        this.dryRun = dryRun;
+        this.log = (0, logger_1.createLogger)('Executor');
+        (0, fs_1.mkdirSync)(workspaceDir, { recursive: true });
+    }
+    async execute(task) {
+        this.log.info('Executing task', { taskId: task.id, objective: task.objective });
+        const context = this.buildContext(task);
+        const cacheKey = this.optimizer.buildCacheKey(task.objective, context);
+        const estimate = this.optimizer.estimate(task.objective + context, 4000, cacheKey);
+        if (estimate.recommendedAction === 'skip') {
+            throw new Error('Budget exhausted — cannot execute task');
+        }
+        let raw;
+        const cached = this.optimizer.getCachedResponse(cacheKey);
+        if (cached) {
+            raw = cached;
+            this.log.debug('Using cached executor response', { taskId: task.id });
+        }
+        else if (this.dryRun) {
+            raw = this.dryRunResponse(task);
+        }
+        else {
+            raw = await this.callApi(task.objective, context);
+            this.optimizer.putCachedResponse(cacheKey, raw);
+        }
+        const parsed = this.parse(raw);
+        const result = await this.apply(task, parsed);
+        this.memory.updateTaskResult(task.id, result);
+        this.log.info('Task executed', {
+            taskId: task.id,
+            filesCreated: result.filesCreated.length,
+            commandsRun: result.commandsRun.length,
+        });
+        return result;
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    buildContext(task) {
+        const decisions = this.memory
+            .loadAllDecisions()
+            .map((d) => `• ${d.title}: ${d.decision}`)
+            .join('\n');
+        const completedTasks = this.memory
+            .loadAllTasks()
+            .filter((t) => t.status === 'COMPLETE' && t.result)
+            .slice(-5) // last 5 for brevity
+            .map((t) => `• ${t.objective}: ${t.result.output.slice(0, 200)}`)
+            .join('\n');
+        return [
+            `Task objective: ${task.objective}`,
+            `Effort: ${task.estimatedEffort}`,
+            decisions ? `\nArchitecture decisions:\n${decisions}` : '',
+            completedTasks ? `\nRecent completed work:\n${completedTasks}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+    }
+    async callApi(objective, context) {
+        const { text, costUsd } = await (0, claude_cli_1.callClaude)(SYSTEM_PROMPT, `TASK: ${objective}\n\nCONTEXT:\n${context}`);
+        this.optimizer.recordCost(costUsd);
+        return text;
+    }
+    parse(raw) {
+        const json = raw.replace(/^```json?\n?/m, '').replace(/```$/m, '').trim();
+        return JSON.parse(json);
+    }
+    async apply(task, parsed) {
+        const filesCreated = [];
+        const commandsRun = [];
+        // Write files
+        for (const file of parsed.files) {
+            const absPath = (0, path_1.join)(this.workspaceDir, file.path);
+            (0, fs_1.mkdirSync)((0, path_1.dirname)(absPath), { recursive: true });
+            (0, fs_1.writeFileSync)(absPath, file.content, 'utf-8');
+            filesCreated.push(absPath);
+            this.memory.recordGeneratedFile(absPath, task.id, file.content);
+            this.log.debug('File written', { path: absPath });
+        }
+        // Run commands
+        for (const cmd of parsed.commands) {
+            try {
+                this.log.info('Running command', { cmd });
+                if (!this.dryRun) {
+                    (0, child_process_1.execSync)(cmd, { cwd: this.workspaceDir, stdio: 'pipe' });
+                }
+                commandsRun.push(cmd);
+            }
+            catch (err) {
+                this.log.warn('Command failed (non-fatal)', { cmd, err: String(err) });
+                commandsRun.push(`FAILED: ${cmd}`);
+            }
+        }
+        return {
+            output: parsed.summary,
+            filesCreated,
+            filesModified: [],
+            commandsRun,
+            tokenUsage: {
+                inputTokens: 0,
+                outputTokens: 0,
+                estimatedCostUsd: this.optimizer.getStats().totalSpendUsd,
+            },
+            executedAt: new Date().toISOString(),
+        };
+    }
+    dryRunResponse(task) {
+        return JSON.stringify({
+            explanation: 'Dry-run — no API call made',
+            files: [
+                {
+                    path: `dry-run/${task.id}.txt`,
+                    content: `Dry-run output for task: ${task.objective}\n`,
+                },
+            ],
+            commands: [],
+            summary: `[DRY-RUN] Completed: ${task.objective}`,
+        });
+    }
+}
+exports.Executor = Executor;
+//# sourceMappingURL=executor.js.map

package/dist/components/executor.js.map

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

package/dist/components/memory-store.d.ts

@@ -0,0 +1,47 @@
+import { ArchitectureDecision, Critique, ProjectState, Task, TaskResult } from '../core/types';
+/**
+ * File-system backed memory store. No external services, no MCP.
+ *
+ * Layout:
+ *   memory/
+ *     state/project.json          ← single project state document
+ *     tasks/<id>.json             ← one file per task
+ *     critiques/<id>.json         ← one file per critique
+ *     decisions/<id>.json         ← one file per ADR
+ *     files/<path-hash>.json      ← metadata for generated files
+ *     cache/<hash>.json           ← cost-optimizer response cache
+ */
+export declare class MemoryStore {
+    private readonly dirs;
+    private readonly log;
+    constructor(memoryDir: string);
+    saveState(state: ProjectState): void;
+    loadState(projectId: string): ProjectState | null;
+    saveTask(task: Task): void;
+    loadTask(taskId: string): Task | null;
+    loadAllTasks(): Task[];
+    updateTaskResult(taskId: string, result: TaskResult): void;
+    saveCritique(critique: Critique): void;
+    loadCritiquesForTask(taskId: string): Critique[];
+    loadAllCritiques(): Critique[];
+    saveDecision(decision: ArchitectureDecision): void;
+    loadAllDecisions(): ArchitectureDecision[];
+    recordGeneratedFile(filePath: string, taskId: string, content?: string): void;
+    loadGeneratedFilePaths(): string[];
+    getCached(cacheKey: string): string | null;
+    putCache(cacheKey: string, response: string): void;
+    getCacheSize(): number;
+    getSummary(): {
+        taskCount: number;
+        completedCount: number;
+        critiqueCount: number;
+        decisionCount: number;
+        generatedFileCount: number;
+        cacheEntries: number;
+    };
+    private write;
+    private read;
+    private readDir;
+    private pathKey;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/components/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/components/memory-store.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,UAAU,EACX,MAAM,eAAe,CAAC;AAGvB;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;gBAEvC,SAAS,EAAE,MAAM;IAkB7B,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMpC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IASjD,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKrC,YAAY,IAAI,IAAI,EAAE;IAItB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAc1D,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKtC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMhD,gBAAgB,IAAI,QAAQ,EAAE;IAM9B,YAAY,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAMlD,gBAAgB,IAAI,oBAAoB,EAAE;IAM1C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAW7E,sBAAsB,IAAI,MAAM,EAAE;IAQlC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlD,YAAY,IAAI,MAAM;IAMtB,UAAU,IAAI;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;KACtB;IAcD,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,OAAO;CAOhB"}

package/dist/components/memory-store.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStore = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../core/logger");
+/**
+ * File-system backed memory store. No external services, no MCP.
+ *
+ * Layout:
+ *   memory/
+ *     state/project.json          ← single project state document
+ *     tasks/<id>.json             ← one file per task
+ *     critiques/<id>.json         ← one file per critique
+ *     decisions/<id>.json         ← one file per ADR
+ *     files/<path-hash>.json      ← metadata for generated files
+ *     cache/<hash>.json           ← cost-optimizer response cache
+ */
+class MemoryStore {
+    constructor(memoryDir) {
+        this.log = (0, logger_1.createLogger)('MemoryStore');
+        this.dirs = {
+            root: memoryDir,
+            state: (0, path_1.join)(memoryDir, 'state'),
+            tasks: (0, path_1.join)(memoryDir, 'tasks'),
+            critiques: (0, path_1.join)(memoryDir, 'critiques'),
+            decisions: (0, path_1.join)(memoryDir, 'decisions'),
+            files: (0, path_1.join)(memoryDir, 'files'),
+            cache: (0, path_1.join)(memoryDir, 'cache'),
+        };
+        for (const dir of Object.values(this.dirs)) {
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+        }
+    }
+    // ── Project State ──────────────────────────────────────────────────────────
+    saveState(state) {
+        const path = (0, path_1.join)(this.dirs.state, 'project.json');
+        this.write(path, state);
+        this.log.debug('Project state saved', { projectId: state.projectId });
+    }
+    loadState(projectId) {
+        const path = (0, path_1.join)(this.dirs.state, 'project.json');
+        const state = this.read(path);
+        if (state && state.projectId === projectId)
+            return state;
+        return null;
+    }
+    // ── Tasks ──────────────────────────────────────────────────────────────────
+    saveTask(task) {
+        const path = (0, path_1.join)(this.dirs.tasks, `${task.id}.json`);
+        this.write(path, task);
+        this.log.debug('Task saved', { taskId: task.id, status: task.status });
+    }
+    loadTask(taskId) {
+        const path = (0, path_1.join)(this.dirs.tasks, `${taskId}.json`);
+        return this.read(path);
+    }
+    loadAllTasks() {
+        return this.readDir(this.dirs.tasks);
+    }
+    updateTaskResult(taskId, result) {
+        const task = this.loadTask(taskId);
+        if (!task) {
+            this.log.warn('Cannot update result — task not found', { taskId });
+            return;
+        }
+        task.result = result;
+        task.status = 'COMPLETE';
+        task.updatedAt = new Date().toISOString();
+        this.saveTask(task);
+    }
+    // ── Critiques ──────────────────────────────────────────────────────────────
+    saveCritique(critique) {
+        const path = (0, path_1.join)(this.dirs.critiques, `${critique.id}.json`);
+        this.write(path, critique);
+    }
+    loadCritiquesForTask(taskId) {
+        return this.readDir(this.dirs.critiques).filter((c) => c.taskId === taskId);
+    }
+    loadAllCritiques() {
+        return this.readDir(this.dirs.critiques);
+    }
+    // ── Architecture Decisions ─────────────────────────────────────────────────
+    saveDecision(decision) {
+        const path = (0, path_1.join)(this.dirs.decisions, `${decision.id}.json`);
+        this.write(path, decision);
+        this.log.info('Architecture decision recorded', { title: decision.title });
+    }
+    loadAllDecisions() {
+        return this.readDir(this.dirs.decisions);
+    }
+    // ── Generated File Metadata ────────────────────────────────────────────────
+    recordGeneratedFile(filePath, taskId, content) {
+        const key = this.pathKey(filePath);
+        const path = (0, path_1.join)(this.dirs.files, `${key}.json`);
+        this.write(path, {
+            filePath,
+            taskId,
+            recordedAt: new Date().toISOString(),
+            contentLength: content?.length ?? 0,
+        });
+    }
+    loadGeneratedFilePaths() {
+        return this.readDir(this.dirs.files).map((f) => f.filePath);
+    }
+    // ── Response Cache ─────────────────────────────────────────────────────────
+    getCached(cacheKey) {
+        const path = (0, path_1.join)(this.dirs.cache, `${cacheKey}.json`);
+        if (!(0, fs_1.existsSync)(path))
+            return null;
+        const entry = this.read(path);
+        return entry?.response ?? null;
+    }
+    putCache(cacheKey, response) {
+        const path = (0, path_1.join)(this.dirs.cache, `${cacheKey}.json`);
+        this.write(path, { response, cachedAt: new Date().toISOString() });
+    }
+    getCacheSize() {
+        return (0, fs_1.readdirSync)(this.dirs.cache).filter((f) => f.endsWith('.json')).length;
+    }
+    // ── Summary ────────────────────────────────────────────────────────────────
+    getSummary() {
+        const tasks = this.loadAllTasks();
+        return {
+            taskCount: tasks.length,
+            completedCount: tasks.filter((t) => t.status === 'COMPLETE').length,
+            critiqueCount: this.readDir(this.dirs.critiques).length,
+            decisionCount: this.readDir(this.dirs.decisions).length,
+            generatedFileCount: this.readDir(this.dirs.files).length,
+            cacheEntries: this.getCacheSize(),
+        };
+    }
+    // ── Internal helpers ───────────────────────────────────────────────────────
+    write(path, data) {
+        (0, fs_1.writeFileSync)(path, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    read(path) {
+        try {
+            if (!(0, fs_1.existsSync)(path))
+                return null;
+            return JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
+        }
+        catch (err) {
+            this.log.warn('Failed to read file', { path, err: String(err) });
+            return null;
+        }
+    }
+    readDir(dir) {
+        try {
+            return (0, fs_1.readdirSync)(dir)
+                .filter((f) => f.endsWith('.json'))
+                .map((f) => this.read((0, path_1.join)(dir, f)))
+                .filter((x) => x !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    pathKey(filePath) {
+        // deterministic safe filename from arbitrary path
+        return filePath
+            .replace(/[^a-zA-Z0-9]/g, '_')
+            .replace(/_+/g, '_')
+            .slice(0, 120);
+    }
+}
+exports.MemoryStore = MemoryStore;
+//# sourceMappingURL=memory-store.js.map

package/dist/components/memory-store.js.map

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

package/dist/components/planner.d.ts

@@ -0,0 +1,22 @@
+import { PlannerOutput, ProjectState } from '../core/types';
+import { CostOptimizer } from './cost-optimizer';
+import { MemoryStore } from './memory-store';
+export declare class Planner {
+    private readonly optimizer;
+    private readonly memory;
+    private readonly dryRun;
+    private readonly log;
+    constructor(optimizer: CostOptimizer, memory: MemoryStore, dryRun?: boolean);
+    /**
+     * Produce an ordered task list for the given goal.
+     * Includes prior project state as context so the planner doesn't re-generate
+     * already-completed work.
+     */
+    plan(goal: string, state: ProjectState): Promise<PlannerOutput[]>;
+    private buildContext;
+    private buildPrompt;
+    private callApi;
+    private parse;
+    private dryRunResponse;
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/components/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/components/planner.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA8C7C,qBAAa,OAAO;IAIhB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;gBAG5B,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,WAAW,EACnB,MAAM,UAAQ;IAGjC;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAiCvE,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,WAAW;YASL,OAAO;IAMrB,OAAO,CAAC,KAAK;IAoCb,OAAO,CAAC,cAAc;CA4BvB"}

package/dist/components/planner.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Planner = void 0;
+const crypto_1 = require("crypto");
+const logger_1 = require("../core/logger");
+const claude_cli_1 = require("./claude-cli");
+const SYSTEM_PROMPT = `You are a senior software architect acting as a project planner.
+Your job is to decompose a high-level project goal into a prioritised list of concrete,
+independently-executable tasks. Each task must be atomic — a single engineer should be
+able to complete it in one sitting.
+
+Return ONLY valid JSON matching this schema (no markdown, no prose):
+{
+  "tasks": [
+    {
+      "objective": "string — what exactly must be done",
+      "priority": 1,          // integer, 1 = highest
+      "dependencies": [],     // array of objective strings from THIS response
+      "estimatedEffort": "low|medium|high",
+      "rationale": "string — why this task exists"
+    }
+  ],
+  "decisions": [
+    {
+      "title": "string",
+      "context": "string",
+      "decision": "string",
+      "consequences": "string"
+    }
+  ]
+}`;
+class Planner {
+    constructor(optimizer, memory, dryRun = false) {
+        this.optimizer = optimizer;
+        this.memory = memory;
+        this.dryRun = dryRun;
+        this.log = (0, logger_1.createLogger)('Planner');
+    }
+    /**
+     * Produce an ordered task list for the given goal.
+     * Includes prior project state as context so the planner doesn't re-generate
+     * already-completed work.
+     */
+    async plan(goal, state) {
+        const contextSummary = this.buildContext(state);
+        const prompt = this.buildPrompt(goal, contextSummary);
+        const cacheKey = this.optimizer.buildCacheKey(prompt);
+        const estimate = this.optimizer.estimate(prompt, 2000, cacheKey);
+        this.log.info('Planning tasks', {
+            goal: goal.slice(0, 80),
+            action: estimate.recommendedAction,
+        });
+        if (estimate.recommendedAction === 'skip') {
+            this.log.warn('Skipping planning — budget exhausted');
+            return [];
+        }
+        let raw;
+        const cached = this.optimizer.getCachedResponse(cacheKey);
+        if (cached) {
+            raw = cached;
+        }
+        else if (this.dryRun) {
+            raw = this.dryRunResponse(goal);
+        }
+        else {
+            raw = await this.callApi(prompt);
+            this.optimizer.putCachedResponse(cacheKey, raw);
+        }
+        return this.parse(raw);
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    buildContext(state) {
+        const completed = state.completedTaskIds.length;
+        const decisions = this.memory.loadAllDecisions();
+        const decisionSummary = decisions
+            .map((d) => `• ${d.title}: ${d.decision}`)
+            .join('\n');
+        return [
+            `Phase: ${state.currentPhase}`,
+            `Iteration: ${state.iterationCount}`,
+            `Completed tasks: ${completed}`,
+            `Coverage: ${state.coveragePercent}%`,
+            decisions.length > 0 ? `\nArchitecture decisions:\n${decisionSummary}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+    }
+    buildPrompt(goal, context) {
+        return [
+            `PROJECT GOAL:\n${goal}`,
+            `\nCURRENT STATE:\n${context}`,
+            '\nGenerate a prioritised task breakdown. Focus only on tasks NOT yet completed.',
+            'Be specific and avoid redundancy with already-made architecture decisions.',
+        ].join('\n');
+    }
+    async callApi(prompt) {
+        const { text, costUsd } = await (0, claude_cli_1.callClaude)(SYSTEM_PROMPT, prompt);
+        this.optimizer.recordCost(costUsd);
+        return text;
+    }
+    parse(raw) {
+        let parsed;
+        try {
+            // strip markdown fences if present
+            const json = raw.replace(/^```json?\n?/m, '').replace(/```$/m, '').trim();
+            parsed = JSON.parse(json);
+        }
+        catch (err) {
+            this.log.error('Failed to parse planner response', { err: String(err), raw });
+            return [];
+        }
+        // Persist architecture decisions
+        for (const d of parsed.decisions ?? []) {
+            const decision = {
+                id: (0, crypto_1.randomUUID)(),
+                ...d,
+                madeAt: new Date().toISOString(),
+            };
+            this.memory.saveDecision(decision);
+        }
+        // Resolve dependency strings → task objectives (same-batch cross-referencing)
+        const tasks = parsed.tasks ?? [];
+        const objectiveToIndex = new Map(tasks.map((t, i) => [t.objective, String(i)]));
+        return tasks.map((t) => ({
+            objective: t.objective,
+            priority: t.priority,
+            estimatedEffort: t.estimatedEffort,
+            rationale: t.rationale,
+            dependencies: t.dependencies
+                .map((dep) => objectiveToIndex.get(dep))
+                .filter((id) => id !== undefined),
+        }));
+    }
+    dryRunResponse(goal) {
+        return JSON.stringify({
+            tasks: [
+                {
+                    objective: `[DRY-RUN] Scaffold project structure for: ${goal}`,
+                    priority: 1,
+                    dependencies: [],
+                    estimatedEffort: 'low',
+                    rationale: 'Dry-run placeholder task',
+                },
+                {
+                    objective: `[DRY-RUN] Implement core logic for: ${goal}`,
+                    priority: 2,
+                    dependencies: [`[DRY-RUN] Scaffold project structure for: ${goal}`],
+                    estimatedEffort: 'medium',
+                    rationale: 'Dry-run placeholder task',
+                },
+            ],
+            decisions: [
+                {
+                    title: 'DRY-RUN mode',
+                    context: 'Planner invoked with dryRun=true',
+                    decision: 'Return stubbed tasks without API calls',
+                    consequences: 'No real planning occurs',
+                },
+            ],
+        });
+    }
+}
+exports.Planner = Planner;
+//# sourceMappingURL=planner.js.map

package/dist/components/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/components/planner.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAIpC,2CAA8C;AAC9C,6CAA0C;AAE1C,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;EAwBpB,CAAC;AAkBH,MAAa,OAAO;IAGlB,YACmB,SAAwB,EACxB,MAAmB,EACnB,SAAS,KAAK;QAFd,cAAS,GAAT,SAAS,CAAe;QACxB,WAAM,GAAN,MAAM,CAAa;QACnB,WAAM,GAAN,MAAM,CAAQ;QALhB,QAAG,GAAG,IAAA,qBAAY,EAAC,SAAS,CAAC,CAAC;IAM5C,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,KAAmB;QAC1C,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEjE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC9B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACvB,MAAM,EAAE,QAAQ,CAAC,iBAAiB;SACnC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACtD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,GAAW,CAAC;QAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,8EAA8E;IAEtE,YAAY,CAAC,KAAmB;QACtC,MAAM,SAAS,GAAG,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACjD,MAAM,eAAe,GAAG,SAAS;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;aACzC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,UAAU,KAAK,CAAC,YAAY,EAAE;YAC9B,cAAc,KAAK,CAAC,cAAc,EAAE;YACpC,oBAAoB,SAAS,EAAE;YAC/B,aAAa,KAAK,CAAC,eAAe,GAAG;YACrC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE;SAC5E;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAEO,WAAW,CAAC,IAAY,EAAE,OAAe;QAC/C,OAAO;YACL,kBAAkB,IAAI,EAAE;YACxB,qBAAqB,OAAO,EAAE;YAC9B,iFAAiF;YACjF,4EAA4E;SAC7E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,MAAc;QAClC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,uBAAU,EAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAClE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,GAAW;QACvB,IAAI,MAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,mCAAmC;YACnC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1E,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9E,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,iCAAiC;QACjC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAyB;gBACrC,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,GAAG,CAAC;gBACJ,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACjC,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAED,8EAA8E;QAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,YAAY,EAAE,CAAC,CAAC,YAAY;iBACzB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;iBACvC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;SAClD,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,KAAK,EAAE;gBACL;oBACE,SAAS,EAAE,6CAA6C,IAAI,EAAE;oBAC9D,QAAQ,EAAE,CAAC;oBACX,YAAY,EAAE,EAAE;oBAChB,eAAe,EAAE,KAAK;oBACtB,SAAS,EAAE,0BAA0B;iBACtC;gBACD;oBACE,SAAS,EAAE,uCAAuC,IAAI,EAAE;oBACxD,QAAQ,EAAE,CAAC;oBACX,YAAY,EAAE,CAAC,6CAA6C,IAAI,EAAE,CAAC;oBACnE,eAAe,EAAE,QAAQ;oBACzB,SAAS,EAAE,0BAA0B;iBACtC;aACF;YACD,SAAS,EAAE;gBACT;oBACE,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,kCAAkC;oBAC3C,QAAQ,EAAE,wCAAwC;oBAClD,YAAY,EAAE,yBAAyB;iBACxC;aACF;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAhJD,0BAgJC"}

package/dist/components/reviewer.d.ts

@@ -0,0 +1,19 @@
+import { ReviewResult, Task } from '../core/types';
+import { CostOptimizer } from './cost-optimizer';
+import { MemoryStore } from './memory-store';
+export declare class Reviewer {
+    private readonly optimizer;
+    private readonly memory;
+    private readonly dryRun;
+    private readonly log;
+    constructor(optimizer: CostOptimizer, memory: MemoryStore, dryRun?: boolean);
+    review(task: Task): Promise<ReviewResult>;
+    /** Count critical issues across all stored critiques. */
+    countCriticalIssues(): number;
+    private buildPrompt;
+    private callApi;
+    private parse;
+    private emptyReview;
+    private dryRunResponse;
+}
+//# sourceMappingURL=reviewer.d.ts.map

package/dist/components/reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/components/reviewer.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA4C7C,qBAAa,QAAQ;IAIjB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;gBAG7B,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,WAAW,EACnB,MAAM,UAAQ;IAG3B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IA6C/C,yDAAyD;IACzD,mBAAmB,IAAI,MAAM;IAQ7B,OAAO,CAAC,WAAW;YAqBL,OAAO;IAMrB,OAAO,CAAC,KAAK;IA8Bb,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,cAAc;CAevB"}