npm - @c4a/context - Versions diffs - 0.7.9 → 0.7.10-alpha.2 - Mend

@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

package/articleStructure.d.ts +254 -0
package/docs/guides/agent-dialogue.md +1 -1
package/docs/guides/code-indexer-skill-authoring.md +76 -178
package/docs/guides/indexer-provider-and-customization.md +93 -453
package/docs/guides/indexer-skill-creation.md +107 -97
package/docs/guides/knowledge-updates.md +35 -14
package/docs/guides/markdown-indexer-skill-authoring.md +57 -134
package/docs/reference/indexer-provider-protocol.md +52 -102
package/docs/reference/package-templates.md +39 -65
package/docs/reference/template-variables.md +2 -3
package/index.d.ts +6 -10
package/index.js +6441 -8771
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 +0 -18
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/indexerProvider.d.ts +46 -288
package/indexerProviderComposition.d.ts +16 -42
package/indexerQuestionAuthority.d.ts +2 -82
package/indexerReaderTargetInventory.d.ts +6 -6
package/indexerRequirementLifecycle.d.ts +6 -6
package/indexerResultReconciliation.d.ts +35 -149
package/indexerSemanticInput.d.ts +10642 -4685
package/indexerStructuredDeclaration.d.ts +24 -24
package/indexerTemplateRendering.d.ts +239 -113
package/knowledgeMap.d.ts +5 -5
package/package.json +1 -1
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/indexerArtifact.d.ts CHANGED Viewed

