ralphy-spec 0.1.1 → 0.2.0

package/dist/core/memory/persistence.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistenceLayer = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const folders_1 = require("../folders");
+const schemaSql = `
+CREATE TABLE IF NOT EXISTS runs (
+  id TEXT PRIMARY KEY,
+  status TEXT NOT NULL,
+  started_at TEXT NOT NULL,
+  finished_at TEXT,
+  repo_root TEXT NOT NULL,
+  backend_id TEXT,
+  workspace_mode TEXT
+);
+
+CREATE TABLE IF NOT EXISTS tasks (
+  run_id TEXT NOT NULL,
+  task_id TEXT NOT NULL,
+  status TEXT NOT NULL,
+  phase TEXT,
+  iteration INTEGER NOT NULL DEFAULT 0,
+  started_at TEXT,
+  finished_at TEXT,
+  last_error TEXT,
+  PRIMARY KEY (run_id, task_id)
+);
+
+CREATE TABLE IF NOT EXISTS ledger (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  run_id TEXT NOT NULL,
+  task_id TEXT,
+  ts TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  message TEXT NOT NULL,
+  data_json TEXT
+);
+
+CREATE TABLE IF NOT EXISTS issues (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  run_id TEXT NOT NULL,
+  task_id TEXT NOT NULL,
+  signature TEXT,
+  kind TEXT NOT NULL,
+  file TEXT,
+  line INTEGER,
+  message TEXT NOT NULL,
+  raw_json TEXT,
+  ts TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS checkpoints (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  run_id TEXT NOT NULL,
+  task_id TEXT NOT NULL,
+  ts TEXT NOT NULL,
+  ref TEXT NOT NULL,
+  message TEXT NOT NULL
+);
+`;
+class PersistenceLayer {
+    db;
+    constructor(dbPath) {
+        this.db = new better_sqlite3_1.default(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.exec(schemaSql);
+    }
+    static async openForRepo(repoRoot) {
+        await (0, folders_1.migrateLegacyIfNeeded)(repoRoot);
+        const ralphyDir = await (0, folders_1.ensureRalphyFolders)(repoRoot);
+        const dbPath = node_path_1.default.join(ralphyDir, folders_1.FILES.db);
+        return new PersistenceLayer(dbPath);
+    }
+    close() {
+        this.db.close();
+    }
+    createRun(args) {
+        this.db
+            .prepare(`INSERT INTO runs (id, status, started_at, repo_root, backend_id, workspace_mode)
+         VALUES (@runId, 'active', @ts, @repoRoot, @backendId, @workspaceMode)`)
+            .run({
+            runId: args.runId,
+            ts: new Date().toISOString(),
+            repoRoot: args.repoRoot,
+            backendId: args.backendId ?? null,
+            workspaceMode: args.workspaceMode ?? null,
+        });
+    }
+    finishRun(args) {
+        this.db
+            .prepare(`UPDATE runs
+         SET status=@status, finished_at=@ts
+         WHERE id=@runId`)
+            .run({ runId: args.runId, status: args.status, ts: new Date().toISOString() });
+    }
+    upsertTaskState(args) {
+        this.db
+            .prepare(`INSERT INTO tasks (run_id, task_id, status, phase, iteration, started_at, last_error)
+         VALUES (@runId, @taskId, @status, @phase, @iteration, @startedAt, @lastError)
+         ON CONFLICT(run_id, task_id) DO UPDATE SET
+           status=excluded.status,
+           phase=excluded.phase,
+           iteration=excluded.iteration,
+           last_error=excluded.last_error`)
+            .run({
+            runId: args.runId,
+            taskId: args.taskId,
+            status: args.status,
+            phase: args.phase ?? null,
+            iteration: args.iteration ?? 0,
+            startedAt: new Date().toISOString(),
+            lastError: args.lastError ?? null,
+        });
+    }
+    appendLedger(event) {
+        this.db
+            .prepare(`INSERT INTO ledger (run_id, task_id, ts, kind, message, data_json)
+         VALUES (@runId, @taskId, @ts, @kind, @message, @dataJson)`)
+            .run({
+            runId: event.runId,
+            taskId: event.taskId ?? null,
+            ts: event.ts,
+            kind: event.kind,
+            message: event.message,
+            dataJson: event.data ? JSON.stringify(event.data) : null,
+        });
+    }
+    listLedger(args) {
+        const rows = this.db
+            .prepare(`SELECT run_id as runId, task_id as taskId, ts, kind, message, data_json as dataJson
+         FROM ledger
+         WHERE run_id=@runId
+         ORDER BY id DESC
+         LIMIT @limit`)
+            .all({ runId: args.runId, limit: args.limit ?? 50 });
+        return rows
+            .reverse()
+            .map((r) => ({
+            runId: r.runId,
+            taskId: r.taskId ?? undefined,
+            ts: r.ts,
+            kind: r.kind,
+            message: r.message,
+            data: r.dataJson ? JSON.parse(r.dataJson) : undefined,
+        }));
+    }
+    getLatestRun() {
+        const row = this.db
+            .prepare(`SELECT id as runId, status, started_at as startedAt
+         FROM runs
+         ORDER BY started_at DESC
+         LIMIT 1`)
+            .get();
+        return row ? row : null;
+    }
+}
+exports.PersistenceLayer = PersistenceLayer;
+//# sourceMappingURL=persistence.js.map

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

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

package/dist/core/reporting/spend.d.ts

@@ -0,0 +1,40 @@
+import type { BudgetUsage } from "../budgets/state";
+export type SpendEntry = {
+    taskId: string;
+    backendId?: string;
+    phase?: string;
+    usd: number;
+    tokens: number;
+    wallTimeMs: number;
+    iterations: number;
+};
+export type SpendBreakdown = {
+    total: BudgetUsage;
+    byTask: Map<string, BudgetUsage>;
+    byBackend: Map<string, BudgetUsage>;
+    byPhase: Map<string, BudgetUsage>;
+    entries: SpendEntry[];
+};
+/**
+ * Aggregate spend data from ledger events.
+ *
+ * This processes ledger events to build a breakdown of spending
+ * by task, backend, and phase.
+ */
+export declare function aggregateSpend(events: SpendEntry[]): SpendBreakdown;
+/**
+ * Format spend breakdown as markdown report.
+ */
+export declare function formatSpendReport(breakdown: SpendBreakdown): string;
+/**
+ * Create spend entries from ledger events.
+ *
+ * This function parses ledger events and extracts spend information
+ * from events with kind="iteration_complete" or similar.
+ */
+export declare function extractSpendFromLedger(ledgerEvents: Array<{
+    taskId?: string;
+    kind: string;
+    data?: unknown;
+}>): SpendEntry[];
+//# sourceMappingURL=spend.d.ts.map

package/dist/core/reporting/spend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/spend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,CA0DnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CA+DnE;AAYD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,KAAK,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,GACD,UAAU,EAAE,CA+Bd"}

package/dist/core/reporting/spend.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aggregateSpend = aggregateSpend;
+exports.formatSpendReport = formatSpendReport;
+exports.extractSpendFromLedger = extractSpendFromLedger;
+/**
+ * Aggregate spend data from ledger events.
+ *
+ * This processes ledger events to build a breakdown of spending
+ * by task, backend, and phase.
+ */
+function aggregateSpend(events) {
+    const total = { usd: 0, tokens: 0, wallTimeMs: 0, iterations: 0 };
+    const byTask = new Map();
+    const byBackend = new Map();
+    const byPhase = new Map();
+    for (const entry of events) {
+        // Accumulate total
+        total.usd += entry.usd;
+        total.tokens += entry.tokens;
+        total.wallTimeMs += entry.wallTimeMs;
+        total.iterations += entry.iterations;
+        // By task
+        const taskUsage = byTask.get(entry.taskId) ?? {
+            usd: 0,
+            tokens: 0,
+            wallTimeMs: 0,
+            iterations: 0,
+        };
+        taskUsage.usd += entry.usd;
+        taskUsage.tokens += entry.tokens;
+        taskUsage.wallTimeMs += entry.wallTimeMs;
+        taskUsage.iterations += entry.iterations;
+        byTask.set(entry.taskId, taskUsage);
+        // By backend (if present)
+        if (entry.backendId) {
+            const backendUsage = byBackend.get(entry.backendId) ?? {
+                usd: 0,
+                tokens: 0,
+                wallTimeMs: 0,
+                iterations: 0,
+            };
+            backendUsage.usd += entry.usd;
+            backendUsage.tokens += entry.tokens;
+            backendUsage.wallTimeMs += entry.wallTimeMs;
+            backendUsage.iterations += entry.iterations;
+            byBackend.set(entry.backendId, backendUsage);
+        }
+        // By phase (if present)
+        if (entry.phase) {
+            const phaseUsage = byPhase.get(entry.phase) ?? {
+                usd: 0,
+                tokens: 0,
+                wallTimeMs: 0,
+                iterations: 0,
+            };
+            phaseUsage.usd += entry.usd;
+            phaseUsage.tokens += entry.tokens;
+            phaseUsage.wallTimeMs += entry.wallTimeMs;
+            phaseUsage.iterations += entry.iterations;
+            byPhase.set(entry.phase, phaseUsage);
+        }
+    }
+    return { total, byTask, byBackend, byPhase, entries: events };
+}
+/**
+ * Format spend breakdown as markdown report.
+ */
+function formatSpendReport(breakdown) {
+    const lines = [];
+    lines.push(`# Spend Breakdown Report`);
+    lines.push(``);
+    // Total
+    lines.push(`## Summary`);
+    lines.push(``);
+    lines.push(`| Metric | Value |`);
+    lines.push(`|--------|-------|`);
+    lines.push(`| Total USD | $${breakdown.total.usd.toFixed(4)} |`);
+    lines.push(`| Total Tokens | ${breakdown.total.tokens.toLocaleString()} |`);
+    lines.push(`| Wall Time | ${formatDuration(breakdown.total.wallTimeMs)} |`);
+    lines.push(`| Iterations | ${breakdown.total.iterations} |`);
+    lines.push(``);
+    // By Task
+    if (breakdown.byTask.size > 0) {
+        lines.push(`## By Task`);
+        lines.push(``);
+        lines.push(`| Task | USD | Tokens | Time | Iterations |`);
+        lines.push(`|------|-----|--------|------|------------|`);
+        for (const [taskId, usage] of breakdown.byTask.entries()) {
+            lines.push(`| ${taskId} | $${usage.usd.toFixed(4)} | ${usage.tokens.toLocaleString()} | ${formatDuration(usage.wallTimeMs)} | ${usage.iterations} |`);
+        }
+        lines.push(``);
+    }
+    // By Backend
+    if (breakdown.byBackend.size > 0) {
+        lines.push(`## By Backend`);
+        lines.push(``);
+        lines.push(`| Backend | USD | Tokens | Time | Iterations |`);
+        lines.push(`|---------|-----|--------|------|------------|`);
+        for (const [backendId, usage] of breakdown.byBackend.entries()) {
+            lines.push(`| ${backendId} | $${usage.usd.toFixed(4)} | ${usage.tokens.toLocaleString()} | ${formatDuration(usage.wallTimeMs)} | ${usage.iterations} |`);
+        }
+        lines.push(``);
+    }
+    // By Phase
+    if (breakdown.byPhase.size > 0) {
+        lines.push(`## By Phase`);
+        lines.push(``);
+        lines.push(`| Phase | USD | Tokens | Time | Iterations |`);
+        lines.push(`|-------|-----|--------|------|------------|`);
+        for (const [phase, usage] of breakdown.byPhase.entries()) {
+            lines.push(`| ${phase} | $${usage.usd.toFixed(4)} | ${usage.tokens.toLocaleString()} | ${formatDuration(usage.wallTimeMs)} | ${usage.iterations} |`);
+        }
+        lines.push(``);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format duration in human-readable form.
+ */
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    if (ms < 3600_000)
+        return `${(ms / 60_000).toFixed(1)}m`;
+    return `${(ms / 3600_000).toFixed(1)}h`;
+}
+/**
+ * Create spend entries from ledger events.
+ *
+ * This function parses ledger events and extracts spend information
+ * from events with kind="iteration_complete" or similar.
+ */
+function extractSpendFromLedger(ledgerEvents) {
+    const entries = [];
+    for (const event of ledgerEvents) {
+        // Look for events that contain spend data
+        if (event.kind === "iteration_complete" || event.kind === "backend_usage") {
+            const data = event.data;
+            if (data && event.taskId) {
+                entries.push({
+                    taskId: event.taskId,
+                    backendId: data.backendId,
+                    phase: data.phase,
+                    usd: data.usd ?? 0,
+                    tokens: data.tokens ?? 0,
+                    wallTimeMs: data.wallTimeMs ?? 0,
+                    iterations: 1,
+                });
+            }
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=spend.js.map

package/dist/core/reporting/spend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend.js","sourceRoot":"","sources":["../../../src/core/reporting/spend.ts"],"names":[],"mappings":";;AA0BA,wCA0DC;AAKD,8CA+DC;AAkBD,wDAqCC;AA3LD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,MAAoB;IACjD,MAAM,KAAK,GAAgB,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC/E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,mBAAmB;QACnB,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC;QACvB,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;QAC7B,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;QACrC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;QAErC,UAAU;QACV,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI;YAC5C,GAAG,EAAE,CAAC;YACN,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;SACd,CAAC;QACF,SAAS,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC;QAC3B,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;QACjC,SAAS,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;QACzC,SAAS,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEpC,0BAA0B;QAC1B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI;gBACrD,GAAG,EAAE,CAAC;gBACN,MAAM,EAAE,CAAC;gBACT,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,CAAC;aACd,CAAC;YACF,YAAY,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC;YAC9B,YAAY,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;YACpC,YAAY,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;YAC5C,YAAY,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;YAC5C,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC/C,CAAC;QAED,wBAAwB;QACxB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;gBAC7C,GAAG,EAAE,CAAC;gBACN,MAAM,EAAE,CAAC;gBACT,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,CAAC;aACd,CAAC;YACF,UAAU,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC;YAC5B,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;YAClC,UAAU,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;YAC1C,UAAU,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,SAAyB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,QAAQ;IACR,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,oBAAoB,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,iBAAiB,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAE1D,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CACR,KAAK,MAAM,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,UAAU,IAAI,CAC1I,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,aAAa;IACb,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAE7D,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CACR,KAAK,SAAS,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,UAAU,IAAI,CAC7I,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,WAAW;IACX,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAE3D,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CACR,KAAK,KAAK,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,UAAU,IAAI,CACzI,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,EAAU;IAChC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,IAAI,EAAE,GAAG,QAAQ;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACzD,OAAO,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,YAIE;IAEF,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,0CAA0C;QAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAQN,CAAC;YAEd,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;oBAClB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;oBACxB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;oBAChC,UAAU,EAAE,CAAC;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/spec/dag.d.ts

@@ -0,0 +1,7 @@
+import type { TaskSpec } from "./types";
+export type TaskGraph = {
+    tasksById: Map<string, TaskSpec>;
+    order: string[];
+};
+export declare function buildTaskDAG(tasks: TaskSpec[]): TaskGraph;
+//# sourceMappingURL=dag.d.ts.map

package/dist/core/spec/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../../src/core/spec/dag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,SAAS,CAiEzD"}

package/dist/core/spec/dag.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTaskDAG = buildTaskDAG;
+function buildTaskDAG(tasks) {
+    const tasksById = new Map();
+    for (const t of tasks) {
+        if (tasksById.has(t.id)) {
+            throw new Error(`Duplicate task id: ${t.id}`);
+        }
+        tasksById.set(t.id, t);
+    }
+    const indeg = new Map();
+    const adj = new Map();
+    for (const id of tasksById.keys()) {
+        indeg.set(id, 0);
+        adj.set(id, new Set());
+    }
+    for (const t of tasks) {
+        const deps = t.deps ?? [];
+        for (const dep of deps) {
+            if (!tasksById.has(dep)) {
+                throw new Error(`Task ${t.id} depends on missing task ${dep}`);
+            }
+            adj.get(dep).add(t.id);
+            indeg.set(t.id, (indeg.get(t.id) ?? 0) + 1);
+        }
+    }
+    const queue = [];
+    for (const [id, d] of indeg.entries()) {
+        if (d === 0)
+            queue.push(id);
+    }
+    // Prefer higher priority first (stable-ish by id)
+    queue.sort((a, b) => {
+        const pa = tasksById.get(a)?.priority ?? 0;
+        const pb = tasksById.get(b)?.priority ?? 0;
+        if (pa !== pb)
+            return pb - pa;
+        return a.localeCompare(b);
+    });
+    const order = [];
+    while (queue.length) {
+        const id = queue.shift();
+        order.push(id);
+        for (const next of adj.get(id) ?? []) {
+            indeg.set(next, (indeg.get(next) ?? 0) - 1);
+            if (indeg.get(next) === 0) {
+                queue.push(next);
+                queue.sort((a, b) => {
+                    const pa = tasksById.get(a)?.priority ?? 0;
+                    const pb = tasksById.get(b)?.priority ?? 0;
+                    if (pa !== pb)
+                        return pb - pa;
+                    return a.localeCompare(b);
+                });
+            }
+        }
+    }
+    if (order.length !== tasksById.size) {
+        const remaining = [...tasksById.keys()].filter((id) => !order.includes(id));
+        throw new Error(`Cycle detected in task dependencies. Remaining: ${remaining.join(", ")}`);
+    }
+    return { tasksById, order };
+}
+//# sourceMappingURL=dag.js.map

package/dist/core/spec/dag.js.map

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

package/dist/core/spec/file-contract.d.ts

@@ -0,0 +1,13 @@
+import type { FileContract } from "./types";
+export type ContractViolation = {
+    file: string;
+    reason: "forbidden" | "not_allowed" | "new_file_disallowed";
+};
+export declare function evaluateFileContract(args: {
+    changedFiles: Array<{
+        file: string;
+        isNew: boolean;
+    }>;
+    contract: FileContract;
+}): ContractViolation[];
+//# sourceMappingURL=file-contract.d.ts.map

package/dist/core/spec/file-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-contract.d.ts","sourceRoot":"","sources":["../../../src/core/spec/file-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,qBAAqB,CAAC;CAC7D,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,QAAQ,EAAE,YAAY,CAAC;CACxB,GAAG,iBAAiB,EAAE,CA6BtB"}

package/dist/core/spec/file-contract.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateFileContract = evaluateFileContract;
+const minimatch_1 = require("minimatch");
+function evaluateFileContract(args) {
+    const { changedFiles, contract } = args;
+    const allowed = contract.allowed ?? [];
+    const forbidden = contract.forbidden ?? [];
+    const allowNewFiles = contract.allowNewFiles ?? true;
+    const violations = [];
+    for (const { file, isNew } of changedFiles) {
+        if (isNew && !allowNewFiles) {
+            violations.push({ file, reason: "new_file_disallowed" });
+            continue;
+        }
+        if (forbidden.some((pat) => (0, minimatch_1.minimatch)(file, pat, { dot: true }))) {
+            violations.push({ file, reason: "forbidden" });
+            continue;
+        }
+        if (allowed.length) {
+            const ok = allowed.some((pat) => (0, minimatch_1.minimatch)(file, pat, { dot: true }));
+            if (!ok) {
+                violations.push({ file, reason: "not_allowed" });
+            }
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=file-contract.js.map

package/dist/core/spec/file-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-contract.js","sourceRoot":"","sources":["../../../src/core/spec/file-contract.ts"],"names":[],"mappings":";;AAQA,oDAgCC;AAxCD,yCAAsC;AAQtC,SAAgB,oBAAoB,CAAC,IAGpC;IACC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAExC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC;IAErD,MAAM,UAAU,GAAwB,EAAE,CAAC;IAE3C,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,YAAY,EAAE,CAAC;QAC3C,IAAI,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACjE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/spec/loader.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectSpec } from "./types";
+export declare class SpecLoader {
+    private readonly repoRoot;
+    constructor(repoRoot: string);
+    loadProjectSpec(): Promise<ProjectSpec>;
+    private readFirstExisting;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/spec/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/spec/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;YAqB/B,iBAAiB;CAiBhC"}

package/dist/core/spec/loader.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecLoader = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = __importDefault(require("yaml"));
+const zod_1 = require("zod");
+const schemas_1 = require("./schemas");
+class SpecLoader {
+    repoRoot;
+    constructor(repoRoot) {
+        this.repoRoot = repoRoot;
+    }
+    async loadProjectSpec() {
+        const ymlPath = node_path_1.default.join(this.repoRoot, "openspec", "project.yml");
+        const jsonPath = node_path_1.default.join(this.repoRoot, "openspec", "project.json");
+        const rawText = await this.readFirstExisting([ymlPath, jsonPath]);
+        const raw = rawText.kind === "yml" ? yaml_1.default.parse(rawText.text) : JSON.parse(rawText.text);
+        try {
+            return schemas_1.projectSpecSchema.parse(raw);
+        }
+        catch (err) {
+            if (err instanceof zod_1.ZodError) {
+                const pretty = err.issues
+                    .map((i) => `- ${i.path.join(".") || "(root)"}: ${i.message}`)
+                    .join("\n");
+                throw new Error(`Invalid OpenSpec project spec:\n${pretty}`);
+            }
+            throw err;
+        }
+    }
+    async readFirstExisting(candidates) {
+        for (const p of candidates) {
+            try {
+                const text = await promises_1.default.readFile(p, "utf8");
+                return { kind: p.endsWith(".json") ? "json" : "yml", path: p, text };
+            }
+            catch {
+                // continue
+            }
+        }
+        throw new Error(`Missing OpenSpec project file. Expected one of:\n${candidates
+            .map((p) => `- ${p}`)
+            .join("\n")}`);
+    }
+}
+exports.SpecLoader = SpecLoader;
+//# sourceMappingURL=loader.js.map

package/dist/core/spec/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/spec/loader.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAkC;AAClC,0DAA6B;AAC7B,gDAAwB;AACxB,6BAA+B;AAC/B,uCAA8C;AAG9C,MAAa,UAAU;IACQ;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,KAAK,CAAC,eAAe;QACnB,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClE,MAAM,GAAG,GACP,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,cAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,OAAO,2BAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAQ,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM;qBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;qBAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,UAAoB;QAEpB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC1C,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oDAAoD,UAAU;aAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;CACF;AAzCD,gCAyCC"}