harnessed 3.4.4 → 3.5.0

package/dist/cli.mjs

@@ -853,7 +853,7 @@ var init_resume = __esm({
 
 // package.json
 var package_default = {
-  version: "3.4.4"};
+  version: "3.5.0"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -2648,7 +2648,14 @@ var COMPLETION_SCHEMA = {
     status: { type: "string", enum: ["COMPLETE", "PARTIAL", "BLOCKED"] },
     phase: { type: "string", enum: ["01-clarify", "02-code", "03-test", "04-deliver"] },
     summary: { type: "string" },
-    blockers: { type: "array", items: { type: "string" } }
+    blockers: { type: "array", items: { type: "string" } },
+    // v3.5.0 Phase 2 — Option 1-Lite signal-driven Agent Teams escalation.
+    // spawned subagent SHOULD set this when any of parallelism-gate.yaml 5
+    // upgrade triggers fire. harnessed runtime propagates to stderr hint;
+    // user opens team in main Claude Code session (TeamCreate not exposed to
+    // spawned subagents via SDK v0.3.142 — see PHASE-2-SPEC.md § Why).
+    needs_teams_escalation: { type: "boolean" },
+    escalation_reason: { type: "string" }
   },
   required: ["status", "phase"]
 };
@@ -3171,12 +3178,28 @@ async function runMasterOrchestrator(masterName, context, packageRoot, spawnDriv
 var MASTER_NAMES = ["discuss", "plan", "task", "verify", "auto"];
 var RALPH_DEFAULT_MAX_ITER = 20;
 var RALPH_HARD_UPPER_LIMIT = 100;
+var ESCALATION_RULES = `If during this task you detect ANY of the following 5 conditions, set \`needs_teams_escalation: true\` in your structured output and fill \`escalation_reason\` with the trigger name + one-sentence specifics. These are signals to the human user in the main Claude Code session \u2014 do NOT attempt to call TeamCreate/SendMessage/TeamDelete yourself (those tools are not available to you).
+
+Five triggers (any one suffices):
+
+1. **teammate_send_message_needed** \u2014 the task requires two or more subagents to exchange messages mid-task (e.g., reconciling API contract proposals across frontend and backend), not just fan-out + report.
+
+2. **subagent_context_overflow** \u2014 your context budget is filling and a separate subagent is needed to take over a portion of the work.
+
+3. **shared_task_list** \u2014 multiple subagents need to coordinate self-assignment from a shared task list (not pre-partitioned work).
+
+4. **opposing_hypothesis_debate** \u2014 the task requires two subagents to defend opposing hypotheses to a lead arbiter (e.g., root-cause debugging where two competing theories need separate evidence-gathering).
+
+5. **fullstack_three_way** \u2014 the task is a synchronized fullstack push (frontend + backend + tests) requiring API contract alignment across three roles simultaneously.
+
+If none of the five apply, omit \`needs_teams_escalation\` (defaults to false) and proceed normally.`;
 function buildAgentDef(skillName, rolePrompts, workflowName, modelTierOverride) {
   const rp = rolePrompts?.[skillName] ?? (workflowName ? rolePrompts?.[workflowName] : void 0);
   if (!rp) {
     return {
       description: `harnessed workflow phase: ${skillName}`,
       prompt: `You are executing the '${skillName}' workflow phase. Follow the phase intent and emit a structured COMPLETE signal when done.`,
+      criticalSystemReminder_EXPERIMENTAL: ESCALATION_RULES,
       ...modelTierOverride ? { model: modelTierOverride } : {}
     };
   }
@@ -3197,6 +3220,7 @@ ${rp.checklist.map((c, i) => `  ${i + 1}. ${c}`).join("\n")}` : "";
   return {
     description: rp.description,
     prompt,
+    criticalSystemReminder_EXPERIMENTAL: ESCALATION_RULES,
     ...modelTierOverride ? { model: modelTierOverride } : {}
   };
 }
@@ -3261,10 +3285,15 @@ var _dispatchSkillStub = {
     }
     const env = JSON.parse(envelopeJson);
     const status = env.structured_output?.status === "COMPLETE" || env.subtype === "success" ? "ok" : "fail";
+    const escalation = env.structured_output?.needs_teams_escalation === true;
     return {
       status,
       output: env.text ?? env.result ?? "",
-      ...env.structured_output?.status ? { decision: env.structured_output.status } : {}
+      ...env.structured_output?.status ? { decision: env.structured_output.status } : {},
+      ...escalation ? {
+        needsTeamsEscalation: true,
+        ...env.structured_output?.escalation_reason ? { escalationReason: env.structured_output.escalation_reason } : {}
+      } : {}
     };
   }
 };
@@ -3353,6 +3382,12 @@ async function runWorkflow(yamlPath, vars, opts = {}) {
     if (r.status !== "ok") {
       return { status: "failed", phasesRun: i, lastPhaseId: ph.id };
     }
+    if (r.needsTeamsEscalation === true) {
+      const reason = r.escalationReason ?? "unspecified trigger";
+      console.error(
+        `\u26A0\uFE0F phase ${ph.id} suggests Agent Teams escalation \u2014 ${reason}. Consider opening a team in your main Claude Code session (TeamCreate) if continuing this work benefits from teammate coordination. See workflows/judgments/parallelism-gate.yaml for the 5 upgrade triggers.`
+      );
+    }
     if (r.target === "chat") {
       try {
         await runAfterOutputHook({