pi-para 0.6.7 → 0.7.1

package/dist/tools/edit-read.js

@@ -0,0 +1,161 @@
+import { formatFreshness } from "../query.js";
+import { autoLinkSlugs, syncFrontmatterLinks } from "../link-utils.js";
+import { normalizeTags, normalizeScopes } from "../tag-registry.js";
+import { redactSecrets } from "../redact.js";
+import { appendLog, gitCommit, listPages, readIndex, readPage, writePage } from "../wiki.js";
+import { parsePagePath, scheduleWikiMaintenance } from "./shared.js";
+// -- Factory: wiki_read execute ----------------------------------------------
+export function createEditExecute(wikiDir, store, markDirty) {
+    return async (params) => {
+        const parsed = parsePagePath(params.path);
+        if (!parsed) {
+            return {
+                content: [{ type: "text", text: `Invalid page path: ${params.path}` }],
+                details: { pagesWritten: [], pagesSkipped: [params.path], indexUpdated: false, logAppended: false },
+            };
+        }
+        const existing = await readPage(wikiDir, parsed.category, parsed.slug);
+        const pagePath = `${parsed.category}/${parsed.slug}`;
+        if (!existing) {
+            return {
+                content: [{ type: "text", text: `Page not found: ${pagePath}` }],
+                details: { pagesWritten: [], pagesSkipped: [pagePath], indexUpdated: false, logAppended: false },
+            };
+        }
+        if (params.edits.length === 0) {
+            return {
+                content: [{ type: "text", text: "No edits supplied." }],
+                details: { pagesWritten: [], pagesSkipped: [pagePath], indexUpdated: false, logAppended: false },
+            };
+        }
+        // Atomic validation: all oldText strings must exist exactly once before writing.
+        const errors = [];
+        for (const edit of params.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) {
+            return {
+                content: [{ type: "text", text: `No changes written.\n${errors.join("\n")}` }],
+                details: { pagesWritten: [], pagesSkipped: [pagePath], indexUpdated: false, logAppended: false },
+            };
+        }
+        let editedBody = existing.body;
+        for (const edit of params.edits) {
+            editedBody = editedBody.replace(edit.oldText, edit.newText);
+        }
+        // Surgical edit path: do not scan/autolink/rebuild/reindex the whole wiki.
+        // wiki_edit is often called mid-task and must stay fast; broader maintenance
+        // can run via wiki_lint/rebuildIndex or on startup.
+        const linkedBody = redactSecrets(editedBody).text;
+        const now = new Date().toISOString();
+        const rawScope = params.scope ?? existing.frontmatter.scope;
+        const newScope = normalizeScopes(rawScope);
+        const rawTags = params.tags ?? existing.frontmatter.tags;
+        const updatedPage = {
+            category: parsed.category,
+            slug: parsed.slug,
+            frontmatter: {
+                ...existing.frontmatter,
+                title: params.title ?? existing.frontmatter.title,
+                scope: newScope,
+                tags: normalizeTags(rawTags, newScope),
+                updated: now,
+                links: syncFrontmatterLinks(linkedBody),
+            },
+            body: linkedBody,
+        };
+        await writePage(wikiDir, updatedPage);
+        if (params.logSummary) {
+            await appendLog(wikiDir, {
+                date: now.split("T")[0],
+                operation: "edit",
+                summary: params.logSummary,
+                pages: [pagePath],
+            });
+        }
+        markDirty();
+        await gitCommit(wikiDir, params.logSummary ?? `wiki_edit: ${pagePath}`);
+        scheduleWikiMaintenance(wikiDir, store, markDirty);
+        return {
+            content: [{ type: "text", text: `Edited ${pagePath}. Scheduled background index/search refresh.` }],
+            details: {
+                pagesWritten: [pagePath],
+                pagesSkipped: [],
+                indexUpdated: false,
+                logAppended: !!params.logSummary,
+            },
+        };
+    };
+}
+export function createReadExecute(wikiDir) {
+    return async (params) => {
+        const now = Date.now();
+        const normalizedPath = params.path.trim().toLowerCase().replace(/^\/+/, "");
+        if (normalizedPath === "index" || normalizedPath === "index.md" || normalizedPath === "wiki-index") {
+            const index = await readIndex(wikiDir);
+            return {
+                content: [{ type: "text", text: index }],
+                details: { found: true, path: "index.md" },
+            };
+        }
+        // Try parsing as category/slug path
+        const parsed = parsePagePath(params.path);
+        if (parsed) {
+            const page = await readPage(wikiDir, parsed.category, parsed.slug);
+            if (page) {
+                const fm = page.frontmatter;
+                const freshness = formatFreshness(fm.updated, now);
+                const header = [
+                    `# ${fm.title}`,
+                    `PARA: ${fm.para} | Scope: ${fm.scope.join(", ")} | Tags: ${fm.tags.join(", ")}`,
+                    `Created: ${fm.created} | Updated: ${fm.updated} | ${freshness}`,
+                    fm.sources.length > 0 ? `Sources: ${fm.sources.join(", ")}` : "",
+                    fm.links.length > 0 ? `Links: ${fm.links.map((l) => `[[${l}]]`).join(", ")}` : "",
+                ]
+                    .filter(Boolean)
+                    .join("\n");
+                return {
+                    content: [{ type: "text", text: `${header}\n\n${page.body}` }],
+                    details: { found: true, path: `${parsed.category}/${parsed.slug}` },
+                };
+            }
+        }
+        // Try finding by title (case-insensitive search across all pages)
+        const allPages = await listPages(wikiDir);
+        const titleLower = params.path.toLowerCase();
+        for (const ref of allPages) {
+            if (ref.title.toLowerCase() === titleLower || ref.slug === titleLower) {
+                const page = await readPage(wikiDir, ref.category, ref.slug);
+                if (page) {
+                    const fm = page.frontmatter;
+                    const freshness = formatFreshness(fm.updated, now);
+                    const header = [
+                        `# ${fm.title}`,
+                        `PARA: ${fm.para} | Scope: ${fm.scope.join(", ")} | Tags: ${fm.tags.join(", ")}`,
+                        `Created: ${fm.created} | Updated: ${fm.updated} | ${freshness}`,
+                        fm.sources.length > 0 ? `Sources: ${fm.sources.join(", ")}` : "",
+                        fm.links.length > 0 ? `Links: ${fm.links.map((l) => `[[${l}]]`).join(", ")}` : "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n");
+                    return {
+                        content: [{ type: "text", text: `${header}\n\n${page.body}` }],
+                        details: { found: true, path: `${ref.category}/${ref.slug}` },
+                    };
+                }
+            }
+        }
+        return {
+            content: [{ type: "text", text: `Page not found: "${params.path}"` }],
+            details: { found: false },
+        };
+    };
+}
+//# sourceMappingURL=edit-read.js.map

