@c4a/context-cli 0.7.8 → 0.7.10-alpha.1

package/plugins/skills/context-code-indexer/templates/api-service-public-api-reference.md

@@ -17,8 +17,7 @@
       "id": "api",
       "type": "json",
       "content_layer": "deterministic-fact",
-      "required": false,
-      "evidence_required": true
+      "required": false
     }
   ],
   "deterministic_blocks": [
@@ -40,13 +39,6 @@
       "deterministic_block_ids": [
         "api-table"
       ],
-      "accepted_evidence_kinds": [
-        "code",
-        "contract",
-        "configuration",
-        "documentation"
-      ],
-      "minimum_evidence_items": 0,
       "on_missing": "omit",
       "deletion_condition": "Omit when no authorized structured contract is available."
     }

package/plugins/skills/context-code-indexer/templates/articles/c01.md

@@ -2,6 +2,19 @@
 id: context.article.c01
 kind: procedure
 media-type: text/markdown
+program:
+  article: c01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 定位与边界
+    capabilities: 核心能力
+    dependencies: 技术与依赖摘要
+    index: 知识索引
+    tasks: 任务导航
+    sources: 来源与适用版本
 ---
 
 # C01 模块／知识入口
@@ -24,3 +37,13 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 ## 图示选择
 
 目录用 text 树；仅有已证实跨模块关系时在概览补 flowchart LR。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。
+
+## 导航内容的主责与合并
+
+主入口负责“哪个问题去哪里”，不重复专业文章的全文。小模块可将 C01、F01 与 C07
+合并为一篇；分开时，架构页解释运行边界，源码指引只补调查顺序，不重复同一份文件表。
+没有深度文章的模块仍可在父级地图中给源码入口，不创建空链接。
+
+导航表优先使用：**读者问题／任务 → 对应模块与职责 → 第一篇文章或源码入口 → 何时继续深入**。
+核心能力必须说出材料已证明的具体行为，不能只写“详细内容见源码”。目录记录的数量、
+实际阅读的数量与深入解释的数量分别说明；不把目录列全当成已读全。

package/plugins/skills/context-code-indexer/templates/articles/c02.md

@@ -2,6 +2,23 @@
 id: context.article.c02
 kind: procedure
 media-type: text/markdown
+program:
+  article: c02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    goals: 业务目标
+    actors: 角色与场景
+    prerequisites: 使用前提
+    operations: 操作与结果
+    exceptions: 规则与异常
+    acceptance: 验收依据
+    version: 版本和范围
+    capabilities: 能力边界
+    flows: 主要流程入口
+    references: 相关系统与文档
 ---
 
 # C02 业务概览

package/plugins/skills/context-code-indexer/templates/articles/c03.md

@@ -2,6 +2,17 @@
 id: context.article.c03
 kind: procedure
 media-type: text/markdown
+program:
+  article: c03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 适用范围
+    terms: 术语表
+    distinctions: 易混概念
+    references: 相关入口
 ---
 
 # C03 术语与标识

package/plugins/skills/context-code-indexer/templates/articles/c04.md

@@ -2,6 +2,18 @@
 id: context.article.c04
 kind: procedure
 media-type: text/markdown
+program:
+  article: c04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    layers: 依赖分层
+    catalog: 核心依赖表
+    initialization: 初始化与注入
+    compatibility: 兼容和版本约束
+    boundaries: 跨边界定位
 ---
 
 # C04 依赖与协作边界

package/plugins/skills/context-code-indexer/templates/articles/c05.md

@@ -2,6 +2,19 @@
 id: context.article.c05
 kind: procedure
 media-type: text/markdown
+program:
+  article: c05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    symptoms: 现象索引
+    conditions: 适用条件
+    findings: 已知事实与判断
+    diagnosis: 排查步骤
+    recovery: 修复与验证
+    sources: 来源
 ---
 
 # C05 已知问题与排障

package/plugins/skills/context-code-indexer/templates/articles/c07.md

@@ -2,6 +2,18 @@
 id: context.article.c07
 kind: procedure
 media-type: text/markdown
+program:
+  article: c07
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    entries: 问题到入口
+    identity: 源码身份与版本
+    reading: 推荐阅读顺序
+    boundaries: 外部边界
+    evidence: 进一步证据
 ---
 
 # C07 从知识继续查源码
@@ -15,3 +27,25 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 ## 图示选择
 
 源码坐标优先表格，阅读顺序可用 text 树；跨边界路径有证据再画 flowchart，并写下一步。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。
