pomaster 0.3.0 → 0.5.0

package/seeds/specs/hard/stacks/spring-boot/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-boot/index.md
+seed_source_sha256: afa8f211cc66a0baeff8cf4e837f4dc88da24a690bbbe637d56423a09e4c03cb
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Spring Boot Overlay 索引
+
+本目录只描述 Spring Boot 应用能力，不推断 Web 栈、持久化方式或部署容器。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:spring-boot` | `spring-boot-application-overlay.md` | `application-framework` |
+

package/seeds/specs/hard/stacks/spring-boot/spring-boot-application-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-boot/spring-boot-application-overlay.md
+seed_source_sha256: c8b2afe8de6c5af245035381a272644acee75d4e7d0efea901cac1f45d18d2a4
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:spring-boot
+capability: application-framework
+requires: [backend-stack:java]
+conflicts: []
+coexistence: independent
+stages: [prepare, implement, check, release]
+---
+
+# Spring Boot 应用 Overlay
+
+## Scope
+
+本 Overlay 具体化 Spring Boot 的配置装配、启动、健康检查和依赖管理边界。
+
+## Rules
+
+- 必须记录 Boot 版本、配置来源、自动配置例外和启动验证。
+- 不得从 Spring Boot 推断 Spring MVC、WebFlux、JAR、WAR 或 Tomcat 形态。
+- 配置项和 actuator 暴露必须遵守安全与环境配置协议。
+
+## Checklist
+
+- [ ] Java 依赖已显式选择。
+- [ ] 自动配置与运行时事实可由构建或启动证据验证。
+

package/seeds/specs/hard/stacks/spring-mvc/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-mvc/index.md
+seed_source_sha256: 8ec06aab6382d0f33ac13d6a8c083f3628081e2ee2defaa871dfcba21a73fb07
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Spring MVC Overlay 索引
+
+本目录只描述 Servlet Web 能力；与其他 Web 栈并存时必须声明模块范围。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:spring-mvc` | `spring-mvc-web-overlay.md` | `web-framework` |
+

package/seeds/specs/hard/stacks/spring-mvc/spring-mvc-web-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-mvc/spring-mvc-web-overlay.md
+seed_source_sha256: 19a75e281d7406d4ce38accd4aa528496e9cb666a8d123bc489c7404cb67fcb6
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:spring-mvc
+capability: web-framework
+requires: [backend-stack:java, backend-stack:spring-boot]
+conflicts: []
+coexistence: explicit-scope
+stages: [prepare, implement, check]
+---
+
+# Spring MVC Web Overlay
+
+## Scope
+
+本 Overlay 具体化 Servlet 请求链、Controller、参数绑定、异常映射和线程模型。
+
+## Rules
+
+- Controller 必须保持传输层职责，业务规则进入明确的应用或领域边界。
+- 阻塞调用、上传下载和异步请求必须声明超时、资源与安全约束。
+- 与 WebFlux 并存时必须记录模块、端口或应用边界。
+
+## Checklist
+
+- [ ] Java 与 Spring Boot 依赖已显式选择。
+- [ ] API、错误码、权限和测试证据与实现一致。
+

package/seeds/specs/hard/stacks/spring-webflux/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-webflux/index.md
+seed_source_sha256: f6f8a2719772d4b7e35b38aa604b4017abaa8cf9d558779239a863af4e3666ce
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Spring WebFlux Overlay 索引
+
+本目录只描述响应式 Web 能力；与阻塞栈并存时必须声明边界。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:spring-webflux` | `spring-webflux-reactive-overlay.md` | `reactive-web-framework` |
+

package/seeds/specs/hard/stacks/spring-webflux/spring-webflux-reactive-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-webflux/spring-webflux-reactive-overlay.md
+seed_source_sha256: 4d2045c5bfa66004516dffa55e965e90958270adba9599f116990ac27cc489f8
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:spring-webflux
+capability: reactive-web-framework
+requires: [backend-stack:java, backend-stack:spring-boot]
+conflicts: []
+coexistence: explicit-scope
+stages: [prepare, implement, check]
+---
+
+# Spring WebFlux 响应式 Overlay
+
+## Scope
+
+本 Overlay 具体化响应式请求链、背压、调度器和非阻塞边界。
+
+## Rules
+
+- 必须识别并隔离阻塞 I/O，不得在事件循环中执行不可控阻塞操作。
+- 必须验证取消、超时、背压和上下文传播。
+- 与 Spring MVC 并存时必须记录模块、端口或应用边界。
+
+## Checklist
+
+- [ ] Java 与 Spring Boot 依赖已显式选择。
+- [ ] 阻塞边界与容量证据可复核。
+

package/seeds/specs/hard/stacks/tomcat/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/tomcat/index.md
+seed_source_sha256: 669d418601ec7a26507179f0bfe085621d7d45fd75ba2d297048431ccd91b43d
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Tomcat Overlay 索引
+
+本目录只描述 Tomcat Servlet 容器能力，并明确区分 embedded 与 external。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:tomcat` | `tomcat-runtime-overlay.md` | `servlet-container` |
+

