kandown 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.28.0 — 2026-07-20 — "Agent Instruction Modes & CLI Reference"
+
+- **Added**: **3 Base Agent Rule Modes (Verbose, Optimized, Caveman)** — redesigned the Agent instructions settings into 3 distinct rule density modes. Users can choose between **Verbose** (full reference guide), **Optimized** (concise, high-density structured rules tailored for LLMs), and **Caveman** (ultra-compact minimal token rules).
+- **Added**: **Quick CLI Commands Reference in Agent Rules** — added a concise CLI cheatsheet table (`kandown work`, `kandown list`, `kandown show`, `kandown create`, `kandown move`, `kandown assign`, `kandown commit`) right at the top of base rules across all modes so AI agents immediately know the native CLI commands available to interact with the board.
+- **Added**: **3-Step Numbered Layout for Agent Settings** — reorganized the Agent Instructions settings page into 3 clear numbered step cards: Step 1 (Base Rules mode & density), Step 2 (Project Guidelines stored in `.kandown/instructions.md`), and Step 3 (Live Board State data filters).
+- **Added**: **Quick Preset Instruction Chips** — added 1-click template insertion chips (`📦 pnpm`, `🧪 Test rule`, `🌳 Git rule`, `⚡ Task log`) below the project instructions editor for adding repository rules instantly.
+- **Added**: **Terminal-Style Sticky Live Preview Panel** — added an independent sticky preview panel on the right with window dot indicators, token estimation badge, layer legend badges (🟢 Step 1, 🟡 Step 2, 🔵 Step 3), 1-click Copy button, and real-time interactive color highlighting when hovering over options.
+
+## 0.27.1 — 2026-07-20 — "Auto-Updater & Daemon Process Upgrade"
+
+- **Fixed**: **Environment inheritance during background auto-update** — cleaned inherited `npm_config_*` and `npm_*` environment variables when spawning `npm install -g kandown` in `checkForUpdate()`. Previously, if Kandown was run via `npx` or `npm run`, inherited local prefix overrides could cause global background updates to fail or target a temporary cache.
+- **Fixed**: **Binary path resolution for system PATH and `~/.local/bin`** — updated `resolveKandownBin()` to check `which kandown`, `command -v kandown`, and `~/.local/bin/kandown` before checking package manager prefixes, ensuring custom global PATH installations are detected accurately.
+- **Fixed**: **Live daemon process upgrade on CLI update** — updated `refreshRunningProjectHtml()` so that background project daemon processes in RAM running older code are automatically stopped and relaunched with the newly updated CLI binary.
+
 ## 0.27.0 — 2026-07-20 — "Unified Views"
 
 - **Added**: **Full Component Parity between Board and List Views** — unified the List view (`ListView.tsx`) and Board view (`Column.tsx`) so that List view sections and task items share the exact same components, column background color tints, icons, and action options as Board columns.

package/bin/kandown.js

