@research-copilot/plugin 1.1.16 → 1.1.18

package/dist/skills/llm-wiki/tests/graph-browser-stage-4-5.regression-1.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+# Regression: stage 4.5 graph browser interactions
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+# shellcheck disable=SC1091
+source "$REPO_ROOT/tests/lib/graph-html-engine-helpers.sh"
+
+target="offline"
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --target)
+      target="${2:-}"
+      shift 2
+      ;;
+    *)
+      fail "Unknown argument: $1"
+      ;;
+  esac
+done
+
+if [ "$target" != "offline" ] && [ "$target" != "workbench" ]; then
+  fail "stage 4.5 browser regression target '$target' is not implemented yet"
+fi
+
+tmp_dir="$(mktemp -d)"
+server_pid=""
+web_pid=""
+cleanup() {
+  if [ -n "$server_pid" ]; then kill "$server_pid" 2>/dev/null || true; fi
+  if [ -n "$web_pid" ]; then kill "$web_pid" 2>/dev/null || true; fi
+  rm -rf "$tmp_dir"
+}
+trap cleanup EXIT
+
+npm run build -w @llm-wiki/graph-engine > /dev/null 2>&1 \
+  || fail "graph-engine build should succeed before stage 4.5 browser regression"
+build_graph_html_fixture "$tmp_dir"
+node - "$tmp_dir/wiki/graph-data.json" <<'NODE'
+const fs = require("fs");
+const file = process.argv[2];
+const data = JSON.parse(fs.readFileSync(file, "utf8"));
+for (const node of data.nodes) {
+  if (node.id === "A") {
+    node.date = "2026-01-02";
+    node.source_title = "不应作为实体来源链接";
+  }
+}
+data.nodes.push({
+  id: "S",
+  label: "节点来源S",
+  type: "source",
+  community: "t2",
+  content: "# 来源S\n\n这是来源S的内容。\n",
+  source_path: "/fake/wiki/sources/S.md",
+  date: "2026-01-03",
+  source_title: "原始文章S"
+});
+data.edges.push({ id: "e3", from: "A", to: "S", type: "EXTRACTED" });
+data.meta.total_nodes = data.nodes.length;
+data.meta.total_edges = data.edges.length;
+data.meta.initial_view = Array.from(new Set([...(data.meta.initial_view || []), "S"]));
+fs.writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`);
+NODE
+bash "$REPO_ROOT/scripts/build-graph-html.sh" "$tmp_dir" > /dev/null 2>&1 \
+  || fail "build-graph-html.sh should succeed after augmenting stage 4.5 browser fixture"
+
+dense_dir="$tmp_dir/dense/wiki"
+mkdir -p "$dense_dir"
+cp "$REPO_ROOT/tests/fixtures/graph-interactive-dense/wiki/graph-data.json" "$dense_dir/graph-data.json"
+bash "$REPO_ROOT/scripts/build-graph-html.sh" "$tmp_dir/dense" > /dev/null 2>&1 \
+  || fail "build-graph-html.sh should succeed on dense stage 4.5 browser fixture"
+
+artifact_dir="$tmp_dir/stage-4.5-artifacts"
+mkdir -p "$artifact_dir"
+
+if [ "$target" = "workbench" ]; then
+  if lsof -i TCP:8787 -sTCP:LISTEN >/dev/null 2>&1; then
+    fail "port 8787 is already in use"
+  fi
+  if lsof -i TCP:5180 -sTCP:LISTEN >/dev/null 2>&1; then
+    fail "port 5180 is already in use"
+  fi
+
+  workbench_kb="$tmp_dir/workbench-kb"
+  mkdir -p "$workbench_kb/wiki/entities" "$tmp_dir/home/.llm-wiki-agent"
+  cp "$REPO_ROOT/tests/fixtures/graph-interactive-basic/wiki/graph-data.json" "$workbench_kb/wiki/graph-data.json"
+  cat > "$workbench_kb/.wiki-schema.md" <<'EOF'
+# Test schema
+EOF
+  cat > "$workbench_kb/purpose.md" <<'EOF'
+# Stage 4.5 Workbench Test
+EOF
+  cat > "$workbench_kb/wiki/entities/A.md" <<'EOF'
+# 节点A
+
+这是节点A的正文。参见 [[wiki/entities/B.md]]。
+EOF
+  cat > "$workbench_kb/wiki/entities/B.md" <<'EOF'
+# 节点B
+
+这是节点B的正文。
+EOF
+  cat > "$workbench_kb/wiki/entities/C.md" <<'EOF'
+# 节点C
+
+这是节点C的正文。
+EOF
+  node - "$workbench_kb/wiki/graph-data.json" <<'NODE'
+const fs = require("fs");
+const file = process.argv[2];
+const data = JSON.parse(fs.readFileSync(file, "utf8"));
+for (const node of data.nodes) {
+  node.source_path = `wiki/entities/${node.id}.md`;
+}
+fs.writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`);
+NODE
+  cat > "$tmp_dir/home/.llm-wiki-agent/config.json" <<JSON
+{
+  "version": 1,
+  "externalKnowledgeBases": ["$workbench_kb"]
+}
+JSON
+
+  HOME="$tmp_dir/home" PORT=8787 npm run dev -w @llm-wiki-agent/server > "$tmp_dir/server.log" 2>&1 &
+  server_pid="$!"
+  npm run dev -w @llm-wiki-agent/web -- --host 127.0.0.1 > "$tmp_dir/web.log" 2>&1 &
+  web_pid="$!"
+
+  for _ in $(seq 1 80); do
+    if curl -fsS "http://127.0.0.1:8787/api/knowledge-bases" >/dev/null 2>&1 \
+      && curl -fsS "http://127.0.0.1:5180" >/dev/null 2>&1; then
+      break
+    fi
+    sleep 0.25
+  done
+
+  curl -fsS "http://127.0.0.1:8787/api/knowledge-bases" >/dev/null 2>&1 \
+    || fail "workbench server did not start; see $tmp_dir/server.log"
+  curl -fsS "http://127.0.0.1:5180" >/dev/null 2>&1 \
+    || fail "workbench web did not start; see $tmp_dir/web.log"
+fi
+
+export GRAPH_STAGE_4_5_TARGET="$target"
+export GRAPH_STAGE_4_5_OFFLINE_HTML="$tmp_dir/wiki/knowledge-graph.html"
+export GRAPH_STAGE_4_5_DENSE_HTML="$dense_dir/knowledge-graph.html"
+export GRAPH_STAGE_4_5_ARTIFACT_DIR="$artifact_dir"
+export GRAPH_STAGE_4_5_WORKBENCH_URL="http://127.0.0.1:5180"
+
+cd "$REPO_ROOT"
+playwright_node_path="$(
+  npx --yes -p playwright -c 'node -e "const path=require(\"path\"); console.log(path.dirname(process.env.PATH.split(\":\")[0]))"'
+)"
+NODE_PATH="$playwright_node_path" node tests/browser/graph-stage-4-5.mjs
+
+echo "PASS: stage 4.5 browser regression ($target)"

