@adhdev/mesh-shared 1.0.60-rc.40 → 1.0.60-rc.42

package/dist/index.mjs

@@ -1569,15 +1569,25 @@ function renderWorkerProtocolFooter(input = {}) {
   const scope = [];
   if (input.taskId) scope.push(`task ${input.taskId}`);
   if (input.taskMode) scope.push(`mode ${input.taskMode}`);
-  if (input.difficulty) scope.push(`difficulty ${input.difficulty}`);
+  if (input.difficulty) {
+    if (isMeshTaskDifficulty(input.difficulty)) {
+      scope.push(`difficulty ${input.difficulty}`);
+    } else {
+      console.warn(
+        `[worker-protocol] task ${input.taskId ?? "(unknown)"}: dropping invalid difficulty '${input.difficulty}' from the worker footer (expected one of easy, medium, difficult, freeform)`
+      );
+    }
+  }
   if (input.readonly) scope.push("read-only");
   if (scope.length) lines.push(`You are a delegated worker (${scope.join(", ")}).`);
   else lines.push("You are a delegated worker.");
   lines.push(
     "When your work is finished, blocked, or has failed, call `report_completion` exactly once. Its `summary` is recorded verbatim as the authoritative record of this task \u2014 your terminal is not scraped for it \u2014 so state what you did, what you found, and where you left the branch.",
     "For work that runs longer than a few minutes, call `progress_update` at natural checkpoints so the coordinator can see you are alive without polling.",
-    "`peer_context_pull` shows what sibling tasks in this mission have reported; `git_status` / `git_diff` / `git_log` inspect your own workspace (pass its absolute path as `workspace`).",
-    "You have no coordinator tools (no `mesh_*`) by design: do not enqueue, dispatch, or restart anything. If you need a decision from the coordinator, finish with `report_completion` and outcome `blocked`, listing what you need in `blockers`."
+    "`peer_context_pull` shows what sibling tasks in this mission have reported; `git_status` / `git_diff` / `git_log` inspect your own workspace \u2014 all three REQUIRE the absolute path to it as `workspace`.",
+    "You have no coordinator tools (no `mesh_*`) by design: do not enqueue, dispatch, or restart anything. If you need a decision from the coordinator, finish with `report_completion` and outcome `blocked`, listing what you need in `blockers`.",
+    "On a code-changing task, `report_completion` with outcome `completed` requires `touched_files` \u2014 send `[]` if you changed nothing, omitting the field is what gets refused. `blocked`/`failed` never need it, and a read-only task should omit it or send `[]`.",
+    "If `report_completion` is refused, the response carries `validationErrors` (or a `hint`) naming exactly what to fix \u2014 correct that field and call it again; a refusal records nothing."
   );
   if (input.enclosedHandoffNotes && input.enclosedHandoffNotes > 0) {
     lines.push(
@@ -1677,7 +1687,12 @@ var HOLD_REASONS = [
   "live_pending",
   "transcript_quiet",
   "weak_candidate",
-  "suspension_before_consumed"
+  "suspension_before_consumed",
+  // A genuine FSM end of a mesh turn whose worker holds a live worker-MCP bind:
+  // the structured report is the primary evidence (design §F2), so the idle edge
+  // only opens this hold (R9r) — a report commits (R17), a new busy edge cancels
+  // it as a false idle (R12r), expiry commits weak (R13r).
+  "await_report"
 ];
 var TURN_OUTCOMES = ["completed", "failed", "cancelled"];
 var COMMIT_STRENGTHS = ["genuine", "weak", "tool_report", "operator"];
@@ -1777,7 +1792,8 @@ var TURN_EVIDENCE_FIELD_SPECS = {
     blockReason: enOpt(TURN_END_BLOCK_REASONS),
     releasedByHardCap: boolOpt,
     nativeOutcome: enOpt(NATIVE_TURN_OUTCOMES),
-    live: { t: "live", optional: true }
+    live: { t: "live", optional: true },
+    reportExpected: boolOpt
   },
   transcript_final: {
     selfAttributing: bool,