@join-pantheon/cli 0.25.0 → 0.25.1

package/README.md

@@ -96,6 +96,10 @@ any other server. The install output prints that exact line, the defaults screen
 your agent sends in your name, `pantheon setup --ask-before-sending` (or the same flag on start/join)
 makes reads silent and prompts for send, open goal and claim; `--approve-all` switches back.
 
+If all you were sent is the code — `pantheon join iIF-uHY8…` with no team or link — that works
+too: the relay names the team the code opens, and the join proceeds. A spent or expired code says
+so and asks for a fresh invite; a relay that cannot be reached asks you for the whole line instead.
+
 Already a member — new laptop, or just pulled a newer build? The same full setup is one command:
 `pantheon install --user` (from your project's repo if you have one).
 

package/dist/admin-stats.js

@@ -125,6 +125,15 @@ export function versionBehind(pkg, relay) {
     }
     return false;
 }
+export const SELF_UPGRADE_SINCE = "0.24.0";
+export function stuckBehind(pkg, relay) {
+    if (!versionBehind(pkg, relay))
+        return false;
+    if (versionBehind(pkg, SELF_UPGRADE_SINCE))
+        return true;
+    const [aMaj = 0, aMin = 0] = pkg.split(".").map(Number), [bMaj = 0, bMin = 0] = relay.split(".").map(Number);
+    return aMaj < bMaj || bMin - aMin >= 2;
+}
 const daysAgo = (ts, now) => Math.max(0, Math.floor((now - ts) / DAY));
 export function spaceHealth(input) {
     const now = input.now ?? Date.now();
@@ -153,10 +162,10 @@ export function spaceHealth(input) {
         if (!m.last_pkg)
             continue;
         versions[m.last_pkg] = (versions[m.last_pkg] ?? 0) + 1;
-        if (versionBehind(m.last_pkg, input.relayPkg))
+        if (stuckBehind(m.last_pkg, input.relayPkg))
             behind.push({ member: m.member, pkg: m.last_pkg, days: daysAgo(seenAt(m), now) });
     }
-    behind.sort((a, b) => a.days - b.days);
+    behind.sort((a, b) => (versionBehind(a.pkg, b.pkg) ? -1 : versionBehind(b.pkg, a.pkg) ? 1 : a.days - b.days));
     const newest = admitted.filter((m) => m.last_pkg).sort((a, b) => seenAt(b) - seenAt(a))[0];
     const seenSays = last_seen === null ? "" : `; last seen ${daysAgo(last_seen, now)}d ago${newest ? ` on ${newest.last_pkg}` : ""}`;
     let verdict, says;

package/dist/cli.js

@@ -10,10 +10,10 @@ import { randomBytes } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { PantheonClient } from "./client.js";
-import { fromInvite, load, save, toInvite, toJoinLink, resolveFor, loadAll, repoInfo, bindRepo, findMembership, setDefaultSpace, removeMembership, configFor, CONFIG_DIR, CONFIG_PATH, DEFAULT_RELAY, resolveForHook } from "./config.js";
+import { fromInvite, looksLikeInviteCode, resolveInviteCode, load, save, toInvite, toJoinLink, resolveFor, loadAll, repoInfo, bindRepo, findMembership, setDefaultSpace, removeMembership, configFor, CONFIG_DIR, CONFIG_PATH, DEFAULT_RELAY, resolveForHook } from "./config.js";
 import { fmtLimit } from "./plans.js";
 import { validEmail, validUsername } from "./accounts.js";
-import { install, launcher, removeCodexUserScope } from "./install.js";
+import { install, launcher, installForUser, removeCodexUserScope } from "./install.js";
 import { Relay } from "./relay.js";
 import { runMcp } from "./mcp.js";
 import { Worker } from "./worker.js";
@@ -728,7 +728,7 @@ async function main() {
             return;
         }
         case "join": {
-            const invite = argv[1] ?? die("usage: pantheon join <invite>   (pantheons://host/space#token, or https://www.joinpantheon.network/join/<team>#<token>)  [setup answers as flags — pantheon setup --questions]");
+            const invite = argv[1] ?? die("usage: pantheon join <invite>   (pantheons://host/space#token, https://www.joinpantheon.network/join/<team>#<token>, or just the code)  [setup answers as flags — pantheon setup --questions]");
             const setupFlags = parseSetupFlags(argv);
             if (setupFlags.errors.length)
                 die(setupFlags.errors.join("\n") + "\n  pantheon setup --questions  lists every answer");
@@ -737,7 +737,11 @@ async function main() {
                 parsed = fromInvite(invite);
             }
             catch (e) {
-                die(e.message);
+                if (!looksLikeInviteCode(invite))
+                    die(e.message);
+                const candidates = [flag("relay"), process.env.PANTHEON_RELAY, load()?.relay, DEFAULT_RELAY].filter((r) => !!r);
+                parsed = await resolveInviteCode(invite, candidates).catch((err) => die(err.message.replace(/^INVITE_CODE_[A-Z]+:\s*/, "")));
+                console.error(D(`That was just the code — it opens "${parsed.space}" on ${new URL(parsed.relay).host}. Joining that team.\n`));
             }
             if (!load()?.account && sameHost(parsed.relay, DEFAULT_RELAY)) {
                 die(`sign in first — this relay verifies email.\n  New here:        pantheon signup --email you@work.com --username you\n  Have an account: pantheon login  --email you@work.com\n  Then run this same \`pantheon join\` command again — the invite is still good.`);
@@ -811,6 +815,16 @@ async function main() {
             console.error(`\n${B("Restart your agent")}, then ask it: "check pantheon_status and introduce yourself to the team".`);
             return;
         }
+        case "rewire": {
+            const rows = installForUser().map((t) => ({ tool: t.tool, status: t.status }));
+            if (argv.includes("--json")) {
+                console.log(JSON.stringify(rows));
+                return;
+            }
+            for (const r of rows)
+                console.error(`  ${r.tool.padEnd(14)}${r.status}`);
+            return;
+        }
         case "upgrade": {
             const { upgrade } = await import("./upgrade.js");
             console.error(`${B("pantheon upgrade")}\n`);

package/dist/config.js

@@ -305,4 +305,32 @@ export function fromInvite(invite) {
         token,
     };
 }
+export const INVITE_CODE = /^[A-Za-z0-9_-]{16,64}$/;
+export const looksLikeInviteCode = (s) => INVITE_CODE.test(s.trim().replace(/^['"`]|['"`]$/g, ""));
+export async function resolveInviteCode(code, relays, fetchImpl = fetch) {
+    const token = code.trim().replace(/^['"`]|['"`]$/g, "");
+    const tried = [...new Set(relays.map((r) => r.replace(/\/+$/, "")).filter(Boolean))];
+    let answered = false;
+    for (const relay of tried) {
+        const http = relay.replace(/^ws/, "http");
+        try {
+            const res = await fetchImpl(`${http}/join?token=${encodeURIComponent(token)}`, { signal: AbortSignal.timeout(6_000) });
+            if (res.status === 404) {
+                answered = true;
+                continue;
+            }
+            if (!res.ok)
+                continue;
+            const body = (await res.json());
+            if (typeof body.team === "string" && body.team)
+                return { relay, space: body.team, token };
+        }
+        catch { }
+    }
+    const hosts = tried.map((r) => new URL(r).host).join(", ");
+    if (answered) {
+        throw new Error(`INVITE_CODE_UNKNOWN: that is an invite code, but no open invite on ${hosts} matches it — it may have been used already or expired (they last 24 hours).\n  Ask your teammate for a fresh one: pantheon invite`);
+    }
+    throw new Error(`INVITE_CODE_UNREACHABLE: that looks like an invite code, but ${hosts} could not be asked which team it opens.\n  Paste the whole invite line instead:  pantheon join https://www.joinpantheon.network/join/<team>#${token}`);
+}
 //# sourceMappingURL=config.js.map

package/dist/doctor.js

@@ -12,7 +12,7 @@ import { fingerprint, signChallenge, verifyChallenge } from "./identity.js";
 import { approvalSummary, chosenApproval, onPath } from "./install.js";
 import { hookState, readIntent, agentHookStates } from "./notify.js";
 import { loadPersonas } from "./persona.js";
-import { workerProc } from "./machine.js";
+import { workerProc, menubarProc, notifierProc } from "./machine.js";
 import { VERSION } from "./version.js";
 import { serviceInstalled } from "./service.js";
 import { hostEnv } from "./host-env.js";
@@ -213,9 +213,24 @@ export async function doctor(projectDir) {
         }
     }
     if (host.desktop) {
-        serviceInstalled("menubar")
-            ? add("pass", "menu bar", "installed — status, pause/resume, and a badge when a decision needs you", undefined, "installed")
-            : add("warn", "menu bar", "not installed on a Mac that can run it", "install it with: pantheon service install menubar (needs the Xcode Command Line Tools — xcode-select --install — and a setup that ran on this computer, not in a cloud agent). --no-menubar at setup also leaves it off; that is fine if it was your choice", "not installed");
+        if (!serviceInstalled("menubar")) {
+            add("warn", "menu bar", "not installed on a Mac that can run it", "install it with: pantheon service install menubar (needs the Xcode Command Line Tools — xcode-select --install — and a setup that ran on this computer, not in a cloud agent). --no-menubar at setup also leaves it off; that is fine if it was your choice", "not installed");
+        }
+        else if (!menubarProc().running) {
+            add("warn", "menu bar", "installed, but not running — launchd is not holding it, so there is no icon right now", "pantheon service restart menubar   (loads it back; something unloaded it — a stop, a crash loop, or a test run on this machine)", "installed, not running");
+        }
+        else {
+            add("pass", "menu bar", "installed and running — status, pause/resume, and a badge when a decision needs you", undefined, "installed and running");
+        }
+        if (!serviceInstalled("notifier")) {
+            add("warn", "alerts", "not installed — no desktop notification when a teammate needs you", "pantheon service install notifier   (--no-notifications at setup also leaves it off; that is fine if it was your choice)", "not installed");
+        }
+        else if (!notifierProc().running) {
+            add("warn", "alerts", "installed, but not running — nothing on this Mac will show you a teammate's message", "pantheon service restart notifier   (loads it back; something unloaded it — a stop, a crash loop, or a test run on this machine)", "installed, not running");
+        }
+        else {
+            add("pass", "alerts", "installed and running — a desktop notification when a teammate needs you", undefined, "installed and running");
+        }
     }
     if (!hookStates.length && !hook.installed) {
         add("warn", "wake-up hook", "not installed — your agent will not notice a peer's message until you ask it to", "pantheon hook install --user (auto-detects claude / codex / cursor on PATH)", "not installed");

package/dist/machine.js

@@ -134,22 +134,29 @@ export function dataSummary(dir) {
     const spaces = files.split("\n").length;
     return `${acts} acts across ${spaces} space${spaces > 1 ? "s" : ""}`;
 }
-export function stopProc(kind) {
-    const p = kind === "relay" ? relayProc(8787) : kind === "worker" ? workerProc() : kind === "menubar" ? menubarProc() : notifierProc();
+const defaultStopIo = () => ({
+    proc: (kind) => kind === "relay" ? relayProc(8787) : kind === "worker" ? workerProc() : kind === "menubar" ? menubarProc() : notifierProc(),
+    installed: (kind) => existsSync(plistPath(kind)),
+    sh,
+});
+export function stopProc(kind, io = defaultStopIo()) {
+    const p = io.proc(kind);
     if (!p.running)
         return [`${kind}: already stopped`];
     if (p.managedBy === "launchd") {
+        if (!io.installed(kind))
+            return [`${kind}: running under launchd, but not installed from this home — left alone`];
         const plist = plistPath(kind);
         const uid = process.getuid?.() ?? 0;
-        if (sh(`launchctl bootout gui/${uid}/dev.pantheon.${kind} 2>&1`) !== null ||
-            sh(`launchctl unload -w "${plist}" 2>&1`) !== null) {
+        if (io.sh(`launchctl bootout gui/${uid}/dev.pantheon.${kind} 2>&1`) !== null ||
+            io.sh(`launchctl unload -w "${plist}" 2>&1`) !== null) {
             return [`${kind}: stopped, and will not restart at login`,
                 `        start it again with: pantheon service install ${kind}`];
         }
         return [`${kind}: could not stop the service — try: launchctl bootout gui/${uid}/dev.pantheon.${kind}`];
     }
     if (p.pid) {
-        sh(`kill ${p.pid}`);
+        io.sh(`kill ${p.pid}`);
         return [`${kind}: stopped pid ${p.pid} (it was started by hand, not as a service)`];
     }
     return [`${kind}: running but no pid found — nothing stopped`];

package/dist/relay.js

@@ -263,6 +263,15 @@ export class Relay {
                         : {}),
             });
         }
+        if (url.pathname === "/join") {
+            const token = (url.searchParams.get("token") ?? "").trim();
+            if (!/^[A-Za-z0-9_-]{16,64}$/.test(token))
+                return this.json(res, 400, { error: "an invite code is required: /join?token=<code>" });
+            const team = this.teamOfInvite(token);
+            return team
+                ? this.json(res, 200, { team })
+                : this.json(res, 404, { error: "no open invite matches that code — it may have been used already or expired" });
+        }
         if (url.pathname === "/act") {
             const space = this.spaces.get(url.searchParams.get("space") ?? "");
             const token = url.searchParams.get("token") ?? "";
@@ -713,6 +722,40 @@ button:hover{background:#1d4ed8}.err{color:var(--bad);margin-top:12px}
     adminCsrf() {
         return createHash("sha256").update("pantheon-admin-csrf " + (this.adminToken ?? "")).digest("hex").slice(0, 32);
     }
+    teamOfInvite(token) {
+        const exact = (al) => { const inv = al.findInvite(token); return !!inv && inv.token === token; };
+        for (const sp of this.spaces.values())
+            if (exact(sp.allow))
+                return sp.name;
+        const safeOf = (name) => name.replace(/[^a-z0-9._-]/gi, "_");
+        const live = new Set([...this.spaces.keys()].map(safeOf));
+        let files = [];
+        try {
+            files = readdirSync(this.dataDir);
+        }
+        catch {
+            return null;
+        }
+        for (const f of files) {
+            if (!f.endsWith(".members.json"))
+                continue;
+            const safe = f.slice(0, -".members.json".length);
+            if (live.has(safe))
+                continue;
+            try {
+                if (!exact(new Allowlist(this.dataDir, safe)))
+                    continue;
+                const named = this.sleepingRecords(safe).find((r) => r.space)?.space;
+                if (named)
+                    return named;
+                if (safeOf(safe) === safe && !/_/.test(safe))
+                    return safe;
+                return null;
+            }
+            catch { }
+        }
+        return null;
+    }
     fleetHealth(now = Date.now()) {
         const out = [];
         const seen = new Set();

package/dist/service.js

@@ -164,14 +164,22 @@ export function uninstallService(kind) {
 export function restartService(kind, exec = (c, a) => execFileSync(c, a, { stdio: "ignore" })) {
     if (!serviceInstalled(kind))
         return [`  ${kind}: not installed here`];
+    const uid = process.getuid?.() ?? 501;
     try {
         if (platform() === "darwin")
-            exec("launchctl", ["kickstart", "-k", `gui/${process.getuid?.() ?? 501}/${LABEL(kind)}`]);
+            exec("launchctl", ["kickstart", "-k", `gui/${uid}/${LABEL(kind)}`]);
         else
             exec("systemctl", ["--user", "restart", `pantheon-${kind}`]);
         return [`  ${kind}: restarted on the new code`];
     }
     catch (e) {
+        if (platform() === "darwin") {
+            try {
+                exec("launchctl", ["bootstrap", `gui/${uid}`, plistPath(kind)]);
+                return [`  ${kind}: was not loaded in launchd — loaded and started on the new code`];
+            }
+            catch { }
+        }
         return [`  ${kind}: could not restart (${e.message.split("\n")[0]}) — pantheon service restart ${kind}`];
     }
 }

package/dist/upgrade.js

@@ -16,6 +16,16 @@ function pkgVersion(root) {
     }
 }
 export const PKG_NAME = "@join-pantheon/cli";
+export function rewireVia(root, fallback, run = (file, args) => execFileSync(process.execPath, [file, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 120_000 })) {
+    try {
+        const out = JSON.parse(run(join(root, "dist", "cli.js"), ["rewire", "--json"]));
+        if (Array.isArray(out) && out.every((o) => o && typeof o.tool === "string" && typeof o.status === "string")) {
+            return out.map((o) => ({ tool: o.tool, status: o.status }));
+        }
+    }
+    catch { }
+    return fallback();
+}
 export function defaultDeps() {
     const git = (root, ...args) => execFileSync("git", ["-C", root, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
     return {
@@ -29,7 +39,7 @@ export function defaultDeps() {
         pull: (root) => git(root, "pull", "--ff-only"),
         build: (root) => execFileSync("npm", ["install", "--no-audit", "--no-fund"], { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }),
         version: pkgVersion,
-        rewire: () => installForUser().map((t) => ({ tool: t.tool, status: t.status })),
+        rewire: () => rewireVia(repoRoot(), () => installForUser().map((t) => ({ tool: t.tool, status: t.status }))),
         running: () => {
             const up = [];
             try {

package/helper/macos/menubar.swift

@@ -182,12 +182,18 @@ final class RowView: NSView {
   private var copied = false
 
   private let titleLines: Int
+  /// The menu is the board people read every day; 430 wrapped a plain sentence
+  /// onto two lines and truncated a decision. 520 carries ~40% more per line.
+  static let rowWidth: CGFloat = 520
   private static let titleFont = NSFont.systemFont(ofSize: 13, weight: .medium)
   private static let lineHeight: CGFloat = 17
 
-  /// How many lines this title needs, at most two. A one-line row truncated
+  /// How many lines this title needs, at most three. A one-line row truncated
   /// mid-word ("Sid asked: Sid is asking: is this work in producti…") hid the
-  /// only part worth reading; two lines carry almost every real title whole.
+  /// only part worth reading; two lines carried most titles, and a decision
+  /// ("Praneet wants the unattended worker able to do everything overlapping
+  /// Pantheo…") still lost its point at the end of the second. Three lines,
+  /// taken only when needed, carry every real title whole.
   static func lines(for text: String, width: CGFloat) -> Int {
     let para = NSMutableParagraphStyle()
     para.lineBreakMode = .byWordWrapping
@@ -195,14 +201,14 @@ final class RowView: NSView {
       with: NSSize(width: width, height: .greatestFiniteMagnitude),
       options: [.usesLineFragmentOrigin, .usesFontLeading],
       attributes: [.font: titleFont, .paragraphStyle: para]).height
-    return max(1, min(2, Int(ceil(h / lineHeight))))
+    return max(1, min(3, Int(ceil(h / lineHeight))))
   }
 
   init(item: Item, width: CGFloat, onOpen: @escaping (Item) -> Void, onCopy: @escaping (Item) -> Void) {
     self.item = item
     self.onOpen = onOpen
     self.onCopy = onCopy
-    self.titleLines = RowView.lines(for: item.title, width: width - 14 - 48)
+    self.titleLines = RowView.lines(for: item.title, width: width - RowView.textInsets)
     let textHeight = CGFloat(titleLines) * RowView.lineHeight
     super.init(frame: NSRect(x: 0, y: 0, width: width, height: textHeight + (item.subtitle.isEmpty ? 13 : 29)))
     setAccessibilityRole(.button)
@@ -210,7 +216,9 @@ final class RowView: NSView {
   }
   required init?(coder: NSCoder) { return nil }
 
-  private var copyRect: NSRect { NSRect(x: bounds.maxX - 42, y: bounds.midY - 12, width: 28, height: 24) }
+  /// Left inset plus what the copy control needs on the right: 28 for the control, 8 clear of the text, 8 to the edge.
+  static let textInsets: CGFloat = 12 + 44
+  private var copyRect: NSRect { NSRect(x: bounds.maxX - 36, y: bounds.midY - 12, width: 28, height: 24) }
 
 
   override func updateTrackingAreas() {
@@ -253,7 +261,7 @@ final class RowView: NSView {
     para.lineSpacing = 0
     let flat = NSMutableParagraphStyle()
     flat.lineBreakMode = .byTruncatingTail
-    let textWidth = bounds.width - 14 - 48
+    let textWidth = bounds.width - RowView.textInsets
     let hasSub = !item.subtitle.isEmpty
     let titleHeight = CGFloat(titleLines) * RowView.lineHeight
     let titleY = bounds.maxY - 7 - titleHeight
@@ -856,7 +864,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
     for item in items.prefix(6) {
       let mi = NSMenuItem(title: item.title, action: nil, keyEquivalent: "")
       mi.toolTip = item.detail
-      mi.view = RowView(item: item, width: 430,
+      mi.view = RowView(item: item, width: RowView.rowWidth,
                         onOpen: { [weak self] it in self?.showDetail(it) },
                         onCopy: { [weak self] it in self?.copyPrompt(it) })
       menu.addItem(mi)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@join-pantheon/cli",
-  "version": "0.25.0",
+  "version": "0.25.1",
   "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": {