chatroom-cli 1.8.0 → 1.10.0

package/dist/index.js

@@ -11589,14 +11589,14 @@ var init_register_agent = __esm(() => {
   init_client2();
   init_machine();
 });
-// ../../services/backend/prompts/cli/task-started/command.ts
-function taskStartedCommand(params) {
+// ../../services/backend/prompts/cli/classify/command.ts
+function classifyCommand(params) {
   const prefix = params.cliEnvPrefix || "";
   const chatroomId = params.chatroomId || "<chatroom-id>";
   const role = params.role || "<role>";
   const taskId = params.taskId || "<task-id>";
   const classification = params.classification || "<question|new_feature|follow_up>";
-  const baseCmd = `${prefix}chatroom task-started --chatroom-id="${chatroomId}" --role="${role}" --task-id="${taskId}" --origin-message-classification=${classification}`;
+  const baseCmd = `${prefix}chatroom classify --chatroom-id="${chatroomId}" --role="${role}" --task-id="${taskId}" --origin-message-classification=${classification}`;
   if (params.classification === "new_feature" || classification === "new_feature") {
     const title = params.title || "[Feature title]";
     const description = params.description || "[Feature description]";
@@ -11619,6 +11619,30 @@ var init_new_feature = () => {};
 var init_classification = __esm(() => {
   init_new_feature();
 });
+
+// ../../services/backend/prompts/cli/task-started/command.ts
+function taskStartedCommand(params) {
+  const prefix = params.cliEnvPrefix || "";
+  const chatroomId = params.chatroomId || "<chatroom-id>";
+  const role = params.role || "<role>";
+  const taskId = params.taskId || "<task-id>";
+  const classification = params.classification || "<question|new_feature|follow_up>";
+  const baseCmd = `${prefix}chatroom task-started --chatroom-id="${chatroomId}" --role="${role}" --task-id="${taskId}" --origin-message-classification=${classification}`;
+  if (params.classification === "new_feature" || classification === "new_feature") {
+    const title = params.title || "[Feature title]";
+    const description = params.description || "[Feature description]";
+    const techSpecs = params.techSpecs || "[Technical specifications]";
+    return `${baseCmd} << 'EOF'
+---TITLE---
+${title}
+---DESCRIPTION---
+${description}
+---TECH_SPECS---
+${techSpecs}
+EOF`;
+  }
+  return baseCmd;
+}
 // ../../services/backend/prompts/cli/task-started/main-prompt.ts
 var init_main_prompt = () => {};
 
@@ -12259,6 +12283,169 @@ var init_task_started2 = __esm(() => {
   init_client2();
 });
 
+// src/commands/classify/index.ts
+var exports_classify = {};
+__export(exports_classify, {
+  classify: () => classify
+});
+async function createDefaultDeps8() {
+  const client2 = await getConvexClient();
+  return {
+    backend: {
+      mutation: (endpoint, args) => client2.mutation(endpoint, args),
+      query: (endpoint, args) => client2.query(endpoint, args)
+    },
+    session: {
+      getSessionId,
+      getConvexUrl,
+      getOtherSessionUrls
+    }
+  };
+}
+async function classify(chatroomId, options, deps) {
+  const d = deps ?? await createDefaultDeps8();
+  const { role, originMessageClassification, rawStdin, taskId } = options;
+  const convexUrl = d.session.getConvexUrl();
+  const cliEnvPrefix = getCliEnvPrefix(convexUrl);
+  const sessionId = d.session.getSessionId();
+  if (!sessionId) {
+    const otherUrls = d.session.getOtherSessionUrls();
+    console.error(`❌ Not authenticated for: ${convexUrl}`);
+    if (otherUrls.length > 0) {
+      console.error(`
+\uD83D\uDCA1 You have sessions for other environments:`);
+      for (const url of otherUrls) {
+        console.error(`   • ${url}`);
+      }
+      console.error(`
+   To use a different environment, set CHATROOM_CONVEX_URL:`);
+      console.error(`   CHATROOM_CONVEX_URL=${otherUrls[0]} chatroom classify ...`);
+      console.error(`
+   Or to authenticate for the current environment:`);
+    }
+    console.error(`   chatroom auth login`);
+    process.exit(1);
+  }
+  if (!chatroomId || typeof chatroomId !== "string" || chatroomId.length < 20 || chatroomId.length > 40) {
+    console.error(`❌ Invalid chatroom ID format: ID must be 20-40 characters (got ${chatroomId?.length || 0})`);
+    process.exit(1);
+  }
+  const chatroom = await d.backend.query(api.chatrooms.get, {
+    sessionId,
+    chatroomId
+  });
+  if (!chatroom) {
+    console.error(`❌ Chatroom not found: ${chatroomId}`);
+    console.error(`   Verify the chatroom ID is correct and you have access.`);
+    process.exit(1);
+  }
+  const entryPoint = chatroom?.teamEntryPoint ?? chatroom?.teamRoles?.[0];
+  if (entryPoint && role.toLowerCase() !== entryPoint.toLowerCase()) {
+    console.error(`❌ \`classify\` is only available to the entry point role (${entryPoint}). Your role is ${role}.`);
+    console.error("");
+    console.error("   Entry point roles receive user messages and must classify them.");
+    console.error("   Other roles receive handoffs and should use:");
+    console.error(`   ${cliEnvPrefix}chatroom task-started --chatroom-id=${chatroomId} --role=${role} --task-id=<task-id> --no-classify`);
+    process.exit(1);
+  }
+  if (originMessageClassification === "new_feature") {
+    if (!rawStdin || rawStdin.trim().length === 0) {
+      console.error(`❌ new_feature classification requires stdin with feature metadata`);
+      console.error("   Provide structured stdin with TITLE, DESCRIPTION, and TECH_SPECS");
+      console.error("");
+      console.error("   Example:");
+      console.error(`   echo '---TITLE---
+Feature title
+---DESCRIPTION---
+What this feature does
+---TECH_SPECS---
+How to implement it' | ${classifyCommand({
+        chatroomId,
+        role,
+        taskId: "<task-id>",
+        classification: "new_feature",
+        cliEnvPrefix
+      })}`);
+      process.exit(1);
+    }
+  }
+  if (!taskId) {
+    console.error(`❌ --task-id is required for classify`);
+    console.error(`   Usage: ${classifyCommand({
+      chatroomId: "<chatroomId>",
+      role: "<role>",
+      taskId: "<task-id>",
+      classification: "question",
+      cliEnvPrefix
+    })}`);
+    process.exit(1);
+  }
+  const targetTask = await d.backend.query(api.tasks.getTask, {
+    sessionId,
+    chatroomId,
+    taskId
+  });
+  if (!targetTask) {
+    console.error(`❌ Task with ID "${taskId}" not found in this chatroom`);
+    console.error(`   Verify the task ID is correct and you have access to this chatroom`);
+    process.exit(1);
+  }
+  try {
+    await d.backend.mutation(api.tasks.startTask, {
+      sessionId,
+      chatroomId,
+      role,
+      taskId
+    });
+  } catch (error) {
+    const err = error;
+    console.error(`❌ Failed to start task`);
+    console.error(`   Error: ${err.message}`);
+    process.exit(1);
+  }
+  try {
+    const result = await d.backend.mutation(api.messages.taskStarted, {
+      sessionId,
+      chatroomId,
+      role,
+      taskId,
+      originMessageClassification,
+      convexUrl: d.session.getConvexUrl(),
+      ...rawStdin && { rawStdin }
+    });
+    console.log(`✅ Task acknowledged and classified`);
+    console.log(`   Classification: ${originMessageClassification}`);
+    console.log(`   Task: ${targetTask.content}`);
+    if (result.reminder) {
+      console.log(`
+\uD83D\uDCA1 ${result.reminder}`);
+    }
+  } catch (error) {
+    const err = error;
+    console.error(`❌ Failed to acknowledge task`);
+    console.error(`   Error: ${err.message}`);
+    if ("stack" in err && err.stack) {
+      const stackLines = err.stack.split(`
+`).slice(0, 5);
+      console.error(`   Stack trace:`);
+      stackLines.forEach((line) => console.error(`     ${line}`));
+    }
+    if (typeof error === "object" && error !== null && "data" in error) {
+      const errData = error.data;
+      if (errData) {
+        console.error(`   Server details:`, JSON.stringify(errData, null, 2));
+      }
+    }
+    process.exit(1);
+  }
+}
+var init_classify = __esm(() => {
+  init_env();
+  init_api3();
+  init_storage();
+  init_client2();
+});
+
 // src/utils/serialization/decode/index.ts
 var exports_decode = {};
 __export(exports_decode, {
@@ -12399,7 +12586,7 @@ var exports_handoff = {};
 __export(exports_handoff, {
   handoff: () => handoff
 });
-async function createDefaultDeps8() {
+async function createDefaultDeps9() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -12414,7 +12601,7 @@ async function createDefaultDeps8() {
   };
 }
 async function handoff(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps8();
+  const d = deps ?? await createDefaultDeps9();
   const { role, message, nextRole, attachedArtifactIds = [] } = options;
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
@@ -12447,7 +12634,7 @@ async function handoff(chatroomId, options, deps) {
   }
   let result;
   try {
-    result = await d.backend.mutation(api.messages.sendHandoff, {
+    result = await d.backend.mutation(api.messages.handoff, {
       sessionId,
       chatroomId,
       senderRole: role,
@@ -12548,7 +12735,7 @@ var exports_report_progress = {};
 __export(exports_report_progress, {
   reportProgress: () => reportProgress
 });
-async function createDefaultDeps9() {
+async function createDefaultDeps10() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -12563,7 +12750,7 @@ async function createDefaultDeps9() {
   };
 }
 async function reportProgress(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps9();
+  const d = deps ?? await createDefaultDeps10();
   const { role, message } = options;
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
@@ -12652,10 +12839,11 @@ __export(exports_backlog, {
   patchBacklog: () => patchBacklog,
   markForReviewBacklog: () => markForReviewBacklog,
   listBacklog: () => listBacklog,
+  historyBacklog: () => historyBacklog,
   completeBacklog: () => completeBacklog,
   addBacklog: () => addBacklog
 });
-async function createDefaultDeps10() {
+async function createDefaultDeps11() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -12684,174 +12872,111 @@ function validateChatroomId(chatroomId) {
   }
 }
 async function listBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
-  const validStatuses = [
-    "pending",
-    "acknowledged",
-    "in_progress",
-    "backlog",
-    "backlog_acknowledged",
-    "completed",
-    "closed",
-    "active",
-    "pending_review",
-    "archived",
-    "all"
-  ];
-  const statusFilter = options.status;
-  if (!statusFilter || !validStatuses.includes(statusFilter)) {
-    console.error(`❌ Invalid or missing status: ${statusFilter || "(none)"}. Must be one of: ${validStatuses.join(", ")}`);
-    process.exit(1);
-    return;
-  }
+  const limit = options.limit ?? 100;
   try {
-    const counts = await d.backend.query(api.tasks.getTaskCounts, {
+    const backlogItems = await d.backend.query(api.backlog.listBacklogItems, {
       sessionId,
-      chatroomId
+      chatroomId,
+      statusFilter: "active",
+      limit
     });
-    let tasks;
-    if (statusFilter === "active") {
-      tasks = await d.backend.query(api.tasks.listActiveTasks, {
-        sessionId,
-        chatroomId,
-        limit: options.limit || 100
-      });
-    } else if (statusFilter === "archived") {
-      tasks = await d.backend.query(api.tasks.listArchivedTasks, {
-        sessionId,
-        chatroomId,
-        limit: options.limit || 100
-      });
-    } else {
-      tasks = await d.backend.query(api.tasks.listTasks, {
-        sessionId,
-        chatroomId,
-        statusFilter: statusFilter === "all" ? undefined : statusFilter,
-        limit: options.limit || 100
-      });
-    }
     console.log("");
     console.log("══════════════════════════════════════════════════");
-    console.log("\uD83D\uDCCB TASK QUEUE");
+    console.log("\uD83D\uDCCB ACTIVE BACKLOG");
     console.log("══════════════════════════════════════════════════");
     console.log(`Chatroom: ${chatroomId}`);
-    console.log(`Filter: ${statusFilter}`);
     console.log("");
-    console.log("──────────────────────────────────────────────────");
-    console.log("\uD83D\uDCCA SUMMARY");
-    console.log("──────────────────────────────────────────────────");
-    if (counts.pending > 0)
-      console.log(`  \uD83D\uDFE2 Pending: ${counts.pending}`);
-    if (counts.in_progress > 0)
-      console.log(`  \uD83D\uDD35 In Progress: ${counts.in_progress}`);
-    if (counts.queued > 0)
-      console.log(`  \uD83D\uDFE1 Queued: ${counts.queued}`);
-    if (counts.backlog > 0)
-      console.log(`  ⚪ Backlog: ${counts.backlog}`);
-    const activeTotal = counts.pending + counts.in_progress + counts.queued + counts.backlog;
-    console.log(`  \uD83D\uDCDD Active Total: ${activeTotal}/100`);
-    console.log("");
-    if (tasks.length === 0) {
-      console.log("No tasks found.");
+    if (backlogItems.length === 0) {
+      console.log("No active backlog items.");
     } else {
       console.log("──────────────────────────────────────────────────");
-      console.log("\uD83D\uDCDD TASKS");
-      console.log("──────────────────────────────────────────────────");
-      for (let i2 = 0;i2 < tasks.length; i2++) {
-        const task = tasks[i2];
-        const statusEmoji = getStatusEmoji(task.status);
-        const date = new Date(task.createdAt).toLocaleString("en-US", {
+      for (let i2 = 0;i2 < backlogItems.length; i2++) {
+        const item = backlogItems[i2];
+        const statusEmoji = getStatusEmoji(item.status);
+        const date = new Date(item.createdAt).toLocaleString("en-US", {
           month: "short",
           day: "numeric",
           hour: "2-digit",
           minute: "2-digit",
           hour12: false
         });
-        const displayContent = task.content;
-        console.log(`#${i2 + 1} [${statusEmoji} ${task.status.toUpperCase()}] ${displayContent}`);
-        console.log(`   ID: ${task._id}`);
-        console.log(`   Created: ${date}${task.assignedTo ? ` | Assigned: ${task.assignedTo}` : ""}`);
+        console.log(`#${i2 + 1} [${statusEmoji} ${item.status.toUpperCase()}] ${item.content}`);
+        console.log(`   ID: ${item._id}`);
+        console.log(`   Created: ${date}${item.assignedTo ? ` | Assigned: ${item.assignedTo}` : ""}`);
+        if (item.complexity !== undefined || item.value !== undefined || item.priority !== undefined) {
+          const parts = [];
+          if (item.complexity)
+            parts.push(`complexity=${item.complexity}`);
+          if (item.value)
+            parts.push(`value=${item.value}`);
+          if (item.priority !== undefined)
+            parts.push(`priority=${item.priority}`);
+          console.log(`   Score: ${parts.join(" | ")}`);
+        }
         console.log("");
       }
     }
     console.log("──────────────────────────────────────────────────");
-    let totalForFilter;
-    if (statusFilter === "all") {
-      totalForFilter = counts.pending + counts.in_progress + counts.queued + counts.backlog + counts.pending_user_review + counts.completed + counts.closed;
-    } else if (statusFilter === "active") {
-      totalForFilter = counts.pending + counts.in_progress + counts.queued + counts.backlog;
-    } else if (statusFilter === "archived") {
-      totalForFilter = counts.completed + counts.closed;
-    } else if (statusFilter === "pending_review") {
-      totalForFilter = tasks.length;
-    } else {
-      totalForFilter = counts[statusFilter] ?? tasks.length;
-    }
-    if (tasks.length < totalForFilter) {
-      console.log(`Showing ${tasks.length} of ${totalForFilter} task(s) (use --limit=N to see more)`);
-    } else {
-      console.log(`Showing ${tasks.length} task(s)`);
-    }
+    console.log(`Showing ${backlogItems.length} backlog item(s)`);
     console.log("");
   } catch (error) {
-    console.error(`❌ Failed to list tasks: ${error.message}`);
+    console.error(`❌ Failed to list backlog items: ${error.message}`);
     process.exit(1);
     return;
   }
 }
 async function addBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
   if (!options.content || options.content.trim().length === 0) {
-    console.error(`❌ Task content cannot be empty`);
+    console.error(`❌ Backlog item content cannot be empty`);
     process.exit(1);
     return;
   }
   try {
-    const result = await d.backend.mutation(api.tasks.createTask, {
+    const itemId = await d.backend.mutation(api.backlog.createBacklogItem, {
       sessionId,
       chatroomId,
       content: options.content.trim(),
-      createdBy: options.role,
-      isBacklog: true
+      createdBy: options.role
     });
     console.log("");
-    console.log("✅ Task added to backlog");
-    console.log(`   ID: ${result.taskId}`);
-    console.log(`   Status: ${result.status}`);
-    console.log(`   Position: ${result.queuePosition}`);
+    console.log("✅ Backlog item added");
+    console.log(`   ID: ${itemId}`);
+    console.log(`   Status: backlog`);
     console.log("");
   } catch (error) {
-    console.error(`❌ Failed to add task: ${error.message}`);
+    console.error(`❌ Failed to add backlog item: ${error.message}`);
     process.exit(1);
     return;
   }
 }
 async function completeBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
-  if (!options.taskId || options.taskId.trim().length === 0) {
-    console.error(`❌ Task ID is required`);
+  if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
+    console.error(`❌ Backlog item ID is required`);
     process.exit(1);
     return;
   }
   try {
     const result = await d.backend.mutation(api.tasks.completeTaskById, {
       sessionId,
-      taskId: options.taskId,
+      taskId: options.backlogItemId,
       force: options.force
     });
     console.log("");
     if (result.wasForced) {
-      console.log("⚠️  Task force-completed (was in_progress or pending)");
+      console.log("⚠️  Backlog item force-completed (was in_progress or pending)");
     } else {
-      console.log("✅ Task completed");
+      console.log("✅ Backlog item completed");
     }
-    console.log(`   ID: ${options.taskId}`);
+    console.log(`   ID: ${options.backlogItemId}`);
     if (result.promoted) {
       console.log(`   \uD83D\uDCE4 Next task promoted: ${result.promoted}`);
       console.log("");
@@ -12859,44 +12984,44 @@ async function completeBacklog(chatroomId, options, deps) {
     }
     console.log("");
   } catch (error) {
-    console.error(`❌ Failed to complete task: ${error.message}`);
+    console.error(`❌ Failed to complete backlog item: ${error.message}`);
     process.exit(1);
     return;
   }
 }
 async function reopenBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
-  if (!options.taskId || options.taskId.trim().length === 0) {
-    console.error(`❌ Task ID is required`);
+  if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
+    console.error(`❌ Backlog item ID is required`);
     process.exit(1);
     return;
   }
   try {
-    await d.backend.mutation(api.tasks.reopenBacklogTask, {
+    await d.backend.mutation(api.backlog.reopenBacklogItem, {
       sessionId,
-      taskId: options.taskId
+      itemId: options.backlogItemId
     });
     console.log("");
-    console.log("✅ Task reopened");
-    console.log(`   ID: ${options.taskId}`);
-    console.log(`   Status: pending_user_review`);
+    console.log("✅ Backlog item reopened");
+    console.log(`   ID: ${options.backlogItemId}`);
+    console.log(`   Status: backlog`);
     console.log("");
-    console.log("\uD83D\uDCA1 The task is now ready for user review again.");
+    console.log("\uD83D\uDCA1 The backlog item is now ready for user review again.");
     console.log("");
   } catch (error) {
-    console.error(`❌ Failed to reopen task: ${error.message}`);
+    console.error(`❌ Failed to reopen backlog item: ${error.message}`);
     process.exit(1);
     return;
   }
 }
 async function patchBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
-  if (!options.taskId || options.taskId.trim().length === 0) {
-    console.error(`❌ Task ID is required`);
+  if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
+    console.error(`❌ Backlog item ID is required`);
     process.exit(1);
     return;
   }
@@ -12927,16 +13052,16 @@ async function patchBacklog(chatroomId, options, deps) {
     }
   }
   try {
-    await d.backend.mutation(api.tasks.patchTask, {
+    await d.backend.mutation(api.backlog.patchBacklogItem, {
       sessionId,
-      taskId: options.taskId,
+      itemId: options.backlogItemId,
       complexity: options.complexity,
       value: options.value,
       priority: priorityNum
     });
     console.log("");
-    console.log("✅ Task updated");
-    console.log(`   ID: ${options.taskId}`);
+    console.log("✅ Backlog item updated");
+    console.log(`   ID: ${options.backlogItemId}`);
     if (options.complexity !== undefined) {
       console.log(`   Complexity: ${options.complexity}`);
     }
@@ -12948,23 +13073,23 @@ async function patchBacklog(chatroomId, options, deps) {
     }
     console.log("");
   } catch (error) {
-    console.error(`❌ Failed to patch task: ${error.message}`);
+    console.error(`❌ Failed to patch backlog item: ${error.message}`);
     process.exit(1);
     return;
   }
 }
 async function scoreBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
-  if (!options.taskId || options.taskId.trim().length === 0) {
-    console.error(`❌ Task ID is required`);
+  if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
+    console.error(`❌ Backlog item ID is required`);
     process.exit(1);
     return;
   }
   if (options.complexity === undefined && options.value === undefined && options.priority === undefined) {
     console.error(`❌ At least one of --complexity, --value, or --priority is required`);
-    console.error(`   Example: chatroom backlog score --task-id=... --complexity=medium --value=high`);
+    console.error(`   Example: chatroom backlog score --backlog-item-id=... --complexity=medium --value=high`);
     process.exit(1);
     return;
   }
@@ -12990,16 +13115,16 @@ async function scoreBacklog(chatroomId, options, deps) {
     }
   }
   try {
-    await d.backend.mutation(api.tasks.patchTask, {
+    await d.backend.mutation(api.backlog.patchBacklogItem, {
       sessionId,
-      taskId: options.taskId,
+      itemId: options.backlogItemId,
       complexity: options.complexity,
       value: options.value,
       priority: priorityNum
     });
     console.log("");
-    console.log("✅ Task scored");
-    console.log(`   ID: ${options.taskId}`);
+    console.log("✅ Backlog item scored");
+    console.log(`   ID: ${options.backlogItemId}`);
     if (options.complexity !== undefined) {
       console.log(`   Complexity: ${options.complexity}`);
     }
@@ -13011,34 +13136,129 @@ async function scoreBacklog(chatroomId, options, deps) {
     }
     console.log("");
   } catch (error) {
-    console.error(`❌ Failed to score task: ${error.message}`);
+    console.error(`❌ Failed to score backlog item: ${error.message}`);
     process.exit(1);
     return;
   }
 }
 async function markForReviewBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
-  if (!options.taskId || options.taskId.trim().length === 0) {
-    console.error(`❌ Task ID is required`);
+  if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
+    console.error(`❌ Backlog item ID is required`);
     process.exit(1);
     return;
   }
   try {
-    await d.backend.mutation(api.tasks.markBacklogForReview, {
+    await d.backend.mutation(api.backlog.markBacklogItemForReview, {
       sessionId,
-      taskId: options.taskId
+      itemId: options.backlogItemId
     });
     console.log("");
-    console.log("✅ Task marked for review");
-    console.log(`   ID: ${options.taskId}`);
+    console.log("✅ Backlog item marked for review");
+    console.log(`   ID: ${options.backlogItemId}`);
     console.log(`   Status: pending_user_review`);
     console.log("");
-    console.log('\uD83D\uDCA1 The task is now visible in the "Pending Review" section for user confirmation.');
+    console.log('\uD83D\uDCA1 The backlog item is now visible in the "Pending Review" section for user confirmation.');
+    console.log("");
+  } catch (error) {
+    console.error(`❌ Failed to mark backlog item for review: ${error.message}`);
+    process.exit(1);
+    return;
+  }
+}
+async function historyBacklog(chatroomId, options, deps) {
+  const d = deps ?? await createDefaultDeps11();
+  const sessionId = requireAuth2(d);
+  validateChatroomId(chatroomId);
+  const now = Date.now();
+  const defaultFrom = now - 30 * 24 * 60 * 60 * 1000;
+  let fromMs;
+  let toMs;
+  if (options.from) {
+    const parsed = Date.parse(options.from);
+    if (isNaN(parsed)) {
+      console.error(`❌ Invalid --from date: "${options.from}". Use YYYY-MM-DD format.`);
+      process.exit(1);
+      return;
+    }
+    fromMs = parsed;
+  }
+  if (options.to) {
+    const parsed = Date.parse(options.to);
+    if (isNaN(parsed)) {
+      console.error(`❌ Invalid --to date: "${options.to}". Use YYYY-MM-DD format.`);
+      process.exit(1);
+      return;
+    }
+    toMs = parsed + 86399999;
+  }
+  try {
+    const tasks = await d.backend.query(api.tasks.listHistoricalTasks, {
+      sessionId,
+      chatroomId,
+      from: fromMs,
+      to: toMs,
+      limit: options.limit
+    });
+    const fromDate = new Date(fromMs ?? defaultFrom).toLocaleDateString("en-US", {
+      month: "short",
+      day: "numeric",
+      year: "numeric"
+    });
+    const toDate = new Date(toMs ?? now).toLocaleDateString("en-US", {
+      month: "short",
+      day: "numeric",
+      year: "numeric"
+    });
+    console.log("");
+    console.log("══════════════════════════════════════════════════");
+    console.log("\uD83D\uDCDC TASK HISTORY");
+    console.log("══════════════════════════════════════════════════");
+    console.log(`Chatroom: ${chatroomId}`);
+    console.log(`Date range: ${fromDate} → ${toDate}`);
+    console.log(`Filter: completed + closed`);
+    console.log("");
+    if (tasks.length === 0) {
+      console.log("No history found for date range.");
+    } else {
+      console.log("──────────────────────────────────────────────────");
+      console.log("\uD83D\uDCDD COMPLETED / CLOSED TASKS");
+      console.log("──────────────────────────────────────────────────");
+      for (let i2 = 0;i2 < tasks.length; i2++) {
+        const task = tasks[i2];
+        const statusEmoji = getStatusEmoji(task.status);
+        const completedTs = task.completedAt ?? task.updatedAt;
+        const date = new Date(completedTs).toLocaleString("en-US", {
+          month: "short",
+          day: "numeric",
+          year: "numeric",
+          hour: "2-digit",
+          minute: "2-digit",
+          hour12: false
+        });
+        console.log(`#${i2 + 1} [${statusEmoji} ${task.status.toUpperCase()}] ${task.content}`);
+        console.log(`   ID: ${task._id}`);
+        console.log(`   Completed: ${date}${task.assignedTo ? ` | Assigned: ${task.assignedTo}` : ""}`);
+        if (task.complexity !== undefined || task.value !== undefined || task.priority !== undefined) {
+          const parts = [];
+          if (task.complexity)
+            parts.push(`complexity=${task.complexity}`);
+          if (task.value)
+            parts.push(`value=${task.value}`);
+          if (task.priority !== undefined)
+            parts.push(`priority=${task.priority}`);
+          console.log(`   Score: ${parts.join(" | ")}`);
+        }
+        console.log("");
+      }
+    }
+    console.log("──────────────────────────────────────────────────");
+    console.log(`Showing ${tasks.length} task(s)`);
     console.log("");
   } catch (error) {
-    console.error(`❌ Failed to mark task for review: ${error.message}`);
+    console.error(`❌ Failed to load history: ${error.message}`);
     process.exit(1);
     return;
   }
@@ -13053,8 +13273,6 @@ function getStatusEmoji(status) {
       return "\uD83D\uDD35";
     case "backlog":
       return "⚪";
-    case "backlog_acknowledged":
-      return "\uD83D\uDCCB";
     case "completed":
       return "✅";
     case "pending_user_review":
@@ -13100,13 +13318,99 @@ function resolveContent(content, filePath, optionName) {
 }
 var init_file_content = () => {};
 
+// src/commands/task/read/index.ts
+var exports_read = {};
+__export(exports_read, {
+  taskRead: () => taskRead
+});
+async function createDefaultDeps12() {
+  const client2 = await getConvexClient();
+  return {
+    backend: {
+      mutation: (endpoint, args) => client2.mutation(endpoint, args),
+      query: (endpoint, args) => client2.query(endpoint, args)
+    },
+    session: {
+      getSessionId,
+      getConvexUrl,
+      getOtherSessionUrls
+    }
+  };
+}
+async function taskRead(chatroomId, options, deps) {
+  const d = deps ?? await createDefaultDeps12();
+  const { role, taskId } = options;
+  const convexUrl = d.session.getConvexUrl();
+  const sessionId = d.session.getSessionId();
+  if (!sessionId) {
+    const otherUrls = d.session.getOtherSessionUrls();
+    console.error(`❌ Not authenticated for: ${convexUrl}`);
+    if (otherUrls.length > 0) {
+      console.error(`
+\uD83D\uDCA1 You have sessions for other environments:`);
+      for (const url of otherUrls) {
+        console.error(`   • ${url}`);
+      }
+      console.error(`
+   To use a different environment, set CHATROOM_CONVEX_URL:`);
+      console.error(`   CHATROOM_CONVEX_URL=${otherUrls[0]} chatroom task read ...`);
+      console.error(`
+   Or to authenticate for the current environment:`);
+    }
+    console.error(`   chatroom auth login`);
+    process.exit(1);
+  }
+  if (!chatroomId || typeof chatroomId !== "string" || chatroomId.length < 20 || chatroomId.length > 40) {
+    console.error(`❌ Invalid chatroom ID format: ID must be 20-40 characters (got ${chatroomId?.length || 0})`);
+    process.exit(1);
+  }
+  if (!taskId || typeof taskId !== "string" || taskId.length < 20 || taskId.length > 40) {
+    console.error(`❌ Invalid task ID format: ID must be 20-40 characters (got ${taskId?.length || 0})`);
+    process.exit(1);
+  }
+  try {
+    const result = await d.backend.mutation(api.tasks.readTask, {
+      sessionId,
+      chatroomId,
+      role,
+      taskId
+    });
+    console.log(`✅ Task content:`);
+    console.log(`   Task ID: ${result.taskId}`);
+    console.log(`   Status: ${result.status}`);
+    console.log(`
+${result.content}`);
+  } catch (error) {
+    const err = error;
+    console.error(`❌ Failed to read task`);
+    console.error(`   Error: ${err.message}`);
+    if (err.message.includes("not found")) {
+      console.error(`
+   Verify the task ID is correct and you have access to this chatroom.`);
+    } else if (err.message.includes("assigned to")) {
+      console.error(`
+   This task is not assigned to your role. Use the correct --role flag.`);
+    } else if (err.message.includes("acknowledged")) {
+      console.error(`
+   Tasks must be in 'acknowledged' status to be read.`);
+      console.error(`   If this task is already in_progress, this might be a recovery situation.`);
+    }
+    process.exit(1);
+  }
+}
+var init_read = __esm(() => {
+  init_api3();
+  init_storage();
+  init_client2();
+});
+
 // src/commands/skill/index.ts
 var exports_skill = {};
 __export(exports_skill, {
   listSkills: () => listSkills,
   activateSkill: () => activateSkill
 });
-async function createDefaultDeps11() {
+async function createDefaultDeps13() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13129,7 +13433,7 @@ function requireAuth3(d) {
   return sessionId;
 }
 async function listSkills(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps11();
+  const d = deps ?? await createDefaultDeps13();
   const sessionId = requireAuth3(d);
   try {
     const skills = await d.backend.query(api.skills.list, {
@@ -13157,7 +13461,7 @@ async function listSkills(chatroomId, options, deps) {
   }
 }
 async function activateSkill(chatroomId, skillId, options, deps) {
-  const d = deps ?? await createDefaultDeps11();
+  const d = deps ?? await createDefaultDeps13();
   const sessionId = requireAuth3(d);
   try {
     const convexUrl = d.session.getConvexUrl();
@@ -13195,7 +13499,7 @@ __export(exports_messages, {
   listSinceMessage: () => listSinceMessage,
   listBySenderRole: () => listBySenderRole
 });
-async function createDefaultDeps12() {
+async function createDefaultDeps14() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13210,7 +13514,7 @@ async function createDefaultDeps12() {
   };
 }
 async function listBySenderRole(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps12();
+  const d = deps ?? await createDefaultDeps14();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     console.error(`❌ Not authenticated. Please run: chatroom auth login`);
@@ -13275,7 +13579,7 @@ ${content.split(`
   }
 }
 async function listSinceMessage(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps12();
+  const d = deps ?? await createDefaultDeps14();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     console.error(`❌ Not authenticated. Please run: chatroom auth login`);
@@ -13351,7 +13655,7 @@ __export(exports_context, {
   listContexts: () => listContexts,
   inspectContext: () => inspectContext
 });
-async function createDefaultDeps13() {
+async function createDefaultDeps15() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13366,7 +13670,7 @@ async function createDefaultDeps13() {
   };
 }
 async function readContext(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps13();
+  const d = deps ?? await createDefaultDeps15();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     console.error(`❌ Not authenticated. Please run: chatroom auth login`);
@@ -13481,7 +13785,7 @@ async function readContext(chatroomId, options, deps) {
   }
 }
 async function newContext(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps13();
+  const d = deps ?? await createDefaultDeps15();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     console.error(`❌ Not authenticated. Please run: chatroom auth login`);
@@ -13533,7 +13837,7 @@ async function newContext(chatroomId, options, deps) {
   }
 }
 async function listContexts(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps13();
+  const d = deps ?? await createDefaultDeps15();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     console.error(`❌ Not authenticated. Please run: chatroom auth login`);
@@ -13585,7 +13889,7 @@ async function listContexts(chatroomId, options, deps) {
   }
 }
 async function inspectContext(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps13();
+  const d = deps ?? await createDefaultDeps15();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     console.error(`❌ Not authenticated. Please run: chatroom auth login`);
@@ -13645,7 +13949,7 @@ __export(exports_guidelines, {
   viewGuidelines: () => viewGuidelines,
   listGuidelineTypes: () => listGuidelineTypes
 });
-async function createDefaultDeps14() {
+async function createDefaultDeps16() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13660,7 +13964,7 @@ async function createDefaultDeps14() {
   };
 }
 async function viewGuidelines(options, deps) {
-  const d = deps ?? await createDefaultDeps14();
+  const d = deps ?? await createDefaultDeps16();
   const { type } = options;
   if (!VALID_TYPES.includes(type)) {
     console.error(`❌ Invalid guideline type: "${type}"`);
@@ -13695,7 +13999,7 @@ ${"═".repeat(60)}
   }
 }
 async function listGuidelineTypes(deps) {
-  const d = deps ?? await createDefaultDeps14();
+  const d = deps ?? await createDefaultDeps16();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     console.error(`❌ Not authenticated. Please run: chatroom auth login`);
@@ -13737,7 +14041,7 @@ __export(exports_artifact, {
   viewArtifact: () => viewArtifact,
   createArtifact: () => createArtifact
 });
-async function createDefaultDeps15() {
+async function createDefaultDeps17() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13752,7 +14056,7 @@ async function createDefaultDeps15() {
   };
 }
 async function createArtifact(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps15();
+  const d = deps ?? await createDefaultDeps17();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     formatAuthError(d.session.getConvexUrl(), d.session.getOtherSessionUrls());
@@ -13806,7 +14110,7 @@ async function createArtifact(chatroomId, options, deps) {
   }
 }
 async function viewArtifact(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps15();
+  const d = deps ?? await createDefaultDeps17();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     formatAuthError(d.session.getConvexUrl(), d.session.getOtherSessionUrls());
@@ -13850,7 +14154,7 @@ async function viewArtifact(chatroomId, options, deps) {
   }
 }
 async function viewManyArtifacts(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps15();
+  const d = deps ?? await createDefaultDeps17();
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
     formatAuthError(d.session.getConvexUrl(), d.session.getOtherSessionUrls());
@@ -13916,7 +14220,7 @@ var exports_get_system_prompt = {};
 __export(exports_get_system_prompt, {
   getSystemPrompt: () => getSystemPrompt
 });
-async function createDefaultDeps16() {
+async function createDefaultDeps18() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13931,7 +14235,7 @@ async function createDefaultDeps16() {
   };
 }
 async function getSystemPrompt(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps16();
+  const d = deps ?? await createDefaultDeps18();
   const { role } = options;
   const sessionId = d.session.getSessionId();
   if (!sessionId) {
@@ -14453,7 +14757,7 @@ async function discoverModels(agentServices) {
   }
   return results;
 }
-function createDefaultDeps17() {
+function createDefaultDeps19() {
   return {
     backend: {
       mutation: async () => {
@@ -14591,7 +14895,7 @@ async function initDaemon() {
   const agentServices = new Map(getAllHarnesses().map((s) => [s.id, s]));
   const availableModels = await registerCapabilities(client2, typedSessionId, config3, agentServices);
   await connectDaemon(client2, typedSessionId, machineId, convexUrl);
-  const deps = createDefaultDeps17();
+  const deps = createDefaultDeps19();
   deps.backend.mutation = (endpoint, args) => client2.mutation(endpoint, args);
   deps.backend.query = (endpoint, args) => client2.query(endpoint, args);
   const events = new DaemonEventBus;
@@ -15657,7 +15961,7 @@ async function isChatroomInstalledDefault() {
     return false;
   }
 }
-async function createDefaultDeps18() {
+async function createDefaultDeps20() {
   const client2 = await getConvexClient();
   const fs = await import("fs/promises");
   return {
@@ -15685,7 +15989,7 @@ async function createDefaultDeps18() {
   };
 }
 async function installTool(options = {}, deps) {
-  const d = deps ?? await createDefaultDeps18();
+  const d = deps ?? await createDefaultDeps20();
   const { checkExisting = true } = options;
   const os = await import("os");
   const path2 = await import("path");
@@ -16189,7 +16493,8 @@ program2.command("get-next-task").description("Join a chatroom and get the next
     role: options.role
   });
 });
-program2.command("task-started").description("Acknowledge a task and optionally classify the user message").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--origin-message-classification <type>", "Original message classification: question, new_feature, or follow_up (for entry point roles)").option("--no-classify", "Skip classification (for handoff recipients - classification already done by entry point)").requiredOption("--task-id <taskId>", "Task ID to acknowledge").action(async (options) => {
+program2.command("task-started").description("[LEGACY] Acknowledge a task and optionally classify the user message. Use classify instead for entry-point roles.").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--origin-message-classification <type>", "Original message classification: question, new_feature, or follow_up (for entry point roles)").option("--no-classify", "Skip classification (for handoff recipients - classification already done by entry point)").requiredOption("--task-id <taskId>", "Task ID to acknowledge").action(async (options) => {
+  console.error("⚠️  DEPRECATED: task-started is legacy. Use chatroom classify for entry-point roles.");
   await maybeRequireAuth();
   const skipClassification = options.classify === false;
   if (!skipClassification && !options.originMessageClassification) {
@@ -16238,6 +16543,36 @@ program2.command("task-started").description("Acknowledge a task and optionally
     noClassify: skipClassification
   });
 });
+program2.command("classify").description("Classify a task's origin message (entry-point role only). Use task-started --no-classify for handoffs.").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role (must be entry-point role)").requiredOption("--task-id <taskId>", "Task ID to acknowledge").requiredOption("--origin-message-classification <type>", "Original message classification: question, new_feature, or follow_up").action(async (options) => {
+  await maybeRequireAuth();
+  const validClassifications = ["question", "new_feature", "follow_up"];
+  if (!validClassifications.includes(options.originMessageClassification)) {
+    console.error(`❌ Invalid classification: ${options.originMessageClassification}. Must be one of: ${validClassifications.join(", ")}`);
+    process.exit(1);
+  }
+  let rawStdin;
+  if (options.originMessageClassification === "new_feature") {
+    const stdinContent = await readStdin();
+    if (!stdinContent.trim()) {
+      console.error(`❌ Stdin is empty. For new_feature classification, provide:
+---TITLE---
+[title]
+---DESCRIPTION---
+[description]
+---TECH_SPECS---
+[specs]`);
+      process.exit(1);
+    }
+    rawStdin = stdinContent;
+  }
+  const { classify: classify2 } = await Promise.resolve().then(() => (init_classify(), exports_classify));
+  await classify2(options.chatroomId, {
+    role: options.role,
+    originMessageClassification: options.originMessageClassification,
+    taskId: options.taskId,
+    rawStdin
+  });
+});
 program2.command("handoff").description("Complete your task and hand off to the next role").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--next-role <nextRole>", "Role to hand off to").option("--attach-artifact <artifactId>", "Attach artifact to handoff (can be used multiple times)", (value, previous) => {
   return previous ? [...previous, value] : [value];
 }, []).action(async (options) => {
@@ -16294,22 +16629,15 @@ program2.command("report-progress").description("Report progress on current task
   });
 });
 var backlogCommand = program2.command("backlog").description("Manage task queue and backlog");
-backlogCommand.command("list").description("List tasks in a chatroom").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--status <status>", "Filter by status (pending|in_progress|backlog|completed|cancelled|active|pending_review|archived|all)").option("--limit <n>", "Maximum number of tasks to show (required for --status=all)").option("--full", "Show full task content without truncation").action(async (options) => {
-  if (options.status === "all" && !options.limit) {
-    console.error("❌ When using --status=all, you must specify --limit=<n>");
-    console.error("   Example: chatroom backlog list --chatroom-id=<id> --role=builder --status=all --limit=50");
-    process.exit(1);
-  }
+backlogCommand.command("list").description("List active backlog items").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--limit <n>", "Maximum number of items to show").action(async (options) => {
   await maybeRequireAuth();
   const { listBacklog: listBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
   await listBacklog2(options.chatroomId, {
     role: options.role,
-    status: options.status,
-    limit: options.limit ? parseInt(options.limit, 10) : 20,
-    full: options.full
+    limit: options.limit ? parseInt(options.limit, 10) : undefined
   });
 });
-backlogCommand.command("add").description("Add a task to the backlog").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role (creator)").requiredOption("--content-file <path>", "Path to file containing task content").action(async (options) => {
+backlogCommand.command("add").description("Add a backlog item").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role (creator)").requiredOption("--content-file <path>", "Path to file containing task content").action(async (options) => {
   await maybeRequireAuth();
   const { readFileContent: readFileContent2 } = await Promise.resolve().then(() => (init_file_content(), exports_file_content));
   let content;
@@ -16326,31 +16654,42 @@ backlogCommand.command("add").description("Add a task to the backlog").requiredO
   const { addBacklog: addBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
   await addBacklog2(options.chatroomId, { role: options.role, content });
 });
-backlogCommand.command("complete").description("Mark a task as complete. Use --force for stuck in_progress/pending tasks.").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--task-id <taskId>", "Task ID to complete").option("-f, --force", "Force complete a stuck in_progress or pending task").action(async (options) => {
+backlogCommand.command("complete").description("Mark a backlog item as complete. Use --force for stuck in_progress/pending tasks.").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--backlog-item-id <id>", "Backlog item ID to complete").option("-f, --force", "Force complete a stuck in_progress or pending task").action(async (options) => {
   await maybeRequireAuth();
   const { completeBacklog: completeBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
   await completeBacklog2(options.chatroomId, options);
 });
-backlogCommand.command("reopen").description("Reopen a completed backlog task, returning it to pending_user_review status.").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--task-id <taskId>", "Task ID to reopen").action(async (options) => {
+backlogCommand.command("reopen").description("Reopen a closed backlog item, returning it to backlog status.").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--backlog-item-id <id>", "Backlog item ID to reopen").action(async (options) => {
   await maybeRequireAuth();
   const { reopenBacklog: reopenBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
   await reopenBacklog2(options.chatroomId, options);
 });
-backlogCommand.command("patch-task").description("Update task scoring fields (complexity, value, priority)").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--task-id <taskId>", "Task ID to patch").option("--complexity <level>", "Complexity level (low|medium|high)").option("--value <level>", "Value level (low|medium|high)").option("--priority <n>", "Priority number (higher = more important)").action(async (options) => {
-  await maybeRequireAuth();
-  const { patchBacklog: patchBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
-  await patchBacklog2(options.chatroomId, options);
-});
-backlogCommand.command("score").description("Score a backlog task by complexity, value, and priority").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--task-id <taskId>", "Task ID to score").option("--complexity <level>", "Complexity level: low, medium, high").option("--value <level>", "Value level: low, medium, high").option("--priority <n>", "Priority number (higher = more important)").action(async (options) => {
+backlogCommand.command("score").description("Score a backlog item by complexity, value, and priority").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--backlog-item-id <id>", "Backlog item ID to score").option("--complexity <level>", "Complexity level: low, medium, high").option("--value <level>", "Value level: low, medium, high").option("--priority <n>", "Priority number (higher = more important)").action(async (options) => {
   await maybeRequireAuth();
   const { scoreBacklog: scoreBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
   await scoreBacklog2(options.chatroomId, options);
 });
-backlogCommand.command("mark-for-review").description("Mark a backlog task as ready for user review (backlog → pending_user_review)").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--task-id <taskId>", "Task ID to mark for review").action(async (options) => {
+backlogCommand.command("mark-for-review").description("Mark a backlog item as ready for user review (backlog → pending_user_review)").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--backlog-item-id <id>", "Backlog item ID to mark for review").action(async (options) => {
   await maybeRequireAuth();
   const { markForReviewBacklog: markForReviewBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
   await markForReviewBacklog2(options.chatroomId, options);
 });
+backlogCommand.command("history").description("View completed and closed backlog items by date range (all statuses)").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--from <date>", "Start date (YYYY-MM-DD), defaults to 30 days ago").option("--to <date>", "End date (YYYY-MM-DD), defaults to today").option("--limit <n>", "Maximum number of items to show").action(async (options) => {
+  await maybeRequireAuth();
+  const { historyBacklog: historyBacklog2 } = await Promise.resolve().then(() => (init_backlog(), exports_backlog));
+  await historyBacklog2(options.chatroomId, {
+    role: options.role,
+    from: options.from,
+    to: options.to,
+    limit: options.limit ? parseInt(options.limit, 10) : undefined
+  });
+});
+var taskCommand = program2.command("task").description("Manage tasks");
+taskCommand.command("read").description("Read a task and mark it as in_progress").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role in the chatroom").requiredOption("--task-id <taskId>", "Task ID to read").action(async (options) => {
+  await maybeRequireAuth();
+  const { taskRead: taskRead2 } = await Promise.resolve().then(() => (init_read(), exports_read));
+  await taskRead2(options.chatroomId, { role: options.role, taskId: options.taskId });
+});
 var skillCommand = program2.command("skill").description("Manage and activate chatroom skills");
 skillCommand.command("list").description("List available skills for a chatroom").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").action(async (options) => {
   await maybeRequireAuth();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatroom-cli",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "CLI for multi-agent chatroom collaboration",
   "type": "module",
   "bin": {