kanban-lite 1.0.35 → 1.0.36

package/CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+- **Card actions**: `actions` field now accepts either an array of action keys (`string[]`) or an object mapping action keys to display titles (`Record<string, string>`). The "Run Action" dropdown shows the title when the object form is used; the action key is always what's sent to the webhook. Fully backward-compatible — existing array-form cards are unchanged.
+
 ### Added
 - **Card logs**: Append timestamped log entries to any card, stored as a `<cardId>.log` text file auto-added as an attachment. Each entry has timestamp (auto-generated), source label (defaults to `"default"`), markdown text, and optional structured data object (stored as compact JSON). Supports markdown formatting (bold, italic, emoji) in log text.
 - **SDK**: `listLogs(cardId, boardId?)`, `addLog(cardId, text, options?, boardId?)`, `clearLogs(cardId, boardId?)` methods on `KanbanSDK`

package/README.md

@@ -398,15 +398,17 @@ Actions let you attach named triggers to a card — things like `retry`, `deploy
 }
 ```
 
-2. **Add actions to a card** — as a list of simple strings stored in the card's frontmatter:
+2. **Add actions to a card** — either as an array of action keys, or an object mapping action keys to display titles:
 
 ```yaml
----
-id: "42-deploy-v2"
-status: "in-progress"
+# Array form — action key is used as the button label
 actions: ["retry", "rollback", "notify-slack"]
----
-# Deploy v2.0
+
+# Object form — keys are the action names sent to the webhook, values are the UI labels
+actions:
+  retry: "Retry deployment"
+  rollback: "Roll back to v1"
+  notify-slack: "Notify Slack"
 ```
 
 3. **Trigger an action** from any interface:
@@ -431,7 +433,7 @@ actions: ["retry", "rollback", "notify-slack"]
     "assignee": "alice",
     "labels": ["deploy"],
     "content": "# Deploy v2.0\n...",
-    "actions": ["retry", "rollback", "notify-slack"]
+    "actions": ["retry", "rollback", "notify-slack"]  // or {"retry": "Retry deployment", ...}
   }
 }
 ```
@@ -440,7 +442,7 @@ The webhook receives the full card object (same shape as the SDK `Card` type, mi
 
 ### Managing actions
 
-Actions are plain strings in the `actions` array of the card's YAML frontmatter. Edit them directly in the markdown file, or use any interface:
+Actions are stored in the `actions` field of the card's YAML frontmatter — either as a plain string array or as a key→title object. Edit them directly in the markdown file, or use any interface:
 
 ```bash
 # Add actions when creating a card

package/dist/cli.js

@@ -3292,7 +3292,18 @@ ${section}`;
       i += 1;
     }
   }
-  const actions = arr("actions");
+  const rawActions = parsed["actions"];
+  const actions = (() => {
+    if (Array.isArray(rawActions))
+      return rawActions.filter((v) => v != null).map(String);
+    if (rawActions != null && typeof rawActions === "object" && !Array.isArray(rawActions)) {
+      const obj = {};
+      for (const [k, v] of Object.entries(rawActions))
+        obj[k] = String(v ?? k);
+      return obj;
+    }
+    return void 0;
+  })();
   const rawMeta = parsed.metadata;
   const meta5 = rawMeta != null && typeof rawMeta === "object" && !Array.isArray(rawMeta) ? rawMeta : void 0;
   return {
@@ -3311,7 +3322,7 @@ ${section}`;
     order: str2("order") || "a0",
     content: body.trim(),
     ...meta5 ? { metadata: meta5 } : {},
-    ...actions.length > 0 ? { actions } : {},
+    ...actions && (Array.isArray(actions) ? actions.length > 0 : Object.keys(actions).length > 0) ? { actions } : {},
     filePath
   };
 }
@@ -3329,7 +3340,7 @@ function serializeCard(card) {
     labels: card.labels,
     attachments: card.attachments || [],
     order: card.order,
-    ...card.actions?.length ? { actions: card.actions } : {},
+    ...card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? { actions: card.actions } : {},
     ...card.metadata && Object.keys(card.metadata).length > 0 ? { metadata: card.metadata } : {}
   };
   const yamlStr = dump(frontmatterObj, { lineWidth: -1, quotingType: '"', forceQuotes: true });
