llm-wiki-kit 0.1.5 → 0.1.6

package/src/install.js

@@ -78,8 +78,10 @@ export async function install(options = {}) {
     await backupFile(localBinPath, 'local-bin-llm-wiki');
   }
   await safeSymlink(binPath, localBinPath);
-  await bootstrapProject(workspace, { profile: options.profile || 'standard', recordState: true });
-  await recordProject(workspace, 'install');
+  if (!options.noProject) {
+    await bootstrapProject(workspace, { profile: options.profile || 'standard', recordState: true });
+    await recordProject(workspace, 'install');
+  }
 
   const codexHooksPath = join(homeDir(), '.codex', 'hooks.json');
   const claudeSettingsPath = join(homeDir(), '.claude', 'settings.json');

package/src/project-state.js

@@ -1,7 +1,7 @@
 import { dirname, join, relative } from 'path';
 import { backupFile, ensureDir, exists, readJson, readText, sha256, writeJson, writeText } from './fs-utils.js';
 import { runtimeVersion } from './version.js';
-import { llmWikiAgents, procedure, rootAgentsPolicy } from './templates.js';
+import { llmWikiAgents, memoryPage, procedure, rootAgentsPolicy } from './templates.js';
 
 export const PROJECT_STATE_SCHEMA_VERSION = 1;
 export const PROJECT_STATE_FILE = '.kit-state.json';
