@michelj/context-guard 0.4.2 → 0.4.3

package/tests/BC-20260707-109.sh

@@ -0,0 +1,56 @@
+#!/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-test-hub-feature-policy-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" show-test-hub --root "$ROOT" >"$OUT"
+HTML_PATH="$(tail -1 "$OUT")"
+if grep -q "检查点策略" "$HTML_PATH"; then
+  cat "$HTML_PATH"
+  exit 1
+fi
+
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "GPU 监控按钮" \
+  --entry "点击 GPU 监控按钮" \
+  --exit-check "打开包含有效 grafana_url 的监控页")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "后端返回监控 URL" \
+  --bad-case "BC-20260707-109" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --bad-case "BC-20260707-109" \
+  --check "点击后进入监控页" >/dev/null
+
+python3 "$SCRIPT" feature-chain-set-checkpoint \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --required optional \
+  --reason "浏览器环境才运行" >/dev/null
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'CG_CHECKPOINT:后端返回监控 URL:PASS\n'" >/dev/null
+
+python3 "$SCRIPT" show-test-hub --root "$ROOT" >"$OUT"
+HTML_PATH="$(tail -1 "$OUT")"
+
+grep -q "检查点策略：1 必跑 / 1 可选" "$HTML_PATH"
+grep -q "后端返回监控 URL" "$HTML_PATH"
+grep -q "前端打开监控页" "$HTML_PATH"
+grep -q "浏览器环境才运行" "$HTML_PATH"

package/tests/BC-20260707-110.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SKILL_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SCRIPT="$SKILL_ROOT/scripts/context_guard.py"
+HOOK="$SKILL_ROOT/scripts/context_guard_hook.py"
+ROOT="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-summary-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "GPU 监控按钮" \
+  --entry "点击 GPU 监控按钮" \
+  --exit-check "打开包含有效 grafana_url 的监控页")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "后端返回监控 URL" \
+  --bad-case "BC-20260707-110" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --bad-case "BC-20260707-110" \
+  --check "点击后进入监控页" >/dev/null
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" "$CHAIN_ID" <<'PY'
+from pathlib import Path
+import json
+import sys
+path = Path(sys.argv[1])
+chain_id = sys.argv[2]
+data = json.loads(path.read_text(encoding="utf-8"))
+chain = next(item for item in data["chains"] if item["id"] == chain_id)
+chain["status"] = "approved"
+chain["type"] = "command"
+chain["command"] = "printf 'CG_CHECKPOINT:后端返回监控 URL:PASS\\n'"
+path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+PY
+
+if python3 "$SCRIPT" dev-complete --root "$ROOT" >"$OUT" 2>&1; then
+  cat "$OUT"
+  exit 1
+fi
+
+grep -q "missing checkpoint marker: 前端打开监控页" "$OUT"
+grep -q "\\[log: " "$OUT"
+
+PYTHONPATH="$SKILL_ROOT/scripts" python3 - "$ROOT" "$HOOK" <<'PY'
+from pathlib import Path
+import importlib.util
+import sys
+
+root = Path(sys.argv[1])
+hook_path = Path(sys.argv[2])
+spec = importlib.util.spec_from_file_location("context_guard_hook", hook_path)
+module = importlib.util.module_from_spec(spec)
+assert spec.loader is not None
+spec.loader.exec_module(module)
+
+details = module.completion_test_failure_details(root)
+assert "failed: GPU 监控按钮" in details
+assert "missing checkpoint marker: 前端打开监控页" in details
+assert "test-hub/runs/" in details
+PY

package/tests/BC-20260707-111.sh

@@ -0,0 +1,70 @@
+#!/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-coverage-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260707-111: GPU 监控按钮没有打开
+
+- Status: resolved
+- Tags: #gpu #ui
+- Display summary: 点击 GPU 监控后没有进入监控页。
+
+### BC-20260707-112: 后端没有返回 grafana URL
+
+- Status: resolved
+- Tags: #gpu #backend
+- Display summary: job payload 里缺少 grafana_url。
+
+### BC-20260707-113: Worker keepalive 丢失
+
+- Status: resolved
+- Tags: #worker #lifecycle
+- Display summary: 空闲 worker 没有进入 keepalive_running。
+MD
+
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "GPU 监控按钮" \
+  --entry "点击 GPU 监控按钮" \
+  --exit-check "打开包含有效 grafana_url 的监控页")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "后端返回监控 URL" \
+  --bad-case "BC-20260707-112" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --bad-case "BC-20260707-111" \
+  --check "点击后进入监控页" >/dev/null
+
+BEFORE="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+python3 "$SCRIPT" feature-chain-coverage --root "$ROOT" >"$OUT"
+AFTER="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+
+grep -q "feature chains: 1" "$OUT"
+grep -q "bad cases in register: 3" "$OUT"
+grep -q "covered by feature chains: 2" "$OUT"
+grep -q "unassigned candidates: 1" "$OUT"
+grep -q "BC-20260707-113" "$OUT"
+if grep -q "BC-20260707-111" "$OUT" && grep -q "candidate: BC-20260707-111" "$OUT"; then
+  cat "$OUT"
+  exit 1
+fi
+test "$BEFORE" = "$AFTER"
+
+python3 "$SCRIPT" feature-chain-coverage --root "$ROOT" --verbose >"$OUT"
+grep -q "checkpoint: 后端返回监控 URL | covers: BC-20260707-112" "$OUT"
+grep -q "checkpoint: 前端打开监控页 | covers: BC-20260707-111" "$OUT"

