@tangle-network/agent-knowledge 1.2.0 → 1.3.0

package/dist/chunk-YMKHCTS2.js

@@ -0,0 +1,19 @@
+// src/ids.ts
+import { createHash } from "crypto";
+function sha256(text) {
+  return createHash("sha256").update(text).digest("hex");
+}
+function slugify(input) {
+  const out = input.trim().toLowerCase().normalize("NFKD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\u4e00-\u9fff]+/g, "-").replace(/^-+|-+$/g, "");
+  return out || "untitled";
+}
+function stableId(prefix, content) {
+  return `${prefix}_${sha256(content).slice(0, 16)}`;
+}
+
+export {
+  sha256,
+  slugify,
+  stableId
+};
+//# sourceMappingURL=chunk-YMKHCTS2.js.map

package/dist/chunk-YMKHCTS2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ids.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\n\nexport function sha256(text: string): string {\n  return createHash('sha256').update(text).digest('hex')\n}\n\nexport function slugify(input: string): string {\n  const out = input\n    .trim()\n    .toLowerCase()\n    .normalize('NFKD')\n    .replace(/[\\u0300-\\u036f]/g, '')\n    .replace(/[^a-z0-9\\u4e00-\\u9fff]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n  return out || 'untitled'\n}\n\nexport function stableId(prefix: string, content: string): string {\n  return `${prefix}_${sha256(content).slice(0, 16)}`\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAEpB,SAAS,OAAO,MAAsB;AAC3C,SAAO,WAAW,QAAQ,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AACvD;AAEO,SAAS,QAAQ,OAAuB;AAC7C,QAAM,MAAM,MACT,KAAK,EACL,YAAY,EACZ,UAAU,MAAM,EAChB,QAAQ,oBAAoB,EAAE,EAC9B,QAAQ,4BAA4B,GAAG,EACvC,QAAQ,YAAY,EAAE;AACzB,SAAO,OAAO;AAChB;AAEO,SAAS,SAAS,QAAgB,SAAyB;AAChE,SAAO,GAAG,MAAM,IAAI,OAAO,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAClD;","names":[]}

package/dist/cli.js

@@ -11,12 +11,13 @@ import {
   searchKnowledge,
   validateKnowledgeIndex,
   writeKnowledgeIndex
-} from "./chunk-JLCQ6O7W.js";
+} from "./chunk-HKYD765Q.js";
 import {
   detectKnowledgeGaps,
   findSurprisingConnections,
   toKnowledgeVizGraph
-} from "./chunk-TXNYP4WI.js";
+} from "./chunk-4PNXQ2NT.js";
+import "./chunk-YMKHCTS2.js";
 
 // src/cli.ts
 import { existsSync, readFileSync } from "fs";
@@ -86,9 +87,13 @@ async function main() {
     }
     case "index": {
       const index = await writeKnowledgeIndex(root);
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(index, null, 2) + "\n");
-      else process.stdout.write(`indexed ${index.pages.length} pages, ${index.graph.edges.length} edges
+      if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(index, null, 2)}
 `);
+      else
+        process.stdout.write(
+          `indexed ${index.pages.length} pages, ${index.graph.edges.length} edges
+`
+        );
       return 0;
     }
     case "source-add": {
@@ -99,16 +104,20 @@ async function main() {
       }
       await initKnowledgeBase(root);
       const sources = await addSourcePath(root, resolve(path));
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(sources, null, 2) + "\n");
+      if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(sources, null, 2)}
+`);
       else for (const source of sources) process.stdout.write(`${source.id} ${source.uri}
 `);
       return 0;
     }
     case "sources": {
       const registry = await loadSourceRegistry(root);
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(registry.sources, null, 2) + "\n");
+      if (args.flags.json === "true")
+        process.stdout.write(`${JSON.stringify(registry.sources, null, 2)}
+`);
       else {
-        for (const source of registry.sources) process.stdout.write(`${source.id} ${source.title ?? source.uri} ${source.uri}
+        for (const source of registry.sources)
+          process.stdout.write(`${source.id} ${source.title ?? source.uri} ${source.uri}
 `);
       }
       return 0;
