sandstream-kit 1.0.1 → 1.2.0

package/dist/memory/continue.js

@@ -0,0 +1,116 @@
+/**
+ * kit memory — Continue.dev transcript parser (multi-harness).
+ *
+ * Continue stores each chat as a Session JSON at ~/.continue/sessions/<id>.json
+ * (an index lives at sessions.json, which we skip). Types verified against the
+ * continuedev/continue source (core/index.d.ts):
+ *
+ *   Session          { sessionId, title, workspaceDirectory, history: ChatHistoryItem[] }
+ *   ChatHistoryItem  { message: ChatMessage, ... }
+ *   ChatMessage      { role: 'user'|'assistant'|'system'|'thinking'|'tool', content }
+ *   MessageContent   string | ({ type:'text', text } | { type:'imageUrl', ... })[]
+ *
+ * We index user + assistant turns, tag harness="continue", and — because Session
+ * carries workspaceDirectory — set cwd so Continue recall is project-scoped like
+ * Claude Code (not global-only). RAW + deterministic; idempotent; no model calls.
+ */
+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 getContinueSessionsDir() {
+    const base = process.env.KIT_CONTINUE_DIR ?? join(homedir(), ".continue");
+    return join(base, "sessions");
+}
+/** Flatten Continue MessageContent (string or part array) to plain text. */
+function contentText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((p) => (p?.type === "text" ? (p.text ?? "") : ""))
+            .filter(Boolean)
+            .join("\n");
+    }
+    return "";
+}
+function indexFile(db, filepath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(filepath, "utf8"));
+    }
+    catch {
+        return { messages: 0 };
+    }
+    if (parsed === null || typeof parsed !== "object")
+        return { messages: 0 };
+    const session = parsed;
+    if (!Array.isArray(session.history))
+        return { messages: 0 }; // not a Session (e.g. the index)
+    const id = session.sessionId ?? basename(filepath, ".json");
+    const sessionId = `continue:${id}`;
+    const cwd = session.workspaceDirectory || undefined;
+    upsertSession(db, {
+        sessionId,
+        harness: "continue",
+        project: cwd ? basename(cwd) : undefined,
+    });
+    let messages = 0;
+    session.history.forEach((item, idx) => {
+        const role = item?.message?.role;
+        if (role !== "user" && role !== "assistant")
+            return; // skip system/thinking/tool
+        const text = contentText(item.message?.content);
+        if (!text)
+            return;
+        const added = insertMessage(db, {
+            uuid: `continue:${id}:${idx}`,
+            sessionId,
+            type: role,
+            role,
+            content: text,
+            cwd,
+        });
+        if (added)
+            messages++;
+    });
+    return { messages };
+}
+/** Walk ~/.continue/sessions and index every session JSON. Idempotent + incremental. */
+export function indexContinueSessions(db) {
+    const dir = getContinueSessionsDir();
+    const result = { files: 0, sessions: 0, messages: 0, toolUses: 0, filesSkipped: 0 };
+    if (!existsSync(dir))
+        return result;
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return result;
+    }
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith(".json") || e.name === "sessions.json")
+            continue;
+        const filepath = join(dir, e.name);
+        let st;
+        try {
+            st = statSync(filepath);
+        }
+        catch {
+            continue;
+        }
+        const mtimeMs = Math.floor(st.mtimeMs);
+        if (isFileIndexed(db, filepath, mtimeMs, st.size)) {
+            result.filesSkipped++;
+            continue;
+        }
+        const counts = indexFile(db, filepath);
+        markFileIndexed(db, filepath, mtimeMs, st.size);
+        result.files++;
+        result.sessions++;
+        result.messages += counts.messages;
+    }
+    return result;
+}
+//# sourceMappingURL=continue.js.map

package/dist/memory/continue.js.map

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

package/dist/memory/db 2.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 2.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%202.js.map

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

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

package/dist/memory/db.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 = 3;
+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;
+/** Has this file already been indexed at exactly this mtime + size? (incremental index) */
+export declare function isFileIndexed(db: DatabaseSync, path: string, mtimeMs: number, size: number): boolean;
+/** Record (or refresh) a file's mtime + size after indexing it. */
+export declare function markFileIndexed(db: DatabaseSync, path: string, mtimeMs: number, size: number): void;
+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[];
+/**
+ * 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 declare function recentMessages(db: DatabaseSync, opts?: SearchOptions): SearchHit[];
+export declare function getStats(db: DatabaseSync): MemoryStats;