@hawkeyexl/manni 4.1.0 → 4.2.0

package/dist/index.js

@@ -3,40 +3,95 @@ import {
   BLOCK_KINDS,
   BUILTIN_SOURCE,
   BUILT_IN_DEFAULTS,
+  COVERAGE_FIELDS,
+  COVERAGE_FIELD_NAMES,
   DEFAULT_CONFIG_FILENAME,
+  DEFAULT_MODEL,
   DocevalsError,
   EVAL_KEYS,
   EXTERNAL_KEYS,
+  EmbedderUnavailableError,
   FILL_PROMPT_VERSION,
   FILL_SYSTEM_PROMPT,
   FRONTMATTER_SCHEMA_ID,
   FillCache,
   GOLDEN_DIR,
+  GRAPH_NOT_APPLICABLE_TO_VARIANT,
+  GRAPH_NOT_SOFTWARE_SUBJECT,
+  GraphError,
+  GraphIndex,
   KeyError,
   LINT_JOBS,
   LINT_TOOLS,
+  LOCALIZATIONS_FILENAME,
   LintError,
+  MODEL_PROFILES,
+  NS,
+  PREFIXES,
   PROPOSAL_SCHEMA,
   REPORT_FORMATS as REPORT_FORMATS2,
   RULE_ID_PREFIX2 as RULE_ID_PREFIX,
+  SECTION_COVERAGE_FIELDS,
   SEEDED_GOLDEN_FILE,
+  SOFTWARE_LIFECYCLE_IRIS,
+  SOFTWARE_SUBJECT_IRIS,
   STDIN_LABEL,
   SUMMARY_FORMATS,
   TOOLS_BY_JOB,
   TOOL_NAME,
+  TOPIC_TYPE_IRIS,
+  UNDETERMINED,
+  VectorIndexError,
+  VectorMismatchError,
+  analyzeDoc,
   appendPageEvals,
+  applyGraphFields,
+  assertProviderSelection,
   buildFillUser,
+  buildSearchIndex,
+  byCodeUnit,
   cacheKey,
   cite_exports,
   classifyRef as classifyRef2,
   clearMatcherCache,
   clearPatternCache,
   clearTemplateCaches,
+  collectGitHistory,
+  compactIri,
+  conceptSlug,
+  constructProvider,
+  createFetchResolver,
+  createLexicalIndex,
+  createLocalEmbedder,
+  createMockEmbedder,
+  createTrace,
+  createVectorIndex,
+  decodeVectorIndex,
+  defaultConfig,
+  deriveGraph,
+  discoverFiles,
   discoverPages,
+  documentPreamble,
+  documentSectionOrder,
+  documentsByLanguage,
+  embedText,
+  emitJsonLd,
+  emitLocalizations,
+  emitRdfXml,
+  emitSearchIndex,
+  emitTurtle,
+  encodeSegment,
+  encodeVectorIndex,
+  existingGraphFields,
+  existingMetaProvenance,
+  expandTerm,
   fillCacheKey,
+  findEntry,
+  frontmatterKind,
   frontmatterSchema,
   graderFor,
   headingMatches,
+  impact,
   isLintTool,
   isValidProposal,
   isWildcard,
@@ -47,21 +102,42 @@ import {
   listReviews,
   loadConfig as loadConfig2,
   loadConfig2 as loadConfig3,
+  loadConfig3 as loadConfig4,
   loadExternalReader,
   loadGoldenCases,
+  loadGraph,
+  loadRunConfig,
   loadTemplate,
   loadTemplateFile,
   makeGenerateScripts,
   makeJudge,
   makeProvider,
+  makeProvider2,
   matchSections,
+  mintAgentIri,
+  mintBuildActivityIri,
+  mintConceptIri,
+  mintDocIri,
+  mintGraphIri,
+  mintProductIri,
+  mintSchemeIri,
+  mintSectionIri,
+  normalize,
+  normalizeDocPath,
   occurrenceRange,
   parseConfig as parseConfig2,
   parseConfig2 as parseConfig3,
+  parseConfig3 as parseConfig4,
   parseFormat,
+  parseLocalizations,
   parserByName,
   parserForExtension,
+  partitionByLanguage,
+  profileFor,
+  projectPackage,
   providerSpecFor,
+  providerSpecFor2,
+  reachedNodes,
   readPage,
   readTarget,
   rebaseConfig,
@@ -70,6 +146,7 @@ import {
   render as render2,
   render2 as render3,
   renderCalibration,
+  renderEmbed,
   renderFill as renderFill2,
   renderGithub,
   renderJson,
@@ -78,18 +155,31 @@ import {
   renderPretty,
   renderReviews,
   renderSarif as renderSarif2,
+  renderSearch,
   renderTemplates,
   renderTools,
+  renderTraverse,
+  resolveBaseIri,
+  resolveDocumentSet,
   resolveExtends,
   resolveLintRun,
   resolvePage,
   resolvePages,
   resolveProviderIdentity,
+  resolveProviderIdentity2,
+  resolveSubject,
+  resolveVariant,
+  reverseReferences,
+  rrfMerge,
   ruleId,
   ruleName,
+  runBuild,
   runCalibrate,
+  runEmbed,
   runEvals,
+  runExport,
   runFill as runFill2,
+  runFill2 as runFill3,
   runGenerate,
   runInit,
   runKeyRotate,
@@ -97,20 +187,38 @@ import {
   runLint,
   runList,
   runPromote,
+  runQuery as runQuery2,
   runReview,
   runRun,
+  runSearch,
+  runStats,
   runTemplates,
   runTools,
+  runTraverse,
+  scopeExclusion,
   scriptLocationFor,
+  searchIndexDigest,
+  searchIndexFilename,
+  sectionOccurrence,
+  sectionOccurrences,
+  sectionOwnText,
   seedGoldenCases,
+  selectProvider,
+  sliceSection,
+  splitFragment,
+  storeToQuads,
   stripFrontmatterBlock,
   supportedExtensions as supportedExtensions2,
+  traverse,
   updateConfigEval,
   updatePageEval,
   validateDocument,
   validateSections,
-  withExternalMetadata
-} from "./chunk-S3NDEIOW.js";
+  vectorIndexFilename,
+  withExternalMetadata,
+  withPrefix,
+  writeZip
+} from "./chunk-UYDRDFYF.js";
 import {
   BinMissing,
   COMMON_FORMATS,
@@ -130,6 +238,7 @@ import {
   EXTERNAL_OWNED_SCHEMA,
   FIELD_SOURCES,
   FILL_FORMATS,
+  GRAPH_OUTPUT_KEYWORD,
   GitHubClient,
   GitLabClient,
   INTEGRITY_SHAPE,
@@ -148,6 +257,7 @@ import {
   STDIN_TOKEN,
   SchemaCache,
   Validator,
+  __default2 as __default,
   __export,
   applyFrontmatter,
   argvFor,
@@ -236,7 +346,7 @@ import {
   valueOf,
   vendorFileName,
   writeFileAtomic
-} from "./chunk-I57KBF45.js";
+} from "./chunk-TH565O2N.js";
 
 // src/docevals/index.ts
 var docevals_exports = {};
@@ -332,13 +442,13 @@ __export(lint_exports, {
   isWildcard: () => isWildcard,
   listBuiltins: () => listBuiltins2,
   listFormats: () => listFormats,
-  loadConfig: () => loadConfig3,
+  loadConfig: () => loadConfig4,
   loadTemplate: () => loadTemplate,
   loadTemplateFile: () => loadTemplateFile,
   matchSections: () => matchSections,
   occurrenceRange: () => occurrenceRange,
   palette: () => palette,
-  parseConfig: () => parseConfig3,
+  parseConfig: () => parseConfig4,
   parserByName: () => parserByName,
   parserForExtension: () => parserForExtension,
   rebaseConfig: () => rebaseConfig,
@@ -368,6 +478,281 @@ function clearCaches() {
   clearPatternCache();
 }
 
+// src/graph/index.ts
+var graph_exports = {};
+__export(graph_exports, {
+  COVERAGE_FIELDS: () => COVERAGE_FIELDS,
+  COVERAGE_FIELD_NAMES: () => COVERAGE_FIELD_NAMES,
+  DEFAULT_MODEL: () => DEFAULT_MODEL,
+  EmbedderUnavailableError: () => EmbedderUnavailableError,
+  FRONTMATTER_SCHEMA_ID: () => FRONTMATTER_SCHEMA_ID2,
+  GRAPH_NOT_APPLICABLE_TO_VARIANT: () => GRAPH_NOT_APPLICABLE_TO_VARIANT,
+  GRAPH_NOT_SOFTWARE_SUBJECT: () => GRAPH_NOT_SOFTWARE_SUBJECT,
+  GraphError: () => GraphError,
+  GraphIndex: () => GraphIndex,
+  LOCALIZATIONS_FILENAME: () => LOCALIZATIONS_FILENAME,
+  MODEL_PROFILES: () => MODEL_PROFILES,
+  MockProvider: () => MockProvider2,
+  NS: () => NS,
+  PREFIXES: () => PREFIXES,
+  SECTION_COVERAGE_FIELDS: () => SECTION_COVERAGE_FIELDS,
+  SOFTWARE_LIFECYCLE_IRIS: () => SOFTWARE_LIFECYCLE_IRIS,
+  SOFTWARE_SUBJECT_IRIS: () => SOFTWARE_SUBJECT_IRIS,
+  TOPIC_TYPE_IRIS: () => TOPIC_TYPE_IRIS,
+  UNDETERMINED: () => UNDETERMINED,
+  VectorIndexError: () => VectorIndexError,
+  VectorMismatchError: () => VectorMismatchError,
+  analyzeDoc: () => analyzeDoc,
+  applyGraphFields: () => applyGraphFields,
+  assemble: () => assemble,
+  assertProviderSelection: () => assertProviderSelection,
+  buildSearchIndex: () => buildSearchIndex,
+  collectGitHistory: () => collectGitHistory,
+  compactIri: () => compactIri,
+  conceptSlug: () => conceptSlug,
+  constructProvider: () => constructProvider,
+  createFetchResolver: () => createFetchResolver,
+  createLexicalIndex: () => createLexicalIndex,
+  createLocalEmbedder: () => createLocalEmbedder,
+  createMockEmbedder: () => createMockEmbedder,
+  createTrace: () => createTrace,
+  createVectorIndex: () => createVectorIndex,
+  decodeVectorIndex: () => decodeVectorIndex,
+  defaultConfig: () => defaultConfig,
+  defaultGraph: () => defaultGraph,
+  deriveGraph: () => deriveGraph,
+  discoverFiles: () => discoverFiles,
+  documentPreamble: () => documentPreamble,
+  documentSectionOrder: () => documentSectionOrder,
+  documentsByLanguage: () => documentsByLanguage,
+  embedText: () => embedText,
+  emitJsonLd: () => emitJsonLd,
+  emitLocalizations: () => emitLocalizations,
+  emitRdfXml: () => emitRdfXml,
+  emitSearchIndex: () => emitSearchIndex,
+  emitTurtle: () => emitTurtle,
+  encodeSegment: () => encodeSegment,
+  encodeVectorIndex: () => encodeVectorIndex,
+  existingGraphFields: () => existingGraphFields,
+  existingMetaProvenance: () => existingMetaProvenance,
+  expandTerm: () => expandTerm,
+  findEntry: () => findEntry,
+  frontmatterKind: () => frontmatterKind,
+  frontmatterSchema: () => frontmatterSchema2,
+  impact: () => impact,
+  literal: () => literal,
+  loadConfig: () => loadConfig3,
+  loadGraph: () => loadGraph,
+  loadRunConfig: () => loadRunConfig,
+  makeProvider: () => makeProvider2,
+  matchQuads: () => matchQuads,
+  mintAgentIri: () => mintAgentIri,
+  mintBuildActivityIri: () => mintBuildActivityIri,
+  mintConceptIri: () => mintConceptIri,
+  mintDocIri: () => mintDocIri,
+  mintGraphIri: () => mintGraphIri,
+  mintProductIri: () => mintProductIri,
+  mintSchemeIri: () => mintSchemeIri,
+  mintSectionIri: () => mintSectionIri,
+  namedNode: () => namedNode,
+  normalize: () => normalize,
+  normalizeDocPath: () => normalizeDocPath,
+  parseConfig: () => parseConfig3,
+  parseLocalizations: () => parseLocalizations,
+  partitionByLanguage: () => partitionByLanguage,
+  profileFor: () => profileFor,
+  projectPackage: () => projectPackage,
+  providerSpecFor: () => providerSpecFor2,
+  rdfjsQuads: () => rdfjsQuads,
+  reachedNodes: () => reachedNodes,
+  renderEmbed: () => renderEmbed,
+  renderSearch: () => renderSearch,
+  renderTraverse: () => renderTraverse,
+  resolveBaseIri: () => resolveBaseIri,
+  resolveDocumentSet: () => resolveDocumentSet,
+  resolveProviderIdentity: () => resolveProviderIdentity2,
+  resolveSubject: () => resolveSubject,
+  resolveVariant: () => resolveVariant,
+  reverseReferences: () => reverseReferences,
+  rrfMerge: () => rrfMerge,
+  runBuild: () => runBuild,
+  runEmbed: () => runEmbed,
+  runExport: () => runExport,
+  runFill: () => runFill3,
+  runQuery: () => runQuery2,
+  runSearch: () => runSearch,
+  runStats: () => runStats,
+  runTraverse: () => runTraverse,
+  scopeExclusion: () => scopeExclusion,
+  searchIndexDigest: () => searchIndexDigest,
+  searchIndexFilename: () => searchIndexFilename,
+  sectionOccurrence: () => sectionOccurrence,
+  sectionOccurrences: () => sectionOccurrences,
+  sectionOwnText: () => sectionOwnText,
+  selectProvider: () => selectProvider,
+  sliceSection: () => sliceSection,
+  splitFragment: () => splitFragment,
+  storeToQuads: () => storeToQuads,
+  traverse: () => traverse,
+  vectorIndexFilename: () => vectorIndexFilename,
+  withPrefix: () => withPrefix,
+  writeZip: () => writeZip
+});
+
+// src/graph/runtime/assemble.ts
+async function assemble(resolver, nodes, options = {}) {
+  const trace = options.trace ?? createTrace();
+  const budget = options.maxChars ?? Infinity;
+  if (nodes.length === 0) {
+    return {
+      ...options.entry ? { entry: options.entry } : {},
+      context: [],
+      citations: [],
+      trace,
+      truncated: false,
+      refusal: {
+        reason: "no-route",
+        detail: "No node in the graph was reachable for this query under the active scope filter."
+      }
+    };
+  }
+  const context = [];
+  let used = 0;
+  let truncated = false;
+  let resolvedAny = false;
+  for (const node of nodes) {
+    const resolved = await resolver.resolve(node.iri);
+    if (!resolved) continue;
+    resolvedAny = true;
+    if (used + resolved.text.length > budget) {
+      truncated = true;
+      continue;
+    }
+    used += resolved.text.length;
+    context.push({
+      iri: resolved.iri,
+      title: resolved.title,
+      text: resolved.text,
+      sourceUrl: resolved.sourceUrl,
+      depth: node.depth
+    });
+  }
+  if (context.length === 0) {
+    return {
+      ...options.entry ? { entry: options.entry } : {},
+      context: [],
+      citations: [],
+      trace,
+      truncated,
+      refusal: {
+        reason: "no-content",
+        detail: resolvedAny ? "Every matching node's content exceeded the character budget." : "Matching nodes were found, but none of them resolved to readable content."
+      }
+    };
+  }
+  return {
+    ...options.entry ? { entry: options.entry } : {},
+    context,
+    citations: context.map((b) => ({
+      iri: b.iri,
+      title: b.title,
+      sourceUrl: b.sourceUrl
+    })),
+    trace,
+    truncated
+  };
+}
+
+// src/graph/runtime/rdfjs.ts
+var XSD_STRING = "http://www.w3.org/2001/XMLSchema#string";
+function namedNode(value) {
+  return {
+    termType: "NamedNode",
+    value,
+    equals(other) {
+      return !!other && other.termType === "NamedNode" && other.value === value;
+    }
+  };
+}
+function defaultGraph() {
+  return {
+    termType: "DefaultGraph",
+    value: "",
+    equals(other) {
+      return !!other && other.termType === "DefaultGraph";
+    }
+  };
+}
+function literal(value, datatype) {
+  const dt = namedNode(datatype ?? XSD_STRING);
+  return {
+    termType: "Literal",
+    value,
+    language: "",
+    datatype: dt,
+    equals(other) {
+      return !!other && other.termType === "Literal" && other.value === value && !!other.datatype && other.datatype.value === dt.value;
+    }
+  };
+}
+function toTerm(v) {
+  return v.kind === "iri" ? namedNode(v.value) : literal(v.value, v.datatype);
+}
+function makeQuad(s, p, o) {
+  const subject = namedNode(s);
+  const predicate = namedNode(p);
+  const object = toTerm(o);
+  const graph = defaultGraph();
+  return {
+    termType: "Quad",
+    subject,
+    predicate,
+    object,
+    graph,
+    equals(other) {
+      return !!other && subject.equals(other.subject) && predicate.equals(other.predicate) && object.equals(other.object);
+    }
+  };
+}
+function rdfjsQuads(graph) {
+  const quads = [];
+  for (const s of graph.ids()) {
+    const node = graph.node(s);
+    if (!node) continue;
+    for (const p of [...node.props.keys()].sort(byCodeUnit)) {
+      for (const v of node.props.get(p) ?? []) quads.push(makeQuad(s, p, v));
+    }
+  }
+  return quads;
+}
+function matchQuads(graph, subject, predicate, object) {
+  const quads = [];
+  const subjects = subject ? [subject] : graph.ids();
+  for (const s of subjects) {
+    const node = graph.node(s);
+    if (!node) continue;
+    const predicates = predicate ? [predicate] : [...node.props.keys()].sort(byCodeUnit);
+    for (const p of predicates) {
+      for (const v of node.props.get(p) ?? []) {
+        if (object !== void 0 && object !== null && v.value !== object) {
+          continue;
+        }
+        quads.push(makeQuad(s, p, v));
+      }
+    }
+  }
+  return quads;
+}
+
+// src/graph/schema.ts
+var frontmatterSchema2 = __default;
+var FRONTMATTER_SCHEMA_ID2 = __default.$id;
+
+// src/graph/index.ts
+import {
+  MockProvider as MockProvider2
+} from "@hawkeyexl/inference";
+
 // src/key/index.ts
 var key_exports = {};
 __export(key_exports, {
@@ -398,6 +783,7 @@ export {
   EXTERNAL_OWNED_SCHEMA,
   FIELD_SOURCES,
   FILL_FORMATS,
+  GRAPH_OUTPUT_KEYWORD,
   GitHubClient,
   GitLabClient,
   INTEGRITY_SHAPE,
@@ -439,6 +825,7 @@ export {
   fetchSchemaBytes,
   frontmatterInnerText,
   getSchemasInfo,
+  graph_exports as graph,
   identityFromOrigin,
   integrityOf,
   isBuiltinField,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/docevals/index.ts","../src/lint/index.ts","../src/key/index.ts"],"sourcesContent":["/** Programmatic API for manni docevals. */\nexport { loadConfig, parseConfig, DEFAULT_CONFIG_FILENAME } from \"./core/config.js\";\nexport type { DocevalsConfig, EvalDef, SuiteDef, ProviderName } from \"./core/config.js\";\nexport { discoverPages, readPage, stripFrontmatterBlock } from \"./core/discover.js\";\nexport type { PageFile } from \"./core/discover.js\";\nexport {\n  loadExternalReader,\n  withExternalMetadata,\n  EVAL_KEYS,\n  EXTERNAL_KEYS,\n} from \"./core/external.js\";\nexport type { ExternalMetadataReader, PageExternal } from \"./core/external.js\";\nexport { resolvePage, resolvePages } from \"./core/resolve.js\";\nexport type { ResolvedEval, ResolvedPagePlan, PageProblem } from \"./core/resolve.js\";\nexport { runList, renderList } from \"./commands/list.js\";\nexport type { ListOptions, ListRun } from \"./commands/list.js\";\nexport { runEvals } from \"./core/engine.js\";\nexport type {\n  EngineReport,\n  JudgeFn,\n  JudgeOptions,\n  RunOptions,\n  RunProblem,\n} from \"./core/engine.js\";\nexport { runRun } from \"./commands/run.js\";\nexport type { RunCommandOptions } from \"./commands/run.js\";\n// From the library, not local copies: judge.ts calls the library's versions,\n// so re-exporting a second implementation here would let a consumer's\n// computeConsensus() diverge from what the judge actually ran — the drift this\n// extraction exists to end.\nexport { computeConsensus, zoneFor } from \"@hawkeyexl/inference\";\nexport type { ZoneThresholds } from \"@hawkeyexl/inference\";\nexport { makeJudge } from \"./judge/judge.js\";\nexport {\n  makeProvider,\n  providerSpecFor,\n  resolveProviderIdentity,\n} from \"./judge/provider.js\";\n// The provider contract and the offline test seam come from the shared\n// inference layer; re-exported so downstream code keeps one import site.\n// `InferenceProvider` is what this package used to call `JudgeProvider`.\nexport {\n  MockProvider,\n  mockVerdict,\n  type CompleteJSONRequest,\n  type CompleteJSONResponse,\n  type InferenceProvider,\n  type MockResponse,\n} from \"@hawkeyexl/inference\";\nexport {\n  render,\n  parseFormat,\n  REPORT_FORMATS,\n  SUMMARY_FORMATS,\n} from \"./reporters/index.js\";\nexport type { ColorOptions, ReportFormat, SummaryFormat } from \"./reporters/index.js\";\nexport {\n  listReviews,\n  renderReviews,\n  runReview,\n} from \"./commands/review.js\";\nexport { runGenerate } from \"./commands/generate.js\";\nexport type { GenerateOptions, GenerateRun } from \"./commands/generate.js\";\nexport { runFill, renderFill } from \"./commands/fill.js\";\nexport type {\n  FillOptions,\n  FillReport,\n  FillPageResult,\n  FillStatus,\n  ProposedEval,\n} from \"./commands/fill.js\";\nexport {\n  FILL_PROMPT_VERSION,\n  FILL_SYSTEM_PROMPT,\n  PROPOSAL_SCHEMA,\n  buildFillUser,\n  isValidProposal,\n} from \"./fill/prompt.js\";\nexport { FillCache, fillCacheKey } from \"./fill/cache.js\";\nexport { runPromote } from \"./commands/promote.js\";\nexport type { PromoteOptions, PromoteProposal } from \"./commands/promote.js\";\nexport { makeGenerateScripts, scriptLocationFor } from \"./graders/scriptgen.js\";\nexport {\n  runCalibrate,\n  renderCalibration,\n  loadGoldenCases,\n  seedGoldenCases,\n  GOLDEN_DIR,\n  SEEDED_GOLDEN_FILE,\n} from \"./commands/calibrate.js\";\nexport type {\n  CalibrateOptions,\n  CalibrationReport,\n  CalibrationCaseResult,\n  GoldenCase,\n  SeedResult,\n} from \"./commands/calibrate.js\";\nexport { runInit } from \"./commands/init.js\";\nexport { registerGrader, graderFor, listGraderKinds } from \"./graders/registry.js\";\nexport type { Grader, GraderContext, GraderTarget, ExecFn } from \"./graders/types.js\";\nexport {\n  updatePageEval,\n  updateConfigEval,\n  appendPageEvals,\n} from \"./core/frontmatter-edit.js\";\nexport type { NewEvalEntry } from \"./core/frontmatter-edit.js\";\nexport { frontmatterSchema, FRONTMATTER_SCHEMA_ID } from \"./schema.js\";\n// The judge cache key and the exact body it hashes. Exported so that anything\n// asking \"is this verdict already cached?\" — `scripts/check-docs-cache.mjs`\n// above all — computes it with the judge's own code instead of reproducing the\n// composition by hand, which is how that script silently keyed on the raw page\n// body after the judge started prefixing the chunk budget.\nexport { cacheKey, judgeCacheBody } from \"./judge/cache.js\";\nexport type { JudgeCacheBody } from \"./judge/cache.js\";\nexport { readTarget } from \"./core/target.js\";\nexport * from \"./types.js\";\n","/** Programmatic API for manni lint. */\nimport { clearTemplateCaches } from \"./core/template-registry.js\";\nimport { clearMatcherCache } from \"./core/resolve-template.js\";\nimport { clearPatternCache } from \"./rules/index.js\";\n\n/**\n * Drop every process-lifetime cache: parsed built-ins, fetched template files,\n * compiled override globs, and compiled heading patterns.\n *\n * A CLI run never needs this - it lints one docset and exits, and the caches\n * are what stop a tree of one doctype from re-reading the same template per\n * page. A long-lived host is the different case: the maps grow with the number\n * of distinct refs and patterns seen, and a cached remote template is served\n * for the life of the process, so one republished upstream is never picked up.\n * Call this between runs, or when a template may have changed underneath.\n */\nexport function clearCaches(): void {\n  clearTemplateCaches();\n  clearMatcherCache();\n  clearPatternCache();\n}\n\nexport { runLint, STDIN_LABEL } from \"./commands/lint.js\";\nexport type {\n  LintOptions,\n  LintRun,\n  LintSummary,\n  LintFileResult,\n} from \"./commands/lint.js\";\nexport { runTemplates, BUILTIN_SOURCE } from \"./commands/templates.js\";\nexport type {\n  TemplateInfo,\n  TemplatesInfo,\n  TemplatesOptions,\n} from \"./commands/templates.js\";\nexport { runTools, BUILT_IN_DEFAULTS } from \"./commands/tools.js\";\nexport type { FormatInfo, ToolInfo, ToolsOptions } from \"./commands/tools.js\";\nexport {\n  LINT_JOBS,\n  LINT_TOOLS,\n  TOOLS_BY_JOB,\n  isLintTool,\n  loadConfig,\n  parseConfig,\n  rebaseConfig,\n  resolveLintRun,\n} from \"./core/config.js\";\nexport type {\n  LintConfig,\n  LintJob,\n  LintJobConfig,\n  LintRunOptions,\n  LintTool,\n  ResolvedLintRun,\n} from \"./core/config.js\";\nexport { validateDocument, validateSections } from \"./core/validator.js\";\nexport { matchSections } from \"./core/match.js\";\nexport type { Match, MatchResult } from \"./core/match.js\";\nexport {\n  BLOCK_KINDS,\n  headingMatches,\n  isWildcard,\n  occurrenceRange,\n} from \"./core/template.js\";\nexport type {\n  AdmonitionsRule,\n  AttributesRule,\n  BlockKind,\n  BlockRule,\n  CodeBlocksRule,\n  ElementsRule,\n  HeadingRule,\n  ImagesRule,\n  ListItemsRule,\n  ListsRule,\n  Occurrences,\n  ParagraphsRule,\n  Rule,\n  TablesRule,\n  Template,\n  TemplateFile,\n} from \"./core/template.js\";\nexport {\n  listBuiltins,\n  loadTemplate,\n  loadTemplateFile,\n  resolveExtends,\n  classifyRef,\n} from \"./core/template-registry.js\";\nexport type {\n  BuiltinInfo,\n  LoadTemplateOptions,\n  RefKind,\n  TemplateResolver,\n} from \"./core/template-registry.js\";\n// Targets resolve through the family's walker (`src/meta/internal.ts`), which\n// is what makes `--ext`, `--exclude`, `.gitignore` handling and `--allow-empty`\n// mean the same thing here as they do for `meta` and `cite`.\nexport { STDIN_TOKEN } from \"../meta/internal.js\";\nexport {\n  listFormats,\n  parserByName,\n  parserForExtension,\n  supportedExtensions,\n} from \"./parsers/index.js\";\nexport {\n  render,\n  renderPretty,\n  renderJson,\n  renderGithub,\n  renderJunit,\n  renderTemplates,\n  renderTools,\n} from \"./reporters/index.js\";\nexport type {\n  ReportFormat,\n  ReportOptions,\n  ListFormat,\n} from \"./reporters/index.js\";\nexport { renderSarif } from \"./reporters/sarif.js\";\nexport type { SarifOptions } from \"./reporters/sarif.js\";\n// A finding's durable identity, so a caller filing or correlating findings\n// spells the id the same way every reporter does.\nexport { RULE_ID_PREFIX, TOOL_NAME, ruleId, ruleName } from \"./core/rule-id.js\";\n// Colour is the family's decision, made once in `src/shared/color.js`. These\n// are re-exported here so a library caller building lint's reports does not\n// have to reach for another tool's entry point to turn ANSI on or off.\nexport { palette, shouldColor } from \"../shared/color.js\";\nexport * from \"./types.js\";\n","/**\n * The key domain's programmatic API, exported from the package as the `key`\n * namespace: `import { key } from \"@hawkeyexl/manni\"`. The command cores, and\n * the family's encryption primitives a caller needs beside them.\n */\nexport * from \"./types.js\";\nexport { KeyError } from \"./errors.js\";\nexport { runKeySet } from \"./commands/set.js\";\nexport { runKeyRotate } from \"./commands/rotate.js\";\nexport { decryptValue, encryptValue, isEncryptedValue } from \"../shared/encryption.js\";\nexport type { EncryptionContext } from \"../shared/encryption.js\";\nexport { resolveEncryptionKey } from \"../shared/encryption-key.js\";\nexport type { KeySource, ResolvedKey } from \"../shared/encryption-key.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gBAAAC;AAAA,EAAA;AAAA,oBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BA,SAAS,kBAAkB,eAAe;AAW1C;AAAA,EACE;AAAA,EACA;AAAA,OAKK;;;AChDP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,sBAAAC;AAAA,EAAA;AAAA,oBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA,gBAAAC;AAAA,EAAA;AAAA;AAAA,qBAAAC;AAAA,EAAA;AAAA,qBAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,6BAAAC;AAAA,EAAA;AAAA;AAAA;AAgBO,SAAS,cAAoB;AAClC,sBAAoB;AACpB,oBAAkB;AAClB,oBAAkB;AACpB;;;ACpBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":["REPORT_FORMATS","loadConfig","parseConfig","render","renderFill","runFill","classifyRef","listBuiltins","loadConfig","parseConfig","render","renderJunit","renderSarif","supportedExtensions"]}
+{"version":3,"sources":["../src/docevals/index.ts","../src/lint/index.ts","../src/graph/index.ts","../src/graph/runtime/assemble.ts","../src/graph/runtime/rdfjs.ts","../src/graph/schema.ts","../src/key/index.ts"],"sourcesContent":["/** Programmatic API for manni docevals. */\nexport { loadConfig, parseConfig, DEFAULT_CONFIG_FILENAME } from \"./core/config.js\";\nexport type { DocevalsConfig, EvalDef, SuiteDef, ProviderName } from \"./core/config.js\";\nexport { discoverPages, readPage, stripFrontmatterBlock } from \"./core/discover.js\";\nexport type { PageFile } from \"./core/discover.js\";\nexport {\n  loadExternalReader,\n  withExternalMetadata,\n  EVAL_KEYS,\n  EXTERNAL_KEYS,\n} from \"./core/external.js\";\nexport type { ExternalMetadataReader, PageExternal } from \"./core/external.js\";\nexport { resolvePage, resolvePages } from \"./core/resolve.js\";\nexport type { ResolvedEval, ResolvedPagePlan, PageProblem } from \"./core/resolve.js\";\nexport { runList, renderList } from \"./commands/list.js\";\nexport type { ListOptions, ListRun } from \"./commands/list.js\";\nexport { runEvals } from \"./core/engine.js\";\nexport type {\n  EngineReport,\n  JudgeFn,\n  JudgeOptions,\n  RunOptions,\n  RunProblem,\n} from \"./core/engine.js\";\nexport { runRun } from \"./commands/run.js\";\nexport type { RunCommandOptions } from \"./commands/run.js\";\n// From the library, not local copies: judge.ts calls the library's versions,\n// so re-exporting a second implementation here would let a consumer's\n// computeConsensus() diverge from what the judge actually ran — the drift this\n// extraction exists to end.\nexport { computeConsensus, zoneFor } from \"@hawkeyexl/inference\";\nexport type { ZoneThresholds } from \"@hawkeyexl/inference\";\nexport { makeJudge } from \"./judge/judge.js\";\nexport {\n  makeProvider,\n  providerSpecFor,\n  resolveProviderIdentity,\n} from \"./judge/provider.js\";\n// The provider contract and the offline test seam come from the shared\n// inference layer; re-exported so downstream code keeps one import site.\n// `InferenceProvider` is what this package used to call `JudgeProvider`.\nexport {\n  MockProvider,\n  mockVerdict,\n  type CompleteJSONRequest,\n  type CompleteJSONResponse,\n  type InferenceProvider,\n  type MockResponse,\n} from \"@hawkeyexl/inference\";\nexport {\n  render,\n  parseFormat,\n  REPORT_FORMATS,\n  SUMMARY_FORMATS,\n} from \"./reporters/index.js\";\nexport type { ColorOptions, ReportFormat, SummaryFormat } from \"./reporters/index.js\";\nexport {\n  listReviews,\n  renderReviews,\n  runReview,\n} from \"./commands/review.js\";\nexport { runGenerate } from \"./commands/generate.js\";\nexport type { GenerateOptions, GenerateRun } from \"./commands/generate.js\";\nexport { runFill, renderFill } from \"./commands/fill.js\";\nexport type {\n  FillOptions,\n  FillReport,\n  FillPageResult,\n  FillStatus,\n  ProposedEval,\n} from \"./commands/fill.js\";\nexport {\n  FILL_PROMPT_VERSION,\n  FILL_SYSTEM_PROMPT,\n  PROPOSAL_SCHEMA,\n  buildFillUser,\n  isValidProposal,\n} from \"./fill/prompt.js\";\nexport { FillCache, fillCacheKey } from \"./fill/cache.js\";\nexport { runPromote } from \"./commands/promote.js\";\nexport type { PromoteOptions, PromoteProposal } from \"./commands/promote.js\";\nexport { makeGenerateScripts, scriptLocationFor } from \"./graders/scriptgen.js\";\nexport {\n  runCalibrate,\n  renderCalibration,\n  loadGoldenCases,\n  seedGoldenCases,\n  GOLDEN_DIR,\n  SEEDED_GOLDEN_FILE,\n} from \"./commands/calibrate.js\";\nexport type {\n  CalibrateOptions,\n  CalibrationReport,\n  CalibrationCaseResult,\n  GoldenCase,\n  SeedResult,\n} from \"./commands/calibrate.js\";\nexport { runInit } from \"./commands/init.js\";\nexport { registerGrader, graderFor, listGraderKinds } from \"./graders/registry.js\";\nexport type { Grader, GraderContext, GraderTarget, ExecFn } from \"./graders/types.js\";\nexport {\n  updatePageEval,\n  updateConfigEval,\n  appendPageEvals,\n} from \"./core/frontmatter-edit.js\";\nexport type { NewEvalEntry } from \"./core/frontmatter-edit.js\";\nexport { frontmatterSchema, FRONTMATTER_SCHEMA_ID } from \"./schema.js\";\n// The judge cache key and the exact body it hashes. Exported so that anything\n// asking \"is this verdict already cached?\" — `scripts/check-docs-cache.mjs`\n// above all — computes it with the judge's own code instead of reproducing the\n// composition by hand, which is how that script silently keyed on the raw page\n// body after the judge started prefixing the chunk budget.\nexport { cacheKey, judgeCacheBody } from \"./judge/cache.js\";\nexport type { JudgeCacheBody } from \"./judge/cache.js\";\nexport { readTarget } from \"./core/target.js\";\nexport * from \"./types.js\";\n","/** Programmatic API for manni lint. */\nimport { clearTemplateCaches } from \"./core/template-registry.js\";\nimport { clearMatcherCache } from \"./core/resolve-template.js\";\nimport { clearPatternCache } from \"./rules/index.js\";\n\n/**\n * Drop every process-lifetime cache: parsed built-ins, fetched template files,\n * compiled override globs, and compiled heading patterns.\n *\n * A CLI run never needs this - it lints one docset and exits, and the caches\n * are what stop a tree of one doctype from re-reading the same template per\n * page. A long-lived host is the different case: the maps grow with the number\n * of distinct refs and patterns seen, and a cached remote template is served\n * for the life of the process, so one republished upstream is never picked up.\n * Call this between runs, or when a template may have changed underneath.\n */\nexport function clearCaches(): void {\n  clearTemplateCaches();\n  clearMatcherCache();\n  clearPatternCache();\n}\n\nexport { runLint, STDIN_LABEL } from \"./commands/lint.js\";\nexport type {\n  LintOptions,\n  LintRun,\n  LintSummary,\n  LintFileResult,\n} from \"./commands/lint.js\";\nexport { runTemplates, BUILTIN_SOURCE } from \"./commands/templates.js\";\nexport type {\n  TemplateInfo,\n  TemplatesInfo,\n  TemplatesOptions,\n} from \"./commands/templates.js\";\nexport { runTools, BUILT_IN_DEFAULTS } from \"./commands/tools.js\";\nexport type { FormatInfo, ToolInfo, ToolsOptions } from \"./commands/tools.js\";\nexport {\n  LINT_JOBS,\n  LINT_TOOLS,\n  TOOLS_BY_JOB,\n  isLintTool,\n  loadConfig,\n  parseConfig,\n  rebaseConfig,\n  resolveLintRun,\n} from \"./core/config.js\";\nexport type {\n  LintConfig,\n  LintJob,\n  LintJobConfig,\n  LintRunOptions,\n  LintTool,\n  ResolvedLintRun,\n} from \"./core/config.js\";\nexport { validateDocument, validateSections } from \"./core/validator.js\";\nexport { matchSections } from \"./core/match.js\";\nexport type { Match, MatchResult } from \"./core/match.js\";\nexport {\n  BLOCK_KINDS,\n  headingMatches,\n  isWildcard,\n  occurrenceRange,\n} from \"./core/template.js\";\nexport type {\n  AdmonitionsRule,\n  AttributesRule,\n  BlockKind,\n  BlockRule,\n  CodeBlocksRule,\n  ElementsRule,\n  HeadingRule,\n  ImagesRule,\n  ListItemsRule,\n  ListsRule,\n  Occurrences,\n  ParagraphsRule,\n  Rule,\n  TablesRule,\n  Template,\n  TemplateFile,\n} from \"./core/template.js\";\nexport {\n  listBuiltins,\n  loadTemplate,\n  loadTemplateFile,\n  resolveExtends,\n  classifyRef,\n} from \"./core/template-registry.js\";\nexport type {\n  BuiltinInfo,\n  LoadTemplateOptions,\n  RefKind,\n  TemplateResolver,\n} from \"./core/template-registry.js\";\n// Targets resolve through the family's walker (`src/meta/internal.ts`), which\n// is what makes `--ext`, `--exclude`, `.gitignore` handling and `--allow-empty`\n// mean the same thing here as they do for `meta` and `cite`.\nexport { STDIN_TOKEN } from \"../meta/internal.js\";\nexport {\n  listFormats,\n  parserByName,\n  parserForExtension,\n  supportedExtensions,\n} from \"./parsers/index.js\";\nexport {\n  render,\n  renderPretty,\n  renderJson,\n  renderGithub,\n  renderJunit,\n  renderTemplates,\n  renderTools,\n} from \"./reporters/index.js\";\nexport type {\n  ReportFormat,\n  ReportOptions,\n  ListFormat,\n} from \"./reporters/index.js\";\nexport { renderSarif } from \"./reporters/sarif.js\";\nexport type { SarifOptions } from \"./reporters/sarif.js\";\n// A finding's durable identity, so a caller filing or correlating findings\n// spells the id the same way every reporter does.\nexport { RULE_ID_PREFIX, TOOL_NAME, ruleId, ruleName } from \"./core/rule-id.js\";\n// Colour is the family's decision, made once in `src/shared/color.js`. These\n// are re-exported here so a library caller building lint's reports does not\n// have to reach for another tool's entry point to turn ANSI on or off.\nexport { palette, shouldColor } from \"../shared/color.js\";\nexport * from \"./types.js\";\n","/** The graph tool's public API. */\nexport * from \"./types.js\";\nexport {\n  defaultConfig,\n  loadConfig,\n  loadRunConfig,\n  parseConfig,\n  type GraphConfig,\n  type DeriveSource,\n  type FillField,\n} from \"./core/config.js\";\nexport {\n  COVERAGE_FIELDS,\n  COVERAGE_FIELD_NAMES,\n  // reference/library-api.mdx names this alongside the other two, so it has to\n  // be reachable from the entry point that page tells consumers to import from.\n  SECTION_COVERAGE_FIELDS,\n  type CoverageField,\n} from \"./core/coverage.js\";\nexport {\n  discoverFiles,\n  resolveDocumentSet,\n  type DocumentInputOptions,\n  type DocumentSetOptions,\n} from \"./core/discover.js\";\nexport {\n  GRAPH_NOT_APPLICABLE_TO_VARIANT,\n  GRAPH_NOT_SOFTWARE_SUBJECT,\n  SOFTWARE_LIFECYCLE_IRIS,\n  SOFTWARE_SUBJECT_IRIS,\n  TOPIC_TYPE_IRIS,\n} from \"./core/iirds.js\";\nexport {\n  conceptSlug,\n  encodeSegment,\n  mintAgentIri,\n  type AgentKind,\n  mintBuildActivityIri,\n  mintConceptIri,\n  mintDocIri,\n  mintGraphIri,\n  mintProductIri,\n  mintSchemeIri,\n  mintSectionIri,\n  normalizeDocPath,\n  resolveBaseIri,\n} from \"./core/iri.js\";\nexport { analyzeDoc } from \"./core/analyze.js\";\nexport {\n  deriveGraph,\n  type DeriveOptions,\n  type Quad,\n  type Term,\n} from \"./core/derive.js\";\nexport {\n  collectGitHistory,\n  type GitFileHistory,\n  type GitHistory,\n} from \"./core/git.js\";\nexport { emitTurtle } from \"./core/emit.js\";\nexport { emitJsonLd } from \"./core/emit-jsonld.js\";\nexport { emitRdfXml } from \"./core/emit-rdfxml.js\";\nexport { writeZip, type ZipEntry } from \"./core/zip.js\";\nexport {\n  projectPackage,\n  type IirdsPackageOptions,\n  type PackageProjection,\n  type ContentFile,\n} from \"./core/iirds-package.js\";\nexport {\n  loadGraph,\n  expandTerm,\n  compactIri,\n  storeToQuads,\n} from \"./core/load.js\";\n/**\n * The browser-native GraphRAG runtime is also published as the `@hawkeyexl/manni/graph/runtime`\n * subpath, which is the import to use in a browser: it has no `node:` imports\n * and no dependencies (ADR 01018).\n */\nexport * from \"./runtime/index.js\";\nexport {\n  applyGraphFields,\n  existingGraphFields,\n  existingMetaProvenance,\n  frontmatterKind,\n  type GraphApplyOptions,\n  type GraphApplyResult,\n} from \"./core/frontmatter-edit.js\";\nexport { NS, PREFIXES } from \"./core/vocab.js\";\nexport {\n  runBuild,\n  type BuildOptions,\n  type BuildResult,\n} from \"./commands/build.js\";\nexport { frontmatterSchema, FRONTMATTER_SCHEMA_ID } from \"./schema.js\";\nexport {\n  runExport,\n  type ExportOptions,\n  type ExportResult,\n  type ExportFormat,\n} from \"./commands/export.js\";\nexport {\n  runQuery,\n  type QueryOptions,\n  type QueryResult,\n} from \"./commands/query.js\";\nexport {\n  runStats,\n  type CoverageRow,\n  type StatsOptions,\n  type StatsReport,\n} from \"./commands/stats.js\";\nexport {\n  runTraverse,\n  renderTraverse,\n  type TraverseOptions as TraverseCommandOptions,\n  type TraverseReport,\n} from \"./commands/traverse.js\";\nexport {\n  runSearch,\n  renderSearch,\n  type SearchHit,\n  type SearchOptions,\n  type SearchReport,\n} from \"./commands/search.js\";\nexport {\n  runEmbed,\n  renderEmbed,\n  embedText,\n  type EmbedOptions,\n  type EmbedReport,\n} from \"./commands/embed.js\";\nexport {\n  createLocalEmbedder,\n  createMockEmbedder,\n  EmbedderUnavailableError,\n  DEFAULT_MODEL,\n  MODEL_PROFILES,\n  profileFor,\n  withPrefix,\n  type EmbedRole,\n  type Embedder,\n  type LocalEmbedderOptions,\n  type MockEmbedderOptions,\n  type ModelProfile,\n} from \"./embed/index.js\";\nexport {\n  buildSearchIndex,\n  documentsByLanguage,\n  emitSearchIndex,\n  partitionByLanguage,\n  type SearchEntry,\n  type SearchIndexDoc,\n  type SearchIndexOptions,\n} from \"./core/search-index.js\";\nexport {\n  emitLocalizations,\n  LOCALIZATIONS_FILENAME,\n  parseLocalizations,\n  searchIndexFilename,\n  UNDETERMINED,\n  vectorIndexFilename,\n  type LocalizationEntry,\n  type LocalizationsDoc,\n  type SearchArtifact,\n  type VectorArtifact,\n} from \"./core/localizations.js\";\nexport {\n  runFill,\n  type FillOptions,\n  type FillReport,\n  type FillDocResult,\n} from \"./commands/fill.js\";\n// The inference layer is @hawkeyexl/inference; re-exported here so downstream\n// code that only depends on dockg can still construct providers and drive the\n// offline test seam without adding a second dependency.\nexport {\n  MockProvider,\n  type CompleteJSONRequest,\n  type CompleteJSONResponse,\n  type InferenceProvider,\n  type MockResponse,\n} from \"@hawkeyexl/inference\";\nexport {\n  assertProviderSelection,\n  constructProvider,\n  makeProvider,\n  providerSpecFor,\n  resolveProviderIdentity,\n  selectProvider,\n  type ProviderChoice,\n  type ProviderFlags,\n  type ProviderSelection,\n} from \"./llm/provider.js\";\n","/**\n * Context assembly (ADR 01018) — the runtime's terminal stage.\n *\n * Turns traversed nodes into the bundle an inference engine consumes:\n * `{ context, citations, trace, refusal? }`. **dockg stops here**: it never\n * calls a model. A different tool (an agent over MCP, a site backend) takes the\n * bundle onward, which keeps this runtime fully deterministic and keeps API\n * keys and inference cost outside dockg entirely.\n *\n * When nothing survives retrieval the result is a *structured refusal*, never\n * empty context — a caller must be able to tell \"no route exists\" apart from\n * \"here is nothing, proceed anyway\" (the disciplined-silence contract).\n *\n * Platform-neutral: no `node:` imports, no npm dependencies.\n */\nimport type { ContentResolver } from \"./resolve.js\";\nimport type { EntryCandidate, QueryTrace } from \"./trace.js\";\nimport { createTrace } from \"./trace.js\";\nimport type { TraversedNode } from \"./traverse.js\";\n\nexport interface ContextBlock {\n  iri: string;\n  title?: string;\n  text: string;\n  sourceUrl: string;\n  /** Hops from the nearest seed — the relevance signal, carried through. */\n  depth: number;\n}\n\nexport interface Citation {\n  iri: string;\n  title?: string;\n  sourceUrl: string;\n}\n\nexport type RefusalReason = \"no-route\" | \"no-content\";\n\nexport interface Refusal {\n  reason: RefusalReason;\n  detail: string;\n}\n\n/**\n * The rankings that produced the seeds, carried through to the caller.\n *\n * Retrieval answers two different questions — \"what matched the query?\" and\n * \"what is the graph connected to it?\" — and a consumer needs both. Returning\n * only the graph result would make the match rankings inferrable solely from the\n * trace, which is diagnostic rather than a result surface (ADR 01020).\n */\nexport interface EntryRankings {\n  /** The lexical leg's own ranking. */\n  lexical: EntryCandidate[];\n  /** The vector leg's own ranking; empty when no embedder was in play. */\n  vector: EntryCandidate[];\n  /** The fused ranking that actually seeded traversal. */\n  merged: EntryCandidate[];\n}\n\nexport interface RetrievalBundle {\n  /** What matched the query, per leg. Absent when seeds were given explicitly. */\n  entry?: EntryRankings;\n  context: ContextBlock[];\n  citations: Citation[];\n  trace: QueryTrace;\n  /** Present when retrieval found nothing usable. `context` is then empty. */\n  refusal?: Refusal;\n  /** True when the character budget dropped otherwise-eligible blocks. */\n  truncated: boolean;\n}\n\nexport interface AssembleOptions {\n  /** Character budget across all blocks. Default: unbounded. */\n  maxChars?: number;\n  /** Append to an existing trace (normally the traversal's). */\n  trace?: QueryTrace;\n  /**\n   * The entry rankings that produced these nodes, passed through to the bundle\n   * so callers see matches and graph results side by side.\n   */\n  entry?: EntryRankings;\n}\n\n/**\n * Resolve traversed nodes to text and assemble the retrieval bundle. Nodes are\n * kept in traversal order (nearest-first), which is deterministic, and every\n * block carries the IRI it came from so citations are structural, not inferred.\n */\nexport async function assemble(\n  resolver: ContentResolver,\n  nodes: TraversedNode[],\n  options: AssembleOptions = {},\n): Promise<RetrievalBundle> {\n  const trace = options.trace ?? createTrace();\n  const budget = options.maxChars ?? Infinity;\n\n  if (nodes.length === 0) {\n    return {\n      ...(options.entry ? { entry: options.entry } : {}),\n      context: [],\n      citations: [],\n      trace,\n      truncated: false,\n      refusal: {\n        reason: \"no-route\",\n        detail:\n          \"No node in the graph was reachable for this query under the active scope filter.\",\n      },\n    };\n  }\n\n  const context: ContextBlock[] = [];\n  let used = 0;\n  let truncated = false;\n  let resolvedAny = false;\n\n  for (const node of nodes) {\n    const resolved = await resolver.resolve(node.iri);\n    if (!resolved) continue;\n    resolvedAny = true;\n    if (used + resolved.text.length > budget) {\n      truncated = true;\n      continue;\n    }\n    used += resolved.text.length;\n    context.push({\n      iri: resolved.iri,\n      title: resolved.title,\n      text: resolved.text,\n      sourceUrl: resolved.sourceUrl,\n      depth: node.depth,\n    });\n  }\n\n  if (context.length === 0) {\n    return {\n      ...(options.entry ? { entry: options.entry } : {}),\n      context: [],\n      citations: [],\n      trace,\n      truncated,\n      refusal: {\n        reason: \"no-content\",\n        detail: resolvedAny\n          ? \"Every matching node's content exceeded the character budget.\"\n          : \"Matching nodes were found, but none of them resolved to readable content.\",\n      },\n    };\n  }\n\n  return {\n    ...(options.entry ? { entry: options.entry } : {}),\n    context,\n    citations: context.map((b) => ({\n      iri: b.iri,\n      title: b.title,\n      sourceUrl: b.sourceUrl,\n    })),\n    trace,\n    truncated,\n  };\n}\n","/**\n * RDF/JS interop — the custom-SPARQL escape hatch (ADR 01018).\n *\n * The runtime's own walker is deliberately not a SPARQL engine: it is 0 KB and\n * it records a trace. But arbitrary user-authored SPARQL is a legitimate need,\n * so the index can hand out its contents as standard **RDF/JS quads**. Feed\n * them to any RDF/JS store and query with any engine:\n *\n * ```js\n * import { Store } from \"n3\";\n * import { QueryEngine } from \"@comunica/query-sparql-rdfjs-lite\";\n * const store = new Store(rdfjsQuads(graph));\n * const bindings = await new QueryEngine().queryBindings(sparql, { sources: [store] });\n * ```\n *\n * Quads are plain data rather than a hand-rolled `Source` stream on purpose:\n * every engine already accepts a store, stores accept quad arrays, and faking\n * Node's stream contract in a browser-safe module is fragile for no gain. At\n * docs scale materializing is trivial (the reference corpus is 172 quads).\n *\n * Honest caveat: engine results are bindings, not walker traces —\n * explainability lives in the walker API.\n *\n * The term shapes are structural, so they are hand-rolled here rather than\n * pulled from `@rdfjs/data-model`, keeping the runtime dependency-free and\n * browser-safe.\n */\nimport { byCodeUnit } from \"../core/sort.js\";\nimport type { GraphIndex, Value } from \"./graph.js\";\n\nconst XSD_STRING = \"http://www.w3.org/2001/XMLSchema#string\";\n\nexport interface RdfTerm {\n  termType: \"NamedNode\" | \"Literal\" | \"DefaultGraph\";\n  value: string;\n  language?: string;\n  datatype?: RdfTerm;\n  equals(other?: RdfTerm | null): boolean;\n}\n\nexport interface RdfQuad {\n  termType: \"Quad\";\n  subject: RdfTerm;\n  predicate: RdfTerm;\n  object: RdfTerm;\n  graph: RdfTerm;\n  equals(other?: RdfQuad | null): boolean;\n}\n\nexport function namedNode(value: string): RdfTerm {\n  return {\n    termType: \"NamedNode\",\n    value,\n    equals(other) {\n      return !!other && other.termType === \"NamedNode\" && other.value === value;\n    },\n  };\n}\n\nexport function defaultGraph(): RdfTerm {\n  return {\n    termType: \"DefaultGraph\",\n    value: \"\",\n    equals(other) {\n      return !!other && other.termType === \"DefaultGraph\";\n    },\n  };\n}\n\nexport function literal(value: string, datatype?: string): RdfTerm {\n  const dt = namedNode(datatype ?? XSD_STRING);\n  return {\n    termType: \"Literal\",\n    value,\n    language: \"\",\n    datatype: dt,\n    equals(other) {\n      return (\n        !!other &&\n        other.termType === \"Literal\" &&\n        other.value === value &&\n        !!other.datatype &&\n        other.datatype.value === dt.value\n      );\n    },\n  };\n}\n\nfunction toTerm(v: Value): RdfTerm {\n  return v.kind === \"iri\" ? namedNode(v.value) : literal(v.value, v.datatype);\n}\n\nfunction makeQuad(s: string, p: string, o: Value): RdfQuad {\n  const subject = namedNode(s);\n  const predicate = namedNode(p);\n  const object = toTerm(o);\n  const graph = defaultGraph();\n  return {\n    termType: \"Quad\",\n    subject,\n    predicate,\n    object,\n    graph,\n    equals(other) {\n      return (\n        !!other &&\n        subject.equals(other.subject) &&\n        predicate.equals(other.predicate) &&\n        object.equals(other.object)\n      );\n    },\n  };\n}\n\n/**\n * The whole index as RDF/JS quads, in the index's deterministic order. Feed to\n * any RDF/JS store (`new Store(rdfjsQuads(graph))`) to run SPARQL.\n */\nexport function rdfjsQuads(graph: GraphIndex): RdfQuad[] {\n  const quads: RdfQuad[] = [];\n  for (const s of graph.ids()) {\n    const node = graph.node(s);\n    if (!node) continue;\n    for (const p of [...node.props.keys()].sort(byCodeUnit)) {\n      for (const v of node.props.get(p) ?? []) quads.push(makeQuad(s, p, v));\n    }\n  }\n  return quads;\n}\n\n/**\n * Triple-pattern match returning RDF/JS quads. A null/undefined position is a\n * wildcard. Convenience for callers who want RDF/JS terms without pulling in a\n * store; the walker API is the richer (and traced) way to query.\n */\nexport function matchQuads(\n  graph: GraphIndex,\n  subject?: string | null,\n  predicate?: string | null,\n  object?: string | null,\n): RdfQuad[] {\n  const quads: RdfQuad[] = [];\n  const subjects = subject ? [subject] : graph.ids();\n  for (const s of subjects) {\n    const node = graph.node(s);\n    if (!node) continue;\n    const predicates = predicate\n      ? [predicate]\n      : [...node.props.keys()].sort(byCodeUnit);\n    for (const p of predicates) {\n      for (const v of node.props.get(p) ?? []) {\n        if (object !== undefined && object !== null && v.value !== object) {\n          continue;\n        }\n        quads.push(makeQuad(s, p, v));\n      }\n    }\n  }\n  return quads;\n}\n","/**\n * The page vocabulary manni graph implements: `manni:graph:1.0.0`, the built-in\n * schema the metadata tool publishes under `src/meta/schemas/`. It defines the\n * `graph:` block a page carries. Pages are validated against that schema\n * itself, imported and bundled into the build, so graph and `manni meta validate`\n * read the same bytes.\n *\n * graph ships no copy of the schema. A copy is a second artifact to keep in step,\n * with nothing but a test to say the two still match. A consumer who wants to\n * validate pages names `manni:graph:1.0.0` to `manni meta validate`, or\n * validates programmatically against the object below.\n */\nimport schema from \"../meta/schemas/graph/1.0.0.json\" with { type: \"json\" };\n\n/** The graph vocabulary, for validators that accept an inline schema. */\nexport const frontmatterSchema = schema as Record<string, unknown>;\n\n/** The vocabulary's `$id`: `manni:graph:1.0.0`. */\nexport const FRONTMATTER_SCHEMA_ID: string = schema.$id;\n","/**\n * The key domain's programmatic API, exported from the package as the `key`\n * namespace: `import { key } from \"@hawkeyexl/manni\"`. The command cores, and\n * the family's encryption primitives a caller needs beside them.\n */\nexport * from \"./types.js\";\nexport { KeyError } from \"./errors.js\";\nexport { runKeySet } from \"./commands/set.js\";\nexport { runKeyRotate } from \"./commands/rotate.js\";\nexport { decryptValue, encryptValue, isEncryptedValue } from \"../shared/encryption.js\";\nexport type { EncryptionContext } from \"../shared/encryption.js\";\nexport { resolveEncryptionKey } from \"../shared/encryption-key.js\";\nexport type { KeySource, ResolvedKey } from \"../shared/encryption-key.js\";\n"],"mappings":"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","names":["REPORT_FORMATS","loadConfig","parseConfig","render","renderFill","runFill","classifyRef","listBuiltins","loadConfig","parseConfig","render","renderJunit","renderSarif","supportedExtensions","FRONTMATTER_SCHEMA_ID","MockProvider","frontmatterSchema","loadConfig","makeProvider","parseConfig","providerSpecFor","resolveProviderIdentity","runFill","runQuery","frontmatterSchema","FRONTMATTER_SCHEMA_ID","MockProvider"]}