ralphy-spec 0.1.1 → 0.2.0

package/dist/core/engine/loop.js

@@ -0,0 +1,366 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EngineLoop = void 0;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const dag_1 = require("../spec/dag");
+const persistence_1 = require("../memory/persistence");
+const ledger_1 = require("../memory/ledger");
+const runner_1 = require("../validators/runner");
+const signatures_1 = require("../validators/signatures");
+const manager_1 = require("../budgets/manager");
+const state_1 = require("../budgets/state");
+const context_pack_1 = require("./context-pack");
+const repair_1 = require("./repair");
+function createRunId() {
+    return `run_${new Date().toISOString().replace(/[:.]/g, "-")}_${node_crypto_1.default
+        .randomBytes(4)
+        .toString("hex")}`;
+}
+class EngineLoop {
+    async run(opts) {
+        const runId = createRunId();
+        const persistence = await persistence_1.PersistenceLayer.openForRepo(opts.repoRoot);
+        const ledger = new ledger_1.LedgerLogger(persistence, runId);
+        const runBudget = opts.spec.budgets?.run;
+        const budgetState = new state_1.BudgetState({
+            usd: runBudget?.moneyUsd,
+            tokens: runBudget?.tokens,
+            wallTimeMs: runBudget?.wallTimeMinutes !== undefined
+                ? runBudget.wallTimeMinutes * 60_000
+                : undefined,
+            maxIterations: runBudget?.maxIterationsTotal,
+        });
+        const budgetManager = new manager_1.BudgetManager(budgetState);
+        persistence.createRun({
+            runId,
+            repoRoot: opts.repoRoot,
+            backendId: opts.backend.id,
+            workspaceMode: opts.workspace.mode,
+        });
+        ledger.event({ kind: "run_started", message: "Run started", data: { runId } });
+        try {
+            const tasks = opts.spec.tasks ?? [];
+            const dag = (0, dag_1.buildTaskDAG)(tasks);
+            const planOrder = opts.taskId ? [opts.taskId] : dag.order;
+            if (opts.dryRun) {
+                ledger.event({
+                    kind: "dry_run",
+                    message: "Dry run plan generated",
+                    data: { tasks: planOrder },
+                });
+                persistence.finishRun({ runId, status: "success" });
+                return { ok: true, runId };
+            }
+            for (const taskId of planOrder) {
+                const task = dag.tasksById.get(taskId) ?? tasks.find((t) => t.id === taskId);
+                if (!task) {
+                    persistence.finishRun({ runId, status: "error" });
+                    return {
+                        ok: false,
+                        runId,
+                        exitCode: 4,
+                        reason: `Unknown task id: ${taskId}`,
+                    };
+                }
+                const outcome = await this.runOneTask({
+                    runId,
+                    task,
+                    repoRoot: opts.repoRoot,
+                    spec: opts.spec,
+                    backend: opts.backend,
+                    workspace: opts.workspace,
+                    persistence,
+                    ledger,
+                    budgetManager,
+                });
+                if (!outcome.ok) {
+                    persistence.finishRun({
+                        runId,
+                        status: outcome.exitCode === 2 || outcome.exitCode === 3 ? "stopped" : "error",
+                    });
+                    return outcome;
+                }
+            }
+            ledger.event({ kind: "run_done", message: "All tasks done" });
+            persistence.finishRun({ runId, status: "success" });
+            return { ok: true, runId };
+        }
+        catch (err) {
+            ledger.event({
+                kind: "run_error",
+                message: err?.message ? String(err.message) : String(err),
+            });
+            persistence.finishRun({ runId, status: "error" });
+            return {
+                ok: false,
+                runId,
+                exitCode: 4,
+                reason: err?.message ? String(err.message) : String(err),
+            };
+        }
+        finally {
+            persistence.close();
+        }
+    }
+    async runOneTask(args) {
+        const { task, runId, persistence, ledger, budgetManager } = args;
+        let phase = "PLAN";
+        persistence.upsertTaskState({ runId, taskId: task.id, status: "running", phase });
+        ledger.event({ taskId: task.id, kind: "task_started", message: "Task started" });
+        const maxIter = task.budget?.hard?.maxIterations ??
+            args.spec.budgets?.run?.maxIterationsTotal ??
+            12;
+        const lastSignatures = [];
+        await args.workspace.prepare(task.id);
+        const cwd = args.workspace.getWorkingDir(task.id);
+        const taskBudgetConfig = this.toTaskBudgetConfig(task) ?? null;
+        let pendingRepairNotes;
+        let lastValidatorResults = null;
+        let lastIssues = null;
+        for (let iter = 1; iter <= maxIter; iter++) {
+            const iterStarted = Date.now();
+            try {
+                budgetManager.preflightOrThrow({ estimatedUsd: 0, estimatedTokens: 0 });
+            }
+            catch (e) {
+                ledger.event({
+                    taskId: task.id,
+                    kind: "budget_exceeded",
+                    message: e?.message ? String(e.message) : "Budget exceeded",
+                });
+                persistence.upsertTaskState({
+                    runId,
+                    taskId: task.id,
+                    status: "blocked",
+                    phase: "DIAGNOSE",
+                    iteration: iter,
+                    lastError: "Budget exceeded",
+                });
+                return { ok: false, runId, exitCode: 2, reason: "Budget limit" };
+            }
+            const tier = taskBudgetConfig ? budgetManager.getTier(taskBudgetConfig) : "optimal";
+            const shouldDegrade = taskBudgetConfig
+                ? budgetManager.shouldApplyDegrade(taskBudgetConfig)
+                : false;
+            if (shouldDegrade) {
+                ledger.event({
+                    taskId: task.id,
+                    kind: "degrade",
+                    message: "WARNING tier: degrade behaviors enabled",
+                });
+            }
+            if (shouldDegrade && lastValidatorResults && lastIssues) {
+                const ctx = (0, context_pack_1.buildContextPack)({
+                    tier: "warning",
+                    taskId: task.id,
+                    validatorResults: lastValidatorResults,
+                    issues: lastIssues,
+                });
+                ledger.event({
+                    taskId: task.id,
+                    kind: "context_pack",
+                    message: `Context pack built (${ctx.size})`,
+                });
+                // Optional calls disabling (MVP: only logs, as we don't have optional calls yet).
+                ledger.event({
+                    taskId: task.id,
+                    kind: "optional_calls_skipped",
+                    message: "WARNING tier: skipping optional calls (self-review / plan regen)",
+                });
+            }
+            phase = "EXEC";
+            persistence.upsertTaskState({
+                runId,
+                taskId: task.id,
+                status: "running",
+                phase,
+                iteration: iter,
+            });
+            ledger.event({ taskId: task.id, kind: "exec", message: `EXEC iteration ${iter}` });
+            const backendRes = await args.backend.implement({ cwd, backendId: args.backend.id }, {
+                task,
+                iteration: iter,
+                repairNotes: pendingRepairNotes ??
+                    (shouldDegrade
+                        ? "WARNING tier active (repair-only mode will be enforced on failures)."
+                        : undefined),
+            });
+            if (!backendRes.ok) {
+                persistence.upsertTaskState({
+                    runId,
+                    taskId: task.id,
+                    status: "error",
+                    phase: "EXEC",
+                    iteration: iter,
+                    lastError: backendRes.message,
+                });
+                ledger.event({
+                    taskId: task.id,
+                    kind: "backend_error",
+                    message: backendRes.message,
+                });
+                return { ok: false, runId, exitCode: 5, reason: "Backend invocation error" };
+            }
+            phase = "VALIDATE";
+            const validators = this.resolveValidators(args.spec, task).map((v) => ({
+                ...v,
+                timeoutMs: v.timeoutMs ?? (args.spec.budgets?.limits?.commandTimeoutSeconds ?? 900) * 1000,
+            }));
+            const runner = new runner_1.ValidatorRunner({
+                cwd,
+                commandTimeoutMs: (args.spec.budgets?.limits?.commandTimeoutSeconds ?? 900) * 1000,
+            });
+            const results = await runner.runAll(validators);
+            const allIssues = Object.entries(results).flatMap(([id, r]) => {
+                // If a validator failed but produced no parsed issues, create a generic one.
+                const issues = !r.ok && r.issues.length === 0
+                    ? [
+                        {
+                            kind: "unknown",
+                            level: "error",
+                            message: `Validator "${id}" failed (exit=${r.exitCode ?? "?"})`,
+                            raw: { validatorId: id },
+                        },
+                    ]
+                    : r.issues;
+                return issues.map((i) => ({
+                    ...i,
+                    raw: i.raw ?? { validatorId: id },
+                }));
+            });
+            // Contract enforcement after EXEC
+            if (task.filesContract) {
+                const violations = await args.workspace.enforceContract(task.id, task.filesContract);
+                if (violations.length) {
+                    allIssues.push(...violations.map((v) => ({
+                        kind: "contract_violation",
+                        level: "error",
+                        message: `File contract violation: ${v.reason} (${v.file})`,
+                        file: v.file,
+                        raw: v,
+                    })));
+                }
+            }
+            const ok = Object.values(results).every((r) => r.ok) && allIssues.every((i) => i.level !== "error");
+            ledger.event({
+                taskId: task.id,
+                kind: "validate",
+                message: ok ? "VALIDATE passed" : "VALIDATE failed",
+                data: { ok, issues: allIssues.length },
+            });
+            const signatures = allIssues.map(signatures_1.issueSignature);
+            lastSignatures.push(...signatures);
+            while (lastSignatures.length > 50)
+                lastSignatures.shift();
+            const recent = lastSignatures.slice(-signatures.length);
+            const stuck = signatures.length > 0 &&
+                recent.length === signatures.length &&
+                iter >= 3 &&
+                signatures.every((s) => lastSignatures.slice(-signatures.length * 3).includes(s));
+            if (ok) {
+                phase = "CHECKPOINT";
+                await args.workspace.checkpoint(task.id, "Task completed");
+                persistence.upsertTaskState({
+                    runId,
+                    taskId: task.id,
+                    status: "done",
+                    phase: "DONE",
+                    iteration: iter,
+                });
+                ledger.event({ taskId: task.id, kind: "task_done", message: "Task done" });
+                budgetManager.recordIteration(Date.now() - iterStarted);
+                return { ok: true, runId };
+            }
+            // Save failure context for next iteration.
+            lastValidatorResults = results;
+            lastIssues = allIssues;
+            pendingRepairNotes = undefined;
+            phase = "DIAGNOSE";
+            persistence.upsertTaskState({
+                runId,
+                taskId: task.id,
+                status: "running",
+                phase,
+                iteration: iter,
+                lastError: "Validation failed",
+            });
+            if (stuck) {
+                ledger.event({
+                    taskId: task.id,
+                    kind: "stuck",
+                    message: "Stuck detected (same issues repeated)",
+                });
+                return { ok: false, runId, exitCode: 3, reason: "Stuck / max iterations" };
+            }
+            phase = "REPAIR";
+            const tierAfter = taskBudgetConfig ? budgetManager.getTier(taskBudgetConfig) : "optimal";
+            const repairNotes = (0, repair_1.buildRepairNotes)({
+                tier: tierAfter === "warning" ? "warning" : "optimal",
+                issues: allIssues,
+            });
+            ledger.event({ taskId: task.id, kind: "repair", message: "Retrying (repair loop)" });
+            pendingRepairNotes = repairNotes;
+            budgetManager.recordIteration(Date.now() - iterStarted);
+        }
+        ledger.event({
+            taskId: task.id,
+            kind: "max_iterations",
+            message: `Max iterations reached (${maxIter})`,
+        });
+        persistence.upsertTaskState({
+            runId,
+            taskId: task.id,
+            status: "blocked",
+            phase: "DIAGNOSE",
+            iteration: maxIter,
+            lastError: "Max iterations reached",
+        });
+        return { ok: false, runId, exitCode: 3, reason: "Max iterations reached" };
+    }
+    toTaskBudgetConfig(task) {
+        const b = task.budget;
+        const hardIter = b?.hard?.maxIterations;
+        if (!b || hardIter === undefined)
+            return null;
+        return {
+            optimal: {
+                usd: b.optimal?.usd,
+                tokens: b.optimal?.tokens,
+                timeMinutes: b.optimal?.timeMinutes,
+            },
+            warning: {
+                usd: b.warning?.usd,
+                tokens: b.warning?.tokens,
+                timeMinutes: b.warning?.timeMinutes,
+            },
+            hard: {
+                usd: b.hard?.usd,
+                tokens: b.hard?.tokens,
+                timeMinutes: b.hard?.timeMinutes,
+                maxIterations: hardIter,
+            },
+        };
+    }
+    resolveValidators(spec, task) {
+        const ids = task.validators ?? spec.defaults.validators ?? [];
+        const byId = new Map((spec.validators ?? []).map((v) => [v.id, v]));
+        const validators = [];
+        for (const id of ids) {
+            const v = byId.get(id);
+            if (!v)
+                continue;
+            validators.push({
+                id: v.id,
+                run: v.run,
+                timeoutMs: v.timeoutSeconds ? v.timeoutSeconds * 1000 : undefined,
+                parser: v.parser ?? undefined,
+            });
+        }
+        return validators;
+    }
+}
+exports.EngineLoop = EngineLoop;
+//# sourceMappingURL=loop.js.map

