pi-para 0.6.0 → 0.6.1

package/dist/tag-registry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Canonical tag registry — normalizes and deduplicates wiki page tags.
+ *
+ * Rules:
+ * 1. Spaces → hyphens ("session files" → "session-files")
+ * 2. Lowercase everything
+ * 3. Map aliases → canonical tags
+ * 4. Remove tags that duplicate scope values on the same page
+ * 5. Deduplicate
+ */
+/**
+ * Normalize a scope value.
+ *
+ * Scope should be a project name (kebab-case, single token), not a topic
+ * description. The daemon LLM sometimes writes freeform multi-word
+ * descriptions like "session exploration" or "mono project" as scope.
+ *
+ * Rules:
+ * 1. Trim + lowercase
+ * 2. If the value contains a known project name as a prefix, extract it
+ *    (e.g. "pi-para daemon" → "pi-para", "pi-mono project" → "pi-mono")
+ * 3. If still multi-word after extraction, drop it — it's a topic
+ *    description, not a project name
+ * 4. Return the clean kebab-case scope
+ *
+ * This is project-agnostic — works for any project, not just pi-para.
+ */
+export declare function normalizeScope(scope: string): string | null;
+/**
+ * Normalize a full scope list:
+ * 1. Normalize each value
+ * 2. Deduplicate
+ * 3. Ensure at least one scope remains (fallback to "global")
+ */
+export declare function normalizeScopes(scopes: string[]): string[];
+/**
+ * Normalize a single tag:
+ * 1. Trim + lowercase
+ * 2. Spaces → hyphens
+ * 3. Resolve alias → canonical
+ */
+export declare function normalizeTag(tag: string): string;
+/**
+ * Normalize a full tag list for a page, given its scope.
+ *
+ * 1. Normalize each tag
+ * 2. Remove tags that exactly match a scope value
+ * 3. Deduplicate
+ * 4. Sort alphabetically
+ */
+export declare function normalizeTags(tags: string[], scope: string[]): string[];
+/**
+ * Get the full alias map for external inspection (e.g., lint reporting).
+ */
+export declare function getAliasMap(): ReadonlyMap<string, string>;
+//# sourceMappingURL=tag-registry.d.ts.map

package/dist/tag-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-registry.d.ts","sourceRoot":"","sources":["../src/tag-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQ1D;AAkDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAavE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD"}

package/dist/tag-registry.js