package/seeds/specs/hard/stacks/tomcat/tomcat-runtime-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/tomcat/tomcat-runtime-overlay.md
+seed_source_sha256: 133f15dbb7866e9e06cecf4e2cfcc2b2f14eeb06d9ea3d29be68c9e11cdd1e11
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:tomcat
+capability: servlet-container
+requires: [backend-stack:java]
+conflicts: []
+coexistence: explicit-runtime
+stages: [prepare, implement, check, release]
+---
+
+# Tomcat 运行时 Overlay
+
+## Scope
+
+本 Overlay 具体化 embedded 与 external Tomcat 的连接器、线程、部署和加固边界。
+
+## Rules
+
+- 必须在技术基线中明确 embedded 或 external，以及 JAR 或 WAR。
+- 连接器、代理头、线程和请求限制必须与入口及容量方案一致。
+- 不得把本地启动形态当作生产运行事实。
+
+## Checklist
+
+- [ ] Java 依赖已显式选择。
+- [ ] 容器版本、打包、配置来源和运行证据一致。
+

package/seeds/specs/hard/stacks/vue3/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/vue3/index.md
+seed_source_sha256: 1d17431560308ce46ea300f9200a7ebb007b5a52c21bbfeda2362516a3b5cbc8
+seed_version: B6F
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Vue 3 Overlay 索引
+
+本目录只描述 Vue 3 框架能力与官方配套（Pinia / Vue Router / TypeScript 工具链）边界，不隐式选择 UI 组件库、CSS 体系、grid 方案或构建工具。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `frontend-stack:vue3` | `vue3-framework-overlay.md` | `application-framework` |
+

package/seeds/specs/hard/stacks/vue3/vue3-framework-overlay.md

@@ -0,0 +1,71 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/vue3/vue3-framework-overlay.md
+seed_source_sha256: 15e7fd3808760bb330933f4a0479e4e95e3e07d0e24485d1b9b860019a708935
+seed_version: B6F
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: frontend-stack:vue3
+capability: application-framework
+requires: []
+conflicts: []
+coexistence: independent
+stages: [prepare, implement, check, release]
+x-research-anchors:
+  note: >-
+    Vue 3.5.42（npm registry latest + GitHub vuejs/core tag v3.5.42 双源一致，2026-09-05 实抓）；
+    vuejs.org 为无版本号滚动站点，版本位以实抓日 + 同日包版本实抓为准。pinia 4.0.3（npm 单源）
+    与 vue-router 5.3.1（npm + GitHub 双源）为现行主版本线——不得沿用 pinia 2/3、
+    vue-router 3/4 旧主版本记忆。TypeScript 7.0.2（npm latest 实抓）与 vue-tsc /
+    @vue/tsconfig 的兼容矩阵未逐条核实（研究 Caveats 在册），写死 TS 版本约束前须补核实。
+  sources:
+    - url: https://vuejs.org/guide/essentials/component-basics.html
+      fetched: 2026-09-05
+    - url: https://vuejs.org/guide/scaling-up/sfc.html
+      fetched: 2026-09-05
+    - url: https://vuejs.org/api/sfc-spec.html
+      fetched: 2026-09-05
+    - url: https://vuejs.org/guide/essentials/reactivity-fundamentals.html
+      fetched: 2026-09-05
+    - url: https://vuejs.org/guide/reusability/composables.html
+      fetched: 2026-09-05
+    - url: https://vuejs.org/guide/essentials/lifecycle.html
+      fetched: 2026-09-05
+    - url: https://vuejs.org/guide/scaling-up/state-management.html
+      fetched: 2026-09-05
+    - url: https://pinia.vuejs.org/
+      fetched: 2026-09-05
+    - url: https://vuejs.org/guide/scaling-up/routing.html
+      fetched: 2026-09-05
+    - url: https://router.vuejs.org/
+      fetched: 2026-09-05
+    - url: https://vuejs.org/guide/typescript/overview.html
+      fetched: 2026-09-05
+    - url: https://vuejs.org/style-guide/
+      fetched: 2026-09-05
+    - url: https://v2.vuejs.org/lts/
+      fetched: 2026-09-05
+---
+
+# Vue 3 框架 Overlay
+
+## Scope
+
+本 Overlay 具体化 Vue 3 组件模型、SFC、响应式系统与官方配套（状态 / 路由 / TypeScript 工具链）的选型与版本边界。
+
+## Rules
+
+- 必须固定并记录 Vue 3、Pinia、vue-router 与 TypeScript 工具链（vue-tsc / @vue/tsconfig）的版本位与来源；版本位经实抓核实，不得沿用旧主版本记忆（现行线为 pinia 4.x / vue-router 5.x）。
+- 状态与路由必须选官方方案：新应用状态管理选 Pinia（Vue 核心团队维护；Vuex 已是维护模式），SPA 路由选官方 Vue Router——两者是官方口径，不自造替代。
+- 组件、SFC 与响应式写法以官方文档与风格指南优先级（A/B/C 三档）为基准；响应式必须声明 ref / reactive 选型边界（reactive 的 proxy 局限官方有专门小节）。
+- 组合式函数必须遵守官方约定（命名、入参、返回值、副作用、使用限制），生命周期钩子按官方注册时机使用。
+- 不得由 Vue 3 选型推断 UI 组件库、CSS 体系、grid 或构建工具选型；Vue 2 已 EOL，其心智不得带入新项目基线。
+
+## Checklist
+
+- [ ] 版本位（vue / pinia / vue-router / typescript）经实抓核实并记录在项目技术基线。
+- [ ] 状态、路由与 TS 类型检查工具链为官方词形（Pinia / Vue Router / vue-tsc）且带实抓日期锚。
+

