pi-para 0.6.0 → 0.6.1

package/dist/store.js

@@ -0,0 +1,282 @@
+/**
+ * qmd store lifecycle — manages the qmd-engine 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 "qmd-engine";
+import { parseFrontmatter } from "./frontmatter.js";
+import { buildQmdProvidersFromParaConfig } from "./qmd-providers.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 provider config -----------------------------------------------------
+/**
+ * qmd-engine currently falls back to node-llama-cpp when no API provider is
+ * configured. pi-para never uses local LLMs, so provide an inert API endpoint
+ * whenever neither pi-para profiles nor legacy provider config exists. BM25
+ * search works without calling this endpoint; accidental vector/chat calls fail
+ * fast instead of downloading/building local models.
+ */
+const NO_LOCAL_PROVIDERS = {
+    embed: {
+        url: "http://127.0.0.1:9",
+        model: "disabled-local-llm",
+    },
+};
+// -- 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 and runs update() for BM25. When requested,
+ * also schedules embed() in the background.
+ */
+export async function openStore(wikiDir, opts = {}) {
+    // Prefer pi-para's in-memory provider profiles. Legacy QMD YAML remains a
+    // fallback for migrated installs and tests that do not pass paraConfig.
+    const configuredProviders = opts.paraConfig
+        ? opts.paraConfig.qmd.providerConfig === "legacy-qmd-compatible"
+            ? loadQmdProviders()
+            : await buildQmdProvidersFromParaConfig(opts.paraConfig, {
+                secretsPath: opts.secretsPath,
+                authStorage: opts.authStorage,
+            })
+        : loadQmdProviders();
+    const providers = configuredProviders ?? NO_LOCAL_PROVIDERS;
+    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,
+        },
+    });
+    // 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();
+    if (opts.backgroundEmbed !== false && opts.paraConfig?.qmd.embedEnabled !== false) {
+        // 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) => {
+            const timer = setTimeout(resolve, 5_000);
+            timer.unref?.();
+        });
+        await Promise.race([pending, timeout]);
+        pendingEmbeds.delete(store);
+    }
+    await store.close();
+}
+/**
+ * Search the wiki with scope and category filtering.
+ *
+ * Uses vector search when an embedding index is available, merged with BM25
+ * lexical search for exact keyword matches. 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 lexResults = await store.searchLex(query, {
+        limit: fetchLimit,
+        collection: "wiki",
+        metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+        graphBoost: opts.graphBoost ?? true,
+    });
+    const rawResults = await mergeLexAndVectorResults(store, query, lexResults, fetchLimit);
+    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 || slug,
+                path: `${category}/${slug}.md`,
+            },
+            score: result.score,
+            snippet,
+            frontmatter,
+        });
+        if (results.length >= limit)
+            break;
+    }
+    return results;
+}
+async function mergeLexAndVectorResults(store, query, lexResults, limit) {
+    let vecResults = [];
+    try {
+        const status = await store.getStatus();
+        const llm = store.internal.llm;
+        const embedModel = llm?.embedModelName;
+        if (status.hasVectorIndex && llm && embedModel) {
+            vecResults = await store.internal.searchVec(query, embedModel, limit, "wiki", llm);
+        }
+    }
+    catch {
+        // Semantic search is best-effort; lexical BM25 remains the reliable fallback.
+    }
+    const merged = new Map();
+    for (const result of lexResults) {
+        merged.set(result.displayPath, { ...result, score: result.score * 0.85 });
+    }
+    for (const result of vecResults) {
+        const existing = merged.get(result.displayPath);
+        if (!existing || result.score > existing.score) {
+            merged.set(result.displayPath, result);
+        }
+    }
+    return [...merged.values()].sort((a, b) => b.score - a.score).slice(0, limit * 2);
+}
+/**
+ * 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,60 @@
+/**
+ * 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 @earendil-works/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 interface OverviewPromptOptions {
+    depth?: "brief" | "detailed";
+    maxChars?: number;
+}
+export declare function generateOverviewPrompt(pages: WikiPage[], scope: ProjectScope, options?: OverviewPromptOptions): 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,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAgCR"}

package/dist/summarize.js

@@ -0,0 +1,266 @@
+/**
+ * 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 "@earendil-works/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 @earendil-works/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 @earendil-works/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");
+    }
+}
+const DEFAULT_BRIEF_OVERVIEW_MAX_CHARS = 28_000;
+const DEFAULT_DETAILED_OVERVIEW_MAX_CHARS = 80_000;
+const BRIEF_EXCERPT_CHARS = 180;
+const DETAILED_BODY_CHARS = 2_000;
+export function generateOverviewPrompt(pages, scope, options = {}) {
+    const depth = options.depth ?? "brief";
+    const maxChars = options.maxChars ?? (depth === "detailed" ? DEFAULT_DETAILED_OVERVIEW_MAX_CHARS : DEFAULT_BRIEF_OVERVIEW_MAX_CHARS);
+    const scopeInfo = `Current scope: ${scope.name} (tags: ${scope.include.join(", ")})`;
+    const header = [
+        OVERVIEW_PROMPT,
+        "",
+        scopeInfo,
+        `Total pages: ${pages.length}`,
+        `Input mode: ${depth === "detailed" ? "bounded detailed excerpts" : "compact metadata/excerpts"}`,
+        "",
+    ].join("\n");
+    const entries = [];
+    let usedChars = header.length;
+    let omitted = 0;
+    for (const page of pages) {
+        const entry = depth === "detailed" ? detailedPageEntry(page) : briefPageEntry(page);
+        if (usedChars + entry.length + 2 > maxChars) {
+            omitted++;
+            continue;
+        }
+        entries.push(entry);
+        usedChars += entry.length + 2;
+    }
+    const omittedNote = omitted > 0
+        ? `\n\n[${omitted} page(s) omitted to keep wiki_summarize within the context budget. Use a category, page path, or depth=\"detailed\" on a narrower target for more detail.]`
+        : "";
+    return `${header}${entries.join("\n\n")}${omittedNote}`;
+}
+function briefPageEntry(page) {
+    const fm = page.frontmatter;
+    const excerpt = firstUsefulExcerpt(page.body, BRIEF_EXCERPT_CHARS);
+    return [
+        `- ${fm.title} (${page.category}/${page.slug})`,
+        `  PARA: ${fm.para} | Scope: ${fm.scope.join(", ")} | Tags: ${fm.tags.join(", ") || "-"} | Updated: ${fm.updated ?? "-"}`,
+        excerpt ? `  Excerpt: ${excerpt}` : undefined,
+        fm.links?.length ? `  Links: ${fm.links.slice(0, 8).map((link) => `[[${link}]]`).join(", ")}` : undefined,
+    ].filter(Boolean).join("\n");
+}
+function detailedPageEntry(page) {
+    const fm = page.frontmatter;
+    return [
+        `### ${fm.title} (${page.category}/${page.slug})`,
+        `PARA: ${fm.para} | Scope: ${fm.scope.join(", ")} | Tags: ${fm.tags.join(", ")}`,
+        `Updated: ${fm.updated ?? "-"} | Links: ${(fm.links ?? []).slice(0, 12).map((link) => `[[${link}]]`).join(", ") || "-"}`,
+        "",
+        truncateForSummary(page.body, DETAILED_BODY_CHARS),
+    ].join("\n");
+}
+function firstUsefulExcerpt(body, maxChars) {
+    const cleaned = body
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith("#") && !/^[-*]\s*\[?\[?/.test(line))
+        .join(" ")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (!cleaned)
+        return "";
+    return cleaned.length <= maxChars ? cleaned : `${cleaned.slice(0, maxChars - 1)}…`;
+}
+//# 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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"}