kandown 0.27.1 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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.

package/bin/kandown.js

@@ -1575,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,
@@ -1612,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
@@ -1625,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) {