sandstream-kit 1.0.1 → 1.2.0

package/dist/memory/hook.test 2.js

@@ -0,0 +1,35 @@
+import { describe, it, before, after } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { openMemoryDb, upsertSession, insertMessage } from "./db.js";
+import { userPromptSubmitReminder } from "./hook.js";
+describe("memory hook — UserPromptSubmit reminder", () => {
+    let tmp;
+    const prev = process.env.KIT_MEMORY_DB;
+    before(() => {
+        tmp = mkdtempSync(join(tmpdir(), "kit-hook-"));
+        process.env.KIT_MEMORY_DB = join(tmp, "memory.db");
+        const db = openMemoryDb();
+        upsertSession(db, { sessionId: "s1", harness: "claude-code" });
+        insertMessage(db, { uuid: "u1", sessionId: "s1", type: "user", content: "hi" });
+        db.close();
+    });
+    after(() => {
+        if (prev === undefined)
+            delete process.env.KIT_MEMORY_DB;
+        else
+            process.env.KIT_MEMORY_DB = prev;
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("nudges the agent to search and reports the message count", () => {
+        const text = userPromptSubmitReminder();
+        assert.match(text, /kit memory search/);
+        assert.match(text, /1 messages/);
+    });
+    it("never throws (fail-open)", () => {
+        assert.doesNotThrow(() => userPromptSubmitReminder());
+    });
+});
+//# sourceMappingURL=hook.test%202.js.map

package/dist/memory/hook.test 2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.test 2.js","sourceRoot":"","sources":["../../src/memory/hook.test 2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,IAAI,GAAW,CAAC;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAEvC,MAAM,CAAC,GAAG,EAAE;QACV,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,aAAa,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;QAC/D,aAAa,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,GAAG,EAAE;QACT,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;;YACpD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC;QACtC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,wBAAwB,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/memory/install 2.d.ts

@@ -0,0 +1,8 @@
+export declare function getClaudeSettingsPath(): string;
+export declare function installMemoryHooks(path?: string): {
+    added: string[];
+    alreadyPresent: string[];
+};
+export declare function uninstallMemoryHooks(path?: string): {
+    removed: string[];
+};

package/dist/memory/install 2.js

@@ -0,0 +1,72 @@
+/**
+ * kit memory — install/remove the two Claude Code hooks in ~/.claude/settings.json.
+ *
+ * Idempotent and non-destructive: merges our hook entries into the existing
+ * settings without touching the user's other hooks. Re-running adds nothing.
+ * Honors KIT_CLAUDE_SETTINGS for tests.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+const MEMORY_HOOKS = [
+    { event: "UserPromptSubmit", command: "kit memory hook user-prompt-submit" },
+    { event: "SessionEnd", command: "kit memory hook session-end" },
+];
+export function getClaudeSettingsPath() {
+    return process.env.KIT_CLAUDE_SETTINGS ?? join(homedir(), ".claude", "settings.json");
+}
+function readSettings(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return {}; // corrupt/unreadable → start fresh rather than crash
+    }
+}
+function writeSettings(path, s) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(s, null, 2) + "\n");
+}
+function groupsHaveCommand(groups, command) {
+    return groups.some((g) => g.hooks?.some((h) => h.command === command));
+}
+export function installMemoryHooks(path = getClaudeSettingsPath()) {
+    const s = readSettings(path);
+    const hooks = (s.hooks ??= {});
+    const added = [];
+    const alreadyPresent = [];
+    for (const { event, command } of MEMORY_HOOKS) {
+        const groups = (hooks[event] ??= []);
+        if (groupsHaveCommand(groups, command)) {
+            alreadyPresent.push(event);
+            continue;
+        }
+        groups.push({ hooks: [{ type: "command", command }] });
+        added.push(event);
+    }
+    if (added.length)
+        writeSettings(path, s);
+    return { added, alreadyPresent };
+}
+export function uninstallMemoryHooks(path = getClaudeSettingsPath()) {
+    const s = readSettings(path);
+    if (!s.hooks)
+        return { removed: [] };
+    const removed = [];
+    for (const { event, command } of MEMORY_HOOKS) {
+        const groups = s.hooks[event];
+        if (!Array.isArray(groups))
+            continue;
+        const filtered = groups.filter((g) => !g.hooks?.some((h) => h.command === command));
+        if (filtered.length !== groups.length) {
+            s.hooks[event] = filtered;
+            removed.push(event);
+        }
+    }
+    if (removed.length)
+        writeSettings(path, s);
+    return { removed };
+}
+//# sourceMappingURL=install%202.js.map

package/dist/memory/install 2.js.map

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

package/dist/memory/install.d.ts

@@ -0,0 +1,8 @@
+export declare function getClaudeSettingsPath(): string;
+export declare function installMemoryHooks(path?: string): {
+    added: string[];
+    alreadyPresent: string[];
+};
+export declare function uninstallMemoryHooks(path?: string): {
+    removed: string[];
+};

package/dist/memory/install.js

@@ -0,0 +1,73 @@
+/**
+ * kit memory — install/remove the two Claude Code hooks in ~/.claude/settings.json.
+ *
+ * Idempotent and non-destructive: merges our hook entries into the existing
+ * settings without touching the user's other hooks. Re-running adds nothing.
+ * Honors KIT_CLAUDE_SETTINGS for tests.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+const MEMORY_HOOKS = [
+    { event: "UserPromptSubmit", command: "kit memory hook user-prompt-submit" },
+    { event: "SessionEnd", command: "kit memory hook session-end" },
+    { event: "SessionStart", command: "kit memory hook session-start" },
+];
+export function getClaudeSettingsPath() {
+    return process.env.KIT_CLAUDE_SETTINGS ?? join(homedir(), ".claude", "settings.json");
+}
+function readSettings(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return {}; // corrupt/unreadable → start fresh rather than crash
+    }
+}
+function writeSettings(path, s) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(s, null, 2) + "\n");
+}
+function groupsHaveCommand(groups, command) {
+    return groups.some((g) => g.hooks?.some((h) => h.command === command));
+}
+export function installMemoryHooks(path = getClaudeSettingsPath()) {
+    const s = readSettings(path);
+    const hooks = (s.hooks ??= {});
+    const added = [];
+    const alreadyPresent = [];
+    for (const { event, command } of MEMORY_HOOKS) {
+        const groups = (hooks[event] ??= []);
+        if (groupsHaveCommand(groups, command)) {
+            alreadyPresent.push(event);
+            continue;
+        }
+        groups.push({ hooks: [{ type: "command", command }] });
+        added.push(event);
+    }
+    if (added.length)
+        writeSettings(path, s);
+    return { added, alreadyPresent };
+}
+export function uninstallMemoryHooks(path = getClaudeSettingsPath()) {
+    const s = readSettings(path);
+    if (!s.hooks)
+        return { removed: [] };
+    const removed = [];
+    for (const { event, command } of MEMORY_HOOKS) {
+        const groups = s.hooks[event];
+        if (!Array.isArray(groups))
+            continue;
+        const filtered = groups.filter((g) => !g.hooks?.some((h) => h.command === command));
+        if (filtered.length !== groups.length) {
+            s.hooks[event] = filtered;
+            removed.push(event);
+        }
+    }
+    if (removed.length)
+        writeSettings(path, s);
+    return { removed };
+}
+//# sourceMappingURL=install.js.map

package/dist/memory/install.js.map

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

package/dist/memory/install.test 2.d.ts

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

package/dist/memory/install.test 2.js

@@ -0,0 +1,59 @@
+import { describe, it, before, after, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync, writeFileSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { installMemoryHooks, uninstallMemoryHooks } from "./install.js";
+describe("memory hook installer", () => {
+    let tmp;
+    let settingsPath;
+    const prev = process.env.KIT_CLAUDE_SETTINGS;
+    before(() => {
+        tmp = mkdtempSync(join(tmpdir(), "kit-install-"));
+        settingsPath = join(tmp, "settings.json");
+        process.env.KIT_CLAUDE_SETTINGS = settingsPath;
+    });
+    beforeEach(() => {
+        // Start each test from a settings file with an unrelated, pre-existing hook.
+        writeFileSync(settingsPath, JSON.stringify({
+            hooks: {
+                UserPromptSubmit: [{ hooks: [{ type: "command", command: "some-other-tool" }] }],
+            },
+        }));
+    });
+    after(() => {
+        if (prev === undefined)
+            delete process.env.KIT_CLAUDE_SETTINGS;
+        else
+            process.env.KIT_CLAUDE_SETTINGS = prev;
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("installs both hooks without clobbering existing ones", () => {
+        const res = installMemoryHooks();
+        assert.deepEqual(res.added.sort(), ["SessionEnd", "UserPromptSubmit"]);
+        const s = JSON.parse(readFileSync(settingsPath, "utf8"));
+        const ups = s.hooks.UserPromptSubmit.flatMap((g) => g.hooks.map((h) => h.command));
+        assert.ok(ups.includes("some-other-tool"), "preserves the pre-existing hook");
+        assert.ok(ups.includes("kit memory hook user-prompt-submit"));
+        assert.ok(s.hooks.SessionEnd.some((g) => g.hooks.some((h) => h.command === "kit memory hook session-end")));
+    });
+    it("is idempotent — re-install adds nothing and creates no duplicates", () => {
+        installMemoryHooks();
+        const res2 = installMemoryHooks();
+        assert.deepEqual(res2.added, []);
+        assert.deepEqual(res2.alreadyPresent.sort(), ["SessionEnd", "UserPromptSubmit"]);
+        const s = JSON.parse(readFileSync(settingsPath, "utf8"));
+        const ours = s.hooks.UserPromptSubmit.filter((g) => g.hooks.some((h) => h.command === "kit memory hook user-prompt-submit"));
+        assert.equal(ours.length, 1);
+    });
+    it("uninstall removes only our hooks, leaving others intact", () => {
+        installMemoryHooks();
+        const res = uninstallMemoryHooks();
+        assert.deepEqual(res.removed.sort(), ["SessionEnd", "UserPromptSubmit"]);
+        const s = JSON.parse(readFileSync(settingsPath, "utf8"));
+        const ups = s.hooks.UserPromptSubmit.flatMap((g) => g.hooks.map((h) => h.command));
+        assert.ok(ups.includes("some-other-tool"), "unrelated hook survives uninstall");
+        assert.ok(!ups.includes("kit memory hook user-prompt-submit"));
+    });
+});
+//# sourceMappingURL=install.test%202.js.map

package/dist/memory/install.test 2.js.map

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

package/dist/memory/merge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * kit memory — merge another store into this one.
+ *
+ * Consolidate memory across machines (a server, an old laptop) into one brain.
+ * Idempotent: messages dedupe by uuid, sessions/pending/threads by their keys, and
+ * a message's tool_uses are copied only when the message itself is newly added, so
+ * re-merging the same source adds nothing. `file_index` is NOT merged (it tracks
+ * machine-local file paths). Deterministic; no model calls.
+ */
+import { DatabaseSync } from "node:sqlite";
+export interface MergeResult {
+    sessions: number;
+    messages: number;
+    toolUses: number;
+    pending: number;
+    threads: number;
+}
+export declare function mergeDb(target: DatabaseSync, sourcePath: string): MergeResult;

package/dist/memory/merge.js

@@ -0,0 +1,109 @@
+/**
+ * kit memory — merge another store into this one.
+ *
+ * Consolidate memory across machines (a server, an old laptop) into one brain.
+ * Idempotent: messages dedupe by uuid, sessions/pending/threads by their keys, and
+ * a message's tool_uses are copied only when the message itself is newly added, so
+ * re-merging the same source adds nothing. `file_index` is NOT merged (it tracks
+ * machine-local file paths). Deterministic; no model calls.
+ */
+import { DatabaseSync } from "node:sqlite";
+import { existsSync } from "node:fs";
+import { insertMessage, insertToolUse, upsertSession } from "./db.js";
+const str = (v) => (typeof v === "string" && v ? v : undefined);
+const num = (v) => (typeof v === "number" ? v : undefined);
+export function mergeDb(target, sourcePath) {
+    if (!existsSync(sourcePath))
+        throw new Error(`source memory db not found: ${sourcePath}`);
+    const src = new DatabaseSync(sourcePath, { readOnly: true });
+    const out = { sessions: 0, messages: 0, toolUses: 0, pending: 0, threads: 0 };
+    try {
+        // Sessions
+        for (const s of src.prepare("SELECT * FROM sessions").all()) {
+            const sessionId = str(s.session_id);
+            if (!sessionId)
+                continue;
+            upsertSession(target, {
+                sessionId,
+                harness: str(s.harness) ?? "claude-code",
+                project: str(s.project),
+                firstMessageAt: str(s.first_message_at),
+                lastMessageAt: str(s.last_message_at),
+                isAgentSidechain: !!s.is_agent_sidechain,
+            });
+            out.sessions++;
+        }
+        // tool_uses grouped by message uuid (copied only for newly-added messages)
+        const toolsByUuid = new Map();
+        for (const t of src.prepare("SELECT * FROM tool_uses").all()) {
+            const uuid = str(t.message_uuid);
+            if (!uuid)
+                continue;
+            (toolsByUuid.get(uuid) ?? toolsByUuid.set(uuid, []).get(uuid)).push(t);
+        }
+        // Messages (dedupe by uuid) + their tool_uses
+        for (const m of src.prepare("SELECT * FROM messages").all()) {
+            const uuid = str(m.uuid);
+            const sessionId = str(m.session_id);
+            const type = str(m.type);
+            if (!uuid || !sessionId || !type)
+                continue; // need a stable id to dedupe
+            const added = insertMessage(target, {
+                uuid,
+                sessionId,
+                parentUuid: str(m.parent_uuid),
+                type,
+                role: str(m.role),
+                content: str(m.content),
+                model: str(m.model),
+                inputTokens: num(m.input_tokens),
+                outputTokens: num(m.output_tokens),
+                timestamp: str(m.timestamp),
+                cwd: str(m.cwd),
+                gitBranch: str(m.git_branch),
+                version: str(m.version),
+            });
+            if (!added)
+                continue;
+            out.messages++;
+            for (const t of toolsByUuid.get(uuid) ?? []) {
+                insertToolUse(target, {
+                    messageUuid: uuid,
+                    sessionId: str(t.session_id),
+                    toolName: str(t.tool_name) ?? "unknown",
+                    toolInput: str(t.tool_input),
+                    timestamp: str(t.timestamp),
+                });
+                out.toolUses++;
+            }
+        }
+        // Pending actions (dedupe by id)
+        const insPending = target.prepare(`INSERT OR IGNORE INTO pending_actions
+       (id, status, title, detail, scope, kind, verify_cmd, created_at, next_check, snooze_until, closed_at, verify_passes)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        for (const p of src.prepare("SELECT * FROM pending_actions").all()) {
+            if (!str(p.id) || !str(p.title))
+                continue;
+            const r = insPending.run(p.id, str(p.status) ?? "open", p.title, (str(p.detail) ?? null), (str(p.scope) ?? null), str(p.kind) ?? "manual", (str(p.verify_cmd) ?? null), (str(p.created_at) ?? null), (str(p.next_check) ?? null), (str(p.snooze_until) ?? null), (str(p.closed_at) ?? null), num(p.verify_passes) ?? 0);
+            if (Number(r.changes) > 0)
+                out.pending++;
+        }
+        // Saved threads (dedupe by name)
+        const insThread = target.prepare(`INSERT OR IGNORE INTO saved_threads (name, session_id, summary, project_path, saved_at)
+       VALUES (?, ?, ?, ?, ?)`);
+        for (const t of src.prepare("SELECT * FROM saved_threads").all()) {
+            const name = str(t.name);
+            const sid = str(t.session_id);
+            if (!name || !sid)
+                continue;
+            const r = insThread.run(name, sid, (str(t.summary) ?? null), (str(t.project_path) ?? null), (str(t.saved_at) ?? null));
+            if (Number(r.changes) > 0)
+                out.threads++;
+        }
+    }
+    finally {
+        src.close();
+    }
+    return out;
+}
+//# sourceMappingURL=merge.js.map

package/dist/memory/merge.js.map

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

package/dist/memory/pal 2.d.ts

@@ -0,0 +1,47 @@
+import type { DatabaseSync } from "node:sqlite";
+export interface PendingAction {
+    id: string;
+    status: string;
+    title: string;
+    detail: string | null;
+    scope: string | null;
+    kind: string;
+    verify_cmd: string | null;
+    created_at: string | null;
+    next_check: string | null;
+    snooze_until: string | null;
+    closed_at: string | null;
+    verify_passes: number;
+}
+export interface PalAddInput {
+    title: string;
+    detail?: string;
+    scope?: string;
+    kind?: "manual" | "auto";
+    verifyCmd?: string;
+}
+export declare function palAdd(db: DatabaseSync, input: PalAddInput): string;
+export interface PalListOptions {
+    status?: string;
+    /** Restrict to this scope plus globally-scoped (NULL) items. Omit = every scope. */
+    scope?: string;
+}
+export declare function palList(db: DatabaseSync, opts?: PalListOptions): PendingAction[];
+export declare function palDone(db: DatabaseSync, id: string): boolean;
+export declare function palSnooze(db: DatabaseSync, id: string, days: number): boolean;
+export interface AutoVerifyResult {
+    checked: number;
+    closed: string[];
+    reopened: string[];
+}
+/**
+ * Auto-verify `auto` items. An OPEN item that passes `confirmPasses` consecutive
+ * times is closed (a pass increments the streak, a fail resets it). A CLOSED item
+ * whose verify now FAILS is reopened (reopen-on-regress). No-info leaves it alone.
+ */
+export declare function palAutoVerify(db: DatabaseSync, confirmPasses?: number): AutoVerifyResult;
+export declare function getLegacyLedgerPath(): string;
+/** Import the old `~/.claude/pal/ledger.jsonl` into pending_actions. Idempotent (by id). */
+export declare function importLegacyLedger(db: DatabaseSync, path?: string): {
+    imported: number;
+};

package/dist/memory/pal 2.js

@@ -0,0 +1,154 @@
+/**
+ * kit memory — PAL (Pending Action Ledger), folded into the memory store.
+ *
+ * PAL is the STRUCTURED, actionable layer on top of raw conversation memory:
+ * "blocked-on-you" items that survive sessions and auto-close when their verify
+ * command starts passing. It lives in the `pending_actions` table of the same
+ * SQLite store. Deterministic; the only side effect is running operator-defined
+ * verify commands (local shell, with a timeout). Fail-open / no-info aware.
+ */
+import { randomBytes } from "node:crypto";
+import { execSync } from "node:child_process";
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function newId(db) {
+    for (let i = 0; i < 100; i++) {
+        const id = randomBytes(2).toString("hex"); // 4 hex chars, e.g. "ec95"
+        if (!db.prepare("SELECT 1 FROM pending_actions WHERE id = ?").get(id))
+            return id;
+    }
+    throw new Error("could not allocate a unique pending-action id");
+}
+export function palAdd(db, input) {
+    const id = newId(db);
+    const kind = input.kind ?? (input.verifyCmd ? "auto" : "manual");
+    db.prepare(`INSERT INTO pending_actions (id, status, title, detail, scope, kind, verify_cmd)
+     VALUES (?, 'open', ?, ?, ?, ?, ?)`).run(id, input.title, input.detail ?? null, input.scope ?? null, kind, input.verifyCmd ?? null);
+    return id;
+}
+export function palList(db, opts = {}) {
+    const status = opts.status ?? "open";
+    if (opts.scope !== undefined) {
+        return db
+            .prepare("SELECT * FROM pending_actions WHERE status = ? AND (scope = ? OR scope IS NULL) ORDER BY created_at, id")
+            .all(status, opts.scope);
+    }
+    return db
+        .prepare("SELECT * FROM pending_actions WHERE status = ? ORDER BY created_at, id")
+        .all(status);
+}
+export function palDone(db, id) {
+    const res = db
+        .prepare("UPDATE pending_actions SET status='closed', closed_at=datetime('now') WHERE id=? AND status!='closed'")
+        .run(id);
+    return Number(res.changes) > 0;
+}
+export function palSnooze(db, id, days) {
+    const d = Math.max(1, Math.floor(days));
+    const res = db
+        .prepare("UPDATE pending_actions SET status='snoozed', snooze_until=datetime('now', ?) WHERE id=?")
+        .run(`+${d} days`, id);
+    return Number(res.changes) > 0;
+}
+/**
+ * Run a verify command. true = pass (exit 0), false = ran but failed, null = no-info.
+ *
+ * SECURITY: this runs `cmd` through a shell on purpose — verify commands routinely
+ * need pipes / `&&` (e.g. `curl -fsS … | grep 200`). The trust boundary: `verify_cmd`
+ * is OPERATOR-AUTHORED and lives only in the PERSONAL store (~/.kit/memory.db); running
+ * it is equivalent to the operator running their own command — no untrusted data is
+ * interpolated, so this is not a command-injection sink. INVARIANT for Track D (shared
+ * memory): shared/synced items must NEVER carry an executable `verify_cmd` that runs
+ * unreviewed — only manual items or review-gated verifies cross the sharing boundary.
+ */
+function runVerify(cmd) {
+    try {
+        execSync(cmd, { stdio: "ignore", timeout: 15_000 });
+        return true;
+    }
+    catch (err) {
+        const status = err.status;
+        if (typeof status === "number")
+            return false; // ran, non-zero exit
+        return null; // spawn error / timeout → no-info, leave state unchanged
+    }
+}
+/**
+ * Auto-verify `auto` items. An OPEN item that passes `confirmPasses` consecutive
+ * times is closed (a pass increments the streak, a fail resets it). A CLOSED item
+ * whose verify now FAILS is reopened (reopen-on-regress). No-info leaves it alone.
+ */
+export function palAutoVerify(db, confirmPasses = 2) {
+    const out = { checked: 0, closed: [], reopened: [] };
+    const rows = db
+        .prepare("SELECT * FROM pending_actions WHERE kind='auto' AND verify_cmd IS NOT NULL AND status IN ('open','closed')")
+        .all();
+    for (const r of rows) {
+        const result = runVerify(r.verify_cmd);
+        if (result === null)
+            continue; // no-info
+        out.checked++;
+        if (r.status === "open") {
+            if (result) {
+                const passes = r.verify_passes + 1;
+                if (passes >= confirmPasses) {
+                    db.prepare("UPDATE pending_actions SET status='closed', closed_at=datetime('now'), verify_passes=? WHERE id=?").run(passes, r.id);
+                    out.closed.push(r.id);
+                }
+                else {
+                    db.prepare("UPDATE pending_actions SET verify_passes=? WHERE id=?").run(passes, r.id);
+                }
+            }
+            else if (r.verify_passes !== 0) {
+                db.prepare("UPDATE pending_actions SET verify_passes=0 WHERE id=?").run(r.id);
+            }
+        }
+        else if (r.status === "closed" && !result) {
+            db.prepare("UPDATE pending_actions SET status='open', verify_passes=0, closed_at=NULL WHERE id=?").run(r.id);
+            out.reopened.push(r.id);
+        }
+    }
+    return out;
+}
+// ── Migration from the legacy python PAL ledger ───────────────────────────────
+export function getLegacyLedgerPath() {
+    return process.env.KIT_PAL_LEDGER ?? join(homedir(), ".claude", "pal", "ledger.jsonl");
+}
+/** Import the old `~/.claude/pal/ledger.jsonl` into pending_actions. Idempotent (by id). */
+export function importLegacyLedger(db, path = getLegacyLedgerPath()) {
+    if (!existsSync(path))
+        return { imported: 0 };
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return { imported: 0 };
+    }
+    const insert = db.prepare(`INSERT OR IGNORE INTO pending_actions
+     (id, status, title, detail, scope, kind, verify_cmd, created_at, next_check, verify_passes)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+    let imported = 0;
+    for (const line of raw.split("\n")) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        let e;
+        try {
+            e = JSON.parse(t);
+        }
+        catch {
+            continue;
+        }
+        if (!e.id || !e.title)
+            continue;
+        const status = e.status === "done" ? "closed" : (e.status ?? "open");
+        const kind = e.verify ? "auto" : "manual";
+        const res = insert.run(e.id, status, e.title, e.why ?? null, e.repo ?? null, kind, e.verify ?? null, e.ts ?? null, e.next_check ?? null, e.pass_streak ?? 0);
+        if (Number(res.changes) > 0)
+            imported++;
+    }
+    return { imported };
+}
+//# sourceMappingURL=pal%202.js.map

package/dist/memory/pal 2.js.map

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