Commit Graph
296 Commits
Author SHA1 Message Date
Lum1104andClaude Opus 4.6 9f7931a1f9 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>
2026-04-09 22:56:00 +08:00
Lum1104andClaude Opus 4.6 1842541a93 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>
2026-04-09 22:50:20 +08:00
Lum1104andClaude Opus 4.6 003339ec88 docs: add platform badges for Codex, Copilot, Gemini CLI, OpenCode
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-09 18:58:22 +08:00
Lum1104andClaude Opus 4.6 7e40b6d03a 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>
2026-04-09 18:42:51 +08:00
Lum1104andClaude Opus 4.6 04972b63f6 docs: update README tagline with expanded input types and multi-platform support
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-09 00:46:39 +08:00
Lum1104andClaude Opus 4.6 311f2ad1ac fix: sync copilot plugin version to 2.2.0
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-06 12:11:51 +08:00
Yuxiang LinandGitHub f9f07d7cb9 Merge pull request #74 from bryan-anthropic/fix/marketplace-json-schema
fix: remove invalid keys from marketplace.json plugins entry
2026-04-06 00:03:36 +08:00
Bryan Thompson 46ab9255f6 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.
2026-04-05 10:52:56 -05:00
Lum1104 bc51673913 fix: add metadata.description to marketplace.json to resolve validation warning 2026-04-05 12:30:25 +08:00
Yuxiang LinandGitHub fb9d60dfe3 Merge pull request #73 from bryan-anthropic/fix/marketplace-json-schema
Fix marketplace.json schema validation
2026-04-04 23:53:53 +08:00
Bryan ThompsonandClaude Opus 4.6 5c35dc9550 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>
2026-04-04 10:17:27 -05:00
Yuxiang LinandGitHub cf15d49850 Merge pull request #71 from Lum1104/feat/merge-graphs
feat: add graph merge scripts and improve agent pipeline
2026-04-04 16:29:02 +08:00
Lum1104andClaude Opus 4.6 660f766783 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>
2026-04-04 12:50:04 +08:00
Lum1104andClaude Opus 4.6 52050e40cb 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>
2026-04-04 12:28:20 +08:00
Lum1104andClaude Opus 4.6 b3683d62e2 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>
2026-04-04 11:56:58 +08:00
Lum1104andClaude Opus 4.6 3dfacd1c43 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>
2026-04-03 11:55:01 +08:00
Lum1104andClaude Opus 4.6 d6a80224b6 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>
2026-04-03 11:49:00 +08:00
Yuxiang LinandGitHub 2ec1c37efa Merge pull request #66 from Lum1104/feat/business-knowledge
feat: add business domain knowledge extraction and visualization
v2.1.0
2026-04-03 00:18:38 +08:00
Lum1104andClaude Opus 4.6 63ee658478 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>
2026-04-03 00:17:20 +08:00
Lum1104andClaude Opus 4.6 87cfe0d869 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>
2026-04-03 00:10:01 +08:00
Lum1104andClaude Opus 4.6 6d01c449c5 chore: update pnpm-lock.yaml
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 00:05:10 +08:00
Lum1104andClaude Opus 4.6 20eb483195 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>
2026-04-03 00:03:03 +08:00
Lum1104andClaude Opus 4.6 d52dd933ee 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>
2026-04-02 23:56:34 +08:00
Lum1104andClaude Opus 4.6 fece84ac59 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>
2026-04-02 23:14:29 +08:00
Lum1104andClaude Opus 4.6 2387649c1b 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>
2026-04-02 22:54:31 +08:00
Lum1104andClaude Opus 4.6 0c08a7853b 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>
2026-04-02 22:24:25 +08:00
Lum1104andClaude Opus 4.6 52a68e5bd4 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>
2026-04-02 22:21:55 +08:00
Lum1104andClaude Opus 4.6 9d1abd0a30 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>
2026-04-02 21:20:33 +08:00
Lum1104andClaude Opus 4.6 e682ec1829 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>
2026-04-02 15:24:30 +08:00
Lum1104andClaude Opus 4.6 7d3c049422 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>
2026-04-02 14:52:34 +08:00
Lum1104 9e8b99bc9e feat(dashboard): serve domain-graph.json via Vite dev server 2026-04-02 14:28:53 +08:00
Lum1104andClaude Opus 4.6 a4daccc54b feat(skills): add /understand-domain skill for business domain knowledge extraction
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 14:26:39 +08:00
Lum1104andClaude Opus 4.6 c97096dd96 feat(agents): add domain-analyzer agent for business domain extraction
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 14:26:06 +08:00
Lum1104andClaude Opus 4.6 b96a8c7338 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>
2026-04-02 14:24:44 +08:00
Lum1104andClaude Opus 4.6 53d507c2b7 feat(dashboard): add domain-aware NodeInfo sidebar for domain/flow/step nodes
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 14:19:30 +08:00
Lum1104andClaude Opus 4.6 5ea7866c00 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>
2026-04-02 12:57:46 +08:00
Lum1104andClaude Opus 4.6 0674ba3f39 feat(dashboard): add DomainGraphView with domain overview and detail views
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 12:34:06 +08:00
Lum1104andClaude Opus 4.6 c6433c0352 feat(dashboard): add FlowNode and StepNode components for domain view
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 12:27:32 +08:00
Lum1104andClaude Opus 4.6 1f2607e83f feat(dashboard): add DomainClusterNode component for domain view
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 12:27:27 +08:00
Lum1104andClaude Opus 4.6 3fba6bf478 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>
2026-04-02 12:20:36 +08:00
Lum1104andClaude Opus 4.6 4cb38ea360 feat(dashboard): add domain graph loading and view mode toggle pill
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 12:17:23 +08:00
Lum1104andClaude Opus 4.6 16f89c05b8 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>
2026-04-02 12:15:00 +08:00
Lum1104andClaude Opus 4.6 22fd49a821 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>
2026-04-02 12:07:05 +08:00
Lum1104andClaude Opus 4.6 005758b922 fix(core): improve step ID normalization and add missing test coverage
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 11:51:12 +08:00
Lum1104andClaude Opus 4.6 9693e1efee 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>
2026-04-02 11:43:23 +08:00
Lum1104andClaude Opus 4.6 d89d7f6e93 feat(core): add domain/flow/step prefixes to node ID normalization
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 11:40:36 +08:00
Lum1104andClaude Opus 4.6 fe01ee0f85 feat(core): add saveDomainGraph/loadDomainGraph persistence functions
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 11:29:26 +08:00
Lum1104andClaude Opus 4.6 37e56d62b3 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>
2026-04-02 11:08:52 +08:00
Lum1104andClaude Opus 4.6 ae00f58824 docs: add business domain knowledge design spec and implementation plan (issue #61)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-01 21:54:13 +08:00
Yuxiang LinandGitHub efd4c483ec Merge pull request #65 from fishinakleinbottle/fix/normalization-for-generated-graph
fix(core): deterministic node ID normalization for parallel batch output
2026-04-01 21:12:45 +08:00