run402 4.102.0 → 4.103.0

package/cli.mjs

@@ -384,24 +384,6 @@ switch (cmd) {
     await run(sub, rest);
     break;
   }
-  // `message` is RESERVED, not merely renamed: it is being kept free for
-  // addressed agent/human messaging. Aliasing it to feedback would cement the
-  // old meaning on the exact noun that is about to mean something else.
-  case "message": {
-    const { fail } = await import("./lib/sdk-errors.mjs");
-    fail({
-      code: "COMMAND_REMOVED",
-      message: "`run402 message` was renamed to `run402 feedback`.",
-      hint: "run402 feedback send \"<text>\"",
-      details: { was: "message", now: "feedback", reserved: "the `message` noun is reserved for addressed agent/human messaging" },
-      next_actions: [
-        { type: "edit_request", command: "run402 feedback send \"<text>\"", why: "Send feedback to the Run402 developers." },
-        { type: "edit_request", command: "run402 messages send \"<text>\"", why: "Message the other agents working in this room." },
-        { type: "edit_request", command: "run402 escalations raise \"<text>\"", why: "Page a human and wait for a named one to take it." },
-      ],
-    });
-    break;
-  }
   case "agent": {
     const { run } = await import("./lib/agent.mjs");
     await run(sub, rest);
@@ -472,11 +454,6 @@ switch (cmd) {
     await run(sub, rest);
     break;
   }
-  case "notifications": {
-    const { run } = await import("./lib/notifications.mjs");
-    await run(sub, rest);
-    break;
-  }
   case "webhook-secret": {
     const { run } = await import("./lib/webhook-secret.mjs");
     await run(sub, rest);

package/lib/command-manifest.mjs

@@ -484,28 +484,4 @@ export const COMMAND_MANIFEST = [
 // completeness check against cli.mjs's dispatch switch.
 export const SKIPPED_FAMILIES = {
   "dev": "interactive wrapper that spawns `astro dev`",
-  // RESERVED, not dispatched: every `run402 message …` fails with
-  // COMMAND_REMOVED pointing at `feedback send` / `messages send` /
-  // `escalations raise`. It has no subcommands to manifest because it takes
-  // none — the noun is being held for addressed agent/human messaging.
-  "message": "reserved noun; fails with COMMAND_REMOVED (renamed to `feedback`)",
-  // Split into `deliveries` / `contacts` / `subscriptions`; every subcommand
-  // answers COMMAND_REMOVED naming its successor.
-  "notifications": "reserved group; split by legible-cli-surface",
-};
-
-/**
- * SUBCOMMAND spellings kept alive only to answer `COMMAND_REMOVED`.
- *
- * A retired spelling still needs a `case` branch — that branch IS the redirect,
- * and without it a caller gets a generic "unknown subcommand" instead of being
- * told where the verb went. But it is not a command: it dispatches nothing and
- * belongs in no capability mapping, so the inventory gate must not demand one.
- *
- * The family-level equivalent is SKIPPED_FAMILIES above. This exists because
- * some spellings are retired INSIDE a family rather than as a whole family,
- * which the family list cannot express.
- */
-export const RESERVED_SUBCOMMANDS = {
-  "escalations:contacts": "merged into `contacts` — the ladder and Telegram channels are one question",
 };

package/lib/contacts.mjs

@@ -83,7 +83,7 @@ async function preferences(args) {
   }
 
   if (positionals[0] !== "set") {
-    fail({ code: "BAD_USAGE", message: "Usage: run402 notifications preferences [set <key>=<value> ...]" });
+    fail({ code: "BAD_USAGE", message: "Usage: run402 contacts preferences [set <key>=<value> ...]" });
   }
 
   // SET — parse remaining positional args as key=value
@@ -171,7 +171,7 @@ async function channelsConnect(args) {
   if (positionals.length === 0) {
     fail({
       code: "BAD_USAGE",
-      message: "Usage: run402 notifications channels connect telegram [--label <name>]",
+      message: "Usage: run402 contacts connect telegram [--label <name>]",
     });
   }
   if (positionals[0] !== "telegram") {
@@ -209,7 +209,7 @@ async function channelsConnect(args) {
     return;
   }
   console.error("Timed out waiting for you to tap the link — the connect code has expired.");
-  console.error("Run `run402 notifications channels connect telegram` again for a fresh link.");
+  console.error("Run `run402 contacts connect telegram` again for a fresh link.");
   console.log(JSON.stringify({ ...pending, connected: false, timed_out: true }, null, 2));
   process.exit(1);
 }
@@ -229,7 +229,7 @@ async function channelsRevoke(args) {
   const [bindingId] = requirePositionalCount(a, [], {
     min: 1,
     max: 1,
-    command: "run402 notifications channels revoke <binding_id>",
+    command: "run402 contacts rm <contact_id>",
     missing: "Missing <binding_id>.",
   });
   walletAuthHeaders("/agent/v1/notifications/channels/telegram");
@@ -264,8 +264,8 @@ async function runChannels(args) {
     await channelsRevoke(rest);
     return;
   }
-  failUnknownSubcommand("notifications channels", channelsAction, {
-    hint: "Run `run402 notifications channels --help` for usage.",
+  failUnknownSubcommand("contacts", channelsAction, {
+    hint: "Run `run402 contacts --help` for usage.",
   });
 }
 

package/lib/escalations.mjs

@@ -226,24 +226,6 @@ async function resolveCmd(args) {
   }
 }
 
-async function contacts(args) {
-  // Merged into `run402 contacts` (legible-cli-surface D4): the escalation
-  // ladder and Telegram channels were the same idea — "where a human is
-  // reachable" — under two names, and neither spelling suggested the other
-  // existed. Reserved, not aliased.
-  const [sub] = Array.isArray(args) ? args : [];
-  fail({
-    code: "COMMAND_REMOVED",
-    message: "`run402 escalations contacts` moved to `run402 contacts`.",
-    hint: sub === "remove" ? "run402 contacts rm <contact_id>" : `run402 contacts ${sub ?? "list"}`,
-    details: {
-      was: `escalations contacts${sub ? ` ${sub}` : ""}`,
-      now: "contacts",
-      why: "the paging ladder and Telegram channels are one question — where a human is reachable",
-    },
-  });
-}
-
 export async function run(sub, args) {
   const argv = Array.isArray(args) ? args : [];
   if (!sub || hasHelp([sub, ...argv])) {
@@ -266,15 +248,8 @@ export async function run(sub, args) {
     case "resolve":
       await resolveCmd(argv);
       break;
-    case "contacts":
-      await contacts(argv);
-      break;
     default:
       failUnknownSubcommand("escalations", sub, {
-        // `contacts` is a nested group, so it has no manifest row of its own —
-        // without this it would be missing from the suggestion list a lost
-        // agent reads.
-        extraSubcommands: ["contacts"],
         hint: "Run `run402 escalations --help` for usage.",
       });
   }

package/lib/projects.mjs

@@ -653,31 +653,6 @@ async function current() {
   console.log(JSON.stringify(out, null, 2));
 }
 
-function commandMoved(name) {
-  fail({
-    code: "COMMAND_MOVED",
-    message: `run402 projects ${name} moved to the explicit local credential-cache surface.`,
-    hint: "Use `run402 credentials project-keys status/export --project <project_id>`.",
-    details: {
-      old_command: `projects ${name}`,
-      new_command: name === "keys" ? "credentials project-keys export --reveal" : "credentials project-keys status",
-      source: "local_cache",
-    },
-    next_actions: [
-      {
-        type: "run_command",
-        command: "run402 credentials project-keys status --project <project_id>",
-        why: "Inspect cached key presence without revealing secrets.",
-      },
-      {
-        type: "run_command",
-        command: "run402 credentials project-keys export --project <project_id> --reveal",
-        why: "Reveal cached project keys only when you explicitly need secret material.",
-      },
-    ],
-  });
-}
-
 async function sqlCmd(projectId, args = []) {
   let file = null;
   let query = null;
@@ -970,8 +945,6 @@ export async function run(sub, args) {
     case "rename":    { const { projectId, rest } = resolveProjectSelector(args, { rejectBareFirst: true, valueFlags: FLAGS_BY_SUB.rename.values }); await rename(projectId, rest); break; }
     case "tenant-payments": { const { projectId, rest } = resolveProjectSelector(args, { rejectBareFirst: true, valueFlags: FLAGS_BY_SUB["tenant-payments"].values }); await tenantPayments(projectId, rest); break; }
     case "get":       { const { projectId } = resolveProjectSelector(args, { rejectBareFirst: true }); await get(projectId); break; }
-    case "info":      commandMoved("info"); break;
-    case "keys":      commandMoved("keys"); break;
     case "sql":       { const { projectId, rest } = resolveProjectSelector(args, { maxBarePositionals: 1, valueFlags: FLAGS_BY_SUB.sql.values, rejectBareFirstWhenFlagPresent: ["--file"] }); await sqlCmd(projectId, rest); break; }
     case "rest":      { const { projectId, rest: restArgs } = resolveProjectSelector(args, { valueFlags: FLAGS_BY_SUB.rest.values }); await rest(projectId, restArgs); break; }
     case "usage":     { const { projectId } = resolveProjectSelector(args, { rejectBareFirst: true }); await usage(projectId); break; }

package/lib/subscriptions.mjs

@@ -119,7 +119,7 @@ async function rulesRm(args) {
   const [ruleId] = requirePositionalCount(a, [], {
     min: 1,
     max: 1,
-    command: "run402 notifications rules rm <rule_id>",
+    command: "run402 subscriptions rm <subscription_id>",
     missing: "Missing <rule_id>.",
   });
   walletAuthHeaders("/agent/v1/notifications/rules");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "4.102.0",
+  "version": "4.103.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/vault-surface.json

@@ -1,5 +1,5 @@
 {
-  "surface_version": "4.102.0",
+  "surface_version": "4.103.0",
   "verbs": [
     "repos create",
     "repos list",

package/lib/notifications.mjs

@@ -1,70 +0,0 @@
-/**
- * `run402 notifications` — tombstone dispatcher. Delivery RECORDS and the
- * CONFIGURATION producing them live under separate nouns:
- *
- *   notifications list|get      -> deliveries list|get
- *   notifications channels      -> contacts        (merged with escalations contacts)
- *   notifications rules         -> subscriptions
- *   notifications preferences   -> contacts preferences
- *
- * Reserved, not aliased: each subcommand names its successor so one failed
- * call teaches the new model, where an alias would teach the old one forever.
- */
-import { fail } from "./sdk-errors.mjs";
-import { hasHelp } from "./argparse.mjs";
-
-const MOVED = {
-  list: "deliveries list",
-  get: "deliveries get",
-  channels: "contacts",
-  rules: "subscriptions",
-  preferences: "contacts preferences",
-  test: "contacts preferences",
-};
-
-const HELP = `run402 notifications — SPLIT into three nouns
-
-Usage:
-  run402 deliveries <list|get>          delivery records — did it land
-  run402 contacts <list|add|connect|rm|preferences|test>
-                                        where a human is reachable
-  run402 subscriptions <add|list|rm>    which events go where
-
-The group mixed delivery RECORDS with the CONFIGURATION that produces them.
-Where everything went:
-
-  notifications list|get      ->  run402 deliveries list|get
-  notifications channels      ->  run402 contacts        (merged with the
-                                  escalation paging ladder — one question:
-                                  where is a human reachable)
-  notifications rules         ->  run402 subscriptions
-  notifications preferences   ->  run402 contacts preferences
-  notifications test          ->  run402 contacts test
-
-Run \`run402 deliveries --help\`, \`run402 contacts --help\`, or
-\`run402 subscriptions --help\`.
-`;
-
-export async function run(sub, args) {
-  // `--help` is a QUESTION, and the most useful answer to "help me with
-  // notifications" is where everything moved — not a failure. Actually
-  // invoking a moved subcommand still fails, naming its successor.
-  if (!sub || hasHelp([sub, ...(Array.isArray(args) ? args : [])])) {
-    console.log(HELP);
-    process.exit(0);
-  }
-  const now = MOVED[sub];
-  fail({
-    code: "COMMAND_REMOVED",
-    message: now
-      ? `\`run402 notifications ${sub}\` moved to \`run402 ${now}\`.`
-      : "`run402 notifications` was split into `deliveries`, `contacts` and `subscriptions`.",
-    hint: now ? `run402 ${now}` : "run402 deliveries --help | run402 contacts --help | run402 subscriptions --help",
-    details: {
-      was: `notifications${sub ? ` ${sub}` : ""}`,
-      now: now ?? null,
-      why: "the group mixed delivery RECORDS with the CONFIGURATION that produces them",
-      moved: MOVED,
-    },
-  });
-}