Commit Graph

13 Commits

  • fix(graph-reviewer): remove duplicated critical checks from warning section
    Edge weights, node ID prefix conventions, and tag formatting were listed
    in both Check 1 (Schema Validation — Critical) and Check 7 (Quality —
    Warning). A deterministic script following check headings would classify
    these as warnings, potentially approving invalid graphs. Remove the
    duplicates from Check 7 since Check 1 already covers them as critical.
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
  • fix(agents): define .sh as supported source extension in project-scanner
    The exclusion rule conditionally kept .sh files for bash-first projects,
    but the source-file whitelist and language mapping table had no .sh entry,
    causing retained shell files to be dropped or untyped. Add .sh/.bash to
    the whitelist and language table (mapped to 'bash'), and remove the
    conditional exclusion rule.
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
  • fix(graph-reviewer): align duplicate-ID classification as critical
    Duplicate node IDs were listed under Check 6 (Warning) but classified as
    critical in the Severity Classification section. A script following check
    headings would classify duplicates as warnings, letting invalid graphs
    pass review. Move duplicate-ID check to its own Check 5 (Critical) and
    renumber subsequent checks.
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
  • chore: bump version to 1.0.5
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
  • feat(agents): add script-augmented two-phase architecture to all agents
    Redesign all 5 agent prompts with a "Phase 1 — Script" + "Phase 2 — LLM
    Reasoning" structure. Agents now write and execute scripts for deterministic
    work (validation, file discovery, structure extraction, graph analysis)
    before applying LLM judgment for semantic tasks (summaries, tags, pedagogy).
    
    Key changes per agent:
    - graph-reviewer: script performs all 6 validation checks deterministically
    - project-scanner: script handles file discovery, language detection, line counting
    - file-analyzer: script extracts functions/classes/imports via regex patterns
    - architecture-analyzer: script computes import adjacency, inter-group frequency
    - tour-builder: script calculates fan-in, BFS traversal, cluster detection
    
    Design safeguards:
    - scriptCompleted sentinel field guards against partial script output
    - Batch-indexed temp paths prevent collision in concurrent file-analyzer agents
    - Explicit "trust the script" directives prevent LLM from re-reading raw data
    - Up to 2 script retries on failure
    - Explicit instructions to strip intermediate fields from final output
    - Bash tool added to all agent tool lists
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
  • fix(dashboard): enable click and expand for all node types (function, class, etc.)
    Previously only FILE nodes responded to clicks with the code viewer overlay.
    Now all node types open the detail viewer on click. Also added a direct click
    handler on CustomNode to fix click events not firing for child nodes inside
    group layers on Windows.
    
    Bump version to 1.0.4.
  • fix: resolve plugin installation failures for workspace resolution and missing dependencies
    Add Vite resolve aliases for core subpath exports (schema, search, types)
    to fix import resolution on Windows where Node.js package exports are not
    properly followed by Vite's import analysis.
    
    Bump version to 1.0.3.
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
  • fix: resolve plugin installation failures for workspace resolution and missing dependencies
    - Add pnpm-workspace.yaml to plugin distribution so workspace:* deps resolve on install
    - Add devlop and hast-util-to-jsx-runtime as explicit dashboard dependencies (pnpm strict hoisting)
    - Make tsconfig.json files self-contained to work outside monorepo root
    - Add prepare script to auto-build core package after pnpm install
    - Bump version to 1.0.2
  • fix: remove nested .claude-plugin/plugin.json to fix user-scope marketplace installation
    The nested plugin.json inside understand-anything-plugin/.claude-plugin/
    conflicted with the root marketplace.json, causing Claude Code to fail
    when installing the plugin in user scope with "Source path does not exist" error.
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
  • feat: redesign dashboard with dark luxury theme, improve agent pipeline
    - Remove ChatPanel and @anthropic-ai/sdk dependency (redundant with /understand-chat)
    - Replace Monaco editor with styled summary code viewer
    - New graph-first layout: 75% graph + 360px right sidebar
    - Dark luxury aesthetic: deep blacks, gold/amber accents, DM Serif Display typography
    - Add ProjectOverview component for sidebar default state
    - Learn persona now shows tour panel directly in sidebar
    - Add schema validation on graph load with error banner
    - Defensive null checks in store for tour methods
    - Agent pipeline: write intermediate results to disk instead of context
    - Agent models: sonnet for simple tasks, opus for complex (no haiku)
    - Prompt-engineer all 5 agent prompts and SKILL.md
    - Auto-trigger /understand-dashboard after /understand completes
    - Add dashboard screenshot to README
    - Bump version to 1.0.1
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
  • feat(skill): add smart graph reading protocol to query skills
    Replace "read the whole graph file" instructions with targeted Grep-based
    reading in /understand-chat, /understand-diff, /understand-explain, and
    /understand-onboard. Each skill now includes a Graph Structure Reference
    and extracts only the relevant subgraph (matched nodes + 1-hop edges)
    instead of dumping the entire JSON into context. Also update /understand
    to reference /understand-dashboard.
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
  • feat(skill): add /understand-dashboard skill to launch visualization
    New skill command that starts the Vite dev server to visualize the
    knowledge graph in a web dashboard.
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
  • refactor: restructure monorepo into Claude Code plugin layout
    Move packages/{core,dashboard,skill} into understand-anything-plugin/ to
    conform to the Claude Code plugin format. Add .claude-plugin/marketplace.json
    for plugin discovery. Update workspace config and docs accordingly.
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>