@c4a/context-cli 0.7.5 → 0.7.8

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

@@ -0,0 +1,66 @@
+---
+id: context.article.l03
+kind: procedure
+media-type: text/markdown
+---
+
+# L03 设计系统及基础规范
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+### 来源和归属
+
+有维护的设计规范、token 源或稳定的跨组件约定时启用。规范文档由 Markdown、实现与 token 由 Code 提供，各自保留来源职责；混合知识通过现有授权主题和引用组合，不新增一个同时吞设计、代码和运行态的通用 Provider。
+
+只有 token 或静态资源材料时，采用“基础资源参考”对应变体，给定义、别名、消费和修改入口；没有规范证据不补设计目标，也不将其标题或内容包装成完整设计系统。仅文档规范则可以独立成文，不以存在组件源码为前置。
+
+不能只由组件源码推断设计意图，也不能将设计图中的名称直接当作当前程序 API。平台、设计规范版本、组件包版本、资源版本分开记录。同名组件在 Web、原生与其他跨端实现中的属性不应互相覆盖。
+
+### 系统入口文章
+
+```markdown
+# <设计系统>
+## 目标与适用范围
+## 平台、软件包与版本
+## 基础规范地图
+## 组件与交互模式
+## 主题及运行配置
+## 采用、定制与迁移
+## 权威资源与维护入口
+```
+
+| 章节 | 必要内容 |
+| --- | --- |
+| 目标与适用范围 | 来自规范的设计目标、覆盖产品／平台范围、与组件库的关系；不虚构品牌原则 |
+| 平台、软件包与版本 | 平台、实现包／入口、设计规范版本、维护状态、文档和源码；不同版本状态分别列 |
+| 基础规范地图 | 已有的颜色、字体／排版、间距、布局／断点、圆角、阴影／层级、动效、图标／插画等主题及入口 |
+| 组件与交互模式 | 组件分类、组合模式、相近能力的选择依据；实际组件 API 链接 L02 |
+| 主题及运行配置 | 默认主题、上下文、局部覆盖、暗色／高对比、方向和响应式的实现边界 |
+| 采用、定制与迁移 | 按平台的接入导航、允许的扩展方式、已有迁移指引和版本差异；不复制安装全篇 |
+| 权威资源与维护入口 | 规范、设计资源、token 定义／生成、实现和维护说明，区分已读取与仅有导航链接 |
+
+### 基础规范专题变体
+
+同一模板按主题拆分 **colors、typography、spacing-layout、elevation、motion、icons-assets** 等文章；只生成有材料和独立阅读价值的主题。
+
+建议章节为 **用途与语义 → 分类／token 目录 → 命名及对应关系 → 消费方式 → 组合与适用规则 → 平台／主题差异 → 来源与修改入口**。
+
+Token 表列：语义名、层级（基础／语义／组件）、定义或别名指向、平台／主题、消费标识、来源。别名引用不等于当前运行值；生成映射要保留权威源和产物关系。颜色十六进制、字号或时长不是唯一重点，必须让读者理解用途与替换边界。
+
+图标／插画专题需说明资源包、命名、取得和渲染方式、镜像／方向或平台差异、定制约束；不是将每张 SVG 都变成一篇组件 Props 页。存在静态资源指南时保留它的使用入口。
+
+### 主题与运行接入专题变体
+
+建议章节为 **环境与 Provider → 全局配置 → 继承与局部覆盖 → CSS／资源加载顺序 → SSR／Hydration → 多端、方向与高对比 → 验证与排查入口**。
+
+只对有证据的技术机制成文。某个组件默认跟随上下文，不能简化为全系统固定常量；只有 Web 样本不能推断原生平台一致。可访问性应区分规范要求、实现行为和验证记录，不能仅靠 token 名称推定合规。
+
+### 分篇与去重
+
+系统内容较少时，上述内容在一篇系统入口中组织；规范丰富时采用“系统入口＋基础主题＋运行接入＋迁移”的菜单。它们是 L03 下不同阅读主题／文章计划，不是每个组件再生成一套设计系统。
+
+L05 组件库 说明实现包如何接入；L02 组件 只写组件特有 token／覆盖差异；F08 应用样式 只写该应用的消费和局部定制。三处通过链接连接，公共规范保持单一权威承载。
+
+## 图示选择
+
+token 别名/主题继承用 flowchart，系统资源目录用 text 树；颜色/排版/动效引用有来源视觉材料，不用关系图冒充视觉规范。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.l04
+kind: procedure
+media-type: text/markdown
+---
+
+# L04 中间件、适配与运行模式
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**扩展边界 → 注册及执行顺序 → 输入输出与上下文 → 与宿主／下游的协作 → 错误和清理 → 使用／测试入口**。
+
+只输出有维护意义的中间件、服务协作和代码约定，不把某个私有实现提升为团队规范。事件执行器沿用 S07，网关适配沿用现有 request-adaptation-guide。
+
+## 图示选择
+
+注册、调用和清理用 sequenceDiagram，宿主/扩展边界用 flowchart；不将声明顺序推断为运行顺序。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,36 @@
+---
+id: context.article.l05
+kind: procedure
+media-type: text/markdown
+---
+
+# L05 组件库总览与接入
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+用于一个明确面向消费者的组件集合、公共业务组件包或多个相关实现包的入口。它与 L02 单组件文章分开，也不将站点自身的演示组件当成库的公共组件。
+
+默认章节：
+
+```markdown
+# <组件库>
+## 定位与适用平台
+## 软件包、版本与维护状态
+## 安装与全局接入
+## 组件分类与选择导航
+## 公共配置、资源与设计系统
+## 兼容、迁移与已知限制
+## 示例、文档与源码入口
+```
+
+包表列：包／子入口、用途、平台、适用版本、维护状态、文档与源码。主入口、deprecated 子入口、图标／颜色资源包分别说明，不能以相近名字混成一套版本。
+
+接入须根据维护资料给依赖前提、CSS／reset 顺序、Provider、环境配置和一个最小消费入口。局部组件页链接本篇并提示必要前提，不重复整份安装指南。配置包含全局与局部优先级时保留其证据。
+
+组件目录按用途／交互任务／正式分类组织，记录公共名称、家族、导入入口、摘要、详情或源码。单组件尚不足以独立成文也应在目录有入口。仅公共类型或 helper 可以在相应能力下承载，不独立制造空页。
+
+规模较小时总览与接入合一；多平台或接入复杂时分总览、quick-start、组件地图、迁移等文章。页面数由阅读边界决定。L05 可采用 C01 的索引结构，但同一库只有一个主入口，不能重复生成同义的 C01/L01/L05 三篇概览。
+
+## 图示选择
+
+包与能力目录用 text 树或表格；真实包依赖用 flowchart，链接组件详情和系统图。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.q03
+kind: procedure
+media-type: text/markdown
+---
+
+# Q03 用例目录
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**范围与来源 → 按能力分组的场景表 → 前置条件和数据 → 自动化入口 → 相关需求／缺陷**。
+
+场景表列：场景、输入／动作、预期结果、来源类别、脚本／正式用例链接、关联代码。正式用例、源码测试、代码推导候选必须区分；没有运行记录不得写“通过”。目录定位完整不等于覆盖率达标。
+
+## 图示选择
+
+用例场景优先表格；分支组合复杂时用 flowchart，区分正式用例与推导候选。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.q05
+kind: procedure
+media-type: text/markdown
+---
+
+# Q05 测试数据与环境
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**数据需求 → 准备入口 → 环境和隔离条件 → 数据生命周期 → 验证和清理**。
+
+保留脚本、配置、测试数据模板及适用前提。静态 fixture、造数程序和真实账号是不同材料；只说明取得数据的方法，不复制实际凭证。某脚本存在不代表当前账号有权限运行。
+
+## 图示选择
+
+数据准备/使用/清理用 flowchart；环境依赖有来源才画，不包含真实凭证。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.q06
+kind: procedure
+media-type: text/markdown
+---
+
+# Q06 工具与排障工具箱
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**任务到工具 → 接入前提 → 常用操作 → 结果解释 → 对应代码／文档入口**。
+
+表格列：问题、工具／平台、定位所需信息、来源、下一步。查询坐标和已有操作说明可发布；没有平台材料时不能猜参数。复用同一工具正文，避免 tools/ 与 references/ 两份重复维护。
+
+## 图示选择
+
+问题到工具的选择用 flowchart；参数、前提和结果解释保留文字或表格。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.s01
+kind: procedure
+media-type: text/markdown
+---
+
+# S01 服务概览
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**服务定位 → 接入和启动 → 架构分层 → 核心能力／接口 → 模型与依赖摘要 → 知识索引 → 源码位置**。
+
+最低证据：注册、bootstrap／handler、运行身份或稳定调用边界。索引列主题、用途、目标；摘要链接详细文章，不复制全部字段和接口表。代码中名为 Service 的类不自动满足服务分类。
+
+## 图示选择
+
+架构摘要用 flowchart LR；概览链接专业图，不复制全部接口执行链。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.s02
+kind: procedure
+media-type: text/markdown
+---
+
+# S02 API 目录
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**协议与范围 → 按能力分组的入口表 → 权威契约 → 主要调用方与实现 → 详情导航**。
+
+表格列：业务能力、HTTP method/path 或 RPC service/method、注册／handler、契约位置、已证明首跳、详情或源码。目录完整性以授权范围内实际入口为准，详情文章仅按需要展开。纯生成声明标记其来源性质，不能当业务实现。
+
+## 图示选择
+
+API 目录优先表格；协议和入口分层复杂时补 flowchart，具体时序放 S03。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,19 @@
+---
+id: context.article.s03
+kind: procedure
+media-type: text/markdown
+---
+
+# S03 API／操作详情
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**用途与入口 → 请求及边界校验 → 处理步骤 → 数据和下游操作 → 响应与错误 → 并发／幂等约束 → 调用方与相关入口**。
+
+静态表由已授权结构事实生成；解释覆盖语义、分支和使用限制。处理步骤按证据标明锁、短路返回、事务边界、部分成功及失败后的去向。关键步骤必须带实现定位，不用粘贴函数体。未分析的深层逻辑留具名继续位置，不用“通常会”填充。
+
+HTTP／RPC 变体强调路由与契约；FaaS／异步入口使用 S07 的触发模型，不能将所有函数伪装成 HTTP API。没有并发或幂等证据时省略相关章节，不宣称默认安全。
+
+## 图示选择
+
+接口处理用 sequenceDiagram 或 flowchart TD，区分下游调用、数据操作及异常出口。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,21 @@
+---
+id: context.article.s04
+kind: procedure
+media-type: text/markdown
+---
+
+# S04 领域模型
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**领域范围 → 实体与概念表 → 核心实体 → 已证实关系 → 状态与转移 → 业务约束 → 实现和相关资料**。
+
+实体表列：业务／代码身份、角色（实体、值对象、事件、DTO）、关键字段、来源；转移表列当前状态、动作／条件、目标状态、执行位置。
+
+领域实体、传输 DTO、持久化表必须区分；领域知识不足时可只保留“代码对象与定位”，不宣称已完整建模。ER 图需要关系证据，状态机需要转移证据；只有 Status 字段时不能生成统一 Active 自循环。没有关系的实体目录使用表格，无需画假 ER 图。
+
+前端也可采用本模板表达有依据的页面实体与约束，服务端规则通过链接引用。没有实体或状态问题的服务不生成空页。
+
+## 图示选择
+
+概念关系用 flowchart，持久实体关系有证据才用 erDiagram；状态转移用 stateDiagram-v2，不能由枚举推导。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.s05
+kind: procedure
+media-type: text/markdown
+---
+
+# S05 数据模型
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**存储职责 → 表／集合与持久化对象 → 查询和索引依据 → 缓存／锁 → 事务与一致性 → 读写入口**。
+
+表格列：实体／表、字段或键、定义位置、主要读写者、索引／TTL 来源。每种存储仅在发现证据时出现；未找到数据库使用不等于证明全系统无数据库。区别 ORM 声明、迁移 DDL、实际线上 schema；逻辑关联不能直接标成数据库外键。结构可引用契约正文，不展开全部长类型声明。
+
+## 图示选择
+
+数据关系用 erDiagram，基数和关联均须有证据；字段/索引/TTL 用表格，读写链可单独用 flowchart。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,17 @@
+---
+id: context.article.s06
+kind: procedure
+media-type: text/markdown
+---
+
+# S06 外部依赖
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**依赖概览 → RPC／HTTP → 事件与任务 → 存储及配置服务 → 初始化与选择 → 故障边界和下一步**。
+
+表格列：依赖身份、类型、用途、调用／初始化位置、选择条件、权威入口。Topic、服务名、配置 namespace 都保留其真实类别；仅字符串匹配命中的项只能列候选，不生成确定调用边。特定平台的初始化规则由已授权的来源和扩展解释。
+
+## 图示选择
+
+依赖章节用 flowchart LR，区分 RPC/HTTP、消息、存储、配置，不推断未读取的外部系统。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,19 @@
+---
+id: context.article.s07
+kind: procedure
+media-type: text/markdown
+---
+
+# S07 事件、任务与对账
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**职责与触发源 → 注册／订阅 → Payload 与过滤 → 处理链路 → 重试、幂等与并发 → 检查点／补偿／对账 → 运行和观测入口**。
+
+入口表列：topic／schedule／command 身份、登记文件、handler、输入契约、首个下游或持久化边界。结果部分按证据解释返回、ack、跳过、重试及死信／人工处理去向。区分定时任务、事件消费、任务执行器、同步／对账作业；任务函数名不是调度证据。
+
+保留现有 event-consumer、background-runtime、data-sync-reconciliation 的各自语义，不统一成 RPC 模板。运行保证需配置或实现证据，不能从框架依赖推定 exactly-once。
+
+## 图示选择
+
+消费与重试顺序用 sequenceDiagram，任务/对账分支用 flowchart TD；明确 ack、补偿与失败出口。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/background-runtime-maintenance-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "background-runtime-maintenance-guide",
+  "profile": "background-runtime",
+  "reader_goal": "modify-or-diagnose-module",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "modify-or-diagnose-module",
+      "variable_ids": [
+        "api"
+      ],
+      "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."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain responsibility, registration, state, persistence and downstream handoffs, actual success and error handling, and change entrypoints. Include only implementation details useful to this maintenance task.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/plugins/skills/context-code-indexer/templates/background-runtime-task-runtime-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "background-runtime-task-runtime-guide",
+  "profile": "background-runtime",
+  "reader_goal": "operate-or-extend-task",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "operate-or-extend-task",
+      "variable_ids": [
+        "api"
+      ],
+      "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."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain trigger and registration, input routing, effects and actual success conditions, then only source-supported retry, idempotency, compensation and operational guidance. Function success is not automatically business completion.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/plugins/skills/context-code-indexer/templates/cli-tool-maintenance-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "cli-tool-maintenance-guide",
+  "profile": "cli-tool",
+  "reader_goal": "modify-or-diagnose-module",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "modify-or-diagnose-module",
+      "variable_ids": [
+        "api"
+      ],
+      "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."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain responsibility, registration, state, persistence and downstream handoffs, actual success and error handling, and change entrypoints. Include only implementation details useful to this maintenance task.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

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

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "cli-tool-public-api-reference",
+  "profile": "cli-tool",
+  "reader_goal": "look-up-public-contract",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "look-up-public-contract",
+      "variable_ids": [
+        "api"
+      ],
+      "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."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain the declared operation or type, invocation prerequisites, input and output semantics, and a supported example. Share this contract reference with related task pages.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->