@@ -0,0 +1,146 @@
+/**
+ * Canonical tag registry — normalizes and deduplicates wiki page tags.
+ *
+ * Rules:
+ * 1. Spaces → hyphens ("session files" → "session-files")
+ * 2. Lowercase everything
+ * 3. Map aliases → canonical tags
+ * 4. Remove tags that duplicate scope values on the same page
+ * 5. Deduplicate
+ */
+// -- Scope normalization -----------------------------------------------------
+/**
+ * Normalize a scope value.
+ *
+ * Scope should be a project name (kebab-case, single token), not a topic
+ * description. The daemon LLM sometimes writes freeform multi-word
+ * descriptions like "session exploration" or "mono project" as scope.
+ *
+ * Rules:
+ * 1. Trim + lowercase
+ * 2. If the value contains a known project name as a prefix, extract it
+ *    (e.g. "pi-para daemon" → "pi-para", "pi-mono project" → "pi-mono")
+ * 3. If still multi-word after extraction, drop it — it's a topic
+ *    description, not a project name
+ * 4. Return the clean kebab-case scope
+ *
+ * This is project-agnostic — works for any project, not just pi-para.
+ */
+export function normalizeScope(scope) {
+    const s = scope.trim().toLowerCase();
+    if (!s)
+        return null;
+    // Already clean (no spaces) — pass through
+    if (!s.includes(" "))
+        return s;
+    // Try to extract a kebab-case project name prefix.
+    // Multi-word scopes from the LLM follow the pattern:
+    //   "<project-name> <topic words>"  e.g. "pi-mono project", "pi-para daemon"
+    // Extract the first kebab-case token if it looks like a project name.
+    const firstToken = s.split(" ")[0];
+    if (firstToken && firstToken.includes("-")) {
+        // Looks like a kebab-case project name (e.g. "pi-mono", "pi-para")
+        return firstToken;
+    }
+    // Multi-word without a kebab prefix → topic description, drop it
+    return null;
+}
+/**
+ * Normalize a full scope list:
+ * 1. Normalize each value
+ * 2. Deduplicate
+ * 3. Ensure at least one scope remains (fallback to "global")
+ */
+export function normalizeScopes(scopes) {
+    const result = new Set();
+    for (const s of scopes) {
+        const normalized = normalizeScope(s);
+        if (normalized)
+            result.add(normalized);
+    }
+    if (result.size === 0)
+        result.add("global");
+    return [...result].sort();
+}
+// -- Tag normalization -------------------------------------------------------
+/** Canonical tag → list of aliases that map to it. */
+const TAG_ALIASES = {
+    // session/capture family
+    "session-capture": ["capture", "background-capture", "session"],
+    "session-files": ["session files"],
+    // project identity
+    "pi-para": ["para"],
+    "pi-mono": ["mono"],
+    "coding-agent": ["agent"],
+    // tech
+    "node-llama-cpp": [],
+    "qmd-search": ["bm25"],
+    "lazy-loading": [],
+    // kebab-case normalization
+    "scope-detection": ["scope detection"],
+    "project-structure": ["project structure", "structure"],
+    "model-registry": ["model registry"],
+    "thinking-level": ["thinking level"],
+    "interactive-mode": ["interactive mode"],
+    "exploration-incomplete": ["exploration incomplete"],
+    "ui-component": ["UI component"],
+    "scoped-models": ["scopedModels"],
+    "github-packages": [],
+    "architecture-pattern": [],
+    "knowledge-management": ["knowledge-base"],
+    // UI
+    "webui": ["ui", "frontend", "react"],
+};
+/** Build reverse lookup: alias → canonical. */
+function buildAliasMap() {
+    const map = new Map();
+    for (const [canonical, aliases] of Object.entries(TAG_ALIASES)) {
+        for (const alias of aliases) {
+            map.set(alias.toLowerCase(), canonical);
+        }
+    }
+    return map;
+}
+const ALIAS_MAP = buildAliasMap();
+/**
+ * Normalize a single tag:
+ * 1. Trim + lowercase
+ * 2. Spaces → hyphens
+ * 3. Resolve alias → canonical
+ */
+export function normalizeTag(tag) {
+    let t = tag.trim().toLowerCase().replace(/\s+/g, "-");
+    const canonical = ALIAS_MAP.get(t);
+    if (canonical)
+        t = canonical;
+    return t;
+}
+/**
+ * Normalize a full tag list for a page, given its scope.
+ *
+ * 1. Normalize each tag
+ * 2. Remove tags that exactly match a scope value
+ * 3. Deduplicate
+ * 4. Sort alphabetically
+ */
+export function normalizeTags(tags, scope) {
+    const scopeSet = new Set(scope.map(s => s.toLowerCase()));
+    const normalized = new Set();
+    for (const tag of tags) {
+        const t = normalizeTag(tag);
+        if (!t)
+            continue;
+        // Don't add tags that duplicate scope
+        if (scopeSet.has(t))
+            continue;
+        normalized.add(t);
+    }
+    return [...normalized].sort();
+}
+/**
+ * Get the full alias map for external inspection (e.g., lint reporting).
+ */
+export function getAliasMap() {
+    return ALIAS_MAP;
+}
+//# sourceMappingURL=tag-registry.js.map

package/dist/tag-registry.js.map

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

