@xulthekl/team-flow 0.23.0 → 0.25.1

package/skills/workflow-bootstrap/scripts/recon-probe.sh

@@ -36,6 +36,7 @@ set -u  # 未定义变量报错；不用 -e（单条采集失败不应中断整
 # ----------------------------------------------------------------------------
 ROOT="."
 OUT=""
+DDL_OUT=""           # v0.24.0: DDL 输出文件路径（默认不写，仅含在 JSON 中）
 MAX_FILES=50000     # LOC 统计文件数上限（保护超大仓库）
 TREE_DEPTH=4        # 目录树限深
 
@@ -51,6 +52,8 @@ while [ $# -gt 0 ]; do
     --root=*) ROOT="${1#*=}"; shift ;;
     --out)    OUT="${2:-}"; shift 2 ;;
     --out=*)  OUT="${1#*=}"; shift ;;
+    --ddl-out) DDL_OUT="${2:-}"; shift 2 ;;
+    --ddl-out=*) DDL_OUT="${1#*=}"; shift ;;
     -h|--help) print_help; exit 0 ;;
     *) echo "[recon-probe] warn: unknown arg '$1' (ignored)" >&2; shift ;;
   esac
@@ -260,6 +263,111 @@ pruned_find -maxdepth 2 -type f \
   -print 2>/dev/null | sed "s#^$ROOT_ABS/##" | sort > "$TMP/doc_files.txt"
 if [ -d "$ROOT_ABS/docs" ]; then DOCS_DIR=true; else DOCS_DIR=false; fi
 