@@ -122,7 +131,8 @@ async function main() {
       await initKnowledgeBase(root);
       const result = await applyKnowledgeWriteBlocksFile(root, resolve(proposalPath));
       await writeKnowledgeIndex(root);
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+      if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
       else {
         for (const path of result.written) process.stdout.write(`wrote ${path}
 `);
@@ -134,11 +144,16 @@ async function main() {
     case "inspect": {
       const index = await loadOrBuildIndex(root);
       const inspection = inspectKnowledgeIndex(index);
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(inspection, null, 2) + "\n");
-      else {
-        process.stdout.write(`pages=${inspection.pageCount} sources=${inspection.sourceCount} edges=${inspection.edgeCount} findings=${inspection.findingCount} blocking=${inspection.blockingFindingCount}
+      if (args.flags.json === "true")
+        process.stdout.write(`${JSON.stringify(inspection, null, 2)}
 `);
-        for (const page of inspection.topPages.slice(0, 5)) process.stdout.write(`${page.degree} ${page.path} sources=${page.sources}
+      else {
+        process.stdout.write(
+          `pages=${inspection.pageCount} sources=${inspection.sourceCount} edges=${inspection.edgeCount} findings=${inspection.findingCount} blocking=${inspection.blockingFindingCount}
+`
+        );
+        for (const page of inspection.topPages.slice(0, 5))
+          process.stdout.write(`${page.degree} ${page.path} sources=${page.sources}
 `);
       }
       return inspection.blockingFindingCount > 0 ? 2 : 0;
@@ -150,17 +165,21 @@ async function main() {
         return 1;
       }
       const explanation = explainKnowledgeTarget(await loadOrBuildIndex(root), target);
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(explanation, null, 2) + "\n");
+      if (args.flags.json === "true")
+        process.stdout.write(`${JSON.stringify(explanation, null, 2)}
+`);
       else {
         process.stdout.write(`${explanation.page ? explanation.page.title : target}
 `);
-        for (const source of explanation.sources) process.stdout.write(`source ${source.id} ${source.title ?? source.uri}
+        for (const source of explanation.sources)
+          process.stdout.write(`source ${source.id} ${source.title ?? source.uri}
 `);
         for (const link of explanation.links) process.stdout.write(`out ${link}
 `);
         for (const inbound of explanation.inbound) process.stdout.write(`in ${inbound}
 `);
-        for (const related of explanation.related.slice(0, 5)) process.stdout.write(`related ${related.path} score=${related.score.toFixed(5)}
+        for (const related of explanation.related.slice(0, 5))
+          process.stdout.write(`related ${related.path} score=${related.score.toFixed(5)}
 `);
       }
       return 0;
@@ -174,11 +193,14 @@ async function main() {
       const index = await loadOrBuildIndex(root);
       const results = searchKnowledge(index, query, Number(args.flags.limit ?? 10));
       if (args.flags.json === "true") {
-        process.stdout.write(JSON.stringify(results, null, 2) + "\n");
+        process.stdout.write(`${JSON.stringify(results, null, 2)}
+`);
       } else {
         for (const result of results) {
-          process.stdout.write(`${result.rank}. ${result.page.title} (${result.page.path}) score=${result.score.toFixed(5)}
-`);
+          process.stdout.write(
+            `${result.rank}. ${result.page.title} (${result.page.path}) score=${result.score.toFixed(5)}
+`
+          );
           if (result.snippet) process.stdout.write(`   ${result.snippet}
 `);
         }
@@ -187,31 +209,45 @@ async function main() {
     }
     case "graph": {
       const index = await loadOrBuildIndex(root);
-      if ((args.flags.format ?? "summary") === "json") process.stdout.write(JSON.stringify(index.graph, null, 2) + "\n");
-      else process.stdout.write(`nodes=${index.graph.nodes.length} edges=${index.graph.edges.length}
+      if ((args.flags.format ?? "summary") === "json")
+        process.stdout.write(`${JSON.stringify(index.graph, null, 2)}
 `);
+      else
+        process.stdout.write(
+          `nodes=${index.graph.nodes.length} edges=${index.graph.edges.length}
+`
+        );
       return 0;
     }
     case "lint": {
       const index = await loadOrBuildIndex(root);
       const findings = lintKnowledgeIndex(index);
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(findings, null, 2) + "\n");
+      if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(findings, null, 2)}
+`);
       else {
         if (findings.length === 0) process.stdout.write("no findings\n");
         for (const finding of findings) {
-          process.stdout.write(`${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ""}: ${finding.message}
-`);
+          process.stdout.write(
+            `${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ""}: ${finding.message}
+`
+          );
         }
       }
       return findings.some((finding) => finding.severity === "error") ? 2 : 0;
     }
     case "validate": {
-      const result = validateKnowledgeIndex(await loadOrBuildIndex(root), { strict: args.flags.strict === "true" });
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+      const result = validateKnowledgeIndex(await loadOrBuildIndex(root), {
+        strict: args.flags.strict === "true"
+      });
+      if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
       else {
         process.stdout.write(result.ok ? "valid\n" : "invalid\n");
-        for (const finding of result.findings) process.stdout.write(`${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ""}: ${finding.message}
-`);
+        for (const finding of result.findings)
+          process.stdout.write(
+            `${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ""}: ${finding.message}
+`
+          );
       }
       return result.ok ? 0 : 2;
     }
@@ -222,7 +258,8 @@ async function main() {
         process.stderr.write("export currently supports --format json\n");
         return 1;
       }
-      process.stdout.write(JSON.stringify(index, null, 2) + "\n");
+      process.stdout.write(`${JSON.stringify(index, null, 2)}
+`);
       return 0;
     }
     case "viz": {
@@ -233,10 +270,13 @@ async function main() {
         gaps: detectKnowledgeGaps(viz),
         surprisingConnections: findSurprisingConnections(viz)
       };
-      if (args.flags.json === "true") process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
-      else {
-        process.stdout.write(`communities=${viz.communities.length} gaps=${payload.gaps.length} surprising=${payload.surprisingConnections.length}
+      if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(payload, null, 2)}
 `);
+      else {
+        process.stdout.write(
+          `communities=${viz.communities.length} gaps=${payload.gaps.length} surprising=${payload.surprisingConnections.length}
+`
+        );
       }
       return 0;
     }
@@ -259,12 +299,15 @@ ${HELP}`);
 }
 async function loadOrBuildIndex(root) {
   const path = join(layoutFor(root).cacheDir, "index.json");
-  if (existsSync(path)) return JSON.parse(readFileSync(path, "utf8"));
+  if (existsSync(path))
+    return JSON.parse(readFileSync(path, "utf8"));
   return await writeKnowledgeIndex(root);
 }
 main().then((code) => process.exit(code)).catch((err) => {
-  process.stderr.write(`agent-knowledge error: ${err instanceof Error ? err.stack ?? err.message : String(err)}
-`);
+  process.stderr.write(
+    `agent-knowledge error: ${err instanceof Error ? err.stack ?? err.message : String(err)}
+`
+  );
   process.exit(1);
 });
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync, readFileSync } from 'node:fs'\nimport { join, resolve } from 'node:path'\n\nimport { buildKnowledgeIndex, writeKnowledgeIndex } from './indexer'\nimport { explainKnowledgeTarget, inspectKnowledgeIndex } from './inspect'\nimport { lintKnowledgeIndex } from './lint'\nimport { applyKnowledgeWriteBlocksFile } from './proposals'\nimport { searchKnowledge } from './search'\nimport { addSourcePath, loadSourceRegistry } from './sources'\nimport { initKnowledgeBase, layoutFor } from './store'\nimport { validateKnowledgeIndex } from './validate'\nimport { detectKnowledgeGaps, findSurprisingConnections, toKnowledgeVizGraph } from './viz/index'\n\ninterface Args {\n  command: string\n  positional: string[]\n  flags: Record<string, string>\n}\n\nfunction parseArgs(argv: string[]): Args {\n  const [command, ...rest] = argv\n  const positional: string[] = []\n  const flags: Record<string, string> = {}\n  for (let i = 0; i < rest.length; i++) {\n    const token = rest[i]!\n    if (token.startsWith('--')) {\n      const key = token.slice(2)\n      const next = rest[i + 1]\n      if (next && !next.startsWith('--')) {\n        flags[key] = next\n        i++\n      } else {\n        flags[key] = 'true'\n      }\n    } else {\n      positional.push(token)\n    }\n  }\n  return { command: command ?? 'help', positional, flags }\n}\n\nconst HELP = `agent-knowledge — source-grounded knowledge graph CLI.\n\nCommands:\n  init [--root .]\n      Create raw/sources, knowledge, and cache directories.\n  index [--root .] [--json]\n      Build .agent-knowledge/index.json from knowledge/**/*.md.\n  source-add <path> [--root .] [--json]\n      Copy a file or directory into raw/sources and register immutable source records.\n  sources [--root .] [--json]\n      List registered sources.\n  apply-write-blocks <proposal-file> [--root .] [--json]\n      Apply safe ---FILE: knowledge/...--- blocks emitted by an agent.\n  inspect [--root .] [--json]\n      Summarize page/source/edge counts, top pages, and lint state.\n  explain <page|id|query> [--root .] [--json]\n      Explain sources, links, inbound links, and related pages.\n  search <query> [--root .] [--limit 10] [--json]\n      Fast local token+graph search over the generated knowledge index.\n  graph [--root .] [--format summary|json]\n      Emit graph summary or JSON.\n  lint [--root .] [--json]\n      Run deterministic structural lint.\n  validate [--root .] [--strict] [--json]\n      Run schema + lint validation. Exits non-zero on blocking findings.\n  export [--root .] [--format json]\n      Export the current index.\n  viz [--root .] [--json]\n      Emit graph gaps and surprising connections.\n  version\n      Print package version.\n`\n\nasync function main(): Promise<number> {\n  const args = parseArgs(process.argv.slice(2))\n  const root = resolve(args.flags.root ?? '.')\n  switch (args.command) {\n    case 'init': {\n      const layout = await initKnowledgeBase(root)\n      process.stdout.write(`initialized knowledge base at ${layout.root}\\n`)\n      return 0\n    }\n    case 'index': {\n      const index = await writeKnowledgeIndex(root)\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(index, null, 2) + '\\n')\n      else process.stdout.write(`indexed ${index.pages.length} pages, ${index.graph.edges.length} edges\\n`)\n      return 0\n    }\n    case 'source-add': {\n      const [path] = args.positional\n      if (!path) {\n        process.stderr.write('source-add requires a file or directory path\\n')\n        return 1\n      }\n      await initKnowledgeBase(root)\n      const sources = await addSourcePath(root, resolve(path))\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(sources, null, 2) + '\\n')\n      else for (const source of sources) process.stdout.write(`${source.id} ${source.uri}\\n`)\n      return 0\n    }\n    case 'sources': {\n      const registry = await loadSourceRegistry(root)\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(registry.sources, null, 2) + '\\n')\n      else {\n        for (const source of registry.sources) process.stdout.write(`${source.id} ${source.title ?? source.uri} ${source.uri}\\n`)\n      }\n      return 0\n    }\n    case 'apply-write-blocks': {\n      const [proposalPath] = args.positional\n      if (!proposalPath) {\n        process.stderr.write('apply-write-blocks requires a proposal file\\n')\n        return 1\n      }\n      await initKnowledgeBase(root)\n      const result = await applyKnowledgeWriteBlocksFile(root, resolve(proposalPath))\n      await writeKnowledgeIndex(root)\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(result, null, 2) + '\\n')\n      else {\n        for (const path of result.written) process.stdout.write(`wrote ${path}\\n`)\n        for (const warning of result.warnings) process.stderr.write(`warning: ${warning}\\n`)\n      }\n      return result.warnings.length > 0 ? 2 : 0\n    }\n    case 'inspect': {\n      const index = await loadOrBuildIndex(root)\n      const inspection = inspectKnowledgeIndex(index)\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(inspection, null, 2) + '\\n')\n      else {\n        process.stdout.write(`pages=${inspection.pageCount} sources=${inspection.sourceCount} edges=${inspection.edgeCount} findings=${inspection.findingCount} blocking=${inspection.blockingFindingCount}\\n`)\n        for (const page of inspection.topPages.slice(0, 5)) process.stdout.write(`${page.degree} ${page.path} sources=${page.sources}\\n`)\n      }\n      return inspection.blockingFindingCount > 0 ? 2 : 0\n    }\n    case 'explain': {\n      const target = args.positional.join(' ')\n      if (!target) {\n        process.stderr.write('explain requires a page path, id, title, or query\\n')\n        return 1\n      }\n      const explanation = explainKnowledgeTarget(await loadOrBuildIndex(root), target)\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(explanation, null, 2) + '\\n')\n      else {\n        process.stdout.write(`${explanation.page ? explanation.page.title : target}\\n`)\n        for (const source of explanation.sources) process.stdout.write(`source ${source.id} ${source.title ?? source.uri}\\n`)\n        for (const link of explanation.links) process.stdout.write(`out ${link}\\n`)\n        for (const inbound of explanation.inbound) process.stdout.write(`in ${inbound}\\n`)\n        for (const related of explanation.related.slice(0, 5)) process.stdout.write(`related ${related.path} score=${related.score.toFixed(5)}\\n`)\n      }\n      return 0\n    }\n    case 'search': {\n      const query = args.positional.join(' ')\n      if (!query) {\n        process.stderr.write('search requires a query\\n')\n        return 1\n      }\n      const index = await loadOrBuildIndex(root)\n      const results = searchKnowledge(index, query, Number(args.flags.limit ?? 10))\n      if (args.flags.json === 'true') {\n        process.stdout.write(JSON.stringify(results, null, 2) + '\\n')\n      } else {\n        for (const result of results) {\n          process.stdout.write(`${result.rank}. ${result.page.title} (${result.page.path}) score=${result.score.toFixed(5)}\\n`)\n          if (result.snippet) process.stdout.write(`   ${result.snippet}\\n`)\n        }\n      }\n      return 0\n    }\n    case 'graph': {\n      const index = await loadOrBuildIndex(root)\n      if ((args.flags.format ?? 'summary') === 'json') process.stdout.write(JSON.stringify(index.graph, null, 2) + '\\n')\n      else process.stdout.write(`nodes=${index.graph.nodes.length} edges=${index.graph.edges.length}\\n`)\n      return 0\n    }\n    case 'lint': {\n      const index = await loadOrBuildIndex(root)\n      const findings = lintKnowledgeIndex(index)\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(findings, null, 2) + '\\n')\n      else {\n        if (findings.length === 0) process.stdout.write('no findings\\n')\n        for (const finding of findings) {\n          process.stdout.write(`${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ''}: ${finding.message}\\n`)\n        }\n      }\n      return findings.some((finding) => finding.severity === 'error') ? 2 : 0\n    }\n    case 'validate': {\n      const result = validateKnowledgeIndex(await loadOrBuildIndex(root), { strict: args.flags.strict === 'true' })\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(result, null, 2) + '\\n')\n      else {\n        process.stdout.write(result.ok ? 'valid\\n' : 'invalid\\n')\n        for (const finding of result.findings) process.stdout.write(`${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ''}: ${finding.message}\\n`)\n      }\n      return result.ok ? 0 : 2\n    }\n    case 'export': {\n      const index = await loadOrBuildIndex(root)\n      const format = args.flags.format ?? 'json'\n      if (format !== 'json') {\n        process.stderr.write('export currently supports --format json\\n')\n        return 1\n      }\n      process.stdout.write(JSON.stringify(index, null, 2) + '\\n')\n      return 0\n    }\n    case 'viz': {\n      const index = await loadOrBuildIndex(root)\n      const viz = toKnowledgeVizGraph(index.graph)\n      const payload = {\n        graph: viz,\n        gaps: detectKnowledgeGaps(viz),\n        surprisingConnections: findSurprisingConnections(viz),\n      }\n      if (args.flags.json === 'true') process.stdout.write(JSON.stringify(payload, null, 2) + '\\n')\n      else {\n        process.stdout.write(`communities=${viz.communities.length} gaps=${payload.gaps.length} surprising=${payload.surprisingConnections.length}\\n`)\n      }\n      return 0\n    }\n    case 'version': {\n      const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as { version: string }\n      process.stdout.write(`${pkg.version}\\n`)\n      return 0\n    }\n    case 'help':\n    case '--help':\n    case '-h':\n      process.stdout.write(HELP)\n      return 0\n    default:\n      process.stderr.write(`unknown command: ${args.command}\\n${HELP}`)\n      return 1\n  }\n}\n\nasync function loadOrBuildIndex(root: string) {\n  const path = join(layoutFor(root).cacheDir, 'index.json')\n  if (existsSync(path)) return JSON.parse(readFileSync(path, 'utf8')) as Awaited<ReturnType<typeof buildKnowledgeIndex>>\n  return await writeKnowledgeIndex(root)\n}\n\nmain()\n  .then((code) => process.exit(code))\n  .catch((err) => {\n    process.stderr.write(`agent-knowledge error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\\n`)\n    process.exit(1)\n  })\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync, readFileSync } from 'node:fs'\nimport { join, resolve } from 'node:path'\n\nimport { type buildKnowledgeIndex, writeKnowledgeIndex } from './indexer'\nimport { explainKnowledgeTarget, inspectKnowledgeIndex } from './inspect'\nimport { lintKnowledgeIndex } from './lint'\nimport { applyKnowledgeWriteBlocksFile } from './proposals'\nimport { searchKnowledge } from './search'\nimport { addSourcePath, loadSourceRegistry } from './sources'\nimport { initKnowledgeBase, layoutFor } from './store'\nimport { validateKnowledgeIndex } from './validate'\nimport { detectKnowledgeGaps, findSurprisingConnections, toKnowledgeVizGraph } from './viz/index'\n\ninterface Args {\n  command: string\n  positional: string[]\n  flags: Record<string, string>\n}\n\nfunction parseArgs(argv: string[]): Args {\n  const [command, ...rest] = argv\n  const positional: string[] = []\n  const flags: Record<string, string> = {}\n  for (let i = 0; i < rest.length; i++) {\n    const token = rest[i]!\n    if (token.startsWith('--')) {\n      const key = token.slice(2)\n      const next = rest[i + 1]\n      if (next && !next.startsWith('--')) {\n        flags[key] = next\n        i++\n      } else {\n        flags[key] = 'true'\n      }\n    } else {\n      positional.push(token)\n    }\n  }\n  return { command: command ?? 'help', positional, flags }\n}\n\nconst HELP = `agent-knowledge — source-grounded knowledge graph CLI.\n\nCommands:\n  init [--root .]\n      Create raw/sources, knowledge, and cache directories.\n  index [--root .] [--json]\n      Build .agent-knowledge/index.json from knowledge/**/*.md.\n  source-add <path> [--root .] [--json]\n      Copy a file or directory into raw/sources and register immutable source records.\n  sources [--root .] [--json]\n      List registered sources.\n  apply-write-blocks <proposal-file> [--root .] [--json]\n      Apply safe ---FILE: knowledge/...--- blocks emitted by an agent.\n  inspect [--root .] [--json]\n      Summarize page/source/edge counts, top pages, and lint state.\n  explain <page|id|query> [--root .] [--json]\n      Explain sources, links, inbound links, and related pages.\n  search <query> [--root .] [--limit 10] [--json]\n      Fast local token+graph search over the generated knowledge index.\n  graph [--root .] [--format summary|json]\n      Emit graph summary or JSON.\n  lint [--root .] [--json]\n      Run deterministic structural lint.\n  validate [--root .] [--strict] [--json]\n      Run schema + lint validation. Exits non-zero on blocking findings.\n  export [--root .] [--format json]\n      Export the current index.\n  viz [--root .] [--json]\n      Emit graph gaps and surprising connections.\n  version\n      Print package version.\n`\n\nasync function main(): Promise<number> {\n  const args = parseArgs(process.argv.slice(2))\n  const root = resolve(args.flags.root ?? '.')\n  switch (args.command) {\n    case 'init': {\n      const layout = await initKnowledgeBase(root)\n      process.stdout.write(`initialized knowledge base at ${layout.root}\\n`)\n      return 0\n    }\n    case 'index': {\n      const index = await writeKnowledgeIndex(root)\n      if (args.flags.json === 'true') process.stdout.write(`${JSON.stringify(index, null, 2)}\\n`)\n      else\n        process.stdout.write(\n          `indexed ${index.pages.length} pages, ${index.graph.edges.length} edges\\n`,\n        )\n      return 0\n    }\n    case 'source-add': {\n      const [path] = args.positional\n      if (!path) {\n        process.stderr.write('source-add requires a file or directory path\\n')\n        return 1\n      }\n      await initKnowledgeBase(root)\n      const sources = await addSourcePath(root, resolve(path))\n      if (args.flags.json === 'true') process.stdout.write(`${JSON.stringify(sources, null, 2)}\\n`)\n      else for (const source of sources) process.stdout.write(`${source.id} ${source.uri}\\n`)\n      return 0\n    }\n    case 'sources': {\n      const registry = await loadSourceRegistry(root)\n      if (args.flags.json === 'true')\n        process.stdout.write(`${JSON.stringify(registry.sources, null, 2)}\\n`)\n      else {\n        for (const source of registry.sources)\n          process.stdout.write(`${source.id} ${source.title ?? source.uri} ${source.uri}\\n`)\n      }\n      return 0\n    }\n    case 'apply-write-blocks': {\n      const [proposalPath] = args.positional\n      if (!proposalPath) {\n        process.stderr.write('apply-write-blocks requires a proposal file\\n')\n        return 1\n      }\n      await initKnowledgeBase(root)\n      const result = await applyKnowledgeWriteBlocksFile(root, resolve(proposalPath))\n      await writeKnowledgeIndex(root)\n      if (args.flags.json === 'true') process.stdout.write(`${JSON.stringify(result, null, 2)}\\n`)\n      else {\n        for (const path of result.written) process.stdout.write(`wrote ${path}\\n`)\n        for (const warning of result.warnings) process.stderr.write(`warning: ${warning}\\n`)\n      }\n      return result.warnings.length > 0 ? 2 : 0\n    }\n    case 'inspect': {\n      const index = await loadOrBuildIndex(root)\n      const inspection = inspectKnowledgeIndex(index)\n      if (args.flags.json === 'true')\n        process.stdout.write(`${JSON.stringify(inspection, null, 2)}\\n`)\n      else {\n        process.stdout.write(\n          `pages=${inspection.pageCount} sources=${inspection.sourceCount} edges=${inspection.edgeCount} findings=${inspection.findingCount} blocking=${inspection.blockingFindingCount}\\n`,\n        )\n        for (const page of inspection.topPages.slice(0, 5))\n          process.stdout.write(`${page.degree} ${page.path} sources=${page.sources}\\n`)\n      }\n      return inspection.blockingFindingCount > 0 ? 2 : 0\n    }\n    case 'explain': {\n      const target = args.positional.join(' ')\n      if (!target) {\n        process.stderr.write('explain requires a page path, id, title, or query\\n')\n        return 1\n      }\n      const explanation = explainKnowledgeTarget(await loadOrBuildIndex(root), target)\n      if (args.flags.json === 'true')\n        process.stdout.write(`${JSON.stringify(explanation, null, 2)}\\n`)\n      else {\n        process.stdout.write(`${explanation.page ? explanation.page.title : target}\\n`)\n        for (const source of explanation.sources)\n          process.stdout.write(`source ${source.id} ${source.title ?? source.uri}\\n`)\n        for (const link of explanation.links) process.stdout.write(`out ${link}\\n`)\n        for (const inbound of explanation.inbound) process.stdout.write(`in ${inbound}\\n`)\n        for (const related of explanation.related.slice(0, 5))\n          process.stdout.write(`related ${related.path} score=${related.score.toFixed(5)}\\n`)\n      }\n      return 0\n    }\n    case 'search': {\n      const query = args.positional.join(' ')\n      if (!query) {\n        process.stderr.write('search requires a query\\n')\n        return 1\n      }\n      const index = await loadOrBuildIndex(root)\n      const results = searchKnowledge(index, query, Number(args.flags.limit ?? 10))\n      if (args.flags.json === 'true') {\n        process.stdout.write(`${JSON.stringify(results, null, 2)}\\n`)\n      } else {\n        for (const result of results) {\n          process.stdout.write(\n            `${result.rank}. ${result.page.title} (${result.page.path}) score=${result.score.toFixed(5)}\\n`,\n          )\n          if (result.snippet) process.stdout.write(`   ${result.snippet}\\n`)\n        }\n      }\n      return 0\n    }\n    case 'graph': {\n      const index = await loadOrBuildIndex(root)\n      if ((args.flags.format ?? 'summary') === 'json')\n        process.stdout.write(`${JSON.stringify(index.graph, null, 2)}\\n`)\n      else\n        process.stdout.write(\n          `nodes=${index.graph.nodes.length} edges=${index.graph.edges.length}\\n`,\n        )\n      return 0\n    }\n    case 'lint': {\n      const index = await loadOrBuildIndex(root)\n      const findings = lintKnowledgeIndex(index)\n      if (args.flags.json === 'true') process.stdout.write(`${JSON.stringify(findings, null, 2)}\\n`)\n      else {\n        if (findings.length === 0) process.stdout.write('no findings\\n')\n        for (const finding of findings) {\n          process.stdout.write(\n            `${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ''}: ${finding.message}\\n`,\n          )\n        }\n      }\n      return findings.some((finding) => finding.severity === 'error') ? 2 : 0\n    }\n    case 'validate': {\n      const result = validateKnowledgeIndex(await loadOrBuildIndex(root), {\n        strict: args.flags.strict === 'true',\n      })\n      if (args.flags.json === 'true') process.stdout.write(`${JSON.stringify(result, null, 2)}\\n`)\n      else {\n        process.stdout.write(result.ok ? 'valid\\n' : 'invalid\\n')\n        for (const finding of result.findings)\n          process.stdout.write(\n            `${finding.severity.toUpperCase()} ${finding.type}${finding.page ? ` ${finding.page}` : ''}: ${finding.message}\\n`,\n          )\n      }\n      return result.ok ? 0 : 2\n    }\n    case 'export': {\n      const index = await loadOrBuildIndex(root)\n      const format = args.flags.format ?? 'json'\n      if (format !== 'json') {\n        process.stderr.write('export currently supports --format json\\n')\n        return 1\n      }\n      process.stdout.write(`${JSON.stringify(index, null, 2)}\\n`)\n      return 0\n    }\n    case 'viz': {\n      const index = await loadOrBuildIndex(root)\n      const viz = toKnowledgeVizGraph(index.graph)\n      const payload = {\n        graph: viz,\n        gaps: detectKnowledgeGaps(viz),\n        surprisingConnections: findSurprisingConnections(viz),\n      }\n      if (args.flags.json === 'true') process.stdout.write(`${JSON.stringify(payload, null, 2)}\\n`)\n      else {\n        process.stdout.write(\n          `communities=${viz.communities.length} gaps=${payload.gaps.length} surprising=${payload.surprisingConnections.length}\\n`,\n        )\n      }\n      return 0\n    }\n    case 'version': {\n      const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as {\n        version: string\n      }\n      process.stdout.write(`${pkg.version}\\n`)\n      return 0\n    }\n    case 'help':\n    case '--help':\n    case '-h':\n      process.stdout.write(HELP)\n      return 0\n    default:\n      process.stderr.write(`unknown command: ${args.command}\\n${HELP}`)\n      return 1\n  }\n}\n\nasync function loadOrBuildIndex(root: string) {\n  const path = join(layoutFor(root).cacheDir, 'index.json')\n  if (existsSync(path))\n    return JSON.parse(readFileSync(path, 'utf8')) as Awaited<ReturnType<typeof buildKnowledgeIndex>>\n  return await writeKnowledgeIndex(root)\n}\n\nmain()\n  .then((code) => process.exit(code))\n  .catch((err) => {\n    process.stderr.write(\n      `agent-knowledge error: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\\n`,\n    )\n    process.exit(1)\n  })\n"],"mappings":"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","names":[]}