pomaster 0.4.0 → 0.5.0

package/README.md

@@ -10,6 +10,16 @@
 POMaster = State + Context + Transition + Evidence，在 Authority 与 Adaptive Governance 下运行
 ```
 
+## v0.5.0 亮点（2026-09-06）
+
+- **技术栈问卷 + 基线确认 gate**：init 平台选择后 14 键逐项必答（候选含实战栈与占位，可自由输入），答完回填 `baseline/<lane>/stack.yaml` 并销账 unknowns 台账；`pomaster baseline confirm` 以 sha256 快照烙印基线——closeout 对未确认（`BASELINE_NOT_CONFIRMED`）与漂移（`BASELINE_DRIFT`）双重阻断，确认后修改走 `--change CHANGE.*` 治理通路。
+- **baseline 栈预置草案**：选型落定后 init 自动为 22 份基线面生成 `PRESET-DRAFT` 草案节——内容逐条溯源到主题文档与 overlay，Owner 可改，confirm 烙印；业务实体/接口零预置。
+- **spec 主题式重组**：77 份 FE/BE 协议重组为 **20 份主题文档 + 1 导航**（13 跨端合并 + 7 端独占），语言差异为主题文档内小节（内容自 18 族 overlay 逐字同步）；旧平铺文件退役，已安装工作区由 doctor/status `legacy_specs_present` 检出。
+- **overlay 前端族**：vue3 / ant-design-vue / geist / css 体系四族入库（原 14 族全后端 java），全部带官方文档实抓锚（x-research-anchors）。
+- **Discovery 方法论长卡 + Grill 策略**：`pomaster-discovery` 卡内置 Grounded Brainstorm 全剧本——先 Ground 后 Grill、九类拷问动作、Frontier 节奏、上游决策失效重算；`brainstorm decide --set/--answer/--ready` 机器闸放行，`promote` 即建任务。
+- **组件画廊（Storybook）**：仓内 `packages/studio`——41 张 archetype 语义卡 + 71 个 antdv 组件真渲染 + 18 overlay 能力页，`pnpm studio:build` 出静态站。
+- **收口链补全**：`record verification`（claim 到 VERIFIED 的公开生产入口）、context 指纹绑定范围内正文（漂移必 stale）、closeout 候选证据置换不变、research request/handoff 公开链。
+
 ## 快速上手
 
 POMaster 的全部能力收敛在一条 CLI（`pomaster`）——八拍 Change Loop 的每一拍都有对应命令面。先给一张**命令全景**（机器钉版，与 `pomaster --help` 零漂移；`#` 分节注释仅人读）。第一次使用？直接看下面 [install → init → 第一个 Change](#1-安装) 的全流程。
@@ -22,6 +32,7 @@ pomaster alerts
 pomaster doctor
 pomaster portability bootstrap/check
 pomaster update --check/--yes
+pomaster baseline set/confirm   # set = 单键后补销账；confirm = 基线确认 gate（14 unknowns 销账后 digest 快照——closeout 阻断码与 doctor/status 确认态的消费源）
 
 # ① TRIAGE —— 秒级判档（MINIMAL/LIGHT/STANDARD；NO-OP 合法）
 pomaster triage "<request>"
@@ -38,7 +49,7 @@ pomaster maintain <change-or-task> --ops <tx>
 
 # ⑤ VERIFY —— FAST gate / gate recipes 派发 / 证据入账
 pomaster check --fast/--gates
-pomaster record gate-run/claim
+pomaster record gate-run/claim/verification
 
 # ⑥ RECONCILE —— delta 三方对账 / 投影视图 / 审计 / 例外台账
 pomaster reconcile --permit <PERMIT.*>
@@ -59,8 +70,8 @@ pomaster resolve "<need>" [--hints ...]
 pomaster new-entity check <governed-id> [--need ...]
 pomaster inspect <governed-id>
 pomaster graph <governed-id> [--view impact]