+
+## 从现象进入代码，而不是罗列源码
+
+优先给 **问题／现象 → 第一入口 → 下一份证据 → 分支条件**。例如：
+
+| 现象 | 第一入口 | 下一步证据与分支 |
+| --- | --- | --- |
+| 页面不可见 | 已确认的路由／菜单注册位置 | 检查访问控制与功能配置；先确认页面是否被挂载 |
+| 提交无结果 | 页面事件处理与请求调用点 | 请求未发出则查前端条件；已发出再核对响应和服务端入口 |
+| 生成类型不一致 | 实际生成配置和消费位置 | 比对输入版本与生成差异；不能用声明证明页面实际调用 |
+
+表中的具体文件应来自本篇证据，示例不替代取证。已证实调用链要求逐跳证据；调查路线
+允许某一跳未知，但必须标明“待查”以及如何定位，不能画成已经发生的调用。
+跨模块 composer 因证据不足不产出完整链路时，本篇仍保留已知入口和明确的证据缺口。
+
+给出仓库、版本和精确搜索范围。确有相应工具时可提供命令，例如
+`rg -n --fixed-strings 'SubmitOrder' apps/orders/src`，说明如何根据命中进入实现／调用方，
+以及无命中时该查别名、生成客户端还是外部依赖。使用真实符号替换例子，避免无范围全仓搜索。
+
+包内文章用可解析链接，交付后检查实际目标；源码位置使用 repo@revision:path#symbol，
+不要把工作区 knowledge 路径或反引号文本当成 dist 中可跳转的链接。文件名改变后的导航
+遵循现有打包映射，不手改 dist 或虚构尚未交付的文章。

package/plugins/skills/context-code-indexer/templates/articles/d01.md

@@ -2,6 +2,18 @@
 id: context.article.d01
 kind: procedure
 media-type: text/markdown
+program:
+  article: d01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 领域职责
+    services: 服务分工
+    entries: 入口与调用边界
+    collaboration: 数据与事件协作
+    references: 阅读导航
 ---
 
 # D01 领域架构与服务地图

package/plugins/skills/context-code-indexer/templates/articles/d02.md

@@ -2,6 +2,19 @@
 id: context.article.d02
 kind: procedure
 media-type: text/markdown
+program:
+  article: d02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    trigger: 场景与触发
+    actors: 参与方
+    flow: 主流程
+    branches: 分支与状态
+    failures: 失败和下一步
+    sources: 源码链路与证据边界
 ---
 
 # D02 业务流程与跨层链路

package/plugins/skills/context-code-indexer/templates/articles/d03.md

@@ -2,6 +2,19 @@
 id: context.article.d03
 kind: procedure
 media-type: text/markdown
+program:
+  article: d03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 业务与版本
+    catalog: 规则分类
+    conditions: 条件与结果
+    implementation: 执行位置
+    conflicts: 例外与冲突
+    references: 相关流程
 ---
 
 # D03 业务规则

package/plugins/skills/context-code-indexer/templates/articles/d04.md

@@ -2,6 +2,23 @@
 id: context.article.d04
 kind: procedure
 media-type: text/markdown
+program:
+  article: d04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 工程边界
+    commands: 构建与测试入口
+    delivery: 环境与交付
+    conventions: 兼容与研发约定
+    environment: 运行与环境
+    configuration: 配置定位
+    observability: 日志指标与追踪
+    diagnosis: 诊断路径
+    recovery: 恢复与回滚
+    verification: 验证依据
 ---
 
 # D04 运维与排障入口

package/plugins/skills/context-code-indexer/templates/articles/f01.md

@@ -2,6 +2,19 @@
 id: context.article.f01
 kind: procedure
 media-type: text/markdown
+program:
+  article: f01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    architecture: 架构总览
+    stack: 技术栈与运行方式
+    startup: 启动与分层
+    crosscutting: 关键横切能力
+    deployment: 部署边界
+    references: 相关入口
 ---
 
 # F01 架构
@@ -17,3 +30,21 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 ## 图示选择
 
 架构章节用 flowchart LR，按启动、宿主和请求层分组，每条边有来源。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。
