@nanobpm/nano-workforce 0.202.0 → 0.203.0

package/pages/cockpit.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/delivery-graph-detail.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/delivery-graphs/staged.mount.js

@@ -113,6 +113,7 @@ function dispatchControl(p, pending) {
   if (isPending(pending, "dispatch", p.digest)) {
     const repository = typeof pending.repository === "string" ? pending.repository : "";
     const baseBranch = typeof pending.baseBranch === "string" ? pending.baseBranch : "";
+    const autoResolve = pending.autoResolveEscalations === true;
     const mode = pending.mode;
     const provDisabled = mode === "fallback" ? "" : " disabled";
     return `<span class="confirm" data-confirm="dispatch">
@@ -123,6 +124,7 @@ function dispatchControl(p, pending) {
       <span class="confirm-msg">Use node repositories sends no run-level repository settings; the server validates that every agent node is provisioned. A run-level repository is a fallback for nodes without their own repository, not an override of node declarations. Checkout-less explicitly opts out of repository provisioning.</span>
       <label class="confirm-field">Repository <input class="confirm-input" type="text" data-dispatch-repository="${esc(p.digest)}" value="${esc(repository)}" placeholder="owner/repo" aria-label="Repository (owner/repo)"${provDisabled} /></label>
       <label class="confirm-field">Base branch <input class="confirm-input" type="text" data-dispatch-base="${esc(p.digest)}" value="${esc(baseBranch)}" placeholder="main" aria-label="Base branch"${provDisabled} /></label>
+      <label class="confirm-check"><input type="checkbox" data-dispatch-autoresolve="${esc(p.digest)}"${autoResolve ? " checked" : ""} /> Automatically resolve escalations (the escalation steward answers this run's eligible escalations; every automatic decision stays reviewable)</label>
       <button class="btn btn-primary" type="button" data-dispatch-confirm="${esc(p.digest)}">Confirm dispatch</button>
       <button class="btn btn-ghost" type="button" data-dispatch-cancel="${esc(p.digest)}">Cancel</button>
     </span>`;
@@ -458,7 +460,7 @@ export function mountStagedProposals(host, config = {}) {
   function openConfirm(kind, digest, name) {
     const staged = typeof digest === "string" ? digest.trim() : "";
     if (staged === "") return;
-    pending = { kind, digest: staged, name: typeof name === "string" ? name : "", repository: "", baseBranch: "", mode: "nodes" };
+    pending = { kind, digest: staged, name: typeof name === "string" ? name : "", repository: "", baseBranch: "", mode: "nodes", autoResolveEscalations: false };
     rerender();
     // Move focus into the name input so the operator can type immediately (best-effort; not all hosts
     // implement focus()).
@@ -514,8 +516,16 @@ export function mountStagedProposals(host, config = {}) {
     }
   });
 
-  // Preserve fallback text across mode changes, but only enable and submit it in fallback mode.
+  // Preserve fallback text across mode changes, but only enable and submit it in fallback mode. Also
+  // track the "Automatically resolve escalations" checkbox (a checkbox fires `change`, not `input`).
   listEl.addEventListener("change", (ev) => {
+    if (pending != null && pending.kind === "dispatch") {
+      const autoResolve = ev.target && ev.target.closest ? ev.target.closest("[data-dispatch-autoresolve]") : null;
+      if (autoResolve && autoResolve.getAttribute("data-dispatch-autoresolve") === pending.digest) {
+        pending.autoResolveEscalations = autoResolve.checked === true;
+        return;
+      }
+    }
     const choice = ev.target && ev.target.closest ? ev.target.closest("[data-dispatch-mode]") : null;
     if (choice && choice.checked && pending != null && pending.kind === "dispatch" &&
         choice.getAttribute("data-dispatch-mode") === pending.digest &&
@@ -562,10 +572,12 @@ export function mountStagedProposals(host, config = {}) {
         return;
       }
       // Construct only the selected mode's fields: disabled fallback text must never leak into node
-      // or checkout-less dispatches, and repoless must never be inferred from blank fields.
+      // or checkout-less dispatches, and repoless must never be inferred from blank fields. The
+      // escalation-steward opt-in is mode-independent — include it whenever the operator checked it.
+      const autoResolve = pending.autoResolveEscalations === true ? { autoResolveEscalations: true } : {};
       const payload = mode === "fallback"
-        ? { digest, repository, baseBranch }
-        : mode === "repoless" ? { digest, repoless: true } : { digest };
+        ? { digest, repository, baseBranch, ...autoResolve }
+        : mode === "repoless" ? { digest, repoless: true, ...autoResolve } : { digest, ...autoResolve };
       closeConfirm();
       doDispatch(payload);
       return;

package/pages/delivery-graphs.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/epic-detail.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/epic.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"
@@ -89,7 +106,8 @@
           { "key": "issue", "label": "owner/repo#123 or a GitHub issue URL", "type": "text", "required": true, "requiredMessage": "An issue reference is required (owner/repo#123 or an issue URL)" },
           { "key": "baseBranch", "label": "Base branch: e.g. epic/agent-protocol to land the whole epic on an integration branch. A missing epic/* branch is auto-created off default HEAD; a non-epic/* branch must already exist.", "type": "text", "required": true, "requiredMessage": "Name the branch the PR targets (e.g. main or epic/agent-protocol)" },
           { "key": "confirmDefaultBase", "label": "Confirm landing on the default branch \u2014 required only when the base above IS the repository default (every task lands directly on it, with any merge-to-default side effect firing per task)", "type": "checkbox" },
-          { "key": "allowSharedBase", "label": "Allow sharing a custom integration branch with another active epic \u2014 required only when another in-flight epic already targets this same custom base", "type": "checkbox" }
+          { "key": "allowSharedBase", "label": "Allow sharing a custom integration branch with another active epic \u2014 required only when another in-flight epic already targets this same custom base", "type": "checkbox" },
+          { "key": "autoResolveEscalations", "label": "Automatically resolve escalations \u2014 the opt-in escalation steward reviews this epic's (and its child loops') open escalations every 30 min and submits a recommended choice, recorded reviewably in Auto-resolutions", "type": "checkbox" }
         ]
       }
     },

package/pages/feature.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"
@@ -93,7 +110,8 @@
           { "key": "humanApproval", "label": "Human approval before merge \u2014 a converged PR waits in Tasks for you to approve the merge or request changes (only applies when Auto-merge is on)", "type": "checkbox" },
           { "key": "autoMerge", "label": "Auto-merge \u2014 after convergence, drive the merge-loop (only applies when Converge is on)", "type": "checkbox" },
           { "key": "confirmDefaultBase", "label": "Confirm landing on the default branch \u2014 required only when the base above IS the repository default", "type": "checkbox" },
-          { "key": "allowSharedBase", "label": "Allow sharing a custom integration branch with another active epic", "type": "checkbox" }
+          { "key": "allowSharedBase", "label": "Allow sharing a custom integration branch with another active epic", "type": "checkbox" },
+          { "key": "autoResolveEscalations", "label": "Automatically resolve escalations \u2014 the opt-in escalation steward reviews this run's open escalations every 30 min and submits a recommended choice, recorded reviewably in Auto-resolutions", "type": "checkbox" }
         ]
       }
     },

