Understand-Anything

fix(dashboard): show function/class nodes in layer detail view

Function and class nodes were invisible in the graph because they
are not directly assigned to layers (only file-level nodes are).
Expand layer membership by following `contains` edges from file nodes
in the active layer to include their child function/class nodes.

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

Lum1104 · 2026-04-02 23:56:34 +08:00

d52dd933ee

fix: address all 24 prompt engineering audit issues across 7 agents

knowledge-graph-guide.md (6 issues):
- Fix node types (5→16), edge types (18→29), tour schema (nodeId→nodeIds)
- Add domain graph documentation, jq examples, expand content

graph-reviewer.md (5 issues):
- Add domain node types (domain/flow/step) and edge types (contains_flow/flow_step/cross_domain)
- Relax layers/tour requirements for domain graphs
- Soften Check 8 (remove overly strict config/resource/endpoint checks)

domain-analyzer.md (6 issues):
- Add input format specification, output file path, writing results section
- Add critical constraints section with validation rules
- Fix flow_step weight scheme to stay within 0-1 range
- Change from "respond with JSON" to write-to-file pattern

file-analyzer.md (6 issues):
- Fix node type count description (13→accurate text)
- Recommend Node.js over bash for extraction scripts
- Replace "validate mentally" with actionable JSON validation instruction
- Clarify exports vs contains edge relationship
- Trim redundant tag guidance section
- Document why direction is always forward

architecture-analyzer.md (4 issues):
- Allow Python fallback for script language
- Clarify allEdges excludes sub-file edges
- Define "common prefix" algorithm for directory grouping
- Add layer count validation and empty group handling

tour-builder.md (2 issues):
- Fix BFS to start from code entry point, not README
- Allow Python fallback for script language

project-scanner.md (4 issues):
- Clarify exclusions match full directory segments, not substrings
- Stop excluding *.d.ts (may be hand-written)
- Add .env secret leak warning
- Document $PROJECT_ROOT variable, prefer Node.js

Cross-agent (3 issues):
- Consistent "prefer Node.js; fall back to Python" across all agents
- Schema type/count consistency across all agents
- Domain graph compatibility with graph-reviewer

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

Lum1104 · 2026-04-02 23:14:29 +08:00

fece84ac59

fix: tone down function/class extraction constraint to avoid false mandate

The previous wording ("MUST have sub-nodes") implied every code file
must produce function nodes, which is wrong for files without significant
functions. Now correctly states: if significant functions exist in the
script output, you must create nodes for them.

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

Lum1104 · 2026-04-02 22:54:31 +08:00

2387649c1b

chore: remove old prompt templates and update hook references

Delete the 5 prompt template files from skills/understand/ now that
they live in agents/. Update auto-update-prompt.md hook to reference
agent definitions instead of deleted prompt files.

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

Lum1104 · 2026-04-02 22:24:25 +08:00

0c08a7853b

refactor: move prompt templates to agent definitions for prompt integrity

Prompt templates (file-analyzer, project-scanner, architecture-analyzer,
tour-builder, graph-reviewer) were being compressed by the orchestrator
when dispatched as subagent prompts, causing function/class extraction
to be silently skipped. Moving them to agents/ ensures the framework
loads the full prompt without compression.

- Move 5 prompt templates from skills/understand/ to agents/
- Update SKILL.md to reference agent definitions instead of templates
- Set all agent models to `inherit` for cross-platform compatibility
- Update CLAUDE.md to reflect new agent model policy

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

Lum1104 · 2026-04-02 22:21:55 +08:00

52a68e5bd4

fix: address code review issues across domain feature

- Remove direction-inverting `implemented_by` alias (same pattern as fd0df15)
- Replace ambiguous `process` alias with `business_process`
- Fix duplicate React Flow edge IDs in DomainGraphView
- Fix navigateToDomain clearing selectedNodeId and losing history
- Preserve domain viewMode when structural graph loads after domain graph
- Add domain/flow/step to fileLevelTypes in GraphView
- Add domain edge category to EDGE_CATEGORY_MAP
- Extend COMPLEXITY_STRING_MAP with trivial/basic/mid/average/advanced
- Normalize string complexity values in normalizeBatchOutput (not just numeric)
- Infer node type from ID prefix in edge fallback normalization
- Include flow discriminator in bare-path step ID normalization
- Clean up domain-context.json intermediate file in SKILL.md

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

Lum1104 · 2026-04-02 21:20:33 +08:00

9d1abd0a30

feat(skills): add extract-domain-context.py for lightweight codebase scanning

Python preprocessing script for /understand-domain Phase 2 (standalone path).
Scans a project and produces a structured JSON context file containing:
- File tree (respects .gitignore)
- Entry points (HTTP routes, CLI commands, events, cron, handlers)
- File signatures (exports, imports, previews) prioritized by business logic
- Project metadata (package.json, README, etc.)

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

Lum1104 · 2026-04-02 15:24:30 +08:00

e682ec1829

fix: address all code review issues from both reviewers

- Fix race condition: setGraph no longer wipes domainGraph on parallel fetch
- Remove workflow/action aliases that conflicted with pipeline type
- Remove duplicate onNodeDoubleClick handler in DomainGraphView
- Add clearActiveDomain store action (replaces direct setState call)
- Remove auto-switch to domain viewMode in setDomainGraph
- Add DomainMetaSchema Zod validation for domainMeta fields
- Add Array.isArray guards for domainMeta collections in NodeInfo
- Remove as-any cast in getDomainMeta (use typed domainMeta directly)
- Add "domain" filter category for domain/flow/step nodes
- Keep flow discriminator in step ID normalization to prevent collisions
- Update SKILL.md Phase 2 to use tool-based scanning (no missing script)
- Update EDGE_LABELS comment to reflect 29 edge types
- Bump version to 2.1.0 in all 4 required files

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

Lum1104 · 2026-04-02 14:52:34 +08:00

7d3c049422

feat(dashboard): serve domain-graph.json via Vite dev server

Lum1104 · 2026-04-02 14:28:53 +08:00

9e8b99bc9e

feat(skills): add /understand-domain skill for business domain knowledge extraction

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

Lum1104 · 2026-04-02 14:26:39 +08:00

a4daccc54b

feat(agents): add domain-analyzer agent for business domain extraction

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

Lum1104 · 2026-04-02 14:26:06 +08:00

c97096dd96

fix(dashboard): improve type safety and graph resolution in domain-aware NodeInfo

Remove unnecessary `as any` and `as string[]` casts by using the properly
typed DomainMeta interface. Fix historyNodes and childNodes to resolve from
activeGraph instead of graph so domain view mode works correctly. Use
type-narrowing filters to eliminate non-null assertions. Add early return
guard for step nodes with no filePath.

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

Lum1104 · 2026-04-02 14:24:44 +08:00

b96a8c7338

feat(dashboard): add domain-aware NodeInfo sidebar for domain/flow/step nodes

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

Lum1104 · 2026-04-02 14:19:30 +08:00

53d507c2b7

fix(dashboard): fix mutable state, theme API, store pattern, and type imports in DomainGraphView

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

Lum1104 · 2026-04-02 12:57:46 +08:00

5ea7866c00

feat(dashboard): add DomainGraphView with domain overview and detail views

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

Lum1104 · 2026-04-02 12:34:06 +08:00

0674ba3f39

feat(dashboard): add FlowNode and StepNode components for domain view

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

Lum1104 · 2026-04-02 12:27:32 +08:00

c6433c0352

feat(dashboard): add DomainClusterNode component for domain view

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

Lum1104 · 2026-04-02 12:27:27 +08:00

1f2607e83f

fix(dashboard): add button types, validation warning, and title attributes to view toggle

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

Lum1104 · 2026-04-02 12:20:36 +08:00

3fba6bf478

feat(dashboard): add domain graph loading and view mode toggle pill

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

Lum1104 · 2026-04-02 12:17:23 +08:00

4cb38ea360

fix(dashboard): add const assertion, reset domain state in setGraph, add category comment

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

Lum1104 · 2026-04-02 12:15:00 +08:00

16f89c05b8

feat(dashboard): add domain view state to store (viewMode, domainGraph, activeDomainId)

Add ViewMode type, DOMAIN_EDGE_TYPES, and domain/flow/step entries to
dashboard store, CustomNode, GraphView, and NodeInfo Record maps so the
dashboard compiles with the new core domain node and edge types.

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

Lum1104 · 2026-04-02 12:07:05 +08:00

22fd49a821

fix(core): improve step ID normalization and add missing test coverage

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

Lum1104 · 2026-04-02 11:51:12 +08:00

005758b922

fix(core): remove dead import and unnecessary type cast in domain persistence test

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

Lum1104 · 2026-04-02 11:43:23 +08:00

9693e1efee

feat(core): add domain/flow/step prefixes to node ID normalization

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

Lum1104 · 2026-04-02 11:40:36 +08:00

d89d7f6e93

feat(core): add saveDomainGraph/loadDomainGraph persistence functions

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

Lum1104 · 2026-04-02 11:29:26 +08:00

fe01ee0f85

feat(core): add domain/flow/step node types and domain edge types for business domain knowledge

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

Lum1104 · 2026-04-02 11:08:52 +08:00

37e56d62b3

docs: add business domain knowledge design spec and implementation plan (issue #61 )

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

Lum1104 · 2026-04-01 21:54:13 +08:00

ae00f58824

Merge pull request #65 from fishinakleinbottle/fix/normalization-for-generated-graph

fix(core): deterministic node ID normalization for parallel batch output

Yuxiang Lin · 2026-04-01 21:12:45 +08:00

efd4c483ec

fix(core): handle all 13 node types, edge cross-variant resolution, and dropped edge traceability

- Add all 13 node types (including non-code) to VALID_PREFIXES and TYPE_TO_PREFIX
  to prevent valid IDs like config:tsconfig.json from being stripped
- Add fallback normalizeNodeId on edge endpoints not found in idMap, fixing
  silent relationship loss when edges use different malformed variants than nodes
- Add DroppedEdge interface with source, target, type, and reason fields so
  callers can surface exactly which edges were lost and why
- Use honest Record<string, unknown>[] return types instead of unsafe type casts
- Align SKILL.md complexity aliases with COMPLEXITY_STRING_MAP
- Add 5 new tests for non-code types, cross-variant edges, dropped edge detail,
  and validateGraph integration

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

Lum1104 · 2026-04-01 21:10:43 +08:00

6f443fbc14

Merge pull request #64 from pablospe/fix/posix-compatible-hooks

fix: use POSIX-compatible pipe instead of bash herestring in hooks

Yuxiang Lin · 2026-04-01 10:35:51 +08:00

89b5000624

fix(core): add deterministic normalization for parallel batch analyzer output

Parallel file-analyzer subagents can produce inconsistent node IDs
(project-name prefixed, double-prefixed, bare paths) and invalid
complexity values. Phase 3 ASSEMBLE now normalizes these deterministically
before merging, preventing cascading edge drops and dashboard load failures.

- Add normalize-graph.ts with normalizeNodeId, normalizeComplexity,
  and normalizeBatchOutput utilities
- Rewrite SKILL.md Phase 3 with 6-step normalization sequence
- Strengthen file-analyzer prompt with ID format warnings
- Add 32 normalization tests and 2 schema boundary tests

Sreeram · 2026-03-31 16:34:04 +05:30

60c2ead398

fix: use POSIX-compatible pipe instead of bash herestring in hooks

The PostToolUse hook used `<<<` (bash herestring) which fails when
Claude Code runs hooks under `/bin/sh`. Replace with `echo | grep`
for POSIX compatibility.

Pablo Speciale · 2026-03-31 12:12:02 +02:00

ee2c9c8dd7

ci: add PR workflow for build, test, and type-check

Runs on every pull_request: builds core and skill packages (which also
serves as TypeScript type-check), then runs all Vitest tests.

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

Lum1104 · 2026-03-30 11:16:57 +08:00

a7eea05694

Merge pull request #56 from Lum1104/copilot/fix-hide-bottom-bar-issue-55

fix: remove redundant CodeViewer bottom bar on node selection

Sreeram N R · 2026-03-30 00:26:53 +05:30

ca044fe730

fix: hide redundant bottom bar (CodeViewer) on node click, closes #55

Agent-Logs-Url: https://github.com/Lum1104/Understand-Anything/sessions/f2065131-263d-42f8-957c-4006b0954284

Co-authored-by: fishinakleinbottle <11816323+fishinakleinbottle@users.noreply.github.com>

copilot-swe-agent[bot] · 2026-03-29 15:09:15 +00:00

43ab4fb893

Initial plan

copilot-swe-agent[bot] · 2026-03-29 15:05:34 +00:00

6bc16e7232

Merge pull request #52 from GarfieldHuang/feat/vscode-copilot-plugin

feat: add VS Code + GitHub Copilot agent skills support

Yuxiang Lin · 2026-03-29 20:52:13 +08:00

f99f2e1941

docs: add Traditional Chinese README and update language links

- Add README.zh-TW.md (Traditional Chinese translation)
- Update language nav links in all READMEs to include 繁體中文

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

Garfield · 2026-03-29 20:42:25 +08:00

631dc588f8

docs: update Japanese and Turkish READMEs with VS Code + GitHub Copilot support

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

Garfield · 2026-03-29 20:40:14 +08:00

179757ff7a

fix: address Copilot review comments

- Remove displayName from plugin.json (not in Copilot manifest schema)
- Use ln -sf for idempotent skill symlinks
- Use rm -f for safer uninstall

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

Garfield · 2026-03-29 13:35:23 +08:00

6beba0975b

fix: correct symlink instructions in VS Code INSTALL.md

Each skill must be symlinked individually into ~/.copilot/skills/,
not the entire skills directory as a single entry.

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

Garfield · 2026-03-29 13:25:38 +08:00

b8a069a65b

feat: add VS Code + GitHub Copilot agent skills support

- Add `.copilot-plugin/plugin.json` for auto-discovery in VS Code (mirrors `.cursor-plugin/` format)
- Add `.vscode/INSTALL.md` with two install options: auto-discovery and personal skills via symlink
- Update README.md and README.zh-CN.md with VS Code section and compatibility table row

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

Garfield · 2026-03-29 13:09:00 +08:00

ea3e42a836

chore: update lockfile for new core dependencies

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

Lum1104 · 2026-03-29 11:36:12 +08:00

364a7ee114

feat(homepage): update features, install, and footer for v2.0.0

Expand feature cards from 3 to 6 covering new capabilities across
v1.2.0–v2.0.0 releases. Update install note and footer tagline to
reflect multi-platform support.

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

Lum1104 · 2026-03-29 11:34:18 +08:00

5bd8eb7c8d

docs: add homepage update implementation plan

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

Lum1104 · 2026-03-29 11:32:29 +08:00

f9fada25f6

docs: add homepage update design for v2.0.0 features

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

Lum1104 · 2026-03-29 11:31:48 +08:00

c190f9ca96

Merge pull request #50 from berkcangumusisik/feat/dashboard-export-filtering

Add filters, export, path finder & tooltips

Yuxiang Lin · 2026-03-29 11:18:44 +08:00

3bcd7f6fec

fix(dashboard): make header legends horizontally scrollable on overflow

Split the header into three sections: fixed left (project name, persona),
scrollable middle (diff toggle, node type filters, layer legend), and
fixed right (filter, export, path, theme actions). Prevents toolbar
overflow when projects have many layers or node types.

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

Lum1104 · 2026-03-29 11:18:22 +08:00

d4e5e7f875

fix(dashboard): fix PNG export by replacing foreignObject with clean SVG primitives

The foreignObject approach caused canvas tainting — browsers block
canvas.toBlob() when the SVG contains embedded DOM content. Extracted
a shared buildCleanSvg() helper using only rect/line/text elements,
reused by both PNG and SVG export.

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

Lum1104 · 2026-03-29 11:13:57 +08:00

8de31ea8e6

Merge main into feat/dashboard-export-filtering

Resolved conflicts by keeping main's features (ThemeProvider, TokenGate,
WarningBanner, graph validation, layer navigation, sidebar composing
behavior) and integrating PR's new features (FilterPanel, ExportMenu,
PathFinderModal, NodeTooltip, ProjectOverview stats) on top.

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

Lum1104 · 2026-03-29 11:02:15 +08:00

4d92381da1

274 Commits