llm-wiki-kit 0.1.5 → 0.1.7

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,17 +27,199 @@ function templateDescriptors() {
       path: join('llm-wiki', 'AGENTS.md'),
       content: llmWikiAgents(),
       mode: 'generated-file',
-      marker: 'Generated by llm-wiki-kit',
+      legacyContents: legacyLlmWikiAgentsContents(),
+      legacySignals: [
+        /^# LLM Wiki Agent Rules/m,
+        /Generated by llm-wiki-kit/m,
+        /## Purpose/m,
+        /## Core Rules/m,
+        /## Operations/m,
+      ],
+    },
+    {
+      id: 'wiki-memory',
+      path: join('llm-wiki', 'wiki', 'memory.md'),
+      content: memoryPage(),
+      mode: 'create-only',
     },
     ...PROCEDURE_NAMES.map((name) => ({
       id: `procedure-${name.replace(/\.md$/, '')}`,
       path: join('llm-wiki', 'procedures', name),
       content: procedure(name),
       mode: 'generated-file',
+      legacyContents: legacyProcedureContents(name),
+      legacySignals: legacyProcedureSignals(name),
     })),
   ];
 }
 
+function legacyLlmWikiAgentsContents() {
+  return [
+    `# LLM Wiki Agent Rules
+
+Generated by llm-wiki-kit <version>.
+
+## 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.
+- \`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/index.md\` and \`wiki/log.md\` whenever new durable knowledge is created.
+- 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"
+---
+\`\`\`
+
+## Operations
+- ingest: read new raw files, create or update wiki pages, then update \`wiki/index.md\` and \`wiki/log.md\`.
+- query: start from \`wiki/index.md\`, read relevant wiki pages, answer with source references, and save reusable answers.
+- lint: find stale pages, orphan pages, broken wiki links, missing sources, duplicate concepts, contradictions, and missing links.`,
+    `# LLM Wiki Agent Rules
+
+Generated by llm-wiki-kit <version>.
+
+## 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.`,
+  ];
+}
+
+function legacyProcedureContents(name) {
+  const early = {
+    'ingest.md': `# Ingest Procedure
+
+1. Read \`wiki/index.md\` first.
+2. Inspect new material under \`raw/inbox/\` or \`raw/sources/\`.
+3. Create or update \`wiki/sources/<slug>.md\` for each source.
+4. Update related concept, entity, decision, architecture, debugging, or context pages.
+5. Prefer updating existing pages over creating duplicates.
+6. Add source references and confidence.
+7. Update \`wiki/index.md\` and append to \`wiki/log.md\`.`,
+    'query.md': `# Query Procedure
+
+1. Start from \`wiki/index.md\`.
+2. Search \`wiki/\` for relevant pages.
+3. Read the smallest useful set of pages first.
+4. Use raw sources only when exact evidence matters.
+5. Separate verified facts from inference.
+6. Save reusable answers into \`wiki/queries/\` and link them from related pages.`,
+    'lint.md': `# Lint Procedure
+
+Check 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.`,
+    'security.md': `# Security Procedure
+
+- Never store credentials, tokens, private keys, \`.env\` contents, customer identifiers, or private personal data.
+- Redact before writing hook payloads or summaries.
+- Full raw transcript capture is disabled by default and must be explicitly enabled by project policy.
+- If a file or prompt looks secret-bearing, do not persist it and ask for confirmation before reading further.`,
+  };
+  const layered = {
+    'ingest.md': `# Ingest Procedure
+
+1. Read \`wiki/memory.md\` and \`wiki/index.md\` first.
+2. Inspect new material under \`raw/inbox/\` or \`raw/sources/\`.
+3. Create or update \`wiki/sources/<slug>.md\` for each source.
+4. Update related concept, entity, decision, architecture, debugging, or context pages.
+5. Prefer updating existing pages over creating duplicates.
+6. Add source references, confidence, memory type, importance, and verification status.
+7. Update \`wiki/memory.md\` or run \`llm-wiki consolidate\` when durable entry points change.
+8. Update \`wiki/index.md\` and append to \`wiki/log.md\`.`,
+    'query.md': `# Query Procedure
+
+1. Start from \`llm-wiki context "<query>"\` or read \`wiki/memory.md\` and \`wiki/index.md\`.
+2. Use \`--limit\` or \`--no-expand\` when you need a narrower context pack.
+3. Search \`wiki/\` for relevant pages.
+4. Read the smallest useful set of pages first.
+5. Use raw sources only when exact evidence matters.
+6. Separate verified facts from inference.
+7. Save reusable answers into \`wiki/queries/\` and link them from related pages.`,
+    'lint.md': `# Lint Procedure
+
+Run \`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.`,
+    'security.md': `# Security Procedure
+
+- Preserve useful work context for the local project wiki.
+- Do not block reads or tool calls only because they look sensitive.
+- Redact authentication values such as tokens, passwords, bearer credentials, and private keys before writing hook payloads, summaries, or context packs.
+- Run \`llm-wiki lint --workspace <project>\` when sensitive material might have entered wiki pages; secret-like content is reported as an error.
+- Full raw transcript capture is disabled by default and must be explicitly enabled by project policy.`,
+  };
+  return [early[name], layered[name]].filter(Boolean);
+}
+
+function legacyProcedureSignals(name) {
+  const common = [/^# .+ Procedure/m];
+  const byName = {
+    'ingest.md': [/^# Ingest Procedure/m, /wiki\/memory\.md/, /raw\/inbox|raw\/sources/],
+    'query.md': [/^# Query Procedure/m, /llm-wiki context/, /Save reusable answers|reusable answers/],
+    'lint.md': [/^# Lint Procedure/m, /llm-wiki lint/, /stale pages|orphan pages/],
+    'security.md': [/^# Security Procedure/m, /Redact authentication values|token|private keys/, /raw transcript capture/],
+  };
+  return byName[name] || common;
+}
+
 function emptyState() {
   return {
     schemaVersion: PROJECT_STATE_SCHEMA_VERSION,
@@ -74,39 +256,91 @@ export async function writeProjectState(projectRoot, state) {
 }
 
 function replaceMarkedBlock(current, replacement) {
+  if (markerStatus(current) !== 'complete') return null;
   const start = current.indexOf(ROOT_POLICY_START);
   const end = current.indexOf(ROOT_POLICY_END);
-  if (start === -1 || end === -1 || end < start) return null;
   const afterEnd = end + ROOT_POLICY_END.length;
   return `${current.slice(0, start)}${replacement.trimStart().trimEnd()}${current.slice(afterEnd)}`;
 }
 
-function hasGeneratedMarker(text, descriptor) {
-  return descriptor.marker ? text.includes(descriptor.marker) : false;
+function markerCount(current, marker) {
+  return current.split(marker).length - 1;
+}
+
+function markerStatus(current) {
+  const start = current.indexOf(ROOT_POLICY_START);
+  const end = current.indexOf(ROOT_POLICY_END);
+  const starts = markerCount(current, ROOT_POLICY_START);
+  const ends = markerCount(current, ROOT_POLICY_END);
+  if (starts === 0 && ends === 0) return 'missing';
+  if (starts !== 1 || ends !== 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 normalizeGeneratedText(text) {
+  return String(text || '')
+    .replace(/\r\n/g, '\n')
+    .replace(/Generated by llm-wiki-kit [^\n]+/g, 'Generated by llm-wiki-kit <version>.')
+    .trim();
+}
+
+function isLegacyGeneratedContent(text, descriptor) {
+  if (descriptor.mode !== 'generated-file') return false;
+  if (!Array.isArray(descriptor.legacyContents) || descriptor.legacyContents.length === 0) return false;
+  const normalized = normalizeGeneratedText(text);
+  return descriptor.legacyContents.some((content) => normalizeGeneratedText(content) === normalized);
+}
+
+function hasLegacyGeneratedSignal(text, descriptor) {
+  if (!Array.isArray(descriptor.legacySignals) || descriptor.legacySignals.length === 0) return false;
+  return descriptor.legacySignals.every((pattern) => pattern.test(text));
+}
+
+function hasKitManagedSignal(text, descriptor) {
+  if (descriptor.mode === 'marker') return markerStatus(text) !== 'missing';
+  if (descriptor.mode === 'generated-file') {
+    return isLegacyGeneratedContent(text, descriptor) || hasLegacyGeneratedSignal(text, descriptor) || /Generated by llm-wiki-kit/.test(text);
+  }
+  return false;
+}
+
+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);
+  return isRecordedManaged(state, descriptor, currentText) ||
+    isKnownGeneratedContent(currentText, descriptor) ||
+    isLegacyGeneratedContent(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)));
+}
+
+async function descriptorParentExists(projectRoot, descriptor) {
+  return exists(dirname(join(projectRoot, descriptor.path)));
+}
+
 export async function inspectProjectState(projectRoot) {
   const state = await readProjectState(projectRoot);
   const runtime = runtimeVersion();
@@ -116,12 +350,24 @@ 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 descriptorParentExists(projectRoot, descriptor);
+    const patchable = descriptor.mode === 'create-only' && !fileExists && !parentExists
+      ? false
+      : (!fileExists && descriptor.mode === 'generated-file'
+        ? parentExists
+        : (markerState === 'malformed' ? false : canPatchDescriptor(state, descriptor, currentText, fileExists)));
+    const needsAttention = (fileExists || recorded) &&
+      !patchable &&
+      currentText !== (desiredText || '') &&
+      (fileExists ? hasKitManagedSignal(currentText, descriptor) : descriptor.mode !== 'create-only');
+    const current = descriptor.mode === 'create-only'
+      ? fileExists
+      : fileExists && desiredText !== null && currentHash === templateHash(desiredText);
 
     files.push({
       id: descriptor.id,
@@ -129,10 +375,12 @@ export async function inspectProjectState(projectRoot) {
       exists: fileExists,
       patchable,
       current,
+      needsAttention,
       currentHash,
       desiredHash,
       recordedHash: recorded?.hash || null,
       recordedVersion: recorded?.version || null,
+      reason: markerState === 'malformed' ? 'malformed-marker' : (!fileExists ? 'missing' : null),
     });
   }
 
@@ -142,11 +390,31 @@ export async function inspectProjectState(projectRoot) {
     schemaVersion: state.schemaVersion,
     lastRuntimeVersionApplied: state.lastRuntimeVersionApplied,
     runtimeUpToDateWithProject: state.lastRuntimeVersionApplied === runtime,
-    managedFilesCurrent: files.every((file) => file.current || !file.patchable),
+    managedFilesCurrent: files.every((file) => file.current || (!file.patchable && !file.needsAttention)),
     managedFiles: files,
   };
 }
 
+export function formatProjectMaintenanceContext(inspection) {
+  const files = inspection?.managedFiles || [];
+  const attention = files.filter((file) => file.needsAttention);
+  const outdated = files.filter((file) => !file.current && file.patchable);
+  if (attention.length === 0 && outdated.length === 0) return '';
+
+  const lines = [
+    'LLM Wiki maintenance note:',
+    '- 이전 버전의 llm-wiki-kit 규칙/문서가 남아 있을 수 있다.',
+    '- 확실히 kit가 관리하는 영역은 자동 갱신된다. 사용자 편집 가능성이 있는 문서는 덮어쓰지 말고 기존 내용을 보존한 채 현재 규칙에 맞게 자연스럽게 정리한다.',
+  ];
+  if (outdated.length > 0) {
+    lines.push(`- 자동 갱신 대상: ${outdated.map((file) => file.path).join(', ')}`);
+  }
+  if (attention.length > 0) {
+    lines.push(`- agent 확인 필요: ${attention.map((file) => file.path).join(', ')}`);
+  }
+  return lines.join('\n');
+}
+
 export async function recordManagedTemplates(projectRoot) {
   const state = await readProjectState(projectRoot);
   const runtime = runtimeVersion();
@@ -155,6 +423,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 +453,56 @@ 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 descriptorParentExists(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;
+      }
+      if (descriptor.mode === 'generated-file' && await descriptorParentExists(projectRoot, descriptor)) {
+        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 { recordManagedTemplates } from './project-state.js';
+import { gitignore, indexPage, llmWikiAgents, logPage, memoryPage, procedure, rootAgentsPolicy } from './templates.js';
+import { formatProjectMaintenanceContext, inspectProjectState, 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']) {
@@ -116,7 +117,7 @@ export async function appendLiveQa(projectRoot, entry) {
     entry.verification || '(not captured)',
     '',
     '### Follow-up',
-    entry.followUp || '(none captured)',
+    entry.followUp || '다음 작업에서 이 turn의 reusable fact가 있으면 기존 wiki 문서에 합치고, 일회성 기록은 이 Q&A에만 보존한다.',
     '',
   ].join('\n');
   await appendText(path, redactText(block, 12000));
@@ -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,17 @@ 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,
+  });
+  const maintenance = await inspectProjectState(projectRoot)
+    .then(formatProjectMaintenanceContext)
+    .catch(() => '');
+  return [formatContextPack(pack), maintenance].filter(Boolean).join('\n\n');
 }

package/src/state.js

@@ -1,4 +1,5 @@
 import { join } from 'path';
+import { unlink } from 'fs/promises';
 import { kitDataDir, readJson, sha256, writeJson } from './fs-utils.js';
 import { summarizeForStorage } from './redaction.js';
 
@@ -33,6 +34,10 @@ export async function writeTurnState(projectRoot, payload, state) {
   await writeJson(statePath(projectRoot, payload), state);
 }
 
+export async function clearTurnState(projectRoot, payload) {
+  await unlink(statePath(projectRoot, payload)).catch(() => {});
+}
+
 export async function rememberQuestion(projectRoot, payload, prompt) {
   const state = await readTurnState(projectRoot, payload);
   const clean = summarizeForStorage(prompt, 3000);