pomaster 0.4.0 → 0.5.0

package/seeds/specs/hard/backend/26-engineering-tooling-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/26-engineering-tooling-protocol.md
-seed_source_sha256: b0fcecee17a3acdb11f59f065ae7cac269cc292e999dd39444e5293565d38fe1
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:engineering-tooling-protocol
-criticality: standard
-injection_mode: triggered
-stages: [prepare, implement, check]
-triggers: [build, tooling, ci]
-requires: []
----
-
-# 工程工具协议
-
-## Scope
-
-规范构建、静态检查、生成产物、CI、版本固定、ADR 与可复现性。
-
-## Non-Scope
-
-不规定所有项目使用同一构建工具。
-
-## Terms
-
-可复现构建是从受控输入得到可核对产物的过程。
-
-## MUST
-
-- 运行时、构建工具、依赖锁定和质量命令必须在仓库或受控环境中可发现。
-
-## MUST NOT
-
-- 不得手工修改生成产物或让本地与 CI 使用不一致的门禁。
-
-## SHOULD
-
-- 应自动校验生成代码、契约、migration、依赖和容器配置漂移。
-
-## Contract
-
-工具链记录必须包含版本来源、入口命令、输入、输出和失败门禁。
-
-## Checklist
-
-- [ ] 干净环境可完成构建、测试和静态检查。
-
-## Examples
-
-- CI 重新生成 OpenAPI 产物并拒绝未提交差异。
-
-## Anti-patterns
-
-- 依赖开发机全局工具或未记录的 IDE 操作。
-
-## Ownership
-
-平台维护者维护工具链，模块维护者确保项目命令持续可运行。
-
-## Change Policy
-
-工具升级必须验证兼容、锁文件、生成差异和回退。
-

package/seeds/specs/hard/backend/27-dependency-supply-chain-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/27-dependency-supply-chain-protocol.md
-seed_source_sha256: 7e0817507039ab5f633ff4cb7eb3590d8755a547b8db91867f92bc702a64ddfe
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:dependency-supply-chain-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, implement, check, release]
-triggers: [dependency, supply-chain]
-requires: []
----
-
-# 依赖与供应链协议
-
-## Scope
-
-规范依赖准入、版本、漏洞、许可证、来源、锁文件和构建供应链。
-
-## Non-Scope
-
-不规定具体语言的包管理器命令。
-
-## Terms
-
-直接依赖由项目显式声明，传递依赖由解析图间接引入。
-
-## MUST
-
-- 新增或升级依赖必须验证必要性、来源、版本、许可证、漏洞和维护状态。
-
-## MUST NOT
-
-- 不得从不可信源下载执行代码或忽略锁文件与校验差异。
-
-## SHOULD
-
-- 应减少重复能力、限制依赖范围并生成可追溯物料清单。
-
-## Contract
-
-依赖变更必须记录原因、影响图、风险、测试、生成差异和回退。
-
-## Checklist
-
-- [ ] 直接与传递依赖、插件、镜像和构建脚本均已审计。
-
-## Examples
-
-- 安全升级同时验证 API 兼容、配置变化和运行回归。
-
-## Anti-patterns
-
-- 为一个简单函数引入高权限且维护不明的大型依赖。
-
-## Ownership
-
-依赖引入者负责评审，安全与平台角色维护阻断策略。
-
-## Change Policy
-
-紧急漏洞例外必须限时、可追踪并安排后续完整验证。
-

