@tangle-network/agent-knowledge 0.1.1 → 1.0.0

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 { 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  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 '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 { 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":[]}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { c as KnowledgeWriteParseResult, S as SourceRecord, d as KnowledgePage, e as SourceRegistry, b as KnowledgeGraph, f as KnowledgeIndex, g as KnowledgeSearchResult, h as KnowledgeLintFinding, i as KnowledgeBaseCandidate } from './types-C1FBNRIN.js';
-export { C as ClaimRef, j as KnowledgeClaim, K as KnowledgeGraphEdge, a as KnowledgeGraphNode, k as KnowledgeId, l as KnowledgePolicy, m as KnowledgeRelation, n as KnowledgeUnit, o as KnowledgeWriteBlock, p as SourceAnchor } from './types-C1FBNRIN.js';
-import { MultiShotVariant, MultiShotOptimizationConfig, MultiShotRunner, MultiShotScorer, MultiShotMutateAdapter, MultiShotOptimizationResult } from '@tangle-network/agent-eval';
+import { c as KnowledgeWriteParseResult, S as SourceRecord, d as KnowledgeEventType, e as KnowledgeEvent, f as KnowledgePage, g as KnowledgeIndex, h as SourceRegistry, b as KnowledgeGraph, i as KnowledgeSearchResult, j as KnowledgeLintFinding, k as KnowledgeBaseCandidate, l as KnowledgeRelease } from './types-CFylueZb.js';
+export { C as ClaimRef, m as KnowledgeClaim, K as KnowledgeGraphEdge, a as KnowledgeGraphNode, n as KnowledgeId, o as KnowledgePolicy, p as KnowledgeRelation, q as KnowledgeUnit, r as KnowledgeWriteBlock, s as SourceAnchor } from './types-CFylueZb.js';
+import { z } from 'zod';
+import { MultiShotVariant, MultiShotOptimizationConfig, MultiShotRunner, MultiShotScorer, MultiShotMutateAdapter, MultiShotOptimizationResult, ReleaseConfidenceScorecard, RunRecord } from '@tangle-network/agent-eval';
 
 declare function sha256(text: string): string;
 declare function slugify(input: string): string;
@@ -48,6 +49,255 @@ interface ApplyWriteBlocksResult {
 declare function applyKnowledgeWriteBlocks(root: string, proposalText: string): Promise<ApplyWriteBlocksResult>;
 declare function applyKnowledgeWriteBlocksFile(root: string, proposalPath: string): Promise<ApplyWriteBlocksResult>;
 
+declare const SourceAnchorSchema: z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    lineStart: z.ZodOptional<z.ZodNumber>;
+    lineEnd: z.ZodOptional<z.ZodNumber>;
+    charStart: z.ZodOptional<z.ZodNumber>;
+    charEnd: z.ZodOptional<z.ZodNumber>;
+    timestampMs: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const SourceRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    uri: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sourceId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        page: z.ZodOptional<z.ZodNumber>;
+        lineStart: z.ZodOptional<z.ZodNumber>;
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+        charStart: z.ZodOptional<z.ZodNumber>;
+        charEnd: z.ZodOptional<z.ZodNumber>;
+        timestampMs: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+declare const KnowledgePageSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    title: z.ZodString;
+    text: z.ZodString;
+    frontmatter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    sourceIds: z.ZodArray<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    outLinks: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const KnowledgeGraphNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    path: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    sourceIds: z.ZodArray<z.ZodString>;
+    outDegree: z.ZodNumber;
+    inDegree: z.ZodNumber;
+}, z.core.$strip>;
+declare const KnowledgeGraphEdgeSchema: z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    weight: z.ZodNumber;
+    reasons: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const KnowledgeIndexSchema: z.ZodObject<{
+    root: z.ZodString;
+    generatedAt: z.ZodString;
+    sources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        uri: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        mediaType: z.ZodOptional<z.ZodString>;
+        contentHash: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sourceId: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            page: z.ZodOptional<z.ZodNumber>;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+            charStart: z.ZodOptional<z.ZodNumber>;
+            charEnd: z.ZodOptional<z.ZodNumber>;
+            timestampMs: z.ZodOptional<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    pages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        title: z.ZodString;
+        text: z.ZodString;
+        frontmatter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        sourceIds: z.ZodArray<z.ZodString>;
+        tags: z.ZodArray<z.ZodString>;
+        outLinks: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    graph: z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            path: z.ZodString;
+            tags: z.ZodArray<z.ZodString>;
+            sourceIds: z.ZodArray<z.ZodString>;
+            outDegree: z.ZodNumber;
+            inDegree: z.ZodNumber;
+        }, z.core.$strip>>;
+        edges: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            target: z.ZodString;
+            weight: z.ZodNumber;
+            reasons: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const KnowledgeEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        "source.added": "source.added";
+        "proposal.applied": "proposal.applied";
+        "index.built": "index.built";
+        "lint.run": "lint.run";
+        "optimization.run": "optimization.run";
+        "release.promoted": "release.promoted";
+        "release.rejected": "release.rejected";
+    }>;
+    createdAt: z.ZodString;
+    actor: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const KnowledgeBaseCandidateSchema: z.ZodObject<{
+    id: z.ZodString;
+    units: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        text: z.ZodString;
+        claims: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            refs: z.ZodArray<z.ZodObject<{
+                sourceId: z.ZodString;
+                anchorId: z.ZodOptional<z.ZodString>;
+                quote: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            status: z.ZodOptional<z.ZodEnum<{
+                draft: "draft";
+                active: "active";
+                superseded: "superseded";
+                rejected: "rejected";
+            }>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            sourceId: z.ZodString;
+            targetId: z.ZodString;
+            predicate: z.ZodString;
+            weight: z.ZodOptional<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        sourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    retrievalPolicy: z.ZodOptional<z.ZodString>;
+    synthesisPolicy: z.ZodOptional<z.ZodString>;
+    questionPolicy: z.ZodOptional<z.ZodString>;
+    updatePolicy: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+
+interface KnowledgeEventQuery {
+    type?: KnowledgeEventType;
+    target?: string;
+    limit?: number;
+}
+declare function createKnowledgeEvent(input: {
+    type: KnowledgeEventType;
+    actor?: string;
+    target?: string;
+    metadata?: Record<string, unknown>;
+    now?: () => Date;
+}): KnowledgeEvent;
+
+interface KbStore {
+    putSource(source: SourceRecord): Promise<void>;
+    getSource(id: string): Promise<SourceRecord | null>;
+    listSources(): Promise<SourceRecord[]>;
+    putPage(page: KnowledgePage): Promise<void>;
+    getPage(idOrPath: string): Promise<KnowledgePage | null>;
+    listPages(): Promise<KnowledgePage[]>;
+    putIndex(index: KnowledgeIndex): Promise<void>;
+    getIndex(): Promise<KnowledgeIndex | null>;
+    putEvent(event: KnowledgeEvent): Promise<void>;
+    listEvents(query?: KnowledgeEventQuery): Promise<KnowledgeEvent[]>;
+}
+declare class MemoryKbStore implements KbStore {
+    private readonly sources;
+    private readonly pages;
+    private readonly events;
+    private index;
+    putSource(source: SourceRecord): Promise<void>;
+    getSource(id: string): Promise<SourceRecord | null>;
+    listSources(): Promise<SourceRecord[]>;
+    putPage(page: KnowledgePage): Promise<void>;
+    getPage(idOrPath: string): Promise<KnowledgePage | null>;
+    listPages(): Promise<KnowledgePage[]>;
+    putIndex(index: KnowledgeIndex): Promise<void>;
+    getIndex(): Promise<KnowledgeIndex | null>;
+    putEvent(event: KnowledgeEvent): Promise<void>;
+    listEvents(query?: KnowledgeEventQuery): Promise<KnowledgeEvent[]>;
+}
+declare class FileSystemKbStore extends MemoryKbStore {
+    private readonly dir;
+    constructor(dir: string);
+    putIndex(index: KnowledgeIndex): Promise<void>;
+    getIndex(): Promise<KnowledgeIndex | null>;
+    putEvent(event: KnowledgeEvent): Promise<void>;
+}
+
+interface DiscoveryTask {
+    id: string;
+    goal: string;
+    query?: string;
+    sourceHints?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface DiscoveryResult {
+    taskId: string;
+    summary: string;
+    sourceUris?: string[];
+    claims?: Array<{
+        text: string;
+        sourceUri?: string;
+        confidence?: number;
+    }>;
+    followUpTasks?: DiscoveryTask[];
+    metadata?: Record<string, unknown>;
+}
+interface KnowledgeDiscoveryWorker {
+    run(task: DiscoveryTask, signal?: AbortSignal): Promise<DiscoveryResult> | DiscoveryResult;
+}
+interface KnowledgeDiscoveryDispatcher {
+    dispatch(tasks: DiscoveryTask[], options?: {
+        concurrency?: number;
+        signal?: AbortSignal;
+    }): Promise<DiscoveryResult[]>;
+}
+declare function createLocalDiscoveryDispatcher(worker: KnowledgeDiscoveryWorker): KnowledgeDiscoveryDispatcher;
+
 interface ChunkingOptions {
     targetChars: number;
     maxChars: number;
@@ -136,6 +386,15 @@ interface KnowledgeExplanation {
 }
 declare function explainKnowledgeTarget(index: KnowledgeIndex, target: string): KnowledgeExplanation;
 
+interface ValidateKnowledgeOptions {
+    strict?: boolean;
+}
+interface ValidateKnowledgeResult {
+    ok: boolean;
+    findings: KnowledgeLintFinding[];
+}
+declare function validateKnowledgeIndex(index: KnowledgeIndex, options?: ValidateKnowledgeOptions): ValidateKnowledgeResult;
+
 type KnowledgeBaseVariant = MultiShotVariant<KnowledgeBaseCandidate>;
 interface KnowledgeOptimizationConfig extends Omit<MultiShotOptimizationConfig<KnowledgeBaseCandidate>, 'runner' | 'scorer' | 'mutateAdapter' | 'target'> {
     target?: string;
@@ -150,4 +409,16 @@ declare function knowledgeVariantFromCandidate(candidate: KnowledgeBaseCandidate
     generation?: number;
 }): KnowledgeBaseVariant;
 
-export { type AddSourceOptions, type ApplyWriteBlocksResult, type ChunkingOptions, KnowledgeBaseCandidate, type KnowledgeBaseVariant, type KnowledgeChunk, type KnowledgeExplanation, KnowledgeGraph, KnowledgeIndex, type KnowledgeInspection, type KnowledgeLayout, KnowledgeLintFinding, type KnowledgeOptimizationConfig, KnowledgePage, KnowledgeSearchResult, KnowledgeWriteParseResult, type ParsedFrontmatter, type SourceAdapter, type SourceAdapterInput, type SourceAdapterOutput, SourceRecord, SourceRegistry, WIKILINK_REGEX, addSourcePath, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, buildKnowledgeGraph, buildKnowledgeIndex, chunkMarkdown, explainKnowledgeTarget, extractWikilinks, formatFrontmatter, initKnowledgeBase, inspectKnowledgeIndex, isSafeKnowledgePath, knowledgeVariantFromCandidate, layoutFor, lintKnowledgeIndex, loadKnowledgePages, loadSourceRegistry, mediaTypeFor, normalizeLinkTarget, parseFrontmatter, parseKnowledgeWriteBlocks, reciprocalRankFusion, runKnowledgeBaseOptimization, searchKnowledge, sha256, slugify, sourceRegistryPath, stableId, stripFrontmatter, textSourceAdapter, tokenizeQuery, writeJson, writeKnowledgeIndex, writeSourceRegistry };
+interface KnowledgeReleaseReport {
+    release: KnowledgeRelease;
+    scorecard: ReleaseConfidenceScorecard;
+    candidateRuns: RunRecord[];
+    baselineRuns: RunRecord[];
+}
+declare function knowledgeReleaseReportFromOptimization(result: MultiShotOptimizationResult<KnowledgeBaseCandidate>, options?: {
+    runRecords?: RunRecord[];
+    createdAt?: string;
+    minScore?: number;
+}): KnowledgeReleaseReport;
+
+export { type AddSourceOptions, type ApplyWriteBlocksResult, type ChunkingOptions, type DiscoveryResult, type DiscoveryTask, FileSystemKbStore, type KbStore, KnowledgeBaseCandidate, KnowledgeBaseCandidateSchema, type KnowledgeBaseVariant, type KnowledgeChunk, type KnowledgeDiscoveryDispatcher, type KnowledgeDiscoveryWorker, KnowledgeEvent, type KnowledgeEventQuery, KnowledgeEventSchema, KnowledgeEventType, type KnowledgeExplanation, KnowledgeGraph, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeIndex, KnowledgeIndexSchema, type KnowledgeInspection, type KnowledgeLayout, KnowledgeLintFinding, type KnowledgeOptimizationConfig, KnowledgePage, KnowledgePageSchema, KnowledgeRelease, type KnowledgeReleaseReport, KnowledgeSearchResult, KnowledgeWriteParseResult, MemoryKbStore, type ParsedFrontmatter, type SourceAdapter, type SourceAdapterInput, type SourceAdapterOutput, SourceAnchorSchema, SourceRecord, SourceRecordSchema, SourceRegistry, type ValidateKnowledgeOptions, type ValidateKnowledgeResult, WIKILINK_REGEX, addSourcePath, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, buildKnowledgeGraph, buildKnowledgeIndex, chunkMarkdown, createKnowledgeEvent, createLocalDiscoveryDispatcher, explainKnowledgeTarget, extractWikilinks, formatFrontmatter, initKnowledgeBase, inspectKnowledgeIndex, isSafeKnowledgePath, knowledgeReleaseReportFromOptimization, knowledgeVariantFromCandidate, layoutFor, lintKnowledgeIndex, loadKnowledgePages, loadSourceRegistry, mediaTypeFor, normalizeLinkTarget, parseFrontmatter, parseKnowledgeWriteBlocks, reciprocalRankFusion, runKnowledgeBaseOptimization, searchKnowledge, sha256, slugify, sourceRegistryPath, stableId, stripFrontmatter, textSourceAdapter, tokenizeQuery, validateKnowledgeIndex, writeJson, writeKnowledgeIndex, writeSourceRegistry };

package/dist/index.js

@@ -1,4 +1,12 @@
 import {
+  KnowledgeBaseCandidateSchema,
+  KnowledgeEventSchema,
+  KnowledgeGraphEdgeSchema,
+  KnowledgeGraphNodeSchema,
+  KnowledgeIndexSchema,
+  KnowledgePageSchema,
+  SourceAnchorSchema,
+  SourceRecordSchema,
   WIKILINK_REGEX,
   addSourcePath,
   applyKnowledgeWriteBlocks,
@@ -27,10 +35,121 @@ import {
   stableId,
   textSourceAdapter,
   tokenizeQuery,
+  validateKnowledgeIndex,
   writeJson,
   writeKnowledgeIndex,
   writeSourceRegistry
-} from "./chunk-XDXIBHPS.js";
+} from "./chunk-WCUKMCAY.js";
+
+// src/events.ts
+function createKnowledgeEvent(input) {
+  const createdAt = (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+  return {
+    id: stableId("evt", `${input.type}:${input.target ?? ""}:${createdAt}:${JSON.stringify(input.metadata ?? {})}`),
+    type: input.type,
+    createdAt,
+    actor: input.actor,
+    target: input.target,
+    metadata: input.metadata
+  };
+}
+
+// src/kb-store.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { dirname, join } from "path";
+var MemoryKbStore = class {
+  sources = /* @__PURE__ */ new Map();
+  pages = /* @__PURE__ */ new Map();
+  events = [];
+  index = null;
+  async putSource(source) {
+    this.sources.set(source.id, clone(source));
+  }
+  async getSource(id) {
+    return clone(this.sources.get(id) ?? null);
+  }
+  async listSources() {
+    return [...this.sources.values()].map(clone);
+  }
+  async putPage(page) {
+    this.pages.set(page.id, clone(page));
+  }
+  async getPage(idOrPath) {
+    return clone(this.pages.get(idOrPath) ?? [...this.pages.values()].find((page) => page.path === idOrPath) ?? null);
+  }
+  async listPages() {
+    return [...this.pages.values()].map(clone);
+  }
+  async putIndex(index) {
+    this.index = clone(index);
+  }
+  async getIndex() {
+    if (this.index) return clone(this.index);
+    const pages = await this.listPages();
+    const sources = await this.listSources();
+    return { root: "memory", generatedAt: (/* @__PURE__ */ new Date()).toISOString(), sources, pages, graph: buildKnowledgeGraph(pages) };
+  }
+  async putEvent(event) {
+    this.events.push(clone(event));
+  }
+  async listEvents(query = {}) {
+    let out = this.events;
+    if (query.type) out = out.filter((event) => event.type === query.type);
+    if (query.target) out = out.filter((event) => event.target === query.target);
+    out = [...out].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    return out.slice(-(query.limit ?? out.length)).map(clone);
+  }
+};
+var FileSystemKbStore = class extends MemoryKbStore {
+  constructor(dir) {
+    super();
+    this.dir = dir;
+  }
+  dir;
+  async putIndex(index) {
+    await super.putIndex(index);
+    await writeJson2(join(this.dir, "index.json"), index);
+  }
+  async getIndex() {
+    try {
+      return JSON.parse(await readFile(join(this.dir, "index.json"), "utf8"));
+    } catch {
+      return await super.getIndex();
+    }
+  }
+  async putEvent(event) {
+    await super.putEvent(event);
+    const events = await this.listEvents();
+    await writeJson2(join(this.dir, "events.json"), events);
+  }
+};
+async function writeJson2(path, value) {
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, JSON.stringify(value, null, 2) + "\n", "utf8");
+}
+function clone(value) {
+  return value == null ? value : JSON.parse(JSON.stringify(value));
+}
+
+// src/discovery.ts
+function createLocalDiscoveryDispatcher(worker) {
+  return {
+    async dispatch(tasks, options = {}) {
+      const concurrency = Math.max(1, options.concurrency ?? 4);
+      const results = [];
+      let cursor = 0;
+      async function runNext() {
+        while (cursor < tasks.length) {
+          if (options.signal?.aborted) throw new Error("Discovery dispatch aborted");
+          const task = tasks[cursor++];
+          results.push(await worker.run(task, options.signal));
+        }
+      }
+      await Promise.all(Array.from({ length: Math.min(concurrency, tasks.length) }, runNext));
+      return results.sort((a, b) => tasks.findIndex((task) => task.id === a.taskId) - tasks.findIndex((task) => task.id === b.taskId));
+    }
+  };
+}
 
 // src/chunking.ts
 var DEFAULT_OPTIONS = {
@@ -179,7 +298,61 @@ function knowledgeVariantFromCandidate(candidate, options = {}) {
     payload: candidate
   };
 }
+
+// src/release.ts
+import {
+  evaluateReleaseConfidence,
+  releaseTraceEvidenceFromMultiShotTrials,
+  validateRunRecord
+} from "@tangle-network/agent-eval";
+function knowledgeReleaseReportFromOptimization(result, options = {}) {
+  const trials = result.evolution.generations.flatMap((generation) => generation.trials);
+  const traceEvidence = releaseTraceEvidenceFromMultiShotTrials(trials);
+  const runRecords = (options.runRecords ?? [
+    ...result.gate?.candidateRuns ?? [],
+    ...result.gate?.baselineRuns ?? []
+  ]).map(validateRunRecord);
+  const scorecard = evaluateReleaseConfidence({
+    target: "agent-knowledge-base",
+    candidateId: result.promotedVariant.id,
+    baselineId: "baseline",
+    traces: traceEvidence,
+    runs: runRecords,
+    gateDecision: result.gate?.decision ?? null,
+    thresholds: {
+      requireCorpus: false,
+      requireHoldout: Boolean(result.gate),
+      minHoldoutRuns: result.gate ? 1 : 0,
+      minSearchRuns: 1,
+      minMeanScore: options.minScore ?? 0.7
+    }
+  });
+  const release = {
+    id: stableId("krel", `${result.promotedVariant.id}:${options.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()}`),
+    candidateId: result.promotedVariant.id,
+    createdAt: options.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    promoted: scorecard.status !== "fail" && result.promotedVariant.id === result.searchBestVariant.id,
+    scorecard,
+    runRecordIds: runRecords.map((record) => record.runId)
+  };
+  return {
+    release,
+    scorecard,
+    candidateRuns: result.gate?.candidateRuns ?? [],
+    baselineRuns: result.gate?.baselineRuns ?? []
+  };
+}
 export {
+  FileSystemKbStore,
+  KnowledgeBaseCandidateSchema,
+  KnowledgeEventSchema,
+  KnowledgeGraphEdgeSchema,
+  KnowledgeGraphNodeSchema,
+  KnowledgeIndexSchema,
+  KnowledgePageSchema,
+  MemoryKbStore,
+  SourceAnchorSchema,
+  SourceRecordSchema,
   WIKILINK_REGEX,
   addSourcePath,
   applyKnowledgeWriteBlocks,
@@ -187,12 +360,15 @@ export {
   buildKnowledgeGraph,
   buildKnowledgeIndex,
   chunkMarkdown,
+  createKnowledgeEvent,
+  createLocalDiscoveryDispatcher,
   explainKnowledgeTarget,
   extractWikilinks,
   formatFrontmatter,
   initKnowledgeBase,
   inspectKnowledgeIndex,
   isSafeKnowledgePath,
+  knowledgeReleaseReportFromOptimization,
   knowledgeVariantFromCandidate,
   layoutFor,
   lintKnowledgeIndex,
@@ -212,6 +388,7 @@ export {
   stripFrontmatter,
   textSourceAdapter,
   tokenizeQuery,
+  validateKnowledgeIndex,
   writeJson,
   writeKnowledgeIndex,
   writeSourceRegistry