chatroom-cli 1.0.73 → 1.0.75

package/dist/index.js

@@ -10707,7 +10707,6 @@ var init_new_feature = () => {};
 var init_classification = __esm(() => {
   init_new_feature();
 });
-
 // ../../services/backend/prompts/base/cli/task-started/main-prompt.ts
 var init_main_prompt = () => {};
 
@@ -10718,9 +10717,6 @@ var init_task_started = __esm(() => {
 });
 
 // ../../services/backend/prompts/base/cli/wait-for-task/reminder.ts
-function getWaitForTaskReminder() {
-  return "Message availability is critical: Use `wait-for-task` in the foreground to stay connected, otherwise your team cannot reach you";
-}
 function getWaitForTaskGuidance() {
   return `\uD83D\uDD17 STAYING CONNECTED TO YOUR TEAM
 
@@ -10736,11 +10732,11 @@ Two requirements:
 
 2. **Blocking execution** - Wait for command completion
    • Do not respond to user or perform other work while running
-   • Only proceed after the command exits (timeout or task received)
+   • Only proceed after the command exits (signal or task received)
 
-⏱️  UNDERSTANDING TIMEOUTS
-• Timeouts are normal and expected - they keep agents responsive
-• When the command terminates:
+⚠️  WHEN THE PROCESS IS TERMINATED OR TIMED OUT
+• Your harness may kill long-running commands after a set duration
+• When the command terminates unexpectedly:
   1. Do you have urgent pending work?
   2. Without wait-for-task, your team cannot reach you
   3. If no urgent work, reconnect immediately
@@ -10813,9 +10809,8 @@ function waitForTaskCommand(params) {
 }
 
 // src/config.ts
-var DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_ACTIVE_TIMEOUT_MS, WEB_SERVER_PORT;
+var DEFAULT_ACTIVE_TIMEOUT_MS, WEB_SERVER_PORT;
 var init_config2 = __esm(() => {
-  DEFAULT_WAIT_TIMEOUT_MS = 10 * 60 * 1000;
   DEFAULT_ACTIVE_TIMEOUT_MS = 60 * 60 * 1000;
   WEB_SERVER_PORT = parseInt(process.env.WEB_PORT || "3456", 10);
 });
@@ -10823,38 +10818,11 @@ var init_config2 = __esm(() => {
 // src/commands/wait-for-task.ts
 var exports_wait_for_task = {};
 __export(exports_wait_for_task, {
-  waitForTask: () => waitForTask,
-  parseDuration: () => parseDuration
+  waitForTask: () => waitForTask
 });
-function parseDuration(duration) {
-  const match = duration.trim().match(/^(\d+(?:\.\d+)?)\s*(s|sec|second|seconds|m|min|minute|minutes|h|hr|hour|hours)?$/i);
-  if (!match)
-    return null;
-  const value = parseFloat(match[1]);
-  const unit = (match[2] || "s").toLowerCase();
-  switch (unit) {
-    case "s":
-    case "sec":
-    case "second":
-    case "seconds":
-      return value * 1000;
-    case "m":
-    case "min":
-    case "minute":
-    case "minutes":
-      return value * 60 * 1000;
-    case "h":
-    case "hr":
-    case "hour":
-    case "hours":
-      return value * 60 * 60 * 1000;
-    default:
-      return null;
-  }
-}
 async function waitForTask(chatroomId, options) {
   const client2 = await getConvexClient();
-  const { role, timeout, silent } = options;
+  const { role, silent } = options;
   const convexUrl = getConvexUrl();
   const cliEnvPrefix = getCliEnvPrefix(convexUrl);
   const sessionId = getSessionId();
@@ -10931,14 +10899,11 @@ async function waitForTask(chatroomId, options) {
       console.warn(`⚠️  Machine registration failed: ${machineError.message}`);
     }
   }
-  const effectiveTimeout = timeout || DEFAULT_WAIT_TIMEOUT_MS;
-  const readyUntil = Date.now() + effectiveTimeout;
   const connectionId = `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
   await client2.mutation(api.participants.join, {
     sessionId,
     chatroomId,
     role,
-    readyUntil,
     connectionId
   });
   const connectionTime = new Date().toISOString().replace("T", " ").substring(0, 19);
@@ -10976,22 +10941,6 @@ async function waitForTask(chatroomId, options) {
   } catch {}
   let taskProcessed = false;
   let unsubscribe = null;
-  const timeoutHandle = setTimeout(() => {
-    if (unsubscribe)
-      unsubscribe();
-    const timeoutTime = new Date().toISOString().replace("T", " ").substring(0, 19);
-    console.log(`
-${"─".repeat(50)}`);
-    console.log(`⚠️  RECONNECTION REQUIRED
-`);
-    console.log(`[${timeoutTime}] Why: Session timeout reached (normal and expected behavior)`);
-    console.log(`Impact: You are no longer listening for tasks`);
-    console.log(`Action: Run this command immediately to resume availability
-`);
-    console.log(waitForTaskCommand({ chatroomId, role, cliEnvPrefix }));
-    console.log(`${"─".repeat(50)}`);
-    process.exit(0);
-  }, effectiveTimeout);
   const handlePendingTasks = async (pendingTasks) => {
     if (taskProcessed)
       return;
@@ -11003,7 +10952,6 @@ ${"─".repeat(50)}`);
     if (currentConnectionId && currentConnectionId !== connectionId) {
       if (unsubscribe)
         unsubscribe();
-      clearTimeout(timeoutHandle);
       const takeoverTime = new Date().toISOString().replace("T", " ").substring(0, 19);
       console.log(`
 ${"─".repeat(50)}`);
@@ -11023,15 +10971,26 @@ ${"─".repeat(50)}`);
       return;
     }
     const { task, message } = taskWithMessage;
