npm - @c4a/context - Versions diffs - 0.7.8 → 0.7.10-alpha.1 - Mend

@c4a/context 0.7.8 → 0.7.10-alpha.1

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 (84) hide show

package/articleStructure.d.ts +254 -0
package/docs/guides/agent-dialogue.md +6 -5
package/docs/guides/agent-guide.md +11 -5
package/docs/guides/code-indexer-skill-authoring.md +76 -178
package/docs/guides/indexer-provider-and-customization.md +93 -398
package/docs/guides/indexer-skill-creation.md +107 -97
package/docs/guides/knowledge-updates.md +137 -18
package/docs/guides/markdown-indexer-skill-authoring.md +57 -134
package/docs/guides/package-outputs.md +213 -47
package/docs/reference/indexer-provider-protocol.md +71 -102
package/docs/reference/package-templates.md +39 -65
package/docs/reference/project-api.md +53 -0
package/docs/reference/template-variables.md +2 -3
package/index.d.ts +11 -11
package/index.js +5826 -8062
package/indexerAgentStepProtocol.d.ts +0 -910
package/indexerApprovedKnowledge.d.ts +98 -359
package/indexerArticlePlan.d.ts +3 -26
package/indexerArtifact.d.ts +201 -70
package/indexerArtifactPolicy.d.ts +4 -22
package/indexerArtifactResult.d.ts +240 -888
package/indexerAuthoringFixture.d.ts +0 -13
package/indexerBenchmark.d.ts +2 -2
package/indexerCandidateCompile.d.ts +123 -167
package/indexerCatalogFallback.d.ts +32 -374
package/indexerCollectionMapping.d.ts +2 -2
package/indexerContentLayers.d.ts +187 -41
package/indexerContractOverlay.d.ts +30 -44
package/indexerControlledInvocation.d.ts +6 -6
package/indexerControlledProgram.d.ts +959 -3020
package/indexerDependencyView.d.ts +96 -96
package/indexerEffectiveArtifact.d.ts +381 -242
package/indexerExampleDecision.d.ts +134 -134
package/indexerExampleIdentity.d.ts +6 -6
package/indexerExampleIdentityAudit.d.ts +6 -6
package/indexerInventoryDisposition.d.ts +0 -39
package/indexerLayerComposition.d.ts +1378 -852
package/indexerLayoutChange.d.ts +24 -33
package/indexerLayoutProposalSet.d.ts +143 -137
package/indexerLayoutResolver.d.ts +116 -101
package/indexerLayoutTransition.d.ts +6 -6
package/indexerMainLifecycle.d.ts +1 -11
package/indexerMainRunLedger.d.ts +0 -14
package/indexerMainRunProtocol.d.ts +806 -2530
package/indexerMainWorkset.d.ts +0 -1212
package/indexerNavigationArtifactPlan.d.ts +2 -2
package/indexerOverlayQuestionApplyProposal.d.ts +0 -4
package/indexerParserCoordinate.d.ts +2 -2
package/indexerParserExecutionPlan.d.ts +42 -42
package/indexerPartitionPlan.d.ts +24 -354
package/indexerPhysicalArtifactManifest.d.ts +12 -27
package/indexerPostAuthorComposition.d.ts +2 -253
package/indexerPostAuthorRunLedger.d.ts +860 -562
package/indexerPrimaryProjection.d.ts +2 -2
package/indexerPrimaryResultView.d.ts +0 -318
package/indexerProfileContract.d.ts +200 -549
package/indexerProgramExecutionAuthorization.d.ts +4 -4
package/indexerProgramRunProtocol.d.ts +806 -2527
package/indexerProjectProposal.d.ts +8 -8
package/indexerProjectedArtifactFanOutAudit.d.ts +8 -8
package/indexerProjectedArtifactPlan.d.ts +0 -9
package/indexerProtocolHash.d.ts +2 -0
package/indexerProvider.d.ts +76 -318
package/indexerProviderComposition.d.ts +16 -42
package/indexerQuestionAuthority.d.ts +2 -82
package/indexerReaderTargetInventory.d.ts +6 -6
package/indexerRegistry.d.ts +606 -0
package/indexerRequirementLifecycle.d.ts +6 -6
package/indexerResultReconciliation.d.ts +35 -149
package/indexerSemanticInput.d.ts +10926 -5665
package/indexerStructuredDeclaration.d.ts +24 -24
package/indexerTemplateRendering.d.ts +239 -113
package/{readingStructure.d.ts → knowledgeMap.d.ts} +21 -21
package/package.json +1 -1
package/packageSite.d.ts +25 -0
package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +13 -16
package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +9 -9
package/indexerArtifactDependencies.d.ts +0 -693
package/indexerCompositionFactDependencies.d.ts +0 -16
package/indexerExampleFactDependencies.d.ts +0 -17
package/indexerIncrementalImpact.d.ts +0 -221
package/indexerKnowledgeDependency.d.ts +0 -46
package/indexerSubjectCatalog.d.ts +0 -230
package/indexerSubjectKeyAuthority.d.ts +0 -786

