kandown 0.28.1 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.30.0 — 2026-07-21 — "Fable UI Themes"
+
+- **Added**: **Customizable JSON Theme Engine (`KandownTheme`)** — upgraded Kandown's skin system from 5 hardcoded HSL presets to an open, JSON-driven theme engine with dynamic inheritance (`base`), fallback safety, and runtime custom theme registration (`registerCustomThemes`).
+- **Added**: **8 Curated Built-in Presets** — introduced 8 design presets in `src/lib/theme.ts`:
+  - ⚡ **Vercel**: Monochrome contrast, tight typography, 6px radius, sharp 1px borders, zero shadows.
+  - 📐 **Linear**: Dark-first (`#08090A`), electric violet (`#5E6AD2`), 8px radius, glass header, soft popover shadows.
+  - 🧡 **Claude**: Editorial warmth, oat crème (`#F5F1EA`), terracotta accent (`#D97757`), Charter serif display font, 12px radius, soft diffuse shadows.
+  - 🍎 **Apple**: Translucent materials (`rgba(255,255,255,0.72)` + backdrop blur), SF system font, 14px squircle radius, multi-layer elevated shadows.
+  - 💳 **Stripe**: Indigo night (`#0A0A23`), blurple accent (`#635BFF`), 8px radius, soft colored glow shadows.
+  - 📄 **Paper**: Notion-style calm studio, `#F7F6F3` light, `#191919` dark, pastel tags, 4px radius, no shadows.
+  - 🧛 **Catppuccin**: Official Mocha (`#1E1E2E` mauve `#CBA6F7`) and Latte palettes.
+  - 🖥️ **Terminal**: CRT homage to TUI, `#0C0C0C` background, `#33FF66` phosphor green text, SF Mono everywhere, 0px radius.
+- **Added**: **Theme Gallery with Live Mini-Board Previews** — replaced static color swatches in Settings with an interactive gallery of `ThemePreviewCard` components rendering isolated live 3-column kanban board previews using each theme's unique HSL tokens, radius, fonts, and shadows.
+- **Added**: **Visual Theme Editor Modal (`ThemeCustomizerModal`)** — added a visual customization drawer for creating and tweaking custom JSON themes with sliders for border radius (0–24px), shadow elevation levels (`none`, `soft`, `elevated`, `dramatic`), density, motion scale, glassmorphism, and live HSL token pickers.
+- **Added**: **Live WCAG 2.1 Contrast Ratio Calculator** — added real-time relative luminance calculation in the theme editor showing an active WCAG AA contrast ratio badge (warning when ratio < 4.5:1).
+- **Added**: **JSON Import & Export** — added direct theme JSON view/edit panel with 1-click clipboard copy for sharing and storing custom themes.
+- **Added**: **`ui.customThemes` Config Support** — custom user themes are automatically persisted in `kandown.json` under `ui.customThemes` and loaded seamlessly on startup.
+- **Changed**: **Appearance CSS Tokens & Design Refinements** — introduced `--radius`, `--shadow-*`, `--font-display`, `--motion-scale`, `--card-blur` variables into `:root` and mapped them to `tailwind.config.js` (`borderRadius`, `fontFamily.display`). Refined base body typography scale to 15px, unified focus rings (`:focus-visible`), and added smooth light/dark root transitions.
+
+## 0.29.0 — 2026-07-20 — "Global Daemon Refresh"
+
+- **Added**: **Global daemon refresh command** — added `kandown daemon refresh-all`, which scans every active local Kandown daemon across the configured port range, refreshes each open project's `.kandown/kandown.html`, and restarts any daemon running an older CLI version.
+- **Added**: **Forced daemon reboot aliases** — added `kandown daemon restart-all` and `kandown daemon refresh-all --force` for cases where every open Kandown daemon should be restarted, even when versions already match.
+- **Changed**: **Safer post-update refresh flow** — refactored the existing auto-update refresh path to reuse the same daemon scan/restart helper, keeping automatic package-update behavior aligned with the new explicit global command.
+- **Changed**: **Daemon CLI documentation** — updated CLI help and the README command table to surface `daemon refresh-all` as the recommended fix when old project sessions remain open after a global update.
+- **Fixed**: **Outdated open project daemons after global updates** — users no longer need to manually find and restart each project when a global Kandown update succeeds but already-running daemons continue serving older code in memory.
+
 ## 0.28.1 — 2026-07-20 — "Robust Global Auto-Updater"
 
 - **Fixed**: **Global package manager auto-update commands** — updated `checkForUpdate()` and `cmdUpdate()` to run `pnpm add -g kandown@latest` (instead of `pnpm install -g kandown`), with fallback chain across `pnpm`, `npm`, `yarn`, and `bun`.

