sandstream-kit 1.0.0 → 1.1.0

package/dist/memory/db.d.ts

@@ -0,0 +1,40 @@
+/**
+ * kit memory — local SQLite store (node:sqlite + FTS5).
+ *
+ * Schema is derived from cloudctx (MIT — github.com/chadptk1238/cloudctx): we reuse
+ * its proven table layout, PRAGMAs and FTS5 design. Differences: kit is a Node/TS
+ * project, so we use the built-in `node:sqlite` driver instead of `bun:sqlite`; we
+ * add a `harness` column (kit is harness-agnostic) and a `pending_actions` table
+ * (PAL — the structured, actionable layer on top of raw conversation memory).
+ *
+ * Memory is RAW and append-only: one row per message, no summarisation. Retrieval
+ * (FTS5) happens at time of work — store everything raw, search on demand. This DB
+ * is secret-dense (it indexes private transcripts): it lives only under ~/.kit/ with
+ * 0600 perms and is never committed. Redaction / encryption is stage B7.
+ */
+import { DatabaseSync } from "node:sqlite";
+import type { MemoryStats, MessageInput, SearchHit, SessionInput, ToolUseInput } from "./types.js";
+export declare const SCHEMA_VERSION = 2;
+export declare function getMemoryDir(): string;
+export declare function getMemoryDbPath(): string;
+/**
+ * Open (creating + migrating if needed) the memory database. Pass ":memory:" for
+ * an ephemeral in-process DB (tests). Otherwise defaults to ~/.kit/memory.db.
+ */
+export declare function openMemoryDb(path?: string): DatabaseSync;
+export declare function upsertSession(db: DatabaseSync, s: SessionInput): void;
+/** Insert a message idempotently (by uuid). Returns true if a new row was added. */
+export declare function insertMessage(db: DatabaseSync, m: MessageInput): boolean;
+export declare function insertToolUse(db: DatabaseSync, t: ToolUseInput): void;
+export interface SearchOptions {
+    limit?: number;
+    /** Restrict to messages whose cwd is this repo root (or a subdirectory). */
+    projectPath?: string;
+}
+/**
+ * Full-text search over raw message content (FTS5 MATCH, ranked by `rank`).
+ * Pass opts.projectPath to scope to one repo (relevance + blast-radius); omit it
+ * for cross-project ("--global") recall over the personal store.
+ */
+export declare function searchMessages(db: DatabaseSync, query: string, opts?: SearchOptions): SearchHit[];
+export declare function getStats(db: DatabaseSync): MemoryStats;

package/dist/memory/db.js

