3 Commits

Include renames

Author	SHA1	Message	Date
nieaoandClaude Opus 4.7	f3ea1a3088	fix(understand-knowledge): Windows path + zod schema null compatibility ... Four single-line fixes that make `/understand-knowledge` work end-to-end on Windows. ## Root causes 1. Path separator mismatch (3 occurrences in parse-knowledge-base.py) - `str(rel.with_suffix(""))` returns backslash-separated stems on Windows (e.g. `entities\foo`), while wikilinks always use forward slashes (`[[entities/foo]]`). - Result: name_map keys and article_ids hold `entities\foo`, while `resolve_wikilink()` looks up `entities/foo` -> 100% miss. - Tested on Windows 11 + Python 3.14: 151/151 wikilinks unresolved, 0 edges built from wikilinks. Fix: use `rel.with_suffix("").as_posix()` in all three places (lines 235, 316, 330 on main). 2. Null vs missing field (1 occurrence) - `"category": category or None` writes `null` when category is empty. - `KnowledgeMetaSchema.category` in packages/core/src/schema.ts is `z.string().optional()`, which accepts `undefined`/missing but rejects `null`. - Result: every article node fails GraphNodeSchema validation in the dashboard (`Invalid input: expected string, received null`), all nodes get dropped, dashboard renders empty. Fix: omit the field when empty using dict spread. ## After Tested with a 27-article Karpathy wiki on Windows: - before: 151 unresolved wikilinks, 0 edges, 0 nodes rendered in dashboard - after: 0 unresolved, 110 wikilink edges + 23 LLM-implicit edges, all 53 nodes (article/topic/entity/claim) render correctly No behavior change on macOS/Linux: `as_posix()` is a no-op when the OS already uses `/`, and dict spread produces the same key as the previous truthy branch. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-09 15:38:13 +08:00
Lum1104andClaude Opus 4.6	7e41ba7a68	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>	2026-04-12 11:21:24 +08:00
Lum1104andClaude Opus 4.6	2fc85e68c3	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>	2026-04-12 11:09:41 +08:00