@tangle-network/agent-knowledge 5.0.4 → 6.1.0

package/dist/cli.js

@@ -1,51 +1,32 @@
 #!/usr/bin/env node
-import {
-  addSourcePath,
-  applyKnowledgeWriteBlocksFile,
-  explainKnowledgeTarget,
-  initKnowledgeBase,
-  inspectKnowledgeIndex,
-  layoutFor,
-  lintKnowledgeIndex,
-  loadSourceRegistry,
-  validateKnowledgeIndex,
-  writeKnowledgeIndex
-} from "./chunk-AKYJG2MR.js";
-import {
-  detectKnowledgeGaps,
-  findSurprisingConnections,
-  toKnowledgeVizGraph
-} from "./chunk-4PNXQ2NT.js";
-import {
-  searchKnowledge
-} from "./chunk-DQ3PDMDP.js";
-import "./chunk-YMKHCTS2.js";
-
-// src/cli.ts
-import { existsSync, readFileSync } from "fs";
-import { join, resolve } from "path";
+import { D as initKnowledgeBase, a as applyKnowledgeWriteBlocksFile, c as validateKnowledgeIndex, d as writeKnowledgeIndex, f as addSourcePath, k as layoutFor, l as lintKnowledgeIndex, m as loadSourceRegistry, n as inspectKnowledgeIndex, t as explainKnowledgeTarget } from "./inspect-D5iarJc2.js";
+import { n as searchKnowledge } from "./search-CP0QtBJZ.js";
+import { detectKnowledgeGaps, findSurprisingConnections, toKnowledgeVizGraph } from "./viz/index.js";
+import { join, resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+//#region src/cli.ts
 function parseArgs(argv) {
-  const [command, ...rest] = argv;
-  const positional = [];
-  const flags = {};
-  for (let i = 0; i < rest.length; i++) {
-    const token = rest[i];
-    if (token.startsWith("--")) {
-      const key = token.slice(2);
-      const next = rest[i + 1];
-      if (next && !next.startsWith("--")) {
-        flags[key] = next;
-        i++;
-      } else {
-        flags[key] = "true";
-      }
-    } else {
-      positional.push(token);
-    }
-  }
-  return { command: command ?? "help", positional, flags };
+	const [command, ...rest] = argv;
+	const positional = [];
+	const flags = {};
+	for (let i = 0; i < rest.length; i++) {
+		const token = rest[i];
+		if (token.startsWith("--")) {
+			const key = token.slice(2);
+			const next = rest[i + 1];
+			if (next && !next.startsWith("--")) {
+				flags[key] = next;
+				i++;
+			} else flags[key] = "true";
+		} else positional.push(token);
+	}
+	return {
+		command: command ?? "help",
+		positional,
+		flags
+	};
 }
-var HELP = `agent-knowledge \u2014 source-grounded knowledge graph CLI.
+const HELP = `agent-knowledge — source-grounded knowledge graph CLI.
 
 Commands:
   init [--root .]
@@ -78,238 +59,163 @@ Commands:
       Print package version.
 `;
 async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const root = resolve(args.flags.root ?? ".");
-  switch (args.command) {
-    case "init": {
-      const layout = await initKnowledgeBase(root);
-      process.stdout.write(`initialized knowledge base at ${layout.root}
-`);
-      return 0;
-    }
-    case "index": {
-      const index = await writeKnowledgeIndex(root);
-      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": {
-      const [path] = args.positional;
-      if (!path) {
-        process.stderr.write("source-add requires a file or directory path\n");
-        return 1;
-      }
-      await initKnowledgeBase(root);
-      const sources = await addSourcePath(root, resolve(path));
-      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)}
-`);
-      else {
-        for (const source of registry.sources)
-          process.stdout.write(`${source.id} ${source.title ?? source.uri} ${source.uri}
-`);
-      }
-      return 0;
-    }
-    case "apply-write-blocks": {
-      const [proposalPath] = args.positional;
-      if (!proposalPath) {
-        process.stderr.write("apply-write-blocks requires a proposal file\n");
-        return 1;
-      }
-      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)}
-`);
-      else {
-        for (const path of result.written) process.stdout.write(`wrote ${path}
-`);
-        for (const warning of result.warnings) process.stderr.write(`warning: ${warning}
-`);
-      }
-      return result.warnings.length > 0 ? 2 : 0;
-    }
-    case "inspect": {
-      const index = await loadOrBuildIndex(root);
-      const inspection = inspectKnowledgeIndex(index);
-      if (args.flags.json === "true")
-        process.stdout.write(`${JSON.stringify(inspection, null, 2)}
-`);
-      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;
-    }
-    case "explain": {
-      const target = args.positional.join(" ");
-      if (!target) {
-        process.stderr.write("explain requires a page path, id, title, or query\n");
-        return 1;
-      }
-      const explanation = explainKnowledgeTarget(await loadOrBuildIndex(root), target);
-      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 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)}
-`);
-      }
-      return 0;
-    }
-    case "search": {
-      const query = args.positional.join(" ");
-      if (!query) {
-        process.stderr.write("search requires a query\n");
-        return 1;
-      }
-      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)}
-`);
-      } else {
-        for (const result of results) {
-          process.stdout.write(
-            `${result.rank}. ${result.page.title} (${result.page.path}) score=${result.score.toFixed(5)}
-`
-          );
-          if (result.snippet) process.stdout.write(`   ${result.snippet}
-`);
-        }
-      }
-      return 0;
-    }
-    case "graph": {
-      const index = await loadOrBuildIndex(root);
-      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)}
-`);
-      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}
-`
-          );
-        }
-      }
-      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)}
-`);
-      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}
-`
-          );
-      }
-      return result.ok ? 0 : 2;
-    }
-    case "export": {
-      const index = await loadOrBuildIndex(root);
-      const format = args.flags.format ?? "json";
-      if (format !== "json") {
-        process.stderr.write("export currently supports --format json\n");
-        return 1;
-      }
-      process.stdout.write(`${JSON.stringify(index, null, 2)}
-`);
-      return 0;
-    }
-    case "viz": {
-      const index = await loadOrBuildIndex(root);
-      const viz = toKnowledgeVizGraph(index.graph);
-      const payload = {
-        graph: viz,
-        gaps: detectKnowledgeGaps(viz),
-        surprisingConnections: findSurprisingConnections(viz)
-      };
-      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;
-    }
-    case "version": {
-      const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
-      process.stdout.write(`${pkg.version}
-`);
-      return 0;
-    }
-    case "help":
-    case "--help":
-    case "-h":
-      process.stdout.write(HELP);
-      return 0;
-    default:
-      process.stderr.write(`unknown command: ${args.command}
-${HELP}`);
-      return 1;
-  }
+	const args = parseArgs(process.argv.slice(2));
+	const root = resolve(args.flags.root ?? ".");
+	switch (args.command) {
+		case "init": {
+			const layout = await initKnowledgeBase(root);
+			process.stdout.write(`initialized knowledge base at ${layout.root}\n`);
+			return 0;
+		}
+		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\n`);
+			return 0;
+		}
+		case "source-add": {
+			const [path] = args.positional;
+			if (!path) {
+				process.stderr.write("source-add requires a file or directory path\n");
+				return 1;
+			}
+			await initKnowledgeBase(root);
+			const sources = await addSourcePath(root, resolve(path));
+			if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(sources, null, 2)}\n`);
+			else for (const source of sources) process.stdout.write(`${source.id} ${source.uri}\n`);
+			return 0;
+		}
+		case "sources": {
+			const registry = await loadSourceRegistry(root);
+			if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(registry.sources, null, 2)}\n`);
+			else for (const source of registry.sources) process.stdout.write(`${source.id} ${source.title ?? source.uri} ${source.uri}\n`);
+			return 0;
+		}
+		case "apply-write-blocks": {
+			const [proposalPath] = args.positional;
+			if (!proposalPath) {
+				process.stderr.write("apply-write-blocks requires a proposal file\n");
+				return 1;
+			}
+			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`);
+			else {
+				for (const path of result.written) process.stdout.write(`wrote ${path}\n`);
+				for (const warning of result.warnings) process.stderr.write(`warning: ${warning}\n`);
+			}
+			return result.warnings.length > 0 ? 2 : 0;
+		}
+		case "inspect": {
+			const inspection = inspectKnowledgeIndex(await loadOrBuildIndex(root));
+			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}\n`);
+				for (const page of inspection.topPages.slice(0, 5)) process.stdout.write(`${page.degree} ${page.path} sources=${page.sources}\n`);
+			}
+			return inspection.blockingFindingCount > 0 ? 2 : 0;
+		}
+		case "explain": {
+			const target = args.positional.join(" ");
+			if (!target) {
+				process.stderr.write("explain requires a page path, id, title, or query\n");
+				return 1;
+			}
+			const explanation = explainKnowledgeTarget(await loadOrBuildIndex(root), target);
+			if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(explanation, null, 2)}\n`);
+			else {
+				process.stdout.write(`${explanation.page ? explanation.page.title : target}\n`);
+				for (const source of explanation.sources) process.stdout.write(`source ${source.id} ${source.title ?? source.uri}\n`);
+				for (const link of explanation.links) process.stdout.write(`out ${link}\n`);
+				for (const inbound of explanation.inbound) process.stdout.write(`in ${inbound}\n`);
+				for (const related of explanation.related.slice(0, 5)) process.stdout.write(`related ${related.path} score=${related.score.toFixed(5)}\n`);
+			}
+			return 0;
+		}
+		case "search": {
+			const query = args.positional.join(" ");
+			if (!query) {
+				process.stderr.write("search requires a query\n");
+				return 1;
+			}
+			const results = searchKnowledge(await loadOrBuildIndex(root), query, Number(args.flags.limit ?? 10));
+			if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(results, null, 2)}\n`);
+			else for (const result of results) {
+				process.stdout.write(`${result.rank}. ${result.page.title} (${result.page.path}) score=${result.score.toFixed(5)}\n`);
+				if (result.snippet) process.stdout.write(`   ${result.snippet}\n`);
+			}
+			return 0;
+		}
+		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}\n`);
+			return 0;
+		}
+		case "lint": {
+			const findings = lintKnowledgeIndex(await loadOrBuildIndex(root));
+			if (args.flags.json === "true") process.stdout.write(`${JSON.stringify(findings, null, 2)}\n`);
+			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}\n`);
+			}
+			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`);
+			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}\n`);
+			}
+			return result.ok ? 0 : 2;
+		}
+		case "export": {
+			const index = await loadOrBuildIndex(root);
+			if ((args.flags.format ?? "json") !== "json") {
+				process.stderr.write("export currently supports --format json\n");
+				return 1;
+			}
+			process.stdout.write(`${JSON.stringify(index, null, 2)}\n`);
+			return 0;
+		}
+		case "viz": {
+			const viz = toKnowledgeVizGraph((await loadOrBuildIndex(root)).graph);
+			const payload = {
+				graph: viz,
+				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}\n`);
+			return 0;
+		}
+		case "version": {
+			const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+			process.stdout.write(`${pkg.version}\n`);
+			return 0;
+		}
+		case "help":
+		case "--help":
+		case "-h":
+			process.stdout.write(HELP);
+			return 0;
+		default:
+			process.stderr.write(`unknown command: ${args.command}\n${HELP}`);
+			return 1;
+	}
 }
 async function loadOrBuildIndex(root) {
-  const path = join(layoutFor(root).cacheDir, "index.json");
-  if (existsSync(path))
-    return JSON.parse(readFileSync(path, "utf8"));
-  return await writeKnowledgeIndex(root);
+	const path = join(layoutFor(root).cacheDir, "index.json");
+	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.exit(1);
+	process.stderr.write(`agent-knowledge error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+	process.exit(1);
 });
+//#endregion
+export {};
+
 //# 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 { 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":[]}
+{"version":3,"file":"cli.js","names":[],"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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"}

package/dist/ids-DRqPZ42_.js

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

package/dist/ids-DRqPZ42_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids-DRqPZ42_.js","names":[],"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":";;AAEA,SAAgB,OAAO,MAAsB;CAC3C,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,KAAK;AACvD;AAEA,SAAgB,QAAQ,OAAuB;CAQ7C,OAPY,MACT,KAAK,CAAC,CACN,YAAY,CAAC,CACb,UAAU,MAAM,CAAC,CACjB,QAAQ,oBAAoB,EAAE,CAAC,CAC/B,QAAQ,4BAA4B,GAAG,CAAC,CACxC,QAAQ,YAAY,EACd,KAAK;AAChB;AAEA,SAAgB,SAAS,QAAgB,SAAyB;CAChE,OAAO,GAAG,OAAO,GAAG,OAAO,OAAO,CAAC,CAAC,MAAM,GAAG,EAAE;AACjD"}