kanban-lite 1.0.21 → 1.0.23

package/{CLAUDE.md → AGENTS.md}

@@ -41,6 +41,17 @@ npm test                   # Run tests (vitest)
 
 All three interfaces (API, CLI, MCP) support the same operations: cards CRUD, columns CRUD, settings get/update, webhooks CRUD, workspace info. When adding new functionality, add it to all three.
 
+## Implementation Order
+
+Always follow this order when adding or modifying any feature:
+
+1. **SDK first** — implement the core logic in `src/sdk/KanbanSDK.ts` (or supporting SDK files) with full JSDoc comments before touching any interface layer.
+2. **API** — add or update the corresponding REST endpoint(s) in `src/standalone/server.ts`.
+3. **CLI** — add or update the command in `src/cli/index.ts`.
+4. **MCP** — add or update the tool definition in `src/mcp-server/index.ts`.
+
+Never implement a feature directly in an interface layer without the SDK method existing first. The SDK is the single source of truth for all business logic.
+
 ## Data Storage
 
 - Cards: `.kanban/{status}/card-name-YYYY-MM-DD.md` (markdown with YAML frontmatter)
@@ -73,6 +84,8 @@ metadata:
 
 - **JSDoc:** Always update JSDoc comments when changing any logic, parameters, return types, or behavior of functions, methods, interfaces, or types. JSDoc is the source of truth for `docs/sdk.md`.
 - **Generated docs:** `docs/api.md`, `docs/sdk.md`, and `docs/webhooks.md` are autogenerated. Never edit them manually. Update the source (JSDoc for SDK, route metadata in `scripts/generate-api-docs.ts` for API, `scripts/generate-webhooks-docs.ts` for webhooks) and run `npm run docs` to regenerate.
+- **README.md:** Always update `README.md` when adding or modifying user-facing features. Update the relevant Features section, configuration examples, CLI usage examples, REST API tables, and MCP tool table as appropriate.
+- **CHANGELOG.md:** Always add an entry to `CHANGELOG.md` for every new feature, behaviour change, or bug fix. Place it under an `## [Unreleased]` section at the top (or the current in-progress version block). Follow the existing format: `### Added`, `### Changed`, `### Fixed` subsections with concise bullet points.
 
 ## Conventions
 

package/CHANGELOG.md

@@ -5,6 +5,74 @@ All notable changes to the Kanban Lite extension will be documented in this file
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.0] - 2026-02-27
+
+### Added
+- Board and card detail zoom settings with slider UI (75–150%) stored in `.kanban.json`
+- Keyboard shortcuts for adjusting board/card zoom level (Ctrl/Cmd `+`/`-`)
+- CSS custom properties (`--board-zoom`, `--card-zoom`) with `calc()` multipliers for smooth font scaling
+- Smooth scrolling to the selected feature card in the kanban board
+- Sorting options in the column context menu
+- Default zoom level configuration for both board and card detail views
+
+## [2.0.0] - 2026-02-26
+
+### Added
+- Per-card actions (named string labels) that trigger a global `actionWebhookUrl` via `POST` on demand
+- Run Actions dropdown in the card editor and action input in CreateFeatureDialog
+- `triggerAction` method in KanbanSDK with full support across REST API, WebSocket, MCP (`trigger_action` tool), and CLI (`--actions` flag)
+- Comment editor component with Write / Preview tabs and a markdown formatting toolbar
+- GitHub-style comment editing using the new CommentEditor in CommentsSection
+- Settings panel split into three tabs: **General**, **Defaults**, and **Labels**
+- `version` field on card frontmatter schema for format tracking
+- Metadata filtering for card list/search operations across all interfaces
+- Creation and modification date display with hover tooltips on FeatureCard and FeatureEditor
+- Sort order filter for card queries
+
+### Fixed
+- `version` field now included in all FeatureFrontmatter constructions in the server
+
+## [1.9.0] - 2026-02-25
+
+### Added
+- Card metadata support — arbitrary key-value data stored as a native YAML block in frontmatter (`metadata` field)
+- Metadata UI: key-count chip `{N}` on card grid and collapsible tree view in the card detail panel
+- Label definitions with color picker in the Settings panel (create, rename, delete labels)
+- Colored labels rendered on cards, in the editor, create dialog, and toolbar
+- Label group filtering across SDK (`filterCardsByLabelGroup`), CLI (`--label-group`), REST API, and MCP tools
+- SDK label management methods: `getLabels`, `setLabel`, `renameLabel`, `deleteLabel`
+- Soft-delete support: hidden **Deleted** column with per-card restore or permanent delete
+- Purge deleted cards functionality to permanently remove all soft-deleted cards
+- `--metadata` flag for CLI `create` and `edit` commands (accepts JSON string)
+- Metadata support in MCP `create_card` and `update_card` tools
+- Metadata support in REST API create/update routes
+- Workspace info section in the Settings panel showing project path and `.kanban.json` parameters
+- `js-yaml` dependency for robust YAML metadata parsing
+
+### Fixed
+- Comment parser no longer breaks on horizontal rules (`---`) inside comment blocks
+- Blank lines in metadata YAML parsed correctly; scalar edge cases handled
+
+## [1.8.0] - 2026-02-24
+
+### Added
+- Multi-board support: board selector dropdown to switch between boards and create new boards
+- Card transfer between boards via a StatusDropdown with a nested board-and-column tree
+- `transferCard` message type and `BoardInfo.columns` field in the extension/standalone protocol
+- Webhooks system: CRUD operations (`create`, `get`, `update`, `delete`, `list`) stored in `.kanban-webhooks.json`
+- Webhook event delivery on card create/update/delete/move with configurable `url`, `events`, and `secret`
+- Webhook management commands in CLI and MCP server
+- Comments functionality: add, edit, and delete comments on feature cards
+- Markdown rendering for comment content
+- Auto-generated SDK docs (`docs/sdk.md`) and REST API docs (`docs/api.md`) from JSDoc / route metadata
+- `npm run docs` script to regenerate all documentation
+- Theme toggle (light / dark) in the board toolbar
+- Release scripts for versioning, changelog generation, and GitHub release creation
+
+### Fixed
+- SDK export paths updated to support both CommonJS and ESM module formats
+- SDK import paths corrected; server feature loading logic improved
+
 ## [1.7.0] - 2026-02-20
 
 ### Added

