@michelj/context-guard 0.4.0

package/skills/context-guard/tests/BC-20260626-081.sh

@@ -0,0 +1,40 @@
+#!/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-hidden-details-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+cat > "$CTX/roadmap.md" <<'MD'
+# Context Roadmap
+
+## Nodes
+
+### NODE-20260626-001: 可点击路线节点
+
+- Date: 2026-06-26
+- Status: done
+- Level: major
+- Branch: Main
+- Parent: none
+- Outcome: 这个节点的详细概括只能在点击节点后显示，不能默认铺在 roadmap 下方。
+- Next: none
+- Linked bad cases: none
+MD
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+HTML="$CTX/roadmap/roadmap.html"
+
+grep -q '<a class="lane-link" href="#node-1">' "$HTML"
+grep -q '<section class="inline-details" hidden data-inline-details' "$HTML"
+grep -q 'function setupInlineDetails()' "$HTML"
+grep -q 'class="detail-card" id="node-1"' "$HTML"
+
+if grep -q '<section class="inline-details" aria-label="Roadmap details">' "$HTML"; then
+  echo "inline details are visible by default" >&2
+  exit 1
+fi

package/skills/context-guard/tests/BC-20260626-082.sh

@@ -0,0 +1,32 @@
+#!/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-root-selection-XXXXXX")"
+ROOT="$(cd "$ROOT" && pwd -P)"
+trap 'rm -rf "$ROOT"' EXIT
+
+mkdir -p "$ROOT/project"
+git -C "$ROOT/project" init --quiet >/dev/null
+
+if (cd "$SKILL_ROOT" && python3 "$SCRIPT" show-roadmap >/tmp/context-guard-implicit-skill-root.out 2>&1); then
+  echo "show-roadmap unexpectedly accepted the skill directory as implicit project root" >&2
+  exit 1
+fi
+grep -q 'refusing to use the Context Guard skill directory' /tmp/context-guard-implicit-skill-root.out
+
+rm -rf "$SKILL_ROOT/.codex"
+printf '{"cwd":"%s/project","prompt":"show roadmap"}' "$ROOT" | (
+  cd "$SKILL_ROOT"
+  python3 "$HOOK" session-start
+) >/tmp/context-guard-hook-root.out
+
+test -f "$ROOT/project/.codex/context/index.md"
+test -f "$ROOT/project/.codex/context/roadmap.md"
+if test -e "$SKILL_ROOT/.codex/context/roadmap.md"; then
+  echo "hook wrote project context into the skill directory" >&2
+  exit 1
+fi
+grep -q "$ROOT/project/.codex/context" /tmp/context-guard-hook-root.out

package/skills/context-guard/tests/BC-20260626-083.sh

@@ -0,0 +1,66 @@
+#!/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-node-detail-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+cat > "$CTX/roadmap.md" <<'MD'
+# Context Roadmap
+
+## Nodes
+
+### NODE-20260626-001: 加入 Task Case 设计确认和 goal 阶段门控
+
+- Date: 2026-06-26
+- Status: done
+- Level: major
+- Branch: Main
+- Parent: none
+- Task: `CTX-20260626-test-chain`
+- Outcome: Context Guard 要求复杂 Task Case 先给用户确认测试设计；goal 模式下把 Task Case 作为阶段门控。
+- Decision / reason: 用户指出测试 case 应该是任务导向，而不是为每个 bug 造很多零散脚本。
+- Avoid going back: 不要让 agent 静默创建大批未经确认的测试 case。
+- Next: 继续观察 goal 模式下是否按阶段记录测试 checkpoint。
+- Linked bad cases: BC-20260626-999
+- Test chain: 节点详情页应显示用户问题、相关问题案例、采取方法和当前进度。
+MD
+
+cat > "$CTX/bad-cases.md" <<'MD'
+# Bad Case Register
+
+## Active Cases
+
+### BC-20260626-999: 测试链路变成碎片化脚本
+
+- Status: resolved
+- First observed: 2026-06-26
+- Last checked: 2026-06-26
+- Scope: test-chain design
+- Roadmap nodes: NODE-20260626-001
+- Tags: #test-chain #context-bloat
+- Phenomenon: agent 为每个 bug 创建零散脚本，真实任务流反而看不清。
+- Trigger / reproduction: 让 agent 为多个历史 bad case 设计测试。
+- Root cause: 测试链路没有以真实任务为单位组织。
+- Fix method: 引入 task case 草案确认和阶段 checkpoint。
+- Guard / verification: 检查节点详情页的相关问题案例和测试链路说明聚合在节点页面内。
+MD
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+DETAIL="$CTX/roadmap/roadmap-details.html"
+
+grep -q '用户提出的问题' "$DETAIL"
+grep -q '相关问题案例' "$DETAIL"
+grep -q '采取方法' "$DETAIL"
+grep -q '当前进度' "$DETAIL"
+grep -q '测试链路变成碎片化脚本' "$DETAIL"
+grep -q '引入 task case 草案确认和阶段 checkpoint' "$DETAIL"
+
+if grep -q '<h2 data-i18n="badCases">Bad Cases</h2>' "$DETAIL"; then
+  echo "detail page still renders a global bad-case list instead of node-scoped sections" >&2
+  exit 1
+fi

