@xulthekl/team-flow 0.44.0 → 0.45.0

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

@@ -1,3 +1,3 @@
-# team-flow v0.44.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.45.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. 25 skills + 16 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.44.0",
+      "version": "0.45.0",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.44.0",
+  "version": "0.45.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). 25 skills + 16 agents, one install.",
   "source": "./",
   "author": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.44.0",
+  "version": "0.45.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.44.0"
+    "version": "0.45.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). 25 skills + 16 agents, one install.",
-  "version": "0.44.0",
+  "version": "0.45.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.44.0"
+    "version": "0.45.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.44.0",
+      "version": "0.45.0",
       "source": ".",
       "author": {
         "name": "LT",

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to `team-flow` will be documented in this file.
 
 The format loosely follows Keep a Changelog.
 
+## [0.45.0] - 2026-08-18
+
+### Added（glaf4-dev 集成增强，v0.45.0）
+
+设计来源：`docs/plan/glaf4-dev-integration-design.md` v2.1（glaf4-dev 统一开发技能族 v0.3.0，生产+测试全委托）
+
+- **运行时探测**（接口①）：`tf glaf4-delegation detect <root>` 三态检测（is_glaf4_java / glaf4_dev_available / delegation_mode）+ 写 `.team-flow/team-flow.config.json` 的 `glaf4_dev` 段；git root ≠ target_root 时写 git root 冗余副本（多服务 OR 聚合 enabled + delegation_mode 保留）；config-loader 查找链补 git root `.team-flow/`
+- **test-matrix-export v2**（接口②）：支持 test-matrix-vnext（schema_version 2.0）——模块名从 case.target 推导、kind→work_mode 映射（REFACTOR→TDD 记 footer）、write_targets 数组多行拆分 + `#方法` 锚点、case_id 与 rewriteIndex 正则兼容 WARN、`validateSchemaVersion` 版本门（未知版本显式 BLOCK）
+- **S1 guard 改造**（接口③）：`EXECUTION_MODES` 扩入 `glaf4-delegation`；execution-recommendation 补 recommend 链（glaf4DelegationAvailable 注入 available_modes + 白名单改引用单一真相源）；cmd-execution 支持 `--mode glaf4-delegation --wave w1:serial:delegate` 单 wave 计划
+- **证据回灌**（接口④）：`tf glaf4-evidence-export` 聚合 glaf4-dev run 终局 PASS 证据（模式→证据阶段映射、每 batch 最终 GREEN、executed_classes 去重、surefire 兼容行、total=0 边界、environment_error 分流）→ `tf test record --from` 落盘
+- **委托协议 CLI**：`tf glaf4-delegation`（confirm DP-4 委托确认 5 项 + write-set.json 落盘 + 契约段 diff WARN；verify-write-set 门禁级对账；verify-tasks 审计；record-partial 落 partial writes；reset 删 plan 重走 DP-4）
+- **delegation-status guard 维度**：executing:closing 校验 `delegation_status`（failed 阻断直到人工重置；retry_count≥3 提示上限）
+- **skip 禁令**：glaf4-delegation 模式禁 `test_matrix_skipped`（唯一例外 TEST_BOOTSTRAP），三个测试门禁统一接入
+- **GLAF4 Delegation 段**：contract-builder SKILL 重写 GLAF4 路由 + `references/glaf4-delegation.md`（骨架矩阵先行时序 + closing 时序协议）+ `templates/execution-contract.md` 段占位；workflow-start 路由从 glaf4-tests → glaf4-dev 实施委托
+- **四轮覆盖度评审闭环**：2 阻塞（C1 探测断链/C2 版本契约）+ 5 Important（模板表头盲区/嵌套工程根/多服务污染/detect 接线/mode last-write-wins）+ 12 Minor 全修，707/707 测试通过
+
 ## [0.44.0] - 2026-08-17
 
 ### Added（独立 business-analysis skill/agent，v0.44.0）

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.44.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.45.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.44.0**。
+当前发布版本：**v0.45.0**。
 
 ---
 

package/README.md

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

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.44.0`
+- Current: `v0.45.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/solutions/INDEX.md

@@ -2,6 +2,7 @@
 <!-- 每条一行，按 severity 降序，≤150 行硬上限 -->
 | date | phase | domain | type | severity | summary | file |
 |------|-------|--------|------|----------|---------|------|
+| 2026-08-18 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-18-no-summary.md |
 | 2026-08-17 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-17-no-summary.md |
 | 2026-08-07 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-07-no-summary.md |
 | 2026-08-06 | cross-phase | general | insight | medium | (no summary) | cross-phase/2026-08-06-no-summary.md |

package/docs/solutions/cross-phase/2026-08-18-no-summary.md

@@ -0,0 +1,17 @@
+---
+phase: cross-phase
+domain: general
+type: insight
+severity: medium
+date: 2026-08-18
+source: 
+---
+
+## 问题描述
+(no summary)
+
+## 根因/模式
+（待补充）
+
+## 预防措施/应用方式
+（待补充）

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). 25 skills, one install.",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# v0.44.0: auto-sync CLI version with plugin version
+# v0.45.0: auto-sync CLI version with plugin version
 set -e
 
 # ═══════════════════════════════════════════════════════════════
 # Plugin version (update this when releasing new versions)
 # ═══════════════════════════════════════════════════════════════
