@zosmaai/pi-llm-wiki 0.11.7 → 0.12.0

package/README.md

@@ -605,6 +605,13 @@ Thanks to everyone who has contributed! This list is regenerated automatically b
                     <sub><b>Superdao</b></sub>
                 </a>
             </td>
+            <td align="center">
+                <a href="https://github.com/wooksong">
+                    <img src="https://avatars.githubusercontent.com/u/2772376?v=4" width="64;" alt="wooksong"/>
+                    <br />
+                    <sub><b>wooksong</b></sub>
+                </a>
+            </td>
             <td align="center">
                 <a href="https://github.com/mystery4f">
                     <img src="https://avatars.githubusercontent.com/u/40482524?v=4" width="64;" alt="mystery4f"/>

package/dist/extensions/llm-wiki/lib/dashboard-command.js

@@ -1,4 +1,4 @@
-import { Container, Text, matchesKey } from "@mariozechner/pi-tui";
+import { Container, matchesKey, Text } from "@earendil-works/pi-tui";
 import { collectDashboardStats } from "./dashboard.js";
 const TYPE_ORDER = [
     "concept",
@@ -65,6 +65,11 @@ export class DashboardScreen extends Container {
         }
     }
 }
+// ponytail: overlay options matching pi-blackhole's config modal style
+const OVERLAY_OPTS = {
+    overlay: true,
+    overlayOptions: { anchor: "center", width: "92%", maxHeight: "95%" },
+};
 /**
  * Register the /wiki-dashboard command.
  */
@@ -80,7 +85,7 @@ export function registerWikiDashboardCommand(pi, runtime) {
             const stats = await collectDashboardStats(ctx.cwd);
             await ctx.ui.custom((_tui, _theme, _keybindings, close) => {
                 return new DashboardScreen(renderStatsLines(stats), close);
-            });
+            }, OVERLAY_OPTS);
         },
     });
 }

package/dist/extensions/llm-wiki/lib/dashboard.js

@@ -11,7 +11,7 @@
  *
  * No writes, no LLM calls, no new files. Pure reader.
  */