package/skills/context-guard/tests/BC-20260627-084.sh

@@ -0,0 +1,74 @@
+#!/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-readable-detail-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+cat > "$CTX/roadmap.md" <<'MD'
+# Context Roadmap
+
+### NODE-20260627-001: 重构节点详情阅读页
+- Date: 2026-06-27
+- Status: done
+- Level: major
+- Branch: Main
+- Outcome: Context Guard 现在承认用户截图、日志、复现和已定位根因可作为 red signal；证据足够时应停止补测试并进入实现。
+- Decision / reason: 用户反馈旧详情页像列表堆料，不利于浏览；详情页应该围绕当前节点，而不是全局展开 bad case 列表；按 `；`、`;` 拆成长字段短条目时不能切碎代码片段；采取方法需要短行展示，不能把多个决策塞进一个段落。用户反馈 skill 又陷入测试循环，说明验证预算还不够，需要明确 stop condition。
+- Avoid going back: 不要在节点详情里渲染全局 Bad Cases 长列表；不要把测试命令日志混入当前进度区；不要把采取方法渲染成一整段文字墙。
+- Next: 保持节点详情只呈现当前节点的关键内容。
+- Linked bad cases: BC-20260627-084
+MD
+
+cat > "$CTX/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260627-084: 节点详情采取方法像文字墙
+- Status: resolved
+- Roadmap nodes: NODE-20260627-001
+- Tags: #roadmap-ux #readability
+- Phenomenon: 节点详情的采取方法把多个长句拼成一段，用户很难扫读。
+- Fix method: 将采取方法拆成短列表；相关问题案例留在当前节点内；进度区不混入测试命令日志。
+- Guard / verification: 检查详情 HTML 中采取方法和当前进度使用 compact list。
+MD
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+HTML="$CTX/roadmap/roadmap.html"
+DETAIL="$CTX/roadmap/roadmap-details.html"
+
+python3 - "$SCRIPT" <<'PY'
+import importlib.util
+import sys
+
+script = sys.argv[1]
+spec = importlib.util.spec_from_file_location("context_guard_under_test", script)
+module = importlib.util.module_from_spec(spec)
+assert spec.loader
+spec.loader.exec_module(module)
+items = module.split_detail_items("第一条；按 `；`、`;` 拆成长字段短条目时不能切碎代码片段；第三条。")
+assert items == [
+    "第一条",
+    "按 `；`、`;` 拆成长字段短条目时不能切碎代码片段",
+    "第三条",
+], items
+assert module.polish_detail_zh(
+    "后续观察 stop hook 是否能让 Codex 在根因明确后先修复，再做一个最小 post-fix 检查。"
+) == "下一步观察结束钩子能否提醒 Codex：根因明确后先修复，再做一次最小检查。"
+PY
+
+grep -q 'class="detail-list"' "$HTML"
+grep -q 'class="detail-list"' "$DETAIL"
+grep -q '<li>.*不要在节点详情里渲染全局 Bad Cases 长列表' "$DETAIL"
+grep -q '<li>.*将采取方法拆成短列表' "$DETAIL"
+grep -q '用户发现 Context Guard 又把时间耗在反复补测试上，因此需要给验证流程设置明确的停止条件' "$DETAIL"
+grep -q '现在只要有截图、日志、复现步骤或明确根因，就可以确认问题已经成立' "$DETAIL"
+grep -q '证据足够时，先修复问题，再做最小验证' "$DETAIL"
+
+if grep -q '不要在节点详情里渲染全局 Bad Cases 长列表；不要把测试命令日志混入当前进度区；不要把采取方法渲染成一整段文字墙' "$DETAIL"; then
+  echo "method detail is still rendered as one paragraph wall" >&2
+  exit 1
+fi

