@c4a/context 0.6.18 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context",
-  "version": "0.6.18",
+  "version": "0.7.0",
   "type": "module",
   "description": "Declarative SDK for Context knowledge sources, workflows, review, and package outputs",
   "license": "MIT",

package/phases.d.ts

@@ -1,8 +1,8 @@
-import { type FileCaptureProcessorDefinition, type KnowledgeCollection, type MarkdownTransform, type PackageKind, type PackageSelectDefinition, type DocumentMainlineCollection } from "./contracts.js";
+import { type FileCaptureProcessorDefinition, type CodeIndexCollection, type KnowledgeCollection, type MarkdownTransform, type PackageKind, type PackageSelectDefinition, type DocumentMainlineCollection } from "./contracts.js";
 import { DOCUMENT_COMPILE_ACTION_SCHEMA_VERSION } from "./documentEvidence.js";
 import { type CodeIndexCoverageKind, type CodeIndexInspectionAdapter, type CodeIndexUnitPlan } from "./codeIndexPlan.js";
 export { CODE_INDEX_CAPABILITIES, CODE_INDEX_COVERAGE_KINDS, CODE_INDEX_LIFECYCLES, CODE_INDEX_MODULE_FACETS, CODE_INDEX_MODULE_TYPES, CODE_INDEX_OUTPUT_PROFILES, ExtractTsConfigurationError, NO_ENTRY_DETECTED, requiredCodeIndexCoverage, } from "./codeIndexPlan.js";
