@c4a/context-cli 0.7.34 → 0.7.35

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

@@ -159,3 +159,20 @@ Use [diagram guidance](diagrams.md) or [source visual processing](visual-source-
 when actual reader needs or supplied images justify them. Diagrams are not
 mandatory. Content quality belongs to the Agent and Review; do not optimize
 wording, headings or section counts to satisfy a metric.
+
+## Source provenance and article prose
+
+Keep capture baselines, repository commit hashes, inspected branch revisions and
+verification timestamps in structured source references or citation destinations,
+not in article headings, introductions, tables or standalone evidence paragraphs.
+Do not add sentences such as “the backend baseline is repository@commit” merely
+to describe how the article was researched. Preserve exact source links and
+reference metadata; removing this prose must not weaken traceability.
+
+Retain business or API versions, compatibility constraints, migration differences
+and performance comparison baselines when they explain behavior or reader actions.
+A commit belongs in the prose only when the requested topic is that specific
+change, regression or reproduction and its identity is necessary. Apply editorial
+cleanup only to the current authorized writing or revision scope; do not scan or
+rewrite unrelated approved articles. This is writing guidance, not a keyword-based
+CLI rejection rule.

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

@@ -30,7 +30,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 3. **技术与依赖摘要**：仅在有技术材料且影响读者选择入口时出现；纯产品资料不强制此节。
 4. **知识索引**：主题、何时阅读、目标文章／代码位置。
 5. **任务导航**：开发、接口对接、排障、交付分别从哪里继续。
-6. **来源与适用版本**：文档身份／定位与适用版本；代码材料记录仓库、模块路径和证据版本。
+6. **来源与适用版本**：文档身份、代码仓库和模块入口；正文仅说明影响使用的业务或兼容版本，取证提交号保留在来源引用元数据中。
 
 最低产出：对象身份、可信资料／起始文件／注册点和下一步阅读位置。浅索引模块可作为父级表格中的记录，不强制单页。禁止链接到尚未产出的模板占位文件。
 

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

@@ -22,7 +22,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 
 适用：入口优先的业务知识包，尤其是只持有 dist 的消费 Agent。建议章节为 **问题到入口的映射 → 源码身份与版本 → 推荐阅读顺序 → 外部边界 → 何时需要进一步证据**。
 
-定位记录：仓库身份、仓内路径／符号、证据版本、已证明到哪一层、接着读什么。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
+定位记录：仓库身份、仓内路径／符号、已证明到哪一层、接着读什么。取证版本保留在来源引用元数据中，不在正文重复仓库提交基线。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
 
 ## 图示选择
 

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

@@ -58,7 +58,7 @@ Toast 类家族可以先给成员选择表，再按成员或调用方式分节
 | 行为与组合规则 | 状态谁控制、如何交互、配置如何叠加 | 受控／非受控、回调、数据结构、覆盖顺序、关闭／清理、组合约束；具体内容由组件能力决定 |
 | 样式与设计系统 | 哪些是组件可覆盖项、哪些来自全局系统 | 变体、尺寸、slot、token、逻辑方向等具体差异；公共基础规范链接到设计系统，不整篇复制 |
 | 运行环境、可访问性与限制 | 在什么条件下可用、有什么已知边界 | SSR／Portal／宿主／移动端限制；已证实键盘、焦点、role、对比度相关行为；实际测试与静态观察区分 |
-| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，明确证据版本；关键行为的定位尽量贴近对应章节 |
+| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，取证版本保留在引用元数据中；关键行为的定位尽量贴近对应章节 |
 
 章节可以有组件特定的小节，例如“选择后是否关闭”“清理时机”“嵌套分组”。固定公共章节不要求把每个组件的业务特点改成相同文案，也不改变事实的原有语义。
 

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

@@ -60,3 +60,20 @@ Use [diagram guidance](diagrams.md) when it clarifies an important relationship.
 For actual source images or tables, read [visual processing](visual-source-processing.md).
 Preserve source strength and external boundaries; diagrams are not a completion
 requirement. Follow the workspace's visual conventions.
+
+## Source provenance and article prose
+
+Keep capture baselines, repository commit hashes, inspected branch revisions and
+verification timestamps in structured source references or citation destinations,
+not in article headings, introductions, tables or standalone evidence paragraphs.
+Do not add sentences such as “the backend baseline is repository@commit” merely
+to describe how the article was researched. Preserve exact source links and
+reference metadata; removing this prose must not weaken traceability.
+
+Retain business or API versions, compatibility constraints, migration differences
+and performance comparison baselines when they explain behavior or reader actions.
+A commit belongs in the prose only when the requested topic is that specific
+change, regression or reproduction and its identity is necessary. Apply editorial
+cleanup only to the current authorized writing or revision scope; do not scan or
+rewrite unrelated approved articles. This is writing guidance, not a keyword-based
+CLI rejection rule.

package/indexers/bundles/context-markdown-indexer/templates/articles/c01.md

@@ -28,7 +28,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 3. **技术与依赖摘要**：仅在有技术材料且影响读者选择入口时出现；纯产品资料不强制此节。
 4. **知识索引**：主题、何时阅读、目标文章／代码位置。
 5. **任务导航**：开发、接口对接、排障、交付分别从哪里继续。
-6. **来源与适用版本**：文档身份／定位与适用版本；代码材料记录仓库、模块路径和证据版本。
+6. **来源与适用版本**：文档身份、代码仓库和模块入口；正文仅说明影响使用的业务或兼容版本，取证提交号保留在来源引用元数据中。
 
 最低产出：对象身份、可信资料／起始文件／注册点和下一步阅读位置。浅索引模块可作为父级表格中的记录，不强制单页。禁止链接到尚未产出的模板占位文件。
 

package/indexers/bundles/context-markdown-indexer/templates/articles/c07.md

@@ -20,7 +20,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 
 适用：入口优先的业务知识包，尤其是只持有 dist 的消费 Agent。建议章节为 **问题到入口的映射 → 源码身份与版本 → 推荐阅读顺序 → 外部边界 → 何时需要进一步证据**。
 
-定位记录：仓库身份、仓内路径／符号、证据版本、已证明到哪一层、接着读什么。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
+定位记录：仓库身份、仓内路径／符号、已证明到哪一层、接着读什么。取证版本保留在来源引用元数据中，不在正文重复仓库提交基线。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
 
 ## 图示选择
 

package/indexers/bundles/context-markdown-indexer/templates/articles/l02.md

@@ -56,7 +56,7 @@ Toast 类家族可以先给成员选择表，再按成员或调用方式分节
 | 行为与组合规则 | 状态谁控制、如何交互、配置如何叠加 | 受控／非受控、回调、数据结构、覆盖顺序、关闭／清理、组合约束；具体内容由组件能力决定 |
 | 样式与设计系统 | 哪些是组件可覆盖项、哪些来自全局系统 | 变体、尺寸、slot、token、逻辑方向等具体差异；公共基础规范链接到设计系统，不整篇复制 |
 | 运行环境、可访问性与限制 | 在什么条件下可用、有什么已知边界 | SSR／Portal／宿主／移动端限制；已证实键盘、焦点、role、对比度相关行为；实际测试与静态观察区分 |
-| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，明确证据版本；关键行为的定位尽量贴近对应章节 |
+| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，取证版本保留在引用元数据中；关键行为的定位尽量贴近对应章节 |
 
 章节可以有组件特定的小节，例如“选择后是否关闭”“清理时机”“嵌套分组”。固定公共章节不要求把每个组件的业务特点改成相同文案，也不改变事实的原有语义。
 

package/indexers/bundles/context-note-indexer/references/writing.md

@@ -55,3 +55,20 @@ answer the selected question without reconstructing the conversation? Check
 that the article answers its planned reader question. Keep remaining investigation
 and real gaps visible in the stage; do not submit a per-passage disposition ledger. A generic overview that drops the actual decision,
 exception or resolution is incomplete even if its headings look correct.
+
+## Source provenance and article prose
+
+Keep capture baselines, repository commit hashes, inspected branch revisions and
+verification timestamps in structured source references or citation destinations,
+not in article headings, introductions, tables or standalone evidence paragraphs.
+Do not add sentences such as “the backend baseline is repository@commit” merely
+to describe how the article was researched. Preserve exact source links and
+reference metadata; removing this prose must not weaken traceability.
+
+Retain business or API versions, compatibility constraints, migration differences
+and performance comparison baselines when they explain behavior or reader actions.
+A commit belongs in the prose only when the requested topic is that specific
+change, regression or reproduction and its identity is necessary. Apply editorial
+cleanup only to the current authorized writing or revision scope; do not scan or
+rewrite unrelated approved articles. This is writing guidance, not a keyword-based
+CLI rejection rule.

package/indexers/bundles/context-note-indexer/templates/articles/c01.md

@@ -28,7 +28,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 3. **技术与依赖摘要**：仅在有技术材料且影响读者选择入口时出现；纯产品资料不强制此节。
 4. **知识索引**：主题、何时阅读、目标文章／代码位置。
 5. **任务导航**：开发、接口对接、排障、交付分别从哪里继续。
-6. **来源与适用版本**：文档身份／定位与适用版本；代码材料记录仓库、模块路径和证据版本。
+6. **来源与适用版本**：文档身份、代码仓库和模块入口；正文仅说明影响使用的业务或兼容版本，取证提交号保留在来源引用元数据中。
 
 最低产出：对象身份、可信资料／起始文件／注册点和下一步阅读位置。浅索引模块可作为父级表格中的记录，不强制单页。禁止链接到尚未产出的模板占位文件。
 

package/indexers/bundles/context-note-indexer/templates/articles/c07.md

@@ -20,7 +20,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 
 适用：入口优先的业务知识包，尤其是只持有 dist 的消费 Agent。建议章节为 **问题到入口的映射 → 源码身份与版本 → 推荐阅读顺序 → 外部边界 → 何时需要进一步证据**。
 
-定位记录：仓库身份、仓内路径／符号、证据版本、已证明到哪一层、接着读什么。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
+定位记录：仓库身份、仓内路径／符号、已证明到哪一层、接着读什么。取证版本保留在来源引用元数据中，不在正文重复仓库提交基线。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
 
 ## 图示选择
 

package/indexers/bundles/context-note-indexer/templates/articles/l02.md

@@ -56,7 +56,7 @@ Toast 类家族可以先给成员选择表，再按成员或调用方式分节
 | 行为与组合规则 | 状态谁控制、如何交互、配置如何叠加 | 受控／非受控、回调、数据结构、覆盖顺序、关闭／清理、组合约束；具体内容由组件能力决定 |
 | 样式与设计系统 | 哪些是组件可覆盖项、哪些来自全局系统 | 变体、尺寸、slot、token、逻辑方向等具体差异；公共基础规范链接到设计系统，不整篇复制 |
 | 运行环境、可访问性与限制 | 在什么条件下可用、有什么已知边界 | SSR／Portal／宿主／移动端限制；已证实键盘、焦点、role、对比度相关行为；实际测试与静态观察区分 |
-| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，明确证据版本；关键行为的定位尽量贴近对应章节 |
+| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，取证版本保留在引用元数据中；关键行为的定位尽量贴近对应章节 |
 
 章节可以有组件特定的小节，例如“选择后是否关闭”“清理时机”“嵌套分组”。固定公共章节不要求把每个组件的业务特点改成相同文案，也不改变事实的原有语义。
 

package/indexers/bundles/context-sessions-indexer/references/writing.md

@@ -61,3 +61,20 @@ answer the selected question without reconstructing the conversation? Check
 that the article answers its planned reader question. Keep remaining investigation
 and real gaps visible in the stage; do not submit a per-passage disposition ledger. A generic overview that drops the actual decision,
 exception or resolution is incomplete even if its headings look correct.
+
+## Source provenance and article prose
+
+Keep capture baselines, repository commit hashes, inspected branch revisions and
+verification timestamps in structured source references or citation destinations,
+not in article headings, introductions, tables or standalone evidence paragraphs.
+Do not add sentences such as “the backend baseline is repository@commit” merely
+to describe how the article was researched. Preserve exact source links and
+reference metadata; removing this prose must not weaken traceability.
+
+Retain business or API versions, compatibility constraints, migration differences
+and performance comparison baselines when they explain behavior or reader actions.
+A commit belongs in the prose only when the requested topic is that specific
+change, regression or reproduction and its identity is necessary. Apply editorial
+cleanup only to the current authorized writing or revision scope; do not scan or
+rewrite unrelated approved articles. This is writing guidance, not a keyword-based
+CLI rejection rule.

package/indexers/bundles/context-sessions-indexer/templates/articles/c01.md

@@ -28,7 +28,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 3. **技术与依赖摘要**：仅在有技术材料且影响读者选择入口时出现；纯产品资料不强制此节。
 4. **知识索引**：主题、何时阅读、目标文章／代码位置。
 5. **任务导航**：开发、接口对接、排障、交付分别从哪里继续。
-6. **来源与适用版本**：文档身份／定位与适用版本；代码材料记录仓库、模块路径和证据版本。
+6. **来源与适用版本**：文档身份、代码仓库和模块入口；正文仅说明影响使用的业务或兼容版本，取证提交号保留在来源引用元数据中。
 
 最低产出：对象身份、可信资料／起始文件／注册点和下一步阅读位置。浅索引模块可作为父级表格中的记录，不强制单页。禁止链接到尚未产出的模板占位文件。
 

package/indexers/bundles/context-sessions-indexer/templates/articles/c07.md

@@ -20,7 +20,7 @@ This is a writing blueprint, not a completion gate. Adapt the headings and level
 
 适用：入口优先的业务知识包，尤其是只持有 dist 的消费 Agent。建议章节为 **问题到入口的映射 → 源码身份与版本 → 推荐阅读顺序 → 外部边界 → 何时需要进一步证据**。
 
-定位记录：仓库身份、仓内路径／符号、证据版本、已证明到哪一层、接着读什么。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
+定位记录：仓库身份、仓内路径／符号、已证明到哪一层、接着读什么。取证版本保留在来源引用元数据中，不在正文重复仓库提交基线。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
 
 ## 图示选择
 

package/indexers/bundles/context-sessions-indexer/templates/articles/l02.md

@@ -56,7 +56,7 @@ Toast 类家族可以先给成员选择表，再按成员或调用方式分节
 | 行为与组合规则 | 状态谁控制、如何交互、配置如何叠加 | 受控／非受控、回调、数据结构、覆盖顺序、关闭／清理、组合约束；具体内容由组件能力决定 |
 | 样式与设计系统 | 哪些是组件可覆盖项、哪些来自全局系统 | 变体、尺寸、slot、token、逻辑方向等具体差异；公共基础规范链接到设计系统，不整篇复制 |
 | 运行环境、可访问性与限制 | 在什么条件下可用、有什么已知边界 | SSR／Portal／宿主／移动端限制；已证实键盘、焦点、role、对比度相关行为；实际测试与静态观察区分 |
-| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，明确证据版本；关键行为的定位尽量贴近对应章节 |
+| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，取证版本保留在引用元数据中；关键行为的定位尽量贴近对应章节 |
 
 章节可以有组件特定的小节，例如“选择后是否关闭”“清理时机”“嵌套分组”。固定公共章节不要求把每个组件的业务特点改成相同文案，也不改变事实的原有语义。