pomaster 0.4.0 → 0.5.1

package/seeds/specs/hard/stacks/antdesign/antdesign-ui-overlay.md

@@ -0,0 +1,48 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/antdesign/antdesign-ui-overlay.md
+seed_source_sha256: e70a6dad3fedbf8c4a182d92af9c9229e13cc368f880b3ccd96fe11ccdbdd7be
+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:antdesign
+capability: ui-component-library
+requires: [frontend-stack:vue3]
+conflicts: []
+coexistence: independent
+stages: [prepare, implement, check, release]
+x-research-anchors:
+  note: >-
+    Ant Design Vue 4.2.6（npm registry + antdv.com 站点头部版本选择器双源一致，2026-09-05
+    实抓；antdv.com 为 JS 渲染站点，经 chrome-devtools 实载取证）。v4 主题 = CSS-in-JS
+    为官方口径（v3 的 less / CSS 变量降级为构建期静态消费兼容通道）。React 版 Ant Design
+    （ant.design，v6.6.2 实抓，external-sites-index 既有锚）仅作跨栈对照注明，组件 API
+    与主题机制不混用于 Vue 栈。
+  sources:
+    - url: https://antdv.com/docs/vue/introduce
+      fetched: 2026-09-05
+    - url: https://antdv.com/docs/vue/customize-theme
+      fetched: 2026-09-05
+---
+
+# Ant Design Vue 组件库 Overlay
+
+## Scope
+
+本 Overlay 具体化 Ant Design Vue 组件库的引入、按需加载、主题（CSS-in-JS Design Token）与 React 版 antd 的对照边界。
+
+## Rules
+
+- 必须固定组件库词形与版本位：Vue 栈为 ant-design-vue 4.x 线；React 版 Ant Design 仅作跨栈对照，其组件 API 与主题机制不得混用。
+- 引入与按需加载必须走官方口径：全局重置用 `import 'ant-design-vue/dist/reset.css'`；按需加载用 unplugin-vue-components + AntDesignVueResolver（官方示例 importStyle: false 旁注 css in js）。
+- 主题定制主通路为 v4 CSS-in-JS：ConfigProvider 的 theme prop（Design Token 三层派生 Seed → Map → Alias、default / dark / compact 三算法、组件级 Component Token），运行时消费用 useToken；v3 less 变量只作构建期静态消费兼容通道（theme.defaultAlgorithm(defaultSeed) + less-loader modifyVars），两条通路不得未声明混装。
+- 不得由组件库选型推断 CSS 作用域体系、预处理器或 utility 方案（css 键独立选型）；组件库主题 token 不替代项目 design token 分层协议。
+
+## Checklist
+
+- [ ] 版本位经 npm registry 实抓（4.2.6 双源一致）并记录在项目技术基线。
+- [ ] 主题通路（运行时 CSS-in-JS / 构建期 less 兼容）已显式声明且与实际接线一致。
+

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

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/antdesign/index.md
+seed_source_sha256: 261b20e682f7907813dbf46d10391022bf9212e62e6964c33d1d7cbf57128b45
+seed_version: B6F
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Ant Design Vue Overlay 索引
+
+本目录只描述 Ant Design Vue 组件库能力（v4 CSS-in-JS 主题与按需加载），不推断 Vue 版本与 CSS 作用域体系，也不混用 React 版 Ant Design 形态。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `frontend-stack:antdesign` | `antdesign-ui-overlay.md` | `ui-component-library` |
+

package/seeds/specs/hard/stacks/css/css-system-overlay.md

