@zosmaai/pi-llm-wiki 0.11.5 → 0.11.6

package/dist/mcp/operations.js

@@ -5,11 +5,15 @@
  * used by Pi tools. No operation parses YAML, scans files, scores
  * registry entries, or builds page strings itself.
  */
+import { join } from "node:path";
 import { bootstrapVault } from "../extensions/llm-wiki/lib/bootstrap.js";
+import { applyWikilinkGate, buildWikilinkIndex, } from "../extensions/llm-wiki/lib/knowledge-links.js";
 import { rebuildMetadata } from "../extensions/llm-wiki/lib/metadata.js";
 import { searchWikiLayered } from "../extensions/llm-wiki/lib/recall.js";
 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 { getWikiStatus, searchRegistry } from "../extensions/llm-wiki/lib/wiki-service.js";
 function projectionOutcome(projection) {
@@ -87,7 +91,7 @@ export async function statusOperation(paths) {
     };
 }
 /** Shared retro operation: validates vault then delegates to saveInsight. */
-export async function retroOperation(paths, slug, title, body, category) {
+export async function retroOperation(paths, slug, title, body, category, wikilinkValidation) {
     const vaultCheck = inspectWritableVault(paths);
     if (!vaultCheck.ok) {
         return {
@@ -95,8 +99,23 @@ export async function retroOperation(paths, slug, title, body, category) {
             diagnostics: vaultCheck.diagnostics.map((d) => ({ code: d.code, message: d.message })),
         };
     }
+    // Pre-write wikilink gate (#172): validate/normalize caller-supplied body.
+    const mode = resolveWikilinkValidation({ wikilinkValidation });
+    let gateBody = body;
+    if (mode !== "off") {
+        const registry = readJson(join(paths.meta, "registry.json"), { pages: {} });
+        const gate = applyWikilinkGate(body, buildWikilinkIndex(Object.keys(registry.pages)), `sources/${slug}`, mode);
+        if (!gate.ok) {
+            return {
+                ok: false,
+                diagnostics: gate.diagnostics.map((d) => ({ code: "link_validation", message: d.message })),
+            };
+        }
+        if (mode === "normalize")
+            gateBody = gate.body;
+    }
     try {
-        const result = saveInsight(paths, slug, title, body, category, { rebuild: false });
+        const result = saveInsight(paths, slug, title, gateBody, category, { rebuild: false });
         const projection = projectionOutcome(rebuildMetadata(paths));
         if (!projection.ok)
             return projection;

package/docs/configuration.md

@@ -58,6 +58,7 @@ All of the above are viewable and editable in the `/wiki-settings` TUI (persists
 | `taskModel`            | —          | Model for background tasks (`{ provider: "openai", id: "gpt-4o" }`) |
 | `synthesisLanguage`    | —          | BCP 47 language tag for ingest synthesis (e.g. `"ru"`, `"fr"`). When unset, synthesis defaults to English. |
 | `synthesisMaxTokens`     | 16384    | Max output tokens for ingest/synthesis runs (stored as a plain number)                        |
+| `wikilinkValidation`   | warn       | Pre-write wikilink gate for page writes (ingest, `wiki_ensure_page`, `wiki_retro`, MCP `wiki_retro`). `off` ignore, `warn` report, `normalize` rewrite resolvable links, `strict` block writes with unresolved/ambiguous links |
 | `trajectories`         | false      | Enable agent-trajectory working-memory                       |
 | `notices`              | true       | Show wiki activity notices in chat                           |
 | `ambientPersonalVault` | host-dependent | Let the personal vault act as the ambient vault in projects that have no wiki. `true` under pi, `false` under oh-my-pi — see below. |

package/docs/obsidian.md

@@ -2,20 +2,20 @@
 
 ## Setup
 
-1. Open `.llm-wiki/wiki/` as an Obsidian vault
-2. The extension generates `.llm-wiki/meta/index.md` as a browsable catalog
-3. `.llm-wiki/meta/backlinks.json` is available for graph plugins
+1. Open `.llm-wiki/` as an Obsidian vault
+2. Your wiki pages live in `wiki/` — Graph View and Backlinks work on these automatically
+3. The extension generates `meta/index.md` (browsable catalog) and `meta/backlinks.json` (link map) — both are read-only, regenerated on each rebuild
 
 ## Recommended Plugins
 
 - [Dataview](https://github.com/blacksmithgu/obsidian-dataview) — Query pages by frontmatter
-- [Graph View](https://obsidian.md) (built-in) — Visualize `[[wikilink]]` connections
+- [Graph View](https://obsidian.md) (built-in) — Visualize `[[wikilink]]` connections in `wiki/`
 - [Backlinks](https://obsidian.md) (built-in) — See inbound links
 
 ## Web Clipper
 
-Use [Obsidian Web Clipper](https://obsidian.md/clipper) to save articles directly into `.llm-wiki/raw/articles/`.
+Use [Obsidian Web Clipper](https://obsidian.md/clipper) to save articles directly into `raw/articles/`.
 
 ## Dataview Dashboard
 
-The extension creates `.llm-wiki/meta/index.md` with page listings. For custom dashboards, use Dataview queries against frontmatter fields like `type`, `domain`, `category`, `sources`.
+For custom dashboards, use Dataview queries against frontmatter fields like `type`, `domain`, `category`, `sources`. Query the `wiki/` directory for knowledge pages.