chatroom-cli 1.8.0 → 1.9.0

package/dist/index.js

@@ -12652,6 +12652,7 @@ __export(exports_backlog, {
   patchBacklog: () => patchBacklog,
   markForReviewBacklog: () => markForReviewBacklog,
   listBacklog: () => listBacklog,
+  historyBacklog: () => historyBacklog,
   completeBacklog: () => completeBacklog,
   addBacklog: () => addBacklog
 });
@@ -12687,116 +12688,55 @@ async function listBacklog(chatroomId, options, deps) {
   const d = deps ?? await createDefaultDeps10();
   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;
   }
@@ -12806,26 +12746,24 @@ async function addBacklog(chatroomId, options, deps) {
   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;
   }
@@ -12834,24 +12772,24 @@ async function completeBacklog(chatroomId, options, deps) {
   const d = deps ?? await createDefaultDeps10();
   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,7 +12797,7 @@ 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;
   }
@@ -12868,25 +12806,25 @@ async function reopenBacklog(chatroomId, options, deps) {
   const d = deps ?? await createDefaultDeps10();
   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;
   }
@@ -12895,8 +12833,8 @@ async function patchBacklog(chatroomId, options, deps) {
   const d = deps ?? await createDefaultDeps10();
   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 +12865,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,7 +12886,7 @@ 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;
   }
@@ -12957,14 +12895,14 @@ async function scoreBacklog(chatroomId, options, deps) {
   const d = deps ?? await createDefaultDeps10();
   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 +12928,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,7 +12949,7 @@ 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;
   }
@@ -13020,25 +12958,120 @@ async function markForReviewBacklog(chatroomId, options, deps) {
   const d = deps ?? await createDefaultDeps10();
   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 task for review: ${error.message}`);
+    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 createDefaultDeps10();
+  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 load history: ${error.message}`);
     process.exit(1);
     return;
   }
@@ -13053,8 +13086,6 @@ function getStatusEmoji(status) {
       return "\uD83D\uDD35";
     case "backlog":
       return "⚪";
-    case "backlog_acknowledged":
-      return "\uD83D\uDCCB";
     case "completed":
       return "✅";
     case "pending_user_review":
@@ -16294,22 +16325,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 +16350,36 @@ 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 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.9.0",
   "description": "CLI for multi-agent chatroom collaboration",
   "type": "module",
   "bin": {