arcane-cli 1.19.0 → 1.20.0

package/dist/assets/.arcane/spells/spell-scope.md

@@ -252,23 +252,35 @@ If `external_provider=jira` or `external_provider=other`, add explicit TODOs in
 
 ### 9. Present and Confirm
 
-<!-- fragment:needs-you:start -->
-**Needs you — required operator actions.** When this run leaves an action that only the operator can take, and the work is not correct or complete until it is taken, report it in one block at the very top of the final report, before every other section and before any optional next step:
+<!-- fragment:action-required:start -->
+**Action required — what only the operator can do.** When this run leaves an action that only the operator can take, report it in one block at the very top of the final report, before every other section and before any optional next step. The block exists because these are the operator's decisions to make, not because the agent is stuck: write it as a hand-off of authority, never as a plea for help. Frame it with a horizontal rule above and below, so it stands apart in a terminal as well as on a rendered page:
 
 ```markdown
-## ⚠ Needs you
+---
+
+## 🚧 Action required
+
+**Now**
+
+- <exactly what to do: the command, the link, or the question> — <why only the operator can do it>
 
-- <exactly what to do: the command, the link, or the question> — <why the agent cannot do it itself>
+**When you're at your desk**
+
+- <exactly what to do> — <why only the operator can do it>
+
+---
 ```
 
-- **What belongs in it:** an action the work needs that only the operator can take — approving or merging a pull request, accepting a decision record, answering a question the work is waiting on, confirming a `guarded` push, running an interactive command such as `spell unblock-push`, or a step on an external platform the agent cannot reach. An optional suggestion, a next spell to run, or anything the agent could do itself is not a required action and stays out of the block.
-- **One line per action.** Say exactly what to do, then, after the dash, why the agent cannot do it. Write the command, link or question out in full; never point elsewhere with "see above".
+- **What belongs in it:** an action only the operator can take — approving or merging a pull request, accepting a decision record, answering a question the work is waiting on, confirming a `guarded` push, running an interactive command such as `spell unblock-push`, or a step on an external platform the agent cannot reach. An optional suggestion, a next spell to run, or anything the agent could do itself is not a required action and stays out of the block.
+- **Two tiers, one block.** **Now** holds what the work is not correct or complete without. **When you're at your desk** holds what only the operator can do but that can wait: a permission rule, a leftover remote branch, a credential to set up. Leave out a tier that has nothing in it; never split the tiers into two blocks.
+- **One line per action.** Say exactly what to do, then, after the dash, why only the operator can do it. Write the command, link or question out in full; never point elsewhere with "see above".
 - **Never only among optional steps.** An action required for correctness is never listed only under next steps, suggestions, `Carry Forward` or `What's Next?`. It may be repeated there, but it always appears in this block.
-- **Omit it when empty.** When nothing needs the operator, leave the block out entirely: no heading and no "None" line.
+- **Done items stay, struck through.** Within one session, once an item has been listed, keep it in every later report of the block; when the operator has done it, strike it through (`~~<the line>~~`) rather than dropping it, so progress shows and nothing disappears silently. The session's close carries only the open items forward.
+- **Omit it when empty.** When nothing is left for the operator and nothing was struck through this session, leave the block out entirely: no heading, no rules and no "None" line.
 - **Every final report.** The block belongs in whatever report ends the run, including a report written when the spell stops early.
-- **Report it to the presence channel.** When the block is not empty, also run `spell presence report --status waiting --needs-you "<line 1>" --needs-you "<line 2>"`, one flag per line of the block; with no presence channel configured on this machine the command prints nothing and exits 0, so the block itself and the rest of the run are unchanged.
+- **Report the Now tier to the presence channel.** When the **Now** tier has open items, also run `spell presence report --status waiting --required-action "<line 1>" --required-action "<line 2>"`, one flag per open line of that tier; the other tier is not blocking and is not reported. With no presence channel configured on this machine the command prints nothing and exits 0, so the block itself and the rest of the run are unchanged.
 - Enforcement: explicitly advisory prose (ARC-023) — no check reads a spell's actual output for this block; it holds by these instructions alone.
-<!-- fragment:needs-you:end -->
+<!-- fragment:action-required:end -->
 
 Present the execution plan to the user. Ask:
 1. Does the epic split make sense?

