@michelj/context-guard 0.4.1 → 0.4.3

package/tests/BC-20260707-100.sh

@@ -0,0 +1,46 @@
+#!/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-suggest-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+OUT="$ROOT/suggest.out"
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "Markdown 公式预览" \
+  --entry "用户输入 Markdown 公式" \
+  --exit-check "预览区显示 MathJax 渲染结果")"
+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 "MathJax 渲染完成" \
+  --bad-case "BC-20260707-100" \
+  --check "预览区包含渲染后的公式且没有空白" >/dev/null
+
+python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT" \
+  --title "GPU 监控按钮" \
+  --entry "点击 GPU 监控按钮" \
+  --exit-check "打开包含 grafana_url 的监控页" >/dev/null
+
+python3 "$SCRIPT" feature-chain-suggest \
+  --root "$ROOT" \
+  --query "Markdown 数学公式预览 MathJax 渲染空白" >"$OUT"
+grep -q "Markdown 公式预览" "$OUT"
+grep -q "MathJax 渲染完成" "$OUT"
+grep -q "next: attach the bad case to a candidate checkpoint" "$OUT"
+if grep -q "GPU 监控按钮" "$OUT"; then
+  cat "$OUT"
+  exit 1
+fi
+
+python3 "$SCRIPT" feature-chain-suggest \
+  --root "$ROOT" \
+  --query "worker lease keepalive 释放失败" >"$OUT"
+grep -q "feature-chain candidates: none" "$OUT"
+grep -q "proposal-needed" "$OUT"

package/tests/BC-20260707-101.sh

@@ -0,0 +1,47 @@
+#!/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-proposed-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 "Markdown 公式预览" \
+  --entry "用户输入 Markdown 公式" \
+  --exit-check "预览区显示 MathJax 渲染结果" \
+  --command-text "printf 'should not run unless approved\n'")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" "$CHAIN_ID" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+registry = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
+chain = next(item for item in registry["chains"] if item["id"] == sys.argv[2])
+assert chain["status"] == "proposed", chain
+assert chain["source"] == "feature-chain", chain
+PY
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$OUT"
+grep -q "no approved every-dev-completion tests" "$OUT"
+
+python3 "$SCRIPT" test-hub-add \
+  --root "$ROOT" \
+  --title "Context 初始化冒烟测试" \
+  --command-text "printf 'ok\n'" >/dev/null
+
+python3 - "$ROOT/.codex/context/test-hub/registry.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+registry = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
+test = registry["tests"][0]
+assert test["status"] == "approved", test
+assert test["run_policy"] == "every-dev-completion", test
+PY

package/tests/BC-20260707-102.sh

@@ -0,0 +1,68 @@
+#!/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-approve-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 "Markdown 公式预览" \
+  --entry "用户输入 Markdown 公式" \
+  --exit-check "预览区显示 MathJax 渲染结果")"
+CHAIN_ID="$(printf '%s\n' "$ADD_OUTPUT" | sed -n 's/.*feature chain: //p')"
+
+if python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'ok\n'" >"$OUT" 2>&1; then
+  cat "$OUT"
+  exit 1
+fi
+grep -q "requires at least one checkpoint" "$OUT"
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "MathJax 渲染完成" \
+  --bad-case "BC-20260707-102" \
+  --check "预览区包含渲染后的公式且没有空白" >/dev/null
+
+if python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" >"$OUT" 2>&1; then
+  cat "$OUT"
+  exit 1
+fi
+grep -q "requires --command-text" "$OUT"
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'CG_CHECKPOINT:MathJax 渲染完成:PASS\n'" >"$OUT"
+grep -q "feature chain approved" "$OUT"
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" "$CHAIN_ID" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+chain = next(
+    item
+    for item in json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["chains"]
+    if item["id"] == sys.argv[2]
+)
+assert chain["status"] == "approved"
+assert chain["run_policy"] == "every-dev-completion"
+assert chain["type"] == "command"
+assert "CG_CHECKPOINT:MathJax 渲染完成:PASS" in chain["command"]
+PY
+
+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 "1 passed, 0 failed, 0 blocked" "$OUT"
+grep -q "success artifacts cleaned" "$OUT"

package/tests/BC-20260707-103.sh

@@ -0,0 +1,59 @@
+#!/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-policy-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-103" \
+  --check "grafana_url 不为空" >/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" dev-complete --root "$ROOT" >"$OUT"
+grep -q "1 passed, 0 failed, 0 blocked" "$OUT"
+
+python3 "$SCRIPT" feature-chain-set-policy \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --run-policy "relevant-only" \
+  --reason "用户要求只在修改 GPU 监控流程时运行" >"$OUT"
+grep -q "feature chain policy updated" "$OUT"
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" "$CHAIN_ID" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+chain = next(
+    item
+    for item in json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["chains"]
+    if item["id"] == sys.argv[2]
+)
+assert chain["status"] == "approved"
+assert chain["run_policy"] == "relevant-only"
+assert "GPU 监控" in chain["policy_reason"]
+PY
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$OUT"
+grep -q "no approved every-dev-completion tests" "$OUT"
+if grep -q "后端返回监控 URL" "$OUT"; then
+  cat "$OUT"
+  exit 1
+fi

