pomaster 0.3.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,11 +49,11 @@ 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.*>
-pomaster view blueprint/task
+pomaster view blueprint/task/attention/decision
 pomaster audit blueprint/task
 pomaster ledger record/list
 
@@ -56,23 +67,24 @@ pomaster closeout <task-id>
 
 # 横切 —— 对象检视 / 图视图 / Discovery / Research / Eval / Catalog / 迁移 / 生产反馈 / 多 Agent / 执行身份
 pomaster resolve "<need>" [--hints ...]
+pomaster new-entity check <governed-id> [--need ...]
 pomaster inspect <governed-id>
 pomaster graph <governed-id> [--view impact]
-pomaster brainstorm start/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>
 pomaster production band/evaluate/challenge/diagnose/metrics/self-improvement
-pomaster agents status
+pomaster agents status/dispatch-pack
 pomaster run <task>
 pomaster handoff <task> --to <role>
 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. 安装
@@ -102,31 +114,36 @@ 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 六区，25 目录 × 各带 README）+ `.pomaster/layout.json` 机器清单（全目录 status=wired + activation_hint——什么样的项目/需求激活该平面由 AI 按项目复杂度自行判断，目录存在 ≠ 已激活）。`--mode light` 与 heavy 的 `.pomaster/` 目录树**完全相同**（mode 只影响 skills/hooks 注入层）；canonical 正文层为 `.pomaster/truth/objects/`，legacy `.pomaster/objects/` 在场会被显式告警（禁静默 merge/覆盖/迁移）。完整规范见 `.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`）。
 
-**显式退回**：`pomaster init --mode light` 保留轻入口形态（细指针适配器，静态、无运行时依赖、无 hook 注入）；对已重入口项目执行时按平台清单移除上述安装物并重写入口文件回轻形态——重→轻可逆，不动人类文件。
-
 **多平台适配器**：`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 注册态 + 双镜像逐字节一致；light 退回形态报告 READY-符合预期）。
+**技术栈问卷与后补销账**（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）
 
 ```yaml
 version: 1
