@c4a/context 0.7.5 → 0.7.9

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 (98) hide show
  1. package/README.md +12 -4
  2. package/README.zh-CN.md +11 -4
  3. package/docs/README.md +13 -1
  4. package/docs/README.zh-CN.md +13 -1
  5. package/docs/getting-started.md +95 -69
  6. package/docs/guides/agent-dialogue.md +20 -9
  7. package/docs/guides/agent-guide.md +48 -10
  8. package/docs/guides/code-indexer-skill-authoring.md +42 -11
  9. package/docs/guides/indexer-manifest-example.md +103 -0
  10. package/docs/guides/indexer-provider-and-customization.md +334 -15
  11. package/docs/guides/indexer-skill-creation.md +99 -0
  12. package/docs/guides/knowledge-updates.md +422 -0
  13. package/docs/guides/lark-resources.md +5 -1
  14. package/docs/guides/markdown-indexer-skill-authoring.md +16 -7
  15. package/docs/guides/note.md +37 -0
  16. package/docs/guides/package-outputs.md +231 -60
  17. package/docs/guides/sessions.md +50 -0
  18. package/docs/guides/workspace-commit.md +45 -0
  19. package/docs/guides/workspace-prepare.md +72 -0
  20. package/docs/guides/workspace-restore.md +59 -0
  21. package/docs/reference/code-extractors.md +23 -11
  22. package/docs/reference/indexer-provider-protocol.md +135 -22
  23. package/docs/reference/package-templates.md +10 -9
  24. package/docs/reference/project-api.md +100 -13
  25. package/docs/reference/template-variables.md +7 -7
  26. package/index.d.ts +15 -0
  27. package/index.js +1708 -626
  28. package/indexerAgentStepProtocol.d.ts +44 -0
  29. package/indexerApprovedKnowledge.d.ts +371 -0
  30. package/indexerArticlePlan.d.ts +83 -0
  31. package/indexerArtifact.d.ts +10 -7
  32. package/indexerArtifactDependencies.d.ts +5 -5
  33. package/indexerArtifactPolicy.d.ts +12 -12
  34. package/indexerArtifactResult.d.ts +76 -69
  35. package/indexerAuthoringFixture.d.ts +8 -8
  36. package/indexerAuthorizedWorksetView.d.ts +14 -14
  37. package/indexerBaseQuestionAmendment.d.ts +40 -0
  38. package/indexerCandidateCompile.d.ts +46 -36
  39. package/indexerCatalogFallback.d.ts +566 -48
  40. package/indexerContentLayers.d.ts +6 -4
  41. package/indexerContractDeclaration.d.ts +3 -0
  42. package/indexerControlledProgram.d.ts +1039 -238
  43. package/indexerCustomizationDraft.d.ts +188 -0
  44. package/indexerDependencyView.d.ts +17 -17
  45. package/indexerEffectiveArtifact.d.ts +26 -15
  46. package/indexerExampleFactDependencies.d.ts +17 -0
  47. package/indexerExampleIdentityAudit.d.ts +2 -2
  48. package/indexerInventoryDisposition.d.ts +44 -44
  49. package/indexerKnowledgeDependency.d.ts +46 -0
  50. package/indexerLayerComposition.d.ts +92 -54
  51. package/indexerLayoutChange.d.ts +8 -8
  52. package/indexerLayoutProposalSet.d.ts +15 -10
  53. package/indexerLayoutResolver.d.ts +15 -6
  54. package/indexerLayoutTransition.d.ts +8 -8
  55. package/indexerLifecycle.d.ts +1 -1
  56. package/indexerMainRunLedger.d.ts +3 -0
  57. package/indexerMainRunProtocol.d.ts +872 -196
  58. package/indexerMainWorkset.d.ts +50 -0
  59. package/indexerNavigationArtifactPlan.d.ts +2 -2
  60. package/indexerOverlayQuestionAmendment.d.ts +56 -16
  61. package/indexerOverlayQuestionApplyProposal.d.ts +98 -26
  62. package/indexerPartitionPlan.d.ts +585 -40
  63. package/indexerPhysicalArtifactAudit.d.ts +2 -2
  64. package/indexerPhysicalArtifactManifest.d.ts +24 -24
  65. package/indexerPostAuthorRunLedger.d.ts +60 -34
  66. package/indexerPrimaryProjection.d.ts +2 -2
  67. package/indexerProfileContract.d.ts +28 -28
  68. package/indexerProgramRunProtocol.d.ts +868 -194
  69. package/indexerProjectProposal.d.ts +36 -8
  70. package/indexerProjectedArtifactFanOutAudit.d.ts +2 -2
  71. package/indexerProtocolHash.d.ts +2 -0
  72. package/indexerProvider.d.ts +102 -58
  73. package/indexerProviderComposition.d.ts +4 -4
  74. package/indexerProviderRouting.d.ts +52 -0
  75. package/indexerProviderSelectionProposal.d.ts +48 -0
  76. package/indexerPublicContractFacts.d.ts +7 -0
  77. package/indexerPublicContractTable.d.ts +11 -0
  78. package/indexerReaderTargetInventory.d.ts +6 -6
  79. package/indexerReferenceOnlyAudit.d.ts +2 -2
  80. package/indexerRegistry.d.ts +658 -0
  81. package/indexerRequirementConfirmation.d.ts +48 -16
  82. package/indexerRequirementLifecycle.d.ts +154 -42
  83. package/indexerResultReconciliation.d.ts +12 -11
  84. package/indexerSemanticInput.d.ts +27168 -3813
  85. package/{indexerGeneratedAuthoringAudit.d.ts → indexerStructuredClaims.d.ts} +0 -84
  86. package/indexerStructuredDeclaration.d.ts +8 -8
  87. package/indexerTemplateRendering.d.ts +7 -7
  88. package/indexerToolSnapshot.d.ts +16 -16
  89. package/knowledgeMap.d.ts +188 -0
  90. package/managedSources.d.ts +15 -0
  91. package/package.json +1 -1
  92. package/packageSite.d.ts +25 -0
  93. package/phases.d.ts +0 -3
  94. package/processedScopes.d.ts +75 -0
  95. package/sessionMetadata.d.ts +49 -0
  96. package/sources.d.ts +9 -3
  97. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +15 -10
  98. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +8 -8
