pomaster 0.4.0 → 0.5.1

package/seeds/specs/hard/backend/06-ai-generated-code-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/06-ai-generated-code-protocol.md
-seed_source_sha256: a88614806137f33161b741d2a9fbc6ee310fa4f0cbf6acd222de07c14aee3d75
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:ai-generated-code-protocol
-criticality: critical
-injection_mode: always
-stages: [prepare, implement, check]
-triggers: []
-requires: []
----
-
-# AI 生成代码协议
-
-## Scope
-
-约束 Agent 的前置检查、事实边界、复用搜索、实现与验证声明。
-
-## Non-Scope
-
-不授权 Agent 自行决定业务事实或扩大写集。
-
-## Terms
-
-权威事实包括已确认的 PRD、契约、schema、配置来源和仓库证据。
-
-## MUST
-
-- 写入前必须读取规范、搜索复用点，并按风险运行可复核检查。
-
-## MUST NOT
-
-- 不得发明字段、接口、错误码、迁移、锁、Redis key、topic、secret 或环境阈值。
-
-## SHOULD
-
-- 应显式标记假设、未知项和需要升级确认的决策。
-
-## Contract
-
-生成内容必须绑定输入来源、目标写集和验证结果。
-
-## Checklist
-
-- [ ] 已检查既有实现、镜像路径、未提交改动和任务边界。
-
-## Examples
-
-- 缺少隔离级别事实时记录待确认项，而不是选择一个默认值。
-
-## Anti-patterns
-
-- 用聊天记忆替代仓库、契约、测试或运行证据。
-
-## Ownership
-
-Agent 对变更与声明负责，用户拥有超出既定范围的决策权。
-
-## Change Policy
-
-新增高频误改模式时应追加明确禁止项和回归测试。
-

package/seeds/specs/hard/backend/07-evidence-acceptance-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/07-evidence-acceptance-protocol.md
-seed_source_sha256: fb86312eaadaec81d21e20abfb979e0127138002731ddc4fb1ead9ec90cd10bb
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:evidence-acceptance-protocol
-criticality: critical
-injection_mode: always
-stages: [prepare, check, release]
-triggers: []
-requires: []
----
-
-# 证据与验收协议
-
-## Scope
-
-定义计划证据、实现证据、检查证据、发布证据和例外门禁。
-
-## Non-Scope
-
-不替代各领域协议规定的具体测试方法。
-
-## Terms
-
-证据是可由他人复核的代码坐标、hash、测试、报告或运行结果。
-
-## MUST
-
-- 验收结论必须绑定当前任务、review range、版本和可复核证据。
-
-## MUST NOT
-
-- 不得以口头完成声明、过期报告或无来源截图通过门禁。
-
-## SHOULD
-
-- 应记录失败检查、未覆盖风险和经批准例外的到期条件。
-
-## Contract
-
-验收记录至少包含检查项、命令或来源、结果、时间范围与责任方。
-
-## Checklist
-
-- [ ] 计划、实现、测试、运行和发布证据处于同一变更范围。
-
-## Examples
-
-- 用 migration 测试与 schema hash 证明数据库变更已验证。
-
-## Anti-patterns
-
-- 只列“测试通过”，不提供测试范围与结果来源。
-
-## Ownership
-
-实现者提供证据，评审与发布责任人决定门禁是否满足。
-
-## Change Policy
-
-降低证据要求必须作为受控例外记录，不得静默删除门禁。
-

package/seeds/specs/hard/backend/08-contract-change-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/08-contract-change-protocol.md
-seed_source_sha256: 805c146b31c70d08f876631bc19273076eb242d78fcb3b3a3bd33437e28a6953
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:contract-change-protocol
-criticality: critical
-injection_mode: always
-stages: [prepare, implement, check, release]
-triggers: []
-requires: []
----
-
-# 契约变更协议
-
-## Scope
-
-识别 API、错误码、schema、消息、配置与运行行为的兼容影响。
-
-## Non-Scope
-
-不定义具体业务契约内容。
-
-## Terms
-
-公共契约是已有调用方、持久化数据或运行依赖所观察的稳定行为。
-
-## MUST
-
-- 变更前必须识别消费者、兼容窗口、迁移、回滚和版本策略。
-
-## MUST NOT
-
-- 不得在没有迁移说明时删除、重命名或改变已发布语义。
-
-## SHOULD
-
-- 应优先采用可并行部署、可观测并可撤回的演进方式。
-
-## Contract
-
-变更记录必须包含旧行为、新行为、影响面、兼容判断和验证证据。
-
-## Checklist
-
-- [ ] API、数据、消息、配置和运行消费者均已检查。
-
-## Examples
-
-- 新字段先以兼容方式发布，消费者迁移后再结束旧版本窗口。
-
-## Anti-patterns
-
-- 只修改实现而不更新 OpenAPI、migration、事件 schema 或变更记录。
-
-## Ownership
-
-契约提供方维护兼容方案，消费者确认迁移完成。
-
-## Change Policy
-
-破坏性变更必须经过显式审批、版本升级和可执行回退方案。
-

