run402 4.73.4 → 4.75.0

package/gitvault-surface.json

@@ -1,5 +1,5 @@
 {
-  "surface_version": "4.73.4",
+  "surface_version": "4.75.0",
   "verbs": [
     "repos create",
     "repos list",

package/lib/billing.mjs

@@ -12,6 +12,7 @@ Subcommands:
   create-email <email>                     Create an email organization
   link-wallet [<org_id>] <wallet_address>  Link a wallet to an email organization
   checkout <identifier> --product <p>      Create an org checkout
+  topup <identifier> --sats <n> [--wait]   Top up the cash balance over Lightning (a bolt11 invoice; no node, no Stripe)
   auto-recharge [<org_id>] <on|off> [--threshold <n>]
   balance <identifier>                     Balance by organization id (UUID), wallet (0x...), or email
   history <identifier> [--limit <n>]       Ledger history by organization id (UUID), wallet, or email
@@ -21,6 +22,7 @@ Examples:
   run402 billing checkout 00000000-0000-4000-8000-000000000001 --product tier --tier hobby
   run402 billing checkout 0x1234... --product email-pack
   run402 billing checkout 0x1234... --product balance-topup --amount 5000000
+  run402 billing topup 0x1234... --sats 2000 --wait
   run402 billing auto-recharge org_abc on --threshold 2000
   run402 billing balance user@example.com
 `;
@@ -208,6 +210,62 @@ async function checkout(args) {
   }
 }
 
+// lightning-cash-topup: "top up N sats" → one invoice, optionally waited on.
+// stdout stays one JSON doc per step (the pipe contract); the human-facing
+// invoice line and the receipt go to stderr.
+async function topup(args) {
+  const parsedArgs = normalizeArgv(args);
+  const valueFlags = ["--sats", "--timeout", "--idempotency-key"];
+  assertKnownFlags(parsedArgs, [...valueFlags, "--wait", "--help", "-h"], valueFlags);
+  const positionals = positionalArgs(parsedArgs, valueFlags);
+  const identifier = positionals[0];
+  if (!identifier || positionals.length > 1) {
+    fail({ code: "BAD_USAGE", message: "Usage: run402 billing topup <identifier> --sats <n> [--wait]", hint: "run402 billing topup 0x1234... --sats 2000 --wait" });
+  }
+  const satsRaw = flagValue(parsedArgs, "--sats");
+  const sats = Number(satsRaw);
+  if (satsRaw === null || !Number.isSafeInteger(sats) || sats <= 0) {
+    fail({ code: "BAD_FLAG", message: "--sats must be a positive whole number of satoshis (100–1000000).", details: { flag: "--sats" } });
+  }
+  const timeoutRaw = flagValue(parsedArgs, "--timeout");
+  const timeoutMs = timeoutRaw === null ? 600_000 : Number(timeoutRaw) * 1000;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    fail({ code: "BAD_FLAG", message: "--timeout must be a positive number of seconds.", details: { flag: "--timeout" } });
+  }
+  try {
+    const sdk = getSdk();
+    const org = await sdk.billing.lookupOrganization(identifier);
+    const created = await sdk.billing.createLightningTopup(org.org_id, {
+      amountSats: sats,
+      idempotencyKey: flagValue(parsedArgs, "--idempotency-key") ?? undefined,
+    });
+    console.log(JSON.stringify(created, null, 2));
+    console.error(`Invoice for ${created.amount_sats} sats (≈ $${(created.amount_usd_micros / 1_000_000).toFixed(2)} at the quoted rate), expires ${created.invoice_expires_at}.`);
+    console.error(`Pay it from any Lightning wallet:\n  lightning:${created.bolt11}`);
+    if (!parsedArgs.includes("--wait")) {
+      console.error(`Then read it: run402 billing topup is one-shot; poll GET /orgs/v1/${org.org_id}/checkouts/${created.topup_id} (or rerun with --wait).`);
+      return;
+    }
+    let announced = false;
+    const final = await sdk.billing.waitForTopup(org.org_id, created.topup_id, {
+      timeoutMs,
+      onPoll: () => { if (!announced) { announced = true; console.error("Waiting for the payment…"); } },
+    });
+    console.log(JSON.stringify(final, null, 2));
+    if (final.status === "paid" || final.status === "paid_late") {
+      console.error(`Received — ${final.amount_sats} sats credited $${(final.amount_usd_micros / 1_000_000).toFixed(2)} to the balance${final.status === "paid_late" ? " (paid after the invoice expired; still credited)" : ""}.`);
+    } else if (final.status === "expired") {
+      console.error("The invoice expired unpaid. Mint a fresh one with the same command.");
+      process.exitCode = 2;
+    } else {
+      console.error("Timed out still pending — a payment that lands later still credits (up to an hour after expiry); poll the top-up.");
+      process.exitCode = 2;
+    }
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
 async function createEmail(args) {
   const parsedArgs = normalizeArgv(args);
   assertKnownFlags(parsedArgs, ["--help", "-h"]);
@@ -353,6 +411,7 @@ export async function run(sub, args) {
     case "create-email": await createEmail(args); break;
     case "link-wallet": await linkWallet(args); break;
     case "checkout": await checkout(args); break;
+    case "topup": await topup(args); break;
     case "auto-recharge": await autoRecharge(args); break;
     case "balance": await balance(args); break;
     case "history": await history(args); break;

package/lib/buzz.mjs

@@ -26,7 +26,7 @@ Canonical workflows:
       --org                       the Run402 organization id as "run402 org whoami" returns it (a UUID)
       --deployment-context-file   JSON with exactly these five non-empty strings, and no others:
                                   project_id, release_id, live_url, source_revision, verified_at
-  run402 buzz install --org <org_id> --community <buzz:community:host> --authority <hex-pubkey>
+  run402 buzz install --org <org_id> --community <buzz:community:host> [--authority <hex-pubkey>]
   run402 buzz enroll --installation <buzzci_id> --identity-link <idlnk_id> --grants-file <json> --expires-at <ISO-8601>
 
 Explicit consent/decision commands:
@@ -34,7 +34,7 @@ Explicit consent/decision commands:
   run402 buzz adopt offer cancel <buzzhao_id>
   run402 buzz adopt complete <buzzha_id> --event-file <owner-event.json>
   run402 buzz adopt cancel <buzzha_id>
-  run402 buzz install activate <buzzci_id> --proof-file <authority-proof.json>
+  run402 buzz install activate <buzzci_id> --invite <link|code>   (a one-use invite minted in Buzz Desktop; no key leaves Desktop)
   run402 buzz install update <buzzci_id> --policy-file <policy.json> --policy-revision <n> --default <true|false>
   run402 buzz install revoke <buzzci_id>
   run402 buzz approve <buzzae_id> --grants-file <json> --descriptor-revision <n> --policy-revision <n>
@@ -199,12 +199,15 @@ async function install(args) {
   const [operation, ...rest] = args;
   if (operation === "activate") {
     const a = normalizeArgv(rest);
-    const values = ["--proof-file", "--idempotency-key"];
+    const values = ["--invite", "--idempotency-key"];
     assertKnownFlags(a, values, values);
-    const [id] = requirePositionalCount(a, values, { min: 1, max: 1, command: "run402 buzz install activate <buzzci_id> --proof-file <json>" });
-    const proof = readJsonFile(requiredFlag(a, "--proof-file"), "--proof-file");
+    const [id] = requirePositionalCount(a, values, { min: 1, max: 1, command: "run402 buzz install activate <buzzci_id> --invite <link|code>" });
+    // The invite is a one-use bearer artifact: it goes to the gateway once
+    // and is never echoed. A bare code, an https://<relay>/invite/<code>
+    // link, or a buzz://join?relay=…&code=… link are all accepted.
+    const invite = requiredFlag(a, "--invite");
     const key = flagValue(a, "--idempotency-key") ?? undefined;
-    return invoke(() => getSdk().buzz.communityInstallations.activate(id, proof, key));
+    return invoke(() => getSdk().buzz.communityInstallations.activate(id, invite, key));
   }
   if (operation === "revoke") {
     const a = normalizeArgv(rest);
@@ -252,13 +255,13 @@ async function install(args) {
   const a = normalizeArgv(args);
   const values = ["--org", "--community", "--authority", "--policy-file", "--idempotency-key"];
   assertKnownFlags(a, values, values);
-  requirePositionalCount(a, values, { min: 0, max: 0, command: "run402 buzz install [--org <org_id>] --community <subject> --authority <hex>" });
+  requirePositionalCount(a, values, { min: 0, max: 0, command: "run402 buzz install [--org <org_id>] --community <subject> [--authority <hex>]" });
   const policyFile = flagValue(a, "--policy-file");
   const organizationId = await resolveOrgId(a, { cmd: "buzz" });
   return invoke(() => getSdk().buzz.install({
     organizationId,
     buzzCommunitySubject: requiredFlag(a, "--community"),
-    buzzCommunityAuthoritySubject: requiredFlag(a, "--authority"),
+    buzzCommunityAuthoritySubject: flagValue(a, "--authority") ?? undefined,
     enrollmentPolicy: policyFile ? readJsonFile(policyFile, "--policy-file") : undefined,
     idempotencyKey: flagValue(a, "--idempotency-key") ?? undefined,
   }));

package/lib/buzz.test.mjs

@@ -194,6 +194,26 @@ describe("run402 buzz CLI", () => {
     assert.match(stderr.join("\n"), /pending/);
   });
 
+  it("installs without naming a Buzz authority and activates through the invite front door", async () => {
+    const calls = [];
+    sdk = {
+      buzz: {
+        install: async (input) => { calls.push(["install", input]); return { status: "pending", installation_identity: { pubkey: "ab".repeat(32) }, next_actions: [{ type: "mint_buzz_invite" }] }; },
+        communityInstallations: {
+          activate: async (id, invite, key) => { calls.push(["activate", id, invite, key]); return { status: "active", bot_mode: "attested" }; },
+        },
+      },
+    };
+    await run("install", ["--org", "22222222-2222-4222-8222-222222222222", "--community", "buzz:community:acme.communities.buzz.xyz"]);
+    assert.equal(calls[0][0], "install");
+    assert.equal(calls[0][1].buzzCommunitySubject, "buzz:community:acme.communities.buzz.xyz");
+    assert.equal(calls[0][1].buzzCommunityAuthoritySubject, undefined);
+    assert.equal(JSON.parse(stdout[0]).next_actions[0].type, "mint_buzz_invite");
+    await run("install", ["activate", `buzzci_${"2".repeat(32)}`, "--invite", "https://acme.communities.buzz.xyz/invite/v2.abcdefghij", "--idempotency-key", "activate-1"]);
+    assert.deepEqual(calls[1], ["activate", `buzzci_${"2".repeat(32)}`, "https://acme.communities.buzz.xyz/invite/v2.abcdefghij", "activate-1"]);
+    assert.equal(JSON.parse(stdout[1]).bot_mode, "attested");
+  });
+
   it("discovers descriptors by community without authentication", async () => {
     let observed;
     sdk = {

package/lib/command-manifest.mjs

@@ -182,7 +182,7 @@ export const COMMAND_MANIFEST = [
 
   // ── deploy (unified deploy v2) ───────────────────────────────────────────
   { path: ["deploy", "apply"], positionals: [], projectScoped: true, legacyPositionalProject: false, minimalArgs: ["--spec", "{}", "--check"], runStyle: "deployV2" },
-  { path: ["deploy", "rehearse"], positionals: [p("plan_id")], projectScoped: true, legacyPositionalProject: false, minimalArgs: ["plan_gate1"], runStyle: "deployV2" },
+  { path: ["deploy", "rehearse"], positionals: [p("plan_id", { required: false })], projectScoped: true, legacyPositionalProject: false, minimalArgs: ["plan_gate1"], runStyle: "deployV2" },
   { path: ["deploy", "promote"], positionals: [p("release_id")], projectScoped: true, legacyPositionalProject: false, minimalArgs: ["rel_gate1"], runStyle: "deployV2" },
   { path: ["deploy", "resume"], positionals: [p("operation_id")], projectScoped: true, legacyPositionalProject: false, minimalArgs: ["op_gate1"], runStyle: "deployV2" },
   { path: ["deploy", "list"], positionals: [], projectScoped: true, legacyPositionalProject: false, minimalArgs: [], runStyle: "deployV2" },
@@ -453,6 +453,7 @@ export const COMMAND_MANIFEST = [
   { path: ["billing", "create-email"], positionals: [p("email")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["gate@example.com"] },
   { path: ["billing", "link-wallet"], positionals: [p("org_id", { required: false })], projectScoped: false, orgScoped: true, legacyPositionalProject: false, minimalArgs: [GATE_ORG, "0x1111111111111111111111111111111111111111"] },
   { path: ["billing", "checkout"], positionals: [p("identifier")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["00000000-0000-4000-8000-000000000001", "--product", "email-pack"] },
+  { path: ["billing", "topup"], positionals: [p("identifier")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["00000000-0000-4000-8000-000000000001", "--sats", "2000"] },
   { path: ["billing", "auto-recharge"], positionals: [p("org_id", { required: false })], projectScoped: false, orgScoped: true, legacyPositionalProject: false, minimalArgs: [GATE_ORG, "--state", "on"] },
   { path: ["billing", "balance"], positionals: [p("identifier")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["gate@example.com"] },
   { path: ["billing", "history"], positionals: [p("identifier")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["gate@example.com"] },

package/lib/deploy-rehearse-discovery.test.mjs

@@ -0,0 +1,25 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { discoverRehearseManifest } from "./deploy-v2.mjs";
+
+describe("deploy rehearse — manifest discovery (the way up does it)", () => {
+  it("prefers run402.json, then run402.deploy.json, then app.json, then executable configs", () => {
+    const dir = mkdtempSync(join(tmpdir(), "run402-rehearse-discover-"));
+    try {
+      assert.equal(discoverRehearseManifest(dir), null);
+      writeFileSync(join(dir, "run402.deploy.ts"), "export default {}");
+      assert.equal(discoverRehearseManifest(dir), join(dir, "run402.deploy.ts"));
+      writeFileSync(join(dir, "app.json"), "{}");
+      assert.equal(discoverRehearseManifest(dir), join(dir, "app.json"));
+      writeFileSync(join(dir, "run402.deploy.json"), "{}");
+      assert.equal(discoverRehearseManifest(dir), join(dir, "run402.deploy.json"));
+      writeFileSync(join(dir, "run402.json"), "{}");
+      assert.equal(discoverRehearseManifest(dir), join(dir, "run402.json"));
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});

package/lib/deploy-v2.mjs

@@ -228,19 +228,28 @@ Output:
   stderr: one JSON poll progress line per attempt when --wait is set
 `;
 
-const REHEARSE_HELP = `run402 deploy rehearse — Run a persisted plan on a contained branch
+const REHEARSE_HELP = `run402 deploy rehearse — Run a plan on a contained branch (ADVANCED; rehearsal is automatic in up / deploy apply)
 
 Usage:
-  run402 deploy rehearse <plan_id> [--project <id>] [--teardown on_pass|keep|always] [--json]
+  run402 deploy rehearse [<plan_id>] [--manifest <path>] [--project <id>] [--teardown on_pass|keep|always] [--json]
 
 Options:
+  <plan_id>           An already-persisted plan. Its bytes must be uploaded; when
+                      the gateway answers REHEARSAL_CONTENT_MISSING the manifest
+                      in the current directory (or --manifest) is used to upload
+                      them and the rehearsal is retried. If facts changed since
+                      that plan, a fresh reviewed plan is created and rehearsed
+                      instead — the result names which plan was rehearsed.
+  --manifest <path>   Plan from this manifest (run402.json, run402.deploy.json,
+                      app.json, or an executable config), upload its bytes, then
+                      rehearse. Without <plan_id> the manifest is discovered in
+                      the current directory the same way run402 up does.
   --teardown <mode>   on_pass (default: passed rehearsals delete their branch;
-                      failed rehearsals keep it), keep, always. When omitted,
-                      the gateway default (on_pass) applies.
+                      failed rehearsals keep it), keep, always.
+  --project <id>      Project for operator-approval metadata and project resolution.
 
-Rehearsal is automatic in \`run402 up\` / \`run402 deploy apply\` for a
-migration-bearing plan against a project with a live release; this verb is the
-primitive for rehearsing an already-persisted plan without committing.
+Nothing is committed. The result carries the rehearsal report and the exact
+bound commit command (run402 deploy apply --require-plan <plan_id>).
 `;
 
 const RELEASE_HELP = `run402 deploy release — Inspect deploy release inventory and diffs
@@ -356,14 +365,52 @@ export async function runDeployV2(sub, args) {
   });
 }
 
+const REHEARSE_MANIFEST_CANDIDATES = ["run402.json", "run402.deploy.json", "app.json", "run402.deploy.ts", "run402.deploy.mts", "run402.deploy.js", "run402.deploy.mjs"];
+
+/** The manifest `deploy rehearse` would plan from in `dir`, discovered the way `up` does, or null. */
+export function discoverRehearseManifest(dir = process.cwd()) {
+  for (const name of REHEARSE_MANIFEST_CANDIDATES) {
+    const candidate = resolve(dir, name);
+    if (existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+
+async function loadReleaseSpecForRehearse(manifestPath, project) {
+  const executable = EXECUTABLE_MANIFEST_EXTENSIONS.has(extname(manifestPath).toLowerCase());
+  let normalized;
+  try {
+    if (executable) {
+      normalized = await loadDeployManifest(manifestPath, { ...(project ? { project } : {}) });
+    } else {
+      const spec = JSON.parse(readFileSync(manifestPath, "utf-8"));
+      rejectLegacySecretManifest(spec, { source: "manifest", path: manifestPath });
+      const defaultProject = project || spec?.project || spec?.project_id ? undefined : resolveProjectId(null);
+      normalized = await normalizeDeployManifest(spec, {
+        baseDir: dirname(manifestPath),
+        ...(project ? { project } : {}),
+        ...(defaultProject ? { defaultProject } : {}),
+      });
+    }
+  } catch (err) {
+    reportSdkError(err);
+  }
+  return normalized;
+}
+
+function isContentMissing(err) {
+  const code = err?.code ?? err?.body?.code ?? err?.envelope?.code;
+  return code === "REHEARSAL_CONTENT_MISSING";
+}
+
 async function rehearseCmd(rawArgs) {
   const args = normalizeArgv(rawArgs);
   if (args.includes("--help") || args.includes("-h")) {
     console.log(REHEARSE_HELP);
     return;
   }
-  const valueFlags = new Set(["--project", "--teardown"]);
-  const allowedFlags = ["--project", "--teardown", "--json", "--help", "-h"];
+  const valueFlags = new Set(["--project", "--teardown", "--manifest"]);
+  const allowedFlags = ["--project", "--teardown", "--manifest", "--json", "--help", "-h"];
   const positionals = [];
   for (let i = 0; i < args.length; i += 1) {
     const arg = args[i];
@@ -382,9 +429,23 @@ async function rehearseCmd(rawArgs) {
     }
     positionals.push(arg);
   }
-  const planId = positionals[0];
-  if (!planId || positionals.length > 1) {
-    fail({ code: "BAD_USAGE", message: "Usage: run402 deploy rehearse <plan_id> [--project <id>] [--teardown on_pass|keep|always] [--json]" });
+  if (positionals.length > 1) {
+    fail({ code: "BAD_USAGE", message: "Usage: run402 deploy rehearse [<plan_id>] [--manifest <path>] [--project <id>] [--teardown on_pass|keep|always] [--json]" });
+  }
+  const givenPlanId = positionals[0] ?? null;
+  const explicitManifest = flagValue(args, "--manifest");
+  const manifestPath = explicitManifest
+    ? (isAbsolute(explicitManifest) ? explicitManifest : resolve(process.cwd(), explicitManifest))
+    : discoverRehearseManifest();
+  if (explicitManifest && !existsSync(manifestPath)) {
+    fail({ code: "BAD_USAGE", message: `Manifest not found: ${manifestPath}`, details: { flag: "--manifest", path: explicitManifest } });
+  }
+  if (!givenPlanId && !manifestPath) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Nothing to rehearse: pass a <plan_id>, or run from a directory with a manifest (run402.json, run402.deploy.json, app.json), or pass --manifest <path>.",
+      details: { searched: REHEARSE_MANIFEST_CANDIDATES },
+    });
   }
   // When --teardown is absent, omit it from the request body entirely — the
   // gateway defaults to on_pass (passed rehearsals delete their branch).
@@ -394,23 +455,63 @@ async function rehearseCmd(rawArgs) {
   }
   const project = flagValue(args, "--project") ?? undefined;
   // A delegate is a complete deploy credential and the gateway explicitly
-  // supports rehearsing with one — walletAuthOrCiSession routes a delegate
-  // bearer through delegateDeployAuth("project.deploy"), and the route rejects
-  // only CI sessions (REHEARSAL_CI_UNSUPPORTED), whose own next_action reads
-  // "Rehearse with a wallet, control-plane session, or scoped agent delegate."
-  // Without this branch the CLI refuses locally with NO_ALLOWANCE and tells the
-  // caller to run `run402 init` — a wrong remedy for a holder who has no wallet
-  // by design, and the same misleading-error shape we removed from the payment
-  // path in 4.11.2. Rehearsal is the SAFE path; never make it the harder one.
+  // supports rehearsing with one (the route rejects only CI sessions).
+  // Rehearsal is the SAFE path; never make it the harder one.
   if (!isCoreApiTarget() && !loadLiveControlPlaneSession() && !delegateTokenFromEnv()) {
-    allowanceAuthHeaders(`/apply/v1/plans/${planId}/rehearse`);
+    allowanceAuthHeaders(`/apply/v1/plans/${givenPlanId ?? "_"}/rehearse`);
+  }
+  const sdk = getSdk();
+  const emit = makeStderrEventWriter(false);
+
+  // Plan from the manifest, upload its bytes, and hand back the persisted
+  // plan id to rehearse. Used when no plan id was given, and as the recovery
+  // for a plan whose bytes were never uploaded.
+  async function planAndUpload() {
+    const normalized = await loadReleaseSpecForRehearse(manifestPath, project);
+    const planned = await sdk._applyEngine.plan(normalized.spec, {
+      idempotencyKey: normalized.idempotencyKey,
+      mode: "reviewedPlan",
+    });
+    const planId = planned.plan.plan_id;
+    if (!planId) {
+      fail({ code: "DRY_RUN_PLAN_NOT_COMMITTABLE", message: "Rehearsal requires a persisted plan_id, but the plan response did not include one.", details: { project_id: normalized.spec.project } });
+    }
+    await sdk._applyEngine.upload(planned.plan, {
+      project: normalized.spec.project,
+      byteReaders: planned.byteReaders,
+      onEvent: emit,
+    });
+    return { planId, plan: planned.plan, projectId: normalized.spec.project };
   }
+
   try {
-    const rehearsal = await withAutoApprove(() =>
-      getSdk()._applyEngine.rehearse(planId, { project, teardown }),
-    );
+    let planId = givenPlanId;
+    let replanned = null;
+    let rehearsal;
+    if (!planId) {
+      const fresh = await planAndUpload();
+      planId = fresh.planId;
+      rehearsal = await withAutoApprove(() => sdk._applyEngine.rehearse(planId, { project: project ?? fresh.projectId, teardown }));
+    } else {
+      try {
+        rehearsal = await withAutoApprove(() => sdk._applyEngine.rehearse(planId, { project, teardown }));
+      } catch (err) {
+        if (!isContentMissing(err) || !manifestPath) throw err;
+        // The plan's bytes were never uploaded (a --plan-only plan). Plan from
+        // the manifest to get byte readers, upload, and retry. When facts
+        // changed since the given plan the fresh plan is the one rehearsed,
+        // and the result says so — never silently substituted.
+        const fresh = await planAndUpload();
+        if (fresh.planId !== givenPlanId) replanned = { original_plan_id: givenPlanId, plan_id: fresh.planId, why: "plan facts changed since the given plan; a fresh reviewed plan was created, its bytes uploaded, and that plan rehearsed" };
+        planId = fresh.planId;
+        rehearsal = await withAutoApprove(() => sdk._applyEngine.rehearse(planId, { project: project ?? fresh.projectId, teardown }));
+      }
+    }
     console.log(JSON.stringify({
       ok: rehearsal.report.status === "passed",
+      plan_id: planId,
+      ...(manifestPath ? { manifest_path: manifestPath } : {}),
+      ...(replanned ? { replanned } : {}),
       rehearsal,
       commit_command: `run402 deploy apply --require-plan ${planId}`,
     }, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "4.73.4",
+  "version": "4.75.0",
   "description": "CLI for Run402 — full-stack backend infrastructure for AI agents: Postgres, auth, storage, serverless functions and atomic deploys. Paid with x402/MPP. Includes $0.03 image generation.",
   "type": "module",
   "bin": {

package/sdk/dist/actions.d.ts

@@ -70,17 +70,22 @@ export interface Run402UpActionInput {
      *  project with a live release gets. Default false. */
     noRehearse?: boolean;
     /** Explicit display name to set on the principal when it has none yet.
-     *  Omitted: the detected client name (`claude-code`, `codex`, `cursor`,
-     *  or `agent`) is used and reported as `identity.source: "detected"`. */
+     *  Omitted: `RUN402_AGENT_NAME` when set, else a specifically detected
+     *  client (`claude-code`, `codex`, `cursor`) reported as `identity.source:
+     *  "detected"`; when nothing is known no name is written and the result
+     *  says `identity.source: "undetected"`. */
     identityName?: string;
 }
 /** How `up` resolved the principal's display name (first-deploy-agent-dx). */
 export interface Run402UpIdentity {
     display_name: string | null;
-    /** `existing`: already set; `explicit`: set now from `identityName`;
-     *  `detected`: set now from the detected client; `unavailable`: could not
-     *  be read or set (never fails the deploy). */
-    source: "existing" | "explicit" | "detected" | "unavailable";
+    /** `existing`: already set; `explicit`: set now from `identityName` or
+     *  `RUN402_AGENT_NAME`; `detected`: set now from a specifically detected
+     *  client (`claude-code`, `codex`, `cursor`); `undetected`: nothing known
+     *  and nothing persisted — a guess is never written as a name (the room
+     *  presence is `agent` for coordination only); `unavailable`: could not be
+     *  read or set (never fails the deploy). */
+    source: "existing" | "explicit" | "detected" | "undetected" | "unavailable";
     /** The project room presence `up` registered under that name, when it could. */
     presence?: {
         presence_id: string;

package/sdk/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/sdk/dist/namespaces/billing.d.ts

@@ -56,6 +56,51 @@ export interface CreateCheckoutResult {
     checkout_url: string;
     topup_id: string;
 }
+/**
+ * A Lightning cash top-up (lightning-cash-topup). `amount_usd_micros` is a
+ * QUOTE fixed at mint (`usd_value_is_quote: true`) and is what settlement
+ * credits. Never carries the provider's credential.
+ */
+export interface LightningTopup {
+    org_id: string;
+    product: "balance_topup";
+    rail: "lightning";
+    topup_id: string;
+    /** The payable invoice, verbatim. */
+    bolt11: string | null;
+    payment_hash: string | null;
+    amount_sats: number | null;
+    amount_usd_micros: number;
+    usd_value_is_quote: true;
+    quoted_rate: {
+        usd_per_btc: number;
+        source: string;
+        observed_at: string;
+        amount_sats: number;
+    } | null;
+    invoice_expires_at: string | null;
+    status: "pending" | "paid" | "paid_late" | "expired";
+    paid_at: string | null;
+    credited_ledger_id: string | null;
+    created_at: string | null;
+    next_actions: Array<{
+        type: string;
+        method: string;
+        path: string;
+        why: string;
+    }>;
+}
+export interface CreateLightningTopupOptions {
+    /** Whole satoshis, 100–1,000,000. */
+    amountSats: number;
+    /** Replay-safe create: the same key returns the same top-up. */
+    idempotencyKey?: string;
+}
+export interface WaitForTopupOptions {
+    pollMs?: number;
+    timeoutMs?: number;
+    onPoll?: (state: LightningTopup) => void;
+}
 export interface EmailOrganization {
     id: string;
     email: string;
@@ -92,6 +137,11 @@ export type CreateCheckoutOptions = {
     amountUsdMicros: number;
     successUrl?: string;
     cancelUrl?: string;
+} | {
+    /** lightning-cash-topup: a bolt11 invoice instead of a Stripe session. */
+    product?: "balance_topup";
+    rail: "lightning";
+    amountSats: number;
 } | {
     product: "tier";
     tier: ProjectTier;
@@ -149,6 +199,19 @@ export declare class Billing {
     getHistory(identifier: OrganizationIdentifier, opts?: BillingHistoryOptions): Promise<BillingHistoryResult>;
     /** Create a Stripe checkout URL for an organization. */
     createCheckout(organizationId: string, checkout: CreateCheckoutOptions): Promise<CreateCheckoutResult>;
+    /**
+     * lightning-cash-topup: mint a bolt11 invoice that tops up the org's cash
+     * balance when paid. No funds move at creation; any active org member or a
+     * delegate for one of the org's projects may call it.
+     */
+    createLightningTopup(organizationId: string, options: CreateLightningTopupOptions): Promise<LightningTopup>;
+    /** Read one top-up (the waiting client's poll). */
+    getTopup(organizationId: string, topupId: string): Promise<LightningTopup>;
+    /**
+     * Poll a top-up until it is paid, paid late, or expired (or the timeout
+     * elapses, in which case the last observed state is returned).
+     */
+    waitForTopup(organizationId: string, topupId: string, options?: WaitForTopupOptions): Promise<LightningTopup>;
     /** Create an email-only (no-wallet) organization. Sends a verification email. */
     createEmailOrganization(email: string): Promise<EmailOrganization>;
     /**

package/sdk/dist/namespaces/billing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/namespaces/billing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/namespaces/billing.ts"],"names":[],"mappings":"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"}