chatroom-cli 1.9.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) {
@@ -12656,7 +12843,7 @@ __export(exports_backlog, {
   completeBacklog: () => completeBacklog,
   addBacklog: () => addBacklog
 });
-async function createDefaultDeps10() {
+async function createDefaultDeps11() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -12685,7 +12872,7 @@ 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 limit = options.limit ?? 100;
@@ -12742,7 +12929,7 @@ async function listBacklog(chatroomId, options, deps) {
   }
 }
 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) {
@@ -12769,7 +12956,7 @@ async function addBacklog(chatroomId, options, deps) {
   }
 }
 async function completeBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
   if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
@@ -12803,7 +12990,7 @@ async function completeBacklog(chatroomId, options, deps) {
   }
 }
 async function reopenBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
   if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
@@ -12830,7 +13017,7 @@ async function reopenBacklog(chatroomId, options, deps) {
   }
 }
 async function patchBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
   if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
@@ -12892,7 +13079,7 @@ async function patchBacklog(chatroomId, options, deps) {
   }
 }
 async function scoreBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
   if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
@@ -12955,7 +13142,7 @@ async function scoreBacklog(chatroomId, options, deps) {
   }
 }
 async function markForReviewBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
   if (!options.backlogItemId || options.backlogItemId.trim().length === 0) {
@@ -12982,7 +13169,7 @@ async function markForReviewBacklog(chatroomId, options, deps) {
   }
 }
 async function historyBacklog(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps10();
+  const d = deps ?? await createDefaultDeps11();
   const sessionId = requireAuth2(d);
   validateChatroomId(chatroomId);
   const now = Date.now();
@@ -13131,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: {
@@ -13160,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, {
@@ -13188,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();
@@ -13226,7 +13499,7 @@ __export(exports_messages, {
   listSinceMessage: () => listSinceMessage,
   listBySenderRole: () => listBySenderRole
 });
-async function createDefaultDeps12() {
+async function createDefaultDeps14() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13241,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`);
@@ -13306,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`);
@@ -13382,7 +13655,7 @@ __export(exports_context, {
   listContexts: () => listContexts,
   inspectContext: () => inspectContext
 });
-async function createDefaultDeps13() {
+async function createDefaultDeps15() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13397,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`);
@@ -13512,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`);
@@ -13564,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`);
@@ -13616,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`);
@@ -13676,7 +13949,7 @@ __export(exports_guidelines, {
   viewGuidelines: () => viewGuidelines,
   listGuidelineTypes: () => listGuidelineTypes
 });
-async function createDefaultDeps14() {
+async function createDefaultDeps16() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13691,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}"`);
@@ -13726,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`);
@@ -13768,7 +14041,7 @@ __export(exports_artifact, {
   viewArtifact: () => viewArtifact,
   createArtifact: () => createArtifact
 });
-async function createDefaultDeps15() {
+async function createDefaultDeps17() {
   const client2 = await getConvexClient();
   return {
     backend: {
@@ -13783,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());
@@ -13837,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());
@@ -13881,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());
@@ -13947,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: {
@@ -13962,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) {
@@ -14484,7 +14757,7 @@ async function discoverModels(agentServices) {
   }
   return results;
 }
-function createDefaultDeps17() {
+function createDefaultDeps19() {
   return {
     backend: {
       mutation: async () => {
@@ -14622,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;
@@ -15688,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 {
@@ -15716,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");
@@ -16220,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) {
@@ -16269,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) => {
@@ -16380,6 +16684,12 @@ backlogCommand.command("history").description("View completed and closed backlog
     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.9.0",
+  "version": "1.10.0",
   "description": "CLI for multi-agent chatroom collaboration",
   "type": "module",
   "bin": {