package/tests/BC-20260707-104.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/context_guard.py"
+ROOT_FAIL="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-checkpoint-fail-XXXXXX")"
+ROOT_PASS="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-checkpoint-pass-XXXXXX")"
+trap 'rm -rf "$ROOT_FAIL" "$ROOT_PASS"' EXIT
+OUT="$ROOT_FAIL/out.txt"
+
+python3 "$SCRIPT" init --root "$ROOT_FAIL" >/dev/null
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT_FAIL" \
+  --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_FAIL" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "后端返回监控 URL" \
+  --bad-case "BC-20260707-104" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT_FAIL" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --bad-case "BC-20260707-104" \
+  --check "点击后进入监控页" >/dev/null
+
+python3 - "$ROOT_FAIL/.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\\nCG_CHECKPOINT:前端打开监控页:FAIL:缺少 grafana_url\\n'"
+path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+PY
+
+if python3 "$SCRIPT" dev-complete --root "$ROOT_FAIL" >"$OUT" 2>&1; then
+  cat "$OUT"
+  exit 1
+fi
+grep -q "checkpoint failed: 前端打开监控页 - 缺少 grafana_url" "$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: 前端打开监控页 - 缺少 grafana_url"
+assert [item["status"] for item in result["checkpoints"]] == ["pass", "fail"]
+PY
+
+OUT="$ROOT_PASS/out.txt"
+python3 "$SCRIPT" init --root "$ROOT_PASS" >/dev/null
+ADD_OUTPUT="$(python3 "$SCRIPT" feature-chain-add \
+  --root "$ROOT_PASS" \
+  --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_PASS" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "后端返回监控 URL" \
+  --bad-case "BC-20260707-104" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT_PASS" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'CG_CHECKPOINT:后端返回监控 URL:PASS\n'" >/dev/null
+
+python3 "$SCRIPT" dev-complete --root "$ROOT_PASS" >"$OUT"
+grep -q "1 passed, 0 failed, 0 blocked" "$OUT"
+grep -q "success artifacts cleaned" "$OUT"
+
+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/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"] == "passed"
+assert result["checkpoints"][0]["label"] == "后端返回监控 URL"
+PY

package/tests/BC-20260707-105.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/context_guard.py"
+ROOT_BAD="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-marker-bad-XXXXXX")"
+ROOT_GOOD="$(mktemp -d "${TMPDIR:-/tmp}/context-guard-feature-chain-marker-good-XXXXXX")"
+trap 'rm -rf "$ROOT_BAD" "$ROOT_GOOD"' EXIT
+OUT="$ROOT_BAD/out.txt"
+
+create_chain() {
+  local root="$1"
+  local mode="${2:-proposed}"
+  local command_text="${3:-}"
+  python3 "$SCRIPT" init --root "$root" >/dev/null
+  local add_output
+  add_output="$(python3 "$SCRIPT" feature-chain-add \
+    --root "$root" \
+    --title "GPU 监控按钮" \
+    --entry "点击 GPU 监控按钮" \
+    --exit-check "打开包含有效 grafana_url 的监控页")"
+  local chain_id
+  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-105" \
+    --check "grafana_url 不为空" >/dev/null
+  python3 "$SCRIPT" feature-chain-attach-bc \
+    --root "$root" \
+    --chain-id "$chain_id" \
+    --node-title "前端打开监控页" \
+    --bad-case "BC-20260707-105" \
+    --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
+  fi
+  printf '%s' "$chain_id"
+}
+
+CHAIN_ID="$(create_chain "$ROOT_BAD" direct-approved "printf 'CG_CHECKPOINT:未登记检查点:PASS\n'")"
+python3 - "$ROOT_BAD/.codex/context/test-hub/feature-chains.json" "$CHAIN_ID" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+chain = next(
+    item
+    for item in json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["chains"]
+    if item["id"] == sys.argv[2]
+)
+nodes = chain["nodes"]
+assert len(nodes) == 2, nodes
+ids = [node["id"] for node in nodes]
+assert len(set(ids)) == 2, ids
+assert "test" not in ids, ids
+PY
+
+if python3 "$SCRIPT" dev-complete --root "$ROOT_BAD" >"$OUT" 2>&1; then
+  cat "$OUT"
+  exit 1
+fi
+grep -q "unknown checkpoint marker: 未登记检查点" "$OUT"
+
+python3 - "$ROOT_BAD/.codex/context/test-hub/last-run.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+result = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["results"][0]
+assert result["status"] == "failed"
+assert result["reason"] == "unknown checkpoint marker: 未登记检查点"
+assert result["checkpoints"][0]["known"] is False
+PY
+
+OUT="$ROOT_GOOD/out.txt"
+CHAIN_ID="$(create_chain "$ROOT_GOOD")"
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT_GOOD" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'CG_CHECKPOINT:后端返回监控 URL:PASS\nCG_CHECKPOINT:前端打开监控页:PASS\n'" >/dev/null
+
+python3 "$SCRIPT" dev-complete --root "$ROOT_GOOD" >"$OUT"
+grep -q "1 passed, 0 failed, 0 blocked" "$OUT"
+grep -q "success artifacts cleaned" "$OUT"
+
+python3 - "$ROOT_GOOD/.codex/context/test-hub/last-run.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+result = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["results"][0]
+assert result["status"] == "passed"
+assert [item["known"] for item in result["checkpoints"]] == [True, True]
+assert [item["label"] for item in result["checkpoints"]] == ["后端返回监控 URL", "前端打开监控页"]
+PY