@@ -4749,7 +4760,7 @@ CREATE INDEX IF NOT EXISTS idx_comments_card       ON comments (card_id, board_i
             card.order || "a0",
             card.content || "",
             card.metadata && Object.keys(card.metadata).length > 0 ? JSON.stringify(card.metadata) : null,
-            card.actions && card.actions.length > 0 ? JSON.stringify(card.actions) : null
+            card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? JSON.stringify(card.actions) : null
           );
           deleteComments.run(card.id, boardId);
           for (const comment of card.comments || []) {
@@ -5436,7 +5447,7 @@ var init_KanbanSDK = __esm({
           order: generateKeyBetween(lastOrder, null),
           content: data.content,
           ...data.metadata && Object.keys(data.metadata).length > 0 ? { metadata: data.metadata } : {},
-          ...data.actions && data.actions.length > 0 ? { actions: data.actions } : {},
+          ...data.actions && (Array.isArray(data.actions) ? data.actions.length > 0 : Object.keys(data.actions).length > 0) ? { actions: data.actions } : {},
           filePath: this._storage.type === "markdown" ? getCardFilePath(boardDir, status, filename) : ""
         };
         await this._storage.writeCard(card);

package/dist/extension.js

@@ -3104,7 +3104,18 @@ ${section}`;
       i += 1;
     }
   }
-  const actions = arr("actions");
+  const rawActions = parsed["actions"];
+  const actions = (() => {
+    if (Array.isArray(rawActions))
+      return rawActions.filter((v) => v != null).map(String);
+    if (rawActions != null && typeof rawActions === "object" && !Array.isArray(rawActions)) {
+      const obj = {};
+      for (const [k, v] of Object.entries(rawActions))
+        obj[k] = String(v ?? k);
+      return obj;
+    }
+    return void 0;
+  })();
   const rawMeta = parsed.metadata;
   const meta = rawMeta != null && typeof rawMeta === "object" && !Array.isArray(rawMeta) ? rawMeta : void 0;
   return {
@@ -3123,7 +3134,7 @@ ${section}`;
     order: str2("order") || "a0",
     content: body.trim(),
     ...meta ? { metadata: meta } : {},
-    ...actions.length > 0 ? { actions } : {},
+    ...actions && (Array.isArray(actions) ? actions.length > 0 : Object.keys(actions).length > 0) ? { actions } : {},
     filePath
   };
 }
@@ -3141,7 +3152,7 @@ function serializeCard(card) {
     labels: card.labels,
     attachments: card.attachments || [],
     order: card.order,
-    ...card.actions?.length ? { actions: card.actions } : {},
+    ...card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? { actions: card.actions } : {},
     ...card.metadata && Object.keys(card.metadata).length > 0 ? { metadata: card.metadata } : {}
   };
   const yamlStr = dump(frontmatterObj, { lineWidth: -1, quotingType: '"', forceQuotes: true });
@@ -4561,7 +4572,7 @@ CREATE INDEX IF NOT EXISTS idx_comments_card       ON comments (card_id, board_i
             card.order || "a0",
             card.content || "",
             card.metadata && Object.keys(card.metadata).length > 0 ? JSON.stringify(card.metadata) : null,
-            card.actions && card.actions.length > 0 ? JSON.stringify(card.actions) : null
+            card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? JSON.stringify(card.actions) : null
           );
           deleteComments.run(card.id, boardId);
           for (const comment of card.comments || []) {
@@ -9160,7 +9171,7 @@ var KanbanSDK = class {
       order: generateKeyBetween(lastOrder, null),
       content: data.content,
       ...data.metadata && Object.keys(data.metadata).length > 0 ? { metadata: data.metadata } : {},
-      ...data.actions && data.actions.length > 0 ? { actions: data.actions } : {},
+      ...data.actions && (Array.isArray(data.actions) ? data.actions.length > 0 : Object.keys(data.actions).length > 0) ? { actions: data.actions } : {},
       filePath: this._storage.type === "markdown" ? getCardFilePath(boardDir, status, filename) : ""
     };
     await this._storage.writeCard(card);

package/dist/mcp-server.js

@@ -3077,7 +3077,18 @@ ${section}`;
       i += 1;
     }
   }
-  const actions = arr("actions");
+  const rawActions = parsed["actions"];
+  const actions = (() => {
+    if (Array.isArray(rawActions))
+      return rawActions.filter((v) => v != null).map(String);
+    if (rawActions != null && typeof rawActions === "object" && !Array.isArray(rawActions)) {
+      const obj = {};
+      for (const [k, v] of Object.entries(rawActions))
+        obj[k] = String(v ?? k);
+      return obj;
+    }
+    return void 0;
+  })();
   const rawMeta = parsed.metadata;
   const meta = rawMeta != null && typeof rawMeta === "object" && !Array.isArray(rawMeta) ? rawMeta : void 0;
   return {
@@ -3096,7 +3107,7 @@ ${section}`;
     order: str2("order") || "a0",
     content: body.trim(),
     ...meta ? { metadata: meta } : {},
-    ...actions.length > 0 ? { actions } : {},
+    ...actions && (Array.isArray(actions) ? actions.length > 0 : Object.keys(actions).length > 0) ? { actions } : {},
     filePath
   };
 }