@@ -27,7 +27,12 @@ function templateDescriptors() {
       path: join('llm-wiki', 'AGENTS.md'),
       content: llmWikiAgents(),
       mode: 'generated-file',
-      marker: 'Generated by llm-wiki-kit',
+    },
+    {
+      id: 'wiki-memory',
+      path: join('llm-wiki', 'wiki', 'memory.md'),
+      content: memoryPage(),
+      mode: 'create-only',
     },
     ...PROCEDURE_NAMES.map((name) => ({
       id: `procedure-${name.replace(/\.md$/, '')}`,
@@ -81,32 +86,45 @@ function replaceMarkedBlock(current, replacement) {
   return `${current.slice(0, start)}${replacement.trimStart().trimEnd()}${current.slice(afterEnd)}`;
 }
 
-function hasGeneratedMarker(text, descriptor) {
-  return descriptor.marker ? text.includes(descriptor.marker) : false;
+function markerStatus(current) {
+  const start = current.indexOf(ROOT_POLICY_START);
+  const end = current.indexOf(ROOT_POLICY_END);
+  if (start === -1 && end === -1) return 'missing';
+  if (start === -1 || end === -1 || end < start) return 'malformed';
+  return 'complete';
 }
 
 function isRecordedManaged(state, descriptor, currentText) {
   const recorded = state.managedTemplates?.[descriptor.id];
   if (!recorded) return false;
+  if (descriptor.mode === 'create-only') return true;
   if (descriptor.mode === 'marker') return true;
-  return !recorded.hash || recorded.hash === templateHash(currentText);
+  return Boolean(recorded.hash) && recorded.hash === templateHash(currentText);
 }
 
 function isKnownGeneratedContent(text, descriptor) {
+  if (descriptor.mode === 'create-only') return false;
   if (descriptor.mode === 'marker') return replaceMarkedBlock(text, descriptor.content) !== null;
-  return templateHash(text) === templateHash(descriptor.content) || hasGeneratedMarker(text, descriptor);
+  return templateHash(text) === templateHash(descriptor.content);
 }
 
-function canPatchDescriptor(state, descriptor, currentText) {
+function canPatchDescriptor(state, descriptor, currentText, fileExists = true) {
+  if (descriptor.mode === 'create-only') return !fileExists;
   if (descriptor.mode === 'marker') return replaceMarkedBlock(currentText, descriptor.content) !== null;
   return isRecordedManaged(state, descriptor, currentText) || isKnownGeneratedContent(currentText, descriptor);
 }
 
-function desiredTextForDescriptor(descriptor, currentText) {
+function desiredTextForDescriptor(descriptor, currentText, fileExists = true) {
+  if (descriptor.mode === 'create-only') return fileExists ? currentText : descriptor.content;
   if (descriptor.mode === 'marker') return replaceMarkedBlock(currentText, descriptor.content);
   return descriptor.content;
 }
 
+async function createOnlyParentExists(projectRoot, descriptor) {
+  if (descriptor.mode !== 'create-only') return true;
+  return exists(dirname(join(projectRoot, descriptor.path)));
+}
+
 export async function inspectProjectState(projectRoot) {
   const state = await readProjectState(projectRoot);
   const runtime = runtimeVersion();
@@ -116,12 +134,18 @@ export async function inspectProjectState(projectRoot) {
     const absolutePath = join(projectRoot, descriptor.path);
     const fileExists = await exists(absolutePath);
     const currentText = fileExists ? await readText(absolutePath) : '';
-    const desiredText = fileExists ? desiredTextForDescriptor(descriptor, currentText) : descriptor.content;
+    const desiredText = desiredTextForDescriptor(descriptor, currentText, fileExists);
     const desiredHash = templateHash(desiredText || descriptor.content);
     const currentHash = fileExists ? templateHash(currentText) : null;
     const recorded = state.managedTemplates[descriptor.id] || null;
-    const patchable = fileExists ? canPatchDescriptor(state, descriptor, currentText) : false;
-    const current = fileExists && desiredText !== null && currentHash === templateHash(desiredText);
+    const markerState = descriptor.mode === 'marker' && fileExists ? markerStatus(currentText) : null;
+    const parentExists = await createOnlyParentExists(projectRoot, descriptor);
+    const patchable = descriptor.mode === 'create-only' && !fileExists && !parentExists
+      ? false
+      : (markerState === 'malformed' || canPatchDescriptor(state, descriptor, currentText, fileExists));
+    const current = descriptor.mode === 'create-only'
+      ? fileExists
+      : fileExists && desiredText !== null && currentHash === templateHash(desiredText);
 
     files.push({
       id: descriptor.id,
@@ -133,6 +157,7 @@ export async function inspectProjectState(projectRoot) {
       desiredHash,
       recordedHash: recorded?.hash || null,
       recordedVersion: recorded?.version || null,
+      reason: markerState === 'malformed' ? 'malformed-marker' : null,
     });
   }
 
@@ -155,6 +180,14 @@ export async function recordManagedTemplates(projectRoot) {
     const absolutePath = join(projectRoot, descriptor.path);
     if (!(await exists(absolutePath))) continue;
     const currentText = await readText(absolutePath);
+    if (descriptor.mode === 'create-only') {
+      state.managedTemplates[descriptor.id] = {
+        path: descriptor.path,
+        version: runtime,
+        hash: templateHash(currentText),
+      };
+      continue;
+    }
     if (!canPatchDescriptor(state, descriptor, currentText)) continue;
     state.managedTemplates[descriptor.id] = {
       path: descriptor.path,
@@ -177,11 +210,43 @@ export async function applyProjectTemplateUpdate(projectRoot, options = {}) {
   for (const descriptor of templateDescriptors()) {
     const absolutePath = join(projectRoot, descriptor.path);
     if (!(await exists(absolutePath))) {
+      if (descriptor.mode === 'create-only') {
+        if (!(await createOnlyParentExists(projectRoot, descriptor))) {
+          skipped.push({ id: descriptor.id, path: descriptor.path, reason: 'missing-wiki' });
+          continue;
+        }
+        if (!options.dryRun) {
+          await ensureDir(dirname(absolutePath));
+          await writeText(absolutePath, descriptor.content, 'utf8');
+        }
+        changed.push({ id: descriptor.id, path: descriptor.path });
+        state.managedTemplates[descriptor.id] = {
+          path: descriptor.path,
+          version: runtime,
+          hash: templateHash(descriptor.content),
+        };
+        continue;
+      }
       skipped.push({ id: descriptor.id, path: descriptor.path, reason: 'missing' });
       continue;
     }
 
     const currentText = await readText(absolutePath);
+    if (descriptor.mode === 'marker' && markerStatus(currentText) === 'malformed') {
+      skipped.push({ id: descriptor.id, path: descriptor.path, reason: 'malformed-marker' });
+      continue;
+    }
+
+    if (descriptor.mode === 'create-only') {
+      unchanged.push({ id: descriptor.id, path: descriptor.path });
+      state.managedTemplates[descriptor.id] = {
+        path: descriptor.path,
+        version: runtime,
+        hash: templateHash(currentText),
+      };
+      continue;
+    }
+
     if (!canPatchDescriptor(state, descriptor, currentText)) {
       skipped.push({ id: descriptor.id, path: descriptor.path, reason: 'not-managed' });
       continue;

package/src/project.js

@@ -3,7 +3,6 @@ import {
   appendText,
   ensureDir,
   exists,
-  listMarkdownFiles,
   readText,
   timeKst,
   todayKst,
@@ -11,8 +10,9 @@ import {
 } from './fs-utils.js';
 import { LLM_WIKI_DIRS } from './constants.js';
 import { normalizeForStorage, redactText, summarizeForStorage } from './redaction.js';
-import { gitignore, indexPage, llmWikiAgents, logPage, procedure, rootAgentsPolicy } from './templates.js';
+import { gitignore, indexPage, llmWikiAgents, logPage, memoryPage, procedure, rootAgentsPolicy } from './templates.js';
 import { recordManagedTemplates } from './project-state.js';
+import { buildContextPack, formatContextPack, searchWiki as searchWikiWithIndex } from './wiki-search.js';
 
 export async function bootstrapProject(projectRoot, options = {}) {
   if (process.env.LLM_WIKI_KIT_DISABLE_BOOTSTRAP === '1') return { created: false };
@@ -28,6 +28,7 @@ export async function bootstrapProject(projectRoot, options = {}) {
 
   await maybeCreate(join(base, 'AGENTS.md'), llmWikiAgents());
   await maybeCreate(join(base, 'wiki', 'index.md'), indexPage());
+  await maybeCreate(join(base, 'wiki', 'memory.md'), memoryPage());
   await maybeCreate(join(base, 'wiki', 'log.md'), logPage());
   await maybeCreate(join(base, '.gitignore'), gitignore());
   for (const name of ['ingest.md', 'query.md', 'lint.md', 'security.md']) {
@@ -128,7 +129,7 @@ export async function writeQueryPage(projectRoot, entry) {
   const slug = slugify(entry.question, 'query');
   const path = join(projectRoot, 'llm-wiki', 'wiki', 'queries', `${day}-${slug}.md`);
   if (await exists(path)) return path;
-  const content = `---\ntitle: "${entry.topic || slug}"\ntype: "query"\nsource_ids: []\nstatus: "draft"\nlast_updated: "${day}"\nconfidence: "medium"\n---\n\n# ${entry.topic || entry.question.slice(0, 80)}\n\n## Question\n${entry.question}\n\n## Answer Summary\n${entry.result || '(not captured)'}\n\n## Work Notes\n${entry.work || '(not captured)'}\n\n## Verification\n${entry.verification || '(not captured)'}\n\n## Related Pages\n- [[index]]\n\n## Change Log\n- ${day}: Captured automatically by llm-wiki-kit hook.\n`;
+  const content = `---\ntitle: "${entry.topic || slug}"\ntype: "query"\nsource_ids: []\nstatus: "draft"\nlast_updated: "${day}"\nconfidence: "medium"\nmemory_type: "episodic"\nimportance: 2\nlast_verified: "unknown"\nsupersedes: []\nsuperseded_by: []\n---\n\n# ${entry.topic || entry.question.slice(0, 80)}\n\n## Question\n${entry.question}\n\n## Answer Summary\n${entry.result || '(not captured)'}\n\n## Work Notes\n${entry.work || '(not captured)'}\n\n## Verification\n${entry.verification || '(not captured)'}\n\n## Related Pages\n- [[index]]\n\n## Change Log\n- ${day}: Captured automatically by llm-wiki-kit hook.\n`;
   await writeTextIfMissing(path, redactText(content, 12000));
   return path;
 }
@@ -141,7 +142,7 @@ export async function writeDecisionPage(projectRoot, entry) {
   const slug = slugify(entry.topic || entry.question || 'decision', 'decision');
   const path = join(projectRoot, 'llm-wiki', 'wiki', 'decisions', `${day}-${slug}.md`);
   if (await exists(path)) return path;
-  const content = `---\ntitle: "${entry.topic || slug}"\ntype: "decision"\nsource_ids: []\nstatus: "draft"\nlast_updated: "${day}"\nconfidence: "medium"\n---\n\n# ${entry.topic || 'Decision'}\n\n## Decision\n${entry.result || '(captured from assistant response; review needed)'}\n\n## Context\n${entry.question || '(not captured)'}\n\n## Evidence\n${entry.work || '(not captured)'}\n\n## Verification\n${entry.verification || '(not captured)'}\n\n## Open Questions\n${entry.followUp || '(none captured)'}\n\n## Change Log\n- ${day}: Captured automatically by llm-wiki-kit hook.\n`;
+  const content = `---\ntitle: "${entry.topic || slug}"\ntype: "decision"\nsource_ids: []\nstatus: "draft"\nlast_updated: "${day}"\nconfidence: "medium"\nmemory_type: "semantic"\nimportance: 4\nlast_verified: "unknown"\nsupersedes: []\nsuperseded_by: []\n---\n\n# ${entry.topic || 'Decision'}\n\n## Decision\n${entry.result || '(captured from assistant response; review needed)'}\n\n## Context\n${entry.question || '(not captured)'}\n\n## Evidence\n${entry.work || '(not captured)'}\n\n## Verification\n${entry.verification || '(not captured)'}\n\n## Open Questions\n${entry.followUp || '(none captured)'}\n\n## Change Log\n- ${day}: Captured automatically by llm-wiki-kit hook.\n`;
   await writeTextIfMissing(path, redactText(content, 12000));
   return path;
 }
@@ -153,59 +154,14 @@ export async function appendContextNote(projectRoot, eventName, text) {
   await appendText(path, block);
 }
 
-function tokenize(text) {
-  return String(text || '')
-    .toLowerCase()
-    .replace(/[^\p{Letter}\p{Number}]+/gu, ' ')
-    .split(/\s+/)
-    .filter((token) => token.length >= 2)
-    .slice(0, 80);
-}
-
 export async function searchWiki(projectRoot, query, limit = 5) {
-  const wikiRoot = join(projectRoot, 'llm-wiki', 'wiki');
-  const files = await listMarkdownFiles(wikiRoot, 400);
-  const terms = tokenize(query);
-  if (terms.length === 0) return [];
-  const scored = [];
-  for (const file of files) {
-    const raw = await readText(file);
-    const content = raw.slice(0, 50000);
-    const lower = content.toLowerCase();
-    let score = 0;
-    for (const term of terms) {
-      if (lower.includes(term)) score += term.length > 3 ? 2 : 1;
-    }
-    if (score > 0) {
-      const rel = relative(join(projectRoot, 'llm-wiki'), file);
-      scored.push({
-        score,
-        path: rel,
-        snippet: content.replace(/\s+/g, ' ').slice(0, 350),
-      });
-    }
-  }
-  return scored.sort((a, b) => b.score - a.score).slice(0, limit);
+  return searchWikiWithIndex(projectRoot, query, typeof limit === 'number' ? { limit } : limit);
 }
 
 export async function buildContextBrief(projectRoot, eventName, query = '') {
-  const index = await readText(join(projectRoot, 'llm-wiki', 'wiki', 'index.md'));
-  const log = await readText(join(projectRoot, 'llm-wiki', 'wiki', 'log.md'));
-  const hits = query ? await searchWiki(projectRoot, query, 5) : [];
-  const parts = [
-    'LLM Wiki context from llm-wiki-kit:',
-    '- Treat chat memory as temporary; update project Markdown when knowledge should persist.',
-    '- Preserve raw/wiki separation. Do not store secrets, tokens, .env contents, private keys, or personal/customer identifiers.',
-    '- Prefer updating existing wiki pages over creating duplicate pages.',
-    '',
-    'Index excerpt:',
-    index.slice(0, 1200).trim(),
-  ];
-  if (hits.length > 0) {
-    parts.push('', 'Relevant wiki pages:', ...hits.map((hit) => `- ${hit.path}: ${hit.snippet}`));
-  }
-  if (eventName === 'SessionStart') {
-    parts.push('', 'Recent log excerpt:', log.slice(-1000).trim());
-  }
-  return parts.join('\n').trim();
+  const pack = await buildContextPack(projectRoot, query, {
+    includeLog: eventName === 'SessionStart',
+    limit: 5,
+  });
+  return formatContextPack(pack);
 }

package/src/templates.js

@@ -1,15 +1,98 @@
 import { runtimeVersion } from './version.js';
 
 export function rootAgentsPolicy() {
-  return `\n<!-- llm-wiki-kit:start -->\n## LLM Wiki Policy\n\nThis repository uses llm-wiki-kit as a hook-first living Markdown wiki for Codex and Claude Code.\n\n- This block supersedes older OMX/OMC/\`omx_wiki/\` LLM Wiki instructions for this repository.\n- Treat chat memory as temporary; durable project knowledge belongs in \`llm-wiki/\`.\n- \`llm-wiki/raw/\` stores immutable or redacted source material. Do not edit raw source files.\n- \`llm-wiki/wiki/\` stores LLM-maintained knowledge pages such as decisions, architecture, debugging, context, concepts, and queries.\n- Before non-trivial work, use the injected LLM Wiki context and consult \`llm-wiki/wiki/index.md\` when present.\n- Capture reusable decisions, debugging findings, verification commands, and open questions into the wiki.\n- Preserve useful work context, but do not store raw authentication values such as tokens, passwords, or private keys.\n- Mark inference explicitly and preserve contradictions instead of silently overwriting them.\n\n<!-- llm-wiki-kit:end -->\n`;
+  return `\n<!-- llm-wiki-kit:start -->\n## LLM Wiki Policy\n\nThis repository uses llm-wiki-kit as a hook-first living Markdown wiki for Codex and Claude Code.\n\n- This block supersedes older OMX/OMC/\`omx_wiki/\` LLM Wiki instructions for this repository.\n- Treat chat memory as temporary; durable project knowledge belongs in \`llm-wiki/\`.\n- \`llm-wiki/raw/\` stores immutable or redacted source material. Do not edit raw source files.\n- \`llm-wiki/wiki/\` stores LLM-maintained knowledge pages such as decisions, architecture, debugging, context, concepts, and queries.\n- \`llm-wiki/wiki/memory.md\` is the short hot index for the most reusable current facts; keep it concise and link to deeper pages.\n- Before non-trivial work, use the injected LLM Wiki context and consult \`llm-wiki/wiki/memory.md\` and \`llm-wiki/wiki/index.md\` when present.\n- Capture reusable decisions, debugging findings, verification commands, and open questions into the wiki.\n- Preserve useful work context, but do not store raw authentication values such as tokens, passwords, or private keys.\n- Mark inference explicitly and preserve contradictions instead of silently overwriting them.\n\n<!-- llm-wiki-kit:end -->\n`;
 }
 
 export function llmWikiAgents() {
-  return `# LLM Wiki Agent Rules\n\nGenerated by llm-wiki-kit ${runtimeVersion()}.\n\n## Purpose\nMaintain a living Markdown LLM Wiki from immutable source files and redacted Codex/Claude Code session events.\nThese rules supersede older OMX/OMC/\`omx_wiki/\` LLM Wiki rules for this project.\n\n## Directories\n- \`raw/\`: immutable or redacted source material. Never edit original source captures.\n- \`wiki/\`: AI-maintained knowledge pages.\n- \`outputs/\`: live Q&A summaries, reports, and generated briefs.\n- \`procedures/\`: detailed operating rules for ingest, query, lint, and security.\n\n## Core Rules\n- Never modify \`raw/\` source material except to append redacted session envelopes generated by hooks.\n- Do not state unsupported claims as facts.\n- Mark inference explicitly.\n- Add \`source_ids\` or file references for important claims.\n- Update \`wiki/index.md\` and \`wiki/log.md\` whenever new durable knowledge is created.\n- Preserve contradictions in \`Contradictions\` or \`Open Questions\` instead of overwriting them.\n- Preserve useful work context and redact authentication values before writing durable notes.\n\n## Page Format\nUse YAML frontmatter when creating wiki pages:\n\n\`\`\`yaml\n---\ntitle: \"\"\ntype: \"source | concept | entity | decision | architecture | debugging | context | query | session-log | convention\"\nsource_ids: []\nstatus: \"draft | reviewed | stale\"\nlast_updated: \"YYYY-MM-DD\"\nconfidence: \"high | medium | low\"\n---\n\`\`\`\n\n## Operations\n- ingest: read new raw files, create or update wiki pages, then update \`wiki/index.md\` and \`wiki/log.md\`.\n- query: start from \`wiki/index.md\`, read relevant wiki pages, answer with source references, and save reusable answers.\n- lint: find stale pages, orphan pages, broken wiki links, missing sources, duplicate concepts, contradictions, and missing links.\n`;
+  return `# LLM Wiki Agent Rules
+
+Generated by llm-wiki-kit ${runtimeVersion()}.
+
+## Purpose
+Maintain a living Markdown LLM Wiki from immutable source files and redacted Codex/Claude Code session events.
+These rules supersede older OMX/OMC/\`omx_wiki/\` LLM Wiki rules for this project.
+
+## Directories
+- \`raw/\`: immutable or redacted source material. Never edit original source captures.
+- \`wiki/\`: AI-maintained knowledge pages. \`wiki/memory.md\` is the short hot index injected into hook context.
+- \`outputs/\`: live Q&A summaries, reports, and generated briefs.
+- \`procedures/\`: detailed operating rules for ingest, query, lint, and security.
+
+## Core Rules
+- Never modify \`raw/\` source material except to append redacted session envelopes generated by hooks.
+- Do not state unsupported claims as facts.
+- Mark inference explicitly.
+- Add \`source_ids\` or file references for important claims.
+- Update \`wiki/memory.md\`, \`wiki/index.md\`, and \`wiki/log.md\` whenever new durable knowledge changes the active project map.
+- Preserve contradictions in \`Contradictions\` or \`Open Questions\` instead of overwriting them.
+- Preserve useful work context and redact authentication values before writing durable notes.
+
+## Page Format
+Use YAML frontmatter when creating wiki pages:
+
+\`\`\`yaml
+---
+title: ""
+type: "source | concept | entity | decision | architecture | debugging | context | query | session-log | convention"
+source_ids: []
+status: "draft | reviewed | stale"
+last_updated: "YYYY-MM-DD"
+confidence: "high | medium | low"
+memory_type: "semantic | episodic | procedural"
+importance: 1
+last_verified: "YYYY-MM-DD | unknown"
+supersedes: []
+superseded_by: []
+---
+\`\`\`
+
+## Operations
+- ingest: read \`wiki/memory.md\` and \`wiki/index.md\`, ingest new raw files, create or update wiki pages, then update the active map and \`wiki/log.md\`.
+- query: start from \`llm-wiki context "<query>"\` or \`wiki/memory.md\`, read relevant wiki pages, answer with source references, and save reusable answers.
+- lint: run \`llm-wiki lint --workspace <project>\` to find stale pages, orphan pages, broken wiki/Markdown links, unsafe source IDs, secret-like content, missing sources, duplicate concepts, contradictions, and missing links.
+- consolidate: run \`llm-wiki consolidate --workspace <project>\` after meaningful wiki growth to refresh generated memory/index blocks without overwriting hand-written notes. Default query/context/session-log pages are excluded unless explicitly durable.
+`;
 }
 
 export function indexPage() {
-  return `# LLM Wiki Index\n\nGenerated by llm-wiki-kit.\n\n## Overview\n\nThis is the navigation map for the project living wiki. Keep it short and useful.\n\n## Main Areas\n\n- [Sources](sources/) - source summaries and source IDs.\n- [Concepts](concepts/) - reusable concepts and terminology.\n- [Entities](entities/) - people, systems, modules, vendors, services, and tools.\n- [Decisions](decisions/) - decisions and rationale.\n- [Architecture](architecture/) - system structure and data/control flow.\n- [Debugging](debugging/) - root causes, fixes, verification evidence.\n- [Context](context/) - session continuity and project memory.\n- [Queries](queries/) - durable answers to useful questions.\n\n## Operating Notes\n\n- Start from this index before broad project questions.\n- Read 3-7 relevant pages first; inspect raw sources only when precision matters.\n- Add links using \`[[page-or-topic]]\` when pages become related.\n`;
+  return `# LLM Wiki Index\n\nGenerated by llm-wiki-kit.\n\n## Overview\n\nThis is the navigation map for the project living wiki. Keep it short and useful.\n\n## Main Areas\n\n- [Memory](memory.md) - short hot index and durable entry points.\n- [Sources](sources/) - source summaries and source IDs.\n- [Concepts](concepts/) - reusable concepts and terminology.\n- [Entities](entities/) - people, systems, modules, vendors, services, and tools.\n- [Decisions](decisions/) - decisions and rationale.\n- [Architecture](architecture/) - system structure and data/control flow.\n- [Debugging](debugging/) - root causes, fixes, verification evidence.\n- [Context](context/) - session continuity and project memory.\n- [Queries](queries/) - durable answers to useful questions.\n\n## Operating Notes\n\n- Start from memory and this index before broad project questions.\n- Read 3-7 relevant pages first; inspect raw sources only when precision matters.\n- Add links using \`[[page-or-topic]]\` when pages become related.\n\n<!-- llm-wiki-kit:index-start -->\n## Generated Page Map\n\nRun \`llm-wiki consolidate --workspace <project>\` to refresh this generated block.\n<!-- llm-wiki-kit:index-end -->\n`;
+}
+
+export function memoryPage() {
+  return `---
+title: "LLM Wiki Memory"
+type: "context"
+source_ids: []
+status: "draft"
+last_updated: "unknown"
+confidence: "medium"
+memory_type: "semantic"
+importance: 5
+last_verified: "unknown"
+supersedes: []
+superseded_by: []
+---
+
+# LLM Wiki Memory
+
+Short hot index for project memory. Keep this page compact enough for hook context. Link to deeper pages instead of copying long notes.
+
+## Current Focus
+
+- Add the current project focus here when it becomes durable.
+
+## Durable Entry Points
+
+- [Index](index.md)
+- [Log](log.md)
+
+<!-- llm-wiki-kit:memory-start -->
+## Generated Memory Map
+
+Run \`llm-wiki consolidate --workspace <project>\` to refresh this generated block.
+<!-- llm-wiki-kit:memory-end -->
+`;
 }
 
 export function logPage() {
@@ -18,10 +101,10 @@ export function logPage() {
 
 export function procedure(name) {
   const procedures = {
-    'ingest.md': `# Ingest Procedure\n\n1. Read \`wiki/index.md\` first.\n2. Inspect new material under \`raw/inbox/\` or \`raw/sources/\`.\n3. Create or update \`wiki/sources/<slug>.md\` for each source.\n4. Update related concept, entity, decision, architecture, debugging, or context pages.\n5. Prefer updating existing pages over creating duplicates.\n6. Add source references and confidence.\n7. Update \`wiki/index.md\` and append to \`wiki/log.md\`.\n`,
-    'query.md': `# Query Procedure\n\n1. Start from \`wiki/index.md\`.\n2. Search \`wiki/\` for relevant pages.\n3. Read the smallest useful set of pages first.\n4. Use raw sources only when exact evidence matters.\n5. Separate verified facts from inference.\n6. Save reusable answers into \`wiki/queries/\` and link them from related pages.\n`,
-    'lint.md': `# Lint Procedure\n\nCheck for stale pages, orphan pages, broken wiki links, missing sources, duplicate concepts, unsupported claims, and unresolved contradictions. Prefer producing a review report before automatic edits.\n`,
-    'security.md': `# Security Procedure\n\n- Preserve useful work context for the local project wiki.\n- Do not block reads or tool calls only because they look sensitive.\n- Redact authentication values such as tokens, passwords, and private keys before writing hook payloads or summaries.\n- Full raw transcript capture is disabled by default and must be explicitly enabled by project policy.\n`,
+    'ingest.md': `# Ingest Procedure\n\n1. Read \`wiki/memory.md\` and \`wiki/index.md\` first.\n2. Inspect new material under \`raw/inbox/\` or \`raw/sources/\`.\n3. Create or update \`wiki/sources/<slug>.md\` for each source.\n4. Update related concept, entity, decision, architecture, debugging, or context pages.\n5. Prefer updating existing pages over creating duplicates.\n6. Add source references, confidence, memory type, importance, and verification status.\n7. Update \`wiki/memory.md\` or run \`llm-wiki consolidate\` when durable entry points change.\n8. Update \`wiki/index.md\` and append to \`wiki/log.md\`.\n`,
+    'query.md': `# Query Procedure\n\n1. Start from \`llm-wiki context \"<query>\"\` or read \`wiki/memory.md\` and \`wiki/index.md\`.\n2. Use \`--limit\` or \`--no-expand\` when you need a narrower context pack.\n3. Search \`wiki/\` for relevant pages.\n4. Read the smallest useful set of pages first.\n5. Use raw sources only when exact evidence matters.\n6. Separate verified facts from inference.\n7. Save reusable answers into \`wiki/queries/\` and link them from related pages.\n`,
+    'lint.md': `# Lint Procedure\n\nRun \`llm-wiki lint --workspace <project>\` to check for stale pages, orphan pages, broken wiki/Markdown links, unsafe source IDs, secret-like content, missing sources, duplicate concepts, unsupported claims, and unresolved contradictions. Prefer producing a review report before automatic edits.\n`,
+    'security.md': `# Security Procedure\n\n- Preserve useful work context for the local project wiki.\n- Do not block reads or tool calls only because they look sensitive.\n- Redact authentication values such as tokens, passwords, bearer credentials, and private keys before writing hook payloads, summaries, or context packs.\n- Run \`llm-wiki lint --workspace <project>\` when sensitive material might have entered wiki pages; secret-like content is reported as an error.\n- Full raw transcript capture is disabled by default and must be explicitly enabled by project policy.\n`,
   };
   return procedures[name] || '';
 }

package/src/update.js

@@ -1,6 +1,7 @@
 import { spawnSync } from 'child_process';
-import { resolve } from 'path';
-import { appendWikiLog, bootstrapProject } from './project.js';
+import { join, resolve } from 'path';
+import { exists } from './fs-utils.js';
+import { appendWikiLog } from './project.js';
 import { install } from './install.js';
 import { applyProjectTemplateUpdate, inspectProjectState } from './project-state.js';
 import { knownProjectRoots } from './projects.js';
@@ -34,6 +35,10 @@ function assertCommandOk(result, label) {
   throw new Error(`${label} failed: ${detail}`);
 }
 
+async function hasProjectWiki(projectRoot) {
+  return exists(join(projectRoot, 'llm-wiki', 'wiki'));
+}
+
 export function parseRegistryVersion(output) {
   return String(output || '').trim().split(/\s+/).at(-1) || '';
 }
@@ -60,6 +65,7 @@ export async function postUpdate(options = {}) {
     ...options,
     workspace,
     replaceHooks: true,
+    noProject: true,
   });
 
   if (options.all) {
@@ -69,7 +75,7 @@ export async function postUpdate(options = {}) {
       const projectResult = options.noProject
         ? null
         : await applyProjectTemplateUpdate(projectRoot);
-      if (!options.noProject) {
+      if (!options.noProject && await hasProjectWiki(projectRoot)) {
         await appendWikiLog(projectRoot, `llm-wiki-kit post-update applied runtime ${runtimeVersion()}; changed templates: ${projectResult.changed.length}`);
       }
       projects.push({
@@ -89,7 +95,7 @@ export async function postUpdate(options = {}) {
     ? null
     : await applyProjectTemplateUpdate(workspace);
 
-  if (!options.noProject) {
+  if (!options.noProject && await hasProjectWiki(workspace)) {
     await appendWikiLog(workspace, `llm-wiki-kit post-update applied runtime ${runtimeVersion()}; changed templates: ${projectResult.changed.length}`);
   }