package/seeds/specs/hard/themes/ai-generated-code.md

@@ -0,0 +1,171 @@
+---
+seed_source: packages/cli/seeds/aggregation-manifest.json
+seed_source_sha256: 039b637ccffacdfe3ce30d85e193f4b38928fcdfb16efdc4eb255e35e05af91f
+seed_version: B7-THEME
+lane: [frontend, backend]
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend, backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: theme:ai-generated-code
+criticality: critical # 聚合注记：取源最高；info 性注记非执行语义
+injection_mode: always # 聚合注记：来源同值；info 性注记非执行语义
+stages: [prepare, implement, check] # 聚合注记：来源 stages 并集；info 性注记非执行语义
+triggers: [] # 聚合注记：来源无 triggers 字段；info 性注记非执行语义
+requires: [] # 聚合注记：来源 requires 并集（全空）
+x-aggregation: # 聚合来源（D6）：逐源 vendor pin（sha256 与卡 vendor_pin 同值）
+  - seed_source: pomaster/components/frontend-hard-spec/assets/universal/02-ai-generated-code-protocol.md
+    sha256: a80ea1c51c9afc0b96001cfffa0675edafb1572563652840bcf88770d81203c8
+    seed_version: B6B-1
+  - seed_source: pomaster/components/backend-hard-spec/assets/universal/06-ai-generated-code-protocol.md
+    sha256: a88614806137f33161b741d2a9fbc6ee310fa4f0cbf6acd222de07c14aee3d75
+    seed_version: B6C
+---
+
+# AI 生成代码
+
+> **聚合纪律**：本文档 12 节正文规则行逐字取自 frontmatter x-aggregation 所列来源协议（节内按「端 → 源编号升序」以加粗来源行分块，源内标题与层级原样保留），零新增、零改写、零删除；新增文本仅限文档标题、本注记与逐节来源行。
+
+## Scope
+
+**源：FE 02 AI 生成代码协议（pomaster/components/frontend-hard-spec/assets/universal/02-ai-generated-code-protocol.md）**
+
+P0。约束 AI 分析、生成、修改、评审和验证代码时的行为。
+
+**源：BE 06 AI 生成代码协议（pomaster/components/backend-hard-spec/assets/universal/06-ai-generated-code-protocol.md）**
+
+约束 Agent 的前置检查、事实边界、复用搜索、实现与验证声明。
+
+## Non-Scope
+
+**源：FE 02 AI 生成代码协议**
+
+不替代人工需求决策、代码所有权、测试、合规审批或上线责任。
+
+**源：BE 06 AI 生成代码协议**
+
+不授权 Agent 自行决定业务事实或扩大写集。
+
+## Terms
+
+**源：FE 02 AI 生成代码协议**
+
+- AI Change Plan：写代码前声明的协议、事实、范围和验证计划。
+- Invented Contract：无正式来源而猜测的字段、状态、权限、API 或规则。
+- Unrelated Change：当前目标不需要的修改。
+
+**源：BE 06 AI 生成代码协议**
+
+权威事实包括已确认的 PRD、契约、schema、配置来源和仓库证据。
+
+## MUST
+
+**源：FE 02 AI 生成代码协议 · §MUST**
+
+- AI 写代码前读取适用协议并输出 Change Plan。
+- AI 必须先搜索已有组件、抽象、契约、工具和同类实现。
+- AI 必须区分事实、推断和待确认项。
+- AI 必须说明为什么修改这些文件、为什么不修改其他层。
+- AI 必须运行可用检查并如实报告未验证项。
+- AI 必须保留与任务无关的用户现有改动。
+
+**源：BE 06 AI 生成代码协议 · §MUST**
+
+- 写入前必须读取规范、搜索复用点，并按风险运行可复核检查。
+
+## MUST NOT
+
+**源：FE 02 AI 生成代码协议 · §MUST NOT**
+
+- MUST NOT 发明正式字段、枚举、公式、权限码、接口、路由或配置。
+- MUST NOT 重复创建已有能力。
+- MUST NOT 删除测试、降低断言、关闭规则或用类型逃逸掩盖问题。
+- MUST NOT 声称执行了实际未运行的验证。
+
+**源：BE 06 AI 生成代码协议 · §MUST NOT**
+
+- 不得发明字段、接口、错误码、迁移、锁、Redis key、topic、secret 或环境阈值。
+
+## SHOULD
+
+**源：FE 02 AI 生成代码协议 · §SHOULD**
+
+- SHOULD 把重复决策沉淀为协议、contract 或自动检查。
+- SHOULD 为高风险公共变更提供迁移和回滚。
+
+**源：BE 06 AI 生成代码协议 · §SHOULD**
+
+- 应显式标记假设、未知项和需要升级确认的决策。
+
+## Contract
+
+**源：FE 02 AI 生成代码协议 · §Contract**
+
+```text
+Goal, Protocols, Facts, Assumptions, TODO_CONFIRM,
+ReuseSearch, FilesToChange, FilesNotToChange,
+Validation, ResidualRisk
+```
+
+**源：BE 06 AI 生成代码协议 · §Contract**
+
+生成内容必须绑定输入来源、目标写集和验证结果。
+
+## Checklist
+
+**源：FE 02 AI 生成代码协议 · §Checklist**
+
+- [ ] 已读协议和正式契约。
+- [ ] 已证明新建必要性。
+- [ ] 未猜测业务和接口事实。
+- [ ] 修改与同步范围明确。
+- [ ] 验证结果真实可复核。
+
+**源：BE 06 AI 生成代码协议 · §Checklist**
+
+- [ ] 已检查既有实现、镜像路径、未提交改动和任务边界。
+
+## Examples
+
+**源：FE 02 AI 生成代码协议 · §Examples**
+
+### 内容示例，可删除
+
+AI 修复报表列宽前识别列 schema 所属层级，验证相同表格类型，再修改领域 preset。
+
+**源：BE 06 AI 生成代码协议 · §Examples**
+
+- 缺少隔离级别事实时记录待确认项，而不是选择一个默认值。
+
+## Anti-patterns
+
+**源：FE 02 AI 生成代码协议 · §Anti-patterns**
+
+未搜索组件库便新建相似组件，并顺手重构 store、API 和全局样式。
+
+**源：BE 06 AI 生成代码协议 · §Anti-patterns**
+
+- 用聊天记忆替代仓库、契约、测试或运行证据。
+
+## Ownership
+
+**源：FE 02 AI 生成代码协议 · §Ownership**
+
+AI 仅为 Contributor；任务、代码、评审和上线分别由对应人类 Owner 负责。
+
+**源：BE 06 AI 生成代码协议 · §Ownership**
+
+Agent 对变更与声明负责，用户拥有超出既定范围的决策权。
+
+## Change Policy
+
+**源：FE 02 AI 生成代码协议 · §Change Policy**
+
+放宽 AI 禁止规则必须由工程治理和领域 Owner 批准；新型 AI 错误应转为协议或门禁。
+
+**源：BE 06 AI 生成代码协议 · §Change Policy**
+
+新增高频误改模式时应追加明确禁止项和回归测试。
+
+> **语言节**：本主题无语言节挂点（缺席诚实）；规则本体即上文通用节。