@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
@@ -1,91 +0,0 @@
1
- import { z } from "zod";
2
- import { type IndexerCurrentEvidenceSource, type IndexerSourceSpanRef } from "./indexerMaterialAnswer.js";
3
- import { type IndexerMaterialAnswerEvidenceCompatibility } from "./indexerMaterialAnswerReview.js";
4
- import { type IndexerMaterialGapLedger, type IndexerMaterialGapLedgerEntry } from "./indexerMaterialGapLedger.js";
5
- import { type IndexerPlannedMaterialAnswer } from "./indexerPlannedMaterialAnswer.js";
6
- import type { IndexerResolvedMaterialQuestion } from "./indexerQuestionAuthority.js";
7
- type ApprovedAnswerEntry = Extract<IndexerMaterialGapLedgerEntry, {
8
- state: "answer-approved" | "resolved";
9
- }>;
10
- export declare function buildIndexerPlannedMaterialAnswer(entry: ApprovedAnswerEntry): IndexerPlannedMaterialAnswer;
11
- export declare function reopenIndexerMaterialAnswerBinding(input: {
12
- ledger: unknown;
13
- expected_revision: string;
14
- question_key: string;
15
- binding_digest: string;
16
- }): IndexerMaterialGapLedger;
17
- export declare function indexerMaterialAnswerActualizationDigest(input: {
18
- binding_digest: string;
19
- planned_answer_digest: string;
20
- answer_landing_ref: string;
21
- actualized_target_ref: string;
22
- section_ref?: string;
23
- layout_digest: string;
24
- }): string;
25
- export declare function actualizeIndexerMaterialAnswer(input: {
26
- ledger: unknown;
27
- expected_revision: string;
28
- question_key: string;
29
- binding_digest: string;
30
- layout_proposal: unknown;
31
- current_question_revision_digest: string;
32
- current_question: IndexerResolvedMaterialQuestion;
33
- current_provider_composition_fingerprints: ReadonlySet<string>;
34
- current_source_input_digests: readonly string[];
35
- current_sources: readonly IndexerCurrentEvidenceSource[];
36
- resolve_evidence_digest: (input: {
37
- source: IndexerCurrentEvidenceSource;
38
- source_spans: readonly IndexerSourceSpanRef[];
39
- }) => string;
40
- }): {
41
- ledger: IndexerMaterialGapLedger;
42
- state: "resolved" | "answer-approved" | "unresolved";
43
- reason_codes: string[];
44
- evidence_compatibility: IndexerMaterialAnswerEvidenceCompatibility;
45
- layout_proposal_digest: string;
46
- planned_answer: IndexerPlannedMaterialAnswer | null;
47
- };
48
- export declare function invalidateIndexerMaterialAnswerActualizations(input: {
49
- ledger: unknown;
50
- expected_revision: string;
51
- invalidated_layout_digest: string;
52
- affected_answer_landing_refs?: readonly string[];
53
- }): {
54
- ledger: IndexerMaterialGapLedger;
55
- reopened_question_keys: string[];
56
- };
57
- declare const approvedMaterialAnswerProjectionSchema: z.ZodObject<{
58
- question_key: z.ZodString;
59
- binding_digest: z.ZodString;
60
- planned_answer_digest: z.ZodString;
61
- actualization_digest: z.ZodString;
62
- actualized_target_ref: z.ZodString;
63
- section_ref: z.ZodOptional<z.ZodString>;
64
- evidence_item_refs: z.ZodArray<z.ZodString, "many">;
65
- evidence_set_digest: z.ZodString;
66
- }, "strict", z.ZodTypeAny, {
67
- binding_digest: string;
68
- question_key: string;
69
- evidence_item_refs: string[];
70
- evidence_set_digest: string;
71
- planned_answer_digest: string;
72
- actualized_target_ref: string;
73
- actualization_digest: string;
74
- section_ref?: string | undefined;
75
- }, {
76
- binding_digest: string;
77
- question_key: string;
78
- evidence_item_refs: string[];
79
- evidence_set_digest: string;
80
- planned_answer_digest: string;
81
- actualized_target_ref: string;
82
- actualization_digest: string;
83
- section_ref?: string | undefined;
84
- }>;
85
- export type IndexerApprovedMaterialAnswerProjection = z.infer<typeof approvedMaterialAnswerProjectionSchema>;
86
- export declare function closeIndexerResolvedMaterialAnswers(input: {
87
- ledger: unknown;
88
- expected_revision: string;
89
- approved_structure_bindings: readonly IndexerApprovedMaterialAnswerProjection[];
90
- }): IndexerMaterialGapLedger;
91
- export {};