-pomaster brainstorm start/question-gate/status/promote
-pomaster research list/inspect
+pomaster brainstorm start/question-gate/status/decide/promote
+pomaster research list/inspect/request/handoff
 pomaster eval --suite behavioral
 pomaster catalog status/explain/relock
 pomaster migrate trellis-spec --analyze --spec-root <dir>
@@ -72,8 +83,8 @@ pomaster session attach/refresh/list
 pomaster lock acquire/heartbeat/release/steal/list
 pomaster execution begin/end/list
 pomaster trace show/list
-# pomaster session（不带子命令）= 治理速览投影（SessionStart 注入源；≤10k 字符，恒 exit 0）
-# pomaster alerts（重入口轻提醒源）= 可行动项过滤器（干净=空输出，恒 exit 0）
+# pomaster session（不带子命令）= 治理速览投影（SessionStart 注入源；≤10k 字符，恒 exit 0；尾部带首答确认协议指令段）
+# pomaster alerts（重入口 UserPromptSubmit 源）= 可行动项过滤器 + workflow 路由段（干净=非空但极简，恒 exit 0）
 ```
 
 ### 1. 安装
@@ -103,18 +114,25 @@ pomaster init
 | `.pomaster/state/authority.json` | Authority Map 骨架（默认登记 `BOOTSTRAP_OWNER`） | 否（人类加注的 owner 一律不动） |
 | `.pomaster/config.yaml` | 治理配置（人类可编辑） | 否（只在缺失时创建） |
 | `AGENTS.md` / `CLAUDE.md` | Agent 重入口（profile + 状态速览 + 常用命令 + 重入口安装物锚点） | 仅带生成标记的（`CLAUDE.md` 通过 `@AGENTS.md` 导入共享） |
+| `SPEC.*` 预植对象 ×19 | Evidence Spec Kit 的 store 对象面（PROPOSED 起步；项目经 maintain→CURRENT 采纳后进 closeout 判卷） | 否（在座零触碰，幂等；`--json` 信封可查） |
 
-**目录宪法全树预铺**（Owner 裁定 2026-09-04，不分档级）：init 一次性建出 `.pomaster/` 目录宪法 §2 全树（state / truth/objects / evidence 三区 / executions / traces / runtime 四区 / discovery/scratchpads / memory/inbox / production 六区，41 目录 × 各带 README——含 09-04 Batch 1 增量 sources/ 来源权威边界平面 + Batch 2 增量 state/contexts/（Task Context Manifest 落盘位）与 evidence/observations/（感知回执 sidecar 分区）+ Batch 6 增量 baseline/（Project Engineering Baseline 四 lane 分区）与 specs/（Spec Workspace：hard/frontend、hard/backend、hard/stacks、acceptance、evidence）两棵播种子树）+ `.pomaster/layout.json` 机器清单（全目录 status=wired + activation_hint——什么样的项目/需求激活该平面由 AI 按项目复杂度自行判断，目录存在 ≠ 已激活）。目录树与入口形态/平台选择**完全无关**（B7 裁定：init 单一重入口，无模式旗标）；canonical 正文层为 `.pomaster/truth/objects/`，legacy `.pomaster/objects/` 在场会被显式告警（禁静默 merge/覆盖/迁移）。播种面语义（Batch 6）：`baseline/**` 与 `specs/**` 下的内容文件由 init 按种子清单 **seed-once-missing-only** 落盘——缺失才写、在座零触碰、播种件不带生成标记（项目自有可编辑，重跑 init 永不覆盖你的修改；AI 禁静默覆盖）。完整规范见 `.pomaster/layout.json` 与目录宪法文档。
+**目录宪法全树预铺**（Owner 裁定 2026-09-04，不分档级）：init 一次性建出 `.pomaster/` 目录宪法 §2 全树（state / truth/objects / evidence 三区 / executions / traces / runtime 四区 / discovery/scratchpads / memory/inbox / production 六区，40 目录 × 各带 README——含 09-04 Batch 1 增量 sources/ 来源权威边界平面 + Batch 2 增量 state/contexts/（Task Context Manifest 落盘位）与 evidence/observations/（感知回执 sidecar 分区）+ Batch 6 增量 baseline/（Project Engineering Baseline 四 lane 分区）与 specs/（Spec Workspace：hard/themes、hard/stacks、acceptance、evidence；B7-THEME 起主题文档单目录承载，旧 FE/BE 平铺位退役）两棵播种子树）+ `.pomaster/layout.json` 机器清单（全目录 status=wired + activation_hint——什么样的项目/需求激活该平面由 AI 按项目复杂度自行判断，目录存在 ≠ 已激活）。目录树与入口形态/平台选择**完全无关**（B7 裁定：init 单一重入口，无模式旗标）；canonical 正文层为 `.pomaster/truth/objects/`，legacy `.pomaster/objects/` 在场会被显式告警（禁静默 merge/覆盖/迁移）。播种面语义（Batch 6）：`baseline/**` 与 `specs/**` 下的内容文件由 init 按种子清单 **seed-once-missing-only** 落盘——缺失才写、在座零触碰、播种件不带生成标记（项目自有可编辑，重跑 init 永不覆盖你的修改；AI 禁静默覆盖）。播种分母 = **102 份内容文件**（specs/hard 57：themes 21（20 主题 + 1 导航——B7-THEME 主题式重组）/ stacks 18×2——后端 14 族 + 前端 4 族；specs/evidence 20；baseline 25）+ manifest 单源；已安装工作区的旧 FE/BE 平铺 spec 由 doctor/status `legacy_specs_present` 检出呈现（纯读不拦不删）。完整规范见 `.pomaster/layout.json` 与目录宪法文档。
 
 **重入口默认**（D13 修订，2026-09-03）：init 缺省生成重入口全套，让 Agent 一开会话就自动看到治理状态、按需自动触发命令卡——
 
-- **skills 命令卡库**：`/pomaster` 路由全景 + `pomaster-bootstrap` … `pomaster-runtime` 等 15 份命令卡，双镜像安装到 `.agents/skills/`（通用层——Codex / Cursor / Gemini CLI / GitHub Copilot / VS Code / Amp / Warp / OpenCode / Droid 等原生读取）与 `.claude/skills/`（Claude Code 必需位），两份逐字节一致、同指 `pomaster --help` 单一事实源；
-- **hooks 注入（claude）**：`.claude/settings.json` 合并式注册 SessionStart → `pomaster session`（治理速览投影，≤10,000 字符硬上限）与 UserPromptSubmit → `pomaster alerts`（可行动项过滤器，干净=空输出恒 exit 0）；既有 hooks（人类/Trellis 条目）一律保留，坏 JSON fail-closed 不覆盖；
+- **skills 命令卡库**：`/pomaster` 路由全景 + `pomaster-bootstrap` … `pomaster-runtime` 等 15 份命令卡，双镜像安装到 `.agents/skills/`（通用层——Codex / Cursor / Gemini CLI / GitHub Copilot / VS Code / Amp / Warp / OpenCode / Droid 等原生读取）与 `.claude/skills/`（Claude Code 必需位），两份逐字节一致、同指 `pomaster --help` 单一事实源；其中 `pomaster-discovery` 是方法论长卡（Grounded Brainstorm：Grill Strategy 主轴 + 对话形式纪律 + 机器闸命令链 + 任务生命周期全图——「走 pomaster brainstorm」/需求讨论/拷问需求等自然语言命中）；
+- **hooks 注入（claude）**：`.claude/settings.json` 合并式注册 SessionStart → `pomaster session`（治理速览投影，≤10,000 字符硬上限，尾部带**首答确认协议**——模型首轮回复必须可见确认注入并报告 Next-Action 路由）与 UserPromptSubmit → `pomaster alerts`（可行动项过滤器 + workflow 路由段：无活跃 TASK 给判档/讨论双入口，有活跃 TASK 给八拍位置与下一拍命令，恒 exit 0）；既有 hooks（人类/Trellis 条目）一律保留，坏 JSON fail-closed 不覆盖；
 - **cursor/qoder**：加厚版 rules（命令卡 + Browser Eyes 展开进 `.cursor/rules/pomaster.mdc` / `.qoder/rules/pomaster.md`）。
 
 **多平台适配器**：`AGENTS.md` 恒为唯一事实源；`--platforms claude,codex,cursor,qoder` 追加各平台的适配器（`CLAUDE.md` / 根 `AGENTS.md` 即 codex 原生入口 / `.cursor/rules/pomaster.mdc` / `.qoder/rules/pomaster.md`，本包产物形态升级自动重写，人类异形内容一律不覆盖）；`--platforms none` 只建 AGENTS.md + 状态骨架。TTY 交互终端直接 `pomaster init` 会出复选清单（◉/◯ 空格勾选 / ↑↓ 移动 / 回车确认；raw 模式不可用时降级为编号输入）；`--json` 恒走确定性缺省（claude，重入口）。
 
-装好后 `pomaster session`（无子命令）就是 hook 看到的治理速览；`pomaster doctor` 会用 `heavy_entry_hooks` / `heavy_entry_skills` 探针核对重入口安装物（hooks 注册态 + 双镜像逐字节一致；未安装 → MISSING_CONFIGURATION 并指路重跑 `pomaster init`）。
+**技术栈问卷与后补销账**（R-M 裁定，2026-09-05）：TTY 交互 init 在平台选择后接技术栈逐键问卷——前端 9 键 + 后端 5 键逐项必答（无缺省不预填，候选含实战栈与常见占位，末行可自由输入；中断 = 零写入），答完即把选型写回 `.pomaster/baseline/<lane>/stack.yaml` 并在 `baseline/manifest.yaml` 的 unknowns 台账对已答键销账；重跑 init 幂等——已答键不重复问，全销账则问卷整体跳过。非交互通道（`--json` / CI）问卷整体跳过、UNKNOWN 显式缺席，后补用 `pomaster baseline set --lane <frontend|backend> --key <key> --value <value>`（键词形 fail-closed；同值重放幂等；已答键改型与已确认基线的修改显式拒绝——修改走治理通路）。分层/职责等架构叙述住播种骨架 `baseline/<lane>/architecture.md`（Owner 就地填写；问卷不程序化改写 md 骨架）。
+
+**基线确认 gate**（R-L 裁定，2026-09-05）：`pomaster baseline confirm` 在 14 个 unknowns 全部销账后对基线做 Owner 确认施断——`baseline/manifest.yaml` 写入 `confirmed` 确认记录（`at_seq` 时点锚 + 两个 `stack.yaml` 与两个 `architecture.md` 的 sha256 digest 快照），已确认且 digest 无漂移时重复 confirm 幂等零写入（NO_CHANGE）。closeout 聚合单点消费确认态：baseline 未确认 → `BASELINE_NOT_CONFIRMED` 阻断；确认后任一快照目标与现盘 digest 不符（检出谁改了架构）→ `BASELINE_DRIFT` 阻断。确认后的修改走治理通路：`pomaster baseline set --change <CHANGE-id>`（CHANGE.* 对象须在册且 lifecycle 合法，kernel 校验）允许写入并使确认记录失效，重确认前 closeout 恢复阻断；漂移后 `pomaster baseline confirm` 重新快照即治理通路终点。`pomaster doctor` / `pomaster status` 呈现确认态（未确认/已确认/已漂移）+ 未销账 unknowns 计数 + 漂移文件清单（`--json` 字段 `baseline_confirmation`；纯读呈现不改 ok 语义）。
+
+**baseline 栈预置草案**（G-B/G-C/G-D 裁定，2026-09-06）：问卷选型落定后，init 自动为 22 份 baseline md 生成「预置草案」节（节头 `PRESET-DRAFT — Owner 确认后成为基线`，NON-AUTHORITATIVE）——草案内容逐条溯源到已锚定的主题文档与 overlay（`- 源:` 行标注 `.pomaster` 路径 + 节锚），纯加法追加、`起步值:UNKNOWN` 骨架字节零改动；栈维度未销账的 lane 保持纯 UNKNOWN（缺席诚实）；draft-once（在座零触碰），Owner 可改；`baseline confirm` 时草案随整文件 digest 烙印，确认后改动即 `BASELINE_DRIFT` 走治理通路。业务实体/接口/数据模型零预置（New Entity Gate 词形在册）。
+
+装好后 `pomaster session`（无子命令）就是 hook 看到的治理速览——**八段分段投影**（分母/任务执行锁状态/**Next-Action 确定性路由**/许可例外/可行动项/attention/完整性微探针/八拍路标，带逐段预算与缺席诚实）+ 尾部首答确认协议（模型首轮必须确认注入并转述 Next-Action 路由）；`pomaster status` 尾行 `next:` 给同一张路由表的当前建议；`pomaster alerts` 恒带 workflow 路由段（无活跃 TASK → 八拍① triage 或 brainstorm start 双入口；有活跃 TASK → 八拍位置 + 下一拍命令 + 分段卡名）。`pomaster doctor` 会用 `heavy_entry_hooks` / `heavy_entry_skills` 探针核对重入口安装物（hooks 注册态 + hook 命令 PATH 可达的生效自检 + 双镜像逐字节一致；未安装/不可达 → MISSING_CONFIGURATION 并给修复指引——重跑 init / 检查 PATH / 项目 hooks 信任审批前置说明）。
 
 ### 3. init 之后该配置什么（config.yaml）
 