-profile: LIGHT            # 治理档位：MINIMAL | LIGHT | STANDARD
+profile: LIGHT            # 治理档位（信息性人类偏好，A1 裁定：不进判卷）：MINIMAL | LIGHT | STANDARD
 triage:
   ttl_hours: 168          # triage 结果有效期，过期必须 re-triage
 ```
 
-**profile 三档怎么选**：
+**profile 三档怎么选**（信息性人类偏好——A1 裁定 2026-09-04：档位只影响呈现与偏好记录，不进任何 gate/permit 判卷、不决定激活；激活由 context compile 的 lane/role/capability 机制承担）：
 
 | 档位 | 适合 | 体感 |
 |---|---|---|
@@ -174,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
@@ -370,16 +387,16 @@ Spec、Task、Gate、Knowledge、Brainstorm……全部是这五个原语的派
 ## 哲学宪法（违者即是 bug）
 
 - Small Constitution：硬约束极少而精——不伪造事实、不越权、不静默冲突、不无证据宣称完成
-- Heavy Entry by Default（D13 修订，2026-09-03）：入口即治理——init 默认安装 skills 库 + hooks 注入，Agent 开会话即见状态；轻入口是显式退回（`--mode light`），不是默认；hook 注入内容永远是 Canonical State 的投影，不是第二事实源
+- 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 棘轮，只升不降）
@@ -389,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）：

package/catalog/archetypes/archetype.frontend.error_taxonomy.json

@@ -3,10 +3,10 @@
   "kind": "archetype",
   "layer": "PATTERN",
   "title_zh": "前端错误分类",
-  "summary_zh": "前端错误九分型逐字闭包（PRD §21）：每型绑定呈现/重试/遥测/用户话术四语义位；浏览器原生信号只够两分，细分映射责任在 HTTP Client 适配层。",
+  "summary_zh": "前端错误十分型闭包（PRD §21 九分型 + Owner 2026-09-04 裁定补 CANCELED 第十分型）：每型绑定呈现/重试/遥测/用户话术四语义位；浏览器原生信号只够两分，细分映射责任在 HTTP Client 适配层。",
   "semantic": {
-    "responsibility": "把运行时错误归类为九分型闭包，驱动呈现/重试/遥测/话术四列的确定性处置",
-    "when_to_use": "任何触发 HTTP/异步调用的页面组契约错误处置面——错误到分型的映射在 HTTP Client 适配层完成（WHATWG fetch 原生只给 TypeError 与 HTTP status 两分，§21 九分型的映射责任不在浏览器）",
+    "responsibility": "把运行时错误归类为十分型闭包，驱动呈现/重试/遥测/话术四列的确定性处置",
+    "when_to_use": "任何触发 HTTP/异步调用的页面组契约错误处置面——错误到分型的映射在 HTTP Client 适配层完成（WHATWG fetch 原生只给 TypeError 与 HTTP status 两分，十分型的映射责任不在浏览器）",
     "when_not_to_use": "非错误态的加载/空态呈现；后端错误信封字段结构本身（v0.6.1 §44 Error Archetype 承载 type/title/status/detail/instance 等成员）"
   },
   "composition": {
@@ -57,6 +57,12 @@
       "telemetry": "timeout_event",
       "user_message": "请求超时，请重试"
     },
+    "CANCELED": {
+      "presentation_pattern": "cancelled_state_quiet_dismissal",
+      "retry_behavior": "never_retry_user_cancelled",
+      "telemetry": "cancel_event_aborted",
+      "user_message": "操作已取消"
+    },
     "OFFLINE": {
       "presentation_pattern": "offline_banner_persistent",
       "retry_behavior": "auto_resume_on_reconnect",
@@ -72,11 +78,13 @@
   },
   "constraints": [
     "浏览器原生信号只够两分：WHATWG fetch 网络失败 reject TypeError、HTTP 错误状态不 reject（查 Response.status）——TIMEOUT/OFFLINE/AUTHENTICATION 等细分全部依赖 client 适配层信号（axios code/AbortSignal/navigator.onLine/status 映射）",
-    "九分型映射责任在 HTTP Client Archetype 层而非浏览器",
+    "十分型映射责任在 HTTP Client Archetype 层而非浏览器",
+    "CANCELED 第十分型（Owner 2026-09-04 裁定）：axios ERR_CANCELED / fetch AbortError / TanStack cancelQueries 三源业界共识——用户主动取消绝不自动重试，呈现为安静取消态而非错误横幅（九分型缺位会把取消误归 UNKNOWN/TRANSPORT）",
+    "429 归重试处置（Owner 2026-09-04 裁定注记）：ofetch 默认重试列表含 409/429 视作传输层瞬时错误——429 不归 CONFLICT 分型，按 retryable 瞬时处置；409 仍归 CONFLICT（语义张力如实登记）",
     "RFC 9457 about:blank（未给出更具体类型时的缺省）与 UNKNOWN 同构"
   ],
   "x-research-anchors": {
-    "note": "【待 Owner 裁定·差异表 #8 两项】①是否补 CANCELED 第十分型（axios ERR_CANCELED/fetch AbortError/TanStack cancelQueries 三处业界共识，retry 语义绝不重试——九分型缺位会把取消误归 UNKNOWN/TRANSPORT）②429 归属（ofetch 默认重试列表含 409/429 视作传输层瞬时错误，与 CONFLICT 语义有张力）——本物料保持九分型不扩，待裁定后走词汇表式修订。WHATWG fetch TypeError/RFC 9457 成员空间/axios error codes 全表/ofetch 重试列表为规范与官方文档 2026-09-03 实抓",
+    "note": "【已裁定 2026-09-04·差异表 #8 两项】①补 CANCELED 第十分型（九→十）：axios ERR_CANCELED/fetch AbortError/TanStack cancelQueries 三处业界共识，retry 语义绝不重试——已入 categories 且四列绑定齐全；②429 归重试处置：ofetch 默认重试列表含 409/429 视作传输层瞬时错误，429 不归 CONFLICT、按 retryable 瞬时处置注记入 constraints。WHATWG fetch TypeError/RFC 9457 成员空间/axios error codes 全表/ofetch 重试列表为规范与官方文档 2026-09-03 实抓",
     "sources": [
       {
         "url": "https://fetch.spec.whatwg.org/",

package/catalog/archetypes/archetype.frontend.feature_oriented.json

@@ -44,7 +44,7 @@
     "自造新层（FSD：层语义已标准化，不推荐新增）"
   ],
   "x-research-anchors": {
-    "note": "【差异表 #4 部分差异】FSD 现行 7 层（Processes deprecated→有效 6 层）、无独立 API 层（api 是 segment）、widgets 无 PRD 对应、app 层 PRD 未纳入——四行声明随物料落位；import rule 严格向下与 Public API「contract+gate」定位（与 PRD §19 public_api_required 同构）为 feature-sliced.design 官方文档（v3 站点）2026-09-03 实抓",
+    "note": "【已裁定 2026-09-04·差异表 #4】FSD v2 现行映射采纳（六有效层 + Processes deprecated + api 是 segment）：上述 defaults 四行声明即裁定正文——FSD 现行 7 层（Processes deprecated→有效 6 层）、无独立 API 层（api 是各层 segment）、widgets 无 PRD 对应层（optional 位）、app 层为 FSD v2 新增有效层；import rule 严格向下与 Public API「contract+gate」定位（与 PRD §19 public_api_required 同构）为 feature-sliced.design 官方文档（v3 站点）2026-09-03 实抓",
     "sources": [
       {
         "url": "https://feature-sliced.design/docs/reference/layers",

package/catalog/archetypes/archetype.state.async_command.json

@@ -3,10 +3,10 @@
   "kind": "archetype",
   "layer": "PATTERN",
   "title_zh": "异步命令状态机",
-  "summary_zh": "以 XState v5 六概念（state/event/transition/guard/actor/input/output）承载的异步命令原型：命令参数经 input 进入，状态经 guarded transition 确定性转移，final state 产出 output；非法组合经 transition contract 显式声明（实现侧绑定 state.can() 守卫位）。",
+  "summary_zh": "以 XState v5 六概念（state/event/transition/guard/actor/input/output）承载的异步命令原型：命令参数经 input 进入，状态经 guarded transition 确定性转移，final state 产出 output；非法组合可检测——未声明 transition 不存在（XState v5 运行时静默忽略），state.can() 守卫为唯一预检位（Owner 2026-09-04 裁定差异表 #7）。",
   "semantic": {
     "responsibility": "把一次异步命令（提交/保存/执行）建模为显式状态机：idle/running/done|error 转移全部声明在案，guard 纯同步布尔",
-    "when_to_use": "命令的合法状态转移需要显式契约时（非法组合必须可表达为「未声明的 transition 不存在」）；多步骤异步编排（invoke/spawn actor）",
+    "when_to_use": "命令的合法状态转移需要显式契约时（非法组合可检测：「未声明的 transition 不存在」——XState v5 对未匹配事件静默忽略，state.can() 守卫预检）；多步骤异步编排（invoke/spawn actor）",
     "when_not_to_use": "远端取数缓存语义（STATE_ARCHETYPE.SERVER_QUERY）；无需显式转移契约的局部加载布尔"
   },
   "composition": {
@@ -33,10 +33,10 @@
   "forbidden": [
     "在 output 语义位放中途产物（output 仅到达 final state 时存在）",
     "直接改 context（immutable，仅 assign 更新）",
-    "断言未匹配事件会运行时报错（XState v5 现实是静默忽略+state.can() 为 false——非法组合的表达位是 transition contract 声明与 can() 守卫位）"
+    "断言未匹配事件会运行时报错（XState v5 现实是静默忽略+state.can() 为 false——非法组合的可检测位是 transition contract 声明与 can() 守卫预检，Owner 2026-09-04 裁定）"
   ],
   "x-research-anchors": {
-    "note": "【待 Owner 裁定·差异表 #7】PRD「Illegal Transition 必须可表达」在 XState v5（npm 5.32.6）无对应词形：未匹配/未启用事件=「no enabled transition → state does not change」静默忽略，state.can() 显式守卫为唯一查询位。本物料落 PRD 语义意图（非法组合经 transition contract 显式声明）+实现绑定注记 can() 守卫位；是否以治理层概念保留 Illegal Transition 词形待裁定。六概念词形与 guard 序列化命名推荐（reusability+visualization）均为 stately.ai 官方文档 2026-09-03 实抓",
+    "note": "【已裁定 2026-09-04·差异表 #7】Illegal Transition 不引入治理层词形：XState v5（npm 5.32.6）对未匹配/未启用事件按「no enabled transition → state does not change」静默忽略，state.can() 显式守卫为唯一预检位——PRD「非法组合必须可表达」由「可检测（transition contract 声明 + state.can() 守卫预检）」承载。六概念词形与 guard 序列化命名推荐（reusability+visualization）均为 stately.ai 官方文档 2026-09-03 实抓",
     "sources": [
       {
         "url": "https://stately.ai/docs/transitions",