package/tests/BC-20260707-112.sh

@@ -0,0 +1,45 @@
+#!/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-bc-query-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260707-112: GPU 监控点击没有打开页面
+
+- Status: resolved
+- Tags: #gpu #grafana #ui
+- Display summary: 点击 GPU 监控按钮后，前端没有打开包含 grafana_url 的监控页。
+- Phenomenon: 用户点击 GPU 监控后页面卡住，或者跳转 URL 为空。
+- Trigger / reproduction: job payload 缺少 grafana_url，前端仍把它当成可打开的监控入口。
+- Root cause: 前端把 job 数据当成 GPU URL 的唯一来源，没有检查后端返回值是否有效。
+MD
+
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "GPU 监控按钮" \
+  --entry "点击 GPU 监控按钮" \
+  --exit-check "打开包含有效 grafana_url 的监控页")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开 Grafana 监控页" \
+  --bad-case "BC-20260707-000" \
+  --check "点击后进入 grafana_url 页面" >/dev/null
+
+BEFORE="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+python3 "$SCRIPT" feature-chain-suggest --root "$ROOT" --query "BC-20260707-112" >"$OUT"
+AFTER="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+
+grep -q "query expanded from bad-case register: BC-20260707-112 GPU 监控点击没有打开页面" "$OUT"
+grep -q "$CHAIN_ID" "$OUT"
+grep -q "GPU 监控按钮" "$OUT"
+grep -q "checkpoint candidate: 前端打开 Grafana 监控页" "$OUT"
+test "$BEFORE" = "$AFTER"

package/tests/BC-20260707-113.sh

@@ -0,0 +1,73 @@
+#!/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-coverage-suggest-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260707-113: GPU 监控点击没有打开 Grafana 页面
+
+- Status: resolved
+- Tags: #gpu #grafana #ui
+- Display summary: 点击 GPU 监控按钮后，前端没有打开包含 grafana_url 的监控页。
+- Phenomenon: 用户点击 GPU 监控后页面卡住，或者跳转 URL 为空。
+- Trigger / reproduction: job payload 缺少 grafana_url，前端仍把它当成可打开的监控入口。
+
+### BC-20260707-114: 后端返回监控 URL 为空
+
+- Status: resolved
+- Tags: #gpu #backend
+- Display summary: 后端没有给 GPU 监控按钮返回 grafana_url。
+
+### BC-20260707-115: Worker keepalive 状态丢失
+
+- Status: resolved
+- Tags: #worker #lifecycle
+- Display summary: 空闲 worker 没有进入 keepalive_running。
+MD
+
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "GPU 监控按钮" \
+  --entry "点击 GPU 监控按钮" \
+  --exit-check "打开包含有效 grafana_url 的 Grafana 监控页")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "后端返回监控 URL" \
+  --bad-case "BC-20260707-114" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开 Grafana 监控页" \
+  --bad-case "BC-20260707-000" \
+  --check "点击后进入 grafana_url 页面" >/dev/null
+
+BEFORE="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+python3 "$SCRIPT" feature-chain-coverage --root "$ROOT" >"$OUT"
+AFTER="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+
+grep -q "covered by feature chains: 1" "$OUT"
+grep -q "unassigned candidates: 2" "$OUT"
+grep -q "candidate: BC-20260707-113 | GPU 监控点击没有打开 Grafana 页面" "$OUT"
+grep -q "possible chain: $CHAIN_ID" "$OUT"
+grep -q "possible checkpoint: 前端打开 Grafana 监控页" "$OUT"
+grep -q "match evidence:" "$OUT"
+grep -q "grafana" "$OUT"
+grep -q "candidate: BC-20260707-115 | Worker keepalive 状态丢失" "$OUT"
+if awk '/candidate: BC-20260707-115/{flag=1; next} flag && /possible chain/{exit 1} flag && /registry:/{exit 0}' "$OUT"; then
+  :
+else
+  cat "$OUT"
+  exit 1
+fi
+test "$BEFORE" = "$AFTER"