+# ============================================================================
+# ⑦ DDL 提取（v0.24.0：schema-baseline 兜底采集）
+# ----------------------------------------------------------------------------
+# 策略（优先级）：
+#   1. 既有 .sql 中的 CREATE TABLE 语句 → 直接提取
+#   2. Java Entity 类（@Entity / @Table 注解）→ 正则提取表名+字段
+#   3. 以上均无 → 输出空 schema-baseline.sql + 提示手动补充
+# 设计契约：只做确定性机械采集（regex），语义推断交给侦察子代理。
+# ============================================================================
+
+: > "$TMP/ddl_statements.sql"
+: > "$TMP/ddl_tables.txt"
+DDL_SOURCE="none"
+DDL_TABLE_COUNT=0
+
+# --- 策略 1：从既有 .sql 文件提取 CREATE TABLE ----------------------------------
+if [ -s "$TMP/sql_files.txt" ]; then
+  while IFS= read -r sql_rel; do
+    sql_abs="$ROOT_ABS/$sql_rel"
+    [ -f "$sql_abs" ] || continue
+    # 提取 CREATE TABLE 语句（多行匹配，到第一个 ; 结束）
+    # 兼容：CREATE TABLE / CREATE TABLE IF NOT EXISTS / 大小写不敏感
+    awk '
+      BEGIN { IGNORECASE=1; in_stmt=0; stmt="" }
+      /CREATE[[:space:]]+TABLE/ { in_stmt=1; stmt="" }
+      in_stmt {
+        stmt = stmt $0 "\n"
+        if (/;/) {
+          printf "%s-- Source: %s\n\n", stmt, sql_file
+          in_stmt=0; stmt=""
+        }
+      }
+    ' sql_file="$sql_rel" "$sql_abs" 2>/dev/null >> "$TMP/ddl_statements.sql" || true
+  done < "$TMP/sql_files.txt"
+  if [ -s "$TMP/ddl_statements.sql" ]; then
+    DDL_SOURCE="sql_files"
+    # 提取表名（用于计数和 JSON）
+    grep -ioE 'CREATE[[:space:]]+TABLE[[:space:]]+(IF[[:space:]]+NOT[[:space:]]+EXISTS[[:space:]]+)?[`"]?([a-zA-Z_][a-zA-Z0-9_.]*)[`"]?' \
+      "$TMP/ddl_statements.sql" 2>/dev/null \
+      | grep -ioE '[`"]?[a-zA-Z_][a-zA-Z0-9_]*\.[a-zA-Z_][a-zA-Z0-9_]*[`"]?|[a-zA-Z_][a-zA-Z0-9_]*[`"]?$' \
+      | sed -E 's/[`"]//g' | sort -u > "$TMP/ddl_tables.txt" || true
+    DDL_TABLE_COUNT=$(wc -l < "$TMP/ddl_tables.txt" | tr -d ' ')
+  fi
+fi
+
+# --- 策略 2：从 Java Entity 类提取（@Entity / @Table 注解）-----------------------
+if [ "$DDL_TABLE_COUNT" -eq 0 ]; then
+  : > "$TMP/entity_files.txt"
+  pruned_find -type f -name '*.java' -print 2>/dev/null \
+    | while IFS= read -r jf; do
+        if grep -qlE '@(Entity|Table|Document|TableName)' "$jf" 2>/dev/null; then
+          echo "$jf"
+        fi
+      done | sort > "$TMP/entity_files.txt"
+
+  ENTITY_COUNT=$(wc -l < "$TMP/entity_files.txt" | tr -d ' ')
+  if [ "$ENTITY_COUNT" -gt 0 ]; then
+    DDL_SOURCE="java_entity"
+    while IFS= read -r ef; do
+      ef_rel="${ef#"$ROOT_ABS"/}"
+      # 提取 @Table(name="xxx") 或类名作为表名
+      table_name=""
+      tn="$(grep -oE '@Table\([^)]*name[[:space:]]*=[[:space:]]*"[^"]+"' "$ef" 2>/dev/null | head -1 \
+        | grep -oE '"[^"]+"' | tr -d '"')" || true
+      if [ -n "$tn" ]; then
+        table_name="$tn"
+      else
+        # 降级：用类名转 snake_case 作为表名
+        table_name="$(grep -oE 'class[[:space:]]+[A-Z][a-zA-Z0-9]*' "$ef" 2>/dev/null | head -1 \
+          | sed -E 's/class[[:space:]]+//' \
+          | sed -E 's/([A-Z])/_\1/g' | tr '[:upper:]' '[:lower:]' | sed 's/^_//')" || true
+      fi
+      [ -z "$table_name" ] && continue
+
+      # 攒完整 DDL 到临时文件再一次性追加（避免多次 >> 缓冲问题）
+      : > "$TMP/_entity_ddl.tmp"
+      echo "-- Entity: $ef_rel" >> "$TMP/_entity_ddl.tmp"
+      echo "CREATE TABLE $table_name (" >> "$TMP/_entity_ddl.tmp"
+      # 机械提取 private 字段声明：private Type fieldName;
+      grep -E '^[[:space:]]*private[[:space:]]+' "$ef" 2>/dev/null \
+        | grep -vE 'static[[:space:]]|final[[:space:]]|Logger|log|serialVersionUID' \
+        | sed -E 's/^[[:space:]]*private[[:space:]]+([A-Za-z0-9_<>, ]+)[[:space:]]+([a-zA-Z_][a-zA-Z0-9_]*)[[:space:]]*(=|;).*/  \2 \1,/' \
+        | sed -E 's/String|varchar|text/varchar(255)/g; s/Long|Integer|int|long/bigint/g; s/Boolean|boolean/tinyint(1)/g; s/Date|LocalDateTime|Timestamp/datetime/g; s/BigDecimal|Double|Float/decimal(15,4)/g' \
+        >> "$TMP/_entity_ddl.tmp" 2>/dev/null || true
+      echo "  create_time datetime," >> "$TMP/_entity_ddl.tmp"
+      echo "  update_time datetime," >> "$TMP/_entity_ddl.tmp"
+      echo "  del_flag tinyint(1) DEFAULT 0" >> "$TMP/_entity_ddl.tmp"
+      echo ");" >> "$TMP/_entity_ddl.tmp"
+      echo "" >> "$TMP/_entity_ddl.tmp"
+      cat "$TMP/_entity_ddl.tmp" >> "$TMP/ddl_statements.sql"
+      echo "$table_name" >> "$TMP/ddl_tables.txt"
+    done < "$TMP/entity_files.txt"
+    sort -u "$TMP/ddl_tables.txt" -o "$TMP/ddl_tables.txt"
+    DDL_TABLE_COUNT=$(wc -l < "$TMP/ddl_tables.txt" | tr -d ' ')
+  fi
+fi
+
+# --- 策略 3：生成占位 schema-baseline.sql ---------------------------------------
+if [ "$DDL_TABLE_COUNT" -eq 0 ]; then
+  DDL_SOURCE="none"
+  printf -- '-- schema-baseline.sql (auto-generated placeholder)\n' > "$TMP/ddl_statements.sql"
+  printf -- '-- No CREATE TABLE statements or Java Entity classes detected.\n' >> "$TMP/ddl_statements.sql"
+  printf -- '-- Please populate manually with your database schema.\n\n' >> "$TMP/ddl_statements.sql"
+fi
+
 # ============================================================================
 # 组装 JSON
 # ============================================================================
@@ -288,8 +396,13 @@ if [ -d "$ROOT_ABS/docs" ]; then DOCS_DIR=true; else DOCS_DIR=false; fi
     "$(json_array_from_file "$TMP/migration_dirs.txt")" \
     "$(json_array_from_file "$TMP/sql_samples.txt")"
   # ⑥ docs
-  printf '  "docs": {"docs_dir": %s, "doc_files": %s}\n' \
+  printf '  "docs": {"docs_dir": %s, "doc_files": %s},\n' \
     "$DOCS_DIR" "$(json_array_from_file "$TMP/doc_files.txt")"
+  # ⑦ DDL 提取（v0.24.0）
+  printf '  "ddl_extraction": {"source": "%s", "table_count": %s, "tables": %s, "ddl_statements": "%s"}\n' \
+    "$(json_escape "$DDL_SOURCE")" "$DDL_TABLE_COUNT" \
+    "$(json_array_from_file "$TMP/ddl_tables.txt")" \
+    "$(json_escape "$(cat "$TMP/ddl_statements.sql" 2>/dev/null)")"
   printf '}\n'
 } > "$TMP/out.json"
 
@@ -311,6 +424,13 @@ else
   emit_json
 fi
 
