187 Commits

This Branch

This Branch

All Branches

• 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

  Lum1104 · 2026-03-28 16:20:58 +08:00
  3cdc2ac71b
• Merge pull request #33 from saismrutiranjan18/main

  Security: fix information disclosure via dashboard server (issue #20)

  Yuxiang Lin · 2026-03-28 13:19:13 +08:00
  7641add7b8
• 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>

  Lum1104 · 2026-03-28 13:17:59 +08:00
  3fad7207fb
• Merge pull request #31 from 1AdityaX/auto_update_feature

  feat: automatic knowledge graph updates on commit with structural fingerprinting

  Yuxiang Lin · 2026-03-28 12:14:26 +08:00
  36c00b9602
• 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>

  Lum1104 · 2026-03-28 12:13:22 +08:00
  39ee76f492
• 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>

  Lum1104 · 2026-03-28 12:11:03 +08:00
  5df763fd75
• merge: resolve SKILL.md conflict — keep both --auto-update and --review flags

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

  Lum1104 · 2026-03-28 12:01:57 +08:00
  8c525839b2
• 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>

  Lum1104 · 2026-03-28 11:55:26 +08:00
  867293ebab
• Merge pull request #47 from Lum1104/feat/token-reduction

  feat: reduce /understand token cost by ~85% on large codebases

  Yuxiang Lin · 2026-03-28 11:48:40 +08:00
  9ec77df3ac
• 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>

  Lum1104 · 2026-03-28 11:15:16 +08:00
  36e7ad8c6e
• 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>

  Lum1104 · 2026-03-28 11:11:49 +08:00
  3fb12033d6
• docs: update README pipeline stats — concurrency 3→5, batch size, --review flag

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

  Lum1104 · 2026-03-27 17:23:09 +08:00
  b90fb16b01
• 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>

  Lum1104 · 2026-03-27 17:10:10 +08:00
  c0dc9b3e71
• chore: bump version to 1.2.2

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

  Lum1104 · 2026-03-27 17:09:04 +08:00
  a33240180d
• 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>

  Lum1104 · 2026-03-27 17:09:00 +08:00
  33d4e73e32
• 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>

  Lum1104 · 2026-03-27 17:08:48 +08:00
  7dbd89a44b
• perf(understand): extend scanner to pre-resolve imports, output importMap in scan-result.json

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

  Lum1104 · 2026-03-27 15:42:36 +08:00
  c8261ff28b
• perf(understand): remove language/framework addendums from Phase 2 batches

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

  Lum1104 · 2026-03-27 15:28:55 +08:00
  67d146033d
• 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>

  Lum1104 · 2026-03-27 15:17:55 +08:00
  1fa84c5959
• perf(understand): slim Phase 4 architecture payload — drop redundant node fields

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

  Lum1104 · 2026-03-27 14:42:58 +08:00
  e4f7902a22
• perf(understand): gate LLM graph-reviewer behind --review flag, add inline deterministic validation

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

  Lum1104 · 2026-03-27 14:41:29 +08:00
  2d86d339c0
• docs: add token reduction plan
  Lum1104 · 2026-03-27 10:53:28 +08:00
  2545ad2f61
• Merge pull request #45 from Lum1104/feat/theme-system

  feat(dashboard): add curated theme preset system with accent customization

  Yuxiang Lin · 2026-03-27 10:20:33 +08:00
  cfa6d71bb1
• 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>

  Lum1104 · 2026-03-27 10:02:38 +08:00
  34cfffc4cc
• feat(dashboard): add light theme CSS overrides and align @theme defaults

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

  Lum1104 · 2026-03-27 09:56:15 +08:00
  b4d541b312
• feat(dashboard): integrate ThemeProvider and ThemePicker into App

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

  Lum1104 · 2026-03-27 09:54:11 +08:00
  17330081ab
• feat(dashboard): add ThemePicker popover component

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

  Lum1104 · 2026-03-27 09:52:08 +08:00
  2225c86ed6
• feat(core): add optional theme field to AnalysisMeta

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

  Lum1104 · 2026-03-27 09:50:38 +08:00
  35732c67a1
• feat(dashboard): add ThemeContext with localStorage persistence

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

  Lum1104 · 2026-03-27 09:49:26 +08:00
  bce59b23b4
• feat(dashboard): add theme engine with CSS variable injection

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

  Lum1104 · 2026-03-27 09:48:07 +08:00
  6dc260de15
• feat(dashboard): add theme preset definitions

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

  Lum1104 · 2026-03-27 09:47:06 +08:00
  11428b3441
• feat(dashboard): add theme type definitions

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

  Lum1104 · 2026-03-27 09:37:07 +08:00
  eff6f473b1
• refactor(dashboard): consolidate hardcoded colors into CSS variables

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

  Lum1104 · 2026-03-27 09:34:42 +08:00
  f7d649043f
• 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>

  Lum1104 · 2026-03-27 09:29:44 +08:00
  dde40b8512
• docs: add theme customize design doc and implementation plan
  Lum1104 · 2026-03-27 09:25:58 +08:00
  348ba3102d
• refactor(dashboard): remove swim-lane flow view

  The swim-lane layout needs more design work before shipping. Remove the
  flow view toggle, useFlowViewGraph hook, applySwimLaneLayout, and
  related store/breadcrumb code. Hierarchical lens navigation is retained.

  Sreeram · 2026-03-27 03:07:30 +05:30
  ef1f220782
• Merge branch 'main' of https://github.com/Lum1104/Understand-Anything into feat/improve-dashboard-ux
  Sreeram · 2026-03-27 02:40:21 +05:30
  275b9020e3
• docs: add theme customize design doc and implementation plan
  Lum1104 · 2026-03-26 23:37:08 +08:00
  f3bd72bc22
• chore: add .worktrees/ to gitignore
  Lum1104 · 2026-03-26 23:17:49 +08:00
  f1f4b43c00
• Merge pull request #42 from Lum1104/feat/dashboard-robustness

  feat: dashboard robustness — permissive graph loading with user-friendly warnings

  Yuxiang Lin · 2026-03-26 22:10:02 +08:00
  a848f3c9d3
• fix(core): restore validation errors compatibility and reject malformed collections
  Lum1104 · 2026-03-26 22:09:38 +08:00
  d79e3c862c
• feat(dashboard): surface graph validation issues and add messy graph fixtures

  Add a --messy mode to the large graph generator so robustness cases can be
    tested with null fields, aliases, dangling refs, and other malformed data.
  
    Update the dashboard to preserve non-fatal validation issues, log
    auto-corrected and dropped items, and show a warning banner with expandable
    details plus copy-to-clipboard support.

  Lum1104 · 2026-03-26 20:44:07 +08:00
  835377b968
• feat(core): permissive graph validation with tiered auto-fix pipeline

  - Add sanitizeGraph (Tier 1): null cleanup, lowercase enums
  - Add autoFixGraph (Tier 2): default missing fields, alias maps, weight coercion
  - Rewrite validateGraph: per-item validation, drop broken items, referential integrity
  - Add GraphIssue type for structured issue tracking
  - Update persistence layer for new ValidationResult API
  - 52 schema tests covering all tiers
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-26 16:39:10 +08:00
  28e3bd1631
• docs: add dashboard robustness design and implementation plan

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

  Lum1104 · 2026-03-26 12:20:44 +08:00
  d861087ba6
• Merge pull request #37 from Lum1104/fix/normalize-llm-type-aliases

  fix: normalize LLM-generated type aliases before schema validation

  Yuxiang Lin · 2026-03-25 10:40:47 +08:00
  v1.2.0 7631935465
• test: add alias chain detection guards

  Ensures no alias value is itself an alias key, which would cause
  single-pass normalization to produce a non-canonical value that
  Zod then rejects. Catches this class of bug at test time.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-25 09:36:18 +08:00
  4b22ed7336
• fix: remove unsafe tests→tested_by alias that inverts edge direction

  The "tests" alias silently rewrites to "tested_by" without swapping
  source/target, which inverts the relationship meaning and produces
  incorrect edges. Direction-inverting aliases should fail validation
  so the LLM gets explicit feedback to fix the edge.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-25 09:33:47 +08:00
  fd0df15d1c
• fix: normalize LLM-generated type aliases before schema validation

  LLMs systematically abbreviate node types (e.g. "func" instead of
  "function") and edge types (e.g. "extends" instead of "inherits"),
  causing dashboard validation failures. This combines two fixes:
  
  Option A: Rename the ambiguous `func:` ID prefix to `function:` across
  all prompts, source code, tests, and example data so LLMs see consistent
  naming. Also fix `relates_to` ghost edge type in django.md.
  
  Option B: Add NODE_TYPE_ALIASES and EDGE_TYPE_ALIASES normalization maps
  in schema.ts that transparently correct common abbreviations before Zod
  validation, as a runtime safety net.
  
  Closes #36
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-25 09:25:42 +08:00
  1a16b0fdd6
• Merge branch 'main' of github.com:fishinakleinbottle/Understand-Anything into feat/improve-dashboard-ux

  # Conflicts:
  #	understand-anything-plugin/packages/dashboard/src/App.tsx
  #	understand-anything-plugin/packages/dashboard/src/components/GraphView.tsx
  #	understand-anything-plugin/packages/dashboard/src/utils/layout.ts

  Sreeram · 2026-03-25 01:04:41 +05:30
  8fade58812
• feat: lens-based graph navigation with flow view and sidebar history

  Replace flat all-nodes-at-once graph with a two-level drill-down:
  - Level 1: layer cluster nodes (free-form graph of architectural layers)
  - Level 2: file nodes within a layer + portal nodes to adjacent layers
  - Breadcrumb navigation with Escape key to go back
  
  Add swim-lane "Flow" view showing all files in columns ordered by
  request lifecycle (API → Middleware → Service → Data → etc.) using
  dagre for within-lane vertical positioning.
  
  Sidebar improvements:
  - Navigation history trail (← Back + clickable breadcrumbs)
  - Directional connection labels (imports/imported by, contains/contained in)
  - Separate "Defined in this file" section for child classes/functions
  - Fix search dropdown overlapping breadcrumbs (z-index)
  - Remove redundant CodeViewer auto-open on node click
  
  Layer detector: add External Services and Background Tasks patterns.

  Sreeram · 2026-03-24 21:19:08 +05:30
  564f7e87c0