chatroom-cli 1.75.0 → 1.77.0

package/dist/index.js

@@ -76767,7 +76767,8 @@ var init_participant = __esm(() => {
     "task.inProgress",
     "task.completed",
     "agent.requestStop",
-    "agent.awaitingHandoff"
+    "agent.awaitingHandoff",
+    "agent.enhancing"
   ]);
 });
 
@@ -77365,6 +77366,38 @@ var init_builder_to_planner = __esm(() => {
   init_role_guidance_disclosure();
 });
 
+// ../../services/backend/prompts/teams/duo/handoff-templates/enhancer-to-planner.ts
+function getEnhancerToPlannerHandoffTemplate() {
+  return `${getHandoffRecipientVisibilityCallout("planner")}
+
+${getHandoffReportTemplateIntro("Planning Feedback (Enhancer → Planner)")}
+
+The planner sent you three XML sections: \`<user-message>\`, \`<grounding>\`, and a draft \`<builder-handoff>\`. Your job is **critical review** of all three — tighten their thinking toward a high-quality eventual handoff to the user. Do not explore the codebase or invent new scope.
+
+\`\`\`markdown
+## Summary
+<one paragraph: overall assessment of the planner's check-in — strengths and the main gaps to address>
+
+## User intent assessment
+<mistakes or misreadings in what the user may want; clarify the correct interpretation>
+
+## Knowledge gaps
+<facts, context, or research the planner is missing or has not surfaced>
+
+## Reasoning & logic
+<logical errors, weak inference chains, contradictions, or unsupported conclusions>
+
+## Alignment with user handoff
+<how to tighten the research and conclusions so the eventual planner→user report will be accurate, complete, and well-justified>
+
+## Recommended next steps
+<concrete actions for the planner: what to research, revise, validate, or decide before proceeding>
+\`\`\`
+
+Return only the feedback markdown — no preamble. Follow this structure; omit sections that truly do not apply.`;
+}
+var init_enhancer_to_planner = () => {};
+
 // ../../services/backend/prompts/teams/duo/handoff-templates/planner-to-builder.ts
 function getPlannerToBuilderHandoffTemplate(nativeIntegration = false) {
   const sessionManagement = nativeIntegration ? `\`compact\` runs in-session context compaction via the SDK runtime. \`new_session\` starts a completely new session within the same process (not compaction). \`none\` continues the prior session. Tasks continue via injection.` : `\`compact\` is NOT supported — use \`none\` or \`new_session\`. \`new_session\` requires a hard restart (daemon stops agent, cold-starts, agent rejoins via \`get-next-task\`). \`none\` resumes prior session (\`wantResume=true\`).`;
@@ -77449,6 +77482,41 @@ Keep one slice ≈ one focused review surface. Delegate slices incrementally —
 }
 var init_planner_to_builder = () => {};
 