+# v0.24.0: DDL 独立输出文件（--ddl-out）
+if [ -n "$DDL_OUT" ] && [ -s "$TMP/ddl_statements.sql" ]; then
+  mkdir -p "$(dirname "$DDL_OUT")" 2>/dev/null || true
+  cp "$TMP/ddl_statements.sql" "$DDL_OUT" 2>/dev/null || true
+  echo "[recon-probe] DDL baseline written to: $DDL_OUT" >&2
+fi
+
 # 人类可读摘要 → stderr
 {
   echo "================ recon-probe 摘要 ================"
@@ -322,6 +442,7 @@ fi
   echo "SQL 迁移     : $SQL_COUNT 个"
   echo "docs/ 目录   : $DOCS_DIR"
   echo "README 等    : $(wc -l < "$TMP/doc_files.txt" | tr -d ' ') 个"
+  echo "DDL 提取     : source=$DDL_SOURCE, tables=$DDL_TABLE_COUNT"
   echo "================================================="
 } >&2
 

package/skills/workflow-orchestrator/references/s2-prd-prototype-loop.md

@@ -54,7 +54,7 @@
 检测可复利时刻（需求矛盾、原型返工、自动评审发现不一致并修正等）。每次自动评审发现不一致并修正后触发：
 
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf solutions capture --phase prd --domain <domain> --type pitfall --severity <sev> --summary "<summary>"
+npx --yes --package @xulthekl/team-flow@0.25.1 tf solutions capture --phase prd --domain <domain> --type pitfall --severity <sev> --summary "<summary>"
 ```
 
 ### 6. 反馈环路检查点

package/skills/workflow-orchestrator/references/s4-split-validate.md

@@ -38,7 +38,7 @@ verdict = FAIL → 必须回退 S3 调整拆分后重新审计，不可绕过直
 
 ```bash
 mkdir -p changes/<change-name>
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state init changes/<change-name>
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state init changes/<change-name>
 ```
 
 > ⚠️ **路径约束**：change 脚手架目录固定为项目根 `changes/<change-name>/`。

package/skills/workflow-orchestrator/references/s5-monitoring.md

@@ -34,7 +34,7 @@
 change closing 时检查经验晋升（change 内经验 → 产品级经验）：
 
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf solutions promote <change-dir>
+npx --yes --package @xulthekl/team-flow@0.25.1 tf solutions promote <change-dir>
 ```
 
 ### 4. 动态重规划触发

package/skills/workflow-start/SKILL.md

@@ -15,14 +15,14 @@ Do NOT invoke for: general coding tasks outside team-flow changes, casual questi
 
 ## States
 
-`exploring` → `specifying` → `bridging` → `approved-for-build` → `executing` → `closing`, with `debugging` side-path from `executing`, and `abandoned` as terminal. If a transition is ambiguous, run `npx --yes --package @xulthekl/team-flow@0.23.0 tf runtime asset read docs/state-machine.md`.
+`exploring` → `specifying` → `bridging` → `approved-for-build` → `executing` → `closing`, with `debugging` side-path from `executing`, and `abandoned` as terminal. If a transition is ambiguous, run `npx --yes --package @xulthekl/team-flow@0.25.1 tf runtime asset read docs/state-machine.md`.
 
 ## Initialization
 
-1. **Update check**: Run `npx --yes --package @xulthekl/team-flow@0.23.0 tf runtime check-update`. Exit 0 → continue. Exit 1 → non-blocking upgrade reminder. Exit 2 → skip.
+1. **Update check**: Run `npx --yes --package @xulthekl/team-flow@0.25.1 tf runtime check-update`. Exit 0 → continue. Exit 1 → non-blocking upgrade reminder. Exit 2 → skip.
 2. **Inspect change folder**: Check for `proposal.md`, `specs/`, `design.md`, `tasks.md`, `execution-contract.md`. Answer: Is the change fuzzy? Artifacts missing/unstable? Contract exist? User approved contract? Execution in progress or blocked? In verification/wrap-up?
-3. **Overlay recovery scan**: Run `npx --yes --package @xulthekl/team-flow@0.23.0 tf handoff list <change-dir> --json` and `npx --yes --package @xulthekl/team-flow@0.23.0 tf checkpoint list <change-dir> --json`. A `result-ready` handoff requires explicit review and `npx --yes --package @xulthekl/team-flow@0.23.0 tf handoff resolve` before resuming the affected work. An `active` handoff is non-blocking side work. Show a non-stale checkpoint as recovery context; show a stale checkpoint only as historical evidence.
-4. **Execution-control recovery scan**: For `approved-for-build`, `executing`, `debugging`, or `closing`, run `npx --yes --package @xulthekl/team-flow@0.23.0 tf execution show <change-dir> --json`. Treat only `current: true` plus `waves[].eligible: true` as permission to start a wave; report plan revision, mode, next eligible wave, and every wave's receipt/blockers. A missing, invalid, or stale plan blocks implementation and routes to `build-executor`; do not infer progress from chat history.
+3. **Overlay recovery scan**: Run `npx --yes --package @xulthekl/team-flow@0.25.1 tf handoff list <change-dir> --json` and `npx --yes --package @xulthekl/team-flow@0.25.1 tf checkpoint list <change-dir> --json`. A `result-ready` handoff requires explicit review and `npx --yes --package @xulthekl/team-flow@0.25.1 tf handoff resolve` before resuming the affected work. An `active` handoff is non-blocking side work. Show a non-stale checkpoint as recovery context; show a stale checkpoint only as historical evidence.
+4. **Execution-control recovery scan**: For `approved-for-build`, `executing`, `debugging`, or `closing`, run `npx --yes --package @xulthekl/team-flow@0.25.1 tf execution show <change-dir> --json`. Treat only `current: true` plus `waves[].eligible: true` as permission to start a wave; report plan revision, mode, next eligible wave, and every wave's receipt/blockers. A missing, invalid, or stale plan blocks implementation and routes to `build-executor`; do not infer progress from chat history.
 
 ## DP-0: User Confirmation Gate
 
