kirograph 0.23.0 → 0.27.0

package/dist/wiki/schema.js

@@ -0,0 +1,148 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var schema_exports = {};
+__export(schema_exports, {
+  DEFAULT_SCHEMA: () => DEFAULT_SCHEMA,
+  parseWikiDiff: () => parseWikiDiff
+});
+module.exports = __toCommonJS(schema_exports);
+const DEFAULT_SCHEMA = `# Wiki Schema
+
+This file tells KiroGraph's LLM how to structure and maintain the project wiki.
+Edit it to match your project's conventions.
+
+## Naming convention
+
+- Entities (classes, services, modules): \`<ClassName>.md\` or \`<module-name>.md\`
+- Architecture decisions: \`arch/<slug>.md\`
+- Recurring patterns: \`pattern/<slug>.md\`
+- External integrations: \`ext/<service>.md\`
+
+## Page structure
+
+Every page should follow this template:
+
+\`\`\`markdown
+## Summary
+One to three sentences describing what this entity is and why it exists.
+
+## Decisions
+- YYYY-MM-DD \u2014 Decision text (one line per decision, newest first)
+
+## Known Issues / Gotchas
+- Bullet points of non-obvious constraints, bugs, or workarounds
+
+## Related
+- [[other-page-slug]] \u2014 one line description of the relationship
+
+## Sources
+- source-name (YYYY-MM-DD)
+\`\`\`
+
+## Ingest workflow
+
+When given a source document to ingest:
+
+1. Read the source and identify entities, decisions, and patterns mentioned
+2. Check MANIFEST.md to find existing pages for those entities
+3. For each existing page: integrate new information into the appropriate sections
+4. For each new entity: create a page following the structure above
+5. Always update ## Sources with the source name and today's date
+6. Update ## Related cross-references in all touched pages
+7. If new information contradicts an existing claim, emit a WIKI_DIFF_CONFLICTS block
+
+## WIKI_DIFF format
+
+Produce output using this exact format \u2014 one block per page operation:
+
+\`\`\`
+WIKI_DIFF_START
+{"action":"upsert","page":"PageSlug","section":"Decisions","mode":"append"}
+- YYYY-MM-DD \u2014 New decision text
+WIKI_DIFF_END
+\`\`\`
+
+Actions:
+- \`create\` \u2014 new page (requires \`title\` field, content is full markdown)
+- \`upsert\` \u2014 update a section in an existing page (mode: \`append\` or \`replace\`)
+- \`append\` \u2014 append to the end of an existing page
+
+For conflicts:
+\`\`\`
+WIKI_DIFF_CONFLICTS
+{"page":"PageSlug","section":"SectionName","existing":"old claim","incoming":"new claim","source":"ADR-001.md","existingDate":"2025-01-01","incomingDate":"2025-06-15"}
+WIKI_DIFF_CONFLICTS_END
+\`\`\`
+`;
+function parseWikiDiff(raw) {
+  const entries = [];
+  const conflicts = [];
+  const diffRegex = /WIKI_DIFF_START\n([\s\S]*?)\nWIKI_DIFF_END/g;
+  let match;
+  while ((match = diffRegex.exec(raw)) !== null) {
+    const block = match[1].trim();
+    const firstNewline = block.indexOf("\n");
+    if (firstNewline === -1) continue;
+    const headerStr = block.slice(0, firstNewline).trim();
+    const content = block.slice(firstNewline + 1);
+    let header;
+    try {
+      header = JSON.parse(headerStr);
+    } catch {
+      continue;
+    }
+    entries.push({
+      action: header.action ?? "upsert",
+      page: header.page ?? "",
+      title: header.title,
+      section: header.section,
+      mode: header.mode ?? "append",
+      content
+    });
+  }
+  const conflictRegex = /WIKI_DIFF_CONFLICTS\n([\s\S]*?)\nWIKI_DIFF_CONFLICTS_END/g;
+  while ((match = conflictRegex.exec(raw)) !== null) {
+    const block = match[1].trim();
+    for (const line of block.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const c = JSON.parse(trimmed);
+        conflicts.push({
+          page: c.page ?? "",
+          section: c.section ?? "",
+          existing: c.existing ?? "",
+          incoming: c.incoming ?? "",
+          source: c.source ?? "",
+          existingDate: c.existingDate,
+          incomingDate: c.incomingDate
+        });
+      } catch {
+        continue;
+      }
+    }
+  }
+  return { entries, conflicts, rawDiff: raw };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_SCHEMA,
+  parseWikiDiff
+});
+//# sourceMappingURL=schema.js.map

