290 Commits

This Branch

This Branch

All Branches

• Merge pull request #74 from bryan-anthropic/fix/marketplace-json-schema

  fix: remove invalid keys from marketplace.json plugins entry

  Yuxiang Lin · 2026-04-06 00:03:36 +08:00
  f9f07d7cb9
• fix: remove invalid keys from marketplace.json plugins entry

  The plugins array entries only support 'name' and 'source' fields.
  The 'version' and 'description' keys cause schema validation failures
  during the marketplace review process.

  Bryan Thompson · 2026-04-05 10:52:56 -05:00
  46ab9255f6
• fix: add metadata.description to marketplace.json to resolve validation warning
  Lum1104 · 2026-04-05 12:30:25 +08:00
  bc51673913
• Merge pull request #73 from bryan-anthropic/fix/marketplace-json-schema

  Fix marketplace.json schema validation

  Yuxiang Lin · 2026-04-04 23:53:53 +08:00
  fb9d60dfe3
• Fix marketplace.json schema validation

  Remove root-level "version" and "description" keys that are not
  recognized by the marketplace schema validator. The description
  is already correctly set in the plugins array entry.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Bryan Thompson · 2026-04-04 10:17:27 -05:00
  5c35dc9550
• Merge pull request #71 from Lum1104/feat/merge-graphs

  feat: add graph merge scripts and improve agent pipeline

  Yuxiang Lin · 2026-04-04 16:29:02 +08:00
  cf15d49850
• fix: coerce edge weights to float before comparison in merge scripts

  Prevents TypeError crash when LLM batches emit mixed weight types
  (e.g. 0.8 vs "0.7") during edge deduplication.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-04 12:50:04 +08:00
  660f766783
• fix: address PR #71 review findings and bump version to 2.2.0

  Fix all actionable code review items: add missing domain/flow/step node
  types, fix batch numeric sorting, align gate thresholds, merge duplicate
  tour steps instead of dropping, add Writing Results section to
  assemble-reviewer, use skill-relative script paths, and add func→function
  type mapping.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-04 12:28:20 +08:00
  52050e40cb
• feat: add graph merge scripts and improve agent pipeline reliability

  Add Python scripts to merge knowledge graphs (closes #70) and move
  mechanical normalization out of LLM context into deterministic scripts
  with diagnostic reporting. Convert all agent definitions from dispatch
  templates to self-contained system prompts to prevent instruction loss.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-04 11:56:58 +08:00
  b3683d62e2
• docs: add live demo badge and switch to default rounded badges across all READMEs

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

  Lum1104 · 2026-04-03 11:55:01 +08:00
  3dfacd1c43
• feat: add live demo dashboard on GitHub Pages

  Add a demo mode to the dashboard that fetches graph data from Supabase
  Storage instead of the local Vite dev server, bypasses the token gate,
  and deploys alongside the homepage at /Understand-Anything/demo/.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-03 11:49:00 +08:00
  d6a80224b6
• Merge pull request #66 from Lum1104/feat/business-knowledge

  feat: add business domain knowledge extraction and visualization

  Yuxiang Lin · 2026-04-03 00:18:38 +08:00
  v2.1.0 2ec1c37efa
• fix(dashboard): auto-widen domain graph spacing for long edge labels

  Instead of truncating cross_domain edge labels, compute ranksep from
  the longest label length (~6px/char) so dagre spaces nodes further
  apart. Also add label background for readability, and support
  spacingOverrides parameter in applyDagreLayout.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-03 00:17:20 +08:00
  63ee658478
• docs: add business domain knowledge feature to all README translations

  Add /understand-domain command, domain-analyzer agent, and two new
  feature entries (Business Domain Knowledge + Structural/Domain Views)
  to all 5 README versions: English, Simplified Chinese, Traditional
  Chinese, Japanese, and Turkish.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-03 00:10:01 +08:00
  87cfe0d869
• chore: update pnpm-lock.yaml

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

  Lum1104 · 2026-04-03 00:05:10 +08:00
  6d01c449c5
• fix(dashboard): address 8 audit issues across dashboard components

  1. Add infrastructure edge category to EDGE_CATEGORY_MAP for 8 missing
     edge types (deploys, serves, provisions, triggers, migrates, documents,
     routes, defines_schema) — previously unfiltered regardless of toggles
  
  2. navigateToDomain now switches viewMode to "domain" — previously
     clicking flow buttons from structural mode was a silent no-op
  
  3. ExportMenu JSON export for non-technical persona now keeps all
     file-level types — previously dropped config/document/service/etc.
  
  4. ProjectOverview category breakdown now includes module/concept in
     Code and domain/flow/step in new Domain category
  
  5. SearchBar type badge colors now cover all 16 node types — previously
     only 5 had colors, rest fell back to file color
  
  6. PathFinder BFS now traverses edges bidirectionally — previously
     only followed forward direction, missing valid reverse paths
  
  7. GraphView node filtering consolidated into single authoritative
     type set — previously fileLevelTypes and persona conditions were
     separate lists that could drift
  
  8. SelectedNodeFitView delayed 100ms to run after layer-level fitView
     on search-click navigation — previously layer fit clobbered node fit
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-03 00:03:03 +08:00
  20eb483195
• 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