222 Commits

This Branch

This Branch

All Branches

• chore: bump version to 2.0.0

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

  Lum1104 · 2026-03-28 23:30:34 +08:00
  41d72e32f1
• fix(dashboard): reduce code viewer overlay height to avoid blocking nodes

  Reduced from 40vh to 25vh so the overlay sits closer to the bottom
  and leaves more room for graph nodes above.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-28 23:27:33 +08:00
  40a460df48
• fix: address comprehensive code review findings for PR #51

  Fix all issues from the 5-agent parallel code review of universal file
  type support:
  
  - Parser error handling: add console.warn in JSON/YAML catch blocks,
    warn on unbalanced braces in Protobuf/Terraform parsers
  - Parser correctness: filter .PHONY special targets in Makefile parser,
    handle opening brace on next line in Shell parser, fix per-stage
    EXPOSE port assignment in Dockerfile parser
  - Graph builder: use nodeType-based ID prefix instead of hardcoded
    "file:", warn on unknown definition kinds, detect duplicate node IDs
  - Type safety: export NodeType alias, add ServiceInfo.lineRange, type
    dashboard color maps as Record<NodeType,...>, refactor
    getDirectionalLabel to Record<EdgeType,...>, consolidate NodeCategory
  - Schema: add StrictLanguageConfigSchema with extensions/filenames
    refinement, fix Infrastructure/Schema-Data category comments
  - Agent prompts: fix Jenkinsfile language ID (groovy → jenkinsfile),
    fix css.md edge type (configures → related), remove shell.md
    Makefile cross-reference
  - Tests: 20+ new edge case tests across parsers, graph builder,
    language registry, and plugin registry
  - Documentation: add JSDoc to all 12 parser classes
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 21:55:20 +08:00
  4d2cb32232
• chore: bump version to 1.4.0 for universal file type support

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

  Lum1104 · 2026-03-28 19:15:53 +08:00
  49bcfd604c
• fix: address code review findings for universal file type support

  - Expand persona filter in GraphView.tsx to show all 9 file-level node
    types (file, config, document, service, table, endpoint, pipeline,
    schema, resource) instead of only "file", fixing invisible nodes
  - Add serves, provisions, and routes edge types with creation criteria
    to file-analyzer-prompt.md
  - Fix related edge weight from 0.3 to 0.5 to match SKILL.md default
  - Add filenames to openapiConfig for proper filename-based detection
  - Add TODO comments to kubernetesConfig and jsonSchemaConfig explaining
    content-based detection limitations
  - Clarify that module/concept types are reserved for higher-level agents
  - Update language-registry tests for 38 built-in configs
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 19:14:00 +08:00
  71468e8082
• feat(pipeline): update main skill pipeline for non-code file analysis

  Phase 1 (SCAN): Include non-code files in scan, add fileCategory to
  batch metadata. Phase 2 (ANALYZE): Add batching strategy for non-code
  files, group related infra/data/doc files together, pass fileCategory
  per file. Phase 4 (ARCHITECTURE): Inject non-code language snippets
  (markdown, yaml, dockerfile, sql, etc.), pass all node types and all
  edge types to architecture analyzer. Phase 5 (TOUR): Include non-code
  nodes in tour candidate pool, pass all edge types for topology analysis.
  Update node type reference table (5 -> 13 types), edge type reference
  table (18 -> 26 types), edge weight conventions, and inline validation
  script to handle file-level non-code node types for layer coverage.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:59:08 +08:00
  376c235d5e
• feat(agents): add language context snippets for 11 non-code file types

  Add language context snippets for markdown, yaml, json, sql, dockerfile,
  terraform, graphql, protobuf, shell, html, and css. Each snippet follows
  the existing typescript.md/python.md pattern with Key Concepts, Notable
  File Patterns, Edge Patterns, and Summary Style sections. These snippets
  are injected into the architecture analyzer prompt to improve layer
  assignments for non-code files.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:56:14 +08:00
  e7ebc600aa
• feat(agents): update graph reviewer for new node/edge types

  Add 8 new node types (config, document, service, table, endpoint,
  pipeline, schema, resource) to valid type list, bringing total to 13.
  Add 8 new edge types (deploys, serves, migrates, documents, provisions,
  routes, defines_schema, triggers) to valid type list, bringing total to
  26. Add quality checks: config nodes should have configures edges, doc
  nodes should have documents edges, service nodes should have deploys
  edges, etc. Add node type / ID prefix consistency check. Update layer
  coverage to include all file-level node types.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:53:56 +08:00
  8ac3a2096a
• feat(agents): extend tour builder for non-code file stops

  Allow non-code files as tour stops: README.md as step 1, Dockerfile,
  SQL migrations, CI configs, and other infrastructure files. Add non-code
  file inventory computation to the topology script. Add languageLesson
  concepts for Dockerfile (multi-stage builds), SQL (normalization), YAML
  (CI/CD triggers), Terraform (state management), GraphQL (type system),
  Protobuf (backward compatibility), and Kubernetes (deployments). Update
  pedagogical flow to weave non-code stops into the narrative naturally.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:52:36 +08:00
  83040be895
• feat(agents): add non-code pattern detection to architecture analyzer

  Add deployment topology detection (Dockerfile -> compose -> K8s), data
  pipeline detection (schema -> migration -> API -> client), documentation
  coverage analysis, and cross-category dependency analysis. Update layer
  hints for infrastructure, documentation, data, ci-cd, and configuration
  layers. Expand directory pattern matching with non-code patterns. Increase
  max layer count from 7 to 10 to accommodate non-code layers.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:50:29 +08:00
  7c8f056447