-    try {
-      await client2.mutation(api.tasks.claimTask, {
-        sessionId,
-        chatroomId,
-        role
-      });
-    } catch (_claimError) {
-      console.log(`\uD83D\uDD04 Task already claimed by another agent, continuing to wait...`);
-      return;
+    if (task.status === "acknowledged") {
+      const acknowledgedAt = task.acknowledgedAt || task.updatedAt;
+      const elapsedMs = Date.now() - acknowledgedAt;
+      const RECOVERY_GRACE_PERIOD_MS = 60 * 1000;
+      if (elapsedMs < RECOVERY_GRACE_PERIOD_MS) {
+        const remainingSec = Math.ceil((RECOVERY_GRACE_PERIOD_MS - elapsedMs) / 1000);
+        console.log(`\uD83D\uDD04 Task was recently acknowledged (${remainingSec}s remaining). ` + `Re-run wait-for-task in 1 minute to recover it if the other agent is unresponsive.`);
+        return;
+      }
+    } else {
+      try {
+        await client2.mutation(api.tasks.claimTask, {
+          sessionId,
+          chatroomId,
+          role
+        });
+      } catch (_claimError) {
+        console.log(`\uD83D\uDD04 Task already claimed by another agent, continuing to wait...`);
+        return;
+      }
     }
     taskProcessed = true;
     if (message) {
@@ -11043,7 +11002,6 @@ ${"─".repeat(50)}`);
     }
     if (unsubscribe)
       unsubscribe();
-    clearTimeout(timeoutHandle);
     const activeUntil = Date.now() + DEFAULT_ACTIVE_TIMEOUT_MS;
     await client2.mutation(api.participants.updateStatus, {
       sessionId,
@@ -11064,126 +11022,7 @@ ${"─".repeat(50)}`);
     console.log(`
 [${taskReceivedTime}] \uD83D\uDCE8 Task received!
 `);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`\uD83C\uDD94 TASK INFORMATION`);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`Task ID: ${task._id}`);