package/indexerPrimaryProjection.d.ts CHANGED Viewed

@@ -30,8 +30,8 @@ export declare const indexerPrimaryRegistryProjectionSchema: z.ZodObject<{
     customization: Record<string, IndexerJson> | null;
     operation: "main-index";
     indexer_id: string;
-    projection_digest: string;
     provider_layers: Record<string, IndexerJson>[];
+    projection_digest: string;
 }, {
     protocol: "context.indexer.primary-registry-projection/v1";
     requirement_bindings: Record<string, IndexerJson>[];
@@ -43,8 +43,8 @@ export declare const indexerPrimaryRegistryProjectionSchema: z.ZodObject<{
     customization: Record<string, IndexerJson> | null;
     operation: "main-index";
     indexer_id: string;
-    projection_digest: string;
     provider_layers: Record<string, IndexerJson>[];
+    projection_digest: string;
 }>;
 export type IndexerPrimaryRegistryProjection = z.infer<typeof indexerPrimaryRegistryProjectionSchema>;
 type PrimaryRegistryProjectionPayload = Omit<IndexerPrimaryRegistryProjection, "projection_digest">;

package/indexerPrimaryResultView.d.ts CHANGED Viewed

@@ -1,148 +1,17 @@
 import { z } from "zod";
 import { type IndexerArtifactResult } from "./indexerArtifactResult.js";
 import type { IndexerJson } from "./indexerRegistry.js";
-declare const primaryFactSchema: z.ZodObject<{
-    fact_ref: z.ZodString;
-    subject_key: z.ZodObject<{
-        protocol: z.ZodLiteral<"context.subject-key/v1">;
-        namespace: z.ZodEffects<z.ZodString, string, string>;
-        kind: z.ZodEffects<z.ZodString, string, string>;
-        local_key: z.ZodEffects<z.ZodString, string, string>;
-    }, "strict", z.ZodTypeAny, {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }, {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }>;
-    fact_kind: z.ZodEffects<z.ZodString, string, string>;
-    value: z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>;
-    evidence_refs: z.ZodEffects<z.ZodArray<z.ZodObject<{
-        ref: z.ZodString;
-        kind: z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>;
-        source_digest: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }, {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }>, "many">, {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[], {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[]>;
-}, "strict", z.ZodTypeAny, {
-    value: IndexerJson;
-    fact_ref: string;
-    fact_kind: string;
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    evidence_refs: {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[];
-}, {
-    value: IndexerJson;
-    fact_ref: string;
-    fact_kind: string;
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    evidence_refs: {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[];
-}>;
 declare const primaryArtifactSchema: z.ZodObject<{
     artifact_ref: z.ZodString;
-    subject_key: z.ZodObject<{
-        protocol: z.ZodLiteral<"context.subject-key/v1">;
-        namespace: z.ZodEffects<z.ZodString, string, string>;
-        kind: z.ZodEffects<z.ZodString, string, string>;
-        local_key: z.ZodEffects<z.ZodString, string, string>;
-    }, "strict", z.ZodTypeAny, {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }, {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }>;
     artifact_kind: z.ZodEffects<z.ZodString, string, string>;
     artifact_policy_variant: z.ZodEffects<z.ZodString, string, string>;
     variables: z.ZodRecord<z.ZodString, z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>>;
-    evidence_refs: z.ZodEffects<z.ZodArray<z.ZodObject<{
-        ref: z.ZodString;
-        kind: z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>;
-        source_digest: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }, {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }>, "many">, {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[], {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[]>;
 }, "strict", z.ZodTypeAny, {
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    evidence_refs: {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[];
     artifact_kind: string;
     variables: Record<string, IndexerJson>;
     artifact_policy_variant: string;
     artifact_ref: string;
 }, {
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    evidence_refs: {
-        ref: string;
-        kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-        source_digest: string;
-    }[];
     artifact_kind: string;
     variables: Record<string, IndexerJson>;
     artifact_policy_variant: string;
@@ -153,148 +22,17 @@ export declare const indexerPrimaryResultViewSchema: z.ZodObject<{
     workset_digest: z.ZodString;
     primary_result_digest: z.ZodString;
     primary_result_protocol: z.ZodLiteral<"context.indexer.main-result/v1">;
-    facts: z.ZodArray<z.ZodObject<{
-        fact_ref: z.ZodString;
-        subject_key: z.ZodObject<{
-            protocol: z.ZodLiteral<"context.subject-key/v1">;
-            namespace: z.ZodEffects<z.ZodString, string, string>;
-            kind: z.ZodEffects<z.ZodString, string, string>;
-            local_key: z.ZodEffects<z.ZodString, string, string>;
-        }, "strict", z.ZodTypeAny, {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        }, {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        }>;
-        fact_kind: z.ZodEffects<z.ZodString, string, string>;
-        value: z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>;
-        evidence_refs: z.ZodEffects<z.ZodArray<z.ZodObject<{
-            ref: z.ZodString;
-            kind: z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>;
-            source_digest: z.ZodString;
-        }, "strict", z.ZodTypeAny, {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }, {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }>, "many">, {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[], {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[]>;
-    }, "strict", z.ZodTypeAny, {
-        value: IndexerJson;
-        fact_ref: string;
-        fact_kind: string;
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
-    }, {
-        value: IndexerJson;
-        fact_ref: string;
-        fact_kind: string;
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
-    }>, "many">;
     artifacts: z.ZodArray<z.ZodObject<{
         artifact_ref: z.ZodString;
-        subject_key: z.ZodObject<{
-            protocol: z.ZodLiteral<"context.subject-key/v1">;
-            namespace: z.ZodEffects<z.ZodString, string, string>;
-            kind: z.ZodEffects<z.ZodString, string, string>;
-            local_key: z.ZodEffects<z.ZodString, string, string>;
-        }, "strict", z.ZodTypeAny, {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        }, {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        }>;
         artifact_kind: z.ZodEffects<z.ZodString, string, string>;
         artifact_policy_variant: z.ZodEffects<z.ZodString, string, string>;
         variables: z.ZodRecord<z.ZodString, z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>>;
-        evidence_refs: z.ZodEffects<z.ZodArray<z.ZodObject<{
-            ref: z.ZodString;
-            kind: z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>;
-            source_digest: z.ZodString;
-        }, "strict", z.ZodTypeAny, {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }, {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }>, "many">, {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[], {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[]>;
     }, "strict", z.ZodTypeAny, {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
         artifact_kind: string;
         variables: Record<string, IndexerJson>;
         artifact_policy_variant: string;
         artifact_ref: string;
     }, {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
         artifact_kind: string;
         variables: Record<string, IndexerJson>;
         artifact_policy_variant: string;
@@ -322,22 +60,6 @@ export declare const indexerPrimaryResultViewSchema: z.ZodObject<{
     }>;
 }, "strict", z.ZodTypeAny, {
     protocol: "context.indexer.primary-result-view/v1";
-    facts: {
-        value: IndexerJson;
-        fact_ref: string;
-        fact_kind: string;
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
-    }[];
     workset_digest: string;
     materialization_receipt: {
         protocol: "context.indexer.primary-result-view-materialization-receipt/v1";
@@ -348,17 +70,6 @@ export declare const indexerPrimaryResultViewSchema: z.ZodObject<{
     };
     view_digest: string;
     artifacts: {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
         artifact_kind: string;
         variables: Record<string, IndexerJson>;
         artifact_policy_variant: string;
@@ -368,22 +79,6 @@ export declare const indexerPrimaryResultViewSchema: z.ZodObject<{
     primary_result_protocol: "context.indexer.main-result/v1";
 }, {
     protocol: "context.indexer.primary-result-view/v1";
-    facts: {
-        value: IndexerJson;
-        fact_ref: string;
-        fact_kind: string;
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
-    }[];
     workset_digest: string;
     materialization_receipt: {
         protocol: "context.indexer.primary-result-view-materialization-receipt/v1";
@@ -394,17 +89,6 @@ export declare const indexerPrimaryResultViewSchema: z.ZodObject<{
     };
     view_digest: string;
     artifacts: {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        evidence_refs: {
-            ref: string;
-            kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
-            source_digest: string;
-        }[];
         artifact_kind: string;
         variables: Record<string, IndexerJson>;
         artifact_policy_variant: string;
@@ -413,7 +97,6 @@ export declare const indexerPrimaryResultViewSchema: z.ZodObject<{
     primary_result_digest: string;
     primary_result_protocol: "context.indexer.main-result/v1";
 }>;
-export type IndexerPrimaryFactView = z.infer<typeof primaryFactSchema>;
 export type IndexerPrimaryArtifactView = z.infer<typeof primaryArtifactSchema>;
 export type IndexerPrimaryResultView = z.infer<typeof indexerPrimaryResultViewSchema>;
 type PrimaryResultViewContent = Omit<IndexerPrimaryResultView, "view_digest" | "materialization_receipt">;
@@ -421,7 +104,6 @@ export declare function indexerPrimaryResultViewDigest(view: PrimaryResultViewCo
 export declare function materializeIndexerPrimaryResultView(input: {
     workset_digest: string;
     primary_result_digest: string;
-    facts: readonly IndexerPrimaryFactView[];
     artifacts: readonly IndexerPrimaryArtifactView[];
     validator_contract_digest: string;
 }): IndexerPrimaryResultView;