package/dist/templates/prompts.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LLM prompt templates for ingest, query, lint, capture, and summarize operations.
+ */
+/**
+ * System prompt for the standalone wiki agent used in capture, lint, and
+ * summarize operations. This agent runs outside the session's agent loop.
+ */
+export declare const WIKI_SYSTEM_PROMPT = "You are a wiki knowledge management agent. You maintain a PARA-structured knowledge base.\n\nYour job is to read content, extract knowledge, and write structured wiki pages. You operate autonomously \u2014 no user confirmation needed.\n\nPARA category rules:\n- **resources/**: Use for almost everything \u2014 architecture docs, how-tos, debugging solutions, configs, patterns, implementation notes. This is the default.\n- **areas/**: Only for ongoing responsibilities with no end date (e.g. server config, deployment procedures).\n- **projects/**: ONLY for actual goals with a defined end date and completion criteria. Do NOT use for documentation about a project's internals.\n- **archives/**: Never create pages here \u2014 pages get moved here when completed.\n\nWhen the user defines a specific goal with a completion condition, create a projects/ page. When identifying a repeating responsibility (monitoring, maintenance, quality), create an areas/ page.\n\nScope and tag rules:\n- scope must be a kebab-case project name (e.g. \"pi-para\", \"qmd\"). NOT topic descriptions like \"session exploration\".\n- tags must be kebab-case (no spaces). Don't duplicate scope values as tags.\n\nContent rules:\n- Use [[wikilinks]] to connect related pages. Always add a ## Connections section.\n- Use the wiki summary format: Topic, Key Facts, Insights, Connections, Open Questions, Sources\n- Keep pages focused on one concept each\n- Be concise and factual \u2014 no fluff\n- Check for existing similar pages before creating new ones to avoid duplicates\n- NEVER include API keys, tokens, passwords, or secrets. Document WHERE they are stored, not the values.\n- Index is auto-rebuilt after every write \u2014 do not manage index.md manually. Do NOT pass indexContent to wiki_write.";
+/**
+ * Prompt included in the tool result when the LLM processes an ingested source.
+ * The LLM reads this along with the source content, schema, and current index.
+ */
+export declare const INGEST_PROMPT = "Analyze the source content below and integrate it into the wiki.\n\nInstructions:\n1. Identify key entities, concepts, facts, and relationships in the source\n2. Review the current index to find existing pages that should be updated\n3. Decide which existing wiki pages need updates and what new pages to create\n4. For each page, use the wiki summary format:\n   - Topic: what this page covers\n   - Key Facts: established knowledge points\n   - Insights: non-obvious findings, patterns, implications\n   - Connections: [[wikilinks]] to related pages with descriptions\n   - Open Questions: gaps in knowledge, unresolved contradictions\n   - Sources: source URLs, file paths, session references\n5. Assign PARA category correctly:\n   - resources/ for reference material (DEFAULT \u2014 use this for most pages)\n   - areas/ for ongoing responsibilities\n   - projects/ ONLY for actual goals with end dates\n6. scope must be a kebab-case project name (NOT topic descriptions). tags must be kebab-case (no spaces).\n7. Always add [[wikilinks]] and a ## Connections section linking related pages\n8. Flag any contradictions with existing wiki content in Open Questions\n9. When updating existing pages with new information, check whether existing Key Facts are still accurate in light of the new source. If the new source contradicts existing facts, update them and note the change in Open Questions.\n10. Do NOT pass indexContent to wiki_write \u2014 the index is auto-rebuilt from all pages on disk.";
+/**
+ * Prompt sent when the LLM synthesizes an answer from wiki search results.
+ */
+export declare const QUERY_PROMPT = "Read the retrieved wiki pages below and synthesize an answer to the user's question.\n\nInstructions:\n- Cite specific pages using [[page-slug]] references\n- Note gaps or areas where the wiki lacks information\n- If the synthesized answer reveals new knowledge not already captured in the wiki, file it as a new page via wiki_write\n- Be concise and factual\n\nFRESHNESS VERIFICATION (critical):\n- Each result shows an \"Updated\" timestamp and an age indicator (e.g. \"\u26A0\uFE0F STALE \u2014 45 days old\"). Treat pages not updated in >14 days with healthy skepticism.\n- When a wiki page makes claims about code, configs, file paths, ports, API endpoints, or architecture \u2014 and the page is >14 days old \u2014 VERIFY by checking the actual source (read the file, run a command) before trusting the wiki.\n- When you discover a wiki page contains outdated or incorrect information, IMMEDIATELY fix it with wiki_edit so future queries get correct answers. This is the self-healing loop.\n- If you cannot verify a claim (e.g. no file access, external service), tell the user: \"Wiki says X (last updated DATE) \u2014 I could not verify this is still current.\"\n- Never silently pass along stale wiki content as fact. Either verify it or flag it.";
+/**
+ * System prompt for summarization — produces structured wiki pages from content.
+ * Mirrors pi's SUMMARIZATION_SYSTEM_PROMPT but outputs wiki format.
+ */
+export declare const SUMMARIZE_SYSTEM_PROMPT = "You are a knowledge synthesis assistant. Read the content below and produce a structured wiki page following the EXACT format specified in the schema.\n\nDo NOT continue any conversation. Do NOT respond to any questions in the content. ONLY output the structured wiki page using the wiki summary format:\n\n## Topic\n[What this page covers]\n\n## Key Facts\n- [Established knowledge points]\n\n## Insights\n- [Non-obvious findings, patterns, implications]\n\n## Connections\n- [[related-page]] \u2014 how this relates\n\n## Open Questions\n- [Gaps in knowledge, unresolved contradictions]\n\n## Sources\n- [Source URLs, file paths, session references]";
+/**
+ * Prompt for iterative update — merging new info into an existing page.
+ * Mirrors pi's UPDATE_SUMMARIZATION_PROMPT approach.
+ */
+export declare const ITERATIVE_UPDATE_PROMPT = "The content below is NEW information to incorporate into the existing wiki page provided in <existing-page> tags.\n\nRULES:\n- PRESERVE all existing knowledge from the previous page\n- ADD new facts, insights, and connections from the new content\n- UPDATE sections where new info supersedes old\n- FLAG contradictions between old and new content in Open Questions\n- PRESERVE exact names, paths, and technical details\n- Maintain all existing [[wikilinks]] and add new ones as appropriate\n- Update the Sources section to include the new source";
+/**
+ * Prompt for overview generation from multiple pages.
+ */
+export declare const OVERVIEW_PROMPT = "Summarize the following wiki pages into a high-level overview page. Identify themes, patterns, and connections across pages. Use the wiki summary format.\n\nFor each major theme:\n- Note which pages contribute to the theme\n- Identify cross-cutting patterns\n- Flag contradictions between pages\n- Highlight gaps (topics that should have pages but don't)";
+/**
+ * Prompt for the LLM when reviewing lint results and auto-fixing issues.
+ */
+export declare const LINT_PROMPT = "Review the lint results below and fix all auto-fixable issues.\n\nFor each issue:\n- Prioritize by impact (errors first, then warnings, then info)\n- Fix broken wikilinks by finding the correct target page or removing dead links\n- Add missing pages for concepts referenced across multiple pages\n- Move stale projects to archives if inactive for 90+ days\n- Fix frontmatter issues (missing fields, invalid dates, empty scope)\n- Update index.md to include any pages missing from the index\n- Propose archiving for inactive projects\n\nReport unfixable issues that require human judgment.";
+/**
+ * System prompt for the standalone capture agent.
+ * Used as WIKI_SYSTEM_PROMPT for the capture agent instance.
+ */
+export declare const CAPTURE_SYSTEM_PROMPT = "You are a knowledge capture assistant. Your job is to extract persistent knowledge from coding sessions and write it to a PARA-structured wiki.\n\nCapture ANY of the following \u2014 even from short sessions:\n- Architecture decisions and rationale (\"we chose X because Y\")\n- Debugging solutions (root cause + fix)\n- Server/infrastructure details (IPs, paths, credentials locations, configs)\n- Build and deployment procedures (commands, steps, gotchas)\n- API keys, service endpoints, and where they are stored\n- Project conventions and coding patterns\n- Tool configurations and setup steps\n- Dependencies and version constraints\n- Environment-specific knowledge (dev vs prod differences)\n- Operational runbooks (how to restart, deploy, rollback)\n\nIndex is auto-rebuilt after every write \u2014 do not manage index.md manually. Do NOT pass indexContent to wiki_write.\n\nRules:\n- If the session was ONLY greetings or completely off-topic chitchat with zero project knowledge, respond with \"nothing to capture\"\n- Otherwise, always capture \u2014 even small facts are valuable (\"the deploy key is at /path/to/key\")\n- Classify each piece of knowledge by PARA category autonomously\n- When the user defines a specific goal with a completion condition, create a projects/ page. When identifying a repeating responsibility (monitoring, maintenance, quality), create an areas/ page.\n- Produce wiki pages in the standard wiki summary format (Topic, Key Facts, Insights, Connections, Open Questions, Sources)\n- Include the full session file path in the Sources section for traceability\n- ALWAYS search wiki_query BEFORE creating any page \u2014 update existing pages instead of creating duplicates\n- If wiki_query finds a page on the same topic (even with a different title/slug), update THAT page using its existing slug\n- The conversation may include compaction summaries from earlier in the session \u2014 treat these as authoritative records of prior work\n- Write directly via wiki_write \u2014 no user confirmation needed\n- NEVER include API keys, tokens, passwords, or secrets in wiki pages. Document WHERE they are stored, not the actual values.";
+/**
+ * Prompt template for auto-capture at session_shutdown.
+ * The serialized conversation is appended after this prompt.
+ */
+export declare const CAPTURE_PROMPT = "Analyze the session conversation below and capture ALL project-relevant knowledge into the wiki.\n\nCapture bias: when in doubt, capture it. Small operational facts (paths, configs, server details, commands) are often the most valuable because they are hard to rediscover.\n\nOnly respond with \"nothing to capture\" if the session was purely greetings or off-topic chitchat with zero project knowledge.\n\nFor everything else:\n1. Use wiki_query to search for EXISTING pages on each topic FIRST\n2. If a matching page exists, use wiki_read to get its content, then wiki_write with its EXACT slug to update it\n3. Only create a NEW page if wiki_query returned no relevant results\n4. Each page must include the session file path in its Sources section\n5. Do NOT pass indexContent to wiki_write - the index is auto-rebuilt from all pages on disk\n\nCRITICAL: prefer updating over creating. The wiki likely already has pages on most topics.\n\n<session-conversation>\n";
+/**
+ * Prompt template for explicit capture via /wiki-capture.
+ * A topic hint (if provided) and the serialized conversation are appended.
+ */
+export declare const EXPLICIT_CAPTURE_PROMPT = "Capture knowledge from the current session into the wiki.";
+//# sourceMappingURL=prompts.d.ts.map