+// ../../services/backend/prompts/teams/duo/handoff-templates/planner-to-enhancer.ts
+function getPlannerToEnhancerHandoffTemplate() {
+  return `${getHandoffRecipientVisibilityCallout("enhancer")}
+
+**Mandatory Planning Check-in (Planner → Enhancer)** — paste into the handoff message. **Do not skip this check-in** when the enhancer is enabled.
+
+The enhancer has **no session context** — only this message. Use the three XML sections below **exactly** — they delimit what the enhancer will review.
+
+\`\`\`markdown
+<user-message>
+<verbatim or faithful quote of the user's request — include constraints, priorities, and classification context if relevant>
+</user-message>
+
+<grounding>
+<fully detailed research the enhancer cannot see from your session — be exhaustive>
+
+Include:
+- **Existing code examples** — relevant snippets, patterns, and conventions already in the codebase
+- **File references** — paths to every file you investigated or plan to change
+- **Technology choices** — libraries, frameworks, APIs, and why they apply here
+- **Observations** — what you learned, edge cases, risks, and open questions from investigation
+${getFileReferenceGuidanceComment()}
+</grounding>
+
+<builder-handoff>
+<your complete, filled-in Delegation Brief for builder review — every section with real content, not placeholders>
+
+Follow the **Handoff to \`builder\`** template structure (Summary, Goal, Files to implement, Requirements, etc.). The enhancer critiques this draft before you delegate.
+</builder-handoff>
+\`\`\`
+
+After the enhancer returns feedback, you will receive it as a new planner task. Revise grounding and the builder handoff as needed, then proceed to \`builder\` or \`user\` as appropriate.`;
+}
+var init_planner_to_enhancer = () => {};
+
 // ../../services/backend/prompts/cli/context/read.ts
 function contextReadCommand(params = {}) {
   const prefix = params.cliEnvPrefix ?? "";
@@ -77540,8 +77608,11 @@ ${CODE_CHANGE_VERIFICATION_CONFIRMATION}
 
 ${getUnresolvedDecisionsSectionBlock()}
 
-## Notes / Next steps
-<anything the user should know, follow-ups, or open questions>
+## Notes
+<anything the user should know — context, caveats, or observations not covered above. Omit if none.>
+
+## Next steps
+<follow-up actions for the user or team. Omit if none.>
 \`\`\``;
 }
 var init_planner_to_user = __esm(() => {
@@ -77558,10 +77629,14 @@ function getDuoHandoffTemplate(query) {
 var DUO_HANDOFF_TEMPLATES;
 var init_handoff_templates = __esm(() => {
   init_builder_to_planner();
+  init_enhancer_to_planner();
   init_planner_to_builder();
+  init_planner_to_enhancer();
   init_planner_to_user();
   DUO_HANDOFF_TEMPLATES = {
     "planner:builder": (query) => getPlannerToBuilderHandoffTemplate(query.nativeIntegration),
+    "planner:enhancer": () => getPlannerToEnhancerHandoffTemplate(),
+    "enhancer:planner": () => getEnhancerToPlannerHandoffTemplate(),
     "planner:user": (query) => getPlannerToUserReportTemplate({
       chatroomId: query.chatroomId,
       role: query.role,
@@ -77638,8 +77713,11 @@ ${CODE_CHANGE_VERIFICATION_CONFIRMATION}
 
 ${getUnresolvedDecisionsSectionBlock()}
 
-## Notes / Next steps
-<anything the user should know, follow-ups, or open questions>
+## Notes
+<anything the user should know — context, caveats, or observations not covered above. Omit if none.>
+
+## Next steps
+<follow-up actions for the user or team. Omit if none.>
 \`\`\``;
 }
 var init_solo_to_user = __esm(() => {
@@ -80380,11 +80458,33 @@ function composeSystemPrompt2(input) {
   });
   return composeSections(buildInitPromptSections(input, selectorCtx));
 }
+function isEnhancerCheckInQueuedHandoff(params) {
+  return params.enhancerCheckInQueued === true && params.role.toLowerCase() === "planner" && params.nextRole.toLowerCase() === "enhancer";
+}
+function getEnhancerCheckInQueuedConfirmationLines() {
+  return [
+    "✅ Planning check-in queued for handoff enhancer",
+    "",
+    "Your check-in was sent to the handoff enhancer (async). You will receive planning feedback back as a planner task when review completes.",
+    "**Run get-next-task now and end your turn** — do not wait for feedback, poll, or re-submit the handoff."
+  ];
+}
 function generateHandoffOutput(params) {
-  const { role, nextRole, chatroomId, convexUrl, supportsNativeIntegration } = params;
+  const {
+    role,
+    nextRole,
+    chatroomId,
+    convexUrl,
+    supportsNativeIntegration,
+    enhancerCheckInQueued
+  } = params;
   const cliEnvPrefix = getCliEnvPrefix(convexUrl);
   const lines = [];
-  lines.push(`✅ Chatroom task completed and handed off to ${nextRole}`);
+  if (isEnhancerCheckInQueuedHandoff({ role, nextRole, enhancerCheckInQueued })) {
+    lines.push(...getEnhancerCheckInQueuedConfirmationLines());
+  } else {
+    lines.push(`✅ Chatroom task completed and handed off to ${nextRole}`);
+  }
   if (supportsNativeIntegration) {
     lines.push(getNativeHandoffTurnEndGuidance(nextRole));
   } else {
@@ -103343,7 +103443,6 @@ class BufferedJournalFactory {
         return;
       flushInProgress = true;
       const batch = buffer.splice(0);
-      console.log(`[journal] Flushing ${batch.length} chunks for session ${harnessSessionId}`);
       outputRepository.appendChunks(harnessSessionId, batch).catch((err) => {
         buffer.unshift(...batch);
         logger.warn(`[journal] Flush FAILED for ${harnessSessionId}: ${err instanceof Error ? err.message : String(err)}`);
@@ -103362,7 +103461,6 @@ class BufferedJournalFactory {
           messageId: chunk2.messageId,
           partType: chunk2.partType
         });
-        logger.log?.(`[journal] chunk recorded session=${harnessSessionId} messageId=${chunk2.messageId ?? "-"} partType=${chunk2.partType ?? "text"} bytes=${chunk2.content.length}`);
       },
       async flush() {
         await waitForInProgress();
@@ -103788,6 +103886,19 @@ var init_start_subscriptions2 = __esm(() => {
 // src/commands/machine/daemon-start/enhancer/constants.ts
 var ENHANCER_AGENT_ROLE = "enhancer";
 
+// src/commands/machine/daemon-start/enhancer/enhancer-log.ts
+function formatEnhancerLogLine(message) {
+  const trimmed = message.trimEnd();
+  if (trimmed.startsWith(ENHANCER_LOG_PREFIX))
+    return trimmed;
+  return `${ENHANCER_LOG_PREFIX} ${trimmed}`;
+}
+function writeEnhancerLog(message) {
+  process.stdout.write(`${formatEnhancerLogLine(message)}
+`);
+}
+var ENHANCER_LOG_PREFIX = "[enhancer]";
+
 // src/commands/machine/daemon-start/enhancer/job-subscriber.ts
 function startEnhancerJobSubscriber(sessionId, machineId, convexUrl, backend2, wsClient2, agentServices) {
   const inFlight = new Set;
@@ -103809,12 +103920,14 @@ function startEnhancerJobSubscriber(sessionId, machineId, convexUrl, backend2, w
           if (!claim.claimed)
             return;
           claimed = true;
+          writeEnhancerLog(`claimed job=${job.jobId} chatroom=${job.chatroomId}`);
           const payload = await backend2.query(api.daemon.enhancer.index.getSpawnPayload, {
             sessionId,
             jobId: job.jobId
           });
           chatroomId = payload.chatroomId;
           jobId = payload.jobId;
+          writeEnhancerLog(`spawning harness=${payload.agentHarness} model=${payload.model} job=${payload.jobId}`);
           const service3 = agentServices.get(payload.agentHarness);
           if (!service3) {
             await backend2.mutation(api.web.enhancer.index.recordAttemptFailure, {
@@ -103838,8 +103951,11 @@ function startEnhancerJobSubscriber(sessionId, machineId, convexUrl, backend2, w
             resolvedConvexUrl: convexUrl
           });
           spawnResult.onLogLine?.((line) => {
-            process.stdout.write(`${line}
-`);
+            writeEnhancerLog(line);
+          });
+          spawnResult.onAssistantText?.((text) => {
+            if (text)
+              writeEnhancerLog(`text] ${text}`);
           });
           await new Promise((resolve4) => {
             spawnResult.onExit(() => resolve4());
@@ -103849,6 +103965,9 @@ function startEnhancerJobSubscriber(sessionId, machineId, convexUrl, backend2, w
             chatroomId: payload.chatroomId,
             jobId: payload.jobId
           });
+          if (status3?.status === "complete") {
+            writeEnhancerLog(`completed job=${payload.jobId}`);
+          }
           if (status3?.status === "running") {
             await backend2.mutation(api.web.enhancer.index.recordAttemptFailure, {
               sessionId,
@@ -103858,7 +103977,7 @@ function startEnhancerJobSubscriber(sessionId, machineId, convexUrl, backend2, w
             });
           }
         } catch (err) {
-          console.warn("[enhancer] spawn error:", err instanceof Error ? err.message : String(err));
+          writeEnhancerLog(`error: ${err instanceof Error ? err.message : String(err)}`);
           if (claimed) {
             await backend2.mutation(api.web.enhancer.index.recordAttemptFailure, {
               sessionId,
@@ -115642,7 +115761,7 @@ handoffCommandGroup.requiredOption("--chatroom-id <id>", "Chatroom identifier").
     console.error("❌ Message is empty");
     process.exit(1);
   }
-  const shouldEnhance = options.role.toLowerCase() === "planner" && options.nextRole.toLowerCase() === "builder";
+  const shouldEnhance = options.role.toLowerCase() === "planner" && options.nextRole.toLowerCase() === "enhancer";
   if (shouldEnhance) {
     const { api: api3 } = await Promise.resolve().then(() => (init_api3(), exports_api));
     const { getConvexClient: getConvexClient2 } = await Promise.resolve().then(() => (init_client2(), exports_client));
@@ -115670,7 +115789,8 @@ handoffCommandGroup.requiredOption("--chatroom-id <id>", "Chatroom identifier").
             role: options.role,
             nextRole: options.nextRole,
             chatroomId: options.chatroomId,
-            convexUrl
+            convexUrl,
+            enhancerCheckInQueued: true
           }));
           return;
         }
@@ -115678,7 +115798,7 @@ handoffCommandGroup.requiredOption("--chatroom-id <id>", "Chatroom identifier").
         const error51 = err;
         if (error51?.data?.code !== "ENHANCER_NOT_ENABLED") {
           console.error(`
-❌ ERROR: Enhancer interception failed`);
+❌ ERROR: Enhancer check-in failed`);
           console.error(`
 ${error51?.data?.message ?? err.message}`);
           process.exit(1);
@@ -116027,4 +116147,4 @@ program2.hook("preAction", async (_thisCommand, actionCommand) => {
 });
 program2.parse();
 
-//# debugId=84E53044E3B850A464756E2164756E21
+//# debugId=94A8E14D18276BBD64756E2164756E21