@join-pantheon/cli 0.19.1 → 0.21.0

package/dist/notifier.js

@@ -17,10 +17,10 @@ export function dueHumanObligations(obligations, member, state, now, reminderMs)
         return last === undefined || now - last >= reminderMs;
     });
 }
-export function pruneNotificationState(state, obligations, member) {
+export function pruneNotificationState(state, obligations, member, now = Date.now()) {
     const active = new Set(humanObligations(obligations, member).map((o) => o.id));
     return {
-        notified_at: Object.fromEntries(Object.entries(state.notified_at).filter(([id]) => active.has(id))),
+        notified_at: Object.fromEntries(Object.entries(state.notified_at).filter(([id, at]) => active.has(id) || (id.startsWith("act:") && now - at < 7 * 86_400_000))),
     };
 }
 function readState(file) {
@@ -108,14 +108,17 @@ export class HumanNotifier {
         this.opts.log(`notifier online as ${this.cfg.member}`);
         this.opts.log(`  reminders every ${Math.round(this.opts.reminderMs / 60_000)} minutes while unresolved`);
         while (!this.stopped) {
-            const pruned = pruneNotificationState(state, client.obligations, this.cfg.member);
+            const pruned = pruneNotificationState(state, client.obligations, this.cfg.member, now());
             let dirty = JSON.stringify(pruned) !== JSON.stringify(state);
             state = pruned;
-            const due = dueHumanObligations(client.obligations, this.cfg.member, state, now(), this.opts.reminderMs);
+            const profile = loadProfile(this.cfg);
+            const prefs = profile.notifications ?? { decisions: true, deliveries: false, worker_done: false };
+            const due = prefs.decisions
+                ? dueHumanObligations(client.obligations, this.cfg.member, state, now(), this.opts.reminderMs)
+                : [];
             for (const obligation of due) {
-                const profile = loadProfile(this.cfg);
                 const goal = obligation.goal ? client.goals.get(obligation.goal)?.title : undefined;
-                const ok = send("Your input is needed", oneLine(goal ?? "Pantheon decision", 80), decisionTitle(obligation.body, 180), profile, decisionPrompt(obligation.id));
+                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));
                 if (ok) {
                     state.notified_at[obligation.id] = now();
                     dirty = true;
@@ -127,7 +130,24 @@ export class HumanNotifier {
             }
             if (dirty || !existsSync(stateFile))
                 writeState(stateFile, state);
-            await client.next(pollMs);
+            const arrived = await client.next(pollMs);
+            if (prefs.deliveries) {
+                for (const r of arrived) {
+                    if (r.act !== "DELIVERED" || r.from === this.cfg.member || state.notified_at[`act:${r.id}`])
+                        continue;
+                    const goal = r.goal ? client.goals.get(r.goal) : undefined;
+                    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");
+                    if (ok) {
+                        state.notified_at[`act:${r.id}`] = now();
+                        writeState(stateFile, state);
+                        this.opts.log(`> delivery alert for ${r.id} from ${r.from}`);
+                    }
+                }
+            }
         }
         client.close();
     }

package/dist/notify.js

@@ -290,7 +290,7 @@ export async function decideStop(raw, deps) {
     const acts = report.acts ?? [];
     const owed = report.obligations ?? [];
     const closed = new Set(report.closed_goals ?? []);
-    const DEMANDS_RESPONSE = new Set(["ASK", "PROPOSE", "OBJECT", "DELIVERED", "CONTRACT", "ESCALATE"]);
+    const DEMANDS_RESPONSE = new Set(["ASK", "PROPOSE", "OBJECT", "DELIVERED", "CONTRACT"]);
     const work = acts.filter((a) => {
         if (a.goal && closed.has(a.goal))
             return false;

package/dist/pending.js

@@ -102,10 +102,12 @@ export async function pending(opts) {
     const obligations = surfaced.filter((o) => !alreadySeen.has(o.id));
     const head = obligationsBody?.seq;
     const all = (historyBody?.acts ?? []);
+    const mine = all.filter((r) => r.from === cfg.member);
     const acts = all
         .filter((r) => r.from !== cfg.member)
         .filter((r) => r.act !== "JOIN" && r.act !== "LEAVE")
-        .filter((r) => !r.to || r.to.length === 0 || r.to.includes(cfg.member));
+        .filter((r) => !r.to || r.to.length === 0 || r.to.includes(cfg.member))
+        .filter((r) => !mine.some((m) => m.seq > r.seq && (m.ref === r.id || (!!r.goal && m.goal === r.goal))));
     const seq = first
         ? head
         : historyBody === null

package/dist/persona.js

@@ -5,7 +5,7 @@ import { CONFIG_DIR } from "./config.js";
 export const PERSONA_INSTRUCTIONS_MAX = 8_000;
 const KNOWN_KEYS = new Set([
     "allow_bash", "max_runs_per_hour", "max_runs_per_day",
-    "wake_by", "kinds", "goals", "agent", "name",
+    "wake_by", "kinds", "goals", "agent", "name", "spaces",
 ]);
 const list = (v) => v.split(",").map((s) => s.trim()).filter(Boolean);
 export function parsePersona(name, scope, file, raw) {
@@ -63,6 +63,9 @@ export function parsePersona(name, scope, file, raw) {
                 case "goals":
                     p.goals = list(value);
                     break;
+                case "spaces":
+                    p.spaces = list(value);
+                    break;
                 case "agent":
                     p.agent = value.trim();
                     break;

package/dist/plans.js

@@ -0,0 +1,46 @@
+export const UNLIMITED = 1_000_000;
+export const DEFAULT_PLANS = {
+    free: { spaces: 1, members: 2, wake: true },
+    pro: { spaces: 10, members: 25, wake: true },
+};
+export const PLAN_NAME = /^[a-z][a-z0-9_-]{0,23}$/;
+const int = (v, min, max) => typeof v === "number" && Number.isInteger(v) && v >= min && v <= max ? v : null;
+export function parseLimits(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const o = raw;
+    const num = (v) => typeof v === "string" && v.trim() !== "" ? Number(v) : v;
+    const spaces = int(num(o["spaces"]), 0, UNLIMITED);
+    const members = int(num(o["members"]), 1, UNLIMITED);
+    const wake = typeof o["wake"] === "boolean" ? o["wake"] : o["wake"] === "true" || o["wake"] === "on" || o["wake"] === "1" ? true : o["wake"] === "false" || o["wake"] === "off" || o["wake"] === "0" || o["wake"] === undefined ? false : null;
+    if (spaces === null || members === null || wake === null)
+        return null;
+    return { spaces, members, wake };
+}
+export function parsePlans(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const out = {};
+    for (const [name, lim] of Object.entries(raw)) {
+        if (!PLAN_NAME.test(name))
+            return null;
+        const l = parseLimits(lim);
+        if (!l)
+            return null;
+        out[name] = l;
+    }
+    return out["free"] ? out : null;
+}
+export function planLimits(plans, plan, override) {
+    if (override) {
+        try {
+            const l = parseLimits(JSON.parse(override));
+            if (l)
+                return l;
+        }
+        catch { }
+    }
+    return plans[plan] ?? plans["free"] ?? DEFAULT_PLANS["free"];
+}
+export const fmtLimit = (n) => n >= UNLIMITED ? "unlimited" : String(n);
+//# sourceMappingURL=plans.js.map

package/dist/profile.js

@@ -25,6 +25,7 @@ export function defaultProfile(cfg) {
         human: { display_name: cfg.display ?? cfg.member, title: "", responsibilities: [] },
         agent: { primary_surface: surfaceFromAgent(cfg.agent), wake_enabled: false },
         attention: { urgent: "primary_surface", decision: "primary_surface", fyi: "inbox" },
+        notifications: { decisions: true, deliveries: false, worker_done: false },
         authority: {},
         decision_keywords: {},
         capabilities: [],
@@ -32,6 +33,9 @@ export function defaultProfile(cfg) {
         updated_at: 0,
     };
 }
+export function wakeDefault(profile) {
+    return (profile.agent.wake_default ?? "anyone") === "anyone";
+}
 export function loadProfile(cfg, file = profilePath()) {
     if (!existsSync(file))
         return defaultProfile(cfg);
@@ -53,11 +57,13 @@ export function loadProfile(cfg, file = profilePath()) {
             },
             agent: { ...defaultProfile(cfg).agent, ...raw.agent, primary_surface: surface },
             attention: { ...defaultProfile(cfg).attention, ...raw.attention },
+            notifications: { ...defaultProfile(cfg).notifications, ...(raw.notifications ?? {}) },
             authority: raw.authority ?? {},
             decision_keywords: cleanKeywords(legacy.decision_keywords),
             capabilities: Array.isArray(raw.capabilities) ? raw.capabilities.filter((x) => typeof x === "string") : [],
             delegations: cleanDelegations(legacy.delegations),
             updated_at: Number.isFinite(legacy.updated_at) ? legacy.updated_at : 0,
+            ...(Object.keys(sanitizeSpaces(raw.spaces)).length ? { spaces: sanitizeSpaces(raw.spaces) } : {}),
         };
     }
     catch {
@@ -95,16 +101,39 @@ function cleanDelegations(value) {
         return [{ to: normalize(d.to), domains, starts_at: d.starts_at, expires_at: d.expires_at }];
     });
 }
-export function organizationProfile(profile) {
+function sanitizeSpaces(raw) {
+    const out = {};
+    if (!raw || typeof raw !== "object")
+        return out;
+    for (const [k, v] of Object.entries(raw)) {
+        if (!v || typeof v !== "object")
+            continue;
+        const o = v;
+        out[k] = {
+            ...(o.responsibilities ? { responsibilities: cleanList(o.responsibilities) } : {}),
+            ...(o.authority && typeof o.authority === "object" ? { authority: Object.fromEntries(Object.entries(o.authority).filter(([, m]) => m === "human_required" || m === "agent_can_decide")) } : {}),
+            ...(o.decision_keywords ? { decision_keywords: cleanKeywords(o.decision_keywords) } : {}),
+        };
+    }
+    return out;
+}
+export function spaceOverride(profile, ...keys) {
+    for (const k of keys)
+        if (k && profile.spaces?.[k])
+            return profile.spaces[k];
+    return undefined;
+}
+export function organizationProfile(profile, ...forSpace) {
+    const ov = spaceOverride(profile, ...forSpace);
     return {
         version: 1,
         member: profile.member,
         display_name: profile.human.display_name || profile.member,
         title: profile.human.title,
-        responsibilities: cleanList(profile.human.responsibilities),
-        authority: Object.fromEntries(Object.entries(profile.authority)
+        responsibilities: cleanList(ov?.responsibilities ?? profile.human.responsibilities),
+        authority: Object.fromEntries(Object.entries(ov?.authority ?? profile.authority)
             .map(([domain, mode]) => [normalize(domain), mode]).filter(([domain]) => !!domain)),
-        decision_keywords: cleanKeywords(profile.decision_keywords),
+        decision_keywords: cleanKeywords(ov?.decision_keywords ?? profile.decision_keywords),
         capabilities: cleanList(profile.capabilities),
         delegations: cleanDelegations(profile.delegations),
         updated_at: profile.updated_at,

package/dist/protocol.js

@@ -96,6 +96,8 @@ export const Hello = z.object({
     agent: z.string().max(80).optional(),
     pkg: z.string().max(32).optional(),
     from_seq: z.number().int().nonnegative().optional(),
+    repo: z.string().regex(/^[rl]_[0-9a-f]{16}$/).optional(),
+    repo_origin: z.string().max(200).optional(),
 });
 export const OrganizationProfileSchema = z.object({
     version: z.literal(1),
@@ -151,6 +153,14 @@ export const SendAct = z.object({
     defers_to: z.string().max(64).optional(),
     affects: z.array(z.string().min(1).max(48)).max(16).optional(),
     meta: z.record(z.unknown()).optional(),
+    repo: z.string().regex(/^[rl]_[0-9a-f]{16}$/).optional(),
+});
+export const BindRepo = z.object({
+    t: z.literal("bind_repo"),
+    cid: z.string().max(64).optional(),
+    repo: z.string().regex(/^[rl]_[0-9a-f]{16}$/),
+    origin: z.string().max(200).nullable().optional(),
+    base: z.string().min(1).max(100).optional(),
 });
 export const OpenGoal = z.object({
     t: z.literal("open_goal"),
@@ -162,7 +172,18 @@ export const OpenGoal = z.object({
     deadline: z.number().int().positive().optional(),
 });
 export const Ping = z.object({ t: z.literal("ping") });
-export const Inbound = z.discriminatedUnion("t", [Hello, SendAct, OpenGoal, Claim, Admit, MakeInvite, PublishProfile, Ping]);
+export const DeleteSpace = z.object({
+    t: z.literal("delete_space"),
+    cid: z.string().max(64).optional(),
+    confirm: z.string().min(1).max(64),
+});
+export const WorkerState = z.object({
+    t: z.literal("worker_state"),
+    state: z.enum(["idle", "holding", "running"]),
+    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 function shouldDeferToHuman(sessions, work, opts = {}) {
     const now = opts.now ?? Date.now();
     const idleMs = opts.idleMs ?? LIMITS.workerIdleMs;

package/dist/quickstart.js

@@ -3,7 +3,8 @@ import { randomBytes } from "node:crypto";
 import { basename } from "node:path";
 import { homedir } from "node:os";
 import { PantheonClient } from "./client.js";
-import { load, save, toInvite, DEFAULT_RELAY } from "./config.js";
+import { load, save, toInvite, resolveFor, repoInfo, bindRepo, DEFAULT_RELAY } from "./config.js";
+import { loadProfile, wakeDefault } from "./profile.js";
 import { newKeypair } from "./identity.js";
 import { installForUser } from "./install.js";
 import { writeIntent, installHooks } from "./notify.js";
@@ -91,7 +92,7 @@ export function wireUp(opts, deps = {}) {
         }
         else {
             try {
-                installSvc("worker", project, ["--project", project]);
+                installSvc("worker", project, []);
                 tools.push({ tool: "worker", status: `on — answers peers while you are away (${project})` });
                 granted.push(`A peer you have granted may_wake can start an agent run on this machine, in an isolated worktree under ${project}.`);
                 if (!existsSync(policyPath())) {
@@ -131,7 +132,9 @@ export function findReach(port) {
 }
 export async function start(opts) {
     const warnings = [];
-    const priorCfg = load();
+    const here = resolveFor(process.cwd());
+    const priorCfg = here.cfg;
+    const repo = repoInfo(process.cwd());
     const signedInRelay = priorCfg?.account ? (priorCfg.relay ?? DEFAULT_RELAY) : undefined;
     const chosen = opts.relay ?? signedInRelay;
     const reach = chosen
@@ -154,7 +157,8 @@ export async function start(opts) {
     }
     const existing = priorCfg;
     const hasOwnSpace = !!existing?.space && !!existing?.token;
-    const reuse = !!existing && !opts.reset && hasOwnSpace && (!opts.space || opts.space === existing.space);
+    const reuse = !!existing && !opts.reset && hasOwnSpace && (here.reason === "binding" || here.reason === "single" || here.reason === "env")
+        && (!opts.space || opts.space === existing.space);
     const keepIdentity = !!existing && !opts.reset && !!existing.publicKey && !!existing.privateKey;
     let cfg = reuse
         ? { ...existing, relay: reach.url, agent: detectAgent() }
@@ -166,7 +170,10 @@ export async function start(opts) {
             agent: detectAgent(),
             ...(keepIdentity ? { publicKey: existing.publicKey, privateKey: existing.privateKey } : newKeypair()),
             ...(keepIdentity && existing.account ? { account: existing.account } : {}),
+            ...(repo ? { repo: repo.fingerprint, ...(repo.origin ? { repoOrigin: repo.origin } : {}) } : {}),
         };
+    if (repo && !repo.shared)
+        warnings.push(`this repo has no origin remote, so nothing you deliver from it can be fetched by a teammate — add one (git remote add origin …) before delivering`);
     if (reuse) {
         opts.log(`  you        ${cfg.member}, same as before`);
         if (opts.me && opts.me !== cfg.member) {
@@ -185,9 +192,19 @@ export async function start(opts) {
         const client = new PantheonClient(c);
         try {
             await client.connect();
+            if (client.spaceId)
+                c.spaceId = client.spaceId;
             save(c);
-            opts.log(`  space      ${c.space} ${reuse ? "— reconnected" : "— created, you own it"}`);
-            const inv = await client.makeInvite(true, opts.ttlMinutes);
+            if (repo && !client.repos.some((r) => r.fingerprint === repo.fingerprint)) {
+                await client.bindRepo(repo.fingerprint, repo.origin).catch((e) => warnings.push(`could not register this repo with the team: ${e.message}`));
+            }
+            if (repo && c.spaceId) {
+                const { replaced } = bindRepo(repo, c.spaceId);
+                if (replaced)
+                    warnings.push(`this repo was bound to another team (${replaced.space}); it now belongs to "${c.space}"`);
+            }
+            opts.log(`  space      ${c.space} ${reuse ? "— reconnected" : "— created, you own it"}${repo ? `   ${repo.origin ?? "local repo"} → bound to it` : ""}`);
+            const inv = await client.makeInvite(wakeDefault(loadProfile(c)), opts.ttlMinutes);
             invite = toInvite({ ...c, token: inv.url });
             claimed = true;
         }
@@ -233,6 +250,7 @@ export async function start(opts) {
 }
 export async function join(opts) {
     const existing = opts.reset ? null : load();
+    const repo = repoInfo(process.cwd());
     const keys = existing?.publicKey && existing.privateKey
         ? { publicKey: existing.publicKey, privateKey: existing.privateKey }
         : newKeypair();
@@ -247,13 +265,25 @@ export async function join(opts) {
         agent: detectAgent(),
         ...keys,
         ...(existing?.account ? { account: existing.account } : {}),
+        ...(repo ? { repo: repo.fingerprint, ...(repo.origin ? { repoOrigin: repo.origin } : {}) } : {}),
     };
     const client = new PantheonClient(cfg, undefined, { enroll: opts.invite.token });
     await client.connect();
     if (!client.enrolledToken)
         throw new Error("the relay accepted us but sent no space token — version mismatch?");
     cfg.token = client.enrolledToken;
+    if (client.spaceId)
+        cfg.spaceId = client.spaceId;
     save(cfg);
+    const warnings = [];
+    if (repo && cfg.spaceId) {
+        const { replaced } = bindRepo(repo, cfg.spaceId);
+        if (replaced)
+            warnings.push(`this repo was bound to another team (${replaced.space}); it now belongs to "${cfg.space}"`);
+        opts.log(`  repo       ${repo.origin ?? "local repo"} → bound to "${cfg.space}"${client.repos.length > 1 ? `   (team repos: ${client.repos.map((r) => r.origin ?? r.fingerprint).join(", ")})` : ""}`);
+        if (!repo.shared)
+            warnings.push(`this repo has no origin remote, so nothing you deliver from it can be fetched by a teammate`);
+    }
     const peers = client.roster.filter((m) => m.id !== cfg.member).map((m) => m.id);
     opts.log(`  joined     "${cfg.space}" as ${cfg.member}${peers.length ? ` — with ${peers.join(", ")}` : ""}`);
     client.close();
@@ -264,7 +294,7 @@ export async function join(opts) {
         unattended: opts.unattended ?? null,
         ...(opts.workerHow ? { workerHow: opts.workerHow } : {}),
     });
-    return { cfg, tools: wired.tools, granted: wired.granted, warnings: wired.warnings };
+    return { cfg, tools: wired.tools, granted: wired.granted, warnings: [...warnings, ...wired.warnings] };
 }
 function detectAgent() {
     const found = detectAvailable();