-    if (message) {
-      console.log(`Message ID: ${message._id}`);
-    }
-    console.log(`
-\uD83D\uDCCB NEXT STEPS`);
-    console.log(`${"=".repeat(60)}`);
-    const isUserMessage = message && message.senderRole.toLowerCase() === "user";
-    if (isUserMessage) {
-      console.log(`To acknowledge and classify this message, run:
-`);
-      const baseCmd = taskStartedCommand({
-        chatroomId,
-        role,
-        taskId: task._id,
-        classification: "question",
-        cliEnvPrefix
-      }).replace("--origin-message-classification=question", "--origin-message-classification=<type>");
-      console.log(baseCmd);
-      console.log(`
-\uD83D\uDCDD Classification Requirements:`);
-      console.log(`   • question: No additional fields required`);
-      console.log(`   • follow_up: No additional fields required`);
-      console.log(`   • new_feature: REQUIRES --title, --description, --tech-specs`);
-      console.log(`
-\uD83D\uDCA1 Example for new_feature:`);
-      console.log(taskStartedCommand({
-        chatroomId,
-        role,
-        taskId: task._id,
-        classification: "new_feature",
-        title: "<title>",
-        description: "<description>",
-        techSpecs: "<tech-specs>",
-        cliEnvPrefix
-      }));
-      console.log(`
-Classification types: question, new_feature, follow_up`);
-    } else if (message) {
-      console.log(`Task handed off from ${message.senderRole}.`);
-      console.log(`The original user message was already classified - you can start work immediately.`);
-    } else {
-      console.log(`No message found. Task ID: ${task._id}`);
-    }
-    console.log(`${"=".repeat(60)}`);
-    console.log(`
-<!-- CONTEXT: Available Actions & Role Instructions`);
-    console.log(taskDeliveryPrompt.humanReadable);
-    console.log(`-->`);
-    const originMessage = taskDeliveryPrompt.json?.contextWindow?.originMessage;
-    console.log(`
-${"=".repeat(60)}`);
-    console.log(`\uD83D\uDCCD PINNED - Work on this immediately`);
-    console.log(`${"=".repeat(60)}`);
-    if (originMessage && originMessage.senderRole.toLowerCase() === "user") {
-      console.log(`
-## User Message`);
-      console.log(`<user-message>`);
-      console.log(originMessage.content);
-      if (originMessage.attachedTasks && originMessage.attachedTasks.length > 0) {
-        console.log(`
-ATTACHED BACKLOG (${originMessage.attachedTasks.length})`);
-        for (const attachedTask of originMessage.attachedTasks) {
-          console.log(`${attachedTask.content}`);
-        }
-      }
-      const followUpCount = taskDeliveryPrompt.json?.contextWindow?.followUpCountSinceOrigin ?? 0;
-      const originCreatedAt = taskDeliveryPrompt.json?.contextWindow?.originMessageCreatedAt;
-      if (followUpCount >= 5) {
-        console.log(`
-⚠️  WARNING: ${followUpCount} follow-up messages since this pinned message.`);
-        console.log(`   The user may have moved on to a different topic.`);
-        console.log(`   Consider asking if this context is still relevant.`);
-      }
-      if (originCreatedAt) {
-        const ageMs = Date.now() - originCreatedAt;
-        const ageHours = ageMs / (1000 * 60 * 60);
-        if (ageHours >= 24) {
-          const ageDays = Math.floor(ageHours / 24);
-          console.log(`
-⚠️  WARNING: This pinned message is ${ageDays} day(s) old.`);
-          console.log(`   The context may be outdated.`);
-        }
-      }
-      console.log(`</user-message>`);
-    }
-    console.log(`
-## Task`);
-    console.log(task.content);
-    const existingClassification = originMessage?.classification;
-    if (existingClassification) {
-      console.log(`
-Classification: ${existingClassification.toUpperCase()}`);
-    }
-    console.log(`
-${"=".repeat(60)}`);
-    console.log(`\uD83D\uDCCB PROCESS`);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`
-1. Mark task as started:`);
-    if (isUserMessage) {
-      console.log(`   ${taskStartedCommand({ chatroomId, role, taskId: task._id, classification: "follow_up", cliEnvPrefix })}`);
-    } else {
-      console.log(`   ${cliEnvPrefix}chatroom task-started --chatroom-id=${chatroomId} --role=${role} --task-id=${task._id} --no-classify`);
-    }
-    console.log(`
-2. Do the work`);
-    console.log(`
-3. Hand off when complete:`);
-    console.log(`   ${cliEnvPrefix}chatroom handoff --chatroom-id=${chatroomId} --role=${role} --next-role=<target>`);
-    console.log(`
-4. Resume listening:`);
-    console.log(`   ${waitForTaskCommand({ chatroomId, role, cliEnvPrefix })}`);
-    console.log(`
-${"=".repeat(60)}`);
-    console.log(getWaitForTaskReminder());
-    console.log(`${"=".repeat(60)}`);
+    console.log(taskDeliveryPrompt.fullCliOutput);
     process.exit(0);
   };
   const wsClient2 = await getConvexWsClient();