@@ -173,15 +191,15 @@ flowchart TB
     STATE["Canonical State<br/>truth-index + objects<br/>四轴状态"]:::core
     PERMIT["Permit / Transition<br/>谁有权改什么"]:::core
     EVI["Evidence 平面<br/>GRN / blobs / claims"]:::core
-    PROJ["Context Projection<br/>MUST/ADVISORY/KNOWLEDGE/<br/>CATALOG/LAZY TOOLS"]:::core
+    PROJ["Context Projection<br/>AUTHORITATIVE PROJECT STATE / REQUIRED POLICY /<br/>ADVISORY KNOWLEDGE / REUSE / CATALOG / VERIFICATION"]:::core
   end
-  subgraph CAT["Engineering Catalog（随包分发）"]
-    POL["policies 79"]:::cat
+  subgraph CAT["Engineering Catalog（随包分发，catalog-lock 逐字节对账）"]
+    POL["policies 206"]:::cat
     KN["knowledge 11"]:::cat
     GT["gates 6"]:::cat
     SEN["sensors 6"]:::cat
     ARC["archetypes 41"]:::cat
-    TOO["tools 8"]:::cat
+    TOO["tools 13"]:::cat
   end
   AGENT["Agent Harness<br/>(Claude Code / Codex / …)"]:::ext
   HUMAN["Human Authority<br/>(Owner)"]:::ext
