pi-para 0.5.2

package/dist/ingest.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Ingest pipeline — processes sources and integrates knowledge into the wiki.
+ *
+ * Resolves source content (URL, file, text), saves raw copy to the vault,
+ * and returns structured data for the caller (tool or standalone agent)
+ * to pass to the LLM for synthesis into wiki pages.
+ */
+import type { ParaCategory, PageRef, LogEntry } from "./wiki.js";
+import type { ProjectScope } from "./scope.js";
+export interface IngestOptions {
+    source: string;
+    sourceType?: "url" | "file" | "text";
+    scope?: string[];
+    category?: ParaCategory;
+}
+export interface IngestReport {
+    pagesCreated: PageRef[];
+    pagesUpdated: PageRef[];
+    logEntry: LogEntry;
+}
+/** Structure returned by LLM during ingest. */
+export interface IngestResult {
+    newPages: Array<{
+        category: ParaCategory;
+        slug: string;
+        title: string;
+        scope: string[];
+        tags: string[];
+        body: string;
+    }>;
+    updatedPages: Array<{
+        category: ParaCategory;
+        slug: string;
+        appendOrReplace: "append" | "replace";
+        body: string;
+    }>;
+    indexUpdate: string;
+    logSummary: string;
+}
+/** Resolved source data from the ingest pipeline. */
+export interface ResolvedSource {
+    /** Original source string (URL, path, or text) */
+    source: string;
+    /** Detected or explicit source type */
+    sourceType: "url" | "file" | "text";
+    /** Fetched/read source content */
+    content: string;
+    /** Path in raw/ vault (undefined for inline text) */
+    rawPath: string | undefined;
+    /** Schema.md content for LLM context */
+    schema: string;
+    /** Index.md content for LLM context */
+    index: string;
+    /** Scope tags to assign */
+    scopeTags: string[];
+    /** Scope name */
+    scopeName: string;
+    /** Category hint (if provided) */
+    categoryHint: ParaCategory | undefined;
+}
+/** Detect source type from the source string. */
+export declare function detectSourceType(source: string): "url" | "file" | "text";
+/** Fetch content from a URL. */
+export declare function fetchUrl(url: string): Promise<string>;
+/** Read content from a file path. */
+export declare function readFileSource(filePath: string): Promise<string>;
+/**
+ * Resolve a source and prepare it for LLM synthesis.
+ *
+ * This is the reusable library function. It:
+ * 1. Detects or uses the explicit source type
+ * 2. Fetches URL / reads file / uses text directly
+ * 3. Saves a raw copy to the vault (for non-text sources)
+ * 4. Reads schema.md and index.md for LLM context
+ * 5. Returns everything the caller needs to build an LLM prompt
+ *
+ * The caller (tool or standalone agent) assembles the prompt and
+ * passes it to the LLM, which calls wiki_write to create pages.
+ */
+export declare function resolveSource(wikiDir: string, options: IngestOptions, scope: ProjectScope): Promise<ResolvedSource>;
+/** Maximum source content length before truncation. */
+export declare const MAX_SOURCE_LENGTH = 50000;
+/**
+ * Truncate source content if it exceeds the limit.
+ * Returns the truncated content with a marker.
+ */
+export declare function truncateSource(content: string, maxLength?: number): string;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,YAAY,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,YAAY,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,QAAQ,GAAG,SAAS,CAAC;QACtC,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,UAAU,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;CACxC;AAID,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAQxE;AAED,gCAAgC;AAChC,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3D;AAED,qCAAqC;AACrC,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtE;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,cAAc,CAAC,CA6CzB;AAED,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAA0B,GAAG,MAAM,CAG7F"}

package/dist/ingest.js