package/seeds/specs/hard/backend/28-testing-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/28-testing-protocol.md
-seed_source_sha256: f5df73dd7bec4ccf4132c3d7a9918a6f1cb0dd9682aa17956cb24446aa406ad7
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:testing-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, check, release]
-triggers: [testing, acceptance]
-requires: []
----
-
-# 测试协议
-
-## Scope
-
-规范单元、API、集成、契约、迁移、并发、安全、性能与故障测试。
-
-## Non-Scope
-
-不规定统一覆盖率阈值或替代验收证据协议。
-
-## Terms
-
-测试层级按需要隔离的边界与要证明的风险划分。
-
-## MUST
-
-- 测试计划必须覆盖变更行为、边界、失败、兼容和高风险交互。
-
-## MUST NOT
-
-- 不得用固定 sleep、共享脏数据或只测成功路径获得虚假稳定性。
-
-## SHOULD
-
-- 应控制时间、随机、网络和外部依赖，并保留失败诊断信息。
-
-## Contract
-
-测试证据必须包含范围、环境、命令、结果、失败和未覆盖风险。
-
-## Checklist
-
-- [ ] API、DB、事务、并发、幂等、缓存、安全和回滚按影响选择。
-
-## Examples
-
-- migration 在真实数据库版本上验证前向、兼容与恢复。
-
-## Anti-patterns
-
-- Mock 掉所有边界后声称集成行为已验证。
-
-## Ownership
-
-实现者维护变更测试，测试与评审角色检查风险覆盖。
-
-## Change Policy
-
-删除或放宽测试必须说明替代证据和风险审批。
-

package/seeds/specs/hard/backend/29-observability-logging-tracing-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/29-observability-logging-tracing-protocol.md
-seed_source_sha256: e871f5d7d1e9fe68956881877baba94f376a5539753441853f8cfa12939f5ebd
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:observability-logging-tracing-protocol
-criticality: standard
-injection_mode: triggered
-stages: [implement, check, release]
-triggers: [observability, logging, tracing]
-requires: []
----
-
-# 可观测性、日志与追踪协议
-
-## Scope
-
-规范日志、指标、TraceId、审计、告警和事故诊断证据。
-
-## Non-Scope
-
-不替代错误码、隐私、安全或具体监控平台配置。
-
-## Terms
-
-可观测信号包括结构化日志、指标、trace、审计和健康状态。
-
-## MUST
-
-- 关键操作必须可关联版本、环境、主体、操作结果与 TraceId。
-
-## MUST NOT
-
-- 不得记录 token、密码、secret、完整敏感 payload 或无界高基数值。
-
-## SHOULD
-
-- 应为关键失败、延迟、容量和依赖建立可行动的指标与告警。
-
-## Contract
-
-信号设计必须定义 schema、级别、采样、保留、脱敏、Owner 与排障用途。
-
-## Checklist
-
-- [ ] 成功、失败、重试、降级和恢复均能通过信号关联。
-
-## Examples
-
-- 外部调用 trace 记录供应方、结果类和延迟，不记录认证凭据。
-
-## Anti-patterns
-
-- 只打印自由文本异常，无法按请求、版本或业务操作聚合。
-
-## Ownership
-
-服务维护者拥有诊断信号，运行角色维护告警与事故流程。
-
-## Change Policy
-
-信号 schema、采样或保留变化必须评估仪表盘、告警和隐私影响。
-

package/seeds/specs/hard/backend/30-performance-capacity-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/30-performance-capacity-protocol.md
-seed_source_sha256: b575dd07e4bb6def646acb55c3d62d086a9fd12035b2ab359ec353bf443773e5
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:performance-capacity-protocol
-criticality: standard
-injection_mode: triggered
-stages: [prepare, check, release]
-triggers: [performance, capacity]
-requires: []
----
-
-# 性能与容量协议
-
-## Scope
-
-规范延迟、吞吐、连接池、线程、批处理、背压、容量和压测证据。
-
-## Non-Scope
-
-不在 universal 中规定具体数值阈值或硬件规模。
-
-## Terms
-
-性能预算是由业务目标与运行环境确认的可测量约束。
-
-## MUST
-
-- 性能结论必须绑定负载模型、数据规模、环境、版本和统计口径。
-
-## MUST NOT
-
-- 不得用单次本地耗时、平均值或无代表性数据声称满足容量。
-
-## SHOULD
-
-- 应同时观察尾延迟、错误率、资源、排队、背压和依赖瓶颈。
-
-## Contract
-
-容量计划必须包含场景、预算、峰值、瓶颈、扩缩容和降级策略。
-
-## Checklist
-
-- [ ] 连接池、线程池、队列、批量、缓存与数据库联动已验证。
-
-## Examples
-
-- 在目标数据量和并发模型下报告 p95/p99、错误率与资源曲线。
-
-## Anti-patterns
-
-- 盲目增大池大小导致下游过载和更长排队。
-
-## Ownership
-
-业务 Owner 提供负载目标，Backend 与运行角色验证容量。
-
-## Change Policy
-
-预算或容量模型变化必须记录来源并重新运行代表性测试。
-