@@ -3114,7 +3125,7 @@ function serializeCard(card) {
     labels: card.labels,
     attachments: card.attachments || [],
     order: card.order,
-    ...card.actions?.length ? { actions: card.actions } : {},
+    ...card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? { actions: card.actions } : {},
     ...card.metadata && Object.keys(card.metadata).length > 0 ? { metadata: card.metadata } : {}
   };
   const yamlStr = dump(frontmatterObj, { lineWidth: -1, quotingType: '"', forceQuotes: true });
@@ -4534,7 +4545,7 @@ CREATE INDEX IF NOT EXISTS idx_comments_card       ON comments (card_id, board_i
             card.order || "a0",
             card.content || "",
             card.metadata && Object.keys(card.metadata).length > 0 ? JSON.stringify(card.metadata) : null,
-            card.actions && card.actions.length > 0 ? JSON.stringify(card.actions) : null
+            card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? JSON.stringify(card.actions) : null
           );
           deleteComments.run(card.id, boardId);
           for (const comment of card.comments || []) {
@@ -5419,7 +5430,7 @@ var KanbanSDK = class {
       order: generateKeyBetween(lastOrder, null),
       content: data.content,
       ...data.metadata && Object.keys(data.metadata).length > 0 ? { metadata: data.metadata } : {},
-      ...data.actions && data.actions.length > 0 ? { actions: data.actions } : {},
+      ...data.actions && (Array.isArray(data.actions) ? data.actions.length > 0 : Object.keys(data.actions).length > 0) ? { actions: data.actions } : {},
       filePath: this._storage.type === "markdown" ? getCardFilePath(boardDir, status, filename) : ""
     };
     await this._storage.writeCard(card);

package/dist/sdk/index.cjs

@@ -3078,7 +3078,18 @@ ${section}`;
       i += 1;
     }
   }
-  const actions = arr("actions");
+  const rawActions = parsed["actions"];
+  const actions = (() => {
+    if (Array.isArray(rawActions))
+      return rawActions.filter((v) => v != null).map(String);
+    if (rawActions != null && typeof rawActions === "object" && !Array.isArray(rawActions)) {
+      const obj = {};
+      for (const [k, v] of Object.entries(rawActions))
+        obj[k] = String(v ?? k);
+      return obj;
+    }
+    return void 0;
+  })();
   const rawMeta = parsed.metadata;
   const meta = rawMeta != null && typeof rawMeta === "object" && !Array.isArray(rawMeta) ? rawMeta : void 0;
   return {
@@ -3097,7 +3108,7 @@ ${section}`;
     order: str2("order") || "a0",
     content: body.trim(),
     ...meta ? { metadata: meta } : {},
-    ...actions.length > 0 ? { actions } : {},
+    ...actions && (Array.isArray(actions) ? actions.length > 0 : Object.keys(actions).length > 0) ? { actions } : {},
     filePath
   };
 }
@@ -3115,7 +3126,7 @@ function serializeCard(card) {
     labels: card.labels,
     attachments: card.attachments || [],
     order: card.order,
-    ...card.actions?.length ? { actions: card.actions } : {},
+    ...card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? { actions: card.actions } : {},
     ...card.metadata && Object.keys(card.metadata).length > 0 ? { metadata: card.metadata } : {}
   };
   const yamlStr = dump(frontmatterObj, { lineWidth: -1, quotingType: '"', forceQuotes: true });
