Understand-Anything

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

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

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

chore: remove unused demo video env vars from homepage workflow

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

Lum1104 · 2026-04-16 17:07:37 +08:00

5fa01446fc

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

Merge pull request #89 from Lum1104/fix/graph-builder-use-language-registry

feat: multi-language tree-sitter extractor architecture (10 languages)

Yuxiang Lin · 2026-04-15 22:34:33 +08:00

3f07df056f

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

docs: add implementation plan for multi-language tree-sitter extractor architecture

Plan covers: LanguageExtractor interface, per-language extractors for 8 languages
(Python, Go, Rust, Java, Ruby, PHP, C/C++, C#), bundled extract-structure.mjs
script replacing LLM-generated regex in file-analyzer agent, and PluginRegistry
enhancements.

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

Lum1104 · 2026-04-15 18:01:57 +08:00

b2fb97b884

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: correct live demo URLs in all READMEs to point to /demo/

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

Lum1104 · 2026-04-14 12:22:45 +08:00

a42ba9119a

fix: add trailing slash to BASE_URL for demo iframe path

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

Lum1104 · 2026-04-14 12:18:41 +08:00

90dc2d453e

fix: remove iframe sandbox to fix demo loading on custom domain

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

Lum1104 · 2026-04-14 12:15:49 +08:00

5ac194885f

feat: embed live demo in homepage and add demo link to all READMEs

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

Lum1104 · 2026-04-14 12:12:19 +08:00

dc84b07159

feat: embed live interactive demo in homepage, replacing video/GIF showcase

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

Lum1104 · 2026-04-14 12:08:28 +08:00

f291628892

Merge pull request #88 from JohnWong/main

fix: include access token in auto-opened dashboard URL

Yuxiang Lin · 2026-04-13 23:51:30 +08:00

f2dce56678

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

redesign: full homepage refresh with gradient keywords, new problem section, and improved visual hierarchy

- Hero: gradient "Understand" headline, badge pill, staggered entrance animations, star icon for GitHub
- New Problem section: structure vs meaning comparison with hairball SVG and domain preview cards
- Showcase: split into structural (table stakes) and business knowledge (star) with pill labels and feature tags
- Features: 2-column layout with gradient icons and tighter copy
- Install: copy-to-clipboard button
- Footer: expanded with Live Demo link and updated tagline
- Global: rose-gold-to-gold gradient tokens, .grad text utility

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

Lum1104 · 2026-04-13 21:30:57 +08:00

16868f200d

389 Commits