@@ -36,17 +36,17 @@ Ask (manual path): change name + one-sentence intent, known constraints, related
 
 After confirmation:
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_decisions "<summary>"
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_result confirmed
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_confirmed true
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_timestamp $(date -u +%Y-%m-%dT%H:%M:%SZ)
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_decisions "<summary>"
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_result confirmed
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_confirmed true
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_timestamp $(date -u +%Y-%m-%dT%H:%M:%SZ)
 ```
 
 Config-aware routing: check `artifacts.order` and `artifacts.skip` from project config.
 
 ## Mode Detection
 
-If workflow is `auto`/`null`/unset: run `npx --yes --package @xulthekl/team-flow@0.23.0 tf runtime infer <change-dir>`. Inference: **hotfix** (≤2 tasks, ≤2 files, no schema/API/new modules), **tweak** (≤4 tasks, config/doc only), **full** (anything larger). Persist with `npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <dir> workflow <mode>`.
+If workflow is `auto`/`null`/unset: run `npx --yes --package @xulthekl/team-flow@0.25.1 tf runtime infer <change-dir>`. Inference: **hotfix** (≤2 tasks, ≤2 files, no schema/API/new modules), **tweak** (≤4 tasks, config/doc only), **full** (anything larger). Persist with `npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <dir> workflow <mode>`.
 
 Validate mode against artifact content. If hotfix/tweak criteria not met → upgrade to `full` and output reason. Don't overwrite explicit mode unless user asks.
 
@@ -59,19 +59,19 @@ Change is fuzzy, scope unclear, comparing options, no stable change name.
 Guard: `arch_design_decision` in `.team-flow.yaml` is `null` → must run before spec-writer. Dispatch `architecture-design` as sub-agent; after return, run reasonableness check and write yaml. Full protocol in `references/routing-rules.md`「Route to architecture-design」.
 
 ### Route to spec-writer
-Guard: `npx --yes --package @xulthekl/team-flow@0.23.0 tf runtime guard check <dir> exploring specifying --json` → fail = BLOCK. **arch_design_decision must not be null** → fail = BLOCK (v0.9 §26). User knows what they want, artifacts missing/incomplete.
+Guard: `npx --yes --package @xulthekl/team-flow@0.25.1 tf runtime guard check <dir> exploring specifying --json` → fail = BLOCK. **arch_design_decision must not be null** → fail = BLOCK (v0.9 §26). User knows what they want, artifacts missing/incomplete.
 
 ### Route to contract-builder
 Guard: `... check <dir> specifying bridging --json` → fail = BLOCK. Artifacts exist, implementation requested, contract missing/stale. Include `DP-3: 契约批准`.
 
 ### Route to build-executor
-Contract exists and approved, contract matches artifacts. Include `DP-4: 执行模式选择`: propose waves, run `npx --yes --package @xulthekl/team-flow@0.23.0 tf execution recommend <change-dir> [--wave ...]`, show the user every available mode plus evidence and the recommendation, then obtain a clear selection. The command saves a current receipt; before the first implementation edit, `build-executor` must run `npx --yes --package @xulthekl/team-flow@0.23.0 tf execution plan <change-dir> --mode <selected> --confirm ...` (and `--acknowledge-recommendation` when the selected mode differs from the recommendation) using matching artifacts, contract, and waves, then `npx --yes --package @xulthekl/team-flow@0.23.0 tf execution show <change-dir> --json`; report the saved revision, selected mode, recommendation alignment, ordered waves, and actual concurrent-dispatch capability. A revision must repeat recommend and confirmation. Do not transition to `executing` until `show` reports `current: true`; then run `... check <dir> approved-for-build executing --json` → fail = BLOCK.
+Contract exists and approved, contract matches artifacts. Include `DP-4: 执行模式选择`: propose waves, run `npx --yes --package @xulthekl/team-flow@0.25.1 tf execution recommend <change-dir> [--wave ...]`, show the user every available mode plus evidence and the recommendation, then obtain a clear selection. The command saves a current receipt; before the first implementation edit, `build-executor` must run `npx --yes --package @xulthekl/team-flow@0.25.1 tf execution plan <change-dir> --mode <selected> --confirm ...` (and `--acknowledge-recommendation` when the selected mode differs from the recommendation) using matching artifacts, contract, and waves, then `npx --yes --package @xulthekl/team-flow@0.25.1 tf execution show <change-dir> --json`; report the saved revision, selected mode, recommendation alignment, ordered waves, and actual concurrent-dispatch capability. A revision must repeat recommend and confirmation. Do not transition to `executing` until `show` reports `current: true`; then run `... check <dir> approved-for-build executing --json` → fail = BLOCK.
 
 ### Route to bug-investigator
 Execution hit blockage: test failure, unexpected behavior, build error, task cannot proceed. After debugging, route back to build-executor.
 
 ### Route to code-reviewer
-The current planned wave is implemented and ready for spec-compliance + code-quality verification. A reviewer must write an `npx --yes --package @xulthekl/team-flow@0.23.0 tf execution review <change-dir> --wave <id> --base <sha> --head <sha> --report <path> --verdict <pass|fail>` receipt before any dependent wave or closing transition.
+The current planned wave is implemented and ready for spec-compliance + code-quality verification. A reviewer must write an `npx --yes --package @xulthekl/team-flow@0.25.1 tf execution review <change-dir> --wave <id> --base <sha> --head <sha> --report <path> --verdict <pass|fail>` receipt before any dependent wave or closing transition.
 
 ### Route to release-archivist
 Guard: `... check <dir> executing closing --json` → fail = BLOCK. Implementation complete, verification complete/nearly complete. Include `DP-7: 归档确认`.
@@ -90,10 +90,10 @@ uncertainty. Do not create a prototype handoff or enter a prototype worktree
 until the user confirms. After confirmation:
 
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf handoff create <change-dir> \
+npx --yes --package @xulthekl/team-flow@0.25.1 tf handoff create <change-dir> \
   --type prototype --objective "<confirmed objective>" \
   --expected-output "<expected evidence>" --acceptance "<completion criterion>"
-npx --yes --package @xulthekl/team-flow@0.23.0 tf isolate <change-dir> prototype-<handoff-id>
+npx --yes --package @xulthekl/team-flow@0.25.1 tf isolate <change-dir> prototype-<handoff-id>
 ```
 
 Never suggest or enter this route automatically for backend, CLI, configuration,