package/seeds/specs/hard/backend/09-role-responsibility-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/09-role-responsibility-protocol.md
-seed_source_sha256: 603b285faa271b77140f28e1038f850cd01b17ed1813b965898c4746233b342f
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:role-responsibility-protocol
-criticality: advisory
-injection_mode: reference
-stages: [prepare, check]
-triggers: [ownership, handoff]
-requires: []
----
-
-# 角色与责任协议
-
-## Scope
-
-规范 Owner、RACI、评审责任、升级和跨角色交接。
-
-## Non-Scope
-
-不保存具体项目的人员名单或排班。
-
-## Terms
-
-Owner 指对契约、实现或证据完整性承担最终维护责任的角色。
-
-## MUST
-
-- 高风险决策、公共契约和运行门禁必须有可识别的责任角色。
-
-## MUST NOT
-
-- 不得用“团队共同负责”掩盖审批、维护或事故响应空缺。
-
-## SHOULD
-
-- 应在 handoff 中明确输入、输出、截止条件和拒收标准。
-
-## Contract
-
-责任记录至少包含决策者、执行者、评审者、被通知方和升级路径。
-
-## Checklist
-
-- [ ] 跨 BP、Frontend、Backend、Test 与 Ops 的边界已明确。
-
-## Examples
-
-- API 提供方维护契约，调用方确认兼容窗口内完成迁移。
-
-## Anti-patterns
-
-- 交接只发送文档链接，不说明版本、状态和待办。
-
-## Ownership
-
-治理维护者定义角色模型，项目自行绑定实际责任人。
-
-## Change Policy
-
-角色模型变化不得回写或推测消费项目的人员事实。
-

package/seeds/specs/hard/backend/10-security-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/10-security-protocol.md
-seed_source_sha256: 56387f03edd35df50a5a701f4daab174b744d490663393f43331cf5401149f67
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:security-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, implement, check, release]
-triggers: [security, api-input, authentication, authorization, file-processing, secrets]
-requires: []
----
-
-# 安全协议
-
-## Scope
-
-规范认证、鉴权、输入与文件校验、注入防护、密钥和安全默认值。
-
-## Non-Scope
-
-不替代隐私保留规则或具体基础设施加固 Overlay。
-
-## Terms
-
-信任边界是数据或调用从较低信任域进入较高权限域的位置。
-
-## MUST
-
-- 所有信任边界必须执行服务端校验、最小权限、失败关闭和安全审计。
-
-## MUST NOT
-
-- 不得信任前端隐藏、客户端校验、代理头或用户提供的资源归属。
-
-## SHOULD
-
-- 应采用参数化接口、集中密钥管理和可轮换凭据。
-
-## Contract
-
-安全设计必须列出资产、威胁、控制、失败语义、日志限制和验证证据。
-
-## Checklist
-
-- [ ] 认证、鉴权、输入、输出、文件、secret 与审计路径已检查。
-
-## Examples
-
-- 下载接口同时验证操作权限、数据范围和资源归属。
-
-## Anti-patterns
-
-- 把 token、密码或敏感 payload 写入日志与异常。
-
-## Ownership
-
-服务端拥有最终安全判断，安全评审者维护阻断门禁。
-
-## Change Policy
-
-放宽安全控制必须经过显式风险审批、范围限制和到期复审。
-

package/seeds/specs/hard/backend/11-environment-configuration-protocol.md