package/tests/BC-20260707-106.sh

@@ -0,0 +1,80 @@
+#!/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-missing-checkpoint-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-106" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --bad-case "BC-20260707-106" \
+  --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"
+
+python3 - "$ROOT/.codex/context/test-hub/last-run.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+result = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["results"][0]
+assert result["status"] == "failed"
+assert result["reason"] == "missing checkpoint marker: 前端打开监控页"
+assert [item["label"] for item in result["missing_checkpoints"]] == ["前端打开监控页"]
+PY
+
+python3 "$SCRIPT" feature-chain-approve \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --command-text "printf 'CG_CHECKPOINT:后端返回监控 URL:PASS\nCG_CHECKPOINT:前端打开监控页:PASS\n'" >/dev/null
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$OUT"
+grep -q "1 passed, 0 failed, 0 blocked" "$OUT"
+grep -q "success artifacts cleaned" "$OUT"
+
+python3 - "$ROOT/.codex/context/test-hub/last-run.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+result = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["results"][0]
+assert result["status"] == "passed"
+assert [item["label"] for item in result["checkpoints"]] == ["后端返回监控 URL", "前端打开监控页"]
+assert result["missing_checkpoints"] == []
+PY

package/tests/BC-20260707-107.sh

@@ -0,0 +1,74 @@
+#!/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-checkpoint-policy-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-107" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --bad-case "BC-20260707-107" \
+  --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" validate-feature-chains --root "$ROOT" >"$OUT"
+grep -q "feature-chain validation passed" "$OUT"
+
+python3 "$SCRIPT" dev-complete --root "$ROOT" >"$OUT"
+grep -q "1 passed, 0 failed, 0 blocked" "$OUT"
+grep -q "success artifacts cleaned" "$OUT"
+
+python3 - "$ROOT/.codex/context/test-hub/feature-chains.json" <<'PY'
+from pathlib import Path
+import json
+import sys
+
+chain = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))["chains"][0]
+nodes = {node["title"]: node for node in chain["nodes"]}
+optional = nodes["前端打开监控页"]
+assert optional["required"] is False
+assert optional["optional"] is True
+assert optional["optional_reason"] == "浏览器环境才运行"
+PY
+
+python3 "$SCRIPT" feature-chain-set-checkpoint \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --required required \
+  --reason "用户要求恢复每次运行" >/dev/null
+
+if python3 "$SCRIPT" dev-complete --root "$ROOT" >"$OUT" 2>&1; then
+  cat "$OUT"
+  exit 1
+fi
+grep -q "missing checkpoint marker: 前端打开监控页" "$OUT"

package/tests/BC-20260707-108.sh

@@ -0,0 +1,48 @@
+#!/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-list-policy-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-108" \
+  --check "grafana_url 不为空" >/dev/null
+
+python3 "$SCRIPT" feature-chain-attach-bc \
+  --root "$ROOT" \
+  --chain-id "$CHAIN_ID" \
+  --node-title "前端打开监控页" \
+  --bad-case "BC-20260707-108" \
+  --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-list --root "$ROOT" >"$OUT"
+grep -q "2 node(s), 1 required, 1 optional" "$OUT"
+if grep -q "checkpoint:" "$OUT"; then
+  cat "$OUT"
+  exit 1
+fi
+
+python3 "$SCRIPT" feature-chain-list --root "$ROOT" --verbose >"$OUT"
+grep -q "2 node(s), 1 required, 1 optional" "$OUT"
+grep -q "checkpoint: 后端返回监控 URL | required" "$OUT"
+grep -q "checkpoint: 前端打开监控页 | optional | reason: 浏览器环境才运行" "$OUT"