@michelj/context-guard 0.4.2 → 0.4.3

package/tests/BC-20260707-131.sh

@@ -0,0 +1,140 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/context_guard.py"
+ROOT="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-lifecycle-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+mkdir -p "$ROOT/.codex/context/test-hub/fixtures"
+
+PROPOSE_OUT="$ROOT/propose.out"
+PLAN_OUT="$ROOT/plan.out"
+ATTACH_OUT="$ROOT/attach.out"
+SUMMARY_OUT="$ROOT/summary.out"
+OVERLAP_OUT="$ROOT/overlap.out"
+APPROVE_OUT="$ROOT/approve.out"
+COMPLETE_OUT="$ROOT/dev-complete.out"
+
+python3 "$SCRIPT" feature-chain-plan \
+  --root "$ROOT" \
+  --query "创建一个测试任务：从编辑器输入 Markdown 到预览正确渲染，主要验证公式渲染回归" >"$PLAN_OUT"
+
+grep -q "after-confirmation command: .*feature-chain-propose" "$PLAN_OUT"
+grep -q -- "--coverage-pending-reason" "$PLAN_OUT"
+
+python3 "$SCRIPT" feature-chain-propose \
+  --root "$ROOT" \
+  --title "Markdown 公式预览" \
+  --entry "编辑器输入 Markdown" \
+  --exit-check "预览正确渲染" \
+  --node-title "公式渲染回归" \
+  --check "单行、多行和矩阵公式都被 MathJax 正常排版" \
+  --coverage-pending-reason "用户先确认功能测试，后续遇到 MathJax 公式渲染 bad case 再挂到 checkpoint" >"$PROPOSE_OUT"
+
+CHAIN_ID="$(grep 'feature chain proposed:' "$PROPOSE_OUT" | awk '{print $NF}')"
+test -n "$CHAIN_ID"
+
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+### BC-20260707-940: Markdown 公式预览没有渲染
+
+- Status: resolved
+- First observed: 2026-07-07
+- Last checked: 2026-07-07
+- Scope: Markdown editor preview
+- Tags: #feature-chain #mathjax #rendering
+- Display summary: Markdown 编辑器里的公式没有被 MathJax 正常渲染。
+- Phenomenon: 单行、多行或矩阵公式在预览里显示为原始文本。
+- Trigger / reproduction: 在编辑器输入 Markdown 公式并打开预览。
+- Root cause: 预览渲染链路没有触发 MathJax 排版。
+- Fix method: 确保预览更新后执行 MathJax typeset。
+- Guard / verification: 功能链 checkpoint 应验证公式预览已渲染。
+- Red condition: 预览仍显示原始公式文本。
+- Green condition: 预览显示排版后的公式。
+- Expected failure reason: 如果公式渲染回归，功能链 checkpoint 会失败。
+MD
+
+python3 "$SCRIPT" feature-chain-plan --root "$ROOT" --query "BC-20260707-940" >"$PLAN_OUT"
+grep -q "action: review-existing-chain" "$PLAN_OUT"
+grep -q "$CHAIN_ID" "$PLAN_OUT"
+grep -q "checkpoint: 公式渲染回归" "$PLAN_OUT"
+grep -q "after-confirmation command: .*feature-chain-attach-bc" "$PLAN_OUT"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "公式渲染回归" \
+  --bad-case "BC-20260707-940" \
+  --check "公式预览必须触发 MathJax 排版" >"$ATTACH_OUT"
+
+python3 "$SCRIPT" feature-chain-summary --root "$ROOT" >"$SUMMARY_OUT"
+grep -q "chains: 1" "$SUMMARY_OUT"
+grep -q "covered bad cases: 1" "$SUMMARY_OUT"
+grep -q "Markdown 公式预览没有渲染" "$SUMMARY_OUT"
+grep -q "coverage density:" "$SUMMARY_OUT"
+if grep -q "coverage pending" "$SUMMARY_OUT"; then
+  cat "$SUMMARY_OUT"
+  exit 1
+fi
+
+python3 "$SCRIPT" feature-chain-propose \
+  --root "$ROOT" \
+  --title "Markdown 数学公式渲染" \
+  --entry "编辑器输入 Markdown" \
+  --exit-check "预览正确渲染" \
+  --node-title "数学公式预览稳定" \
+  --bad-cases "BC-20260707-941" \
+  --check "公式预览不会显示原始文本" >/dev/null
+
+python3 "$SCRIPT" feature-chain-overlap --root "$ROOT" --min-score 4 >"$OVERLAP_OUT"
+grep -q "overlapping candidates: 1" "$OVERLAP_OUT"
+grep -q "Markdown 公式预览" "$OVERLAP_OUT"
+grep -q "Markdown 数学公式渲染" "$OVERLAP_OUT"
+
+cat >"$ROOT/.codex/context/test-hub/fixtures/markdown_preview_chain.sh" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:公式渲染回归:PASS"
+SH
+chmod +x "$ROOT/.codex/context/test-hub/fixtures/markdown_preview_chain.sh"
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "bash .codex/context/test-hub/fixtures/markdown_preview_chain.sh" >"$APPROVE_OUT"
+
+grep -q "feature chain approved: $CHAIN_ID" "$APPROVE_OUT"
+grep -q "approval dry-run: passed" "$APPROVE_OUT"
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$COMPLETE_OUT"
+grep -q "test hub: 1 passed, 0 failed, 0 blocked" "$COMPLETE_OUT"
+grep -q "passed: Markdown 公式预览" "$COMPLETE_OUT"
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" "$ROOT/.codex/context/test-hub/last-run.json" "$CHAIN_ID" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+chains_path = Path(sys.argv[1])
+run_path = Path(sys.argv[2])
+chain_id = sys.argv[3]
+
+chains = json.loads(chains_path.read_text(encoding="utf-8"))["chains"]
+chain = next(item for item in chains if item["id"] == chain_id)
+assert chain["status"] == "approved", chain
+assert chain["run_policy"] == "every-dev-completion", chain
+node = chain["nodes"][0]
+assert node["title"] == "公式渲染回归", node
+assert "BC-20260707-940" in node["bad_cases"], node
+assert "coverage_pending_reason" not in node, node
+
+last_run = json.loads(run_path.read_text(encoding="utf-8"))
+results = last_run.get("results", [])
+assert len(results) == 1, last_run
+result = results[0]
+assert result["status"] == "passed", result
+assert any(item.get("label") == "公式渲染回归" and item.get("status") == "pass" for item in result.get("checkpoints", [])), result
+PY
+
+python3 "$SCRIPT" validate-feature-chains --root "$ROOT" >"$ROOT/validate.out"
+grep -q "feature-chain validation passed: 2 chain(s), 0 warning(s)" "$ROOT/validate.out"

