@c4a/context 0.7.1 → 0.7.5

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 (119) hide show
  1. package/README.md +67 -171
  2. package/README.zh-CN.md +53 -130
  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 +104 -518
  7. package/docs/guides/code-indexer-skill-authoring.md +38 -13
  8. package/docs/guides/indexer-provider-and-customization.md +32 -20
  9. package/docs/guides/markdown-indexer-skill-authoring.md +22 -13
  10. package/docs/reference/code-extractors.md +29 -121
  11. package/docs/reference/indexer-provider-protocol.md +43 -110
  12. package/docs/reference/package-templates.md +2 -3
  13. package/docs/reference/project-api.md +52 -986
  14. package/index.d.ts +10 -8
  15. package/index.js +13132 -15249
  16. package/indexerAgentStepProtocol.d.ts +1326 -8429
  17. package/indexerArtifact.d.ts +225 -0
  18. package/indexerArtifactDependencies.d.ts +43 -39
  19. package/indexerArtifactResult.d.ts +219 -252
  20. package/indexerAuthorizedWorksetView.d.ts +368 -0
  21. package/indexerBaseQuestionAmendment.d.ts +484 -280
  22. package/indexerBenchmark.d.ts +16 -16
  23. package/indexerCandidateCompile.d.ts +66 -60
  24. package/indexerCapabilityGroupEvidence.d.ts +6 -6
  25. package/indexerCatalogFallback.d.ts +122 -128
  26. package/indexerCollectionMapping.d.ts +13 -13
  27. package/indexerCompositionFactDependencies.d.ts +16 -0
  28. package/indexerContentLayers.d.ts +8 -8
  29. package/indexerContractOverlay.d.ts +10 -10
  30. package/indexerControlledInvocation.d.ts +12 -12
  31. package/indexerControlledProgram.d.ts +2467 -2797
  32. package/indexerCoreExports.d.ts +6 -6
  33. package/indexerCustomizationDraft.d.ts +3315 -2091
  34. package/indexerCustomizationLadder.d.ts +2 -2
  35. package/indexerDependencyView.d.ts +108 -108
  36. package/indexerEffectiveArtifact.d.ts +1134 -0
  37. package/indexerEvidenceAdapterAuthorityMerge.d.ts +48 -0
  38. package/indexerEvidenceAdapterResult.d.ts +52 -52
  39. package/indexerExampleDecision.d.ts +128 -128
  40. package/indexerExampleIdentity.d.ts +6 -6
  41. package/indexerGeneratedAuthoringAudit.d.ts +18 -18
  42. package/indexerIncrementalImpact.d.ts +16 -16
  43. package/indexerInspectorWorksetProjection.d.ts +6 -0
  44. package/indexerInventoryDisposition.d.ts +70 -70
  45. package/indexerLayerComposition.d.ts +2139 -373
  46. package/indexerLayoutChange.d.ts +10 -10
  47. package/indexerLayoutProposalSet.d.ts +71 -66
  48. package/indexerLayoutResolver.d.ts +53 -48
  49. package/indexerLayoutTransition.d.ts +0 -50
  50. package/indexerLifecycle.d.ts +0 -13
  51. package/indexerMainLifecycle.d.ts +10 -0
  52. package/indexerMainRunLedger.d.ts +142 -11
  53. package/indexerMainRunProtocol.d.ts +1406 -785
  54. package/indexerMainWorkset.d.ts +460 -206
  55. package/indexerMaterialGapLedger.d.ts +13 -2904
  56. package/indexerOverlayQuestionAmendment.d.ts +491 -287
  57. package/indexerOverlayQuestionApplyProposal.d.ts +1022 -614
  58. package/indexerParserCapabilityCatalog.d.ts +136 -0
  59. package/indexerParserCoordinate.d.ts +16 -16
  60. package/indexerParserDependencyIntent.d.ts +22 -0
  61. package/indexerParserExecutionPlan.d.ts +388 -0
  62. package/indexerParserFactView.d.ts +42 -22
  63. package/indexerPartitionConvergence.d.ts +0 -3
  64. package/indexerPartitionInventory.d.ts +2 -0
  65. package/indexerPartitionPlan.d.ts +101 -99
  66. package/indexerPhysicalArtifactManifest.d.ts +8 -8
  67. package/indexerPostAuthorComposition.d.ts +116 -1156
  68. package/indexerPostAuthorRunLedger.d.ts +1434 -280
  69. package/indexerPrimaryProjection.d.ts +10 -10
  70. package/indexerPrimaryResultView.d.ts +435 -0
  71. package/indexerProfileContract.d.ts +181 -181
  72. package/indexerProgramExecutionAuthorization.d.ts +12 -12
  73. package/indexerProgramRunProtocol.d.ts +2141 -2749
  74. package/indexerProjectProposal.d.ts +496 -292
  75. package/indexerProjectedArtifactFanOutAudit.d.ts +0 -3
  76. package/indexerProtocolCommon.d.ts +4 -1
  77. package/indexerProvider.d.ts +134 -218
  78. package/indexerProviderComposition.d.ts +53 -53
  79. package/indexerProviderResolution.d.ts +12 -12
  80. package/indexerProviderResolutionAction.d.ts +14 -14
  81. package/indexerProviderRouting.d.ts +923 -515
  82. package/indexerProviderSelectionProposal.d.ts +893 -485
  83. package/indexerQuestionAuthority.d.ts +46 -47
  84. package/indexerReaderTargetInventory.d.ts +8 -8
  85. package/indexerRegistry.d.ts +765 -357
  86. package/indexerRequirementConfirmation.d.ts +98 -98
  87. package/indexerRequirementLifecycle.d.ts +224 -224
  88. package/indexerResultReconciliation.d.ts +204 -5919
  89. package/indexerResultReconciliationRun.d.ts +0 -1
  90. package/indexerRunEnvelope.d.ts +20 -20
  91. package/indexerSemanticInput.d.ts +5794 -0
  92. package/indexerStructuredDeclaration.d.ts +57 -53
  93. package/indexerSubjectCatalog.d.ts +14 -14
  94. package/indexerSubjectIdentity.d.ts +2 -2
  95. package/indexerSubjectKeyAuthority.d.ts +31 -30
  96. package/indexerTemplateRendering.d.ts +64 -64
  97. package/indexerToolSnapshot.d.ts +8 -8
  98. package/package.json +1 -1
  99. package/phases.d.ts +3 -183
  100. package/codeIndexPlan.d.ts +0 -158
  101. package/indexerAuditFacts.d.ts +0 -66
  102. package/indexerAuditOverrideReadiness.d.ts +0 -27
  103. package/indexerAuditProtocol.d.ts +0 -238
  104. package/indexerAuditRevision.d.ts +0 -726
  105. package/indexerAuditRevisionActions.d.ts +0 -236
  106. package/indexerMaterialAnswer.d.ts +0 -738
  107. package/indexerMaterialAnswerActualization.d.ts +0 -91
  108. package/indexerMaterialAnswerExecutionPlan.d.ts +0 -2887
  109. package/indexerMaterialAnswerFlow.d.ts +0 -63
  110. package/indexerMaterialAnswerLayout.d.ts +0 -76
  111. package/indexerMaterialAnswerReview.d.ts +0 -217
  112. package/indexerMaterialAnswerReviewRoute.d.ts +0 -6145
  113. package/indexerMaterialAnswerRunLedger.d.ts +0 -918
  114. package/indexerMaterialAnswerRunProtocol.d.ts +0 -1253
  115. package/indexerMaterialQuestionExclusion.d.ts +0 -129
  116. package/indexerMaterialQuestionWorkset.d.ts +0 -508
  117. package/indexerPlannedMaterialAnswer.d.ts +0 -116
  118. package/indexerProfileMetricAudit.d.ts +0 -218
  119. 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;