@join-pantheon/cli 0.21.3 → 0.23.0

package/dist/setup-guide.js

@@ -59,7 +59,13 @@ export function questionnaire() {
     const opt = (flag, id, label) => `     ${label}  → --${flag} ${id}`;
     return [
         "pantheon setup — the questions, and the flag for each answer.",
-        "Ask your human each one in plain words, then run:  pantheon setup --yes <flags>",
+        "Ask your human in plain words, then pass the answers as flags — to `pantheon setup --yes`, or straight to",
+        "`pantheon start` / `pantheon join`, which apply them the moment the team exists.",
+        "",
+        "Only 3 and 4 need the person every time. Ask 2 whenever there is a repo (it is the one default people are",
+        "surprised by). The rest have defaults you may take and say out loud:",
+        "  --wake anyone --decides none --alerts decisions --playbook yes --base <what origin calls its default>",
+        "Without a repo, --wake, --commands, --playbook and --base do nothing yet: skip them and say so.",
         "",
         "1. While they're away, may teammates hand work to this machine? (their agent runs here on its own,",
         "   in a separate copy of the repo, and delivers on a branch for review)",
@@ -71,7 +77,7 @@ export function questionnaire() {
         `4. Their role, in a word (${TITLE_OPTIONS.slice(0, -1).join(", ")}, or their own).  → --title \"…\"`,
         "5. Which of these do they decide personally? Agents will stop and ask them first. Any number, or none.",
         ...DECISION_AREAS.map((x) => `     ${x.label}  → ${x.id}`),
-        "     pass them comma-separated: --decides deployment,pricing   (or --decides none)",
+        "     pass them comma-separated: --decides deployment,pricing   (or --decides none) — the full list; an area not named is released",
         "6. Which desktop alerts do they want?",
         ...ALERT_OPTIONS.map((o) => opt("alerts", o.id, o.label)),
         "7. Should their worker follow a short written playbook for this repo? (skip if --wake no)",
@@ -146,42 +152,76 @@ export async function runGuide(io, ctx, deps = {}, preset = {}) {
     }
     const applied = [], warnings = [];
     if (io) {
-        io.say("A few choices only you can make. Pick a number; Enter keeps the suggested one.\n");
-        const wakeIdx = await io.choose("While you're away, may teammates hand work to this machine? Your agent would run here on its own, in a separate copy of the repo, and deliver on a branch for review.", WAKE_OPTIONS.map((o) => o.label), Math.max(0, WAKE_OPTIONS.findIndex((o) => o.id === d.wake)));
-        a.wake = WAKE_OPTIONS[wakeIdx].id;
-        if (a.wake !== "no" && ctx.project) {
-            const c = await io.choose("When a teammate's request wakes this machine, what may the run do?", ["Edit files only — it can answer questions and draft changes, but cannot run tests, commit, or push.",
-                "Run commands too — needed to run tests and to commit and push work for review. Only requests from people you granted wake permission start a run."], a.commands ? 1 : 0);
-            a.commands = c === 1;
-        }
-        else if (a.wake === "no") {
-            a.commands = false;
-        }
+        io.say("Three questions, then one screen of defaults. Enter keeps the suggested answer.\n");
         a.name = (await io.ask("Your name, as teammates will see it", d.name)).trim() || d.name;
         const known = TITLE_OPTIONS.findIndex((t) => t.toLowerCase() === d.title.toLowerCase());
         const t = await io.choose("Your role, in a word — it goes on the team directory", TITLE_OPTIONS, known >= 0 ? known : d.title ? TITLE_OPTIONS.length - 1 : 0);
         a.title = t === TITLE_OPTIONS.length - 1 ? (await io.ask("Your role", d.title)).trim() || d.title || "Member" : TITLE_OPTIONS[t];
-        const picks = await io.chooseMany("Which of these do you decide personally? Agents — yours and your teammates' — will stop and ask you before acting on them. Pick any number, or none.", DECISION_AREAS.map((x) => x.label), d.decides.map((id) => DECISION_AREAS.findIndex((x) => x.id === id)).filter((i) => i >= 0));
-        a.decides = [...new Set(picks.map((i) => DECISION_AREAS[i].id))];
-        const n = await io.choose("Which desktop alerts do you want?", ALERT_OPTIONS.map((o) => o.label), Math.max(0, ALERT_OPTIONS.findIndex((o) => o.id === d.notifications)));
-        a.notifications = ALERT_OPTIONS[n].id;
+        const askCommands = async () => {
+            const undecided = profile.agent.allow_bash === undefined && preset.commands === undefined;
+            const c = await io.choose("Teammates can hand work to this machine while you're away. It runs in a separate copy of the repo and delivers on a branch you review. May a run also execute commands?", ["Yes — run tests, commit, and push work for review (recommended)",
+                "No — edit files and answer only; it cannot run tests, commit, or push"], undecided || a.commands ? 0 : 1);
+            a.commands = c === 0;
+        };
+        let commandsAsked = false;
         if (a.wake !== "no" && ctx.project) {
-            const p = await io.choose("Should your worker follow a short written playbook for this repo? It says what a woken run may do here and what it must leave to you. You can edit it any time.", ["Yes — write a starter playbook now (recommended)", "Not now"], 0);
-            a.persona = p === 0;
+            await askCommands();
+            commandsAsked = true;
         }
         const detected = ctx.project && deps.setRepoBase ? detectBaseBranch(ctx.project) : null;
-        if (detected) {
-            const suggested = preset.base ?? detected;
-            const b = await io.choose("Which branch should your worker start from, and deliveries be checked against? Usually the branch this project deploys or releases from.", [`${suggested}${suggested === detected ? " (what origin calls its default)" : ""}`, "A different branch"], 0);
-            a.base = b === 0 ? suggested : ((await io.ask("Branch name", suggested)).trim() || suggested);
+        const suggestedBase = detected ? (preset.base ?? detected) : undefined;
+        if (a.wake !== "no" && ctx.project)
+            a.persona = preset.persona ?? true;
+        const shortAlert = (id) => ALERT_OPTIONS.find((o) => o.id === id).label.split(" — ")[0].replace(/ \(recommended\)/, "");
+        io.say("\nThe rest has defaults. Change them now, or any time with `pantheon setup`:");
+        io.say(`  • Wake: ${a.wake === "no" ? "off — this machine only works while you are at it"
+            : !ctx.project ? "on once this machine has a repo (run pantheon setup from your project's repo)"
+                : a.wake === "anyone" ? "teammates may hand work to this machine while you're away; invites you send grant it, and you can revoke anyone (pantheon admit <name> --revoke)"
+                    : "only people you approve by hand (pantheon admit <name> --may-wake)"}`);
+        io.say(`  • Alerts: ${shortAlert(a.notifications).toLowerCase()}`);
+        io.say(`  • Decisions: ${a.decides.length ? `you personally decide ${a.decides.join(", ")}` : "none reserved for you — your agent may decide; add an area when one comes up"}`);
+        if (a.wake !== "no" && ctx.project)
+            io.say(`  • Playbook: ${a.persona ? "a short starter playbook for your worker, in this repo" : "none"}`);
+        if (suggestedBase)
+            io.say(`  • Base branch: ${suggestedBase}${suggestedBase === detected ? " (what origin calls its default)" : ""}`);
+        const keep = await io.choose("Keep these?", ["Keep them (recommended)", "Change some"], 0);
+        if (keep === 0) {
+            if (suggestedBase)
+                a.base = suggestedBase;
+        }
+        else {
+            const wakeIdx = await io.choose("While you're away, may teammates hand work to this machine? Your agent would run here on its own, in a separate copy of the repo, and deliver on a branch for review.", WAKE_OPTIONS.map((o) => o.label), Math.max(0, WAKE_OPTIONS.findIndex((o) => o.id === a.wake)));
+            a.wake = WAKE_OPTIONS[wakeIdx].id;
+            if (a.wake === "no") {
+                a.commands = false;
+                a.persona = false;
+            }
+            else if (ctx.project && !commandsAsked) {
+                await askCommands();
+                a.persona = preset.persona ?? true;
+            }
+            const picks = await io.chooseMany("Which of these do you decide personally? Agents — yours and your teammates' — will stop and ask you before acting on them. Pick any number, or none.", DECISION_AREAS.map((x) => x.label), a.decides.map((id) => DECISION_AREAS.findIndex((x) => x.id === id)).filter((i) => i >= 0));
+            a.decides = [...new Set(picks.map((i) => DECISION_AREAS[i].id))];
+            const n = await io.choose("Which desktop alerts do you want?", ALERT_OPTIONS.map((o) => o.label), Math.max(0, ALERT_OPTIONS.findIndex((o) => o.id === a.notifications)));
+            a.notifications = ALERT_OPTIONS[n].id;
+            if (a.wake !== "no" && ctx.project) {
+                const p = await io.choose("Should your worker follow a short written playbook for this repo? It says what a woken run may do here and what it must leave to you. You can edit it any time.", ["Yes — write a starter playbook now (recommended)", "Not now"], a.persona ? 0 : 1);
+                a.persona = p === 0;
+            }
+            if (suggestedBase) {
+                const b = await io.choose("Which branch should your worker start from, and deliveries be checked against? Usually the branch this project deploys or releases from.", [`${suggestedBase}${suggestedBase === detected ? " (what origin calls its default)" : ""}`, "A different branch"], 0);
+                a.base = b === 0 ? suggestedBase : ((await io.ask("Branch name", suggestedBase)).trim() || suggestedBase);
+            }
         }
     }
     let next = a.title ? applyProfileInit(profile, { name: a.name, title: a.title }) : { ...profile, human: { ...profile.human, display_name: a.name } };
     const authority = { ...next.authority };
+    const prior = guideDefaults(profile, ctx.cfg).decides;
+    const replace = !!io || preset.decides !== undefined;
     for (const area of DECISION_AREAS) {
         if (a.decides.includes(area.id))
             authority[area.id] = "human_required";
-        else if (authority[area.id] === "human_required" && d.decides.includes(area.id) && io)
+        else if (authority[area.id] === "human_required" && prior.includes(area.id) && replace)
             delete authority[area.id];
     }
     next = {

package/dist/tray.js

@@ -87,6 +87,8 @@ export async function trayStatus(cfg = load()) {
             ...first,
             space: ok.map((p) => p.space).join(" · "),
             relay_ok: ok.every((p) => p.relay_ok),
+            decisions_ok: ok.every((p) => p.decisions_ok),
+            unavailable_spaces: ok.flatMap((p) => p.unavailable_spaces ?? []),
             online: ok.reduce((n, p) => n + (p.online ?? 0), 0),
             members: ok.reduce((n, p) => n + (p.members ?? 0), 0),
             decisions: ok.flatMap((p) => (p.decisions ?? []).map((d) => ({ ...d, body: `[${p.space}] ${d.body}` }))),
@@ -106,8 +108,10 @@ async function trayStatusOne(cfg) {
     ]);
     const space = health
         ?.spaces?.find((s) => s.name === cfg.space);
-    const decisions = (obligations?.obligations ?? [])
-        .map((o) => ({ id: o.id, body: decisionTitle(o.body), prompt: decisionPrompt(o.id) }));
+    const pending = obligations?.obligations;
+    const decisionsOk = Array.isArray(pending) && pending.every((o) => o && typeof o.id === "string" && typeof o.body === "string");
+    const decisions = (decisionsOk ? pending : [])
+        .map((o) => ({ id: o.id, body: decisionTitle(o.body), detail: o.body, prompt: decisionPrompt(o.id) }));
     const profile = loadProfile(cfg);
     const surface = profile.agent.primary_surface;
     const surfaceName = surface === "claude-code" ? "Claude" : surface === "cursor" ? "Cursor" : "Codex";
@@ -119,6 +123,8 @@ async function trayStatusOne(cfg) {
         member: cfg.member,
         relay: cfg.relay,
         relay_ok: !!space,
+        decisions_ok: decisionsOk,
+        unavailable_spaces: !space || !decisionsOk ? [cfg.space] : [],
         online: space?.online ?? 0,
         members: space?.members ?? 0,
         worker_running: workerProc().running,

package/dist/worker.js

@@ -10,7 +10,7 @@ import { applyAnswer, loadPolicy, mayAsk, needsSelfUpgrade, recordAsk, savePolic
 import { agentHookStates, repairHook } from "./notify.js";
 import { fence, assess } from "./untrusted.js";
 import { allowed, recordRun } from "./spend.js";
-import { loadProfile } from "./profile.js";
+import { loadProfile, reservedDecisionsNote } from "./profile.js";
 import { clip, workerDoneNotice } from "./brief.js";
 import { loadPersonas, matchPersona, personaByName, personaMatches, effectivePolicy, personaBrief, describePersona, } from "./persona.js";
 import { isContinuationFor, LIMITS, shouldDeferToHuman } from "./protocol.js";
@@ -536,7 +536,8 @@ export class Worker {
             this.opts.log(`! ${detail}`);
             return { obligation: o, branch, worktree, ok: false, detail };
         }
-        const brief = makeBrief(branch) + baseNote(baseRef, baseSha);
+        const reserved = reservedDecisionsNote(loadProfile(this.cfg));
+        const brief = makeBrief(branch) + baseNote(baseRef, baseSha) + (reserved ? `\n\n${reserved}` : "");
         writeFileSync(join(worktree, ".pantheon-task.md"), brief);
         let command;
         let args;
@@ -692,6 +693,10 @@ export class Worker {
                 result = { ok: false, alreadyCurrent: false, from: VERSION, to: relayPkg ?? "?" };
                 this.opts.log(`! self-upgrade failed: ${e.message}`);
             }
+            if (result.ok && !result.alreadyCurrent && result.to === result.from) {
+                this.opts.log(`* self-upgrade: the registry does not serve ${relayPkg} yet (installed ${result.to}); will check again`);
+                return;
+            }
             if (result.ok && !result.alreadyCurrent) {
                 await client.send({
                     act: "NOTE", goal: null, after_seq: client.readSeq,

package/helper/macos/menubar.swift

@@ -26,6 +26,8 @@ let pollSeconds = argv.count >= 3 ? (Double(argv[2]) ?? 15) : 15
 struct TrayState {
   var configured = false
   var reachable = false          // did tray-status itself run and parse
+  var decisionsOk = false
+  var unavailableSpaces: [String] = []
   var relayOk = false
   var space = ""
   var member = ""
@@ -40,7 +42,7 @@ struct TrayState {
   var surfaceName = "agent"
   var surfaceBundleID = ""
   var decisionsPrompt = ""
-  var decisions: [(id: String, body: String, prompt: String)] = []
+  var decisions: [(id: String, body: String, detail: String, prompt: String)] = []
   var version = ""
 }
 
@@ -70,6 +72,8 @@ func fetchState() -> TrayState {
   s.reachable = true
   s.configured = j["configured"] as? Bool ?? false
   s.version = j["version"] as? String ?? ""
+  s.decisionsOk = j["decisions_ok"] as? Bool ?? false
+  s.unavailableSpaces = j["unavailable_spaces"] as? [String] ?? []
   s.relayOk = j["relay_ok"] as? Bool ?? false
   s.space = j["space"] as? String ?? ""
   s.member = j["member"] as? String ?? ""
@@ -88,6 +92,7 @@ func fetchState() -> TrayState {
     s.decisions.append((
       id: d["id"] as? String ?? "",
       body: d["body"] as? String ?? "",
+      detail: d["detail"] as? String ?? d["body"] as? String ?? "",
       prompt: d["prompt"] as? String ?? ""
     ))
   }
@@ -98,6 +103,11 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
   private var item: NSStatusItem!
   private var state = TrayState()
   private var timer: Timer?
+  private var refreshing = false
+  private var menuOpen = false
+  private var hasLoaded = false
+  private var workerAction: String?
+  private var actionError: String?
 
   func applicationDidFinishLaunching(_ note: Notification) {
     NSApp.setActivationPolicy(.accessory)
@@ -105,6 +115,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
     let menu = NSMenu()
     menu.delegate = self
     item.menu = menu
+    paint()
     refresh()
     timer = Timer.scheduledTimer(withTimeInterval: pollSeconds, repeats: true) { [weak self] _ in
       self?.refresh()
@@ -112,12 +123,25 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
   }
 
   @objc func refresh() {
+    guard !refreshing else { return }
+    refreshing = true
     DispatchQueue.global().async {
       let next = fetchState()
-      DispatchQueue.main.async { self.state = next; self.paint() }
+      DispatchQueue.main.async {
+        self.state = next
+        self.hasLoaded = true
+        self.refreshing = false
+        self.paint()
+        if !self.menuOpen, let menu = self.item.menu { self.menuNeedsUpdate(menu) }
+      }
     }
   }
 
+  // Keep targets stable while a person is navigating the menu. The badge can
+  // refresh immediately; refreshed rows appear on the next opening.
+  func menuWillOpen(_ menu: NSMenu) { menuOpen = true; refresh() }
+  func menuDidClose(_ menu: NSMenu) { menuOpen = false }
+
   enum MarkMode { case full, idle, off }
 
   /// The Three Stones mark — the product's own logo, the same three arcs the
@@ -164,68 +188,87 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
   private func paint() {
     let mode: MarkMode = !state.configured || !state.relayOk ? .off : state.workerRunning ? .full : .idle
     item.button?.image = markImage(mode)
-    item.button?.title = state.decisions.isEmpty ? "" : " \(state.decisions.count)"
+    let unknown = hasLoaded && (!state.reachable || (state.configured && !state.decisionsOk))
+    item.button?.title = actionError != nil ? " !" : state.decisions.isEmpty ? (unknown ? " !" : "") : " \(state.decisions.count)\(unknown ? "+" : "")"
     item.button?.imagePosition = .imageLeading
-    item.button?.toolTip = state.configured
-      ? "pantheon — \(state.member) in \(state.space)\(state.relayOk ? "" : " (relay unreachable)")"
-      : "pantheon — not joined to a space yet"
+    let summary = !hasLoaded ? "Checking status…" : !state.reachable ? "Unable to check status" : !state.configured ? "Not joined to a team yet" : !state.decisionsOk ? "Unable to check every decision" : state.decisions.isEmpty ? "No decisions need your input" : "\(state.decisions.count) decisions need your input"
+    item.button?.toolTip = "Pantheon — " + (actionError ?? summary)
+    item.button?.setAccessibilityLabel("Pantheon — " + (actionError ?? summary))
   }
 
   func menuNeedsUpdate(_ menu: NSMenu) {
     menu.removeAllItems()
     let info = { (text: String) in
-      let mi = NSMenuItem(title: text, action: nil, keyEquivalent: ""); mi.isEnabled = false
+      let title = text.count > 110 ? String(text.prefix(109)) + "…" : text
+      let mi = NSMenuItem(title: title, action: nil, keyEquivalent: "")
+      mi.isEnabled = false
+      mi.toolTip = text
+      mi.attributedTitle = NSAttributedString(string: title, attributes: [.foregroundColor: NSColor.labelColor])
       menu.addItem(mi)
     }
 
-    if !state.reachable {
-      info("pantheon CLI is not answering")
-      info("check: \(pantheonBin)")
+    if !hasLoaded {
+      info("Checking Pantheon…")
+    } else if !state.reachable {
+      info("Unable to check Pantheon status")
+      info("Try Refresh now, or Check connection below")
     } else if !state.configured {
-      info("Not joined to a space yet")
-      info("Run `pantheon start` or `pantheon join <invite>`")
+      info("Connect with your team")
+      info("Run pantheon start, or join with an invite link")
     } else {
-      info("\(state.member) in \(state.space)  ·  v\(state.version)")
+      info("\(state.member) · \(state.space)")
       info(state.relayOk
-        ? "Relay reachable  ·  \(state.online) of \(state.members) members online"
-        : "Relay unreachable — peers cannot reach you")
-      info("\(state.workerRunning ? "●" : "○") Unattended work \(state.workerRunning ? "on" : "off")   " +
-           "\(state.notifierRunning ? "●" : "○") Alerts   \(state.hookOn ? "●" : "○") Wake hook")
-      if !state.workerState.isEmpty {
-        info("Worker: " + String(state.workerState.prefix(80)))
-      }
-
+        ? "Connected · \(state.online) of \(state.members) members online"
+        : "Connection unavailable · \(state.unavailableSpaces.joined(separator: ", "))")
       menu.addItem(.separator())
+      if !state.decisionsOk {
+        info("Some decisions could not be checked")
+        info("Refresh to try again. The count may be incomplete.")
+      }
       if state.decisions.isEmpty {
-        info("You are all caught up")
+        if state.decisionsOk { info("No decisions need your input") }
       } else {
         let noun = state.decisions.count == 1 ? "decision needs" : "decisions need"
         info("\(state.decisions.count) \(noun) your input")
-        info("Choose one — your agent opens with the question already asked")
         for d in state.decisions.prefix(5) {
-          let item = makeItem(String(d.body.prefix(100)), #selector(openDecision(_:)))
-          item.representedObject = [d.id, d.prompt]
-          menu.addItem(item)
+          let decision = makeItem(d.body.count > 72 ? String(d.body.prefix(71)) + "…" : d.body, #selector(openDecision(_:)))
+          decision.toolTip = d.detail
+          decision.representedObject = [d.id, d.prompt]
+          menu.addItem(decision)
         }
-        if state.decisions.count > 1 {
-          menu.addItem(makeItem("Explain all in \(state.surfaceName)", #selector(openAllDecisions)))
-        }
-        menu.addItem(makeItem("View all decision details", #selector(openApprovals)))
+        menu.addItem(makeItem("\(state.decisions.count > 5 ? "Review all \(state.decisions.count) decisions" : "Review decisions") in \(state.surfaceName)", #selector(openAllDecisions)))
       }
-
       menu.addItem(.separator())
-      if state.workerRunning {
+      info(state.workerRunning ? "Unattended work is on" : state.workerInstalled ? "Unattended work is paused" : "Unattended work is not set up")
+      if !state.workerState.isEmpty && state.workerRunning { info(state.workerState) }
+      if let action = workerAction {
+        info(action)
+      } else if state.workerRunning {
         menu.addItem(makeItem("Pause unattended work", #selector(pauseWorker)))
       } else if state.workerInstalled {
         menu.addItem(makeItem("Resume unattended work", #selector(resumeWorker)))
       } else {
-        info("Unattended work not set up (pantheon service install worker)")
+        info("Set up with pantheon service install worker")
       }
     }
+    if let error = actionError {
+      menu.addItem(.separator())
+      info(error)
+    }
 
+    let details = NSMenuItem(title: "Diagnostics", action: nil, keyEquivalent: "")
+    let submenu = NSMenu()
+    for text in ["Version \(state.version)", "Alerts: \(state.notifierRunning ? "running" : "off")", "Wake hook: \(state.hookOn ? "installed" : "off")"] {
+      let row = NSMenuItem(title: text, action: nil, keyEquivalent: "")
+      row.isEnabled = false
+      submenu.addItem(row)
+    }
+    submenu.addItem(makeItem("View decision details in Terminal", #selector(openApprovals)))
+    details.submenu = submenu
+    menu.addItem(details)
     menu.addItem(.separator())
     menu.addItem(makeItem("Open status in Terminal", #selector(openStatus)))
-    menu.addItem(makeItem("Run doctor in Terminal", #selector(openDoctor)))
+    menu.addItem(makeItem("Check connection in Terminal", #selector(openDoctor)))
     menu.addItem(makeItem("Refresh now", #selector(refreshNow)))
     menu.addItem(.separator())
     menu.addItem(makeItem("Quit pantheon menu bar", #selector(quit)))
@@ -237,15 +280,26 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
     return mi
   }
 
+  private func changeWorker(_ title: String, path: String, args: [String]) {
+    guard workerAction == nil else { return }
+    workerAction = title
+    actionError = nil
+    paint()
+    if let menu = item.menu { menuNeedsUpdate(menu) }
+    DispatchQueue.global().async {
+      let result = run(path, args)
+      DispatchQueue.main.async {
+        self.workerAction = nil
+        if result?.code != 0 { self.reportFailure("Could not change unattended work. Check connection in Terminal.") }
+        self.refresh()
+      }
+    }
+  }
   @objc private func pauseWorker() {
-    DispatchQueue.global().async { _ = run(pantheonBin, ["stop", "worker"]); self.refresh() }
+    changeWorker("Pausing unattended work…", path: pantheonBin, args: ["stop", "worker"])
   }
   @objc private func resumeWorker() {
-    let plist = state.workerPlist
-    DispatchQueue.global().async {
-      _ = run("/bin/launchctl", ["load", "-w", plist])
-      self.refresh()
-    }
+    changeWorker("Resuming unattended work…", path: "/bin/launchctl", args: ["load", "-w", state.workerPlist])
   }
   // .command files are written by `pantheon menubar` next to the tray binary;
   // Terminal owns running them, so an unsigned accessory app never needs
@@ -273,13 +327,26 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
     }
     let dir = (Bundle.main.executablePath as NSString?)?.deletingLastPathComponent
       ?? URL(fileURLWithPath: CommandLine.arguments[0]).deletingLastPathComponent().path
-    try? id.write(toFile: dir + "/.explain-id", atomically: true, encoding: .utf8)
-    openCommand("pantheon-explain.command")
+    do {
+      try id.write(toFile: dir + "/.explain-id", atomically: true, encoding: .utf8)
+      openCommand("pantheon-explain.command")
+    } catch {
+      reportFailure("Could not open your agent. The question is copied; paste it into your agent.")
+    }
   }
   private func openCommand(_ name: String) {
     let dir = (Bundle.main.executablePath as NSString?)?.deletingLastPathComponent
       ?? URL(fileURLWithPath: CommandLine.arguments[0]).deletingLastPathComponent().path
-    NSWorkspace.shared.open(URL(fileURLWithPath: dir + "/" + name))
+    if !NSWorkspace.shared.open(URL(fileURLWithPath: dir + "/" + name)) {
+      reportFailure("Could not open Terminal. Run pantheon doctor to check your setup.")
+    } else {
+      actionError = nil
+      paint()
+    }
+  }
+  private func reportFailure(_ message: String) {
+    actionError = message
+    paint()
   }
   @objc private func refreshNow() { refresh() }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@join-pantheon/cli",
-  "version": "0.21.3",
+  "version": "0.23.0",
   "description": "Let your coding agent collaborate directly with your teammates' agents — ask, agree an interface, and deliver, without a human relaying messages.",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
     "build": "rm -rf dist && tsc -p .",
     "dev": "tsc -p . --watch",
     "relay": "node dist/cli.js relay",
-    "test": "PANTHEON_HOME=\"$(mktemp -d)\" node --test --test-force-exit dist/test/*.test.js",
+    "test": "PANTHEON_HOME=\"$(mktemp -d)\" HOME=\"$(mktemp -d)\" node --test --test-force-exit dist/test/*.test.js",
     "prepare": "npm run build",
     "prepublishOnly": "npm run build && npm test",
     "start": "node dist/cli.js relay"