package/dist/skills/llm-wiki/tests/graph-build-failures.regression-1.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# Regression: graph build should fail clearly when node/engine path is broken
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+GRAPH_DATA_SAMPLE="$REPO_ROOT/tests/fixtures/graph-data-sample-wiki"
+
+fail() {
+    echo "FAIL: $1" >&2
+    exit 1
+}
+
+assert_text_contains() {
+    local text="$1"
+    local expected="$2"
+
+    if ! printf '%s' "$text" | grep -F -- "$expected" > /dev/null; then
+        fail "Expected output to contain: $expected"
+    fi
+}
+
+test_graph_data_exits_without_node() {
+    local tmp_dir fake_bin output
+    tmp_dir="$(mktemp -d)"
+    fake_bin="$tmp_dir/bin"
+    mkdir -p "$fake_bin"
+
+    ln -s /bin/bash "$fake_bin/bash"
+    ln -s "$(command -v jq)" "$fake_bin/jq"
+
+    if output="$(PATH="$fake_bin" bash "$REPO_ROOT/scripts/build-graph-data.sh" "$GRAPH_DATA_SAMPLE" 2>&1)"; then
+        fail "build-graph-data.sh should fail when node is unavailable"
+    fi
+
+    assert_text_contains "$output" "node"
+    assert_text_contains "$output" "Install it via"
+
+    rm -rf "$tmp_dir"
+}
+
+test_graph_data_exits_when_helper_missing() {
+    local tmp_dir repo_copy output
+    tmp_dir="$(mktemp -d)"
+    repo_copy="$tmp_dir/repo"
+
+    cp -R "$REPO_ROOT" "$repo_copy"
+    rm -rf "$repo_copy/.git"
+    rm "$repo_copy/scripts/graph-analysis.js"
+
+    if output="$(LLM_WIKI_TEST_MODE=1 bash "$repo_copy/scripts/build-graph-data.sh" "$repo_copy/tests/fixtures/graph-data-sample-wiki" 2>&1)"; then
+        fail "build-graph-data.sh should fail when helper is missing"
+    fi
+
+    assert_text_contains "$output" "graph-analysis.js"
+    assert_text_contains "$output" "图谱分析 helper"
+
+    rm -rf "$tmp_dir"
+}
+
+test_graph_html_keeps_existing_html_when_engine_asset_missing() {
+    local tmp_dir repo_copy output html_path
+    tmp_dir="$(mktemp -d)"
+    repo_copy="$tmp_dir/repo"
+
+    cp -R "$REPO_ROOT" "$repo_copy"
+    rm -rf "$repo_copy/.git"
+    rm "$repo_copy/packages/graph-engine/dist/engine.iife.js"
+
+    html_path="$repo_copy/tests/fixtures/graph-interactive-basic/wiki/knowledge-graph.html"
+    printf 'stable old html\n' > "$html_path"
+
+    if output="$(bash "$repo_copy/scripts/build-graph-html.sh" "$repo_copy/tests/fixtures/graph-interactive-basic" 2>&1)"; then
+        fail "build-graph-html.sh should fail when engine asset is missing"
+    fi
+
+    assert_text_contains "$output" "engine.iife.js"
+    assert_text_contains "$output" "graph-engine IIFE 产物"
+    assert_text_contains "$(cat "$html_path")" "stable old html"
+
+    rm -rf "$tmp_dir"
+}
+
+main() {
+    test_graph_data_exits_without_node
+    test_graph_data_exits_when_helper_missing
+    test_graph_html_keeps_existing_html_when_engine_asset_missing
+    echo "PASS: graph build failure regression coverage"
+}
+
+main "$@"

