pi-para 0.5.2

package/dist/store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * qmd store lifecycle — manages the @picassio/qmd store instance.
+ *
+ * Handles store creation/opening, search with scope filtering,
+ * re-indexing after wiki changes, and embedding lifecycle.
+ */
+import type { QMDStore } from "@picassio/qmd";
+import type { PageFrontmatter, PageRef, ParaCategory } from "./wiki.js";
+import type { ProjectScope } from "./scope.js";
+export type { QMDStore } from "@picassio/qmd";
+export interface WikiSearchOptions {
+    scope?: ProjectScope;
+    category?: ParaCategory;
+    limit?: number;
+    includeArchives?: boolean;
+    graphBoost?: boolean;
+}
+export interface WikiSearchResult {
+    page: PageRef;
+    score: number;
+    snippet: string;
+    frontmatter: PageFrontmatter;
+}
+/**
+ * Open and configure a qmd store for the wiki directory.
+ *
+ * Creates the store with two collections:
+ * - wiki: all .md files except raw/
+ * - raw: .md files under raw/, not included in default queries
+ *
+ * Adds PARA category contexts, runs update() for BM25,
+ * and schedules embed() in the background.
+ */
+export declare function openStore(wikiDir: string): Promise<QMDStore>;
+/**
+ * Close the store. Awaits any pending embed operation (with timeout) first.
+ */
+export declare function closeStore(store: QMDStore): Promise<void>;
+/**
+ * Search the wiki with scope and category filtering.
+ *
+ * Uses BM25 search (searchLex) which requires no LLM. Each result's
+ * frontmatter is parsed to apply scope/category/archive filters.
+ */
+export declare function searchWiki(store: QMDStore, query: string, opts: WikiSearchOptions): Promise<WikiSearchResult[]>;
+/**
+ * Re-index the store (fast filesystem scan). Makes new/changed
+ * content BM25-searchable immediately. Call after wiki writes.
+ */
+export declare function reindex(store: QMDStore): Promise<void>;
+/**
+ * Generate vector embeddings for new/changed pages.
+ * Slow — call only at startup (via openStore) or shutdown.
+ */
+export declare function embedIfNeeded(store: QMDStore): Promise<void>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAGhE,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAsCD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwDlE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoE7B;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE"}

package/dist/store.js

