304 Commits

This Branch

This Branch

All Branches

• fix: address Codex review — stable layout, scoped infra filter, basename dedup

  P1: Separate force layout computation from visual state updates so
  clicking/searching/touring doesn't re-randomize node positions. Layout
  only recomputes when the graph data or filters change.
  
  P1: Restrict infrastructure-file skipping (index.md, log.md, etc.) to
  the wiki root level only. Nested files like concepts/index.md are now
  correctly treated as content articles.
  
  P2: Track ambiguous bare basenames in the wikilink resolution map.
  Duplicate basenames (e.g., a/foo.md and b/foo.md) are removed from
  the flat lookup so [[foo]] doesn't silently resolve to the wrong page.
  
  Also fixed: edge IDs now use stable source-target-type keys instead of
  array indices for proper React reconciliation.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-12 11:21:24 +08:00
  7e41ba7a68
• docs: add /understand-knowledge to translated READMEs

  Updated zh-CN, zh-TW, ja-JP, tr-TR with the same 4 changes:
  tagline, knowledge base section, command example, agent table row.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-12 11:15:51 +08:00
  d3dfbd873b
• docs: add /understand-knowledge to README

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

  Lum1104 · 2026-04-12 11:12:38 +08:00
  66a8706646
• feat: add /understand-knowledge for Karpathy LLM wiki knowledge bases

  Support the Karpathy LLM wiki pattern — a three-layer architecture
  (raw sources + wiki markdown + schema) with wikilinks, index.md
  categories, and append-only log.md.
  
  Pipeline:
  - parse-knowledge-base.py: deterministic extraction of articles,
    wikilinks, categories from index.md, source nodes from raw/
  - article-analyzer agent: LLM-based entity/claim extraction and
    implicit relationship discovery (builds_on, contradicts, etc.)
  - merge-knowledge-graph.py: combines scan + analysis with entity
    dedup, layer assignment from categories, tour generation
  
  Dashboard:
  - KnowledgeGraphView with d3-force layout (community clustering
    by index.md categories, degree-proportional sizing)
  - 5 knowledge node types (article, entity, topic, claim, source)
  - 6 knowledge edge types with visual styling
  - KnowledgeNodeDetails sidebar (wikilinks, backlinks, preview)
  - Auto-detect kind:"knowledge" → knowledge-only view mode
  
  Core:
  - 5 node types + 6 edge types added to NodeType/EdgeType unions
  - KnowledgeMeta interface (wikilinks, backlinks, category, content)
  - kind field on KnowledgeGraph for view mode detection
  - Zod schemas + node/edge type aliases
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-12 11:09:41 +08:00
  2fc85e68c3
• docs: add Star History rank badge to all READMEs

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

  Lum1104 · 2026-04-11 09:19:13 +08:00
  55a03f6647
• docs: reorganize docs/ into superpowers/specs/ and superpowers/plans/

  Move all design docs to docs/superpowers/specs/ and all implementation
  plans to docs/superpowers/plans/ for consistent organization.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-11 09:15:51 +08:00
  b2c2934291
• docs: add /understand-knowledge implementation plan (14 tasks)

  Detailed step-by-step plan covering core type extensions, schema validation,
  dashboard changes (CSS, store, sidebar, reading panel, edge styling, layout),
  agent definitions, format guides, and skill definition.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-11 09:15:51 +08:00
  e58ceb856f
• docs: add /understand-knowledge design spec for personal knowledge base plugin

  New skill that takes markdown knowledge bases (Obsidian, Logseq, Dendron, Foam,
  Karpathy-style, Zettelkasten, plain) and produces interactive knowledge graphs
  with typed nodes/edges, auto-format detection, and dashboard visualization.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-11 09:15:51 +08:00
  098ad791c0
• Add funding information for Patreon
  Yuxiang Lin · 2026-04-10 19:45:02 +08:00
  78b72724ed
• fix: include access token in dashboard URL reported to user

  The understand-dashboard skill now instructs agents to capture and
  share the full tokenized URL from the Vite server output, so users
  are not blocked by the token gate.
  
  Bump version to 2.2.1.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-09 22:50:20 +08:00
  1842541a93
• docs: add platform badges for Codex, Copilot, Gemini CLI, OpenCode

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

  Lum1104 · 2026-04-09 18:58:22 +08:00
  003339ec88
• docs: add animated showcase GIFs and streamline READMEs

  - Replace static overview.png with two animated GIFs (structural + domain views)
  - Reorder READMEs: Features section before Quick Start
  - Remove redundant sections (Why, Who is this for, duplicate feature entries)
  - Move project structure/tech stack/dev commands to CONTRIBUTING.md
  - Homepage: use Supabase-hosted MP4 videos via GitHub variables, GIF fallback
  - Add DEMO_STRUCTURAL_VIDEO_URL and DEMO_DOMAIN_VIDEO_URL to deploy workflow
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-09 18:42:51 +08:00
  7e40b6d03a
• docs: update README tagline with expanded input types and multi-platform support

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

  Lum1104 · 2026-04-09 00:46:39 +08:00
  04972b63f6
• fix: sync copilot plugin version to 2.2.0

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

  Lum1104 · 2026-04-06 12:11:51 +08:00
  311f2ad1ac
• 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