kandown 0.24.0 → 0.25.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.25.1 — 2026-07-20 — "Stale Daemon Refresh"
+
+- **Fixed**: **Deep-link refreshes after existing daemon sessions** — Kandown now detects when a project daemon was started by an older CLI version and restarts it when the current CLI is newer. This matters because URL refresh handling for paths like `/058?p=suzu` lives in the daemon process itself; refreshing `kandown.html` alone cannot teach an already-running old daemon to serve task deep-link routes.
+- **Fixed**: **Direct task URLs no longer require manual daemon restarts after updates** — running `kandown` or `kandown daemon start` now upgrades stale daemon processes automatically, so newly published routing behavior becomes active for existing projects without users needing to hunt for old PIDs.
+- **Changed**: **Daemon reconnect behavior** — reconnecting to a same-project daemon still reuses compatible current/newer daemons, but older or unknown-version daemons are stopped and relaunched with the current CLI before returning the daemon URL.
+
+## 0.25.0 — 2026-07-20 — "Task Deep Links"
+
+- **Added**: **Shareable task deep links** — opening a task drawer now updates the browser URL to a copy-pasteable route such as `/210?p=kandown`, where numeric task segments are normalized to Kandown task ids like `t210`. This makes it possible to send a direct link to a specific task instead of asking someone to find it manually on the board.
+- **Added**: **Direct URL hydration for task drawers** — pasted links are parsed on web app startup and after browser navigation. Kandown now accepts the canonical `/210?p=kandown` format plus tolerant alternatives such as `/t210?p=kandown`, `?task=210`, and `?p=kandown/210`, then opens the matching drawer once the project is loaded.
+- **Added**: **Browser history support for task navigation** — drawer open and close actions now synchronize with `pushState`/`replaceState`, and Kandown listens for `popstate` so browser Back and Forward switch between board-only and task-focused URLs instead of leaving stale drawer state behind.
+- **Added**: **Copy URL action in the task drawer** — the opened task header now includes a lightweight Copy URL control that writes the absolute task link to the clipboard, with a toast fallback that displays the URL if clipboard access is denied.
+- **Fixed**: **Daemon routing for deep links** — the local web daemon now serves the single-page app for safe one-segment task paths like `/210`, preventing direct task URLs from returning `404 Not found` before React has a chance to hydrate and open the drawer.
+- **Changed**: **Project URL handling** — board/project URLs now go through shared URL helpers so project-only navigation keeps `/?p=<project>` while task navigation cleanly adds or removes the task path segment.
+- **Changed**: **Board housekeeping** — completed Kandown task files were archived or removed from the active task set, new backlog tasks were added for upcoming archive/subtask/opened-task redesign work, and local board config/runtime ignore files were updated to match the current project workflow.
+
 ## 0.24.0 — 2026-07-20 — "Work Output Configurator"
 
 - **Added**: **`kandown work` Output Configurator** — added a new Settings panel under Agent configuration that lets each project control the markdown emitted by `kandown work`. Users can enable or disable the base rules, project instructions, and live board digest blocks without editing generated files by hand.

package/bin/kandown.js

@@ -1987,7 +1987,21 @@ function releaseDaemonSpawnLock(lockPath) {
 
 async function startDaemon(kandownDir, preferredPort) {
   const current = await getDaemonStatus(kandownDir);
-  if (current.running) return current;
+  if (current.running) {
+    const currentVersion = getCurrentVersion();
+    const daemonVersion = current.metadata?.version || null;
+    // 📖 Deep-link routes and other daemon-owned behavior live in the long-running
+    // daemon process, not in kandown.html. If the CLI updated while a daemon was
+    // already running, reconnecting to the old process keeps old routing alive
+    // (e.g. refreshing `/058?p=suzu` returned 404). Restart only when the local
+    // CLI is newer; newer/dev daemons are left untouched.
+    if (!daemonVersion || semverGt(currentVersion, daemonVersion) > 0) {
+      warn(`Restarting daemon v${daemonVersion || 'unknown'} → v${currentVersion}...`);
+      await stopDaemon(kandownDir);
+    } else {
+      return current;
+    }
+  }
 
   const lock = acquireDaemonSpawnLock(kandownDir);
   if (!lock) {
@@ -2726,6 +2740,15 @@ function serveStaticAsset(req, res, pathname) {
   return false;
 }
 
+function isTaskDeepLinkPath(pathname) {
+  try {
+    const cleaned = decodeURIComponent(pathname).replace(/^\/+|\/+$/g, '');
+    return !!cleaned && !cleaned.includes('/') && !cleaned.includes('.') && /^[A-Za-z0-9_-]+$/.test(cleaned);
+  } catch {
+    return false;
+  }
+}
+
 function createServeServer(kandownDir) {
   try {
     const tasksDir = getTasksDir(kandownDir);
@@ -2750,6 +2773,7 @@ function createServeServer(kandownDir) {
       return handleApi(req, res, requestUrl, kandownDir);
     }
     if (serveStaticAsset(req, res, requestUrl.pathname)) return;
+    if (req.method === 'GET' && isTaskDeepLinkPath(requestUrl.pathname)) return serveApp(res, kandownDir);
     return writeText(res, 404, 'Not found');
   });
 }