@@ -23,16 +23,69 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
     template_id: z.ZodEffects<z.ZodString, string, string>;
     variables: z.ZodRecord<z.ZodString, z.ZodObject<{
         value: z.ZodType<import("./indexerRegistry.js").IndexerJson, z.ZodTypeDef, import("./indexerRegistry.js").IndexerJson>;
-        fact_refs: z.ZodArray<z.ZodString, "many">;
-        evidence_refs: z.ZodArray<z.ZodString, "many">;
+        references: z.ZodArray<z.ZodObject<{
+            source_ref: z.ZodString;
+            locator: z.ZodEffects<z.ZodObject<{
+                path: z.ZodEffects<z.ZodString, string, string>;
+                start_line: z.ZodNumber;
+                end_line: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                path: string;
+                start_line: number;
+                end_line: number;
+            }, {
+                path: string;
+                start_line: number;
+                end_line: number;
+            }>, {
+                path: string;
+                start_line: number;
+                end_line: number;
+            }, {
+                path: string;
+                start_line: number;
+                end_line: number;
+            }>;
+            content_digest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }, {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }>, "many">;
     }, "strict", z.ZodTypeAny, {
         value: import("./indexerRegistry.js").IndexerJson;
-        evidence_refs: string[];
-        fact_refs: string[];
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
     }, {
         value: import("./indexerRegistry.js").IndexerJson;
-        evidence_refs: string[];
-        fact_refs: string[];
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
     }>>;
     section_projections: z.ZodArray<z.ZodObject<{
         section_key: z.ZodEffects<z.ZodString, string, string>;
@@ -62,8 +115,15 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
     template_id: string;
     variables: Record<string, {
         value: import("./indexerRegistry.js").IndexerJson;
-        evidence_refs: string[];
-        fact_refs: string[];
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
     }>;
     section_projections: {
         section_key: string;
@@ -80,8 +140,15 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
     template_id: string;
     variables: Record<string, {
         value: import("./indexerRegistry.js").IndexerJson;
-        evidence_refs: string[];
-        fact_refs: string[];
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
     }>;
     section_projections: {
         section_key: string;
@@ -102,127 +169,191 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
         reader_goal: z.ZodEffects<z.ZodString, string, string>;
         artifact_kind: z.ZodEffects<z.ZodString, string, string>;
     } & {
-        blocks: z.ZodArray<z.ZodDiscriminatedUnion<"layer", [z.ZodObject<{
-            block_id: z.ZodEffects<z.ZodString, string, string>;
-            layer: z.ZodLiteral<"deterministic-block">;
-            renderer: z.ZodEnum<["bullet-list", "key-value-table", "multi-column-table", "public-contract-table", "json-code-block"]>;
-            fact_refs: z.ZodArray<z.ZodString, "many">;
-        }, "strict", z.ZodTypeAny, {
-            block_id: string;
-            layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-            fact_refs: string[];
-        }, {
-            block_id: string;
-            layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-            fact_refs: string[];
-        }>, z.ZodObject<{
+        blocks: z.ZodArray<z.ZodObject<{
             block_id: z.ZodEffects<z.ZodString, string, string>;
             layer: z.ZodLiteral<"semantic-prose">;
             markdown: z.ZodString;
-            evidence_refs: z.ZodArray<z.ZodString, "many">;
+            references: z.ZodArray<z.ZodObject<{
+                source_ref: z.ZodString;
+                locator: z.ZodEffects<z.ZodObject<{
+                    path: z.ZodEffects<z.ZodString, string, string>;
+                    start_line: z.ZodNumber;
+                    end_line: z.ZodNumber;
+                }, "strict", z.ZodTypeAny, {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                }, {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                }>, {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                }, {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                }>;
+                content_digest: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }, {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }>, "many">;
         }, "strict", z.ZodTypeAny, {
-            evidence_refs: string[];
+            references: {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }[];
             block_id: string;
             layer: "semantic-prose";
             markdown: string;
         }, {
-            evidence_refs: string[];
+            references: {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }[];
             block_id: string;
             layer: "semantic-prose";
             markdown: string;
-        }>]>, "many">;
+        }>, "many">;
     }, "strict", z.ZodTypeAny, {
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
-        blocks: ({
-            block_id: string;
-            layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-            fact_refs: string[];
-        } | {
-            evidence_refs: string[];
+        blocks: {
+            references: {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }[];
             block_id: string;
             layer: "semantic-prose";
             markdown: string;
-        })[];
+        }[];
     }, {
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
-        blocks: ({
-            block_id: string;
-            layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-            fact_refs: string[];
-        } | {
-            evidence_refs: string[];
+        blocks: {
+            references: {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }[];
             block_id: string;
             layer: "semantic-prose";
             markdown: string;
-        })[];
+        }[];
     }>, "many">;
     artifact_id: z.ZodEffects<z.ZodString, string, string>;
     artifact_kind: z.ZodEffects<z.ZodString, string, string>;
     artifact_policy_variant: z.ZodEffects<z.ZodString, string, string>;
 }, "strict", z.ZodTypeAny, {
-    artifact_kind: string;
-    representation: "sections";
-    artifact_id: string;
-    artifact_policy_variant: string;
     sections: {
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
-        blocks: ({
-            block_id: string;
-            layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-            fact_refs: string[];
-        } | {
-            evidence_refs: string[];
+        blocks: {
+            references: {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }[];
             block_id: string;
             layer: "semantic-prose";
             markdown: string;
-        })[];
+        }[];
     }[];
-    template_id?: string | undefined;
-}, {
     artifact_kind: string;
     representation: "sections";
     artifact_id: string;
     artifact_policy_variant: string;
+    template_id?: string | undefined;
+}, {
     sections: {
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
-        blocks: ({
-            block_id: string;
-            layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-            fact_refs: string[];
-        } | {
-            evidence_refs: string[];
+        blocks: {
+            references: {
+                source_ref: string;
+                locator: {
+                    path: string;
+                    start_line: number;
+                    end_line: number;
+                };
+                content_digest: string;
+            }[];
             block_id: string;
             layer: "semantic-prose";
             markdown: string;
-        })[];
+        }[];
     }[];
+    artifact_kind: string;
+    representation: "sections";
+    artifact_id: string;
+    artifact_policy_variant: string;
     template_id?: string | undefined;
 }>]>;
 export type IndexerArtifact = z.infer<typeof indexerArtifactSchema>;
 export type IndexerArtifactSectionProjection = z.infer<typeof indexerArtifactSectionProjectionSchema>;