package/dist/tools/edit-read.js.map

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

package/dist/tools/ingest.d.ts

@@ -0,0 +1,12 @@
+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 { WikiIngestDetails } from "./schemas.js";
+export declare function createIngestExecute(wikiDir: string, _store: QMDStore, getScope: () => ProjectScope): (params: {
+    source: string;
+    sourceType?: "url" | "file" | "text";
+    category?: ParaCategory;
+    scope?: string[];
+}) => Promise<AgentToolResult<WikiIngestDetails>>;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/tools/ingest.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;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,MAAM,YAAY,IAG1B,QAAQ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,KAC1G,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CA6C/C"}

package/dist/tools/ingest.js

@@ -0,0 +1,48 @@
+import { resolveSource, truncateSource } from "../ingest.js";
+import { INGEST_PROMPT } from "../templates/prompts.js";
+// -- Factory: wiki_ingest execute --------------------------------------------
+export function createIngestExecute(wikiDir, _store, getScope) {
+    return async (params) => {
+        const scope = getScope();
+        const resolved = await resolveSource(wikiDir, {
+            source: params.source,
+            sourceType: params.sourceType,
+            scope: params.scope,
+            category: params.category,
+        }, scope);
+        const categoryHint = resolved.categoryHint
+            ? `\nSuggested PARA category: ${resolved.categoryHint}`
+            : "";
+        // Assemble the tool result with instructions for the LLM
+        const toolResultText = [
+            INGEST_PROMPT,
+            "",
+            `Current scope: ${resolved.scopeName} (tags: ${resolved.scopeTags.join(", ")})`,
+            categoryHint,
+            resolved.rawPath ? `Raw source saved to: ${resolved.rawPath}` : "",
+            "",
+            "<wiki-schema>",
+            resolved.schema,
+            "</wiki-schema>",
+            "",
+            "<wiki-index>",
+            resolved.index,
+            "</wiki-index>",
+            "",
+            "<source-content>",
+            truncateSource(resolved.content),
+            "</source-content>",
+            "",
+            "Now analyze the source content and use wiki_write to create/update pages, update the index, and log the operation.",
+        ].join("\n");
+        return {
+            content: [{ type: "text", text: toolResultText }],
+            details: {
+                sourceType: resolved.sourceType,
+                rawPath: resolved.rawPath,
+                sourceLength: resolved.content.length,
+            },
+        };
+    };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/tools/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../src/tools/ingest.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,+EAA+E;AAE/E,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,MAAgB,EAChB,QAA4B;IAE5B,OAAO,KAAK,EACV,MAA2G,EAC9D,EAAE;QAC/C,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE;YAC5C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,EAAE,KAAK,CAAC,CAAC;QAEV,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY;YACxC,CAAC,CAAC,8BAA8B,QAAQ,CAAC,YAAY,EAAE;YACvD,CAAC,CAAC,EAAE,CAAC;QAEP,yDAAyD;QACzD,MAAM,cAAc,GAAG;YACrB,aAAa;YACb,EAAE;YACF,kBAAkB,QAAQ,CAAC,SAAS,WAAW,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC/E,YAAY;YACZ,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;YAClE,EAAE;YACF,eAAe;YACf,QAAQ,CAAC,MAAM;YACf,gBAAgB;YAChB,EAAE;YACF,cAAc;YACd,QAAQ,CAAC,KAAK;YACd,eAAe;YACf,EAAE;YACF,kBAAkB;YAClB,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC;YAChC,mBAAmB;YACnB,EAAE;YACF,oHAAoH;SACrH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;YACjD,OAAO,EAAE;gBACP,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;aACtC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/lint.d.ts

@@ -0,0 +1,10 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { QMDStore } from "qmd-engine";
+import type { WikiLintDetails } from "./schemas.js";
+export declare function createLintExecute(wikiDir: string, store: QMDStore, markDirty: () => void, getLintConfig?: () => {
+    autoFix: boolean;
+    staleDays: number;
+}): (params: {
+    autoFix?: boolean;
+}) => Promise<AgentToolResult<WikiLintDetails>>;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/tools/lint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,IAAI,EACrB,aAAa,CAAC,EAAE,MAAM;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,IAG3D,QAAQ;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAC5B,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAuD7C"}

package/dist/tools/lint.js

@@ -0,0 +1,57 @@
+import { lintWiki } from "../lint.js";
+import { PARA_CATEGORIES } from "../wiki.js";
+import { LINT_PROMPT } from "../templates/prompts.js";
+import { scheduleWikiMaintenance } from "./shared.js";
+// -- Factory: wiki_lint execute ----------------------------------------------
+export function createLintExecute(wikiDir, store, markDirty, getLintConfig) {
+    return async (params) => {
+        const configured = getLintConfig?.();
+        const report = await lintWiki(wikiDir, {
+            autoFix: params.autoFix ?? configured?.autoFix ?? true,
+            staleDays: configured?.staleDays ?? 90,
+        });
+        if (report.fixed.length > 0) {
+            scheduleWikiMaintenance(wikiDir, store, markDirty);
+        }
+        const { issues, fixed, stats } = report;
+        // Format report for the LLM
+        const parts = [];
+        parts.push("## Wiki Lint Report\n");
+        parts.push(`Total pages: ${stats.totalPages}`);
+        parts.push(`By category: ${PARA_CATEGORIES.map((c) => `${c}: ${stats.byCategory[c]}`).join(", ")}`);
+        parts.push(`Total links: ${stats.totalLinks} (broken: ${stats.brokenLinks})`);
+        parts.push(`Orphan pages: ${stats.orphanPages}`);
+        if (stats.oldestPage)
+            parts.push(`Oldest page: ${stats.oldestPage}`);
+        if (stats.newestPage)
+            parts.push(`Newest page: ${stats.newestPage}`);
+        if (stats.lastIngest)
+            parts.push(`Last ingest: ${stats.lastIngest}`);
+        if (fixed.length > 0) {
+            parts.push(`\n## Auto-fixed (${fixed.length})\n`);
+            for (const f of fixed) {
+                parts.push(`- [${f.severity}] ${f.page ?? ""}: ${f.message}`);
+            }
+        }
+        if (issues.length > 0) {
+            parts.push(`\n## Remaining Issues (${issues.length})\n`);
+            for (const issue of issues) {
+                parts.push(`- [${issue.severity}] ${issue.category}${issue.page ? ` (${issue.page})` : ""}: ${issue.message}`);
+            }
+            parts.push("");
+            parts.push(LINT_PROMPT);
+        }
+        else {
+            parts.push("\nNo remaining issues. Wiki is healthy.");
+        }
+        return {
+            content: [{ type: "text", text: parts.join("\n") }],
+            details: {
+                issueCount: issues.length,
+                fixedCount: fixed.length,
+                stats,
+            },
+        };
+    };
+}
+//# sourceMappingURL=lint.js.map

package/dist/tools/lint.js.map

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

package/dist/tools/migrate.d.ts

@@ -0,0 +1,6 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+export declare function createMigrateExecute(wikiDir: string): () => Promise<AgentToolResult<{
+    migratedCount: number;
+    totalPages: number;
+}>>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/tools/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMrE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,SAEE,OAAO,CAAC,eAAe,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkCzF"}

package/dist/tools/migrate.js

@@ -0,0 +1,36 @@
+import { CURRENT_SCHEMA_VERSION, migrateToLatest } from "../frontmatter.js";
+import { listPages, readPage, writePage } from "../wiki.js";
+// -- Factory: wiki_migrate execute -------------------------------------------
+export function createMigrateExecute(wikiDir) {
+    return async () => {
+        const allRefs = await listPages(wikiDir);
+        let migratedCount = 0;
+        for (const ref of allRefs) {
+            const page = await readPage(wikiDir, ref.category, ref.slug);
+            if (!page)
+                continue;
+            const version = page.frontmatter.schemaVersion ?? 1;
+            if (version >= CURRENT_SCHEMA_VERSION)
+                continue;
+            const rawObj = page.frontmatter;
+            const result = migrateToLatest(rawObj, page.body);
+            const migratedFm = result.fm;
+            migratedFm.updated = new Date().toISOString();
+            await writePage(wikiDir, {
+                category: ref.category,
+                slug: ref.slug,
+                frontmatter: migratedFm,
+                body: result.body,
+            });
+            migratedCount++;
+        }
+        const summary = migratedCount > 0
+            ? `Migrated ${migratedCount} page(s) to schema version ${CURRENT_SCHEMA_VERSION}.`
+            : `All ${allRefs.length} page(s) already at schema version ${CURRENT_SCHEMA_VERSION}.`;
+        return {
+            content: [{ type: "text", text: summary }],
+            details: { migratedCount, totalPages: allRefs.length },
+        };
+    };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/tools/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/tools/migrate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAwB,MAAM,YAAY,CAAC;AAElF,+EAA+E;AAE/E,MAAM,UAAU,oBAAoB,CAClC,OAAe;IAEf,OAAO,KAAK,IAA6E,EAAE;QACzF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,IAAI,CAAC,CAAC;YACpD,IAAI,OAAO,IAAI,sBAAsB;gBAAE,SAAS;YAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAiD,CAAC;YACtE,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAElD,MAAM,UAAU,GAAG,MAAM,CAAC,EAAgC,CAAC;YAC3D,UAAU,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,SAAS,CAAC,OAAO,EAAE;gBACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;YACH,aAAa,EAAE,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,GAAG,CAAC;YAC/B,CAAC,CAAC,YAAY,aAAa,8BAA8B,sBAAsB,GAAG;YAClF,CAAC,CAAC,OAAO,OAAO,CAAC,MAAM,sCAAsC,sBAAsB,GAAG,CAAC;QAEzF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1C,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE;SACvD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/move.d.ts

@@ -0,0 +1,9 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { QMDStore } from "qmd-engine";
+import { type ParaCategory } from "../wiki.js";
+import type { WikiMoveDetails } from "./schemas.js";
+export declare function createMoveExecute(wikiDir: string, store: QMDStore, markDirty: () => void): (params: {
+    path: string;
+    to: ParaCategory;
+}) => Promise<AgentToolResult<WikiMoveDetails>>;
+//# sourceMappingURL=move.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","sourceRoot":"","sources":["../../src/tools/move.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAwE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACrH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,IAAI,IAGnB,QAAQ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,YAAY,CAAA;CAAE,KACzC,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CA+D7C"}

package/dist/tools/move.js

@@ -0,0 +1,61 @@
+import { appendLog, gitCommit, movePage, readPage, rebuildIndex } from "../wiki.js";
+import { parsePagePath, scheduleWikiMaintenance } from "./shared.js";
+// -- Factory: wiki_move execute ----------------------------------------------
+export function createMoveExecute(wikiDir, store, markDirty) {
+    return async (params) => {
+        const parsed = parsePagePath(params.path);
+        if (!parsed) {
+            throw new Error(`Invalid page path: "${params.path}". Expected format: category/slug`);
+        }
+        const page = await readPage(wikiDir, parsed.category, parsed.slug);
+        if (!page) {
+            throw new Error(`Page not found: "${params.path}"`);
+        }
+        if (parsed.category === params.to) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Page "${params.path}" is already in ${params.to}. No move needed.`,
+                    },
+                ],
+                details: { from: params.path, to: `${params.to}/${parsed.slug}` },
+            };
+        }
+        const ref = {
+            category: parsed.category,
+            slug: parsed.slug,
+            title: page.frontmatter.title,
+            path: `${parsed.category}/${parsed.slug}.md`,
+        };
+        await movePage(wikiDir, ref, params.to);
+        // Rebuild index.md inline (fast, single-pass); defer QMD reindex to the
+        // debounced background maintenance queue like wiki_write/wiki_edit.
+        await rebuildIndex(wikiDir);
+        scheduleWikiMaintenance(wikiDir, store, markDirty);
+        markDirty();
+        // Git commit
+        await gitCommit(wikiDir, `move: ${page.frontmatter.title} → ${params.to}`);
+        // Log the move
+        const now = new Date().toISOString();
+        await appendLog(wikiDir, {
+            date: now.split("T")[0],
+            operation: "move",
+            summary: `Moved ${page.frontmatter.title} from ${parsed.category} to ${params.to}`,
+            pages: [`${params.to}/${parsed.slug}`],
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Moved "${page.frontmatter.title}" from ${parsed.category}/ to ${params.to}/`,
+                },
+            ],
+            details: {
+                from: `${parsed.category}/${parsed.slug}`,
+                to: `${params.to}/${parsed.slug}`,
+            },
+        };
+    };
+}
+//# sourceMappingURL=move.js.map

