@join-pantheon/cli 0.23.0 → 0.23.2

package/dist/cli.js

@@ -2108,6 +2108,60 @@ async function main() {
                 if (id === "all")
                     id = undefined;
             }
+            let hud = null;
+            if (argv.includes("--queued")) {
+                const f = join(CONFIG_DIR, "bin", ".hud-action.json");
+                try {
+                    hud = JSON.parse(readFileSync(f, "utf8"));
+                    rmSync(f, { force: true });
+                }
+                catch {
+                    hud = null;
+                }
+            }
+            if (hud?.action === "details") {
+                const acts = await fetchHistory(cfg).catch(() => []);
+                const a = hud.act ? acts.find((x) => x.id === hud.act) : undefined;
+                if (a) {
+                    console.log(formatAct(a));
+                    if (a.ref) {
+                        const r = acts.find((x) => x.id === a.ref);
+                        if (r)
+                            console.log(D("\nin reply to:\n") + formatAct(r, { short: true }));
+                    }
+                }
+                else if (!hud.decision)
+                    console.log(D("that act is no longer in what the relay holds"));
+                if (hud.decision) {
+                    const c2 = new PantheonClient(cfg, undefined, { role: "cli" });
+                    await c2.connect().catch((e) => die(e.message));
+                    const o = c2.obligations.find((x) => x.id === hud.decision);
+                    c2.close();
+                    if (o)
+                        console.log(`\n${B("Decision required")}  ${o.id}\n  ${o.body}\n\nAnswer: ${C(`pantheon approvals answer ${o.id} 'your decision and rationale'`)}\n${D(`or have your agent explain it: pantheon explain ${o.id}`)}`);
+                    else
+                        console.log(D("\nthat decision is no longer waiting on you"));
+                }
+                return;
+            }
+            if (hud?.action === "open") {
+                const p = loadProfile(cfg);
+                if (hud.tool && isAgentSurface(hud.tool) && p.agent.primary_surface !== hud.tool) {
+                    saveProfile({ ...p, agent: { ...p.agent, primary_surface: hud.tool }, updated_at: Date.now() });
+                    console.error(D(`${hud.tool} is now where your decisions open`));
+                }
+                if (hud.prompt) {
+                    const agent = pickExplainAgent(hud.tool ?? p.agent.primary_surface, detectAvailable());
+                    if (!agent)
+                        die("no agent CLI found on this machine (claude, cursor-agent, or codex)");
+                    console.error(D(`opening ${agent.id}…`));
+                    const { spawnSync } = await import("node:child_process");
+                    spawnSync(agent.binary, [hud.prompt], { stdio: "inherit" });
+                    return;
+                }
+                if (hud.decision)
+                    id = hud.decision;
+            }
             const client = new PantheonClient(cfg, undefined, { role: "cli" });
             await client.connect().catch((e) => die(e.message));
             const waiting = client.obligations.filter((o) => o.kind === "HUMAN" && o.owner === `human:${cfg.member}`);
@@ -2230,14 +2284,10 @@ async function main() {
                     graceMs: numFlag("grace", LIMITS.workerGraceMs / 1000) * 1000,
                     once: argv.includes("--once"),
                     ...(argv.includes("--no-notify") ? {} : {
-                        notify: (n) => {
-                            try {
-                                const c = load();
-                                if (c)
-                                    sendDesktopNotification(n.title, n.subtitle, n.body, loadProfile(c), "", n.eyebrow);
-                            }
-                            catch { }
-                        },
+                        notify: (n) => { try {
+                            sendDesktopNotification(n);
+                        }
+                        catch { } },
                     }),
                     log: (l) => console.error(l),
                 });
@@ -2265,12 +2315,10 @@ async function main() {
                 graceMs: numFlag("grace", LIMITS.workerGraceMs / 1000) * 1000,
                 once: argv.includes("--once"),
                 ...(argv.includes("--no-notify") ? {} : {
-                    notify: (n) => {
-                        try {
-                            sendDesktopNotification(n.title, n.subtitle, n.body, loadProfile(cfg), "", n.eyebrow);
-                        }
-                        catch { }
-                    },
+                    notify: (n) => { try {
+                        sendDesktopNotification(n);
+                    }
+                    catch { } },
                 }),
                 log: (l) => console.error(l),
             });

package/dist/client.js

