Understand-Anything

chore(dashboard): address Task 5 review minors

- Re-export NODE_WIDTH/NODE_HEIGHT from utils/layout.ts as the
  fallback dimensions in elk-layout.ts. Coupling them with the dagre/
  force defaults prevents silent drift during the migration.
- Declare optional x/y on ElkChild so downstream consumers (Tasks 9-12)
  see the position contract in the type. Comment notes ELK sets them
  on output but they're absent on input.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-03 16:07:57 +08:00

00a75c27db

feat(dashboard): ContainerNode component (visual + click toggle)

Lum1104 · 2026-05-03 16:07:26 +08:00

e459e924ff

test(dashboard): applyElkLayout integration cases

Lum1104 · 2026-05-03 16:06:49 +08:00

43fd232df7

chore(dashboard): address Task 4 review minors

- Length-prefix the inter-container bucket key to eliminate collision
  risk when container ids contain the separator (e.g. folder names with
  spaces). Adds a regression test.
- Rename AggregatedContainerEdge.types -> edgeTypes for symmetry with
  the existing LayerEdgeAggregation.edgeTypes field.
- Drop the as-cast in the test helper by giving it the real EdgeType
  literal type and a complete object shape.
- Reword the JSDoc to match what the function actually does (silently
  drop unmapped endpoints; callers needing strict can pre-filter).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-03 16:04:57 +08:00

9da085018e

feat(dashboard): store fields for expanded containers + layout cache

Lum1104 · 2026-05-03 16:04:34 +08:00

3ba65e67a0

chore(dashboard): address Task 2 + 3 review minors

- louvain.ts: rewrite the misleading "disconnected nodes get -1" comment
  (the library actually assigns unique ids; the reassignment loop is a
  defensive net for future API drift).
- containers.test.ts: add tags:[] to the test node helper for shape
  fidelity; replace the vacuously-true "every is community" assertion
  with one that actually fails if the community fallback regresses.
- containers.ts: collapse the two-pass groupByFolder into a single
  branching loop; guard Cluster A-Z naming so it doesn't wrap into
  punctuation past 26 communities.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-03 16:02:20 +08:00

a2b8f27810

feat(dashboard): elk-layout repair pipeline + applyElkLayout

Lum1104 · 2026-05-03 16:00:49 +08:00

8f3a6bf2c4

feat(dashboard): aggregateContainerEdges (directional, types-set)

Lum1104 · 2026-05-03 15:57:28 +08:00

46dc0485b9

feat(dashboard): deriveContainers community fallback via Louvain

Lum1104 · 2026-05-03 15:54:24 +08:00

74342da070

docs(spec+plan): fix-up — rename KnowledgeGraph* types, correct §2 thresholds

Task 2 implementation surfaced inconsistencies between the spec/plan
and the actual codebase:
- The real type exports are GraphNode / GraphEdge, not KnowledgeGraph*
- Folder grouping uses bucket count (folders + rooted) not just folder
  count, with threshold < 2 instead of < 3
- Concentration threshold is > 70% (was > 60%) so 2/3 distributions
  stay in folder mode
- Single-child suppression is gated by layer total ≥ 3 to avoid
  emptying tiny layers
- Removed the "layer < 8 → flat" rule; the algorithm is now uniform
  and small layers fall through naturally via single-child suppression

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-03 15:51:28 +08:00

5d11a6bfdc

feat(dashboard): deriveContainers folder strategy

Lum1104 · 2026-05-03 10:53:46 +08:00

30cd640b1e

chore(dashboard): add graphology-types as direct dep

Code review flagged that without it as a direct dep, TypeScript would
fail to resolve types like Attributes/NodeKey from transitive
graphology-types when later tasks import them.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-03 10:46:53 +08:00

a11c692c99

chore(dashboard): add elkjs, graphology, vitest

Lum1104 · 2026-05-03 10:42:34 +08:00

28362dbfe0

docs(plan): graph layout scaling — implementation tasks

17-task plan for the dashboard layout migration: dependencies + vitest,
container derivation (folder + Louvain), edge aggregation, ELK repair
pipeline, store extensions, ContainerNode component, per-view migration,
Stage 2 lazy expansion, auto-expand triggers, visual overlays, size
deviation re-layout, banner integration, and perf benchmarks.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-03 10:37:18 +08:00

fec05f6278

docs(spec): graph layout scaling — ELK + lazy containers

Design doc for replacing dagre with ELK across structural views, plus
folder/community-based containers and lazy two-stage layout for the
layer-detail view to fix horizontal sprawl at 50+ nodes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-03 10:27:26 +08:00

d965df7859

Merge pull request #110 from LukasWana/main

fix: change file permissions for extract-domain-context.py

Yuxiang Lin · 2026-05-01 18:31:22 +08:00

ab96806c08

fix: change file permissions for extract-domain-context.py

OpenClaw Ad Radar · 2026-05-01 12:24:43 +02:00

d0f77aa736

