kanban-lite 1.0.21 → 1.0.23

package/dist/mcp-server.js

@@ -302,6 +302,8 @@ var DEFAULT_CONFIG = {
   compactMode: false,
   markdownEditorMode: false,
   showDeletedColumn: false,
+  boardZoom: 100,
+  cardZoom: 100,
   port: 3e3,
   labels: {}
 };
@@ -352,6 +354,8 @@ function migrateConfigV1ToV2(raw) {
     compactMode: v1.compactMode,
     markdownEditorMode: v1.markdownEditorMode,
     showDeletedColumn: false,
+    boardZoom: 100,
+    cardZoom: 100,
     port: 3e3
   };
 }
@@ -425,7 +429,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) {
@@ -439,7 +445,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
   };
 }
 
@@ -3099,6 +3107,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 JSON_SCHEMA = json;
 var load = loader.load;
 var loadAll = loader.loadAll;
 var dump = dumper.dump;
@@ -3137,48 +3146,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] || "";
@@ -3199,22 +3186,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 } : {},
@@ -3222,37 +3210,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
 `;
@@ -4245,25 +4224,28 @@ var KanbanSDK = class {
     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.
@@ -4688,6 +4670,57 @@ var KanbanSDK = class {
     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.
    *
@@ -5657,6 +5690,23 @@ async function main() {
       };
     }
   );
+  server.tool(
+    "cleanup_column",
+    "Move all cards in a column to the deleted (soft-delete) column. The column itself is kept.",
+    {
+      boardId: import_zod.z.string().optional().describe("Board ID (uses default board if omitted)"),
+      columnId: import_zod.z.string().describe("Column ID to clean up")
+    },
+    async ({ boardId, columnId }) => {
+      const moved = await sdk.cleanupColumn(columnId, boardId);
+      return {
+        content: [{
+          type: "text",
+          text: `Moved ${moved} card${moved === 1 ? "" : "s"} from "${columnId}" to deleted`
+        }]
+      };
+    }
+  );
   server.tool("list_labels", "List all label definitions with colors and groups", {
     boardId: import_zod.z.string().optional().describe("Board ID")
   }, async () => {
@@ -5678,10 +5728,10 @@ async function main() {
     await sdk.renameLabel(oldName, newName);
     return { content: [{ type: "text", text: `Label "${oldName}" renamed to "${newName}"` }] };
   });
-  server.tool("delete_label", "Remove a label definition (cards keep the label text)", {
+  server.tool("delete_label", "Remove a label definition and remove it from all cards", {
     name: import_zod.z.string().describe("Label name to remove")
   }, async ({ name }) => {
-    sdk.deleteLabel(name);
+    await sdk.deleteLabel(name);
     return { content: [{ type: "text", text: `Label "${name}" definition removed` }] };
   });
   server.tool(

package/dist/sdk/index.cjs

@@ -325,6 +325,8 @@ var DEFAULT_CONFIG = {
   compactMode: false,
   markdownEditorMode: false,
   showDeletedColumn: false,
+  boardZoom: 100,
+  cardZoom: 100,
   port: 3e3,
   labels: {}
 };
@@ -375,6 +377,8 @@ function migrateConfigV1ToV2(raw) {
     compactMode: v1.compactMode,
     markdownEditorMode: v1.markdownEditorMode,
     showDeletedColumn: false,
+    boardZoom: 100,
+    cardZoom: 100,
     port: 3e3
   };
 }
@@ -452,7 +456,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) {
@@ -466,7 +472,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
   };
 }
 
@@ -3126,6 +3134,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 JSON_SCHEMA = json;
 var load = loader.load;
 var loadAll = loader.loadAll;
 var dump = dumper.dump;
@@ -3164,48 +3173,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] || "";
@@ -3226,22 +3213,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 } : {},
@@ -3249,37 +3237,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
 `;
@@ -4272,25 +4251,28 @@ var KanbanSDK = class {
     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.
@@ -4715,6 +4697,57 @@ var KanbanSDK = class {
     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.
    *