run402 4.22.0 → 4.23.0

package/lib/buzz-notifications.mjs

@@ -0,0 +1,310 @@
+/**
+ * `run402 buzz notifications` — project-event routing into a Buzz channel.
+ *
+ * Gateway subsystem: add-buzz-project-event-routing
+ * (/buzz-project-event-routes/v1/*). JSON envelopes to stdout (pipe
+ * contract); the authorization handoff and wait narration go to stderr.
+ */
+import { getSdk } from "./sdk.mjs";
+import { fail, reportSdkError } from "./sdk-errors.mjs";
+import {
+  normalizeArgv,
+  hasHelp,
+  assertKnownFlags,
+  parseIntegerFlag,
+  flagValue,
+  positionalArgs,
+  requirePositionalCount,
+  failUnknownSubcommand,
+} from "./argparse.mjs";
+
+const HELP = `run402 buzz notifications — route project events into a Buzz community channel
+
+Usage:
+  run402 buzz notifications configure --org <uuid> --installation <buzzci_id> --name <route_name> --channel <uuid> --project <id> [--project <id> ...] [--event-type <t> ...] [--event-class <c> ...]
+  run402 buzz notifications status [--org <uuid> | <buzzper_id>]
+  run402 buzz notifications test <buzzper_id> [--wait] [--poll-seconds <n>] [--timeout-seconds <n>]
+  run402 buzz notifications deliveries <buzzper_id> [--limit <n>] [--cursor <c>] [--delivery <buzzped_id>]
+  run402 buzz notifications pause <buzzper_id>
+  run402 buzz notifications resume <buzzper_id>
+  run402 buzz notifications rotate <buzzper_id>
+  run402 buzz notifications revoke <buzzper_id>
+
+THE WORKFLOW — configure -> authorize -> test -> live:
+  1. configure   Creates the route. The response's \`authorization\` block is
+                 either \`authorized\` (live now) or \`pending_buzz_authorization\`
+                 with the ONE exact, non-secret handoff: a Buzz community owner
+                 or admin adds the printed notification_pubkey as a relay
+                 member (the approving human's own Buzz key lives in
+                 Buzz Desktop -> Settings -> Profile -> Identity).
+  2. authorize   Done on the Buzz side by that human — nothing to run here.
+  3. test        Re-checks the Buzz-side membership (activating the route when
+                 it landed) and queues one signed test message. \`--wait\` polls
+                 the delivery for you.
+  4. live        Matching project events flow as channel messages. NEW events
+                 only — nothing that predates the route is ever delivered.
+
+What can be routed:
+  event types    deploy_activated, error_fingerprints_observed,
+                 platform_incident — the three reviewed projectors. Nothing
+                 else has one, so nothing else can be routed.
+  event classes  security, billing_critical, destructive_lifecycle,
+                 verification, and recovery may NEVER be routed to Buzz.
+  Omitting --event-type/--event-class routes every registered type / every
+  non-forbidden class. There is no empty filter: the gateway rejects [].
+
+Buzz is never a deadman channel: mandatory operator notifications keep their
+human paths (email, Telegram) regardless of route state, and a Buzz delivery
+acknowledges nothing.
+
+Delivery semantics:
+  At-least-once, one row per (route, event), byte-identical republish on
+  retry. Backoff 1m/5m/30m/2h/12h to 8 attempts or 48h, then dead_letter —
+  visible in \`deliveries\`. Ten consecutive hard failures auto-pause the
+  route (pause_reason: delivery_failures); \`resume\` re-arms it.
+
+Security:
+  - JSON stdout only; progress and the authorization handoff go to stderr.
+  - No command here ever accepts or prints a signing secret — the
+    notification_pubkey and signing_generation are the only credential
+    material on the wire. \`rotate\` stages the NEXT key; the swap activates
+    only after its own Buzz-side membership verifies.
+  - Every command in this group has zero spend impact.
+
+Examples:
+  run402 buzz notifications configure --org 8f14…-uuid --installation buzzci_… --name deploys --channel <nip29-channel-id> --project prj_myapp --event-type deploy_activated
+  run402 buzz notifications test buzzper_… --wait
+  run402 buzz notifications deliveries buzzper_… --limit 20
+`;
+
+function out(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+
+/** All values of a repeatable value-flag, in argv order. */
+function flagValues(args, flag) {
+  const values = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] !== flag) continue;
+    if (i + 1 >= args.length || (typeof args[i + 1] === "string" && args[i + 1].startsWith("--"))) {
+      fail({ code: "BAD_FLAG", message: `${flag} requires a value`, details: { flag } });
+    }
+    values.push(args[i + 1]);
+    i += 1;
+  }
+  return values;
+}
+
+function requiredFlag(args, flag) {
+  const value = flagValue(args, flag);
+  if (value === null) fail({ code: "BAD_FLAG", message: `${flag} is required`, details: { flag } });
+  return value;
+}
+
+/**
+ * The authorization block is the one exact handoff a human must complete —
+ * it goes to stderr LOUDLY (the JSON on stdout already carries it verbatim).
+ */
+function narrateAuthorization(authorization) {
+  if (!authorization || authorization.status !== "pending_buzz_authorization") return;
+  console.error("PENDING BUZZ AUTHORIZATION — the route cannot deliver until a Buzz community owner or admin completes this handoff:");
+  console.error(`  notification_pubkey: ${authorization.notification_pubkey}`);
+  if (authorization.connect_command) console.error(`  connect command:     ${authorization.connect_command}`);
+  if (authorization.instructions) console.error(`  ${authorization.instructions}`);
+  console.error("  (The approving human's Buzz key lives in Buzz Desktop -> Settings -> Profile -> Identity.)");
+  console.error("  Then run `run402 buzz notifications test <buzzper_id> --wait` to verify it landed.");
+}
+
+async function configure(args) {
+  const a = normalizeArgv(args);
+  const valueFlags = ["--org", "--installation", "--name", "--channel", "--project", "--event-type", "--event-class", "--idempotency-key"];
+  assertKnownFlags(a, [...valueFlags, "--help", "-h"], valueFlags);
+  requirePositionalCount(positionalArgs(a, valueFlags), valueFlags, {
+    min: 0, max: 0, command: "run402 buzz notifications configure", missing: "",
+  });
+  const projectIds = flagValues(a, "--project");
+  if (projectIds.length === 0) {
+    fail({ code: "BAD_FLAG", message: "--project is required at least once — a route's scope is always explicit", details: { flag: "--project" } });
+  }
+  const eventTypes = flagValues(a, "--event-type");
+  const eventClasses = flagValues(a, "--event-class");
+  try {
+    const created = await getSdk().buzz.notifications.createRoute(requiredFlag(a, "--org"), {
+      installationId: requiredFlag(a, "--installation"),
+      routeName: requiredFlag(a, "--name"),
+      buzzChannelId: requiredFlag(a, "--channel"),
+      projectIds,
+      ...(eventTypes.length ? { eventTypes } : {}),
+      ...(eventClasses.length ? { eventClasses } : {}),
+      ...(flagValue(a, "--idempotency-key") ? { idempotencyKey: flagValue(a, "--idempotency-key") } : {}),
+    });
+    out(created);
+    narrateAuthorization(created.authorization);
+    if (created.authorization?.status === "authorized") {
+      console.error("Route is authorized and active. Run `run402 buzz notifications test <buzzper_id> --wait` to see a delivery land.");
+    }
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
+async function status(args) {
+  const a = normalizeArgv(args);
+  const valueFlags = ["--org"];
+  assertKnownFlags(a, [...valueFlags, "--help", "-h"], valueFlags);
+  const positionals = requirePositionalCount(positionalArgs(a, valueFlags), valueFlags, {
+    min: 0, max: 1, command: "run402 buzz notifications status [--org <uuid> | <buzzper_id>]", missing: "",
+  });
+  try {
+    const sdk = getSdk();
+    if (positionals.length === 1) {
+      out(await sdk.buzz.notifications.get(positionals[0]));
+      return;
+    }
+    const routes = await sdk.buzz.notifications.list(requiredFlag(a, "--org"));
+    out({ buzz_project_event_routes: routes });
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
+async function test(args) {
+  const a = normalizeArgv(args);
+  const valueFlags = ["--poll-seconds", "--timeout-seconds", "--idempotency-key"];
+  assertKnownFlags(a, [...valueFlags, "--wait", "--help", "-h"], valueFlags);
+  const positionals = requirePositionalCount(positionalArgs(a, valueFlags), valueFlags, {
+    min: 1, max: 1, command: "run402 buzz notifications test", missing: "<buzzper_id>",
+  });
+  const routeId = positionals[0];
+  const idempotencyKey = flagValue(a, "--idempotency-key") ?? undefined;
+  try {
+    const sdk = getSdk();
+    if (!a.includes("--wait")) {
+      const queued = await sdk.buzz.notifications.test(routeId, idempotencyKey);
+      out(queued);
+      console.error(`Queued ${queued.buzz_project_event_delivery_id} — the tick publishes within ~60s. Poll: run402 buzz notifications deliveries ${routeId} --delivery ${queued.buzz_project_event_delivery_id}`);
+      return;
+    }
+    const pollSeconds = flagValue(a, "--poll-seconds");
+    const timeoutSeconds = flagValue(a, "--timeout-seconds");
+    const pollMs = (pollSeconds != null ? parseIntegerFlag("--poll-seconds", pollSeconds, { min: 2, max: 600 }) : 5) * 1000;
+    const timeoutMs = (timeoutSeconds != null ? parseIntegerFlag("--timeout-seconds", timeoutSeconds, { min: 10, max: 3600 }) : 180) * 1000;
+    // The SDK owns the wait (shared waitFor contract: a timeout RETURNS the
+    // still-queued delivery, never throws). The CLI only narrates on stderr —
+    // stdout stays one JSON doc (the pipe contract).
+    let announced = false;
+    const delivery = await sdk.buzz.notifications.testAndWait(routeId, {
+      pollMs,
+      timeoutMs,
+      onPoll: (state) => {
+        if (!announced) {
+          announced = true;
+          console.error(`Queued ${state.buzz_project_event_delivery_id} (${state.status}); waiting for the publisher tick…`);
+        }
+      },
+    });
+    out(delivery);
+    if (delivery.status === "delivered") {
+      console.error(`Delivered — Nostr event ${delivery.nostr_event_id ?? "(id pending)"} is on the relay. The route is live.`);
+    } else if (delivery.status === "queued" || delivery.status === "retryable") {
+      console.error("Timed out still queued — the tick publishes within ~60s; silence is not failure, poll deliveries. If the route was pending authorization, the Buzz-side member-add may not have landed yet.");
+      process.exitCode = 2;
+    } else {
+      console.error(`Terminal without delivering (${delivery.status}${delivery.last_error ? `: ${delivery.last_error}` : ""}) — inspect \`run402 buzz notifications status ${routeId}\` for route health.`);
+      process.exitCode = 2;
+    }
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
+async function deliveries(args) {
+  const a = normalizeArgv(args);
+  const valueFlags = ["--limit", "--cursor", "--delivery"];
+  assertKnownFlags(a, [...valueFlags, "--help", "-h"], valueFlags);
+  const positionals = requirePositionalCount(positionalArgs(a, valueFlags), valueFlags, {
+    min: 1, max: 1, command: "run402 buzz notifications deliveries", missing: "<buzzper_id>",
+  });
+  try {
+    out(await getSdk().buzz.notifications.deliveries(positionals[0], {
+      ...(flagValue(a, "--limit") != null
+        ? { limit: parseIntegerFlag("--limit", flagValue(a, "--limit"), { min: 1, max: 200 }) }
+        : {}),
+      ...(flagValue(a, "--cursor") ? { cursor: flagValue(a, "--cursor") } : {}),
+      ...(flagValue(a, "--delivery") ? { deliveryId: flagValue(a, "--delivery") } : {}),
+    }));
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
+async function lifecycle(action, args) {
+  const a = normalizeArgv(args);
+  const valueFlags = ["--idempotency-key"];
+  assertKnownFlags(a, [...valueFlags, "--help", "-h"], valueFlags);
+  const positionals = requirePositionalCount(positionalArgs(a, valueFlags), valueFlags, {
+    min: 1, max: 1, command: `run402 buzz notifications ${action}`, missing: "<buzzper_id>",
+  });
+  const routeId = positionals[0];
+  const idempotencyKey = flagValue(a, "--idempotency-key") ?? undefined;
+  try {
+    const sdk = getSdk();
+    if (action === "rotate") {
+      const staged = await sdk.buzz.notifications.rotate(routeId, idempotencyKey);
+      out(staged);
+      console.error("Rotation STAGED, not active: the current key keeps signing until the NEXT pubkey's own Buzz-side membership verifies.");
+      narrateAuthorization({
+        status: "pending_buzz_authorization",
+        notification_pubkey: staged.rotation?.next_notification_pubkey,
+        instructions: staged.rotation?.authorize_hint,
+      });
+      return;
+    }
+    if (action === "revoke") {
+      const revoked = await sdk.buzz.notifications.revoke(routeId, idempotencyKey);
+      out(revoked);
+      if (revoked.notification_credential_destroyed) {
+        console.error("This was the installation's last live route — its notification credential was destroyed with it.");
+      }
+      console.error("Queued deliveries were cancelled; the route's sanitized history stays readable.");
+      return;
+    }
+    out(action === "pause"
+      ? await sdk.buzz.notifications.pause(routeId, idempotencyKey)
+      : await sdk.buzz.notifications.resume(routeId, idempotencyKey));
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
+export async function run(sub, args) {
+  const argv = Array.isArray(args) ? args : [];
+  if (!sub || sub === "help" || hasHelp([sub, ...argv])) {
+    console.log(HELP);
+    return;
+  }
+  switch (sub) {
+    case "configure":
+      await configure(argv);
+      break;
+    case "status":
+      await status(argv);
+      break;
+    case "test":
+      await test(argv);
+      break;
+    case "deliveries":
+      await deliveries(argv);
+      break;
+    case "pause":
+    case "resume":
+    case "rotate":
+    case "revoke":
+      await lifecycle(sub, argv);
+      break;
+    default:
+      failUnknownSubcommand("buzz notifications", sub, {
+        hint: "Run `run402 buzz notifications --help` for usage.",
+      });
+  }
+}

package/lib/buzz.mjs

@@ -40,6 +40,14 @@ Explicit consent/decision commands:
   run402 buzz deny <buzzae_id> [--reason <text>]
   run402 buzz revoke <buzzae_id>
 
+Project-event routing into a Buzz channel (configure → authorize → test → live):
+  run402 buzz notifications configure --org <uuid> --installation <buzzci_id> --name <route_name> --channel <uuid> --project <id> [--event-type <t> ...] [--event-class <c> ...]
+  run402 buzz notifications status [--org <uuid> | <buzzper_id>]
+  run402 buzz notifications test <buzzper_id> [--wait]
+  run402 buzz notifications deliveries <buzzper_id> [--limit <n>] [--cursor <c>] [--delivery <buzzped_id>]
+  run402 buzz notifications pause|resume|rotate|revoke <buzzper_id>
+  (run \`run402 buzz notifications --help\` for the full workflow)
+
 Advanced recovery reads:
   run402 buzz adopt direct --org <org_id> --identity-link <idlnk_id>
   run402 buzz adopt list --org <org_id>
@@ -308,6 +316,12 @@ async function revoke(args) {
 }
 
 export async function run(sub, args = []) {
+  if (sub === "notifications") {
+    // The group owns its own help (`run402 buzz notifications --help` must
+    // teach the routing workflow, not this module's lifecycle states).
+    const { run: runNotifications } = await import("./buzz-notifications.mjs");
+    return runNotifications(args[0], args.slice(1));
+  }
   if (!sub || sub === "help" || sub === "--help" || sub === "-h" || args.includes("--help") || args.includes("-h")) {
     console.log(HELP);
     return;

package/lib/buzz.test.mjs

@@ -17,6 +17,10 @@ mock.module("./sdk.mjs", {
 });
 
 const { run } = await import("./buzz.mjs");
+// Link the notifications group NOW, while the sdk.mjs module mock is active —
+// buzz.mjs imports it lazily, and a first import that happens mid-suite (after
+// an afterEach mock.restoreAll) would bind the REAL getSdk.
+await import("./buzz-notifications.mjs");
 
 let stdout;
 let stderr;
@@ -231,3 +235,210 @@ describe("run402 buzz CLI", () => {
     assert.equal(calls[1][2], "revoke-installation-1");
   });
 });
+
+describe("run402 buzz notifications CLI", () => {
+  const ORG = "11111111-1111-4111-8111-111111111111";
+  const ROUTE_ID = `buzzper_${"1".repeat(32)}`;
+  const DELIVERY_ID = `buzzped_${"2".repeat(32)}`;
+
+  beforeEach(() => {
+    process.exitCode = undefined;
+  });
+
+  it("teaches the configure → authorize → test → live workflow in group help", async () => {
+    sdk = {};
+    await run("notifications", ["--help"]);
+    const help = stdout.join("\n");
+    assert.match(help, /Usage:/);
+    assert.match(help, /configure -> authorize -> test -> live/);
+    assert.match(help, /deploy_activated, error_fingerprints_observed/);
+    assert.match(help, /may NEVER be routed/);
+    assert.match(help, /Buzz Desktop -> Settings -> Profile -> Identity/);
+    assert.match(help, /never a deadman channel/);
+  });
+
+  it("configure maps repeatable flags onto the SDK input and shouts the pending authorization handoff on stderr", async () => {
+    let observedOrg;
+    let observedInput;
+    const pubkey = "ab".repeat(32);
+    sdk = {
+      buzz: {
+        notifications: {
+          createRoute: async (orgId, input) => {
+            observedOrg = orgId;
+            observedInput = input;
+            return {
+              buzz_project_event_route_id: ROUTE_ID,
+              org_id: orgId,
+              status: "pending_authorization",
+              authorization: {
+                status: "pending_buzz_authorization",
+                notification_pubkey: pubkey,
+                connect_command: `buzz-admin add-member --pubkey ${pubkey}`,
+                instructions: `Ask a community owner or admin to add this pubkey as a relay member (e.g. ./run.sh add-member ${pubkey}), then POST the test route to verify.`,
+                verify_path: `/buzz-project-event-routes/v1/${ROUTE_ID}/test`,
+              },
+            };
+          },
+        },
+      },
+    };
+    await run("notifications", [
+      "configure",
+      "--org", ORG,
+      "--installation", `buzzci_${"3".repeat(32)}`,
+      "--name", "deploys",
+      "--channel", "chan-1",
+      "--project", "prj_a",
+      "--project", "prj_b",
+      "--event-type", "deploy_activated",
+      "--idempotency-key", "route-1",
+    ]);
+    assert.equal(observedOrg, ORG, "org_id is the bare dashed UUID, passed through verbatim");
+    assert.deepEqual(observedInput.projectIds, ["prj_a", "prj_b"]);
+    assert.deepEqual(observedInput.eventTypes, ["deploy_activated"]);
+    assert.equal(observedInput.eventClasses, undefined, "an unset filter is omitted, never fabricated");
+    assert.equal(observedInput.idempotencyKey, "route-1");
+    assert.equal(JSON.parse(stdout[0]).authorization.status, "pending_buzz_authorization");
+    const err = stderr.join("\n");
+    assert.match(err, /PENDING BUZZ AUTHORIZATION/);
+    assert.ok(err.includes(pubkey), "the notification pubkey is the one exact handoff and must be on stderr");
+    assert.match(err, /add-member/);
+    assert.doesNotMatch(err, /private|nsec|secret/i);
+  });
+
+  it("status lists for an org and reads one route by positional id", async () => {
+    const calls = [];
+    sdk = {
+      buzz: {
+        notifications: {
+          list: async (orgId) => { calls.push(["list", orgId]); return [{ buzz_project_event_route_id: ROUTE_ID }]; },
+          get: async (routeId) => { calls.push(["get", routeId]); return { buzz_project_event_route_id: routeId, health: "active" }; },
+        },
+      },
+    };
+    await run("notifications", ["status", "--org", ORG]);
+    await run("notifications", ["status", ROUTE_ID]);
+    assert.deepEqual(calls, [["list", ORG], ["get", ROUTE_ID]]);
+    assert.deepEqual(JSON.parse(stdout[0]).buzz_project_event_routes, [{ buzz_project_event_route_id: ROUTE_ID }]);
+    assert.equal(JSON.parse(stdout[1]).health, "active");
+  });
+
+  it("test --wait narrates once on stderr and reports a delivered route as live", async () => {
+    sdk = {
+      buzz: {
+        notifications: {
+          testAndWait: async (routeId, opts) => {
+            opts.onPoll({ buzz_project_event_delivery_id: DELIVERY_ID, status: "queued", poll: { path: "p" } });
+            const delivered = {
+              buzz_project_event_delivery_id: DELIVERY_ID,
+              status: "delivered",
+              nostr_event_id: "ev1",
+            };
+            opts.onPoll(delivered);
+            return delivered;
+          },
+        },
+      },
+    };
+    await run("notifications", ["test", ROUTE_ID, "--wait"]);
+    assert.equal(JSON.parse(stdout[0]).status, "delivered");
+    const announcements = stderr.filter((line) => line.includes(DELIVERY_ID) && line.includes("waiting"));
+    assert.equal(announcements.length, 1, "the queued announcement happens exactly once");
+    assert.match(stderr.join("\n"), /route is live/i);
+    assert.equal(process.exitCode, undefined);
+  });
+
+  it("test --wait exits 2 on a still-queued timeout — the tick cadence is not failure", async () => {
+    sdk = {
+      buzz: {
+        notifications: {
+          testAndWait: async (routeId, opts) => {
+            const queued = { buzz_project_event_delivery_id: DELIVERY_ID, status: "queued", poll: { path: "p" } };
+            opts.onPoll(queued);
+            return queued;
+          },
+        },
+      },
+    };
+    await run("notifications", ["test", ROUTE_ID, "--wait", "--poll-seconds", "2", "--timeout-seconds", "10"]);
+    const exitCode = process.exitCode;
+    // Reset before asserting so a signalled exit code never leaks into the
+    // test child process's own exit status.
+    process.exitCode = undefined;
+    assert.equal(JSON.parse(stdout[0]).status, "queued", "stdout stays one JSON doc — the still-queued delivery");
+    assert.match(stderr.join("\n"), /still queued — the tick publishes within ~60s; silence is not failure, poll deliveries/);
+    assert.equal(exitCode, 2);
+  });
+
+  it("test without --wait prints the queued 202 and the poll handoff", async () => {
+    sdk = {
+      buzz: {
+        notifications: {
+          test: async (routeId, key) => ({
+            buzz_project_event_delivery_id: DELIVERY_ID,
+            status: "queued",
+            poll: { path: `/buzz-project-event-routes/v1/${routeId}/deliveries?delivery_id=${DELIVERY_ID}` },
+            _key: key,
+          }),
+        },
+      },
+    };
+    await run("notifications", ["test", ROUTE_ID]);
+    assert.equal(JSON.parse(stdout[0]).status, "queued");
+    assert.match(stderr.join("\n"), /publishes within ~60s/);
+    assert.match(stderr.join("\n"), new RegExp(`deliveries ${ROUTE_ID} --delivery ${DELIVERY_ID}`));
+    assert.equal(process.exitCode, undefined);
+  });
+
+  it("deliveries maps limit/cursor/delivery flags onto SDK options", async () => {
+    let observed;
+    sdk = {
+      buzz: {
+        notifications: {
+          deliveries: async (routeId, opts) => {
+            observed = [routeId, opts];
+            return { buzz_project_event_deliveries: [], has_more: false };
+          },
+        },
+      },
+    };
+    await run("notifications", ["deliveries", ROUTE_ID, "--limit", "20", "--cursor", "cur_1", "--delivery", DELIVERY_ID]);
+    assert.deepEqual(observed, [ROUTE_ID, { limit: 20, cursor: "cur_1", deliveryId: DELIVERY_ID }]);
+    assert.equal(JSON.parse(stdout[0]).has_more, false);
+  });
+
+  it("revoke reports credential destruction and rotate shouts the staged next-key handoff", async () => {
+    const nextPubkey = "cd".repeat(32);
+    sdk = {
+      buzz: {
+        notifications: {
+          revoke: async (routeId, key) => ({
+            buzz_project_event_route_id: routeId,
+            status: "revoked",
+            notification_credential_destroyed: true,
+            _key: key,
+          }),
+          rotate: async (routeId) => ({
+            buzz_project_event_route_id: routeId,
+            rotation: {
+              status: "pending_buzz_authorization",
+              next_signing_generation: 2,
+              next_notification_pubkey: nextPubkey,
+              authorize_hint: "Ask a community owner or admin to add the NEXT pubkey as a relay member; the swap activates only after that membership verifies.",
+              verify_path: `/buzz-project-event-routes/v1/${routeId}/test`,
+            },
+          }),
+        },
+      },
+    };
+    await run("notifications", ["revoke", ROUTE_ID, "--idempotency-key", "rm-1"]);
+    assert.equal(JSON.parse(stdout[0]).notification_credential_destroyed, true);
+    assert.match(stderr.join("\n"), /last live route/);
+    await run("notifications", ["rotate", ROUTE_ID]);
+    assert.equal(JSON.parse(stdout[1]).rotation.next_signing_generation, 2);
+    const err = stderr.join("\n");
+    assert.match(err, /STAGED, not active/);
+    assert.ok(err.includes(nextPubkey), "the NEXT pubkey is the rotation handoff and must be on stderr");
+  });
+});

package/lib/command-manifest.mjs

@@ -57,6 +57,16 @@ export const COMMAND_MANIFEST = [
   { path: ["buzz", "approve"], positionals: [p("buzz_agent_enrollment_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzae_11111111111111111111111111111111", "--grants-file", "__FIXTURE_FILE__", "--descriptor-revision", "1", "--policy-revision", "1"], skipBehavioral: "requires owner step-up and a live pending enrollment" },
   { path: ["buzz", "deny"], positionals: [p("buzz_agent_enrollment_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzae_11111111111111111111111111111111"], skipBehavioral: "requires owner step-up and a live pending enrollment" },
   { path: ["buzz", "revoke"], positionals: [p("buzz_agent_enrollment_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzae_11111111111111111111111111111111"], skipBehavioral: "requires a live enrollment" },
+  // Project-event routing into a Buzz channel (add-buzz-project-event-routing).
+  // org ids on this surface are BARE dashed UUIDs, never org_-prefixed.
+  { path: ["buzz", "notifications", "configure"], positionals: [], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["--org", "11111111-1111-4111-8111-111111111111", "--installation", "buzzci_11111111111111111111111111111111", "--name", "deploys", "--channel", "22222222-2222-4222-8222-222222222222"], skipBehavioral: "requires live owner authentication and an active Buzz installation (and its repeatable --project scope flag is reserved by the gate)" },
+  { path: ["buzz", "notifications", "status"], positionals: [p("buzz_project_event_route_id", { required: false })], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["--org", "11111111-1111-4111-8111-111111111111"], skipBehavioral: "requires live owner authentication" },
+  { path: ["buzz", "notifications", "test"], positionals: [p("buzz_project_event_route_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzper_11111111111111111111111111111111"], skipBehavioral: "requires live owner authentication and a live route" },
+  { path: ["buzz", "notifications", "deliveries"], positionals: [p("buzz_project_event_route_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzper_11111111111111111111111111111111"], skipBehavioral: "requires live owner authentication and a live route" },
+  { path: ["buzz", "notifications", "pause"], positionals: [p("buzz_project_event_route_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzper_11111111111111111111111111111111"], skipBehavioral: "requires live owner authentication and a live route" },
+  { path: ["buzz", "notifications", "resume"], positionals: [p("buzz_project_event_route_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzper_11111111111111111111111111111111"], skipBehavioral: "requires live owner authentication and a live route" },
+  { path: ["buzz", "notifications", "rotate"], positionals: [p("buzz_project_event_route_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzper_11111111111111111111111111111111"], skipBehavioral: "requires live owner authentication and a live route" },
+  { path: ["buzz", "notifications", "revoke"], positionals: [p("buzz_project_event_route_id")], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["buzzper_11111111111111111111111111111111"], skipBehavioral: "requires live owner authentication and a live route" },
 
   // ── up / init / status (flat runners) ────────────────────────────────────
   { path: ["up"], positionals: [p("source", { required: false })], projectScoped: true, legacyPositionalProject: false, minimalArgs: ["--check", "-y"], runStyle: "flat", skipBehavioral: "orchestrates a full provision/build/deploy against the real cwd" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "4.22.0",
+  "version": "4.23.0",
   "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 and MPP micropayments.",
   "type": "module",
   "bin": {

package/sdk/dist/index.d.ts

@@ -337,8 +337,9 @@ export type * from "./namespaces/projects.types.js";
 export { IdentityLinks, NostrIdentityLinks } from "./namespaces/identity-links.js";
 export type * from "./namespaces/identity-links.js";
 export type * from "./namespaces/identity-links.types.js";
-export { Buzz, BuzzHumanAdoptions, BuzzHumanAdoptionOffers, BuzzCommunityInstallations, BuzzAgentEnrollments } from "./namespaces/buzz.js";
+export { Buzz, BuzzHumanAdoptions, BuzzHumanAdoptionOffers, BuzzCommunityInstallations, BuzzAgentEnrollments, BuzzNotifications } from "./namespaces/buzz.js";
 export type * from "./namespaces/buzz.types.js";
+export type * from "./namespaces/buzz-notifications.types.js";
 export type * from "./namespaces/secrets.js";
 export type * from "./namespaces/sender-domain.js";
 export type * from "./namespaces/service.js";

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

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

package/sdk/dist/index.js

@@ -373,6 +373,6 @@ export { Archives } from "./namespaces/archives.js";
 export { Snapshots } from "./namespaces/snapshots.js";
 export { Branches } from "./namespaces/branches.js";
 export { IdentityLinks, NostrIdentityLinks } from "./namespaces/identity-links.js";
-export { Buzz, BuzzHumanAdoptions, BuzzHumanAdoptionOffers, BuzzCommunityInstallations, BuzzAgentEnrollments } from "./namespaces/buzz.js";
+export { Buzz, BuzzHumanAdoptions, BuzzHumanAdoptionOffers, BuzzCommunityInstallations, BuzzAgentEnrollments, BuzzNotifications } from "./namespaces/buzz.js";
 export { ScopedWallet } from "./namespaces/wallets.js";
 //# sourceMappingURL=index.js.map