@@ -866,7 +866,7 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
866
866
  blocks: ({
867
867
  block_id: string;
868
868
  layer: "deterministic-block";
869
- renderer: "bullet-list" | "key-value-table" | "json-code-block";
869
+ renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
870
870
  fact_refs: string[];
871
871
  } | {
872
872
  evidence_refs: string[];
@@ -875,6 +875,7 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
875
875
  markdown: string;
876
876
  })[];
877
877
  }[];
878
+ template_id?: string | undefined;
878
879
  })[];
879
880
  indexer_id: string;
880
881
  provider_integrity: string;
@@ -963,41 +964,41 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
963
964
  section_key: string;
964
965
  artifact_id: string;
965
966
  }[];
966
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
967
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
967
968
  inventory_disposition: "owned";
968
969
  projection_disposition: "detailed";
969
970
  } | {
970
971
  member_id: string;
971
972
  capability_group_ref: string;
972
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
973
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
973
974
  inventory_disposition: "owned";
974
975
  projection_disposition: "capability-group";
975
976
  } | {
976
977
  fact_refs: string[];
977
978
  member_id: string;
978
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
979
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
979
980
  inventory_disposition: "owned";
980
981
  projection_disposition: "catalog-only";
981
982
  } | {
982
983
  evidence_refs: string[];
983
984
  member_id: string;
984
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
985
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
985
986
  inventory_disposition: "owned";
986
987
  projection_disposition: "boundary-only";
987
988
  } | {
988
989
  evidence_refs: string[];
989
990
  member_id: string;
990
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
991
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
991
992
  inventory_disposition: "excluded-with-reason";
992
993
  reason_code: string;
993
994
  } | {
994
995
  member_id: string;
995
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
996
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
996
997
  inventory_disposition: "unsupported";
997
998
  missing_capabilities: string[];
998
999
  } | {
999
1000
  member_id: string;
1000
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1001
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1001
1002
  inventory_disposition: "request-material";
1002
1003
  material_question_proposal_ref: string;
1003
1004
  })[];
@@ -1021,16 +1022,16 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
1021
1022
  protocol: "context.indexer.artifact-bundle/v1";
1022
1023
  artifact_policy_variant: string;
1023
1024
  artifacts: ({
1025
+ purpose: "required" | "discretionary";
1024
1026
  evidence_refs: string[];
1025
1027
  artifact_kind: string;
1026
1028
  artifact_id: string;
1027
- purpose: "required" | "discretionary";
1028
1029
  reader_question_refs: string[];
1029
1030
  } | {
1031
+ purpose: "semantic-split";
1030
1032
  evidence_refs: string[];
1031
1033
  artifact_kind: string;
1032
1034
  artifact_id: string;
1033
- purpose: "semantic-split";
1034
1035
  reader_question_refs: string[];
1035
1036
  split_of: string;
1036
1037
  boundary: {
@@ -1069,7 +1070,7 @@ export declare function relevantResults(owner: OwnerCell, results: readonly Inde
1069
1070
  module_ref: string | null;
1070
1071
  carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
1071
1072
  carrier_ref: string;
1072
- declaration_kind: "locator" | "handler" | "entry" | "directory" | "method" | "store";
1073
+ declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
1073
1074
  target: {
1074
1075
  normalized_path: string;
1075
1076
  target_type: "directory";