@@ -0,0 +1,227 @@
+/**
+ * qmd store lifecycle — manages the @picassio/qmd store instance.
+ *
+ * Handles store creation/opening, search with scope filtering,
+ * re-indexing after wiki changes, and embedding lifecycle.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { createStore, extractSnippet } from "@picassio/qmd";
+import { parseFrontmatter } from "./frontmatter.js";
+import { matchesScope } from "./scope.js";
+// -- PARA context descriptions -----------------------------------------------
+const PARA_CONTEXTS = {
+    "projects/": "Active projects with defined goals and end dates",
+    "areas/": "Ongoing responsibilities and standards",
+    "resources/": "Reference material and how-to guides",
+    "archives/": "Completed or deprecated items",
+};
+const RAW_CONTEXT = "Immutable source material: articles, documents, notes. Not synthesized.";
+// -- Pending embed tracking --------------------------------------------------
+const pendingEmbeds = new WeakMap();
+// -- qmd config loading ------------------------------------------------------
+/**
+ * Read providers from ~/.config/qmd/index.yml.
+ * Returns undefined if no config file or no providers configured.
+ */
+function loadQmdProviders() {
+    const configPath = join(homedir(), ".config", "qmd", "index.yml");
+    if (!existsSync(configPath))
+        return undefined;
+    try {
+        const content = readFileSync(configPath, "utf-8");
+        const config = parseYaml(content);
+        return config?.providers;
+    }
+    catch {
+        return undefined;
+    }
+}
+// -- Functions ---------------------------------------------------------------
+/**
+ * Open and configure a qmd store for the wiki directory.
+ *
+ * Creates the store with two collections:
+ * - wiki: all .md files except raw/
+ * - raw: .md files under raw/, not included in default queries
+ *
+ * Adds PARA category contexts, runs update() for BM25,
+ * and schedules embed() in the background.
+ */
+export async function openStore(wikiDir) {
+    // Read providers from ~/.config/qmd/index.yml so external API providers
+    // (embed, chat, rerank) are used instead of local GGUF models.
+    const providers = loadQmdProviders();
+    const store = await createStore({
+        dbPath: join(wikiDir, ".qmd.sqlite"),
+        config: {
+            collections: {
+                wiki: {
+                    path: wikiDir,
+                    pattern: "**/*.md",
+                    ignore: ["raw/**"],
+                },
+                raw: {
+                    path: join(wikiDir, "raw"),
+                    pattern: "**/*.md",
+                    includeByDefault: false,
+                },
+            },
+            ...(providers ? { providers: providers } : {}),
+        },
+    });
+    // Add PARA category contexts to the wiki collection
+    for (const [prefix, description] of Object.entries(PARA_CONTEXTS)) {
+        await store.addContext("wiki", prefix, description);
+    }
+    // Add context for the raw collection root
+    await store.addContext("raw", "/", RAW_CONTEXT);
+    // Sync filesystem -> BM25 index (fast, search ready immediately)
+    await store.update();
+    // Schedule embedding in background (non-blocking).
+    // BM25 search works immediately; hybrid search improves once embed completes.
+    // Suppress console.error from qmd's internal embed failures.
+    const origError = console.error;
+    const embedPromise = store.embed().then(() => {
+        pendingEmbeds.delete(store);
+    }).catch(() => {
+        // Embedding failures are non-fatal — hybrid search degrades to BM25
+        pendingEmbeds.delete(store);
+    }).finally(() => {
+        console.error = origError;
+    });
+    // Temporarily suppress embed error noise during background embed
+    console.error = (...args) => {
+        const msg = String(args[0] ?? "");
+        if (msg.includes("embed error") || msg.includes("fetch failed"))
+            return;
+        origError(...args);
+    };
+    pendingEmbeds.set(store, embedPromise);
+    return store;
+}
+/**
+ * Close the store. Awaits any pending embed operation (with timeout) first.
+ */
+export async function closeStore(store) {
+    const pending = pendingEmbeds.get(store);
+    if (pending) {
+        // Wait for pending embed with a short timeout — don't hang forever
+        const timeout = new Promise((resolve) => setTimeout(resolve, 5_000));
+        await Promise.race([pending, timeout]);
+        pendingEmbeds.delete(store);
+    }
+    await store.close();
+}
+/**
+ * Search the wiki with scope and category filtering.
+ *
+ * Uses BM25 search (searchLex) which requires no LLM. Each result's
+ * frontmatter is parsed to apply scope/category/archive filters.
+ */
+export async function searchWiki(store, query, opts) {
+    const limit = opts.limit ?? 10;
+    // Build metadata filter for SQL-level filtering (qmd v2.2.0+)
+    // Note: we can only use metadata.category here, NOT scope.
+    // Scope filtering must remain as post-filter because:
+    // - Pages with scope:["global"] must match ANY project scope
+    // - Pages in the scope.include list need OR matching
+    // - The exclude list needs post-filter negation
+    // SQL-level scope filter would miss global pages.
+    const metadata = {};
+    if (opts.category) {
+        metadata.category = opts.category;
+    }
+    const fetchLimit = opts.scope ? limit * 3 : limit;
+    const rawResults = await store.searchLex(query, {
+        limit: fetchLimit,
+        collection: "wiki",
+        metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+        graphBoost: opts.graphBoost ?? true,
+    });
+    const results = [];
+    for (const result of rawResults) {
+        // Parse category and slug from the display path (e.g. "projects/auth-refactor.md")
+        const parsed = parseDisplayPath(result.displayPath);
+        if (!parsed)
+            continue;
+        const { category, slug } = parsed;
+        // Exclude archives unless explicitly requested (post-filter fallback
+        // for pages without frontmatter metadata)
+        if (category === "archives" && !opts.includeArchives) {
+            continue;
+        }
+        // Parse frontmatter from body
+        const body = result.body ?? "";
+        const { frontmatter } = parseFrontmatter(body);
+        // Scope post-filter fallback for pages without metadata
+        if (opts.scope && !matchesScope(frontmatter.scope, opts.scope)) {
+            continue;
+        }
+        // Extract a snippet for display
+        const snippetResult = extractSnippet(body, query);
+        const snippet = snippetResult.snippet;
+        results.push({
+            page: {
+                category,
+                slug,
+                title: frontmatter.title || result.title,
+                path: `${category}/${slug}.md`,
+            },
+            score: result.score,
+            snippet,
+            frontmatter,
+        });
+        if (results.length >= limit)
+            break;
+    }
+    return results;
+}
+/**
+ * Re-index the store (fast filesystem scan). Makes new/changed
+ * content BM25-searchable immediately. Call after wiki writes.
+ */
+export async function reindex(store) {
+    await store.update();
+}
+/**
+ * Generate vector embeddings for new/changed pages.
+ * Slow — call only at startup (via openStore) or shutdown.
+ */
+export async function embedIfNeeded(store) {
+    await store.embed();
+}
+// -- Helpers -----------------------------------------------------------------
+/** Valid PARA categories for path parsing. */
+const VALID_CATEGORIES = new Set([
+    "projects",
+    "areas",
+    "resources",
+    "archives",
+]);
+/**
+ * Parse a qmd display path into category + slug.
+ * Display paths from searchLex include the collection prefix:
+ *   "wiki/resources/ssl-certs.md" or "wiki/schema.md"
+ * Returns null for root-level files (schema.md, index.md, etc.) — they
+ * still appear in search results but aren't PageRef-able.
+ */
+function parseDisplayPath(displayPath) {
+    const parts = displayPath.split("/");
+    // Display paths are: collection/category/slug.md (3+ parts)
+    // or collection/file.md (2 parts, root-level files like schema.md)
+    if (parts.length < 3)
+        return null;
+    // Skip collection prefix (parts[0] = "wiki")
+    const category = parts[1];
+    if (!VALID_CATEGORIES.has(category))
+        return null;
+    const filename = parts.slice(2).join("/");
+    if (!filename.endsWith(".md"))
+        return null;
+    const slug = filename.slice(0, -3);
+    return { category: category, slug };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/summarize.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Wiki summarization — adapts pi's compaction approach for wiki knowledge.
+ *
+ * Produces structured wiki summaries in the standard format:
+ * Topic, Key Facts, Insights, Connections, Open Questions, Sources.
+ *
+ * Supports ingest, session, page, and iterative summarization modes.
+ *
+ * Functions here generate prompt strings — they do NOT call the LLM.
+ * The caller (capture.ts, tools.ts) passes the prompt to a standalone Agent.
+ */
+import type { WikiPage } from "./wiki.js";
+import type { ParaCategory } from "./wiki.js";
+import type { ProjectScope } from "./scope.js";
+export interface SummarizeOptions {
+    mode: "ingest" | "session" | "page" | "iterative";
+    existingContent?: string;
+    scope: ProjectScope;
+    category?: ParaCategory;
+}
+/**
+ * Serialize session messages for wiki capture.
+ *
+ * Converts AgentMessage[] to a text representation that prevents the LLM
+ * from treating it as a conversation to continue. Uses pi's convertToLlm +
+ * serializeConversation when the messages contain pi-specific types
+ * (bashExecution, compactionSummary, branchSummary, etc.). Falls back to
+ * a compatible reimplementation for plain user/assistant/toolResult messages.
+ *
+ * @param messages - AgentMessage[] from @mariozechner/pi-agent-core
+ * @returns Serialized text in [User]: / [Assistant]: / [Tool result]: format
+ */
+export declare function serializeSessionForWiki(messages: unknown[]): string;
+/**
+ * Generate a wiki-format summary prompt from raw content.
+ *
+ * Returns the prompt string to send to the LLM. The caller passes this
+ * to a standalone Agent or includes it in a tool result for the session agent.
+ *
+ * @param content - Source text, serialized conversation, or page content
+ * @param options - Summarization mode and context
+ * @returns Prompt string for the LLM
+ */
+export declare function generateSummary(content: string, options: SummarizeOptions): string;
+/**
+ * Generate an overview prompt from multiple wiki pages.
+ *
+ * Used by /wiki-summarize and wiki_summarize tool to produce high-level
+ * overviews of a category or the entire wiki.
+ *
+ * @param pages - Wiki pages to summarize
+ * @param scope - Current project scope for context
+ * @returns Prompt string for the LLM
+ */
+export declare function generateOverviewPrompt(pages: WikiPage[], scope: ProjectScope): string;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAuGD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,EAAE,GAClB,MAAM,CAYR;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,MAAM,CA2DR;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,YAAY,GAClB,MAAM,CAqBR"}

package/dist/summarize.js

@@ -0,0 +1,231 @@
+/**
+ * Wiki summarization — adapts pi's compaction approach for wiki knowledge.
+ *
+ * Produces structured wiki summaries in the standard format:
+ * Topic, Key Facts, Insights, Connections, Open Questions, Sources.
+ *
+ * Supports ingest, session, page, and iterative summarization modes.
+ *
+ * Functions here generate prompt strings — they do NOT call the LLM.
+ * The caller (capture.ts, tools.ts) passes the prompt to a standalone Agent.
+ */
+import { convertToLlm, serializeConversation, } from "@mariozechner/pi-coding-agent";
+import { SUMMARIZE_SYSTEM_PROMPT, ITERATIVE_UPDATE_PROMPT, OVERVIEW_PROMPT, CAPTURE_PROMPT, } from "./templates/prompts.js";
+// -- Constants ---------------------------------------------------------------
+/** Maximum characters for a tool result in serialized output. */
+const TOOL_RESULT_MAX_CHARS = 2000;
+// -- Fallback serialization --------------------------------------------------
+/**
+ * Truncate text to a maximum character length for summarization.
+ * Keeps the beginning and appends a truncation marker.
+ */
+function truncateForSummary(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    const truncatedChars = text.length - maxChars;
+    return `${text.slice(0, maxChars)}\n\n[... ${truncatedChars} more characters truncated]`;
+}
+/**
+ * Extract text content from a message content field.
+ * Handles both string and array-of-blocks shapes.
+ */
+function extractTextContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((c) => typeof c === "object" &&
+        c !== null &&
+        "type" in c &&
+        c.type === "text" &&
+        "text" in c)
+        .map((c) => c.text)
+        .join("");
+}
+/**
+ * Fallback serialization that mirrors pi's serializeConversation format.
+ * Used when @mariozechner/pi-coding-agent is not available.
+ *
+ * Formats: [User]:, [Assistant]:, [Assistant thinking]:,
+ *          [Assistant tool calls]:, [Tool result]:
+ */
+function serializeMessagesFallback(messages) {
+    const parts = [];
+    for (const msg of messages) {
+        if (typeof msg !== "object" || msg === null || !("role" in msg))
+            continue;
+        const m = msg;
+        if (m.role === "user") {
+            const text = extractTextContent(m.content);
+            if (text)
+                parts.push(`[User]: ${text}`);
+        }
+        else if (m.role === "assistant") {
+            const content = m.content;
+            if (!Array.isArray(content))
+                continue;
+            const textParts = [];
+            const thinkingParts = [];
+            const toolCalls = [];
+            for (const block of content) {
+                if (typeof block !== "object" || block === null || !("type" in block))
+                    continue;
+                const b = block;
+                if (b.type === "text" && typeof b.text === "string") {
+                    textParts.push(b.text);
+                }
+                else if (b.type === "thinking" && typeof b.thinking === "string") {
+                    thinkingParts.push(b.thinking);
+                }
+                else if (b.type === "toolCall" && typeof b.name === "string") {
+                    const args = (b.arguments ?? {});
+                    const argsStr = Object.entries(args)
+                        .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+                        .join(", ");
+                    toolCalls.push(`${b.name}(${argsStr})`);
+                }
+            }
+            if (thinkingParts.length > 0) {
+                parts.push(`[Assistant thinking]: ${thinkingParts.join("\n")}`);
+            }
+            if (textParts.length > 0) {
+                parts.push(`[Assistant]: ${textParts.join("\n")}`);
+            }
+            if (toolCalls.length > 0) {
+                parts.push(`[Assistant tool calls]: ${toolCalls.join("; ")}`);
+            }
+        }
+        else if (m.role === "toolResult") {
+            const text = extractTextContent(m.content);
+            if (text) {
+                parts.push(`[Tool result]: ${truncateForSummary(text, TOOL_RESULT_MAX_CHARS)}`);
+            }
+        }
+    }
+    return parts.join("\n\n");
+}
+// -- Public API --------------------------------------------------------------
+/**
+ * Serialize session messages for wiki capture.
+ *
+ * Converts AgentMessage[] to a text representation that prevents the LLM
+ * from treating it as a conversation to continue. Uses pi's convertToLlm +
+ * serializeConversation when the messages contain pi-specific types
+ * (bashExecution, compactionSummary, branchSummary, etc.). Falls back to
+ * a compatible reimplementation for plain user/assistant/toolResult messages.
+ *
+ * @param messages - AgentMessage[] from @mariozechner/pi-agent-core
+ * @returns Serialized text in [User]: / [Assistant]: / [Tool result]: format
+ */
+export function serializeSessionForWiki(messages) {
+    // Use pi's convertToLlm to handle custom message types (bashExecution,
+    // compactionSummary, branchSummary, etc.), then serialize the resulting
+    // standard LLM messages.
+    try {
+        const llmMessages = convertToLlm(messages);
+        return serializeConversation(llmMessages);
+    }
+    catch {
+        // If convertToLlm fails (e.g., unexpected message shapes), fall back
+        // to our reimplementation that handles the base roles.
+        return serializeMessagesFallback(messages);
+    }
+}
+/**
+ * Generate a wiki-format summary prompt from raw content.
+ *
+ * Returns the prompt string to send to the LLM. The caller passes this
+ * to a standalone Agent or includes it in a tool result for the session agent.
+ *
+ * @param content - Source text, serialized conversation, or page content
+ * @param options - Summarization mode and context
+ * @returns Prompt string for the LLM
+ */
+export function generateSummary(content, options) {
+    const scopeInfo = `Current scope: ${options.scope.name} (tags: ${options.scope.include.join(", ")})`;
+    const categoryHint = options.category ? `\nSuggested PARA category: ${options.category}` : "";
+    switch (options.mode) {
+        case "ingest":
+            return [
+                SUMMARIZE_SYSTEM_PROMPT,
+                "",
+                scopeInfo,
+                categoryHint,
+                "",
+                "Produce a wiki page from the following source material:",
+                "",
+                "<source-content>",
+                content,
+                "</source-content>",
+            ].join("\n");
+        case "session":
+            return [
+                CAPTURE_PROMPT,
+                content,
+                "</session-conversation>",
+            ].join("\n");
+        case "page":
+            return [
+                SUMMARIZE_SYSTEM_PROMPT,
+                "",
+                scopeInfo,
+                "",
+                "Summarize the following wiki page into a concise overview:",
+                "",
+                "<page-content>",
+                content,
+                "</page-content>",
+            ].join("\n");
+        case "iterative":
+            if (!options.existingContent) {
+                // No existing content — treat as a fresh page
+                return generateSummary(content, { ...options, mode: "ingest" });
+            }
+            return [
+                ITERATIVE_UPDATE_PROMPT,
+                "",
+                scopeInfo,
+                categoryHint,
+                "",
+                "<existing-page>",
+                options.existingContent,
+                "</existing-page>",
+                "",
+                "<new-content>",
+                content,
+                "</new-content>",
+            ].join("\n");
+    }
+}
+/**
+ * Generate an overview prompt from multiple wiki pages.
+ *
+ * Used by /wiki-summarize and wiki_summarize tool to produce high-level
+ * overviews of a category or the entire wiki.
+ *
+ * @param pages - Wiki pages to summarize
+ * @param scope - Current project scope for context
+ * @returns Prompt string for the LLM
+ */
+export function generateOverviewPrompt(pages, scope) {
+    const scopeInfo = `Current scope: ${scope.name} (tags: ${scope.include.join(", ")})`;
+    const pageEntries = pages.map((page) => {
+        const fm = page.frontmatter;
+        return [
+            `### ${fm.title} (${page.category}/${page.slug})`,
+            `PARA: ${fm.para} | Scope: ${fm.scope.join(", ")} | Tags: ${fm.tags.join(", ")}`,
+            "",
+            page.body,
+        ].join("\n");
+    });
+    return [
+        OVERVIEW_PROMPT,
+        "",
+        scopeInfo,
+        `Total pages: ${pages.length}`,
+        "",
+        ...pageEntries,
+    ].join("\n");
+}
+//# sourceMappingURL=summarize.js.map

