@c4a/context 0.7.9 → 0.7.10-alpha.2

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 (78) hide show
  1. package/articleStructure.d.ts +254 -0
  2. package/docs/guides/agent-dialogue.md +1 -1
  3. package/docs/guides/code-indexer-skill-authoring.md +76 -178
  4. package/docs/guides/indexer-provider-and-customization.md +93 -453
  5. package/docs/guides/indexer-skill-creation.md +107 -97
  6. package/docs/guides/knowledge-updates.md +35 -14
  7. package/docs/guides/markdown-indexer-skill-authoring.md +57 -134
  8. package/docs/reference/indexer-provider-protocol.md +52 -102
  9. package/docs/reference/package-templates.md +39 -65
  10. package/docs/reference/template-variables.md +2 -3
  11. package/index.d.ts +6 -10
  12. package/index.js +6441 -8771
  13. package/indexerAgentStepProtocol.d.ts +0 -910
  14. package/indexerApprovedKnowledge.d.ts +98 -359
  15. package/indexerArticlePlan.d.ts +3 -26
  16. package/indexerArtifact.d.ts +201 -70
  17. package/indexerArtifactPolicy.d.ts +0 -18
  18. package/indexerArtifactResult.d.ts +240 -888
  19. package/indexerAuthoringFixture.d.ts +0 -13
  20. package/indexerBenchmark.d.ts +2 -2
  21. package/indexerCandidateCompile.d.ts +123 -167
  22. package/indexerCatalogFallback.d.ts +32 -374
  23. package/indexerCollectionMapping.d.ts +2 -2
  24. package/indexerContentLayers.d.ts +187 -41
  25. package/indexerContractOverlay.d.ts +30 -44
  26. package/indexerControlledInvocation.d.ts +6 -6
  27. package/indexerControlledProgram.d.ts +959 -3020
  28. package/indexerDependencyView.d.ts +96 -96
  29. package/indexerEffectiveArtifact.d.ts +381 -242
  30. package/indexerExampleDecision.d.ts +134 -134
  31. package/indexerExampleIdentity.d.ts +6 -6
  32. package/indexerExampleIdentityAudit.d.ts +6 -6
  33. package/indexerInventoryDisposition.d.ts +0 -39
  34. package/indexerLayerComposition.d.ts +1378 -852
  35. package/indexerLayoutChange.d.ts +24 -33
  36. package/indexerLayoutProposalSet.d.ts +143 -137
  37. package/indexerLayoutResolver.d.ts +116 -101
  38. package/indexerLayoutTransition.d.ts +6 -6
  39. package/indexerMainLifecycle.d.ts +1 -11
  40. package/indexerMainRunLedger.d.ts +0 -14
  41. package/indexerMainRunProtocol.d.ts +806 -2530
  42. package/indexerMainWorkset.d.ts +0 -1212
  43. package/indexerNavigationArtifactPlan.d.ts +2 -2
  44. package/indexerOverlayQuestionApplyProposal.d.ts +0 -4
  45. package/indexerParserCoordinate.d.ts +2 -2
  46. package/indexerParserExecutionPlan.d.ts +42 -42
  47. package/indexerPartitionPlan.d.ts +24 -354
  48. package/indexerPhysicalArtifactManifest.d.ts +12 -27
  49. package/indexerPostAuthorComposition.d.ts +2 -253
  50. package/indexerPostAuthorRunLedger.d.ts +860 -562
  51. package/indexerPrimaryProjection.d.ts +2 -2
  52. package/indexerPrimaryResultView.d.ts +0 -318
  53. package/indexerProfileContract.d.ts +200 -549
  54. package/indexerProgramExecutionAuthorization.d.ts +4 -4
  55. package/indexerProgramRunProtocol.d.ts +806 -2527
  56. package/indexerProjectProposal.d.ts +8 -8
  57. package/indexerProjectedArtifactFanOutAudit.d.ts +8 -8
  58. package/indexerProjectedArtifactPlan.d.ts +0 -9
  59. package/indexerProvider.d.ts +46 -288
  60. package/indexerProviderComposition.d.ts +16 -42
  61. package/indexerQuestionAuthority.d.ts +2 -82
  62. package/indexerReaderTargetInventory.d.ts +6 -6
  63. package/indexerRequirementLifecycle.d.ts +6 -6
  64. package/indexerResultReconciliation.d.ts +35 -149
  65. package/indexerSemanticInput.d.ts +10642 -4685
  66. package/indexerStructuredDeclaration.d.ts +24 -24
  67. package/indexerTemplateRendering.d.ts +239 -113
  68. package/knowledgeMap.d.ts +5 -5
  69. package/package.json +1 -1
  70. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +13 -16
  71. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +9 -9
  72. package/indexerArtifactDependencies.d.ts +0 -693
  73. package/indexerCompositionFactDependencies.d.ts +0 -16
  74. package/indexerExampleFactDependencies.d.ts +0 -17
  75. package/indexerIncrementalImpact.d.ts +0 -221
  76. package/indexerKnowledgeDependency.d.ts +0 -46
  77. package/indexerSubjectCatalog.d.ts +0 -230
  78. package/indexerSubjectKeyAuthority.d.ts +0 -786
