@join-pantheon/cli 0.21.1 → 0.21.2

package/README.md

@@ -70,7 +70,7 @@ default when run inside a git repo; `--no-worker` opts out — and a peer still
 ends with a "You're set" summary, then a short guided setup on a terminal: whether teammates may wake
 your machine while you are away, what a woken run may execute, who you are and which decisions are
 yours alone (so agents stop and ask you), and which alerts you want. Plain questions, mostly options;
-`pantheon setup` re-runs it any time. Restart your agent once and ask it *"check pantheon_status"*.
+`pantheon setup` re-runs it any time — and an agent setting you up can run `pantheon setup --questions`, ask you in chat, and pass your answers back as flags, so nobody has to open a terminal. Restart your agent once and ask it *"check pantheon_status"*.
 
 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).

package/dist/cli.js

@@ -19,7 +19,7 @@ import { runMcp } from "./mcp.js";
 import { Worker } from "./worker.js";
 import { DEFAULT_REMINDER_MS, ensureNativeNotifier, HumanNotifier, sendDesktopNotification } from "./notifier.js";
 import { AGENT_SURFACES, applyProfileInit, cleanList, isAgentSurface, loadProfile, organizationProfile, profileInitialized, saveProfile, wakeDefault } from "./profile.js";
-import { runGuide, terminalIO } from "./setup-guide.js";
+import { runGuide, terminalIO, parseSetupFlags, questionnaire } from "./setup-guide.js";
 import { doctor, render } from "./doctor.js";
 import { menubarProc, notifierProc, relayProc, workerProc, wiring, logFileFor, dataSummary, stopProc, statFile } from "./machine.js";
 import { assess } from "./untrusted.js";
@@ -272,12 +272,13 @@ function unattendedProject() {
 async function guidedSetup(cfg, project, opts = {}) {
     if (argv.includes("--no-guide"))
         return;
-    const interactive = !!process.stdin.isTTY && !argv.includes("--yes");
+    const preset = opts.preset ?? {};
+    const interactive = !!process.stdin.isTTY && !argv.includes("--yes") && !Object.keys(preset).length;
     if (!interactive && !opts.force)
         return;
     const rl = interactive ? createInterface({ input: process.stdin, output: process.stderr }) : null;
     const io = rl ? terminalIO(rl, (l) => console.error(l)) : null;
-    console.error(`\n${B("A few choices, then you're done.")}${io ? "" : D("  (no terminal — taking the defaults)")}`);
+    console.error(`\n${B("A few choices, then you're done.")}${io ? "" : Object.keys(preset).length ? D("  (applying the answers you passed)") : D("  (no terminal — taking the defaults)")}`);
     try {
         const r = await runGuide(io, { cfg, project }, {
             publish: async (p) => {
@@ -308,7 +309,7 @@ async function guidedSetup(cfg, project, opts = {}) {
                         bindRepo(info, cfg.spaceId);
                 },
             } : {}),
-        });
+        }, preset);
         console.error("");
         for (const l of r.applied)
             console.error(`  ${C("✓")} ${l}`);
@@ -417,6 +418,7 @@ ${B("control")}
   pantheon doctor             check this machine end to end
   pantheon setup              the guided choices: who may wake this machine, what a run may execute,
                               what you personally decide, which alerts you want — re-run any time
+                              (--questions prints them for an agent to ask you; answers go back as flags)
   pantheon upgrade            pull the latest pantheon, rebuild, and re-wire your agents
 
 ${D("more: pantheon help --all")}