-export declare function indexerArtifactRef(nodeRef: string, artifact: {
+export declare function indexerArtifactRef(logicalUnitRef: string, artifact: {
     artifact_id: string;
-    artifact_kind: string;
+    artifact_kind?: string;
 }): string;
+/** Article-wide traversal has no three-source cap; that cap applies to each
+ * individual fragment. This helper never expands references into parser facts. */
+export declare function indexerArtifactReferences(artifact: IndexerArtifact): {
+    source_ref: string;
+    locator: {
+        path: string;
+        start_line: number;
+        end_line: number;
+    };
+    content_digest: string;
+}[];

package/indexerArtifactPolicy.d.ts CHANGED Viewed

@@ -131,16 +131,13 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
     artifact_kind: z.ZodEffects<z.ZodString, string, string>;
     purpose: z.ZodEnum<["required", "discretionary"]>;
     reader_question_refs: z.ZodArray<z.ZodString, "many">;
-    evidence_refs: z.ZodArray<z.ZodString, "many">;
 }, "strict", z.ZodTypeAny, {
     purpose: "required" | "discretionary";
-    evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
     reader_question_refs: string[];
 }, {
     purpose: "required" | "discretionary";
-    evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
     reader_question_refs: string[];
@@ -149,7 +146,6 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
     artifact_kind: z.ZodEffects<z.ZodString, string, string>;
     purpose: z.ZodLiteral<"semantic-split">;
     reader_question_refs: z.ZodArray<z.ZodString, "many">;
-    evidence_refs: z.ZodArray<z.ZodString, "many">;
     split_of: z.ZodEffects<z.ZodString, string, string>;
     boundary: z.ZodObject<{
         axis: z.ZodEffects<z.ZodString, string, string>;
@@ -166,7 +162,6 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
     }>;
 }, "strict", z.ZodTypeAny, {
     purpose: "semantic-split";
-    evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
     reader_question_refs: string[];
@@ -178,7 +173,6 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
     };
 }, {
     purpose: "semantic-split";
-    evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
     reader_question_refs: string[];
@@ -198,16 +192,13 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
         artifact_kind: z.ZodEffects<z.ZodString, string, string>;
         purpose: z.ZodEnum<["required", "discretionary"]>;
         reader_question_refs: z.ZodArray<z.ZodString, "many">;
-        evidence_refs: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
         purpose: "required" | "discretionary";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
     }, {
         purpose: "required" | "discretionary";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
@@ -216,7 +207,6 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
         artifact_kind: z.ZodEffects<z.ZodString, string, string>;
         purpose: z.ZodLiteral<"semantic-split">;
         reader_question_refs: z.ZodArray<z.ZodString, "many">;
-        evidence_refs: z.ZodArray<z.ZodString, "many">;
         split_of: z.ZodEffects<z.ZodString, string, string>;
         boundary: z.ZodObject<{
             axis: z.ZodEffects<z.ZodString, string, string>;
@@ -233,7 +223,6 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
         }>;
     }, "strict", z.ZodTypeAny, {
         purpose: "semantic-split";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
@@ -245,7 +234,6 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
         };
     }, {
         purpose: "semantic-split";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
@@ -265,13 +253,11 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
     artifact_policy_variant: string;
     artifacts: ({
         purpose: "required" | "discretionary";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
     } | {
         purpose: "semantic-split";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
@@ -291,13 +277,11 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
     artifact_policy_variant: string;
     artifacts: ({
         purpose: "required" | "discretionary";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
     } | {
         purpose: "semantic-split";
-        evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
         reader_question_refs: string[];
@@ -327,9 +311,7 @@ export declare function validateIndexerArtifactBundlePolicy(input: {
     actual_artifacts: readonly {
         artifact_id: string;
         artifact_kind: string;
-        evidence_refs: readonly string[];
     }[];
     allowed_question_refs: readonly string[];
-    known_evidence_refs: readonly string[];
 }): IndexerArtifactBundle;
 export {};