pi-para 0.6.7 → 0.7.0

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

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