package/dist/summarize.js.map

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

package/dist/tag-registry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Canonical tag registry — normalizes and deduplicates wiki page tags.
+ *
+ * Rules:
+ * 1. Spaces → hyphens ("session files" → "session-files")
+ * 2. Lowercase everything
+ * 3. Map aliases → canonical tags
+ * 4. Remove tags that duplicate scope values on the same page
+ * 5. Deduplicate
+ */
+/**
+ * Normalize a scope value.
+ *
+ * Scope should be a project name (kebab-case, single token), not a topic
+ * description. The daemon LLM sometimes writes freeform multi-word
+ * descriptions like "session exploration" or "mono project" as scope.
+ *
+ * Rules:
+ * 1. Trim + lowercase
+ * 2. If the value contains a known project name as a prefix, extract it
+ *    (e.g. "pi-para daemon" → "pi-para", "pi-mono project" → "pi-mono")
+ * 3. If still multi-word after extraction, drop it — it's a topic
+ *    description, not a project name
+ * 4. Return the clean kebab-case scope
+ *
+ * This is project-agnostic — works for any project, not just pi-para.
+ */
+export declare function normalizeScope(scope: string): string | null;
+/**
+ * Normalize a full scope list:
+ * 1. Normalize each value
+ * 2. Deduplicate
+ * 3. Ensure at least one scope remains (fallback to "global")
+ */
+export declare function normalizeScopes(scopes: string[]): string[];
+/**
+ * Normalize a single tag:
+ * 1. Trim + lowercase
+ * 2. Spaces → hyphens
+ * 3. Resolve alias → canonical
+ */
+export declare function normalizeTag(tag: string): string;
+/**
+ * Normalize a full tag list for a page, given its scope.
+ *
+ * 1. Normalize each tag
+ * 2. Remove tags that exactly match a scope value
+ * 3. Deduplicate
+ * 4. Sort alphabetically
+ */
+export declare function normalizeTags(tags: string[], scope: string[]): string[];
+/**
+ * Get the full alias map for external inspection (e.g., lint reporting).
+ */
+export declare function getAliasMap(): ReadonlyMap<string, string>;
+//# sourceMappingURL=tag-registry.d.ts.map

package/dist/tag-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-registry.d.ts","sourceRoot":"","sources":["../src/tag-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQ1D;AAkDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAavE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD"}