opencode-backlog 0.1.5 → 0.2.0

package/README.md

@@ -4,22 +4,30 @@ A persistent project backlog for OpenCode V2 agents and the TUI.
 
 `opencode-backlog` gives the agent tools to manage project tasks. It also adds an interactive backlog to the OpenCode sidebar and command palette.
 
+Published package: [opencode-backlog on npm](https://www.npmjs.com/package/opencode-backlog).
+
 ![Backlog sidebar in OpenCode](docs/images/opencode-backlog.jpg)
 
 ## What It Does
 
-The plugin stores tasks in `BACKLOG.json` at the project root. Each task has a title, optional notes, and one Kanban state:
+The plugin stores tasks and ordered categories in `BACKLOG.json` at the project root.
+
+New backlogs contain these categories:
 
 - `todo`
 - `doing`
 - `done`
 
-The server plugin lets the agent list, add, edit, move, reorder, and remove tasks. The TUI plugin provides:
+You can add, rename, reorder, purge, and remove categories. Each category has a stable ID and a modifiable title.
+
+The server plugin manages tasks and categories. The TUI plugin provides:
 
 - A live backlog summary below the sidebar context.
 - A `Browse backlog` command in the command palette.
 - `/backlog` and `/tasks` slash commands.
-- Task details and status changes from the TUI.
+- Task details and category changes from the TUI.
+- `/backlog-purge` to remove every task from a selected category.
+- `/backlog-categories` to manage categories.
 
 ## Requirements
 
@@ -119,35 +127,57 @@ Reopen the TUI to load the TUI plugin.
 Ask the agent to manage tasks in normal language:
 
 ```text
-Add a todo task to document the release process.
-Move the release task to doing.
-List only the todo tasks.
-Mark the current task as done.
+Add a Todo task to document the release process.
+Add a Blocked category after Doing.
+Move the release task to Blocked.
+Purge all tasks in Done.
 ```
 
-Open the command palette and select `Browse backlog` to inspect tasks. Select a task to view its ID, notes, and current state. Then select its new state.
+Open the command palette and select `Browse backlog` to inspect tasks. Select a task to view its ID, notes, and category.
 
 Run `/backlog` or `/tasks` to open the same browser directly.
 
+The backlog browser provides these shortcuts:
+
+- `Enter` opens the selected task details.
+- `n` creates a task.
+- `c` changes the selected task category.
+- `e` edits the selected task.
+- `d` deletes the selected task after confirmation.
+- `p` purges all tasks from a selected category after confirmation.
+
+Click a sidebar task to open its details. The detail dialog provides `c`, `e`, and `d` for the same actions.
+
 ## Agent Tools
 
 | Tool | Purpose |
 | --- | --- |
-| `backlog_list` | List all tasks or filter by `todo`, `doing`, or `done`. |
-| `backlog_add` | Add a task at an optional state and position. |
+| `backlog_list` | List categories and tasks, with an optional category ID filter. |
+| `backlog_add` | Add a task at an optional category and position. |
 | `backlog_update` | Change a task title or notes. |
-| `backlog_move` | Change a task state or position. |
+| `backlog_move` | Change a task category or position. |
 | `backlog_remove` | Permanently remove a task. |
+| `backlog_category_add` | Add a category with a stable ID and title. |
+| `backlog_category_update` | Change a category title. |
+| `backlog_category_move` | Change a category position. |
+| `backlog_category_remove` | Remove an empty category. |
+| `backlog_category_purge` | Permanently remove all tasks from a category. |
 
 The agent receives task IDs from `backlog_list` and from each mutation result.
 
 ## Backlog File
 
-The plugin creates `BACKLOG.json` when the first task is added:
+The plugin creates `BACKLOG.json` when the first task or category is added:
 
 ```json
 {
-  "version": 1,
+  "version": 2,
+  "categories": [
+    { "id": "todo", "title": "Todo" },
+    { "id": "doing", "title": "Doing" },
+    { "id": "blocked", "title": "Blocked" },
+    { "id": "done", "title": "Done" }
+  ],
   "items": [
     {
       "id": "c50437e3-2a57-424d-9257-32ec432145a9",
@@ -159,7 +189,11 @@ The plugin creates `BACKLOG.json` when the first task is added:
 }
 ```
 
-Items stay grouped by state. Their array order defines their position inside each state.
+The category array defines category order. The item array defines task order inside each category.
+
+Category IDs stay stable when titles change. The plugin rejects tasks that reference an unknown category ID.
+
+The plugin reads version 1 files with the default categories. The next backlog change writes the file as version 2.
 
 Commit `BACKLOG.json` when the backlog must follow the project. Ignore it when the backlog must remain local.
 

package/dist/backlog.d.ts

@@ -1,6 +1,9 @@
 export declare const BACKLOG_FILE = "BACKLOG.json";
-export declare const STATUSES: readonly ["todo", "doing", "done"];
-export type Status = (typeof STATUSES)[number];
+export interface Category {
+    readonly id: string;
+    readonly title: string;
+}
+export type Status = string;
 export interface BacklogItem {
     readonly id: string;
     readonly title: string;
@@ -8,12 +11,19 @@ export interface BacklogItem {
     readonly status: Status;
 }
 export interface Backlog {
-    readonly version: 1;
+    readonly version: 2;
+    readonly categories: readonly Category[];
     readonly items: readonly BacklogItem[];
 }
+export declare const DEFAULT_CATEGORIES: readonly Category[];
 export declare const EMPTY_BACKLOG: Backlog;
-export declare function isStatus(value: unknown): value is Status;
+export declare function isStatus(backlog: Backlog, value: unknown): value is Status;
 export declare function parseBacklog(value: unknown): Backlog;
-export declare function sortByStatus(items: readonly BacklogItem[]): BacklogItem[];
-export declare function moveItem(items: readonly BacklogItem[], id: string, status: Status | undefined, position: number | undefined): BacklogItem[];
+export declare function sortByStatus(items: readonly BacklogItem[], categories: readonly Category[]): BacklogItem[];
+export declare function moveItem(items: readonly BacklogItem[], id: string, status: Status | undefined, position: number | undefined, categories: readonly Category[]): BacklogItem[];
 export declare function describeBacklog(backlog: Backlog, statuses?: readonly Status[]): string;
+export declare function addCategory(backlog: Backlog, category: Category, position?: number): Backlog;
+export declare function renameCategory(backlog: Backlog, id: string, title: string): Backlog;
+export declare function moveCategory(backlog: Backlog, id: string, position: number): Backlog;
+export declare function removeCategory(backlog: Backlog, id: string): Backlog;
+export declare function purgeCategory(backlog: Backlog, id: string): Backlog;

package/dist/backlog.js

@@ -1,21 +1,46 @@
 export const BACKLOG_FILE = "BACKLOG.json";
-export const STATUSES = ["todo", "doing", "done"];
-export const EMPTY_BACKLOG = { version: 1, items: [] };
+export const DEFAULT_CATEGORIES = [
+    { id: "todo", title: "Todo" },
+    { id: "doing", title: "Doing" },
+    { id: "done", title: "Done" },
+];
+export const EMPTY_BACKLOG = { version: 2, categories: DEFAULT_CATEGORIES, items: [] };
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-export function isStatus(value) {
-    return typeof value === "string" && STATUSES.includes(value);
+function validateCategory(category, index) {
+    const label = index === undefined ? "Category" : `Backlog category ${index}`;
+    if (!isRecord(category))
+        throw new Error(`${label} must be an object`);
+    if (typeof category.id !== "string" || category.id.trim().length === 0) {
+        throw new Error(`${label} must have a non-empty id`);
+    }
+    if (typeof category.title !== "string" || category.title.trim().length === 0) {
+        throw new Error(`${label} must have a non-empty title`);
+    }
+    return { id: category.id, title: category.title };
 }
-export function parseBacklog(value) {
-    if (!isRecord(value) || value.version !== 1 || !Array.isArray(value.items)) {
-        throw new Error("BACKLOG.json must contain a version 1 backlog");
+function validateCategories(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error("A version 2 backlog must have at least one category");
     }
     const ids = new Set();
-    const items = value.items.map((item, index) => {
+    return value.map((value, index) => {
+        const category = validateCategory(value, index);
+        if (ids.has(category.id))
+            throw new Error(`Backlog category id ${category.id} is duplicated`);
+        ids.add(category.id);
+        return category;
+    });
+}
+function validateItems(value, categories) {
+    if (!Array.isArray(value))
+        throw new Error("Backlog items must be an array");
+    const ids = new Set();
+    return value.map((item, index) => {
         if (!isRecord(item))
             throw new Error(`Backlog item ${index} must be an object`);
-        if (typeof item.id !== "string" || item.id.length === 0) {
+        if (typeof item.id !== "string" || item.id.trim().length === 0) {
             throw new Error(`Backlog item ${index} must have a non-empty id`);
         }
         if (ids.has(item.id))
@@ -26,8 +51,9 @@ export function parseBacklog(value) {
         if (item.notes !== undefined && typeof item.notes !== "string") {
             throw new Error(`Backlog item ${item.id} has invalid notes`);
         }
-        if (!isStatus(item.status))
+        if (typeof item.status !== "string" || !categories.some(({ id }) => id === item.status)) {
             throw new Error(`Backlog item ${item.id} has an invalid status`);
+        }
         ids.add(item.id);
         return {
             id: item.id,
@@ -36,35 +62,109 @@ export function parseBacklog(value) {
             status: item.status,
         };
     });
-    return { version: 1, items };
 }
-export function sortByStatus(items) {
-    return STATUSES.flatMap((status) => items.filter((item) => item.status === status));
+export function isStatus(backlog, value) {
+    return typeof value === "string" && backlog.categories.some(({ id }) => id === value);
 }
-export function moveItem(items, id, status, position) {
+export function parseBacklog(value) {
+    if (!isRecord(value))
+        throw new Error("BACKLOG.json must contain a backlog object");
+    if (value.version === 1) {
+        return {
+            version: 2,
+            categories: DEFAULT_CATEGORIES,
+            items: validateItems(value.items, DEFAULT_CATEGORIES),
+        };
+    }
+    if (value.version !== 2)
+        throw new Error(`Unsupported backlog version ${String(value.version)}`);
+    const categories = validateCategories(value.categories);
+    return { version: 2, categories, items: validateItems(value.items, categories) };
+}
+export function sortByStatus(items, categories) {
+    return categories.flatMap(({ id }) => items.filter((item) => item.status === id));
+}
+export function moveItem(items, id, status, position, categories) {
     const item = items.find((candidate) => candidate.id === id);
     if (!item)
         throw new Error(`Backlog item ${id} does not exist`);
     const targetStatus = status ?? item.status;
+    if (!categories.some((category) => category.id === targetStatus)) {
+        throw new Error(`Backlog category ${targetStatus} does not exist`);
+    }
     const remaining = items.filter((candidate) => candidate.id !== id);
     const target = remaining.filter((candidate) => candidate.status === targetStatus);
-    const targetPosition = Math.min(position ?? target.length, target.length);
-    target.splice(targetPosition, 0, { ...item, status: targetStatus });
-    return STATUSES.flatMap((candidateStatus) => candidateStatus === targetStatus
+    target.splice(clampPosition(position, target.length), 0, { ...item, status: targetStatus });
+    return categories.flatMap(({ id: categoryId }) => categoryId === targetStatus
         ? target
-        : remaining.filter((candidate) => candidate.status === candidateStatus));
+        : remaining.filter((candidate) => candidate.status === categoryId));
 }
-export function describeBacklog(backlog, statuses = STATUSES) {
-    if (backlog.items.length === 0 && statuses.length === STATUSES.length) {
-        return "The project backlog is empty.";
-    }
-    return statuses.map((status) => {
+export function describeBacklog(backlog, statuses) {
+    const selected = statuses ?? backlog.categories.map(({ id }) => id);
+    return selected.map((status) => {
+        const category = backlog.categories.find(({ id }) => id === status);
+        if (!category)
+            throw new Error(`Backlog category ${status} does not exist`);
         const items = backlog.items.filter((item) => item.status === status);
         const lines = items.map((item, index) => {
             const notes = item.notes ? `\n   Notes: ${item.notes}` : "";
             return `${index}. ${item.id}: ${item.title}${notes}`;
         });
-        return `${status.toUpperCase()} (${items.length})\n${lines.length > 0 ? lines.join("\n") : "Empty"}`;
+        return `${category.title.toUpperCase()} [${category.id}] (${items.length})\n${lines.length > 0 ? lines.join("\n") : "Empty"}`;
     }).join("\n\n");
 }
+export function addCategory(backlog, category, position) {
+    const added = validateCategory(category);
+    if (backlog.categories.some(({ id }) => id === added.id)) {
+        throw new Error(`Backlog category id ${added.id} is duplicated`);
+    }
+    const categories = [...backlog.categories];
+    categories.splice(clampPosition(position, categories.length), 0, added);
+    return { ...backlog, categories };
+}
+export function renameCategory(backlog, id, title) {
+    if (title.trim().length === 0)
+        throw new Error("Category must have a non-empty title");
+    if (!backlog.categories.some((category) => category.id === id)) {
+        throw new Error(`Backlog category ${id} does not exist`);
+    }
+    return {
+        ...backlog,
+        categories: backlog.categories.map((category) => category.id === id ? { ...category, title } : category),
+    };
+}
+export function moveCategory(backlog, id, position) {
+    const category = backlog.categories.find((candidate) => candidate.id === id);
+    if (!category)
+        throw new Error(`Backlog category ${id} does not exist`);
+    const categories = backlog.categories.filter((candidate) => candidate.id !== id);
+    categories.splice(clampPosition(position, categories.length), 0, category);
+    return { ...backlog, categories, items: sortByStatus(backlog.items, categories) };
+}
+export function removeCategory(backlog, id) {
+    requireRemovableCategory(backlog, id);
+    if (backlog.items.some((item) => item.status === id)) {
+        throw new Error(`Backlog category ${id} is not empty`);
+    }
+    return { ...backlog, categories: backlog.categories.filter((category) => category.id !== id) };
+}
+export function purgeCategory(backlog, id) {
+    if (!backlog.categories.some((category) => category.id === id)) {
+        throw new Error(`Backlog category ${id} does not exist`);
+    }
+    return {
+        ...backlog,
+        items: backlog.items.filter((item) => item.status !== id),
+    };
+}
+function requireRemovableCategory(backlog, id) {
+    if (!backlog.categories.some((category) => category.id === id)) {
+        throw new Error(`Backlog category ${id} does not exist`);
+    }
+    if (backlog.categories.length === 1)
+        throw new Error("Cannot remove the final backlog category");
+}
+function clampPosition(position, length) {
+    return Math.max(0, Math.min(position ?? length, length));
+}
 //# sourceMappingURL=backlog.js.map

package/dist/backlog.js.map

@@ -1 +1 @@
-{"version":3,"file":"backlog.js","sourceRoot":"","sources":["../src/backlog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backlog.js","sourceRoot":"","sources":["../src/backlog.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { Plugin } from "@opencode-ai/plugin";
-import { BACKLOG_FILE, describeBacklog, moveItem, sortByStatus, } from "./backlog.js";
+import { BACKLOG_FILE, addCategory, describeBacklog, moveItem, moveCategory, purgeCategory, removeCategory, renameCategory, sortByStatus, } from "./backlog.js";
 import { optionalNullableString, optionalPosition, optionalStatus, record, requiredString, } from "./input.js";
 import { readBacklog, updateBacklog } from "./store.js";
 const idInput = {
@@ -10,6 +10,15 @@ const idInput = {
     required: ["id"],
     additionalProperties: false,
 };
+const categoryTitleInput = {
+    type: "object",
+    properties: {
+        id: { type: "string", minLength: 1 },
+        title: { type: "string", minLength: 1 },
+    },
+    required: ["id", "title"],
+    additionalProperties: false,
+};
 async function backlogPath(context, sessionID) {
     const session = await context.session.get({ sessionID });
     return join(session.location.directory, BACKLOG_FILE);
@@ -33,29 +42,30 @@ export default Plugin.define({
         await context.tool.transform((tools) => {
             tools.add({
                 name: "backlog_list",
-                description: "List the ordered project backlog, optionally filtered by Kanban state.",
+                description: "List the ordered project backlog, optionally filtered by category ID.",
                 input: {
                     type: "object",
-                    properties: { status: { type: "string", enum: ["todo", "doing", "done"] } },
+                    properties: { status: { type: "string", minLength: 1 } },
                     additionalProperties: false,
                 },
                 options: { codemode: false },
                 execute: async (input, toolContext) => {
-                    const status = optionalStatus(record(input));
+                    const backlog = await readForSession(context, toolContext.sessionID);
+                    const status = optionalStatus(record(input), backlog);
                     return {
-                        content: describeBacklog(await readForSession(context, toolContext.sessionID), status === undefined ? undefined : [status]),
+                        content: describeBacklog(backlog, status === undefined ? undefined : [status]),
                     };
                 },
             });
             tools.add({
                 name: "backlog_add",
-                description: "Add a task to the project backlog at a position within a Kanban state.",
+                description: "Add a task at a zero-based position within a backlog category.",
                 input: {
                     type: "object",
                     properties: {
                         title: { type: "string", minLength: 1 },
                         notes: { type: "string" },
-                        status: { type: "string", enum: ["todo", "doing", "done"] },
+                        status: { type: "string", minLength: 1 },
                         position: { type: "integer", minimum: 0 },
                     },
                     required: ["title"],
@@ -66,18 +76,27 @@ export default Plugin.define({
                     const values = record(input);
                     const title = requiredString(values, "title");
                     const notes = optionalNullableString(values, "notes") ?? undefined;
-                    const status = optionalStatus(values) ?? "todo";
                     const position = optionalPosition(values);
-                    const item = {
-                        id: randomUUID(),
-                        title,
-                        ...(notes === undefined ? {} : { notes }),
-                        status,
-                    };
-                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => ({
-                        version: 1,
-                        items: moveItem([...current.items, item], item.id, status, position),
-                    }));
+                    let item;
+                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => {
+                        const firstCategory = current.categories[0];
+                        if (!firstCategory)
+                            throw new Error("The backlog must have at least one category");
+                        const status = optionalStatus(values, current) ?? firstCategory.id;
+                        item = {
+                            id: randomUUID(),
+                            title,
+                            ...(notes === undefined ? {} : { notes }),
+                            status,
+                        };
+                        return {
+                            version: 2,
+                            categories: current.categories,
+                            items: moveItem([...current.items, item], item.id, status, position, current.categories),
+                        };
+                    });
+                    if (!item)
+                        throw new Error("Backlog update did not add an item");
                     return { content: `Added ${item.id}.\n\n${describeBacklog(backlog)}` };
                 },
             });
@@ -113,19 +132,23 @@ export default Plugin.define({
                             ...(title === undefined ? {} : { title }),
                             ...(notes === undefined || notes === null ? {} : { notes }),
                         };
-                        return { version: 1, items: sortByStatus(replaceItem(current.items, replacement)) };
+                        return {
+                            version: 2,
+                            categories: current.categories,
+                            items: sortByStatus(replaceItem(current.items, replacement), current.categories),
+                        };
                     });
                     return { content: `Updated ${id}.\n\n${describeBacklog(backlog)}` };
                 },
             });
             tools.add({
                 name: "backlog_move",
-                description: "Change a task Kanban state or its zero-based position within that state.",
+                description: "Change a task category or its zero-based position within that category.",
                 input: {
                     type: "object",
                     properties: {
                         id: { type: "string", minLength: 1 },
-                        status: { type: "string", enum: ["todo", "doing", "done"] },
+                        status: { type: "string", minLength: 1 },
                         position: { type: "integer", minimum: 0 },
                     },
                     required: ["id"],
@@ -135,15 +158,18 @@ export default Plugin.define({
                 execute: async (input, toolContext) => {
                     const values = record(input);
                     const id = requiredString(values, "id");
-                    const status = optionalStatus(values);
                     const position = optionalPosition(values);
-                    if (status === undefined && position === undefined) {
-                        throw new Error("backlog_move requires a status or position change");
-                    }
-                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => ({
-                        version: 1,
-                        items: moveItem(current.items, id, status, position),
-                    }));
+                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => {
+                        const status = optionalStatus(values, current);
+                        if (status === undefined && position === undefined) {
+                            throw new Error("backlog_move requires a status or position change");
+                        }
+                        return {
+                            version: 2,
+                            categories: current.categories,
+                            items: moveItem(current.items, id, status, position, current.categories),
+                        };
+                    });
                     return { content: `Moved ${id}.\n\n${describeBacklog(backlog)}` };
                 },
             });
@@ -158,11 +184,96 @@ export default Plugin.define({
                         if (!current.items.some((item) => item.id === id)) {
                             throw new Error(`Backlog item ${id} does not exist`);
                         }
-                        return { version: 1, items: current.items.filter((item) => item.id !== id) };
+                        return {
+                            version: 2,
+                            categories: current.categories,
+                            items: current.items.filter((item) => item.id !== id),
+                        };
                     });
                     return { content: `Removed ${id}.\n\n${describeBacklog(backlog)}` };
                 },
             });
+            tools.add({
+                name: "backlog_category_add",
+                description: "Add a backlog category with a unique ID, title, and optional zero-based position.",
+                input: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", minLength: 1 },
+                        title: { type: "string", minLength: 1 },
+                        position: { type: "integer", minimum: 0 },
+                    },
+                    required: ["id", "title"],
+                    additionalProperties: false,
+                },
+                options: { codemode: false },
+                execute: async (input, toolContext) => {
+                    const values = record(input);
+                    const id = requiredString(values, "id");
+                    const title = requiredString(values, "title");
+                    const position = optionalPosition(values);
+                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => addCategory(current, { id, title }, position));
+                    return { content: `Added category ${id}.\n\n${describeBacklog(backlog)}` };
+                },
+            });
+            tools.add({
+                name: "backlog_category_update",
+                description: "Change a backlog category title.",
+                input: categoryTitleInput,
+                options: { codemode: false },
+                execute: async (input, toolContext) => {
+                    const values = record(input);
+                    const id = requiredString(values, "id");
+                    const title = requiredString(values, "title");
+                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => renameCategory(current, id, title));
+                    return { content: `Updated category ${id}.\n\n${describeBacklog(backlog)}` };
+                },
+            });
+            tools.add({
+                name: "backlog_category_move",
+                description: "Move a backlog category to a zero-based position.",
+                input: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", minLength: 1 },
+                        position: { type: "integer", minimum: 0 },
+                    },
+                    required: ["id", "position"],
+                    additionalProperties: false,
+                },
+                options: { codemode: false },
+                execute: async (input, toolContext) => {
+                    const values = record(input);
+                    const id = requiredString(values, "id");
+                    const position = optionalPosition(values);
+                    if (position === undefined)
+                        throw new Error("position is required");
+                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => moveCategory(current, id, position));
+                    return { content: `Moved category ${id}.\n\n${describeBacklog(backlog)}` };
+                },
+            });
+            tools.add({
+                name: "backlog_category_remove",
+                description: "Remove an empty backlog category.",
+                input: idInput,
+                options: { codemode: false },
+                execute: async (input, toolContext) => {
+                    const id = requiredString(record(input), "id");
+                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => removeCategory(current, id));
+                    return { content: `Removed category ${id}.\n\n${describeBacklog(backlog)}` };
+                },
+            });
+            tools.add({
+                name: "backlog_category_purge",
+                description: "Permanently remove all tasks in a backlog category while retaining the category.",
+                input: idInput,
+                options: { codemode: false },
+                execute: async (input, toolContext) => {
+                    const id = requiredString(record(input), "id");
+                    const backlog = await updateForSession(context, toolContext.sessionID, (current) => purgeCategory(current, id));
+                    return { content: `Purged tasks from category ${id}.\n\n${describeBacklog(backlog)}` };
+                },
+            });
         });
     },
 });