package/pages/home.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"
@@ -108,6 +125,11 @@
             "key": "autoMerge",
             "label": "Auto-merge \u2014 after convergence, drive the merge-loop",
             "type": "checkbox"
+          },
+          {
+            "key": "autoResolveEscalations",
+            "label": "Automatically resolve escalations \u2014 the opt-in escalation steward reviews this loop's open escalations every 30 min and submits a recommended choice, recorded reviewably in Auto-resolutions",
+            "type": "checkbox"
           }
         ]
       }

package/pages/lineage.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/mcp.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/overview.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/tasks.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/pages/velocity.page.json

@@ -49,6 +49,23 @@
               "hideWhenZero": true
             }
           },
+          {
+            "label": "Auto-resolutions",
+            "page": "auto-resolutions",
+            "badge": {
+              "source": "app",
+              "table": "escalation_auto_resolutions__read_model",
+              "filter": [
+                {
+                  "field": "review_state",
+                  "eq": "pending"
+                }
+              ],
+              "tone": "warn",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
           {
             "label": "Cockpit",
             "page": "cockpit"

package/resources/processes/escalation-steward.bpmn

@@ -0,0 +1,162 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xmlns:bpmndi_1="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:zeebe="http://camunda.org/schema/zeebe/1.0" xmlns:nano="https://nanobpm.io/schema/shapes/1.0" id="Definitions_nano_workforce_escalation_steward" targetNamespace="http://nanobpm.io/nano-workforce">
+  <bpmn:process id="escalation-steward" name="Escalation steward" isExecutable="true">
+    <bpmn:extensionElements>
+      <nano:shapes>
+        <nano:shape id="StewardCollectIn" name="Collect eligible escalations — input">
+          <nano:extend name="minAgeMs" type="integer" optional="true" />
+        </nano:shape>
+        <nano:shape id="StewardCollectOut" name="Collect eligible escalations — output">
+          <nano:extend name="eligibleCount" type="integer" />
+          <nano:extend name="claimed" type="string" list="true" optional="true" />
+          <nano:extend name="skippedOverlap" type="boolean" optional="true" />
+        </nano:shape>
+        <nano:shape id="StewardRecordIn" name="Record steward resolutions — input">
+          <nano:extend name="resolutions" type="string" optional="true" />
+        </nano:shape>
+      </nano:shapes>
+    </bpmn:extensionElements>
+    <bpmn:startEvent id="tick" name="Steward tick">
+      <bpmn:outgoing>es_toCollect</bpmn:outgoing>
+    </bpmn:startEvent>
+    <bpmn:serviceTask id="collect" name="Collect eligible escalations">
+      <bpmn:extensionElements>
+        <zeebe:taskDefinition type="pr.escalation-steward-collect" />
+        <zeebe:properties>
+          <zeebe:property name="io.nanobpm.dataEnvelope.in" value="StewardCollectIn" />
+          <zeebe:property name="io.nanobpm.dataEnvelope.out" value="StewardCollectOut" />
+        </zeebe:properties>
+      </bpmn:extensionElements>
+      <bpmn:incoming>es_toCollect</bpmn:incoming>
+      <bpmn:outgoing>es_collected</bpmn:outgoing>
+    </bpmn:serviceTask>
+    <bpmn:exclusiveGateway id="gw_any" name="any eligible?" default="es_done">
+      <bpmn:incoming>es_collected</bpmn:incoming>
+      <bpmn:outgoing>es_dispatch</bpmn:outgoing>
+      <bpmn:outgoing>es_done</bpmn:outgoing>
+    </bpmn:exclusiveGateway>
+    <bpmn:serviceTask id="steward-agent" name="Review escalations (agent)">
+      <bpmn:extensionElements>
+        <zeebe:taskDefinition type="senior:escalation-steward" />
+        <zeebe:agentDefinition agentType="external" />
+        <zeebe:linkedResources>
+          <zeebe:linkedResource resourceId="prompts/escalation-steward.md" bindingType="latest" resourceType="GenericScript" linkName="prompt" />
+        </zeebe:linkedResources>
+        <zeebe:ioMapping>
+          <zeebe:input source="=claimed" target="claimedTasks" />
+          <zeebe:output source="=if (is defined(resolutions)) then resolutions else null" target="resolutions" />
+        </zeebe:ioMapping>
+      </bpmn:extensionElements>
+      <bpmn:incoming>es_dispatch</bpmn:incoming>
+      <bpmn:outgoing>es_toRecord</bpmn:outgoing>
+    </bpmn:serviceTask>
+    <bpmn:boundaryEvent id="be_steward_sla" name="Agent SLA elapsed" attachedToRef="steward-agent">
+      <bpmn:outgoing>es_sla</bpmn:outgoing>
+      <bpmn:timerEventDefinition id="ted_steward_sla">
+        <bpmn:timeDuration xsi:type="bpmn:tFormalExpression">=agentSlaTimeout</bpmn:timeDuration>
+      </bpmn:timerEventDefinition>
+    </bpmn:boundaryEvent>
+    <bpmn:serviceTask id="record" name="Record steward resolutions">
+      <bpmn:extensionElements>
+        <zeebe:taskDefinition type="pr.escalation-steward-record" />
+        <zeebe:properties>
+          <zeebe:property name="io.nanobpm.dataEnvelope.in" value="StewardRecordIn" />
+        </zeebe:properties>
+      </bpmn:extensionElements>
+      <bpmn:incoming>es_toRecord</bpmn:incoming>
+      <bpmn:outgoing>es_recorded</bpmn:outgoing>
+    </bpmn:serviceTask>
+    <bpmn:endEvent id="done" name="Tick complete">
+      <bpmn:incoming>es_done</bpmn:incoming>
+      <bpmn:incoming>es_recorded</bpmn:incoming>
+      <bpmn:incoming>es_sla</bpmn:incoming>
+    </bpmn:endEvent>
+    <bpmn:sequenceFlow id="es_toCollect" sourceRef="tick" targetRef="collect" />
+    <bpmn:sequenceFlow id="es_collected" sourceRef="collect" targetRef="gw_any" />
+    <bpmn:sequenceFlow id="es_dispatch" name="eligible" sourceRef="gw_any" targetRef="steward-agent">
+      <bpmn:conditionExpression xsi:type="bpmn:tFormalExpression">=eligibleCount &gt; 0</bpmn:conditionExpression>
+    </bpmn:sequenceFlow>
+    <bpmn:sequenceFlow id="es_done" name="none" sourceRef="gw_any" targetRef="done" />
+    <bpmn:sequenceFlow id="es_toRecord" sourceRef="steward-agent" targetRef="record" />
+    <bpmn:sequenceFlow id="es_recorded" sourceRef="record" targetRef="done" />
+    <bpmn:sequenceFlow id="es_sla" name="agent SLA elapsed" sourceRef="be_steward_sla" targetRef="done" />
+  </bpmn:process>
+  <bpmndi_1:BPMNDiagram id="BPMNDiagram_escalation-steward">
+    <bpmndi_1:BPMNPlane id="BPMNPlane_escalation-steward" bpmnElement="escalation-steward">
+      <bpmndi_1:BPMNShape id="BPMNShape_tick" bpmnElement="tick">
+        <dc:Bounds x="80" y="102" width="36" height="36" />
+        <bpmndi_1:BPMNLabel>
+          <dc:Bounds x="53" y="143" width="90" height="14" />
+        </bpmndi_1:BPMNLabel>
+      </bpmndi_1:BPMNShape>
+      <bpmndi_1:BPMNShape id="BPMNShape_collect" bpmnElement="collect">
+        <dc:Bounds x="216" y="80" width="100" height="80" />
+      </bpmndi_1:BPMNShape>
+      <bpmndi_1:BPMNShape id="BPMNShape_gw_any" bpmnElement="gw_any" isMarkerVisible="true">
+        <dc:Bounds x="416" y="95" width="50" height="50" />
+        <bpmndi_1:BPMNLabel>
+          <dc:Bounds x="408" y="62" width="67" height="28" />
+        </bpmndi_1:BPMNLabel>
+      </bpmndi_1:BPMNShape>
+      <bpmndi_1:BPMNShape id="BPMNShape_steward-agent" bpmnElement="steward-agent">
+        <dc:Bounds x="566" y="240" width="100" height="80" />
+      </bpmndi_1:BPMNShape>
+      <bpmndi_1:BPMNShape id="BPMNShape_record" bpmnElement="record">
+        <dc:Bounds x="766" y="240" width="100" height="80" />
+      </bpmndi_1:BPMNShape>
+      <bpmndi_1:BPMNShape id="BPMNShape_done" bpmnElement="done">
+        <dc:Bounds x="966" y="102" width="36" height="36" />
+        <bpmndi_1:BPMNLabel>
+          <dc:Bounds x="953" y="69" width="63" height="28" />
+        </bpmndi_1:BPMNLabel>
+      </bpmndi_1:BPMNShape>
+      <bpmndi_1:BPMNShape id="BPMNShape_be_steward_sla" bpmnElement="be_steward_sla">
+        <dc:Bounds x="598" y="302" width="36" height="36" />
+        <bpmndi_1:BPMNLabel>
+          <dc:Bounds x="580" y="363" width="72" height="28" />
+        </bpmndi_1:BPMNLabel>
+      </bpmndi_1:BPMNShape>
+      <bpmndi_1:BPMNEdge id="BPMNEdge_es_toCollect" bpmnElement="es_toCollect">
+        <di:waypoint x="116" y="120" />
+        <di:waypoint x="216" y="120" />
+      </bpmndi_1:BPMNEdge>
+      <bpmndi_1:BPMNEdge id="BPMNEdge_es_collected" bpmnElement="es_collected">
+        <di:waypoint x="316" y="120" />
+        <di:waypoint x="416" y="120" />
+      </bpmndi_1:BPMNEdge>
+      <bpmndi_1:BPMNEdge id="BPMNEdge_es_done" bpmnElement="es_done">
+        <di:waypoint x="466" y="120" />
+        <di:waypoint x="966" y="120" />
+        <bpmndi_1:BPMNLabel>
+          <dc:Bounds x="700" y="98" width="32" height="14" />
+        </bpmndi_1:BPMNLabel>
+      </bpmndi_1:BPMNEdge>
+      <bpmndi_1:BPMNEdge id="BPMNEdge_es_dispatch" bpmnElement="es_dispatch">
+        <di:waypoint x="441" y="145" />
+        <di:waypoint x="441" y="280" />
+        <di:waypoint x="566" y="280" />
+        <bpmndi_1:BPMNLabel>
+          <dc:Bounds x="446" y="206" width="60" height="14" />
+        </bpmndi_1:BPMNLabel>
+      </bpmndi_1:BPMNEdge>
+      <bpmndi_1:BPMNEdge id="BPMNEdge_es_toRecord" bpmnElement="es_toRecord">
+        <di:waypoint x="666" y="280" />
+        <di:waypoint x="766" y="280" />
+      </bpmndi_1:BPMNEdge>
+      <bpmndi_1:BPMNEdge id="BPMNEdge_es_recorded" bpmnElement="es_recorded">
+        <di:waypoint x="866" y="280" />
+        <di:waypoint x="984" y="280" />
+        <di:waypoint x="984" y="138" />
+      </bpmndi_1:BPMNEdge>
+      <bpmndi_1:BPMNEdge id="BPMNEdge_es_sla" bpmnElement="es_sla">
+        <di:waypoint x="616" y="338" />
+        <di:waypoint x="616" y="358" />
+        <di:waypoint x="984" y="358" />
+        <di:waypoint x="984" y="138" />
+        <bpmndi_1:BPMNLabel>
+          <dc:Bounds x="765" y="325" width="70" height="28" />
+        </bpmndi_1:BPMNLabel>
+      </bpmndi_1:BPMNEdge>
+    </bpmndi_1:BPMNPlane>
+  </bpmndi_1:BPMNDiagram>
+</bpmn:definitions>

package/resources/prompts/escalation-steward.md

@@ -0,0 +1,87 @@
+# Escalation steward — review open escalations and recommend a choice for each
+
+You are the **escalation steward** for an opt-in fleet. Once per tick you are handed a
+set of **claimed** open escalations — each a human-in-the-loop wait that is parking a
+piece of work — and your job is to investigate each one and either **resolve** it
+(submit the recommended choice) or **abstain** (deliberately leave it for a human).
+
+Every decision you make is written to a durable, reviewable record and shown to an
+operator in the **Auto-resolutions** view, so a human can examine or step in after the
+fact. You are an agent acting with **agent** attribution — your answers are never
+recorded as a human decision.
+
+## Job input (`job.variables`)
+
+| var            | meaning                                                                 |
+|----------------|-------------------------------------------------------------------------|
+| `claimedTasks` | an array of JSON strings, one per claimed escalation. Parse each.        |
+
+Each parsed entry carries:
+
+| field                 | meaning                                                        |
+|-----------------------|----------------------------------------------------------------|
+| `user_task_key`       | the completable user-task key you act on                        |
+| `element_id`          | the BPMN element id (the escalation kind)                       |
+| `escalation_kind`     | the human-readable kind label                                   |
+| `subject_type`        | `feature` \| `plan` \| `pr` \| `delivery`                       |
+| `subject_key`         | the subject's key (e.g. `owner/repo#123`, a run key)            |
+| `subject_url`         | an external link (the PR/issue URL), when known                 |
+| `process_instance_key`| the owning engine process instance                              |
+| `question`            | the escalation question / findings, when recorded               |
+
+## Evidence before choosing — verify, don't guess
+
+For **every** escalation, before you choose, run the same checks an operator would:
+
+- Read the escalation's **question, options and form schema**. Use the form's real keys
+  (for example `decision` / `value` / `escalationNote` for delivery tasks, `answer` for
+  a `wait-answer`, `resolution` / `answer` for a feature escalation).
+- **Verify any claim that matters**, using the repo and the engine:
+  - Does the PR, branch or WIP ref actually exist? (`gh pr view`, `git ls-remote`)
+  - Were commits pushed? What do the review threads say?
+  - Was this question ruled on before? Check `pr_adjudications` (via the
+    `getPrHistory` / prior-resolution context) and earlier auto-resolutions.
+- Choose an option and, where the option allows, write a **corrective note** (for
+  example a `Retry` with guidance on what to fix).
+
+## When you MUST abstain
+
+Abstain (record `abstained`, leave the escalation for a human) when **any** of these
+hold:
+
+- The right choice is **unclear** after investigation.
+- The option is **irreversible or destructive** — for example *abandon*, deleting work,
+  or merging past a failing required check.
+- A **credential or permission** change is needed.
+- The **loop guard** trips: the same subject has already been auto-resolved twice and
+  has escalated again. Repeated escalation means the automatic answer isn't working —
+  say so in your rationale.
+
+When in doubt, abstain. A human can always answer; a wrong automatic answer is worse.
+
+## Output contract
+
+Write a JSON object to the file named by the `AGENT_RESULT_FILE` environment variable
+(or, as a fallback, print a single last stdout line `::nano:result:: {json}`). The
+object MUST carry a `resolutions` field: a JSON **string** encoding an array with one
+entry per claimed escalation:
+
+```json
+{
+  "resolutions": "[{\"userTaskKey\":\"...\",\"outcome\":\"resolved\",\"choice\":\"retry\",\"variables\":{\"answer\":\"...\"},\"rationale\":\"...\",\"evidence\":\"...\",\"options\":[\"retry\",\"abandon\"]}]"
+}
+```
+
+Each entry:
+
+- `userTaskKey` (required) — the escalation this decision is for.
+- `outcome` (required) — `"resolved"` or `"abstained"`.
+- `variables` (required when `resolved`) — the exact typed form variables to submit.
+- `choice` — the option value you picked (used by the host's destructive-option guard).
+- `rationale` — one line: why this choice (or why you abstained).
+- `evidence` — what you checked, with links (a short markdown/JSON note).
+- `options` — the option values the form offered (a snapshot for the record).
+
+**Emitting a machine-readable result is your mandatory final step — never exit
+silently.** Exit `0` on every path. If you cannot reach a confident answer for an
+escalation, record it as `abstained` with the reason — do not guess.