kirograph 0.22.0 → 0.26.0

package/dist/wiki/index.js

@@ -0,0 +1,149 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wiki_exports = {};
+__export(wiki_exports, {
+  KiroGraphWiki: () => KiroGraphWiki
+});
+module.exports = __toCommonJS(wiki_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_database = require("./database");
+var import_schema = require("./schema");
+var import_schema2 = require("./schema");
+var import_ingest = require("./ingest");
+var import_lint = require("./lint");
+class KiroGraphWiki {
+  constructor(db, kirographDir, opts = {}) {
+    this.wikiDb = new import_database.WikiDatabase(db);
+    this.wikiDir = path.join(kirographDir, "wiki");
+    this.autoResolveConflicts = opts.autoResolveConflicts ?? false;
+  }
+  initialize() {
+    this.wikiDb.initialize();
+    fs.mkdirSync(this.wikiDir, { recursive: true });
+  }
+  // ── Init ───────────────────────────────────────────────────────────────────
+  initWiki() {
+    this.initialize();
+    const schemaPath = path.join(this.wikiDir, "SCHEMA.md");
+    if (!fs.existsSync(schemaPath)) {
+      fs.writeFileSync(schemaPath, import_schema.DEFAULT_SCHEMA, "utf8");
+    }
+    const manifestPath = path.join(this.wikiDir, "MANIFEST.md");
+    if (!fs.existsSync(manifestPath)) {
+      fs.writeFileSync(manifestPath, "# Wiki Manifest\n\n(empty)\n", "utf8");
+    }
+  }
+  // ── Ingest ─────────────────────────────────────────────────────────────────
+  /**
+   * Returns the ingest prompt for the LLM (agent mode).
+   * The agent uses this to produce a WIKI_DIFF, then calls applyDiff.
+   */
+  getIngestPrompt(source, sourceName = "source") {
+    this.initialize();
+    return (0, import_ingest.buildIngestPrompt)(this.wikiDir, source, sourceName);
+  }
+  // ── Queue (local synthesis mode) ──────────────────────────────────────────
+  queueSource(sourceText, sourceName) {
+    this.initialize();
+    this.wikiDb.queueSource(sourceName, sourceText);
+  }
+  getPendingQueue() {
+    this.initialize();
+    return this.wikiDb.getPendingQueue();
+  }
+  clearQueue() {
+    this.initialize();
+    this.wikiDb.clearQueue();
+  }
+  getQueueCount() {
+    this.initialize();
+    return this.wikiDb.getQueueCount();
+  }
+  async synthesize(modelName, quiet = false) {
+    this.initialize();
+    const { runWikiLocalSynthesis } = await Promise.resolve().then(() => require("./synthesize.js"));
+    return runWikiLocalSynthesis(this, modelName, quiet);
+  }
+  /**
+   * Parse and apply a WIKI_DIFF string produced by the LLM.
+   */
+  applyDiff(rawDiff) {
+    this.initialize();
+    const diff = (0, import_schema2.parseWikiDiff)(rawDiff);
+    return (0, import_ingest.applyDiff)(diff, this.wikiDir, this.wikiDb, {
+      autoResolveConflicts: this.autoResolveConflicts
+    });
+  }
+  // ── Search & Read ──────────────────────────────────────────────────────────
+  search(query, limit = 10) {
+    this.initialize();
+    return this.wikiDb.search(query, limit);
+  }
+  getPage(slug) {
+    this.initialize();
+    return this.wikiDb.getPage(slug);
+  }
+  listPages() {
+    this.initialize();
+    return this.wikiDb.listPages();
+  }
+  // ── Lint ───────────────────────────────────────────────────────────────────
+  lint() {
+    this.initialize();
+    return (0, import_lint.lintWiki)(this.wikiDb);
+  }
+  // ── Reindex ────────────────────────────────────────────────────────────────
+  reindex() {
+    this.initialize();
+    return (0, import_ingest.reindexFromDisk)(this.wikiDir, this.wikiDb);
+  }
+  // ── Stats ──────────────────────────────────────────────────────────────────
+  getStats() {
+    this.initialize();
+    return this.wikiDb.getStats();
+  }
+  // ── Context enrichment ────────────────────────────────────────────────────
+  /**
+   * Returns wiki pages relevant to a query, for inclusion in kirograph_context.
+   * Returns up to `limit` pages with score >= threshold.
+   */
+  getContextPages(query, limit = 3, threshold = 0.4) {
+    this.initialize();
+    return this.wikiDb.search(query, limit * 2).filter((r) => r.score >= threshold).slice(0, limit).map((r) => r.page);
+  }
+  get dir() {
+    return this.wikiDir;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KiroGraphWiki
+});
+//# sourceMappingURL=index.js.map

package/dist/wiki/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wiki/index.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Wiki \u2014 Public API\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { WikiDatabase } from './database';\nimport { DEFAULT_SCHEMA } from './schema';\nimport { parseWikiDiff } from './schema';\nimport { buildIngestPrompt, applyDiff, reindexFromDisk, updateManifest } from './ingest';\nimport { lintWiki } from './lint';\nimport type {\n  WikiPage,\n  ScoredWikiPage,\n  WikiDiff,\n  WikiLintIssue,\n  WikiStats,\n} from './types';\n\nexport type { WikiPage, ScoredWikiPage, WikiDiff, WikiLintIssue, WikiStats };\n\nexport class KiroGraphWiki {\n  private wikiDb: WikiDatabase;\n  private wikiDir: string;\n  private autoResolveConflicts: boolean;\n\n  constructor(\n    db: any,\n    kirographDir: string,\n    opts: { autoResolveConflicts?: boolean } = {}\n  ) {\n    this.wikiDb = new WikiDatabase(db);\n    this.wikiDir = path.join(kirographDir, 'wiki');\n    this.autoResolveConflicts = opts.autoResolveConflicts ?? false;\n  }\n\n  initialize(): void {\n    this.wikiDb.initialize();\n    fs.mkdirSync(this.wikiDir, { recursive: true });\n  }\n\n  // \u2500\u2500 Init \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\n  initWiki(): void {\n    this.initialize();\n    const schemaPath = path.join(this.wikiDir, 'SCHEMA.md');\n    if (!fs.existsSync(schemaPath)) {\n      fs.writeFileSync(schemaPath, DEFAULT_SCHEMA, 'utf8');\n    }\n    const manifestPath = path.join(this.wikiDir, 'MANIFEST.md');\n    if (!fs.existsSync(manifestPath)) {\n      fs.writeFileSync(manifestPath, '# Wiki Manifest\\n\\n(empty)\\n', 'utf8');\n    }\n  }\n\n  // \u2500\u2500 Ingest \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\n  /**\n   * Returns the ingest prompt for the LLM (agent mode).\n   * The agent uses this to produce a WIKI_DIFF, then calls applyDiff.\n   */\n  getIngestPrompt(source: string, sourceName = 'source'): string {\n    this.initialize();\n    return buildIngestPrompt(this.wikiDir, source, sourceName);\n  }\n\n  // \u2500\u2500 Queue (local synthesis mode) \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\n  queueSource(sourceText: string, sourceName: string): void {\n    this.initialize();\n    this.wikiDb.queueSource(sourceName, sourceText);\n  }\n\n  getPendingQueue(): Array<{ id: number; sourceName: string; sourceText: string }> {\n    this.initialize();\n    return this.wikiDb.getPendingQueue();\n  }\n\n  clearQueue(): void {\n    this.initialize();\n    this.wikiDb.clearQueue();\n  }\n\n  getQueueCount(): number {\n    this.initialize();\n    return this.wikiDb.getQueueCount();\n  }\n\n  async synthesize(modelName: string, quiet = false) {\n    this.initialize();\n    const { runWikiLocalSynthesis } = await Promise.resolve().then(() => require('./synthesize.js'));\n    return runWikiLocalSynthesis(this, modelName, quiet);\n  }\n\n  /**\n   * Parse and apply a WIKI_DIFF string produced by the LLM.\n   */\n  applyDiff(rawDiff: string) {\n    this.initialize();\n    const diff = parseWikiDiff(rawDiff);\n    return applyDiff(diff, this.wikiDir, this.wikiDb, {\n      autoResolveConflicts: this.autoResolveConflicts,\n    });\n  }\n\n  // \u2500\u2500 Search & Read \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\n  search(query: string, limit = 10): ScoredWikiPage[] {\n    this.initialize();\n    return this.wikiDb.search(query, limit);\n  }\n\n  getPage(slug: string): WikiPage | null {\n    this.initialize();\n    return this.wikiDb.getPage(slug);\n  }\n\n  listPages(): WikiPage[] {\n    this.initialize();\n    return this.wikiDb.listPages();\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\n\n  lint(): WikiLintIssue[] {\n    this.initialize();\n    return lintWiki(this.wikiDb);\n  }\n\n  // \u2500\u2500 Reindex \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\n  reindex(): number {\n    this.initialize();\n    return reindexFromDisk(this.wikiDir, this.wikiDb);\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\n\n  getStats(): WikiStats {\n    this.initialize();\n    return this.wikiDb.getStats();\n  }\n\n  // \u2500\u2500 Context enrichment \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\n  /**\n   * Returns wiki pages relevant to a query, for inclusion in kirograph_context.\n   * Returns up to `limit` pages with score >= threshold.\n   */\n  getContextPages(query: string, limit = 3, threshold = 0.4): WikiPage[] {\n    this.initialize();\n    return this.wikiDb\n      .search(query, limit * 2)\n      .filter(r => r.score >= threshold)\n      .slice(0, limit)\n      .map(r => r.page);\n  }\n\n  get dir(): string {\n    return this.wikiDir;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["import_schema"]
+}

package/dist/wiki/ingest.js

@@ -0,0 +1,259 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ingest_exports = {};
+__export(ingest_exports, {
+  applyDiff: () => applyDiff,
+  buildIngestPrompt: () => buildIngestPrompt,
+  reindexFromDisk: () => reindexFromDisk,
+  updateManifest: () => updateManifest
+});
+module.exports = __toCommonJS(ingest_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+function slugToFilePath(slug) {
+  return slug.replace(/\//g, path.sep) + ".md";
+}
+function ensureDir(p) {
+  fs.mkdirSync(path.dirname(p), { recursive: true });
+}
+function upsertSection(content, section, newContent, mode) {
+  const heading = `## ${section}`;
+  const idx = content.indexOf(heading);
+  if (idx === -1) {
+    return content.trimEnd() + `
+
+${heading}
+${newContent.trimEnd()}
+`;
+  }
+  const afterHeading = idx + heading.length;
+  const nextHeading = content.indexOf("\n## ", afterHeading);
+  const sectionEnd = nextHeading === -1 ? content.length : nextHeading;
+  if (mode === "replace") {
+    return content.slice(0, idx) + heading + "\n" + newContent.trimEnd() + "\n" + content.slice(sectionEnd);
+  } else {
+    const sectionContent = content.slice(afterHeading, sectionEnd).trimEnd();
+    return content.slice(0, idx) + heading + sectionContent + "\n" + newContent.trimEnd() + "\n" + content.slice(sectionEnd);
+  }
+}
+function buildIngestPrompt(wikiDir, sourceContent, sourceName) {
+  const schemaPath = path.join(wikiDir, "SCHEMA.md");
+  const manifestPath = path.join(wikiDir, "MANIFEST.md");
+  const schema = fs.existsSync(schemaPath) ? fs.readFileSync(schemaPath, "utf8") : "(no SCHEMA.md found \u2014 use default wiki page structure)";
+  const manifest = fs.existsSync(manifestPath) ? fs.readFileSync(manifestPath, "utf8") : "(wiki is empty \u2014 no pages yet)";
+  return `You are maintaining a project wiki following the schema below.
+
+## SCHEMA
+${schema}
+
+## MANIFEST (existing pages)
+${manifest}
+
+## SOURCE TO INGEST
+Source name: ${sourceName}
+${sourceContent}
+
+## INSTRUCTIONS
+
+Read the source above. Following the schema:
+1. Identify entities, decisions, and patterns mentioned
+2. For existing pages (listed in MANIFEST): update relevant sections
+3. For new entities: create pages using the standard structure
+4. Emit one WIKI_DIFF block per page operation
+5. If incoming info contradicts existing content, emit a WIKI_DIFF_CONFLICTS block
+
+Produce ONLY the WIKI_DIFF blocks and WIKI_DIFF_CONFLICTS blocks. No other output.`;
+}
+function applyDiff(diff, wikiDir, wikiDb, opts = {}) {
+  const result = {
+    created: [],
+    updated: [],
+    conflictsResolved: [],
+    conflictsPending: []
+  };
+  for (const entry of diff.entries) {
+    if (!entry.page) continue;
+    const relPath = slugToFilePath(entry.page);
+    const absPath = path.join(wikiDir, relPath);
+    if (entry.action === "create") {
+      ensureDir(absPath);
+      const title = entry.title ?? entry.page;
+      const fileContent = `# ${title}
+
+${entry.content.trimEnd()}
+`;
+      fs.writeFileSync(absPath, fileContent, "utf8");
+      wikiDb.upsertPage({
+        slug: entry.page,
+        title,
+        content: fileContent,
+        filePath: relPath,
+        sourceCount: 1
+      });
+      result.created.push(entry.page);
+    } else if (entry.action === "upsert") {
+      let current = "";
+      let isNew = false;
+      if (fs.existsSync(absPath)) {
+        current = fs.readFileSync(absPath, "utf8");
+      } else {
+        ensureDir(absPath);
+        current = `# ${entry.page}
+
+`;
+        isNew = true;
+      }
+      const updated = entry.section ? upsertSection(current, entry.section, entry.content, entry.mode ?? "append") : current.trimEnd() + "\n\n" + entry.content.trimEnd() + "\n";
+      fs.writeFileSync(absPath, updated, "utf8");
+      const titleMatch = updated.match(/^#\s+(.+)$/m);
+      wikiDb.upsertPage({
+        slug: entry.page,
+        title: titleMatch?.[1] ?? entry.page,
+        content: updated,
+        filePath: relPath,
+        sourceCount: 1
+      });
+      if (isNew) {
+        result.created.push(entry.page);
+      } else {
+        result.updated.push(entry.page);
+      }
+    } else if (entry.action === "append") {
+      let current = "";
+      if (fs.existsSync(absPath)) {
+        current = fs.readFileSync(absPath, "utf8");
+      } else {
+        ensureDir(absPath);
+        current = `# ${entry.page}
+
+`;
+      }
+      const appended = current.trimEnd() + "\n\n" + entry.content.trimEnd() + "\n";
+      fs.writeFileSync(absPath, appended, "utf8");
+      const titleMatch = appended.match(/^#\s+(.+)$/m);
+      wikiDb.upsertPage({
+        slug: entry.page,
+        title: titleMatch?.[1] ?? entry.page,
+        content: appended,
+        filePath: relPath,
+        sourceCount: 1
+      });
+      result.updated.push(entry.page);
+    }
+  }
+  for (const conflict of diff.conflicts) {
+    if (opts.autoResolveConflicts) {
+      const resolved = resolveConflictByDate(conflict, wikiDir, wikiDb);
+      if (resolved) {
+        result.conflictsResolved.push(conflict.page);
+        continue;
+      }
+    }
+    result.conflictsPending.push(conflict);
+  }
+  updateManifest(wikiDir, wikiDb);
+  return result;
+}
+function resolveConflictByDate(conflict, wikiDir, wikiDb) {
+  const existingDate = conflict.existingDate ? new Date(conflict.existingDate).getTime() : 0;
+  const incomingDate = conflict.incomingDate ? new Date(conflict.incomingDate).getTime() : 0;
+  if (incomingDate >= existingDate && conflict.page && conflict.section) {
+    const relPath = slugToFilePath(conflict.page);
+    const absPath = path.join(wikiDir, relPath);
+    if (!fs.existsSync(absPath)) return false;
+    let content = fs.readFileSync(absPath, "utf8");
+    const supersededNote = `
+> \u26A0 Superseded by ${conflict.source} on ${conflict.incomingDate ?? "unknown date"}
+`;
+    const oldClaim = conflict.existing;
+    content = content.replace(oldClaim, conflict.incoming + supersededNote);
+    fs.writeFileSync(absPath, content, "utf8");
+    const titleMatch = content.match(/^#\s+(.+)$/m);
+    wikiDb.upsertPage({
+      slug: conflict.page,
+      title: titleMatch?.[1] ?? conflict.page,
+      content,
+      filePath: relPath,
+      sourceCount: 0
+    });
+    return true;
+  }
+  return false;
+}
+function updateManifest(wikiDir, wikiDb) {
+  const pages = wikiDb.listPages();
+  if (pages.length === 0) return;
+  const rows = pages.map((p) => `| [${p.slug}](${p.filePath}) | ${p.title} | ${p.sourceCount} | ${new Date(p.updatedAt).toISOString().slice(0, 10)} |`).join("\n");
+  const manifest = `# Wiki Manifest
+
+| Slug | Title | Sources | Updated |
+|------|-------|---------|----------|
+${rows}
+`;
+  fs.writeFileSync(path.join(wikiDir, "MANIFEST.md"), manifest, "utf8");
+}
+function reindexFromDisk(wikiDir, wikiDb) {
+  wikiDb.clearAll();
+  let count = 0;
+  function walkDir(dir) {
+    if (!fs.existsSync(dir)) return;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const abs = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walkDir(abs);
+      } else if (entry.name.endsWith(".md") && entry.name !== "SCHEMA.md" && entry.name !== "MANIFEST.md") {
+        const rel = path.relative(wikiDir, abs);
+        const slug = rel.replace(/\.md$/, "").replace(/\\/g, "/");
+        const content = fs.readFileSync(abs, "utf8");
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        const stat = fs.statSync(abs);
+        wikiDb.upsertPage({
+          slug,
+          title: titleMatch?.[1] ?? slug,
+          content,
+          filePath: rel,
+          updatedAt: stat.mtimeMs,
+          sourceCount: 0
+        });
+        count++;
+      }
+    }
+  }
+  walkDir(wikiDir);
+  updateManifest(wikiDir, wikiDb);
+  return count;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyDiff,
+  buildIngestPrompt,
+  reindexFromDisk,
+  updateManifest
+});
+//# sourceMappingURL=ingest.js.map

package/dist/wiki/ingest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wiki/ingest.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Wiki \u2014 Ingest & apply-diff logic\n *\n * applyDiff: writes markdown files + updates SQLite from a parsed WIKI_DIFF\n * buildIngestPrompt: returns the prompt for the LLM (SCHEMA + MANIFEST + source)\n * resolveConflicts: deterministic auto-resolve by source date\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport type { WikiDiff, WikiDiffEntry, WikiDiffConflict, WikiPage } from './types';\nimport type { WikiDatabase } from './database';\n\n// \u2500\u2500 Helpers \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\nfunction slugToFilePath(slug: string): string {\n  return slug.replace(/\\//g, path.sep) + '.md';\n}\n\nfunction ensureDir(p: string): void {\n  fs.mkdirSync(path.dirname(p), { recursive: true });\n}\n\nfunction upsertSection(content: string, section: string, newContent: string, mode: 'replace' | 'append'): string {\n  const heading = `## ${section}`;\n  const idx = content.indexOf(heading);\n\n  if (idx === -1) {\n    // Section doesn't exist \u2014 append at end\n    return content.trimEnd() + `\\n\\n${heading}\\n${newContent.trimEnd()}\\n`;\n  }\n\n  // Find end of section (next ## heading or EOF)\n  const afterHeading = idx + heading.length;\n  const nextHeading = content.indexOf('\\n## ', afterHeading);\n  const sectionEnd = nextHeading === -1 ? content.length : nextHeading;\n\n  if (mode === 'replace') {\n    return content.slice(0, idx) + heading + '\\n' + newContent.trimEnd() + '\\n' + content.slice(sectionEnd);\n  } else {\n    // append: insert before next heading\n    const sectionContent = content.slice(afterHeading, sectionEnd).trimEnd();\n    return content.slice(0, idx) + heading + sectionContent + '\\n' + newContent.trimEnd() + '\\n' + content.slice(sectionEnd);\n  }\n}\n\n// \u2500\u2500 buildIngestPrompt \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 function buildIngestPrompt(\n  wikiDir: string,\n  sourceContent: string,\n  sourceName: string,\n): string {\n  const schemaPath = path.join(wikiDir, 'SCHEMA.md');\n  const manifestPath = path.join(wikiDir, 'MANIFEST.md');\n\n  const schema = fs.existsSync(schemaPath)\n    ? fs.readFileSync(schemaPath, 'utf8')\n    : '(no SCHEMA.md found \u2014 use default wiki page structure)';\n\n  const manifest = fs.existsSync(manifestPath)\n    ? fs.readFileSync(manifestPath, 'utf8')\n    : '(wiki is empty \u2014 no pages yet)';\n\n  return `You are maintaining a project wiki following the schema below.\n\n## SCHEMA\n${schema}\n\n## MANIFEST (existing pages)\n${manifest}\n\n## SOURCE TO INGEST\nSource name: ${sourceName}\n${sourceContent}\n\n## INSTRUCTIONS\n\nRead the source above. Following the schema:\n1. Identify entities, decisions, and patterns mentioned\n2. For existing pages (listed in MANIFEST): update relevant sections\n3. For new entities: create pages using the standard structure\n4. Emit one WIKI_DIFF block per page operation\n5. If incoming info contradicts existing content, emit a WIKI_DIFF_CONFLICTS block\n\nProduce ONLY the WIKI_DIFF blocks and WIKI_DIFF_CONFLICTS blocks. No other output.`;\n}\n\n// \u2500\u2500 applyDiff \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 ApplyDiffResult {\n  created: string[];\n  updated: string[];\n  conflictsResolved: string[];\n  conflictsPending: WikiDiffConflict[];\n}\n\nexport function applyDiff(\n  diff: WikiDiff,\n  wikiDir: string,\n  wikiDb: WikiDatabase,\n  opts: { autoResolveConflicts?: boolean } = {}\n): ApplyDiffResult {\n  const result: ApplyDiffResult = {\n    created: [],\n    updated: [],\n    conflictsResolved: [],\n    conflictsPending: [],\n  };\n\n  for (const entry of diff.entries) {\n    if (!entry.page) continue;\n\n    const relPath = slugToFilePath(entry.page);\n    const absPath = path.join(wikiDir, relPath);\n\n    if (entry.action === 'create') {\n      ensureDir(absPath);\n      const title = entry.title ?? entry.page;\n      const fileContent = `# ${title}\\n\\n${entry.content.trimEnd()}\\n`;\n      fs.writeFileSync(absPath, fileContent, 'utf8');\n      wikiDb.upsertPage({\n        slug: entry.page,\n        title,\n        content: fileContent,\n        filePath: relPath,\n        sourceCount: 1,\n      });\n      result.created.push(entry.page);\n\n    } else if (entry.action === 'upsert') {\n      let current = '';\n      let isNew = false;\n      if (fs.existsSync(absPath)) {\n        current = fs.readFileSync(absPath, 'utf8');\n      } else {\n        ensureDir(absPath);\n        current = `# ${entry.page}\\n\\n`;\n        isNew = true;\n      }\n\n      const updated = entry.section\n        ? upsertSection(current, entry.section, entry.content, entry.mode ?? 'append')\n        : current.trimEnd() + '\\n\\n' + entry.content.trimEnd() + '\\n';\n\n      fs.writeFileSync(absPath, updated, 'utf8');\n      const titleMatch = updated.match(/^#\\s+(.+)$/m);\n      wikiDb.upsertPage({\n        slug: entry.page,\n        title: titleMatch?.[1] ?? entry.page,\n        content: updated,\n        filePath: relPath,\n        sourceCount: 1,\n      });\n      if (isNew) {\n        result.created.push(entry.page);\n      } else {\n        result.updated.push(entry.page);\n      }\n\n    } else if (entry.action === 'append') {\n      let current = '';\n      if (fs.existsSync(absPath)) {\n        current = fs.readFileSync(absPath, 'utf8');\n      } else {\n        ensureDir(absPath);\n        current = `# ${entry.page}\\n\\n`;\n      }\n      const appended = current.trimEnd() + '\\n\\n' + entry.content.trimEnd() + '\\n';\n      fs.writeFileSync(absPath, appended, 'utf8');\n      const titleMatch = appended.match(/^#\\s+(.+)$/m);\n      wikiDb.upsertPage({\n        slug: entry.page,\n        title: titleMatch?.[1] ?? entry.page,\n        content: appended,\n        filePath: relPath,\n        sourceCount: 1,\n      });\n      result.updated.push(entry.page);\n    }\n  }\n\n  // Handle conflicts\n  for (const conflict of diff.conflicts) {\n    if (opts.autoResolveConflicts) {\n      const resolved = resolveConflictByDate(conflict, wikiDir, wikiDb);\n      if (resolved) {\n        result.conflictsResolved.push(conflict.page);\n        continue;\n      }\n    }\n    result.conflictsPending.push(conflict);\n  }\n\n  updateManifest(wikiDir, wikiDb);\n\n  return result;\n}\n\n// \u2500\u2500 resolveConflictByDate \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\nfunction resolveConflictByDate(\n  conflict: WikiDiffConflict,\n  wikiDir: string,\n  wikiDb: WikiDatabase,\n): boolean {\n  const existingDate = conflict.existingDate ? new Date(conflict.existingDate).getTime() : 0;\n  const incomingDate = conflict.incomingDate ? new Date(conflict.incomingDate).getTime() : 0;\n\n  // Incoming is newer \u2014 replace existing claim and add superseded note\n  if (incomingDate >= existingDate && conflict.page && conflict.section) {\n    const relPath = slugToFilePath(conflict.page);\n    const absPath = path.join(wikiDir, relPath);\n    if (!fs.existsSync(absPath)) return false;\n\n    let content = fs.readFileSync(absPath, 'utf8');\n    const supersededNote = `\\n> \u26A0 Superseded by ${conflict.source} on ${conflict.incomingDate ?? 'unknown date'}\\n`;\n    const oldClaim = conflict.existing;\n    content = content.replace(oldClaim, conflict.incoming + supersededNote);\n    fs.writeFileSync(absPath, content, 'utf8');\n\n    const titleMatch = content.match(/^#\\s+(.+)$/m);\n    wikiDb.upsertPage({\n      slug: conflict.page,\n      title: titleMatch?.[1] ?? conflict.page,\n      content,\n      filePath: relPath,\n      sourceCount: 0,\n    });\n    return true;\n  }\n\n  return false;\n}\n\n// \u2500\u2500 updateManifest \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 function updateManifest(wikiDir: string, wikiDb: WikiDatabase): void {\n  const pages = wikiDb.listPages();\n  if (pages.length === 0) return;\n\n  const rows = pages\n    .map(p => `| [${p.slug}](${p.filePath}) | ${p.title} | ${p.sourceCount} | ${new Date(p.updatedAt).toISOString().slice(0, 10)} |`)\n    .join('\\n');\n\n  const manifest = `# Wiki Manifest\\n\\n| Slug | Title | Sources | Updated |\\n|------|-------|---------|----------|\\n${rows}\\n`;\n  fs.writeFileSync(path.join(wikiDir, 'MANIFEST.md'), manifest, 'utf8');\n}\n\n// \u2500\u2500 reindex \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 function reindexFromDisk(wikiDir: string, wikiDb: WikiDatabase): number {\n  wikiDb.clearAll();\n\n  let count = 0;\n\n  function walkDir(dir: string): void {\n    if (!fs.existsSync(dir)) return;\n    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n      const abs = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        walkDir(abs);\n      } else if (entry.name.endsWith('.md') && entry.name !== 'SCHEMA.md' && entry.name !== 'MANIFEST.md') {\n        const rel = path.relative(wikiDir, abs);\n        const slug = rel.replace(/\\.md$/, '').replace(/\\\\/g, '/');\n        const content = fs.readFileSync(abs, 'utf8');\n        const titleMatch = content.match(/^#\\s+(.+)$/m);\n        const stat = fs.statSync(abs);\n        wikiDb.upsertPage({\n          slug,\n          title: titleMatch?.[1] ?? slug,\n          content,\n          filePath: rel,\n          updatedAt: stat.mtimeMs,\n          sourceCount: 0,\n        });\n        count++;\n      }\n    }\n  }\n\n  walkDir(wikiDir);\n  updateManifest(wikiDir, wikiDb);\n  return count;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/wiki/lint.js

@@ -0,0 +1,93 @@
+"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 lint_exports = {};
+__export(lint_exports, {
+  lintWiki: () => lintWiki
+});
+module.exports = __toCommonJS(lint_exports);
+const LINK_RE = /\[\[([^\]]+)\]\]/g;
+function lintWiki(wikiDb) {
+  const issues = [];
+  const pages = wikiDb.listPages();
+  const slugSet = new Set(pages.map((p) => p.slug));
+  for (const page of pages) {
+    let m;
+    const re = new RegExp(LINK_RE.source, "g");
+    while ((m = re.exec(page.content)) !== null) {
+      const linked = m[1].trim();
+      if (!slugSet.has(linked)) {
+        issues.push({
+          kind: "broken_link",
+          slug: page.slug,
+          detail: `Broken link to [[${linked}]] \u2014 page does not exist`,
+          relatedSlug: linked
+        });
+      }
+    }
+    const hasRelated = /^## Related/m.test(page.content);
+    const hasIncoming = pages.some((p) => p.slug !== page.slug && p.content.includes(`[[${page.slug}]]`));
+    if (!hasRelated && !hasIncoming && pages.length > 1) {
+      issues.push({
+        kind: "orphan",
+        slug: page.slug,
+        detail: "Page has no ## Related section and no incoming links from other pages"
+      });
+    }
+    const sourcesMatch = page.content.match(/## Sources\n([\s\S]*?)(?=\n## |\n*$)/);
+    if (sourcesMatch) {
+      const sourcesBlock = sourcesMatch[1];
+      const hasDates = /\d{4}-\d{2}-\d{2}/.test(sourcesBlock);
+      if (!hasDates) {
+        issues.push({
+          kind: "stale",
+          slug: page.slug,
+          detail: "## Sources section has no dates \u2014 cannot verify freshness"
+        });
+      }
+    }
+    const similar = wikiDb.search(page.title, 5);
+    for (const { page: other } of similar) {
+      if (other.slug === page.slug) continue;
+      const contradictionSignals = ["instead of", "not", "replaced by", "superseded", "deprecated"];
+      const bothMentionSignal = contradictionSignals.some(
+        (sig) => page.content.toLowerCase().includes(sig) && other.content.toLowerCase().includes(sig)
+      );
+      if (bothMentionSignal) {
+        const key = [page.slug, other.slug].sort().join("|");
+        const alreadyReported = issues.some(
+          (i) => i.kind === "contradiction" && i.detail.includes(other.slug)
+        );
+        if (!alreadyReported) {
+          issues.push({
+            kind: "contradiction",
+            slug: page.slug,
+            detail: `Possible contradiction with [[${other.slug}]] \u2014 both pages contain negation signals on shared topics`,
+            relatedSlug: other.slug
+          });
+        }
+      }
+    }
+  }
+  return issues;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  lintWiki
+});
+//# sourceMappingURL=lint.js.map

package/dist/wiki/lint.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wiki/lint.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Wiki \u2014 Lint\n *\n * Health checks: contradictions (FTS similarity), orphan pages,\n * broken [[slug]] cross-references.\n */\n\nimport * as path from 'path';\nimport type { WikiLintIssue } from './types';\nimport type { WikiDatabase } from './database';\n\nconst LINK_RE = /\\[\\[([^\\]]+)\\]\\]/g;\n\nexport function lintWiki(wikiDb: WikiDatabase): WikiLintIssue[] {\n  const issues: WikiLintIssue[] = [];\n  const pages = wikiDb.listPages();\n  const slugSet = new Set(pages.map(p => p.slug));\n\n  for (const page of pages) {\n    // Broken [[slug]] links\n    let m: RegExpExecArray | null;\n    const re = new RegExp(LINK_RE.source, 'g');\n    while ((m = re.exec(page.content)) !== null) {\n      const linked = m[1].trim();\n      if (!slugSet.has(linked)) {\n        issues.push({\n          kind: 'broken_link',\n          slug: page.slug,\n          detail: `Broken link to [[${linked}]] \u2014 page does not exist`,\n          relatedSlug: linked,\n        });\n      }\n    }\n\n    // Orphan: no ## Related section and no incoming links from other pages\n    const hasRelated = /^## Related/m.test(page.content);\n    const hasIncoming = pages.some(p => p.slug !== page.slug && p.content.includes(`[[${page.slug}]]`));\n    if (!hasRelated && !hasIncoming && pages.length > 1) {\n      issues.push({\n        kind: 'orphan',\n        slug: page.slug,\n        detail: 'Page has no ## Related section and no incoming links from other pages',\n      });\n    }\n\n    // Stale: ## Sources section present but no date found (can't verify freshness)\n    const sourcesMatch = page.content.match(/## Sources\\n([\\s\\S]*?)(?=\\n## |\\n*$)/);\n    if (sourcesMatch) {\n      const sourcesBlock = sourcesMatch[1];\n      const hasDates = /\\d{4}-\\d{2}-\\d{2}/.test(sourcesBlock);\n      if (!hasDates) {\n        issues.push({\n          kind: 'stale',\n          slug: page.slug,\n          detail: '## Sources section has no dates \u2014 cannot verify freshness',\n        });\n      }\n    }\n\n    // Contradictions: FTS similarity with other pages on the same topic\n    // Simple heuristic: search for the page title and flag pages with conflicting signals\n    const similar = wikiDb.search(page.title, 5);\n    for (const { page: other } of similar) {\n      if (other.slug === page.slug) continue;\n      // Check for negation keywords close to shared terms\n      const contradictionSignals = ['instead of', 'not', 'replaced by', 'superseded', 'deprecated'];\n      const bothMentionSignal = contradictionSignals.some(\n        sig => page.content.toLowerCase().includes(sig) && other.content.toLowerCase().includes(sig)\n      );\n      if (bothMentionSignal) {\n        const key = [page.slug, other.slug].sort().join('|');\n        const alreadyReported = issues.some(\n          i => i.kind === 'contradiction' && i.detail.includes(other.slug)\n        );\n        if (!alreadyReported) {\n          issues.push({\n            kind: 'contradiction',\n            slug: page.slug,\n            detail: `Possible contradiction with [[${other.slug}]] \u2014 both pages contain negation signals on shared topics`,\n            relatedSlug: other.slug,\n          });\n        }\n      }\n    }\n  }\n\n  return issues;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,MAAM,UAAU;AAET,SAAS,SAAS,QAAuC;AAC9D,QAAM,SAA0B,CAAC;AACjC,QAAM,QAAQ,OAAO,UAAU;AAC/B,QAAM,UAAU,IAAI,IAAI,MAAM,IAAI,OAAK,EAAE,IAAI,CAAC;AAE9C,aAAW,QAAQ,OAAO;AAExB,QAAI;AACJ,UAAM,KAAK,IAAI,OAAO,QAAQ,QAAQ,GAAG;AACzC,YAAQ,IAAI,GAAG,KAAK,KAAK,OAAO,OAAO,MAAM;AAC3C,YAAM,SAAS,EAAE,CAAC,EAAE,KAAK;AACzB,UAAI,CAAC,QAAQ,IAAI,MAAM,GAAG;AACxB,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,MAAM,KAAK;AAAA,UACX,QAAQ,oBAAoB,MAAM;AAAA,UAClC,aAAa;AAAA,QACf,CAAC;AAAA,MACH;AAAA,IACF;AAGA,UAAM,aAAa,eAAe,KAAK,KAAK,OAAO;AACnD,UAAM,cAAc,MAAM,KAAK,OAAK,EAAE,SAAS,KAAK,QAAQ,EAAE,QAAQ,SAAS,KAAK,KAAK,IAAI,IAAI,CAAC;AAClG,QAAI,CAAC,cAAc,CAAC,eAAe,MAAM,SAAS,GAAG;AACnD,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,MAAM,KAAK;AAAA,QACX,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAGA,UAAM,eAAe,KAAK,QAAQ,MAAM,sCAAsC;AAC9E,QAAI,cAAc;AAChB,YAAM,eAAe,aAAa,CAAC;AACnC,YAAM,WAAW,oBAAoB,KAAK,YAAY;AACtD,UAAI,CAAC,UAAU;AACb,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,MAAM,KAAK;AAAA,UACX,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AAAA,IACF;AAIA,UAAM,UAAU,OAAO,OAAO,KAAK,OAAO,CAAC;AAC3C,eAAW,EAAE,MAAM,MAAM,KAAK,SAAS;AACrC,UAAI,MAAM,SAAS,KAAK,KAAM;AAE9B,YAAM,uBAAuB,CAAC,cAAc,OAAO,eAAe,cAAc,YAAY;AAC5F,YAAM,oBAAoB,qBAAqB;AAAA,QAC7C,SAAO,KAAK,QAAQ,YAAY,EAAE,SAAS,GAAG,KAAK,MAAM,QAAQ,YAAY,EAAE,SAAS,GAAG;AAAA,MAC7F;AACA,UAAI,mBAAmB;AACrB,cAAM,MAAM,CAAC,KAAK,MAAM,MAAM,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG;AACnD,cAAM,kBAAkB,OAAO;AAAA,UAC7B,OAAK,EAAE,SAAS,mBAAmB,EAAE,OAAO,SAAS,MAAM,IAAI;AAAA,QACjE;AACA,YAAI,CAAC,iBAAiB;AACpB,iBAAO,KAAK;AAAA,YACV,MAAM;AAAA,YACN,MAAM,KAAK;AAAA,YACX,QAAQ,iCAAiC,MAAM,IAAI;AAAA,YACnD,aAAa,MAAM;AAAA,UACrB,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;",
+  "names": []
+}