@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/skills/llm-wiki-skill/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/skills/llm-wiki-skill/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/skills/llm-wiki-skill/tests/graph-default-behavior.regression-1.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Regression: graph-owned surfaces should own browser-conflicting defaults.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+# shellcheck disable=SC1091
+source "$REPO_ROOT/tests/lib/graph-html-engine-helpers.sh"
+
+tmp_dir="$(mktemp -d)"
+cleanup() {
+    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 graph default behavior browser regression"
+build_graph_html_fixture "$tmp_dir"
+
+playwright_node_path="$(
+    npx --yes -p playwright -c 'node -e "const path=require(\"path\"); console.log(path.dirname(process.env.PATH.split(\":\")[0]))"'
+)"
+
+chrome_executable="${GRAPH_DEFAULT_BEHAVIOR_CHROME_EXECUTABLE:-}"
+if [ -z "$chrome_executable" ] && [ -x "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" ]; then
+    chrome_executable="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+fi
+
+GRAPH_DEFAULT_BEHAVIOR_HTML="$tmp_dir/wiki/knowledge-graph.html" \
+GRAPH_DEFAULT_BEHAVIOR_CHROME_EXECUTABLE="$chrome_executable" \
+NODE_PATH="$playwright_node_path" \
+node "$REPO_ROOT/tests/browser/graph-default-behavior.mjs" \
+    || fail "graph default behavior browser regression should pass"
+
+echo "PASS: graph default behavior regression"

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

@@ -0,0 +1,50 @@
+#!/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`)'
+    grep -Eq 'setAttribute\(`aria-pressed`,[^)]*\)' "$html" \
+        || fail "Expected $html to include generated aria-pressed binding"
+    assert_file_contains "$REPO_ROOT/packages/graph-engine/src/render/nodes.ts" 'button.setAttribute("aria-pressed", node.selected ? "true" : "false");'
+    assert_file_contains "$html" "关闭阅读面板"
+    assert_file_contains "$REPO_ROOT/packages/graph-engine/src/render/offline-reader.ts" 'close.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/offline-reader.ts" 'close.addEventListener("click", input.onClose);'
+
+    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 "$@"

package/skills/llm-wiki-skill/tests/graph-html-brand-link.regression-1.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+# Regression: offline graph header should keep product identity without external links
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+source "$REPO_ROOT/tests/lib/graph-html-engine-helpers.sh"
+
+test_graph_html_has_product_branding() {
+    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" "HTML测试知识库 知识舆图"
+    assert_file_contains "$html" "国风知识库·数字山水图"
+    assert_file_contains "$html" "aria-label=\"图谱统计\""
+    assert_file_contains "$html" "3 节点"
+    assert_file_contains "$html" "2 关联"
+
+    rm -rf "$tmp_dir"
+}
+
+test_graph_html_has_focus_visible_style_without_external_brand_assets() {
+    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" "offline-shell"
+    assert_file_not_contains "$html" "brand__github"
+    assert_file_not_contains "$html" "<span>GitHub</span>"
+    assert_file_not_contains "$html" "fonts.googleapis.com"
+    assert_file_not_contains "$html" "cdn.jsdelivr.net"
+
+    rm -rf "$tmp_dir"
+}
+
+main() {
+    test_graph_html_has_product_branding
+    test_graph_html_has_focus_visible_style_without_external_brand_assets
+    echo "PASS: graph HTML brand regression coverage"
+}
+
+main "$@"