package/skills/context-guard/tests/BC-20260630-086.sh

@@ -0,0 +1,50 @@
+#!/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-user-request-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+python3 "$SCRIPT" checkpoint-roadmap-node \
+  --root "$ROOT" \
+  --title "改善节点详情可读性" \
+  --branch "Main" \
+  --level major \
+  --user-request "用户希望节点详情里的问题摘要直接来自用户输入，不要由 Codex 自由发挥。" \
+  --outcome "节点详情页现在优先展示 User request 字段。" \
+  --decision "这是内部实现决策，不应该冒充用户提出的问题。" \
+  --next-step "继续保持用户问题摘要和实现复盘分离。" >/dev/null
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+DETAIL="$CTX/roadmap/roadmap-details.html"
+
+grep -q -- "- User request: 用户希望节点详情里的问题摘要直接来自用户输入" "$CTX/roadmap.md"
+grep -q "用户希望节点详情里的问题摘要直接来自用户输入，不要由 Codex 自由发挥" "$DETAIL"
+
+python3 - "$DETAIL" <<'PY'
+from pathlib import Path
+import re
+import sys
+
+html = Path(sys.argv[1]).read_text(encoding="utf-8")
+match = re.search(r'<h4>.*?用户提出的问题.*?</h4>\s*<div>(?P<body>.*?)</div>', html, re.S)
+assert match, "user-question section should render"
+body = match.group("body")
+assert "用户希望节点详情里的问题摘要直接来自用户输入" in body
+assert "内部实现决策" not in body
+assert "Outcome" not in body
+PY
+
+python3 "$SCRIPT" checkpoint-roadmap-node \
+  --root "$ROOT" \
+  --title "历史节点没有用户请求字段" \
+  --branch "Main" \
+  --level major \
+  --outcome "历史节点没有 User request 字段。" >/dev/null
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+grep -q "这个历史节点没有记录用户原始请求" "$DETAIL"

package/skills/context-guard/tests/BC-20260630-087.sh

@@ -0,0 +1,103 @@
+#!/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-single-route-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+cat > "$CTX/roadmap.md" <<'MD'
+# Context Roadmap
+
+## Nodes
+
+### NODE-20260630-001: 收敛到模型记忆定位问题
+
+- Date: 2026-06-30
+- Status: done
+- Level: major
+- Branch: Main
+- User request: 用户明确核心研究问题是模型的哪些层或部分能够记住目标数据，而不是训练流程本身。
+- Outcome: 用户明确核心研究问题是模型的哪些层或部分能够记住目标数据，需要让路线图摘要完整可读。
+- Next: 继续推进单主线。
+- Linked bad cases: none
+
+### NODE-20260630-002: 完成本地按需启动聊天原型
+
+- Date: 2026-06-30
+- Status: done
+- Level: major
+- Branch: Main
+- User request: 用户希望完成本地 Web 聊天原型，并把相关问题案例和测试链路挂到节点下。
+- Outcome: 创建了本地 Web 聊天原型，前端页面可调用 Qwen3-1.7B-Base。
+- Next: 观察 worker 长时间运行问题。
+- Linked bad cases: BC-20260630-001, BC-20260630-002
+MD
+
+cat > "$CTX/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260630-001: Base 模型回复重复对话模板
+- Status: resolved
+- Roadmap nodes: NODE-20260630-002
+- Tags: #chat #model
+- Phenomenon: Base 模型可能重复输出对话模板。
+- Guard / verification: 运行短聊天请求，确认不会重复 continued chat transcript。
+
+### BC-20260630-002: 默认生成长度导致 worker 长时间运行
+- Status: resolved
+- Roadmap nodes: NODE-20260630-002
+- Tags: #runtime
+- Phenomenon: 默认生成长度过长导致 worker 持续运行。
+- Guard / verification: 运行短请求，确认响应能在合理时间返回。
+MD
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+HTML="$CTX/roadmap/roadmap.html"
+
+grep -q 'class="route-stack"' "$HTML"
+if grep -q 'class="route-stack branch-map"' "$HTML"; then
+  echo "single-route roadmap should not use branch-map layout" >&2
+  exit 1
+fi
+grep -q '.route-stack:not(.branch-map) .track-grid' "$HTML"
+grep -q 'min-height: auto;' "$HTML"
+grep -q 'single-mainline' "$HTML"
+grep -q '.track-column.route-column.no-test-line' "$HTML"
+grep -q -- '-webkit-line-clamp: 3;' "$HTML"
+
+if grep -q 'min-height: 430px;' "$HTML"; then
+  echo "single-route roadmap still reserves a large empty canvas" >&2
+  exit 1
+fi
+
+BODY="$(python3 - "$HTML" <<'PY'
+from pathlib import Path
+import sys
+html = Path(sys.argv[1]).read_text()
+print(html.split("</style>", 1)[1])
+PY
+)"
+
+if grep -q 'track-label-column' <<<"$BODY"; then
+  echo "single-route roadmap should not show a left lane label column" >&2
+  exit 1
+fi
+
+if grep -q 'data-lane="bad-cases"' <<<"$BODY"; then
+  echo "single-route roadmap should not render bad-case lanes in the overview" >&2
+  exit 1
+fi
+
+if grep -q 'data-lane="test-chain"' <<<"$BODY"; then
+  echo "single-route roadmap should not render test-chain lanes in the overview" >&2
+  exit 1
+fi
+
+if grep -q 'route-test-line' <<<"$BODY"; then
+  echo "single-route roadmap should not render the compact test route" >&2
+  exit 1
+fi