package/dist/skills/llm-wiki/tests/graph-data-confidence-merge.regression-1.sh

@@ -0,0 +1,309 @@
+#!/bin/bash
+# Regression: build-graph-data.sh should upgrade edge type from default EXTRACTED
+# to explicit INFERRED / AMBIGUOUS when the same (from, to) pair is referenced
+# multiple times within a single source file.
+#
+# Motivates fix for:
+#   scripts/build-graph-data.sh edge-merge awk block —
+#   previously the condition `saved_conf[key] == ""` was always false once the
+#   key had been seen (because the ternary in the same branch always filled
+#   it with "EXTRACTED" or the current conf), so the first occurrence locked
+#   the edge type forever. Any later `<!-- confidence: INFERRED -->` annotation
+#   on the same [[link]] in subsequent lines was silently ignored.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+SCRIPT="$REPO_ROOT/scripts/build-graph-data.sh"
+
+fail() {
+    echo "FAIL: $1" >&2
+    exit 1
+}
+
+test_explicit_confidence_overrides_default_on_same_page() {
+    local tmp_dir
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/wiki/entities"
+
+    # A.md: first reference to B has no annotation (default EXTRACTED),
+    # later reference in the 相关页面 list carries explicit INFERRED.
+    # Before the fix, first occurrence locks type to EXTRACTED forever.
+    cat > "$tmp_dir/wiki/entities/A.md" <<'EOF'
+---
+tags: [test]
+---
+
+# A
+
+正文中提到 [[B]] 是一个相关的模块。
+
+## 相关页面
+
+- [[B]] <!-- confidence: INFERRED --> — 推断关联
+EOF
+
+    cat > "$tmp_dir/wiki/entities/B.md" <<'EOF'
+---
+tags: [test]
+---
+
+# B
+
+## 相关页面
+
+- [[A]] <!-- confidence: INFERRED --> — 推断关联
+EOF
+
+    # Minimal purpose.md so build-graph-data doesn't bail
+    cat > "$tmp_dir/purpose.md" <<'EOF'
+# 研究目的
+test
+EOF
+
+    LLM_WIKI_TEST_MODE=1 \
+        bash "$SCRIPT" "$tmp_dir" "$tmp_dir/graph-data.json" > /dev/null 2>&1 \
+        || fail "build-graph-data.sh should succeed on fixture"
+
+    local a_to_b_type b_to_a_type
+    a_to_b_type=$(jq -r '.edges[] | select(.from == "A" and .to == "B") | .type' "$tmp_dir/graph-data.json")
+    b_to_a_type=$(jq -r '.edges[] | select(.from == "B" and .to == "A") | .type' "$tmp_dir/graph-data.json")
+
+    [ "$a_to_b_type" = "INFERRED" ] \
+        || fail "A→B should be INFERRED after merging (default + explicit INFERRED on same page), got: $a_to_b_type"
+
+    [ "$b_to_a_type" = "INFERRED" ] \
+        || fail "B→A should be INFERRED (only one reference, explicitly annotated), got: $b_to_a_type"
+}
+
+test_ambiguous_overrides_default_when_mixed() {
+    local tmp_dir
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/wiki/entities"
+
+    # X.md references Y multiple times: plain body + AMBIGUOUS annotation
+    cat > "$tmp_dir/wiki/entities/X.md" <<'EOF'
+---
+tags: [test]
+---
+
+# X
+
+See [[Y]] in context.
+Also mention [[Y]] again.
+
+## 相关页面
+
+- [[Y]] <!-- confidence: AMBIGUOUS --> — 待确认
+EOF
+
+    cat > "$tmp_dir/wiki/entities/Y.md" <<'EOF'
+---
+tags: [test]
+---
+
+# Y
+
+## 相关页面
+
+- [[X]]
+EOF
+
+    cat > "$tmp_dir/purpose.md" <<'EOF'
+# 研究目的
+test
+EOF
+
+    LLM_WIKI_TEST_MODE=1 \
+        bash "$SCRIPT" "$tmp_dir" "$tmp_dir/graph-data.json" > /dev/null 2>&1 \
+        || fail "build-graph-data.sh should succeed on fixture"
+
+    local x_to_y_type
+    x_to_y_type=$(jq -r '.edges[] | select(.from == "X" and .to == "Y") | .type' "$tmp_dir/graph-data.json")
+
+    [ "$x_to_y_type" = "AMBIGUOUS" ] \
+        || fail "X→Y should be AMBIGUOUS (default + default + AMBIGUOUS merge), got: $x_to_y_type"
+}
+
+test_default_extracted_when_no_annotation() {
+    local tmp_dir
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/wiki/entities"
+
+    cat > "$tmp_dir/wiki/entities/P.md" <<'EOF'
+---
+tags: [test]
+---
+
+# P
+
+See [[Q]].
+
+## 相关页面
+
+- [[Q]]
+EOF
+
+    cat > "$tmp_dir/wiki/entities/Q.md" <<'EOF'
+---
+tags: [test]
+---
+
+# Q
+
+## 相关页面
+
+- [[P]]
+EOF
+
+    cat > "$tmp_dir/purpose.md" <<'EOF'
+# 研究目的
+test
+EOF
+
+    LLM_WIKI_TEST_MODE=1 \
+        bash "$SCRIPT" "$tmp_dir" "$tmp_dir/graph-data.json" > /dev/null 2>&1 \
+        || fail "build-graph-data.sh should succeed on fixture"
+
+    local p_to_q_type
+    p_to_q_type=$(jq -r '.edges[] | select(.from == "P" and .to == "Q") | .type' "$tmp_dir/graph-data.json")
+
+    [ "$p_to_q_type" = "EXTRACTED" ] \
+        || fail "P→Q should default to EXTRACTED when no annotation exists, got: $p_to_q_type"
+}
+
+test_first_explicit_wins_among_multiple_explicit() {
+    # When two different explicit confidence values appear for the same
+    # (from, to) pair within the same page, the first-seen one should win
+    # (stable + deterministic). This keeps semantics aligned with the
+    # existing "first occurrence" comment in the awk block.
+    local tmp_dir
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/wiki/entities"
+
+    cat > "$tmp_dir/wiki/entities/M.md" <<'EOF'
+---
+tags: [test]
+---
+
+# M
+
+See [[N]] <!-- confidence: INFERRED --> in the body.
+
+## 相关页面
+
+- [[N]] <!-- confidence: AMBIGUOUS --> — should NOT override INFERRED
+EOF
+
+    cat > "$tmp_dir/wiki/entities/N.md" <<'EOF'
+---
+tags: [test]
+---
+
+# N
+
+## 相关页面
+
+- [[M]]
+EOF
+
+    cat > "$tmp_dir/purpose.md" <<'EOF'
+# 研究目的
+test
+EOF
+
+    LLM_WIKI_TEST_MODE=1 \
+        bash "$SCRIPT" "$tmp_dir" "$tmp_dir/graph-data.json" > /dev/null 2>&1 \
+        || fail "build-graph-data.sh should succeed on fixture"
+
+    local m_to_n_type
+    m_to_n_type=$(jq -r '.edges[] | select(.from == "M" and .to == "N") | .type' "$tmp_dir/graph-data.json")
+
+    [ "$m_to_n_type" = "INFERRED" ] \
+        || fail "M→N should keep first explicit INFERRED, got: $m_to_n_type"
+}
+
+test_edge_contract_separates_relation_type_and_confidence() {
+    local tmp_dir
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/wiki/entities"
+
+    cat > "$tmp_dir/wiki/entities/A.md" <<'EOF'
+---
+tags: [test]
+---
+
+# A
+
+See [[B]] without labels first.
+
+## 相关页面
+
+- [[B]] <!-- relation: 实现 --> <!-- confidence: INFERRED --> — explicit contract
+- [[C]] — default contract
+EOF
+
+    cat > "$tmp_dir/wiki/entities/B.md" <<'EOF'
+---
+tags: [test]
+---
+
+# B
+EOF
+
+    cat > "$tmp_dir/wiki/entities/C.md" <<'EOF'
+---
+tags: [test]
+---
+
+# C
+EOF
+
+    cat > "$tmp_dir/purpose.md" <<'EOF'
+# 研究目的
+test
+EOF
+
+    LLM_WIKI_TEST_MODE=1 \
+        bash "$SCRIPT" "$tmp_dir" "$tmp_dir/graph-data.json" > /dev/null 2>&1 \
+        || fail "build-graph-data.sh should succeed on relation contract fixture"
+
+    local a_to_b_type a_to_b_confidence a_to_b_relation
+    a_to_b_type=$(jq -r '.edges[] | select(.from == "A" and .to == "B") | .type' "$tmp_dir/graph-data.json")
+    a_to_b_confidence=$(jq -r '.edges[] | select(.from == "A" and .to == "B") | .confidence' "$tmp_dir/graph-data.json")
+    a_to_b_relation=$(jq -r '.edges[] | select(.from == "A" and .to == "B") | .relation_type' "$tmp_dir/graph-data.json")
+
+    [ "$a_to_b_type" = "INFERRED" ] \
+        || fail "A→B legacy type should remain INFERRED for compatibility, got: $a_to_b_type"
+    [ "$a_to_b_confidence" = "INFERRED" ] \
+        || fail "A→B confidence should be INFERRED, got: $a_to_b_confidence"
+    [ "$a_to_b_relation" = "实现" ] \
+        || fail "A→B relation_type should be 实现, got: $a_to_b_relation"
+
+    local a_to_c_confidence a_to_c_relation
+    a_to_c_confidence=$(jq -r '.edges[] | select(.from == "A" and .to == "C") | .confidence' "$tmp_dir/graph-data.json")
+    a_to_c_relation=$(jq -r '.edges[] | select(.from == "A" and .to == "C") | .relation_type' "$tmp_dir/graph-data.json")
+
+    [ "$a_to_c_confidence" = "EXTRACTED" ] \
+        || fail "A→C confidence should default to EXTRACTED, got: $a_to_c_confidence"
+    [ "$a_to_c_relation" = "依赖" ] \
+        || fail "A→C relation_type should default to 依赖, got: $a_to_c_relation"
+}
+
+test_explicit_confidence_overrides_default_on_same_page
+test_ambiguous_overrides_default_when_mixed
+test_default_extracted_when_no_annotation
+test_first_explicit_wins_among_multiple_explicit
+test_edge_contract_separates_relation_type_and_confidence
+
+echo "PASS: graph-data-confidence-merge.regression-1"