package/dist/core/engine/loop.js.map

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

package/dist/core/engine/phases.d.ts

@@ -0,0 +1,2 @@
+export type Phase = "PLAN" | "PREP" | "EXEC" | "VALIDATE" | "DIAGNOSE" | "REPAIR" | "CHECKPOINT" | "DONE";
+//# sourceMappingURL=phases.d.ts.map

package/dist/core/engine/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../../src/core/engine/phases.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GACb,MAAM,GACN,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,MAAM,CAAC"}

package/dist/core/engine/phases.js

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

package/dist/core/engine/phases.js.map

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

package/dist/core/engine/repair.d.ts

@@ -0,0 +1,6 @@
+import type { Issue } from "../validators/types";
+export declare function buildRepairNotes(args: {
+    tier: "optimal" | "warning" | "hard";
+    issues: Issue[];
+}): string;
+//# sourceMappingURL=repair.d.ts.map

package/dist/core/engine/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../../src/core/engine/repair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,GAAG,MAAM,CAsBT"}

package/dist/core/engine/repair.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRepairNotes = buildRepairNotes;
+function buildRepairNotes(args) {
+    const lines = [];
+    lines.push(`# Repair notes`);
+    lines.push(``);
+    if (args.tier === "warning") {
+        lines.push(`## Constraints (WARNING tier)`);
+        lines.push(`- Fix only failing validators`);
+        lines.push(`- Do NOT refactor unrelated code`);
+        lines.push(`- Do NOT add new features`);
+        lines.push(``);
+    }
+    lines.push(`## Issues`);
+    for (const i of args.issues) {
+        const loc = i.file ? `${i.file}${i.line ? `:${i.line}` : ""}` : "";
+        lines.push(`- [${i.level}] ${i.kind}${loc ? ` (${loc})` : ""}: ${i.message}`);
+    }
+    lines.push(``);
+    return lines.join("\n");
+}
+//# sourceMappingURL=repair.js.map