package/README.md

@@ -91,6 +91,7 @@ The web daemon stays alive after you quit the TUI so the browser keeps working.
 | `kandown daemon status` | Show this project's web daemon status |
 | `kandown daemon start` | Start/reconnect this project's web daemon |
 | `kandown daemon stop` | Stop this project's web daemon |
+| `kandown daemon refresh-all` | Refresh open projects and restart outdated daemons with the current CLI version |
 | `kandown update` | Update `kandown.html` to latest |
 | `kandown list` \| `show` \| `create` \| `move` \| `assign` \| `commit` | One-shot task commands (see below) |
 | `kandown tasks` | Full help for the one-shot task commands |

package/bin/kandown.js

@@ -574,7 +574,7 @@ ${c.bold}Commands:${c.reset}
   ${c.cyan}board${c.reset}       Open the interactive kanban board in the terminal
   ${c.cyan}init${c.reset}        Initialize .kandown/ in the current directory
   ${c.cyan}settings${c.reset}    Open the settings TUI
-  ${c.cyan}daemon${c.reset}      Manage the per-project web daemon (start|stop|status)
+  ${c.cyan}daemon${c.reset}      Manage web daemons (start|stop|status|refresh-all)
   ${c.cyan}update${c.reset}      Update kandown.html to the latest version
   ${c.cyan}list${c.reset}        List tasks ${c.dim}(-s status, -a assignee, -t tag, -p priority, --json)${c.reset}
   ${c.cyan}show${c.reset}        Print a task's raw file content
@@ -594,6 +594,7 @@ ${c.bold}Examples:${c.reset}
   ${c.dim}$${c.reset} npx kandown --port 3000  ${c.dim}# use a specific web UI port${c.reset}
   ${c.dim}$${c.reset} npx kandown board        ${c.dim}# board TUI only${c.reset}
   ${c.dim}$${c.reset} npx kandown daemon stop  ${c.dim}# stop this project's web daemon${c.reset}
+  ${c.dim}$${c.reset} npx kandown daemon refresh-all ${c.dim}# refresh/restart outdated open daemons${c.reset}
   ${c.dim}$${c.reset} npx kandown init
   ${c.dim}$${c.reset} npx kandown init --path docs/kanban
   ${c.dim}$${c.reset} npx kandown init --no-agents
@@ -1946,35 +1947,62 @@ function refreshKandownHtml(kandownDir) {
   return false;
 }
 
