pi-para 0.5.2

package/dist/daemon.js

@@ -0,0 +1,226 @@
+/**
+ * Main daemon loop — watches for completed sessions and processes them.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { openStore, closeStore } from "./store.js";
+import { StateDB } from "./state.js";
+import { RegistryWatcher } from "./watcher.js";
+import { processSession } from "./processor.js";
+import { runMaintenance } from "./maintainer.js";
+import { startServer } from "./webui/server.js";
+export class Daemon {
+    config;
+    state;
+    watcher;
+    store = null;
+    queue = [];
+    processing = false;
+    running = false;
+    maintenanceTimer = null;
+    maintenanceRunning = false;
+    webServer = null;
+    constructor(config) {
+        this.config = config;
+        this.state = new StateDB(config.wikiDir);
+        this.watcher = new RegistryWatcher(config.wikiDir, (entries) => this.onNewEntries(entries), config.pollIntervalMs ?? 5000);
+    }
+    /** Start the daemon. */
+    async start() {
+        console.log(`[daemon] Starting — wiki: ${this.config.wikiDir}`);
+        // Open qmd store
+        try {
+            this.store = await openStore(this.config.wikiDir);
+            console.log("[daemon] qmd store opened");
+        }
+        catch (err) {
+            console.error(`[daemon] Failed to open store: ${err instanceof Error ? err.message : err}`);
+            this.store = null;
+        }
+        this.running = true;
+        this.state.setState("daemon_started_at", new Date().toISOString());
+        this.state.setState("daemon_pid", String(process.pid));
+        // Start watching
+        this.watcher.start();
+        // Process any unprocessed sessions from registry
+        const existing = this.watcher.getAllEntries();
+        const unprocessed = existing.filter((e) => !this.state.isProcessed(e.sessionPath));
+        if (unprocessed.length > 0) {
+            console.log(`[daemon] Found ${unprocessed.length} unprocessed session(s)`);
+            this.onNewEntries(unprocessed);
+        }
+        // Start periodic maintenance (link discovery + lint)
+        const maintenanceMs = this.config.maintenanceIntervalMs ?? 30 * 60 * 1000;
+        this.maintenanceTimer = setInterval(() => this.runMaintenancePass(), maintenanceMs);
+        // Run first maintenance after a delay to let the store warm up
+        setTimeout(() => this.runMaintenancePass(), 60_000);
+        // Start web wiki server if enabled
+        if (this.config.webWiki?.enabled) {
+            try {
+                this.webServer = startServer(this.config.wikiDir, this.store, this.config.webWiki);
+                console.log(`[daemon] Web wiki: ${this.webServer.url}`);
+            }
+            catch (err) {
+                console.error(`[daemon] Web wiki failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        console.log(`[daemon] Running (maintenance every ${Math.round(maintenanceMs / 60000)}m). Press Ctrl+C to stop.`);
+    }
+    /** Stop the daemon. */
+    async stop() {
+        console.log("[daemon] Stopping...");
+        this.running = false;
+        this.watcher.stop();
+        if (this.maintenanceTimer) {
+            clearInterval(this.maintenanceTimer);
+            this.maintenanceTimer = null;
+        }
+        // Stop web wiki server
+        if (this.webServer) {
+            try {
+                await this.webServer.close();
+                console.log("[daemon] Web wiki stopped");
+            }
+            catch { }
+            this.webServer = null;
+        }
+        if (this.store) {
+            try {
+                await closeStore(this.store);
+            }
+            catch { }
+            this.store = null;
+        }
+        this.state.close();
+        console.log("[daemon] Stopped.");
+    }
+    /** Get the web server URL (if running). */
+    getWebUrl() {
+        return this.webServer?.url ?? null;
+    }
+    /** Process a single session file (for CLI `process` command). */
+    async processOne(sessionPath) {
+        if (!existsSync(sessionPath)) {
+            console.error(`[daemon] Session file not found: ${sessionPath}`);
+            return;
+        }
+        if (!this.store) {
+            try {
+                this.store = await openStore(this.config.wikiDir);
+            }
+            catch (err) {
+                console.error(`[daemon] Failed to open store: ${err instanceof Error ? err.message : err}`);
+                return;
+            }
+        }
+        const scope = detectScopeFromPath(sessionPath);
+        console.log(`[daemon] Processing: ${sessionPath} (scope: ${scope})`);
+        try {
+            const result = await processSession(sessionPath, this.config.wikiDir, this.store, scope, this.config.model, this.config.getApiKey);
+            if (result.skipped) {
+                console.log(`[daemon] Skipped: ${result.reason}`);
+                this.state.recordSuccess(sessionPath, scope, [], []);
+            }
+            else {
+                console.log(`[daemon] Done: ${result.pagesCreated.length} created, ${result.pagesUpdated.length} updated`);
+                this.state.recordSuccess(sessionPath, scope, result.pagesCreated, result.pagesUpdated);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[daemon] Failed: ${msg}`);
+            this.state.recordFailure(sessionPath, scope, msg);
+        }
+    }
+    /** Handle new entries from the registry watcher. */
+    onNewEntries(entries) {
+        // Filter already-processed
+        const newEntries = entries.filter((e) => existsSync(e.sessionPath) && !this.state.isProcessed(e.sessionPath));
+        if (newEntries.length === 0)
+            return;
+        console.log(`[daemon] Queued ${newEntries.length} session(s) for processing`);
+        this.queue.push(...newEntries);
+        this.processQueue();
+    }
+    /** Process queued sessions sequentially. */
+    async processQueue() {
+        if (this.processing || !this.running)
+            return;
+        this.processing = true;
+        while (this.queue.length > 0 && this.running) {
+            const entry = this.queue.shift();
+            await this.processOne(entry.sessionPath);
+        }
+        this.processing = false;
+    }
+    /** Run periodic maintenance via LLM agent. */
+    async runMaintenancePass() {
+        if (this.maintenanceRunning || !this.running || !this.store)
+            return;
+        this.maintenanceRunning = true;
+        try {
+            console.log("[daemon] Running maintenance agent...");
+            const result = await runMaintenance(this.config.wikiDir, this.store, this.config.model, this.config.getApiKey);
+            console.log(`[daemon] Maintenance done: ${result.pagesUpdated} updated, ${result.pagesMerged} merged`);
+            if (result.summary) {
+                // Log first 200 chars of summary
+                console.log(`[daemon] Summary: ${result.summary.slice(0, 200)}`);
+            }
+        }
+        catch (err) {
+            console.error(`[daemon] Maintenance error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        this.maintenanceRunning = false;
+    }
+    /** Get processing history. */
+    getHistory(scope, limit) {
+        return this.state.getHistory(scope, limit);
+    }
+    /** Get failed sessions. */
+    getFailed() {
+        return this.state.getFailed();
+    }
+    /** Retry all failed sessions. */
+    async retryFailed() {
+        const failed = this.state.getFailed();
+        if (failed.length === 0) {
+            console.log("[daemon] No failed sessions to retry.");
+            return;
+        }
+        console.log(`[daemon] Retrying ${failed.length} failed session(s)...`);
+        for (const session of failed) {
+            await this.processOne(session.sessionPath);
+        }
+    }
+}
+/** Extract project scope from session path or header. */
+function detectScopeFromPath(sessionPath) {
+    // 1. Try reading the session header — most reliable, has the real cwd
+    try {
+        const { readFileSync } = require("node:fs");
+        const firstLine = readFileSync(sessionPath, "utf-8").split("\n")[0];
+        const header = JSON.parse(firstLine);
+        if (header.cwd) {
+            const parts = header.cwd.split("/");
+            return parts[parts.length - 1] ?? "unknown";
+        }
+    }
+    catch { }
+    // 2. Fallback: decode from directory name
+    // Path format: ~/.pi/agent/sessions/--home-ubuntu-projects-pi-mono--/file.jsonl
+    // The dir name encodes the cwd path with / replaced by -
+    // But project names can contain hyphens, so we can't just replace all - with /
+    // Instead, find the last segment after "projects-" which is the project name
+    const dirName = sessionPath.split("/").slice(-2, -1)[0] ?? "";
+    if (dirName.startsWith("--") && dirName.endsWith("--")) {
+        const inner = dirName.slice(2, -2); // e.g. "home-ubuntu-projects-agent-board"
+        // Look for "projects-" marker — everything after it is the project name
+        const projectsIdx = inner.indexOf("projects-");
+        if (projectsIdx >= 0) {
+            return inner.slice(projectsIdx + "projects-".length); // "agent-board"
+        }
+    }
+    return "unknown";
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAchD,MAAM,OAAO,MAAM;IACT,MAAM,CAAe;IACrB,KAAK,CAAU;IACf,OAAO,CAAkB;IACzB,KAAK,GAAoB,IAAI,CAAC;IAC9B,KAAK,GAAuB,EAAE,CAAC;IAC/B,UAAU,GAAG,KAAK,CAAC;IACnB,OAAO,GAAG,KAAK,CAAC;IAChB,gBAAgB,GAA0C,IAAI,CAAC;IAC/D,kBAAkB,GAAG,KAAK,CAAC;IAC3B,SAAS,GAAuD,IAAI,CAAC;IAE7E,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAChC,MAAM,CAAC,OAAO,EACd,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EACvC,MAAM,CAAC,cAAc,IAAI,IAAI,CAC9B,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAEhE,iBAAiB;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5F,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAEvD,iBAAiB;QACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAErB,iDAAiD;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QACnF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,kBAAkB,WAAW,CAAC,MAAM,yBAAyB,CAAC,CAAC;YAC3E,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QAED,qDAAqD;QACrD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC1E,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,aAAa,CAAC,CAAC;QACpF,+DAA+D;QAC/D,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,MAAM,CAAC,CAAC;QAEpD,mCAAmC;QACnC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnF,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACnH,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACrC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,SAAS;QACP,OAAO,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,UAAU,CAAC,WAAmB;QAClC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,oCAAoC,WAAW,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC5F,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,wBAAwB,WAAW,YAAY,KAAK,GAAG,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,WAAW,EACX,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,IAAI,CAAC,KAAK,EACV,KAAK,EACL,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,IAAI,CAAC,MAAM,CAAC,SAAS,CACtB,CAAC;YAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,YAAY,CAAC,MAAM,aAAa,MAAM,CAAC,YAAY,CAAC,MAAM,UAAU,CAAC,CAAC;gBAC3G,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,oDAAoD;IAC5C,YAAY,CAAC,OAA2B;QAC9C,2BAA2B;QAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAC3E,CAAC;QAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEpC,OAAO,CAAC,GAAG,CAAC,mBAAmB,UAAU,CAAC,MAAM,4BAA4B,CAAC,CAAC;QAC9E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC/B,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,4CAA4C;IACpC,KAAK,CAAC,YAAY;QACxB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;YAClC,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,8CAA8C;IACtC,KAAK,CAAC,kBAAkB;QAC9B,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACpE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAE/B,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,IAAI,CAAC,MAAM,CAAC,SAAS,CACtB,CAAC;YACF,OAAO,CAAC,GAAG,CACT,8BAA8B,MAAM,CAAC,YAAY,aAAa,MAAM,CAAC,WAAW,SAAS,CAC1F,CAAC;YACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,iCAAiC;gBACjC,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;IAClC,CAAC;IAED,8BAA8B;IAC9B,UAAU,CAAC,KAAc,EAAE,KAAc;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,2BAA2B;IAC3B,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,uBAAuB,CAAC,CAAC;QACvE,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;CACF;AAED,yDAAyD;AACzD,SAAS,mBAAmB,CAAC,WAAmB;IAC9C,sEAAsE;IACtE,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,0CAA0C;IAC1C,gFAAgF;IAChF,yDAAyD;IACzD,+EAA+E;IAC/E,6EAA6E;IAC7E,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,0CAA0C;QAC9E,wEAAwE;QACxE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB;QACxE,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/frontmatter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * YAML frontmatter parsing and serialization for wiki pages.
+ *
+ * Handles the `---\n...\n---` frontmatter block in markdown files.
+ * Uses the `yaml` package for robust parsing. Preserves unknown fields.
+ */
+import type { PageFrontmatter } from "./wiki.js";
+/** Current schema version. Bump when frontmatter/body format changes. */
+export declare const CURRENT_SCHEMA_VERSION = 1;
+/** A migration transforms pages from one schema version to the next. */
+export interface Migration {
+    from: number;
+    to: number;
+    migrate: (fm: Record<string, unknown>, body: string) => {
+        fm: Record<string, unknown>;
+        body: string;
+    };
+    description: string;
+}
+/**
+ * Registry of all schema migrations, ordered by `from` version.
+ * Empty while CURRENT_SCHEMA_VERSION = 1 — add entries when bumping.
+ */
+export declare const MIGRATIONS: Migration[];
+/**
+ * Apply all applicable migrations to bring a page up to CURRENT_SCHEMA_VERSION.
+ *
+ * Chains migrations sequentially: 1→2, 2→3, etc.
+ * If `schemaVersion` is already >= CURRENT_SCHEMA_VERSION, returns as-is (no downgrade).
+ * If `schemaVersion` is missing, defaults to 1.
+ */
+export declare function migrateToLatest(fm: Record<string, unknown>, body: string): {
+    fm: Record<string, unknown>;
+    body: string;
+};
+/**
+ * Parse YAML frontmatter from markdown content.
+ *
+ * Expects content starting with `---\n...\n---`. If no frontmatter block
+ * is found, returns default frontmatter and the entire content as body.
+ * If the YAML is malformed, throws with a descriptive error.
+ */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: PageFrontmatter;
+    body: string;
+};
+/**
+ * Serialize frontmatter and body back to a markdown string with YAML
+ * frontmatter block.
+ */
+export declare function serializeFrontmatter(frontmatter: PageFrontmatter, body: string): string;
+/**
+ * Validate and normalize a raw frontmatter object into a PageFrontmatter.
+ *
+ * Required field: `title` (defaults to "Untitled" if missing).
+ * All other fields get sensible defaults. Unknown fields are preserved.
+ */
+export declare function validateFrontmatter(fm: Record<string, unknown>): PageFrontmatter;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,WAAW,CAAC;AAI/D,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK;QAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,EAAO,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAyB/C;AAaD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd,CA+BA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,MAAM,GACX,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,eAAe,CAyDjB"}

package/dist/frontmatter.js

@@ -0,0 +1,170 @@
+/**
+ * YAML frontmatter parsing and serialization for wiki pages.
+ *
+ * Handles the `---\n...\n---` frontmatter block in markdown files.
+ * Uses the `yaml` package for robust parsing. Preserves unknown fields.
+ */
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+// -- Schema versioning -------------------------------------------------------
+/** Current schema version. Bump when frontmatter/body format changes. */
+export const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Registry of all schema migrations, ordered by `from` version.
+ * Empty while CURRENT_SCHEMA_VERSION = 1 — add entries when bumping.
+ */
+export const MIGRATIONS = [];
+/**
+ * Apply all applicable migrations to bring a page up to CURRENT_SCHEMA_VERSION.
+ *
+ * Chains migrations sequentially: 1→2, 2→3, etc.
+ * If `schemaVersion` is already >= CURRENT_SCHEMA_VERSION, returns as-is (no downgrade).
+ * If `schemaVersion` is missing, defaults to 1.
+ */
+export function migrateToLatest(fm, body) {
+    let version = typeof fm.schemaVersion === "number" ? fm.schemaVersion : 1;
+    // Don't downgrade pages ahead of current version
+    if (version >= CURRENT_SCHEMA_VERSION) {
+        return { fm: { ...fm, schemaVersion: version }, body };
+    }
+    let currentFm = { ...fm };
+    let currentBody = body;
+    while (version < CURRENT_SCHEMA_VERSION) {
+        const migration = MIGRATIONS.find((m) => m.from === version);
+        if (!migration) {
+            // No migration path — stop at current version
+            break;
+        }
+        const result = migration.migrate(currentFm, currentBody);
+        currentFm = result.fm;
+        currentBody = result.body;
+        version = migration.to;
+    }
+    currentFm.schemaVersion = version;
+    return { fm: currentFm, body: currentBody };
+}
+const VALID_PARA_CATEGORIES = new Set([
+    "projects",
+    "areas",
+    "resources",
+    "archives",
+]);
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n?---\n?([\s\S]*)$/;
+// -- Functions ---------------------------------------------------------------
+/**
+ * Parse YAML frontmatter from markdown content.
+ *
+ * Expects content starting with `---\n...\n---`. If no frontmatter block
+ * is found, returns default frontmatter and the entire content as body.
+ * If the YAML is malformed, throws with a descriptive error.
+ */
+export function parseFrontmatter(content) {
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return {
+            frontmatter: validateFrontmatter({}),
+            body: content,
+        };
+    }
+    const rawYaml = match[1];
+    const body = match[2];
+    let parsed;
+    try {
+        parsed = parseYaml(rawYaml);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Malformed YAML frontmatter: ${msg}`);
+    }
+    if (parsed == null || typeof parsed !== "object") {
+        return {
+            frontmatter: validateFrontmatter({}),
+            body,
+        };
+    }
+    return {
+        frontmatter: validateFrontmatter(parsed),
+        body,
+    };
+}
+/**
+ * Serialize frontmatter and body back to a markdown string with YAML
+ * frontmatter block.
+ */
+export function serializeFrontmatter(frontmatter, body) {
+    // Always write the current schema version on serialize
+    const fmWithVersion = { ...frontmatter, schemaVersion: CURRENT_SCHEMA_VERSION };
+    const yaml = stringifyYaml(fmWithVersion, { lineWidth: 0 }).trimEnd();
+    return `---\n${yaml}\n---\n${body}`;
+}
+/**
+ * Validate and normalize a raw frontmatter object into a PageFrontmatter.
+ *
+ * Required field: `title` (defaults to "Untitled" if missing).
+ * All other fields get sensible defaults. Unknown fields are preserved.
+ */
+export function validateFrontmatter(fm) {
+    const now = new Date().toISOString();
+    const title = typeof fm.title === "string" && fm.title.length > 0
+        ? fm.title
+        : "Untitled";
+    const para = validateParaCategory(fm.para);
+    const scope = toStringArray(fm.scope);
+    const tags = toStringArray(fm.tags);
+    const sources = toStringArray(fm.sources);
+    const links = toStringArray(fm.links);
+    const created = typeof fm.created === "string" && fm.created.length > 0
+        ? fm.created
+        : now;
+    const updated = typeof fm.updated === "string" && fm.updated.length > 0
+        ? fm.updated
+        : now;
+    const schemaVersion = typeof fm.schemaVersion === "number" ? fm.schemaVersion : 1;
+    // Build result with known fields first, then spread unknown fields underneath.
+    // Known fields override any unknown fields with the same name.
+    const knownKeys = new Set([
+        "title",
+        "para",
+        "scope",
+        "tags",
+        "sources",
+        "created",
+        "updated",
+        "links",
+        "schemaVersion",
+    ]);
+    const unknownFields = {};
+    for (const [key, value] of Object.entries(fm)) {
+        if (!knownKeys.has(key)) {
+            unknownFields[key] = value;
+        }
+    }
+    return {
+        ...unknownFields,
+        title,
+        para,
+        scope,
+        tags,
+        sources,
+        created,
+        updated,
+        links,
+        schemaVersion,
+    };
+}
+// -- Helpers -----------------------------------------------------------------
+function validateParaCategory(value) {
+    if (typeof value === "string" && VALID_PARA_CATEGORIES.has(value)) {
+        return value;
+    }
+    return "resources";
+}
+function toStringArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((v) => typeof v === "string");
+    }
+    if (typeof value === "string") {
+        return [value];
+    }
+    return [];
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/gepa/dataset.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GEPA dataset extraction — builds evaluation context from wiki state and session history.
+ *
+ * The evaluation context gives the LLM judge grounding:
+ * it knows about the wiki's current size, structure, common patterns,
+ * and recent capture results to judge whether a prompt would work well.
+ */
+/** Summary of the current wiki state for evaluation context. */
+export interface WikiContext {
+    /** Total number of wiki pages. */
+    totalPages: number;
+    /** Pages per PARA category. */
+    categoryCounts: Record<string, number>;
+    /** Number of unique scopes. */
+    scopeCount: number;
+    /** Most common scopes (top 5). */
+    topScopes: string[];
+    /** Number of unique tags. */
+    tagCount: number;
+    /** Most common tags (top 10). */
+    topTags: string[];
+    /** Sample page titles (up to 15). */
+    sampleTitles: string[];
+}
+/** Full evaluation context. */
+export interface EvalContext {
+    /** Formatted context string for the LLM judge. */
+    contextString: string;
+    /** Raw wiki stats. */
+    wikiStats: WikiContext;
+}
+/**
+ * Build a formatted evaluation context string from wiki state.
+ */
+export declare function buildEvalContext(wikiDir?: string): Promise<EvalContext>;
+//# sourceMappingURL=dataset.d.ts.map