@@ -130,17 +130,27 @@ function getCurrentVersion() {
  * @returns {string|null} Absolute path to the kandown binary, or null.
  */
 function resolveKandownBin() {
+  try {
+    const whichBin = String(execSync('which kandown 2>/dev/null || command -v kandown 2>/dev/null', {
+      timeout: 3000, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
+    })).trim();
+    if (whichBin && existsSync(whichBin)) return whichBin;
+  } catch { /* ignore */ }
+  const localBin = join(homedir(), '.local', 'bin', 'kandown');
+  if (existsSync(localBin)) return localBin;
   try {
     const npmBin = String(execSync('npm config get prefix 2>/dev/null', {
       timeout: 3000, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
     })).trim();
     if (existsSync(join(npmBin, 'bin', 'kandown'))) return join(npmBin, 'bin', 'kandown');
+    if (existsSync(join(npmBin, 'kandown'))) return join(npmBin, 'kandown');
   } catch { /* npm not available */ }
   try {
     const pnpmBin = String(execSync('pnpm config get prefix 2>/dev/null', {
       timeout: 3000, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
     })).trim();
     if (existsSync(join(pnpmBin, 'bin', 'kandown'))) return join(pnpmBin, 'bin', 'kandown');
+    if (existsSync(join(pnpmBin, 'kandown'))) return join(pnpmBin, 'kandown');
   } catch { /* pnpm not available */ }
   return null;
 }
@@ -307,10 +317,16 @@ async function checkForUpdate(argv = process.argv) {
   const updateOk = await new Promise((resolve) => {
     const tryInstall = (cmd) => {
       return new Promise((res) => {
+        const cleanEnv = { ...process.env };
+        for (const k of Object.keys(cleanEnv)) {
+          if (k.startsWith('npm_config_') || k.startsWith('npm_') || k === 'INIT_CWD') {
+            delete cleanEnv[k];
+          }
+        }
         const child = spawn(cmd, ['install', '-g', 'kandown'], {
-          timeout: 45000,
+          timeout: 60000,
           stdio: ['pipe', 'pipe', 'pipe'],
-          env: { ...process.env },
+          env: cleanEnv,
           detached: false,
         });
         child.stderr.on('data', () => {}); // silence npm noise
@@ -1559,18 +1575,32 @@ function priorityRank(p) {
 }
 
 const WORK_OUTPUT_SECTION_IDS = ['baseRules', 'projectInstructions', 'boardDigest'];
-const CONCISE_AGENT_RULES = `# Kandown agent rules — concise
+const OPTIMIZED_AGENT_RULES = `# Kandown agent rules
+
+## CLI Commands
+- \`kandown list\` (list tasks) · \`kandown show <id>\` (view task)
+- \`kandown create "<title>"\` (create task) · \`kandown move <id> <status>\` (move task column)
+- \`kandown assign <id> <user>\` · \`kandown commit\` (commit board to git)
 
+## Rules
 - Task state lives in project-root \`tasks/*.md\`; do not maintain a separate board index.
 - Before work, read the relevant task file and keep it updated while you progress.
 - Move tasks by editing frontmatter \`status:\`; complete work by setting \`status: Done\` and adding a markdown \`report:\` summary.
 - Update subtasks in-place: \`- [ ]\` → \`- [x]\`, with a short \`report:\` line for meaningful progress.
 - Board columns live in \`.kandown/kandown.json\` under \`board.columns\`; project instructions live in \`.kandown/instructions.md\`.
 - Never put Kandown task data inside \`.kandown/\`; tasks belong in \`./tasks/\`.`;
+
+const CAVEMAN_AGENT_RULES = `# Kandown agent rules
+
+CLI: kandown list | kandown show <id> | kandown create "<title>" | kandown move <id> <status> | kandown assign <id> <user> | kandown commit
+RULES: TASKS IN ./tasks/*.md. READ TASK BEFORE WORK. UPDATE SUBTASKS - [ ] -> - [x] + REPORT. MOVE: EDIT status:. DONE: status: Done + report:.`;
+
+const CONCISE_AGENT_RULES = OPTIMIZED_AGENT_RULES;
+
 const DEFAULT_WORK_OUTPUT = {
   mode: 'blocks',
   includeBaseRules: true,
-  baseRulesMode: 'full',
+  baseRulesMode: 'verbose',
   includeProjectInstructions: true,
   includeBoardDigest: true,
   sectionOrder: WORK_OUTPUT_SECTION_IDS,
@@ -1596,11 +1626,13 @@ function normalizeWorkOutputConfig(config) {
     ? raw.sectionOrder.filter(id => WORK_OUTPUT_SECTION_IDS.includes(id))
     : DEFAULT_WORK_OUTPUT.sectionOrder;
   const order = sectionOrder.length > 0 ? sectionOrder : DEFAULT_WORK_OUTPUT.sectionOrder;
+  const validBaseModes = ['verbose', 'optimized', 'caveman', 'full', 'concise'];
+  const baseMode = validBaseModes.includes(raw.baseRulesMode) ? raw.baseRulesMode : DEFAULT_WORK_OUTPUT.baseRulesMode;
   return {
     ...DEFAULT_WORK_OUTPUT,
     ...raw,
     mode: raw.mode === 'raw' ? 'raw' : 'blocks',
-    baseRulesMode: raw.baseRulesMode === 'concise' ? 'concise' : 'full',
+    baseRulesMode: baseMode,
     sectionOrder: order,
     rawTemplate: typeof raw.rawTemplate === 'string' && raw.rawTemplate.trim()
       ? raw.rawTemplate
@@ -1609,8 +1641,9 @@ function normalizeWorkOutputConfig(config) {
   };
 }
 
-function readBaseAgentRules(mode = 'full') {
-  if (mode === 'concise') return CONCISE_AGENT_RULES;
+function readBaseAgentRules(mode = 'verbose') {
+  if (mode === 'caveman') return CAVEMAN_AGENT_RULES;
+  if (mode === 'optimized' || mode === 'concise') return OPTIMIZED_AGENT_RULES;
   try {
     return readFileSync(join(PKG_ROOT, 'templates', 'AGENT_KANDOWN.md'), 'utf8').trim();
   } catch (e) {
@@ -1926,10 +1959,19 @@ async function refreshRunningProjectHtml() {
       .filter(dir => typeof dir === 'string' && dir.length > 0)
   );
 
+  const currentVersion = getCurrentVersion();
   let refreshed = 0;
   for (const kandownDir of kandownDirs) {
     try {
       if (refreshKandownHtml(kandownDir)) 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);
+        }
+      }
     } catch { /* best-effort: one locked project must not block restart */ }
   }
   return refreshed;