@@ -469,6 +469,14 @@ export class PantheonClient {
     recentFrom(id) {
         return this.seen.get(id)?.from ?? null;
     }
+    seenAct(id) {
+        return this.seen.get(id) ?? null;
+    }
+    mineSince(ts, goal) {
+        return [...this.seen.values()]
+            .filter((r) => r.from === this.cfg.member && r.ts >= ts && r.act !== "JOIN" && r.act !== "LEAVE" && (goal == null || r.goal === goal))
+            .sort((a, b) => a.seq - b.seq);
+    }
     takenBySibling() {
         return this.myObligations().filter((o) => o.claimed_by && o.claimed_by.session !== this.session);
     }

package/dist/notice.js

@@ -0,0 +1,157 @@
+import { decisionPrompt, decisionTitle } from "./decision-ui.js";
+export const TOOL_LABELS = { "claude-code": "Claude Code", codex: "Codex", cursor: "Cursor" };
+export const BUDGET = { who: 60, heading: 40, context: 70, body: 190 };
+const oneLine = (s) => s.replace(/\s+/g, " ").trim();
+export function fit(text, max) {
+    const t = oneLine(text);
+    if (t.length <= max)
+        return t;
+    const cut = t.slice(0, max - 1);
+    const space = cut.lastIndexOf(" ");
+    return `${(space > max * 0.6 ? cut.slice(0, space) : cut).trimEnd()}…`;
+}
+export function enrich(summary, body, max) {
+    const head = plain(summary);
+    const sentences = plain(body).split(/(?<=[.!?])\s+/).filter(Boolean);
+    let out = head;
+    for (const s of sentences) {
+        if (!out) {
+            out = s;
+            continue;
+        }
+        if (out.includes(s.slice(0, 40)))
+            continue;
+        if (out.length + 1 + s.length > max)
+            break;
+        out = `${out} ${s}`;
+    }
+    return fit(out || head, max);
+}
+export function relTime(ts, now = Date.now()) {
+    const s = Math.max(0, Math.round((now - ts) / 1000));
+    if (s < 45)
+        return "just now";
+    const m = Math.round(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.round(m / 60);
+    if (h < 24)
+        return `${h}h ago`;
+    const d = Math.round(h / 24);
+    return d === 1 ? "yesterday" : `${d}d ago`;
+}
+export function plain(text) {
+    return oneLine(text)
+        .replace(/^[a-z0-9._-]+\s+(?:asked|asks|says|said|needs a decision|escalated)\s*:\s*/i, "")
+        .replace(/^(?:ASK|ANSWER|PROPOSE|ACCEPT|OBJECT|CONTRACT|COMMIT|DELIVERED|ESCALATE|HUMAN_REQUIRED|NOTE|CLOSE)\s+from\s+[a-z0-9._-]+\s*:\s*/i, "")
+        .replace(/^(?:ASK|ANSWER|PROPOSE|ACCEPT|OBJECT|CONTRACT|COMMIT|DELIVERED|ESCALATE|HUMAN_REQUIRED|NOTE|CLOSE)\s*[:—-]\s*/, "")
+        .replace(/^(?:human (?:action|input) required)\s*[—:-]?\s*/i, "")
+        .replace(/^[a-z0-9._-]+\s+(?:asked|asks)\s*:\s*/i, "");
+}
+const agentLabel = (agent) => {
+    if (!agent)
+        return null;
+    const a = agent.toLowerCase();
+    if (a.includes("claude"))
+        return "Claude Code";
+    if (a.includes("codex"))
+        return "Codex";
+    if (a.includes("cursor"))
+        return "Cursor";
+    return null;
+};
+function whoLine(from, agent, ts, now) {
+    const parts = [from];
+    const a = agentLabel(agent);
+    if (a)
+        parts.push(a);
+    if (ts)
+        parts.push(relTime(ts, now));
+    return fit(parts.join(" · "), BUDGET.who);
+}
+function primaryFor(tools, preferred, prompt) {
+    if (!tools.length)
+        return undefined;
+    const def = tools.find((t) => t.id === preferred) ?? tools[0];
+    return { label: `Open in ${def.label}`, default: def.id, tools, prompt };
+}
+export function composeDecision(o, act, goal, peer, ctx) {
+    const now = ctx.now ?? Date.now();
+    const from = act?.from ?? peer?.member ?? o.body.match(/^([a-z0-9._-]+)\s+(?:needs a decision|escalated)/i)?.[1] ?? "a teammate";
+    const body = act
+        ? enrich(act.summary ?? "", act.body, BUDGET.body) || decisionTitle(plain(o.body), BUDGET.body)
+        : decisionTitle(plain(o.body), BUDGET.body);
+    return {
+        kind: "decision",
+        who: whoLine(from, peer?.agent ?? act?.role === "worker" ? peer?.agent : peer?.agent, act?.ts ?? o.created_at, now),
+        heading: "Needs your decision",
+        context: fit(goal?.title ?? "", BUDGET.context),
+        body: fit(body, BUDGET.body),
+        ttl: 0,
+        sound: true,
+        primary: primaryFor(ctx.tools, ctx.preferred, decisionPrompt(o.id)),
+        details: { decision: o.id, ...(act ? { act: act.id } : {}) },
+    };
+}
+export function composeDelivery(act, goal, peer, ctx) {
+    const now = ctx.now ?? Date.now();
+    const m = (act.meta ?? {});
+    const where = m.branch ? `${m.branch}${m.commit ? ` @ ${m.commit.slice(0, 7)}` : ""}` : "a branch";
+    const said = enrich(act.summary ?? "", act.body, BUDGET.body - where.length - 4);
+    const prompt = `A teammate delivered work in Pantheon: fetch ${m.branch ?? "their branch"}${m.commit ? ` at ${m.commit}` : ""} from ${act.from}, check it against the goal "${goal?.title ?? act.goal ?? ""}", then ACCEPT or OBJECT (act ${act.id}).`;
+    return {
+        kind: "delivery",
+        who: whoLine(act.from, peer?.agent, act.ts, now),
+        heading: "Delivered work to you",
+        context: fit(goal?.title ?? "", BUDGET.context),
+        body: fit(`${said ? `${said} ` : ""}(${where})`, BUDGET.body),
+        ttl: 15,
+        sound: false,
+        primary: primaryFor(ctx.tools, ctx.preferred, prompt),
+        details: { act: act.id },
+    };
+}
+const VERB = {
+    ANSWER: "Answered", ACCEPT: "Accepted", OBJECT: "Objected to", DELIVERED: "Delivered on", PROPOSE: "Proposed for", NOTE: "Noted on", ESCALATE: "Escalated", COMMIT: "Committed to",
+};
+const NOUN = { ANSWER: "question", ACCEPT: "delivery", OBJECT: "delivery", DELIVERED: "request", PROPOSE: "request", NOTE: "request", ESCALATE: "request to you", COMMIT: "request" };
+const ASKED = { ASK: "question", PROPOSE: "proposal", DELIVERED: "delivery", CONTRACT: "contract", COMMIT: "commitment", ESCALATE: "escalation", HUMAN_REQUIRED: "decision" };
+function nounFor(obligationBody, replyAct) {
+    const m = /^(ASK|PROPOSE|DELIVERED|CONTRACT|COMMIT|ESCALATE|HUMAN_REQUIRED)\s+from\s+/i.exec(obligationBody.trim());
+    if (m)
+        return ASKED[m[1].toUpperCase()] ?? "request";
+    if (/^[a-z0-9._-]+\s+asked\s*:/i.test(obligationBody))
+        return "question";
+    return (replyAct && NOUN[replyAct]) ?? "request";
+}
+export function composeWorker(run, ctx) {
+    const peer = run.triggeredBy && run.triggeredBy !== "unknown" ? run.triggeredBy : "a teammate";
+    const asked = plain(run.obligationBody);
+    let body;
+    if (!run.ok) {
+        body = `Could not finish ${peer}'s request: ${asked}. It needs a live session or your decision.`;
+    }
+    else if (run.reply) {
+        const verb = VERB[run.reply.act] ?? "Replied to";
+        const noun = nounFor(run.obligationBody, run.reply.act);
+        const lead = `${verb} ${peer}'s ${noun}: `;
+        const said = enrich(run.reply.summary ?? "", run.reply.body, BUDGET.body - lead.length);
+        body = said ? lead + said : lead.replace(/: $/, "");
+    }
+    else {
+        body = `Handled ${peer}'s request: ${asked}`;
+    }
+    const prompt = `A Pantheon run on this machine could not finish ${peer}'s request${run.goal ? ` in "${run.goal.title}"` : ""}${run.obligationRef ? ` (act ${run.obligationRef})` : ""}. Read the thread, then answer or deliver what is still owed.`;
+    return {
+        kind: run.ok ? "worker" : "worker_failed",
+        who: fit(`Your worker · for ${peer}`, BUDGET.who),
+        heading: run.ok ? "Your worker handled it" : "Your worker could not finish",
+        context: fit(run.goal?.title ?? "", BUDGET.context),
+        body: fit(body, BUDGET.body),
+        ttl: run.ok ? 15 : 0,
+        sound: !run.ok,
+        ...(run.ok ? {} : { primary: primaryFor(ctx.tools, ctx.preferred, prompt) }),
+        details: { ...(run.reply ? { act: run.reply.id } : run.obligationRef ? { act: run.obligationRef } : {}) },
+    };
+}
+//# sourceMappingURL=notice.js.map

package/dist/notifier.js

@@ -6,8 +6,9 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { PantheonClient } from "./client.js";
 import { CONFIG_DIR } from "./config.js";
-import { decisionPrompt, decisionTitle } from "./decision-ui.js";
-import { loadProfile, SURFACE_BUNDLE_IDS } from "./profile.js";
+import { loadProfile } from "./profile.js";
+import { composeDecision, composeDelivery, TOOL_LABELS } from "./notice.js";
+import { detectAvailable } from "./agents.js";
 export const DEFAULT_REMINDER_MS = 4 * 60 * 60 * 1_000;
 export function humanObligations(obligations, member) {
     return obligations.filter((o) => o.kind === "HUMAN" && o.owner === `human:${member}`);
@@ -69,19 +70,26 @@ export function requireDeveloperTools(what, service) {
         throw new Error(`building ${what} needs the Xcode Command Line Tools — run \`xcode-select --install\`, then \`pantheon service install ${service}\``);
     }
 }
-export function sendDesktopNotification(title, subtitle, body, profile, prompt = "", eyebrow = "Decision needed") {
+export function installedTools() {
+    const seen = new Set();
+    const out = [];
+    for (const { backend } of detectAvailable()) {
+        const id = backend.id;
+        if (!(id in TOOL_LABELS) || seen.has(id))
+            continue;
+        seen.add(id);
+        out.push({ id, label: TOOL_LABELS[id] });
+    }
+    return out;
+}
+export function sendDesktopNotification(notice, home = CONFIG_DIR) {
     if (platform() !== "darwin")
         return false;
-    const binary = hudBinaryPath();
+    const binary = hudBinaryPath(home);
     if (!existsSync(binary))
         return false;
     try {
-        const child = spawn(binary, [
-            "post", title, `${subtitle} — ${body}`, SURFACE_BUNDLE_IDS[profile.agent.primary_surface], prompt,
-        ], {
-            env: { ...process.env, PANTHEON_HUD_EYEBROW: eyebrow },
-            detached: true, stdio: "ignore",
-        });
+        const child = spawn(binary, ["post", "--json", JSON.stringify({ ...notice, bin_dir: join(home, "bin") })], { detached: true, stdio: "ignore" });
         child.unref();
         return true;
     }
@@ -119,9 +127,13 @@ export class HumanNotifier {
             const due = prefs.decisions
                 ? dueHumanObligations(client.obligations, this.cfg.member, state, now(), this.opts.reminderMs)
                 : [];
+            const tools = installedTools();
+            const peerOf = (from) => from ? { member: from, agent: client.roster.find((m) => m.id === from)?.agent } : undefined;
+            const withLabel = (n) => this.opts.label ? { ...n, context: n.context ? `${this.opts.label} · ${n.context}` : this.opts.label } : n;
             for (const obligation of due) {
-                const goal = obligation.goal ? client.goals.get(obligation.goal)?.title : undefined;
-                const ok = send("Your input is needed", oneLine(`${this.opts.label ? `${this.opts.label} · ` : ""}${goal ?? "Pantheon decision"}`, 80), decisionTitle(obligation.body, 180), profile, decisionPrompt(obligation.id));
+                const act = client.seenAct(obligation.ref);
+                const notice = withLabel(composeDecision(obligation, act, obligation.goal ? client.goals.get(obligation.goal) : undefined, peerOf(act?.from), { tools, preferred: profile.agent.primary_surface, now: now() }));
+                const ok = send(notice);
                 if (ok) {
                     state.notified_at[obligation.id] = now();
                     dirty = true;
@@ -142,8 +154,7 @@ export class HumanNotifier {
                     const forMe = (r.to?.includes(this.cfg.member) ?? false) || (goal?.members.includes(this.cfg.member) ?? false);
                     if (!forMe)
                         continue;
-                    const m = r.meta;
-                    const ok = send("Work delivered to you", oneLine(`${this.opts.label ? `${this.opts.label} · ` : ""}${goal?.title ?? "Pantheon delivery"}`, 80), oneLine(`${r.from} pushed ${m?.branch ?? "a branch"}${m?.commit ? ` @ ${m.commit.slice(0, 7)}` : ""} — ${r.body}`, 180), profile, `A teammate delivered work in pantheon: fetch ${m?.branch ?? "their branch"}${m?.commit ? ` at ${m.commit}` : ""} from ${r.from}, check it against the goal "${goal?.title ?? r.goal ?? ""}", then ACCEPT or OBJECT.`, "Delivered");
+                    const ok = send(withLabel(composeDelivery(r, goal, peerOf(r.from), { tools, preferred: profile.agent.primary_surface, now: now() })));
                     if (ok) {
                         state.notified_at[`act:${r.id}`] = now();
                         writeState(stateFile, state);

package/dist/quickstart.js

@@ -58,6 +58,7 @@ export function wireUp(opts, deps = {}) {
         try {
             ensureNotifier();
             installSvc("notifier", homedir(), []);
+            writeTrayCommands();
             tools.push({ tool: "notifications", status: "on — native alerts for decisions that require you" });
         }
         catch (e) {