@joekytc/dsh-swarm 0.1.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (567) hide show
  1. package/README.md +3 -3
  2. package/README.zh-CN.md +3 -3
  3. package/client/BoardCard.tsx +24 -2
  4. package/client/ConfigSection.tsx +71 -0
  5. package/client/ConfigSelect.tsx +69 -0
  6. package/client/KanbanBoard.tsx +3 -0
  7. package/client/KanbanTab.tsx +4 -3
  8. package/client/TaskDrawer.tsx +2 -26
  9. package/client/WorkflowRail.tsx +3 -1
  10. package/client/config-store.ts +51 -0
  11. package/client/config.css +110 -0
  12. package/client/index.ts +39 -4
  13. package/client/kanban.css +19 -2
  14. package/client/session-bridge.ts +39 -0
  15. package/client/timeline-model.ts +10 -1
  16. package/client/workflow-model.ts +3 -1
  17. package/lib/client.js +358 -53
  18. package/lib/config.d.ts +8 -1
  19. package/lib/config.js +6 -1
  20. package/lib/dispatcher/agent-runner.d.ts +28 -6
  21. package/lib/dispatcher/agent-runner.js +175 -62
  22. package/lib/dispatcher/chain-auditor.js +4 -1
  23. package/lib/dispatcher/dispatcher.d.ts +62 -3
  24. package/lib/dispatcher/dispatcher.js +243 -20
  25. package/lib/dispatcher/session-events.d.ts +11 -15
  26. package/lib/dispatcher/session-events.js +17 -5
  27. package/lib/dispatcher/v-orchestrator.d.ts +42 -9
  28. package/lib/dispatcher/v-orchestrator.js +236 -28
  29. package/lib/domain/config-override.d.ts +38 -0
  30. package/lib/domain/config-override.js +101 -0
  31. package/lib/domain/delivery-contract.d.ts +3 -2
  32. package/lib/domain/delivery-contract.js +28 -16
  33. package/lib/domain/gate-policy.d.ts +26 -0
  34. package/lib/domain/gate-policy.js +44 -0
  35. package/lib/domain/kanban-service.d.ts +16 -3
  36. package/lib/domain/kanban-service.js +41 -6
  37. package/lib/domain/permissions.js +1 -1
  38. package/lib/domain/planning-checklist.d.ts +5 -0
  39. package/lib/domain/planning-checklist.js +80 -6
  40. package/lib/domain/projection.js +2 -1
  41. package/lib/domain/review-evidence.js +1 -1
  42. package/lib/domain/state-machine.js +2 -1
  43. package/lib/domain/types.d.ts +2 -2
  44. package/lib/index.js +19 -21
  45. package/lib/roles/clean-fs-tools.d.ts +22 -0
  46. package/lib/roles/clean-fs-tools.js +118 -0
  47. package/lib/roles/skill-installer.d.ts +6 -0
  48. package/lib/roles/skill-installer.js +32 -0
  49. package/lib/roles/toolsets.d.ts +13 -1
  50. package/lib/roles/toolsets.js +163 -31
  51. package/lib/roles/wiki-worker.d.ts +1 -0
  52. package/lib/roles/wiki-worker.js +10 -2
  53. package/lib/routes/kanban-http.d.ts +5 -2
  54. package/lib/routes/kanban-http.js +36 -3
  55. package/lib/routes/planning-driver.d.ts +3 -1
  56. package/lib/routes/planning-driver.js +10 -6
  57. package/lib/routes/prefix-router.d.ts +16 -0
  58. package/lib/routes/prefix-router.js +37 -2
  59. package/lib/services/config-provider.d.ts +42 -0
  60. package/lib/services/config-provider.js +94 -0
  61. package/lib/services/gate-runner.d.ts +24 -0
  62. package/lib/services/gate-runner.js +87 -0
  63. package/lib/services/kanban-provider.d.ts +5 -1
  64. package/lib/services/kanban-provider.js +40 -2
  65. package/lib/services/llm-catalog.d.ts +35 -0
  66. package/lib/services/llm-catalog.js +19 -0
  67. package/lib/tools/kanban-tools.js +1 -0
  68. package/lib/tools/main-session-tools.d.ts +17 -2
  69. package/lib/tools/main-session-tools.js +88 -21
  70. package/lib/tools/planning-tools.d.ts +4 -0
  71. package/lib/tools/planning-tools.js +39 -12
  72. package/lib/tools/prefetch-tools.js +1 -0
  73. package/lib/tools/spec-card-tools.js +1 -0
  74. package/lib/tools/wiki-tools.js +5 -4
  75. package/lib/wiki/kb-linkage.d.ts +9 -2
  76. package/lib/wiki/kb-linkage.js +3 -3
  77. package/lib/wiki/local-kb-client.d.ts +14 -0
  78. package/lib/wiki/local-kb-client.js +101 -0
  79. package/lib/wiki/local-kb.d.ts +6 -0
  80. package/lib/wiki/local-kb.js +25 -0
  81. package/lib/wiki/memory-recall.d.ts +14 -6
  82. package/lib/wiki/memory-recall.js +17 -13
  83. package/lib/wiki/page-path.d.ts +9 -3
  84. package/lib/wiki/page-path.js +29 -11
  85. package/lib/wiki/wiki-vault-client.d.ts +3 -3
  86. package/lib/wiki/wiki-vault-client.js +6 -6
  87. package/package.json +16 -11
  88. package/personas/kanban-d/preset.yml +1 -1
  89. package/personas/kanban-dt/agent.cordis.yml +2 -2
  90. package/personas/kanban-dt/preset.yml +1 -1
  91. package/personas/kanban-p/agent.cordis.yml +16 -0
  92. package/personas/kanban-p/preset.yml +1 -1
  93. package/personas/kanban-pt/agent.cordis.yml +38 -8
  94. package/personas/kanban-pt/preset.yml +1 -1
  95. package/personas/kanban-w/agent.cordis.yml +35 -16
  96. package/personas/kanban-w/preset.yml +1 -1
  97. package/personas/persona-dt.md +1 -1
  98. package/personas/persona-p.md +4 -1
  99. package/personas/persona-pt.md +13 -6
  100. package/personas/persona-w.md +11 -9
  101. package/skills/grill-me/SKILL.md +71 -0
  102. package/skills/llm-wiki-skill/.mise.toml +2 -0
  103. package/skills/llm-wiki-skill/.nvmrc +1 -0
  104. package/skills/llm-wiki-skill/AGENTS.md +173 -0
  105. package/skills/llm-wiki-skill/CHANGELOG.md +548 -0
  106. package/skills/llm-wiki-skill/CLAUDE.md +152 -0
  107. package/skills/llm-wiki-skill/HERMES.md +44 -0
  108. package/skills/llm-wiki-skill/README.en.md +261 -0
  109. package/skills/llm-wiki-skill/README.md +291 -0
  110. package/skills/llm-wiki-skill/SKILL.md +1133 -0
  111. package/skills/llm-wiki-skill/assets/graph-demo.gif +0 -0
  112. package/skills/llm-wiki-skill/assets/graph-preview.png +0 -0
  113. package/skills/llm-wiki-skill/deps/LICENSE-d3.txt +13 -0
  114. package/skills/llm-wiki-skill/deps/LICENSE-marked.txt +44 -0
  115. package/skills/llm-wiki-skill/deps/LICENSE-purify.txt +568 -0
  116. package/skills/llm-wiki-skill/deps/LICENSE-roughjs.txt +21 -0
  117. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/SKILL.md +261 -0
  118. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/references/config/first-time-setup.md +106 -0
  119. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/cdp.ts +179 -0
  120. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/constants.ts +13 -0
  121. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/defuddle-converter.ts +58 -0
  122. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/html-to-markdown.ts +135 -0
  123. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/legacy-converter.ts +629 -0
  124. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/main.ts +314 -0
  125. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/markdown-conversion-shared.ts +305 -0
  126. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/media-localizer.ts +317 -0
  127. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/package.json +14 -0
  128. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/paths.ts +29 -0
  129. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/vendor/baoyu-chrome-cdp/package.json +9 -0
  130. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/vendor/baoyu-chrome-cdp/src/index.test.ts +307 -0
  131. package/skills/llm-wiki-skill/deps/baoyu-url-to-markdown/scripts/vendor/baoyu-chrome-cdp/src/index.ts +523 -0
  132. package/skills/llm-wiki-skill/deps/d3.min.js +2 -0
  133. package/skills/llm-wiki-skill/deps/marked.min.js +6 -0
  134. package/skills/llm-wiki-skill/deps/purify.min.js +3 -0
  135. package/skills/llm-wiki-skill/deps/rough.min.js +7 -0
  136. package/skills/llm-wiki-skill/deps/youtube-transcript/SKILL.md +47 -0
  137. package/skills/llm-wiki-skill/deps/youtube-transcript/scripts/get_transcript.py +72 -0
  138. package/skills/llm-wiki-skill/designs/graph-edge-legibility/graph-edge-treatments.html +480 -0
  139. package/skills/llm-wiki-skill/docs/design/oriental-atlas/DESIGN.md +183 -0
  140. package/skills/llm-wiki-skill/docs/design/oriental-atlas/README.md +10 -0
  141. package/skills/llm-wiki-skill/docs/design/oriental-atlas/design-brief.md +170 -0
  142. package/skills/llm-wiki-skill/docs/design/oriental-atlas/oriental-editorial-atlas.html +1908 -0
  143. package/skills/llm-wiki-skill/docs/design/oriental-atlas/reviews/result-review.md +68 -0
  144. package/skills/llm-wiki-skill/docs/graph/2026-06-16-interaction-risk-audit.md +88 -0
  145. package/skills/llm-wiki-skill/docs/graph/2026-06-16-interaction-test-coverage-map.md +212 -0
  146. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-18-phase-0-2-baseline.md +86 -0
  147. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-18-phase-1-3-dom-svg-large-baseline.md +85 -0
  148. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-18-phase-1-4-disposable-validation-gate.md +97 -0
  149. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-18-phase-2-4-global-renderer-trial-matrix.md +168 -0
  150. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-19-phase-6-1-sigma-graphology-trial.md +71 -0
  151. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-19-phase-6-2-vis-network-trial.md +78 -0
  152. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-19-phase-6-3-aggregation-fallback-trial.md +72 -0
  153. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-19-phase-6-4-global-renderer-route-decision.md +94 -0
  154. package/skills/llm-wiki-skill/docs/graph/performance/2026-06-19-sigma-global-production-integration-result.md +102 -0
  155. package/skills/llm-wiki-skill/docs/graph/performance/artifacts/2026-06-18-phase-0-2/stage-4.5-offline-dense-wheel.json +9 -0
  156. package/skills/llm-wiki-skill/docs/graph/performance/artifacts/2026-06-18-phase-0-2/stage-4.5-offline-dense-wheel.png +0 -0
  157. package/skills/llm-wiki-skill/docs/graph/performance/artifacts/2026-06-18-phase-0-2/stage-4.5-offline-navigation.png +0 -0
  158. package/skills/llm-wiki-skill/docs/spark/2026-06-15-omp-tool-status-events-design.md +174 -0
  159. package/skills/llm-wiki-skill/docs/spark/2026-06-16-graph-interaction-geometry-design.md +832 -0
  160. package/skills/llm-wiki-skill/docs/spark/2026-06-16-graph-six-layer-architecture-design.md +577 -0
  161. package/skills/llm-wiki-skill/docs/spark/2026-06-17-static-renderer-coordination-split-design.md +172 -0
  162. package/skills/llm-wiki-skill/docs/spark/2026-06-18-large-graph-global-community-design.md +909 -0
  163. package/skills/llm-wiki-skill/docs/spark/2026-06-19-sigma-global-graph-renderer-design.md +360 -0
  164. package/skills/llm-wiki-skill/docs/spark/2026-06-20-paper-ui-port-design.md +162 -0
  165. package/skills/llm-wiki-skill/docs/spark/2026-06-20-paper-ui-v2-shell-alignment-design.md +384 -0
  166. package/skills/llm-wiki-skill/docs/spark/2026-06-21-graph-experience-completion-design.md +534 -0
  167. package/skills/llm-wiki-skill/docs/spark/2026-06-22-chat-auto-scroll-design.md +185 -0
  168. package/skills/llm-wiki-skill/docs/spark/2026-06-22-graph-community-node-visual-design.md +266 -0
  169. package/skills/llm-wiki-skill/docs/spark/2026-06-25-sigma-overlay-refactor-perf-design.md +170 -0
  170. package/skills/llm-wiki-skill/docs/spark/2026-06-26-global-sigma-community-spotlight-design.md +393 -0
  171. package/skills/llm-wiki-skill/docs/spark/mockups/2026-06-18-large-graph-global-community-flow.html +746 -0
  172. package/skills/llm-wiki-skill/install.ps1 +87 -0
  173. package/skills/llm-wiki-skill/install.sh +722 -0
  174. package/skills/llm-wiki-skill/package-lock.json +11171 -0
  175. package/skills/llm-wiki-skill/package.json +24 -0
  176. package/skills/llm-wiki-skill/packages/graph-engine/package.json +37 -0
  177. package/skills/llm-wiki-skill/packages/graph-engine/src/anim/.gitkeep +1 -0
  178. package/skills/llm-wiki-skill/packages/graph-engine/src/anim/index.ts +179 -0
  179. package/skills/llm-wiki-skill/packages/graph-engine/src/architecture.ts +79 -0
  180. package/skills/llm-wiki-skill/packages/graph-engine/src/diff.ts +121 -0
  181. package/skills/llm-wiki-skill/packages/graph-engine/src/facade.ts +1406 -0
  182. package/skills/llm-wiki-skill/packages/graph-engine/src/graph-node.ts +37 -0
  183. package/skills/llm-wiki-skill/packages/graph-engine/src/index.ts +25 -0
  184. package/skills/llm-wiki-skill/packages/graph-engine/src/layout/edge-geometry.ts +17 -0
  185. package/skills/llm-wiki-skill/packages/graph-engine/src/layout/index.ts +16 -0
  186. package/skills/llm-wiki-skill/packages/graph-engine/src/layout/spatial-index.ts +509 -0
  187. package/skills/llm-wiki-skill/packages/graph-engine/src/model/atlas.ts +18 -0
  188. package/skills/llm-wiki-skill/packages/graph-engine/src/model/index.ts +10 -0
  189. package/skills/llm-wiki-skill/packages/graph-engine/src/model/labels.ts +11 -0
  190. package/skills/llm-wiki-skill/packages/graph-engine/src/model/layout.ts +81 -0
  191. package/skills/llm-wiki-skill/packages/graph-engine/src/model/learning.ts +8 -0
  192. package/skills/llm-wiki-skill/packages/graph-engine/src/model/legacy-helpers.ts +1379 -0
  193. package/skills/llm-wiki-skill/packages/graph-engine/src/model/queue.ts +7 -0
  194. package/skills/llm-wiki-skill/packages/graph-engine/src/model/storage.ts +4 -0
  195. package/skills/llm-wiki-skill/packages/graph-engine/src/model/visibility.ts +9 -0
  196. package/skills/llm-wiki-skill/packages/graph-engine/src/render/.gitkeep +1 -0
  197. package/skills/llm-wiki-skill/packages/graph-engine/src/render/adapter.ts +443 -0
  198. package/skills/llm-wiki-skill/packages/graph-engine/src/render/aggregation-containers.ts +64 -0
  199. package/skills/llm-wiki-skill/packages/graph-engine/src/render/community-cloud-geometry.ts +178 -0
  200. package/skills/llm-wiki-skill/packages/graph-engine/src/render/community-wash.ts +238 -0
  201. package/skills/llm-wiki-skill/packages/graph-engine/src/render/community-washes.ts +19 -0
  202. package/skills/llm-wiki-skill/packages/graph-engine/src/render/compat-contract.ts +14 -0
  203. package/skills/llm-wiki-skill/packages/graph-engine/src/render/controller.ts +705 -0
  204. package/skills/llm-wiki-skill/packages/graph-engine/src/render/controls.ts +288 -0
  205. package/skills/llm-wiki-skill/packages/graph-engine/src/render/dom-svg-renderer.ts +180 -0
  206. package/skills/llm-wiki-skill/packages/graph-engine/src/render/edges.ts +51 -0
  207. package/skills/llm-wiki-skill/packages/graph-engine/src/render/geometry.ts +380 -0
  208. package/skills/llm-wiki-skill/packages/graph-engine/src/render/gestures.ts +673 -0
  209. package/skills/llm-wiki-skill/packages/graph-engine/src/render/graph-renderer-root.ts +387 -0
  210. package/skills/llm-wiki-skill/packages/graph-engine/src/render/hit-testing.ts +56 -0
  211. package/skills/llm-wiki-skill/packages/graph-engine/src/render/host-dom.ts +14 -0
  212. package/skills/llm-wiki-skill/packages/graph-engine/src/render/hover-card.ts +37 -0
  213. package/skills/llm-wiki-skill/packages/graph-engine/src/render/index.ts +213 -0
  214. package/skills/llm-wiki-skill/packages/graph-engine/src/render/keyboard.ts +48 -0
  215. package/skills/llm-wiki-skill/packages/graph-engine/src/render/legend.ts +25 -0
  216. package/skills/llm-wiki-skill/packages/graph-engine/src/render/minimap.ts +45 -0
  217. package/skills/llm-wiki-skill/packages/graph-engine/src/render/model.ts +1339 -0
  218. package/skills/llm-wiki-skill/packages/graph-engine/src/render/node-drag-lifecycle.ts +94 -0
  219. package/skills/llm-wiki-skill/packages/graph-engine/src/render/nodes.ts +103 -0
  220. package/skills/llm-wiki-skill/packages/graph-engine/src/render/offline-reader.ts +209 -0
  221. package/skills/llm-wiki-skill/packages/graph-engine/src/render/overlays-presenter.ts +192 -0
  222. package/skills/llm-wiki-skill/packages/graph-engine/src/render/overlays.ts +73 -0
  223. package/skills/llm-wiki-skill/packages/graph-engine/src/render/pin-position.ts +51 -0
  224. package/skills/llm-wiki-skill/packages/graph-engine/src/render/preview.ts +65 -0
  225. package/skills/llm-wiki-skill/packages/graph-engine/src/render/relation-focus.ts +91 -0
  226. package/skills/llm-wiki-skill/packages/graph-engine/src/render/render-context.ts +85 -0
  227. package/skills/llm-wiki-skill/packages/graph-engine/src/render/render-pipeline.ts +871 -0
  228. package/skills/llm-wiki-skill/packages/graph-engine/src/render/render-styles.ts +1405 -0
  229. package/skills/llm-wiki-skill/packages/graph-engine/src/render/renderer-surface.ts +75 -0
  230. package/skills/llm-wiki-skill/packages/graph-engine/src/render/search.ts +57 -0
  231. package/skills/llm-wiki-skill/packages/graph-engine/src/render/sigma-coordinates.ts +44 -0
  232. package/skills/llm-wiki-skill/packages/graph-engine/src/render/sigma-global-drag.ts +246 -0
  233. package/skills/llm-wiki-skill/packages/graph-engine/src/render/sigma-global-renderer.ts +1425 -0
  234. package/skills/llm-wiki-skill/packages/graph-engine/src/render/sigma-overlay-svg.ts +121 -0
  235. package/skills/llm-wiki-skill/packages/graph-engine/src/render/simulation-bridge.ts +59 -0
  236. package/skills/llm-wiki-skill/packages/graph-engine/src/render/state.ts +262 -0
  237. package/skills/llm-wiki-skill/packages/graph-engine/src/render/toolbar.ts +40 -0
  238. package/skills/llm-wiki-skill/packages/graph-engine/src/render/viewport.ts +336 -0
  239. package/skills/llm-wiki-skill/packages/graph-engine/src/select/.gitkeep +1 -0
  240. package/skills/llm-wiki-skill/packages/graph-engine/src/select/index.ts +189 -0
  241. package/skills/llm-wiki-skill/packages/graph-engine/src/sim/index.ts +372 -0
  242. package/skills/llm-wiki-skill/packages/graph-engine/src/sim/pins.ts +84 -0
  243. package/skills/llm-wiki-skill/packages/graph-engine/src/summary/index.ts +447 -0
  244. package/skills/llm-wiki-skill/packages/graph-engine/src/themes/.gitkeep +1 -0
  245. package/skills/llm-wiki-skill/packages/graph-engine/src/themes/index.ts +8 -0
  246. package/skills/llm-wiki-skill/packages/graph-engine/src/themes/tokens.ts +117 -0
  247. package/skills/llm-wiki-skill/packages/graph-engine/src/types/d3-quadtree.d.ts +22 -0
  248. package/skills/llm-wiki-skill/packages/graph-engine/src/types.ts +531 -0
  249. package/skills/llm-wiki-skill/packages/graph-engine/test/aggregation-fallback-trial-adapter.test.ts +115 -0
  250. package/skills/llm-wiki-skill/packages/graph-engine/test/aggregation-fallback-trial-adapter.ts +222 -0
  251. package/skills/llm-wiki-skill/packages/graph-engine/test/anim.test.ts +121 -0
  252. package/skills/llm-wiki-skill/packages/graph-engine/test/architecture.test.ts +63 -0
  253. package/skills/llm-wiki-skill/packages/graph-engine/test/community-cloud-geometry.test.ts +86 -0
  254. package/skills/llm-wiki-skill/packages/graph-engine/test/community-wash.test.ts +97 -0
  255. package/skills/llm-wiki-skill/packages/graph-engine/test/diff.test.ts +133 -0
  256. package/skills/llm-wiki-skill/packages/graph-engine/test/facade.test.ts +1369 -0
  257. package/skills/llm-wiki-skill/packages/graph-engine/test/geometry.test.ts +147 -0
  258. package/skills/llm-wiki-skill/packages/graph-engine/test/gestures.test.ts +768 -0
  259. package/skills/llm-wiki-skill/packages/graph-engine/test/graph-layout.test.ts +110 -0
  260. package/skills/llm-wiki-skill/packages/graph-engine/test/helpers.test.ts +287 -0
  261. package/skills/llm-wiki-skill/packages/graph-engine/test/interaction-contract.test.ts +106 -0
  262. package/skills/llm-wiki-skill/packages/graph-engine/test/keyboard.test.ts +59 -0
  263. package/skills/llm-wiki-skill/packages/graph-engine/test/large-fixtures.test.ts +47 -0
  264. package/skills/llm-wiki-skill/packages/graph-engine/test/large-graph-fixtures.ts +420 -0
  265. package/skills/llm-wiki-skill/packages/graph-engine/test/learning.test.ts +259 -0
  266. package/skills/llm-wiki-skill/packages/graph-engine/test/node-drag-lifecycle.test.ts +166 -0
  267. package/skills/llm-wiki-skill/packages/graph-engine/test/overlays.test.ts +115 -0
  268. package/skills/llm-wiki-skill/packages/graph-engine/test/preview.test.ts +56 -0
  269. package/skills/llm-wiki-skill/packages/graph-engine/test/queue.test.ts +114 -0
  270. package/skills/llm-wiki-skill/packages/graph-engine/test/relation-focus.test.ts +115 -0
  271. package/skills/llm-wiki-skill/packages/graph-engine/test/render-model.test.ts +1030 -0
  272. package/skills/llm-wiki-skill/packages/graph-engine/test/renderer-adapter-contract.test.ts +271 -0
  273. package/skills/llm-wiki-skill/packages/graph-engine/test/renderer-boundary.test.ts +618 -0
  274. package/skills/llm-wiki-skill/packages/graph-engine/test/renderer-lifecycle.test.ts +1711 -0
  275. package/skills/llm-wiki-skill/packages/graph-engine/test/route-continuity.test.ts +284 -0
  276. package/skills/llm-wiki-skill/packages/graph-engine/test/runtime-state.test.ts +281 -0
  277. package/skills/llm-wiki-skill/packages/graph-engine/test/search-and-legend.test.ts +124 -0
  278. package/skills/llm-wiki-skill/packages/graph-engine/test/select.test.ts +168 -0
  279. package/skills/llm-wiki-skill/packages/graph-engine/test/sigma-coordinates.test.ts +50 -0
  280. package/skills/llm-wiki-skill/packages/graph-engine/test/sigma-global-renderer.test.ts +2210 -0
  281. package/skills/llm-wiki-skill/packages/graph-engine/test/sigma-trial-adapter.test.ts +82 -0
  282. package/skills/llm-wiki-skill/packages/graph-engine/test/sigma-trial-adapter.ts +271 -0
  283. package/skills/llm-wiki-skill/packages/graph-engine/test/sim.test.ts +207 -0
  284. package/skills/llm-wiki-skill/packages/graph-engine/test/simulation-bridge.test.ts +96 -0
  285. package/skills/llm-wiki-skill/packages/graph-engine/test/spatial-index.test.ts +222 -0
  286. package/skills/llm-wiki-skill/packages/graph-engine/test/state.test.ts +189 -0
  287. package/skills/llm-wiki-skill/packages/graph-engine/test/summary-contract.test.ts +422 -0
  288. package/skills/llm-wiki-skill/packages/graph-engine/test/themes.test.ts +62 -0
  289. package/skills/llm-wiki-skill/packages/graph-engine/test/toolbar.test.ts +64 -0
  290. package/skills/llm-wiki-skill/packages/graph-engine/test/viewport.test.ts +213 -0
  291. package/skills/llm-wiki-skill/packages/graph-engine/test/vis-network-trial-adapter.test.ts +82 -0
  292. package/skills/llm-wiki-skill/packages/graph-engine/test/vis-network-trial-adapter.ts +186 -0
  293. package/skills/llm-wiki-skill/packages/graph-engine/tsconfig.json +17 -0
  294. package/skills/llm-wiki-skill/packages/graph-engine/vite.config.ts +15 -0
  295. package/skills/llm-wiki-skill/platforms/claude/CLAUDE.md +37 -0
  296. package/skills/llm-wiki-skill/platforms/claude/companions/llm-wiki-upgrade/SKILL.md +95 -0
  297. package/skills/llm-wiki-skill/platforms/codex/AGENTS.md +23 -0
  298. package/skills/llm-wiki-skill/platforms/hermes/README.md +31 -0
  299. package/skills/llm-wiki-skill/platforms/openclaw/README.md +31 -0
  300. package/skills/llm-wiki-skill/scripts/adapter-state.sh +424 -0
  301. package/skills/llm-wiki-skill/scripts/build-graph-data.sh +395 -0
  302. package/skills/llm-wiki-skill/scripts/build-graph-html.sh +459 -0
  303. package/skills/llm-wiki-skill/scripts/cache.sh +352 -0
  304. package/skills/llm-wiki-skill/scripts/create-source-page.sh +100 -0
  305. package/skills/llm-wiki-skill/scripts/delete-helper.sh +68 -0
  306. package/skills/llm-wiki-skill/scripts/graph-analysis.js +732 -0
  307. package/skills/llm-wiki-skill/scripts/hook-session-start.sh +46 -0
  308. package/skills/llm-wiki-skill/scripts/init-wiki.sh +95 -0
  309. package/skills/llm-wiki-skill/scripts/lib/source-signal-eligibility.js +158 -0
  310. package/skills/llm-wiki-skill/scripts/lint-fix.sh +114 -0
  311. package/skills/llm-wiki-skill/scripts/lint-runner.sh +217 -0
  312. package/skills/llm-wiki-skill/scripts/runtime-context.sh +77 -0
  313. package/skills/llm-wiki-skill/scripts/shared-config.sh +83 -0
  314. package/skills/llm-wiki-skill/scripts/source-record-contract.tsv +10 -0
  315. package/skills/llm-wiki-skill/scripts/source-registry.sh +349 -0
  316. package/skills/llm-wiki-skill/scripts/source-registry.tsv +10 -0
  317. package/skills/llm-wiki-skill/scripts/source-signal-coverage.js +83 -0
  318. package/skills/llm-wiki-skill/scripts/validate-step1.sh +144 -0
  319. package/skills/llm-wiki-skill/scripts/wiki-compat.sh +267 -0
  320. package/skills/llm-wiki-skill/setup.sh +8 -0
  321. package/skills/llm-wiki-skill/templates/entity-template.md +30 -0
  322. package/skills/llm-wiki-skill/templates/graph-styles/wash/footer.html +27 -0
  323. package/skills/llm-wiki-skill/templates/graph-styles/wash/graph-wash-helpers.js +1326 -0
  324. package/skills/llm-wiki-skill/templates/graph-styles/wash/graph-wash.js +1009 -0
  325. package/skills/llm-wiki-skill/templates/graph-styles/wash/header.html +2002 -0
  326. package/skills/llm-wiki-skill/templates/index-en-template.md +51 -0
  327. package/skills/llm-wiki-skill/templates/index-template.md +51 -0
  328. package/skills/llm-wiki-skill/templates/log-en-template.md +11 -0
  329. package/skills/llm-wiki-skill/templates/log-template.md +11 -0
  330. package/skills/llm-wiki-skill/templates/overview-en-template.md +41 -0
  331. package/skills/llm-wiki-skill/templates/overview-template.md +41 -0
  332. package/skills/llm-wiki-skill/templates/purpose-en-template.md +16 -0
  333. package/skills/llm-wiki-skill/templates/purpose-template.md +16 -0
  334. package/skills/llm-wiki-skill/templates/query-template.md +19 -0
  335. package/skills/llm-wiki-skill/templates/schema-template.md +185 -0
  336. package/skills/llm-wiki-skill/templates/source-template.md +51 -0
  337. package/skills/llm-wiki-skill/templates/synthesis-template.md +25 -0
  338. package/skills/llm-wiki-skill/templates/topic-template.md +35 -0
  339. package/skills/llm-wiki-skill/tests/adapter-state.sh +338 -0
  340. package/skills/llm-wiki-skill/tests/browser/graph-aggregation-fallback-trial.ts +737 -0
  341. package/skills/llm-wiki-skill/tests/browser/graph-community-node-map.mjs +255 -0
  342. package/skills/llm-wiki-skill/tests/browser/graph-community-wash-interactions.mjs +170 -0
  343. package/skills/llm-wiki-skill/tests/browser/graph-default-behavior.mjs +630 -0
  344. package/skills/llm-wiki-skill/tests/browser/graph-density-preview.mjs +53 -0
  345. package/skills/llm-wiki-skill/tests/browser/graph-html-insights.mjs +41 -0
  346. package/skills/llm-wiki-skill/tests/browser/graph-large-performance.ts +689 -0
  347. package/skills/llm-wiki-skill/tests/browser/graph-node-slim.mjs +75 -0
  348. package/skills/llm-wiki-skill/tests/browser/graph-offline-phase-6.mjs +660 -0
  349. package/skills/llm-wiki-skill/tests/browser/graph-renderer-trial-shared.ts +291 -0
  350. package/skills/llm-wiki-skill/tests/browser/graph-sigma-global-production.ts +1437 -0
  351. package/skills/llm-wiki-skill/tests/browser/graph-sigma-graphology-trial.ts +949 -0
  352. package/skills/llm-wiki-skill/tests/browser/graph-stage-4-5.mjs +815 -0
  353. package/skills/llm-wiki-skill/tests/browser/graph-vis-network-trial.ts +762 -0
  354. package/skills/llm-wiki-skill/tests/browser/graph-workbench-interactions.mjs +730 -0
  355. package/skills/llm-wiki-skill/tests/browser/validate-graph-trial-result.mjs +149 -0
  356. package/skills/llm-wiki-skill/tests/expected/graph-data-empty.json +60 -0
  357. package/skills/llm-wiki-skill/tests/expected/graph-data-sample.json +396 -0
  358. package/skills/llm-wiki-skill/tests/expected/graph-interactive-basic.html +1736 -0
  359. package/skills/llm-wiki-skill/tests/expected/lint-output.txt +44 -0
  360. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/index.md +1 -0
  361. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/wiki/entities/Alpha.md +10 -0
  362. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/wiki/entities/Beta.md +7 -0
  363. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/wiki/entities/Delta.md +8 -0
  364. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/wiki/entities/Gamma.md +8 -0
  365. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/wiki/queries/20260422-abc.md +10 -0
  366. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/wiki/synthesis/Crystal.md +8 -0
  367. package/skills/llm-wiki-skill/tests/fixtures/coverage-sample-wiki/wiki/topics/Overview.md +9 -0
  368. package/skills/llm-wiki-skill/tests/fixtures/graph-data-empty-wiki/wiki/entities/.gitkeep +0 -0
  369. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/purpose.md +3 -0
  370. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/entities/Attention.md +7 -0
  371. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/entities/Decoder.md +7 -0
  372. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/entities/Encoder.md +7 -0
  373. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/entities/GPT.md +7 -0
  374. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/entities/Transformer.md +13 -0
  375. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/sources/paper.md +9 -0
  376. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/topics/arch.md +12 -0
  377. package/skills/llm-wiki-skill/tests/fixtures/graph-data-sample-wiki/wiki/topics/finetune.md +9 -0
  378. package/skills/llm-wiki-skill/tests/fixtures/graph-interactive-basic/wiki/graph-data.json +40 -0
  379. package/skills/llm-wiki-skill/tests/fixtures/graph-interactive-dense/wiki/graph-data.json +3965 -0
  380. package/skills/llm-wiki-skill/tests/fixtures/graph-interactive-multicomm/wiki/graph-data.json +212 -0
  381. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/index.md +14 -0
  382. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/wiki/entities/C++.md +6 -0
  383. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/wiki/entities/Lonely.md +4 -0
  384. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/wiki/entities/Other.md +8 -0
  385. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/wiki/entities/Real.md +7 -0
  386. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/wiki/sources/2026-01-01-test-source.md +15 -0
  387. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/wiki/sources/2026-02-01-inline-img.md +12 -0
  388. package/skills/llm-wiki-skill/tests/fixtures/lint-sample-wiki/wiki/topics/AIbasic.md +3 -0
  389. package/skills/llm-wiki-skill/tests/graph-aggregation-fallback-trial.regression-1.sh +46 -0
  390. package/skills/llm-wiki-skill/tests/graph-analysis-helper.regression-1.sh +237 -0
  391. package/skills/llm-wiki-skill/tests/graph-browser-large-performance.regression-1.sh +39 -0
  392. package/skills/llm-wiki-skill/tests/graph-browser-stage-4-5.regression-1.sh +163 -0
  393. package/skills/llm-wiki-skill/tests/graph-build-failures.regression-1.sh +91 -0
  394. package/skills/llm-wiki-skill/tests/graph-community-node-map.regression-1.sh +107 -0
  395. package/skills/llm-wiki-skill/tests/graph-community-wash-interactions.regression-1.sh +35 -0
  396. package/skills/llm-wiki-skill/tests/graph-data-confidence-merge.regression-1.sh +309 -0
  397. package/skills/llm-wiki-skill/tests/graph-data-source-paths.regression-1.sh +49 -0
  398. package/skills/llm-wiki-skill/tests/graph-default-behavior.regression-1.sh +35 -0
  399. package/skills/llm-wiki-skill/tests/graph-html-a11y.regression-1.sh +50 -0
  400. package/skills/llm-wiki-skill/tests/graph-html-brand-link.regression-1.sh +47 -0
  401. package/skills/llm-wiki-skill/tests/graph-html-density.regression-1.sh +228 -0
  402. package/skills/llm-wiki-skill/tests/graph-html-drawer-neighbors.regression-1.sh +47 -0
  403. package/skills/llm-wiki-skill/tests/graph-html-insights.regression-1.sh +80 -0
  404. package/skills/llm-wiki-skill/tests/graph-html-long-label.regression-1.sh +92 -0
  405. package/skills/llm-wiki-skill/tests/graph-html-minimap.regression-1.sh +51 -0
  406. package/skills/llm-wiki-skill/tests/graph-html-mobile.regression-1.sh +48 -0
  407. package/skills/llm-wiki-skill/tests/graph-html-oriental-atlas-contract.regression-1.sh +94 -0
  408. package/skills/llm-wiki-skill/tests/graph-html-oriental-design-contract.regression-1.sh +82 -0
  409. package/skills/llm-wiki-skill/tests/graph-html-search.regression-1.sh +52 -0
  410. package/skills/llm-wiki-skill/tests/graph-html-styles.regression-1.sh +66 -0
  411. package/skills/llm-wiki-skill/tests/graph-html-toolbar.regression-1.sh +62 -0
  412. package/skills/llm-wiki-skill/tests/graph-offline-phase-6.regression-1.sh +51 -0
  413. package/skills/llm-wiki-skill/tests/graph-sigma-global-production.regression-1.sh +64 -0
  414. package/skills/llm-wiki-skill/tests/graph-sigma-graphology-trial.regression-1.sh +46 -0
  415. package/skills/llm-wiki-skill/tests/graph-vis-network-trial.regression-1.sh +46 -0
  416. package/skills/llm-wiki-skill/tests/graph-workbench-interactions.regression-1.sh +151 -0
  417. package/skills/llm-wiki-skill/tests/js/graph-wash-bootstrap.test.js +110 -0
  418. package/skills/llm-wiki-skill/tests/js/graph-wash-helpers.test.js +296 -0
  419. package/skills/llm-wiki-skill/tests/js/graph-wash-learning.test.js +260 -0
  420. package/skills/llm-wiki-skill/tests/js/graph-wash-queue.test.js +115 -0
  421. package/skills/llm-wiki-skill/tests/js/graph-wash-runtime-state.test.js +282 -0
  422. package/skills/llm-wiki-skill/tests/js/source-signal-coverage.test.js +48 -0
  423. package/skills/llm-wiki-skill/tests/js/source-signal-eligibility.test.js +202 -0
  424. package/skills/llm-wiki-skill/tests/lib/graph-html-engine-helpers.sh +110 -0
  425. package/skills/llm-wiki-skill/tests/lint-output.regression-1.sh +32 -0
  426. package/skills/llm-wiki-skill/tests/regression.sh +1754 -0
  427. package/skills/llm-wiki-skill/workbench/AGENTS.md +110 -0
  428. package/skills/llm-wiki-skill/workbench/CLAUDE.md +55 -0
  429. package/skills/llm-wiki-skill/workbench/LICENSE +21 -0
  430. package/skills/llm-wiki-skill/workbench/PRODUCT.md +1353 -0
  431. package/skills/llm-wiki-skill/workbench/README.md +30 -0
  432. package/skills/llm-wiki-skill/workbench/docs/current-kb-retrieval-design.md +587 -0
  433. package/skills/llm-wiki-skill/workbench/docs/graph-evolution-1-design.md +210 -0
  434. package/skills/llm-wiki-skill/workbench/docs/stage-2-design.md +1139 -0
  435. package/skills/llm-wiki-skill/workbench/docs/stage-3-design.md +1269 -0
  436. package/skills/llm-wiki-skill/workbench/docs/stage-3.5-design.md +1164 -0
  437. package/skills/llm-wiki-skill/workbench/docs/stage-4-design.md +504 -0
  438. package/skills/llm-wiki-skill/workbench/docs/stage-4.5-design.md +195 -0
  439. package/skills/llm-wiki-skill/workbench/docs/superpowers/specs/2026-05-28-resizable-preview-layout-design.md +165 -0
  440. package/skills/llm-wiki-skill/workbench/docs/superpowers/specs/2026-05-28-settings-panel-scroll-fix.md +50 -0
  441. package/skills/llm-wiki-skill/workbench/server/package.json +31 -0
  442. package/skills/llm-wiki-skill/workbench/server/src/agent.ts +457 -0
  443. package/skills/llm-wiki-skill/workbench/server/src/artifacts.ts +248 -0
  444. package/skills/llm-wiki-skill/workbench/server/src/auth.ts +164 -0
  445. package/skills/llm-wiki-skill/workbench/server/src/config.ts +130 -0
  446. package/skills/llm-wiki-skill/workbench/server/src/conversations.test.ts +159 -0
  447. package/skills/llm-wiki-skill/workbench/server/src/conversations.ts +270 -0
  448. package/skills/llm-wiki-skill/workbench/server/src/digest/batch.ts +189 -0
  449. package/skills/llm-wiki-skill/workbench/server/src/digest/concurrency.test.ts +36 -0
  450. package/skills/llm-wiki-skill/workbench/server/src/digest/concurrency.ts +31 -0
  451. package/skills/llm-wiki-skill/workbench/server/src/digest/subagent.ts +91 -0
  452. package/skills/llm-wiki-skill/workbench/server/src/extensions/artifacts.ts +81 -0
  453. package/skills/llm-wiki-skill/workbench/server/src/extensions/knowledge-base.ts +263 -0
  454. package/skills/llm-wiki-skill/workbench/server/src/extensions/new-wiki.ts +42 -0
  455. package/skills/llm-wiki-skill/workbench/server/src/extensions/synthesis.ts +172 -0
  456. package/skills/llm-wiki-skill/workbench/server/src/graph-watcher.test.ts +196 -0
  457. package/skills/llm-wiki-skill/workbench/server/src/graph.test.ts +113 -0
  458. package/skills/llm-wiki-skill/workbench/server/src/graph.ts +351 -0
  459. package/skills/llm-wiki-skill/workbench/server/src/index.ts +1148 -0
  460. package/skills/llm-wiki-skill/workbench/server/src/knowledge-bases.test.ts +30 -0
  461. package/skills/llm-wiki-skill/workbench/server/src/knowledge-bases.ts +321 -0
  462. package/skills/llm-wiki-skill/workbench/server/src/pages.test.ts +41 -0
  463. package/skills/llm-wiki-skill/workbench/server/src/pages.ts +160 -0
  464. package/skills/llm-wiki-skill/workbench/server/src/retrieval.test.ts +151 -0
  465. package/skills/llm-wiki-skill/workbench/server/src/retrieval.ts +427 -0
  466. package/skills/llm-wiki-skill/workbench/server/src/tool-status-events.test.ts +363 -0
  467. package/skills/llm-wiki-skill/workbench/server/src/tool-status-events.ts +616 -0
  468. package/skills/llm-wiki-skill/workbench/server/src/wiki-init.test.ts +19 -0
  469. package/skills/llm-wiki-skill/workbench/server/src/wiki-init.ts +188 -0
  470. package/skills/llm-wiki-skill/workbench/server/tsconfig.json +10 -0
  471. package/skills/llm-wiki-skill/workbench/tsconfig.json +20 -0
  472. package/skills/llm-wiki-skill/workbench/web/README.md +73 -0
  473. package/skills/llm-wiki-skill/workbench/web/components.json +21 -0
  474. package/skills/llm-wiki-skill/workbench/web/eslint.config.js +22 -0
  475. package/skills/llm-wiki-skill/workbench/web/index.html +16 -0
  476. package/skills/llm-wiki-skill/workbench/web/package.json +54 -0
  477. package/skills/llm-wiki-skill/workbench/web/src/App.tsx +1195 -0
  478. package/skills/llm-wiki-skill/workbench/web/src/components/AddExternalDialog.tsx +375 -0
  479. package/skills/llm-wiki-skill/workbench/web/src/components/AppearancePanel.tsx +158 -0
  480. package/skills/llm-wiki-skill/workbench/web/src/components/ArtifactView.tsx +15 -0
  481. package/skills/llm-wiki-skill/workbench/web/src/components/BatchDigestPanel.tsx +117 -0
  482. package/skills/llm-wiki-skill/workbench/web/src/components/ChatPanel.tsx +890 -0
  483. package/skills/llm-wiki-skill/workbench/web/src/components/CommandMenu.tsx +75 -0
  484. package/skills/llm-wiki-skill/workbench/web/src/components/ExportButtons.tsx +58 -0
  485. package/skills/llm-wiki-skill/workbench/web/src/components/GraphPanel.tsx +800 -0
  486. package/skills/llm-wiki-skill/workbench/web/src/components/GraphReader.tsx +52 -0
  487. package/skills/llm-wiki-skill/workbench/web/src/components/GraphSelection.tsx +100 -0
  488. package/skills/llm-wiki-skill/workbench/web/src/components/GraphSummaryDrawer.tsx +269 -0
  489. package/skills/llm-wiki-skill/workbench/web/src/components/MainViewTabs.tsx +69 -0
  490. package/skills/llm-wiki-skill/workbench/web/src/components/MarkdownView.tsx +106 -0
  491. package/skills/llm-wiki-skill/workbench/web/src/components/NewWikiDialog.tsx +103 -0
  492. package/skills/llm-wiki-skill/workbench/web/src/components/RefMenu.tsx +44 -0
  493. package/skills/llm-wiki-skill/workbench/web/src/components/RightDrawer.tsx +298 -0
  494. package/skills/llm-wiki-skill/workbench/web/src/components/SearchPanel.tsx +165 -0
  495. package/skills/llm-wiki-skill/workbench/web/src/components/SettingsPanel.tsx +320 -0
  496. package/skills/llm-wiki-skill/workbench/web/src/components/Sidebar.tsx +354 -0
  497. package/skills/llm-wiki-skill/workbench/web/src/components/ToolHistorySummary.tsx +111 -0
  498. package/skills/llm-wiki-skill/workbench/web/src/components/ToolStatusRunway.tsx +70 -0
  499. package/skills/llm-wiki-skill/workbench/web/src/components/TopBar.tsx +348 -0
  500. package/skills/llm-wiki-skill/workbench/web/src/components/renderers/DownloadOnlyRenderer.tsx +88 -0
  501. package/skills/llm-wiki-skill/workbench/web/src/components/renderers/HtmlRenderer.tsx +92 -0
  502. package/skills/llm-wiki-skill/workbench/web/src/components/ui/button.tsx +52 -0
  503. package/skills/llm-wiki-skill/workbench/web/src/components/ui/command.tsx +50 -0
  504. package/skills/llm-wiki-skill/workbench/web/src/components/ui/dialog.tsx +156 -0
  505. package/skills/llm-wiki-skill/workbench/web/src/components/ui/input.tsx +21 -0
  506. package/skills/llm-wiki-skill/workbench/web/src/components/ui/tooltip.tsx +57 -0
  507. package/skills/llm-wiki-skill/workbench/web/src/index.css +4204 -0
  508. package/skills/llm-wiki-skill/workbench/web/src/lib/api.ts +648 -0
  509. package/skills/llm-wiki-skill/workbench/web/src/lib/appearance.ts +114 -0
  510. package/skills/llm-wiki-skill/workbench/web/src/lib/drawer-layout.ts +41 -0
  511. package/skills/llm-wiki-skill/workbench/web/src/lib/drawer-state.ts +168 -0
  512. package/skills/llm-wiki-skill/workbench/web/src/lib/graph-reader.ts +25 -0
  513. package/skills/llm-wiki-skill/workbench/web/src/lib/graph-selection-drawer.ts +35 -0
  514. package/skills/llm-wiki-skill/workbench/web/src/lib/graph-selection.ts +96 -0
  515. package/skills/llm-wiki-skill/workbench/web/src/lib/graph-summary-actions.ts +184 -0
  516. package/skills/llm-wiki-skill/workbench/web/src/lib/legacy-tool-status.ts +113 -0
  517. package/skills/llm-wiki-skill/workbench/web/src/lib/model-roles.ts +20 -0
  518. package/skills/llm-wiki-skill/workbench/web/src/lib/search-filter.ts +104 -0
  519. package/skills/llm-wiki-skill/workbench/web/src/lib/sse.ts +72 -0
  520. package/skills/llm-wiki-skill/workbench/web/src/lib/tool-status-format.ts +170 -0
  521. package/skills/llm-wiki-skill/workbench/web/src/lib/tool-status-model.ts +392 -0
  522. package/skills/llm-wiki-skill/workbench/web/src/lib/utils.ts +10 -0
  523. package/skills/llm-wiki-skill/workbench/web/src/lib/view-status.ts +16 -0
  524. package/skills/llm-wiki-skill/workbench/web/src/lib/wiki-links.ts +32 -0
  525. package/skills/llm-wiki-skill/workbench/web/src/main.tsx +10 -0
  526. package/skills/llm-wiki-skill/workbench/web/test/api.test.ts +61 -0
  527. package/skills/llm-wiki-skill/workbench/web/test/app-shell-drawer-layout.test.tsx +48 -0
  528. package/skills/llm-wiki-skill/workbench/web/test/appearance-panel.test.tsx +121 -0
  529. package/skills/llm-wiki-skill/workbench/web/test/appearance.test.ts +262 -0
  530. package/skills/llm-wiki-skill/workbench/web/test/chat-host-source.test.tsx +22 -0
  531. package/skills/llm-wiki-skill/workbench/web/test/chat-panel-auto-scroll.test.tsx +311 -0
  532. package/skills/llm-wiki-skill/workbench/web/test/chat-panel-bubbles.test.tsx +48 -0
  533. package/skills/llm-wiki-skill/workbench/web/test/chat-panel-composer.test.tsx +86 -0
  534. package/skills/llm-wiki-skill/workbench/web/test/chat-panel-tool-status.test.tsx +26 -0
  535. package/skills/llm-wiki-skill/workbench/web/test/export-batch-paper.test.tsx +101 -0
  536. package/skills/llm-wiki-skill/workbench/web/test/graph-drawer-state.test.ts +257 -0
  537. package/skills/llm-wiki-skill/workbench/web/test/graph-panel-paper.test.tsx +200 -0
  538. package/skills/llm-wiki-skill/workbench/web/test/graph-reader-request.test.ts +32 -0
  539. package/skills/llm-wiki-skill/workbench/web/test/graph-reader.test.ts +62 -0
  540. package/skills/llm-wiki-skill/workbench/web/test/graph-selection-drawer.test.ts +56 -0
  541. package/skills/llm-wiki-skill/workbench/web/test/graph-selection.test.ts +83 -0
  542. package/skills/llm-wiki-skill/workbench/web/test/graph-summary-actions.test.ts +188 -0
  543. package/skills/llm-wiki-skill/workbench/web/test/main-view-tabs.test.tsx +34 -0
  544. package/skills/llm-wiki-skill/workbench/web/test/markdown-view.test.tsx +34 -0
  545. package/skills/llm-wiki-skill/workbench/web/test/popup-menus.test.tsx +85 -0
  546. package/skills/llm-wiki-skill/workbench/web/test/render.test.tsx +30 -0
  547. package/skills/llm-wiki-skill/workbench/web/test/render.tsx +38 -0
  548. package/skills/llm-wiki-skill/workbench/web/test/right-drawer-graph-summary.test.tsx +287 -0
  549. package/skills/llm-wiki-skill/workbench/web/test/right-drawer-interactions.test.tsx +182 -0
  550. package/skills/llm-wiki-skill/workbench/web/test/search-filter.test.ts +65 -0
  551. package/skills/llm-wiki-skill/workbench/web/test/search-panel.test.tsx +155 -0
  552. package/skills/llm-wiki-skill/workbench/web/test/setup-dom.ts +66 -0
  553. package/skills/llm-wiki-skill/workbench/web/test/sidebar-v2-source.test.ts +17 -0
  554. package/skills/llm-wiki-skill/workbench/web/test/sidebar.test.tsx +110 -0
  555. package/skills/llm-wiki-skill/workbench/web/test/tool-history-summary.test.tsx +150 -0
  556. package/skills/llm-wiki-skill/workbench/web/test/tool-status-format.test.ts +107 -0
  557. package/skills/llm-wiki-skill/workbench/web/test/tool-status-model.test.ts +324 -0
  558. package/skills/llm-wiki-skill/workbench/web/test/tool-status-runway.test.ts +159 -0
  559. package/skills/llm-wiki-skill/workbench/web/test/topbar.test.tsx +248 -0
  560. package/skills/llm-wiki-skill/workbench/web/test/visual/paper-ui.ts +898 -0
  561. package/skills/llm-wiki-skill/workbench/web/test/wiki-links.test.ts +23 -0
  562. package/skills/llm-wiki-skill/workbench/web/test-results/paper-ui/actual/.gitkeep +1 -0
  563. package/skills/llm-wiki-skill/workbench/web/test-results/paper-ui/baseline/.gitkeep +1 -0
  564. package/skills/llm-wiki-skill/workbench/web/tsconfig.app.json +30 -0
  565. package/skills/llm-wiki-skill/workbench/web/tsconfig.json +7 -0
  566. package/skills/llm-wiki-skill/workbench/web/tsconfig.node.json +24 -0
  567. package/skills/llm-wiki-skill/workbench/web/vite.config.ts +28 -0