@@ -0,0 +1,52 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/css/css-system-overlay.md
+seed_source_sha256: 4167e2a2d4c457f594db95336470dca4f0778e76df006e815207c0761667692a
+seed_version: B6G
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: frontend-stack:css
+capability: css-system
+requires: [frontend-stack:vue3]
+conflicts: []
+coexistence: independent
+stages: [prepare, implement, check, release]
+x-research-anchors:
+  note: >-
+    css 键选型 = Owner 裁定 D8（09-05-spec-thematic-reorg）：组合词形
+    scoped-sfc+antdv-cssinjs-tokens+antdv-reset-css。版本位 vue 3.5.42 /
+    ant-design-vue 4.2.6（npm registry 实抓 2026-09-05；ant-design-vue 另经 antdv.com
+    站点头部版本选择器双源一致；antdv.com 为 JS 渲染站点，经 chrome-devtools 实载
+    取证）。scoped CSS / :deep() / :slotted() / :global() 词形与子组件根元素口径
+    出自 vuejs.org SFC CSS Features 特性页（vue 3.5.42 时点滚动站）；CSS-in-JS 主题
+    （ConfigProvider theme + useToken）与 reset.css 引入词形出自 antdv.com 官方文档。
+  sources:
+    - url: https://vuejs.org/api/sfc-css-features.html
+      fetched: 2026-09-05
+    - url: https://antdv.com/docs/vue/customize-theme
+      fetched: 2026-09-05
+    - url: https://antdv.com/docs/vue/introduce
+      fetched: 2026-09-05
+---
+
+# CSS 体系 Overlay
+
+## Scope
+
+本 Overlay 具体化项目 CSS 体系选型（裁定 D8 组合词形 scoped-sfc+antdv-cssinjs-tokens+antdv-reset-css）的官方词形与版本边界：SFC scoped 作用域机制、Ant Design Vue CSS-in-JS 主题 token 消费与官方全局重置。
+
+## Rules
+
+- 必须固定并记录 CSS 体系组合词形与版本位：scoped-sfc+antdv-cssinjs-tokens+antdv-reset-css（vue 3.5.42 / ant-design-vue 4.2.6，npm registry 实抓双源一致）；组合之外的作用域/utility 方案属 css 键改型，不得未声明引入。
+- scoped 作用域以 SFC `<style scoped>` 为项目主机制（编译为 data-v-hash 属性选择器）；穿透与例外必须用官方逃逸词形 `:deep()`（子组件穿透）、`:slotted()`（slot 内容）、`:global()`（全局例外）；子组件根元素同时受父 scoped 影响为官方口径。
+- antdv 主题 token 消费走 v4 CSS-in-JS 官方通路：ConfigProvider 的 theme prop（Design Token 三层派生 Seed → Map → Alias、default / dark / compact 三算法、组件级 Component Token），运行时消费用 useToken；组件库主题 token 不替代项目 design token 分层协议。
+- 全局重置以官方单一来源承载：`import 'ant-design-vue/dist/reset.css'`；不得未声明引入与之竞争的第二套全局重置。
+
+## Checklist
+
+- [ ] css 键组合词形与版本位（vue / ant-design-vue）经 npm registry 实抓并记录在项目技术基线。
+- [ ] scoped 逃逸词形（:deep() / :slotted() / :global()）、antdv 主题通路（ConfigProvider theme + useToken）与全局重置（reset.css import）与实际接线一致。
+

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

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/css/index.md
+seed_source_sha256: eb09e17e34b577df39889213194207a3335f151d7c0f6655fa2f6aca63f0dc63
+seed_version: B6G
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# CSS 体系 Overlay 索引
+
+本目录只描述项目 CSS 体系能力（SFC scoped 作用域、Ant Design Vue CSS-in-JS 主题 token 与官方全局重置的官方词形），不推断 Vue 版本与 UI 组件库选型，也不混用 React 版 Ant Design 形态。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `frontend-stack:css` | `css-system-overlay.md` | `css-system` |
+

package/seeds/specs/hard/stacks/geist/geist-design-system-overlay.md

@@ -0,0 +1,48 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/geist/geist-design-system-overlay.md
+seed_source_sha256: a9edc3d23708ccef6aeade6669dd638117f341052c47e0145347a5b51e085680
+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:geist
+capability: design-system
+requires: []
+conflicts: []
+coexistence: independent
+stages: [prepare, implement, check, release]
+x-research-anchors:
+  note: >-
+    Vercel Geist 设计体系参照（2026-09-02 实抓，external-design-references 批次——
+    external-sites-index 既有在册锚）：Foundations 现状为 colors / typography /
+    materials（无 spacing foundation——缺席诚实）；70 组件清单；Button variant+state
+    词表；Best Practices icon-only validator 抛错 = fail-closed 先例。设计体系站点
+    无 npm 包版本位，时效以 verified 时点为准，过期引用须重新核实。
+  sources:
+    - url: https://vercel.com/geist
+      fetched: 2026-09-02
+    - url: https://vercel.com/font
+      fetched: 2026-09-02
+---
+
+# Geist 设计体系 Overlay
+
+## Scope
+
+本 Overlay 具体化以 Vercel Geist 为设计体系参照的 foundations 词形、组件词表与使用规则引用边界。
+
+## Rules
+
+- Foundations 词形（colors / typography / materials）必须以实抓现状为准；Geist 现状无 spacing foundation——缺席诚实记录，禁杜撰 foundation 词形。
+- 组件清单与 variant / state 词表以 Geist 组件页为词形锚；项目侧组件命名与变体词形引用时必须与锚一致或在册声明差异。
+- 引用 Best Practices 要点（如 icon-only validator 抛错 = fail-closed 先例）必须带实抓时点；页面内容随后可能变动，过期引用须重新核实。
+- Geist 为设计体系参照而非实现依赖——不得由 geist 参照推断框架、UI 组件库或 CSS 方案选型；与 UI 组件库 overlay 并存时各守各轴。
+
+## Checklist
+
+- [ ] 引用的 foundations / 组件词表 / 使用规则带 verified 时点（2026-09-02）且未过期或已重新核实。
+- [ ] 参照边界在册：geist 参照不绑定实现依赖，token 消费与主题协议的衔接已显式声明。
+

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

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/geist/index.md
+seed_source_sha256: af0097581fdcac786ff234938bed8237be3185b72ed64d9c19e1a43f7b7a79df
+seed_version: B6F
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Geist Overlay 索引
+
+本目录只描述以 Vercel Geist 为参照的设计体系能力（foundations / 组件词表 / 使用规则），不隐式选择框架、UI 组件库实现或 CSS 方案。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `frontend-stack:geist` | `geist-design-system-overlay.md` | `design-system` |
+

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**
+
+新增高频误改模式时应追加明确禁止项和回归测试。
+
+> **语言节**：本主题无语言节挂点（缺席诚实）；规则本体即上文通用节。