package/README.md

@@ -44,10 +44,16 @@ kl add --title "My first task" --priority high
 - **Layout toggle**: Switch between horizontal and vertical board layouts
 - **Real-time updates**: WebSocket-powered live sync across clients
 - **Light & dark mode** support
+- **Tabbed settings panel**: Settings organized into **General**, **Defaults**, and **Labels** tabs
+- **Zoom controls**: Scale the board view and card detail panel independently between 75–150% via settings sliders or keyboard shortcuts
+- **Column sorting**: Sort cards within a column by priority, due date, or creation date from the column menu
+- **Smooth scroll to selection**: Board automatically scrolls to the selected card when switching features
 - **Keyboard shortcuts**:
   - `N` - Create new feature
   - `Esc` - Close dialogs
   - `Cmd/Ctrl + Enter` - Submit create dialog
+  - `Ctrl/Cmd + =` / `Ctrl/Cmd + -` - Zoom board view in / out
+  - `Ctrl/Cmd + Shift + =` / `Ctrl/Cmd + Shift + -` - Zoom card detail in / out
 
 ### Feature Cards
 
@@ -628,12 +634,16 @@ Board configuration is stored in `.kanban.json` at your project root. It support
   "showDueDate": true,
   "showLabels": true,
   "compactMode": false,
