@c4a/context 0.7.1 → 0.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/README.md +65 -170
  2. package/README.zh-CN.md +52 -129
  3. package/docs/README.md +9 -10
  4. package/docs/README.zh-CN.md +6 -7
  5. package/docs/getting-started.md +73 -428
  6. package/docs/guides/agent-guide.md +94 -518
  7. package/docs/guides/code-indexer-skill-authoring.md +24 -13
  8. package/docs/guides/markdown-indexer-skill-authoring.md +14 -14
  9. package/docs/reference/code-extractors.md +29 -121
  10. package/docs/reference/indexer-provider-protocol.md +43 -110
  11. package/docs/reference/package-templates.md +2 -3
  12. package/docs/reference/project-api.md +52 -986
  13. package/index.d.ts +10 -8
  14. package/index.js +4739 -7103
  15. package/indexerAgentStepProtocol.d.ts +1366 -7649
  16. package/indexerArtifact.d.ts +225 -0
  17. package/indexerArtifactDependencies.d.ts +41 -39
  18. package/indexerArtifactResult.d.ts +219 -252
  19. package/indexerAuthorizedWorksetView.d.ts +368 -0
  20. package/indexerBaseQuestionAmendment.d.ts +484 -280
  21. package/indexerBenchmark.d.ts +16 -16
  22. package/indexerCandidateCompile.d.ts +66 -60
  23. package/indexerCapabilityGroupEvidence.d.ts +6 -6
  24. package/indexerCatalogFallback.d.ts +122 -128
  25. package/indexerCollectionMapping.d.ts +13 -13
  26. package/indexerContentLayers.d.ts +8 -8
  27. package/indexerContractOverlay.d.ts +10 -10
  28. package/indexerControlledInvocation.d.ts +12 -12
  29. package/indexerControlledProgram.d.ts +2467 -2797
  30. package/indexerCoreExports.d.ts +6 -6
  31. package/indexerCustomizationDraft.d.ts +3315 -2091
  32. package/indexerCustomizationLadder.d.ts +2 -2
  33. package/indexerDependencyView.d.ts +108 -108
  34. package/indexerEffectiveArtifact.d.ts +1134 -0
  35. package/indexerEvidenceAdapterAuthorityMerge.d.ts +48 -0
  36. package/indexerEvidenceAdapterResult.d.ts +52 -52
  37. package/indexerExampleDecision.d.ts +128 -128
  38. package/indexerExampleIdentity.d.ts +6 -6
  39. package/indexerGeneratedAuthoringAudit.d.ts +18 -18
  40. package/indexerIncrementalImpact.d.ts +16 -16
  41. package/indexerInspectorWorksetProjection.d.ts +6 -0
  42. package/indexerInventoryDisposition.d.ts +70 -70
  43. package/indexerLayerComposition.d.ts +2139 -373
  44. package/indexerLayoutChange.d.ts +10 -10
  45. package/indexerLayoutProposalSet.d.ts +71 -66
  46. package/indexerLayoutResolver.d.ts +53 -48
  47. package/indexerLayoutTransition.d.ts +0 -50
  48. package/indexerLifecycle.d.ts +0 -13
  49. package/indexerMainLifecycle.d.ts +10 -0
  50. package/indexerMainRunLedger.d.ts +138 -11
  51. package/indexerMainRunProtocol.d.ts +1406 -785
  52. package/indexerMainWorkset.d.ts +460 -206
  53. package/indexerMaterialGapLedger.d.ts +13 -2904
  54. package/indexerOverlayQuestionAmendment.d.ts +491 -287
  55. package/indexerOverlayQuestionApplyProposal.d.ts +1022 -614
  56. package/indexerParserCapabilityCatalog.d.ts +136 -0
  57. package/indexerParserCoordinate.d.ts +16 -16
  58. package/indexerParserDependencyIntent.d.ts +22 -0
  59. package/indexerParserExecutionPlan.d.ts +388 -0
  60. package/indexerParserFactView.d.ts +42 -22
  61. package/indexerPartitionConvergence.d.ts +0 -3
  62. package/indexerPartitionInventory.d.ts +2 -0
  63. package/indexerPartitionPlan.d.ts +101 -99
  64. package/indexerPhysicalArtifactManifest.d.ts +8 -8
  65. package/indexerPostAuthorComposition.d.ts +116 -1156
  66. package/indexerPostAuthorRunLedger.d.ts +1434 -280
  67. package/indexerPrimaryProjection.d.ts +10 -10
  68. package/indexerPrimaryResultView.d.ts +435 -0
  69. package/indexerProfileContract.d.ts +181 -181
  70. package/indexerProgramExecutionAuthorization.d.ts +12 -12
  71. package/indexerProgramRunProtocol.d.ts +2141 -2749
  72. package/indexerProjectProposal.d.ts +496 -292
  73. package/indexerProjectedArtifactFanOutAudit.d.ts +0 -3
  74. package/indexerProtocolCommon.d.ts +4 -1
  75. package/indexerProvider.d.ts +134 -218
  76. package/indexerProviderComposition.d.ts +53 -53
  77. package/indexerProviderResolution.d.ts +12 -12
  78. package/indexerProviderResolutionAction.d.ts +14 -14
  79. package/indexerProviderRouting.d.ts +923 -515
  80. package/indexerProviderSelectionProposal.d.ts +893 -485
  81. package/indexerQuestionAuthority.d.ts +46 -47
  82. package/indexerReaderTargetInventory.d.ts +8 -8
  83. package/indexerRegistry.d.ts +765 -357
  84. package/indexerRequirementConfirmation.d.ts +98 -98
  85. package/indexerRequirementLifecycle.d.ts +224 -224
  86. package/indexerResultReconciliation.d.ts +204 -5919
  87. package/indexerResultReconciliationRun.d.ts +0 -1
  88. package/indexerRunEnvelope.d.ts +20 -20
  89. package/indexerSemanticInput.d.ts +3678 -0
  90. package/indexerStructuredDeclaration.d.ts +57 -53
  91. package/indexerSubjectCatalog.d.ts +14 -14
  92. package/indexerSubjectIdentity.d.ts +2 -2
  93. package/indexerSubjectKeyAuthority.d.ts +31 -30
  94. package/indexerTemplateRendering.d.ts +64 -64
  95. package/indexerToolSnapshot.d.ts +8 -8
  96. package/package.json +1 -1
  97. package/phases.d.ts +3 -183
  98. package/codeIndexPlan.d.ts +0 -158
  99. package/indexerAuditFacts.d.ts +0 -66
  100. package/indexerAuditOverrideReadiness.d.ts +0 -27
  101. package/indexerAuditProtocol.d.ts +0 -238
  102. package/indexerAuditRevision.d.ts +0 -726
  103. package/indexerAuditRevisionActions.d.ts +0 -236
  104. package/indexerMaterialAnswer.d.ts +0 -738
  105. package/indexerMaterialAnswerActualization.d.ts +0 -91
  106. package/indexerMaterialAnswerExecutionPlan.d.ts +0 -2887
  107. package/indexerMaterialAnswerFlow.d.ts +0 -63
  108. package/indexerMaterialAnswerLayout.d.ts +0 -76
  109. package/indexerMaterialAnswerReview.d.ts +0 -217
  110. package/indexerMaterialAnswerReviewRoute.d.ts +0 -6145
  111. package/indexerMaterialAnswerRunLedger.d.ts +0 -918
  112. package/indexerMaterialAnswerRunProtocol.d.ts +0 -1253
  113. package/indexerMaterialQuestionExclusion.d.ts +0 -129
  114. package/indexerMaterialQuestionWorkset.d.ts +0 -508
  115. package/indexerPlannedMaterialAnswer.d.ts +0 -116
  116. package/indexerProfileMetricAudit.d.ts +0 -218
  117. package/indexerWorksetRead.d.ts +0 -287
