pi-para 0.5.2

package/dist/scripts/bulk-link-fix.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env tsx
+/**
+ * One-time bulk fix: auto-link slugs, normalize tags, sync frontmatter.links
+ * across all wiki pages.
+ *
+ * Usage: npx tsx src/scripts/bulk-link-fix.ts [--dry-run]
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { listPages, readPage, writePage, } from "../wiki.js";
+import { autoLinkSlugs, syncFrontmatterLinks } from "../link-utils.js";
+import { normalizeTags, normalizeScopes } from "../tag-registry.js";
+const WIKI_DIR = join(homedir(), ".pi", "wiki");
+const dryRun = process.argv.includes("--dry-run");
+async function main() {
+    console.log(`\n📚 Bulk Wiki Fix — ${dryRun ? "DRY RUN" : "LIVE"}`);
+    console.log(`   Wiki: ${WIKI_DIR}\n`);
+    // Load all pages
+    const refs = await listPages(WIKI_DIR);
+    const pages = [];
+    for (const ref of refs) {
+        const page = await readPage(WIKI_DIR, ref.category, ref.slug);
+        if (page)
+            pages.push(page);
+    }
+    const allSlugs = new Set(pages.map(p => p.slug));
+    console.log(`   Found ${pages.length} pages, ${allSlugs.size} unique slugs\n`);
+    let linksAdded = 0;
+    let tagsNormalized = 0;
+    let frontmatterSynced = 0;
+    let pagesChanged = 0;
+    for (const page of pages) {
+        const originalBody = page.body;
+        const originalTags = [...page.frontmatter.tags];
+        const originalLinks = [...page.frontmatter.links];
+        const originalScope = [...page.frontmatter.scope];
+        // 1. Normalize scopes first (tags depend on scope)
+        const newScope = normalizeScopes(page.frontmatter.scope);
+        // 2. Auto-link slug mentions in body
+        let newBody = autoLinkSlugs(originalBody, allSlugs, page.slug);
+        // 3. Sync frontmatter.links from body [[wikilinks]]
+        const newLinks = syncFrontmatterLinks(newBody);
+        // 4. Normalize tags (using normalized scope for dedup)
+        const newTags = normalizeTags(page.frontmatter.tags, newScope);
+        // Check what changed
+        const bodyChanged = newBody !== originalBody;
+        const linksChanged = JSON.stringify(newLinks.sort()) !== JSON.stringify(originalLinks.sort());
+        const tagsChanged = JSON.stringify(newTags) !== JSON.stringify(originalTags.sort());
+        const scopeChanged = JSON.stringify(newScope) !== JSON.stringify(originalScope.sort());
+        if (!bodyChanged && !linksChanged && !tagsChanged && !scopeChanged)
+            continue;
+        pagesChanged++;
+        const addedLinksCount = newLinks.filter(l => !originalLinks.includes(l)).length;
+        linksAdded += addedLinksCount;
+        if (tagsChanged)
+            tagsNormalized++;
+        if (linksChanged)
+            frontmatterSynced++;
+        // Report
+        const changes = [];
+        if (scopeChanged) {
+            changes.push(`scope: [${originalScope.join(", ")}] → [${newScope.join(", ")}]`);
+        }
+        if (bodyChanged) {
+            const addedLinks = newLinks.filter(l => !originalLinks.includes(l));
+            changes.push(`+${addedLinks.length} wikilinks: ${addedLinks.join(", ")}`);
+        }
+        if (tagsChanged) {
+            changes.push(`tags: [${originalTags.join(", ")}] → [${newTags.join(", ")}]`);
+        }
+        if (linksChanged && !bodyChanged) {
+            changes.push(`frontmatter.links synced`);
+        }
+        console.log(`  ${dryRun ? "WOULD FIX" : "FIXED"} ${page.category}/${page.slug}`);
+        for (const c of changes) {
+            console.log(`    → ${c}`);
+        }
+        if (!dryRun) {
+            const updatedPage = {
+                ...page,
+                body: newBody,
+                frontmatter: {
+                    ...page.frontmatter,
+                    scope: newScope,
+                    tags: newTags,
+                    links: newLinks,
+                    updated: new Date().toISOString(),
+                },
+            };
+            await writePage(WIKI_DIR, updatedPage);
+        }
+    }
+    console.log(`\n━━━ Summary ━━━`);
+    console.log(`  Pages changed:      ${pagesChanged} / ${pages.length}`);
+    console.log(`  Wikilinks added:    ${linksAdded}`);
+    console.log(`  Tags normalized:    ${tagsNormalized}`);
+    console.log(`  Frontmatter synced: ${frontmatterSynced}`);
+    if (dryRun)
+        console.log(`\n  (dry run — no files modified, re-run without --dry-run to apply)`);
+    console.log();
+}
+main().catch(err => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=bulk-link-fix.js.map

package/dist/scripts/bulk-link-fix.js.map

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

package/dist/session-tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Session exploration tools for the Agent.
+ *
+ * These tools give the Agent the ability to explore a session file
+ * without loading the entire thing into the prompt — the TypeScript
+ * equivalent of RLM's REPL-based exploration.
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+interface SessionMessage {
+    role: string;
+    text: string;
+    toolCalls: string[];
+    charOffset: number;
+}
+export interface LoadedSession {
+    messages: SessionMessage[];
+    serialized: string;
+    stats: {
+        totalMessages: number;
+        userMessages: number;
+        assistantMessages: number;
+        toolResults: number;
+        toolCalls: number;
+        totalChars: number;
+        compactionSummaries: number;
+    };
+}
+/** Load and pre-process a session JSONL file. */
+export declare function loadSession(sessionPath: string): LoadedSession;
+/** Create session exploration tools bound to a loaded session. */
+export declare function createSessionTools(session: LoadedSession): AgentTool[];
+export {};
+//# sourceMappingURL=session-tools.d.ts.map