-import { readFile, readdir, stat } from "node:fs/promises";
+import { readdir, readFile, stat } from "node:fs/promises";
 import { readJson, resolveVaultPaths } from "./utils.js";
 /** Directories excluded from the page walk (infrastructure, not pages). */
 const SKIP_DIRS = new Set([

package/dist/extensions/llm-wiki/lib/guardrails.js

@@ -1,4 +1,4 @@
-import { isToolCallEventType } from "@mariozechner/pi-coding-agent";
+import { isToolCallEventType } from "@earendil-works/pi-coding-agent";
 import { scheduleReindex } from "./indexing.js";
 import { rebuildMetadataLight } from "./metadata.js";
 import { isPathWithin, isProtectedPath, resolveVaultPaths } from "./utils.js";

package/dist/extensions/llm-wiki/lib/host.js

@@ -1,6 +1,6 @@
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { getAgentDir } from "@mariozechner/pi-coding-agent";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
 /** Project config directory name per host. */
 const CONFIG_DIR = { pi: ".pi", omp: ".omp" };
 /** Settings file names inside a config directory, lowest → highest precedence. */
@@ -100,7 +100,7 @@ export function resolveProjectSettingsPath(cwd, host = detectHost()) {
  *
  * Always writes to `settings.json` inside the agent dir — both hosts read it.
  */
-export function resolveGlobalSettingsPath(host = detectHost()) {
+export function resolveGlobalSettingsPath(_host = detectHost()) {
     let agentDir = "";
     try {
         agentDir = getAgentDir();

package/dist/extensions/llm-wiki/lib/ingest-worker.js

@@ -7,7 +7,7 @@ import { appendEvent, rebuildMetadataLight } from "./metadata.js";
 import { runSubAgent } from "./subagent.js";
 import { resolveWikilinkValidation } from "./task-config.js";
 import { fmtDate, readJson, slugify } from "./utils.js";
-import { VaultWriteError, assertWritableVault } from "./vault-format.js";
+import { assertWritableVault, VaultWriteError } from "./vault-format.js";
 /**
  * Background ingest synthesis (issue #65, part of epic #63).
  *

package/dist/extensions/llm-wiki/lib/knowledge-links.js

@@ -158,7 +158,7 @@ function resolveMarkdownTarget(target, sourceId) {
     }
     // Convert decoded backslashes to /
     const normalized = decoded.map((s) => s.replace(/\\/g, "/")).join("/");
-    const sourceDir = sourceId.replace(/[^\/]*$/, ""); // directory of source
+    const sourceDir = sourceId.replace(/[^/]*$/, ""); // directory of source
     const parts = normalized.split("/");
     const isRootRelative = normalized.startsWith("/");
     if (isRootRelative) {

package/dist/extensions/llm-wiki/lib/legacy-repair.js

@@ -1,5 +1,5 @@
 import { createHash, randomUUID } from "node:crypto";
-import { constants, chmodSync, closeSync, existsSync, fstatSync, fsyncSync, linkSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, unlinkSync, utimesSync, writeFileSync, } from "node:fs";
+import { chmodSync, closeSync, constants, existsSync, fstatSync, fsyncSync, linkSync, lstatSync, mkdirSync, openSync, readdirSync, readFileSync, renameSync, unlinkSync, utimesSync, writeFileSync, } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { createKnowledgeDocument, parseKnowledgeDocument, parseMarkdownFrontmatter, serializeKnowledgeDocument, } from "./knowledge-document.js";
 import { readJson } from "./utils.js";

package/dist/extensions/llm-wiki/lib/metadata.js

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
 import { dirname, join } from "node:path";
 import { buildResolvedBacklinks, buildWikilinkIndex, } from "./knowledge-links.js";
 import { isPathWithin, readJson } from "./utils.js";

package/dist/extensions/llm-wiki/lib/model-command.js

@@ -1,6 +1,11 @@
+import { Container, matchesKey, SelectList, Spacer, Text, } from "@earendil-works/pi-tui";
 import { parseModelRef, persistTaskModel } from "./task-config.js";
 /** Words that clear the override and revert to the session model. */
 const CLEAR_WORDS = new Set(["session", "default", "reset", "clear", "none", "unset"]);
+/** Sentinel value for the "use session model" picker row — not a valid provider/id. */
+const SESSION_VALUE = "__session__";
+/** Same window size as pi's built-in `/model` picker. */
+const MAX_VISIBLE = 10;
 /** The status-bar key for the active-model label (so we can update it in place). */
 export const MODEL_STATUS_KEY = "llm-wiki-model";
 /**
@@ -17,6 +22,68 @@ export function formatActiveModelLabel(config, sessionModelId) {
 function modelRef(m) {
     return `${m.provider}/${m.id}`;
 }
+function buildSelectTheme(theme) {
+    return {
+        selectedPrefix: (text) => theme.fg("accent", text),
+        selectedText: (text) => theme.fg("accent", text),
+        description: (text) => theme.fg("dim", text),
+        scrollInfo: (text) => theme.fg("dim", text),
+        noMatch: (text) => theme.fg("muted", text),
+    };
+}
+function buildPickerItems(pool, currentRef) {
+    const items = [
+        {
+            value: SESSION_VALUE,
+            label: "↩ Use session model (clear override)",
+            description: currentRef ? undefined : "current",
+        },
+    ];
+    let selectedIndex = 0;
+    for (const m of pool) {
+        const ref = modelRef(m);
+        const isCurrent = currentRef === ref;
+        items.push({
+            value: ref,
+            label: ref,
+            description: isCurrent ? "current" : undefined,
+        });
+        if (isCurrent)
+            selectedIndex = items.length - 1;
+    }
+    return { items, selectedIndex };
+}
+/** Editor-dock picker; `ui.custom` without overlay replaces the input slot like `/model`. */
+class ModelPickerScreen extends Container {
+    list;
+    doneFn;
+    closed = false;
+    constructor(title, items, selectedIndex, theme, done) {
+        super();
+        this.doneFn = done;
+        this.addChild(new Text(title, 0, 0));
+        this.addChild(new Spacer(1));
+        this.list = new SelectList(items, Math.min(MAX_VISIBLE, Math.max(items.length, 1)), buildSelectTheme(theme));
+        this.list.setSelectedIndex(selectedIndex);
+        this.list.onSelect = (item) => this.finish(item.value);
+        this.list.onCancel = () => this.finish(undefined);
+        this.addChild(this.list);
+    }
+    handleInput(data) {
+        // matchesKey covers kitty CSI-u Esc; SelectList cancel is the fallback.
+        if (matchesKey(data, "escape")) {
+            this.finish(undefined);
+            return;
+        }
+        this.list.handleInput(data);
+    }
+    finish(result) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.doneFn(result);
+    }
+}
 /**
  * Register the `/wiki-model` slash command. Lets the user view the active
  * background task model and choose another (or revert to the session model).
@@ -66,14 +133,20 @@ export function registerWikiModelCommand(pi, runtime) {
                 ctx.ui.notify(`LLM Wiki: active background model is ${current}. Pass provider/id to change it (no interactive UI here).`, "info");
                 return;
             }
+            if (typeof ctx.ui.custom !== "function") {
+                ctx.ui.notify(`LLM Wiki: this host does not support the model picker. Pass provider/id (e.g. anthropic/claude-haiku) or "session". Active: ${current}.`, "warning");
+                return;
+            }
             const available = ctx.modelRegistry.getAvailable() ?? [];
             const pool = available.length > 0 ? available : ctx.modelRegistry.getAll();
-            const sessionOption = "↩ Use session model (clear override)";
-            const options = [sessionOption, ...pool.map(modelRef)];
-            const picked = await ctx.ui.select(`Wiki background model (current: ${current})`, options);
+            const currentRef = runtime.config.taskModel ? modelRef(runtime.config.taskModel) : undefined;
+            const { items, selectedIndex } = buildPickerItems(pool, currentRef);
+            const picked = await ctx.ui.custom((_tui, theme, _keybindings, done) => {
+                return new ModelPickerScreen(`Wiki background model (current: ${current})`, items, selectedIndex, theme, done);
+            });
             if (picked === undefined)
                 return; // cancelled
-            if (picked === sessionOption) {
+            if (picked === SESSION_VALUE) {
                 apply(undefined);
                 return;
             }

package/dist/extensions/llm-wiki/lib/recall.js

@@ -42,7 +42,7 @@ function normalizeText(value) {
     return flattenSearchValue(value)
         .toLowerCase()
         .normalize("NFKC")
-        .replace(/[\-_./\\]+/g, " ")
+        .replace(/[-_./\\]+/g, " ")
         .replace(/[\p{P}\p{S}]+/gu, " ")
         .replace(/\s+/g, " ")
         .trim();
@@ -236,7 +236,7 @@ function chunkPreview(heading, content) {
  * Pseudo-relevance feedback: terms from top-matching pages that aren't in
  * the original query become expansion candidates.
  */
-function extractExpansionTerms(scored, originalQuery, paths, maxTerms = 6) {
+function extractExpansionTerms(scored, originalQuery, _paths, maxTerms = 6) {
     const topResults = scored.slice(0, Math.min(3, scored.length));
     if (topResults.length === 0)
         return [];

package/dist/extensions/llm-wiki/lib/runtime.js

@@ -1,4 +1,4 @@
-import { TASK_DEFAULTS, loadTaskConfig, noticesEnabled } from "./task-config.js";
+import { loadTaskConfig, noticesEnabled, TASK_DEFAULTS } from "./task-config.js";
 export class Runtime {
     config = { ...TASK_DEFAULTS };
     /**

package/dist/extensions/llm-wiki/lib/settings-command.js

@@ -1,5 +1,5 @@
 import { homedir } from "node:os";
-import { Container, Input, SettingsList, Spacer, Text, } from "@mariozechner/pi-tui";
+import { Container, Input, SettingsList, Spacer, Text, } from "@earendil-works/pi-tui";
 import { loadTaskConfig, loadTaskConfigSources, parseModelRef, persistSetting, trajectoriesEnabled, } from "./task-config.js";
 const SETTINGS = [
     {
@@ -280,6 +280,11 @@ class SettingsScreen extends Container {
 function scopeTitle(scope) {
     return `\u{1F9E0} LLM Wiki Settings \u2014 ${scope === "global" ? "Global" : "Project"} (Esc to close)`;
 }
+// ponytail: overlay options matching pi-blackhole's config modal style
+const OVERLAY_OPTS = {
+    overlay: true,
+    overlayOptions: { anchor: "center", width: "92%", maxHeight: "95%" },
+};
 async function showSettingsTui(ui, cwd, scope) {
     if (typeof ui.custom !== "function") {
         ui.notify("LLM Wiki: this host does not support the settings screen. Edit settings.json directly.", "warning");
@@ -344,7 +349,7 @@ async function showSettingsTui(ui, cwd, scope) {
         }, () => close());
         screenRef = new SettingsScreen(scopeTitle(writeScope), list);
         return screenRef;
-    });
+    }, OVERLAY_OPTS);
 }
 /**
  * Register the /wiki-settings command.

package/dist/extensions/llm-wiki/lib/source-extractors.js

@@ -190,7 +190,7 @@ async function extractWithMarkItDown(pi, source, signal) {
     try {
         if (!(await hasMarkItDown(pi, signal)))
             return "";
-        const mdResult = await exec(pi, "sh", ["-c", `uvx --from 'markitdown[docx,pdf]' markitdown "${source}" 2>/dev/null || echo ""`], { signal, timeout: markitdownTimeoutMs() });
+        const mdResult = await exec(pi, "uvx", ["--from", "markitdown[docx,pdf]", "markitdown", source], { signal, timeout: markitdownTimeoutMs() });
         return mdResult.stdout.trim() ? mdResult.stdout : "";
     }
     catch {
@@ -198,8 +198,24 @@ async function extractWithMarkItDown(pi, source, signal) {
     }
 }
 async function hasMarkItDown(pi, signal) {
-    const markitdown = await exec(pi, "sh", ["-c", `which uvx >/dev/null 2>&1 && echo "yes" || echo "no"`], { signal });
-    return markitdown.stdout.trim() === "yes";
+    // Probe without shell to avoid CWE-78; try which/where then uvx --version
+    try {
+        await exec(pi, "which", ["uvx"], { signal });
+        return true;
+    }
+    catch { }
+    try {
+        await exec(pi, "where", ["uvx"], { signal });
+        return true;
+    }
+    catch { }
+    try {
+        await exec(pi, "uvx", ["--version"], { signal });
+        return true;
+    }
+    catch {
+        return false;
+    }
 }
 async function fetchTextUrl(pi, url, signal) {
     try {
@@ -254,7 +270,7 @@ function decodeHtmlEntities(text) {
         if (map[lower])
             return map[lower];
         if (lower.startsWith("&#"))
-            return String.fromCodePoint(Number.parseInt(entity.slice(2, -1)));
+            return String.fromCodePoint(Number.parseInt(entity.slice(2, -1), 10));
         return entity;
     });
 }
@@ -271,7 +287,7 @@ function xmlToMarkdown(xml) {
     let prev = "";
     while (prev !== text) {
         prev = text;
-        text = text.replace(/<[a-zA-Z\/!?][^>]*>/g, "");
+        text = text.replace(/<[a-zA-Z/!?][^>]*>/g, "");
     }
     text = text.replace(/</g, "");
     text = decodeHtmlEntities(text);

package/dist/extensions/llm-wiki/lib/source-packet.js

@@ -1,6 +1,6 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { copyFile } from "node:fs/promises";
-import { extname, join } from "node:path";
+import { basename, extname, join } from "node:path";
 import { createKnowledgeDocument, serializeKnowledgeDocument } from "./knowledge-document.js";
 import { appendEvent } from "./metadata.js";
 import { binaryExtractionFailureMessage, detectBinaryMagicBytes, extractUrlContent, fileExtractorFor, } from "./source-extractors.js";
@@ -47,7 +47,7 @@ function urlCaptureSource(pi, url, signal) {
     };
 }
 function fileCaptureSource(pi, filePath, signal) {
-    const fileName = filePath.split("/").pop() || "unknown";
+    const fileName = originalFileNameForPath(filePath);
     const extractor = fileExtractorFor(filePath);
     const content = extractor.shouldReadText ? readText(filePath) : "";
     return {
@@ -168,6 +168,14 @@ function originalFileNameForUrl(url) {
     }
     return "source.html";
 }
+/**
+ * Original-artifact name for a local file capture. Uses platform basename so
+ * Windows absolute paths (drive colon + backslashes) cannot leak into the
+ * packet/original file name (issue #204).
+ */
+export function originalFileNameForPath(filePath) {
+    return basename(filePath) || "unknown";
+}
 function contentExtractionFailureMessage(source) {
     return `_Content could not be extracted from ${source}_\n`;
 }

package/dist/extensions/llm-wiki/lib/subagent.js

@@ -1,4 +1,4 @@
-import { agentLoop, } from "@mariozechner/pi-agent-core";
+import { agentLoop, } from "@earendil-works/pi-agent-core";
 /**
  * Run a sub-agent loop to completion.
  *

package/dist/extensions/llm-wiki/lib/tools.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join, relative } from "node:path";
 import { Type } from "typebox";
 import { bootstrapVault } from "./bootstrap.js";
@@ -871,6 +871,9 @@ function runWikiLint(paths, autoFix) {
     // The gap snapshot is generated discovery metadata consumed by wiki_status:
     // persist it on every successful lint so status never reports a stale count.
     // Corrective actions below (report, event, meta rebuild) stay autoFix-only.
+    // mkdir mirrors the autoFix report write below: on a fresh checkout the
+    // gitignored .discoveries dir does not exist yet (issue #203).
+    mkdirSync(paths.discoveries, { recursive: true });
     writeJson(join(paths.discoveries, "gaps.json"), {
         gaps,
         generated: new Date().toISOString(),

package/dist/extensions/llm-wiki/lib/trajectory.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { Type } from "typebox";
 import { appendEvent, rebuildMetadataLight } from "./metadata.js";

package/dist/extensions/llm-wiki/lib/utils.js

@@ -1,4 +1,4 @@
-import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmdirSync, writeFileSync, } from "node:fs";
+import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, readlinkSync, realpathSync, renameSync, rmdirSync, writeFileSync, } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, sep } from "node:path";
 /**

package/dist/extensions/llm-wiki/lib/vault-format.js

@@ -1,4 +1,4 @@
-import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
+import { existsSync, lstatSync, readdirSync, readFileSync } from "node:fs";
 import { isAbsolute, join, relative, sep } from "node:path";
 import { parseKnowledgeDocument, parseMarkdownFrontmatter, } from "./knowledge-document.js";
 import { relativePhysicalPath } from "./utils.js";

package/dist/extensions/llm-wiki/lib/visible-status.js

@@ -1,4 +1,4 @@
-import { MODEL_STATUS_KEY, formatActiveModelLabel } from "./model-command.js";
+import { formatActiveModelLabel, MODEL_STATUS_KEY } from "./model-command.js";
 import { noticesEnabled } from "./task-config.js";
 /**
  * Apply the two post-session-start visible status lines (issue #77,

package/dist/mcp/operations.js

@@ -14,7 +14,7 @@ import { saveInsight } from "../extensions/llm-wiki/lib/retro.js";
 import { captureFile, captureText, captureUrl } from "../extensions/llm-wiki/lib/source-packet.js";
 import { resolveWikilinkValidation } from "../extensions/llm-wiki/lib/task-config.js";
 import { readJson } from "../extensions/llm-wiki/lib/utils.js";
-import { VaultWriteError, inspectVaultFormat, inspectWritableVault, } from "../extensions/llm-wiki/lib/vault-format.js";
+import { inspectVaultFormat, inspectWritableVault, VaultWriteError, } from "../extensions/llm-wiki/lib/vault-format.js";
 import { getWikiStatus, searchRegistry } from "../extensions/llm-wiki/lib/wiki-service.js";
 function projectionOutcome(projection) {
     return projection.ok