package/dist/assets/.arcane/spells/spell-ship.md

@@ -97,23 +97,35 @@ Workflow:
    - OR: BLOCK — [reason]
    ```
 
-   <!-- fragment:needs-you:start -->
-   **Needs you — required operator actions.** When this run leaves an action that only the operator can take, and the work is not correct or complete until it is taken, report it in one block at the very top of the final report, before every other section and before any optional next step:
+   <!-- fragment:action-required:start -->
+   **Action required — what only the operator can do.** When this run leaves an action that only the operator can take, report it in one block at the very top of the final report, before every other section and before any optional next step. The block exists because these are the operator's decisions to make, not because the agent is stuck: write it as a hand-off of authority, never as a plea for help. Frame it with a horizontal rule above and below, so it stands apart in a terminal as well as on a rendered page:
 
    ```markdown
-   ## ⚠ Needs you
+   ---
 
-   - <exactly what to do: the command, the link, or the question> — <why the agent cannot do it itself>
+   ## 🚧 Action required
+
+   **Now**
+
+   - <exactly what to do: the command, the link, or the question> — <why only the operator can do it>
+
+   **When you're at your desk**
+
+   - <exactly what to do> — <why only the operator can do it>
+
+   ---
    ```
 
-   - **What belongs in it:** an action the work needs that only the operator can take — approving or merging a pull request, accepting a decision record, answering a question the work is waiting on, confirming a `guarded` push, running an interactive command such as `spell unblock-push`, or a step on an external platform the agent cannot reach. An optional suggestion, a next spell to run, or anything the agent could do itself is not a required action and stays out of the block.
-   - **One line per action.** Say exactly what to do, then, after the dash, why the agent cannot do it. Write the command, link or question out in full; never point elsewhere with "see above".
+   - **What belongs in it:** an action only the operator can take — approving or merging a pull request, accepting a decision record, answering a question the work is waiting on, confirming a `guarded` push, running an interactive command such as `spell unblock-push`, or a step on an external platform the agent cannot reach. An optional suggestion, a next spell to run, or anything the agent could do itself is not a required action and stays out of the block.
+   - **Two tiers, one block.** **Now** holds what the work is not correct or complete without. **When you're at your desk** holds what only the operator can do but that can wait: a permission rule, a leftover remote branch, a credential to set up. Leave out a tier that has nothing in it; never split the tiers into two blocks.
+   - **One line per action.** Say exactly what to do, then, after the dash, why only the operator can do it. Write the command, link or question out in full; never point elsewhere with "see above".
    - **Never only among optional steps.** An action required for correctness is never listed only under next steps, suggestions, `Carry Forward` or `What's Next?`. It may be repeated there, but it always appears in this block.
-   - **Omit it when empty.** When nothing needs the operator, leave the block out entirely: no heading and no "None" line.
+   - **Done items stay, struck through.** Within one session, once an item has been listed, keep it in every later report of the block; when the operator has done it, strike it through (`~~<the line>~~`) rather than dropping it, so progress shows and nothing disappears silently. The session's close carries only the open items forward.
+   - **Omit it when empty.** When nothing is left for the operator and nothing was struck through this session, leave the block out entirely: no heading, no rules and no "None" line.
    - **Every final report.** The block belongs in whatever report ends the run, including a report written when the spell stops early.
-   - **Report it to the presence channel.** When the block is not empty, also run `spell presence report --status waiting --needs-you "<line 1>" --needs-you "<line 2>"`, one flag per line of the block; with no presence channel configured on this machine the command prints nothing and exits 0, so the block itself and the rest of the run are unchanged.
+   - **Report the Now tier to the presence channel.** When the **Now** tier has open items, also run `spell presence report --status waiting --required-action "<line 1>" --required-action "<line 2>"`, one flag per open line of that tier; the other tier is not blocking and is not reported. With no presence channel configured on this machine the command prints nothing and exits 0, so the block itself and the rest of the run are unchanged.
    - Enforcement: explicitly advisory prose (ARC-023) — no check reads a spell's actual output for this block; it holds by these instructions alone.
