@c4a/context 0.7.5 → 0.7.9

package/{indexerGeneratedAuthoringAudit.d.ts → indexerStructuredClaims.d.ts}

@@ -1,5 +1,4 @@
 import { z } from "zod";
-import type { IndexerArtifactResult } from "./indexerArtifactResult.js";
 declare const structuredClaimSchema: z.ZodObject<{
     claim_ref: z.ZodString;
     claim_kind: z.ZodEffects<z.ZodString, string, string>;
@@ -104,86 +103,7 @@ export declare const indexerStructuredClaimSetSchema: z.ZodObject<{
     }[];
     claims_digest: string;
 }>;
-export declare const indexerGeneratedAuthoringAuditSchema: z.ZodObject<{
-    protocol: z.ZodLiteral<"context.indexer.generated-authoring-audit/v1">;
-    artifact_result_digest: z.ZodString;
-    hard_findings: z.ZodArray<z.ZodObject<{
-        code: z.ZodEnum<["generated-placeholder", "empty-required-section"]>;
-        artifact_id: z.ZodEffects<z.ZodString, string, string>;
-        section_key: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
-        content_ref: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        code: "generated-placeholder" | "empty-required-section";
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-    }, {
-        code: "generated-placeholder" | "empty-required-section";
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-    }>, "many">;
-    structured_claim_count: z.ZodNumber;
-    evidence_covered_structured_claim_count: z.ZodNumber;
-    semantic_prose_review_targets: z.ZodArray<z.ZodObject<{
-        artifact_id: z.ZodEffects<z.ZodString, string, string>;
-        section_key: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
-        content_ref: z.ZodString;
-        advisory_code: z.ZodLiteral<"semantic-prose-agent-review-required">;
-    }, "strict", z.ZodTypeAny, {
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-        advisory_code: "semantic-prose-agent-review-required";
-    }, {
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-        advisory_code: "semantic-prose-agent-review-required";
-    }>, "many">;
-    agent_review_required: z.ZodBoolean;
-    audit_digest: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    protocol: "context.indexer.generated-authoring-audit/v1";
-    artifact_result_digest: string;
-    hard_findings: {
-        code: "generated-placeholder" | "empty-required-section";
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-    }[];
-    structured_claim_count: number;
-    evidence_covered_structured_claim_count: number;
-    semantic_prose_review_targets: {
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-        advisory_code: "semantic-prose-agent-review-required";
-    }[];
-    agent_review_required: boolean;
-    audit_digest: string;
-}, {
-    protocol: "context.indexer.generated-authoring-audit/v1";
-    artifact_result_digest: string;
-    hard_findings: {
-        code: "generated-placeholder" | "empty-required-section";
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-    }[];
-    structured_claim_count: number;
-    evidence_covered_structured_claim_count: number;
-    semantic_prose_review_targets: {
-        section_key: string | null;
-        artifact_id: string;
-        content_ref: string;
-        advisory_code: "semantic-prose-agent-review-required";
-    }[];
-    agent_review_required: boolean;
-    audit_digest: string;
-}>;
 export type IndexerStructuredClaimSet = z.infer<typeof indexerStructuredClaimSetSchema>;