-PLUGIN_VERSION="0.44.0"
+PLUGIN_VERSION="0.45.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.44.0.
+Current version: v0.45.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.44.0",
+  "version": "0.45.0",
   "description": "Unified plugin (25 skills + 16 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.44.0",
+  "version": "0.45.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). 25 skills + 16 agents, one install.",
   "author": {
     "name": "LT"

package/scripts/guard/checks/delegation-status.mjs

@@ -0,0 +1,56 @@
+// scripts/guard/checks/delegation-status.mjs — GLAF4 委托状态位 guard（v2.1 §6.7）
+//
+// 规则（v2.1 §6.7 委托失败恢复闭环）：
+// - execution_mode !== 'glaf4-delegation' → pass（透明，不干预非委托 change）
+// - delegation_status === 'success' → pass（委托已成功完成）
+// - delegation_status === 'failed' → FAIL（阻断 closing 直到人工重置——三选一恢复）
+// - delegation_status 缺失 / null / in_progress → FAIL（委托未成功完成，closing 前必须终局）
+//
+// 设计原则：
+// - 与 compound-captured 同属"状态位约束"维度，确保 delegation_status 有 guard 约束力
+//   （否则状态位无约束力，三选一恢复全靠人工纪律）
+// - 状态位经 `tf state set delegation_status <in_progress|success|failed>` 程序化写入
+
+import { readState } from '../../lib/state-loader.mjs';
+
+/**
+ * Check GLAF4 委托状态位（executing:closing 维度）
+ * @param {string} changeDir
+ * @returns {{ pass: boolean, failures: string[] }}
+ */
+export function checkDelegationStatus(changeDir) {
+  const state = readState(changeDir);
+
+  // 非 glaf4-delegation 模式：透明放行（可选接入，非 GLAF4 项目完全不受影响，v2.1 §8）
+  if (state.execution_mode !== 'glaf4-delegation') {
+    return { pass: true, failures: [] };
+  }
+
+  if (state.delegation_status === 'success') {
+    return { pass: true, failures: [] };
+  }
+
+  const failures = [];
+  if (state.delegation_status === 'failed') {
+    // I3（2026-08-18）：retry_count 封顶 3 机械提示——达到上限必须走降级/转人工，不再允许重试
+    const retryCount = Number.isInteger(state.delegation_retry_count) ? state.delegation_retry_count : 0;
+    const atLimit = retryCount >= 3;
+    failures.push(
+      'GLAF4 委托状态位为 failed——closing 前必须人工处置（v2.1 §6.7 三选一）：'
+      + (atLimit
+        ? `⚠️  delegation_retry_count=${retryCount} 已达上限 3——禁止继续重试，必须走 ② 降级 build-executor（glaf4-delegation reset 删 plan 重走 DP-4）或 ③ 标记阻塞转人工排障。`
+        : `① 重试（delegation_retry_count 封顶 3，当前 ${retryCount}）② 降级 build-executor（glaf4-delegation reset 删 plan 重走 DP-4）③ 标记阻塞转人工排障。`)
+      + '处置后 `tf state set delegation_status success`（或重置为 in_progress 继续委托）。'
+    );
+  } else if (state.delegation_status === 'in_progress') {
+    failures.push(
+      'GLAF4 委托状态位仍为 in_progress——委托 run 尚未终局，closing 前必须完成委托并回灌证据后置为 success。'
+    );
+  } else {
+    failures.push(
+      'GLAF4 委托状态位缺失（delegation_status 未记录）——glaf4-delegation 模式 change 必须先完成委托，'
+      + '证据回灌 + 对账通过后 `tf state set delegation_status success`。'
+    );
+  }
+  return { pass: false, failures };
+}

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

@@ -32,6 +32,19 @@ export function skipMissingReason(state) {
   return state?.test_matrix_skipped === 'true' && !hasExplicitSkip(state);
 }
 
+/**
+ * v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 test_matrix_skipped（唯一例外 TEST_BOOTSTRAP 零测试）。
+ * 防止"矩阵权威在 glaf4-dev"被误读为"矩阵可 skip"导致零测试证据关闭（测试门三道短路后门）。
+ * @returns {string|null} 违规原因（null = 无违规）
+ */
+export function glaf4SkipViolation(state) {
+  if (state?.execution_mode !== 'glaf4-delegation') return null;
+  if (state?.test_matrix_skipped !== 'true') return null;
+  // 唯一例外：TEST_BOOTSTRAP 零测试（reason 显式声明）
+  if (/TEST_BOOTSTRAP/.test(state?.test_matrix_skip_reason || '')) return null;
+  return 'glaf4-delegation 模式禁止 test_matrix_skipped（唯一例外 TEST_BOOTSTRAP 零测试，skip_reason 须显式声明 TEST_BOOTSTRAP）';
+}
+
 export const SKIP_REASON_HINT =
   "test_matrix_skipped=true requires test_matrix_skip_reason — record it: "
   + "tf state set <dir> test_matrix_skip_reason '<why this change needs no test matrix>'";

package/scripts/guard/checks/test-matrix-complete.mjs

@@ -10,6 +10,7 @@ import { computeTestMatrixHash } from '../../lib/hash.mjs';
 import {
   isLegacyChange,
   skipMissingReason,
+  glaf4SkipViolation,
   SKIP_REASON_HINT,
   contractDeclaresTestMatrix,
   readTestMatrixFile,
@@ -28,6 +29,11 @@ export function checkTestMatrixComplete(changeDir) {
 
   // Step 2 — 显式 skip：必须附理由（可审计豁免）。
   if (state.test_matrix_skipped === 'true') {
+    // v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 skip（唯一例外 TEST_BOOTSTRAP）
+    const glaf4Violation = glaf4SkipViolation(state);
+    if (glaf4Violation) {
+      return { pass: false, failures: [glaf4Violation] };
+    }
     if (skipMissingReason(state)) {
       return { pass: false, failures: [SKIP_REASON_HINT] };
     }

package/scripts/guard/checks/test-matrix-ready.mjs

@@ -8,6 +8,7 @@ import { readState } from '../../lib/state-loader.mjs';
 import {
   isLegacyChange,
   skipMissingReason,
+  glaf4SkipViolation,
   SKIP_REASON_HINT,
   contractDeclaresTestMatrix,
   readTestMatrixFile,
@@ -26,6 +27,11 @@ export function checkTestMatrixReady(changeDir) {
 
   // Exemption 2：显式 skip（必须附理由）。
   if (state.test_matrix_skipped === 'true') {
+    // v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 skip（唯一例外 TEST_BOOTSTRAP）
+    const glaf4Violation = glaf4SkipViolation(state);
+    if (glaf4Violation) {
+      return { pass: false, failures: [glaf4Violation] };
+    }
     if (skipMissingReason(state)) {
       return { pass: false, failures: [SKIP_REASON_HINT] };
     }

package/scripts/guard/checks/tests-passing.mjs

@@ -9,7 +9,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { readState } from '../../lib/state-loader.mjs';
-import { isLegacyChange, skipMissingReason, SKIP_REASON_HINT } from './test-gate-exemptions.mjs';
+import { isLegacyChange, skipMissingReason, glaf4SkipViolation, SKIP_REASON_HINT } from './test-gate-exemptions.mjs';
 
 /**
  * 解析结构化 test_result：
@@ -68,6 +68,11 @@ export function checkTestsPassing(changeDir) {
 
   // 显式 skip（必须附理由）。
   if (state.test_matrix_skipped === 'true') {
+    // v2.1 §6.3 skip 禁令：glaf4-delegation 模式禁止 skip（唯一例外 TEST_BOOTSTRAP）
+    const glaf4Violation = glaf4SkipViolation(state);
+    if (glaf4Violation) {
+      return { pass: false, failures: [glaf4Violation] };
+    }
     if (skipMissingReason(state)) {
       return { pass: false, failures: [SKIP_REASON_HINT] };
     }

package/scripts/guard/guard.mjs

@@ -18,6 +18,7 @@ import { checkTestMatrixComplete } from './checks/test-matrix-complete.mjs';
 import { checkTestMatrixReady } from './checks/test-matrix-ready.mjs';
 import { checkArchReadiness } from './checks/arch-readiness.mjs';
 import { checkArchSnapshot } from './checks/arch-snapshot.mjs';
+import { checkDelegationStatus } from './checks/delegation-status.mjs';
 
 // Transition matrix: <from>:<to> → required check dimensions
 const TRANSITION_CHECKS = {
@@ -37,7 +38,7 @@ const TRANSITION_CHECKS = {
   'approved-for-build:executing':   ['artifacts-exist', 'contract-fresh', 'dp-gate-passed', 'execution-plan-ready', 'test-matrix-ready'],
   // v0.35.0 (v0.14 §59.4): arch-snapshot 新增——"先快照后回写"的强制化（legacy 豁免）。
   // 仅在 full workflow 挂；hotfix/tweak 沿用 §59.4 豁免（紧急/微调不挂）。
-  'executing:closing':              ['tasks-complete', 'tests-passing', 'specs-merged', 'execution-plan-ready', 'execution-reviews-passed', 'compound-captured', 'test-matrix-complete', 'arch-snapshot'],
+  'executing:closing':              ['tasks-complete', 'tests-passing', 'specs-merged', 'execution-plan-ready', 'execution-reviews-passed', 'compound-captured', 'test-matrix-complete', 'arch-snapshot', 'delegation-status'],
 
   // Debugging side-path
   'executing:debugging':            [],
@@ -188,6 +189,7 @@ async function main() {
     'test-matrix-ready': (dir) => checkTestMatrixReady(dir),
     'arch-readiness': (dir) => checkArchReadiness(dir),
     'arch-snapshot': (dir) => checkArchSnapshot(dir),
+    'delegation-status': (dir) => checkDelegationStatus(dir),
   };
 
   const checks = [];

package/scripts/lib/cmd-state.mjs

@@ -21,6 +21,9 @@ const SETTABLE_FIELDS = [
   'dp_1_result', 'dp_1_timestamp', 'dp_1_decisions', 'dp_1_confirmed',
   'dp_2_result', 'dp_2_timestamp', 'dp_2_decisions', 'dp_2_confirmed',
   'dp_3_result', 'dp_3_timestamp', 'dp_3_decisions', 'dp_3_confirmed',
+  // v2.1 §6.6/§6.7：GLAF4 委托决策与状态位（dp_4_result 仍由 tf execution plan --confirm 程序化写入，不在列表）
+  'dp_4_glaf4_mode', 'dp_4_write_set_hash',
+  'delegation_status', 'delegation_retry_count', 'delegation_partial_writes',
   'dp_5_result', 'dp_5_timestamp', 'dp_5_decisions', 'dp_5_confirmed',
   'dp_6_result', 'dp_6_timestamp', 'dp_6_decisions', 'dp_6_confirmed',
   'dp_7_result', 'dp_7_timestamp', 'dp_7_decisions', 'dp_7_confirmed',

package/scripts/lib/config-loader.mjs

@@ -28,6 +28,13 @@ const DEFAULTS = {
     // 各 skill 上下文加载时按 phase 过滤注入
     // 示例: { database: ".team-flow/conventions/db-design.md", ... }
   },
+  glaf4_dev: {
+    // glaf4-dev 运行时探测结果（v2.1 §4 接口①）
+    // contract-builder 产出 execution-contract 时实时探测写入；delegation_mode 由用户/编排开关
+    enabled: false,
+    version: null,
+    delegation_mode: 'auto',
+  },
 };
 
 export const MODEL_PROFILES = Object.freeze([
@@ -89,6 +96,10 @@ function findConfigFile(startDir) {
       encoding: 'utf-8',
       stdio: ['pipe', 'pipe', 'pipe'],
     }).trim();
+    // v2.1 评审 C1（2026-08-18）：git root 优先查 .team-flow/（writeGlaf4DevConfig 落点，
+    // contract-builder 在工程根写探测结果，changeDir 子目录需经此读到），再查 legacy 位置。
+    const gitTeamFlowDir = join(gitRoot, '.team-flow', 'team-flow.config.json');
+    if (existsSync(gitTeamFlowDir)) return gitTeamFlowDir;
     const gitPath = join(gitRoot, 'team-flow.config.json');
     if (existsSync(gitPath)) return gitPath;
   } catch {

package/scripts/lib/conventions-generator.mjs

@@ -10,9 +10,100 @@
 // 设计来源：test-capability-enhancement-design v1.0 §四 + §55.4
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
 import path, { join } from 'node:path';
 import { parseArgs } from 'node:util';
 
+// ── glaf4-dev 运行时探测（v2.1 §4 接口①）─────────────────────────────────────
+
+// Claude Code 插件安装登记表（实测结构：{ version: 2, plugins: { "<name>@<marketplace>": [{ scope, installPath, version }] } }）
+const PLUGINS_INSTALLED_PATH = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
+
+/**
+ * 探测 glaf4-dev 插件是否可用（解析 ~/.claude/plugins/installed_plugins.json）
+ * @param {string} [pluginsFilePath] 可注入登记表路径（测试用），默认 ~/.claude/plugins/installed_plugins.json
+ * @returns {{ available: boolean, version: string|null, installPath: string|null }}
+ */
+export function detectGlaf4DevPlugin(pluginsFilePath = PLUGINS_INSTALLED_PATH) {
+  try {
+    if (!existsSync(pluginsFilePath)) {
+      return { available: false, version: null, installPath: null };
+    }
+    const raw = readFileSync(pluginsFilePath, 'utf-8');
+    const registry = JSON.parse(raw);
+    const plugins = registry?.plugins || {};
+    // 匹配 key 形如 "glaf4-dev@glaf4-dev" 或 "glaf4-dev"
+    for (const [key, entries] of Object.entries(plugins)) {
+      const name = key.split('@')[0];
+      if (name !== 'glaf4-dev') continue;
+      const entry = Array.isArray(entries) ? entries[0] : entries;
+      if (entry?.installPath) {
+        return {
+          available: true,
+          version: entry.version || null,
+          installPath: entry.installPath,
+        };
+      }
+    }
+    return { available: false, version: null, installPath: null };
+  } catch {
+    // 解析失败按不可用处理（fail-open：不阻断 conventions 生成）
+    return { available: false, version: null, installPath: null };
+  }
+}
+
+/**
+ * GLAF4 委托三态检测（v2.1 §4 接口①）
+ * @param {string} root 项目根目录
+ * @param {object} options 覆盖项（如 { delegationMode: 'manual', pluginsFilePath: '/tmp/xxx.json' }）
+ * @returns {{ is_glaf4_java: boolean, glaf4_dev_available: boolean, glaf4_dev_version: string|null, delegation_mode: 'auto'|'manual'|'off' }}
+ */
+export function detectGlaf4Delegation(root, options = {}) {
+  const techStack = detectTechStack(root);
+  // is_glaf4_java = Java 技术栈命中（pom.xml/build.gradle 存在即可，v2.1 §4）
+  // glaf4-dev 只处理 Java，Spring/JUnit 细分由 contract-builder 已有检测负责
+  const isGlaf4Java = techStack.language === 'java';
+  const plugin = detectGlaf4DevPlugin(options.pluginsFilePath);
+  const mode = options.delegationMode || 'auto';
+  return {
+    is_glaf4_java: isGlaf4Java,
+    glaf4_dev_available: plugin.available,
+    glaf4_dev_version: plugin.version,
+    delegation_mode: mode,
+  };
+}
+
+/**
+ * 写 glaf4_dev 段到 team-flow.config.json（v2.1 §4：contract-builder 产出 execution-contract 时探测写入）
+ * @param {string} root 项目根目录
+ * @param {{ enabled: boolean, version: string|null, delegationMode?: 'auto'|'manual'|'off' }} glaf4DevInfo
+ */
+export function writeGlaf4DevConfig(root, glaf4DevInfo) {
+  const teamFlowDir = join(root, '.team-flow');
+  const configPath = join(teamFlowDir, 'team-flow.config.json');
+  mkdirSync(teamFlowDir, { recursive: true });
+
+  let config = {};
+  if (existsSync(configPath)) {
+    try {
+      config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    } catch {
+      config = {};
+    }
+  }
+
+  config.glaf4_dev = {
+    enabled: glaf4DevInfo.enabled,
+    version: glaf4DevInfo.version,
+  };
+  // L5 修复（2026-08-18）：delegation_mode 显式落盘，不依赖 config-loader 默认 auto
+  if (glaf4DevInfo.delegationMode) {
+    config.glaf4_dev.delegation_mode = glaf4DevInfo.delegationMode;
+  }
+
+  writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+
 // ── 常量 ─────────────────────────────────────────────────────────────────────
 
 const TEMPLATE_DIR = join(import.meta.dirname, '../../templates/conventions');

package/scripts/lib/execution-plan.mjs

@@ -7,7 +7,8 @@ import { getOverlayPaths } from './sdd-overlay.mjs';
 import { readState } from './state-loader.mjs';
 import { detectWorkspaceRoot, findSubRepo } from './git-utils.mjs';
 
-export const EXECUTION_MODES = ['inline', 'batch-inline', 'sdd'];
+// v2.1 §6.6：扩入 glaf4-delegation（GLAF4 change 整体委托 glaf4-dev 七模式流，S1 结构统一）
+export const EXECUTION_MODES = ['inline', 'batch-inline', 'sdd', 'glaf4-delegation'];
 
 const WAVE_STRATEGIES = new Set(['parallel', 'serial']);
 const REVIEW_STATUSES = new Set(['pass', 'fail']);

package/scripts/lib/execution-recommendation.mjs

@@ -7,8 +7,21 @@ import { loadConfig } from './config-loader.mjs';
 import { computeArtifactsHash, computeContractHash } from './hash.mjs';
 import { getOverlayPaths } from './sdd-overlay.mjs';
 import { readState } from './state-loader.mjs';
+import { EXECUTION_MODES } from './execution-plan.mjs';
+
+// v2.1 §6.6（二轮评审 HIGH）：recommend 链补全
+// - GLAF4 change 的 recommend 恒为"推荐 inline + available_modes 含 glaf4-delegation"
+// - 选 glaf4-delegation 属非推荐选择，需 --acknowledge-recommendation（cmd-execution 校验）
+export function recommendExecutionModes({ workflow, taskCount, inlineThreshold, waves = [], glaf4DelegationAvailable = false }) {
+  const base = recommendBaseExecutionModes({ workflow, taskCount, inlineThreshold, waves });
+  if (glaf4DelegationAvailable && !base.available_modes.includes('glaf4-delegation')) {
+    base.available_modes = [...base.available_modes, 'glaf4-delegation'];
+  }
+  base.facts.glaf4_delegation_available = glaf4DelegationAvailable;
+  return base;
+}
 
-export function recommendExecutionModes({ workflow, taskCount, inlineThreshold, waves = [] }) {
+function recommendBaseExecutionModes({ workflow, taskCount, inlineThreshold, waves = [] }) {
   const normalizedWorkflow = typeof workflow === 'string' ? workflow : null;
   const normalizedTaskCount = Number.isInteger(taskCount) && taskCount >= 0 ? taskCount : null;
   const threshold = Number.isInteger(inlineThreshold) && inlineThreshold > 0 ? inlineThreshold : 3;
@@ -68,11 +81,15 @@ export function recommendExecutionModes({ workflow, taskCount, inlineThreshold,
 export function recommendExecutionModesForChange(changeDir, waves = []) {
   const state = readState(changeDir);
   const config = loadConfig(changeDir);
+  // v2.1 §6.6：glaf4-delegation 可用性 = 运行时探测已写 config.glaf4_dev（enabled）且 delegation_mode ≠ off
+  const glaf4 = config.glaf4_dev || {};
+  const glaf4DelegationAvailable = glaf4.enabled === true && glaf4.delegation_mode !== 'off';
   return recommendExecutionModes({
     workflow: state.workflow,
     taskCount: countDocumentedTasks(changeDir),
     inlineThreshold: config.execution.inlineThreshold,
     waves,
+    glaf4DelegationAvailable,
   });
 }
 
@@ -154,10 +171,10 @@ function validateRecommendationReceiptStructure(receipt) {
   if (!isObject(receipt.recommendation)) failures.push('execution recommendation payload is required');
   else {
     const recommendation = receipt.recommendation;
-    if (!Array.isArray(recommendation.available_modes) || recommendation.available_modes.some(mode => !['inline', 'batch-inline', 'sdd'].includes(mode))) {
+    if (!Array.isArray(recommendation.available_modes) || recommendation.available_modes.some(mode => !EXECUTION_MODES.includes(mode))) {
       failures.push('execution recommendation available modes are invalid');
     }
-    if (!isObject(recommendation.recommendation) || !['inline', 'batch-inline', 'sdd'].includes(recommendation.recommendation.mode)) {
+    if (!isObject(recommendation.recommendation) || !EXECUTION_MODES.includes(recommendation.recommendation.mode)) {
       failures.push('execution recommendation mode is invalid');
     }
     if (!Array.isArray(recommendation.recommendation?.reasons) || recommendation.recommendation.reasons.some(reason => typeof reason !== 'string' || !reason.trim())) {