-   <!-- fragment:needs-you:end -->
+   <!-- fragment:action-required:end -->
 
 7. **Request human approval** — present the ship report and wait for explicit approval.
 

package/dist/assets/.arcane/spells/spell-sync-pull-request.md

@@ -110,7 +110,7 @@ then classify **each conflicted hunk independently** — a single file can conta
   that one side's content is a strict superset of the other's. **STOP.** Do not guess, do not pick a
   side, do not attempt a "reasonable-looking" merge of the two. Abort the in-progress rebase/merge
   (`git rebase --abort` / `git merge --abort`) so the branch is left exactly as it was, then report:
-  - First, the `## ⚠ Needs you` block described in Step 6, naming the manual resolution as the action.
+  - First, the `## 🚧 Action required` block described in Step 6, naming the manual resolution as the action.
   - The exact conflicting file(s) and hunk(s).
   - Both sides' conflicting content, verbatim.
   - That the recoverable ref from Step 1 still points at the pre-sync state.
@@ -172,23 +172,35 @@ report the discrepancy rather than declaring the sync done.
 
 ## Step 6 — Report
 
-<!-- fragment:needs-you:start -->
-**Needs you — required operator actions.** When this run leaves an action that only the operator can take, and the work is not correct or complete until it is taken, report it in one block at the very top of the final report, before every other section and before any optional next step:
+<!-- fragment:action-required:start -->
+**Action required — what only the operator can do.** When this run leaves an action that only the operator can take, report it in one block at the very top of the final report, before every other section and before any optional next step. The block exists because these are the operator's decisions to make, not because the agent is stuck: write it as a hand-off of authority, never as a plea for help. Frame it with a horizontal rule above and below, so it stands apart in a terminal as well as on a rendered page:
 
 ```markdown
-## ⚠ Needs you
+---
+
+## 🚧 Action required
+
+**Now**
+
+- <exactly what to do: the command, the link, or the question> — <why only the operator can do it>
 
-- <exactly what to do: the command, the link, or the question> — <why the agent cannot do it itself>
+**When you're at your desk**
+
+- <exactly what to do> — <why only the operator can do it>
+
+---
 ```
 
-- **What belongs in it:** an action the work needs that only the operator can take — approving or merging a pull request, accepting a decision record, answering a question the work is waiting on, confirming a `guarded` push, running an interactive command such as `spell unblock-push`, or a step on an external platform the agent cannot reach. An optional suggestion, a next spell to run, or anything the agent could do itself is not a required action and stays out of the block.
-- **One line per action.** Say exactly what to do, then, after the dash, why the agent cannot do it. Write the command, link or question out in full; never point elsewhere with "see above".
+- **What belongs in it:** an action only the operator can take — approving or merging a pull request, accepting a decision record, answering a question the work is waiting on, confirming a `guarded` push, running an interactive command such as `spell unblock-push`, or a step on an external platform the agent cannot reach. An optional suggestion, a next spell to run, or anything the agent could do itself is not a required action and stays out of the block.
+- **Two tiers, one block.** **Now** holds what the work is not correct or complete without. **When you're at your desk** holds what only the operator can do but that can wait: a permission rule, a leftover remote branch, a credential to set up. Leave out a tier that has nothing in it; never split the tiers into two blocks.
+- **One line per action.** Say exactly what to do, then, after the dash, why only the operator can do it. Write the command, link or question out in full; never point elsewhere with "see above".
 - **Never only among optional steps.** An action required for correctness is never listed only under next steps, suggestions, `Carry Forward` or `What's Next?`. It may be repeated there, but it always appears in this block.
-- **Omit it when empty.** When nothing needs the operator, leave the block out entirely: no heading and no "None" line.
+- **Done items stay, struck through.** Within one session, once an item has been listed, keep it in every later report of the block; when the operator has done it, strike it through (`~~<the line>~~`) rather than dropping it, so progress shows and nothing disappears silently. The session's close carries only the open items forward.
+- **Omit it when empty.** When nothing is left for the operator and nothing was struck through this session, leave the block out entirely: no heading, no rules and no "None" line.
 - **Every final report.** The block belongs in whatever report ends the run, including a report written when the spell stops early.