package/tests/BC-20260707-132.sh

@@ -0,0 +1,150 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/context_guard.py}"
+ROOT="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-rerun-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+mkdir -p "$ROOT/.codex/context/test-hub/fixtures"
+
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+### BC-20260707-950: Markdown 公式输入没有进入预览流程
+
+- Status: resolved
+- First observed: 2026-07-07
+- Last checked: 2026-07-07
+- Scope: Markdown editor preview
+- Tags: #feature-chain #mathjax #input
+- Display summary: 公式输入后预览流程没有被触发。
+- Phenomenon: 用户输入公式后，预览仍停在旧内容。
+- Trigger / reproduction: 在编辑器输入包含公式的 Markdown。
+- Root cause: 输入事件没有触发预览更新。
+- Fix method: 预览链路监听输入并进入渲染流程。
+- Guard / verification: 功能链 checkpoint 检查公式输入进入预览流程。
+- Red condition: 输入公式后预览流程没有执行。
+- Green condition: 输入公式后预览流程开始并进入渲染阶段。
+- Expected failure reason: 输入阶段回归时，功能链第一 checkpoint 会失败。
+
+### BC-20260707-951: Markdown 公式预览仍显示原始文本
+
+- Status: resolved
+- First observed: 2026-07-07
+- Last checked: 2026-07-07
+- Scope: Markdown editor preview
+- Tags: #feature-chain #mathjax #rendering
+- Display summary: 公式预览没有完成 MathJax 渲染。
+- Phenomenon: 预览区显示原始 LaTeX 文本，而不是排版后的公式。
+- Trigger / reproduction: 输入单行、多行或矩阵公式并打开预览。
+- Root cause: 渲染阶段没有执行 MathJax 排版。
+- Fix method: 预览更新后执行 MathJax typeset。
+- Guard / verification: 功能链 checkpoint 检查公式预览已渲染。
+- Red condition: 预览仍显示原始公式文本。
+- Green condition: 预览显示排版后的公式。
+- Expected failure reason: 渲染阶段回归时，功能链第二 checkpoint 会失败。
+MD
+
+PROPOSE_OUT="$ROOT/propose.out"
+python3 "$SCRIPT" feature-chain-propose \
+  --root "$ROOT" \
+  --title "Markdown 公式预览" \
+  --entry "编辑器输入 Markdown 公式" \
+  --exit-check "预览区显示排版后的公式" \
+  --node-title "公式输入进入预览流程" \
+  --bad-cases "BC-20260707-950" \
+  --check "输入公式后预览流程必须开始" >"$PROPOSE_OUT"
+
+CHAIN_ID="$(grep 'feature chain proposed:' "$PROPOSE_OUT" | awk '{print $NF}')"
+test -n "$CHAIN_ID"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "公式预览完成渲染" \
+  --bad-case "BC-20260707-951" \
+  --check "单行、多行和矩阵公式都必须完成 MathJax 排版" >/dev/null
+
+RUNNER="$ROOT/.codex/context/test-hub/fixtures/markdown_formula_flow.sh"
+cat >"$RUNNER" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:公式输入进入预览流程:PASS"
+echo "CG_CHECKPOINT:公式预览完成渲染:PASS"
+SH
+chmod +x "$RUNNER"
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "bash .codex/context/test-hub/fixtures/markdown_formula_flow.sh" >"$ROOT/approve.out"
+grep -q "approval dry-run: passed" "$ROOT/approve.out"
+
+cat >"$RUNNER" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:公式输入进入预览流程:PASS"
+echo "CG_CHECKPOINT:公式预览完成渲染:FAIL:预览仍显示原始公式文本"
+printf "raw formula still visible\n" > "$CONTEXT_GUARD_TEST_RUN_DIR/render-evidence.txt"
+SH
+chmod +x "$RUNNER"
+
+if python3 "$SCRIPT" dev-complete --root "$ROOT" >"$ROOT/fail.out" 2>&1; then
+  cat "$ROOT/fail.out"
+  exit 1
+fi
+grep -q "test hub: 0 passed, 1 failed, 0 blocked" "$ROOT/fail.out"
+grep -q "checkpoint failed: 公式预览完成渲染 - 预览仍显示原始公式文本" "$ROOT/fail.out"
+grep -q "evidence preserved" "$ROOT/fail.out"
+
+python3 - "$ROOT/.codex/context/test-hub/last-run.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+run = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
+result = run["results"][0]
+assert result["status"] == "failed", result
+assert result["reason"] == "checkpoint failed: 公式预览完成渲染 - 预览仍显示原始公式文本", result
+labels = [item["label"] for item in result["checkpoints"]]
+assert labels == ["公式输入进入预览流程", "公式预览完成渲染"], labels
+log_path = Path(result["log"])
+assert log_path.exists(), log_path
+evidence = log_path.parent / "render-evidence.txt"
+assert evidence.exists(), evidence
+assert "raw formula" in evidence.read_text(encoding="utf-8")
+PY
+
+cat >"$RUNNER" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:公式输入进入预览流程:PASS"
+echo "CG_CHECKPOINT:公式预览完成渲染:PASS"
+printf "temporary success artifact\n" > "$CONTEXT_GUARD_TEST_RUN_DIR/success.tmp"
+SH
+chmod +x "$RUNNER"
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$ROOT/pass.out"
+grep -q "test hub: 1 passed, 0 failed, 0 blocked" "$ROOT/pass.out"
+grep -q "success artifacts cleaned" "$ROOT/pass.out"
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" "$ROOT/.codex/context/test-hub/last-run.json" "$CHAIN_ID" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+chains = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["chains"]
+chain = next(item for item in chains if item["id"] == sys.argv[3])
+assert chain["status"] == "approved", chain
+assert chain["run_policy"] == "every-dev-completion", chain
+covered = sorted(bc for node in chain["nodes"] for bc in node["bad_cases"])
+assert covered == ["BC-20260707-950", "BC-20260707-951"], covered
+
+last_run = json.loads(Path(sys.argv[2]).read_text(encoding="utf-8"))
+result = last_run["results"][0]
+assert result["status"] == "passed", result
+assert result["missing_checkpoints"] == [], result
+assert all(item["status"] == "pass" for item in result["checkpoints"]), result
+PY
+
+python3 "$SCRIPT" validate-feature-chains --root "$ROOT" >"$ROOT/validate.out"
+grep -q "feature-chain validation passed: 1 chain(s), 0 warning(s)" "$ROOT/validate.out"