package/dist/skills/llm-wiki/tests/graph-data-source-paths.regression-1.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Regression: graph-data nodes must keep wiki-relative page paths for workbench reader and selection prompts.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+SCRIPT="$REPO_ROOT/scripts/build-graph-data.sh"
+
+fail() {
+    echo "FAIL: $1" >&2
+    exit 1
+}
+
+test_synthesis_session_node_keeps_wiki_relative_path() {
+    local tmp_dir source_path private_path
+    tmp_dir="$(mktemp -d)"
+
+    mkdir -p "$tmp_dir/wiki/synthesis/sessions"
+
+    cat > "$tmp_dir/purpose.md" <<'EOF'
+# Source Path Fixture
+EOF
+
+    cat > "$tmp_dir/wiki/synthesis/sessions/A.md" <<'EOF'
+# A
+
+消化结果正文。
+EOF
+
+    LLM_WIKI_TEST_MODE=1 \
+        bash "$SCRIPT" "$tmp_dir" "$tmp_dir/wiki/graph-data.json" > /dev/null 2>&1 \
+        || fail "build-graph-data.sh should succeed on synthesis session fixture"
+
+    source_path="$(jq -r '.nodes[] | select(.id == "A") | .source_path // ""' "$tmp_dir/wiki/graph-data.json")"
+    [ "$source_path" = "wiki/synthesis/sessions/A.md" ] \
+        || fail "Expected source_path to be wiki/synthesis/sessions/A.md, got: $source_path"
+
+    private_path="$(jq -r '.nodes[] | select(.id == "A") | ._file_path // ""' "$tmp_dir/wiki/graph-data.json")"
+    [ -z "$private_path" ] || fail "Graph data should not expose helper-only _file_path, got: $private_path"
+
+    rm -rf "$tmp_dir"
+}
+
+main() {
+    test_synthesis_session_node_keeps_wiki_relative_path
+    echo "PASS: graph data source path regression coverage"
+}
+
+main "$@"