Merge pull request #108 from arkaigrowth/codex/code-viewer-sidepane

feat(dashboard): add read-only source viewer

Yuxiang Lin · 2026-05-01 18:01:29 +08:00

32875a486e

chore: bump version to 2.4.0

PR #108 ships a new user-visible feature (in-dashboard source code viewer
with Files tab + double-click navigation), so it warrants a minor bump
across all 5 version-tracked files.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-01 17:57:43 +08:00

87e3150c4b

feat(dashboard): file double-click also navigates the graph

Double-clicking a file in the Files tab previously only opened the source
viewer; the graph stayed wherever it was. Now also calls navigateToNode
first (drills into the layer + selects the node), then re-opens the code
viewer so the source panel stays visible.

Order matters: navigateToNodeInLayer resets codeViewerOpen, so the
openCodeViewer call has to come after.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-01 17:55:56 +08:00

7e58e97b5a

fix(dashboard): preserve sidebar composition + restore slide-up code viewer

Two issues from review of #108:

1. Sidebar exclusivity regression — replacing the entire sidebar with the
   CodeViewer when codeViewerOpen hid NodeInfo / LearnPanel / ProjectOverview
   while reading source. Same pattern that was rejected in #50. Restore the
   slide-up bottom overlay (per CLAUDE.md), keep sidebar tabs always visible,
   and revert the <aside> overflow-hidden change so long content can scroll.

2. Cross-graph mismatch (Codex P1) — FileExplorer always builds its tree from
   the structural graph and emits structural node IDs, but CodeViewer resolved
   IDs against the domain graph in domain mode, yielding "No file selected".
   Fall back to the structural graph when the active graph misses, so the
   Files tab works regardless of viewMode.

Also update CLAUDE.md to describe the Files tab + modal expand behavior so
future Claude sessions don't re-introduce the slide-up regression.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-05-01 17:28:08 +08:00

c6f5409111

feat(dashboard): add source code viewer

arkaigrowth · 2026-04-27 17:02:34 -05:00

13327b7945

docs: add Discord join badge to all README locales

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-26 16:58:14 +08:00

d3c2c65b86

fix(hooks): use \${CLAUDE_PLUGIN_ROOT} so plugin path expands at runtime

Hook echo commands referenced \${PLUGIN_DIR}, which Claude Code does not
inject into hook commands. The documented variable is \${CLAUDE_PLUGIN_ROOT}
(used elsewhere in skills/understand/SKILL.md and friends). Also switched
the surrounding single quotes to double quotes so the variable actually
expands at runtime instead of being passed literally.

Without this fix, the auto-update hook silently sent Claude a non-existent
file path, so the knowledge graph never incrementally updated even when
autoUpdate: true was configured.

Builds on the direction identified in #96; closes #96.

Co-Authored-By: xiaolai <lixiaolai@gmail.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-25 21:00:55 +08:00

1e07cbac94

Merge pull request #97 from xiaolai/fix/nlpm-echo-tool-input-printf

fix: use printf instead of echo to pipe TOOL_INPUT into grep

Yuxiang Lin · 2026-04-25 20:58:20 +08:00

6afa1bdfc5

Merge pull request #98 from xiaolai/fix/nlpm-gitignore-stderr-warnings

fix: log skipped invalid gitignore patterns to stderr

Yuxiang Lin · 2026-04-25 20:55:47 +08:00

1f61d9d03b

compress hero image

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-25 20:49:48 +08:00

ed584b1de2

Merge pull request #105 from gustn99/docs/update-claude-code-link

docs: update claude code link to claude code plugin in README

Yuxiang Lin · 2026-04-25 11:49:42 +08:00

f6dbaabbd2

docs: update claude code link to claude code plugin in README

gustn99 · 2026-04-25 12:15:56 +09:00

e68f651fb0

Merge pull request #103 from ZebangCheng/fix/image-404-paths

fix: correct hero image extension from .png to .jpg in Hero.astro

Yuxiang Lin · 2026-04-24 19:29:29 +08:00

2eb109d0f3

fix: correct hero image extension from .png to .jpg in Hero.astro

The homepage Hero component referenced `/images/hero.png`, but the
actual asset shipped at `homepage/public/images/hero.jpg`. As a result,
https://understand-anything.com/images/hero.png returned HTTP 404 and
the hero background failed to load.

修复：把 homepage/src/components/Hero.astro:7 的 /images/hero.png 改成
/images/hero.jpg，与仓库中实际存在的 homepage/public/images/hero.jpg
对齐，消除站点首页的 404。

Repro:
  curl -sI https://understand-anything.com/images/hero.png
  # HTTP/2 404

Root cause:
  homepage/src/components/Hero.astro:7
    <img src="/images/hero.png" ... />   # file does not exist
  homepage/public/images/
    hero.jpg (182179 bytes)              # actual file shipped

Fix:
  Single-line: .png -> .jpg in Hero.astro:7. Asset already published,
  no binary changes needed. After Pages rebuild, /images/hero.jpg
  resolves with HTTP 200.

