muonroi-cli 1.2.0

package/dist/storage/__tests__/migrations.test.js

@@ -0,0 +1,357 @@
+/**
+ * src/storage/__tests__/migrations.test.ts
+ *
+ * Tests for DB migration v3 (pil_active + enrichment_delta columns).
+ *
+ * Uses an in-memory SQLiteDatabase implemented via vi.mock for bun:sqlite,
+ * then delegates to a pure-JS in-memory store to verify schema mutations.
+ *
+ * Strategy: mock `bun:sqlite` before import, then use the SQLiteDatabase
+ * interface directly to call applyMigrations() and assert column additions.
+ */
+import { describe, expect, it } from "vitest";
+class InMemoryDatabase {
+    tables = new Map();
+    rows = new Map();
+    userVersion = 0;
+    exec(sql) {
+        // Parse CREATE TABLE statements to extract column info
+        this.parseAndApply(sql);
+    }
+    parseAndApply(sql) {
+        // Split on semicolons for multi-statement exec
+        const stmts = sql
+            .split(";")
+            .map((s) => s.trim())
+            .filter(Boolean);
+        for (const stmt of stmts) {
+            this.applySingleStatement(stmt);
+        }
+    }
+    applySingleStatement(stmt) {
+        const upper = stmt.trim().toUpperCase();
+        if (upper.startsWith("CREATE TABLE")) {
+            this.applyCreateTable(stmt);
+        }
+        else if (upper.startsWith("ALTER TABLE") && upper.includes("ADD COLUMN")) {
+            this.applyAlterTable(stmt);
+        }
+        else if (upper.startsWith("CREATE INDEX") || upper.startsWith("PRAGMA")) {
+            // Ignore indexes and pragma in exec (pragma handled separately)
+        }
+        // INSERT, SELECT, etc. handled in prepare()
+    }
+    applyCreateTable(stmt) {
+        // Extract table name
+        const match = stmt.match(/CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?(\w+)\s*\(/i);
+        if (!match)
+            return;
+        const tableName = match[1].toLowerCase();
+        if (this.tables.has(tableName))
+            return; // IF NOT EXISTS
+        const columns = new Map();
+        // Extract column definitions (simplified — handles PRIMARY KEY, NOT NULL, DEFAULT)
+        const body = stmt.slice(stmt.indexOf("(") + 1, stmt.lastIndexOf(")"));
+        const colDefs = this.splitColumnDefs(body);
+        for (const def of colDefs) {
+            const parsed = this.parseColumnDef(def);
+            if (parsed)
+                columns.set(parsed.name.toLowerCase(), parsed);
+        }
+        this.tables.set(tableName, columns);
+        this.rows.set(tableName, []);
+    }
+    applyAlterTable(stmt) {
+        const match = stmt.match(/ALTER\s+TABLE\s+(\w+)\s+ADD\s+COLUMN\s+(.*)/i);
+        if (!match)
+            return;
+        const tableName = match[1].toLowerCase();
+        const colDef = match[2].trim().replace(/;$/, "");
+        const parsed = this.parseColumnDef(colDef);
+        if (!parsed)
+            return;
+        const table = this.tables.get(tableName);
+        if (!table)
+            return;
+        // Do not add if already exists (idempotent)
+        if (!table.has(parsed.name.toLowerCase())) {
+            table.set(parsed.name.toLowerCase(), parsed);
+        }
+    }
+    splitColumnDefs(body) {
+        const defs = [];
+        let depth = 0;
+        let current = "";
+        for (const ch of body) {
+            if (ch === "(")
+                depth++;
+            else if (ch === ")")
+                depth--;
+            else if (ch === "," && depth === 0) {
+                defs.push(current.trim());
+                current = "";
+                continue;
+            }
+            current += ch;
+        }
+        if (current.trim())
+            defs.push(current.trim());
+        return defs;
+    }
+    parseColumnDef(def) {
+        const tokens = def.trim().split(/\s+/);
+        if (!tokens[0])
+            return null;
+        const name = tokens[0].replace(/^"|"$/g, "");
+        // Skip table constraints (PRIMARY KEY, UNIQUE, FOREIGN KEY, CHECK)
+        const upper = name.toUpperCase();
+        if (["PRIMARY", "UNIQUE", "FOREIGN", "CHECK", "CONSTRAINT"].includes(upper))
+            return null;
+        const type = tokens[1] ?? "TEXT";
+        const notNull = def.toUpperCase().includes("NOT NULL");
+        let defaultVal = null;
+        const defaultMatch = def.match(/DEFAULT\s+(\S+)/i);
+        if (defaultMatch) {
+            const raw = defaultMatch[1].replace(/['"]/g, "");
+            defaultVal = Number.isNaN(Number(raw)) ? raw : Number(raw);
+        }
+        return { name: name.toLowerCase(), type, notNull, defaultVal };
+    }
+    prepare(sql) {
+        return {
+            run: (...params) => this.runInsert(sql, params),
+            get: (...params) => this.runQuery(sql, params),
+            all: (...params) => this.runQueryAll(sql, params),
+        };
+    }
+    runInsert(sql, params) {
+        const upper = sql.trim().toUpperCase();
+        if (!upper.startsWith("INSERT"))
+            return;
+        // Extract table name
+        const match = sql.match(/INSERT\s+INTO\s+(\w+)\s*\(([^)]+)\)\s*VALUES/i);
+        if (!match)
+            return;
+        const tableName = match[1].toLowerCase();
+        const colNames = match[2].split(",").map((c) => c.trim().toLowerCase());
+        const tableRows = this.rows.get(tableName) ?? [];
+        const table = this.tables.get(tableName);
+        if (!table)
+            return;
+        // Build row from params + defaults
+        const row = {};
+        for (const [i, colName] of colNames.entries()) {
+            row[colName] = params[i];
+        }
+        // Apply defaults for missing columns
+        for (const [colName, def] of table.entries()) {
+            if (!(colName in row)) {
+                row[colName] = def.defaultVal;
+            }
+        }
+        tableRows.push(row);
+        this.rows.set(tableName, tableRows);
+        return row;
+    }
+    runQuery(sql, _params) {
+        const upper = sql.trim().toUpperCase();
+        if (upper.startsWith("PRAGMA")) {
+            if (upper.includes("TABLE_INFO")) {
+                const match = sql.match(/table_info\((\w+)\)/i);
+                if (!match)
+                    return null;
+                const tableName = match[1].toLowerCase();
+                const table = this.tables.get(tableName);
+                if (!table)
+                    return null;
+                const cols = [...table.values()];
+                return cols.length > 0 ? cols[0] : null;
+            }
+            if (upper.includes("USER_VERSION")) {
+                return { user_version: this.userVersion };
+            }
+            return null;
+        }
+        return null;
+    }
+    runQueryAll(sql, params) {
+        const upper = sql.trim().toUpperCase();
+        if (upper.startsWith("PRAGMA") && upper.includes("TABLE_INFO")) {
+            const match = sql.match(/table_info\((\w+)\)/i);
+            if (!match)
+                return [];
+            const tableName = match[1].toLowerCase();
+            const table = this.tables.get(tableName);
+            if (!table)
+                return [];
+            return [...table.values()].map((col, i) => ({
+                cid: i,
+                name: col.name,
+                type: col.type,
+                notnull: col.notNull ? 1 : 0,
+                dflt_value: col.defaultVal,
+                pk: 0,
+            }));
+        }
+        if (upper.startsWith("SELECT")) {
+            const fromMatch = sql.match(/FROM\s+(\w+)/i);
+            if (!fromMatch)
+                return [];
+            const tableName = fromMatch[1].toLowerCase();
+            const tableRows = this.rows.get(tableName) ?? [];
+            // Handle WHERE clause with = ?
+            const whereMatch = sql.match(/WHERE\s+(\w+)\s*=\s*\?/i);
+            if (whereMatch) {
+                const col = whereMatch[1].toLowerCase();
+                const val = params[0];
+                return tableRows.filter((r) => r[col] === val);
+            }
+            return tableRows;
+        }
+        return [];
+    }
+    pragma(query, options) {
+        if (query.includes("=")) {
+            const versionMatch = query.match(/user_version\s*=\s*(\d+)/i);
+            if (versionMatch) {
+                this.userVersion = Number(versionMatch[1]);
+            }
+            return undefined;
+        }
+        if (query.toLowerCase().includes("user_version")) {
+            if (options?.simple)
+                return this.userVersion;
+            return { user_version: this.userVersion };
+        }
+        return undefined;
+    }
+    transaction(fn) {
+        return fn; // No-op transaction for test
+    }
+    close() {
+        /* no-op */
+    }
+}
+import { applyMigrations } from "../migrations.js";
+function makeDb() {
+    const raw = new InMemoryDatabase();
+    return { db: raw, raw };
+}
+describe("DB migrations", () => {
+    it("Test 1: DB starting at version 0 creates usage_events with pil_active + enrichment_delta columns", () => {
+        const { db, raw } = makeDb();
+        applyMigrations(db);
+        const table = raw.tables.get("usage_events");
+        expect(table).toBeDefined();
+        expect(table.has("pil_active")).toBe(true);
+        expect(table.has("enrichment_delta")).toBe(true);
+    });
+    it("Test 2: DB at version 2 — migration v3 adds both columns without dropping existing ones", () => {
+        const { db, raw } = makeDb();
+        // Simulate existing v2 schema with usage_events but no pil_active
+        raw.tables.set("usage_events", new Map([
+            ["id", { name: "id", type: "INTEGER", notNull: true, defaultVal: null }],
+            ["session_id", { name: "session_id", type: "TEXT", notNull: true, defaultVal: null }],
+            ["source", { name: "source", type: "TEXT", notNull: true, defaultVal: null }],
+            ["model", { name: "model", type: "TEXT", notNull: true, defaultVal: null }],
+            ["created_at", { name: "created_at", type: "TEXT", notNull: true, defaultVal: null }],
+            ["cost_micros", { name: "cost_micros", type: "INTEGER", notNull: true, defaultVal: 0 }],
+        ]));
+        raw.tables.set("sessions", new Map());
+        raw.tables.set("workspaces", new Map());
+        raw.tables.set("messages", new Map());
+        raw.tables.set("tool_calls", new Map());
+        raw.tables.set("tool_results", new Map());
+        raw.tables.set("compactions", new Map());
+        raw.userVersion = 2;
+        applyMigrations(db);
+        const table = raw.tables.get("usage_events");
+        expect(table.has("pil_active")).toBe(true);
+        expect(table.has("enrichment_delta")).toBe(true);
+        // Existing columns preserved
+        expect(table.has("session_id")).toBe(true);
+        expect(table.has("cost_micros")).toBe(true);
+        expect(table.has("created_at")).toBe(true);
+    });
+    it("Test 3: DB already at version 3 — applyMigrations is idempotent (no error, no duplicate columns)", () => {
+        const { db, raw } = makeDb();
+        applyMigrations(db);
+        expect(() => applyMigrations(db)).not.toThrow();
+        const table = raw.tables.get("usage_events");
+        // Columns should appear exactly once
+        const cols = [...table.keys()];
+        const pilCount = cols.filter((c) => c === "pil_active").length;
+        const deltaCount = cols.filter((c) => c === "enrichment_delta").length;
+        expect(pilCount).toBe(1);
+        expect(deltaCount).toBe(1);
+    });
+    it("Test 4: row inserted without pil_active/enrichment_delta uses DEFAULT 0", () => {
+        const { db, raw } = makeDb();
+        applyMigrations(db);
+        // Add required parent rows to tables
+        raw.rows.set("workspaces", [
+            {
+                id: "ws1",
+                scope_key: "/tmp",
+                canonical_path: "/tmp",
+                display_name: "test",
+                last_seen_at: new Date().toISOString(),
+            },
+        ]);
+        raw.rows.set("sessions", [
+            {
+                id: "sess1",
+                workspace_id: "ws1",
+                model: "claude",
+                mode: "safe",
+                cwd_at_start: "/tmp",
+                cwd_last: "/tmp",
+                status: "active",
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            },
+        ]);
+        raw.rows.set("usage_events", []);
+        // Insert without pil_active/enrichment_delta — should default to 0
+        db.prepare(`INSERT INTO usage_events (session_id, message_seq, source, model, input_tokens, output_tokens, total_tokens, cost_micros, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run("sess1", null, "orchestrator", "claude", 100, 50, 150, 0, new Date().toISOString());
+        const usageRows = raw.rows.get("usage_events");
+        expect(usageRows).toHaveLength(1);
+        expect(usageRows[0].pil_active).toBe(0);
+        expect(usageRows[0].enrichment_delta).toBe(0);
+    });
+    it("Test 5: row inserted with pilActive=true and enrichmentDelta=-120 stores 1 and -120", () => {
+        const { db, raw } = makeDb();
+        applyMigrations(db);
+        raw.rows.set("workspaces", [
+            {
+                id: "ws2",
+                scope_key: "/tmp2",
+                canonical_path: "/tmp2",
+                display_name: "test2",
+                last_seen_at: new Date().toISOString(),
+            },
+        ]);
+        raw.rows.set("sessions", [
+            {
+                id: "sess2",
+                workspace_id: "ws2",
+                model: "claude",
+                mode: "safe",
+                cwd_at_start: "/tmp2",
+                cwd_last: "/tmp2",
+                status: "active",
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            },
+        ]);
+        raw.rows.set("usage_events", []);
+        db.prepare(`INSERT INTO usage_events (session_id, message_seq, source, model, input_tokens, output_tokens, total_tokens, cost_micros, created_at, pil_active, enrichment_delta)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run("sess2", null, "orchestrator", "claude", 100, 50, 150, 0, new Date().toISOString(), 1, -120);
+        const usageRows = raw.rows.get("usage_events");
+        expect(usageRows).toHaveLength(1);
+        expect(usageRows[0].pil_active).toBe(1);
+        expect(usageRows[0].enrichment_delta).toBe(-120);
+    });
+});
+//# sourceMappingURL=migrations.test.js.map

package/dist/storage/__tests__/migrations.test.js.map

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

package/dist/storage/atomic-io.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Atomically write a JSON value to filePath using .tmp + rename pattern.
+ * Pitfall 9 mitigation: a Ctrl+C between write and rename leaves no dangling state.
+ *
+ * Steps: serialize → ensure parent dir → write to filePath + ".tmp" → rename .tmp → filePath.
+ * On serialize failure, .tmp is never created. On rename failure, .tmp is cleaned up.
+ */
+export declare function atomicWriteJSON(filePath: string, value: unknown): Promise<void>;
+/**
+ * Atomically write plain text content to filePath using .tmp + rename pattern.
+ * Same durability guarantees as atomicWriteJSON but without JSON serialization.
+ */
+export declare function atomicWriteText(filePath: string, content: string): Promise<void>;
+/**
+ * Read a JSON file and parse it. Returns null if file is absent (ENOENT).
+ * Throws if the file exists but contains invalid JSON.
+ */
+export declare function atomicReadJSON<T>(filePath: string): Promise<T | null>;

package/dist/storage/atomic-io.js

@@ -0,0 +1,65 @@
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+/**
+ * Atomically write a JSON value to filePath using .tmp + rename pattern.
+ * Pitfall 9 mitigation: a Ctrl+C between write and rename leaves no dangling state.
+ *
+ * Steps: serialize → ensure parent dir → write to filePath + ".tmp" → rename .tmp → filePath.
+ * On serialize failure, .tmp is never created. On rename failure, .tmp is cleaned up.
+ */
+export async function atomicWriteJSON(filePath, value) {
+    const tmpPath = `${filePath}.tmp`;
+    let serialized;
+    try {
+        serialized = JSON.stringify(value, null, 2);
+    }
+    catch (err) {
+        throw new Error(`atomicWriteJSON: failed to serialize value for ${filePath}: ${err.message}`);
+    }
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    try {
+        await fs.writeFile(tmpPath, serialized, "utf8");
+        await fs.rename(tmpPath, filePath);
+    }
+    catch (err) {
+        // Clean up the .tmp if rename failed mid-flight
+        await fs.unlink(tmpPath).catch(() => {
+            /* ignore */
+        });
+        throw err;
+    }
+}
+/**
+ * Atomically write plain text content to filePath using .tmp + rename pattern.
+ * Same durability guarantees as atomicWriteJSON but without JSON serialization.
+ */
+export async function atomicWriteText(filePath, content) {
+    const tmpPath = `${filePath}.tmp`;
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    try {
+        await fs.writeFile(tmpPath, content, "utf8");
+        await fs.rename(tmpPath, filePath);
+    }
+    catch (err) {
+        await fs.unlink(tmpPath).catch(() => {
+            /* ignore */
+        });
+        throw err;
+    }
+}
+/**
+ * Read a JSON file and parse it. Returns null if file is absent (ENOENT).
+ * Throws if the file exists but contains invalid JSON.
+ */
+export async function atomicReadJSON(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+//# sourceMappingURL=atomic-io.js.map

package/dist/storage/atomic-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-io.js","sourceRoot":"","sources":["../../src/storage/atomic-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAc;IACpE,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;IAClC,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gDAAgD;QAChD,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAClC,YAAY;QACd,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAe;IACrE,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAClC,YAAY;QACd,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,QAAgB;IACtD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/storage/atomic-io.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/storage/atomic-io.test.js

@@ -0,0 +1,49 @@
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { atomicReadJSON, atomicWriteJSON } from "./atomic-io.js";
+let tmpDir;
+beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "atomic-io-test-"));
+});
+afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+describe("atomicWriteJSON", () => {
+    it("Test 1: writes file and removes .tmp on success", async () => {
+        const filePath = path.join(tmpDir, "foo.json");
+        await atomicWriteJSON(filePath, { hello: 1 });
+        const raw = await fs.readFile(filePath, "utf8");
+        expect(JSON.parse(raw)).toEqual({ hello: 1 });
+        // .tmp must NOT exist after success
+        await expect(fs.access(`${filePath}.tmp`)).rejects.toThrow();
+    });
+    it("Test 2: throws on circular reference and does not leave .tmp", async () => {
+        const filePath = path.join(tmpDir, "cyclic.json");
+        // Write a pre-existing file to confirm it remains untouched on error
+        await fs.writeFile(filePath, JSON.stringify({ safe: true }), "utf8");
+        // Create a circular object
+        const cyclic = {};
+        cyclic.self = cyclic;
+        await expect(atomicWriteJSON(filePath, cyclic)).rejects.toThrow();
+        // Pre-existing file must be untouched
+        const raw = await fs.readFile(filePath, "utf8");
+        expect(JSON.parse(raw)).toEqual({ safe: true });
+        // .tmp must NOT exist after failure
+        await expect(fs.access(`${filePath}.tmp`)).rejects.toThrow();
+    });
+});
+describe("atomicReadJSON", () => {
+    it("Test 3: returns null for absent file", async () => {
+        const filePath = path.join(tmpDir, "never-written.json");
+        const result = await atomicReadJSON(filePath);
+        expect(result).toBeNull();
+    });
+    it("Test 4: throws on corrupted (invalid JSON) file", async () => {
+        const filePath = path.join(tmpDir, "corrupt.json");
+        await fs.writeFile(filePath, "{ this is not valid json }", "utf8");
+        await expect(atomicReadJSON(filePath)).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=atomic-io.test.js.map

package/dist/storage/atomic-io.test.js.map

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

package/dist/storage/config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TUI-owned cap configuration stored at ~/.muonroi-cli/config.json.
+ *
+ * Architecture anti-pattern 4: cap state is owned exclusively by the TUI process.
+ * EE server must NEVER read or write this file — it only receives per-call context
+ * over HTTP.
+ */
+export interface MuonroiConfig {
+    cap: {
+        monthly_usd: number;
+    };
+    ee?: {
+        baseUrl?: string;
+        authToken?: string;
+    };
+}
+/**
+ * Load config from ~/.muonroi-cli/config.json.
+ * If absent, writes and returns the default config (cap.monthly_usd = 15).
+ * Accepts an optional homeOverride for test isolation.
+ */
+export declare function loadConfig(homeOverride?: string): Promise<MuonroiConfig>;

package/dist/storage/config.js

@@ -0,0 +1,35 @@
+import * as os from "node:os";
+import * as path from "node:path";
+import { atomicReadJSON, atomicWriteJSON } from "./atomic-io.js";
+const DEFAULT_CONFIG = {
+    cap: { monthly_usd: 15 },
+    ee: { baseUrl: "http://localhost:8082" },
+};
+/**
+ * Resolve the ~/.muonroi-cli/ home directory.
+ * Priority: explicit override → MUONROI_CLI_HOME env → os.homedir()/.muonroi-cli
+ */
+function muonroiHome(override) {
+    return override ?? process.env.MUONROI_CLI_HOME ?? path.join(os.homedir(), ".muonroi-cli");
+}
+/**
+ * Load config from ~/.muonroi-cli/config.json.
+ * If absent, writes and returns the default config (cap.monthly_usd = 15).
+ * Accepts an optional homeOverride for test isolation.
+ */
+export async function loadConfig(homeOverride) {
+    const home = muonroiHome(homeOverride);
+    const filePath = path.join(home, "config.json");
+    const existing = await atomicReadJSON(filePath);
+    if (existing) {
+        // Merge so that missing keys fall back to defaults (handles partial user configs)
+        return {
+            ...DEFAULT_CONFIG,
+            ...existing,
+            cap: { ...DEFAULT_CONFIG.cap, ...existing.cap },
+        };
+    }
+    await atomicWriteJSON(filePath, DEFAULT_CONFIG);
+    return DEFAULT_CONFIG;
+}
+//# sourceMappingURL=config.js.map

package/dist/storage/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/storage/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAcjE,MAAM,cAAc,GAAkB;IACpC,GAAG,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IACxB,EAAE,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE;CACzC,CAAC;AAEF;;;GAGG;AACH,SAAS,WAAW,CAAC,QAAiB;IACpC,OAAO,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAC7F,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,YAAqB;IACpD,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAgB,QAAQ,CAAC,CAAC;IAC/D,IAAI,QAAQ,EAAE,CAAC;QACb,kFAAkF;QAClF,OAAO;YACL,GAAG,cAAc;YACjB,GAAG,QAAQ;YACX,GAAG,EAAE,EAAE,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE;SAChD,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAChD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/storage/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/storage/config.test.js

@@ -0,0 +1,29 @@
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { atomicWriteJSON } from "./atomic-io.js";
+import { loadConfig } from "./config.js";
+let tmpDir;
+beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "config-test-"));
+});
+afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+describe("loadConfig", () => {
+    it("Test 5: bootstraps default config when ~/.muonroi-cli/config.json absent", async () => {
+        const config = await loadConfig(tmpDir);
+        expect(config.cap.monthly_usd).toBe(15);
+        // File must be written now
+        const raw = await fs.readFile(path.join(tmpDir, "config.json"), "utf8");
+        const parsed = JSON.parse(raw);
+        expect(parsed.cap.monthly_usd).toBe(15);
+    });
+    it("Test 6: respects user-provided cap.monthly_usd value", async () => {
+        await atomicWriteJSON(path.join(tmpDir, "config.json"), { cap: { monthly_usd: 30 } });
+        const config = await loadConfig(tmpDir);
+        expect(config.cap.monthly_usd).toBe(30);
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/storage/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/storage/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,IAAI,MAAc,CAAC;AAEnB,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,2BAA2B;QAC3B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/storage/db.d.ts

@@ -0,0 +1,18 @@
+export interface SQLiteStatement {
+    run(...params: unknown[]): unknown;
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+}
+export interface SQLiteDatabase {
+    exec(sql: string): void;
+    prepare(sql: string): SQLiteStatement;
+    pragma(query: string, options?: {
+        simple?: boolean;
+    }): unknown;
+    transaction<T>(fn: () => T): () => T;
+    close(): void;
+}
+export declare function getDatabasePath(): string;
+export declare function getDatabase(): SQLiteDatabase;
+export declare function withTransaction<T>(fn: (database: SQLiteDatabase) => T): T;
+export declare function closeDatabase(): void;