@c4a/context 0.7.8 → 0.7.9

package/docs/reference/project-api.md

@@ -65,6 +65,51 @@ worksets, Candidate creation, Review application and delivery. Code, Markdown,
 Note and Sessions Providers can use authorized supporting documents without
 creating a second capture or knowledge pipeline.
 
+### Batch capture from the source registry
+
+When all registered Lark documents are intended for this project and share capture
+settings, read the registry once instead of copying its module names into
+`src/index.ts`. For the standard `src/index.ts` entry:
+
+```ts
+import { fileURLToPath } from "node:url";
+import {
+  allSources, captureLark, defineProject, loadSourcesRegistry, source,
+} from "@c4a/context";
+
+const workspaceRoot = fileURLToPath(new URL("../", import.meta.url));
+const registry = await loadSourcesRegistry({ rootDir: workspaceRoot });
+const documents = registry.larks.map(entry =>
+  source(entry.name, { type: "lark" }),
+);
+
+export default defineProject({
+  sources: [...allSources("repo"), ...documents],
+  phases: documents.map(document => captureLark({ source: document })),
+  packages: [],
+});
+```
+
+Merge this pattern into existing declarations; preserve unrelated phases and
+package outputs. Adjust the root calculation if the entry lives elsewhere.
+Registry loading only reads local registrations; it does not fetch documents.
+
+- `sources/lark/index.yaml` owns document identities, URLs and titles. The project
+  selects those identities and declares capture settings. This example includes
+  future registrations too; use it only when the entire registered set is intended.
+- For a subset, filter registry entries by the intended namespace or names before
+  mapping. Apply exceptional resource settings within the same map instead of
+  declaring a second phase for the same document.
+- File documents use `registry.files`, `source(entry.name, { type: "file" })`
+  and `captureFile`. Group by actual processor needs; do not apply `mdxJsonDocs()`
+  indiscriminately to all file sources.
+- `allSources("lark")` selects a collection; its array contains a collection
+  reference, not individual documents. It neither expands capture phases nor
+  supports mapping its entries into `captureLark`.
+- The map declares one phase per document. It does not fetch URLs, change capture
+  permissions, or request parallel execution. Run the declared phases through the
+  existing CLI flow so each document retains independent refresh and retry behavior.
+
 ## `customPhase`
 
 ```ts
@@ -83,6 +128,7 @@ kbPackage({
   name: "component-kb",
   template: "src/package-templates/kb",
   select: { collections: ["codeindex", "architecture"] },
+  site: { title: "Component knowledge", lang: "en-US", base: "/" },
 });
 
 llmsPackage({
@@ -95,6 +141,13 @@ llmsPackage({
 Package selection reads approved `knowledge/` only. `dist/` is generated and
 may be rebuilt; it is not an authoring source.
 
+`kbPackage.site` optionally adds a VitePress website at `dist/<base>-site/` in
+the same build, beside the KB directory. `<base>` removes one trailing `-kb`
+from the package name, if present. Omit it for KB-only output. It accepts `title`, `description`,
+`lang` and a deployment `base` path. Knowledge map is projected from
+`src/knowledge-map.yaml` independently of KB directories; see
+[Package Outputs](../guides/package-outputs.md#optional-static-documentation-website).
+
 ## Indexer registry
 
 When this file is absent, the configuration Route supplies the initial schema:

package/index.d.ts

@@ -1,3 +1,5 @@
+import { type PackageSiteDefinition } from "./packageSite.js";
+export { packageSiteSchema, type PackageSiteDefinition } from "./packageSite.js";
 import type { PackageNavigationDefinition, PackageSelectDefinition } from "./contracts.js";
 import type { PhaseDefinition, PhaseResourceReference } from "./phases.js";
 import type { ProjectSourceDefinition } from "./sources.js";
@@ -109,6 +111,7 @@ export type KbPackageDefinition = BasePackageDefinition & {
     navigation: PackageNavigationDefinition;
     distribution?: PackageDistributionDefinition;
     assets?: PackageAssetDefinition;
+    site?: PackageSiteDefinition;
 };
 export type LlmsPackageDefinition = BasePackageDefinition & {
     kind: "package.llms";
@@ -131,6 +134,7 @@ export declare const kbPackage: (definition: {
     navigation?: Partial<PackageNavigationDefinition>;
     distribution?: PackageDistributionDefinition;
     assets?: PackageAssetDefinition;
+    site?: PackageSiteDefinition;
 }) => KbPackageDefinition;
 export declare const llmsPackage: (definition: {
     name: string;
@@ -145,6 +149,6 @@ export { sessionChangeSchema, sessionChangesSchema, readSessionChanges, writeSes
 export type { SessionChange } from "./sessionMetadata.js";
 export { indexerArticleKeySchema, indexerArticlePlanSchema, validateIndexerArticlePlan, indexerArticleSectionKey, validateIndexerPlannedArticles } from "./indexerArticlePlan.js";
 export type { IndexerArticlePlan } from "./indexerArticlePlan.js";
-export * from "./readingStructure.js";
+export * from "./knowledgeMap.js";
 export * from "./indexerKnowledgeDependency.js";
 export * from "./indexerApprovedKnowledge.js";

package/index.js

@@ -6915,55 +6915,6 @@ var require_public_api = __commonJS((exports) => {
   exports.stringify = stringify;
 });
 
-// src/contracts.ts
-var DEFAULT_PACKAGE_NAVIGATION = {
-  foldDirectoryIndexes: true,
-  maxInlineEntries: 50
-};
-var DOC_MAINLINE_COLLECTIONS = [
-  "business",
-  "product",
-  "architecture",
-  "sop",
-  "faq",
-  "standards",
-  "decision",
-  "incident",
-  "test"
-];
-var MAINLINE_COLLECTIONS = ["codeindex", "codegraph", ...DOC_MAINLINE_COLLECTIONS];
-var TOP_LEVEL_NAMESPACES = [...MAINLINE_COLLECTIONS, "feats"];
-var OKF_ROOTS = ["guides", "rules", "wikis", "feats"];
-var KNOWLEDGE_COLLECTIONS = TOP_LEVEL_NAMESPACES;
-function assertKnowledgeCollection(value, field) {
-  if (!KNOWLEDGE_COLLECTIONS.includes(value)) {
-    throw new TypeError(`${field} must be one of ${KNOWLEDGE_COLLECTIONS.join(", ")}: ${value}`);
-  }
-}
-function assertDocumentMainlineCollection(value, field) {
-  if (!DOC_MAINLINE_COLLECTIONS.includes(value)) {
-    throw new TypeError(`${field} must be one of ${DOC_MAINLINE_COLLECTIONS.join(", ")}: ${value}`);
-  }
-}
-function assertMainlineCollection(value, field) {
-  if (!MAINLINE_COLLECTIONS.includes(value)) {
-    throw new TypeError(`${field} must be one of ${MAINLINE_COLLECTIONS.join(", ")}: ${value}`);
-  }
-}
-function assertTopLevelNamespace(value, field) {
-  if (!TOP_LEVEL_NAMESPACES.includes(value)) {
-    throw new TypeError(`${field} must be one of ${TOP_LEVEL_NAMESPACES.join(", ")}: ${value}`);
-  }
-}
-function assertOkfRoot(value, field) {
-  if (!OKF_ROOTS.includes(value)) {
-    throw new TypeError(`${field} must be one of ${OKF_ROOTS.join(", ")}: ${value}`);
-  }
-}
-
-// src/indexerProtocolCommon.ts
-import { createHash } from "node:crypto";
-
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -10937,6 +10888,133 @@ var coerce = {
   date: (arg) => ZodDate.create({ ...arg, coerce: true })
 };
 var NEVER = INVALID;
+// src/packageSite.ts
+var packageSiteSchema = exports_external.object({
+  title: exports_external.string().trim().min(1).optional(),
+  description: exports_external.string().optional(),
+  lang: exports_external.string().min(1).default("en-US"),
+  base: exports_external.string().regex(/^\/(?:[a-zA-Z0-9_-]+\/)*$/, "Use / or a slash-delimited deployment path, such as /docs/").default("/")
+}).strict();
+function normalizePackageSite(value) {
+  return value === undefined ? undefined : packageSiteSchema.parse(value);
+}
+// src/contracts.ts
+var DEFAULT_PACKAGE_NAVIGATION = {
+  foldDirectoryIndexes: true,
+  maxInlineEntries: 50
+};
+var DOC_MAINLINE_COLLECTIONS = [
+  "business",
+  "product",
+  "architecture",
+  "sop",
+  "faq",
+  "standards",
+  "decision",
+  "incident",
+  "test"
+];
+var MAINLINE_COLLECTIONS = ["codeindex", "codegraph", ...DOC_MAINLINE_COLLECTIONS];
+var TOP_LEVEL_NAMESPACES = [...MAINLINE_COLLECTIONS, "feats"];
+var OKF_ROOTS = ["guides", "rules", "wikis", "feats"];
+var KNOWLEDGE_COLLECTIONS = TOP_LEVEL_NAMESPACES;
+function assertKnowledgeCollection(value, field) {
+  if (!KNOWLEDGE_COLLECTIONS.includes(value)) {
+    throw new TypeError(`${field} must be one of ${KNOWLEDGE_COLLECTIONS.join(", ")}: ${value}`);
+  }
+}
+function assertDocumentMainlineCollection(value, field) {
+  if (!DOC_MAINLINE_COLLECTIONS.includes(value)) {
+    throw new TypeError(`${field} must be one of ${DOC_MAINLINE_COLLECTIONS.join(", ")}: ${value}`);
+  }
+}
+function assertMainlineCollection(value, field) {
+  if (!MAINLINE_COLLECTIONS.includes(value)) {
+    throw new TypeError(`${field} must be one of ${MAINLINE_COLLECTIONS.join(", ")}: ${value}`);
+  }
+}
+function assertTopLevelNamespace(value, field) {
+  if (!TOP_LEVEL_NAMESPACES.includes(value)) {
+    throw new TypeError(`${field} must be one of ${TOP_LEVEL_NAMESPACES.join(", ")}: ${value}`);
+  }
+}
+function assertOkfRoot(value, field) {
+  if (!OKF_ROOTS.includes(value)) {
+    throw new TypeError(`${field} must be one of ${OKF_ROOTS.join(", ")}: ${value}`);
+  }
+}
+
+// src/indexerProtocolHash.ts
+import { createHash } from "node:crypto";
+function hashCanonicalIndexerJson(value, fallback) {
+  const hash = createHash("sha256");
+  let buffer = "";
+  const unsupported = Symbol("non-json value");
+  const active = new Set;
+  const append = (text) => {
+    buffer += text;
+    if (buffer.length >= 16384) {
+      hash.update(buffer);
+      buffer = "";
+    }
+  };
+  const visit = (item) => {
+    if (item === null || typeof item !== "object") {
+      const text = JSON.stringify(item);
+      if (text === undefined)
+        throw unsupported;
+      append(text);
+      return;
+    }
+    if (active.has(item))
+      throw unsupported;
+    active.add(item);
+    if (Array.isArray(item)) {
+      append("[");
+      for (let i = 0;i < item.length; i++) {
+        if (i !== 0)
+          append(",");
+        const child = item[i];
+        if (child === undefined || typeof child === "function" || typeof child === "symbol")
+          append("null");
+        else
+          visit(child);
+      }
+      append("]");
+    } else {
+      const entries = Object.entries(item).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0);
+      if (entries.some(([key, child]) => key === "toJSON" && typeof child === "function"))
+        throw unsupported;
+      const ordered = Object.fromEntries(entries);
+      append("{");
+      let first = true;
+      for (const key of Object.keys(ordered)) {
+        const child = ordered[key];
+        if (child === undefined || typeof child === "function" || typeof child === "symbol")
+          continue;
+        if (!first)
+          append(",");
+        first = false;
+        append(JSON.stringify(key));
+        append(":");
+        visit(child);
+      }
+      append("}");
+    }
+    active.delete(item);
+  };
+  try {
+    visit(value);
+    if (buffer)
+      hash.update(buffer);
+    return `sha256:${hash.digest("hex")}`;
+  } catch (error) {
+    if (error !== unsupported)
+      throw error;
+    return `sha256:${createHash("sha256").update(fallback(value)).digest("hex")}`;
+  }
+}
+
 // src/indexerProtocolCommon.ts
 var INDEXER_PROVIDER_MANIFEST_NAME = "context-indexer.yaml";
 var DEFAULT_INDEXER_REGISTRY_PATH = "src/indexers.yaml";
@@ -11031,7 +11109,7 @@ function canonicalIndexerJson(value) {
   return JSON.stringify(canonicalize(value));
 }
 function indexerProtocolDigest(value) {
-  return `sha256:${createHash("sha256").update(canonicalIndexerJson(value)).digest("hex")}`;
+  return hashCanonicalIndexerJson(value, canonicalIndexerJson);
 }
 function formatIndexerSchemaIssues(issues) {
   return issues.map((issue) => {
@@ -13723,7 +13801,7 @@ var providerLayerSchema = exports_external.object({
     });
   }
 });
-var indexerRegistryEntrySchema = exports_external.object({
+var indexerRegistryEntryInputSchema = exports_external.object({
   id: indexerIdSchema,
   operations: exports_external.array(exports_external.enum(INDEXER_SEMANTIC_OPERATIONS)).min(1).default(["main-index"]),
   requirement_bindings: exports_external.array(requirementBindingSchema).min(1),
@@ -13737,7 +13815,8 @@ var indexerRegistryEntrySchema = exports_external.object({
   customization: exports_external.object({
     mode: exports_external.enum(["extend", "replace"])
   }).strict().optional()
-}).strict().transform((value) => ({
+}).strict();
+var indexerRegistryEntrySchema = indexerRegistryEntryInputSchema.transform((value) => ({
   ...value,
   read_scope: value.read_scope ?? {
     refs: [...new Set(value.requirement_bindings.flatMap((binding) => binding.role === "primary" ? [
@@ -28184,8 +28263,8 @@ function validateIndexerAgentStepInput(value) {
   }
   return input;
 }
-// src/readingStructure.ts
-var readingStructureEntrySchema = exports_external.object({
+// src/knowledgeMap.ts
+var knowledgeMapEntrySchema = exports_external.object({
   key: exports_external.string().min(1),
   parent: exports_external.string().min(1).nullable(),
   title: exports_external.string().min(1),
@@ -28195,51 +28274,51 @@ var readingStructureEntrySchema = exports_external.object({
     section_key: exports_external.string().min(1).optional()
   }).strict().optional()
 }).strict();
-var readingStructureUpdateSchema = exports_external.object({
+var knowledgeMapUpdateSchema = exports_external.object({
   expected_revision: exports_external.string().nullable(),
-  upsert: exports_external.array(readingStructureEntrySchema).default([]),
+  upsert: exports_external.array(knowledgeMapEntrySchema).default([]),
   remove: exports_external.array(exports_external.string().min(1)).default([])
 }).strict();
-var readingStructureSchema = exports_external.object({
-  protocol: exports_external.literal("context.reading-structure/v1"),
+var knowledgeMapSchema = exports_external.object({
+  protocol: exports_external.literal("context.knowledge-map/v1"),
   revision: exports_external.string().min(1),
-  entries: exports_external.array(readingStructureEntrySchema)
+  entries: exports_external.array(knowledgeMapEntrySchema)
 }).strict();
 function validateEntries(entries) {
   const indexed = new Map(entries.map((entry) => [entry.key, entry]));
   if (indexed.size !== entries.length)
-    throw new TypeError("reading entries must have unique keys");
+    throw new TypeError("knowledge-map entries must have unique keys");
   for (const entry of entries) {
     const visited = new Set;
     let current = entry;
     while (current !== undefined) {
       if (visited.has(current.key))
-        throw new TypeError("reading structure contains a parent cycle");
+        throw new TypeError("knowledge map contains a parent cycle");
       visited.add(current.key);
       if (current.parent === null)
         break;
       const parent = indexed.get(current.parent);
       if (parent === undefined)
-        throw new TypeError(`reading entry ${current.key} has an unknown parent`);
+        throw new TypeError(`knowledge-map entry ${current.key} has an unknown parent`);
       current = parent;
     }
   }
 }
-function validateReadingStructure(value) {
-  const result = readingStructureSchema.parse(value);
+function validateKnowledgeMap(value) {
+  const result = knowledgeMapSchema.parse(value);
   validateEntries(result.entries);
   const { revision, ...payload2 } = result;
   if (indexerProtocolDigest(payload2) !== revision)
-    throw new TypeError("reading structure revision does not match its content");
+    throw new TypeError("knowledge map revision does not match its content");
   return result;
 }
-function updateReadingStructure(current, value) {
-  const update = readingStructureUpdateSchema.parse(value);
+function updateKnowledgeMap(current, value) {
+  const update = knowledgeMapUpdateSchema.parse(value);
   if ((current?.revision ?? null) !== update.expected_revision)
-    throw new TypeError("reading structure changed; reread the current structure before applying this edit");
+    throw new TypeError("knowledge map changed; reread the current structure before applying this edit");
   const keys = update.upsert.map((entry) => entry.key);
   if (new Set(keys).size !== keys.length || new Set(update.remove).size !== update.remove.length || keys.some((key) => update.remove.includes(key))) {
-    throw new TypeError("reading structure update contains conflicting entry identities");
+    throw new TypeError("knowledge map update contains conflicting entry identities");
   }
   const entries = new Map(current?.entries.map((entry) => [entry.key, entry]) ?? []);
   for (const key of update.remove)
@@ -28247,13 +28326,13 @@ function updateReadingStructure(current, value) {
   for (const entry of update.upsert)
     entries.set(entry.key, entry);
   const payload2 = {
-    protocol: "context.reading-structure/v1",
+    protocol: "context.knowledge-map/v1",
     entries: [...entries.values()].sort((a, b) => a.key < b.key ? -1 : a.key > b.key ? 1 : 0)
   };
   validateEntries(payload2.entries);
   return { ...payload2, revision: indexerProtocolDigest(payload2) };
 }
-function projectReadingStructure(structure, targets) {
+function projectKnowledgeMap(structure, targets) {
   const children = new Map;
   for (const entry of structure.entries)
     children.set(entry.parent, [...children.get(entry.parent) ?? [], entry]);
@@ -28261,10 +28340,10 @@ function projectReadingStructure(structure, targets) {
   function project(parent) {
     return (children.get(parent) ?? []).sort((a, b) => a.order - b.order || a.key.localeCompare(b.key)).flatMap((entry) => {
       const descendants = project(entry.key);
-      const identity2 = entry.target === undefined ? undefined : readingTargetKey(entry.target);
+      const identity2 = entry.target === undefined ? undefined : knowledgeMapTargetKey(entry.target);
       const href = identity2 === undefined ? undefined : targets.get(identity2);
       if (identity2 !== undefined && href === undefined)
-        warnings.push({ entry: entry.key, code: "reading-target-unavailable", target: identity2 });
+        warnings.push({ entry: entry.key, code: "knowledge-map-target-unavailable", target: identity2 });
       if (href === undefined && descendants.length === 0)
         return [];
       return [{ key: entry.key, title: entry.title, ...href === undefined ? {} : { href }, children: descendants }];
@@ -28272,11 +28351,23 @@ function projectReadingStructure(structure, targets) {
   }
   return { entries: project(null), warnings };
 }
-function readingTargetKey(target) {
+function knowledgeMapTargetKey(target) {
   return target.section_key === undefined ? target.artifact_ref : `${target.artifact_ref}#${encodeURIComponent(target.section_key)}`;
 }
 
 // src/indexerSemanticInput.ts