@@ -107,7 +107,7 @@ work.
 - **Hotfix**: Route to contract-builder (minimal), skip need-explorer + spec-writer, guard check `exploring bridging --workflow hotfix`, then `bridging -> approved-for-build`, after DP-3 → build-executor (recommend, show, and confirm an execution mode), after → release-archivist (lightweight). Hotfix may skip `proposal.md`, `design.md`, `tasks.md`, and `specs/`, but it still requires a fresh minimal `execution-contract.md`, DP-3 approval, and a current execution plan before build. **architecture-design 不豁免**（v0.9 §26）：同样过 architecture-design 子代理判断门，快速判定是否涉及架构变更（hotfix 可能正是架构缺陷导致）
 - **Tweak**: Route to build-executor (direct edit), skip need-explorer + spec-writer + contract-builder, guard check `exploring approved-for-build --workflow tweak`, after → release-archivist (lightweight). **architecture-design 不豁免**（v0.9 §26）：同样过 architecture-design 子代理判断门
 
-Post-transition: 💡 `npx --yes --package @xulthekl/team-flow@0.23.0 tf inject <change-dir>` to update phase-guard artifacts.
+Post-transition: 💡 `npx --yes --package @xulthekl/team-flow@0.25.1 tf inject <change-dir>` to update phase-guard artifacts.
 
 ## Staleness Detection
 
@@ -124,7 +124,7 @@ Use content inspection, not timestamps.
 ## Guardrails
 
 - No implementation before planning artifacts or contract exist
-- No implementation for full/hotfix without a current `npx --yes --package @xulthekl/team-flow@0.23.0 tf execution plan`; no state transition based on an unverified DP-4 string
+- No implementation for full/hotfix without a current `npx --yes --package @xulthekl/team-flow@0.25.1 tf execution plan`; no state transition based on an unverified DP-4 string
 - No "continue" without state inspection
 - No implementation past stale contract
 - No implementation past bug without investigation

package/skills/workflow-start/references/routing-rules.md

