@sdsrs/llm-wiki 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.6.3 (2026-07-11)
+
+Two cosmetic fixes from an independent review of 0.6.0–0.6.2; no behavior
+change beyond the scan warning's rounding.
+
+- fix(scan): the tag-dispersion warning now flags on the same rounded top-tag
+  share it displays, so it can no longer print "top tag covers 30%" while
+  firing a "below 30%" rule. Effective threshold is 29.5% (was a raw 30% with
+  an inconsistent display); negligible for an advisory heuristic. Suite 178 →
+  179.
+- docs: note that the JSON Canvas map's `file` cards are vault-relative from the
+  KB root, so a canvas written outside the KB via `--out` won't resolve them in
+  Obsidian — open the canvas with the KB as its own vault.
+
 ## 0.6.2 (2026-07-11)
 
 No breaking changes, no KB migration, no default-behavior change — one additive

package/README.md

@@ -147,6 +147,9 @@ human to resolve.
 
 `export --format canvas` writes a JSON Canvas (`graph.canvas`) domain map —
 `file` cards laid out by page type that open as live notes in Obsidian Canvas.
+The card paths are vault-relative from the KB root, so open the canvas with the
+KB as its own vault; a canvas written outside the KB via `--out` won't resolve
+its cards.
 
 ### Skills (Claude Code / Codex)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/llm-wiki",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Compile messy document directories into Karpathy-style llm_wiki knowledge bases — standalone Q&A CLI + Claude Code/Codex skills",
   "directories": {
     "test": "test"

package/src/scanner.mjs

@@ -33,8 +33,12 @@ function detectDomainMixture(files, kbRoot) {
   if (pages.length >= TAG_MIN_PAGES) {
     const counts = new Map()
     for (const p of pages) for (const t of new Set(p.data.tags)) counts.set(t, (counts.get(t) ?? 0) + 1)
-    const topShare = Math.max(...counts.values()) / pages.length
-    tags = { pages: pages.length, distinct: counts.size, topShare: Number(topShare.toFixed(2)), flagged: topShare < TAG_TOP_SHARE_MIN }
+    // Round once and flag on the rounded value so the stored/displayed share
+    // (CLI prints Math.round(topShare*100)) never reads "30%" while the strict
+    // `< TAG_TOP_SHARE_MIN` rule fired on a raw 0.29x. Effective threshold is
+    // 29.5%; negligible for an advisory heuristic, and flag/display now agree.
+    const topShare = Number((Math.max(...counts.values()) / pages.length).toFixed(2))
+    tags = { pages: pages.length, distinct: counts.size, topShare, flagged: topShare < TAG_TOP_SHARE_MIN }
   }
   return { language, tags, flagged: language.flagged || (tags?.flagged ?? false) }
 }