package/seeds/specs/hard/backend/31-runtime-deployment-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/31-runtime-deployment-protocol.md
-seed_source_sha256: c791451de0be3aa0629fd562e2b43cc54066e4b10d786264fa7a333c561ef23a
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:runtime-deployment-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, implement, check, release]
-triggers: [runtime, deployment, configuration]
-requires: []
----
-
-# 运行时与部署协议
-
-## Scope
-
-规范部署单元、实例、网络、TLS、代理头、健康检查、容器与运行时加固。
-
-## Non-Scope
-
-不默认选择 Nginx、Ingress、Tomcat、容器平台或具体 JVM 参数。
-
-## Terms
-
-部署拓扑描述入口链路、信任边界、运行单元、状态依赖与观测链路。
-
-## MUST
-
-- 必须记录真实打包、启动、端口、协议、实例、状态依赖和配置来源。
-
-## MUST NOT
-
-- 不得把开发机拓扑、默认端口或未验证容器行为当作生产事实。
-
-## SHOULD
-
-- 应支持优雅启动停止、健康检查、滚动发布、最小权限和故障隔离。
-
-## Contract
-
-部署设计必须包含入口、网络、信任、依赖、扩缩容、恢复和证据。
-
-## Checklist
-
-- [ ] 多实例、代理链、TLS、健康、配置、日志与回滚已演练。
-
-## Examples
-
-- 明确 Ingress 到 Service 再到应用的代理头与健康检查责任。
-
-## Anti-patterns
-
-- 应用无条件信任任意来源的 `X-Forwarded-*`。
-
-## Ownership
-
-Backend 拥有应用运行契约，平台角色拥有受控部署环境。
-
-## Change Policy
-
-拓扑或打包变化必须同步技术基线、发布方案与运行验证。
-

package/seeds/specs/hard/backend/32-release-versioning-rollback-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/32-release-versioning-rollback-protocol.md
-seed_source_sha256: 26a6a23928fc24338f69fb34199ecdea5f654e21534a76ac53a7c0b78030b3c8
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:release-versioning-rollback-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, check, release]
-triggers: [release, rollback, versioning]
-requires: []
----
-
-# 发布、版本与回滚协议
-
-## Scope
-
-规范版本、灰度、开关、发布记录、兼容窗口、回滚和数据库演进。
-
-## Non-Scope
-
-不替代具体平台操作手册或证据验收协议。
-
-## Terms
-
-可回退包括代码回滚、配置恢复、流量撤回和数据 roll-forward 的组合能力。
-
-## MUST
-
-- 发布前必须确认版本、依赖顺序、兼容、观测、停止条件和恢复路径。
-
-## MUST NOT
-
-- 不得在无法恢复数据或无监控信号时进行不可逆全量发布。
-
-## SHOULD
-
-- 应采用小批量灰度、可撤回开关和前后版本并行兼容。
-
-## Contract
-
-发布记录必须包含变更范围、产物 hash、步骤、门禁、指标、Owner 与结果。
-
-## Checklist
-
-- [ ] 应用、数据库、配置、消息、缓存与消费者版本已对齐。
-
-## Examples
-
-- 先发布兼容读写版本，完成数据迁移后再清理旧契约。
-
-## Anti-patterns
-
-- 把数据库回滚等同于逆向执行破坏性 migration。
-
-## Ownership
-
-发布责任人执行门禁，Backend 提供兼容与恢复证据。
-
-## Change Policy
-
-发布流程和阻断门禁变化必须通过演练与审计后生效。
-