@@ -32,17 +32,17 @@ artifacts:                       # required 时必填
 - `null`（未判定）→ **BLOCK**
 
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> arch_design_decision "<required|skipped>"
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> arch_design_reason "<reason>"
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> arch_design_timestamp $(date -u +%Y-%m-%dT%H:%M:%SZ)
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> arch_design_decision "<required|skipped>"
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> arch_design_reason "<reason>"
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> arch_design_timestamp $(date -u +%Y-%m-%dT%H:%M:%SZ)
 # if required:
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> arch_design_artifacts "architecture/architecture.md,architecture/database.md,architecture/api.md"
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> arch_design_artifacts "architecture/architecture.md,architecture/database.md,architecture/api.md"
 ```
 
 **hotfix / tweak 不豁免**：同样过 architecture-design 子代理判断门。
 
 ## Route to spec-writer
-Guard: `npx --yes --package @xulthekl/team-flow@0.23.0 tf runtime guard check <dir> exploring specifying --json` → fail = BLOCK.
+Guard: `npx --yes --package @xulthekl/team-flow@0.25.1 tf runtime guard check <dir> exploring specifying --json` → fail = BLOCK.
 **arch_design_decision must not be null** → fail = BLOCK（architecture-design gate not passed，v0.9 §26）。
 User knows what they want, artifacts missing/incomplete.
 
@@ -55,12 +55,12 @@ Contract exists and approved, contract matches artifacts. Include DP-4: 执行
 
 Propose waves, run:
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf execution recommend <change-dir> [--wave ...]
+npx --yes --package @xulthekl/team-flow@0.25.1 tf execution recommend <change-dir> [--wave ...]
 ```
 Show every available mode plus evidence and recommendation, obtain clear selection. Then:
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf execution plan <change-dir> --mode <selected> --confirm ...
-npx --yes --package @xulthekl/team-flow@0.23.0 tf execution show <change-dir> --json
+npx --yes --package @xulthekl/team-flow@0.25.1 tf execution plan <change-dir> --mode <selected> --confirm ...
+npx --yes --package @xulthekl/team-flow@0.25.1 tf execution show <change-dir> --json
 ```
 Do not transition to `executing` until `show` reports `current: true`.
 Guard: `... check <dir> approved-for-build executing --json` → fail = BLOCK.
@@ -71,7 +71,7 @@ Execution hit blockage: test failure, unexpected behavior, build error. After de
 ## Route to code-reviewer
 Current planned wave implemented and ready for review. Reviewer must write:
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf execution review <change-dir> --wave <id> --base <sha> --head <sha> --report <path> --verdict <pass|fail>
+npx --yes --package @xulthekl/team-flow@0.25.1 tf execution review <change-dir> --wave <id> --base <sha> --head <sha> --report <path> --verdict <pass|fail>
 ```
 
 ## Route to release-archivist
@@ -93,10 +93,10 @@ User explicitly requests, bug-investigator escalates after 3+ failures AND user
 
 When the user's brief explicitly contains UI/screen/interaction/layout/UX uncertainty, ask once whether a prototype would reduce uncertainty. After confirmation:
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf handoff create <change-dir> \
+npx --yes --package @xulthekl/team-flow@0.25.1 tf handoff create <change-dir> \
   --type prototype --objective "<confirmed objective>" \
   --expected-output "<expected evidence>" --acceptance "<completion criterion>"
-npx --yes --package @xulthekl/team-flow@0.23.0 tf isolate <change-dir> prototype-<handoff-id>
+npx --yes --package @xulthekl/team-flow@0.25.1 tf isolate <change-dir> prototype-<handoff-id>
 ```
 Never suggest for backend/CLI/config/internal-refactor work. Never pass `--force`.
 
@@ -130,17 +130,17 @@ else:
 
 After confirmation:
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_decisions "<summary>"
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_result confirmed
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_confirmed true
-npx --yes --package @xulthekl/team-flow@0.23.0 tf state set <change-dir> dp_0_timestamp $(date -u +%Y-%m-%dT%H:%M:%SZ)
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_decisions "<summary>"
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_result confirmed
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_confirmed true
+npx --yes --package @xulthekl/team-flow@0.25.1 tf state set <change-dir> dp_0_timestamp $(date -u +%Y-%m-%dT%H:%M:%SZ)
 ```
 
 ## Mode Detection
 
 If workflow is `auto`/`null`/unset:
 ```bash
-npx --yes --package @xulthekl/team-flow@0.23.0 tf runtime infer <change-dir>
+npx --yes --package @xulthekl/team-flow@0.25.1 tf runtime infer <change-dir>
 ```
 Inference: **hotfix** (≤2 tasks, ≤2 files, no schema/API/new modules), **tweak** (≤4 tasks, config/doc only), **full** (anything larger).
 
@@ -152,4 +152,4 @@ Inference: **hotfix** (≤2 tasks, ≤2 files, no schema/API/new modules), **twe
 - **Brief drift (advisory, v0.9)**: change-brief.md 的 `plan_hash` 与当前 plan.md 不一致 → 提示回 orchestrator 重新分发；**不**阻断、**不**进 artifacts_hash、**不**混入上述三条产物互查
 
 ## Post-transition
-💡 `npx --yes --package @xulthekl/team-flow@0.23.0 tf inject <change-dir>` to update phase-guard artifacts.
+💡 `npx --yes --package @xulthekl/team-flow@0.25.1 tf inject <change-dir>` to update phase-guard artifacts.

package/templates/prd-brainstorm-profile.md