package/tests/BC-20260707-115.sh

@@ -0,0 +1,77 @@
+#!/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-plan-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+STRONG_OUT="$ROOT/strong.txt"
+WEAK_OUT="$ROOT/weak.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260707-115: GPU 监控点击没有打开 Grafana 页面
+
+- Status: resolved
+- Tags: #gpu #grafana #ui
+- Display summary: 点击 GPU 监控按钮后，前端没有打开包含 grafana_url 的监控页。
+- Phenomenon: 用户点击 GPU 监控后页面卡住，或者跳转 URL 为空。
+- Trigger / reproduction: job payload 缺少 grafana_url，前端仍把它当成可打开的监控入口。
+
+### BC-20260707-116: Worker keepalive 状态丢失
+
+- Status: resolved
+- Tags: #worker #lifecycle
+- Display summary: 空闲 worker 没有进入 keepalive_running。
+MD
+
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "GPU 监控按钮" \
+  --entry "点击 GPU 监控按钮" \
+  --exit-check "打开包含有效 grafana_url 的 Grafana 监控页")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开 Grafana 监控页" \
+  --bad-case "BC-20260707-115" \
+  --check "点击后进入 grafana_url 页面" >/dev/null
+
+BEFORE="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+python3 "$SCRIPT" feature-chain-plan --root "$ROOT" --query "BC-20260707-115" >"$STRONG_OUT"
+python3 "$SCRIPT" feature-chain-plan --root "$ROOT" --query "BC-20260707-116" >"$WEAK_OUT"
+AFTER="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+
+grep -q "action: review-existing-chain" "$STRONG_OUT"
+grep -q "chain: $CHAIN_ID" "$STRONG_OUT"
+grep -q "checkpoint: 前端打开 Grafana 监控页" "$STRONG_OUT"
+grep -q "match evidence:" "$STRONG_OUT"
+grep -q "after-confirmation command: .*feature-chain-attach-bc" "$STRONG_OUT"
+grep -q -- "--bad-case BC-20260707-115" "$STRONG_OUT"
+grep -q "tighten checkpoint based on confirmed symptom" "$STRONG_OUT"
+grep -q "next: if the user confirms the match" "$STRONG_OUT"
+
+grep -q "action: propose-new-chain" "$WEAK_OUT"
+grep -q "confirmation prompt: 测试创建识别" "$WEAK_OUT"
+grep -q "Worker keepalive 状态丢失" "$WEAK_OUT"
+grep -q "after-confirmation command: .*feature-chain-propose" "$WEAK_OUT"
+grep -q "confirmed feature title" "$WEAK_OUT"
+grep -q -- "--node-title 'Worker keepalive 状态丢失'" "$WEAK_OUT"
+grep -q -- "--bad-cases BC-20260707-116" "$WEAK_OUT"
+if grep -q "after-confirmation command: .*feature-chain-add" "$WEAK_OUT"; then
+  cat "$WEAK_OUT"
+  exit 1
+fi
+if grep -q "从「BC-20260707-116」相关入口" "$WEAK_OUT"; then
+  cat "$WEAK_OUT"
+  exit 1
+fi
+if grep -q "action: review-existing-chain" "$WEAK_OUT"; then
+  cat "$WEAK_OUT"
+  exit 1
+fi
+
+test "$BEFORE" = "$AFTER"

package/tests/BC-20260707-116.sh