+
+## 多模块工程地图写法
+
+以已确认的模块为行，给出 **仓内路径 → 职责 → 首要注册／启动入口 → 深入位置**。
+一级工程先区分宿主、应用、共享库和工具，再按需要展开业务子模块；不把每个子目录
+自动认作一个应用。相同框架的模块合并说明，只展开有实际差异的运行边界。
+
+匿名示例（路径只示范组织方式，不是默认框架约定，产出时替换为实际证据）：
+
+| 模块 | 职责 | 首要入口 | 下一步 |
+| --- | --- | --- | --- |
+| apps/portal | 装载页面与公共导航 | src/bootstrap.ts | 路由注册、访问控制和模块装载位置 |
+| apps/portal/modules/orders | 订单查询与详情 | src/routes.ts | 对应页面的数据请求与状态分支 |
+| packages/widgets | 跨页面组件 | src/index.ts | 组件消费说明与实际调用方 |
+
+将路由、权限、请求、状态、宿主桥接等横切入口集中说明，业务模块页回链并写自身差异。
+结构图用于解释关系，定位表用于找文件，两者无需互相复述。目录中无法证实的职责标为待查，
+不按目录名编造业务能力。大范围材料只提供地图时，说明样本与未读范围。

package/plugins/skills/context-code-indexer/templates/articles/f02.md

@@ -2,6 +2,18 @@
 id: context.article.f02
 kind: procedure
 media-type: text/markdown
+program:
+  article: f02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    organization: 路由组织
+    routes: 页面登记表
+    access: 参数与访问控制
+    layout: 布局和全局兜底
+    references: 页面详情导航
 ---
 
 # F02 路由与页面地图

package/plugins/skills/context-code-indexer/templates/articles/f03.md

@@ -2,6 +2,23 @@
 id: context.article.f03
 kind: procedure
 media-type: text/markdown
+program:
+  article: f03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    identity: 页面定位
+    access: 路由参数与权限
+    components: 主要组件与依赖
+    flow: 页面内流程
+    state: 状态与数据流
+    api: API 边界
+    rules: 业务条件
+    feedback: Loading Empty Error
+    references: 知识与源码
+  contract_table: contract_api
 ---
 
 # F03 页面／用户任务详情

package/plugins/skills/context-code-indexer/templates/articles/f04.md

@@ -2,6 +2,19 @@
 id: context.article.f04
 kind: procedure
 media-type: text/markdown
+program:
+  article: f04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    ownership: 状态归属
+    initialization: 初始化与读取
+    writes: 写入与派生
+    async: 异步与缓存
+    lifecycle: 清理与生命周期
+    references: 定位与排障
 ---
 
 # F04 状态与数据流

package/plugins/skills/context-code-indexer/templates/articles/f05.md

@@ -2,6 +2,19 @@
 id: context.article.f05
 kind: procedure
 media-type: text/markdown
+program:
+  article: f05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    clients: 请求层与客户端
+    catalog: 接口与调用入口
+    mapping: 输入输出与转换
+    errors: 错误与重试
+    boundaries: 契约与外部边界
+    references: 源码入口
 ---
 
 # F05 API 集成

package/plugins/skills/context-code-indexer/templates/articles/f06.md

@@ -2,6 +2,19 @@
 id: context.article.f06
 kind: procedure
 media-type: text/markdown
+program:
+  article: f06
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 模型范围
+    catalog: 类型目录
+    roles: DTO 与视图模型
+    mapping: 转换与校验
+    authority: 权威与生成关系
+    references: 使用与源码
 ---
 
 # F06 类型模型

package/plugins/skills/context-code-indexer/templates/articles/f07.md

@@ -2,6 +2,18 @@
 id: context.article.f07
 kind: procedure
 media-type: text/markdown
+program:
+  article: f07
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 复用范围
+    catalog: 组件地图
+    parents: 父页面与调用方
+    dependencies: 封装与依赖库
+    references: 详情与修改入口
 ---
 
 # F07 应用内组件与复用边界

package/plugins/skills/context-code-indexer/templates/articles/f08.md

@@ -2,6 +2,21 @@
 id: context.article.f08
 kind: procedure
 media-type: text/markdown
+program:
+  article: f08
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    systems: 使用的组件库与设计系统
+    layers: 样式分层
+    tokens: Token 定义与消费
+    overrides: 局部覆盖
+    platforms: 主题与平台差异
+    accessibility: 响应式与可访问性
+    examples: 调整入口与示例
+    references: 系统规范与源码
 ---
 
 # F08 样式与设计系统

package/plugins/skills/context-code-indexer/templates/articles/f09.md

@@ -2,6 +2,19 @@
 id: context.article.f09
 kind: procedure
 media-type: text/markdown
+program:
+  article: f09
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 工程与交付边界
+    prerequisites: 运行前提
+    commands: 构建与测试入口
+    deployment: 部署与配置
+    verification: 验证与回滚
+    references: 相关资料
 ---
 
 # F09 构建与部署

