227 Commits

• chore(dashboard): add elkjs, graphology, vitest
  Lum1104 · 2026-05-03 10:42:34 +08:00
  28362dbfe0
• fix: change file permissions for extract-domain-context.py
  OpenClaw Ad Radar · 2026-05-01 12:24:43 +02:00
  d0f77aa736
• 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
• 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
• 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
• 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
• 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
• 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
• 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
• 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
• fix: allow /understand to target an arbitrary directory path

  Previously, PROJECT_ROOT was always set to CWD, which broke on
  alternative CLIs (e.g. OpenClaw) that set CWD to their own workspace
  directory. Now Phase 0 parses $ARGUMENTS for a non-flag directory path
  and uses it as PROJECT_ROOT, falling back to CWD when omitted.
  
  Closes #90
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-16 18:56:53 +08:00
  45e56a4624
• fix: PHP namespace block extraction, C/C++ language split, and Lua config

  - Handle block-scoped PHP namespaces (`namespace Foo { class Bar {} }`)
    by recursing into compound_statement bodies in PhpExtractor
  - Separate C (.c/.h) from C++ (.cpp/.cc/.hpp) into distinct language
    configs so .c/.h files resolve to language "c" instead of "cpp"
  - Add Lua language config so .lua files resolve to "lua" instead of
    "unknown" after the EXTENSION_LANGUAGE map was replaced by LanguageRegistry
  - Update TreeSitterPlugin JSDoc to reflect all 10 supported languages
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-16 14:40:24 +08:00
  a2907ec76f