@@ -5,15 +5,12 @@ import { type IndexerRegistry } from "./indexerRegistry.js";
5
5
  declare const registeredMaterialSourceSchema: z.ZodObject<{
6
6
  source_ref: z.ZodString;
7
7
  source_input_digest: z.ZodString;
8
- evidence_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
9
8
  }, "strict", z.ZodTypeAny, {
10
9
  source_ref: string;
11
10
  source_input_digest: string;
12
- evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
13
11
  }, {
14
12
  source_ref: string;
15
13
  source_input_digest: string;
16
- evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
17
14
  }>;
18
15
  export declare const capabilityGapSchema: z.ZodObject<{
19
16
  gap_ref: z.ZodString;
@@ -102,7 +99,6 @@ export declare const materialGapDetailSchema: z.ZodObject<{
102
99
  }, "strict", z.ZodTypeAny, {
103
100
  requirement_ref: string;
104
101
  severity: "recommended" | "blocking";
105
- coverage_domain: string;
106
102
  entry: {
107
103
  state: "unresolved";
108
104
  dependencies: {
@@ -118,6 +114,7 @@ export declare const materialGapDetailSchema: z.ZodObject<{
118
114
  question_target_item_digest: string;
119
115
  question_revision_digest: string;
120
116
  };
117
+ coverage_domain: string;
121
118
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
122
119
  owner_cell_ref: string;
123
120
  question_key: string;
@@ -126,7 +123,6 @@ export declare const materialGapDetailSchema: z.ZodObject<{
126
123
  }, {
127
124
  requirement_ref: string;
128
125
  severity: "recommended" | "blocking";
129
- coverage_domain: string;
130
126
  entry: {
131
127
  state: "unresolved";
132
128
  dependencies: {
@@ -142,6 +138,7 @@ export declare const materialGapDetailSchema: z.ZodObject<{
142
138
  question_target_item_digest: string;
143
139
  question_revision_digest: string;
144
140
  };
141
+ coverage_domain: string;
145
142
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
146
143
  owner_cell_ref: string;
147
144
  question_key: string;
@@ -309,7 +306,6 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
309
306
  }, "strict", z.ZodTypeAny, {
310
307
  requirement_ref: string;
311
308
  severity: "recommended" | "blocking";
312
- coverage_domain: string;
313
309
  entry: {
314
310
  state: "unresolved";
315
311
  dependencies: {
@@ -325,6 +321,7 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
325
321
  question_target_item_digest: string;
326
322
  question_revision_digest: string;
327
323
  };
324
+ coverage_domain: string;
328
325
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
329
326
  owner_cell_ref: string;
330
327
  question_key: string;
@@ -333,7 +330,6 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
333
330
  }, {
334
331
  requirement_ref: string;
335
332
  severity: "recommended" | "blocking";
336
- coverage_domain: string;
337
333
  entry: {
338
334
  state: "unresolved";
339
335
  dependencies: {
@@ -349,6 +345,7 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
349
345
  question_target_item_digest: string;
350
346
  question_revision_digest: string;
351
347
  };
348
+ coverage_domain: string;
352
349
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
353
350
  owner_cell_ref: string;
354
351
  question_key: string;
@@ -391,7 +388,6 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
391
388
  material_gaps: {
392
389
  requirement_ref: string;
393
390
  severity: "recommended" | "blocking";
394
- coverage_domain: string;
395
391
  entry: {
396
392
  state: "unresolved";
397
393
  dependencies: {
@@ -407,6 +403,7 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
407
403
  question_target_item_digest: string;
408
404
  question_revision_digest: string;
409
405
  };
406
+ coverage_domain: string;
410
407
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
411
408
  owner_cell_ref: string;
412
409
  question_key: string;
@@ -447,7 +444,6 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
447
444
  material_gaps: {
448
445
  requirement_ref: string;
449
446
  severity: "recommended" | "blocking";
450
- coverage_domain: string;
451
447
  entry: {
452
448
  state: "unresolved";
453
449
  dependencies: {
@@ -463,6 +459,7 @@ export declare const coverageCompletionReportPayloadSchema: z.ZodObject<{
463
459
  question_target_item_digest: string;
464
460
  question_revision_digest: string;
465
461
  };
462
+ coverage_domain: string;
466
463
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
467
464
  owner_cell_ref: string;
468
465
  question_key: string;
@@ -600,7 +597,6 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
600
597
  }, "strict", z.ZodTypeAny, {
601
598
  requirement_ref: string;
602
599
  severity: "recommended" | "blocking";
603
- coverage_domain: string;
604
600
  entry: {
605
601
  state: "unresolved";
606
602
  dependencies: {
@@ -616,6 +612,7 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
616
612
  question_target_item_digest: string;
617
613
  question_revision_digest: string;
618
614
  };
615
+ coverage_domain: string;
619
616
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
620
617
  owner_cell_ref: string;
621
618
  question_key: string;
@@ -624,7 +621,6 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
624
621
  }, {
625
622
  requirement_ref: string;
626
623
  severity: "recommended" | "blocking";
627
- coverage_domain: string;
628
624
  entry: {
629
625
  state: "unresolved";
630
626
  dependencies: {
@@ -640,6 +636,7 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
640
636
  question_target_item_digest: string;
641
637
  question_revision_digest: string;
642
638
  };
639
+ coverage_domain: string;
643
640
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
644
641
  owner_cell_ref: string;
645
642
  question_key: string;
@@ -685,7 +682,6 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
685
682
  material_gaps: {
686
683
  requirement_ref: string;
687
684
  severity: "recommended" | "blocking";
688
- coverage_domain: string;
689
685
  entry: {
690
686
  state: "unresolved";
691
687
  dependencies: {
@@ -701,6 +697,7 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
701
697
  question_target_item_digest: string;
702
698
  question_revision_digest: string;
703
699
  };
700
+ coverage_domain: string;
704
701
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
705
702
  owner_cell_ref: string;
706
703
  question_key: string;
@@ -742,7 +739,6 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
742
739
  material_gaps: {
743
740
  requirement_ref: string;
744
741
  severity: "recommended" | "blocking";
745
- coverage_domain: string;
746
742
  entry: {
747
743
  state: "unresolved";
748
744
  dependencies: {
@@ -758,6 +754,7 @@ export declare const indexerCoverageCompletionReportSchema: z.ZodObject<{
758
754
  question_target_item_digest: string;
759
755
  question_revision_digest: string;
760
756
  };
757
+ coverage_domain: string;
761
758
  reason_code: "provider-requested-material" | "provider-omitted-required-question" | "main-evidence-contract-not-met";
762
759
  owner_cell_ref: string;
763
760
  question_key: string;
@@ -814,18 +811,6 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
814
811
  source_ref: string;
815
812
  protocol: "context.indexer.artifact-result/v1";
816
813
  requirement_ref: string;
817
- facts: {
818
- value: import("./indexerRegistry.js").IndexerJson;
819
- fact_ref: string;
820
- fact_kind: string;
821
- subject_key: {
822
- kind: string;
823
- namespace: string;
824
- protocol: "context.subject-key/v1";
825
- local_key: string;
826
- };
827
- evidence_refs: string[];
828
- }[];
829
814
  module_ref: string | null;
830
815
  input_digest: string;
831
816
  output_digest: string;
@@ -840,8 +825,15 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
840
825
  template_id: string;
841
826
  variables: Record<string, {
842
827
  value: import("./indexerRegistry.js").IndexerJson;
843
- evidence_refs: string[];
844
- fact_refs: string[];
828
+ references: {
829
+ source_ref: string;
830
+ locator: {
831
+ path: string;
832
+ start_line: number;
833
+ end_line: number;
834
+ };
835
+ content_digest: string;
836
+ }[];
845
837
  }>;
846
838
  section_projections: {
847
839
  section_key: string;
@@ -853,28 +845,31 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
853
845
  artifact_id: string;
854
846
  artifact_policy_variant: string;
855
847
  } | {
856
- artifact_kind: string;
857
- representation: "sections";
858
- artifact_id: string;
859
- artifact_policy_variant: string;
860
848
  sections: {
861
849
  section_key: string;
862
850
  owner_indexer_id: string;
863
851
  document_kind: string;
864
852
  reader_goal: string;
865
853
  artifact_kind: string;
866
- blocks: ({
867
- block_id: string;
868
- layer: "deterministic-block";
869
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
870
- fact_refs: string[];
871
- } | {
872
- evidence_refs: string[];
854
+ blocks: {
855
+ references: {
856
+ source_ref: string;
857
+ locator: {
858
+ path: string;
859
+ start_line: number;
860
+ end_line: number;
861
+ };
862
+ content_digest: string;
863
+ }[];
873
864
  block_id: string;
874
865
  layer: "semantic-prose";
875
866
  markdown: string;
876
- })[];
867
+ }[];
877
868
  }[];
869
+ artifact_kind: string;
870
+ representation: "sections";
871
+ artifact_id: string;
872
+ artifact_policy_variant: string;
878
873
  template_id?: string | undefined;
879
874
  })[];
880
875
  indexer_id: string;
@@ -888,45 +883,8 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
888
883
  customization_fingerprint: string | null;
889
884
  source_role: string;
890
885
  logical_unit: {
891
- subject_key: {
892
- kind: string;
893
- namespace: string;
894
- protocol: "context.subject-key/v1";
895
- local_key: string;
896
- };
897
886
  logical_unit_ref: string;
898
887
  group_key: string;
899
- target_resolution_dispositions: ({
900
- target_node_ref: string;
901
- disposition: "reuse-existing";
902
- query_ref: string;
903
- target_subject_key: {
904
- kind: string;
905
- namespace: string;
906
- protocol: "context.subject-key/v1";
907
- local_key: string;
908
- };
909
- } | {
910
- subject_key: {
911
- kind: string;
912
- namespace: string;
913
- protocol: "context.subject-key/v1";
914
- local_key: string;
915
- };
916
- evidence_refs: string[];
917
- disposition: "create-independent";
918
- query_ref: string;
919
- reason_code: string;
920
- } | {
921
- disposition: "request-material";
922
- query_ref: string;
923
- missing_facts: string[];
924
- source_hints: string[];
925
- } | {
926
- disposition: "unsupported";
927
- query_ref: string;
928
- missing_capabilities: string[];
929
- })[];
930
888
  };
931
889
  capability_group_evidence: {
932
890
  protocol: "context.indexer.capability-group-evidence/v1";
@@ -960,7 +918,6 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
960
918
  dispositions: ({
961
919
  member_id: string;
962
920
  section_evidence: {
963
- evidence_refs: string[];
964
921
  section_key: string;
965
922
  artifact_id: string;
966
923
  }[];
@@ -974,19 +931,16 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
974
931
  inventory_disposition: "owned";
975
932
  projection_disposition: "capability-group";
976
933
  } | {
977
- fact_refs: string[];
978
934
  member_id: string;
979
935
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
980
936
  inventory_disposition: "owned";
981
937
  projection_disposition: "catalog-only";
982
938
  } | {
983
- evidence_refs: string[];
984
939
  member_id: string;
985
940
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
986
941
  inventory_disposition: "owned";
987
942
  projection_disposition: "boundary-only";
988
943
  } | {
989
- evidence_refs: string[];
990
944
  member_id: string;
991
945
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
992
946
  inventory_disposition: "excluded-with-reason";
@@ -1004,32 +958,16 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
1004
958
  })[];
1005
959
  disposition_digest: string;
1006
960
  };
1007
- evidence_bindings: {
1008
- kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
1009
- source_ref: string;
1010
- locator: {
1011
- path: string;
1012
- start_line: number;
1013
- end_line: number;
1014
- };
1015
- content_digest: string;
1016
- module_ref: string | null;
1017
- coverage_tier: "ast-catalog" | "lightweight-evidence";
1018
- evidence_ref: string;
1019
- binding_digest: string;
1020
- }[];
1021
961
  artifact_bundle: {
1022
962
  protocol: "context.indexer.artifact-bundle/v1";
1023
963
  artifact_policy_variant: string;
1024
964
  artifacts: ({
1025
965
  purpose: "required" | "discretionary";
1026
- evidence_refs: string[];
1027
966
  artifact_kind: string;
1028
967
  artifact_id: string;
1029
968
  reader_question_refs: string[];
1030
969
  } | {
1031
970
  purpose: "semantic-split";
1032
- evidence_refs: string[];
1033
971
  artifact_kind: string;
1034
972
  artifact_id: string;
1035
973
  reader_question_refs: string[];
@@ -1047,64 +985,19 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
1047
985
  } | null;
1048
986
  material_question_proposals: {
1049
987
  requirement_ref: string;
1050
- source_hints: string[];
1051
988
  proposal_ref: string;
1052
989
  question_ref: string;
1053
990
  question_target_key: string;
991
+ source_hints: string[];
1054
992
  }[];
1055
993
  question_target_dispositions: ({
1056
994
  state: "answered";
1057
995
  question_target_key: string;
1058
- evidence_binding_digest: string;
1059
996
  } | {
1060
997
  state: "material-gap";
1061
998
  material_question_proposal_ref: string;
1062
999
  question_target_key: string;
1063
1000
  })[];
1064
- structured_declarations?: {
1065
- protocol: "context.indexer.structured-declaration-set/v1";
1066
- source_identity_inventory_digest: string;
1067
- declarations: {
1068
- source_ref: string;
1069
- evidence_refs: string[];
1070
- module_ref: string | null;
1071
- carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
1072
- carrier_ref: string;
1073
- declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
1074
- target: {
1075
- normalized_path: string;
1076
- target_type: "directory";
1077
- } | {
1078
- content_digest: string;
1079
- normalized_path: string;
1080
- target_type: "file";
1081
- } | {
1082
- normalized_path: string;
1083
- qualified_item_path: string;
1084
- signature_digest: string;
1085
- target_type: "item";
1086
- source_fact_ref: string;
1087
- };
1088
- declaration_ref: string;
1089
- }[];
1090
- declaration_set_digest: string;
1091
- } | undefined;
1092
- structured_claims?: {
1093
- protocol: "context.indexer.structured-claim-set/v1";
1094
- logical_unit_ref: string;
1095
- author_workset_digest: string;
1096
- claims: {
1097
- evidence_refs: string[];
1098
- claim_ref: string;
1099
- claim_kind: string;
1100
- subject_ref: string;
1101
- owner: {
1102
- section_key: string;
1103
- artifact_id: string;
1104
- };
1105
- }[];
1106
- claims_digest: string;
1107
- } | undefined;
1108
1001
  }[];
1109
1002
  export declare function dispositionMap(input: {
1110
1003
  pairs: readonly QuestionPair[];
@@ -1113,13 +1006,6 @@ export declare function dispositionMap(input: {
1113
1006
  result: IndexerArtifactResult;
1114
1007
  disposition: IndexerArtifactResult["question_target_dispositions"][number];
1115
1008
  }>;
1116
- export declare function mainEvidenceMeetsContract(input: {
1117
- pair: QuestionPair;
1118
- result: IndexerArtifactResult;
1119
- evidence_binding_digest: string;
1120
- evidence_facts: Readonly<Record<string, unknown>>;
1121
- allowed_selector_fact_paths: ReadonlySet<string>;
1122
- }): boolean;
1123
1009
  export declare function materialGap(input: {
1124
1010
  registry: IndexerRegistry;
1125
1011
  pair: QuestionPair;