243 Commits

This Branch

This Branch

All Branches

• 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
• Merge pull request #51 from Lum1104/feat/universal-file-type-support

  feat: universal file type support for non-code files

  Yuxiang Lin · 2026-03-28 23:31:37 +08:00
  v2.0.0 1fb759eca6
• 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
• Add filters, export, path finder & tooltips

  Introduce interactive graph tools and UI improvements: add FilterPanel, ExportMenu, PathFinderModal and NodeTooltip components; extend CustomNode data with incoming/outgoing counts and tags. Wire new components into App (buttons + keyboard shortcuts F/E/P) and implement outside-click/escape handling. Update GraphView to apply persona + filter rules, compute connection counts, register ReactFlow instance, and render per-node tooltips. Add JSON/SVG/PNG export that respects persona/filters and a BFS-based path finder UI. Enhance ProjectOverview with complexity distribution, most-connected nodes and average connections. Extend store with FilterState, edge category types, reactFlowInstance and toggles.

  Berkcan Gümüşışık · 2026-03-28 15:46:25 +03:00
  30e6b87c7d
• 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