package/seeds/specs/hard/backend/index.md

@@ -1,177 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/index.md
-seed_source_sha256: b50c1fdcab5d1a3217a6e28059580195f681b6e68f465eb8e055bd8e5310c479
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:index
-injection_mode: always
-stages: [prepare, implement, check, release]
----
-
-# 后端通用硬规范索引
-
-本目录包含 32 个编号协议和本索引。语义 ID、编号和 canonical filename 是稳定地址；编号只追加，不表示 criticality 或激活优先级。协议正文只定义跨项目治理，不保存项目 endpoint、table、column、业务状态、环境阈值或责任人。
-
-## 使用规则
-
-本目录协议由 init 一次性播种到 `.pomaster/specs/hard/backend/`（seed-once：缺席才写、在座零触碰）；开发/验收上下文的协议激活由 `pomaster context compile --role <role>` 投影承载（frontmatter 的 injection_mode/stages/triggers 为移植保留的 info 性注记，非执行语义）。`criticality` 只决定违规严重度，不参与默认选择。
-
-## 维护 spec：主题 → 协议路由表
-
-**要给本项目补充/修改后端规则时，MUST 就地编辑下表命中的编号协议文件，MUST NOT 新建平行文件。**
-把规则写进目标文件的 `MUST` / `MUST NOT` / `SHOULD` / `Contract` / `Checklist` 章节；
-技术栈特有规则进 `stacks/<slug>/<slug>-overlay.md`。
-
-| 你要维护的主题（关键词） | 就地编辑这个文件 |
-|---|---|
-| 架构治理、架构决策、ADR | `01-architecture-governance-protocol.md` |
-| 工程结构、模块划分、包组织 | `02-project-structure-governance-protocol.md` |
-| 目录边界、依赖方向 | `03-directory-boundary-protocol.md` |
-| 分层架构、Controller/Service/Repository 职责 | `04-layering-architecture-protocol.md` |
-| 任务流程、开发工作流 | `05-task-workflow-protocol.md` |
-| AI 生成代码约束 | `06-ai-generated-code-protocol.md` |
-| 证据、验收标准 | `07-evidence-acceptance-protocol.md` |
-| 契约变更、破坏性改动、兼容窗口 | `08-contract-change-protocol.md` |
-| Owner、角色责任 | `09-role-responsibility-protocol.md` |
-| 认证授权、加密、注入防护、安全边界 | `10-security-protocol.md` |
-| 环境变量、配置中心、多环境 | `11-environment-configuration-protocol.md` |
-| API 契约、OpenAPI、REST 风格、版本 | `12-api-contract-protocol.md` |
-| 隐私、数据留存与删除、脱敏 | `13-privacy-data-lifecycle-protocol.md` |
-| 业务规则、领域状态机 | `14-business-rules-state-protocol.md` |
-| 实体、DTO、领域模型、字段语义 | `15-data-model-protocol.md` |
-| 错误码、异常体系、错误响应 | `16-error-code-protocol.md` |
-| 权限模型、RBAC、数据范围 | `17-permission-authorization-protocol.md` |
-| 数据库 schema、migration、Flyway/Liquibase | `18-database-schema-migration-protocol.md` |
-| SQL、索引、慢查询、查询优化 | `19-query-index-sql-protocol.md` |
-| 事务边界、传播行为、回滚 | `20-transaction-boundary-protocol.md` |
-| 并发、锁、乐观/悲观锁、竞态 | `21-concurrency-locking-protocol.md` |
-| 幂等、重复请求、去重 | `22-idempotency-protocol.md` |
-| 缓存、Redis 一致性、缓存失效 | `23-cache-redis-consistency-protocol.md` |
-| 外部集成、熔断、降级、重试、超时 | `24-external-integration-resilience-protocol.md` |
-| 异步任务、定时调度、消息消费 | `25-async-job-scheduler-protocol.md` |
-| 构建工具、静态检查、CI | `26-engineering-tooling-protocol.md` |
-| 依赖管理、供应链安全 | `27-dependency-supply-chain-protocol.md` |
-| 单元/集成/契约测试、覆盖率 | `28-testing-protocol.md` |
-| 日志、链路追踪、可观测性、指标 | `29-observability-logging-tracing-protocol.md` |
-| 性能、容量、压测、限流 | `30-performance-capacity-protocol.md` |
-| 运行时、部署、容器、健康检查 | `31-runtime-deployment-protocol.md` |
-| 发布、版本、回滚 | `32-release-versioning-rollback-protocol.md` |
-| 语言/框架/中间件特有细则（Java、Spring、MyBatis、MySQL、Redis、Nginx…） | `stacks/<slug>/<slug>-overlay.md` |
-
-只有当一条规则在上表与所有 overlay 里**找不到任何归属主题**时，才允许新增协议文件；此时必须同步
-下方「协议目录」与「任务命中矩阵」，保持双向索引完整。
-
-重跑播种（init）默认只补齐缺失文件、不覆盖已存在的协议，所以就地维护不会被覆盖。
-
-## 协议目录
-
-| No | Semantic ID | Canonical filename | Criticality | Injection | Stages | Triggers | 核心职责 |
-|---:|---|---|---|---|---|---|---|
-| 01 | `backend:architecture-governance-protocol` | `01-architecture-governance-protocol.md` | critical | reference | prepare,check | architecture,technology-baseline,deployment-topology | 架构边界、ADR 与演进门禁 |
-| 02 | `backend:project-structure-governance-protocol` | `02-project-structure-governance-protocol.md` | standard | triggered | prepare,implement,check | project-structure,module-layout | 项目目录分区与结构检查 |
-| 03 | `backend:directory-boundary-protocol` | `03-directory-boundary-protocol.md` | critical | always | implement,check | - | 公开入口、依赖方向与越界识别 |
-| 04 | `backend:layering-architecture-protocol` | `04-layering-architecture-protocol.md` | critical | triggered | prepare,implement,check | layering,module-boundary,domain-design | 后端分层职责与边界 |
-| 05 | `backend:task-workflow-protocol` | `05-task-workflow-protocol.md` | critical | always | prepare,implement,check,release | - | Backend Ready 与阶段路由 |
-| 06 | `backend:ai-generated-code-protocol` | `06-ai-generated-code-protocol.md` | critical | always | prepare,implement,check | - | Agent 事实边界与验证 |
-| 07 | `backend:evidence-acceptance-protocol` | `07-evidence-acceptance-protocol.md` | critical | always | prepare,check,release | - | 证据、验收与例外门禁 |
-| 08 | `backend:contract-change-protocol` | `08-contract-change-protocol.md` | critical | always | prepare,implement,check,release | - | 公共契约兼容与迁移 |
-| 09 | `backend:role-responsibility-protocol` | `09-role-responsibility-protocol.md` | advisory | reference | prepare,check | ownership,handoff | Owner、RACI 与交接 |
-| 10 | `backend:security-protocol` | `10-security-protocol.md` | critical | triggered | prepare,implement,check,release | security,api-input,authentication,authorization,file-processing,secrets | 服务端安全控制 |
-| 11 | `backend:environment-configuration-protocol` | `11-environment-configuration-protocol.md` | critical | triggered | prepare,implement,check,release | environment-configuration,configuration,secrets,runtime | 环境、secret 与配置漂移 |
-| 12 | `backend:api-contract-protocol` | `12-api-contract-protocol.md` | critical | triggered | prepare,implement,check | api-contract,api-change | API 与兼容契约 |
-| 13 | `backend:privacy-data-lifecycle-protocol` | `13-privacy-data-lifecycle-protocol.md` | critical | triggered | prepare,implement,check,release | sensitive-data,privacy,data-export | 隐私与数据生命周期 |
-| 14 | `backend:business-rules-state-protocol` | `14-business-rules-state-protocol.md` | critical | triggered | prepare,implement,check | business-rules,state-transition | 服务端规则与状态机 |
-| 15 | `backend:data-model-protocol` | `15-data-model-protocol.md` | standard | triggered | prepare,implement,check | data-model,dto,mapping | 边界模型与映射 |
-| 16 | `backend:error-code-protocol` | `16-error-code-protocol.md` | standard | triggered | prepare,implement,check | error-code,error-handling | 稳定错误语义 |
-| 17 | `backend:permission-authorization-protocol` | `17-permission-authorization-protocol.md` | critical | triggered | prepare,implement,check | authorization,tenant,data-scope | 权限、租户与数据范围 |
-| 18 | `backend:database-schema-migration-protocol` | `18-database-schema-migration-protocol.md` | critical | triggered | prepare,implement,check,release | database-schema,migration,data-repair | Schema、迁移与修复 |
-| 19 | `backend:query-index-sql-protocol` | `19-query-index-sql-protocol.md` | standard | triggered | implement,check | sql,query,index,pagination | SQL、分页与索引证据 |
-| 20 | `backend:transaction-boundary-protocol` | `20-transaction-boundary-protocol.md` | critical | triggered | prepare,implement,check | transaction | 事务边界与失败语义 |
-| 21 | `backend:concurrency-locking-protocol` | `21-concurrency-locking-protocol.md` | critical | triggered | prepare,implement,check | concurrency,locking | 并发、锁与冲突 |
-| 22 | `backend:idempotency-protocol` | `22-idempotency-protocol.md` | critical | triggered | prepare,implement,check | idempotency,callback,replay | 写操作幂等与重放 |
-| 23 | `backend:cache-redis-consistency-protocol` | `23-cache-redis-consistency-protocol.md` | critical | triggered | prepare,implement,check,release | redis,cache | 缓存与权威源一致性 |
-| 24 | `backend:external-integration-resilience-protocol` | `24-external-integration-resilience-protocol.md` | critical | triggered | prepare,implement,check,release | external-integration,resilience | 超时、重试、补偿与对账 |
-| 25 | `backend:async-job-scheduler-protocol` | `25-async-job-scheduler-protocol.md` | standard | triggered | prepare,implement,check,release | async-job,scheduler,import-export | Job 生命周期与调度 |
-| 26 | `backend:engineering-tooling-protocol` | `26-engineering-tooling-protocol.md` | standard | triggered | prepare,implement,check | build,tooling,ci | 构建、生成与 CI |
-| 27 | `backend:dependency-supply-chain-protocol` | `27-dependency-supply-chain-protocol.md` | critical | triggered | prepare,implement,check,release | dependency,supply-chain | 依赖与供应链风险 |
-| 28 | `backend:testing-protocol` | `28-testing-protocol.md` | critical | triggered | prepare,check,release | testing,acceptance | 风险导向测试 |
-| 29 | `backend:observability-logging-tracing-protocol` | `29-observability-logging-tracing-protocol.md` | standard | triggered | implement,check,release | observability,logging,tracing | 日志、指标、追踪与审计 |
-| 30 | `backend:performance-capacity-protocol` | `30-performance-capacity-protocol.md` | standard | triggered | prepare,check,release | performance,capacity | 性能预算与容量证据 |
-| 31 | `backend:runtime-deployment-protocol` | `31-runtime-deployment-protocol.md` | critical | triggered | prepare,implement,check,release | runtime,deployment,configuration | 运行时、入口与部署拓扑 |
-| 32 | `backend:release-versioning-rollback-protocol` | `32-release-versioning-rollback-protocol.md` | critical | triggered | prepare,check,release | release,rollback,versioning | 发布、版本与恢复 |
-
-## 默认激活基线
-
-默认激活面严格只有以下 5 个短协议和索引；实际命中按任务特征（见「任务命中矩阵」）继续收窄。
-
-```text
-backend:index
-backend:task-workflow-protocol
-backend:ai-generated-code-protocol
-backend:directory-boundary-protocol
-backend:contract-change-protocol
-backend:evidence-acceptance-protocol
-```
-
-| Stage | 建议纳入上下文 |
-|---|---|
-| prepare | index、task workflow、AI generated code、contract change、evidence acceptance |
-| implement | index、task workflow、AI generated code、directory boundary、contract change |
-| check | index 加全部 5 个基线协议 |
-| release | index、task workflow、contract change、evidence acceptance |
-
-## 任务命中矩阵
-
-| 任务特征 | 建议命中的协议特征 |
-|---|---|
-| 架构、技术栈或部署形态选择 | 显式展开 `backend:architecture-governance-protocol`，并命中 `project-structure`、`layering`、`environment-configuration`、`build`、`dependency`、`performance`、`runtime`、`release` |
-| 新增或修改 API | `api-contract`、`data-model`、`error-code`、`data-scope`、`idempotency`、`testing`、`observability`、`release` |
-| 业务规则或状态流转 | `layering`、`business-rules`、`state-transition`、`data-model`、`error-code`、`data-scope`、`transaction`、`concurrency`、`testing` |
-| 数据库结构或迁移 | `database-schema`、`migration`、`sql`、`transaction`、`concurrency`、`testing`、`observability`、`rollback` |
-| 查询、分页、报表或导出 | `api-contract`、`data-model`、`data-scope`、`query`、`pagination`、`cache`、`testing`、`performance` |
-| 事务写流程 | `business-rules`、`error-code`、`transaction`、`concurrency`、`idempotency`、`external-integration`、`testing`、`observability` |
-| Redis 或缓存变更 | `environment-configuration`、`concurrency`、`idempotency`、`redis`、`testing`、`observability`、`capacity` |
-| 外部系统集成 | `environment-configuration`、`api-contract`、`error-code`、`idempotency`、`external-integration`、`resilience`、`async-job`、`testing`、`observability` |
-| 导入、导出或异步任务 | `api-contract`、`error-code`、`data-scope`、`idempotency`、`cache`、`async-job`、`scheduler`、`testing`、`observability`、`performance` |
-| 认证、权限或敏感数据 | `security`、`authentication`、`sensitive-data`、`privacy`、`error-code`、`data-scope`、`testing`、`observability` |
-| 运行时、部署或配置 | `environment-configuration`、`external-integration`、`deployment`、`observability`、`performance`、`release` |
-| 依赖升级 | `build`、`dependency`、`supply-chain`、`testing`、`performance`、`release` |
-| 发布、灰度或回滚 | `environment-configuration`、`testing`、`observability`、`performance`、`deployment`、`release`、`rollback` |
-
-矩阵只产生候选特征；实际纳入由 `pomaster context compile --role <role>` 投影承载（Overlay 依赖与冲突按「冲突与责任边界」收窄），纳入/排除决策可经 `pomaster context explain` 逐条审计。
-
-## 协议固定结构
-
-所有编号协议严格使用以下顺序：
-
-1. `Scope`
-2. `Non-Scope`
-3. `Terms`
-4. `MUST`
-5. `MUST NOT`
-6. `SHOULD`
-7. `Contract`
-8. `Checklist`
-9. `Examples`
-10. `Anti-patterns`
-11. `Ownership`
-12. `Change Policy`
-
-## 冲突与责任边界
-
-- 安全规则优先于便利性；最终服务端授权优先于客户端展示。
-- 正式 API、schema、消息和配置契约优先于 Mock、历史示例和聊天记录。
-- 业务规则协议定义权威语义；数据模型协议只定义边界转换。
-- 错误码协议定义调用方语义；可观测性协议定义内部诊断与审计信号。
-- 事务协议定义原子边界；并发协议定义竞争、锁与冲突。
-- 测试协议选择验证方式；证据协议决定声明与门禁是否成立。
-- Stack Overlay 只能收紧或具体化本目录规则，不能保存项目事实或放宽底线。
-
-## 维护规则
-
-协议编号、语义 ID 与 canonical filename 只追加不重排。新增或修改规则必须同步索引、模板、播种清单与 catalog 锁校验；废弃规则必须提供替代 ID、兼容窗口和迁移说明。