@@ -489,6 +491,8 @@ async function main() {
                 console.error(`  ${C(`pantheon join ${r.invite}`)}\n`);
                 console.error(D(`  Tell them to run it from their project's git repo. Single use, expires in ${Math.round(Number(flag("ttl", "1440")) / 60)}h.`));
                 console.error(D(`  Redeeming it admits them — no separate approval step. Need another? \`pantheon invite\``));
+                console.error(D(`\n  Not technical? Forward them this instead, and their agent does the rest:`));
+                console.error(`  ${D("Tell your agent: run")} ${C("curl -fsSL https://www.joinpantheon.network/skills/join.md")} ${D("and follow it. Invite:")} ${C(`pantheon join ${r.invite}`)}`);
             }
             if (!r.reach.shareable && r.reach.hint) {
                 console.error(`\n\x1b[33m  That address only works on this machine.\x1b[0m`);
@@ -513,6 +517,8 @@ async function main() {
             const inv = await client.makeInvite(mayWake, ttl).catch((e) => die(e.message));
             console.log(`pantheon join ${toInvite({ ...cfg, token: inv.url })}`);
             console.error(D(`\nSingle use, expires ${new Date(inv.expires_at).toLocaleString()}.`));
+            console.error(D(`For a teammate who is not technical, forward this and their agent does the rest:`));
+            console.error(`  ${D("Tell your agent: run")} ${C("curl -fsSL https://www.joinpantheon.network/skills/join.md")} ${D("and follow it. Invite:")} ${C(`pantheon join ${toInvite({ ...cfg, token: inv.url })}`)}`);
             client.close();
             return;
         }
@@ -722,8 +728,15 @@ async function main() {
             return;
         }
         case "setup": {
+            if (argv.includes("--questions")) {
+                console.log(questionnaire());
+                return;
+            }
+            const { preset, errors } = parseSetupFlags(argv);
+            if (errors.length)
+                die(errors.join("\n") + "\n  pantheon setup --questions  lists every answer");
             const cfg = need();
-            await guidedSetup(cfg, repoInfo(process.cwd())?.root ?? null, { force: true });
+            await guidedSetup(cfg, repoInfo(process.cwd())?.root ?? null, { force: true, preset });
             return;
         }
         case "version": {

package/dist/relay.js

@@ -1774,7 +1774,7 @@ pantheon signup --email you@work.com --username you</code></pre>
                 message: `over ${LIMITS.rateActs} acts in ${LIMITS.rateWindowMs / 1000}s. This is a backstop against a stuck loop, not a hard stop — wait a few seconds and send again. If you are genuinely producing this much, you are probably doing work that belongs in a commit and a DELIVERED, not in acts.` };
         }
         for (const id of to ?? []) {
-            if (!sp.members.has(id)) {
+            if (!sp.members.has(id) && !sp.allow.get(id)?.admitted) {
                 return { code: "NO_SUCH_MEMBER", message: `nobody here is called "${id}" — members: ${[...sp.members.keys()].join(", ")}` };
             }
         }
@@ -2211,6 +2211,11 @@ pantheon signup --email you@work.com --username you</code></pre>
             lastTouch: Date.now(),
         };
         this.spaces.set(name, sp);
+        for (const e of allow.all()) {
+            if (e.admitted && !sp.members.has(e.member)) {
+                sp.members.set(e.member, { id: e.member, display: e.member, agent: "unknown", last_seen: e.first_seen, sessions: new Map(), activity: new Map(), delivered_seq: 0, stamps: [] });
+            }
+        }
         const open = [...sp.goals.values()].filter((g) => g.state !== "CLOSED").length;
         this.log(`[${name}] space ready (seq ${sp.ledger.head}, ${sp.goals.size} goals — ${open} still open, ${sp.obligations.size} obligations restored)`);
         this.compactSpace(sp);

package/dist/setup-guide.js

@@ -55,14 +55,95 @@ export function detectBaseBranch(project) {
     const cur = git("rev-parse", "--abbrev-ref", "HEAD");
     return cur && cur !== "HEAD" ? cur : null;
 }