package/dist/gepa/dataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset.d.ts","sourceRoot":"","sources":["../../src/gepa/dataset.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,qCAAqC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IAEtB,sBAAsB;IACtB,SAAS,EAAE,WAAW,CAAC;CACxB;AAyHD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8B7E"}

package/dist/gepa/dataset.js

@@ -0,0 +1,148 @@
+/**
+ * GEPA dataset extraction — builds evaluation context from wiki state and session history.
+ *
+ * The evaluation context gives the LLM judge grounding:
+ * it knows about the wiki's current size, structure, common patterns,
+ * and recent capture results to judge whether a prompt would work well.
+ */
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+// -- Wiki state extraction ---------------------------------------------------
+async function extractWikiStats(wikiDir) {
+    const categories = ["projects", "areas", "resources", "archives"];
+    const categoryCounts = {};
+    const allScopes = [];
+    const allTags = [];
+    const sampleTitles = [];
+    let totalPages = 0;
+    for (const cat of categories) {
+        const catDir = join(wikiDir, cat);
+        if (!existsSync(catDir)) {
+            categoryCounts[cat] = 0;
+            continue;
+        }
+        try {
+            const files = await readdir(catDir);
+            const mdFiles = files.filter((f) => f.endsWith(".md"));
+            categoryCounts[cat] = mdFiles.length;
+            totalPages += mdFiles.length;
+            // Parse frontmatter from each page (lightweight — just YAML header)
+            for (const file of mdFiles.slice(0, 30)) {
+                try {
+                    const content = await readFile(join(catDir, file), "utf-8");
+                    const fm = parseFrontmatter(content);
+                    if (fm) {
+                        if (fm.title && sampleTitles.length < 15) {
+                            sampleTitles.push(fm.title);
+                        }
+                        if (fm.scope)
+                            allScopes.push(...fm.scope);
+                        if (fm.tags)
+                            allTags.push(...fm.tags);
+                    }
+                }
+                catch {
+                    // Skip unreadable pages
+                }
+            }
+        }
+        catch {
+            categoryCounts[cat] = 0;
+        }
+    }
+    const scopeCounts = countOccurrences(allScopes);
+    const tagCounts = countOccurrences(allTags);
+    return {
+        totalPages,
+        categoryCounts,
+        scopeCount: Object.keys(scopeCounts).length,
+        topScopes: topN(scopeCounts, 5),
+        tagCount: Object.keys(tagCounts).length,
+        topTags: topN(tagCounts, 10),
+        sampleTitles,
+    };
+}
+/** Minimal frontmatter parser — extract title, scope, tags from YAML header. */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    const yaml = match[1];
+    const result = {};
+    // Extract title
+    const titleMatch = yaml.match(/^title:\s*(.+)$/m);
+    if (titleMatch) {
+        result.title = titleMatch[1].replace(/^["']|["']$/g, "").trim();
+    }
+    // Extract scope (inline array)
+    const scopeMatch = yaml.match(/^scope:\s*\[([^\]]*)\]/m);
+    if (scopeMatch) {
+        result.scope = scopeMatch[1].split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+    }
+    else {
+        // Multi-line array format
+        const scopeSection = yaml.match(/^scope:\s*\n((?:\s+-\s+.+\n?)*)/m);
+        if (scopeSection) {
+            result.scope = scopeSection[1].match(/^\s+-\s+(.+)$/gm)?.map((l) => l.replace(/^\s+-\s+/, "").replace(/^["']|["']$/g, "").trim()) ?? [];
+        }
+    }
+    // Extract tags (inline array)
+    const tagsMatch = yaml.match(/^tags:\s*\[([^\]]*)\]/m);
+    if (tagsMatch) {
+        result.tags = tagsMatch[1].split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+    }
+    else {
+        const tagsSection = yaml.match(/^tags:\s*\n((?:\s+-\s+.+\n?)*)/m);
+        if (tagsSection) {
+            result.tags = tagsSection[1].match(/^\s+-\s+(.+)$/gm)?.map((l) => l.replace(/^\s+-\s+/, "").replace(/^["']|["']$/g, "").trim()) ?? [];
+        }
+    }
+    return result;
+}
+function countOccurrences(items) {
+    const counts = {};
+    for (const item of items) {
+        counts[item] = (counts[item] ?? 0) + 1;
+    }
+    return counts;
+}
+function topN(counts, n) {
+    return Object.entries(counts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, n)
+        .map(([key]) => key);
+}
+// -- Context building --------------------------------------------------------
+/**
+ * Build a formatted evaluation context string from wiki state.
+ */
+export async function buildEvalContext(wikiDir) {
+    const dir = wikiDir ?? join(homedir(), ".pi", "wiki");
+    const wikiStats = await extractWikiStats(dir);
+    const lines = [
+        "## Wiki State Summary",
+        "",
+        `Total pages: ${wikiStats.totalPages}`,
+        `Categories: ${Object.entries(wikiStats.categoryCounts).map(([k, v]) => `${k}=${v}`).join(", ")}`,
+        `Scopes: ${wikiStats.scopeCount} unique (top: ${wikiStats.topScopes.join(", ") || "none"})`,
+        `Tags: ${wikiStats.tagCount} unique (top: ${wikiStats.topTags.slice(0, 5).join(", ") || "none"})`,
+        "",
+    ];
+    if (wikiStats.sampleTitles.length > 0) {
+        lines.push("Sample page titles:");
+        for (const title of wikiStats.sampleTitles.slice(0, 10)) {
+            lines.push(`  - ${title}`);
+        }
+        lines.push("");
+    }
+    // Check for recent processing history
+    const stateDbPath = join(dir, ".daemon.sqlite");
+    if (existsSync(stateDbPath)) {
+        lines.push("Daemon: active (session processing enabled)");
+    }
+    const contextString = lines.join("\n");
+    return { contextString, wikiStats };
+}
+//# sourceMappingURL=dataset.js.map