@@ -3712,7 +3723,7 @@ CREATE INDEX IF NOT EXISTS idx_comments_card       ON comments (card_id, board_i
             card.order || "a0",
             card.content || "",
             card.metadata && Object.keys(card.metadata).length > 0 ? JSON.stringify(card.metadata) : null,
-            card.actions && card.actions.length > 0 ? JSON.stringify(card.actions) : null
+            card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? JSON.stringify(card.actions) : null
           );
           deleteComments.run(card.id, boardId);
           for (const comment of card.comments || []) {
@@ -4616,7 +4627,7 @@ var KanbanSDK = class {
       order: generateKeyBetween(lastOrder, null),
       content: data.content,
       ...data.metadata && Object.keys(data.metadata).length > 0 ? { metadata: data.metadata } : {},
-      ...data.actions && data.actions.length > 0 ? { actions: data.actions } : {},
+      ...data.actions && (Array.isArray(data.actions) ? data.actions.length > 0 : Object.keys(data.actions).length > 0) ? { actions: data.actions } : {},
       filePath: this._storage.type === "markdown" ? getCardFilePath(boardDir, status, filename) : ""
     };
     await this._storage.writeCard(card);

package/dist/sdk/index.mjs

@@ -3063,7 +3063,18 @@ ${section}`;
       i += 1;
     }
   }
-  const actions = arr("actions");
+  const rawActions = parsed["actions"];
+  const actions = (() => {
+    if (Array.isArray(rawActions))
+      return rawActions.filter((v) => v != null).map(String);
+    if (rawActions != null && typeof rawActions === "object" && !Array.isArray(rawActions)) {
+      const obj = {};
+      for (const [k, v] of Object.entries(rawActions))
+        obj[k] = String(v ?? k);
+      return obj;
+    }
+    return void 0;
+  })();
   const rawMeta = parsed.metadata;
   const meta = rawMeta != null && typeof rawMeta === "object" && !Array.isArray(rawMeta) ? rawMeta : void 0;
   return {
@@ -3082,7 +3093,7 @@ ${section}`;
     order: str2("order") || "a0",
     content: body.trim(),
     ...meta ? { metadata: meta } : {},
-    ...actions.length > 0 ? { actions } : {},
+    ...actions && (Array.isArray(actions) ? actions.length > 0 : Object.keys(actions).length > 0) ? { actions } : {},
     filePath
   };
 }
@@ -3100,7 +3111,7 @@ function serializeCard(card) {
     labels: card.labels,
     attachments: card.attachments || [],
     order: card.order,
-    ...card.actions?.length ? { actions: card.actions } : {},
+    ...card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? { actions: card.actions } : {},
     ...card.metadata && Object.keys(card.metadata).length > 0 ? { metadata: card.metadata } : {}
   };
   const yamlStr = dump(frontmatterObj, { lineWidth: -1, quotingType: '"', forceQuotes: true });
@@ -3694,7 +3705,7 @@ CREATE INDEX IF NOT EXISTS idx_comments_card       ON comments (card_id, board_i
             card.order || "a0",
             card.content || "",
             card.metadata && Object.keys(card.metadata).length > 0 ? JSON.stringify(card.metadata) : null,
-            card.actions && card.actions.length > 0 ? JSON.stringify(card.actions) : null
+            card.actions && (Array.isArray(card.actions) ? card.actions.length > 0 : Object.keys(card.actions).length > 0) ? JSON.stringify(card.actions) : null
           );
           deleteComments.run(card.id, boardId);
           for (const comment of card.comments || []) {
@@ -4572,7 +4583,7 @@ var KanbanSDK = class {
       order: generateKeyBetween(lastOrder, null),
       content: data.content,
       ...data.metadata && Object.keys(data.metadata).length > 0 ? { metadata: data.metadata } : {},
-      ...data.actions && data.actions.length > 0 ? { actions: data.actions } : {},
+      ...data.actions && (Array.isArray(data.actions) ? data.actions.length > 0 : Object.keys(data.actions).length > 0) ? { actions: data.actions } : {},
       filePath: this._storage.type === "markdown" ? getCardFilePath(boardDir, status, filename) : ""
     };
     await this._storage.writeCard(card);

package/dist/sdk/shared/types.d.ts

@@ -91,8 +91,8 @@ export interface Card {
     content: string;
     /** Arbitrary user-defined metadata stored as YAML in the frontmatter. */
     metadata?: Record<string, any>;
-    /** Named action strings that can be triggered via the action webhook. */
-    actions?: string[];
+    /** Named actions that can be triggered via the action webhook. Either an array of action keys or a map of action key → display title. */
+    actions?: string[] | Record<string, string>;
     /** Absolute path to the card's markdown file on disk. */
     filePath: string;
 }
@@ -283,8 +283,8 @@ export interface CardFrontmatter {
     order: string;
     /** Arbitrary user-defined metadata stored as YAML in the frontmatter. */
     metadata?: Record<string, any>;
-    /** Named action strings that can be triggered via the action webhook. */
-    actions?: string[];
+    /** Named actions that can be triggered via the action webhook. Either an array of action keys or a map of action key → display title. */
+    actions?: string[] | Record<string, string>;
 }
 /**
  * Read-only workspace information displayed in the settings panel.
@@ -343,7 +343,7 @@ export type WebviewMessage = {
         dueDate: string | null;
         labels: string[];
         metadata?: Record<string, any>;
-        actions?: string[];
+        actions?: string[] | Record<string, string>;
     };
 } | {
     type: 'moveCard';