@@ -0,0 +1,86 @@
1
+ import { describe, it } from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import React from "react";
4
+ import { readFileSync } from "node:fs";
5
+ import { resolve } from "node:path";
6
+
7
+ import { ChatPanel } from "../src/components/ChatPanel";
8
+ import { TooltipProvider } from "../src/components/ui/tooltip";
9
+ import { changeText, render, screen } from "./render";
10
+
11
+ describe("ChatPanel Paper composer", () => {
12
+ it("keeps send inside the composer input card and export outside it", () => {
13
+ renderChatPanel();
14
+
15
+ const textarea = screen.getByPlaceholderText(/写下想法/);
16
+ const sendButton = screen.getByRole("button", { name: /发送/ });
17
+ const composer = textarea.closest(".composer-card");
18
+ assert.ok(composer);
19
+ assert.equal(composer?.contains(sendButton), true);
20
+ assert.equal(Boolean(sendButton.closest(".composer-actions")), true);
21
+ assert.equal(composer?.querySelector(".chat-send-row"), null);
22
+ assert.equal(screen.queryByText("就绪"), null);
23
+
24
+ const exportBar = document.querySelector(".export-bar");
25
+ assert.ok(exportBar);
26
+ assert.equal(exportBar?.closest(".composer-card"), null);
27
+ assert.equal(Boolean(exportBar?.closest(".composer-tools")), true);
28
+ });
29
+
30
+ it("keeps the empty composer to one light input card", () => {
31
+ renderChatPanel([]);
32
+
33
+ assert.equal(document.querySelector(".chat-input-hints"), null);
34
+ assert.equal(document.querySelector(".composer-tools"), null);
35
+ assert.ok(document.querySelector(".composer-card"));
36
+ });
37
+
38
+ it("keeps material ingest chips available above the composer card", async () => {
39
+ renderChatPanel();
40
+
41
+ await changeText(screen.getByPlaceholderText(/写下想法/), "https://example.com/paper");
42
+
43
+ const chip = screen.getByText(/检测到URL/).closest(".input-chip");
44
+ assert.ok(chip);
45
+ assert.equal(Boolean(chip?.nextElementSibling?.classList.contains("composer-card")), true);
46
+ });
47
+
48
+ it("keeps the Paper composer styling contract", () => {
49
+ const css = readFileSync(resolve(import.meta.dirname, "../src/index.css"), "utf8");
50
+
51
+ assert.match(css, /\.composer-card\s*\{/);
52
+ assert.match(css, /\.composer-card:focus-within[\s\S]*var\(--app-accent\)/);
53
+ assert.match(css, /\.chat-textarea[\s\S]*background:\s*transparent/);
54
+ assert.match(css, /\[data-hand="on"\] \.chat-textarea::placeholder[\s\S]*var\(--font-hand\)/);
55
+ assert.match(css, /\.send-btn[\s\S]*border-radius:\s*10px/);
56
+ });
57
+
58
+ it("keeps the V2 composer compact and places actions inside the card", () => {
59
+ const css = readFileSync(resolve(import.meta.dirname, "../src/index.css"), "utf8");
60
+
61
+ assert.match(css, /\.composer-card[\s\S]*border-radius:\s*14px/);
62
+ assert.match(css, /\.composer-card[\s\S]*display:\s*flex/);
63
+ assert.match(css, /\.composer-card[\s\S]*align-items:\s*flex-end/);
64
+ assert.match(css, /\.chat-textarea[\s\S]*min-height:\s*40px/);
65
+ assert.match(css, /\.chat-textarea[\s\S]*padding:\s*9px 0/);
66
+ assert.match(css, /\.send-btn[\s\S]*width:\s*36px/);
67
+ assert.match(css, /\.send-btn[\s\S]*height:\s*36px/);
68
+ assert.match(css, /\.composer-tools[\s\S]*display:\s*flex/);
69
+ assert.doesNotMatch(css, /\.chat-send-row\s*\{/);
70
+ });
71
+ });
72
+
73
+ function renderChatPanel(initialMessages = [
74
+ { id: "u1", role: "user" as const, content: "帮我总结这篇笔记", tools: [] },
75
+ { id: "a1", role: "assistant" as const, content: "可以。", tools: [] },
76
+ ]) {
77
+ return render(
78
+ <TooltipProvider>
79
+ <ChatPanel
80
+ currentKnowledgeBaseName="AI学习知识库"
81
+ currentKnowledgeBasePath="/kb"
82
+ initialMessages={initialMessages}
83
+ />
84
+ </TooltipProvider>,
85
+ );
86
+ }
@@ -0,0 +1,26 @@
1
+ import { describe, it } from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import React from "react";
4
+ import { renderToStaticMarkup } from "react-dom/server";
5
+
6
+ import { ToolHistorySummary } from "../src/components/ToolHistorySummary";
7
+ import { createLegacyToolStatusState } from "../src/lib/legacy-tool-status";
8
+
9
+ describe("ChatPanel tool status rendering", () => {
10
+ it("renders legacy historical tool calls as a folded summary instead of the old live list", () => {
11
+ const state = createLegacyToolStatusState("a-history", [
12
+ { name: "读取 ~/wiki/index.md:读取完成", status: "done" },
13
+ { name: "历史工具调用:bash", status: "done" },
14
+ ]);
15
+ assert.ok(state);
16
+
17
+ const html = renderToStaticMarkup(React.createElement(ToolHistorySummary, { state }));
18
+
19
+ assert.match(html, /tool-history-summary/);
20
+ assert.match(html, /已完成 2 项工具调用/);
21
+ assert.match(html, /文件 1/);
22
+ assert.match(html, /命令 1/);
23
+ assert.equal(html.includes("msg-tools"), false);
24
+ assert.equal(html.includes("tool-runway"), false);
25
+ });
26
+ });
@@ -0,0 +1,101 @@
1
+ import { describe, it } from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import React from "react";
4
+ import { readFileSync } from "node:fs";
5
+ import { resolve } from "node:path";
6
+
7
+ import { BatchDigestPanel, type BatchDigestJob } from "../src/components/BatchDigestPanel";
8
+ import { ExportButtons } from "../src/components/ExportButtons";
9
+ import { TooltipProvider } from "../src/components/ui/tooltip";
10
+ import type { ExportKind } from "../src/lib/api";
11
+ import { click, render, screen } from "./render";
12
+
13
+ describe("Paper export and batch digest surfaces", () => {
14
+ it("renders export actions as a prominent Paper bar and preserves click callbacks", async () => {
15
+ const exports: ExportKind[] = [];
16
+ render(
17
+ <TooltipProvider>
18
+ <ExportButtons disabled={false} disabledReason="disabled" onExport={(kind) => exports.push(kind)} />
19
+ </TooltipProvider>,
20
+ );
21
+
22
+ const bar = screen.getByLabelText("导出当前对话");
23
+ assert.match(bar.className, /export-bar/);
24
+ assert.match(bar.textContent ?? "", /把当前对话整理成文件/);
25
+
26
+ await click(screen.getByRole("button", { name: "导出为 PDF" }));
27
+ await click(screen.getByRole("button", { name: "导出为 HTML" }));
28
+
29
+ assert.deepEqual(exports, ["pdf", "html"]);
30
+ });
31
+
32
+ it("renders batch digest progress, file states, and output action", async () => {
33
+ const opened: string[] = [];
34
+ render(
35
+ <BatchDigestPanel
36
+ job={batchJob()}
37
+ onClose={() => opened.push("close")}
38
+ onOpenOutput={(path) => opened.push(path)}
39
+ />,
40
+ );
41
+
42
+ const panel = screen.getByLabelText("批量消化进度");
43
+ assert.match(panel.className, /batch-panel/);
44
+ assert.match(panel.textContent ?? "", /批量消化/);
45
+ assert.match(panel.textContent ?? "", /50%/);
46
+ assert.match(screen.getByLabelText("批量消化进度 50%").className, /batch-progress/);
47
+ assert.match(screen.getByText("source-a.md").closest(".batch-file")?.className ?? "", /batch-file-done/);
48
+ assert.match(screen.getByText("source-b.md").closest(".batch-file")?.className ?? "", /batch-file-running/);
49
+
50
+ await click(screen.getByRole("button", { name: "打开结果" }));
51
+ await click(screen.getByRole("button", { name: "关闭" }));
52
+
53
+ assert.deepEqual(opened, ["wiki/source-a.md", "close"]);
54
+ });
55
+
56
+ it("keeps the Paper styling contract for export and batch digest surfaces", () => {
57
+ const css = readFileSync(resolve(import.meta.dirname, "../src/index.css"), "utf8");
58
+
59
+ assert.match(css, /\.export-bar\s*\{/);
60
+ assert.match(css, /\.export-bar[\s\S]*var\(--paper-grain\)/);
61
+ assert.match(css, /\.export-btn[\s\S]*border-radius:\s*9px/);
62
+ assert.match(css, /\.batch-panel[\s\S]*var\(--paper-grain\)/);
63
+ assert.match(css, /\.batch-status-running[\s\S]*var\(--app-accent-soft\)/);
64
+ assert.match(css, /\.batch-progress-bar[\s\S]*linear-gradient/);
65
+ assert.match(css, /\.batch-output-btn\s*\{/);
66
+ });
67
+ });
68
+
69
+ function batchJob(): BatchDigestJob {
70
+ return {
71
+ id: "job-1",
72
+ kbPath: "/kb",
73
+ status: "running",
74
+ total: 4,
75
+ completed: 1,
76
+ failed: 1,
77
+ current: "/inputs/source-b.md",
78
+ files: [
79
+ {
80
+ index: 0,
81
+ filePath: "/inputs/source-a.md",
82
+ status: "done",
83
+ chars: 1200,
84
+ outputPath: "wiki/source-a.md",
85
+ },
86
+ {
87
+ index: 1,
88
+ filePath: "/inputs/source-b.md",
89
+ status: "running",
90
+ chars: 400,
91
+ },
92
+ {
93
+ index: 2,
94
+ filePath: "/inputs/source-c.md",
95
+ status: "error",
96
+ error: "读取失败",
97
+ },
98
+ ],
99
+ events: [],
100
+ };
101
+ }
@@ -0,0 +1,257 @@
1
+ import { describe, it } from "node:test";
2
+ import assert from "node:assert/strict";
3
+
4
+ import type {
5
+ GraphCommunitySummaryPayload,
6
+ GraphGlobalOverviewPayload,
7
+ GraphNodeSummaryPayload,
8
+ GraphOpenPagePayload,
9
+ GraphSearchResultsPayload,
10
+ GraphUnavailableObjectPayload,
11
+ Selection,
12
+ } from "@llm-wiki/graph-engine";
13
+ import {
14
+ artifactDrawer,
15
+ closedDrawer,
16
+ graphCommunitySummaryDrawer,
17
+ graphEmptyDrawer,
18
+ graphErrorDrawer,
19
+ graphGlobalOverviewDrawer,
20
+ graphLoadingDrawer,
21
+ graphNodeSummaryDrawer,
22
+ graphReaderDrawer,
23
+ graphSearchResultsDrawer,
24
+ graphSelectionDrawer,
25
+ graphUnavailableObjectDrawer,
26
+ wikiDrawer,
27
+ } from "../src/lib/drawer-state";
28
+
29
+ describe("drawer state", () => {
30
+ it("creates mutually exclusive closed, wiki, artifact, and graph reader states", () => {
31
+ const payload = graphPayload();
32
+
33
+ assert.deepEqual(closedDrawer(), { mode: "closed" });
34
+ assert.deepEqual(wikiDrawer("wiki/topics/a.md", { loading: true }), {
35
+ mode: "wiki",
36
+ path: "wiki/topics/a.md",
37
+ content: "",
38
+ loading: true,
39
+ error: null,
40
+ });
41
+ assert.deepEqual(artifactDrawer([], "artifact-1"), {
42
+ mode: "artifacts",
43
+ artifacts: [],
44
+ activeArtifactId: "artifact-1",
45
+ });
46
+ assert.deepEqual(graphReaderDrawer(payload, { content: "# Alpha" }), {
47
+ mode: "graph-reader",
48
+ payload,
49
+ content: "# Alpha",
50
+ loading: false,
51
+ error: null,
52
+ });
53
+ assert.deepEqual(graphSelectionDrawer(selectionFixture(), "Alpha", "note"), {
54
+ mode: "graph-selection",
55
+ title: "Alpha",
56
+ selection: selectionFixture(),
57
+ freeText: "note",
58
+ });
59
+ });
60
+
61
+ it("creates every lightweight graph drawer state with distinct modes and titles", () => {
62
+ const node = nodeSummaryFixture();
63
+ const community = communitySummaryFixture();
64
+ const search = searchResultsFixture();
65
+ const global = globalOverviewFixture();
66
+ const unavailable = unavailableFixture();
67
+
68
+ assert.deepEqual(graphNodeSummaryDrawer(node), {
69
+ mode: "graph-node-summary",
70
+ payload: node,
71
+ });
72
+ assert.deepEqual(graphCommunitySummaryDrawer(community), {
73
+ mode: "graph-community-summary",
74
+ payload: community,
75
+ });
76
+ assert.deepEqual(graphSearchResultsDrawer(search), {
77
+ mode: "graph-search-results",
78
+ payload: search,
79
+ });
80
+ assert.deepEqual(graphGlobalOverviewDrawer(global), {
81
+ mode: "graph-global-overview",
82
+ payload: global,
83
+ });
84
+ assert.deepEqual(graphUnavailableObjectDrawer(unavailable), {
85
+ mode: "graph-unavailable-object",
86
+ payload: unavailable,
87
+ });
88
+ assert.deepEqual(graphLoadingDrawer("图谱摘要", "整理中"), {
89
+ mode: "graph-loading",
90
+ title: "图谱摘要",
91
+ message: "整理中",
92
+ });
93
+ assert.deepEqual(graphEmptyDrawer("没有强关系", "missing-strong-relations", "暂无强关系"), {
94
+ mode: "graph-empty",
95
+ title: "没有强关系",
96
+ reason: "missing-strong-relations",
97
+ message: "暂无强关系",
98
+ });
99
+ assert.deepEqual(graphEmptyDrawer("没有邻居", "missing-neighbors", "暂无邻居").reason, "missing-neighbors");
100
+ assert.deepEqual(graphEmptyDrawer("没有社区摘要", "missing-community-summary", "暂无社区摘要").reason, "missing-community-summary");
101
+ assert.deepEqual(graphEmptyDrawer("没有搜索结果", "no-search-results", "暂无搜索结果").reason, "no-search-results");
102
+ assert.deepEqual(graphErrorDrawer("图谱错误", "摘要生成失败"), {
103
+ mode: "graph-error",
104
+ title: "图谱错误",
105
+ message: "摘要生成失败",
106
+ });
107
+ });
108
+ });
109
+
110
+ function graphPayload(): GraphOpenPagePayload {
111
+ return {
112
+ path: "wiki/topics/a.md",
113
+ node: {
114
+ id: "a",
115
+ title: "Alpha",
116
+ type: "topic",
117
+ typeLabel: "主题",
118
+ sourcePath: "wiki/topics/a.md",
119
+ community: "alpha",
120
+ date: "2026-06-13",
121
+ source: "Archive",
122
+ isolated: false,
123
+ },
124
+ };
125
+ }
126
+
127
+ function selectionFixture(): Selection {
128
+ return {
129
+ id: "selection-test",
130
+ nodeIds: ["a"],
131
+ communityIds: [],
132
+ facts: {
133
+ pageCount: 1,
134
+ internalLinkCount: 0,
135
+ communityCount: 1,
136
+ isolatedCount: 0,
137
+ },
138
+ actions: [
139
+ { id: "summarize_page", label: "总结这一页", tone: "digest" },
140
+ ],
141
+ };
142
+ }
143
+
144
+ function nodeSummaryFixture(): GraphNodeSummaryPayload {
145
+ return {
146
+ kind: "node-summary",
147
+ object: { kind: "node", nodeId: "a" },
148
+ nodeId: "a",
149
+ label: "Alpha",
150
+ type: "topic",
151
+ communityId: "alpha",
152
+ sourcePath: "wiki/a.md",
153
+ summary: "short summary",
154
+ connectionCount: 2,
155
+ searchHit: true,
156
+ pinHint: { nodeId: "a", wikiPath: "wiki/a.md", pinned: false, position: null },
157
+ selection: {
158
+ input: { kind: "node", id: "a" },
159
+ selectionId: "node:a",
160
+ selectedNodeIds: ["a"],
161
+ selectedCommunityIds: ["alpha"],
162
+ containsCurrentObject: true,
163
+ },
164
+ strongestRelations: [],
165
+ bridgeRelations: [],
166
+ aggregationMarkers: [],
167
+ commands: [
168
+ { kind: "open-detail-read", nodeId: "a", path: "wiki/a.md", label: "打开详情" },
169
+ ],
170
+ };
171
+ }
172
+
173
+ function communitySummaryFixture(): GraphCommunitySummaryPayload {
174
+ return {
175
+ kind: "community-summary",
176
+ object: { kind: "community", communityId: "alpha" },
177
+ communityId: "alpha",
178
+ label: "Alpha community",
179
+ nodeCount: 2,
180
+ coreNodeIds: ["a"],
181
+ searchResultIds: [],
182
+ pinHints: [],
183
+ selection: {
184
+ input: { kind: "community", id: "alpha" },
185
+ selectionId: "community:a,b",
186
+ selectedNodeIds: ["a", "b"],
187
+ selectedCommunityIds: ["alpha"],
188
+ containsCurrentObject: true,
189
+ },
190
+ strongestRelations: [],
191
+ bridgeRelations: [],
192
+ aggregationMarkers: [],
193
+ commands: [
194
+ { kind: "enter-community", communityId: "alpha", label: "进入社区" },
195
+ ],
196
+ };
197
+ }
198
+
199
+ function searchResultsFixture(): GraphSearchResultsPayload {
200
+ return {
201
+ kind: "search-results",
202
+ query: "alpha",
203
+ searchResultIds: ["a"],
204
+ visibleResultIds: ["a"],
205
+ unavailableResultIds: [],
206
+ selection: {
207
+ input: null,
208
+ selectionId: null,
209
+ selectedNodeIds: [],
210
+ selectedCommunityIds: [],
211
+ containsCurrentObject: false,
212
+ },
213
+ pinHints: [],
214
+ aggregationMarkers: [],
215
+ commands: [],
216
+ };
217
+ }
218
+
219
+ function globalOverviewFixture(): GraphGlobalOverviewPayload {
220
+ return {
221
+ kind: "global-overview",
222
+ nodeCount: 2,
223
+ edgeCount: 1,
224
+ communityCount: 1,
225
+ coreNodeIds: ["a"],
226
+ searchResultIds: [],
227
+ pinHints: [],
228
+ selection: {
229
+ input: null,
230
+ selectionId: null,
231
+ selectedNodeIds: [],
232
+ selectedCommunityIds: [],
233
+ containsCurrentObject: false,
234
+ },
235
+ aggregationMarkers: [],
236
+ commands: [],
237
+ };
238
+ }
239
+
240
+ function unavailableFixture(): GraphUnavailableObjectPayload {
241
+ return {
242
+ kind: "unavailable-object",
243
+ object: { kind: "node", nodeId: "missing" },
244
+ reason: "missing-node",
245
+ selection: {
246
+ input: null,
247
+ selectionId: null,
248
+ selectedNodeIds: [],
249
+ selectedCommunityIds: [],
250
+ containsCurrentObject: false,
251
+ },
252
+ searchResultIds: [],
253
+ pinHints: [],
254
+ aggregationMarkers: [],
255
+ commands: [],
256
+ };
257
+ }
@@ -0,0 +1,200 @@
1
+ import { afterEach, describe, it } from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { readFileSync } from "node:fs";
4
+ import { resolve } from "node:path";
5
+ import React from "react";
6
+
7
+ import { GraphPanel } from "../src/components/GraphPanel";
8
+ import { click, pressKey, render, screen, waitFor } from "./render";
9
+
10
+ describe("GraphPanel Paper shell", () => {
11
+ const originalFetch = globalThis.fetch;
12
+
13
+ afterEach(() => {
14
+ globalThis.fetch = originalFetch;
15
+ });
16
+
17
+ it("renders the graph shell toolbar without adding app-level graph overlays", async () => {
18
+ mockGraphFetch();
19
+
20
+ render(
21
+ <GraphPanel
22
+ currentKnowledgeBaseName="AI 学习库"
23
+ currentKnowledgeBasePath="/kb"
24
+ theme="light"
25
+ />,
26
+ );
27
+
28
+ const toolbar = screen.getByRole("banner", { name: "图谱工具栏" });
29
+ assert.equal(toolbar.classList.contains("graph-shell-toolbar"), true);
30
+ assert.match(toolbar.textContent ?? "", /图谱活地图/);
31
+ assert.ok(screen.getByRole("button", { name: /重置布局/ }));
32
+ assert.ok(screen.getByRole("button", { name: /调参/ }));
33
+ assert.ok(screen.getByRole("button", { name: /重构/ }));
34
+ assert.notEqual(toolbar.querySelector(".graph-shell-legend"), null);
35
+
36
+ await waitFor(() => {
37
+ assert.match(toolbar.textContent ?? "", /1 节点 · 0 关联/);
38
+ });
39
+
40
+ const shell = document.querySelector(".graph-shell");
41
+ const stage = document.querySelector(".graph-stage");
42
+ assert.ok(shell);
43
+ assert.ok(stage);
44
+ assert.equal(shell?.contains(toolbar), true);
45
+ assert.equal(shell?.contains(stage), true);
46
+ assert.equal(stage?.contains(toolbar), false);
47
+ assert.notEqual(screen.queryByLabelText("图谱图例"), null);
48
+ assert.equal(document.querySelector(".graph-legend"), null);
49
+ assert.ok(document.querySelector(".graph-host"));
50
+ });
51
+
52
+ it("opens graph edge tuning controls from the toolbar", async () => {
53
+ mockGraphFetch();
54
+
55
+ render(
56
+ <GraphPanel
57
+ currentKnowledgeBaseName="AI 学习库"
58
+ currentKnowledgeBasePath="/kb"
59
+ theme="light"
60
+ />,
61
+ );
62
+
63
+ const tuningButton = screen.getByRole("button", { name: /调参/ }) as HTMLButtonElement;
64
+ await waitFor(() => {
65
+ assert.equal(tuningButton.disabled, false);
66
+ });
67
+ await click(tuningButton);
68
+
69
+ const panel = screen.getByRole("dialog", { name: "图谱调参" });
70
+ assert.match(panel.textContent ?? "", /分主次/);
71
+ const semanticToggle = screen.getByRole("checkbox", { name: "语义强调" });
72
+ const focusToggle = screen.getByRole("checkbox", { name: "聚焦点亮" });
73
+ assert.equal((semanticToggle as HTMLInputElement).checked, false);
74
+ assert.equal((focusToggle as HTMLInputElement).checked, false);
75
+ assert.equal(document.activeElement, semanticToggle);
76
+
77
+ await click(semanticToggle);
78
+
79
+ await waitFor(() => {
80
+ assert.equal((semanticToggle as HTMLInputElement).checked, true);
81
+ assert.equal(localStorage.getItem("llm-wiki.graph.edge-style"), "{\"semanticEmphasis\":true,\"focusHighlight\":false}");
82
+ });
83
+
84
+ await click(focusToggle);
85
+
86
+ await waitFor(() => {
87
+ assert.equal((focusToggle as HTMLInputElement).checked, true);
88
+ assert.equal(localStorage.getItem("llm-wiki.graph.edge-style"), "{\"semanticEmphasis\":true,\"focusHighlight\":true}");
89
+ });
90
+
91
+ await pressKey(document, "Escape");
92
+
93
+ assert.equal(screen.queryByRole("dialog", { name: "图谱调参" }), null);
94
+ assert.equal(document.activeElement, tuningButton);
95
+ });
96
+
97
+ it("surfaces graph build errors in the graph panel", async () => {
98
+ mockGraphFetch({ needsBuild: true });
99
+
100
+ const { rerender } = render(
101
+ <GraphPanel
102
+ currentKnowledgeBaseName="AI 学习库"
103
+ currentKnowledgeBasePath="/kb"
104
+ theme="light"
105
+ />,
106
+ );
107
+
108
+ await waitFor(() => {
109
+ assert.match(screen.getByText("图谱构建中").textContent ?? "", /图谱构建中/);
110
+ });
111
+
112
+ rerender(
113
+ <GraphPanel
114
+ currentKnowledgeBaseName="AI 学习库"
115
+ currentKnowledgeBasePath="/kb"
116
+ theme="light"
117
+ graphBuildError={{ kbPath: "/kb", message: "构建失败", rebuiltAt: "2026-06-20T00:00:00.000Z" }}
118
+ />,
119
+ );
120
+
121
+ await waitFor(() => {
122
+ assert.match(screen.getByText("图谱暂时不可用").textContent ?? "", /图谱暂时不可用/);
123
+ assert.match(document.body.textContent ?? "", /构建失败/);
124
+ });
125
+ });
126
+
127
+ it("keeps the GraphPanel Paper shell styling outside graph-engine internals", () => {
128
+ const css = readFileSync(resolve(import.meta.dirname, "../src/index.css"), "utf8");
129
+
130
+ assert.match(css, /\.graph-shell\s*\{[\s\S]*display:\s*grid/);
131
+ assert.match(css, /\.graph-shell-toolbar[\s\S]*position:\s*relative/);
132
+ assert.match(css, /\.graph-stage[\s\S]*min-height:\s*0/);
133
+ assert.match(css, /\.graph-shell-legend[\s\S]*display:\s*flex/);
134
+ assert.doesNotMatch(cssBlock(css, ".graph-shell-toolbar"), /position:\s*absolute/);
135
+ assert.match(css, /\.graph-shell-toolbar[\s\S]*var\(--paper-grain\)/);
136
+ assert.match(css, /\.graph-shell-toolbar-chip,[\s\S]*\.graph-shell-toolbar-button/);
137
+ assert.match(css, /\.graph-stage[\s\S]*border-radius:\s*16px/);
138
+ assert.doesNotMatch(css, /(^|\n)\s*\.graph-toolbar\b/);
139
+ assert.doesNotMatch(css, /(^|\n)\s*\.graph-legend\b/);
140
+ assert.doesNotMatch(css, /render-styles|sigma-node|sigma-edge/);
141
+ });
142
+ });
143
+
144
+ function cssBlock(css: string, selector: string): string {
145
+ const start = css.indexOf(`${selector} {`);
146
+ if (start === -1) return "";
147
+ const end = css.indexOf("\n }", start);
148
+ return end === -1 ? css.slice(start) : css.slice(start, end);
149
+ }
150
+
151
+ function mockGraphFetch(options: { needsBuild?: boolean } = {}) {
152
+ globalThis.fetch = (async (input) => {
153
+ const url = String(input);
154
+ if (url.startsWith("/api/graph/layout")) {
155
+ return jsonResponse({
156
+ ok: true,
157
+ layout: { version: 1, pins: {}, updatedAt: "2026-06-20T00:00:00.000Z" },
158
+ });
159
+ }
160
+ if (url.startsWith("/api/graph?")) {
161
+ if (options.needsBuild) {
162
+ return jsonResponse({
163
+ ok: true,
164
+ needsBuild: true,
165
+ graphPath: "/kb/.llm-wiki/graph.json",
166
+ });
167
+ }
168
+ return jsonResponse({
169
+ ok: true,
170
+ needsBuild: false,
171
+ data: {
172
+ meta: { build_date: "2026-06-20T00:00:00.000Z" },
173
+ nodes: [
174
+ {
175
+ id: "wiki/paper.md",
176
+ label: "Paper",
177
+ title: "Paper",
178
+ type: "topic",
179
+ community: "paper",
180
+ path: "wiki/paper.md",
181
+ },
182
+ ],
183
+ edges: [],
184
+ communities: [],
185
+ },
186
+ });
187
+ }
188
+ if (url.startsWith("/api/graph/rebuild")) {
189
+ return jsonResponse({ ok: true, status: "started" });
190
+ }
191
+ return jsonResponse({ ok: false, error: `Unexpected request: ${url}` }, 500);
192
+ }) as typeof fetch;
193
+ }
194
+
195
+ function jsonResponse(payload: unknown, status = 200) {
196
+ return new Response(JSON.stringify(payload), {
197
+ status,
198
+ headers: { "Content-Type": "application/json" },
199
+ });
200
+ }