@@ -0,0 +1,69 @@
+# PRD Brainstorm Profile: GTMC D7 业务要件
+
+本文件定义 ce-brainstorm Phase 2 方案探索的**产品维度锚点**。
+Phase 2 产出的每个方案必须覆盖核心维度，按需覆盖扩展维度，不得越入反例边界。
+
+## 核心思考维度（每个方案必须覆盖）
+
+| 维度 | 对应 PRD 章节 | 引导问题 |
+|------|-------------|---------|
+| 业务流程 | §2 业务流程一览 + §3 D7.1 | 完整的业务操作流程是什么？L1分类→L2分组→L3流程→L4子流程分别是什么？ |
+| 状态模型 | §3（流程步骤中的状态流转） | 核心实体有哪些状态？状态之间如何流转？触发条件和约束是什么？ |
+| 权限模型 | §8.2.1 权限说明 | 谁（用户类型）在什么条件下能做什么操作？登录前/后有区别吗？ |
+| 用户角色 | §8.2.1 + §10.4.1 项目体制 | 系统有哪些使用者类型？各自职责？与画面如何映射？ |
+| 数据关系 | §4.3 信息结构图 | 核心业务实体之间的关联规则是什么？实体间的层级/归属/引用关系？ |
+| 业务规则 | §8.2.4 其他机制与规则 | 排序规则？搜索规则？加载机制？异常处理？校验逻辑？ |
+| 系统功能 | §7 D7.5 系统功能清单 | 需要哪些功能点？每个功能点关联哪个业务流程/活动？ |
+
+## 扩展思考维度（按需触发）
+
+| 维度 | 触发条件 | 对应 PRD 章节 | 引导问题 |
+|------|---------|-------------|---------|
+| 画面设计 | 涉及 UI 交互 | §4 D7.2 | 画面结构如何？页面间如何迁移？ |
+| 业务术语 | 出现领域专有名词 | §6 D7.4 | 哪些术语需要统一定义？有无同义词？ |
+| 报表需求 | 用户提到"报表/统计/分析" | §5 D7.3 | 需要哪些报表？关联哪些流程和数据？ |
+| 交互机制 | 有特殊交互需求 | §8.2.2 | 键盘/画面/弹层交互细节？ |
+| 非功能性需求 | 有性能/安全/可用性要求 | §8.5 | 响应时间？并发数？安全要求？ |
+| 编码规则 | 有自动编号需求 | §8.7 | 编号规则是什么？自动生成还是手工？ |
+
+## 反例边界（Phase 2 禁止产出）
+
+以下内容属于 ce-plan（技术实施阶段），在 Phase 2 方案探索中**不应包含**：
+
+- 后端模块划分（如：domainpolicy/、deptpolicy/）
+- 前端页面/组件结构（如：views/policy/domainPolicy.vue）
+- 数据库表设计（表名、字段名、索引、物理模型）
+- API 接口定义（路径、参数、响应结构）
+- 技术选型（框架、库、中间件选择）
+- 部署架构（服务器、容器、网络拓扑）
+- 代码结构（类名、方法名、包结构）
+
+## 正向示例
+
+**正确的产品方案输出**（以"方针管理"为例）：
+
+> **方案 A：集中式方针管理**
+> - 业务流程：方针创建→内容填写→提交审批→审批通过→发布上线→定期回顾→停用/续期
+> - 状态模型：草稿（可编辑）→ 待审批（锁定）→ 已发布（只读）→ 已停用 → 可续期为新草稿
+> - 权限模型：管理员（全流程操作）、部门负责人（创建+编辑本部门）、普通用户（查看已发布）
+> - 业务规则：每个年度只能有一条有效方针；发布后不可编辑，需停用后创建新版本
+>
+> **方案 B：分布式方针管理**
+> - 业务流程：部门自主创建→部门内审批→自动发布→总部可抽查
+> - 状态模型：草稿 → 部门审批中 → 已发布 → 已归档
+> - ...
+
+**错误的技术方案输出**（Phase 2 不应出现）：
+
+> ~~方案采用标准分离式实现：~~
+> ~~后端模块：domainpolicy/（领域方针）、deptpolicy/（部门方针）~~
+> ~~数据库表：t_domain_policy（id, name, status, created_by...）~~
+> ~~前端页面：views/policy/domainPolicy.vue~~
+
+## 自定义 Profile
+
+创建新 PRD 模板时，应同步创建对应的 brainstorm profile：
+
+1. 文件命名：`<模板名>-brainstorm-profile.md`（与模板同目录）
+2. 三段结构：核心维度（必选覆盖）+ 扩展维度（按需触发）+ 反例边界（禁止越界）
+3. 未配套 profile 的模板将使用本文件（内置默认）——维度可能不匹配

package/tests/lib/guard-compound-captured.test.mjs