package/plugins/skills/context-code-indexer/templates/articles/f10.md

@@ -2,6 +2,19 @@
 id: context.article.f10
 kind: procedure
 media-type: text/markdown
+program:
+  article: f10
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    roles: 宿主与 Remote
+    registration: 注册与 Expose
+    loading: 加载和生命周期
+    sharing: 共享依赖与上下文
+    failures: 错误与兼容边界
+    references: 源码导航
 ---
 
 # F10 宿主与微前端

package/plugins/skills/context-code-indexer/templates/articles/f11.md

@@ -2,6 +2,22 @@
 id: context.article.f11
 kind: procedure
 media-type: text/markdown
+program:
+  article: f11
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 子应用范围
+    catalog: 子应用目录
+    ownership: 入口与职责
+    integration: 宿主接入
+    contracts: 共享契约
+    capabilities: 暴露能力与入口
+    navigation: 页面与 API 导航
+    delivery: 开发交付差异
+    details: 详情与下一步
 ---
 
 # F11 子应用目录与详情

package/plugins/skills/context-code-indexer/templates/articles/f12.md

@@ -2,6 +2,19 @@
 id: context.article.f12
 kind: procedure
 media-type: text/markdown
+program:
+  article: f12
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 职责与父层
+    callers: 调用方与输入
+    behavior: 行为与状态
+    dependencies: 组件及请求依赖
+    change: 修改入口
+    verification: 测试与验证
 ---
 
 # F12 应用内部组件定位与修改指南

package/plugins/skills/context-code-indexer/templates/articles/l01.md

@@ -2,6 +2,21 @@
 id: context.article.l01
 kind: procedure
 media-type: text/markdown
+program:
+  article: l01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 用途与适用范围
+    installation: 安装与初始化
+    capabilities: 主要能力
+    usage: 典型用法
+    contracts: 契约与扩展点
+    limits: 限制与兼容
+    references: 源码与验证入口
+  contract_table: contract_api
 ---
 
 # L01 公共能力与使用指南

package/plugins/skills/context-code-indexer/templates/articles/l02.md

@@ -2,6 +2,21 @@
 id: context.article.l02
 kind: procedure
 media-type: text/markdown
+program:
+  article: l02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 用途与选用
+    setup: 接入与基本用法
+    scenarios: 场景与变体
+    behavior: 行为与组合规则
+    styles: 样式与设计系统
+    limits: 环境可访问性与限制
+    references: 相关组件与源码入口
+  contract_table: api
 ---
 
 # L02 公共组件与组件家族

package/plugins/skills/context-code-indexer/templates/articles/l03.md

@@ -2,6 +2,32 @@
 id: context.article.l03
 kind: procedure
 media-type: text/markdown
+program:
+  article: l03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 目标与适用范围
+    packages: 平台软件包与版本
+    foundations: 基础规范地图
+    components: 组件与交互模式
+    configuration: 主题及运行配置
+    adoption: 采用定制与迁移
+    purpose: 用途与语义
+    catalog: 分类与 Token 目录
+    mapping: 命名及对应关系
+    consumption: 消费方式
+    rules: 组合与适用规则
+    environment: 环境与 Provider
+    globals: 全局配置
+    inheritance: 继承与局部覆盖
+    resources: CSS 与资源加载顺序
+    ssr: SSR 与 Hydration
+    platforms: 平台和主题差异
+    verification: 验证与排查入口
+    references: 来源与修改入口
 ---
 
 # L03 设计系统及基础规范

package/plugins/skills/context-code-indexer/templates/articles/l04.md

@@ -2,6 +2,19 @@
 id: context.article.l04
 kind: procedure
 media-type: text/markdown
+program:
+  article: l04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    boundary: 扩展边界
+    registration: 注册及执行顺序
+    context: 输入输出与上下文
+    collaboration: 宿主与下游协作
+    cleanup: 错误和清理
+    references: 使用与测试入口
 ---
 
 # L04 中间件、适配与运行模式

package/plugins/skills/context-code-indexer/templates/articles/l05.md

@@ -2,6 +2,20 @@
 id: context.article.l05
 kind: procedure
 media-type: text/markdown
+program:
+  article: l05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 定位与适用平台
+    packages: 软件包版本与维护状态
+    setup: 安装与全局接入
+    catalog: 组件分类与选择导航
+    configuration: 公共配置资源与设计系统
+    compatibility: 兼容迁移与限制
+    references: 示例文档与源码
 ---
 
 # L05 组件库总览与接入