@@ -0,0 +1,105 @@
+/**
+ * Ingest pipeline — processes sources and integrates knowledge into the wiki.
+ *
+ * Resolves source content (URL, file, text), saves raw copy to the vault,
+ * and returns structured data for the caller (tool or standalone agent)
+ * to pass to the LLM for synthesis into wiki pages.
+ */
+import { readFile } from "node:fs/promises";
+import { readSchema, readIndex } from "./wiki.js";
+import { saveRawSource } from "./raw.js";
+// -- Source resolution -------------------------------------------------------
+/** Detect source type from the source string. */
+export function detectSourceType(source) {
+    if (/^https?:\/\//i.test(source))
+        return "url";
+    if (/^\/|^\.\/|^~\/|^[a-zA-Z]:\\/.test(source))
+        return "file";
+    // Heuristic: if it contains newlines or is very long, treat as text
+    if (source.includes("\n") || source.length > 500)
+        return "text";
+    // Check for file-like paths (has extension)
+    if (/\.\w{1,10}$/.test(source) && !source.includes(" "))
+        return "file";
+    return "text";
+}
+/** Fetch content from a URL. */
+export async function fetchUrl(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+}
+/** Read content from a file path. */
+export async function readFileSource(filePath) {
+    const resolved = filePath.replace(/^~\//, `${process.env.HOME ?? ""}/`);
+    return readFile(resolved, "utf-8");
+}
+// -- Main pipeline -----------------------------------------------------------
+/**
+ * Resolve a source and prepare it for LLM synthesis.
+ *
+ * This is the reusable library function. It:
+ * 1. Detects or uses the explicit source type
+ * 2. Fetches URL / reads file / uses text directly
+ * 3. Saves a raw copy to the vault (for non-text sources)
+ * 4. Reads schema.md and index.md for LLM context
+ * 5. Returns everything the caller needs to build an LLM prompt
+ *
+ * The caller (tool or standalone agent) assembles the prompt and
+ * passes it to the LLM, which calls wiki_write to create pages.
+ */
+export async function resolveSource(wikiDir, options, scope) {
+    const sourceType = options.sourceType ?? detectSourceType(options.source);
+    // Resolve source content
+    let content;
+    switch (sourceType) {
+        case "url":
+            content = await fetchUrl(options.source);
+            break;
+        case "file":
+            content = await readFileSource(options.source);
+            break;
+        case "text":
+            content = options.source;
+            break;
+    }
+    // Save raw source (skip for inline text — it's ephemeral)
+    let rawPath;
+    if (sourceType !== "text") {
+        rawPath = await saveRawSource(wikiDir, {
+            type: sourceType,
+            content,
+            originalPath: options.source,
+        });
+    }
+    // Read schema and index for LLM context
+    const schema = await readSchema(wikiDir);
+    const index = await readIndex(wikiDir);
+    // Build scope info
+    const scopeTags = options.scope ?? scope.include;
+    return {
+        source: options.source,
+        sourceType,
+        content,
+        rawPath,
+        schema,
+        index,
+        scopeTags,
+        scopeName: scope.name,
+        categoryHint: options.category,
+    };
+}
+/** Maximum source content length before truncation. */
+export const MAX_SOURCE_LENGTH = 50_000;
+/**
+ * Truncate source content if it exceeds the limit.
+ * Returns the truncated content with a marker.
+ */
+export function truncateSource(content, maxLength = MAX_SOURCE_LENGTH) {
+    if (content.length <= maxLength)
+        return content;
+    return content.slice(0, maxLength) + "\n\n[... truncated]";
+}
+//# sourceMappingURL=ingest.js.map

package/dist/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA4DzC,+EAA+E;AAE/E,iDAAiD;AACjD,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9D,oEAAoE;IACpE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,MAAM,CAAC;IAChE,4CAA4C;IAC5C,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACvE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;IACxE,OAAO,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,OAAsB,EACtB,KAAmB;IAEnB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1E,yBAAyB;IACzB,IAAI,OAAe,CAAC;IACpB,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,MAAM;YACT,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM;QACR,KAAK,MAAM;YACT,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YACzB,MAAM;IACV,CAAC;IAED,0DAA0D;IAC1D,IAAI,OAA2B,CAAC;IAChC,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE;YACrC,IAAI,EAAE,UAAU;YAChB,OAAO;YACP,YAAY,EAAE,OAAO,CAAC,MAAM;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAEvC,mBAAmB;IACnB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;IAEjD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU;QACV,OAAO;QACP,OAAO;QACP,MAAM;QACN,KAAK;QACL,SAAS;QACT,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,YAAY,EAAE,OAAO,CAAC,QAAQ;KAC/B,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,YAAoB,iBAAiB;IACnF,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,OAAO,CAAC;IAChD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,qBAAqB,CAAC;AAC7D,CAAC"}

package/dist/link-discovery.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Link discovery — finds related wiki pages and adds [[wikilinks]].
+ *
+ * Uses BM25 search to find pages that are semantically related but
+ * not yet linked. Runs as a periodic daemon job or on-demand.
+ *
+ * Strategy:
+ * 1. For each page, search the wiki using its title + key terms
+ * 2. Filter results to pages not already linked
+ * 3. If a related page scores above threshold, add it to ## Connections
+ * 4. Sync frontmatter.links
+ */
+import type { QMDStore } from "./store.js";
+export interface LinkDiscoveryResult {
+    pagesUpdated: number;
+    linksAdded: number;
+    discoveries: Array<{
+        page: string;
+        newLinks: string[];
+    }>;
+}
+export interface LinkDiscoveryOptions {
+    /** Minimum BM25 score to consider a page related (0-1). Default 0.3 */
+    minScore?: number;
+    /** Max new links to add per page per run. Default 5 */
+    maxLinksPerPage?: number;
+    /** Dry run — report but don't write. Default false */
+    dryRun?: boolean;
+}
+/**
+ * Discover and add missing [[wikilinks]] between related pages.
+ *
+ * For each page:
+ * 1. Search wiki using the page's title as query
+ * 2. Find high-scoring pages not already linked
+ * 3. Add them to ## Connections section
+ * 4. Sync frontmatter.links
+ */
+export declare function discoverLinks(wikiDir: string, store: QMDStore, options?: LinkDiscoveryOptions): Promise<LinkDiscoveryResult>;
+//# sourceMappingURL=link-discovery.d.ts.map

package/dist/link-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-discovery.d.ts","sourceRoot":"","sources":["../src/link-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3C,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA+G9B"}

package/dist/link-discovery.js

@@ -0,0 +1,122 @@
+/**
+ * Link discovery — finds related wiki pages and adds [[wikilinks]].
+ *
+ * Uses BM25 search to find pages that are semantically related but
+ * not yet linked. Runs as a periodic daemon job or on-demand.
+ *
+ * Strategy:
+ * 1. For each page, search the wiki using its title + key terms
+ * 2. Filter results to pages not already linked
+ * 3. If a related page scores above threshold, add it to ## Connections
+ * 4. Sync frontmatter.links
+ */
+import { listPages, readPage, writePage, } from "./wiki.js";
+import { searchWiki } from "./store.js";
+import { extractWikilinks, syncFrontmatterLinks } from "./link-utils.js";
+// -- Discovery ---------------------------------------------------------------
+/**
+ * Discover and add missing [[wikilinks]] between related pages.
+ *
+ * For each page:
+ * 1. Search wiki using the page's title as query
+ * 2. Find high-scoring pages not already linked
+ * 3. Add them to ## Connections section
+ * 4. Sync frontmatter.links
+ */
+export async function discoverLinks(wikiDir, store, options) {
+    const minScore = options?.minScore ?? 0.3;
+    const maxLinksPerPage = options?.maxLinksPerPage ?? 5;
+    const dryRun = options?.dryRun ?? false;
+    const refs = await listPages(wikiDir);
+    const pages = [];
+    for (const ref of refs) {
+        const page = await readPage(wikiDir, ref.category, ref.slug);
+        if (page)
+            pages.push(page);
+    }
+    const allSlugs = new Set(pages.map(p => p.slug));
+    const result = {
+        pagesUpdated: 0,
+        linksAdded: 0,
+        discoveries: [],
+    };
+    for (const page of pages) {
+        // Get existing outgoing links
+        const existingLinks = new Set(extractWikilinks(page.body));
+        // Also include frontmatter links
+        for (const l of page.frontmatter.links)
+            existingLinks.add(l);
+        // Search for related pages using title
+        const query = page.frontmatter.title;
+        let related;
+        try {
+            related = await searchWiki(store, query, { limit: 10 });
+        }
+        catch {
+            continue; // search failure — skip this page
+        }
+        // Filter: not self, not already linked, above score threshold
+        const candidates = related
+            .filter(r => r.page.slug !== page.slug &&
+            !existingLinks.has(r.page.slug) &&
+            r.score >= minScore)
+            .slice(0, maxLinksPerPage);
+        if (candidates.length === 0)
+            continue;
+        const newLinks = candidates.map(c => c.page.slug);
+        // Build ## Connections addition
+        const connectionsLines = newLinks.map(slug => {
+            const targetPage = pages.find(p => p.slug === slug);
+            const title = targetPage?.frontmatter.title ?? slug;
+            return `- [[${slug}]] — ${title}`;
+        });
+        // Update page body
+        let newBody = page.body;
+        const hasConnections = /^## Connections/m.test(newBody);
+        if (hasConnections) {
+            // Append to existing Connections section
+            // Find the end of the Connections section (next ## heading or EOF)
+            const connectionsIdx = newBody.indexOf("## Connections");
+            const afterConnections = newBody.indexOf("\n## ", connectionsIdx + 1);
+            const insertPos = afterConnections === -1 ? newBody.length : afterConnections;
+            // Insert before the next section
+            const insertion = "\n" + connectionsLines.join("\n");
+            newBody = newBody.slice(0, insertPos) + insertion + newBody.slice(insertPos);
+        }
+        else {
+            // Add new Connections section at the end (before ## Sources or ## Open Questions if they exist)
+            const sourcesIdx = newBody.indexOf("\n## Sources");
+            const questionsIdx = newBody.indexOf("\n## Open Questions");
+            const insertBefore = Math.min(sourcesIdx === -1 ? Infinity : sourcesIdx, questionsIdx === -1 ? Infinity : questionsIdx);
+            const section = "\n\n## Connections\n" + connectionsLines.join("\n");
+            if (insertBefore === Infinity) {
+                newBody = newBody.trimEnd() + section + "\n";
+            }
+            else {
+                newBody = newBody.slice(0, insertBefore) + section + newBody.slice(insertBefore);
+            }
+        }
+        // Sync frontmatter.links
+        const updatedLinks = syncFrontmatterLinks(newBody);
+        if (!dryRun) {
+            const updatedPage = {
+                ...page,
+                body: newBody,
+                frontmatter: {
+                    ...page.frontmatter,
+                    links: updatedLinks,
+                    updated: new Date().toISOString(),
+                },
+            };
+            await writePage(wikiDir, updatedPage);
+        }
+        result.pagesUpdated++;
+        result.linksAdded += newLinks.length;
+        result.discoveries.push({
+            page: `${page.category}/${page.slug}`,
+            newLinks,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=link-discovery.js.map

package/dist/link-discovery.js.map

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

package/dist/link-utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared wikilink utilities — extraction, auto-linking, and sync.
+ *
+ * Centralizes the [[wikilink]] logic that was duplicated across
+ * tools.ts, lint.ts, processor.ts, and webui/server.ts.
+ */
+/** Extract all [[wikilink]] targets from markdown body. Returns deduplicated slugs. */
+export declare function extractWikilinks(body: string): string[];
+/** Remove [[target]] (and optional display text) from body text. */
+export declare function removeWikilink(body: string, target: string): string;
+/**
+ * Auto-link page slug mentions in body text with [[wikilinks]].
+ *
+ * - Wraps unlinked slug mentions in [[slug]]
+ * - Skips code blocks, URLs, existing [[wikilinks]], headings
+ * - Matches longest slugs first to avoid partial matches
+ * - Uses word-boundary matching (won't match "pi-para" inside "pi-para-daemon")
+ * - Only links each slug once per page (first occurrence) to avoid noise
+ *
+ * @param body - Page body markdown
+ * @param allSlugs - Set of all existing page slugs
+ * @param ownSlug - This page's own slug (excluded from auto-linking)
+ * @returns Updated body with [[wikilinks]] inserted
+ */
+export declare function autoLinkSlugs(body: string, allSlugs: Set<string>, ownSlug?: string): string;
+/**
+ * Sync frontmatter.links to match all [[wikilinks]] found in body text.
+ */
+export declare function syncFrontmatterLinks(body: string): string[];
+//# sourceMappingURL=link-utils.d.ts.map

package/dist/link-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-utils.d.ts","sourceRoot":"","sources":["../src/link-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQvD;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAInE;AAgED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAoDR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D"}

package/dist/link-utils.js

@@ -0,0 +1,145 @@
+/**
+ * Shared wikilink utilities — extraction, auto-linking, and sync.
+ *
+ * Centralizes the [[wikilink]] logic that was duplicated across
+ * tools.ts, lint.ts, processor.ts, and webui/server.ts.
+ */
+// -- Wikilink extraction ----------------------------------------------------
+const WIKILINK_RE = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g;
+/** Extract all [[wikilink]] targets from markdown body. Returns deduplicated slugs. */
+export function extractWikilinks(body) {
+    const links = [];
+    let m;
+    const re = new RegExp(WIKILINK_RE.source, WIKILINK_RE.flags);
+    while ((m = re.exec(body)) !== null) {
+        links.push(m[1].trim());
+    }
+    return [...new Set(links)];
+}
+/** Remove [[target]] (and optional display text) from body text. */
+export function removeWikilink(body, target) {
+    const escaped = target.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const re = new RegExp(`\\[\\[${escaped}(?:\\|[^\\]]+)?\\]\\]`, "g");
+    return body.replace(re, "");
+}
+// -- Auto-linking -----------------------------------------------------------
+/**
+ * Identify regions in markdown body that should NOT be auto-linked.
+ * Returns array of [start, end] ranges to skip.
+ *
+ * Protected regions:
+ * - Fenced code blocks (``` ... ```)
+ * - Inline code (`...`)
+ * - Existing [[wikilinks]]
+ * - URLs (http:// https://)
+ * - YAML frontmatter lines referencing slugs
+ */
+function findProtectedRanges(body) {
+    const ranges = [];
+    // Fenced code blocks
+    const fencedRe = /```[\s\S]*?```/g;
+    let m;
+    while ((m = fencedRe.exec(body)) !== null) {
+        ranges.push([m.index, m.index + m[0].length]);
+    }
+    // Inline code
+    const inlineCodeRe = /`[^`]+`/g;
+    while ((m = inlineCodeRe.exec(body)) !== null) {
+        ranges.push([m.index, m.index + m[0].length]);
+    }
+    // Existing [[wikilinks]]
+    const wlRe = /\[\[[^\]]+\]\]/g;
+    while ((m = wlRe.exec(body)) !== null) {
+        ranges.push([m.index, m.index + m[0].length]);
+    }
+    // URLs
+    const urlRe = /https?:\/\/[^\s)>]+/g;
+    while ((m = urlRe.exec(body)) !== null) {
+        ranges.push([m.index, m.index + m[0].length]);
+    }
+    // Markdown headings (don't wrap slugs in heading lines)
+    const headingRe = /^#{1,6}\s+.*$/gm;
+    while ((m = headingRe.exec(body)) !== null) {
+        ranges.push([m.index, m.index + m[0].length]);
+    }
+    return ranges.sort((a, b) => a[0] - b[0]);
+}
+/**
+ * Check if a position falls inside any protected range.
+ */
+function isProtected(pos, end, ranges) {
+    for (const [rStart, rEnd] of ranges) {
+        if (rStart > end)
+            break; // ranges are sorted
+        if (pos >= rStart && end <= rEnd)
+            return true;
+        if (pos < rEnd && end > rStart)
+            return true; // overlap
+    }
+    return false;
+}
+/**
+ * Auto-link page slug mentions in body text with [[wikilinks]].
+ *
+ * - Wraps unlinked slug mentions in [[slug]]
+ * - Skips code blocks, URLs, existing [[wikilinks]], headings
+ * - Matches longest slugs first to avoid partial matches
+ * - Uses word-boundary matching (won't match "pi-para" inside "pi-para-daemon")
+ * - Only links each slug once per page (first occurrence) to avoid noise
+ *
+ * @param body - Page body markdown
+ * @param allSlugs - Set of all existing page slugs
+ * @param ownSlug - This page's own slug (excluded from auto-linking)
+ * @returns Updated body with [[wikilinks]] inserted
+ */
+export function autoLinkSlugs(body, allSlugs, ownSlug) {
+    if (allSlugs.size === 0)
+        return body;
+    // Sort slugs longest-first so "pi-para-daemon" is matched before "pi-para"
+    const sortedSlugs = [...allSlugs]
+        .filter(s => s !== ownSlug)
+        .sort((a, b) => b.length - a.length);
+    const protectedRanges = findProtectedRanges(body);
+    const linkedSlugs = new Set(extractWikilinks(body));
+    let result = body;
+    for (const slug of sortedSlugs) {
+        // Skip if already linked
+        if (linkedSlugs.has(slug))
+            continue;
+        // Build regex: match slug at word boundaries
+        // Slug chars are [a-z0-9-], so word boundary = not preceded/followed by these chars
+        const escaped = slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        // Use negative lookbehind/lookahead for slug characters
+        const re = new RegExp(`(?<![a-z0-9-])${escaped}(?![a-z0-9-])`, "g");
+        // Re-compute protected ranges for current state of result
+        const currentProtected = findProtectedRanges(result);
+        let match;
+        let linked = false;
+        // Reset regex
+        re.lastIndex = 0;
+        while ((match = re.exec(result)) !== null) {
+            if (linked)
+                break; // only link first occurrence
+            const pos = match.index;
+            const end = pos + match[0].length;
+            if (isProtected(pos, end, currentProtected))
+                continue;
+            // Replace this occurrence with [[slug]]
+            const before = result.slice(0, pos);
+            const after = result.slice(end);
+            const replacement = `[[${slug}]]`;
+            result = before + replacement + after;
+            linked = true;
+            // Update regex index to account for replacement length difference
+            re.lastIndex = pos + replacement.length;
+        }
+    }
+    return result;
+}
+/**
+ * Sync frontmatter.links to match all [[wikilinks]] found in body text.
+ */
+export function syncFrontmatterLinks(body) {
+    return extractWikilinks(body);
+}
+//# sourceMappingURL=link-utils.js.map

package/dist/link-utils.js.map

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

package/dist/lint.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Wiki health checks — validates wiki structure and content integrity.
+ *
+ * Checks for orphan pages, broken links, stale pages, scope drift,
+ * archive candidates, missing pages, frontmatter issues, index drift,
+ * empty categories, and duplicate slugs.
+ *
+ * When autoFix is true (default), fixable issues are repaired in-place:
+ * broken links removed, index rebuilt for drift, missing frontmatter fields set.
+ */
+import type { ParaCategory } from "./wiki.js";
+export interface LintOptions {
+    staleDays?: number;
+    autoFix?: boolean;
+}
+export interface LintReport {
+    issues: LintIssue[];
+    fixed: LintIssue[];
+    stats: WikiStats;
+}
+export interface LintIssue {
+    severity: "error" | "warning" | "info";
+    category: string;
+    page?: string;
+    message: string;
+    autoFixable: boolean;
+}
+export interface WikiStats {
+    totalPages: number;
+    byCategory: Record<ParaCategory, number>;
+    totalLinks: number;
+    brokenLinks: number;
+    orphanPages: number;
+    oldestPage: string;
+    newestPage: string;
+    lastIngest: string;
+}
+export declare function lintWiki(wikiDir: string, options?: LintOptions): Promise<LintReport>;
+//# sourceMappingURL=lint.d.ts.map

package/dist/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,WAAW,CAAC;AAkBjE,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAw1BD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CA2FrB"}