package/skills/context-guard/tests/BC-20260630-088.sh

@@ -0,0 +1,32 @@
+#!/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-display-title-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+python3 "$SCRIPT" checkpoint-roadmap-node \
+  --root "$ROOT" \
+  --title "用用户请求字段驱动节点详情" \
+  --display-title "按用户原话解释节点" \
+  --branch "Main" \
+  --level major \
+  --user-request "用户希望节点标题和详情问题摘要更接近自己的原话。" \
+  --outcome "路线图节点现在可以用独立的人类展示标题。" \
+  --decision "source title 可以服务检索，但 overview 标题必须先服务阅读。" \
+  --next-step "后续创建节点时同时填写 Display title 和 User request。" >/dev/null
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+
+grep -q -- "- Display title: 按用户原话解释节点" "$CTX/roadmap.md"
+grep -q "按用户原话解释节点" "$CTX/roadmap/roadmap.html"
+grep -q "按用户原话解释节点" "$CTX/roadmap/roadmap-details.html"
+
+if grep -q "用用户请求字段驱动节点详情" "$CTX/roadmap/roadmap.html"; then
+  echo "human roadmap should not expose the implementation-oriented source title" >&2
+  exit 1
+fi

package/skills/context-guard/tests/BC-20260630-089.sh

@@ -0,0 +1,63 @@
+#!/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-detail-summary-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+python3 "$SCRIPT" checkpoint-roadmap-node \
+  --root "$ROOT" \
+  --title "新增详情摘要字段并调整渲染优先级" \
+  --display-title "节点详情读起来更顺" \
+  --branch "Main" \
+  --level major \
+  --user-request "用户希望节点详情里的进度、问题案例和方法都读起来通顺。" \
+  --progress-summary "已经让节点详情优先显示人类进度摘要，避免把 schema、CLI 和 HTML 投影说明直接展示给用户。" \
+  --method-summary "把 agent 源字段和用户阅读字段分开；有摘要时优先显示摘要，没有摘要时才回退到旧字段。" \
+  --outcome "roadmap node schema、CLI 和 HTML projection now support human-readable detail summaries." \
+  --decision "The renderer used raw source fields, which sounded like implementation logs." \
+  --linked-bad-cases "BC-20260630-089" >/dev/null
+
+cat >> "$CTX/bad-cases.md" <<'EOF'
+
+### BC-20260630-089: 节点详情字段拼接导致阅读不顺
+
+- Status: resolved
+- First observed: 2026-06-30
+- Last checked: 2026-06-30
+- Scope: roadmap details
+- Roadmap nodes: NODE-20260630-001
+- Tags: #roadmap-ux #readability
+- Display summary: 详情页把实现记录直接展示出来，用户读起来像在看流水账。
+- Phenomenon: User-facing detail sections reused roadmap outcome, decision, avoid, and bad-case phenomenon fields directly, creating stiff implementation prose.
+- Fix method: Prefer human-written progress, method, and case display summaries before falling back to source fields.
+- Guard / verification: Run this script and inspect node detail output.
+EOF
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+DETAIL="$CTX/roadmap/roadmap-details.html"
+
+grep -q -- "- Progress summary: 已经让节点详情优先显示人类进度摘要" "$CTX/roadmap.md"
+grep -q -- "- Method summary: 把 agent 源字段和用户阅读字段分开" "$CTX/roadmap.md"
+grep -q -- "- Display summary: 详情页把实现记录直接展示出来" "$CTX/bad-cases.md"
+
+python3 - "$DETAIL" <<'PY'
+from pathlib import Path
+import re
+import sys
+
+html = Path(sys.argv[1]).read_text(encoding="utf-8")
+card = re.search(r'<section class="detail-card" id="node-1">(?P<body>.*?)</section>\s*</div>\s*</section>', html, re.S)
+assert card, "node detail card should exist"
+body = card.group("body")
+assert "已经让节点详情优先显示人类进度摘要" in body
+assert "把 agent 源字段和用户阅读字段分开" in body
+assert "详情页把实现记录直接展示出来，用户读起来像在看流水账" in body
+assert "roadmap node schema、CLI 和 HTML projection" not in body
+assert "The renderer used raw source fields" not in body
+assert "User-facing detail sections reused" not in body
+PY