+var catalogProviderSelectionSchema = exports_external.object({
+  id: indexerIdSchema,
+  role: exports_external.enum(["primary", "extension"]).default("primary"),
+  catalog_skill: indexerIdSchema,
+  config: exports_external.record(indexerJsonSchema).optional()
+}).strict();
+var providerSelectionEntrySchema = indexerRegistryEntryInputSchema.extend({
+  providers: exports_external.array(exports_external.union([
+    catalogProviderSelectionSchema,
+    indexerRegistryEntryInputSchema.shape.providers.element
+  ])).min(1)
+});
 var providerObservationSchema = exports_external.object({
   skill: exports_external.string().min(1),
   version: exports_external.string().min(1).nullable(),
@@ -28290,7 +28381,7 @@ var providerObservationSchema = exports_external.object({
 var indexerProviderSelectionSemanticInputSchema = exports_external.object({
   stage: exports_external.literal("provider-selection"),
   host_visible_skills: exports_external.array(providerObservationSchema).default([]),
-  indexers: exports_external.array(indexerRegistryEntrySchema).min(1)
+  indexers: exports_external.array(providerSelectionEntrySchema).min(1)
 }).strict();
 var indexerProviderResolutionSemanticInputSchema = exports_external.object({
   stage: exports_external.literal("provider-resolution"),
@@ -28558,7 +28649,7 @@ var indexerPostAuthorBatchSemanticInputSchema = exports_external.object({
 });
 var structureReviewBaseSchema = exports_external.object({
   stage: exports_external.literal("structure-review"),
-  reading_structure: readingStructureUpdateSchema.optional(),
+  knowledge_map: knowledgeMapUpdateSchema.optional(),
   decision: exports_external.enum(["approved", "exclude-obsolete", "request-adjustment"]),
   feedback: exports_external.string().min(1).optional()
 }).strict();
@@ -34418,12 +34509,14 @@ var kbPackage = (definition) => {
   const base = createPackageDefinitionBase("kb", definition);
   const distribution = normalizePackageDistribution(definition.distribution);
   const assets = normalizePackageAssets(definition.assets);
+  const site = normalizePackageSite(definition.site);
   return {
     kind: "package.kb",
     ...base,
     navigation: normalizePackageNavigation(definition.navigation),
     ...distribution === undefined ? {} : { distribution },
-    assets
+    assets,
+    ...site === undefined ? {} : { site }
   };
 };
 var llmsPackage = (definition) => ({
@@ -34435,7 +34528,7 @@ export {
   validatedIndexerCustomizationDraftSchema,
   validateValidatedIndexerCustomizationDraft,
   validateResolvedProviderBundle,
-  validateReadingStructure,
+  validateKnowledgeMap,
   validateIndexerToolSnapshot,
   validateIndexerTargetResolutionView,
   validateIndexerSubjectKeyForSchema,
@@ -34575,7 +34668,7 @@ export {
   validateArtifactResults,
   validateAndRecordIndexerMainRun,
   validateAndMaterializeIndexerLayerFragment,
-  updateReadingStructure,
+  updateKnowledgeMap,
   startIndexerPostAuthorRun,
   startIndexerMainRuns,
   startIndexerMainRun,
@@ -34609,14 +34702,10 @@ export {
   recoverIndexerPostAuthorRunLedger,
   recoverIndexerMainRunLedger,
   reconcileIndexerResults,
-  readingTargetKey,
-  readingStructureUpdateSchema,
-  readingStructureSchema,
-  readingStructureEntrySchema,
   readSessionChanges,
   readProcessedScopes,
   questionPairs,
-  projectReadingStructure,
+  projectKnowledgeMap,
   projectIndexerSourceIdentityInventory,
   projectIndexerPublicContractTable,
   projectIndexerPartitionSubjects,
@@ -34630,6 +34719,7 @@ export {
   parseIndexerRegistry,
   parseIndexerProviderManifest,
   parseIndexerCurrentActionSubmission,
+  packageSiteSchema,
   ownerCells,
   observeIndexerPostAuthorState,
   observeIndexerMainWorksetState,
@@ -34651,6 +34741,10 @@ export {
   loadIndexerRegistry,
   loadIndexerProviderManifest,
   llmsPackage,
+  knowledgeMapUpdateSchema,
+  knowledgeMapTargetKey,
+  knowledgeMapSchema,
+  knowledgeMapEntrySchema,
   kbPackage,
   isPortableIndexerPath,
   isIndexerProviderProtocol,

package/indexerArtifactPolicy.d.ts

@@ -10,11 +10,11 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
         path: z.ZodString;
         value: z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>;
     }, "strict", z.ZodTypeAny, {
-        path: string;
         value: IndexerJson;
-    }, {
         path: string;
+    }, {
         value: IndexerJson;
+        path: string;
     }>, "many">;
     provider_supported_variants: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     eligible_variants: z.ZodArray<z.ZodObject<{
@@ -71,8 +71,8 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
     profile_id: string;
     profile_contract_digest: string;
     canonical_facts: {
-        path: string;
         value: IndexerJson;
+        path: string;
     }[];
     provider_supported_variants: string[];
     eligible_variants: {
@@ -94,8 +94,8 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
     profile_id: string;
     profile_contract_digest: string;
     canonical_facts: {
-        path: string;
         value: IndexerJson;
+        path: string;
     }[];
     provider_supported_variants: string[];
     eligible_variants: {

package/indexerProtocolHash.d.ts

@@ -0,0 +1,2 @@
+/** Hash canonical JSON without retaining a second object tree and full JSON string. */
+export declare function hashCanonicalIndexerJson(value: unknown, fallback: (value: unknown) => string): string;