package/dist/wiki/schema.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wiki/schema.ts"],
+  "sourcesContent": ["// Default SCHEMA.md content written by `kirograph wiki init`\n\nexport const DEFAULT_SCHEMA = `# Wiki Schema\n\nThis file tells KiroGraph's LLM how to structure and maintain the project wiki.\nEdit it to match your project's conventions.\n\n## Naming convention\n\n- Entities (classes, services, modules): \\`<ClassName>.md\\` or \\`<module-name>.md\\`\n- Architecture decisions: \\`arch/<slug>.md\\`\n- Recurring patterns: \\`pattern/<slug>.md\\`\n- External integrations: \\`ext/<service>.md\\`\n\n## Page structure\n\nEvery page should follow this template:\n\n\\`\\`\\`markdown\n## Summary\nOne to three sentences describing what this entity is and why it exists.\n\n## Decisions\n- YYYY-MM-DD \u2014 Decision text (one line per decision, newest first)\n\n## Known Issues / Gotchas\n- Bullet points of non-obvious constraints, bugs, or workarounds\n\n## Related\n- [[other-page-slug]] \u2014 one line description of the relationship\n\n## Sources\n- source-name (YYYY-MM-DD)\n\\`\\`\\`\n\n## Ingest workflow\n\nWhen given a source document to ingest:\n\n1. Read the source and identify entities, decisions, and patterns mentioned\n2. Check MANIFEST.md to find existing pages for those entities\n3. For each existing page: integrate new information into the appropriate sections\n4. For each new entity: create a page following the structure above\n5. Always update ## Sources with the source name and today's date\n6. Update ## Related cross-references in all touched pages\n7. If new information contradicts an existing claim, emit a WIKI_DIFF_CONFLICTS block\n\n## WIKI_DIFF format\n\nProduce output using this exact format \u2014 one block per page operation:\n\n\\`\\`\\`\nWIKI_DIFF_START\n{\"action\":\"upsert\",\"page\":\"PageSlug\",\"section\":\"Decisions\",\"mode\":\"append\"}\n- YYYY-MM-DD \u2014 New decision text\nWIKI_DIFF_END\n\\`\\`\\`\n\nActions:\n- \\`create\\` \u2014 new page (requires \\`title\\` field, content is full markdown)\n- \\`upsert\\` \u2014 update a section in an existing page (mode: \\`append\\` or \\`replace\\`)\n- \\`append\\` \u2014 append to the end of an existing page\n\nFor conflicts:\n\\`\\`\\`\nWIKI_DIFF_CONFLICTS\n{\"page\":\"PageSlug\",\"section\":\"SectionName\",\"existing\":\"old claim\",\"incoming\":\"new claim\",\"source\":\"ADR-001.md\",\"existingDate\":\"2025-01-01\",\"incomingDate\":\"2025-06-15\"}\nWIKI_DIFF_CONFLICTS_END\n\\`\\`\\`\n`;\n\n// \u2500\u2500 WIKI_DIFF parser \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nimport type { WikiDiff, WikiDiffEntry, WikiDiffConflict } from './types';\n\nexport function parseWikiDiff(raw: string): WikiDiff {\n  const entries: WikiDiffEntry[] = [];\n  const conflicts: WikiDiffConflict[] = [];\n\n  // Parse WIKI_DIFF_START...WIKI_DIFF_END blocks\n  const diffRegex = /WIKI_DIFF_START\\n([\\s\\S]*?)\\nWIKI_DIFF_END/g;\n  let match: RegExpExecArray | null;\n\n  while ((match = diffRegex.exec(raw)) !== null) {\n    const block = match[1].trim();\n    const firstNewline = block.indexOf('\\n');\n    if (firstNewline === -1) continue;\n\n    const headerStr = block.slice(0, firstNewline).trim();\n    const content = block.slice(firstNewline + 1);\n\n    let header: Record<string, any>;\n    try {\n      header = JSON.parse(headerStr);\n    } catch {\n      continue;\n    }\n\n    entries.push({\n      action: header.action ?? 'upsert',\n      page: header.page ?? '',\n      title: header.title,\n      section: header.section,\n      mode: header.mode ?? 'append',\n      content,\n    });\n  }\n\n  // Parse WIKI_DIFF_CONFLICTS...WIKI_DIFF_CONFLICTS_END blocks\n  const conflictRegex = /WIKI_DIFF_CONFLICTS\\n([\\s\\S]*?)\\nWIKI_DIFF_CONFLICTS_END/g;\n\n  while ((match = conflictRegex.exec(raw)) !== null) {\n    const block = match[1].trim();\n    for (const line of block.split('\\n')) {\n      const trimmed = line.trim();\n      if (!trimmed) continue;\n      try {\n        const c = JSON.parse(trimmed);\n        conflicts.push({\n          page: c.page ?? '',\n          section: c.section ?? '',\n          existing: c.existing ?? '',\n          incoming: c.incoming ?? '',\n          source: c.source ?? '',\n          existingDate: c.existingDate,\n          incomingDate: c.incomingDate,\n        });\n      } catch {\n        continue;\n      }\n    }\n  }\n\n  return { entries, conflicts, rawDiff: raw };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEO,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAyEvB,SAAS,cAAc,KAAuB;AACnD,QAAM,UAA2B,CAAC;AAClC,QAAM,YAAgC,CAAC;AAGvC,QAAM,YAAY;AAClB,MAAI;AAEJ,UAAQ,QAAQ,UAAU,KAAK,GAAG,OAAO,MAAM;AAC7C,UAAM,QAAQ,MAAM,CAAC,EAAE,KAAK;AAC5B,UAAM,eAAe,MAAM,QAAQ,IAAI;AACvC,QAAI,iBAAiB,GAAI;AAEzB,UAAM,YAAY,MAAM,MAAM,GAAG,YAAY,EAAE,KAAK;AACpD,UAAM,UAAU,MAAM,MAAM,eAAe,CAAC;AAE5C,QAAI;AACJ,QAAI;AACF,eAAS,KAAK,MAAM,SAAS;AAAA,IAC/B,QAAQ;AACN;AAAA,IACF;AAEA,YAAQ,KAAK;AAAA,MACX,QAAQ,OAAO,UAAU;AAAA,MACzB,MAAM,OAAO,QAAQ;AAAA,MACrB,OAAO,OAAO;AAAA,MACd,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO,QAAQ;AAAA,MACrB;AAAA,IACF,CAAC;AAAA,EACH;AAGA,QAAM,gBAAgB;AAEtB,UAAQ,QAAQ,cAAc,KAAK,GAAG,OAAO,MAAM;AACjD,UAAM,QAAQ,MAAM,CAAC,EAAE,KAAK;AAC5B,eAAW,QAAQ,MAAM,MAAM,IAAI,GAAG;AACpC,YAAM,UAAU,KAAK,KAAK;AAC1B,UAAI,CAAC,QAAS;AACd,UAAI;AACF,cAAM,IAAI,KAAK,MAAM,OAAO;AAC5B,kBAAU,KAAK;AAAA,UACb,MAAM,EAAE,QAAQ;AAAA,UAChB,SAAS,EAAE,WAAW;AAAA,UACtB,UAAU,EAAE,YAAY;AAAA,UACxB,UAAU,EAAE,YAAY;AAAA,UACxB,QAAQ,EAAE,UAAU;AAAA,UACpB,cAAc,EAAE;AAAA,UAChB,cAAc,EAAE;AAAA,QAClB,CAAC;AAAA,MACH,QAAQ;AACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,WAAW,SAAS,IAAI;AAC5C;",
+  "names": []
+}

