@c4a/context-cli 0.7.5 → 0.7.9

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

@@ -0,0 +1,29 @@
+---
+id: context.article.q06
+kind: procedure
+media-type: text/markdown
+program:
+  article: q06
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    tasks: 任务到工具
+    prerequisites: 接入前提
+    operations: 常用操作
+    results: 结果解释
+    references: 代码与文档入口
+---
+
+# 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,31 @@
+---
+id: context.article.s01
+kind: procedure
+media-type: text/markdown
+program:
+  article: s01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 服务定位
+    startup: 接入和启动
+    architecture: 架构分层
+    capabilities: 核心能力与接口
+    dependencies: 模型和依赖摘要
+    index: 知识索引
+    sources: 源码位置
+---
+
+# 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,30 @@
+---
+id: context.article.s02
+kind: procedure
+media-type: text/markdown
+program:
+  article: s02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 协议与范围
+    catalog: 能力与入口表
+    authority: 权威契约
+    implementation: 调用方与实现
+    references: 详情导航
+  contract_table: contract_api
+---
+
+# 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,34 @@
+---
+id: context.article.s03
+kind: procedure
+media-type: text/markdown
+program:
+  article: s03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    entry: 用途与入口
+    validation: 请求和边界校验
+    steps: 处理步骤
+    downstream: 数据与下游操作
+    response: 响应与错误
+    concurrency: 并发与幂等
+    references: 调用方与入口
+  contract_table: contract_api
+---
+
+# 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,35 @@
+---
+id: context.article.s04
+kind: procedure
+media-type: text/markdown
+program:
+  article: s04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 领域范围
+    catalog: 实体与概念表
+    entities: 核心实体
+    relations: 已证实关系
+    states: 状态与转移
+    rules: 业务约束
+    references: 实现与资料
+---
+
+# 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,30 @@
+---
+id: context.article.s05
+kind: procedure
+media-type: text/markdown
+program:
+  article: s05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 存储职责
+    models: 表与持久化对象
+    queries: 查询和索引
+    cache: 缓存与锁
+    consistency: 事务与一致性
+    references: 读写入口
+---
+
+# 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,30 @@
+---
+id: context.article.s06
+kind: procedure
+media-type: text/markdown
+program:
+  article: s06
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    overview: 依赖概览
+    requests: RPC 与 HTTP
+    events: 事件与任务
+    storage: 存储及配置服务
+    initialization: 初始化与选择
+    failures: 故障边界和下一步
+---
+
+# 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,33 @@
+---
+id: context.article.s07
+kind: procedure
+media-type: text/markdown
+program:
+  article: s07
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    triggers: 职责与触发源
+    registration: 注册与订阅
+    payload: Payload 与过滤
+    processing: 处理链路
+    retry: 重试幂等与并发
+    reconciliation: 检查点补偿与对账
+    operations: 运行和观测入口
+---
+
+# 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 -->

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

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "cli-tool-usage-guide",
+  "profile": "cli-tool",
+  "reader_goal": "integrate-capability",
+  "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": "integrate-capability",
+      "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 actual import and setup, when to choose the capability, a minimal example, important combinations and usage limitations.",
+    "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 -->