-export type { CodeIndexCapability, CodeIndexCapabilityGap, CodeIndexCoverageKind, CodeIndexInspectionAdapter, CodeIndexInspectionContext, CodeIndexInspectionFinding, CodeIndexInspectionFindingKind, CodeIndexInspectionResult, CodeIndexLifecycle, CodeIndexModuleFacet, CodeIndexModuleType, CodeIndexOutputProfile, CodeIndexUnitPlan, } from "./codeIndexPlan.js";
+export type { CodeIndexCapability, CodeIndexCapabilityGap, CodeIndexCoverageKind, CodeIndexInspectionAdapter, CodeIndexInspectionContext, CodeIndexInspectionFinding, CodeIndexInspectionFindingKind, CodeIndexInspectionInventory, CodeIndexInspectionResult, CodeIndexIdentityGroup, CodeIndexChainCandidate, CodeIndexChainCandidateDecision, CodeIndexChainCandidateFamily, CodeIndexLifecycle, CodeIndexModuleFacet, CodeIndexModuleType, CodeIndexOutputProfile, CodeIndexUnitPlan, } from "./codeIndexPlan.js";
 import type { DocumentSourceDefinition, DocumentSourceType, FileSourceDefinition, FileSourceReference, LarkSourceDefinition, LarkSourceReference, RepoProjectSourceDefinition, SourceCollectionReference, SourceDefinition } from "./sources.js";
 export type PhaseResourceReference = {
     kind: "source";
@@ -64,7 +64,7 @@ export type ExtractTsPhaseDefinition = {
     reads: readonly PhaseResourceReference[];
     writes: readonly PhaseResourceReference[];
     source: RepoProjectSourceDefinition;
-    collection: "codegraph";
+    collection: CodeIndexCollection;
     include: readonly string[];
     mode: "exports" | "scan";
     entries?: readonly string[];
@@ -82,7 +82,9 @@ export type ExtractTsPhaseDefinition = {
 export interface CustomCodeEvidence {
     source: string;
     file: string;
+    /** Stable canonical-ref token. Do not include ':' or '@'; keep exact signatures in Section prose. */
     symbol: string;
+    /** Stable canonical-ref token. Do not include ':' or '@'. */
     kind: string;
     digest: string;
     line?: number;
@@ -106,6 +108,7 @@ export interface CustomCodeCandidateSection {
     id: string;
     kind: CodeIndexCoverageKind;
     title: string;
+    /** Reader-facing Section body only. Context renders the heading from title. */
     markdown: string;
     evidence: readonly CustomCodeEvidence[];
 }
@@ -114,9 +117,8 @@ export interface CustomCodeCandidateDraft {
     kind: string;
     visibility: string;
     module: string;
-    markdown?: string;
-    /** Evidence-scoped aggregate sections used to prove output-profile coverage. */
-    sections?: readonly CustomCodeCandidateSection[];
+    /** Required evidence-scoped sections used to render the page and prove output-profile coverage. */
+    sections: readonly CustomCodeCandidateSection[];
     evidence: readonly CustomCodeEvidence[];
     review: CustomCodeCandidateReview;
     edges?: readonly CustomCodeCandidateEdge[];
@@ -141,7 +143,7 @@ export type ExtractCustomPhaseDefinition = {
     reads: readonly PhaseResourceReference[];
     writes: readonly PhaseResourceReference[];
     sources: readonly RepoProjectSourceDefinition[];
-    collection: "codegraph";
+    collection: CodeIndexCollection;
     indexPlan: "declared" | "inferred";
     indexUnits: readonly CodeIndexUnitPlan[];
     inspect?: CodeIndexInspectionAdapter;
@@ -239,7 +241,7 @@ export declare const compileProse: (definition: {
 }) => CompileProsePhaseDefinition;
 export declare const extractTs: (definition: {
     source: RepoProjectSourceDefinition;
-    collection: "codegraph";
+    collection: CodeIndexCollection;
     include?: readonly string[];
     mode?: "exports" | "scan";
     entries?: readonly string[];
@@ -250,7 +252,7 @@ export declare const extractTs: (definition: {
 export declare const extractCustom: (definition: {
     id: string;
     sources: readonly RepoProjectSourceDefinition[];
-    collection: "codegraph";
+    collection: CodeIndexCollection;
     indexUnits?: readonly CodeIndexUnitPlan[];
     inspect?: CodeIndexInspectionAdapter;
     extract: CustomCodeExtractor;

package/templates/package-templates/kb/AGENTS.md

@@ -18,7 +18,7 @@ Selected OKF root directories such as `{{wikisRoot}}/`, `{{guidesRoot}}/`,
 `{{rulesRoot}}/`, and `{{featsRoot}}/` follow an OKF-compatible Context profile:
 OKF fields and Context extension fields stay at the top level, and no `context`
 or `schema` field is emitted. Root mapping:
-`{{wikisRoot}}/` maps from structured `codegraph`, `business`, and `product` knowledge;
+`{{wikisRoot}}/` maps from structured `codeindex`, `business`, and `product` knowledge;
 `{{guidesRoot}}/` maps from `architecture`, `sop`, `faq`, `decision`, and `incident`;
 `{{rulesRoot}}/` maps from `standards` and `test`; `{{featsRoot}}/` maps from `feats`. Treat
 `{{wikisRoot}}/` as the entity-and-relationship layer; guides and rules may

package/templates/package-templates/kb/skills/knowledge-query/SKILL.md

@@ -29,7 +29,7 @@ as evidence rather than relying on memory or frontmatter summaries.
 
 | Root | Use |
 |---|---|
-| `{{wikisRoot}}/` | Structured entities and relationships from codegraph, business, and product knowledge. |
+| `{{wikisRoot}}/` | Structured entities and relationships from codeindex, business, and product knowledge. |
 | `{{guidesRoot}}/` | Architecture, procedures, FAQs, decisions, incidents, and troubleshooting. |
 | `{{rulesRoot}}/` | Standards, constraints, acceptance criteria, and test scenarios. |
 | `{{featsRoot}}/` | Feature knowledge when selected into the package. |

package/templates/package-templates.zh-CN/kb/AGENTS.md

@@ -14,7 +14,7 @@
 
 包内可能包含以下 OKF 根目录：
 
-- `{{wikisRoot}}/`：结构化实体和关系，对应 codegraph、business、product。
+- `{{wikisRoot}}/`：结构化实体和关系，对应 codeindex、business、product。
 - `{{guidesRoot}}/`：架构、流程、FAQ、决策和故障记录。
 - `{{rulesRoot}}/`：标准、约束、验收条件和测试场景。
 - `{{featsRoot}}/`：被选择进入包内的功能知识。

package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md

@@ -20,7 +20,7 @@ description: 查询 {{displayName}} 中经过审核、可追溯来源的知识
 
 | 根目录 | 用途 |
 |---|---|
-| `{{wikisRoot}}/` | 来自 codegraph、business、product 的结构化实体和关系。 |
+| `{{wikisRoot}}/` | 来自 codeindex、business、product 的结构化实体和关系。 |
 | `{{guidesRoot}}/` | 架构、流程、FAQ、决策、故障和排障说明。 |
 | `{{rulesRoot}}/` | 标准、约束、验收条件和测试场景。 |
 | `{{featsRoot}}/` | 被选择进入包内的功能知识。 |