package/dist/core/engine/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../../src/core/engine/repair.ts"],"names":[],"mappings":";;AAEA,4CAyBC;AAzBD,SAAgB,gBAAgB,CAAC,IAGhC;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/core/folders.d.ts

@@ -0,0 +1,26 @@
+export declare const LEGACY_ROOT_DIR = ".ralphy";
+export declare const DEFAULT_ROOT_DIR = "ralphy-spec";
+export declare const FOLDERS: {
+    readonly runs: "runs";
+    readonly logs: "logs";
+    readonly worktrees: "worktrees";
+    readonly tasks: "tasks";
+};
+export declare const FILES: {
+    readonly db: "state.db";
+    readonly status: "STATUS.md";
+    readonly tasks: "TASKS.md";
+    readonly budget: "BUDGET.md";
+};
+export declare function getRalphyRoot(repoRoot: string, overrideDir?: string): string;
+export declare function ensureRalphyFolders(repoRoot: string, overrideDir?: string): Promise<string>;
+export declare function migrateLegacyIfNeeded(repoRoot: string, overrideDir?: string): Promise<{
+    migrated: false;
+    from?: undefined;
+    to?: undefined;
+} | {
+    migrated: true;
+    from: string;
+    to: string;
+}>;
+//# sourceMappingURL=folders.d.ts.map