-export async function runGuide(io, ctx, deps = {}) {
+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>",
+        "",
+        "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)",
+        ...WAKE_OPTIONS.map((o) => opt("wake", o.id, o.label)),
+        "2. When a teammate's request wakes this machine, what may the run do? (skip if --wake no)",
+        opt("commands", "no", "Edit files only — it can answer and draft, but cannot run tests, commit, or push."),
+        opt("commands", "yes", "Run commands too — needed to run tests and to commit and push work for review."),
+        "3. Their name, as teammates will see it.                       → --name \"…\"",
+        `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)",
+        "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)",
+        opt("playbook", "yes", "Yes — write a starter playbook now (recommended)"),
+        opt("playbook", "no", "Not now"),
+        "8. Which branch should workers start from, and deliveries be checked against? Usually the branch this",
+        "   project deploys or releases from (often the default branch).     → --base <branch>",
+        "",
+        "Example:  pantheon setup --yes --wake anyone --commands yes --name \"Praneet Sinha\" --title Founder \\",
+        "            --decides deployment --alerts decisions --playbook yes --base main",
+    ].join("\n");
+}
+export function parseSetupFlags(argv) {
+    const preset = {};
+    const errors = [];
+    const val = (name) => { const i = argv.indexOf(`--${name}`); return i >= 0 ? argv[i + 1] : undefined; };
+    const yn = (name) => { const v = val(name); if (v === undefined)
+        return undefined; if (/^(yes|true|on|1)$/i.test(v))
+        return true; if (/^(no|false|off|0)$/i.test(v))
+        return false; errors.push(`--${name} takes yes or no, not "${v}"`); return undefined; };
+    const wake = val("wake");
+    if (wake !== undefined) {
+        if (WAKE_OPTIONS.some((o) => o.id === wake))
+            preset.wake = wake;
+        else
+            errors.push(`--wake takes ${WAKE_OPTIONS.map((o) => o.id).join(", ")}, not "${wake}"`);
+    }
+    const commands = yn("commands");
+    if (commands !== undefined)
+        preset.commands = commands;
+    const name = val("name");
+    if (name !== undefined)
+        preset.name = name.trim();
+    const title = val("title");
+    if (title !== undefined)
+        preset.title = title.trim();
+    const decides = val("decides");
+    if (decides !== undefined) {
+        const ids = decides.split(",").map((x) => x.trim().toLowerCase()).filter((x) => x && x !== "none");
+        const bad = ids.filter((id) => !DECISION_AREAS.some((x) => x.id === id));
+        if (bad.length)
+            errors.push(`--decides: unknown area${bad.length === 1 ? "" : "s"} ${bad.join(", ")} — use ${DECISION_AREAS.map((x) => x.id).join(", ")} or none`);
+        else
+            preset.decides = [...new Set(ids)];
+    }
+    const alerts = val("alerts");
+    if (alerts !== undefined) {
+        if (ALERT_OPTIONS.some((o) => o.id === alerts))
+            preset.notifications = alerts;
+        else
+            errors.push(`--alerts takes ${ALERT_OPTIONS.map((o) => o.id).join(", ")}, not "${alerts}"`);
+    }
+    const playbook = yn("playbook");
+    if (playbook !== undefined)
+        preset.persona = playbook;
+    const base = val("base");
+    if (base !== undefined && base.trim())
+        preset.base = base.trim();
+    return { preset, errors };
+}
+export async function runGuide(io, ctx, deps = {}, preset = {}) {
     const install = deps.installService ?? realInstall;
     const uninstall = deps.uninstallService ?? realUninstall;
     const installed = deps.serviceInstalled ?? realInstalled;
     const file = deps.profileFile ?? profilePath();
     const profile = loadProfile(ctx.cfg, file);
-    const d = guideDefaults(profile, ctx.cfg);
+    const d = { ...guideDefaults(profile, ctx.cfg), ...preset };
     const a = { ...d };
+    if (a.wake === "no") {
+        a.commands = false;
+        a.persona = false;
+    }
     const applied = [], warnings = [];
     if (io) {
         io.say("A few choices only you can make. Pick a number; Enter keeps the suggested one.\n");
@@ -90,8 +171,9 @@ export async function runGuide(io, ctx, deps = {}) {
         }
         const detected = ctx.project && deps.setRepoBase ? detectBaseBranch(ctx.project) : null;
         if (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.", [`${detected} (what origin calls its default)`, "A different branch"], 0);
-            a.base = b === 0 ? detected : ((await io.ask("Branch name", detected)).trim() || 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);
         }
     }
     let next = a.title ? applyProfileInit(profile, { name: a.name, title: a.title }) : { ...profile, human: { ...profile.human, display_name: a.name } };

package/package.json

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