sandstream-kit 1.0.0 → 1.1.0

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/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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"}

package/dist/memory/pal.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.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.js.map

package/dist/memory/pal.js.map

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

package/dist/memory/parser.d.ts

@@ -0,0 +1,25 @@
+import type { DatabaseSync } from "node:sqlite";
+export interface IndexResult {
+    files: number;
+    sessions: number;
+    messages: number;
+    toolUses: number;
+}
+export declare function getClaudeProjectsDir(): string;
+interface ContentBlock {
+    type?: string;
+    text?: string;
+    name?: string;
+    input?: unknown;
+}
+type Content = string | ContentBlock[] | undefined;
+/** Flatten transcript content (string or block array) into searchable plain text. */
+export declare function extractText(content: Content): string;
+/** Extract tool_use blocks from a message's content. */
+export declare function extractToolUses(content: Content): {
+    name: string;
+    input: string;
+}[];
+/** Walk ~/.claude/projects and index every transcript. Idempotent. */
+export declare function indexClaudeTranscripts(db: DatabaseSync): IndexResult;
+export {};