-export type IndexerGeneratedAuthoringAudit = z.infer<typeof indexerGeneratedAuthoringAuditSchema>;
 export declare function buildIndexerStructuredClaimSet(input: {
     author_workset_digest: string;
     logical_unit_ref: string;
@@ -201,8 +121,4 @@ export declare function validateIndexerStructuredClaimSet(input: {
         evidence_refs: readonly string[];
     }[];
 }): IndexerStructuredClaimSet;
-export declare function containsIndexerControlledAuthoringPlaceholder(markdown: string): boolean;
-export declare function buildIndexerGeneratedAuthoringAudit(result: IndexerArtifactResult): IndexerGeneratedAuthoringAudit;
-export declare function validateIndexerGeneratedAuthoringAudit(value: unknown): IndexerGeneratedAuthoringAudit;
-export declare function assertIndexerGeneratedAuthoringAuditClear(audit: IndexerGeneratedAuthoringAudit): void;
 export {};

package/indexerStructuredDeclaration.d.ts

@@ -207,7 +207,7 @@ declare const declarationPayloadSchema: z.ZodObject<{
     module_ref: string | null;
     carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
     carrier_ref: string;
-    declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+    declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
     target: {
         normalized_path: string;
         target_type: "directory";
@@ -228,7 +228,7 @@ declare const declarationPayloadSchema: z.ZodObject<{
     module_ref: string | null;
     carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
     carrier_ref: string;
-    declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+    declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
     target: {
         normalized_path: string;
         target_type: "directory";
@@ -299,7 +299,7 @@ export declare const indexerStructuredDeclarationSchema: z.ZodObject<{
     module_ref: string | null;
     carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
     carrier_ref: string;
-    declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+    declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
     target: {
         normalized_path: string;
         target_type: "directory";
@@ -321,7 +321,7 @@ export declare const indexerStructuredDeclarationSchema: z.ZodObject<{
     module_ref: string | null;
     carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
     carrier_ref: string;
-    declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+    declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
     target: {
         normalized_path: string;
         target_type: "directory";
@@ -396,7 +396,7 @@ export declare const indexerStructuredDeclarationSetSchema: z.ZodObject<{
         module_ref: string | null;
         carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
         carrier_ref: string;
-        declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+        declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
         target: {
             normalized_path: string;
             target_type: "directory";
@@ -418,7 +418,7 @@ export declare const indexerStructuredDeclarationSetSchema: z.ZodObject<{
         module_ref: string | null;
         carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
         carrier_ref: string;
-        declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+        declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
         target: {
             normalized_path: string;
             target_type: "directory";
@@ -445,7 +445,7 @@ export declare const indexerStructuredDeclarationSetSchema: z.ZodObject<{
         module_ref: string | null;
         carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
         carrier_ref: string;
-        declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+        declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
         target: {
             normalized_path: string;
             target_type: "directory";
@@ -472,7 +472,7 @@ export declare const indexerStructuredDeclarationSetSchema: z.ZodObject<{
         module_ref: string | null;
         carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
         carrier_ref: string;
-        declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
+        declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
         target: {
             normalized_path: string;
             target_type: "directory";

package/indexerTemplateRendering.d.ts

@@ -57,15 +57,15 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     }>, "many">;
     deterministic_blocks: z.ZodArray<z.ZodObject<{
         id: z.ZodEffects<z.ZodString, string, string>;
-        renderer: z.ZodEnum<["bullet-list", "key-value-table", "json-code-block"]>;
+        renderer: z.ZodEnum<["bullet-list", "key-value-table", "multi-column-table", "public-contract-table", "json-code-block"]>;
         source_variable_id: z.ZodEffects<z.ZodString, string, string>;
     }, "strict", z.ZodTypeAny, {
         id: string;
-        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
         source_variable_id: string;
     }, {
         id: string;
-        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
         source_variable_id: string;
     }>, "many">;
     sections: z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -173,7 +173,7 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     };
     deterministic_blocks: {
         id: string;
-        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
         source_variable_id: string;
     }[];
     page_policy: {
@@ -217,7 +217,7 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     };
     deterministic_blocks: {
         id: string;
-        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
         source_variable_id: string;
     }[];
     page_policy: {
@@ -261,7 +261,7 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     };
     deterministic_blocks: {
         id: string;
-        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
         source_variable_id: string;
     }[];
     page_policy: {
@@ -305,7 +305,7 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     };
     deterministic_blocks: {
         id: string;
-        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
         source_variable_id: string;
     }[];
     page_policy: {

package/indexerToolSnapshot.d.ts

@@ -145,6 +145,10 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         item_count: number;
         response_digest: string;
     }[];
+    location: {
+        site: string;
+        region: string | null;
+    };
     tool: {
         id: string;
         version: string;
@@ -159,10 +163,6 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         endpoint_type: string;
         resolved_revision: string;
     };
-    location: {
-        site: string;
-        region: string | null;
-    };
     query: {
         operation: string;
         arguments_digest: string;
@@ -190,6 +190,10 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         item_count: number;
         response_digest: string;
     }[];
+    location: {
+        site: string;
+        region: string | null;
+    };
     tool: {
         id: string;
         version: string;
@@ -204,10 +208,6 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         endpoint_type: string;
         resolved_revision: string;
     };
-    location: {
-        site: string;
-        region: string | null;
-    };
     query: {
         operation: string;
         arguments_digest: string;
@@ -235,6 +235,10 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         item_count: number;
         response_digest: string;
     }[];
+    location: {
+        site: string;
+        region: string | null;
+    };
     tool: {
         id: string;
         version: string;
@@ -249,10 +253,6 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         endpoint_type: string;
         resolved_revision: string;
     };
-    location: {
-        site: string;
-        region: string | null;
-    };
     query: {
         operation: string;
         arguments_digest: string;
@@ -280,6 +280,10 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         item_count: number;
         response_digest: string;
     }[];
+    location: {
+        site: string;
+        region: string | null;
+    };
     tool: {
         id: string;
         version: string;
@@ -294,10 +298,6 @@ export declare const indexerToolSnapshotSchema: z.ZodEffects<z.ZodObject<{
         endpoint_type: string;
         resolved_revision: string;
     };
-    location: {
-        site: string;
-        region: string | null;
-    };
     query: {
         operation: string;
         arguments_digest: string;

package/knowledgeMap.d.ts

@@ -0,0 +1,188 @@
+import { z } from "zod";
+/** Reader organization is independent of collections, source ownership and outputs. */
+export declare const knowledgeMapEntrySchema: z.ZodObject<{
+    key: z.ZodString;
+    parent: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    target: z.ZodOptional<z.ZodObject<{
+        artifact_ref: z.ZodString;
+        section_key: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        artifact_ref: string;
+        section_key?: string | undefined;
+    }, {
+        artifact_ref: string;
+        section_key?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    key: string;
+    order: number;
+    parent: string | null;
+    target?: {
+        artifact_ref: string;
+        section_key?: string | undefined;
+    } | undefined;
+}, {
+    title: string;
+    key: string;
+    parent: string | null;
+    target?: {
+        artifact_ref: string;
+        section_key?: string | undefined;
+    } | undefined;
+    order?: number | undefined;
+}>;
+export declare const knowledgeMapUpdateSchema: z.ZodObject<{
+    expected_revision: z.ZodNullable<z.ZodString>;
+    upsert: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        parent: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        order: z.ZodDefault<z.ZodNumber>;
+        target: z.ZodOptional<z.ZodObject<{
+            artifact_ref: z.ZodString;
+            section_key: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        }, {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        key: string;
+        order: number;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+    }, {
+        title: string;
+        key: string;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+        order?: number | undefined;
+    }>, "many">>;
+    remove: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    expected_revision: string | null;
+    upsert: {
+        title: string;
+        key: string;
+        order: number;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+    }[];
+    remove: string[];
+}, {
+    expected_revision: string | null;
+    upsert?: {
+        title: string;
+        key: string;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+        order?: number | undefined;
+    }[] | undefined;
+    remove?: string[] | undefined;
+}>;
+export declare const knowledgeMapSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.knowledge-map/v1">;
+    revision: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        parent: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        order: z.ZodDefault<z.ZodNumber>;
+        target: z.ZodOptional<z.ZodObject<{
+            artifact_ref: z.ZodString;
+            section_key: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        }, {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        key: string;
+        order: number;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+    }, {
+        title: string;
+        key: string;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+        order?: number | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    entries: {
+        title: string;
+        key: string;
+        order: number;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+    }[];
+    protocol: "context.knowledge-map/v1";
+    revision: string;
+}, {
+    entries: {
+        title: string;
+        key: string;
+        parent: string | null;
+        target?: {
+            artifact_ref: string;
+            section_key?: string | undefined;
+        } | undefined;
+        order?: number | undefined;
+    }[];
+    protocol: "context.knowledge-map/v1";
+    revision: string;
+}>;
+export type KnowledgeMap = z.infer<typeof knowledgeMapSchema>;
+export type KnowledgeMapUpdate = z.infer<typeof knowledgeMapUpdateSchema>;
+export declare function validateKnowledgeMap(value: unknown): KnowledgeMap;
+export declare function updateKnowledgeMap(current: KnowledgeMap | undefined, value: unknown): KnowledgeMap;
+export interface ProjectedKnowledgeMapEntry {
+    key: string;
+    title: string;
+    href?: string;
+    children: ProjectedKnowledgeMapEntry[];
+}
+/** Target availability belongs to each channel. Omit pending/excluded entries and
+ * empty groups without mutating shared organization or another channel's map. */
+export declare function projectKnowledgeMap(structure: KnowledgeMap, targets: ReadonlyMap<string, string>): {
+    entries: ProjectedKnowledgeMapEntry[];
+    warnings: {
+        entry: string;
+        code: "knowledge-map-target-unavailable";
+        target: string;
+    }[];
+};
+export declare function knowledgeMapTargetKey(target: {
+    artifact_ref: string;
+    section_key?: string | undefined;
+}): string;

package/managedSources.d.ts

@@ -0,0 +1,15 @@
+import { type SessionChange } from "./sessionMetadata.js";
+export type ManagedDocumentSourceType = "note" | "sessions";
+export interface ManagedDocumentSourceEntry {
+    id: string;
+    name: string;
+    namespace: string;
+    module: string;
+    materializedAt: string;
+    changes?: SessionChange[];
+}
+/** A readable dated filename is the identity; no registry or content hash is
+ * added to the name. Paths are deliberately limited to these managed roots. */
+export declare function assertManagedDocumentName(name: string): void;
+export declare function assertManagedDocumentPath(rootDir: string, type: ManagedDocumentSourceType, name: string): Promise<string>;
+export declare function discoverManagedDocuments(rootDir: string, type: ManagedDocumentSourceType): Promise<ManagedDocumentSourceEntry[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context",
-  "version": "0.7.5",
+  "version": "0.7.9",
   "type": "module",
   "description": "Declarative SDK for Context knowledge sources, workflows, review, and package outputs",
   "license": "MIT",

package/packageSite.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+/** Static website in a sibling dist/<name-without-trailing-kb>-site directory. */
+export declare const packageSiteSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    lang: z.ZodDefault<z.ZodString>;
+    base: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    lang: string;
+    base: string;
+    title?: string | undefined;
+    description?: string | undefined;
+}, {
+    title?: string | undefined;
+    description?: string | undefined;
+    lang?: string | undefined;
+    base?: string | undefined;
+}>;
+export type PackageSiteDefinition = z.input<typeof packageSiteSchema>;
+export declare function normalizePackageSite(value: PackageSiteDefinition | undefined): {
+    lang: string;
+    base: string;
+    title?: string | undefined;
+    description?: string | undefined;
+} | undefined;

package/phases.d.ts

@@ -17,9 +17,6 @@ export type PhaseResourceReference = {
     kind: "knowledge.approved";
     path: "knowledge";
     select?: PackageSelectDefinition;
-} | {
-    kind: "knowledge.decisions";
-    path: "knowledge/decisions.json";
 } | {
     kind: "package.template";
     path: string;

package/processedScopes.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+/** The latest completed input for one requirement and source scope, not a
+ * page revision or an acquisition receipt. An absent module list means the
+ * whole source within that requirement. */
+export declare const processedScopeSchema: z.ZodEffects<z.ZodObject<{
+    requirement_ref: z.ZodEffects<z.ZodString, string, string>;
+    source_ref: z.ZodEffects<z.ZodString, string, string>;
+    processed_version: z.ZodEffects<z.ZodString, string, string>;
+    module_refs: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}>, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}>;
+export type ProcessedScope = z.infer<typeof processedScopeSchema>;
+export declare function processedScopeKey(scope: Pick<ProcessedScope, "requirement_ref" | "source_ref" | "module_refs">): string;
+export declare const processedScopesSchema: z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodObject<{
+    requirement_ref: z.ZodEffects<z.ZodString, string, string>;
+    source_ref: z.ZodEffects<z.ZodString, string, string>;
+    processed_version: z.ZodEffects<z.ZodString, string, string>;
+    module_refs: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}>, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}>, "many">, {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}[], {
+    source_ref: string;
+    requirement_ref: string;
+    processed_version: string;
+    module_refs?: string[] | undefined;
+}[]>;
+/** Missing metadata is unknown, never inferred from current source versions. */
+export declare function readProcessedScopes(structure: Record<string, unknown> | null): ProcessedScope[];
+/** A narrower completed scope cannot advance its containing source scope. */
+export declare function mergeProcessedScopes(previous: readonly ProcessedScope[], completed: readonly ProcessedScope[]): ProcessedScope[];
+/** Overlapping incomparable scopes with different versions are unknown; string
+ * ordering of commit hashes is never a chronology. */
+export declare function processedVersionForScope(scopes: readonly ProcessedScope[], scope: Pick<ProcessedScope, "requirement_ref" | "source_ref" | "module_refs">): string | undefined;