@zosmaai/pi-llm-wiki 0.11.0 → 0.11.2

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

@@ -48,13 +48,107 @@ export const CommitSynthesisSchema = Type.Object({
     })),
 });
 // ── deterministic persistence (no LLM) ────────────────────
-function buildEntityPageBody(title, description, sourceId) {
+/** Localized headings for generated pages (issue #124). */
+const HEADINGS = {
+    ru: {
+        summary: "Резюме",
+        keyTakeaways: "Ключевые выводы",
+        entitiesMentioned: "Упомянутые сущности",
+        conceptsMentioned: "Упомянутые концепции",
+        notableQuotes: "Заметные цитаты",
+        contradictions: "Противоречия",
+        sourcePacket: "Пакет источника",
+        overview: "Обзор",
+        definition: "Определение",
+        noneRecorded: "[Не записано]",
+        none: "[Нет]",
+        id: "ID",
+        extracted: "Извлечено",
+        manifest: "Манифест",
+        contradiction: "⚠️ **Противоречие**",
+    },
+    fr: {
+        summary: "Résumé",
+        keyTakeaways: "Points clés",
+        entitiesMentioned: "Entités mentionnées",
+        conceptsMentioned: "Concepts mentionnés",
+        notableQuotes: "Citations notables",
+        contradictions: "Contradictions",
+        sourcePacket: "Paquet source",
+        overview: "Aperçu",
+        definition: "Définition",
+        noneRecorded: "[Aucun enregistré]",
+        none: "[Aucun]",
+        id: "ID",
+        extracted: "Extrait",
+        manifest: "Manifeste",
+        contradiction: "⚠️ **Contradiction**",
+    },
+    de: {
+        summary: "Zusammenfassung",
+        keyTakeaways: "Wichtige Erkenntnisse",
+        entitiesMentioned: "Erwähnte Entitäten",
+        conceptsMentioned: "Erwähnte Konzepte",
+        notableQuotes: "Bemerkenswerte Zitate",
+        contradictions: "Widersprüche",
+        sourcePacket: "Quellenpaket",
+        overview: "Übersicht",
+        definition: "Definition",
+        noneRecorded: "[Keine aufgezeichnet]",
+        none: "[Keine]",
+        id: "ID",
+        extracted: "Extrahiert",
+        manifest: "Manifest",
+        contradiction: "⚠️ **Widerspruch**",
+    },
+    ja: {
+        summary: "要約",
+        keyTakeaways: "主な要点",
+        entitiesMentioned: "言及されたエンティティ",
+        conceptsMentioned: "言及された概念",
+        notableQuotes: "注目すべき引用",
+        contradictions: "矛盾",
+        sourcePacket: "ソースパケット",
+        overview: "概要",
+        definition: "定義",
+        noneRecorded: "[記録なし]",
+        none: "[なし]",
+        id: "ID",
+        extracted: "抽出済み",
+        manifest: "マニフェスト",
+        contradiction: "⚠️ **矛盾**",
+    },
+};
+function getHeadings(lang) {
+    if (lang && HEADINGS[lang])
+        return HEADINGS[lang];
+    // English defaults
+    return {
+        summary: "Summary",
+        keyTakeaways: "Key Takeaways",
+        entitiesMentioned: "Entities Mentioned",
+        conceptsMentioned: "Concepts Mentioned",
+        notableQuotes: "Notable Quotes",
+        contradictions: "Contradictions",
+        sourcePacket: "Source Packet",
+        overview: "Overview",
+        definition: "Definition",
+        noneRecorded: "[None recorded]",
+        none: "[None]",
+        id: "ID",
+        extracted: "Extracted",
+        manifest: "Manifest",
+        contradiction: "⚠️ **Contradiction**",
+    };
+}
+function buildEntityPageBody(title, description, sourceId, lang) {
     const desc = description.trim() || "One-line description.";
+    const h = getHeadings(lang);
     return `# ${title}
 
 ${desc}
 
-## Overview
+## ${h.overview}
 
 [Key facts]
 
@@ -62,13 +156,14 @@ ${desc}
 
 - [${sourceId}](/sources/${sourceId}.md)`;
 }
-function buildConceptPageBody(title, definition, sourceId) {
+function buildConceptPageBody(title, definition, sourceId, lang) {
     const def = definition.trim() || "One-line definition.";
+    const h = getHeadings(lang);
     return `# ${title}
 
 ${def}
 
-## Definition
+## ${h.definition}
 
 [Clear explanation]
 
@@ -77,62 +172,63 @@ ${def}
 - [${sourceId}](/sources/${sourceId}.md)`;
 }
 /** Rebuild the source page body from synthesis data, marking it ingested. */
-export function buildIngestedSourcePageBody(manifest, data, _date) {
+export function buildIngestedSourcePageBody(manifest, data, _date, lang) {
     const id = String(manifest.id);
     const title = String(manifest.title || id);
     const url = manifest.url ? `\n> _Original: [${manifest.url}](${manifest.url})_` : "";
+    const h = getHeadings(lang);
     const takeaways = data.key_takeaways.length > 0
         ? data.key_takeaways.map((t) => `- ${t.trim()}`).join("\n")
-        : "- [None recorded]";
+        : `- ${h.noneRecorded}`;
     const entities = data.entities.length > 0
         ? data.entities.map((e) => `- [${e.title}](/entities/${slugify(e.title)}.md)`).join("\n")
-        : "- [None]";
+        : `- ${h.none}`;
     const concepts = data.concepts.length > 0
         ? data.concepts.map((c) => `- [${c.title}](/concepts/${slugify(c.title)}.md)`).join("\n")
-        : "- [None]";
+        : `- ${h.none}`;
     const quotes = data.quotes && data.quotes.length > 0
         ? data.quotes
             .map((q) => `> ${q.text.trim()}${q.attribution ? ` — ${q.attribution}` : ""}`)
             .join("\n\n")
-        : "> [None recorded]";
+        : `> ${h.noneRecorded}`;
     const contradictions = data.contradictions && data.contradictions.length > 0
-        ? `\n## Contradictions\n\n${data.contradictions.map((c) => `⚠️ **Contradiction**: ${c.trim()}`).join("\n")}\n`
+        ? `\n## ${h.contradictions}\n\n${data.contradictions.map((c) => `${h.contradiction}: ${c.trim()}`).join("\n")}\n`
         : "";
     return `# ${title}${url}
 
-## Summary
+## ${h.summary}
 
 ${data.summary.trim()}
 
-## Key Takeaways
+## ${h.keyTakeaways}
 
 ${takeaways}
 
-## Entities Mentioned
+## ${h.entitiesMentioned}
 
 ${entities}
 
-## Concepts Mentioned
+## ${h.conceptsMentioned}
 
 ${concepts}
 
-## Notable Quotes
+## ${h.notableQuotes}
 
 ${quotes}
-${contradictions}## Source Packet
+${contradictions}## ${h.sourcePacket}
 
-- **ID:** \`sources/${id}\`
-- **Extracted:** \`raw/sources/${id}/extracted.md\`
-- **Manifest:** \`raw/sources/${id}/manifest.json\`
+- **${h.id}:** \`sources/${id}\`
+- **${h.extracted}:** \`raw/sources/${id}/extracted.md\`
+- **${h.manifest}:** \`raw/sources/${id}/manifest.json\`
 `;
 }
 /** Rebuild the source page from synthesis data, marking it ingested. */
-export function buildIngestedSourcePage(manifest, data, date) {
+export function buildIngestedSourcePage(manifest, data, date, lang) {
     const id = String(manifest.id);
     const title = String(manifest.title || id);
     const format = String(manifest.format || "unknown");
     const captured = String(manifest.captured || date);
-    const body = buildIngestedSourcePageBody(manifest, data, date);
+    const body = buildIngestedSourcePageBody(manifest, data, date, lang);
     const doc = createKnowledgeDocument(`sources/${id}.md`, {
         type: "source",
         title,
@@ -150,7 +246,7 @@ export function buildIngestedSourcePage(manifest, data, date) {
  * ingested), create missing entity/concept pages (existing pages are linked,
  * never overwritten), and log the event. Pure file I/O — no LLM, no network.
  */
-export function commitSynthesis(paths, sourceId, manifest, data, date = fmtDate()) {
+export function commitSynthesis(paths, sourceId, manifest, data, date = fmtDate(), lang) {
     const result = {
         sourceId,
         sourcePage: join(paths.wiki, "sources", `${sourceId}.md`),
@@ -177,7 +273,7 @@ export function commitSynthesis(paths, sourceId, manifest, data, date = fmtDate(
             return { ok: false, sourceId, diagnostics: parsed.diagnostics };
         sourceDocument = patchKnowledgeDocument(parsed.document, {
             fields: { status: "ingested", updated: date },
-            body: buildIngestedSourcePageBody(manifest, data, date),
+            body: buildIngestedSourcePageBody(manifest, data, date, lang),
         });
     }
     else {
@@ -190,7 +286,7 @@ export function commitSynthesis(paths, sourceId, manifest, data, date = fmtDate(
             captured: String(manifest.captured || date),
             status: "ingested",
             updated: date,
-        }, buildIngestedSourcePageBody(manifest, data, date));
+        }, buildIngestedSourcePageBody(manifest, data, date, lang));
     }
     mkdirSync(join(paths.wiki, "sources"), { recursive: true });
     writeKnowledgeDocumentFile(result.sourcePage, sourceDocument);
@@ -211,7 +307,7 @@ export function commitSynthesis(paths, sourceId, manifest, data, date = fmtDate(
                 description: e.description.trim() || "One-line description.",
                 created: date,
                 updated: date,
-            }, buildEntityPageBody(e.title, e.description, sourceId), [{ id: sourceId, resource: `/sources/${sourceId}.md` }]);
+            }, buildEntityPageBody(e.title, e.description, sourceId, lang), [{ id: sourceId, resource: `/sources/${sourceId}.md` }]);
             writeKnowledgeDocumentFile(pagePath, entityDoc);
             result.entitiesCreated.push(slug);
         }
@@ -233,7 +329,7 @@ export function commitSynthesis(paths, sourceId, manifest, data, date = fmtDate(
                 description: c.definition.trim() || "One-line definition.",
                 created: date,
                 updated: date,
-            }, buildConceptPageBody(c.title, c.definition, sourceId), [{ id: sourceId, resource: `/sources/${sourceId}.md` }]);
+            }, buildConceptPageBody(c.title, c.definition, sourceId, lang), [{ id: sourceId, resource: `/sources/${sourceId}.md` }]);
             writeKnowledgeDocumentFile(pagePath, conceptDoc);
             result.conceptsCreated.push(slug);
         }
@@ -269,10 +365,14 @@ Rules:
  * synthesis.
  */
 export async function runIngestSynthesis(args) {
-    const { model, apiKey, headers, paths, sourceId, manifest, extracted, maxChars, signal } = args;
+    const { model, apiKey, headers, paths, sourceId, manifest, extracted, maxChars, signal, synthesisLanguage, } = args;
     const content = extracted.slice(0, maxChars ?? 24_000);
     if (!content.trim())
         return undefined;
+    const languageInstruction = synthesisLanguage
+        ? `\n\nWrite all generated content in ${synthesisLanguage}, including titles, headings, summaries, descriptions, and concept/entity names. Only preserve code, API names, file paths, commands, exact technical identifiers, and verbatim quotations in their original form.`
+        : "";
+    const systemPrompt = INGEST_SYSTEM + languageInstruction;
     let committed;
     const commitTool = {
         name: "commit_synthesis",
@@ -280,7 +380,7 @@ export async function runIngestSynthesis(args) {
         description: "Persist the structured synthesis of this source into wiki pages. Call exactly once.",
         parameters: CommitSynthesisSchema,
         execute: async (_id, params) => {
-            const outcome = commitSynthesis(paths, sourceId, manifest, params);
+            const outcome = commitSynthesis(paths, sourceId, manifest, params, undefined, synthesisLanguage);
             if (!outcome.ok) {
                 return {
                     content: [{ type: "text", text: `Failed: ${outcome.diagnostics[0].message}` }],
@@ -299,7 +399,7 @@ export async function runIngestSynthesis(args) {
         model,
         apiKey,
         headers,
-        systemPrompt: INGEST_SYSTEM,
+        systemPrompt,
         userPrompt,
         tools: [commitTool],
         signal,

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

@@ -26,17 +26,21 @@ export function rebuildMetadata(paths) {
     // Step 4: Build backlinks from discovered documents
     const knownIds = new Set(documents.map((d) => d.id));
     const backlinks = buildBacklinks(documents, knownIds, allDiagnostics);
-    const eventLogResult = buildOkfLog(readText(join(paths.meta, "events.jsonl")));
-    allDiagnostics.push(...eventLogResult.diagnostics);
+    const eventSource = readEventSource(join(paths.meta, "events.jsonl"));
+    const eventLogResult = eventSource.available ? buildOkfLog(eventSource.content) : undefined;
+    if (eventLogResult)
+        allDiagnostics.push(...eventLogResult.diagnostics);
+    else if (!eventSource.available)
+        allDiagnostics.push(eventSource.diagnostic);
     // Step 5: Build meta/index.md
     const metaIndex = buildIndexMarkdown(registry);
     // Step 6: Build meta/log.md (existing rich format)
-    const metaLog = buildLogMarkdown(paths);
+    const metaLog = eventSource.available ? buildLogMarkdown(eventSource.content) : undefined;
     // Step 7: Build OKF projections if in okf-0.2 mode
     const okfIndexes = vaultState.knowledgeFormat === "okf-0.2"
         ? buildDirectoryIndexes(documents, readJson(join(paths.dotWiki, "config.json"), {}))
         : null;
-    const okfLog = vaultState.knowledgeFormat === "okf-0.2" ? eventLogResult.markdown : null;
+    const okfLog = vaultState.knowledgeFormat === "okf-0.2" ? eventLogResult?.markdown : undefined;
     // Step 8: Atomic write all projections
     mkdirSync(paths.meta, { recursive: true });
     const registryJson = `${JSON.stringify(registry, null, 2)}\n`;
@@ -44,7 +48,8 @@ export function rebuildMetadata(paths) {
     atomicWriteFile(join(paths.meta, "registry.json"), registryJson);
     atomicWriteFile(join(paths.meta, "backlinks.json"), backlinksJson);
     atomicWriteFile(join(paths.meta, "index.md"), metaIndex);
-    atomicWriteFile(join(paths.meta, "log.md"), metaLog);
+    if (metaLog !== undefined)
+        atomicWriteFile(join(paths.meta, "log.md"), metaLog);
     // Step 9: Write OKF projections if applicable
     if (okfIndexes && okfIndexes.size > 0) {
         mkdirSync(paths.wiki, { recursive: true });
@@ -54,7 +59,7 @@ export function rebuildMetadata(paths) {
         // Prune obsolete generated indexes
         pruneObsoleteIndexes(paths, okfIndexes);
     }
-    if (okfLog !== null) {
+    if (okfLog !== undefined) {
         mkdirSync(paths.wiki, { recursive: true });
         atomicWriteFile(join(paths.wiki, "log.md"), okfLog);
     }
@@ -196,25 +201,21 @@ function buildIndexMarkdown(registry) {
     sections.push(`---\n*Last updated: ${registry.last_updated}* | *Total pages: ${Object.keys(registry.pages).length}*`);
     return `${sections.join("\n")}\n`;
 }
-/** Build meta/log.md in existing rich format. */
-function buildLogMarkdown(paths) {
-    const eventsPath = join(paths.meta, "events.jsonl");
+function buildLogMarkdown(eventsJsonl) {
     const events = [];
-    if (existsSync(eventsPath)) {
-        const raw = readText(eventsPath).trim();
-        for (const line of raw.split("\n")) {
-            if (!line.trim())
-                continue;
-            try {
-                const candidate = JSON.parse(line);
-                if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) {
-                    events.push(candidate);
-                }
-            }
-            catch {
-                // skip malformed
+    const raw = eventsJsonl.trim();
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const candidate = JSON.parse(line);
+            if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) {
+                events.push(candidate);
             }
         }
+        catch {
+            // Keep backward-compatible rich-log behavior: malformed lines are omitted.
+        }
     }
     const lines = [];
     lines.push("# Activity Log\n\n> Auto-generated from meta/events.jsonl. Do not edit manually.\n");
@@ -230,9 +231,8 @@ function buildLogMarkdown(paths) {
             lines.push(`- ${details}`);
         lines.push("");
     }
-    if (events.length === 0) {
+    if (events.length === 0)
         lines.push("_No events recorded yet._\n");
-    }
     return `${lines.join("\n")}\n`;
 }
 /** Append an event to events.jsonl. */
@@ -254,15 +254,21 @@ function atomicWriteFile(path, content) {
     writeFileSync(temporary, content, "utf8");
     renameSync(temporary, path);
 }
-/** Read text file or return empty string. */
-function readText(path) {
+function readEventSource(filePath, diagnosticPath = "meta/events.jsonl") {
     try {
-        if (!existsSync(path))
-            return "";
-        return readFileSync(path, "utf8");
+        return { available: true, content: readFileSync(filePath, "utf8") };
     }
-    catch {
-        return "";
+    catch (error) {
+        const code = error.code;
+        // ENOENT = missing; ENOTDIR/EISDIR = not a regular file (FreeBSD dir hazard); else unreadable
+        const diagnosticCode = code === "ENOENT" ? "event_source_missing" : "event_source_unreadable";
+        const message = diagnosticCode === "event_source_missing"
+            ? "Authoritative event source is missing; existing log projections were preserved"
+            : "Authoritative event source is unreadable; existing log projections were preserved";
+        return {
+            available: false,
+            diagnostic: okfDiag("warning", diagnosticCode, diagnosticPath, message),
+        };
     }
 }
 /** Prune obsolete generated indexes in OKF mode. */

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

@@ -35,7 +35,6 @@ export function registerWikiModelCommand(pi, runtime) {
             const apply = (model) => {
                 persistTaskModel(ctx.cwd, model);
                 runtime.config = { ...runtime.config, taskModel: model };
-                runtime.configLoaded = true;
                 const label = formatActiveModelLabel(runtime.config, sessionId);
                 ctx.ui.setStatus(MODEL_STATUS_KEY, `🧠 wiki model: ${label}`);
                 ctx.ui.notify(`LLM Wiki: background tasks now use ${label}`, "info");

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

@@ -1,7 +1,6 @@
 import { TASK_DEFAULTS, loadTaskConfig, noticesEnabled } from "./task-config.js";
 export class Runtime {
     config = { ...TASK_DEFAULTS };
-    configLoaded = false;
     /**
      * Extension API handle, attached at registration. Used by `report()` to emit
      * visible completion messages for background actions (issue #77). Optional so
@@ -15,10 +14,7 @@ export class Runtime {
     /** Whether we've already surfaced a model-resolution failure (avoid spam). */
     resolveFailureNotified = false;
     ensureConfig(cwd) {
-        if (this.configLoaded)
-            return;
         this.config = loadTaskConfig(cwd);
-        this.configLoaded = true;
     }
     /** True if a task with this label is currently running. */
     isInFlight(label) {

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

@@ -80,7 +80,7 @@ function fileCaptureSource(pi, filePath, signal) {
             file_path: filePath,
             format: extractor.format,
         }),
-        event: () => ({ file_path: filePath, format: extractor.format }),
+        event: () => ({ format: extractor.format }),
     };
 }
 function textCaptureSource(text, title) {

package/dist/extensions/llm-wiki/lib/task-config.js

@@ -67,6 +67,12 @@ function readNamespacedConfig(path) {
         if (typeof section.trajectories === "boolean") {
             out.trajectories = section.trajectories;
         }
+        const lang = section.synthesisLanguage;
+        if (typeof lang === "string" && lang.trim()) {
+            const canonical = validateSynthesisLanguage(lang.trim());
+            if (canonical)
+                out.synthesisLanguage = canonical;
+        }
         return out;
     }
     catch {
@@ -91,6 +97,29 @@ export function parseModelRef(ref) {
         return undefined;
     return { provider, id };
 }
+/**
+ * Validate and canonicalize a BCP 47 language tag for synthesisLanguage (issue #124).
+ * Returns the canonical tag, or undefined if invalid or suspicious.
+ * Uses Intl.getCanonicalLocales for validation; rejects tags containing
+ * newlines, quotes, or other prompt-injection candidates.
+ */
+export function validateSynthesisLanguage(tag) {
+    // Reject obvious injection attempts: newlines, quotes, braces, angle brackets
+    if (/\n|\r|"|'|<|>|{|}/.test(tag))
+        return undefined;
+    // Reject if it looks like an instruction (contains "write", "ignore", "translate", etc.)
+    const lower = tag.toLowerCase();
+    if (/\b(write|ignore|translate|system|prompt|instruction)\b/.test(lower))
+        return undefined;
+    // Basic BCP 47 pattern: language[-script][-region][-variant]*
+    // Must start with 2-3 letter language code
+    if (!/^[a-z]{2,3}(?:-[A-Za-z]{1,8})*$/.test(tag))
+        return undefined;
+    const canonical = Intl.getCanonicalLocales(tag);
+    if (canonical.length === 0)
+        return undefined;
+    return canonical[0];
+}
 /**
  * Read a settings JSON file as a plain object, or `{}` when it is absent or
  * corrupt. Reads directly (no `existsSync` pre-check) so there is no

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

@@ -327,6 +327,7 @@ export function registerWikiIngest(pi, runtime) {
                                 sourceId: s.id,
                                 manifest: s.manifest,
                                 extracted: s.extracted,
+                                synthesisLanguage: runtime.config.synthesisLanguage,
                             });
                             if (committed) {
                                 // Background semantic embeddings (#66): embed the pages this
@@ -960,6 +961,12 @@ export function registerWikiRebuildMeta(pi, runtime) {
                     if (!result.ok) {
                         return `⚠️ LLM Wiki: rebuild had issues — ${result.diagnostics.map((d) => `${d.code}: ${d.message}`).join("; ")}`;
                     }
+                    const warnings = result.diagnostics.filter((diagnostic) => diagnostic.severity === "warning");
+                    if (warnings.length > 0) {
+                        return `⚠️ LLM Wiki: metadata rebuilt with warnings — ${warnings
+                            .map((diagnostic) => `${diagnostic.code}: ${diagnostic.message}`)
+                            .join("; ")}`;
+                    }
                     const registry = readJson(join(paths.meta, "registry.json"), {
                         version: "1.0",
                         last_updated: "",

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

@@ -333,6 +333,12 @@ export function isProtectedPath(absPath, paths) {
                 reason: "Raw sources are immutable. Use wiki_capture_source to add sources.",
             };
         }
+        if (relativePhysicalPath(paths.meta, absPath) === "events.jsonl") {
+            return {
+                protected: true,
+                reason: "Event history is append-only authoritative state. Use wiki_log_event or an owning wiki operation instead.",
+            };
+        }
         if (isPathWithin(paths.meta, absPath)) {
             return {
                 protected: true,

package/dist/mcp/index.js

@@ -10,7 +10,8 @@
  */
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { McpServer, StdioServerTransport } from "@modelcontextprotocol/server";
+import { McpServer } from "@modelcontextprotocol/server";
+import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
 import * as z from "zod/v4";
 import { resolveVaultPaths } from "../extensions/llm-wiki/lib/utils.js";
 import { createExecApi } from "./exec.js";

package/docs/api.md

@@ -280,6 +280,8 @@ Health is `"⚠️ Warning"` when orphan count exceeds 5, `"🔴 Empty"` when th
 Force a full synchronous rebuild of all generated metadata: `registry.json`, `backlinks.json`,
 `index.md`, `log.md`. Use when metadata appears out of sync with actual wiki files.
 
+If `meta/events.jsonl` is missing or unreadable, rebuild reports a warning and preserves existing log projections while continuing to rebuild registry, backlinks, and indexes. A present zero-byte event file is an intentional empty history.
+
 **Parameters**
 
 None.
@@ -294,8 +296,9 @@ details: { pageCount: number }
 
 ## wiki_log_event
 
-Append a structured event to `meta/events.jsonl` and regenerate `meta/log.md`. Every event is
-timestamped automatically.
+Append a structured event to the authoritative, append-only `meta/events.jsonl` stream and regenerate available log projections. Every event is timestamped automatically. The event stream must be preserved in full-vault backups; generated Markdown logs cannot reconstruct it.
+
+`details` is user-controlled and may appear in OKF-mode `wiki/log.md`. Do not include secrets, credentials, or private machine-local paths. Built-in local-file capture records its stable source ID and format in events, omitting the caller-supplied input path from the event stream and generated log projections. The exact path remains in the extension-owned raw manifest. Other wiki projections are not covered by this guarantee: extraction-failure text and source-page titles may still surface path-derived strings, so treat the source page area as potentially machine-local until a dedicated sanitization pass exists.
 
 **Parameters**
 

package/docs/architecture.md

@@ -55,7 +55,7 @@ WIKI_ROOT/
     │   ├── analyses/          # Durable query answers
     │   ├── cases/             # One specific past task per trajectory
     │   └── skills/            # Reusable patterns distilled from trajectories
-    ├── meta/                  # Auto-generated (extension-owned)
+    ├── meta/                  # Durable event source + generated internal projections
     │   ├── registry.json      # Master page catalog
     │   ├── backlinks.json     # Inbound link map
     │   ├── index.md           # Human-readable catalog
@@ -73,9 +73,12 @@ WIKI_ROOT/
 | --------------------- | ------------------------ | ------------------------ |
 | `.llm-wiki/raw/**`    | Extension                | Immutable after capture  |
 | `.llm-wiki/wiki/**`   | Model + user             | Editable knowledge pages |
-| `.llm-wiki/meta/**`   | Extension                | Auto-generated           |
+| `.llm-wiki/meta/events.jsonl` | Extension tools | Authoritative, append-only; preserve in full-vault backups |
+| `.llm-wiki/meta/**` except `events.jsonl` | Extension | Generated projections |
 | `.llm-wiki/` | Human + explicit request | Operating rules          |
 
+`events.jsonl` records selected extension operations, not every filesystem edit. `meta/log.md` and OKF-mode `wiki/log.md` are one-way projections; neither can recover the event stream.
+
 ## Source Packet Format
 
 Each captured source becomes a packet:

package/docs/configuration.md

@@ -32,6 +32,31 @@ The personal vault lives at `~/.llm-wiki/` (or `$WIKI_HOME`) and is always avail
 | `WIKI_HOME`                   | `~/.llm-wiki` | Override the personal wiki vault location     |
 | `WIKI_MARKITDOWN_TIMEOUT_MS` | 180000      | Timeout (ms) for MarkItDown PDF/text extraction |
 
+## Pi Agent Settings
+
+Runtime settings for the wiki's background tasks live in `.pi/settings.json` under the `llm-wiki` namespace. These can be set globally (`~/.pi/agent/settings.json`) or per-project (`<cwd>/.pi/settings.json`).
+
+| Setting               | Default | Description                                                  |
+| --------------------- | ------- | ------------------------------------------------------------ |
+| `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. |
+| `trajectories`        | false   | Enable agent-trajectory working-memory                       |
+| `notices`             | true    | Show wiki activity notices in chat                           |
+
+Example:
+
+```json
+{
+  "llm-wiki": {
+    "synthesisLanguage": "ru",
+    "taskModel": {
+      "provider": "openai",
+      "id": "gpt-4o"
+    }
+  }
+}
+```
+
 ## Vault Resolution
 
 The vault root is resolved in this priority order: