Commit Graph
204 Commits
Author SHA1 Message Date
Lum1104andClaude Opus 4.6 2bb107e2d9 feat(core): add non-code file support to GraphBuilder
Add addNonCodeFile() and addNonCodeFileWithAnalysis() methods that create
graph nodes with the appropriate non-code types (document, config, service,
table, endpoint, pipeline, schema, resource).

addNonCodeFileWithAnalysis() creates child nodes for definitions, services,
endpoints, steps, and resources with "contains" edges to the parent file.

Add mapKindToNodeType() helper for mapping definition kinds to node types.
Extend EXTENSION_LANGUAGE map with all non-code file extensions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:40:04 +08:00
Lum1104andClaude Opus 4.6 3fd688ac37 feat(core): add 12 custom parsers for non-code file types
Add regex/parser-based analyzers for: Markdown, YAML, JSON, TOML, Env,
Dockerfile, SQL, GraphQL, Protobuf, Terraform, Makefile, Shell.

Each implements AnalyzerPlugin with analyzeFile() and optional
extractReferences(). Uses `yaml` npm package for YAML parsing,
built-in JSON.parse for JSON, regex for all others.

Add registerAllParsers() helper to register all parsers at once.
Add comprehensive test suite with 35 tests covering all parsers.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:38:25 +08:00
Lum1104andClaude Opus 4.6 c76b0a1f2d feat(core): add 26 non-code language configs with filename-based detection
Add LanguageConfig files for: markdown, yaml, json, toml, env, xml,
dockerfile, sql, graphql, protobuf, terraform, github-actions, makefile,
shell, html, css, openapi, kubernetes, docker-compose, json-schema, csv,
restructuredtext, powershell, batch, jenkinsfile, plaintext.

Add filenames? field to LanguageConfigSchema for filename-based detection
(Dockerfile, Makefile, Jenkinsfile, docker-compose.yml, .env variants).

Update LanguageRegistry.getForFile() to check filename matches first
(more specific) before falling back to extension-based lookup.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:34:16 +08:00
Lum1104andClaude Opus 4.6 9eb220c492 feat(core): make resolveImports optional on AnalyzerPlugin
Update PluginRegistry.resolveImports() to check for plugin.resolveImports
existence before calling it. Non-code plugins (e.g., markdown, dockerfile)
don't need import resolution, so this method is now optional.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:31:00 +08:00
Lum1104andClaude Opus 4.6 1f554146c0 feat(core): extend Zod schemas and aliases for 8 new node/edge types
Update EdgeTypeSchema with 8 new edge types (deploys, serves, migrates,
documents, provisions, routes, defines_schema, triggers).

Update GraphNodeSchema with 8 new node types (config, document, service,
table, endpoint, pipeline, schema, resource).

Add NODE_TYPE_ALIASES for non-code types (container->service, doc->document,
workflow->pipeline, etc.) and EDGE_TYPE_ALIASES (describes->documents,
creates->provisions, exposes->serves, etc.).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:30:17 +08:00
Lum1104andClaude Opus 4.6 b1f763adac feat(core): extend GraphNode/EdgeType/StructuralAnalysis for non-code file types
Add 8 new node types (config, document, service, table, endpoint,
pipeline, schema, resource) and 8 new edge types (deploys, serves,
migrates, documents, provisions, routes, defines_schema, triggers).

Add StructuralAnalysis sub-interfaces: SectionInfo, DefinitionInfo,
ServiceInfo, EndpointInfo, StepInfo, ResourceInfo, ReferenceResolution.

Make resolveImports optional on AnalyzerPlugin and add extractReferences.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:29:01 +08:00
Lum1104andClaude Opus 4.6 fd6235ad24 docs: add implementation plan for universal file type support
22-task plan covering core types, schema, parsers, language configs,
agent prompt updates, dashboard visualization, and integration testing.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:18:38 +08:00
Lum1104andClaude Sonnet 4.6 97537eba5d docs: add design for universal file type support
Adds design document for extending Understand Anything to analyze all
file types (Markdown, Dockerfile, YAML, SQL, Terraform, etc.) — not
just code. Covers 26 new file types, 8 new node types, 8 new edge
types, 12 custom parsers, agent pipeline changes, and dashboard
visualization updates.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-28 18:11:50 +08:00
Lum1104andClaude Opus 4.6 26cc41cf03 feat(dashboard): add token gate page for unauthenticated access
Visiting localhost:5173 without ?token= now shows a clean token input
page instead of a broken dashboard. Token is persisted in sessionStorage
so refreshes work within the same browser session.

Bump version to 1.3.1.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 16:59:51 +08:00
Yuxiang LinandGitHub 07c49fd4b0 Merge pull request #44 from fishinakleinbottle/feat/improve-dashboard-ux
Dashboard Improvement: lens-based hierarchical graph navigation
v1.3.0
2026-03-28 16:45:24 +08:00
Lum1104andClaude Opus 4.6 86be2da691 chore: bump version to 1.3.0
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 16:45:05 +08:00
Lum1104andClaude Opus 4.6 6fcee67214 fix(dashboard): review fixes for hierarchical navigation PR
- Restore topology/visual separation in useLayerDetailGraph to prevent
  dagre relayout on every selection/search change (perf regression)
- Remove unused tourHighlightedNodeIds from useOverviewGraph deps
- Remove dead code: showLayers/toggleLayers, zoomToNodeId,
  applyDagreLayoutAsync (Web Worker path)
- Replace direct useDashboardStore.setState() in NodeInfo with proper
  navigateToHistoryIndex store action
- Fix non-technical persona filter (was no-op due to prior type=file constraint)
- Integrate Escape-to-overview into App keyboard shortcuts (remove
  duplicate listener from Breadcrumb)
- Cap nodeHistory at 50 entries to prevent unbounded growth
- Add memo() to LayerClusterNode and PortalNode for render performance
- Make computePortals accept pre-computed aggregation to avoid redundant work
- Restore code viewer popup on node click
- Show NodeInfo above LearnPanel when a node is selected

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 16:44:15 +08:00
Lum1104 3cdc2ac71b Merge branch 'main' into pr44/improve-dashboard-ux
# Conflicts:
#	understand-anything-plugin/packages/dashboard/src/components/GraphView.tsx
#	understand-anything-plugin/packages/dashboard/src/components/LayerLegend.tsx
#	understand-anything-plugin/packages/dashboard/src/components/NodeInfo.tsx
2026-03-28 16:20:58 +08:00
Yuxiang LinandGitHub 710f312498 Merge pull request #41 from berkcangumusisik/test/improve-coverage
Expand core tests and add vitest coverage dep
2026-03-28 15:56:19 +08:00
Lum1104 34dcf1f16b Make persistence test compatible with current main 2026-03-28 15:55:15 +08:00
Lum1104 334ac871df Align persistence test with fatal validation behavior 2026-03-28 15:53:31 +08:00
Lum1104 e7ad9d6d69 Fix ImportResolution test fixture 2026-03-28 15:46:33 +08:00
Yuxiang LinandGitHub 7641add7b8 Merge pull request #33 from saismrutiranjan18/main
Security: fix information disclosure via dashboard server (issue #20)
2026-03-28 13:19:13 +08:00
Lum1104andClaude Opus 4.6 3fad7207fb merge: resolve conflict with main and fix token auth in dashboard
- Resolve import conflict in persistence/index.ts (keep both PR's path
  utilities and main's ProjectConfig/FingerprintStore imports)
- Fix critical bug: App.tsx fetches were missing the ?token= param,
  causing 403 on all data endpoints. Extract token from URL and forward
  it via tokenUrl() helper.
- Protect /meta.json endpoint with same token auth
- Revert unnecessary saveMeta whitespace reformatting

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 13:17:59 +08:00
Yuxiang LinandGitHub 36c00b9602 Merge pull request #31 from 1AdityaX/auto_update_feature
feat: automatic knowledge graph updates on commit with structural fingerprinting
2026-03-28 12:14:26 +08:00
Lum1104andClaude Opus 4.6 39ee76f492 fix: address remaining Copilot review findings
- SKILL.md Phase 7: use core buildFingerprintStore instead of ad-hoc regex script
- change-classifier: accurate FULL_UPDATE reason message (count vs percentage)
- persistence: add saveConfig/loadConfig tests (round-trip, missing, corrupted)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 12:13:22 +08:00
Lum1104andClaude Opus 4.6 5df763fd75 fix: address review findings — sort mutation, injection, directory baseline, error handling
- C1: use [...array].sort() to avoid mutating fingerprint inputs
- C2: replace echo piping with here-string to prevent shell injection in hooks
- M1/M2: add allKnownFiles param to classifyUpdate for correct directory baseline
- M3: add try-catch to loadFingerprints for corrupted JSON resilience
- M5: add hasStructuralAnalysis flag for conservative no-tree-sitter classification
- m3: replace fragile sed with node JSON.parse in SessionStart hook
- Add 7 new tests covering all fixes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 12:11:03 +08:00
Lum1104andClaude Opus 4.6 8c525839b2 merge: resolve SKILL.md conflict — keep both --auto-update and --review flags
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 12:01:57 +08:00
Lum1104andClaude Opus 4.6 867293ebab feat(understand): add review-only path and clarifying prompt for up-to-date graphs
- --review at same commit hash skips to Phase 6, reuses existing graph
- Same commit hash without flags now asks user what they'd like to do
  instead of silently stopping

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 11:55:26 +08:00
Yuxiang LinandGitHub 9ec77df3ac Merge pull request #47 from Lum1104/feat/token-reduction
feat: reduce /understand token cost by ~85% on large codebases
2026-03-28 11:48:40 +08:00
Lum1104andClaude Opus 4.6 36e7ad8c6e fix(understand): address PR #47 review — edge types, validator guards, prompt accuracy
- Map Quick Reference edge signals to allowed types (publishes→exports,
  subscribes→depends_on) to resolve contradiction with edge type table
- Restore `name` in Phase 4 payload (architecture-analyzer expects it)
- Add Array.isArray guards for layers/tour in inline validator
- Fix Python import syntax: `import .x` → `from . import x`
- Update Critical Constraints to reference batchFiles/batchImportData

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 11:15:16 +08:00
Lum1104andClaude Opus 4.6 3fb12033d6 fix(understand): address review findings — importCount metric source and plan typo
- Update importCount metric description to reference batchImportData[file.path].length
  instead of "number of import statements" (contradicted "do NOT extract imports" rule)
- Fix duplicate /index.js → /index.jsx in impl plan Task 5 extension variants

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 11:11:49 +08:00
Lum1104andClaude Opus 4.6 b90fb16b01 docs: update README pipeline stats — concurrency 3→5, batch size, --review flag
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 17:23:09 +08:00
Lum1104andClaude Opus 4.6 c0dc9b3e71 docs: fix version references in token-reduction plan (1.0.2 → 1.2.2)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 17:10:10 +08:00
Lum1104andClaude Opus 4.6 a33240180d chore: bump version to 1.2.2
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 17:09:04 +08:00
Lum1104andClaude Opus 4.6 33d4e73e32 perf(understand): wire importMap into batchImportData per batch, increase batch size 5-10→20-30, concurrency 3→5
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 17:09:00 +08:00
Lum1104andClaude Opus 4.6 7dbd89a44b perf(understand): replace allProjectFiles with batchImportData in file-analyzer — import resolution now done by scanner
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 17:08:48 +08:00
Lum1104andClaude Opus 4.6 c8261ff28b perf(understand): extend scanner to pre-resolve imports, output importMap in scan-result.json
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 15:42:36 +08:00
Lum1104andClaude Opus 4.6 67d146033d perf(understand): remove language/framework addendums from Phase 2 batches
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 15:28:55 +08:00
Lum1104andClaude Opus 4.6 1fa84c5959 perf(understand): slim Phase 5 tour payload — file nodes only, imports+calls edges, slim layers
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 15:17:55 +08:00
Lum1104andClaude Opus 4.6 e4f7902a22 perf(understand): slim Phase 4 architecture payload — drop redundant node fields
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 14:42:58 +08:00
Lum1104andClaude Opus 4.6 2d86d339c0 perf(understand): gate LLM graph-reviewer behind --review flag, add inline deterministic validation
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 14:41:29 +08:00
Lum1104 2545ad2f61 docs: add token reduction plan 2026-03-27 10:53:28 +08:00
Yuxiang LinandGitHub cfa6d71bb1 Merge pull request #45 from Lum1104/feat/theme-system
feat(dashboard): add curated theme preset system with accent customization
2026-03-27 10:20:33 +08:00
Lum1104andClaude Opus 4.6 34cfffc4cc fix(dashboard): resolve light theme visual issues from code review
- Use CSS variables for diff edge colors in GraphView
- Make ReactFlow colorMode respond to theme preset
- Replace hardcoded text-white/bg-gray-900 in LearnPanel
- Use CSS variables for .kbd border and box-shadow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 10:02:38 +08:00
Lum1104andClaude Opus 4.6 b4d541b312 feat(dashboard): add light theme CSS overrides and align @theme defaults
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:56:15 +08:00
Lum1104andClaude Opus 4.6 17330081ab feat(dashboard): integrate ThemeProvider and ThemePicker into App
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:54:11 +08:00
Lum1104andClaude Opus 4.6 2225c86ed6 feat(dashboard): add ThemePicker popover component
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:52:08 +08:00
Lum1104andClaude Opus 4.6 35732c67a1 feat(core): add optional theme field to AnalysisMeta
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:50:38 +08:00
Lum1104andClaude Opus 4.6 bce59b23b4 feat(dashboard): add ThemeContext with localStorage persistence
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:49:26 +08:00
Lum1104andClaude Opus 4.6 6dc260de15 feat(dashboard): add theme engine with CSS variable injection
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:48:07 +08:00
Lum1104andClaude Opus 4.6 11428b3441 feat(dashboard): add theme preset definitions
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:47:06 +08:00
Lum1104andClaude Opus 4.6 eff6f473b1 feat(dashboard): add theme type definitions
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:37:07 +08:00
Lum1104andClaude Opus 4.6 f7d649043f refactor(dashboard): consolidate hardcoded colors into CSS variables
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:34:42 +08:00
Lum1104andClaude Opus 4.6 dde40b8512 refactor(dashboard): rename gold CSS variables to accent
Rename all gold-related CSS custom properties, Tailwind classes,
and keyframe animations from "gold" to "accent" to prepare for
the theme system where the accent color is user-configurable.

- --color-gold -> --color-accent (plus -dim and -bright variants)
- @keyframes goldPulse -> accentPulse
- .animate-gold-pulse -> .animate-accent-pulse
- All text-gold, bg-gold, border-gold, ring-gold Tailwind classes

No behavioral or visual change — pure mechanical rename.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-27 09:29:44 +08:00