package/tests/BC-20260707-133.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/context_guard.py}"
+ROOT="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-dry-run-id-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+### BC-20260707-960: Dry-run 证据目录可能撞名
+
+- Status: resolved
+- First observed: 2026-07-07
+- Last checked: 2026-07-07
+- Scope: Context Guard Test Hub dry-run evidence
+- Tags: #feature-chain #test-hub #artifact-policy
+- Display summary: 快速连续 dry-run 不应把失败证据写到同一个目录。
+- Phenomenon: 秒级 run id 可能让同一条功能链的多次 dry-run 复用同一个 evidence path。
+- Trigger / reproduction: 快速连续运行两次失败的 `feature-chain-dry-run`。
+- Root cause: dry-run 目录名只使用秒级时间戳。
+- Fix method: dry-run/run 目录名改用微秒级唯一 run id。
+- Guard / verification: 快速连续失败 dry-run 应保留两个不同 evidence 目录。
+- Red condition: 两次失败 dry-run 输出相同 evidence preserved 路径。
+- Green condition: 两次失败 dry-run 输出不同 evidence preserved 路径，且目录都存在。
+- Expected failure reason: 证据路径撞名会覆盖或混杂失败日志，让 Codex 误判坏在哪个 checkpoint。
+MD
+
+PROPOSE_OUT="$ROOT/propose.out"
+python3 "$SCRIPT" feature-chain-propose \
+  --root "$ROOT" \
+  --title "Markdown 公式预览" \
+  --entry "输入 Markdown 公式" \
+  --exit-check "预览渲染公式" \
+  --node-title "公式预览完成渲染" \
+  --bad-cases "BC-20260707-960" \
+  --check "公式预览必须完成渲染" >"$PROPOSE_OUT"
+
+CHAIN_ID="$(grep 'feature chain proposed:' "$PROPOSE_OUT" | awk '{print $NF}')"
+test -n "$CHAIN_ID"
+
+set +e
+python3 "$SCRIPT" feature-chain-dry-run \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'CG_CHECKPOINT:公式预览完成渲染:FAIL:第一次失败\\n'" >"$ROOT/fail-1.out" 2>&1
+STATUS_ONE=$?
+python3 "$SCRIPT" feature-chain-dry-run \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'CG_CHECKPOINT:公式预览完成渲染:FAIL:第二次失败\\n'" >"$ROOT/fail-2.out" 2>&1
+STATUS_TWO=$?
+set -e
+
+test "$STATUS_ONE" -ne 0
+test "$STATUS_TWO" -ne 0
+
+DIR_ONE="$(sed -n 's/.*dry-run evidence preserved: //p' "$ROOT/fail-1.out" | tail -n 1)"
+DIR_TWO="$(sed -n 's/.*dry-run evidence preserved: //p' "$ROOT/fail-2.out" | tail -n 1)"
+test -n "$DIR_ONE"
+test -n "$DIR_TWO"
+test "$DIR_ONE" != "$DIR_TWO"
+test -d "$DIR_ONE"
+test -d "$DIR_TWO"
+
+grep -q "第一次失败" "$DIR_ONE/$CHAIN_ID.log"
+grep -q "第二次失败" "$DIR_TWO/$CHAIN_ID.log"
+
+python3 "$SCRIPT" validate-feature-chains --root "$ROOT" >"$ROOT/validate.out"
+grep -q "feature-chain validation passed: 1 chain(s), 0 warning(s)" "$ROOT/validate.out"