package/dist/session-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tools.d.ts","sourceRoot":"","sources":["../src/session-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAI9E,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAyF9D;AAgBD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,CAqHtE"}

package/dist/session-tools.js

@@ -0,0 +1,211 @@
+/**
+ * Session exploration tools for the Agent.
+ *
+ * These tools give the Agent the ability to explore a session file
+ * without loading the entire thing into the prompt — the TypeScript
+ * equivalent of RLM's REPL-based exploration.
+ */
+import { readFileSync } from "node:fs";
+import { Type } from "typebox";
+/** Load and pre-process a session JSONL file. */
+export function loadSession(sessionPath) {
+    const raw = readFileSync(sessionPath, "utf-8");
+    const lines = raw.split("\n").filter((l) => l.trim());
+    const messages = [];
+    const parts = [];
+    let charOffset = 0;
+    let compactionSummaries = 0;
+    let toolCallCount = 0;
+    for (const line of lines) {
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry.type === "compaction" && typeof entry.summary === "string") {
+            const text = `[Compaction Summary]:\n${entry.summary}`;
+            parts.push(text);
+            messages.push({ role: "compaction", text, toolCalls: [], charOffset });
+            charOffset += text.length + 2;
+            compactionSummaries++;
+            continue;
+        }
+        if (entry.type !== "message")
+            continue;
+        const msg = entry.message;
+        if (!msg)
+            continue;
+        const role = msg.role;
+        if (!["user", "assistant", "toolResult"].includes(role))
+            continue;
+        const content = msg.content;
+        let text = "";
+        const toolCalls = [];
+        if (typeof content === "string") {
+            text = content;
+        }
+        else if (Array.isArray(content)) {
+            const textParts = [];
+            for (const block of content) {
+                if (typeof block !== "object" || block === null)
+                    continue;
+                const b = block;
+                if (b.type === "text" && typeof b.text === "string") {
+                    textParts.push(b.text);
+                }
+                else if (b.type === "toolCall" && typeof b.name === "string") {
+                    const argsStr = JSON.stringify(b.arguments ?? {});
+                    toolCalls.push(`${b.name}(${argsStr.length > 300 ? argsStr.slice(0, 300) + "..." : argsStr})`);
+                    toolCallCount++;
+                }
+            }
+            text = textParts.join("\n");
+            if (toolCalls.length > 0) {
+                text += `\n[Tools]: ${toolCalls.join("; ")}`;
+            }
+        }
+        if (!text.trim())
+            continue;
+        // Truncate tool results
+        if (role === "toolResult" && text.length > 1000) {
+            text = text.slice(0, 1000) + "\n[truncated]";
+        }
+        const label = { user: "User", assistant: "Assistant", toolResult: "Tool" }[role] ?? role;
+        const formatted = `[${label}]: ${text}`;
+        parts.push(formatted);
+        messages.push({ role, text: formatted, toolCalls, charOffset });
+        charOffset += formatted.length + 2;
+    }
+    const serialized = parts.join("\n\n");
+    return {
+        messages,
+        serialized,
+        stats: {
+            totalMessages: messages.length,
+            userMessages: messages.filter((m) => m.role === "user").length,
+            assistantMessages: messages.filter((m) => m.role === "assistant").length,
+            toolResults: messages.filter((m) => m.role === "toolResult").length,
+            toolCalls: toolCallCount,
+            totalChars: serialized.length,
+            compactionSummaries,
+        },
+    };
+}
+// -- Tool definitions --------------------------------------------------------
+const SliceParams = Type.Object({
+    start: Type.Number({ description: "Start character offset" }),
+    end: Type.Number({ description: "End character offset" }),
+});
+const SearchParams = Type.Object({
+    query: Type.String({ description: "Text to search for (case-insensitive)" }),
+    maxResults: Type.Optional(Type.Number({ description: "Max results (default 10)" })),
+});
+const StatsParams = Type.Object({});
+/** Create session exploration tools bound to a loaded session. */
+export function createSessionTools(session) {
+    const sessionSlice = {
+        name: "session_slice",
+        label: "Session Slice",
+        description: `Read a slice of the session text (${session.stats.totalChars} chars total). Use to explore specific sections.`,
+        parameters: SliceParams,
+        execute: async (_id, params) => {
+            const start = Math.max(0, params.start);
+            const end = Math.min(session.serialized.length, params.end);
+            const slice = session.serialized.slice(start, end);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `[chars ${start}-${end} of ${session.serialized.length}]\n\n${slice}`,
+                    },
+                ],
+                details: { start, end, length: slice.length },
+            };
+        },
+    };
+    const sessionSearch = {
+        name: "session_search",
+        label: "Session Search",
+        description: "Search the session for a keyword. Returns matching sections with character offsets.",
+        parameters: SearchParams,
+        execute: async (_id, params) => {
+            const query = params.query.toLowerCase();
+            const maxResults = params.maxResults ?? 10;
+            const matches = [];
+            const text = session.serialized.toLowerCase();
+            let pos = 0;
+            while (matches.length < maxResults) {
+                const idx = text.indexOf(query, pos);
+                if (idx === -1)
+                    break;
+                // Extract context around match
+                const contextStart = Math.max(0, idx - 200);
+                const contextEnd = Math.min(session.serialized.length, idx + query.length + 200);
+                matches.push({
+                    offset: idx,
+                    context: session.serialized.slice(contextStart, contextEnd),
+                });
+                pos = idx + query.length;
+            }
+            if (matches.length === 0) {
+                return {
+                    content: [{ type: "text", text: `No matches for "${params.query}"` }],
+                    details: { matchCount: 0 },
+                };
+            }
+            const resultText = matches
+                .map((m, i) => `Match ${i + 1} (offset ${m.offset}):\n${m.context}\n`)
+                .join("\n---\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${matches.length} match(es) for "${params.query}":\n\n${resultText}`,
+                    },
+                ],
+                details: { matchCount: matches.length },
+            };
+        },
+    };
+    const sessionStats = {
+        name: "session_stats",
+        label: "Session Stats",
+        description: "Get session overview: message counts, size, topics.",
+        parameters: StatsParams,
+        execute: async () => {
+            const s = session.stats;
+            // Extract user message topics (first 100 chars of each, cap at 50)
+            const allUserMsgs = session.messages.filter((m) => m.role === "user");
+            const displayLimit = 50;
+            const userTopics = allUserMsgs
+                .slice(0, displayLimit)
+                .map((m) => m.text.replace(/^\[User\]: /, "").slice(0, 100))
+                .map((t, i) => `  ${i + 1}. ${t}`);
+            if (allUserMsgs.length > displayLimit) {
+                userTopics.push(`  ... and ${allUserMsgs.length - displayLimit} more user messages. Use session_search to find specific topics.`);
+            }
+            const sizeLabel = s.totalChars > 1_000_000 ? `${(s.totalChars / 1_000_000).toFixed(1)}M`
+                : s.totalChars > 1_000 ? `${(s.totalChars / 1_000).toFixed(0)}K`
+                    : `${s.totalChars}`;
+            const text = [
+                `Session: ${sizeLabel} chars, ${s.totalMessages} messages`,
+                `  User: ${s.userMessages}, Assistant: ${s.assistantMessages}, Tool results: ${s.toolResults}`,
+                `  Tool calls: ${s.toolCalls}, Compaction summaries: ${s.compactionSummaries}`,
+                "",
+                "Strategy: Use session_search to find topics, then session_slice to read details.",
+                `Valid slice range: 0 to ${s.totalChars}`,
+                "",
+                "User messages (topics):",
+                ...userTopics,
+            ].join("\n");
+            return {
+                content: [{ type: "text", text }],
+                details: s,
+            };
+        },
+    };
+    return [sessionSlice, sessionSearch, sessionStats];
+}
+//# sourceMappingURL=session-tools.js.map