• feat: export LanguageExtractor type and builtinExtractors from core package

  Completes the language extractor architecture — 10 languages with
  tree-sitter support (TS, JS, Python, Go, Rust, Java, Ruby, PHP, C/C++, C#).
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-15 19:27:33 +08:00
  11d2e95720
• feat: file-analyzer uses bundled tree-sitter script instead of LLM-generated regex

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

  Lum1104 · 2026-04-15 19:26:39 +08:00
  20c1567143
• feat: add bundled tree-sitter extraction script for file-analyzer agent

  Replaces the LLM-generated throwaway regex scripts in Phase 1 of the
  file-analyzer with a deterministic script that uses PluginRegistry
  (TreeSitterPlugin + all non-code parsers) from @understand-anything/core.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-15 19:23:49 +08:00
  f4b79e1d92
• feat: create extractor index with builtinExtractors, wire all 9 extractors into TreeSitterPlugin

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

  Lum1104 · 2026-04-15 19:20:42 +08:00
  4ff04b251e
• feat: add CSharpExtractor for tree-sitter C# structural analysis

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

  Lum1104 · 2026-04-15 19:19:24 +08:00
  3e4f7b6c02
• feat: add CppExtractor for tree-sitter C/C++ structural analysis

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

  Lum1104 · 2026-04-15 19:13:59 +08:00
  48e1daa838
• feat: add PhpExtractor for tree-sitter PHP structural analysis

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

  Lum1104 · 2026-04-15 19:08:51 +08:00
  4eb35b0437
• feat: add RubyExtractor for tree-sitter Ruby structural analysis

  Handles methods, classes, modules, attr_* properties, require imports,
  and call graph including bare identifier calls (no-arg method invocations).
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-15 19:02:52 +08:00
  dc8dd7dd77
• feat: add JavaExtractor for tree-sitter Java structural analysis

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

  Lum1104 · 2026-04-15 18:42:55 +08:00
  6e500cbfdf
• feat: add RustExtractor for tree-sitter Rust structural analysis

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

  Lum1104 · 2026-04-15 18:38:26 +08:00
  a1fb9585d3
• feat: add GoExtractor for tree-sitter Go structural analysis

  Implements the LanguageExtractor interface for Go, handling functions,
  methods with receivers, structs, interfaces, imports, exports (via
  capitalization convention), and call graph extraction. Includes 25 tests.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-15 18:33:18 +08:00
  f18cad61d5
• feat: add PythonExtractor for tree-sitter Python structural analysis

  Implements the LanguageExtractor interface for Python, extracting functions
  (with type annotations, defaults, *args/**kwargs), classes (methods +
  annotated properties), imports (plain, from, aliased, wildcard), exports
  (top-level defs), and caller-callee call graphs. Includes 31 tests using
  the real tree-sitter parser.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-15 18:28:38 +08:00
  398f5b15b0
• feat: add tree-sitter grammar deps and treeSitter configs for 10 languages

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

  Lum1104 · 2026-04-15 18:22:51 +08:00
  2ad0563878
• feat: add extractCallGraph to PluginRegistry, derive DEFAULT_PLUGIN_CONFIG from configs

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

  Lum1104 · 2026-04-15 18:20:31 +08:00
  9376375c8c
• refactor: move TS/JS extraction logic to TypeScriptExtractor, dispatch via LanguageExtractor interface

  Extract all TypeScript/JavaScript-specific AST extraction functions
  (extractParams, extractReturnType, extractImportSpecifiers, processTopLevelNode,
  extractFunction, extractClass, extractVariableDeclarations, extractImport,
  processExportStatement, and call graph walking) from TreeSitterPlugin into the
  new TypeScriptExtractor class. TreeSitterPlugin now dispatches to registered
  LanguageExtractor instances, defaulting to TypeScriptExtractor for backward
  compatibility. All 426 existing tests pass unchanged.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-15 18:17:09 +08:00
  ab011ff856
• feat: add LanguageExtractor interface and shared base utilities

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

  Lum1104 · 2026-04-15 18:12:07 +08:00
  4f954907ec
• refactor: replace hardcoded EXTENSION_LANGUAGE map in GraphBuilder with LanguageRegistry

  GraphBuilder maintained its own ~60-line extension-to-language mapping that
  duplicated and could diverge from the canonical LanguageRegistry. Now delegates
  language detection to LanguageRegistry.getForFile(), eliminating the duplication
  and ensuring new language configs are automatically picked up everywhere.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-15 17:30:38 +08:00
  6cba6de658
• fix: include access token in auto-opened dashboard URL

  CLI --open overrides server.open config, stripping the token. Remove
  --open from CLI and set server.open to /?token= so the browser opens
  with the access token already included.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  JohnWong · 2026-04-13 23:22:05 +08:00
  61a28c7d6c
• refactor: extract addChildNode helper to remove repeated boilerplate

  All five child-node loops in addNonCodeFileWithAnalysis shared the same four-line pattern: dedup check, nodeIds.add, nodes.push, and a contains edge push. A private addChildNode helper centralises this so each loop only constructs the node object specific to its type.

  Nikola Chetelyazov · 2026-04-13 09:56:12 +03:00
  d11a9bb1c9
• fix: use localeCompare in languages sort for reliable alphabetical order

  Default sort() uses Unicode code point ordering which can produce unexpected results for non-ASCII strings. localeCompare guarantees correct alphabetical ordering regardless of character set.

  Nikola Chetelyazov · 2026-04-13 09:52:13 +03:00
  45b98716ec
• refactor: return shallow copies of nodes and edges from build()

  build() was returning direct references to the builder's internal arrays, allowing callers to mutate graph.nodes or graph.edges and corrupt the builder's state. Spreading into new arrays at build time prevents this at negligible cost.

  Nikola Chetelyazov · 2026-04-13 09:49:47 +03:00
  e82235e1df
• refactor: deduplicate import and call edges via edgeKeys set

  addImportEdge and addCallEdge previously pushed edges unconditionally, allowing duplicate relationships if multiple agents reported the same import or call. A shared edgeKeys set keyed on type|source|target silently skips any edge that has already been recorded.

  Nikola Chetelyazov · 2026-04-13 09:47:16 +03:00
  ef0c65aa17
• refactor: extract endpoint label into variable to avoid duplicated template

  The endpoint name template was evaluated twice — once for name and once for summary. A single const removes the duplication and resolves the nested template literal lint warning.

  Nikola Chetelyazov · 2026-04-13 09:44:17 +03:00
  5593af76ca
• refactor: return fileId from addNonCodeFile instead of recomputing it

  addNonCodeFileWithAnalysis was reconstructing the fileId string independently of addNonCodeFile, creating a silent correctness risk if the ID construction logic ever changed. addNonCodeFile now returns the ID it used so the caller cannot go out of sync.

  Nikola Chetelyazov · 2026-04-13 09:41:12 +03:00
  6c55ee303a
• refactor: extract basename helper to replace repeated split/pop pattern

  The same filePath.split("/").pop() ?? filePath expression appeared three times across addFile, addFileWithAnalysis, and addNonCodeFile. A private static helper centralises the logic and makes call sites easier to read.

  Nikola Chetelyazov · 2026-04-13 09:35:55 +03:00
  82b1d06777
• refactor: promote nodeIds to class field to avoid O(n²) set rebuild

  Previously addNonCodeFileWithAnalysis rebuilt a full Set from this.nodes on every call, making duplicate checks O(n) per file and O(n²) overall. Moving nodeIds to a class field and updating it incrementally at each insertion reduces duplicate detection to O(1) per check.

  Nikola Chetelyazov · 2026-04-13 09:33:18 +03:00
  a89555d369
• refactor: extract KIND_TO_NODE_TYPE as module-level constant in GraphBuilder

  Previously the mapping object was recreated on every mapKindToNodeType call. Moving it to module level means it is allocated once at load time instead of once per definition node processed.

  Nikola Chetelyazov · 2026-04-13 09:28:02 +03:00
  c96a14c541
• fix: add plugin manifest under understand-anything-plugin/.claude-plugin

  marketplace.json declares plugins[0].source as ./understand-anything-plugin,
  so Claude Code resolves the plugin manifest at
  ./understand-anything-plugin/.claude-plugin/plugin.json. That file did not
  exist — only .claude-plugin/plugin.json at the repo root — causing
  "Marketplace sync failed. Some plugins in this marketplace have validation
  errors." when adding the marketplace via /plugin marketplace add.
  
  Adds the manifest at the path the marketplace source expects, so marketplace
  sync validates and the plugin can be installed. Version matches the current
  root plugin.json (2.3.1).
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  jiachen · 2026-04-12 17:22:30 +08:00
  72953254d2