@sjawhar/pi-legion 12.1.0 → 12.2.0

package/dist/legion.js

@@ -7495,7 +7495,7 @@ async function findHandoffCommit(input) {
 
 // ../pi-shared/src/interface.ts
 import { logger } from "@oh-my-pi/pi-utils";
-var ENVOY_PLUGIN_INTERFACE_VERSION = 4;
+var ENVOY_PLUGIN_INTERFACE_VERSION = 5;
 var ENVOY_PLUGIN_INTERFACE_KEY = Symbol.for("legion.pi-shared.envoy-plugin-interface");
 var LEGION_PLUGIN_LOADED_KEY = Symbol.for("legion.pi-legion.loaded");
 var LEGACY_LEGION_LOADED_KEY = Symbol.for("legion.pi-envoy.legion-loaded");
@@ -7612,6 +7612,9 @@ function onEnvoyRoleRegained(listener) {
 }
 
 // ../pi-shared/src/startup-turn.ts
+function markStartupTurnPending(sessionID) {
+  envoyPluginInterface().startupTurn = { session: sessionID, sentAt: undefined };
+}
 function markStartupTurnSent(sessionID) {
   envoyPluginInterface().startupTurn = { session: sessionID, sentAt: Date.now() };
 }
@@ -8178,7 +8181,7 @@ async function bootLegionClaim(host) {
 // package.json
 var package_default = {
   name: "@sjawhar/pi-legion",
-  version: "12.1.0",
+  version: "12.2.0",
   license: "Apache-2.0",
   type: "module",
   omp: {
@@ -8505,6 +8508,7 @@ function createControllerSession(deps) {
     const envoyContext = "setInterval" in context ? context : undefined;
     if (startMessage !== undefined && !startMessageSent) {
       if (context.sessionManager.getSessionId() !== sessionID) {
+        clearStartupTurn(sessionID);
         startHandedOver = true;
         return;
       }
@@ -8537,8 +8541,12 @@ function createControllerSession(deps) {
     claimWidget = undefined;
   };
   const handleSessionStart = async (context) => {
-    if (!daemonLaunchedController(process.env))
+    if (!daemonLaunchedController(process.env)) {
+      if (operatorLaunchedController(process.env) && process.env.LEGION_CONTROLLER_START_MESSAGE && !startMessageSent) {
+        markStartupTurnPending(context.sessionManager.getSessionId());
+      }
       return;
+    }
     const sessionID = context.sessionManager.getSessionId();
     if (controllerSessionID === undefined || controllerSessionID === sessionID) {
       await claim(context);
@@ -8555,11 +8563,14 @@ function createControllerSession(deps) {
         context.ui.notify("legion: this process already sent the start message, but its controller claim did not finish; run /legion-claim-controller to claim the controller role and its wakes again.", "warning");
         return;
       }
+      const claimed = context.sessionManager.getSessionId();
       try {
         await claimOnce(context, { registered: false });
       } catch (error) {
         const message = messageFor(error);
         logger3.error(`[legion] the controller claim failed: ${message}`);
+        if (!startMessageSent)
+          clearStartupTurn(claimed);
         context.ui.notify(startMessageSent ? `legion: the controller claim failed after the start message was sent: ${message}. The start turn has the controller's registration; run /legion-claim-controller to claim the controller role and its wakes again.` : `legion: the controller claim failed: ${message}. Run /legion-claim-controller to claim again; it sends the start message once the claim succeeds.`, "warning");
       }
     });

package/dist/skills/legion-worker/references/merge-gate.md

@@ -53,10 +53,20 @@ it, and any other change to the head voids it.
   push's runs and read the CI head again). GitHub's compare lists at most 300 files for the whole
   comparison, so `files` at 300 is a comparison GitHub cut at its cap and `handoffsOnly` decides
   nothing: tell the architect and do not approve. A required check
-  `queued` or `in_progress`: wait. One `completed` as
-  `cancelled`, or absent: `gh run rerun <run-id>` once, then wait; when nothing will run it (a
-  check only a commit status reports, a workflow another repository defines), tell the architect
-  and do not approve. `gh pr checks <n>` is not the read: it reads only the current head, which
+  `queued` or `in_progress`: wait. One `completed` as `cancelled`, or absent: re-run that run's
+  failed and cancelled jobs, once, then wait — never the whole run, which runs again every job that
+  succeeded too. Find the run and job at the CI head: the head's runs
+  (`gh api 'repos/<o>/<r>/actions/runs?head_sha=<ci head>&per_page=100' --jq '.workflow_runs[] | [.id, .name, .event, .status, .conclusion] | @tsv'`),
+  then each candidate run's jobs
+  (`gh api repos/<o>/<r>/actions/runs/<run-id>/jobs --jq '.jobs[] | [.id, .name, .status, .conclusion] | @tsv'`).
+  A cancelled job: `gh run rerun <run-id> --failed`, which GitHub applies to the run's failed and
+  cancelled jobs and the jobs that depend on them, and to nothing that succeeded. Never
+  `--job <job-id>` alone: under a routing workflow, re-running only the final job reads the
+  cancelled results again and stays red. GitHub refuses a re-run while an attempt of that run is
+  still in progress: wait for it. When no
+  run at the CI head holds the job, or nothing will run it (a check only a commit status reports, a
+  workflow another repository defines), tell the architect and do not approve. `gh pr checks <n>`
+  is not the read: it reads only the current head, which
   at a handoff head shows only the `pr-title` runs the review events start (measured on
   sjawhar/legion#1944 at 0220b94fc2 on 2026-10-14).
   Approval is refused while either `E2E (implementer)` or `E2E (tester)` is missing: `REQUEST_CHANGES` naming the missing line.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/pi-legion",
-  "version": "12.1.0",
+  "version": "12.2.0",
   "license": "Apache-2.0",
   "type": "module",
   "omp": {