package/dist/wiki/synthesize.js

@@ -0,0 +1,104 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var synthesize_exports = {};
+__export(synthesize_exports, {
+  runWikiLocalSynthesis: () => runWikiLocalSynthesis
+});
+module.exports = __toCommonJS(synthesize_exports);
+var import_synthesize = require("../watchmen/synthesize");
+const SYSTEM_PROMPT = `You are a project wiki assistant. You receive a source text and a wiki schema, and you produce structured WIKI_DIFF blocks.
+
+Rules:
+- Output ONLY WIKI_DIFF_START / WIKI_DIFF_END blocks. No explanations, no prose.
+- Follow the schema exactly \u2014 use the JSON header format shown.
+- Use "page" field (not "slug") in the JSON header.
+- Keep page slugs lowercase-kebab-case.
+- Copy technical terms, function names, and identifiers exactly as they appear in the source.
+- If the source contradicts an existing page, add a WIKI_DIFF_CONFLICTS block.`;
+function isGemma4(modelName) {
+  return modelName.includes("gemma-4");
+}
+async function generate(pipe, userPrompt, modelName, quiet) {
+  const messages = [
+    { role: "system", content: SYSTEM_PROMPT },
+    { role: "user", content: userPrompt }
+  ];
+  const genOpts = {
+    max_new_tokens: 600,
+    return_full_text: false
+  };
+  if (isGemma4(modelName)) {
+    genOpts.temperature = 1;
+    genOpts.top_p = 0.95;
+    genOpts.top_k = 64;
+    genOpts.do_sample = true;
+  } else {
+    genOpts.do_sample = false;
+    genOpts.repetition_penalty = 1.3;
+  }
+  const output = await pipe(messages, genOpts);
+  let text;
+  if (Array.isArray(output) && output[0]?.generated_text) {
+    const gt = output[0].generated_text;
+    text = Array.isArray(gt) ? gt[gt.length - 1]?.content ?? "" : String(gt);
+  } else {
+    text = String(output);
+  }
+  return (0, import_synthesize.removeHallucinatedContent)((0, import_synthesize.truncateAtRepetitionLoop)((0, import_synthesize.stripCodeFences)(text)));
+}
+async function runWikiLocalSynthesis(wiki, modelName, quiet = false) {
+  const result = {
+    processed: 0,
+    created: [],
+    updated: [],
+    errors: []
+  };
+  const queue = wiki.getPendingQueue();
+  if (queue.length === 0) return result;
+  if (!quiet) process.stderr.write(`[wiki] Loading model ${modelName}...
+`);
+  const pipe = await (0, import_synthesize.getGenPipeline)(modelName, quiet);
+  for (const entry of queue) {
+    if (!quiet) process.stderr.write(`[wiki] Synthesizing source "${entry.sourceName}"...
+`);
+    try {
+      const prompt = wiki.getIngestPrompt(entry.sourceText, entry.sourceName);
+      const raw = await generate(pipe, prompt, modelName, quiet);
+      if (!raw.includes("WIKI_DIFF_START")) {
+        if (!quiet) process.stderr.write(`[wiki] No WIKI_DIFF found for "${entry.sourceName}" \u2014 skipping
+`);
+        result.errors.push(`No WIKI_DIFF produced for source "${entry.sourceName}"`);
+        continue;
+      }
+      const applyResult = wiki.applyDiff(raw);
+      result.created.push(...applyResult.created);
+      result.updated.push(...applyResult.updated);
+      result.processed++;
+    } catch (e) {
+      result.errors.push(`Error processing "${entry.sourceName}": ${e?.message ?? e}`);
+    }
+  }
+  wiki.clearQueue();
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runWikiLocalSynthesis
+});
+//# sourceMappingURL=synthesize.js.map