@@ -0,0 +1,233 @@
+/**
+ * kit memory — local SQLite store (node:sqlite + FTS5).
+ *
+ * Schema is derived from cloudctx (MIT — github.com/chadptk1238/cloudctx): we reuse
+ * its proven table layout, PRAGMAs and FTS5 design. Differences: kit is a Node/TS
+ * project, so we use the built-in `node:sqlite` driver instead of `bun:sqlite`; we
+ * add a `harness` column (kit is harness-agnostic) and a `pending_actions` table
+ * (PAL — the structured, actionable layer on top of raw conversation memory).
+ *
+ * Memory is RAW and append-only: one row per message, no summarisation. Retrieval
+ * (FTS5) happens at time of work — store everything raw, search on demand. This DB
+ * is secret-dense (it indexes private transcripts): it lives only under ~/.kit/ with
+ * 0600 perms and is never committed. Redaction / encryption is stage B7.
+ */
+import { DatabaseSync } from "node:sqlite";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync, mkdirSync, chmodSync, statSync } from "node:fs";
+export const SCHEMA_VERSION = 2;
+export function getMemoryDir() {
+    return process.env.KIT_MEMORY_DIR ?? join(homedir(), ".kit");
+}
+export function getMemoryDbPath() {
+    return process.env.KIT_MEMORY_DB ?? join(getMemoryDir(), "memory.db");
+}
+function ensureMemoryDir() {
+    const dir = getMemoryDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS sessions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT UNIQUE NOT NULL,
+  harness TEXT NOT NULL DEFAULT 'claude-code',
+  project TEXT,
+  first_message_at TEXT,
+  last_message_at TEXT,
+  message_count INTEGER DEFAULT 0,
+  is_agent_sidechain INTEGER DEFAULT 0
+);
+
+CREATE TABLE IF NOT EXISTS messages (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  uuid TEXT UNIQUE,
+  session_id TEXT NOT NULL,
+  parent_uuid TEXT,
+  type TEXT NOT NULL,
+  role TEXT,
+  content TEXT,
+  model TEXT,
+  input_tokens INTEGER,
+  output_tokens INTEGER,
+  timestamp TEXT,
+  cwd TEXT,
+  git_branch TEXT,
+  version TEXT
+);
+
+CREATE TABLE IF NOT EXISTS tool_uses (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  message_uuid TEXT,
+  session_id TEXT,
+  tool_name TEXT,
+  tool_input TEXT,
+  timestamp TEXT
+);
+
+CREATE TABLE IF NOT EXISTS saved_threads (
+  name TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  summary TEXT,
+  project_path TEXT,
+  saved_at TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS pending_actions (
+  id TEXT PRIMARY KEY,
+  status TEXT NOT NULL DEFAULT 'open',
+  title TEXT NOT NULL,
+  detail TEXT,
+  scope TEXT,
+  kind TEXT NOT NULL DEFAULT 'manual',
+  verify_cmd TEXT,
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+  next_check TEXT,
+  snooze_until TEXT,
+  closed_at TEXT,
+  verify_passes INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id);
+CREATE INDEX IF NOT EXISTS idx_messages_type ON messages(type);
+CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(timestamp);
+CREATE INDEX IF NOT EXISTS idx_tool_uses_tool ON tool_uses(tool_name);
+CREATE INDEX IF NOT EXISTS idx_pending_status ON pending_actions(status);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
+  content,
+  content=messages,
+  content_rowid=id
+);
+
+CREATE TRIGGER IF NOT EXISTS messages_ai AFTER INSERT ON messages BEGIN
+  INSERT INTO messages_fts(rowid, content) VALUES (new.id, new.content);
+END;
+CREATE TRIGGER IF NOT EXISTS messages_ad AFTER DELETE ON messages BEGIN
+  INSERT INTO messages_fts(messages_fts, rowid, content) VALUES ('delete', old.id, old.content);
+END;
+CREATE TRIGGER IF NOT EXISTS messages_au AFTER UPDATE ON messages BEGIN
+  INSERT INTO messages_fts(messages_fts, rowid, content) VALUES ('delete', old.id, old.content);
+  INSERT INTO messages_fts(rowid, content) VALUES (new.id, new.content);
+END;
+`;
+function ensureColumn(db, table, column, decl) {
+    const cols = db.prepare(`PRAGMA table_info(${table})`).all();
+    if (!cols.some((col) => col.name === column)) {
+        db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${decl}`);
+    }
+}
+function migrate(db) {
+    db.exec("CREATE TABLE IF NOT EXISTS schema_meta (version INTEGER NOT NULL)");
+    db.exec(SCHEMA_SQL);
+    // v2: pending_actions.verify_passes (N=2 auto-verify confirmation). Add to
+    // tables created before this column existed.
+    ensureColumn(db, "pending_actions", "verify_passes", "INTEGER NOT NULL DEFAULT 0");
+    const row = db.prepare("SELECT version FROM schema_meta LIMIT 1").get();
+    if (!row) {
+        db.prepare("INSERT INTO schema_meta(version) VALUES (?)").run(SCHEMA_VERSION);
+    }
+    else if (row.version < SCHEMA_VERSION) {
+        db.prepare("UPDATE schema_meta SET version = ?").run(SCHEMA_VERSION);
+    }
+}
+/**
+ * Open (creating + migrating if needed) the memory database. Pass ":memory:" for
+ * an ephemeral in-process DB (tests). Otherwise defaults to ~/.kit/memory.db.
+ */
+export function openMemoryDb(path) {
+    const dbPath = path ?? getMemoryDbPath();
+    if (dbPath !== ":memory:")
+        ensureMemoryDir();
+    const db = new DatabaseSync(dbPath);
+    db.exec("PRAGMA journal_mode = WAL");
+    db.exec("PRAGMA busy_timeout = 5000");
+    db.exec("PRAGMA foreign_keys = OFF");
+    migrate(db);
+    if (dbPath !== ":memory:" && existsSync(dbPath)) {
+        try {
+            chmodSync(dbPath, 0o600);
+        }
+        catch {
+            // best-effort: non-POSIX filesystems may not support chmod
+        }
+    }
+    return db;
+}
+export function upsertSession(db, s) {
+    db.prepare(`INSERT INTO sessions (session_id, harness, project, first_message_at, last_message_at, is_agent_sidechain)
+     VALUES (?, ?, ?, ?, ?, ?)
+     ON CONFLICT(session_id) DO UPDATE SET
+       last_message_at = COALESCE(excluded.last_message_at, sessions.last_message_at),
+       first_message_at = COALESCE(sessions.first_message_at, excluded.first_message_at),
+       project = COALESCE(excluded.project, sessions.project),
+       harness = excluded.harness,
+       is_agent_sidechain = MAX(sessions.is_agent_sidechain, excluded.is_agent_sidechain)`).run(s.sessionId, s.harness, s.project ?? null, s.firstMessageAt ?? null, s.lastMessageAt ?? null, s.isAgentSidechain ? 1 : 0);
+}
+/** Insert a message idempotently (by uuid). Returns true if a new row was added. */
+export function insertMessage(db, m) {
+    const res = db
+        .prepare(`INSERT OR IGNORE INTO messages
+       (uuid, session_id, parent_uuid, type, role, content, model, input_tokens, output_tokens, timestamp, cwd, git_branch, version)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+        .run(m.uuid, m.sessionId, m.parentUuid ?? null, m.type, m.role ?? null, m.content ?? null, m.model ?? null, m.inputTokens ?? null, m.outputTokens ?? null, m.timestamp ?? null, m.cwd ?? null, m.gitBranch ?? null, m.version ?? null);
+    if (Number(res.changes) > 0) {
+        db.prepare("UPDATE sessions SET message_count = message_count + 1 WHERE session_id = ?").run(m.sessionId);
+        return true;
+    }
+    return false;
+}
+export function insertToolUse(db, t) {
+    db.prepare(`INSERT INTO tool_uses (message_uuid, session_id, tool_name, tool_input, timestamp)
+     VALUES (?, ?, ?, ?, ?)`).run(t.messageUuid ?? null, t.sessionId ?? null, t.toolName, t.toolInput ?? null, t.timestamp ?? null);
+}
+/**
+ * Full-text search over raw message content (FTS5 MATCH, ranked by `rank`).
+ * Pass opts.projectPath to scope to one repo (relevance + blast-radius); omit it
+ * for cross-project ("--global") recall over the personal store.
+ */
+export function searchMessages(db, query, opts = {}) {
+    const limit = opts.limit ?? 20;
+    const params = [query];
+    let where = "messages_fts MATCH ?";
+    if (opts.projectPath) {
+        where += " AND (m.cwd = ? OR m.cwd LIKE ?)";
+        params.push(opts.projectPath, `${opts.projectPath}/%`);
+    }
+    params.push(limit);
+    return db
+        .prepare(`SELECT m.id AS id, m.uuid AS uuid, m.session_id AS sessionId, m.role AS role,
+              m.content AS content, m.timestamp AS timestamp
+       FROM messages_fts f
+       JOIN messages m ON m.id = f.rowid
+       WHERE ${where}
+       ORDER BY rank
+       LIMIT ?`)
+        .all(...params);
+}
+export function getStats(db) {
+    const count = (sql) => {
+        const r = db.prepare(sql).get();
+        return r ? Number(r.n) : 0;
+    };
+    const dbPath = getMemoryDbPath();
+    let sizeBytes = 0;
+    if (dbPath !== ":memory:" && existsSync(dbPath)) {
+        try {
+            sizeBytes = statSync(dbPath).size;
+        }
+        catch {
+            // best-effort: size is informational only
+        }
+    }
+    return {
+        sessions: count("SELECT COUNT(*) AS n FROM sessions"),
+        messages: count("SELECT COUNT(*) AS n FROM messages"),
+        toolUses: count("SELECT COUNT(*) AS n FROM tool_uses"),
+        pendingOpen: count("SELECT COUNT(*) AS n FROM pending_actions WHERE status = 'open'"),
+        dbPath,
+        sizeBytes,
+    };
+}
+//# sourceMappingURL=db.js.map

package/dist/memory/db.js.map

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

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

@@ -0,0 +1,6 @@
+/** Reminder injected before every prompt. Empty string on any error (fail-open). */
+export declare function userPromptSubmitReminder(): string;
+/** Index the just-ended session. Returns count of newly indexed messages (fail-open). */
+export declare function runSessionEndIndex(): {
+    messages: number;
+};

package/dist/memory/hook 2.js

@@ -0,0 +1,51 @@
+/**
+ * kit memory — Claude Code hook entry points (the "whole system is two hooks").
+ *
+ *  - UserPromptSubmit → a short reminder that searchable memory exists. The agent
+ *    pulls on demand (`kit memory search`) instead of pre-loading everything.
+ *  - SessionEnd → index the just-ended session into the store (incremental sync).
+ *
+ * Both are FAIL-OPEN: any error yields an empty/no-op result so a hook can never
+ * block a prompt or break a session. Deterministic, zero model calls.
+ */
+import { basename } from "node:path";
+import { openMemoryDb, getStats } from "./db.js";
+import { indexClaudeTranscripts } from "./parser.js";
+import { palList } from "./pal.js";
+import { getCurrentProjectRoot } from "./project.js";
+/** Reminder injected before every prompt. Empty string on any error (fail-open). */
+export function userPromptSubmitReminder() {
+    try {
+        const db = openMemoryDb();
+        const s = getStats(db);
+        // Only surface THIS project's open items (plus globally-scoped) — no cross-project noise.
+        const openItems = palList(db, { scope: basename(getCurrentProjectRoot()) });
+        db.close();
+        let pending = "";
+        if (openItems.length > 0) {
+            const shown = openItems.slice(0, 3);
+            const titles = shown.map((p) => `${p.id} ${p.title}`).join("; ");
+            const more = openItems.length > shown.length ? " …" : "";
+            pending = ` ${openItems.length} open action item(s) blocked on you: ${titles}${more}.`;
+        }
+        return (`You have local conversation memory: ${s.messages} messages indexed. ` +
+            "Before answering anything project-specific, run `kit memory search <terms>` " +
+            `to retrieve what was actually said instead of reconstructing it.${pending}`);
+    }
+    catch {
+        return ""; // fail-open: never block a prompt
+    }
+}
+/** Index the just-ended session. Returns count of newly indexed messages (fail-open). */
+export function runSessionEndIndex() {
+    try {
+        const db = openMemoryDb();
+        const res = indexClaudeTranscripts(db);
+        db.close();
+        return { messages: res.messages };
+    }
+    catch {
+        return { messages: 0 }; // fail-open
+    }
+}
+//# sourceMappingURL=hook%202.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook 2.js","sourceRoot":"","sources":["../../src/memory/hook 2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,oFAAoF;AACpF,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvB,0FAA0F;QAC1F,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,OAAO,GAAG,IAAI,SAAS,CAAC,MAAM,wCAAwC,MAAM,GAAG,IAAI,GAAG,CAAC;QACzF,CAAC;QACD,OAAO,CACL,uCAAuC,CAAC,CAAC,QAAQ,qBAAqB;YACtE,8EAA8E;YAC9E,mEAAmE,OAAO,EAAE,CAC7E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,kCAAkC;IAC/C,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY;IACtC,CAAC;AACH,CAAC"}

package/dist/memory/hook.d.ts

@@ -0,0 +1,6 @@
+/** Reminder injected before every prompt. Empty string on any error (fail-open). */
+export declare function userPromptSubmitReminder(): string;
+/** Index the just-ended session. Returns count of newly indexed messages (fail-open). */
+export declare function runSessionEndIndex(): {
+    messages: number;
+};

package/dist/memory/hook.js

@@ -0,0 +1,51 @@
+/**
+ * kit memory — Claude Code hook entry points (the "whole system is two hooks").
+ *
+ *  - UserPromptSubmit → a short reminder that searchable memory exists. The agent
+ *    pulls on demand (`kit memory search`) instead of pre-loading everything.
+ *  - SessionEnd → index the just-ended session into the store (incremental sync).
+ *
+ * Both are FAIL-OPEN: any error yields an empty/no-op result so a hook can never
+ * block a prompt or break a session. Deterministic, zero model calls.
+ */
+import { basename } from "node:path";
+import { openMemoryDb, getStats } from "./db.js";
+import { indexClaudeTranscripts } from "./parser.js";
+import { palList } from "./pal.js";
+import { getCurrentProjectRoot } from "./project.js";
+/** Reminder injected before every prompt. Empty string on any error (fail-open). */
+export function userPromptSubmitReminder() {
+    try {
+        const db = openMemoryDb();
+        const s = getStats(db);
+        // Only surface THIS project's open items (plus globally-scoped) — no cross-project noise.
+        const openItems = palList(db, { scope: basename(getCurrentProjectRoot()) });
+        db.close();
+        let pending = "";
+        if (openItems.length > 0) {
+            const shown = openItems.slice(0, 3);
+            const titles = shown.map((p) => `${p.id} ${p.title}`).join("; ");
+            const more = openItems.length > shown.length ? " …" : "";
+            pending = ` ${openItems.length} open action item(s) blocked on you: ${titles}${more}.`;
+        }
+        return (`You have local conversation memory: ${s.messages} messages indexed. ` +
+            "Before answering anything project-specific, run `kit memory search <terms>` " +
+            `to retrieve what was actually said instead of reconstructing it.${pending}`);
+    }
+    catch {
+        return ""; // fail-open: never block a prompt
+    }
+}
+/** Index the just-ended session. Returns count of newly indexed messages (fail-open). */
+export function runSessionEndIndex() {
+    try {
+        const db = openMemoryDb();
+        const res = indexClaudeTranscripts(db);
+        db.close();
+        return { messages: res.messages };
+    }
+    catch {
+        return { messages: 0 }; // fail-open
+    }
+}
+//# sourceMappingURL=hook.js.map

package/dist/memory/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/memory/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,oFAAoF;AACpF,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvB,0FAA0F;QAC1F,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,OAAO,GAAG,IAAI,SAAS,CAAC,MAAM,wCAAwC,MAAM,GAAG,IAAI,GAAG,CAAC;QACzF,CAAC;QACD,OAAO,CACL,uCAAuC,CAAC,CAAC,QAAQ,qBAAqB;YACtE,8EAA8E;YAC9E,mEAAmE,OAAO,EAAE,CAC7E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,kCAAkC;IAC/C,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY;IACtC,CAAC;AACH,CAAC"}

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

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

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,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.js.map

package/dist/memory/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/memory/install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,YAAY,GAAyC;IACzD,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,oCAAoC,EAAE;IAC5E,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,6BAA6B,EAAE;CAChE,CAAC;AAEF,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AACxF,CAAC;AAeD,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,qDAAqD;IAClE,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,CAAW;IAC9C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAmB,EAAE,OAAe;IAC7D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAe,qBAAqB,EAAE;IAEtC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACrC,IAAI,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YACvC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM;QAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAe,qBAAqB,EAAE;IAEtC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;QACpF,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YACtC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM;QAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

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

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