package/dist/templates/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/templates/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,4vDAuBsF,CAAC;AAItH;;;GAGG;AACH,eAAO,MAAM,aAAa,i+CAqBqE,CAAC;AAIhG;;GAEG;AACH,eAAO,MAAM,YAAY,4uCAa4D,CAAC;AAItF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gpBAoBY,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,siBASmB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,eAAe,uWAM+B,CAAC;AAI5D;;GAEG;AACH,eAAO,MAAM,WAAW,ilBAW6B,CAAC;AAItD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,8nEA2B4F,CAAC;AAE/H;;;GAGG;AACH,eAAO,MAAM,cAAc,48BAgB1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,8DAA8D,CAAC"}

package/dist/templates/prompts.js

@@ -0,0 +1,203 @@
+/**
+ * LLM prompt templates for ingest, query, lint, capture, and summarize operations.
+ */
+// -- Wiki System Prompt (standalone agent) ------------------------------------
+/**
+ * System prompt for the standalone wiki agent used in capture, lint, and
+ * summarize operations. This agent runs outside the session's agent loop.
+ */
+export const WIKI_SYSTEM_PROMPT = `You are a wiki knowledge management agent. You maintain a PARA-structured knowledge base.
+
+Your job is to read content, extract knowledge, and write structured wiki pages. You operate autonomously — no user confirmation needed.
+
+PARA category rules:
+- **resources/**: Use for almost everything — architecture docs, how-tos, debugging solutions, configs, patterns, implementation notes. This is the default.
+- **areas/**: Only for ongoing responsibilities with no end date (e.g. server config, deployment procedures).
+- **projects/**: ONLY for actual goals with a defined end date and completion criteria. Do NOT use for documentation about a project's internals.
+- **archives/**: Never create pages here — pages get moved here when completed.
+
+When the user defines a specific goal with a completion condition, create a projects/ page. When identifying a repeating responsibility (monitoring, maintenance, quality), create an areas/ page.
+
+Scope and tag rules:
+- scope must be a kebab-case project name (e.g. "pi-para", "qmd"). NOT topic descriptions like "session exploration".
+- tags must be kebab-case (no spaces). Don't duplicate scope values as tags.
+
+Content rules:
+- Use [[wikilinks]] to connect related pages. Always add a ## Connections section.
+- Use the wiki summary format: Topic, Key Facts, Insights, Connections, Open Questions, Sources
+- Keep pages focused on one concept each
+- Be concise and factual — no fluff
+- Check for existing similar pages before creating new ones to avoid duplicates
+- NEVER include API keys, tokens, passwords, or secrets. Document WHERE they are stored, not the values.
+- Index is auto-rebuilt after every write — do not manage index.md manually. Do NOT pass indexContent to wiki_write.`;
+// -- Ingest Prompts ----------------------------------------------------------
+/**
+ * Prompt included in the tool result when the LLM processes an ingested source.
+ * The LLM reads this along with the source content, schema, and current index.
+ */
+export const INGEST_PROMPT = `Analyze the source content below and integrate it into the wiki.
+
+Instructions:
+1. Identify key entities, concepts, facts, and relationships in the source
+2. Review the current index to find existing pages that should be updated
+3. Decide which existing wiki pages need updates and what new pages to create
+4. For each page, use the wiki summary format:
+   - Topic: what this page covers
+   - Key Facts: established knowledge points
+   - Insights: non-obvious findings, patterns, implications
+   - Connections: [[wikilinks]] to related pages with descriptions
+   - Open Questions: gaps in knowledge, unresolved contradictions
+   - Sources: source URLs, file paths, session references
+5. Assign PARA category correctly:
+   - resources/ for reference material (DEFAULT — use this for most pages)
+   - areas/ for ongoing responsibilities
+   - projects/ ONLY for actual goals with end dates
+6. scope must be a kebab-case project name (NOT topic descriptions). tags must be kebab-case (no spaces).
+7. Always add [[wikilinks]] and a ## Connections section linking related pages
+8. Flag any contradictions with existing wiki content in Open Questions
+9. When updating existing pages with new information, check whether existing Key Facts are still accurate in light of the new source. If the new source contradicts existing facts, update them and note the change in Open Questions.
+10. Do NOT pass indexContent to wiki_write — the index is auto-rebuilt from all pages on disk.`;
+// -- Query Prompts -----------------------------------------------------------
+/**
+ * Prompt sent when the LLM synthesizes an answer from wiki search results.
+ */
+export const QUERY_PROMPT = `Read the retrieved wiki pages below and synthesize an answer to the user's question.
+
+Instructions:
+- Cite specific pages using [[page-slug]] references
+- Note gaps or areas where the wiki lacks information
+- If the synthesized answer reveals new knowledge not already captured in the wiki, file it as a new page via wiki_write
+- Be concise and factual
+
+FRESHNESS VERIFICATION (critical):
+- Each result shows an "Updated" timestamp and an age indicator (e.g. "⚠️ STALE — 45 days old"). Treat pages not updated in >14 days with healthy skepticism.
+- When a wiki page makes claims about code, configs, file paths, ports, API endpoints, or architecture — and the page is >14 days old — VERIFY by checking the actual source (read the file, run a command) before trusting the wiki.
+- When you discover a wiki page contains outdated or incorrect information, IMMEDIATELY fix it with wiki_edit so future queries get correct answers. This is the self-healing loop.
+- If you cannot verify a claim (e.g. no file access, external service), tell the user: "Wiki says X (last updated DATE) — I could not verify this is still current."
+- Never silently pass along stale wiki content as fact. Either verify it or flag it.`;
+// -- Summarize Prompts -------------------------------------------------------
+/**
+ * System prompt for summarization — produces structured wiki pages from content.
+ * Mirrors pi's SUMMARIZATION_SYSTEM_PROMPT but outputs wiki format.
+ */
+export const SUMMARIZE_SYSTEM_PROMPT = `You are a knowledge synthesis assistant. Read the content below and produce a structured wiki page following the EXACT format specified in the schema.
+
+Do NOT continue any conversation. Do NOT respond to any questions in the content. ONLY output the structured wiki page using the wiki summary format:
+
+## Topic
+[What this page covers]
+
+## Key Facts
+- [Established knowledge points]
+
+## Insights
+- [Non-obvious findings, patterns, implications]
+
+## Connections
+- [[related-page]] — how this relates
+
+## Open Questions
+- [Gaps in knowledge, unresolved contradictions]
+
+## Sources
+- [Source URLs, file paths, session references]`;
+/**
+ * Prompt for iterative update — merging new info into an existing page.
+ * Mirrors pi's UPDATE_SUMMARIZATION_PROMPT approach.
+ */
+export const ITERATIVE_UPDATE_PROMPT = `The content below is NEW information to incorporate into the existing wiki page provided in <existing-page> tags.
+
+RULES:
+- PRESERVE all existing knowledge from the previous page
+- ADD new facts, insights, and connections from the new content
+- UPDATE sections where new info supersedes old
+- FLAG contradictions between old and new content in Open Questions
+- PRESERVE exact names, paths, and technical details
+- Maintain all existing [[wikilinks]] and add new ones as appropriate
+- Update the Sources section to include the new source`;
+/**
+ * Prompt for overview generation from multiple pages.
+ */
+export const OVERVIEW_PROMPT = `Summarize the following wiki pages into a high-level overview page. Identify themes, patterns, and connections across pages. Use the wiki summary format.
+
+For each major theme:
+- Note which pages contribute to the theme
+- Identify cross-cutting patterns
+- Flag contradictions between pages
+- Highlight gaps (topics that should have pages but don't)`;
+// -- Lint Prompts ------------------------------------------------------------
+/**
+ * Prompt for the LLM when reviewing lint results and auto-fixing issues.
+ */
+export const LINT_PROMPT = `Review the lint results below and fix all auto-fixable issues.
+
+For each issue:
+- Prioritize by impact (errors first, then warnings, then info)
+- Fix broken wikilinks by finding the correct target page or removing dead links
+- Add missing pages for concepts referenced across multiple pages
+- Move stale projects to archives if inactive for 90+ days
+- Fix frontmatter issues (missing fields, invalid dates, empty scope)
+- Update index.md to include any pages missing from the index
+- Propose archiving for inactive projects
+
+Report unfixable issues that require human judgment.`;
+// -- Capture Prompts ---------------------------------------------------------
+/**
+ * System prompt for the standalone capture agent.
+ * Used as WIKI_SYSTEM_PROMPT for the capture agent instance.
+ */
+export const CAPTURE_SYSTEM_PROMPT = `You are a knowledge capture assistant. Your job is to extract persistent knowledge from coding sessions and write it to a PARA-structured wiki.
+
+Capture ANY of the following — even from short sessions:
+- Architecture decisions and rationale ("we chose X because Y")
+- Debugging solutions (root cause + fix)
+- Server/infrastructure details (IPs, paths, credentials locations, configs)
+- Build and deployment procedures (commands, steps, gotchas)
+- API keys, service endpoints, and where they are stored
+- Project conventions and coding patterns
+- Tool configurations and setup steps
+- Dependencies and version constraints
+- Environment-specific knowledge (dev vs prod differences)
+- Operational runbooks (how to restart, deploy, rollback)
+
+Index is auto-rebuilt after every write — do not manage index.md manually. Do NOT pass indexContent to wiki_write.
+
+Rules:
+- If the session was ONLY greetings or completely off-topic chitchat with zero project knowledge, respond with "nothing to capture"
+- Otherwise, always capture — even small facts are valuable ("the deploy key is at /path/to/key")
+- Classify each piece of knowledge by PARA category autonomously
+- When the user defines a specific goal with a completion condition, create a projects/ page. When identifying a repeating responsibility (monitoring, maintenance, quality), create an areas/ page.
+- Produce wiki pages in the standard wiki summary format (Topic, Key Facts, Insights, Connections, Open Questions, Sources)
+- Include the full session file path in the Sources section for traceability
+- ALWAYS search wiki_query BEFORE creating any page — update existing pages instead of creating duplicates
+- If wiki_query finds a page on the same topic (even with a different title/slug), update THAT page using its existing slug
+- The conversation may include compaction summaries from earlier in the session — treat these as authoritative records of prior work
+- Write directly via wiki_write — no user confirmation needed
+- NEVER include API keys, tokens, passwords, or secrets in wiki pages. Document WHERE they are stored, not the actual values.`;
+/**
+ * Prompt template for auto-capture at session_shutdown.
+ * The serialized conversation is appended after this prompt.
+ */
+export const CAPTURE_PROMPT = `Analyze the session conversation below and capture ALL project-relevant knowledge into the wiki.
+
+Capture bias: when in doubt, capture it. Small operational facts (paths, configs, server details, commands) are often the most valuable because they are hard to rediscover.
+
+Only respond with "nothing to capture" if the session was purely greetings or off-topic chitchat with zero project knowledge.
+
+For everything else:
+1. Use wiki_query to search for EXISTING pages on each topic FIRST
+2. If a matching page exists, use wiki_read to get its content, then wiki_write with its EXACT slug to update it
+3. Only create a NEW page if wiki_query returned no relevant results
+4. Each page must include the session file path in its Sources section
+5. Do NOT pass indexContent to wiki_write - the index is auto-rebuilt from all pages on disk
+
+CRITICAL: prefer updating over creating. The wiki likely already has pages on most topics.
+
+<session-conversation>
+`;
+/**
+ * Prompt template for explicit capture via /wiki-capture.
+ * A topic hint (if provided) and the serialized conversation are appended.
+ */
+export const EXPLICIT_CAPTURE_PROMPT = `Capture knowledge from the current session into the wiki.`;
+//# sourceMappingURL=prompts.js.map