@@ -0,0 +1,77 @@
+#!/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-candidates-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+cat >"$ROOT/.codex/context/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260707-116: Roadmap 卡片标题看不懂
+
+- Status: resolved
+- Tags: #roadmap-ux #readability
+- Display summary: 路线图卡片标题像实现日志，不像用户任务。
+
+### BC-20260707-117: Roadmap 详情页太啰嗦
+
+- Status: resolved
+- Tags: #roadmap-ux #readability
+- Display summary: 点击节点后看到太多字段，无法快速理解任务。
+
+### BC-20260707-118: Context 没有在新会话恢复
+
+- Status: resolved
+- Tags: #context-loss
+- Display summary: 新会话不知道之前已经讨论过的路线。
+
+### BC-20260707-119: Context 写到远程服务器路径
+
+- Status: resolved
+- Tags: #context-loss #remote
+- Display summary: SSH 开发时 context 被写到远程路径。
+
+### BC-20260707-120: 已覆盖的 roadmap 旧问题
+
+- Status: resolved
+- Tags: #roadmap-ux
+- Display summary: 已经挂到功能链的旧路线图问题。
+MD
+
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "路线图展示体验" \
+  --entry "打开 roadmap.html" \
+  --exit-check "用户能快速看懂路线图节点")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "路线图卡片可读" \
+  --bad-case "BC-20260707-120" \
+  --check "卡片标题能直接说明任务" >/dev/null
+
+BEFORE="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+python3 "$SCRIPT" feature-chain-candidates --root "$ROOT" --min-cases 2 >"$OUT"
+AFTER="$(cat "$ROOT/.codex/context/test-hub/feature-chains.json")"
+
+grep -q "feature-chain candidates" "$OUT"
+grep -q "candidate chain: 路线图展示体验 / 可读性 | 2 unassigned bad cases | new coverage: 2 | tags: #roadmap-ux, #readability" "$OUT"
+grep -q "candidate chain: Context 持久化 | 2 unassigned bad cases | new coverage: 2 | tags: #context-loss" "$OUT"
+grep -q "confirmation prompt: 测试创建识别" "$OUT"
+grep -q "BC-20260707-116" "$OUT"
+grep -q "BC-20260707-117" "$OUT"
+grep -q "BC-20260707-118" "$OUT"
+grep -q "BC-20260707-119" "$OUT"
+if grep -q "BC-20260707-120" "$OUT"; then
+  cat "$OUT"
+  exit 1
+fi
+if grep -q "candidate chain: 路线图展示体验 | 2 unassigned bad cases | tags: #roadmap-ux" "$OUT"; then
+  cat "$OUT"
+  exit 1
+fi
+test "$BEFORE" = "$AFTER"

