@michelj/context-guard 0.4.2 → 0.4.4

package/skills/context-guard/tests/BC-20260618-065.sh

@@ -1,66 +0,0 @@
-#!/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-marker-test-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-20260618-001: 标记测试节点
-
-- Date: 2026-06-18
-- Status: done
-- Level: major
-- Branch: Main
-- Parent: none
-- Task: `CTX-20260618-marker`
-- Outcome: 检查问题案例标题行标记布局。
-- Decision / reason: 标记不能单独占一行。
-- Avoid going back: 不要把状态点放在标题前面。
-- Next: none
-- Linked bad cases: BC-20260618-999
-- Test chain: none
-MD
-
-cat > "$CTX/bad-cases.md" <<'MD'
-# Bad Case Register
-
-## Active Cases
-
-### BC-20260618-999: 这是一个很长的问题案例标题用于触发换行但标记不能单独成行
-
-- Status: resolved
-- First observed: 2026-06-18
-- Last checked: 2026-06-18
-- Scope: roadmap marker layout
-- Context task: `CTX-20260618-marker`
-- Roadmap nodes: NODE-20260618-001
-- Tags: #roadmap-ux
-- Frequency: repeated-2
-- Phenomenon: 状态点和频率点不应该单独一行。
-- Trigger / reproduction: 生成 roadmap 并检查 badcase-head。
-- Root cause: 标记位于标题前，窄列时容易变成单独一行。
-- Fix method: 将标记移到标题右侧的 inline marker 容器。
-- Guard / verification: 本脚本检查 HTML 结构。
-- Reusable guard path: none
-- Test chain: none
-MD
-
-python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
-HTML="$CTX/roadmap/roadmap.html"
-
-grep -q 'class="badcase-markers"' "$HTML"
-grep -q '.badcase-head { display: grid; grid-template-columns: minmax(0, 1fr) auto;' "$HTML"
-if grep -q '<div class="badcase-head"><span class="status-dot' "$HTML"; then
-  echo "badcase marker still starts a separate title row" >&2
-  exit 1
-fi
-grep -q '<a class="detail-link" href="#case-1">' "$HTML"

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

@@ -1,48 +0,0 @@
-#!/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-map-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: 这是一段很长的主线摘要，过去会直接显示在多路线概览卡片里，让路线图看起来像卡片墙而不是路线骨架。
-- Next: none
-- Linked bad cases: none
-
-### NODE-20260626-002: 支线入口
-
-- Date: 2026-06-26
-- Status: done
-- Level: major
-- Branch: 可读性支线
-- Parent: NODE-20260626-001
-- Outcome: 这是一段很长的支线摘要，应该留在详情里，而不是占据概览卡片的主要视觉空间。
-- Next: none
-- Linked bad cases: none
-MD
-
-python3 "$SCRIPT" show-roadmap --root "$ROOT" >/dev/null
-HTML="$CTX/roadmap/roadmap.html"
-
-grep -q 'class="route-stack branch-map"' "$HTML"
-grep -q '.track-grid.route-only {' "$HTML"
-grep -q 'grid-auto-columns: minmax(180px, 230px);' "$HTML"
-grep -q '.branch-map .summary {' "$HTML"
-grep -q 'display: none;' "$HTML"
-grep -q -- '-webkit-line-clamp: 3;' "$HTML"

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

@@ -1,40 +0,0 @@
-#!/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

@@ -1,32 +0,0 @@
-#!/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

@@ -1,66 +0,0 @@
-#!/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

@@ -1,74 +0,0 @@
-#!/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

@@ -1,50 +0,0 @@
-#!/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

@@ -1,103 +0,0 @@
-#!/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

@@ -1,32 +0,0 @@
-#!/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

@@ -1,63 +0,0 @@
-#!/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

@@ -1,83 +0,0 @@
-#!/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