@xulthekl/team-flow 0.43.1 → 0.45.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.43.1",
-  "description": "Unified plugin (24 skills + 15 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback for multi-agent coding tools.",
+  "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",
   "bin": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-flow",
-  "version": "0.43.1",
-  "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). 24 skills + 15 agents, one install.",
+  "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())) {