@@ -1,67 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/11-environment-configuration-protocol.md
-seed_source_sha256: eb9e82e9df64ce238501bc51cd359f36150f911c149904e2ed5a43d9b652b1bd
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:environment-configuration-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, implement, check, release]
-triggers: [environment-configuration, configuration, secrets, runtime]
-requires: []
----
-
-# 环境与配置协议
-
-## Scope
-
-规范环境、profile、secret、超时、配置来源、变更和漂移。
-
-## Non-Scope
-
-不规定具体环境名称、凭据或连接参数数值。
-
-## Terms
-
-配置漂移是声明基线与构建、部署或运行时有效值不一致。
-
-## MUST
-
-- 配置必须有类型、来源、默认行为、敏感级别、验证与变更路径。
-
-## MUST NOT
-
-- 不得把 secret 写入仓库、日志、示例、命令行历史或生成文档。
-
-## SHOULD
-
-- 应在启动时校验关键配置，并对版本与来源提供可观测证据。
-
-## Contract
-
-配置变更必须说明兼容影响、部署顺序、回滚和漂移检测方式。
-
-## Checklist
-
-- [ ] 本地、CI、测试与运行环境的来源和覆盖顺序已核对。
-
-## Examples
-
-- 缺少必需配置时启动失败并输出不含 secret 的稳定错误。
-
-## Anti-patterns
-
-- 用环境默认值掩盖未声明的生产行为。
-
-## Ownership
-
-应用维护者定义消费契约，平台维护者提供受控配置与 secret 来源。
-
-## Change Policy
-
-配置键重命名必须提供双读或迁移窗口并验证旧值清理。

package/seeds/specs/hard/backend/12-api-contract-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/12-api-contract-protocol.md
-seed_source_sha256: 35519d81548cabff729de888e0bf9e0d5b40a0274c9fa3684641b50e75938ca0
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:api-contract-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, implement, check]
-triggers: [api-contract, api-change]
-requires: []
----
-
-# API 契约协议
-
-## Scope
-
-规范请求响应、版本、字段、权限、错误、幂等、分页、兼容与 TraceId。
-
-## Non-Scope
-
-不替代领域规则、最终鉴权或具体 endpoint 事实。
-
-## Terms
-
-正式契约是 OpenAPI 或项目明确指定的等价权威来源。
-
-## MUST
-
-- method、path、字段、状态码、错误码、权限和兼容策略必须与实现一致。
-
-## MUST NOT
-
-- 不得把 Mock、聊天记录或调用方猜测当作正式契约。
-
-## SHOULD
-
-- 应对新增字段、分页、重试和版本演进采用向后兼容默认值。
-
-## Contract
-
-每个接口必须定义输入、输出、失败、幂等、权限、追踪与版本语义。
-
-## Checklist
-
-- [ ] 契约、实现、生成客户端、测试和 handoff 已同步。
-
-## Examples
-
-- 冲突返回稳定错误码与 TraceId，而不是泄露内部异常。
-
-## Anti-patterns
-
-- 修改响应字段但不更新正式契约和调用方兼容测试。
-
-## Ownership
-
-Backend 维护服务端契约，消费者确认联调与兼容结果。
-
-## Change Policy
-
-破坏性 API 变化必须按契约变更协议执行版本与迁移。
-

package/seeds/specs/hard/backend/13-privacy-data-lifecycle-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/13-privacy-data-lifecycle-protocol.md
-seed_source_sha256: df20ccb85008f8744ea16db3ea64e54bdf9fd19d7aa3098c45dc44fff94c3d8d
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:privacy-data-lifecycle-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, implement, check, release]
-triggers: [sensitive-data, privacy, data-export]
-requires: []
----
-
-# 隐私与数据生命周期协议
-
-## Scope
-
-规范数据最小化、分类、脱敏、保留、删除、导出、接收方与审计。
-
-## Non-Scope
-
-不替代一般安全控制或业务合法性确认。
-
-## Terms
-
-生命周期覆盖收集、传输、存储、使用、共享、导出、保留与删除。
-
-## MUST
-
-- 敏感数据必须有目的、来源、接收方、保留期、删除触发与访问控制。
-
-## MUST NOT
-
-- 不得因“以后可能有用”收集或无限期保留数据。
-
-## SHOULD
-
-- 应在非必要场景使用最小字段、脱敏值或不可逆标识。
-
-## Contract
-
-数据设计必须记录分类、处理目的、存储位置、流向、保留与删除证据。
-
-## Checklist
-
-- [ ] URL、日志、trace、缓存、导出和备份均已检查敏感数据。
-
-## Examples
-
-- 审计记录保存必要标识与操作事实，不复制完整敏感 payload。
-
-## Anti-patterns
-
-- 在测试样例、日志或分析事件中使用真实敏感数据。
-
-## Ownership
-
-数据 Owner 决定用途与保留，Backend 实施并证明技术控制。
-
-## Change Policy
-
-扩大处理范围或接收方必须重新评审目的、权限与保留规则。
-