package/dist/templates/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/templates/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;qHAuBmF,CAAC;AAEtH,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;+FAqBkE,CAAC;AAEhG,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;qFAayD,CAAC;AAEtF,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;gDAoBS,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;uDASgB,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;2DAM4B,CAAC;AAE5D,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;qDAW0B,CAAC;AAEtD,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;8HA2ByF,CAAC;AAE/H;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;CAgB7B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,2DAA2D,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { QMDStore } from "qmd-engine";
+import type { ProjectScope } from "./scope.js";
+/**
+ * Register all wiki tools with the pi extension API.
+ *
+ * Tools: wiki_ingest, wiki_query, wiki_write, wiki_edit, wiki_read,
+ *        wiki_move, wiki_lint, wiki_summarize
+ */
+export declare function registerTools(pi: ExtensionAPI, wikiDir: string, store: QMDStore, getScope: () => ProjectScope, markDirty: () => void, getGraphBoost?: () => boolean): void;
+/**
+ * Create standalone AgentTool instances for the mini-agent (capture/lint/summarize).
+ * Returns only the tools needed for autonomous wiki operations:
+ * wiki_write, wiki_edit, wiki_read, wiki_query, wiki_move.
+ */
+export declare function createStandaloneTools(wikiDir: string, store: QMDStore, getScope: () => ProjectScope, markDirty?: () => void): AgentTool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +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;AAsgC/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,GAC5B,IAAI,CAgWN;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"}