@@ -0,0 +1,136 @@
1
+ import { type IndexerParserRequirement } from "./indexerParserCoordinate.js";
2
+ export declare const INDEXER_EVIDENCE_ADAPTER_ABI = "context.indexer.evidence-adapter-result/v1";
3
+ export type IndexerParserAuthorityDomain = "code-catalog" | "configuration-semantics" | "protocol-contract" | "query-semantics" | "style-semantics" | "workspace-structure";
4
+ export interface IndexerParserCapabilitySpec {
5
+ capability: string;
6
+ package: string;
7
+ export: string;
8
+ extensions: readonly string[];
9
+ authority_domain: IndexerParserAuthorityDomain;
10
+ coverage_tier: "ast-catalog" | "lightweight-evidence";
11
+ release_metadata: boolean;
12
+ }
13
+ export declare const INDEXER_PARSER_CAPABILITY_SPECS: readonly [{
14
+ readonly capability: "parser.typescript";
15
+ readonly package: "@c4a/extract-ts";
16
+ readonly export: "typeScriptExtractionToEvidenceAdapterMaterialization";
17
+ readonly extensions: readonly [".cts", ".mts", ".ts", ".tsx"];
18
+ readonly authority_domain: "code-catalog";
19
+ readonly coverage_tier: "ast-catalog";
20
+ readonly release_metadata: true;
21
+ }, {
22
+ readonly capability: "parser.javascript";
23
+ readonly package: "@c4a/extract-ts";
24
+ readonly export: "typeScriptExtractionToEvidenceAdapterMaterialization";
25
+ readonly extensions: readonly [".cjs", ".js", ".jsx", ".mjs"];
26
+ readonly authority_domain: "code-catalog";
27
+ readonly coverage_tier: "ast-catalog";
28
+ readonly release_metadata: true;
29
+ }, {
30
+ readonly capability: "parser.go";
31
+ readonly package: "@c4a/extract-go";
32
+ readonly export: "goExtractionToEvidenceAdapterMaterialization";
33
+ readonly extensions: readonly [".go"];
34
+ readonly authority_domain: "code-catalog";
35
+ readonly coverage_tier: "ast-catalog";
36
+ readonly release_metadata: true;
37
+ }, {
38
+ readonly capability: "parser.rush";
39
+ readonly package: "@c4a/extract-rush";
40
+ readonly export: "rushWorkspaceIndexToEvidenceAdapterMaterialization";
41
+ readonly extensions: readonly ["rush.json"];
42
+ readonly authority_domain: "workspace-structure";
43
+ readonly coverage_tier: "ast-catalog";
44
+ readonly release_metadata: true;
45
+ }, {
46
+ readonly capability: "parser.mdx";
47
+ readonly package: "@c4a/extract-mdx";
48
+ readonly export: "mdxSourcesToEvidenceAdapterMaterialization";
49
+ readonly extensions: readonly [".mdx"];
50
+ readonly authority_domain: "code-catalog";
51
+ readonly coverage_tier: "ast-catalog";
52
+ readonly release_metadata: true;
53
+ }, {
54
+ readonly capability: "parser.thrift";
55
+ readonly package: "@c4a/extract-thrift";
56
+ readonly export: "thriftSourcesToEvidenceAdapterMaterialization";
57
+ readonly extensions: readonly [".thrift"];
58
+ readonly authority_domain: "protocol-contract";
59
+ readonly coverage_tier: "ast-catalog";
60
+ readonly release_metadata: true;
61
+ }, {
62
+ readonly capability: "parser.proto";
63
+ readonly package: "@c4a/extract-proto";
64
+ readonly export: "protoSourcesToEvidenceAdapterMaterialization";
65
+ readonly extensions: readonly [".proto"];
66
+ readonly authority_domain: "protocol-contract";
67
+ readonly coverage_tier: "ast-catalog";
68
+ readonly release_metadata: true;
69
+ }, {
70
+ readonly capability: "parser.openapi";
71
+ readonly package: "@c4a/extract-contract";
72
+ readonly export: "contractSourcesToEvidenceAdapterMaterialization";
73
+ readonly extensions: readonly [".json", ".yaml", ".yml"];
74
+ readonly authority_domain: "protocol-contract";
75
+ readonly coverage_tier: "ast-catalog";
76
+ readonly release_metadata: true;
77
+ }, {
78
+ readonly capability: "parser.graphql";
79
+ readonly package: "@c4a/extract-contract";
80
+ readonly export: "contractSourcesToEvidenceAdapterMaterialization";
81
+ readonly extensions: readonly [".gql", ".graphql"];
82
+ readonly authority_domain: "protocol-contract";
83
+ readonly coverage_tier: "ast-catalog";
84
+ readonly release_metadata: true;
85
+ }, {
86
+ readonly capability: "parser.css";
87
+ readonly package: "@c4a/extract-style";
88
+ readonly export: "styleSourcesToEvidenceAdapterMaterialization";
89
+ readonly extensions: readonly [".css"];
90
+ readonly authority_domain: "style-semantics";
91
+ readonly coverage_tier: "lightweight-evidence";
92
+ readonly release_metadata: true;
93
+ }, {
94
+ readonly capability: "parser.scss";
95
+ readonly package: "@c4a/extract-style";
96
+ readonly export: "styleSourcesToEvidenceAdapterMaterialization";
97
+ readonly extensions: readonly [".scss"];
98
+ readonly authority_domain: "style-semantics";
99
+ readonly coverage_tier: "lightweight-evidence";
100
+ readonly release_metadata: true;
101
+ }, {
102
+ readonly capability: "parser.sql";
103
+ readonly package: "@c4a/extract-sql";
104
+ readonly export: "sqlSourcesToEvidenceAdapterMaterialization";
105
+ readonly extensions: readonly [".sql"];
106
+ readonly authority_domain: "query-semantics";
107
+ readonly coverage_tier: "lightweight-evidence";
108
+ readonly release_metadata: true;
109
+ }, {
110
+ readonly capability: "parser.json";
111
+ readonly package: "@c4a/extract";
112
+ readonly export: "configSourcesToEvidenceAdapterMaterialization";
113
+ readonly extensions: readonly [".json"];
114
+ readonly authority_domain: "configuration-semantics";
115
+ readonly coverage_tier: "lightweight-evidence";
116
+ readonly release_metadata: true;
117
+ }, {
118
+ readonly capability: "parser.yaml";
119
+ readonly package: "@c4a/extract";
120
+ readonly export: "configSourcesToEvidenceAdapterMaterialization";
121
+ readonly extensions: readonly [".yaml", ".yml"];
122
+ readonly authority_domain: "configuration-semantics";
123
+ readonly coverage_tier: "lightweight-evidence";
124
+ readonly release_metadata: true;
125
+ }, {
126
+ readonly capability: "parser.toml";
127
+ readonly package: "@c4a/extract";
128
+ readonly export: "configSourcesToEvidenceAdapterMaterialization";
129
+ readonly extensions: readonly [".toml"];
130
+ readonly authority_domain: "configuration-semantics";
131
+ readonly coverage_tier: "lightweight-evidence";
132
+ readonly release_metadata: true;
133
+ }];
134
+ export type IndexerParserCapability = typeof INDEXER_PARSER_CAPABILITY_SPECS[number]["capability"];
135
+ export declare function indexerParserCapabilitySpec(capability: string): IndexerParserCapabilitySpec;
136
+ export declare function buildIndexerParserCapabilityRequirements(packageVersion: string): IndexerParserRequirement[];
@@ -4,13 +4,13 @@ export declare const indexerParserPackageCoordinateSchema: z.ZodObject<{
4
4
  export: z.ZodString;
5
5
  version: z.ZodString;
6
6
  }, "strict", z.ZodTypeAny, {
7
- export: string;
8
7
  package: string;
9
8
  version: string;
10
- }, {
11
9
  export: string;
10
+ }, {
12
11
  package: string;
13
12
  version: string;
13
+ export: string;
14
14
  }>;