package/tests/BC-20260707-118.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/context_guard.py}"
+ROOT_FAIL="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-closed-loop-fail-XXXXXX")"
+ROOT_PASS="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-closed-loop-pass-XXXXXX")"
+trap 'rm -rf "$ROOT_FAIL" "$ROOT_PASS"' EXIT
+OUT="$ROOT_FAIL/out.txt"
+
+create_chain() {
+  local root="$1"
+  local command_text="$2"
+  local mode="${3:-approve}"
+  python3 "$SCRIPT" init --root "$root" >/dev/null
+  local add_output
+  add_output="$(python3 "$SCRIPT" feature-chain-add \
+    --root "$root" \
+    --title "Markdown 公式预览" \
+    --entry "输入包含单行、多行和矩阵公式的 Markdown" \
+    --exit-check "预览区完成 MathJax 渲染且没有空白或错误占位")"
+  local chain_id
+  chain_id="$(printf '%s\n' "$add_output" | sed -n 's/.*feature chain: //p')"
+  test -n "$chain_id"
+
+  python3 "$SCRIPT" feature-chain-attach-bc \
+    --root "$root" \
+    --chain-id "$chain_id" \
+    --node-title "公式输入进入预览流程" \
+    --bad-case "BC-20260707-118-input" \
+    --check "单行、多行和矩阵公式都进入同一预览流程" >/dev/null
+
+  python3 "$SCRIPT" feature-chain-attach-bc \
+    --root "$root" \
+    --chain-id "$chain_id" \
+    --node-title "MathJax 渲染完成" \
+    --bad-case "BC-20260707-118-render" \
+    --check "预览区展示渲染后的公式且没有空白或错误占位" >/dev/null
+
+  if [[ "$mode" == "direct-approved" ]]; then
+    python3 - "$root/.codex/context/test-hub/feature-chains.json" "$chain_id" "$command_text" <<'PY'
+from pathlib import Path
+import json
+import sys
+path = Path(sys.argv[1])
+chain_id = sys.argv[2]
+command = sys.argv[3]
+data = json.loads(path.read_text(encoding="utf-8"))
+chain = next(item for item in data["chains"] if item["id"] == chain_id)
+chain["status"] = "approved"
+chain["type"] = "command"
+chain["command"] = command
+path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+PY
+  else
+    python3 "$SCRIPT" feature-chain-approve \
+      --root "$root" \
+      --chain-id "$chain_id" \
+      --command-text "$command_text" >/dev/null
+  fi
+
+  python3 "$SCRIPT" validate-feature-chains --root "$root" | grep -q "feature-chain validation passed"
+}
+
+FAIL_COMMAND='printf "CG_CHECKPOINT:公式输入进入预览流程:PASS\nCG_CHECKPOINT:MathJax 渲染完成:FAIL:预览区为空\n"; printf "render empty\n" > "$CONTEXT_GUARD_TEST_RUN_DIR/render-diagnostic.txt"'
+create_chain "$ROOT_FAIL" "$FAIL_COMMAND" direct-approved
+
+if python3 "$SCRIPT" dev-complete --root "$ROOT_FAIL" >"$OUT" 2>&1; then
+  cat "$OUT"
+  exit 1
+fi
+grep -q "0 passed, 1 failed, 0 blocked" "$OUT"
+grep -q "checkpoint failed: MathJax 渲染完成 - 预览区为空" "$OUT"
+grep -q "evidence preserved" "$OUT"
+
+python3 - "$ROOT_FAIL/.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"
+assert result["reason"] == "checkpoint failed: MathJax 渲染完成 - 预览区为空"
+assert [item["label"] for item in result["checkpoints"]] == ["公式输入进入预览流程", "MathJax 渲染完成"]
+log_path = Path(result["log"])
+run_dir = log_path.parent
+assert run_dir.exists(), run_dir
+assert (run_dir / "render-diagnostic.txt").exists()
+PY
+
+PASS_COMMAND='tmp=.codex/context/test-hub/feature-chain-closed-loop.tmp; printf "CG_CHECKPOINT:公式输入进入预览流程:PASS\nCG_CHECKPOINT:MathJax 渲染完成:PASS\n" > "$tmp"; cat "$tmp"; rm -f "$tmp"'
+create_chain "$ROOT_PASS" "$PASS_COMMAND"
+
+python3 "$SCRIPT" dev-complete --root "$ROOT_PASS" >"$OUT"
+grep -q "1 passed, 0 failed, 0 blocked" "$OUT"
+grep -q "success artifacts cleaned" "$OUT"
+test ! -e "$ROOT_PASS/.codex/context/test-hub/feature-chain-closed-loop.tmp"
+if find "$ROOT_PASS/.codex/context/test-hub/runs" -mindepth 1 -maxdepth 1 2>/dev/null | grep -q .; then
+  find "$ROOT_PASS/.codex/context/test-hub/runs" -mindepth 1 -maxdepth 1
+  exit 1
+fi
+
+python3 - "$ROOT_PASS/.codex/context/test-hub/feature-chains.json" "$ROOT_PASS/.codex/context/test-hub/last-run.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+registry = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
+chain = registry["chains"][0]
+covered = sorted(bc for node in chain["nodes"] for bc in node["bad_cases"])
+assert covered == ["BC-20260707-118-input", "BC-20260707-118-render"]
+result = json.loads(Path(sys.argv[2]).read_text(encoding="utf-8"))["results"][0]
+assert result["status"] == "passed"
+assert result["missing_checkpoints"] == []
+PY

package/tests/BC-20260707-119.sh

@@ -0,0 +1,47 @@
+#!/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-propose-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+
+python3 "$SCRIPT" feature-chain-propose \
+  --root "$ROOT" \
+  --title "路线图节点阅读" \
+  --entry "用户点击路线图节点" \
+  --exit-check "节点详情页用自然语言展示用户问题、相关 bad case、方法和进度" \
+  --node-title "节点详情可读" \
+  --bad-cases "BC-20260707-119-title, BC-20260707-119-detail" \
+  --check "详情页能一眼看懂节点对应任务" >"$OUT"
+
+grep -q "feature chain proposed:" "$OUT"
+grep -q "status: proposed; this chain is not executable and will not run in dev-complete" "$OUT"
+grep -q "checkpoint: 节点详情可读 | covers BC-20260707-119-title, BC-20260707-119-detail" "$OUT"
+grep -q "next: after the user confirms the automation" "$OUT"
+
+python3 "$SCRIPT" validate-feature-chains --root "$ROOT" >"$OUT"
+grep -q "feature-chain validation passed: 1 chain(s), 0 warning(s)" "$OUT"
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$OUT"
+grep -q "test hub: no approved every-dev-completion tests" "$OUT"
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+registry = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
+chain = registry["chains"][0]
+assert chain["status"] == "proposed"
+assert chain["type"] == "manual"
+assert chain["command"] == ""
+assert chain["run_policy"] == "every-dev-completion"
+assert chain["proposal_note"].startswith("Human-confirmed draft only")
+node = chain["nodes"][0]
+assert node["title"] == "节点详情可读"
+assert node["bad_cases"] == ["BC-20260707-119-title", "BC-20260707-119-detail"]
+assert node["checks"] == ["详情页能一眼看懂节点对应任务"]
+PY