package/dist/tools/move.js.map

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

package/dist/tools/query.d.ts

@@ -0,0 +1,12 @@
+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 { WikiQueryDetails } from "./schemas.js";
+export declare function createQueryExecute(_wikiDir: string, store: QMDStore, getScope: () => ProjectScope, getGraphBoost?: () => boolean): (params: {
+    query: string;
+    global?: boolean;
+    category?: ParaCategory;
+    limit?: number;
+}) => Promise<AgentToolResult<WikiQueryDetails>>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.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;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIrD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,YAAY,EAC5B,aAAa,CAAC,EAAE,MAAM,OAAO,IAG3B,QAAQ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACnF,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CA4C9C"}

package/dist/tools/query.js

@@ -0,0 +1,47 @@
+import { queryWiki as queryWikiLib, formatQueryResults } from "../query.js";
+import { QUERY_PROMPT } from "../templates/prompts.js";
+// -- Factory: wiki_query execute ---------------------------------------------
+export function createQueryExecute(_wikiDir, store, getScope, getGraphBoost) {
+    return async (params) => {
+        const scope = getScope();
+        const result = await queryWikiLib(store, {
+            query: params.query,
+            global: params.global,
+            category: params.category,
+            limit: params.limit,
+            graphBoost: getGraphBoost?.() ?? true,
+        }, scope);
+        if (result.results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No wiki pages found for "${params.query}". The wiki may not have content on this topic yet.`,
+                    },
+                ],
+                details: {
+                    resultCount: 0,
+                    scopeUsed: result.wasGlobal ? "global" : scope.name,
+                },
+            };
+        }
+        const formatted = formatQueryResults(result.results);
+        const toolResultText = [
+            QUERY_PROMPT,
+            "",
+            `Query: "${params.query}"`,
+            `Scope: ${result.wasGlobal ? "global (all scopes)" : scope.name}`,
+            `Results: ${result.results.length}`,
+            "",
+            formatted,
+        ].join("\n");
+        return {
+            content: [{ type: "text", text: toolResultText }],
+            details: {
+                resultCount: result.results.length,
+                scopeUsed: result.wasGlobal ? "global" : scope.name,
+            },
+        };
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/tools/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,IAAI,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,KAAe,EACf,QAA4B,EAC5B,aAA6B;IAE7B,OAAO,KAAK,EACV,MAAoF,EACxC,EAAE;QAC9C,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE;YACvC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,aAAa,EAAE,EAAE,IAAI,IAAI;SACtC,EAAE,KAAK,CAAC,CAAC;QAEV,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4BAA4B,MAAM,CAAC,KAAK,qDAAqD;qBACpG;iBACF;gBACD,OAAO,EAAE;oBACP,WAAW,EAAE,CAAC;oBACd,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;iBACpD;aACF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG;YACrB,YAAY;YACZ,EAAE;YACF,WAAW,MAAM,CAAC,KAAK,GAAG;YAC1B,UAAU,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE;YACjE,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE;YACnC,EAAE;YACF,SAAS;SACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;YACjD,OAAO,EAAE;gBACP,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBAClC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;aACpD;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,109 @@
+import { Type } from "typebox";
+import type { LintReport } from "../lint.js";
+export declare const PARA_ENUM: Type.TUnsafe<"projects" | "areas" | "resources" | "archives">;
+export declare const PARA_ENUM_NO_ARCHIVES: Type.TUnsafe<"projects" | "areas" | "resources">;
+export declare const WikiIngestParams: Type.TObject<{
+    source: Type.TString;
+    sourceType: Type.TOptional<Type.TUnsafe<"url" | "file" | "text">>;
+    category: Type.TOptional<Type.TUnsafe<"projects" | "areas" | "resources">>;
+    scope: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export declare const WikiQueryParams: Type.TObject<{
+    query: Type.TString;
+    global: Type.TOptional<Type.TBoolean>;
+    category: Type.TOptional<Type.TUnsafe<"projects" | "areas" | "resources" | "archives">>;
+    limit: Type.TOptional<Type.TNumber>;
+}>;
+export declare const WikiEditSchema: Type.TObject<{
+    oldText: Type.TString;
+    newText: Type.TString;
+}>;
+export declare const WikiWritePageSchema: Type.TObject<{
+    category: Type.TUnsafe<"projects" | "areas" | "resources" | "archives">;
+    slug: Type.TString;
+    title: Type.TString;
+    scope: Type.TArray<Type.TString>;
+    tags: Type.TArray<Type.TString>;
+    body: Type.TString;
+    mode: Type.TUnsafe<"replace" | "edit" | "append" | "create">;
+    edits: Type.TOptional<Type.TArray<Type.TObject<{
+        oldText: Type.TString;
+        newText: Type.TString;
+    }>>>;
+}>;
+export declare const WikiWriteParams: Type.TObject<{
+    pages: Type.TArray<Type.TObject<{
+        category: Type.TUnsafe<"projects" | "areas" | "resources" | "archives">;
+        slug: Type.TString;
+        title: Type.TString;
+        scope: Type.TArray<Type.TString>;
+        tags: Type.TArray<Type.TString>;
+        body: Type.TString;
+        mode: Type.TUnsafe<"replace" | "edit" | "append" | "create">;
+        edits: Type.TOptional<Type.TArray<Type.TObject<{
+            oldText: Type.TString;
+            newText: Type.TString;
+        }>>>;
+    }>>;
+    indexContent: Type.TOptional<Type.TString>;
+    logSummary: Type.TOptional<Type.TString>;
+}>;
+export declare const WikiEditParams: Type.TObject<{
+    path: Type.TString;
+    edits: Type.TArray<Type.TObject<{
+        oldText: Type.TString;
+        newText: Type.TString;
+    }>>;
+    title: Type.TOptional<Type.TString>;
+    scope: Type.TOptional<Type.TArray<Type.TString>>;
+    tags: Type.TOptional<Type.TArray<Type.TString>>;
+    logSummary: Type.TOptional<Type.TString>;
+}>;
+export declare const WikiReadParams: Type.TObject<{
+    path: Type.TString;
+}>;
+export declare const WikiMoveParams: Type.TObject<{
+    path: Type.TString;
+    to: Type.TUnsafe<"projects" | "areas" | "resources" | "archives">;
+}>;
+export declare const WikiLintParams: Type.TObject<{
+    autoFix: Type.TOptional<Type.TBoolean>;
+}>;
+export declare const WikiMigrateParams: Type.TObject<{}>;
+export declare const WikiSummarizeParams: Type.TObject<{
+    target: Type.TString;
+    depth: Type.TOptional<Type.TUnsafe<"brief" | "detailed">>;
+}>;
+export interface WikiIngestDetails {
+    sourceType: "url" | "file" | "text";
+    rawPath?: string;
+    sourceLength: number;
+}
+export interface WikiQueryDetails {
+    resultCount: number;
+    scopeUsed: string;
+}
+export interface WikiWriteDetails {
+    pagesWritten: string[];
+    indexUpdated: boolean;
+    logAppended: boolean;
+    pagesSkipped?: string[];
+}
+export interface WikiReadDetails {
+    found: boolean;
+    path?: string;
+}
+export interface WikiMoveDetails {
+    from: string;
+    to: string;
+}
+export interface WikiLintDetails {
+    issueCount: number;
+    fixedCount: number;
+    stats: LintReport["stats"];
+}
+export interface WikiSummarizeDetails {
+    target: string;
+    pageCount: number;
+}
+//# sourceMappingURL=schemas.d.ts.map