• feat(agents): add type-aware analysis prompts for non-code files

  Update file-analyzer-prompt.md with category-specific extraction guidance
  for config, docs, infra, data, script, and markup files. Add new output
  fields (sections, definitions, services, endpoints, steps, resources) and
  nodeType mapping from fileCategory to graph node types. Add edge generation
  guidance for non-code relationships (configures, documents, deploys,
  migrates, triggers, defines_schema). Expand tagging vocabulary with
  infrastructure, database, ci-cd, deployment, and migration tags.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:48:21 +08:00
  c1eda8395f
• feat(dashboard): add node type category filter controls

  Add nodeTypeFilters state and toggleNodeTypeFilter action to the Zustand
  store, apply category-based filtering in GraphView's useLayerDetailTopology,
  and render filter toggle buttons in the App header for Code, Config, Docs,
  Infra, and Data categories with colored indicator dots.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:48:08 +08:00
  642626653c
• feat(dashboard): add file type breakdown to ProjectOverview

  Show a categorized count of node types (Code, Config, Docs, Infra, Data)
  with colored dots matching node type colors. Only displayed when non-code
  nodes are present in the graph.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:46:49 +08:00
  78c8ce2602
• feat(dashboard): add new node/edge type support to NodeInfo sidebar

  Add badge colors for 8 new node types (config, document, service,
  table, endpoint, pipeline, schema, resource) and directional labels
  for 8 new edge types (deploys, serves, migrates, documents, provisions,
  routes, defines_schema, triggers).
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:46:11 +08:00
  6e3213e849
• feat(dashboard): add new node type colors to CustomNode

  Add typeColors and typeTextColors entries for config, document, service,
  table, endpoint, pipeline, schema, and resource node types.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:45:37 +08:00
  07ac08248e
• feat(agents): update project-scanner to discover all file types

  Remove the code-only file filter so the scanner discovers non-code files
  (.md, .yaml, .json, .sql, .tf, Dockerfile, etc.). Add fileCategory field
  to each discovered file (code/config/docs/infra/data/script/markup) with
  extension-based category detection logic. Expand language detection table
  to cover 26+ file types. Infrastructure tooling detection added to
  framework detection step.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:45:20 +08:00
  231ef484a0
• feat(dashboard): add 8 new node type colors to all theme presets

  Add colors for config, document, service, table, endpoint, pipeline,
  schema, and resource node types to all 5 theme presets (dark-gold,
  dark-ocean, dark-forest, dark-rose, light-minimal) and register the
  CSS variables in the Tailwind v4 @theme block.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:45:08 +08:00
  10173b19c5
• feat(core): export new types and parsers from core

  Export all 12 non-code parsers (MarkdownParser, YAMLConfigParser,
  JSONConfigParser, TOMLParser, EnvParser, DockerfileParser, SQLParser,
  GraphQLParser, ProtobufParser, TerraformParser, MakefileParser,
  ShellParser) and the registerAllParsers() helper from core index.
  
  New type exports (SectionInfo, DefinitionInfo, ServiceInfo, etc.)
  are already covered by the existing `export * from "./types.js"`.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-28 18:40:55 +08:00
  db572231f8
• 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>

  Lum1104 · 2026-03-28 18:40:04 +08:00
  2bb107e2d9
• 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>

  Lum1104 · 2026-03-28 18:38:25 +08:00
  3fd688ac37
• 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>

  Lum1104 · 2026-03-28 18:34:16 +08:00
  c76b0a1f2d
• 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>

  Lum1104 · 2026-03-28 18:31:00 +08:00
  9eb220c492
• 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>

  Lum1104 · 2026-03-28 18:30:17 +08:00
  1f554146c0
• 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>

  Lum1104 · 2026-03-28 18:29:01 +08:00
  b1f763adac
• 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>

  Lum1104 · 2026-03-28 18:18:38 +08:00
  fd6235ad24
• 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>

  Lum1104 · 2026-03-28 18:11:50 +08:00
  97537eba5d
• 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>

  Lum1104 · 2026-03-28 16:59:51 +08:00
  26cc41cf03
• Merge pull request #44 from fishinakleinbottle/feat/improve-dashboard-ux

  Dashboard Improvement: lens-based hierarchical graph navigation

  Yuxiang Lin · 2026-03-28 16:45:24 +08:00
  v1.3.0 07c49fd4b0
• chore: bump version to 1.3.0

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

  Lum1104 · 2026-03-28 16:45:05 +08:00
  86be2da691
• 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>

  Lum1104 · 2026-03-28 16:44:15 +08:00
  6fcee67214
• 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 #41 from berkcangumusisik/test/improve-coverage

  Expand core tests and add vitest coverage dep

  Yuxiang Lin · 2026-03-28 15:56:19 +08:00
  710f312498
• Make persistence test compatible with current main
  Lum1104 · 2026-03-28 15:55:15 +08:00
  34dcf1f16b
• Align persistence test with fatal validation behavior
  Lum1104 · 2026-03-28 15:53:31 +08:00
  334ac871df
• Fix ImportResolution test fixture
  Lum1104 · 2026-03-28 15:46:33 +08:00
  e7ad9d6d69
• 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