package/skills/context-guard/tests/BC-20260701-090.sh

@@ -0,0 +1,83 @@
+#!/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-approved-tests-XXXXXX")"
+trap 'rm -rf "$ROOT"' EXIT
+
+python3 "$SCRIPT" init --root "$ROOT" >/dev/null
+python3 "$SCRIPT" set-language --language zh --root "$ROOT" >/dev/null
+
+CTX="$ROOT/.codex/context"
+cat > "$CTX/roadmap.md" <<'MD'
+# Context Roadmap
+
+## Nodes
+
+### NODE-20260701-001: 主线阶段
+
+- Date: 2026-07-01
+- Status: done
+- Level: major
+- Branch: Main
+- Display title: 主线阶段
+- Outcome: 主线阶段完成。
+- Linked bad cases: BC-20260701-001
+
+### NODE-20260701-002: 支线阶段
+
+- Date: 2026-07-01
+- Status: done
+- Level: major
+- Branch: 支线
+- Parent: NODE-20260701-001
+- Display title: 支线阶段
+- Outcome: 支线阶段完成。
+- Linked bad cases: BC-20260701-002
+MD
+
+cat > "$CTX/bad-cases.md" <<'MD'
+# Bad Case Register
+
+### BC-20260701-001: 普通 bad case guard 不应显示为测试
+- Status: resolved
+- Roadmap nodes: NODE-20260701-001
+- Tags: #roadmap-ux
+- Phenomenon: 普通 bad case guard 被误当成用户测试。
+- Guard / verification: 这是普通复发检查，不是用户批准测试。
+
+### BC-20260701-002: 用户批准测试应显示
+- Status: resolved
+- Roadmap nodes: NODE-20260701-002
+- Tags: #roadmap-ux
+- Phenomenon: 用户批准的测试需要显示在线路上。
+- Guard / verification: 运行用户确认的测试。
+- Run policy: every-dev-completion
+MD
+
+python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
+HTML="$CTX/roadmap/roadmap.html"
+BODY="$(python3 - "$HTML" <<'PY'
+from pathlib import Path
+import sys
+html = Path(sys.argv[1]).read_text()
+print(html.split("</style>", 1)[1])
+PY
+)"
+
+python3 - <<'PY' "$HTML"
+from pathlib import Path
+import sys
+import re
+html = Path(sys.argv[1]).read_text()
+body = html.split("</style>", 1)[1]
+notes = re.findall(r'<a class="route-test-note"[^>]*>(.*?)</a>', body, re.S)
+joined = "\n".join(notes)
+if "用户批准测试应显示" not in joined:
+    raise SystemExit("approved test did not appear in the route test line")
+if "普通 bad case guard 不应显示为测试" in joined:
+    raise SystemExit("ordinary linked bad-case guard appeared as a test route item")
+test_items = len(notes)
+if test_items != 1:
+    raise SystemExit(f"expected exactly one approved test route item, got {test_items}")
+PY