@join-pantheon/cli 0.22.0 → 0.23.1

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/protocol.js

@@ -132,6 +132,15 @@ export const MakeInvite = z.object({
     may_wake: z.boolean().default(true),
     ttl_minutes: z.number().int().min(1).max(10080).default(60),
 });
+export const ListInvites = z.object({
+    t: z.literal("invites"),
+    cid: z.string().max(64).optional(),
+});
+export const RevokeInvite = z.object({
+    t: z.literal("revoke_invite"),
+    cid: z.string().max(64).optional(),
+    token: z.string().min(6).max(64),
+});
 export const Admit = z.object({
     t: z.literal("admit"),
     cid: z.string().max(64).optional(),
@@ -183,7 +192,7 @@ export const WorkerState = z.object({
     detail: z.string().max(200).optional(),
     until: z.number().int().positive().optional(),
 });
-export const Inbound = z.discriminatedUnion("t", [Hello, SendAct, OpenGoal, Claim, Admit, MakeInvite, PublishProfile, BindRepo, DeleteSpace, WorkerState, Ping]);
+export const Inbound = z.discriminatedUnion("t", [Hello, SendAct, OpenGoal, Claim, Admit, MakeInvite, ListInvites, RevokeInvite, PublishProfile, BindRepo, DeleteSpace, WorkerState, Ping]);
 export function shouldDeferToHuman(sessions, work, opts = {}) {
     const now = opts.now ?? Date.now();
     const idleMs = opts.idleMs ?? LIMITS.workerIdleMs;

package/dist/quickstart.js

@@ -12,6 +12,7 @@ import { detectAvailable, agentById } from "./agents.js";
 import { installService } from "./service.js";
 import { ensureNativeNotifier } from "./notifier.js";
 import { ensureTrayBinary, writeTrayCommands } from "./tray.js";
+import { desktopUnavailable, ephemeralWarning, hostEnv } from "./host-env.js";
 import { existsSync } from "node:fs";
 import { grant as grantCap, loadPolicy, policyPath, savePolicy } from "./worker-policy.js";
 import { Relay } from "./relay.js";
@@ -27,9 +28,12 @@ export function wireUp(opts, deps = {}) {
     const installSvc = deps.installService ?? installService;
     const ensureNotifier = deps.ensureNotifier ?? ensureNativeNotifier;
     const ensureTray = deps.ensureTray ?? ensureTrayBinary;
+    const host = deps.host ?? hostEnv();
     const tools = installForUser().map((t) => ({ tool: t.tool, status: t.status }));
     const granted = [];
     const warnings = [];
+    if (host.ephemeral)
+        warnings.push(ephemeralWarning(host));
     if (opts.hook) {
         try {
             const { agents } = installHooks("user");
@@ -47,10 +51,14 @@ export function wireUp(opts, deps = {}) {
     else {
         tools.push({ tool: "wake-up hook", status: "skipped (--no-hook) — a peer's message waits until you type" });
     }
-    if (opts.notifications) {
+    if (opts.notifications && !host.desktop) {
+        tools.push({ tool: "notifications", status: desktopUnavailable(host, "desktop alerts") });
+    }
+    else if (opts.notifications) {
         try {
             ensureNotifier();
             installSvc("notifier", homedir(), []);
+            writeTrayCommands();
             tools.push({ tool: "notifications", status: "on — native alerts for decisions that require you" });
         }
         catch (e) {
@@ -61,7 +69,10 @@ export function wireUp(opts, deps = {}) {
     else {
         tools.push({ tool: "notifications", status: "off (--no-notifications) — human escalations only appear in pantheon status" });
     }
-    if (opts.menubar) {
+    if (opts.menubar && !host.desktop) {
+        tools.push({ tool: "menu bar", status: desktopUnavailable(host, "the menu bar") });
+    }
+    else if (opts.menubar) {
         try {
             ensureTray();
             writeTrayCommands();
@@ -241,7 +252,7 @@ export async function start(opts) {
     const wired = wireUp({
         hook: opts.hook !== false,
         notifications: opts.notifications !== false,
-        menubar: opts.menubar !== false && process.platform === "darwin",
+        menubar: opts.menubar !== false,
         unattended: opts.unattended ?? null,
         ...(opts.workerHow ? { workerHow: opts.workerHow } : {}),
     });
@@ -290,7 +301,7 @@ export async function join(opts) {
     const wired = wireUp({
         hook: opts.hook !== false,
         notifications: opts.notifications !== false,
-        menubar: opts.menubar !== false && process.platform === "darwin",
+        menubar: opts.menubar !== false,
         unattended: opts.unattended ?? null,
         ...(opts.workerHow ? { workerHow: opts.workerHow } : {}),
     });