@xulthekl/team-flow 0.63.0 → 0.65.0

package/.claude/always/phase-guard.md

@@ -1,3 +1,3 @@
-# team-flow v0.63.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.65.0 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "team-flow",
       "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback + independent business analysis. 28 skills + 17 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.63.0",
+      "version": "0.65.0",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + design-system (design tokens + component contract + AI primer + showcase) + test-strategy (test strategy design) + project-initialize (new service onboarding) + jarvis (team-flow decision agent, opt-in). 28 skills + 17 agents, one install.",
   "source": "./",
   "author": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
   "author": {
     "name": "MageByte",

package/.cursor-plugin/marketplace.json

@@ -5,7 +5,7 @@
   },
   "metadata": {
     "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.63.0"
+    "version": "0.65.0"
   },
   "plugins": [
     {

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "team-flow",
   "displayName": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + jarvis (team-flow decision agent, opt-in). 28 skills + 17 agents, one install.",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "author": {
     "name": "LT",
     "url": "https://github.com/LT"

package/.github/plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.63.0"
+    "version": "0.65.0"
   },
   "plugins": [
     {
       "name": "team-flow",
       "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, independent business analysis, and local HTML prototyping.",
-      "version": "0.63.0",
+      "version": "0.65.0",
       "source": ".",
       "author": {
         "name": "LT",

package/.github/workflows/ci.yml

@@ -24,6 +24,7 @@ jobs:
       - run: npm ci
       - run: npm run build
       - run: npm test
+      - run: npm run test:e2e
       - name: Check version consistency
         run: node scripts/check-version-consistency.mjs
       - name: CLI smoke
@@ -83,6 +84,7 @@ jobs:
       - run: npm ci
       - run: npm run build
       - run: npm test
+      - run: npm run test:e2e
       - name: Check version consistency
         run: node scripts/check-version-consistency.mjs
       - name: Token efficiency lint (warning only)

package/CHANGELOG.md

@@ -4,6 +4,63 @@ All notable changes to `team-flow` will be documented in this file.
 
 The format loosely follows Keep a Changelog.
 
+## [0.65.0] - 2026-09-25
+
+### Added（DDD 纯度 + 架构回写机制重构：O1–O9 全量落地；设计 = docs/plan/ddd-purity-and-arch-merge-design.md v1.5，P1.5 完整档 3 轮闭合 + 三批 P3/P4 独立评审全处置）
+
+**O8 · 回写机制两段式重构（本版核心，registry 持久化 + 软着陆双路径）**
+- 新增 `scripts/lib/arch-registry.mjs`：`docs/architecture/.registry/registry.json` 唯一存储（JSON·固定键序·零依赖可重放）；schema 五段冻结（aggregates 含 `events[]`、bounded_contexts 含 `context_map[]`——O4/O7 登载体预置；subdomains 含 Core/Supporting/Generic；source 全段必填 `base|change:<name>`）；delta 四 op 匹配矩阵（new/extend/refactor/retire；retire 不删行置 status+reason；违约分流软着陆 WARN / 硬切 violation）；**save 前 validate fail-closed**（写不出好过写出坏文件）+ 内容级幂等（时间戳不刷不写盘）。
+- `arch-merge` 双路径：`.arch-delta.json` 存在 → **seed 先于 delta**（首跑自动 seed：closed changes 聚合 + 快照 + schema-baseline 表 + API-INDEX 端点，红牌 12）→ schema 校验（结构错 abort、evidence 类软着陆 WARN）→ registry 落盘 → **四生成式改源**（PHYSICAL-MODEL/DATABASE/API-INDEX/INDEX ← registry，R-b 修复；schema-baseline.sql 保留单向 append 兼容）；缺失 → legacy 重算路径 + 显式登记（v0.66.0 硬切）。**物理事实机械补种**（本次 DDL 表 / 扫描端点 / current 聚合 → 补 + WARN 不静默）与**语义意图只经 delta** 分界。
+- `touchedFiles` 白名单追加 `.registry/`（登记永不 commit 修复）；守恒断言 C2（B 级下界，有触发正例）/C3（半级）挂 merge；C4 运行时与 doctor 维度归 M1–M3 存量迁移批（待授权）。
+- release-archivist 新增 **①-pre 语义段**（delta 产出纪律：evidence/reason 必填两类别、补种边界、R3-3、软着陆→硬切时点）；planned ⚠ 块回指。
+- 守卫横展：SKIPPED 物化**双形态识别**（新规范 `SKIPPED.md` + 存量 `SKIPPED`——arch-readiness/arch-snapshot/cmd-doctor 同步，防新规范卡死硬门）。
+
+**O4/O5/O6/O7 · 设计层模板**
+- O4 事件 schema 版本策略门禁（产品级 §3.2：major/minor/tombstone + 必填版本字段 → 评审阻塞 + 消费侧 upcasting）+ 变更级模板 §2.5 独立领域事件表（schema 版本/兼容级别列）。
+- O7 Context Map **6→经典 8 模式**（+Partnership +Published Language）+ 新 `references/context-map-8.md`（模式表 + 决策流 Mermaid + CML NO-GO）；ch04 F5 / SKILL F5 / 产品级枚举四处同步（教=用）。
+- O5 新 `references/ddd-evented-playbook.md`（Saga 补偿矩阵 / Projection 重建 staging 优先 / 幂等键；设计层 ONLY 不生成代码）。
+- O6 新 `references/adr-templates.md`（MADR/轻量/Y-Statement/废弃/RFC 五模板 + 三条件防泛滥 + replan_log 可机读唯一落点，不另起 `docs/adr/`）；架构修订决策门接入。
+
+**O1 · DDD 深度 advisory**
+- SKILL 判定链新增 advisory 段（五项检查之前；领域复杂度三判据、禁 4 选 2 硬阈值）+ 结构化输出契约 `ddd_depth: full|lightweight` 与 `decision` **正交**（任意组合合法、禁推导）；**红牌 `lightweight ≠ skipped` + 第 4/5 项（API/DB）不短路**；两条规则文本 lint 测试锁定（明示非行为护栏）。
+
+**O2/O3 · 战略层（前批）+ O9 可读性**
+- 产品级模板 §0 per-BC 统一语言索引（无定义列防第三真相源，唯一内容写入点 `docs/architecture/CONCEPTS.md`）+ §1 拆 1.1 子域（问题空间投资分级）/1.2 限界上下文（解空间）；ch04 子域节、ch06 CONCEPTS 维护（两段拆分 + 主动纪律）、glossary 区分。
+- O9 变更级模板 frontmatter 5 必填（mode/provenance/as_is_anchor/iteration_version/product_snapshot）+ 设计意图前置（首屏 ≤10 行）/证据下沉 evidence/ 纪律 + SKIPPED 命名统一 `.md`。
+- **C4 代码注解扫描**（`tf arch scan-code`，唯一 A 级锚；emp-auth 只读实测 count=56 与 baseline 逐项吻合）+ P0-B' 快照只读 seed（provenance 分档仅 reverse-engineered，修投影域丢基线）。
+
+**测试**：`npm test` 1237 → **1343**（+106：registry 24 / arch-merge O8 e2e+seed 16 / arch-template 31 / C4 28 等）+ `test:e2e` 103 全绿；反向验证 ×9；`lint:skills` 87/7 与基线逐条同。P3/P4：三批独立评审（P0-B' 2I+5m、P0-A 1C+2I+6m、全并段 3C+8I+6m）全部处置闭合；plugin-validator/skill-reviewer 双门禁过。
+
+**行为变更**：① 带 delta 的 change 走 registry 路径（旧 change 无 delta 自动 legacy，零破坏）② `tf arch scan-code` 新命令（退出码恒 0，status=na/partial ≠ PASS）③ skip 物化新规范 `SKIPPED.md`（存量 `SKIPPED` 门禁仍识别）。**软着陆**：delta 缺失合法、v0.66.0 硬切（退出条件 = legacy 登记数归零 + 存量 change 清仓）。
+
+## [0.64.0] - 2026-09-24
+
+### Added（spec-superflow 2.0 同步：双前门 + 轻路径 + 轻量全局态闸门；设计 = docs/plan/spec-superflow-2.0-implementation-plan.md v2.1，P1.5 两轮独立评审 13+13 组全闭合）
+
+**双前门（`workflow_variant` 与 `workflow` 正交）**
+- direct（→`quick`）：零文档零契约，`exploring→approved-for-build→executing→closing` 捷径；planned（→`full`）：proposal+tasks 两份 + `tf execution plan --derive`（tasks.md 派生单 wave，免 recommend/receipt/DP-4）+ 一次最终审查。
+- legacy/null 走既有全量流程零破坏（null≡legacy + TTY 单次提示 / headless 不挂起）；`workflow` 枚举扩为五值（+`quick`/`lightweight`）。
+- 新子命令：`tf state upgrade <dir> <planned|full>`（升档唯一机械入口：方向向上 + `variant_source=upgrade` + 回退 approved-for-build + 重算 hash；**降档拒绝**）。
+- 新 CLI 参数：`tf execution plan --derive`、`tf arch-merge --light`、`tf test-merge --light`（changelog 归因锚 `change:<name>`）、guard `--workflow-variant`/`--planned-arch`。
+
+**11 个新 guard 维度（CHECK_RUNNERS 20→31）+ 共享扫描层**
+- `surface-scan.mjs`：三源合并（committed diff + 工作区 + untracked）+ `base_sha` 基线（缺省 origin merge-base，再缺 fail-closed）+ 架构 surface 路径模式表 + `.team-flow/aggregate-dirs.txt` 聚合清单（**缺失 FAIL，显式空文件 = 确认无聚合**）+ `.team-flow/scan-ignore` 排除。
+- direct 侧：`direct-short-path`（碰 API/DB/聚合 → FAIL+升档指引，G1）、`direct-test-result`/`lightweight-completion-evidence`（只读 `tf test record` 程序化证据，guard 不现场跑测试）。
+- planned 侧 closing「轻回写四灯」：`arch-merged-light`（同 sink：最小 architecture.md/api.md/database.md 持久源 + 全局台账 `change:<name>` 归因）、`compound-writeback-light`（禁 `compound_skipped` 自清）、`test-merged-light`、`cross-change-consistency-light`（**确定性扫描 runner**，语义级仍由 checker agent 兜底）+ `execution-reviews-passed-light`（≥5 行内容契约）+ `artifacts-planned`（proposal≥10 行 + checkbox，反空壳）+ `arch-design-light`/`arch-snapshot-light`（`planned_arch=true` 条件挂载）。
+- 既有 4 维加轻分支：`test-matrix-ready/complete` 无契约轻判据（D4）、`execution-plan-ready` planned 豁免 DP-4、`specs-merged` planned 无 specs 即过/有 specs 无 delta 头 FAIL。
+
+**状态机 schema（三环齐全）**
+- `workflow_variant` / `variant_source` / `variant_direction` / `planned_arch` / `model_profile`（接入既有 `models` 键四档，非新配置）/ `base_sha` / `arch_design_light_skipped(+reason)`；`workflow_variant` 经 `tf state set` 通用通道**仅 exploring 态可写**。
+
+**SKILL 层**
+- workflow-start：Front Doors 三分支路由 + infer 双通道（`suggested_path` 绝不写入 workflow；arch 信号→建议 planned 而非 full）+ 架构门/Guardrails 按 variant 分叉（direct/planned 结构性不经 `exploring:specifying`，Q3 零代码满足的限定条件落地）。
+- release-archivist：关门序列按 variant 三分叉（planned 回写+审查全前置、transition 最后——防 closing 维度死锁；direct 仅 transition）+ Verdict 新增 **ACCEPTED-RISK**（仅非 guard 维度、禁自判、不伪造通过、不自动合并）。
+- jarvis/session-handoff：variant 回显；test-strategy/clean-code description 收紧（§3.8 静态复核）。
+
+**测试（npm test 1237 + test:e2e 103 全绿；CI 补 `npm run test:e2e` 步骤）**
+- `light-paths.test.mjs`（21 用例，每新维度正/负例）、`light-merge-survival.test.mjs`（D8 same-sink 存活三断言：marker 聚合行 + 演进归因 + API 端点经 full merge 存活）、`light-pilot.test.mjs`（P7 双路径真实 CLI 全链 + 升档/禁降档试点）。
+- e2e test-matrix 登记 L1–L5。
+
 ## [0.63.0] - 2026-09-23
 
 ### Added（sop-flow 效率八项改进 S1–S6 + E1/E2；来源：emp-auth workflow-feedback 20260923-013114，经 308 行独立专家评审定稿）

package/GEMINI.md

@@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r
 
 
 <!-- team-flow-phase-guard-start -->
-# team-flow v0.63.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.65.0 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
 <!-- team-flow-phase-guard-end -->

package/INSTALL.md

@@ -7,7 +7,7 @@
 - [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎（Schema 验证、Delta Spec、工件解析）
 - [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律（TDD 铁律、SDD、系统化调试、代码审查）
 
-当前发布版本：**v0.63.0**。
+当前发布版本：**v0.65.0**。
 
 ---
 

package/README.md

@@ -1,6 +1,6 @@
 # team-flow
 
-> 当前版本：`v0.63.0`
+> 当前版本：`v0.65.0`
 
 > 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，十三套能力协同（详见下文「十三套能力」）。
 

package/agents/architecture-design.md

@@ -87,7 +87,7 @@ artifacts:                       # required: list of produced files, skipped: em
   - architecture/sql/migration/...
 
 # product 模式（v0.36.0）
-decision: completed | skipped    # completed: 8 步设计完成；skipped: 迭代无结构性变更（须物化 SKIPPED 标记）
+decision: completed | skipped    # completed: 8 步设计完成；skipped: 迭代无结构性变更（须物化 SKIPPED.md 标记；存量 SKIPPED 亦识别）
 reason: "..."
 snapshot_path: docs/architecture/iterations/vN/architecture.md
 verdict: pending_review          # 评审门（architecture-reviewer product 视角）在产出后进行

package/agents/architecture-reviewer.md

@@ -37,13 +37,13 @@ If change_brief_path or architecture_dir is missing or unreadable **in change mo
 `review_mode: product` 时（S3.5 产品级评审门），审查对象与维度适配变化：
 
 - **审查对象**：`product_snapshot_path`（`docs/architecture/iterations/vN/architecture.md`，6 产物：Context Map / 聚合注册表 / 指令事件 / 状态机 / 概念 ER / 时序）+ `domains/` 按域详细页；**不审查** change 内三件套。
-- **A1**：6 产物章节存在 + marker 成对 + anchor id 可解析（机械预检）；**不执行** change 模式的 `test -f architecture/{architecture,database,api}.md`。
+- **A1**：6 产物章节存在 + **§0 统一语言索引**（存在、per-BC 分列、表头无「定义/含义」列 —— O2 判据①②；唯一内容写入点=docs/architecture/CONCEPTS.md）+ **§1.1 子域段**（存在、与 §1.2 BC 段物理分离、每行有 Core/Supporting/Generic 分类**且业务问题列非空** —— O3 判据①②；子域描述不含 `Service`/`Impl`/包名类实现载体词 = 反例校验 O3-③）+ marker 成对 + anchor id 可解析（机械预检）；**不执行** change 模式的 `test -f architecture/{architecture,database,api}.md`。**日期锚门控（§4.0 纪律 1，存量不追溯）**：快照 `established_at` < 2026-09-25，**或 `established_at` 缺失/不可解析** → 缺 §0 / §1.1 记 **WARN 不 FAIL**。
 - **A2**：SQL/结构有效（若快照含 sql/ 引用；机械 grep）。
 - **A3**：对照 `references/s3.5-architecture-template.md`（产品级模板），非 `templates/architecture.md`（变更级模板）。
 - **A4**：对照 PRD 功能清单（F001_P0 逐条）→ BC/聚合/API 全覆盖映射；对照源是 PRD（非 change-brief——change-brief 是变更级输入）。
 - **A5**：旧项目逆向重建场景对照现状代码/全局基线；正向设计场景仅检查与既有基线无矛盾。
 - **A6**：conventions 合规（同 change 模式）。
-- **skip 处理**：S3.5 显式跳过（`iterations/vN/SKIPPED` 标记）时本 agent 不执行。
+- **skip 处理**：S3.5 显式跳过（`iterations/vN/SKIPPED.md` 标记；存量无扩展名 SKIPPED 亦识别）时本 agent 不执行。
 - **报告落盘**：product 模式评审报告落盘 `docs/architecture/iterations/vN/auto-review.md`（非 `changes/<name>/architecture/auto-review.md`——product 模式无 change 目录）。
 
 ## 6-Dimension Checklist

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.63.0`
+- Current: `v0.65.0`
 - v0.9.1 highlights: DP-4 execution-mode recommendations, a portable runtime across 17 platforms, and a raw-package smoke with no plugin-root variable.
 - Self-contained — no OpenSpec or Superpowers runtime required
 - Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)

package/docs/state-machine.md

@@ -112,6 +112,8 @@ eight core states.
   exploring ──── hotfix ─────────> bridging          (fast-path)
   bridging  ──── hotfix ─────────> approved-for-build
   exploring ──── tweak ──────────> approved-for-build (fast-path)
+  exploring ──── quick/lightweight ─> approved-for-build > executing > closing   (direct 前门, v0.64.0)
+  exploring ──── full+planned ───> approved-for-build > executing > closing     (planned 前门, v0.64.0)
 
   exploring -> specifying -> bridging -> approved-for-build -> executing -> closing
                 ^              ^             |                 ^    |
@@ -159,4 +161,5 @@ If the contract changed, the artifacts changed.
 - `hotfix` follows `exploring -> bridging -> approved-for-build -> executing`.
 - `hotfix` may skip full planning artifacts such as `proposal.md`, `design.md`, and `specs/`; `tasks.md` requires an explicit `tasks_skipped=true` + `tasks_skip_reason` (v0.22 §85) rather than a silent skip. The key is rejected for `full`/`auto` workflows — declare the mode first (`tf state set <dir> workflow hotfix|tweak`) or produce `tasks.md`.
 - `hotfix` still requires a fresh minimal `execution-contract.md` and explicit DP-3 approval before implementation.
-- `tweak` remains the only path that can jump directly from `exploring` to `approved-for-build`.
+- `tweak` is **no longer the only** path from `exploring` to `approved-for-build` (v0.64.0)——`quick`/`lightweight`（direct 前门）与 `full`+`workflow_variant=planned`（planned 前门）同样走该捷径，维度表分别由 `QUICK_TRANSITION_CHECKS` / `PLANNED_TRANSITION_CHECKS` 管辖（见 workflow-start SKILL「Front Doors」与 guard.mjs）。`workflow_variant` 与 `workflow` 是两个正交维度：direct→`quick`、planned→`full`，**不是 workflow 取值**。
+- 升档唯一机械入口 `tf state upgrade <dir> <planned|full>`（方向向上 + `variant_source=upgrade`；降档拒绝）。`executing → debugging → executing` 对 quick/planned 按档分支（direct: `direct-test-result`；planned: `execution-plan-ready`+`tests-passing`），**不回落 full 表**。

package/docs/team-flow /344/275/277/347/224/250/350/257/264/346/230/216/357/274/210/347/240/224/345/217/221/345/233/242/351/230/237/347/211/210/357/274/211.md"

@@ -1,6 +1,6 @@
 # team-flow 使用说明（研发团队版）
 
-> 版本锚点：v0.63.0（28 skills + 17 agents）· 更新日期：2026-09-21
+> 版本锚点：v0.65.0（28 skills + 17 agents）· 更新日期：2026-09-21
 > 读者：使用 team-flow 做日常研发的工程师。不需要你懂插件内部实现，只需要照着路径走。
 > 配套文档：安装细节见 [INSTALL.md](../INSTALL.md)；状态机细节见 [state-machine.md](state-machine.md)；决策点细节见 [decision-points.md](decision-points.md)；平台差异见 [platform-matrix.md](platform-matrix.md)。
 
@@ -232,7 +232,7 @@ workflow-start 在初始化时自动推断（`tf runtime infer`），你也可
 tf runtime guard check <change-dir> <from-state> <to-state> [--workflow full|hotfix|tweak]
 ```
 
-**full 模式的完整转换矩阵**（20 个维度 + 1 个 workflow 限制维度）：
+**full 模式的完整转换矩阵**（31 个维度 + 1 个 workflow 限制维度；v0.64.0 增 quick/lightweight/planned 轻路径 11 维）：
 
 | 转换 | 维度 |
 |------|------|

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML) + business-analysis (independent requirement/scenario artifact) + jarvis (team-flow decision agent, opt-in). 28 skills, one install.",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# v0.63.0: auto-sync CLI version with plugin version
+# v0.65.0: auto-sync CLI version with plugin version
 set -e
 
 # ═══════════════════════════════════════════════════════════════
 # Plugin version (update this when releasing new versions)
 # ═══════════════════════════════════════════════════════════════
-PLUGIN_VERSION="0.63.0"
+PLUGIN_VERSION="0.65.0"
 
 # ═══════════════════════════════════════════════════════════════
 # Step 1: Auto-sync CLI version with plugin version

package/llms.txt

@@ -3,7 +3,7 @@
 ## Overview
 spec-superflow is a self-contained workflow integration plugin for Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, and Trae. It merges spec-driven planning artifacts (proposal, specs, design, tasks) with disciplined execution guardrails (TDD, review gates, controlled handoff) into one unified workflow.
 
-Current version: v0.63.0.
+Current version: v0.65.0.
 
 ## Key Documents
 - README.md: Chinese homepage with full usage guide and FAQ

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "description": "Unified plugin (28 skills + 17 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback, business-analysis for multi-agent coding tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + design-system (design tokens + component contract + AI primer + showcase) + test-strategy (test strategy design) + project-initialize (new service onboarding) + jarvis (team-flow decision agent, opt-in). 28 skills + 17 agents, one install.",
   "author": {
     "name": "LT"

package/scripts/guard/checks/_fs-utils.mjs

@@ -0,0 +1,18 @@
+// scripts/guard/checks/_fs-utils.mjs — light check 共享的文件系统小工具
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** 递归扫描 dir 下所有 .md，文件名或内容任一含 needle 即 true（dir 不存在 → false） */
+export function filesContainDir(dir, needle) {
+  if (!existsSync(dir)) return false;
+  const entries = readdirSync(dir, { recursive: true, withFileTypes: true });
+  for (const e of entries) {
+    if (!e.isFile() || !/\.md$/i.test(e.name)) continue;
+    if (e.name.includes(needle)) return true;
+    const parent = typeof e.parentPath === 'string' ? e.parentPath : dir;
+    try {
+      if (readFileSync(join(parent, e.name), 'utf-8').includes(needle)) return true;
+    } catch { /* skip unreadable */ }
+  }
+  return false;
+}

package/scripts/guard/checks/arch-design-light.mjs

@@ -0,0 +1,39 @@
+// scripts/guard/checks/arch-design-light.mjs — 轻架构说明（§4，可选维度）
+// v0.64.0：挂 planned 且 planned_arch=true（exploring→approved-for-build / approved-for-build→executing）。
+// 判据：architecture/light-note.md 存在非空，或显式 skip-with-reason（arch_design_light_skipped
+// + arch_design_light_skip_reason 两键齐全）。不要求 4A+DDD 全套 + 契约 + DP。
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { readState } from '../../lib/state-loader.mjs';
+
+export function checkArchDesignLight(changeDir) {
+  const state = readState(changeDir);
+
+  if (state.arch_design_light_skipped === 'true') {
+    const reason = (state.arch_design_light_skip_reason || '').trim();
+    if (!reason || reason === 'null') {
+      return {
+        pass: false,
+        failures: ['arch_design_light_skipped=true but no skip reason — set arch_design_light_skip_reason via tf state set'],
+      };
+    }
+    return { pass: true, failures: [], reason: `skipped: ${reason}` };
+  }
+
+  const notePath = join(changeDir, 'architecture', 'light-note.md');
+  if (!existsSync(notePath)) {
+    return {
+      pass: false,
+      failures: [
+        'architecture/light-note.md missing — write a short light architecture note '
+        + '(touched surfaces, key decisions; no 4A+DDD suite needed), or skip explicitly: '
+        + 'tf state set <dir> arch_design_light_skipped true + arch_design_light_skip_reason "<reason>"',
+      ],
+    };
+  }
+  const content = readFileSync(notePath, 'utf-8').trim();
+  if (!content) {
+    return { pass: false, failures: ['architecture/light-note.md is empty — write the light architecture note'] };
+  }
+  return { pass: true, failures: [] };
+}

package/scripts/guard/checks/arch-gate-exemptions.mjs

@@ -61,13 +61,15 @@ export function findLatestIterationDir(root) {
 }
 
 /**
- * skip 物化检查：只认最新迭代目录的 SKIPPED（v0.36.3 修复——防旧迭代陈旧标记
+ * skip 物化检查：只认最新迭代目录的 skip 标记（v0.36.3 修复——防旧迭代陈旧标记
  * 错误豁免新迭代的结构性变更，P3 原则要防的失效模式）。
+ * ★ 命名双形态识别（P3 C-3 / O9 B8）：写侧新规范统一 `SKIPPED.md`（s3.5 SOP + orchestrator），
+ *   存量有无扩展名 `SKIPPED`（emp-auth v2/v3）——读侧两态皆认，防新规范物化后门禁不可见卡死。
  */
 export function isArchSkipMaterialized(root) {
   const latest = findLatestIterationDir(root);
   if (!latest) return false;
-  return fs.existsSync(path.join(latest, 'SKIPPED'));
+  return fs.existsSync(path.join(latest, 'SKIPPED.md')) || fs.existsSync(path.join(latest, 'SKIPPED'));
 }
 
 /** 最近一个迭代的产品级架构快照路径（iterations/<latest>/architecture.md）。不存在 → null。 */
@@ -80,4 +82,4 @@ export function findLatestIterationSnapshot(root) {
 
 export const ARCH_READINESS_FAIL_HINT =
   'iterations/<vN>/architecture.md missing — 回 ARCH 阶段补快照，'
-  + '或显式 skip 物化（iterations/<vN>/SKIPPED 标记 + 理由）';
+  + '或显式 skip 物化（iterations/<vN>/SKIPPED.md 标记 + 理由；存量 SKIPPED 亦识别）';

package/scripts/guard/checks/arch-merged-light.mjs

@@ -0,0 +1,67 @@
+// scripts/guard/checks/arch-merged-light.mjs — 架构台账轻回写（§4，非 negotiable 底线）
+// v0.64.0（D8/D10）：
+// - 无架构 surface → 过（G4）
+// - 有 surface → 最小持久源齐（architecture.md 必产；触及 API/DB 另需 api.md/database.md）
+//   + 全局台账（docs/architecture/**）含归因 `change:<name>`（归因锚 = 扫描 + 条目，非快照）
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readState } from '../../lib/state-loader.mjs';
+import { scanArchitectureSurface } from '../../lib/surface-scan.mjs';
+
+function filesContain(dir, needle) {
+  if (!existsSync(dir)) return false;
+  const entries = readdirSync(dir, { recursive: true, withFileTypes: true });
+  for (const e of entries) {
+    if (!e.isFile() || !/\.md$/i.test(e.name)) continue;
+    const parent = typeof e.parentPath === 'string' ? e.parentPath : dir;
+    try {
+      if (readFileSync(join(parent, e.name), 'utf-8').includes(needle)) return true;
+    } catch { /* skip unreadable */ }
+  }
+  return false;
+}
+
+function minSourceOk(changeDir, rel) {
+  const p = join(changeDir, 'architecture', rel);
+  return existsSync(p) && readFileSync(p, 'utf-8').trim().length > 0;
+}
+
+export function checkArchMergedLight(changeDir) {
+  const state = readState(changeDir);
+  const changeName = state.change_name || changeDir.split('/').filter(Boolean).pop();
+  const scan = scanArchitectureSurface(changeDir, state);
+
+  if (scan.error === 'no-baseline' || scan.error === 'diff-failed') {
+    return { pass: false, failures: [`surface scan failed (${scan.error}) — cannot verify ledger writeback, fail-closed`] };
+  }
+  if (scan.error === 'aggregate-list-missing') {
+    return {
+      pass: false,
+      failures: ['aggregate list missing (.team-flow/aggregate-dirs.txt) — cannot classify architecture surface, fail-closed'],
+    };
+  }
+
+  if (scan.architectureSurface.length === 0) {
+    return { pass: true, failures: [], reason: 'no architecture surface touched — ledger writeback N/A (G4)' };
+  }
+
+  const failures = [];
+  // D8 最小持久源：architecture.md 必产（聚合注册行 + 演进日志段 = marker 区投影输入）
+  if (!minSourceOk(changeDir, 'architecture.md')) {
+    failures.push('changes/<name>/architecture/architecture.md missing/empty — minimal persistent source required (aggregate lines + ### change:<name> evolution entry); run the light arch writeback');
+  }
+  if (scan.apiFiles.length > 0 && !minSourceOk(changeDir, 'api.md')) {
+    failures.push('API surface touched but architecture/api.md missing/empty — minimal endpoint delta required (feeds arch-merge rebuild)');
+  }
+  if (scan.dbFiles.length > 0 && !minSourceOk(changeDir, 'database.md')) {
+    failures.push('DB surface touched but architecture/database.md missing/empty — minimal schema delta required');
+  }
+
+  const anchor = `change:${changeName}`;
+  const globalLedger = join(scan.projectRoot, 'docs', 'architecture');
+  if (!filesContain(globalLedger, anchor)) {
+    failures.push(`global ledger (docs/architecture/**) has no '${anchor}' attribution — run: tf arch-merge --light <change-dir>`);
+  }
+
+  return failures.length ? { pass: false, failures } : { pass: true, failures: [] };
+}

package/scripts/guard/checks/arch-readiness.mjs

@@ -3,7 +3,7 @@
 //
 // 规则：
 // - arch_baseline == null（存量/重建未完成）→ PASS + WARN（不阻断，项目级豁免，P3 留逃生舱）
-// - skip 已物化（iterations/vN/SKIPPED）→ PASS
+// - skip 已物化（iterations/vN/SKIPPED.md；存量 SKIPPED 亦识别——双态见 arch-gate-exemptions）→ PASS
 // - iterations/<latest>/architecture.md 存在 → PASS
 // - 否则 → FAIL，引导回 ARCH 补快照或显式 skip
 import {

package/scripts/guard/checks/arch-snapshot-light.mjs

@@ -0,0 +1,30 @@
+// scripts/guard/checks/arch-snapshot-light.mjs — 轻架构快照（§4，条件维度）
+// v0.64.0（D10 裁决）：仅当 light-note 产出时需要快照（供演进日志 diff 展示）；
+// arch-merged-light 的归因锚 = 扫描 + 台账条目，不依赖本快照——无 note / 已 skip → N/A 通过。
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { readState } from '../../lib/state-loader.mjs';
+
+export function checkArchSnapshotLight(changeDir) {
+  const state = readState(changeDir);
+
+  const notePath = join(changeDir, 'architecture', 'light-note.md');
+  const hasNote = existsSync(notePath) && readFileSync(notePath, 'utf-8').trim().length > 0;
+  const skipped = state.arch_design_light_skipped === 'true';
+
+  if (!hasNote || skipped) {
+    return { pass: true, failures: [], reason: 'no light architecture note — snapshot N/A (D10: anchor is scan+ledger, not snapshot)' };
+  }
+
+  const snapPath = join(changeDir, 'architecture', 'snapshot-light.md');
+  if (!existsSync(snapPath)) {
+    return {
+      pass: false,
+      failures: ['light note present but architecture/snapshot-light.md missing — snapshot the touched surfaces before closing'],
+    };
+  }
+  if (!readFileSync(snapPath, 'utf-8').trim()) {
+    return { pass: false, failures: ['architecture/snapshot-light.md is empty'] };
+  }
+  return { pass: true, failures: [] };
+}

package/scripts/guard/checks/arch-snapshot.mjs

@@ -3,12 +3,14 @@
 //
 // v0.53.0 注释修正：原写「（先于 arch-merge）」。B' 方案（设计增强方案 v0.25 §110）已把
 // arch-merge 前移到本转换**之前**执行，"先于 arch-merge"不再成立。二者现同挂本转换且
-// **无数据依赖**：本 check 只读 `docs/architecture/iterations/`，而 arch-merge 全流程不触碰
-// 该目录（已逐行核对）。"先快照后回写"仍是语义前提（快照在 ARCH 阶段产出，早于整个 closing）。
+// **无数据依赖**：本 check 只读 `docs/architecture/iterations/`；arch-merge 自 P0-B'-① 起
+// （ddd-purity-and-arch-merge-design v1.5）**只读不写**该目录（seedFromSnapshots 读快照聚合），
+// 不构成数据依赖（P3 MIN-1：原「arch-merge 全流程不触碰该目录（已逐行核对）」已过期）。
+// "先快照后回写"仍是语义前提（快照在 ARCH 阶段产出，早于整个 closing）。
 //
 // 规则：
 // - arch_baseline == null（在途/存量）→ PASS + WARN（legacy 豁免）
-// - skip 已物化（iterations/vN/SKIPPED）→ PASS
+// - skip 已物化（iterations/vN/SKIPPED.md；存量 SKIPPED 亦识别——双态见 arch-gate-exemptions）→ PASS
 // - iterations/<latest>/architecture.md 存在 → PASS
 // - 否则 → FAIL
 //

package/scripts/guard/checks/artifacts-planned.mjs

@@ -0,0 +1,38 @@
+// scripts/guard/checks/artifacts-planned.mjs — planned 的规划制品判据（§4.5②，替代四件套）
+// v0.64.0（B-01 强化）：不止「存在」——防空壳套餐：
+// proposal.md 非空（≥10 个非空行）+ tasks.md ≥1 条 checkbox。
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseTaskLine } from '../../lib/md-normalize.mjs';
+
+function nonEmptyLines(text) {
+  return text.split('\n').filter(l => l.trim()).length;
+}
+
+export function checkArtifactsPlanned(changeDir) {
+  const failures = [];
+  const proposalPath = join(changeDir, 'proposal.md');
+  const tasksPath = join(changeDir, 'tasks.md');
+
+  if (!existsSync(proposalPath)) {
+    failures.push('proposal.md is missing — planned path requires proposal.md + tasks.md');
+  } else {
+    const proposal = readFileSync(proposalPath, 'utf-8');
+    const lines = nonEmptyLines(proposal);
+    if (lines < 10) {
+      failures.push(`proposal.md too thin (${lines} non-empty lines, need ≥10) — state intent, scope, and acceptance criteria`);
+    }
+  }
+
+  if (!existsSync(tasksPath)) {
+    failures.push('tasks.md is missing — planned path requires proposal.md + tasks.md');
+  } else {
+    const tasks = readFileSync(tasksPath, 'utf-8');
+    const taskCount = tasks.split('\n').map(l => parseTaskLine(l)).filter(Boolean).length;
+    if (taskCount < 1) {
+      failures.push('tasks.md has no task checkboxes — add at least one `- [ ]` task');
+    }
+  }
+
+  return failures.length ? { pass: false, failures } : { pass: true, failures: [] };
+}

package/scripts/guard/checks/compound-writeback-light.mjs

@@ -0,0 +1,45 @@
+// scripts/guard/checks/compound-writeback-light.mjs — 复利轻回写（§4，同 sink 不另起台账）
+// v0.64.0：planned closing 必执行（含「无新增决策」的显式空捕获记录），
+// **不走 compound_skipped 自清**（§3.7——自清会让 closed 后的全局库漏写无兜底）。
+// 判据：docs/solutions/** 存在归因 `change:<name>` 的条目（INDEX 单写入口 tf solutions 系列产出）。
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readState } from '../../lib/state-loader.mjs';
+import { findProjectRoot } from '../../lib/surface-scan.mjs';
+
+function filesContain(dir, needle) {
+  if (!existsSync(dir)) return false;
+  const entries = readdirSync(dir, { recursive: true, withFileTypes: true });
+  for (const e of entries) {
+    if (!e.isFile() || !/\.md$/i.test(e.name)) continue;
+    const parent = typeof e.parentPath === 'string' ? e.parentPath : dir;
+    try {
+      if (readFileSync(join(parent, e.name), 'utf-8').includes(needle)) return true;
+    } catch { /* skip */ }
+  }
+  return false;
+}
+
+export function checkCompoundWritebackLight(changeDir) {
+  const state = readState(changeDir);
+  const changeName = state.change_name || changeDir.split('/').filter(Boolean).pop();
+
+  // 自清通道对本维度无效（planned 禁 compound_skipped，§3.7）
+  if (state.compound_skipped === true || state.compound_skipped === 'true') {
+    return {
+      pass: false,
+      failures: ['compound_skipped is not accepted on the planned light path — capture into the global library (empty capture "no new decisions" is fine): tf solutions capture / ce-compound with change:<name> attribution'],
+    };
+  }
+
+  const projectRoot = findProjectRoot(changeDir);
+  const solutionsDir = join(projectRoot, 'docs', 'solutions');
+  const anchor = `change:${changeName}`;
+  if (filesContain(solutionsDir, anchor) || filesContain(solutionsDir, changeName)) {
+    return { pass: true, failures: [] };
+  }
+  return {
+    pass: false,
+    failures: [`no solution entry attributed '${anchor}' (or '${changeName}') in docs/solutions/** — run compound capture (tf solutions capture / ce-compound), INDEX single-writer + dedup; an explicit 'no new decisions' entry satisfies this gate`],
+  };
+}