@joekytc/dsh-swarm 0.1.2 → 0.3.0

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

@@ -0,0 +1,163 @@
+#!/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"
+
+chrome_executable="${GRAPH_STAGE_4_5_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
+export GRAPH_STAGE_4_5_CHROME_EXECUTABLE="$chrome_executable"
+
+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/skills/llm-wiki-skill/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/skills/llm-wiki-skill/tests/graph-community-node-map.regression-1.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+# Regression: focused community view renders as a lightweight node relationship map.
+
+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 community node map 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 graph = JSON.parse(fs.readFileSync(file, "utf8"));
+const coreNodes = [
+  { id: "A", label: "节点A", type: "topic", community: "t1", content: "# 节点A\n\n这是节点A。", source_path: "/fake/wiki/entities/A.md", x: 24, y: 42, weight: 90 },
+  { id: "B", label: "节点B", type: "entity", community: "t1", content: "# 节点B\n\n这是节点B。", source_path: "/fake/wiki/entities/B.md", x: 36, y: 32, weight: 70 },
+  { id: "C", label: "节点C", type: "source", community: "t1", content: "# 节点C\n\n这是节点C。", source_path: "/fake/wiki/entities/C.md", x: 38, y: 56, weight: 60 },
+  { id: "D", label: "节点D", type: "entity", community: "t1", content: "# 节点D\n\n这是节点D。", source_path: "/fake/wiki/entities/D.md", x: 55, y: 34, weight: 50 },
+  { id: "E", label: "节点E", type: "entity", community: "t1", content: "# 节点E\n\n这是节点E。", source_path: "/fake/wiki/entities/E.md", x: 68, y: 38, weight: 40 },
+  { id: "F", label: "节点F", type: "comparison", community: "t1", content: "# 节点F\n\n这是节点F。", source_path: "/fake/wiki/entities/F.md", x: 80, y: 46, weight: 30 }
+];
+const fillerNodes = Array.from({ length: 18 }, (_, index) => {
+  const id = `N${index + 1}`;
+  const column = index % 6;
+  const row = Math.floor(index / 6);
+  return {
+    id,
+    label: `普通节点${index + 1}`,
+    type: index % 7 === 0 ? "topic" : index % 5 === 0 ? "source" : "entity",
+    community: "t1",
+    content: `# 普通节点${index + 1}\n\n这是用于验证默认标签稀疏度的普通节点。`,
+    source_path: `/fake/wiki/entities/${id}.md`,
+    x: 18 + column * 12,
+    y: 18 + row * 21,
+    weight: Math.max(5, 28 - index)
+  };
+});
+graph.nodes = [...coreNodes, ...fillerNodes];
+const aNeighborEdges = Array.from({ length: 10 }, (_, index) => ({
+  id: `eAN${index + 1}`,
+  from: "A",
+  to: `N${index + 1}`,
+  type: "EXTRACTED",
+  confidence: "EXTRACTED",
+  relation_type: index % 2 === 0 ? "实现" : "依赖",
+  weight: 0.6
+}));
+graph.edges = [
+  { id: "eAB", from: "A", to: "B", type: "EXTRACTED", confidence: "EXTRACTED", relation_type: "实现", weight: 1 },
+  { id: "eAC", from: "A", to: "C", type: "INFERRED", confidence: "INFERRED", relation_type: "对比", weight: 0.8 },
+  { id: "eBD", from: "B", to: "D", type: "EXTRACTED", confidence: "EXTRACTED", relation_type: "依赖", weight: 0.7 },
+  { id: "eDE", from: "D", to: "E", type: "EXTRACTED", confidence: "EXTRACTED", relation_type: "衍生", weight: 0.5 },
+  { id: "eEF", from: "E", to: "F", type: "AMBIGUOUS", confidence: "AMBIGUOUS", relation_type: "矛盾", weight: 0.4 },
+  ...aNeighborEdges
+];
+graph.meta.total_nodes = graph.nodes.length;
+graph.meta.total_edges = graph.edges.length;
+graph.learning = {
+  version: 1,
+  entry: { recommended_start_node_id: "A", recommended_start_reason: "fixture", default_mode: "global" },
+  views: {
+    path: { enabled: false, start_node_id: null, node_ids: [], degraded: true },
+    community: { enabled: true, community_id: "t1", label: "测试社区", node_ids: graph.nodes.map((node) => node.id), is_weak: false, degraded: false },
+    global: { enabled: true, node_ids: graph.nodes.map((node) => node.id), degraded: false }
+  },
+  communities: [
+    { id: "t1", label: "测试社区", node_count: graph.nodes.length, color_index: 0, recommended_start_node_id: "A" }
+  ]
+};
+fs.writeFileSync(file, `${JSON.stringify(graph, 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 on community node map fixture"
+
+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_COMMUNITY_NODE_MAP_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
+
+artifact_dir="${GRAPH_COMMUNITY_NODE_MAP_ARTIFACT_DIR:-$(mktemp -d "${TMPDIR:-/tmp}/llm-wiki-community-node-map.XXXXXX")}"
+screenshot_path="${GRAPH_COMMUNITY_NODE_MAP_SCREENSHOT:-$artifact_dir/community-node-map.png}"
+
+GRAPH_COMMUNITY_NODE_MAP_HTML="$tmp_dir/wiki/knowledge-graph.html" \
+GRAPH_COMMUNITY_NODE_MAP_CHROME_EXECUTABLE="$chrome_executable" \
+GRAPH_COMMUNITY_NODE_MAP_SCREENSHOT="$screenshot_path" \
+NODE_PATH="$playwright_node_path" \
+node "$REPO_ROOT/tests/browser/graph-community-node-map.mjs" \
+    || fail "community node map browser regression should pass"
+
+echo "PASS: graph community node map regression"
+echo "SCREENSHOT: $screenshot_path"

package/skills/llm-wiki-skill/tests/graph-community-wash-interactions.regression-1.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Regression: community wash is a visual/click target, not a wheel or node-drag fence.
+
+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 community wash 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_COMMUNITY_WASH_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_COMMUNITY_WASH_HTML="$tmp_dir/wiki/knowledge-graph.html" \
+GRAPH_COMMUNITY_WASH_CHROME_EXECUTABLE="$chrome_executable" \
+NODE_PATH="$playwright_node_path" \
+node "$REPO_ROOT/tests/browser/graph-community-wash-interactions.mjs" \
+    || fail "community wash browser regression should pass"
+
+echo "PASS: graph community wash interaction regression"