ZebangCheng · 2026-04-24 11:03:45 +00:00

5649d5a515

update hero image

Lum1104 · 2026-04-24 15:52:03 +08:00

de626527e4

chore: bump to 2.3.2 and sync version manifest list

Bumps all five version-carrying manifests to 2.3.2, bringing
.copilot-plugin/plugin.json back in sync (was stuck at 2.2.0), and
updates CLAUDE.md to reflect the true set of files that must move
together: the nested understand-anything-plugin/.claude-plugin/plugin.json
and .copilot-plugin/plugin.json were missing, and marketplace.json was
incorrectly listed (its plugins[] entry does not support a version field).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-24 12:13:58 +08:00

bdba4795e2

chore: ignore .private/ directory

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-24 12:11:05 +08:00

51b5fc53f4

Merge pull request #95 from 0xnayuta/fix/pi-plugin-root-resolution

fix(skills): harden plugin root resolution across install modes

Yuxiang Lin · 2026-04-24 11:29:34 +08:00

81238fbc17

feat(homepage): add Substack release-updates subscribe to Hero

Adds a collapsed "Subscribe to release updates" disclosure below the
Hero CTA row. Default state preserves the existing dark-luxury layout;
clicking expands the Substack embed iframe in place. Uses native
<details> to avoid runtime JS.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-23 12:22:25 +08:00

7fb368579e

fix(skills): harden plugin root resolution across install modes

0xnayuta · 2026-04-22 11:19:07 +08:00

d9250d76a9

fix: log skipped invalid gitignore patterns to stderr

Silent pass on re.error hid invalid .gitignore patterns from users,
making it impossible to diagnose unexpected file-exclusion behavior.
Now logs a warning to stderr so users can see which patterns were
skipped and why.

Co-Authored-By: Claude Code <noreply@anthropic.com>

claude[bot] · 2026-04-21 12:28:26 +00:00

d919a0cf00

fix: use printf instead of echo to pipe TOOL_INPUT into grep

echo interprets escape sequences and flags (e.g. -e, -n) in some
shells, which can corrupt or truncate the hook event JSON before it
reaches grep. printf '%s' passes the value as a plain string with
no interpretation, eliminating any risk of mishandled special chars.

Co-Authored-By: Claude Code <noreply@anthropic.com>

claude[bot] · 2026-04-21 12:27:54 +00:00

a2a0a0c171

chore(pi): improve plugin root error message

0xnayuta · 2026-04-20 20:20:54 +08:00

6a071b5abd

fix(pi): resolve understand plugin root via symlink-safe logic

0xnayuta · 2026-04-20 20:08:20 +08:00

a2071fbf3c

Merge pull request #93 from Lum1104/fix/dashboard-code-splitting

perf(dashboard): code-split bundle to drop initial chunk under warning threshold

Yuxiang Lin · 2026-04-20 16:49:03 +08:00

822b20d9bf

perf(dashboard): code-split bundle to drop initial chunk under warning threshold

Split the single 770 kB dashboard bundle into named vendor chunks and
lazy-load optional views so the initial JS payload is smaller and stays
under Vite's 500 kB warning threshold.

- vite manualChunks: react-vendor, xyflow, graph-layout, markdown
- React.lazy for CodeViewer, LearnPanel, PathFinderModal, KeyboardShortcutsHelp
- PathFinderModal now only mounts while open (was always mounted)

Before: index 769.80 kB (gzip 235.12 kB), chunks-too-large warning.
After:  index 205 kB + split vendor/lazy chunks, warning gone.

Fixes #86

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-19 23:40:15 +08:00

4233e8668d

docs: point homepage links at understand-anything.com

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-19 12:33:42 +08:00

92ee9e3dbb

chore: migrate homepage and demo to understand-anything.com

Drops the /Understand-Anything subpath and retargets the site at the
apex custom domain served through GitHub Pages.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-19 12:23:41 +08:00

dbb4e94808

Merge pull request #92 from 0xnayuta/fix/quote-understand-argument-hint-yaml

fix(skill): quote understand argument-hint yaml

Yuxiang Lin · 2026-04-18 22:22:39 +08:00

716c3d6088

fix(skill): quote understand argument-hint yaml

0xnayuta · 2026-04-18 22:21:09 +08:00

aef6f88e90

fix(understand): preflight build of core package on first run

Lum1104 · 2026-04-17 14:33:23 +08:00

aebd6dcb3c

docs: add "Share the Graph with Your Team" section to READMEs (#79 )

Lum1104 · 2026-04-17 11:05:06 +08:00

38a0e3e2e1

chore: sync pnpm-lock.yaml with package.json

Lockfile was missing entries for tree-sitter language parsers
(c-sharp, cpp, go, java, php, python, ruby, rust) that were already
declared in packages/core/package.json.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-17 10:38:26 +08:00

f9b027245e

419 Commits