package/tests/BC-20260708-136.sh

@@ -0,0 +1,210 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/context_guard.py}"
+ROOT="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-multi-chain-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+mkdir -p "$ROOT/.codex/context/test-hub/fixtures"
+
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+### BC-20260708-960: 晚间清单漏勾仍显示完成
+
+- Status: resolved
+- First observed: 2026-07-08
+- Last checked: 2026-07-08
+- Scope: Evening reset checklist
+- Tags: #feature-chain #life
+- Display summary: 晚间收纳清单不能在漏勾时显示完成。
+- Phenomenon: 用户只勾选部分事项，页面仍显示今晚重置完成。
+- Trigger / reproduction: 打开晚间重置清单，少勾一项后点击完成。
+- Root cause: 完成判断只看点击事件，没有检查全部事项。
+- Fix method: 完成前检查所有事项。
+- Guard / verification: 功能链 checkpoint 检查提前完成被阻止。
+- Red condition: 漏勾仍显示完成。
+- Green condition: 漏勾时提示未完成。
+- Expected failure reason: 完成判断回归时，生活清单功能链会失败。
+
+### BC-20260708-961: 晚间清单完成后没有保存
+
+- Status: resolved
+- First observed: 2026-07-08
+- Last checked: 2026-07-08
+- Scope: Evening reset checklist
+- Tags: #feature-chain #life #persistence
+- Display summary: 晚间收纳清单完成后必须保存结果。
+- Phenomenon: 页面显示完成，但刷新或读取状态时没有保存完成记录。
+- Trigger / reproduction: 勾选全部事项并点击完成。
+- Root cause: UI 状态更新后没有写入 localStorage。
+- Fix method: 完成时写入 completed/count/total。
+- Guard / verification: 功能链 checkpoint 检查完成结果已保存。
+- Red condition: 完成后没有保存状态。
+- Green condition: 完成后保存 completed=true 且数量正确。
+- Expected failure reason: 保存回归时，生活清单功能链会失败。
+
+### BC-20260708-962: 角色卡空白名字生成空主角
+
+- Status: resolved
+- First observed: 2026-07-08
+- Last checked: 2026-07-08
+- Scope: Story character card generator
+- Tags: #feature-chain #creative
+- Display summary: 角色卡生成器不能把空白名字直接写成空主角。
+- Phenomenon: 用户没填角色名时，生成文本出现空主角字段。
+- Trigger / reproduction: 只填写少量线索并点击生成角色卡。
+- Root cause: 输入规范化缺失。
+- Fix method: 空白角色名使用可读默认名。
+- Guard / verification: 功能链 checkpoint 检查输入被规范化。
+- Red condition: 空白角色名进入最终文本。
+- Green condition: 空白角色名被规范化为可读默认名。
+- Expected failure reason: 输入规范化回归时，创作工具功能链会失败。
+
+### BC-20260708-963: 角色卡重复生成不稳定
+
+- Status: resolved
+- First observed: 2026-07-08
+- Last checked: 2026-07-08
+- Scope: Story character card generator
+- Tags: #feature-chain #creative #determinism
+- Display summary: 相同线索重复生成角色卡时输出应稳定。
+- Phenomenon: 用户用相同线索重复点击生成，角色卡文本不断变化。
+- Trigger / reproduction: 相同输入连续点击生成角色卡。
+- Root cause: 输出生成缺少稳定规则。
+- Fix method: 对同一输入使用确定性结构。
+- Guard / verification: 功能链 checkpoint 检查最终文本稳定可复制。
+- Red condition: 同一输入重复生成不同结果。
+- Green condition: 同一输入重复生成完全一致。
+- Expected failure reason: 稳定性回归时，创作工具功能链会失败。
+MD
+
+propose_life="$ROOT/propose-life.out"
+python3 "$SCRIPT" feature-chain-propose \
+  --root "$ROOT" \
+  --title "晚间收纳重置" \
+  --entry "勾选晚间收纳事项并点击完成" \
+  --exit-check "页面显示 3/3 完成并保存状态" \
+  --node-title "阻止提前完成" \
+  --bad-cases "BC-20260708-960" \
+  --check "漏勾任一事项时不能显示完成" >"$propose_life"
+life_id="$(grep 'feature chain proposed:' "$propose_life" | awk '{print $NF}')"
+test -n "$life_id"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$life_id" \
+  --node-title "保存完成结果" \
+  --bad-case "BC-20260708-961" \
+  --check "完成后必须保存 completed=true 且 count=3 total=3" >/dev/null
+
+propose_story="$ROOT/propose-story.out"
+python3 "$SCRIPT" feature-chain-propose \
+  --root "$ROOT" \
+  --title "故事角色卡生成" \
+  --entry "填写线索并点击生成角色卡" \
+  --exit-check "生成稳定、完整、可复制的角色卡" \
+  --node-title "输入被规范化" \
+  --bad-cases "BC-20260708-962" \
+  --check "空白角色名必须被规范化为可读默认名" >"$propose_story"
+story_id="$(grep 'feature chain proposed:' "$propose_story" | awk '{print $NF}')"
+test -n "$story_id"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$story_id" \
+  --node-title "最终文本稳定可复制" \
+  --bad-case "BC-20260708-963" \
+  --check "同一输入重复生成必须输出一致" >/dev/null
+
+life_runner="$ROOT/.codex/context/test-hub/fixtures/life_chain.sh"
+story_runner="$ROOT/.codex/context/test-hub/fixtures/story_chain.sh"
+
+cat >"$life_runner" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:阻止提前完成:PASS"
+echo "CG_CHECKPOINT:保存完成结果:PASS"
+SH
+chmod +x "$life_runner"
+
+cat >"$story_runner" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:输入被规范化:PASS"
+echo "CG_CHECKPOINT:最终文本稳定可复制:PASS"
+SH
+chmod +x "$story_runner"
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$life_id" \
+  --command-text "bash .codex/context/test-hub/fixtures/life_chain.sh" >"$ROOT/approve-life.out"
+grep -q "approval dry-run: passed" "$ROOT/approve-life.out"
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$story_id" \
+  --command-text "bash .codex/context/test-hub/fixtures/story_chain.sh" >"$ROOT/approve-story.out"
+grep -q "approval dry-run: passed" "$ROOT/approve-story.out"
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$ROOT/pass-two.out"
+grep -q "test hub: 2 passed, 0 failed, 0 blocked" "$ROOT/pass-two.out"
+grep -q "passed: 晚间收纳重置" "$ROOT/pass-two.out"
+grep -q "passed: 故事角色卡生成" "$ROOT/pass-two.out"
+grep -q "success artifacts cleaned" "$ROOT/pass-two.out"
+
+cat >"$story_runner" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:输入被规范化:PASS"
+echo "CG_CHECKPOINT:最终文本稳定可复制:FAIL:相同线索重复生成了不同角色卡"
+printf "story output drifted\n" > "$CONTEXT_GUARD_TEST_RUN_DIR/story-drift.txt"
+SH
+chmod +x "$story_runner"
+
+if python3 "$SCRIPT" dev-complete --root "$ROOT" >"$ROOT/fail-one.out" 2>&1; then
+  cat "$ROOT/fail-one.out"
+  exit 1
+fi
+grep -q "test hub: 1 passed, 1 failed, 0 blocked" "$ROOT/fail-one.out"
+grep -q "passed: 晚间收纳重置" "$ROOT/fail-one.out"
+grep -q "failed: 故事角色卡生成 (checkpoint failed: 最终文本稳定可复制 - 相同线索重复生成了不同角色卡)" "$ROOT/fail-one.out"
+grep -q "evidence preserved" "$ROOT/fail-one.out"
+
+python3 - "$ROOT/.codex/context/test-hub/last-run.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+run = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
+results = {item["title"]: item for item in run["results"]}
+assert results["晚间收纳重置"]["status"] == "passed", results
+story = results["故事角色卡生成"]
+assert story["status"] == "failed", story
+assert story["reason"] == "checkpoint failed: 最终文本稳定可复制 - 相同线索重复生成了不同角色卡", story
+assert [c["label"] for c in story["checkpoints"]] == ["输入被规范化", "最终文本稳定可复制"], story
+evidence = Path(story["log"]).parent / "story-drift.txt"
+assert evidence.exists(), evidence
+assert "story output drifted" in evidence.read_text(encoding="utf-8")
+PY
+
+cat >"$story_runner" <<'SH'
+#!/usr/bin/env bash
+set -euo pipefail
+echo "CG_CHECKPOINT:输入被规范化:PASS"
+echo "CG_CHECKPOINT:最终文本稳定可复制:PASS"
+SH
+chmod +x "$story_runner"
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$ROOT/final-pass.out"
+grep -q "test hub: 2 passed, 0 failed, 0 blocked" "$ROOT/final-pass.out"
+grep -q "success artifacts cleaned" "$ROOT/final-pass.out"
+
+python3 "$SCRIPT" feature-chain-summary --root "$ROOT" >"$ROOT/summary.out"
+grep -q "chains: 2" "$ROOT/summary.out"
+grep -q "covered bad cases: 4" "$ROOT/summary.out"
+grep -q "coverage density: 2.0 bad case(s) per covered chain" "$ROOT/summary.out"
+grep -q "reuse signal: one workflow covers up to 2 bad case(s)" "$ROOT/summary.out"
+
+python3 "$SCRIPT" validate-feature-chains --root "$ROOT" >"$ROOT/validate.out"
+grep -q "feature-chain validation passed: 2 chain(s), 0 warning(s)" "$ROOT/validate.out"