package/dist/session-tools.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SQLite state management for processed sessions.
+ * Tracks which sessions have been processed, their content hash,
+ * and what pages were created/updated.
+ */
+export interface PageSummary {
+    slug: string;
+    category: string;
+    scope: string[];
+    tags: string[];
+    firstParagraph: string;
+    updatedAt: string;
+}
+export interface ProcessedSession {
+    sessionPath: string;
+    contentHash: string;
+    processedAt: string;
+    scope: string;
+    pagesCreated: string[];
+    pagesUpdated: string[];
+    error: string | null;
+}
+export declare class StateDB {
+    private db;
+    constructor(wikiDir: string);
+    private migrate;
+    /** Check if a session file has already been processed with the same content. */
+    isProcessed(sessionPath: string): boolean;
+    /** Get the stored hash for a session (or null if not processed). */
+    getHash(sessionPath: string): string | null;
+    /** Record a successfully processed session. */
+    recordSuccess(sessionPath: string, scope: string, pagesCreated: string[], pagesUpdated: string[]): void;
+    /** Record a failed processing attempt. */
+    recordFailure(sessionPath: string, scope: string, error: string): void;
+    /** Get all failed sessions for retry. */
+    getFailed(): ProcessedSession[];
+    /** Get processing history, optionally filtered by scope. */
+    getHistory(scope?: string, limit?: number): ProcessedSession[];
+    /** Get/set daemon state values. */
+    getState(key: string): string | null;
+    setState(key: string, value: string): void;
+    /** Upsert a page summary in the cache. */
+    upsertPageSummary(slug: string, category: string, scope: string[], tags: string[], firstParagraph: string, updatedAt: string): void;
+    /** Get all page summaries, optionally filtered by scope. */
+    getPageSummaries(scope?: {
+        name: string;
+        include: string[];
+        exclude: string[];
+    }): PageSummary[];
+    /** Delete a page summary from the cache. */
+    deletePageSummary(slug: string): void;
+    close(): void;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAoB;gBAElB,OAAO,EAAE,MAAM;IAO3B,OAAO,CAAC,OAAO;IA0Bf,gFAAgF;IAChF,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAUzC,oEAAoE;IACpE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO3C,+CAA+C;IAC/C,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,MAAM,EAAE,GACrB,IAAI;IAkBP,0CAA0C;IAC1C,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWtE,yCAAyC;IACzC,SAAS,IAAI,gBAAgB,EAAE;IAe/B,4DAA4D;IAC5D,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,gBAAgB,EAAE;IAiBlE,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOpC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1C,0CAA0C;IAC1C,iBAAiB,CACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EAAE,EACd,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,IAAI;IAiBP,4DAA4D;IAC5D,gBAAgB,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,WAAW,EAAE;IAoC/F,4CAA4C;IAC5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMrC,KAAK,IAAI,IAAI;CAGd"}

package/dist/state.js

@@ -0,0 +1,176 @@
+/**
+ * SQLite state management for processed sessions.
+ * Tracks which sessions have been processed, their content hash,
+ * and what pages were created/updated.
+ */
+import Database from "better-sqlite3";
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+export class StateDB {
+    db;
+    constructor(wikiDir) {
+        const dbPath = join(wikiDir, ".daemon.sqlite");
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS processed_sessions (
+        session_path TEXT PRIMARY KEY,
+        content_hash TEXT NOT NULL,
+        processed_at TEXT NOT NULL,
+        scope TEXT,
+        pages_created TEXT DEFAULT '[]',
+        pages_updated TEXT DEFAULT '[]',
+        error TEXT
+      );
+      CREATE TABLE IF NOT EXISTS daemon_state (
+        key TEXT PRIMARY KEY,
+        value TEXT
+      );
+      CREATE TABLE IF NOT EXISTS page_summaries (
+        slug TEXT PRIMARY KEY,
+        category TEXT NOT NULL,
+        scope_json TEXT NOT NULL DEFAULT '[]',
+        tags_json TEXT NOT NULL DEFAULT '[]',
+        first_paragraph TEXT NOT NULL DEFAULT '',
+        updated_at TEXT NOT NULL
+      );
+    `);
+    }
+    /** Check if a session file has already been processed with the same content. */
+    isProcessed(sessionPath) {
+        const row = this.db
+            .prepare("SELECT content_hash FROM processed_sessions WHERE session_path = ?")
+            .get(sessionPath);
+        if (!row)
+            return false;
+        const currentHash = hashFile(sessionPath);
+        return row.content_hash === currentHash;
+    }
+    /** Get the stored hash for a session (or null if not processed). */
+    getHash(sessionPath) {
+        const row = this.db
+            .prepare("SELECT content_hash FROM processed_sessions WHERE session_path = ?")
+            .get(sessionPath);
+        return row?.content_hash ?? null;
+    }
+    /** Record a successfully processed session. */
+    recordSuccess(sessionPath, scope, pagesCreated, pagesUpdated) {
+        const hash = hashFile(sessionPath);
+        this.db
+            .prepare(`
+        INSERT OR REPLACE INTO processed_sessions
+        (session_path, content_hash, processed_at, scope, pages_created, pages_updated, error)
+        VALUES (?, ?, ?, ?, ?, ?, NULL)
+      `)
+            .run(sessionPath, hash, new Date().toISOString(), scope, JSON.stringify(pagesCreated), JSON.stringify(pagesUpdated));
+    }
+    /** Record a failed processing attempt. */
+    recordFailure(sessionPath, scope, error) {
+        const hash = hashFile(sessionPath);
+        this.db
+            .prepare(`
+        INSERT OR REPLACE INTO processed_sessions
+        (session_path, content_hash, processed_at, scope, pages_created, pages_updated, error)
+        VALUES (?, ?, ?, ?, '[]', '[]', ?)
+      `)
+            .run(sessionPath, hash, new Date().toISOString(), scope, error);
+    }
+    /** Get all failed sessions for retry. */
+    getFailed() {
+        const rows = this.db
+            .prepare("SELECT * FROM processed_sessions WHERE error IS NOT NULL")
+            .all();
+        return rows.map(rowToSession);
+    }
+    /** Get processing history, optionally filtered by scope. */
+    getHistory(scope, limit = 20) {
+        const sql = scope
+            ? "SELECT * FROM processed_sessions WHERE scope = ? ORDER BY processed_at DESC LIMIT ?"
+            : "SELECT * FROM processed_sessions ORDER BY processed_at DESC LIMIT ?";
+        const params = scope ? [scope, limit] : [limit];
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(rowToSession);
+    }
+    /** Get/set daemon state values. */
+    getState(key) {
+        const row = this.db
+            .prepare("SELECT value FROM daemon_state WHERE key = ?")
+            .get(key);
+        return row?.value ?? null;
+    }
+    setState(key, value) {
+        this.db
+            .prepare("INSERT OR REPLACE INTO daemon_state (key, value) VALUES (?, ?)")
+            .run(key, value);
+    }
+    /** Upsert a page summary in the cache. */
+    upsertPageSummary(slug, category, scope, tags, firstParagraph, updatedAt) {
+        this.db
+            .prepare(`
+        INSERT OR REPLACE INTO page_summaries
+        (slug, category, scope_json, tags_json, first_paragraph, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?)
+      `)
+            .run(slug, category, JSON.stringify(scope), JSON.stringify(tags), firstParagraph, updatedAt);
+    }
+    /** Get all page summaries, optionally filtered by scope. */
+    getPageSummaries(scope) {
+        const rows = this.db
+            .prepare("SELECT * FROM page_summaries ORDER BY updated_at DESC")
+            .all();
+        const summaries = rows.map((row) => ({
+            slug: row.slug,
+            category: row.category,
+            scope: JSON.parse(row.scope_json || "[]"),
+            tags: JSON.parse(row.tags_json || "[]"),
+            firstParagraph: row.first_paragraph,
+            updatedAt: row.updated_at,
+        }));
+        if (!scope)
+            return summaries;
+        // Filter by scope: include global + matching, exclude excluded
+        return summaries.filter((s) => {
+            if (scope.exclude.length > 0 &&
+                s.scope.some((tag) => scope.exclude.includes(tag))) {
+                return false;
+            }
+            if (s.scope.includes("global"))
+                return true;
+            return s.scope.some((tag) => scope.include.includes(tag));
+        });
+    }
+    /** Delete a page summary from the cache. */
+    deletePageSummary(slug) {
+        this.db
+            .prepare("DELETE FROM page_summaries WHERE slug = ?")
+            .run(slug);
+    }
+    close() {
+        this.db.close();
+    }
+}
+function hashFile(filePath) {
+    try {
+        const content = readFileSync(filePath);
+        return createHash("sha256").update(content).digest("hex");
+    }
+    catch {
+        return "missing";
+    }
+}
+function rowToSession(row) {
+    return {
+        sessionPath: row.session_path,
+        contentHash: row.content_hash,
+        processedAt: row.processed_at,
+        scope: row.scope ?? "",
+        pagesCreated: JSON.parse(row.pages_created || "[]"),
+        pagesUpdated: JSON.parse(row.pages_updated || "[]"),
+        error: row.error,
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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