@@ -371,14 +389,14 @@ Spec、Task、Gate、Knowledge、Brainstorm……全部是这五个原语的派
 - Small Constitution：硬约束极少而精——不伪造事实、不越权、不静默冲突、不无证据宣称完成
 - Heavy Entry by Default（D13 修订 2026-09-03 + B7 裁定 2026-09-04）：入口即治理——init 默认安装 skills 库 + hooks 注入，Agent 开会话即见状态；单一重入口、无模式旗标；hook 注入内容永远是 Canonical State 的投影，不是第二事实源
 - No-op is elegant：没有必要的治理动作，零变化就是成功
-- Framework as Review Surface：框架约束好了的人，不需要读 AI 写的每一行代码——但前提是判卷器诚实，所以我们用对抗性用例持续攻击自己的 gate
+- Framework as Review Surface：框架约束好了的人，不需要读 AI 写的每一行代码——但前提是判卷器诚实，所以我们用对抗性用例持续攻击自己的 gate（8 个宪法回归 Case **CRC-A..H** 永久套件守护核心不变式：一句话需求必须过 grounding、原型实现无权威、agent 不得自批、观察失败≠不存在、截图≠payload……）
 - Minimum Sufficient Governance：治理开销必须与变更风险成比例；小改动的体验是"几乎感觉不到 POMaster"
 - Memory Sovereignty：删掉本机缓存 + fresh clone + bootstrap ≈ 项目认知完全恢复
 
 ## 项目结构
 
 ```text
-packages/    kernel（状态与判卷权威）· cli（命令面）· gauntlet-lite（确定性 gate 腿）· schemas（FROZEN 词表 schema）
+packages/    kernel（状态与判卷权威）· cli（命令面）· gauntlet-lite（确定性 gate 腿）· schemas（FROZEN 词表 schema）· studio（组件画廊 Storybook 实例——private，不入 npm 发布面）
 catalog/     policies · knowledge · gates · sensors · archetypes · tools——随包分发的工程策展物料（catalog-lock 逐字节对账；手补物料后 `pomaster catalog relock` 一键重锁）
 references/  concept-ledger（治理概念账本）· external-sites-index（外部参照站点索引）
 tests/       单元 / 集成 / Golden / 对抗 / 行为 / 自托管基准（数量下限进 CI 棘轮，只升不降）
@@ -388,6 +406,24 @@ legal/       THIRD_PARTY_NOTICES · PROVENANCE
 
 技术栈：TypeScript · Node ≥ 22 · pnpm monorepo · Canonical State 为 JSON · Git 为版本与回滚底座 · 外部测试工具一律走 Adapter（绝不进核心）。
 
+## 组件画廊（Storybook studio，仓内开发面）
+
+开发仓内置 canonical Storybook 实例（裁定 G-A；`packages/studio`，private——`build-npm-package` 的 stage 白名单不含它，npm 发布面零泄漏）。组件资产的「有哪些 + 长什么样」一页可览：
+
+| 页面类 | 数量 | 形态 |
+| --- | --- | --- |
+| Archetype 语义卡 | 41 | MDX 纯文档页（responsibility / when_to_use / composition / 研究锚透传） |
+| AntDV 组件 | 71 | CSF3 story 真渲染（`ant-design-vue@4.2.6`，同族子导出一并挂载） |
+| Overlay 能力清单 | 18 | MDX 页（capability / requires / Rules / 源指向，自 `seeds/specs/hard/stacks/`） |
+| Foundations 与边界 | 4 | geist 官方站参照（无 Vue 本体声明）· CSS 体系 D8 组合 · baseline 四 lane 导航 · 画廊总览 |
+
+```bash
+corepack pnpm studio:dev      # 起 dev server（生成产物先自动重建；遥测经 STORYBOOK_DISABLE_TELEMETRY 关闭）
+corepack pnpm studio:build    # 静态导出到 packages/studio/dist-storybook/（gitignore，可任意静态伺服）
+```
+
+生成器纪律：全部 MDX/stories 由 `packages/studio/scripts/lib/` 从 `catalog/archetypes` 与 `seeds/` 程序化生成（幂等可重放）；`generated/` 不入 git，入库的是生成器 + 配置 + 少量手写边界页。覆盖与幂等由 `packages/studio/tests/generators.spec.ts` 钉住（41/71/18/4 分母 + 双跑 diff 空）。画廊全程只读渲染既有锚定物料：NON-AUTHORITATIVE 声明在页头、零新增 catalog 物料（D6）、业务实体/业务组件零出现（G-D）。
+
 ## License
 
 POMaster 采用**双许可**发布（Owner 决议 2026-09-01）：