-async function refreshRunningProjectHtml() {
+function daemonScanPorts() {
   const ports = [];
   for (let port = START_PORT_RANGE; port <= END_PORT_RANGE; port++) {
     if (!isBrowserUnsafePort(port)) ports.push(port);
   }
+  return ports;
+}
 
-  const daemons = await Promise.all(ports.map(port => fetchDaemonInfo(port)));
-  const kandownDirs = new Set(
-    daemons
-      .map(daemon => daemon?.kandownDir)
-      .filter(dir => typeof dir === 'string' && dir.length > 0)
-  );
+async function listRunningDaemons() {
+  const daemons = await Promise.all(daemonScanPorts().map(port => fetchDaemonInfo(port)));
+  const byDir = new Map();
+  for (const daemon of daemons) {
+    if (!daemon || typeof daemon.kandownDir !== 'string' || daemon.kandownDir.length === 0) continue;
+    if (!byDir.has(daemon.kandownDir)) byDir.set(daemon.kandownDir, daemon);
+  }
+  return [...byDir.values()];
+}
 
+async function refreshRunningDaemons({ forceRestart = false } = {}) {
+  const daemons = await listRunningDaemons();
   const currentVersion = getCurrentVersion();
-  let refreshed = 0;
-  for (const kandownDir of kandownDirs) {
+  const results = {
+    found: daemons.length,
+    refreshed: 0,
+    restarted: 0,
+    skipped: 0,
+    failed: [],
+  };
+
+  for (const daemon of daemons) {
+    const kandownDir = daemon.kandownDir;
     try {
-      if (refreshKandownHtml(kandownDir)) refreshed++;
+      if (refreshKandownHtml(kandownDir)) results.refreshed++;
       const current = await getDaemonStatus(kandownDir);
-      if (current.running) {
-        const daemonVersion = current.metadata?.version || null;
-        if (!daemonVersion || (currentVersion && semverGt(currentVersion, daemonVersion) > 0)) {
-          await stopDaemon(kandownDir);
-          await startDaemon(kandownDir, current.metadata?.port || null);
-        }
+      const daemonVersion = daemon.version || current.metadata?.version || null;
+      const shouldRestart = forceRestart || !daemonVersion || (currentVersion && semverGt(currentVersion, daemonVersion) > 0);
+      if (!shouldRestart) {
+        results.skipped++;
+        continue;
       }
-    } catch { /* best-effort: one locked project must not block restart */ }
+      const preferredPort = daemon.port || current.metadata?.port || null;
+      await stopDaemon(kandownDir);
+      const restarted = await startDaemon(kandownDir, preferredPort);
+      if (!restarted.running) throw new Error('daemon failed to restart');
+      results.restarted++;
+    } catch (e) {
+      results.failed.push({ kandownDir, error: e.message });
+    }
   }
-  return refreshed;
+
+  return results;
+}
+
+async function refreshRunningProjectHtml() {
+  const results = await refreshRunningDaemons({ forceRestart: false });
+  return results.refreshed;
 }
 
 async function waitForDaemon(kandownDir, timeoutMs = 8000) {
@@ -2978,6 +3006,21 @@ function detectStaleKandown(port, currentKandownDir) {
 
 async function cmdDaemon(rawArgs) {
   const [subcommand = 'status', ...rest] = rawArgs;
+
+  if (subcommand === 'refresh-all' || subcommand === 'restart-all') {
+    const forceRestart = rest.includes('--force') || subcommand === 'restart-all';
+    const results = await refreshRunningDaemons({ forceRestart });
+    success(`Scanned ${results.found} running daemon${results.found === 1 ? '' : 's'}`);
+    info(`Refreshed ${results.refreshed} kandown.html bundle${results.refreshed === 1 ? '' : 's'}`);
+    info(`${forceRestart ? 'Restarted' : 'Restarted outdated'} ${results.restarted} daemon${results.restarted === 1 ? '' : 's'}`);
+    if (!forceRestart && results.skipped > 0) info(`Skipped ${results.skipped} already-current daemon${results.skipped === 1 ? '' : 's'}`);
+    if (results.failed.length > 0) {
+      for (const failure of results.failed) warn(`${failure.kandownDir}: ${failure.error}`);
+      process.exit(1);
+    }
+    return;
+  }
+
   const { kandownDir } = ensureKandownDir(rest);
   const preferredPort = parsePort(parseArgs(rest).port);
 
@@ -3039,7 +3082,7 @@ async function cmdDaemon(rawArgs) {
   }
 
   err(`Unknown daemon command: ${subcommand}`);
-  log(`  Use ${c.cyan}kandown daemon start|stop|status${c.reset}`);
+  log(`  Use ${c.cyan}kandown daemon start|stop|status|refresh-all${c.reset}`);
   process.exit(1);
 }