15
15
  export declare const indexerParserRequirementSchema: z.ZodObject<{
16
16
  protocol: z.ZodLiteral<"context.indexer.parser-requirement/v1">;
@@ -22,13 +22,13 @@ export declare const indexerParserRequirementSchema: z.ZodObject<{
22
22
  export: z.ZodString;
23
23
  version: z.ZodString;
24
24
  }, "strict", z.ZodTypeAny, {
25
- export: string;
26
25
  package: string;
27
26
  version: string;
28
- }, {
29
27
  export: string;
28
+ }, {
30
29
  package: string;
31
30
  version: string;
31
+ export: string;
32
32
  }>;
33
33
  } & {
34
34
  requirement_digest: z.ZodString;
@@ -38,9 +38,9 @@ export declare const indexerParserRequirementSchema: z.ZodObject<{
38
38
  abi: string;
39
39
  abi_digest: string;
40
40
  community_coordinate: {
41
- export: string;
42
41
  package: string;
43
42
  version: string;
43
+ export: string;
44
44
  };
45
45
  requirement_digest: string;
46
46
  }, {
@@ -49,9 +49,9 @@ export declare const indexerParserRequirementSchema: z.ZodObject<{
49
49
  abi: string;
50
50
  abi_digest: string;
51
51
  community_coordinate: {
52
- export: string;
53
52
  package: string;
54
53
  version: string;
54
+ export: string;
55
55
  };
56
56
  requirement_digest: string;
57
57
  }>;
@@ -67,13 +67,13 @@ export declare const indexerParserCoordinateMappingSchema: z.ZodObject<{
67
67
  export: z.ZodString;
68
68
  version: z.ZodString;
69
69
  }, "strict", z.ZodTypeAny, {
70
- export: string;
71
70
  package: string;
72
71
  version: string;
73
- }, {
74
72
  export: string;
73
+ }, {
75
74
  package: string;
76
75
  version: string;
76
+ export: string;
77
77
  }>;
78
78
  abi_digest: z.ZodString;
79
79
  } & {
@@ -86,9 +86,9 @@ export declare const indexerParserCoordinateMappingSchema: z.ZodObject<{
86
86
  requirement_digest: string;
87
87
  resolution: "direct" | "wrapper";
88
88
  actual_coordinate: {
89
- export: string;
90
89
  package: string;
91
90
  version: string;
91
+ export: string;
92
92
  };
93
93
  mapping_digest: string;
94
94
  }, {
@@ -99,9 +99,9 @@ export declare const indexerParserCoordinateMappingSchema: z.ZodObject<{
99
99
  requirement_digest: string;
100
100
  resolution: "direct" | "wrapper";
101
101
  actual_coordinate: {
102
- export: string;
103
102
  package: string;
104
103
  version: string;
104
+ export: string;
105
105
  };
106
106
  mapping_digest: string;
107
107
  }>;
@@ -116,13 +116,13 @@ export declare const indexerParserResolutionLockSchema: z.ZodObject<{
116
116
  export: z.ZodString;
117
117
  version: z.ZodString;
118
118
  }, "strict", z.ZodTypeAny, {
119
- export: string;
120
119
  package: string;
121
120
  version: string;
122
- }, {
123
121
  export: string;
122
+ }, {
124
123
  package: string;
125
124
  version: string;
125
+ export: string;
126
126
  }>;
127
127
  abi_digest: z.ZodString;
128
128
  lock_integrity: z.ZodString;
@@ -135,9 +135,9 @@ export declare const indexerParserResolutionLockSchema: z.ZodObject<{
135
135
  abi_digest: string;
136
136
  requirement_digest: string;
137
137
  actual_coordinate: {
138
- export: string;
139
138
  package: string;
140
139
  version: string;
140
+ export: string;
141
141
  };
142
142
  mapping_digest: string;
143
143
  lock_integrity: string;
@@ -149,9 +149,9 @@ export declare const indexerParserResolutionLockSchema: z.ZodObject<{
149
149
  abi_digest: string;
150
150
  requirement_digest: string;
151
151
  actual_coordinate: {
152
- export: string;
153
152
  package: string;
154
153
  version: string;
154
+ export: string;
155
155
  };
156
156
  mapping_digest: string;
157
157
  lock_integrity: string;
@@ -166,15 +166,15 @@ export declare const indexerParserImportSchema: z.ZodObject<{
166
166
  version: z.ZodString;
167
167
  parser_lock_digest: z.ZodString;
168
168
  }, "strict", z.ZodTypeAny, {
169
- export: string;
170
169
  package: string;
171
170
  version: string;
171
+ export: string;
172
172
  capability: string;
173
173
  parser_lock_digest: string;
174
174
  }, {
175
- export: string;
176
175
  package: string;
177
176
  version: string;
177
+ export: string;
178
178
  capability: string;
179
179
  parser_lock_digest: string;
180
180
  }>;
@@ -0,0 +1,22 @@
1
+ import { type IndexerDependencyAuthorizationReceipt, type IndexerDependencyIntentSet } from "./indexerProjectProposal.js";
2
+ import { type IndexerParserCoordinateMapping, type IndexerParserRequirement, type IndexerParserResolutionLock } from "./indexerParserCoordinate.js";
3
+ interface ParserResolutionInput {
4
+ requirements: readonly IndexerParserRequirement[];
5
+ mappings: readonly IndexerParserCoordinateMapping[];
6
+ }
7
+ export declare function buildIndexerCommunityParserCoordinateMappings(input: {
8
+ requirements: readonly IndexerParserRequirement[];
9
+ registry: string;
10
+ }): IndexerParserCoordinateMapping[];
11
+ export declare function buildIndexerParserDependencyIntentSet(input: ParserResolutionInput & {
12
+ importers?: readonly string[];
13
+ authorization_receipt?: IndexerDependencyAuthorizationReceipt;
14
+ }): IndexerDependencyIntentSet;
15
+ export declare function buildIndexerParserResolutionLocks(input: ParserResolutionInput & {
16
+ authorization_receipt: IndexerDependencyAuthorizationReceipt;
17
+ }): IndexerParserResolutionLock[];
18
+ export declare function assertIndexerParserDependenciesLocked(input: {
19
+ dependencies: unknown;
20
+ locks: readonly IndexerParserResolutionLock[];
21
+ }): IndexerDependencyIntentSet;
22
+ export {};
@@ -0,0 +1,388 @@
1
+ import { z } from "zod";
2
+ export declare const indexerParserApplicabilityDispositionSchema: z.ZodEnum<["applicable", "not-applicable", "excluded-by-scope", "unsupported-format"]>;
3
+ export declare const indexerParserExecutionPlanEntrySchema: z.ZodEffects<z.ZodObject<{
4
+ capability: z.ZodEffects<z.ZodString, string, string>;
5
+ requirement_digest: z.ZodString;
6
+ parser_lock_digest: z.ZodString;
7
+ source_ref: z.ZodString;
8
+ module_ref: z.ZodNullable<z.ZodString>;
9
+ authority_domain: z.ZodEffects<z.ZodString, string, string>;
10
+ precedence: z.ZodNumber;
11
+ files: z.ZodArray<z.ZodObject<{
12
+ normalized_path: z.ZodEffects<z.ZodString, string, string>;
13
+ content_digest: z.ZodString;
14
+ contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
15
+ role: z.ZodEnum<["primary-owner", "enricher"]>;
16
+ }, "strict", z.ZodTypeAny, {
17
+ role: "enricher" | "primary-owner";
18
+ content_digest: string;
19
+ normalized_path: string;
20
+ contract_scope: string | null;
21
+ }, {
22
+ role: "enricher" | "primary-owner";
23
+ content_digest: string;
24
+ normalized_path: string;
25
+ contract_scope: string | null;
26
+ }>, "many">;
27
+ }, "strict", z.ZodTypeAny, {
28
+ files: {
29
+ role: "enricher" | "primary-owner";
30
+ content_digest: string;
31
+ normalized_path: string;
32
+ contract_scope: string | null;
33
+ }[];
34
+ source_ref: string;
35
+ module_ref: string | null;
36
+ precedence: number;
37
+ capability: string;
38
+ requirement_digest: string;
39
+ parser_lock_digest: string;
40
+ authority_domain: string;
41
+ }, {
42
+ files: {
43
+ role: "enricher" | "primary-owner";
44
+ content_digest: string;
45
+ normalized_path: string;
46
+ contract_scope: string | null;
47
+ }[];
48
+ source_ref: string;
49
+ module_ref: string | null;
50
+ precedence: number;
51
+ capability: string;
52
+ requirement_digest: string;
53
+ parser_lock_digest: string;
54
+ authority_domain: string;
55
+ }>, {
56
+ files: {
57
+ role: "enricher" | "primary-owner";
58
+ content_digest: string;
59
+ normalized_path: string;
60
+ contract_scope: string | null;
61
+ }[];
62
+ source_ref: string;
63
+ module_ref: string | null;
64
+ precedence: number;
65
+ capability: string;
66
+ requirement_digest: string;
67
+ parser_lock_digest: string;
68
+ authority_domain: string;
69
+ }, {
70
+ files: {
71
+ role: "enricher" | "primary-owner";
72
+ content_digest: string;
73
+ normalized_path: string;
74
+ contract_scope: string | null;
75
+ }[];
76
+ source_ref: string;
77
+ module_ref: string | null;
78
+ precedence: number;
79
+ capability: string;
80
+ requirement_digest: string;
81
+ parser_lock_digest: string;
82
+ authority_domain: string;
83
+ }>;
84
+ export declare const indexerParserApplicabilitySchema: z.ZodDiscriminatedUnion<"disposition", [z.ZodObject<{
85
+ source_ref: z.ZodString;
86
+ module_ref: z.ZodNullable<z.ZodString>;
87
+ normalized_path: z.ZodEffects<z.ZodString, string, string>;
88
+ content_digest: z.ZodString;
89
+ contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
90
+ capability: z.ZodEffects<z.ZodString, string, string>;
91
+ authority_domain: z.ZodEffects<z.ZodString, string, string>;
92
+ disposition: z.ZodLiteral<"applicable">;
93
+ role: z.ZodEnum<["primary-owner", "enricher"]>;
94
+ }, "strict", z.ZodTypeAny, {
95
+ source_ref: string;
96
+ role: "enricher" | "primary-owner";
97
+ content_digest: string;
98
+ module_ref: string | null;
99
+ normalized_path: string;
100
+ disposition: "applicable";
101
+ capability: string;
102
+ authority_domain: string;
103
+ contract_scope: string | null;
104
+ }, {
105
+ source_ref: string;
106
+ role: "enricher" | "primary-owner";
107
+ content_digest: string;
108
+ module_ref: string | null;
109
+ normalized_path: string;
110
+ disposition: "applicable";
111
+ capability: string;
112
+ authority_domain: string;
113
+ contract_scope: string | null;
114
+ }>, z.ZodObject<{
115
+ source_ref: z.ZodString;
116
+ module_ref: z.ZodNullable<z.ZodString>;
117
+ normalized_path: z.ZodEffects<z.ZodString, string, string>;
118
+ content_digest: z.ZodString;
119
+ contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
120
+ capability: z.ZodEffects<z.ZodString, string, string>;
121
+ authority_domain: z.ZodEffects<z.ZodString, string, string>;
122
+ disposition: z.ZodEnum<["not-applicable", "excluded-by-scope", "unsupported-format"]>;
123
+ reason_code: z.ZodEffects<z.ZodString, string, string>;
124
+ }, "strict", z.ZodTypeAny, {
125
+ source_ref: string;
126
+ content_digest: string;
127
+ module_ref: string | null;
128
+ normalized_path: string;
129
+ disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
130
+ capability: string;
131
+ authority_domain: string;
132
+ reason_code: string;
133
+ contract_scope: string | null;
134
+ }, {
135
+ source_ref: string;
136
+ content_digest: string;
137
+ module_ref: string | null;
138
+ normalized_path: string;
139
+ disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
140
+ capability: string;
141
+ authority_domain: string;
142
+ reason_code: string;
143
+ contract_scope: string | null;
144
+ }>]>;
145
+ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
146
+ protocol: z.ZodLiteral<"context.indexer.parser-execution-plan/v1">;
147
+ profile_contract_digest: z.ZodString;
148
+ source_registry_digest: z.ZodString;
149
+ entries: z.ZodArray<z.ZodEffects<z.ZodObject<{
150
+ capability: z.ZodEffects<z.ZodString, string, string>;
151
+ requirement_digest: z.ZodString;
152
+ parser_lock_digest: z.ZodString;
153
+ source_ref: z.ZodString;
154
+ module_ref: z.ZodNullable<z.ZodString>;
155
+ authority_domain: z.ZodEffects<z.ZodString, string, string>;
156
+ precedence: z.ZodNumber;
157
+ files: z.ZodArray<z.ZodObject<{
158
+ normalized_path: z.ZodEffects<z.ZodString, string, string>;
159
+ content_digest: z.ZodString;
160
+ contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
161
+ role: z.ZodEnum<["primary-owner", "enricher"]>;
162
+ }, "strict", z.ZodTypeAny, {
163
+ role: "enricher" | "primary-owner";
164
+ content_digest: string;
165
+ normalized_path: string;
166
+ contract_scope: string | null;
167
+ }, {
168
+ role: "enricher" | "primary-owner";
169
+ content_digest: string;
170
+ normalized_path: string;
171
+ contract_scope: string | null;
172
+ }>, "many">;
173
+ }, "strict", z.ZodTypeAny, {
174
+ files: {
175
+ role: "enricher" | "primary-owner";
176
+ content_digest: string;
177
+ normalized_path: string;
178
+ contract_scope: string | null;
179
+ }[];
180
+ source_ref: string;
181
+ module_ref: string | null;
182
+ precedence: number;
183
+ capability: string;
184
+ requirement_digest: string;
185
+ parser_lock_digest: string;
186
+ authority_domain: string;
187
+ }, {
188
+ files: {
189
+ role: "enricher" | "primary-owner";
190
+ content_digest: string;
191
+ normalized_path: string;
192
+ contract_scope: string | null;
193
+ }[];
194
+ source_ref: string;
195
+ module_ref: string | null;
196
+ precedence: number;
197
+ capability: string;
198
+ requirement_digest: string;
199
+ parser_lock_digest: string;
200
+ authority_domain: string;
201
+ }>, {
202
+ files: {
203
+ role: "enricher" | "primary-owner";
204
+ content_digest: string;
205
+ normalized_path: string;
206
+ contract_scope: string | null;
207
+ }[];
208
+ source_ref: string;
209
+ module_ref: string | null;
210
+ precedence: number;
211
+ capability: string;
212
+ requirement_digest: string;
213
+ parser_lock_digest: string;
214
+ authority_domain: string;
215
+ }, {
216
+ files: {
217
+ role: "enricher" | "primary-owner";
218
+ content_digest: string;
219
+ normalized_path: string;
220
+ contract_scope: string | null;
221
+ }[];
222
+ source_ref: string;
223
+ module_ref: string | null;
224
+ precedence: number;
225
+ capability: string;
226
+ requirement_digest: string;
227
+ parser_lock_digest: string;
228
+ authority_domain: string;
229
+ }>, "many">;
230
+ applicability: z.ZodArray<z.ZodDiscriminatedUnion<"disposition", [z.ZodObject<{
231
+ source_ref: z.ZodString;
232
+ module_ref: z.ZodNullable<z.ZodString>;
233
+ normalized_path: z.ZodEffects<z.ZodString, string, string>;
234
+ content_digest: z.ZodString;
235
+ contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
236
+ capability: z.ZodEffects<z.ZodString, string, string>;
237
+ authority_domain: z.ZodEffects<z.ZodString, string, string>;
238
+ disposition: z.ZodLiteral<"applicable">;
239
+ role: z.ZodEnum<["primary-owner", "enricher"]>;
240
+ }, "strict", z.ZodTypeAny, {
241
+ source_ref: string;
242
+ role: "enricher" | "primary-owner";
243
+ content_digest: string;
244
+ module_ref: string | null;
245
+ normalized_path: string;
246
+ disposition: "applicable";
247
+ capability: string;
248
+ authority_domain: string;
249
+ contract_scope: string | null;
250
+ }, {
251
+ source_ref: string;
252
+ role: "enricher" | "primary-owner";
253
+ content_digest: string;
254
+ module_ref: string | null;
255
+ normalized_path: string;
256
+ disposition: "applicable";
257
+ capability: string;
258
+ authority_domain: string;
259
+ contract_scope: string | null;
260
+ }>, z.ZodObject<{
261
+ source_ref: z.ZodString;
262
+ module_ref: z.ZodNullable<z.ZodString>;
263
+ normalized_path: z.ZodEffects<z.ZodString, string, string>;
264
+ content_digest: z.ZodString;
265
+ contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
266
+ capability: z.ZodEffects<z.ZodString, string, string>;
267
+ authority_domain: z.ZodEffects<z.ZodString, string, string>;
268
+ disposition: z.ZodEnum<["not-applicable", "excluded-by-scope", "unsupported-format"]>;
269
+ reason_code: z.ZodEffects<z.ZodString, string, string>;
270
+ }, "strict", z.ZodTypeAny, {
271
+ source_ref: string;
272
+ content_digest: string;
273
+ module_ref: string | null;
274
+ normalized_path: string;
275
+ disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
276
+ capability: string;
277
+ authority_domain: string;
278
+ reason_code: string;
279
+ contract_scope: string | null;
280
+ }, {
281
+ source_ref: string;
282
+ content_digest: string;
283
+ module_ref: string | null;
284
+ normalized_path: string;
285
+ disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
286
+ capability: string;
287
+ authority_domain: string;
288
+ reason_code: string;
289
+ contract_scope: string | null;
290
+ }>]>, "many">;
291
+ } & {
292
+ plan_digest: z.ZodString;
293
+ }, "strict", z.ZodTypeAny, {
294
+ entries: {
295
+ files: {
296
+ role: "enricher" | "primary-owner";
297
+ content_digest: string;
298
+ normalized_path: string;
299
+ contract_scope: string | null;
300
+ }[];
301
+ source_ref: string;
302
+ module_ref: string | null;
303
+ precedence: number;
304
+ capability: string;
305
+ requirement_digest: string;
306
+ parser_lock_digest: string;
307
+ authority_domain: string;
308
+ }[];
309
+ protocol: "context.indexer.parser-execution-plan/v1";
310
+ profile_contract_digest: string;
311
+ source_registry_digest: string;
312
+ applicability: ({
313
+ source_ref: string;
314
+ role: "enricher" | "primary-owner";
315
+ content_digest: string;
316
+ module_ref: string | null;
317
+ normalized_path: string;
318
+ disposition: "applicable";
319
+ capability: string;
320
+ authority_domain: string;
321
+ contract_scope: string | null;
322
+ } | {
323
+ source_ref: string;
324
+ content_digest: string;
325
+ module_ref: string | null;
326
+ normalized_path: string;
327
+ disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
328
+ capability: string;
329
+ authority_domain: string;
330
+ reason_code: string;
331
+ contract_scope: string | null;
332
+ })[];
333
+ plan_digest: string;
334
+ }, {
335
+ entries: {
336
+ files: {
337
+ role: "enricher" | "primary-owner";
338
+ content_digest: string;
339
+ normalized_path: string;
340
+ contract_scope: string | null;
341
+ }[];
342
+ source_ref: string;
343
+ module_ref: string | null;
344
+ precedence: number;
345
+ capability: string;
346
+ requirement_digest: string;
347
+ parser_lock_digest: string;
348
+ authority_domain: string;
349
+ }[];
350
+ protocol: "context.indexer.parser-execution-plan/v1";
351
+ profile_contract_digest: string;
352
+ source_registry_digest: string;
353
+ applicability: ({
354
+ source_ref: string;
355
+ role: "enricher" | "primary-owner";
356
+ content_digest: string;
357
+ module_ref: string | null;
358
+ normalized_path: string;
359
+ disposition: "applicable";
360
+ capability: string;
361
+ authority_domain: string;
362
+ contract_scope: string | null;
363
+ } | {
364
+ source_ref: string;
365
+ content_digest: string;
366
+ module_ref: string | null;
367
+ normalized_path: string;
368
+ disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
369
+ capability: string;
370
+ authority_domain: string;
371
+ reason_code: string;
372
+ contract_scope: string | null;
373
+ })[];
374
+ plan_digest: string;
375
+ }>;
376
+ export type IndexerParserApplicability = z.infer<typeof indexerParserApplicabilitySchema>;
377
+ export type IndexerParserExecutionPlanEntry = z.infer<typeof indexerParserExecutionPlanEntrySchema>;
378
+ export type IndexerParserExecutionPlan = z.infer<typeof indexerParserExecutionPlanSchema>;
379
+ export declare function indexerParserExecutionEntryDigest(value: z.input<typeof indexerParserExecutionPlanEntrySchema>): string;
380
+ export declare function buildIndexerParserExecutionPlan(input: {
381
+ profile_contract_digest: string;
382
+ source_registry_digest: string;
383
+ entries: readonly z.input<typeof indexerParserExecutionPlanEntrySchema>[];
384
+ applicability: readonly z.input<typeof indexerParserApplicabilitySchema>[];
385
+ }): IndexerParserExecutionPlan;
386
+ export declare function validateIndexerParserExecutionPlan(value: unknown): IndexerParserExecutionPlan;
387
+ export declare function indexerParserExecutionPlanDigest(value: unknown): string;
388
+ export declare function sameIndexerParserExecutionPlan(left: unknown, right: unknown): boolean;