package/dist/wiki/synthesize.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wiki/synthesize.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Wiki \u2014 Local model synthesis\n *\n * Reads the pending wiki_queue, runs a local HuggingFace model to produce\n * WIKI_DIFF blocks for each queued source, then applies them.\n * Mirrors the watchmen local synthesis pattern.\n */\n\nimport {\n  getGenPipeline,\n  stripCodeFences,\n  removeHallucinatedContent,\n  truncateAtRepetitionLoop,\n} from '../watchmen/synthesize';\nimport type { KiroGraphWiki } from './index';\n\nexport interface WikiSynthesisResult {\n  processed: number;\n  created: string[];\n  updated: string[];\n  errors: string[];\n}\n\nconst SYSTEM_PROMPT = `You are a project wiki assistant. You receive a source text and a wiki schema, and you produce structured WIKI_DIFF blocks.\n\nRules:\n- Output ONLY WIKI_DIFF_START / WIKI_DIFF_END blocks. No explanations, no prose.\n- Follow the schema exactly \u2014 use the JSON header format shown.\n- Use \"page\" field (not \"slug\") in the JSON header.\n- Keep page slugs lowercase-kebab-case.\n- Copy technical terms, function names, and identifiers exactly as they appear in the source.\n- If the source contradicts an existing page, add a WIKI_DIFF_CONFLICTS block.`;\n\nfunction isGemma4(modelName: string): boolean {\n  return modelName.includes('gemma-4');\n}\n\nasync function generate(\n  pipe: any,\n  userPrompt: string,\n  modelName: string,\n  quiet: boolean,\n): Promise<string> {\n  const messages = [\n    { role: 'system', content: SYSTEM_PROMPT },\n    { role: 'user', content: userPrompt },\n  ];\n\n  const genOpts: any = {\n    max_new_tokens: 600,\n    return_full_text: false,\n  };\n\n  if (isGemma4(modelName)) {\n    genOpts.temperature = 1.0;\n    genOpts.top_p = 0.95;\n    genOpts.top_k = 64;\n    genOpts.do_sample = true;\n  } else {\n    genOpts.do_sample = false;\n    genOpts.repetition_penalty = 1.3;\n  }\n\n  const output = await pipe(messages, genOpts);\n\n  let text: string;\n  if (Array.isArray(output) && output[0]?.generated_text) {\n    const gt = output[0].generated_text;\n    text = Array.isArray(gt) ? gt[gt.length - 1]?.content ?? '' : String(gt);\n  } else {\n    text = String(output);\n  }\n\n  return removeHallucinatedContent(truncateAtRepetitionLoop(stripCodeFences(text)));\n}\n\nexport async function runWikiLocalSynthesis(\n  wiki: KiroGraphWiki,\n  modelName: string,\n  quiet = false,\n): Promise<WikiSynthesisResult> {\n  const result: WikiSynthesisResult = {\n    processed: 0,\n    created: [],\n    updated: [],\n    errors: [],\n  };\n\n  const queue = wiki.getPendingQueue();\n  if (queue.length === 0) return result;\n\n  if (!quiet) process.stderr.write(`[wiki] Loading model ${modelName}...\\n`);\n  const pipe = await getGenPipeline(modelName, quiet);\n\n  for (const entry of queue) {\n    if (!quiet) process.stderr.write(`[wiki] Synthesizing source \"${entry.sourceName}\"...\\n`);\n    try {\n      const prompt = wiki.getIngestPrompt(entry.sourceText, entry.sourceName);\n      const raw = await generate(pipe, prompt, modelName, quiet);\n\n      if (!raw.includes('WIKI_DIFF_START')) {\n        if (!quiet) process.stderr.write(`[wiki] No WIKI_DIFF found for \"${entry.sourceName}\" \u2014 skipping\\n`);\n        result.errors.push(`No WIKI_DIFF produced for source \"${entry.sourceName}\"`);\n        continue;\n      }\n\n      const applyResult = wiki.applyDiff(raw);\n      result.created.push(...applyResult.created);\n      result.updated.push(...applyResult.updated);\n      result.processed++;\n    } catch (e: any) {\n      result.errors.push(`Error processing \"${entry.sourceName}\": ${e?.message ?? e}`);\n    }\n  }\n\n  wiki.clearQueue();\n  return result;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,wBAKO;AAUP,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUtB,SAAS,SAAS,WAA4B;AAC5C,SAAO,UAAU,SAAS,SAAS;AACrC;AAEA,eAAe,SACb,MACA,YACA,WACA,OACiB;AACjB,QAAM,WAAW;AAAA,IACf,EAAE,MAAM,UAAU,SAAS,cAAc;AAAA,IACzC,EAAE,MAAM,QAAQ,SAAS,WAAW;AAAA,EACtC;AAEA,QAAM,UAAe;AAAA,IACnB,gBAAgB;AAAA,IAChB,kBAAkB;AAAA,EACpB;AAEA,MAAI,SAAS,SAAS,GAAG;AACvB,YAAQ,cAAc;AACtB,YAAQ,QAAQ;AAChB,YAAQ,QAAQ;AAChB,YAAQ,YAAY;AAAA,EACtB,OAAO;AACL,YAAQ,YAAY;AACpB,YAAQ,qBAAqB;AAAA,EAC/B;AAEA,QAAM,SAAS,MAAM,KAAK,UAAU,OAAO;AAE3C,MAAI;AACJ,MAAI,MAAM,QAAQ,MAAM,KAAK,OAAO,CAAC,GAAG,gBAAgB;AACtD,UAAM,KAAK,OAAO,CAAC,EAAE;AACrB,WAAO,MAAM,QAAQ,EAAE,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,WAAW,KAAK,OAAO,EAAE;AAAA,EACzE,OAAO;AACL,WAAO,OAAO,MAAM;AAAA,EACtB;AAEA,aAAO,iDAA0B,gDAAyB,mCAAgB,IAAI,CAAC,CAAC;AAClF;AAEA,eAAsB,sBACpB,MACA,WACA,QAAQ,OACsB;AAC9B,QAAM,SAA8B;AAAA,IAClC,WAAW;AAAA,IACX,SAAS,CAAC;AAAA,IACV,SAAS,CAAC;AAAA,IACV,QAAQ,CAAC;AAAA,EACX;AAEA,QAAM,QAAQ,KAAK,gBAAgB;AACnC,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,MAAI,CAAC,MAAO,SAAQ,OAAO,MAAM,wBAAwB,SAAS;AAAA,CAAO;AACzE,QAAM,OAAO,UAAM,kCAAe,WAAW,KAAK;AAElD,aAAW,SAAS,OAAO;AACzB,QAAI,CAAC,MAAO,SAAQ,OAAO,MAAM,+BAA+B,MAAM,UAAU;AAAA,CAAQ;AACxF,QAAI;AACF,YAAM,SAAS,KAAK,gBAAgB,MAAM,YAAY,MAAM,UAAU;AACtE,YAAM,MAAM,MAAM,SAAS,MAAM,QAAQ,WAAW,KAAK;AAEzD,UAAI,CAAC,IAAI,SAAS,iBAAiB,GAAG;AACpC,YAAI,CAAC,MAAO,SAAQ,OAAO,MAAM,kCAAkC,MAAM,UAAU;AAAA,CAAgB;AACnG,eAAO,OAAO,KAAK,qCAAqC,MAAM,UAAU,GAAG;AAC3E;AAAA,MACF;AAEA,YAAM,cAAc,KAAK,UAAU,GAAG;AACtC,aAAO,QAAQ,KAAK,GAAG,YAAY,OAAO;AAC1C,aAAO,QAAQ,KAAK,GAAG,YAAY,OAAO;AAC1C,aAAO;AAAA,IACT,SAAS,GAAQ;AACf,aAAO,OAAO,KAAK,qBAAqB,MAAM,UAAU,MAAM,GAAG,WAAW,CAAC,EAAE;AAAA,IACjF;AAAA,EACF;AAEA,OAAK,WAAW;AAChB,SAAO;AACT;",
+  "names": []
+}