package/dist/core/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/core/folders.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAE9C,eAAO,MAAM,OAAO;;;;;CAKV,CAAC;AAEX,eAAO,MAAM,KAAK;;;;;CAKR,CAAC;AAEX,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,mBAQ/E;AAED,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;;;;;;;;GAWjF"}

package/dist/core/folders.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILES = exports.FOLDERS = exports.DEFAULT_ROOT_DIR = exports.LEGACY_ROOT_DIR = void 0;
+exports.getRalphyRoot = getRalphyRoot;
+exports.ensureRalphyFolders = ensureRalphyFolders;
+exports.migrateLegacyIfNeeded = migrateLegacyIfNeeded;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+exports.LEGACY_ROOT_DIR = ".ralphy";
+exports.DEFAULT_ROOT_DIR = "ralphy-spec";
+exports.FOLDERS = {
+    runs: "runs",
+    logs: "logs",
+    worktrees: "worktrees",
+    tasks: "tasks",
+};
+exports.FILES = {
+    db: "state.db",
+    status: "STATUS.md",
+    tasks: "TASKS.md",
+    budget: "BUDGET.md",
+};
+function getRalphyRoot(repoRoot, overrideDir) {
+    return node_path_1.default.join(repoRoot, overrideDir ?? exports.DEFAULT_ROOT_DIR);
+}
+async function ensureRalphyFolders(repoRoot, overrideDir) {
+    const root = getRalphyRoot(repoRoot, overrideDir);
+    await promises_1.default.mkdir(root, { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(root, exports.FOLDERS.runs), { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(root, exports.FOLDERS.logs), { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(root, exports.FOLDERS.worktrees), { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(root, exports.FOLDERS.tasks), { recursive: true });
+    return root;
+}
+async function migrateLegacyIfNeeded(repoRoot, overrideDir) {
+    const legacy = node_path_1.default.join(repoRoot, exports.LEGACY_ROOT_DIR);
+    const next = getRalphyRoot(repoRoot, overrideDir);
+    const legacyExists = await exists(legacy);
+    const nextExists = await exists(next);
+    if (!legacyExists || nextExists)
+        return { migrated: false };
+    await fs_extra_1.default.copy(legacy, next, { overwrite: false, errorOnExist: false });
+    return { migrated: true, from: legacy, to: next };
+}
+async function exists(p) {
+    try {
+        await promises_1.default.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=folders.js.map

package/dist/core/folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../src/core/folders.ts"],"names":[],"mappings":";;;;;;AAqBA,sCAEC;AAED,kDAQC;AAED,sDAWC;AA9CD,gEAAkC;AAClC,0DAA6B;AAC7B,wDAA2B;AAEd,QAAA,eAAe,GAAG,SAAS,CAAC;AAC5B,QAAA,gBAAgB,GAAG,aAAa,CAAC;AAEjC,QAAA,OAAO,GAAG;IACrB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;CACN,CAAC;AAEE,QAAA,KAAK,GAAG;IACnB,EAAE,EAAE,UAAU;IACd,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,WAAW;CACX,CAAC;AAEX,SAAgB,aAAa,CAAC,QAAgB,EAAE,WAAoB;IAClE,OAAO,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,IAAI,wBAAgB,CAAC,CAAC;AAC9D,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,QAAgB,EAAE,WAAoB;IAC9E,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAO,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAAC,QAAgB,EAAE,WAAoB;IAChF,MAAM,MAAM,GAAG,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAe,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAElD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,CAAC,YAAY,IAAI,UAAU;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAc,EAAE,CAAC;IAErE,MAAM,kBAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,OAAO,EAAE,QAAQ,EAAE,IAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/core/memory/ledger.d.ts

@@ -0,0 +1,13 @@
+import type { PersistenceLayer } from "./persistence";
+export declare class LedgerLogger {
+    private readonly persistence;
+    private readonly runId;
+    constructor(persistence: PersistenceLayer, runId: string);
+    event(args: {
+        taskId?: string;
+        kind: string;
+        message: string;
+        data?: unknown;
+    }): void;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/dist/core/memory/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../../src/core/memory/ledger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,WAAW,EAAE,gBAAgB,EAC7B,KAAK,EAAE,MAAM;IAGhC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAWtF"}

package/dist/core/memory/ledger.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerLogger = void 0;
+class LedgerLogger {
+    persistence;
+    runId;
+    constructor(persistence, runId) {
+        this.persistence = persistence;
+        this.runId = runId;
+    }
+    event(args) {
+        const ev = {
+            runId: this.runId,
+            taskId: args.taskId,
+            ts: new Date().toISOString(),
+            kind: args.kind,
+            message: args.message,
+            data: args.data,
+        };
+        this.persistence.appendLedger(ev);
+    }
+}
+exports.LedgerLogger = LedgerLogger;
+//# sourceMappingURL=ledger.js.map

package/dist/core/memory/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../src/core/memory/ledger.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IAEJ;IACA;IAFnB,YACmB,WAA6B,EAC7B,KAAa;QADb,gBAAW,GAAX,WAAW,CAAkB;QAC7B,UAAK,GAAL,KAAK,CAAQ;IAC7B,CAAC;IAEJ,KAAK,CAAC,IAAwE;QAC5E,MAAM,EAAE,GAAgB;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;CACF;AAjBD,oCAiBC"}

package/dist/core/memory/persistence.d.ts

@@ -0,0 +1,45 @@
+export type RunStatus = "active" | "success" | "stopped" | "error";
+export type TaskStatus = "pending" | "running" | "done" | "blocked" | "error";
+export type LedgerEvent = {
+    runId: string;
+    taskId?: string;
+    ts: string;
+    kind: string;
+    message: string;
+    data?: unknown;
+};
+export declare class PersistenceLayer {
+    private readonly db;
+    constructor(dbPath: string);
+    static openForRepo(repoRoot: string): Promise<PersistenceLayer>;
+    close(): void;
+    createRun(args: {
+        runId: string;
+        repoRoot: string;
+        backendId?: string;
+        workspaceMode?: string;
+    }): void;
+    finishRun(args: {
+        runId: string;
+        status: RunStatus;
+    }): void;
+    upsertTaskState(args: {
+        runId: string;
+        taskId: string;
+        status: TaskStatus;
+        phase?: string;
+        iteration?: number;
+        lastError?: string;
+    }): void;
+    appendLedger(event: LedgerEvent): void;
+    listLedger(args: {
+        runId: string;
+        limit?: number;
+    }): LedgerEvent[];
+    getLatestRun(): {
+        runId: string;
+        status: RunStatus;
+        startedAt: string;
+    } | null;
+}
+//# sourceMappingURL=persistence.d.ts.map

package/dist/core/memory/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../src/core/memory/persistence.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AACnE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9E,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AA0DF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,MAAM,EAAE,MAAM;WAMb,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOrE,KAAK,IAAI,IAAI;IAIb,SAAS,CAAC,IAAI,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,IAAI;IAeR,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAU3D,eAAe,CAAC,IAAI,EAAE;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,UAAU,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAsBR,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAgBtC,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,EAAE;IAuBlE,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAW/E"}