@@ -0,0 +1,92 @@
+// tests/lib/guard-compound-captured.test.mjs
+// v0.24.0: compound-captured guard — executing:closing must require learnings.md
+// or explicit compound_skipped=true in state.
+
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, writeFileSync, rmSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..', '..');
+
+// Import the check function directly for unit-level testing.
+const { checkCompoundCaptured } = await import(
+  join(ROOT, 'scripts', 'guard', 'checks', 'compound-captured.mjs')
+);
+
+function makeDir(prefix) {
+  return mkdtempSync(join(tmpdir(), `tf-compound-${prefix}-`));
+}
+
+function cleanup(dir) {
+  if (existsSync(dir)) rmSync(dir, { recursive: true, force: true });
+}
+
+describe('compound-captured guard', () => {
+  describe('learnings.md existence', () => {
+    let dir;
+    before(() => { dir = makeDir('learnings'); });
+    after(() => cleanup(dir));
+
+    it('SHALL fail when no learnings.md and no compound_skipped', () => {
+      writeFileSync(join(dir, '.team-flow.yaml'), 'state: executing\nworkflow: full\n');
+      const result = checkCompoundCaptured(dir);
+      assert.equal(result.pass, false);
+      assert.ok(result.failures.length > 0);
+      assert.match(result.failures[0], /Compound capture missing/);
+    });
+
+    it('SHALL pass when learnings.md exists and is non-empty', () => {
+      writeFileSync(join(dir, 'learnings.md'), '# Session Learnings\n\n## Lesson 1\nTest.\n');
+      const result = checkCompoundCaptured(dir);
+      assert.equal(result.pass, true);
+    });
+
+    it('SHALL fail when learnings.md exists but is empty', () => {
+      writeFileSync(join(dir, 'learnings.md'), '');
+      const result = checkCompoundCaptured(dir);
+      assert.equal(result.pass, false);
+      assert.match(result.failures[0], /empty/);
+    });
+  });
+
+  describe('compound_skipped explicit opt-out', () => {
+    let dir;
+    before(() => { dir = makeDir('skip'); });
+    after(() => cleanup(dir));
+
+    it('SHALL pass when compound_skipped=true and no learnings.md', () => {
+      writeFileSync(join(dir, '.team-flow.yaml'), 'state: executing\nworkflow: full\ncompound_skipped: true\n');
+      const result = checkCompoundCaptured(dir);
+      assert.equal(result.pass, true);
+    });
+
+    it('SHALL fail when compound_skipped=false (not opted out)', () => {
+      writeFileSync(join(dir, '.team-flow.yaml'), 'state: executing\nworkflow: full\ncompound_skipped: false\n');
+      const result = checkCompoundCaptured(dir);
+      assert.equal(result.pass, false);
+    });
+  });
+
+  describe('no state file (backward compatibility)', () => {
+    let dir;
+    before(() => { dir = makeDir('no-state'); });
+    after(() => cleanup(dir));
+
+    it('SHALL fail when no state file and no learnings.md', () => {
+      // No .team-flow.yaml, no learnings.md — guard should still fail
+      const result = checkCompoundCaptured(dir);
+      assert.equal(result.pass, false);
+    });
+
+    it('SHALL pass when no state file but learnings.md exists', () => {
+      writeFileSync(join(dir, 'learnings.md'), '# Learnings\nContent.\n');
+      const result = checkCompoundCaptured(dir);
+      assert.equal(result.pass, true);
+    });
+  });
+});

package/tests/lib/guard-specs-merged.test.mjs

@@ -27,6 +27,8 @@ function makeChangeDir(withDelta) {
     ? '## ADDED Requirements\n\n### Requirement: New\n\nThe system SHALL do new.\n\n#### Scenario: New\n- **WHEN** x\n- **THEN** y\n'
     : '## Requirements\n\n### Requirement: Existing\n\nThe system SHALL exist.\n\n#### Scenario: Existing\n- **WHEN** a\n- **THEN** b\n';
   writeFileSync(join(dir, 'specs', 'test.md'), specsContent);
+  // v0.24.0: compound-captured dimension requires learnings.md
+  writeFileSync(join(dir, 'learnings.md'), '# Session Learnings\n\n## Lesson 1\nTest.\n');
   initializeGitRepository(dir);
   return dir;
 }

package/tests/lib/guard-tests-passing.test.mjs

@@ -25,6 +25,8 @@ function makeChangeDir() {
   writeFileSync(join(dir, 'tasks.md'), '# Tasks\n\n- [x] Task 1\n- [x] Task 2\n');
   writeFileSync(join(dir, 'specs', 'test.md'), '## ADDED Requirements\n\n### Requirement: Test\n\nThe system SHALL test.\n\n#### Scenario: Test\n- **WHEN** test\n- **THEN** test\n');
   writeFileSync(join(dir, 'execution-contract.md'), '# Execution Contract\n\n## Intent Lock\nTest.\n');
+  // v0.24.0: compound-captured dimension requires learnings.md
+  writeFileSync(join(dir, 'learnings.md'), '# Session Learnings\n\n## Lesson 1\nTest.\n');
   initializeGitRepository(dir);
   return dir;
 }

package/tests/lib/guard.test.mjs

@@ -312,6 +312,8 @@ describe('guard: execution control records', () => {
   function recordPassingClosingPrerequisites() {
     runNodeScript(CLI_PATH, ['state', 'set', dir, 'test_result', 'pass: unit tests']);
     runNodeScript(CLI_PATH, ['state', 'set', dir, 'spec_merged', 'true']);
+    // v0.24.0: compound-captured dimension requires learnings.md (or explicit skip)
+    writeFileSync(join(dir, 'learnings.md'), '# Session Learnings\n\n## Lesson 1\nCaptured during guard test.\n');
   }
 
   function writeReviewReport(name, content = 'Review completed without blocking findings.\n') {