package/dist/wiki/types.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/wiki/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wiki/types.ts"],
+  "sourcesContent": ["// \u2500\u2500 WikiPage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface WikiPage {\n  slug: string;\n  title: string;\n  content: string;\n  filePath: string;\n  updatedAt: number;\n  sourceCount: number;\n}\n\nexport interface ScoredWikiPage {\n  page: WikiPage;\n  score: number;\n}\n\n// \u2500\u2500 WIKI_DIFF types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type DiffAction = 'upsert' | 'create' | 'append';\nexport type DiffMode = 'replace' | 'append';\n\nexport interface WikiDiffEntry {\n  action: DiffAction;\n  page: string;          // slug\n  title?: string;        // required for action=create\n  section?: string;      // target section heading (e.g. \"Decisions\")\n  mode?: DiffMode;       // for action=upsert: replace section or append to it\n  content: string;       // markdown content to write\n}\n\nexport interface WikiDiffConflict {\n  page: string;\n  section: string;\n  existing: string;\n  incoming: string;\n  source: string;\n  existingDate?: string; // ISO date string\n  incomingDate?: string; // ISO date string\n}\n\nexport interface WikiDiff {\n  entries: WikiDiffEntry[];\n  conflicts: WikiDiffConflict[];\n  rawDiff: string;\n}\n\n// \u2500\u2500 Lint \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type LintIssueKind = 'contradiction' | 'orphan' | 'stale' | 'broken_link';\n\nexport interface WikiLintIssue {\n  kind: LintIssueKind;\n  slug: string;\n  detail: string;\n  relatedSlug?: string;\n}\n\n// \u2500\u2500 Stats \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface WikiStats {\n  pageCount: number;\n  totalSources: number;\n  oldestPage: number | null;\n  newestPage: number | null;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kirograph",
-  "version": "0.23.0",
+  "version": "0.27.0",
   "description": "Semantic code knowledge graph for Kiro: fewer tool calls, instant symbol lookups, 100% local.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,6 +24,8 @@
     "test:turboquant": "bash scripts/turboquant/test.sh",
     "test:turbovec": "bash scripts/turbovec/test.sh",
     "test:data": "bash scripts/data/test.sh",
+    "test:wiki": "bash scripts/wiki/test.sh",
+    "test:mem": "bash scripts/mem/test.sh",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "release": "./scripts/release.sh",
     "docs": "npx serve docs"
@@ -44,8 +46,7 @@
     "parquetjs-lite": "^0.8.7",
     "picomatch": "^4.0.3",
     "tree-sitter-wasms": "^0.1.11",
-    "web-tree-sitter": "^0.25.3",
-    "xlsx": "^0.18.5"
+    "web-tree-sitter": "^0.25.3"
   },
   "optionalDependencies": {
     "@ast-grep/lang-bash": "^0.0.8",
@@ -77,7 +78,8 @@
     "sqlite-vec": "^0.1.9",
     "turboquant-js": "^0.2.0",
     "turbovec-node": "file:native/turbovec-node",
-    "typesense": "^3.0.6"
+    "typesense": "^3.0.6",
+    "xlsx": "^0.18.5"
   },
   "devDependencies": {
     "@types/figlet": "^1.7.0",