sandstream-kit 1.0.1 → 1.2.0

package/dist/memory/db.js

@@ -0,0 +1,275 @@
+/**
+ * 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 = 3;
+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 TABLE IF NOT EXISTS file_index (
+  path TEXT PRIMARY KEY,
+  mtime_ms INTEGER NOT NULL,
+  size INTEGER NOT NULL,
+  indexed_at TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
+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;
+}
+/** Has this file already been indexed at exactly this mtime + size? (incremental index) */
+export function isFileIndexed(db, path, mtimeMs, size) {
+    return !!db
+        .prepare("SELECT 1 FROM file_index WHERE path = ? AND mtime_ms = ? AND size = ?")
+        .get(path, mtimeMs, size);
+}
+/** Record (or refresh) a file's mtime + size after indexing it. */
+export function markFileIndexed(db, path, mtimeMs, size) {
+    db.prepare(`INSERT INTO file_index (path, mtime_ms, size, indexed_at)
+     VALUES (?, ?, ?, datetime('now'))
+     ON CONFLICT(path) DO UPDATE SET mtime_ms = excluded.mtime_ms, size = excluded.size, indexed_at = datetime('now')`).run(path, mtimeMs, size);
+}
+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);
+}
+/**
+ * Most-recent messages by wall-clock time (newest first) — the basis for session
+ * recovery (re-injecting "where you left off" after a compaction/resume). Unlike
+ * searchMessages this needs no query; pass opts.projectPath to scope to one repo.
+ * Skips empty-content rows so the recovery block stays signal, not blank tool turns.
+ */
+export function recentMessages(db, opts = {}) {
+    const limit = opts.limit ?? 10;
+    const params = [];
+    let where = "content IS NOT NULL AND content != ''";
+    if (opts.projectPath) {
+        where += " AND (cwd = ? OR cwd LIKE ?)";
+        params.push(opts.projectPath, `${opts.projectPath}/%`);
+    }
+    params.push(limit);
+    return db
+        .prepare(`SELECT id, uuid, session_id AS sessionId, role, content, timestamp
+       FROM messages
+       WHERE ${where}
+       ORDER BY timestamp DESC, id DESC
+       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/gemini.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { IndexResult } from "./parser.js";
+export declare function getGeminiTmpDir(): string;
+/** Walk ~/.gemini/tmp and index every conversation log/checkpoint. Idempotent + incremental. */
+export declare function indexGeminiSessions(db: DatabaseSync): IndexResult;

package/dist/memory/gemini.js

@@ -0,0 +1,176 @@
+/**
+ * kit memory — Gemini CLI transcript parser (multi-harness).
+ *
+ * Gemini CLI persists conversation state under ~/.gemini/tmp/<projectHash>/ via a
+ * few mechanisms. Formats verified against the google-gemini/gemini-cli source:
+ *   - logs.json — a JSON array of LogEntry records
+ *       { sessionId, messageId, timestamp, type, message }
+ *   - checkpoint files — either { history: Content[] } (modern) or a bare
+ *       Content[] (legacy), where Content = { role: 'user'|'model', parts:[{text}] }
+ *
+ * We index user + model turns from whichever are present, tag harness="gemini",
+ * synthesize stable uuids (idempotent), and STRUCTURALLY skip non-conversation
+ * JSON (e.g. file-snapshot checkpoints whose shape isn't Content[]). RAW +
+ * deterministic; no model calls.
+ *
+ * Limitation: Gemini keys directories by a one-way projectHash, so the real repo
+ * path isn't recoverable — Gemini messages carry no cwd and surface in `--global`
+ * recall rather than project-scoped search.
+ */
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, basename } from "node:path";
+import { insertMessage, upsertSession, isFileIndexed, markFileIndexed } from "./db.js";
+export function getGeminiTmpDir() {
+    const base = process.env.KIT_GEMINI_DIR ?? join(homedir(), ".gemini");
+    return join(base, "tmp");
+}
+function partsText(parts) {
+    if (!Array.isArray(parts))
+        return "";
+    return parts
+        .map((p) => p?.text ?? "")
+        .filter(Boolean)
+        .join("\n");
+}
+/** Coerce a parsed checkpoint to Content[], or null if it isn't a conversation. */
+function asHistory(parsed) {
+    if (Array.isArray(parsed)) {
+        const looksLikeContent = parsed.every((x) => x !== null && typeof x === "object" && ("role" in x || "parts" in x));
+        return looksLikeContent ? parsed : null;
+    }
+    if (parsed !== null && typeof parsed === "object") {
+        const h = parsed.history;
+        if (Array.isArray(h))
+            return h;
+    }
+    return null;
+}
+/** Map a Gemini role/sender to the store's user|assistant. */
+function roleOf(raw) {
+    return raw === "user" ? "user" : "assistant"; // 'model'/'gemini'/etc → assistant
+}
+function indexLogs(db, filepath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(filepath, "utf8"));
+    }
+    catch {
+        return { messages: 0 };
+    }
+    if (!Array.isArray(parsed))
+        return { messages: 0 };
+    let messages = 0;
+    let idx = 0;
+    for (const entry of parsed) {
+        const text = typeof entry?.message === "string" ? entry.message : "";
+        if (!text)
+            continue;
+        const sessionId = `gemini:${entry.sessionId ?? basename(filepath)}`;
+        upsertSession(db, { sessionId, harness: "gemini" });
+        const added = insertMessage(db, {
+            uuid: `gemini:log:${entry.sessionId ?? basename(filepath)}:${entry.messageId ?? idx}`,
+            sessionId,
+            type: roleOf(entry.type),
+            role: roleOf(entry.type),
+            content: text,
+            timestamp: entry.timestamp,
+        });
+        idx++;
+        if (added)
+            messages++;
+    }
+    return { messages };
+}
+function indexCheckpoint(db, filepath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(filepath, "utf8"));
+    }
+    catch {
+        return { messages: 0 };
+    }
+    const history = asHistory(parsed);
+    if (!history)
+        return { messages: 0 }; // not a conversation checkpoint — skip
+    const sessionId = `gemini-ckpt:${basename(filepath, ".json")}`;
+    upsertSession(db, { sessionId, harness: "gemini" });
+    let messages = 0;
+    history.forEach((c, idx) => {
+        if (c?.role !== "user" && c?.role !== "model")
+            return; // skip non-turn entries
+        const text = partsText(c.parts);
+        if (!text)
+            return;
+        const added = insertMessage(db, {
+            uuid: `gemini:ckpt:${basename(filepath)}:${idx}`,
+            sessionId,
+            type: roleOf(c.role),
+            role: roleOf(c.role),
+            content: text,
+        });
+        if (added)
+            messages++;
+    });
+    return { messages };
+}
+function* walkGeminiFiles(tmpDir) {
+    let hashes;
+    try {
+        hashes = readdirSync(tmpDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const h of hashes) {
+        if (!h.isDirectory())
+            continue;
+        const projDir = join(tmpDir, h.name);
+        const logs = join(projDir, "logs.json");
+        if (existsSync(logs))
+            yield { path: logs, kind: "logs" };
+        // checkpoint JSON lives at the project root and/or in a checkpoints/ subdir
+        for (const dir of [projDir, join(projDir, "checkpoints")]) {
+            let entries;
+            try {
+                entries = readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const e of entries) {
+                if (e.isFile() && e.name.endsWith(".json") && e.name !== "logs.json") {
+                    yield { path: join(dir, e.name), kind: "checkpoint" };
+                }
+            }
+        }
+    }
+}
+/** Walk ~/.gemini/tmp and index every conversation log/checkpoint. Idempotent + incremental. */
+export function indexGeminiSessions(db) {
+    const tmpDir = getGeminiTmpDir();
+    const result = { files: 0, sessions: 0, messages: 0, toolUses: 0, filesSkipped: 0 };
+    if (!existsSync(tmpDir))
+        return result;
+    for (const f of walkGeminiFiles(tmpDir)) {
+        let st;
+        try {
+            st = statSync(f.path);
+        }
+        catch {
+            continue;
+        }
+        const mtimeMs = Math.floor(st.mtimeMs);
+        if (isFileIndexed(db, f.path, mtimeMs, st.size)) {
+            result.filesSkipped++;
+            continue;
+        }
+        const counts = f.kind === "logs" ? indexLogs(db, f.path) : indexCheckpoint(db, f.path);
+        markFileIndexed(db, f.path, mtimeMs, st.size);
+        result.files++;
+        result.sessions++;
+        result.messages += counts.messages;
+    }
+    return result;
+}
+//# sourceMappingURL=gemini.js.map

package/dist/memory/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/memory/gemini.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,15 @@
+/** Reminder injected before every prompt. Empty string on any error (fail-open). */
+export declare function userPromptSubmitReminder(): string;
+/**
+ * SessionStart recovery — re-inject "where you left off" for THIS project after a
+ * resume/compact, so the agent regains continuity instead of starting blank. Pulls
+ * the most recent messages + open action items from the store. FAIL-OPEN and
+ * deterministic: empty string on any error or when there's nothing to recover.
+ */
+export declare function sessionStartRecovery(opts?: {
+    limit?: number;
+}): 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,84 @@
+/**
+ * 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, recentMessages } 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
+    }
+}
+/**
+ * SessionStart recovery — re-inject "where you left off" for THIS project after a
+ * resume/compact, so the agent regains continuity instead of starting blank. Pulls
+ * the most recent messages + open action items from the store. FAIL-OPEN and
+ * deterministic: empty string on any error or when there's nothing to recover.
+ */
+export function sessionStartRecovery(opts = {}) {
+    try {
+        const db = openMemoryDb();
+        const root = getCurrentProjectRoot();
+        const recent = recentMessages(db, { projectPath: root, limit: opts.limit ?? 6 });
+        const openItems = palList(db, { scope: basename(root) });
+        db.close();
+        if (recent.length === 0 && openItems.length === 0)
+            return "";
+        const lines = [`Picking up in ${basename(root)} — recent memory (newest first):`];
+        for (const m of recent) {
+            const who = m.role === "assistant" ? "assistant" : "you";
+            const text = (m.content ?? "").replace(/\s+/g, " ").trim().slice(0, 200);
+            if (text)
+                lines.push(`  · ${who}: ${text}`);
+        }
+        if (openItems.length > 0) {
+            const titles = openItems.slice(0, 3).map((p) => `${p.id} ${p.title}`).join("; ");
+            lines.push(`Open action items blocked on you: ${titles}${openItems.length > 3 ? " …" : ""}.`);
+        }
+        lines.push("Run `kit memory search <terms>` to pull more of what was actually said.");
+        return lines.join("\n");
+    }
+    catch {
+        return ""; // fail-open: never block a session start
+    }
+}
+/** 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":"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"}

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

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