@c4a/context-cli 0.7.8 → 0.7.9

package/indexers/bundles/context-code-indexer/references/indexer.md

@@ -322,3 +322,7 @@ Use the materialized [diagram guidance](diagrams.md) when a diagram clarifies th
 ## Existing source images and tables
 
 For authorized visual material, follow [source visual processing](visual-source-processing.md): preference, capability-aware conversion, accepted-result reuse and retention. Follow the workspace AGENTS.md for editable diagram style.
+
+## Reading selected article material
+
+Use the current task's combined writing brief: it includes selected article guidance, examples when supplied, and section/variable slots. Profile bindings can share one article Markdown source; do not open every binding or regenerate every listed article. Keep short collaboration notes and examples beside the relevant guidance instead of requesting separate files. Read extra source or full technical contracts only when this task needs them. The CLI applies executable contracts and evidence bindings; the Agent decides applicability, substance and useful diagrams. Reuse an already-read unchanged shared resource while it remains in context.

package/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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/indexers/bundles/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 组件库总览与接入

package/indexers/bundles/context-code-indexer/templates/articles/q03.md

@@ -2,6 +2,18 @@
 id: context.article.q03
 kind: procedure
 media-type: text/markdown
+program:
+  article: q03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 范围与来源
+    catalog: 能力与场景表
+    prerequisites: 前置条件和数据
+    automation: 自动化入口
+    references: 需求与缺陷
 ---
 
 # Q03 用例目录