-- **Report it to the presence channel.** When the block is not empty, also run `spell presence report --status waiting --needs-you "<line 1>" --needs-you "<line 2>"`, one flag per line of the block; with no presence channel configured on this machine the command prints nothing and exits 0, so the block itself and the rest of the run are unchanged.
+- **Report the Now tier to the presence channel.** When the **Now** tier has open items, also run `spell presence report --status waiting --required-action "<line 1>" --required-action "<line 2>"`, one flag per open line of that tier; the other tier is not blocking and is not reported. With no presence channel configured on this machine the command prints nothing and exits 0, so the block itself and the rest of the run are unchanged.
 - Enforcement: explicitly advisory prose (ARC-023) — no check reads a spell's actual output for this block; it holds by these instructions alone.
-<!-- fragment:needs-you:end -->
+<!-- fragment:action-required:end -->
 
 ```
 ✓ PR synced: <URL>

package/dist/assets/ai-context/system-prompt-context.md

@@ -33,7 +33,7 @@
 - **Branch:** main
 - **Blockers:** None.
 - **Pending Verification:** None.
-- **Needs you:** None.
+- **Action required:** None.
 - **Notes:** —
 
 > ✓ Consumed: YYYY-MM-DD — scaffold placeholder, not a real session; ships pre-consumed so the first

package/dist/assets/schemas/presence.schema.json

@@ -15,7 +15,7 @@
     "task",
     "message",
     "status",
-    "needs_you",
+    "required_actions",
     "started_at",
     "reported_at",
     "ended_at",
@@ -73,11 +73,11 @@
       ],
       "description": "working: a spell is running; waiting: the session asked the operator for something; blocked: cannot proceed for an external reason; idle: open, no spell running; done: ended (set by end only)."
     },
-    "needs_you": {
+    "required_actions": {
       "type": "array",
       "maxItems": 20,
       "items": {
-        "$ref": "#/$defs/needsYou"
+        "$ref": "#/$defs/requiredAction"
       }
     },
     "started_at": {
@@ -216,7 +216,7 @@
         }
       }
     },
-    "needsYou": {
+    "requiredAction": {
       "type": "object",
       "additionalProperties": false,
       "required": [
@@ -227,7 +227,7 @@
         "action": {
           "type": "string",
           "maxLength": 256,
-          "description": "Exactly what the operator must do: one line of a '## ⚠ Needs you' block.",
+          "description": "Exactly what the operator must do: one line of a '## 🚧 Action required' block.",
           "minLength": 1
         },
         "reason": {
@@ -390,14 +390,33 @@
           "maxLength": 256,
           "description": "Absent keeps the stored value; null clears it."
         },
-        "needs_you": {
+        "required_actions": {
           "type": "array",
           "maxItems": 20,
           "items": {
-            "$ref": "#/$defs/needsYou"
+            "$ref": "#/$defs/requiredAction"
           },
           "description": "Replaces the stored list on every report; absent means []. More than 20 entries is refused with 400, never cut."
+        },
+        "needs_you": {
+          "type": "array",
+          "maxItems": 20,
+          "items": {
+            "$ref": "#/$defs/requiredAction"
+          },
+          "deprecated": true,
+          "description": "The name of required_actions before 1.20 (ARC-060 decision 14), accepted as required_actions for the 1.20 series. Never sent together with required_actions: a body with both is refused with 400 naming needs_you."
         }
+      },
+      "not": {
+        "properties": {
+          "required_actions": true,
+          "needs_you": true
+        },
+        "required": [
+          "required_actions",
+          "needs_you"
+        ]
       }
     },
     "end": {
@@ -528,7 +547,7 @@
       }
     },
     "event": {
-      "description": "One change on GET /v0/events: the event name and the full record after the change. Exactly one event per accepted report, by the precedence started > resumed > needs_you > updated (architecture D5). The record is the truth and the event name is why it was sent: a consumer that alerts on 'needs you' reads the record's needs_you, because a first or a resumed report can carry lines under another event name.",
+      "description": "One change on GET /v0/events: the event name and the full record after the change. Exactly one event per accepted report, by the precedence started > resumed > action_required > updated (architecture D5). The record is the truth and the event name is why it was sent: a consumer that alerts on 'action required' reads the record's required_actions, because a first or a resumed report can carry lines under another event name.",
       "type": "object",
       "additionalProperties": false,
       "required": [
@@ -540,7 +559,7 @@
           "enum": [
             "session.started",
             "session.updated",
-            "session.needs_you",
+            "session.action_required",
             "session.stale",
             "session.resumed",
             "session.ended",

package/dist/index.js

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from "node:module";
 const require = __createRequire(import.meta.url);
 
 // src/index.ts
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import { fileURLToPath } from "url";
 import { dirname as dirname15, join as join31 } from "path";
 
@@ -8419,7 +8419,7 @@ var PRESENCE_ENV = { port: "ARCANE_PRESENCE_PORT", token: "ARCANE_PRESENCE_TOKEN
 var LOOPBACK_HOST = "127.0.0.1";
 var MAX_BODY_BYTES = 65536;
 var MAX_LINE_CHARS = 256;
-var MAX_NEEDS_YOU = 20;
+var MAX_REQUIRED_ACTIONS = 20;
 var MAX_SUBSCRIBERS = 32;
 var MAX_SUBSCRIBER_BUFFER_BYTES = 1048576;
 var MAX_CONNECTIONS = 128;
@@ -8438,7 +8438,7 @@ var ALIAS_CONTEXTS = ["openclaw", "slug"];
 var SESSION_EVENTS = [
   "session.started",
   "session.updated",
-  "session.needs_you",
+  "session.action_required",
   "session.stale",
   "session.resumed",
   "session.ended",
@@ -11255,11 +11255,11 @@ function detectHarness(env) {
 }
 
 // src/modules/presence/reporter.ts
-var NEEDS_YOU_SEPARATOR = " \u2014 ";
-function parseNeedsYou(line2) {
-  const at = line2.indexOf(NEEDS_YOU_SEPARATOR);
+var REQUIRED_ACTION_SEPARATOR = " \u2014 ";
+function parseRequiredAction(line2) {
+  const at = line2.indexOf(REQUIRED_ACTION_SEPARATOR);
   if (at < 0) return { action: line2, reason: null };
-  return { action: line2.slice(0, at), reason: line2.slice(at + NEEDS_YOU_SEPARATOR.length) };
+  return { action: line2.slice(0, at), reason: line2.slice(at + REQUIRED_ACTION_SEPARATOR.length) };
 }
 async function quiet(fn) {
   try {
@@ -11315,7 +11315,7 @@ async function sendReport(cwd, flags, deps = {}) {
     agent: agent2,
     repository: located.repository,
     checkout: located.checkout,
-    needs_you: (flags.needsYou ?? []).map(parseNeedsYou)
+    required_actions: (flags.requiredActions ?? []).map(parseRequiredAction)
   };
   if (flags.spell !== void 0) body["spell"] = flags.spell;
   if (flags.task !== void 0) body["task"] = flags.task;
@@ -11364,7 +11364,7 @@ var PRESENCE_TOOLS = [
         task: { ...LINE, description: "What the session is doing, in one line." },
         spell: { ...LINE, description: "The spell running, e.g. spell-implement." },
         message: { ...LINE, description: "A free one-line note; an empty string clears it." },
-        needs_you: { type: "array", maxItems: 20, items: { type: "string" }, description: "Lines of a Needs you block, '<action> \u2014 <reason>'." },
+        required_actions: { type: "array", maxItems: 20, items: { type: "string" }, description: "Lines of the Now tier of an Action required block, '<action> \u2014 <reason>'." },
         agent: { type: "string", description: "The roster agent (a slug or an alias); default: the orchestrator." },
         harness: { type: "string", enum: [...HARNESSES] },
         cwd: { type: "string", description: "The checkout to report for; default: the server's working directory." }
@@ -11421,16 +11421,16 @@ function serveMcp(options) {
   const report = async (args) => {
     const status = stringArg(args, "status");
     if (status === void 0) return text("status is required: one of working, waiting, blocked, idle.", true);
-    const needs = args["needs_you"];
+    const needs = args["required_actions"];
     if (needs !== void 0 && (!Array.isArray(needs) || needs.some((n) => typeof n !== "string"))) {
-      return text("needs_you must be a list of strings.", true);
+      return text("required_actions must be a list of strings.", true);
     }
     const flags = { status };
     for (const key of ["task", "spell", "message", "agent", "harness"]) {
       const v = stringArg(args, key);
       if (v !== void 0) flags[key] = v;
     }
-    if (Array.isArray(needs)) flags.needsYou = needs;
+    if (Array.isArray(needs)) flags.requiredActions = needs;
     if (resolveEndpoint(deps) === null) return text(NOT_CONFIGURED_TEXT);
     const where = stringArg(args, "cwd") ?? cwd;
     const outcome = await sendReport(where, flags, deps);
@@ -11816,13 +11816,14 @@ function checkout(value) {
   }
   return { path: nonEmpty(c["path"], "checkout.path"), branch: line(c["branch"], "checkout.branch", true), linked_worktree: c["linked_worktree"] };
 }
-function needsYou(value) {
-  if (!Array.isArray(value)) throw new Refusal("invalid_field", "needs_you", "needs_you must be a list");
-  if (value.length > MAX_NEEDS_YOU) {
-    throw new Refusal("too_many_lines", "needs_you", `needs_you carries at most ${MAX_NEEDS_YOU} lines; ${value.length} were sent`);
+var LEGACY_REQUIRED_ACTIONS_KEY = "needs_you";
+function requiredActions(value, key = "required_actions") {
+  if (!Array.isArray(value)) throw new Refusal("invalid_field", key, `${key} must be a list`);
+  if (value.length > MAX_REQUIRED_ACTIONS) {
+    throw new Refusal("too_many_lines", key, `${key} carries at most ${MAX_REQUIRED_ACTIONS} lines; ${value.length} were sent`);
   }
   return value.map((item, i) => {
-    const field = `needs_you.${i}`;
+    const field = `${key}.${i}`;
     const n = closed(item, field, ["action", "reason"]);
     return { action: nonEmptyLine(n["action"], `${field}.action`), reason: line(n["reason"], `${field}.reason`, true) };
   });
@@ -11839,7 +11840,7 @@ function refuse(fn) {
 }
 function validateReport(value) {
   return refuse(() => {
-    const b = closed(value, void 0, ["status", "harness", "agent", "repository", "checkout"], ["spell", "task", "message", "needs_you"]);
+    const b = closed(value, void 0, ["status", "harness", "agent", "repository", "checkout"], ["spell", "task", "message", "required_actions", LEGACY_REQUIRED_ACTIONS_KEY]);
     if (b["status"] === "done") {
       throw new Refusal("invalid_field", "status", "status done is set by ending a session: use POST /v0/sessions/end (spell presence end)");
     }
@@ -11853,7 +11854,11 @@ function validateReport(value) {
     for (const key of ["spell", "task", "message"]) {
       if (key in b) out[key] = line(b[key], key, true);
     }
-    if ("needs_you" in b) out.needs_you = needsYou(b["needs_you"]);
+    if ("required_actions" in b && LEGACY_REQUIRED_ACTIONS_KEY in b) {
+      throw new Refusal("invalid_field", LEGACY_REQUIRED_ACTIONS_KEY, "send required_actions only: needs_you is its name before 1.20");
+    }
+    if ("required_actions" in b) out.required_actions = requiredActions(b["required_actions"]);
+    else if (LEGACY_REQUIRED_ACTIONS_KEY in b) out.required_actions = requiredActions(b[LEGACY_REQUIRED_ACTIONS_KEY], LEGACY_REQUIRED_ACTIONS_KEY);
     return out;
   });
 }
@@ -12095,7 +12100,7 @@ data: ${JSON.stringify(hello)}
 function copy(record) {
   return structuredClone(record);
 }
-function sameNeedsYou(a, b) {
+function sameRequiredActions(a, b) {
   if (a.length !== b.length) return false;
   return a.every((item, i) => item.action === b[i]?.action && item.reason === b[i]?.reason);
 }
@@ -12120,7 +12125,7 @@ function createSessionTable(options) {
       const ms = now();
       const at = new Date(ms).toISOString();
       const key = body.checkout.path;
-      const needsYou2 = (body.needs_you ?? []).map((n) => ({ action: n.action, reason: n.reason }));
+      const requiredActions2 = (body.required_actions ?? []).map((n) => ({ action: n.action, reason: n.reason }));
       const existing = entries.get(key);
       if (existing === void 0) {
         const record2 = {
@@ -12133,7 +12138,7 @@ function createSessionTable(options) {
           task: body.task ?? null,
           message: body.message ?? null,
           status: body.status,
-          needs_you: needsYou2,
+          required_actions: requiredActions2,
           started_at: at,
           reported_at: at,
           ended_at: null,
@@ -12145,7 +12150,7 @@ function createSessionTable(options) {
       }
       const record = existing.record;
       const wasStale = record.stale;
-      const needsChanged = !sameNeedsYou(record.needs_you, needsYou2);
+      const needsChanged = !sameRequiredActions(record.required_actions, requiredActions2);
       record.agent = structuredClone(body.agent);
       record.harness = body.harness;
       record.repository = structuredClone(body.repository);
@@ -12154,11 +12159,11 @@ function createSessionTable(options) {
       if (body.task !== void 0) record.task = body.task;
       if (body.message !== void 0) record.message = body.message;
       record.status = body.status;
-      record.needs_you = needsYou2;
+      record.required_actions = requiredActions2;
       record.reported_at = at;
       record.stale = false;
       existing.reportedMs = ms;
-      const event = wasStale ? "session.resumed" : needsChanged ? "session.needs_you" : "session.updated";
+      const event = wasStale ? "session.resumed" : needsChanged ? "session.action_required" : "session.updated";
       emit(event, record);
       return { record: copy(record), created: false, event };
     },
@@ -12380,7 +12385,7 @@ function renderSessionsTable(sessions, now) {
   const out = [line2(header)];
   sessions.forEach((s, i) => {
     out.push(line2(rows[i]));
-    for (const n of s.needs_you) out.push(`  needs you: ${n.reason === null ? n.action : `${n.action} \u2014 ${n.reason}`}`);
+    for (const n of s.required_actions) out.push(`  action required: ${n.reason === null ? n.action : `${n.action} \u2014 ${n.reason}`}`);
   });
   return out;
 }
@@ -12705,8 +12710,9 @@ function collectLine(value, previous) {
   return [...previous, value];
 }
 var exitZero = () => process.exit(0);
-presenceCommand.command("report").description("Report this checkout's session to the presence service. Silent, exit 0, when no channel is configured; never blocks").requiredOption("--status <status>", "working | waiting | blocked | idle").option("--task <line>", "What the session is doing, in one line").option("--spell <id>", "The spell running, e.g. spell-implement").option("--message <line>", "A free one-line note; an empty value clears it").option("--needs-you <line>", "One line of a Needs you block, '<action> \u2014 <reason>'; repeat per line", collectLine, []).option("--agent <slug>", "The roster agent this session reports as (a slug or an alias); default: the orchestrator").option("--harness <id>", "claude-code | copilot | codex | openclaw | cron | other; default: detected, else other").exitOverride(exitZero).action(async (opts) => {
-  const run = await runPresenceReport(process.cwd(), opts);
+presenceCommand.command("report").description("Report this checkout's session to the presence service. Silent, exit 0, when no channel is configured; never blocks").requiredOption("--status <status>", "working | waiting | blocked | idle").option("--task <line>", "What the session is doing, in one line").option("--spell <id>", "The spell running, e.g. spell-implement").option("--message <line>", "A free one-line note; an empty value clears it").option("--required-action <line>", "One open line of the Now tier of an Action required block, '<action> \u2014 <reason>'; repeat per line", collectLine, []).addOption(new Option("--needs-you <line>").argParser(collectLine).default([]).hideHelp()).option("--agent <slug>", "The roster agent this session reports as (a slug or an alias); default: the orchestrator").option("--harness <id>", "claude-code | copilot | codex | openclaw | cron | other; default: detected, else other").exitOverride(exitZero).action(async (opts) => {
+  const { requiredAction, needsYou, ...rest } = opts;
+  const run = await runPresenceReport(process.cwd(), { ...rest, requiredActions: [...requiredAction, ...needsYou] });
   process.exitCode = 0;
   if (run.timedOut) process.exit(0);
 });