pi-para 0.6.7 → 0.7.1

package/dist/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,eAAO,MAAM,SAAS,+DAGrB,CAAC;AAEF,eAAO,MAAM,qBAAqB,kDAGjC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;EAW3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;EAS1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;EAGzB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAa9B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;EAY1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;EASzB,CAAC;AAEH,eAAO,MAAM,cAAc;;EAIzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;EAKzB,CAAC;AAEH,eAAO,MAAM,cAAc;;EAIzB,CAAC;AAEH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,eAAO,MAAM,mBAAmB;;;EAS9B,CAAC;AAIH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/tools/schemas.js

@@ -0,0 +1,80 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+// -- Parameter schemas -------------------------------------------------------
+export const PARA_ENUM = StringEnum(["projects", "areas", "resources", "archives"], { description: "PARA category" });
+export const PARA_ENUM_NO_ARCHIVES = StringEnum(["projects", "areas", "resources"], { description: "PARA category (archives excluded for new content)" });
+export const WikiIngestParams = Type.Object({
+    source: Type.String({ description: "URL, file path, or raw text to ingest" }),
+    sourceType: Type.Optional(StringEnum(["url", "file", "text"], {
+        description: "Source type (auto-detected if omitted)",
+    })),
+    category: Type.Optional(PARA_ENUM_NO_ARCHIVES),
+    scope: Type.Optional(Type.Array(Type.String(), { description: "Scope tags for the ingested content" })),
+});
+export const WikiQueryParams = Type.Object({
+    query: Type.String({ description: "Natural language search query" }),
+    global: Type.Optional(Type.Boolean({ description: "Search all scopes, not just current project" })),
+    category: Type.Optional(PARA_ENUM),
+    limit: Type.Optional(Type.Number({ description: "Max results (default 10)" })),
+});
+export const WikiEditSchema = Type.Object({
+    oldText: Type.String({ description: "Exact text to find in the page body" }),
+    newText: Type.String({ description: "Replacement text" }),
+});
+export const WikiWritePageSchema = Type.Object({
+    category: PARA_ENUM,
+    slug: Type.String({ description: "Page slug (lowercase, hyphens)" }),
+    title: Type.String({ description: "Page title" }),
+    scope: Type.Array(Type.String(), { description: "Scope tags" }),
+    tags: Type.Array(Type.String(), { description: "Topic tags" }),
+    body: Type.String({ description: "Page body in markdown (wiki summary format)" }),
+    mode: StringEnum(["create", "replace", "append", "edit"], {
+        description: "Write mode: create new, replace existing, append to existing, or edit specific sections",
+    }),
+    edits: Type.Optional(Type.Array(WikiEditSchema, {
+        description: "For mode=edit: targeted text replacements (oldText→newText). Page must exist.",
+    })),
+});
+export const WikiWriteParams = Type.Object({
+    pages: Type.Array(WikiWritePageSchema, {
+        description: "Pages to write or update",
+    }),
+    // DEPRECATED: indexContent is ignored. Index is auto-rebuilt from all pages on disk.
+    // Kept in schema to avoid breaking existing callers.
+    indexContent: Type.Optional(Type.String({ description: "Updated index.md content (full replacement)" })),
+    logSummary: Type.Optional(Type.String({ description: "One-line summary for log.md" })),
+});
+export const WikiEditParams = Type.Object({
+    path: Type.String({ description: "Existing page path (e.g. 'resources/ssl-cert-gotchas')" }),
+    edits: Type.Array(WikiEditSchema, {
+        description: "Atomic exact text replacements. Every oldText must appear exactly once or no changes are written.",
+    }),
+    title: Type.Optional(Type.String({ description: "Optional replacement page title" })),
+    scope: Type.Optional(Type.Array(Type.String(), { description: "Optional replacement scope tags" })),
+    tags: Type.Optional(Type.Array(Type.String(), { description: "Optional replacement topic tags" })),
+    logSummary: Type.Optional(Type.String({ description: "One-line summary for log.md" })),
+});
+export const WikiReadParams = Type.Object({
+    path: Type.String({
+        description: "Page path (e.g. 'projects/auth-refactor') or page title",
+    }),
+});
+export const WikiMoveParams = Type.Object({
+    path: Type.String({
+        description: "Current page path (e.g. 'projects/auth-refactor')",
+    }),
+    to: PARA_ENUM,
+});
+export const WikiLintParams = Type.Object({
+    autoFix: Type.Optional(Type.Boolean({ description: "Auto-fix simple issues (default true)" })),
+});
+export const WikiMigrateParams = Type.Object({});
+export const WikiSummarizeParams = Type.Object({
+    target: Type.String({
+        description: "Page path, category name (e.g. 'projects'), or 'all'",
+    }),
+    depth: Type.Optional(StringEnum(["brief", "detailed"], {
+        description: "Summary depth (default brief)",
+    })),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

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

package/dist/tools/shared.d.ts

@@ -0,0 +1,14 @@
+import type { QMDStore } from "qmd-engine";
+import { type ParaCategory } from "../wiki.js";
+/** Resolve a page path like "projects/auth-refactor" into category + slug. */
+export declare function parsePagePath(path: string): {
+    category: ParaCategory;
+    slug: string;
+} | null;
+/**
+ * Schedule index rebuild + QMD reindex after latency-sensitive edits.
+ * Debounced per wiki directory and coordinated through the scheduler queue so
+ * multiple Pi processes do not run the same maintenance task concurrently.
+ */
+export declare function scheduleWikiMaintenance(wikiDir: string, store: QMDStore, markDirty: () => void): void;
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAIhE,8EAA8E;AAC9E,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUjD;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,IAAI,GACpB,IAAI,CAEN"}

package/dist/tools/shared.js

@@ -0,0 +1,25 @@
+import { enqueueWikiMaintenance } from "../scheduler/index.js";
+import { PARA_CATEGORIES } from "../wiki.js";
+// -- Source resolution helpers -----------------------------------------------
+/** Resolve a page path like "projects/auth-refactor" into category + slug. */
+export function parsePagePath(path) {
+    const parts = path.split("/");
+    if (parts.length === 2) {
+        const cat = parts[0];
+        if (PARA_CATEGORIES.includes(cat)) {
+            const slug = parts[1].replace(/\.md$/, "");
+            return { category: cat, slug };
+        }
+    }
+    return null;
+}
+// -- Background maintenance --------------------------------------------------
+/**
+ * Schedule index rebuild + QMD reindex after latency-sensitive edits.
+ * Debounced per wiki directory and coordinated through the scheduler queue so
+ * multiple Pi processes do not run the same maintenance task concurrently.
+ */
+export function scheduleWikiMaintenance(wikiDir, store, markDirty) {
+    enqueueWikiMaintenance(wikiDir, store, markDirty);
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAqB,MAAM,YAAY,CAAC;AAEhE,+EAA+E;AAE/E,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAC3B,IAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAiB,CAAC;QACrC,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,KAAe,EACf,SAAqB;IAErB,sBAAsB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC"}

package/dist/tools/summarize.d.ts

@@ -0,0 +1,8 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { ProjectScope } from "../scope.js";
+import type { WikiSummarizeDetails } from "./schemas.js";
+export declare function createSummarizeExecute(wikiDir: string, getScope: () => ProjectScope): (params: {
+    target: string;
+    depth?: "brief" | "detailed";
+}) => Promise<AgentToolResult<WikiSummarizeDetails>>;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/tools/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../src/tools/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKzD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,YAAY,IAG1B,QAAQ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CAAE,KACvD,OAAO,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAyElD"}

package/dist/tools/summarize.js

@@ -0,0 +1,82 @@
+import { generateOverviewPrompt } from "../summarize.js";
+import { listPages, readPage, PARA_CATEGORIES } from "../wiki.js";
+import { parsePagePath } from "./shared.js";
+// -- Factory: wiki_summarize execute -----------------------------------------
+export function createSummarizeExecute(wikiDir, getScope) {
+    return async (params) => {
+        const scope = getScope();
+        const pages = [];
+        if (params.target === "all") {
+            // Summarize entire wiki
+            const refs = await listPages(wikiDir);
+            for (const ref of refs) {
+                const page = await readPage(wikiDir, ref.category, ref.slug);
+                if (page)
+                    pages.push(page);
+            }
+        }
+        else if (PARA_CATEGORIES.includes(params.target)) {
+            // Summarize a category
+            const refs = await listPages(wikiDir, params.target);
+            for (const ref of refs) {
+                const page = await readPage(wikiDir, ref.category, ref.slug);
+                if (page)
+                    pages.push(page);
+            }
+        }
+        else {
+            // Summarize a single page
+            const parsed = parsePagePath(params.target);
+            if (parsed) {
+                const page = await readPage(wikiDir, parsed.category, parsed.slug);
+                if (page)
+                    pages.push(page);
+            }
+            else {
+                // Try finding by slug alone across categories
+                const allPages = await listPages(wikiDir);
+                const targetLower = params.target.toLowerCase();
+                for (const ref of allPages) {
+                    if (ref.slug === targetLower || ref.title.toLowerCase() === targetLower) {
+                        const page = await readPage(wikiDir, ref.category, ref.slug);
+                        if (page)
+                            pages.push(page);
+                        break;
+                    }
+                }
+            }
+        }
+        if (pages.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No pages found for target "${params.target}". Nothing to summarize.`,
+                    },
+                ],
+                details: { target: params.target, pageCount: 0 },
+            };
+        }
+        // Generate a bounded overview prompt for the LLM. For large targets like
+        // `all`, brief mode must not dump every full page body into model context.
+        const depth = params.depth ?? "brief";
+        const overviewPrompt = generateOverviewPrompt(pages, scope, { depth });
+        const depthNote = depth === "detailed"
+            ? "\nProvide a DETAILED summary with full Key Facts, Insights, and Connections for each theme."
+            : "\nProvide a BRIEF overview — one paragraph per theme, focus on high-level patterns.";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: overviewPrompt + depthNote +
+                        "\n\nYou may optionally create a summary page via wiki_write if the overview is worth preserving.",
+                },
+            ],
+            details: {
+                target: params.target,
+                pageCount: pages.length,
+            },
+        };
+    };
+}
+//# sourceMappingURL=summarize.js.map

package/dist/tools/summarize.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,23 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { QMDStore } from "qmd-engine";
+import type { ProjectScope } from "../scope.js";
+import { type ParaCategory } from "../wiki.js";
+import type { WikiWriteDetails } from "./schemas.js";
+export declare function createWriteExecute(wikiDir: string, store: QMDStore, getScope: () => ProjectScope, markDirty: () => void): (params: {
+    pages: Array<{
+        category: ParaCategory;
+        slug: string;
+        title: string;
+        scope: string[];
+        tags: string[];
+        body: string;
+        mode: "create" | "replace" | "append" | "edit";
+        edits?: Array<{
+            oldText: string;
+            newText: string;
+        }>;
+    }>;
+    indexContent?: string;
+    logSummary?: string;
+}) => Promise<AgentToolResult<WikiWriteDetails>>;
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,EAA0E,KAAK,YAAY,EAAiB,MAAM,YAAY,CAAC;AACtI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,YAAY,EAC5B,SAAS,EAAE,MAAM,IAAI,IAGnB,QAAQ;IACN,KAAK,EAAE,KAAK,CAAC;QACX,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;QACb,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC/C,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,KACA,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAyN9C"}

package/dist/tools/write.js

@@ -0,0 +1,215 @@
+import { normalizeTags, normalizeScopes } from "../tag-registry.js";
+import { redactSecrets } from "../redact.js";
+import { autoLinkSlugs, syncFrontmatterLinks } from "../link-utils.js";
+import { validateFrontmatter } from "../frontmatter.js";
+import { appendLog, gitCommit, listPageSlugs, readPage, rebuildIndex, writePage } from "../wiki.js";
+import { scheduleWikiMaintenance } from "./shared.js";
+// -- Factory: wiki_write execute ---------------------------------------------
+export function createWriteExecute(wikiDir, store, getScope, markDirty) {
+    return async (params) => {
+        const pagesWritten = [];
+        const pagesSkipped = [];
+        const now = new Date().toISOString();
+        const scope = getScope();
+        // Gather all existing slugs for auto-linking (slug-only readdir scan;
+        // reading/parsing every page here made wiki_write scale poorly)
+        const allSlugs = await listPageSlugs(wikiDir);
+        for (const pageSpec of params.pages) {
+            // Sanitize slug
+            const slug = pageSpec.slug
+                .toLowerCase()
+                .replace(/[^a-z0-9-]/g, "-")
+                .replace(/-+/g, "-")
+                .replace(/^-|-$/g, "");
+            if (!slug) {
+                continue; // skip invalid slugs
+            }
+            const existing = await readPage(wikiDir, pageSpec.category, slug);
+            const pagePath = `${pageSpec.category}/${slug}`;
+            // Track this slug for auto-linking other pages in this batch
+            allSlugs.add(slug);
+            if (pageSpec.mode === "create" && existing) {
+                pagesSkipped.push(`${pagePath} (already exists; use mode=replace, mode=append, or wiki_edit)`);
+                continue;
+            }
+            if (pageSpec.mode === "edit" && !existing) {
+                pagesSkipped.push(`${pagePath} (missing; wiki_write mode=edit requires an existing page)`);
+                continue;
+            }
+            if (pageSpec.mode === "edit" && existing) {
+                // Legacy edit mode: keep for compatibility, but make it atomic like wiki_edit.
+                const edits = pageSpec.edits ?? [];
+                if (edits.length === 0) {
+                    continue; // no edits to apply
+                }
+                const errors = [];
+                for (const edit of edits) {
+                    const first = existing.body.indexOf(edit.oldText);
+                    const last = existing.body.lastIndexOf(edit.oldText);
+                    if (first === -1) {
+                        errors.push(`oldText not found: "${edit.oldText.slice(0, 60)}..."`);
+                    }
+                    else if (first !== last) {
+                        errors.push(`oldText is not unique: "${edit.oldText.slice(0, 60)}..."`);
+                    }
+                }
+                if (errors.length > 0) {
+                    pagesSkipped.push(`${pagePath} (${errors.join("; ")})`);
+                    continue;
+                }
+                let editedBody = existing.body;
+                for (const edit of edits) {
+                    editedBody = editedBody.replace(edit.oldText, edit.newText);
+                }
+                const linkedBody = redactSecrets(autoLinkSlugs(editedBody, allSlugs, slug)).text;
+                const rawScope = pageSpec.scope.length > 0 ? pageSpec.scope : existing.frontmatter.scope;
+                const newScope = normalizeScopes(rawScope);
+                const newTags = pageSpec.tags.length > 0 ? pageSpec.tags : existing.frontmatter.tags;
+                const updatedPage = {
+                    category: pageSpec.category,
+                    slug,
+                    frontmatter: {
+                        ...existing.frontmatter,
+                        title: pageSpec.title || existing.frontmatter.title,
+                        scope: newScope,
+                        tags: normalizeTags(newTags, newScope),
+                        updated: now,
+                        links: syncFrontmatterLinks(linkedBody),
+                    },
+                    body: linkedBody,
+                };
+                await writePage(wikiDir, updatedPage);
+                pagesWritten.push(pagePath + (errors.length > 0 ? ` (${errors.length} edit(s) failed)` : ""));
+            }
+            else if (pageSpec.mode === "append" && existing) {
+                // Append to existing page body
+                const combinedBody = existing.body.trimEnd() + "\n\n" + pageSpec.body;
+                const linkedBody = redactSecrets(autoLinkSlugs(combinedBody, allSlugs, slug)).text;
+                const mergedTags = [...new Set([...existing.frontmatter.tags, ...pageSpec.tags])];
+                const mergedScope = normalizeScopes([...new Set([...existing.frontmatter.scope, ...pageSpec.scope])]);
+                const updatedPage = {
+                    ...existing,
+                    body: linkedBody,
+                    frontmatter: {
+                        ...existing.frontmatter,
+                        updated: now,
+                        tags: normalizeTags(mergedTags, mergedScope),
+                        scope: mergedScope,
+                        links: syncFrontmatterLinks(linkedBody),
+                    },
+                };
+                await writePage(wikiDir, updatedPage);
+                pagesWritten.push(pagePath);
+            }
+            else if (pageSpec.mode === "replace" && existing) {
+                // Replace existing page body, update frontmatter
+                const linkedBody = redactSecrets(autoLinkSlugs(pageSpec.body, allSlugs, slug)).text;
+                const rawScope = pageSpec.scope.length > 0 ? pageSpec.scope : existing.frontmatter.scope;
+                const newScope = normalizeScopes(rawScope);
+                const newTags = pageSpec.tags.length > 0 ? pageSpec.tags : existing.frontmatter.tags;
+                const updatedPage = {
+                    category: pageSpec.category,
+                    slug,
+                    frontmatter: {
+                        ...existing.frontmatter,
+                        title: pageSpec.title,
+                        para: pageSpec.category,
+                        scope: newScope,
+                        tags: normalizeTags(newTags, newScope),
+                        updated: now,
+                        links: syncFrontmatterLinks(linkedBody),
+                    },
+                    body: linkedBody,
+                };
+                await writePage(wikiDir, updatedPage);
+                pagesWritten.push(pagePath);
+            }
+            else {
+                // Create new page (or mode=create/replace on non-existing)
+                const linkedBody = redactSecrets(autoLinkSlugs(pageSpec.body, allSlugs, slug)).text;
+                const rawScope = pageSpec.scope.length > 0 ? pageSpec.scope : [scope.name];
+                const newScope = normalizeScopes(rawScope);
+                const frontmatter = validateFrontmatter({
+                    title: pageSpec.title,
+                    para: pageSpec.category,
+                    scope: newScope,
+                    tags: normalizeTags(pageSpec.tags, newScope),
+                    sources: [],
+                    created: now,
+                    updated: now,
+                    links: syncFrontmatterLinks(linkedBody),
+                });
+                const newPage = {
+                    category: pageSpec.category,
+                    slug,
+                    frontmatter,
+                    body: linkedBody,
+                };
+                await writePage(wikiDir, newPage);
+                pagesWritten.push(pagePath);
+            }
+        }
+        // Always auto-rebuild index from disk.
+        // The LLM's indexContent is unreliable — it only knows about pages
+        // in its context, so it produces partial indexes that overwrite
+        // the full one. indexContent parameter is deprecated and ignored.
+        let indexUpdated = false;
+        if (pagesWritten.length > 0) {
+            await rebuildIndex(wikiDir);
+            indexUpdated = true;
+        }
+        // Append to log.md if summary provided
+        let logAppended = false;
+        if (params.logSummary && pagesWritten.length > 0) {
+            await appendLog(wikiDir, {
+                date: now.split("T")[0],
+                operation: "ingest",
+                summary: params.logSummary,
+                pages: pagesWritten,
+            });
+            logAppended = true;
+        }
+        // Defer QMD BM25 reindex to the debounced background maintenance queue
+        // (same as wiki_edit). Immediate post-write queries are safe: queryWiki
+        // retries with a fresh store.update() before returning zero results.
+        if (pagesWritten.length > 0) {
+            scheduleWikiMaintenance(wikiDir, store, markDirty);
+        }
+        // Mark context cache dirty so before_agent_start rebuilds
+        markDirty();
+        // Git auto-commit
+        if (pagesWritten.length > 0) {
+            const commitMsg = params.logSummary
+                ? params.logSummary
+                : `wiki: ${pagesWritten.join(", ")}`;
+            await gitCommit(wikiDir, commitMsg);
+        }
+        const summary = [
+            pagesWritten.length > 0
+                ? `Wrote ${pagesWritten.length} page(s): ${pagesWritten.join(", ")}`
+                : "No pages written.",
+            pagesSkipped.length > 0 ? `Skipped ${pagesSkipped.length} page(s): ${pagesSkipped.join(", ")}` : "",
+        ].filter(Boolean).join("\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        summary,
+                        indexUpdated ? "Updated index.md." : "",
+                        logAppended ? `Logged: ${params.logSummary}` : "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n"),
+                },
+            ],
+            details: {
+                pagesWritten,
+                indexUpdated,
+                logAppended,
+                pagesSkipped,
+            },
+        };
+    };
+}
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

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

package/dist/tools.d.ts

@@ -1,11 +1,4 @@
-/**
- * Tool registrations — wiki tools for both pi's session agent and standalone mini-agent.
- *
- * Tool implementations are shared between both consumers. Only the registration
- * wrapper differs (pi.registerTool vs AgentTool).
- *
- * Factory functions (createXxxExecute) close over wikiDir and store — no ctx dependency.
- */
+/** Tool registration composition for pi sessions and standalone mini-agents. */
 import type { AgentTool } from "@earendil-works/pi-agent-core";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { QMDStore } from "qmd-engine";

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAghC/C;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,YAAY,EAC5B,SAAS,EAAE,MAAM,IAAI,EACrB,aAAa,CAAC,EAAE,MAAM,OAAO,EAC7B,aAAa,CAAC,EAAE,MAAM;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D,IAAI,CAiWN;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,YAAY,EAC5B,SAAS,CAAC,EAAE,MAAM,IAAI,GACrB,SAAS,EAAE,CAiDb"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqB/C;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,YAAY,EAC5B,SAAS,EAAE,MAAM,IAAI,EACrB,aAAa,CAAC,EAAE,MAAM,OAAO,EAC7B,aAAa,CAAC,EAAE,MAAM;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D,IAAI,CAiWN;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,YAAY,EAC5B,SAAS,CAAC,EAAE,MAAM,IAAI,GACrB,SAAS,EAAE,CAiDb"}