Skip to content

v0.8.0 — Sprint 3 完走: "Open KIOKU and see what your memory looks like" (HTML Visualizer β)

Choose a tag to compare

View all tags
@ai-ryu ai-ryu released this 13 May 03:21
v0.8.0
84f49f3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v0.8.0 marks Sprint 3 (価値の可視化) completion — Sprint 1 (信頼性) と Sprint 2 (記憶品質) gave KIOKU the foundations to answer "is my KIOKU working?" and "is my Wiki rotting?". Sprint 3 builds the surface where you can see how your memory is growing in 5 seconds. As a self-contained HTML you can open in any browser, kioku_generate_viz wraps 4 views (Overview / Timeline / Diff / Lineage) into a single file.

This is the first release where KIOKU can show its value without Obsidian — drag-and-drop the generated HTML into any browser and watch your second brain breathe. Path C+β (KIOKU = Markdown analytics platform) viewer 70% achieved.

Highlights

Overview tab — see 4 layers at a glance (Phase 1 + 2)

  • Vault overview: pages total, summaries growth (7d/30d), page type distribution
  • Health focus: broken wikilinks (cluster view with merge candidates) / source sha256 duplicates / warm zone (7-30 days, fresh→warm→stale gradient)
  • Graph preview: hot pages by inbound degree / active projects / recent decisions
  • Action queue: 3-5 actionable items with P0/P1/P2 priority + concrete next_action

5 visualizations — pure CSS + DOM (Phase 2)

No external chart library. SVG / Canvas / D3 / Chart.js は不使用:

  • bar chart for page type distribution
  • sparkline for summaries growth rate (7d/30d)
  • warm zone gradient (fresh/warm/stale 3-segment bar)
  • broken wikilink cluster (target で grouped, merge candidate view)
  • source_sha256 duplicate cluster (same-source 重複 page の merge surface)

Lineage tab — KIOKU's distinctive view (Phase 3)

raw-sources → summaries → wiki pages の 3 layer lineage graph with 5 edge types:

Edge type Weight Meaning
sha256 1.00 Deterministic frontmatter hash match
derived_from 0.95 Explicit frontmatter reference
filename varies Filename / slug similarity
wikilink varies [[link]] within wiki pages
time 0.40 mtime proximity (1-hour window)
  • 300-node cap (acceptance criteria for stability)
  • best-effort hint (codex doc: "完全性よりも説明可能性を優先")
  • 1-2 hop subgraph helper for focused drill-down
  • Avoids Obsidian Graph View re-implementation by focusing on what's distinctive to KIOKU (raw-source lineage that Obsidian doesn't model)

Quality notes drawer (Phase 4)

wiki/lint-report.md (auto-lint LLM output) rendered as the 5th Overview card. Phase 2 で 2 重 negative assert していた契約を Phase 4 で flip (negative → positive):

  • auto-lint 4 観点: concept contradiction / concept splinter / dedicated page candidate / semantic wikilink gap
  • kioku_health の 11 machine-checkable metrics と auto-lint の LLM judgment が non-overlapping surface で共存

3 段 fallback (bullet → paragraph → whole-section) で LLM 出力の揺らぎに堅牢。

§46 N=3 mandatory refactor

mcp/lib/wiki-walker.mjs を抽出、3 caller (health-metrics / visualizer-data / lineage-graph) を walkPages() 共通 entry point に統一。LEARN#8b framework の好例 — N=2 で defer registered (Phase 1)、N=3 trigger (Phase 3) で同 PR 内で extract → resolved。

Real-world dogfood (PM Vault, 162 pages)

  • Overview tab: broken=23 / sha256_dup=2 / warm=99 / hot=10 / active=5 / action=5 (P0×2 / P1×1 / P2×2)
  • Lineage tab: 184 nodes (raw=24 / wiki=127 / summary=33) / 846 edges (sha256=21 / derived_from=17 / wikilink=424 / time=384) / 68ms (300 cap 余裕)
  • Auto-lint drawer: 4 categories, generated_at='2026-05-08'
  • HTML self-contained: external script/link/fetch 全 0、61.5KB

Path C+β viewer 70% 達成

  • ✅ read (Markdown viewer = HTML output)
  • ✅ visualize (lineage graph + wikilink graph + health overlay)
  • ✅ analyze (kioku_health 11 metrics + auto-lint 4 観点)
  • ✅ dashboard (HTML visualizer first view = 4 layer)
  • ⏳ search (Sprint 4)
  • ⏳ navigate (Sprint 4)
  • ✅ ingest (Sprint 2 既存)
  • ✅ agent integration (MCP + Hook)

Sprint 4 で残 (search + navigate + Bases dashboard 内製 + wikilink graph 強化) を land、Path C+β viewer 100% 達成へ。

Tests

  • 38 Phase 4 (visualizer-data 24 + visualizer 10 + screenshot 4)
  • 45 Phase 3 (wiki-walker 9 + lineage-graph 7+補強 + visualizer-data 15 + mcp/visualizer 9)
  • 全 Node + Bash regression pass
  • CI screenshot regression (tests/mcp/tools-visualizer-screenshot.test.mjs) with deterministic empty/small Vault fixtures

delegation pattern (release engineering 4-session pipeline)

session N role
制作 Claude impl 12 (Phase 1-4) Branch + PR + 7 点セット完了報告
codex CLI strategic 1 Sprint 3 strategic doc (PR #122)
マーケ Claude article 2 (前 v0.7.2-v0.7.5 retrospect) Sprint 3 完走 retrospect は本 release で起票予定
PM Claude tactical (orchestrator) strategic → tactical handoff + trust-but-verify

Install / upgrade

# Plugin marketplace (recommended)
claude plugin marketplace add megaphone-tokyo/kioku
claude plugin install kioku@megaphone-tokyo

# Or .mcpb (Claude Desktop)
# Download kioku-wiki-0.8.0.mcpb below and drag into Settings → Connectors

# Upgrade from v0.7.5
git pull origin main
bash scripts/generate-viz.sh    # See your new Overview tab + Lineage + Quality drawer

Verify the .mcpb

SHA-256: 5286f3532283e27c01f7f3af9f2e9fb6c46f056ab1eb241ba41c65f0ee097016

Full Changelog: v0.7.5...v0.8.0

Assets 3
Loading