@@ -11199,7 +11038,6 @@ ${"=".repeat(60)}`);
   const handleSignal = (_signal) => {
     if (unsubscribe)
       unsubscribe();
-    clearTimeout(timeoutHandle);
     const signalTime = new Date().toISOString().replace("T", " ").substring(0, 19);
     console.log(`
 ${"─".repeat(50)}`);
@@ -12475,7 +12313,10 @@ var init_messages = __esm(() => {
 // src/commands/context.ts
 var exports_context = {};
 __export(exports_context, {
-  readContext: () => readContext
+  readContext: () => readContext,
+  newContext: () => newContext,
+  listContexts: () => listContexts,
+  inspectContext: () => inspectContext
 });
 async function readContext(chatroomId, options) {
   const client2 = await getConvexClient();
@@ -12571,6 +12412,136 @@ async function readContext(chatroomId, options) {
     process.exit(1);
   }
 }
+async function newContext(chatroomId, options) {
+  const client2 = await getConvexClient();
+  const sessionId = getSessionId();
+  if (!sessionId) {
+    console.error(`❌ Not authenticated. Please run: 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 (!options.content || options.content.trim().length === 0) {
+    console.error(`❌ Context content cannot be empty`);
+    process.exit(1);
+  }
+  try {
+    const contextId = await client2.mutation(api.contexts.createContext, {
+      sessionId,
+      chatroomId,
+      content: options.content,
+      role: options.role
+    });
+    console.log(`✅ Context created successfully`);
+    console.log(`   Context ID: ${contextId}`);
+    console.log(`   Created by: ${options.role}`);
+    console.log(`
+\uD83D\uDCCC This context is now pinned for all agents in this chatroom.`);
+  } catch (err) {
+    console.error(`❌ Failed to create context: ${err.message}`);
+    process.exit(1);
+  }
+}
+async function listContexts(chatroomId, options) {
+  const client2 = await getConvexClient();
+  const sessionId = getSessionId();
+  if (!sessionId) {
+    console.error(`❌ Not authenticated. Please run: 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);
+  }
+  try {
+    const contexts = await client2.query(api.contexts.listContexts, {
+      sessionId,
+      chatroomId,
+      limit: options.limit ?? 10
+    });
+    if (contexts.length === 0) {
+      console.log(`
+\uD83D\uDCED No contexts found for this chatroom`);
+      console.log(`
+\uD83D\uDCA1 Create a context with:`);
+      console.log(`   chatroom context new --chatroom-id=${chatroomId} --role=${options.role} --content="Your context summary"`);
+      return;
+    }
+    console.log(`
+\uD83D\uDCDA CONTEXTS (${contexts.length} found)`);
+    console.log("═".repeat(60));
+    for (const context of contexts) {
+      const timestamp = new Date(context.createdAt).toLocaleString();
+      console.log(`
+\uD83D\uDD39 Context ID: ${context._id}`);
+      console.log(`   Created by: ${context.createdBy}`);
+      console.log(`   Created at: ${timestamp}`);
+      if (context.messageCountAtCreation !== undefined) {
+        console.log(`   Messages at creation: ${context.messageCountAtCreation}`);
+      }
+      console.log(`   Content:`);
+      const truncatedContent = context.content.length > 200 ? context.content.slice(0, 200) + "..." : context.content;
+      console.log(truncatedContent.split(`
+`).map((l) => `      ${l}`).join(`
+`));
+    }
+    console.log(`
+` + "═".repeat(60));
+  } catch (err) {
+    console.error(`❌ Failed to list contexts: ${err.message}`);
+    process.exit(1);
+  }
+}
+async function inspectContext(chatroomId, options) {
+  const client2 = await getConvexClient();
+  const sessionId = getSessionId();
+  if (!sessionId) {
+    console.error(`❌ Not authenticated. Please run: chatroom auth login`);
+    process.exit(1);
+  }
+  try {
+    const context = await client2.query(api.contexts.getContext, {
+      sessionId,
+      contextId: options.contextId
+    });
+    console.log(`
+\uD83D\uDCCB CONTEXT DETAILS`);
+    console.log("═".repeat(60));
+    console.log(`
+\uD83D\uDD39 Context ID: ${context._id}`);
+    console.log(`   Created by: ${context.createdBy}`);
+    console.log(`   Created at: ${new Date(context.createdAt).toLocaleString()}`);
+    console.log(`
+\uD83D\uDCCA Staleness:`);
+    console.log(`   Messages since context: ${context.messagesSinceContext}`);
+    console.log(`   Time elapsed: ${context.elapsedHours.toFixed(1)} hours`);
+    if (context.messagesSinceContext >= 10) {
+      console.log(`
+⚠️  Many messages since this context was created.`);
+      console.log(`   Consider creating a new context with an updated summary.`);
+    }
+    if (context.elapsedHours >= 24) {
+      console.log(`
+⚠️  This context is over 24 hours old.`);
+      console.log(`   Consider creating a new context with an updated summary.`);
+    }
+    console.log(`
+\uD83D\uDCDD Content:`);
+    console.log("─".repeat(60));
+    console.log(context.content);
+    console.log("─".repeat(60));
+    console.log(`
+\uD83D\uDCA1 To create a new context:`);
+    console.log(`   chatroom context new --chatroom-id=${chatroomId} --role=${options.role} --content="Your updated summary"`);
+    console.log(`
+` + "═".repeat(60));
+  } catch (err) {
+    console.error(`❌ Failed to inspect context: ${err.message}`);
+    process.exit(1);
+  }
+}
 var init_context = __esm(() => {
   init_api3();
   init_storage();
@@ -13972,24 +13943,11 @@ program2.command("register-agent").description("Register agent type for a chatro
     type: options.type
   });
 });
-program2.command("wait-for-task").description("Join a chatroom and wait for tasks").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Role to join as (e.g., builder, reviewer)").option("--timeout <ms>", "Optional timeout in milliseconds (deprecated, use --duration)").option("--duration <duration>", 'How long to wait (e.g., "1m", "5m", "30s")').action(async (options) => {
+program2.command("wait-for-task").description("Join a chatroom and wait for tasks").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Role to join as (e.g., builder, reviewer)").action(async (options) => {
   await maybeRequireAuth();
-  const { waitForTask: waitForTask2, parseDuration: parseDuration2 } = await Promise.resolve().then(() => (init_wait_for_task(), exports_wait_for_task));
-  let timeoutMs;
-  if (options.duration) {
-    const parsed = parseDuration2(options.duration);
-    if (parsed === null) {
-      console.error(`❌ Invalid duration format: "${options.duration}". Use formats like "1m", "5m", "30s".`);
-      process.exit(1);
-    }
-    timeoutMs = parsed;
-  } else if (options.timeout) {
-    timeoutMs = parseInt(options.timeout, 10);
-  }
+  const { waitForTask: waitForTask2 } = await Promise.resolve().then(() => (init_wait_for_task(), exports_wait_for_task));
   await waitForTask2(options.chatroomId, {
-    role: options.role,
-    timeout: timeoutMs,
-    duration: options.duration
+    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) => {
@@ -14194,12 +14152,45 @@ messagesCommand.command("list").description("List messages by sender role or sin
     });
   }
 });
-var contextCommand = program2.command("context").description("Get chatroom context and state");
+var contextCommand = program2.command("context").description("Manage chatroom context and state (explicit context management)");
 contextCommand.command("read").description("Read context for your role (conversation history, tasks, status)").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").action(async (options) => {
   await maybeRequireAuth();
   const { readContext: readContext2 } = await Promise.resolve().then(() => (init_context(), exports_context));
   await readContext2(options.chatroomId, options);
 });
+contextCommand.command("new").description("Create a new context and pin it for all agents").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role (creator of the context)").option("--content <content>", "Context summary/description (alternative: provide via stdin/heredoc)").action(async (options) => {
+  await maybeRequireAuth();
+  let content;
+  if (options.content && options.content.trim().length > 0) {
+    content = options.content.trim();
+  } else {
+    const stdinContent = await readStdin();
+    if (!stdinContent.trim()) {
+      console.error("❌ Context content cannot be empty.");
+      console.error('   Provide content via --content="..." or stdin (heredoc):');
+      console.error("   chatroom context new --chatroom-id=<id> --role=<role> << 'EOF'");
+      console.error("   Your context summary here");
+      console.error("   EOF");
+      process.exit(1);
+    }
+    content = stdinContent.trim();
+  }
+  const { newContext: newContext2 } = await Promise.resolve().then(() => (init_context(), exports_context));
+  await newContext2(options.chatroomId, { ...options, content });
+});
+contextCommand.command("list").description("List recent contexts for a chatroom").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--limit <n>", "Maximum number of contexts to show (default: 10)").action(async (options) => {
+  await maybeRequireAuth();
+  const { listContexts: listContexts2 } = await Promise.resolve().then(() => (init_context(), exports_context));
+  await listContexts2(options.chatroomId, {
+    role: options.role,
+    limit: options.limit ? parseInt(options.limit, 10) : 10
+  });
+});
+contextCommand.command("inspect").description("View a specific context with staleness information").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").requiredOption("--context-id <contextId>", "Context ID to inspect").action(async (options) => {
+  await maybeRequireAuth();
+  const { inspectContext: inspectContext2 } = await Promise.resolve().then(() => (init_context(), exports_context));
+  await inspectContext2(options.chatroomId, options);
+});
 var guidelinesCommand = program2.command("guidelines").description("View review guidelines by type");
 guidelinesCommand.command("view").description("View guidelines for a specific review type").requiredOption("--type <type>", "Guideline type (coding|security|design|performance|all)").action(async (options) => {
   await maybeRequireAuth();

package/package.json

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