package/seeds/specs/hard/backend/14-business-rules-state-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/14-business-rules-state-protocol.md
-seed_source_sha256: fb255dd2331ac35e73a1ad222e4de4ec2f5fb3a09e675de0e1919d80022ac291
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:business-rules-state-protocol
-criticality: critical
-injection_mode: triggered
-stages: [prepare, implement, check]
-triggers: [business-rules, state-transition]
-requires: []
----
-
-# 业务规则与状态协议
-
-## Scope
-
-规范服务端权威不变量、状态机、计算、校验和失败语义。
-
-## Non-Scope
-
-不发明 BP 未确认的业务规则、阈值或状态。
-
-## Terms
-
-不变量是在任何成功事务后都必须成立的业务条件。
-
-## MUST
-
-- 状态转移必须定义前置条件、权限、效果、失败码和并发行为。
-
-## MUST NOT
-
-- 不得只依赖前端禁用按钮或流程顺序维护业务不变量。
-
-## SHOULD
-
-- 应集中表达同一权威规则并覆盖边界与非法转移测试。
-
-## Contract
-
-规则设计必须绑定 BP 来源、输入、状态、输出、失败和证据。
-
-## Checklist
-
-- [ ] 不变量、状态、权限、事务与并发边界已对齐。
-
-## Examples
-
-- 审批操作在服务端校验当前状态与操作权限后原子更新。
-
-## Anti-patterns
-
-- 在多个 Controller 和 SQL 中复制略有差异的状态判断。
-
-## Ownership
-
-BP 拥有业务语义，Backend 拥有服务端一致实现。
-
-## Change Policy
-
-业务语义变化必须来自正式 delta，并同步状态迁移与兼容计划。
-

package/seeds/specs/hard/backend/15-data-model-protocol.md

@@ -1,68 +0,0 @@
----
-seed_source: pomaster/components/backend-hard-spec/assets/universal/15-data-model-protocol.md
-seed_source_sha256: 21cdd88fac93c9dc834a51d62978b51453ca02eca68f223859aeca0ada99c3f2
-seed_version: B6C
-lane: backend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [backend]
-related_evidence_specs: []
-related_tools: []
-legacy_id: backend:data-model-protocol
-criticality: standard
-injection_mode: triggered
-stages: [prepare, implement, check]
-triggers: [data-model, dto, mapping]
-requires: []
----
-
-# 数据模型协议
-
-## Scope
-
-规范 Command、DTO、Domain Model、Entity 与持久化模型的边界和映射。
-
-## Non-Scope
-
-不定义具体项目字段、表或业务枚举。
-
-## Terms
-
-边界模型是在特定层或契约中表达数据的稳定结构。
-
-## MUST
-
-- 每次转换必须明确字段来源、空值、默认值、精度、时间和枚举语义。
-
-## MUST NOT
-
-- 不得让 API DTO、ORM Entity 与领域模型无条件共用同一类型。
-
-## SHOULD
-
-- 应只在边界转换一次，并通过契约或 round-trip 测试验证。
-
-## Contract
-
-映射必须声明源、目标、必填性、丢失规则和失败行为。
-
-## Checklist
-
-- [ ] 新增字段已追踪到所有生产、转换、存储与消费边界。
-
-## Examples
-
-- API 字符串枚举在入口转换为受控领域值，未知值返回稳定错误。
-
-## Anti-patterns
-
-- 使用反射复制掩盖字段语义、精度或空值差异。
-
-## Ownership
-
-各边界 Owner 维护模型契约，映射实现者负责 round-trip 证据。
-
-## Change Policy
-
-模型变化必须评估 API、数据、消息和历史数据兼容性。
-