+  "boardZoom": 100,
+  "cardZoom": 100,
   "actionWebhookUrl": "https://example.com/kanban-actions"
 }
 ```
 
 Columns are fully customizable per board — add, remove, rename, or recolor them from the web UI, CLI, or REST API.
 
+`boardZoom` and `cardZoom` set the default zoom percentage (75–150) for the board view and card detail panel respectively. They can also be adjusted live in the Settings panel or with `Ctrl/Cmd + =` / `Ctrl/Cmd + -` keyboard shortcuts.
+
 ## AI Agent Integration
 - **Claude Code**: Default, Plan, Auto-edit, and Full Auto modes
 - **Codex**: Suggest, Auto-edit, and Full Auto modes

package/dist/cli.js

@@ -330,6 +330,8 @@ function migrateConfigV1ToV2(raw) {
     compactMode: v1.compactMode,
     markdownEditorMode: v1.markdownEditorMode,
     showDeletedColumn: false,
+    boardZoom: 100,
+    cardZoom: 100,
     port: 3e3
   };
 }
@@ -403,7 +405,9 @@ function configToSettings(config) {
     markdownEditorMode: config.markdownEditorMode,
     showDeletedColumn: config.showDeletedColumn,
     defaultPriority: config.defaultPriority,
-    defaultStatus: config.defaultStatus
+    defaultStatus: config.defaultStatus,
+    boardZoom: config.boardZoom ?? 100,
+    cardZoom: config.cardZoom ?? 100
   };
 }
 function settingsToConfig(config, settings) {
@@ -417,7 +421,9 @@ function settingsToConfig(config, settings) {
     compactMode: settings.compactMode,
     showDeletedColumn: settings.showDeletedColumn,
     defaultPriority: settings.defaultPriority,
-    defaultStatus: settings.defaultStatus
+    defaultStatus: settings.defaultStatus,
+    boardZoom: settings.boardZoom,
+    cardZoom: settings.cardZoom
   };
 }
 var fs, path, DEFAULT_BOARD_CONFIG, DEFAULT_CONFIG, CONFIG_FILENAME;
@@ -453,6 +459,8 @@ var init_config = __esm({
       compactMode: false,
       markdownEditorMode: false,
       showDeletedColumn: false,
+      boardZoom: 100,
+      cardZoom: 100,
       port: 3e3,
       labels: {}
     };
@@ -2714,7 +2722,7 @@ function renamed(from, to) {
     throw new Error("Function yaml." + from + " is removed in js-yaml 4. Use yaml." + to + " instead, which is now safe by default.");
   };
 }
-var isNothing_1, isObject_1, toArray_1, repeat_1, isNegativeZero_1, extend_1, common, exception, snippet, TYPE_CONSTRUCTOR_OPTIONS, YAML_NODE_KINDS, type, schema, str, seq, map, failsafe, _null, bool, int, YAML_FLOAT_PATTERN, SCIENTIFIC_WITHOUT_DOT, float, json, core, YAML_DATE_REGEXP, YAML_TIMESTAMP_REGEXP, timestamp, merge, BASE64_MAP, binary, _hasOwnProperty$3, _toString$2, omap, _toString$1, pairs, _hasOwnProperty$2, set, _default, _hasOwnProperty$1, CONTEXT_FLOW_IN, CONTEXT_FLOW_OUT, CONTEXT_BLOCK_IN, CONTEXT_BLOCK_OUT, CHOMPING_CLIP, CHOMPING_STRIP, CHOMPING_KEEP, PATTERN_NON_PRINTABLE, PATTERN_NON_ASCII_LINE_BREAKS, PATTERN_FLOW_INDICATORS, PATTERN_TAG_HANDLE, PATTERN_TAG_URI, simpleEscapeCheck, simpleEscapeMap, i, directiveHandlers, loadAll_1, load_1, loader, _toString, _hasOwnProperty, CHAR_BOM, CHAR_TAB, CHAR_LINE_FEED, CHAR_CARRIAGE_RETURN, CHAR_SPACE, CHAR_EXCLAMATION, CHAR_DOUBLE_QUOTE, CHAR_SHARP, CHAR_PERCENT, CHAR_AMPERSAND, CHAR_SINGLE_QUOTE, CHAR_ASTERISK, CHAR_COMMA, CHAR_MINUS, CHAR_COLON, CHAR_EQUALS, CHAR_GREATER_THAN, CHAR_QUESTION, CHAR_COMMERCIAL_AT, CHAR_LEFT_SQUARE_BRACKET, CHAR_RIGHT_SQUARE_BRACKET, CHAR_GRAVE_ACCENT, CHAR_LEFT_CURLY_BRACKET, CHAR_VERTICAL_LINE, CHAR_RIGHT_CURLY_BRACKET, ESCAPE_SEQUENCES, DEPRECATED_BOOLEANS_SYNTAX, DEPRECATED_BASE60_SYNTAX, QUOTING_TYPE_SINGLE, QUOTING_TYPE_DOUBLE, STYLE_PLAIN, STYLE_SINGLE, STYLE_LITERAL, STYLE_FOLDED, STYLE_DOUBLE, dump_1, dumper, load, loadAll, dump, safeLoad, safeLoadAll, safeDump;
+var isNothing_1, isObject_1, toArray_1, repeat_1, isNegativeZero_1, extend_1, common, exception, snippet, TYPE_CONSTRUCTOR_OPTIONS, YAML_NODE_KINDS, type, schema, str, seq, map, failsafe, _null, bool, int, YAML_FLOAT_PATTERN, SCIENTIFIC_WITHOUT_DOT, float, json, core, YAML_DATE_REGEXP, YAML_TIMESTAMP_REGEXP, timestamp, merge, BASE64_MAP, binary, _hasOwnProperty$3, _toString$2, omap, _toString$1, pairs, _hasOwnProperty$2, set, _default, _hasOwnProperty$1, CONTEXT_FLOW_IN, CONTEXT_FLOW_OUT, CONTEXT_BLOCK_IN, CONTEXT_BLOCK_OUT, CHOMPING_CLIP, CHOMPING_STRIP, CHOMPING_KEEP, PATTERN_NON_PRINTABLE, PATTERN_NON_ASCII_LINE_BREAKS, PATTERN_FLOW_INDICATORS, PATTERN_TAG_HANDLE, PATTERN_TAG_URI, simpleEscapeCheck, simpleEscapeMap, i, directiveHandlers, loadAll_1, load_1, loader, _toString, _hasOwnProperty, CHAR_BOM, CHAR_TAB, CHAR_LINE_FEED, CHAR_CARRIAGE_RETURN, CHAR_SPACE, CHAR_EXCLAMATION, CHAR_DOUBLE_QUOTE, CHAR_SHARP, CHAR_PERCENT, CHAR_AMPERSAND, CHAR_SINGLE_QUOTE, CHAR_ASTERISK, CHAR_COMMA, CHAR_MINUS, CHAR_COLON, CHAR_EQUALS, CHAR_GREATER_THAN, CHAR_QUESTION, CHAR_COMMERCIAL_AT, CHAR_LEFT_SQUARE_BRACKET, CHAR_RIGHT_SQUARE_BRACKET, CHAR_GRAVE_ACCENT, CHAR_LEFT_CURLY_BRACKET, CHAR_VERTICAL_LINE, CHAR_RIGHT_CURLY_BRACKET, ESCAPE_SEQUENCES, DEPRECATED_BOOLEANS_SYNTAX, DEPRECATED_BASE60_SYNTAX, QUOTING_TYPE_SINGLE, QUOTING_TYPE_DOUBLE, STYLE_PLAIN, STYLE_SINGLE, STYLE_LITERAL, STYLE_FOLDED, STYLE_DOUBLE, dump_1, dumper, JSON_SCHEMA, load, loadAll, dump, safeLoad, safeLoadAll, safeDump;
 var init_js_yaml = __esm({
   "node_modules/js-yaml/dist/js-yaml.mjs"() {
     isNothing_1 = isNothing;
@@ -3115,6 +3123,7 @@ var init_js_yaml = __esm({
     dumper = {
       dump: dump_1
     };
+    JSON_SCHEMA = json;
     load = loader.load;
     loadAll = loader.loadAll;
     dump = dumper.dump;
@@ -3155,48 +3164,26 @@ function parseFeatureFile(content, filePath) {
     return null;
   const frontmatter = frontmatterMatch[1];
   const rest = frontmatterMatch[2] || "";
-  const getValue = (key) => {
-    const match = frontmatter.match(new RegExp(`^${key}:\\s*(.*)$`, "m"));
-    if (!match)
+  let parsed;
+  try {
+    const loaded = load(frontmatter, { schema: JSON_SCHEMA });
+    if (!loaded || typeof loaded !== "object" || Array.isArray(loaded))
+      return null;
+    parsed = loaded;
+  } catch {
+    return null;
+  }
+  const str2 = (key) => {
+    const val = parsed[key];
+    if (val == null)
       return "";
-    const value = match[1].trim().replace(/^["']|["']$/g, "");
-    return value === "null" ? "" : value;
+    return String(val);
   };
-  const getArrayValue = (key) => {
-    const match = frontmatter.match(new RegExp(`^${key}:\\s*\\[([^\\]]*)\\]`, "m"));
-    if (!match)
+  const arr = (key) => {
+    const val = parsed[key];
+    if (!Array.isArray(val))
       return [];
-    return match[1].split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
-  };
-  const getMetadata = () => {
-    const lines = frontmatter.split("\n");
-    let metaStart = -1;
-    for (let j = 0; j < lines.length; j++) {
-      if (/^metadata:\s*$/.test(lines[j])) {
-        metaStart = j + 1;
-        break;
-      }
-    }
-    if (metaStart === -1)
-      return void 0;
-    const indentedLines = [];
-    for (let j = metaStart; j < lines.length; j++) {
-      if (/^\s/.test(lines[j]) || lines[j].trim() === "") {
-        indentedLines.push(lines[j]);
-      } else {
-        break;
-      }
-    }
-    if (indentedLines.length === 0)
-      return void 0;
-    try {
-      const parsed = load(indentedLines.join("\n"));
-      if (parsed && typeof parsed === "object")
-        return parsed;
-      return void 0;
-    } catch {
-      return void 0;
-    }
+    return val.filter((v) => v != null).map(String);
   };
   const sections = rest.split(/\n---\n/);
   let body = sections[0] || "";
@@ -3217,22 +3204,23 @@ ${section}`;
       i += 1;
     }
   }