package/dist/skills/llm-wiki/tests/graph-html-a11y.regression-1.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+# Regression: engine graph HTML should keep accessible node and reader hooks
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+source "$REPO_ROOT/tests/lib/graph-html-engine-helpers.sh"
+
+test_graph_html_has_reduced_motion_and_accessible_markup() {
+    local tmp_dir html
+    tmp_dir="$(mktemp -d)"
+
+    build_graph_html_fixture "$tmp_dir"
+    html="$tmp_dir/wiki/knowledge-graph.html"
+
+    assert_file_contains "$html" "prefers-reduced-motion"
+    assert_file_contains "$html" "aria-label=\"图谱统计\""
+    assert_file_contains "$html" 'setAttribute(`aria-hidden`,`true`)'
+    assert_file_contains "$html" 'setAttribute(`aria-pressed`,e.selected?`true`:`false`)'
+    assert_file_contains "$html" 'setAttribute(`aria-label`,`关闭阅读面板`)'
+
+    rm -rf "$tmp_dir"
+}
+
+test_graph_html_has_keyboard_safe_reader_close() {
+    local tmp_dir html
+    tmp_dir="$(mktemp -d)"
+
+    build_graph_html_fixture "$tmp_dir"
+    html="$tmp_dir/wiki/knowledge-graph.html"
+
+    grep -Eq '[[:alnum:]_$]+\.type=`button`' "$html" \
+        || fail "Expected $html to set generated graph buttons to type=button"
+    assert_file_contains "$html" "graph-reader-close"
+    assert_file_contains "$html" "关闭阅读面板"
+    assert_file_contains "$REPO_ROOT/packages/graph-engine/src/render/static-renderer.ts" 'close.addEventListener("click", () => clearInteractionState());'
+
+    rm -rf "$tmp_dir"
+}
+
+main() {
+    test_graph_html_has_reduced_motion_and_accessible_markup
+    test_graph_html_has_keyboard_safe_reader_close
+    echo "PASS: graph HTML a11y regression coverage"
+}
+
+main "$@"