-  const meta = getMetadata();
-  const actions = getArrayValue("actions");
+  const actions = arr("actions");
+  const rawMeta = parsed.metadata;
+  const meta = rawMeta != null && typeof rawMeta === "object" && !Array.isArray(rawMeta) ? rawMeta : void 0;
   return {
-    version: parseInt(getValue("version"), 10) || 0,
-    id: getValue("id") || extractIdFromFilename(filePath),
-    status: getValue("status") || "backlog",
-    priority: getValue("priority") || "medium",
-    assignee: getValue("assignee") || null,
-    dueDate: getValue("dueDate") || null,
-    created: getValue("created") || (/* @__PURE__ */ new Date()).toISOString(),
-    modified: getValue("modified") || (/* @__PURE__ */ new Date()).toISOString(),
-    completedAt: getValue("completedAt") || null,
-    labels: getArrayValue("labels"),
-    attachments: getArrayValue("attachments"),
+    version: typeof parsed.version === "number" ? parsed.version : parseInt(str2("version"), 10) || 0,
+    id: str2("id") || extractIdFromFilename(filePath),
+    status: str2("status") || "backlog",
+    priority: str2("priority") || "medium",
+    assignee: parsed.assignee != null ? String(parsed.assignee) : null,
+    dueDate: parsed.dueDate != null ? String(parsed.dueDate) : null,
+    created: str2("created") || (/* @__PURE__ */ new Date()).toISOString(),
+    modified: str2("modified") || (/* @__PURE__ */ new Date()).toISOString(),
+    completedAt: parsed.completedAt != null ? String(parsed.completedAt) : null,
+    labels: arr("labels"),
+    attachments: arr("attachments"),
     comments,
-    order: getValue("order") || "a0",
+    order: str2("order") || "a0",
     content: body.trim(),
     ...meta ? { metadata: meta } : {},
     ...actions.length > 0 ? { actions } : {},
@@ -3240,37 +3228,28 @@ ${section}`;
   };
 }
 function serializeFeature(feature) {
-  const lines = [
-    "---",
-    `version: ${feature.version ?? CARD_FORMAT_VERSION}`,
-    `id: "${feature.id}"`,
-    `status: "${feature.status}"`,
-    `priority: "${feature.priority}"`,
-    `assignee: ${feature.assignee ? `"${feature.assignee}"` : "null"}`,
-    `dueDate: ${feature.dueDate ? `"${feature.dueDate}"` : "null"}`,
-    `created: "${feature.created}"`,
-    `modified: "${feature.modified}"`,
-    `completedAt: ${feature.completedAt ? `"${feature.completedAt}"` : "null"}`,
-    `labels: [${feature.labels.map((l) => `"${l}"`).join(", ")}]`,
-    `attachments: [${(feature.attachments || []).map((a) => `"${a}"`).join(", ")}]`,
-    `order: "${feature.order}"`
-  ];
-  if (feature.actions && feature.actions.length > 0) {
-    lines.push(`actions: [${feature.actions.map((a) => `"${a}"`).join(", ")}]`);
-  }
-  if (feature.metadata && Object.keys(feature.metadata).length > 0) {
-    const metaYaml = dump(feature.metadata, { indent: 2, lineWidth: -1 });
-    lines.push("metadata:");
-    for (const line of metaYaml.trimEnd().split("\n")) {
-      lines.push("  " + line);
-    }
-  }
-  lines.push("---");
-  lines.push("");
-  const frontmatter = lines.join("\n");
-  let result = frontmatter + feature.content;
-  const comments = feature.comments || [];
-  for (const comment of comments) {
+  const frontmatterObj = {
+    version: feature.version ?? CARD_FORMAT_VERSION,
+    id: feature.id,
+    status: feature.status,
+    priority: feature.priority,
+    assignee: feature.assignee ?? null,
+    dueDate: feature.dueDate ?? null,
+    created: feature.created,
+    modified: feature.modified,
+    completedAt: feature.completedAt ?? null,
+    labels: feature.labels,
+    attachments: feature.attachments || [],
+    order: feature.order,
+    ...feature.actions?.length ? { actions: feature.actions } : {},
+    ...feature.metadata && Object.keys(feature.metadata).length > 0 ? { metadata: feature.metadata } : {}
+  };
+  const yamlStr = dump(frontmatterObj, { lineWidth: -1, quotingType: '"', forceQuotes: true });
+  let result = `---
+${yamlStr}---
+
+${feature.content}`;
+  for (const comment of feature.comments || []) {
     result += "\n\n---\n";
     result += `comment: true
 `;
@@ -4308,25 +4287,28 @@ var init_KanbanSDK = __esm({
         writeConfig(this.workspaceRoot, config);
       }
       /**
-       * Removes a label definition from the workspace configuration.
-       *
-       * This only removes the color/group definition — cards that use this
-       * label keep their label strings. Those labels will render with default
-       * gray styling in the UI.
+       * Removes a label definition from the workspace configuration and cascades
+       * the deletion to all cards by removing the label from their `labels` array.
        *
        * @param name - The label name to remove.
        *
        * @example
        * ```ts
-       * sdk.deleteLabel('bug')
+       * await sdk.deleteLabel('bug')
        * ```
        */
-      deleteLabel(name) {
+      async deleteLabel(name) {
         const config = readConfig(this.workspaceRoot);
         if (config.labels) {
           delete config.labels[name];
           writeConfig(this.workspaceRoot, config);
         }
+        const cards = await this.listCards();
+        for (const card of cards) {
+          if (card.labels.includes(name)) {
+            await this.updateCard(card.id, { labels: card.labels.filter((l) => l !== name) });
+          }
+        }
       }
       /**
        * Renames a label in the configuration and cascades the change to all cards.
@@ -4751,6 +4733,57 @@ var init_KanbanSDK = __esm({
         this.emitEvent("column.deleted", removed);
         return board.columns;
       }
+      /**
+       * Moves all cards in the specified column to the `deleted` (soft-delete) column.
+       *
+       * This is a non-destructive operation — cards are moved to the reserved
+       * `deleted` status and can be restored or permanently deleted later.
+       * The column itself is not removed.
+       *
+       * @param columnId - The ID of the column whose cards should be moved to `deleted`.
+       * @param boardId - Optional board ID. Defaults to the workspace's default board.
+       * @returns A promise resolving to the number of cards that were moved.
+       * @throws {Error} If the column is `'deleted'` (no-op protection).
+       *
+       * @example
+       * ```ts
+       * const moved = await sdk.cleanupColumn('blocked')
+       * console.log(`Moved ${moved} cards to deleted`)
+       * ```
+       */
+      async cleanupColumn(columnId, boardId) {
+        if (columnId === DELETED_STATUS_ID)
+          return 0;
+        const cards = await this.listCards(void 0, boardId);
+        const cardsToMove = cards.filter((c) => c.status === columnId);
+        for (const card of cardsToMove) {
+          await this.moveCard(card.id, DELETED_STATUS_ID, 0, boardId);
+        }
+        return cardsToMove.length;
+      }
+      /**
+       * Permanently deletes all cards currently in the `deleted` column.
+       *
+       * This is equivalent to "empty trash". All soft-deleted cards are
+       * removed from disk. This operation cannot be undone.
+       *
+       * @param boardId - Optional board ID. Defaults to the workspace's default board.
+       * @returns A promise resolving to the number of cards that were permanently deleted.
+       *
+       * @example
+       * ```ts
+       * const count = await sdk.purgeDeletedCards()
+       * console.log(`Permanently deleted ${count} cards`)
+       * ```
+       */
+      async purgeDeletedCards(boardId) {
+        const cards = await this.listCards(void 0, boardId);
+        const deleted = cards.filter((c) => c.status === DELETED_STATUS_ID);
+        for (const card of deleted) {
+          await this.permanentlyDeleteCard(card.id, boardId);
+        }
+        return deleted.length;
+      }
       /**
        * Reorders the columns of a board.
        *
@@ -10587,10 +10620,7 @@ function startServer(featuresDir, port, webviewDir) {
   }
   async function doPurgeDeletedCards() {
     try {
-      const deletedCards = features.filter((f) => f.status === "deleted");
-      for (const card of deletedCards) {
-        await sdk.permanentlyDeleteCard(card.id, currentBoardId);
-      }
+      await sdk.purgeDeletedCards(currentBoardId);
       await loadFeatures();
       broadcast(buildInitMessage());
       return true;
@@ -10637,6 +10667,20 @@ function startServer(featuresDir, port, webviewDir) {
       return { removed: false, error: String(err) };
     }
   }
+  async function doCleanupColumn(columnId) {
+    try {
+      migrating = true;
+      await sdk.cleanupColumn(columnId, currentBoardId);
+      await loadFeatures();
+      broadcast(buildInitMessage());
+      return true;
+    } catch (err) {
+      console.error("Failed to cleanup column:", err);
+      return false;
+    } finally {
+      migrating = false;
+    }
+  }
   function doSaveSettings(newSettings) {
     sdk.updateSettings(newSettings);
     broadcast(buildInitMessage());
@@ -10823,6 +10867,9 @@ function startServer(featuresDir, port, webviewDir) {
       case "removeColumn":
         await doRemoveColumn(msg.columnId);
         break;
+      case "cleanupColumn":
+        await doCleanupColumn(msg.columnId);
+        break;
       case "removeAttachment": {
         const featureId = msg.featureId;
         const feature = await doRemoveAttachment(featureId, msg.attachment);
@@ -10971,13 +11018,16 @@ function startServer(featuresDir, port, webviewDir) {
       }
       case "renameLabel": {
         await sdk.renameLabel(msg.oldName, msg.newName);
+        await loadFeatures();
         broadcast({ type: "labelsUpdated", labels: sdk.getLabels() });
         broadcast(buildInitMessage());
         break;
       }
       case "deleteLabel": {
-        sdk.deleteLabel(msg.name);
+        await sdk.deleteLabel(msg.name);
+        await loadFeatures();
         broadcast({ type: "labelsUpdated", labels: sdk.getLabels() });
+        broadcast(buildInitMessage());
         break;
       }
       case "triggerAction": {
@@ -11589,6 +11639,9 @@ function startServer(featuresDir, port, webviewDir) {
         if (!newName)
           return jsonError(res, 400, "newName is required");
         await sdk.renameLabel(name, newName);
+        await loadFeatures();
+        broadcast({ type: "labelsUpdated", labels: sdk.getLabels() });
+        broadcast(buildInitMessage());
         return jsonOk(res, sdk.getLabels());
       } catch (err) {
         return jsonError(res, 400, String(err));
@@ -11598,7 +11651,10 @@ function startServer(featuresDir, port, webviewDir) {
     if (params) {
       try {
         const name = decodeURIComponent(params.name);
-        sdk.deleteLabel(name);
+        await sdk.deleteLabel(name);
+        await loadFeatures();
+        broadcast({ type: "labelsUpdated", labels: sdk.getLabels() });
+        broadcast(buildInitMessage());
         return jsonOk(res, { success: true });
       } catch (err) {
         return jsonError(res, 400, String(err));
@@ -13142,9 +13198,19 @@ async function cmdColumns(sdk, positional, flags) {
         console.log(JSON.stringify(columns, null, 2));
       break;
     }
+    case "cleanup": {
+      const columnId = positional[1];
+      if (!columnId) {
+        console.error(red("Usage: kl columns cleanup <id>"));
+        process.exit(1);
+      }
+      const moved = await sdk.cleanupColumn(columnId, boardId);
+      console.log(green(`Moved ${moved} card${moved === 1 ? "" : "s"} from "${columnId}" to deleted`));
+      break;
+    }
     default:
       console.error(red(`Unknown columns subcommand: ${subcommand}`));
-      console.error("Available: list, add, update, remove");
+      console.error("Available: list, add, update, remove, cleanup");
       process.exit(1);
   }
 }
@@ -13218,7 +13284,7 @@ async function cmdLabels(sdk, positional, flags) {
         console.error(red("Usage: kl labels delete <name>"));
         process.exit(1);
       }
-      sdk.deleteLabel(name);
+      await sdk.deleteLabel(name);
       if (flags.json) {
         console.log(JSON.stringify({ deleted: name }, null, 2));
       } else {