@myapihq/cli 2.16.1 → 2.16.2

package/dist/commands/account.d.ts

@@ -5,6 +5,7 @@ export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
 export declare const HELP = "Usage: myapi account <subcommand>\n\nSubcommands:\n  api-keys        Manage API keys \u00B7 list / create / revoke\n  config          Manage CLI defaults (org, funnel, domain) \u00B7 supports set-org / set-funnel / set-domain\n  import-key      Import an existing API key non-interactively\n  install-skills  DEPRECATED \u2014 use `myapi install-skills` instead\n  keys            Alias for api-keys\n  link [email]    Upgrade anonymous account to registered (or add a second session)\n                  Use myapi account setup to create a completely new account\n  login           Sign in via your browser \u2014 Google or email code (preview: --mock)\n  mailing-address Get or set the account's mailing address (CAN-SPAM)\n  registrant      Manage stored WHOIS contact info for domain registration \u00B7 set / get / clear\n  setup           Configure your account\n  switch [index]  Switch active account by index or email\n  whoami          Show current account \u00B7 supports --json";
 export declare const INSTALL_SKILLS_HELP = "Usage: myapi install-skills\n\nInstalls the MyAPI skills pack for AI coding agents (Claude, Codex, Gemini, \u2026).\n\nThis command writes skill definition files to:\n  ~/.agents/skills/myapi/\n\nAnd creates symlinks in the appropriate agent config directories:\n  ~/.claude/  (Claude)\n  ~/.gemini/  (Gemini)\n  ~/.cursor/  (Cursor, if detected)\n\nThese files teach agents how to use the MyAPI CLI and API directly.\nRun this command again to update existing skills to the latest version.\n\nNote: `myapi account install-skills` is deprecated and will be removed in the next minor.\nUse `myapi install-skills` going forward.";
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function link(flags?: Flags, emailArg?: string): Promise<void>;
 export declare function whoami(flags?: Flags): Promise<void>;
 export declare function switchCmd(flags?: Flags, indexArg?: string): Promise<void>;

package/dist/commands/account.js

@@ -115,7 +115,7 @@ Subcommands:
   get       Print the stored registrant (or "not set").
   set       Interactive prompt for all fields. Or pass --registrant-json
             '<json>' to set non-interactively (agent-friendly).`;
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'mailing-address': `myapi account mailing-address                       Show current value (null if unset)
 myapi account mailing-address "<address>"            Set the mailing address
 

package/dist/commands/audience.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/audience.js

@@ -169,7 +169,7 @@ async function refresh(id, flags) {
     const sign = res.delta > 0 ? '+' : '';
     success(`Refreshed. ${res.previous} → ${res.total} (${sign}${res.delta})`);
 }
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': `myapi audience create <name> --from <people|company> --filter <json> [--description <text>] [--org <id>]
 
 The Goldfox filter shape is shared across people/company/audience:

package/dist/commands/authproduct.d.ts

@@ -3,5 +3,6 @@ import { type Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const SCHEMA: FlagSchema;
 export declare const EXPOSES: Exposes;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare const HELP = "Usage: myapi auth <subcommand>\n\nAuthentication for your app's end users \u2014 a managed OIDC identity provider\n(\u00E0 la Kinde/Auth0). One auth tenant per org; register OIDC clients (apps)\nagainst it; sign users in via the hosted login page or the JS SDK; verify\ntokens locally against the tenant JWKS.\n\nEnd users sign in with managed Google, email/password, or magic links \u2014 pick\nwhich via `tenant create --connections`. (Operator/account commands moved to\n`myapi account`.)\n\nSubcommands:\n  client   Register, list, delete, and rotate OIDC clients (your apps)\n  domain   Serve auth on your own domain (auth.acme.com)\n  tenant   Show or create your org's OIDC auth tenant (+ sign-in methods)\n  usage    Monthly active users (MAU) for the current period";
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/authproduct.js

@@ -29,7 +29,7 @@ export const EXPOSES = [
     'POST /auth/orgs/{org_id}/domain/verify',
     'DELETE /auth/orgs/{org_id}/domain',
 ];
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'tenant': `myapi auth tenant [show|create] [--connections <list>] [--theme <json>] [--org <id>] [--json]
 
 Your org's OIDC auth tenant — the identity provider your app's end users sign

package/dist/commands/billing.d.ts

@@ -4,6 +4,7 @@ import type { Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const SCHEMA: FlagSchema;
 export declare const EXPOSES: Exposes;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;
 export declare function balance(flags: Flags): Promise<void>;
 export declare function history(flags: Flags): Promise<void>;

package/dist/commands/billing.js

@@ -21,7 +21,7 @@ export const EXPOSES = [
     'PUT /hq/billing/auto-recharge',
     'DELETE /hq/billing/auto-recharge',
 ];
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'auto-recharge': `myapi billing auto-recharge [show | set | disable]
 
 Keep the prepaid wallet funded without a human in the loop: when the balance

package/dist/commands/company.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/company.js

@@ -97,7 +97,7 @@ async function get(companyId, flags) {
     const res = await sdkCompany.getCompany(config.api_key, orgId, companyId, includePeople);
     printJson(res);
 }
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'search': `myapi company search [--confidence <csv>] [--country <csv>] [--country-consistent]
        [--tld-class <csv>] [--has-c-level] [--has-careers-page]
        [--has-decision-maker] [--has-investors-page] [--has-shop-page]

package/dist/commands/container.d.ts

@@ -21,4 +21,5 @@ export declare function rollback(id: string, flags: Flags): Promise<void>;
 export declare function logs(id: string, flags: Flags): Promise<void>;
 export declare function domain(id: string, domainArg: string | undefined, flags: Flags): Promise<void>;
 export declare function buildLogs(id: string | undefined, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/container.js

@@ -570,7 +570,7 @@ export async function buildLogs(id, flags) {
         info(l);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': `myapi container create --name <name> [--type service|worker|job] [--cron <expr>]
                        [--cpu <n>] [--memory <size>] [--min-instances <n>]
                        [--max-instances <n>] [--port <n>] [--env K=V,...] [--org <id>]

package/dist/commands/crm/companies.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../../helpers.js';
 import type { Exposes } from '../../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/crm/companies.js

@@ -142,7 +142,7 @@ async function promote(domain, flags) {
     success(`Promoted ${c.domain} → ${c.id}`);
 }
 // ── Dispatcher ──────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     list: 'myapi crm companies list [--limit N] [--offset N] [--org <id>] [--json]',
     search: `myapi crm companies search [--stage <csv>] [--origin <csv>] [--domain <d>]
        [--include-deleted] [--limit N] [--offset N] [--org <id>] [--json]

package/dist/commands/crm/contacts.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../../helpers.js';
 import type { Exposes } from '../../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/crm/contacts.js

@@ -177,7 +177,7 @@ async function events(id, flags) {
         info(`\n— More — pass --cursor "${res.next_cursor}" to continue`);
 }
 // ── Dispatcher ──────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     list: 'myapi crm contacts list [--limit N] [--offset N] [--org <id>] [--json]',
     search: `myapi crm contacts search [--stage <csv>] [--origin <csv>] [--email <e>]
        [--company-id <id>] [--min-last-engagement-days N] [--max-last-engagement-days N]

package/dist/commands/database.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/database.js

@@ -192,7 +192,7 @@ async function keyDel(key, flags) {
     }
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'namespaces': 'myapi database namespaces [--org <id>] [--json]',
     'create': 'myapi database create <name> [--org <id>]',
     'delete-namespace': `myapi database delete-namespace <name> [--org <id>]

package/dist/commands/domain.d.ts

@@ -30,4 +30,5 @@ export declare function retryProvisioning(domainArg: string, flags: Flags): Prom
 export declare function mailServerResync(domainArg: string, flags: Flags): Promise<void>;
 export declare function settings(domainArg: string, flags: Flags): Promise<void>;
 export declare function updateSettings(domainArg: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/domain.js

@@ -568,7 +568,7 @@ async function recordsRun(sub, args, flags) {
     }
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'list': `myapi domain list [--filter=all|unassigned|org] [--org <id>] [--json]
 
   --filter=all         All domains owned by the account.

package/dist/commands/feedback.d.ts

@@ -8,4 +8,5 @@ export declare function create(bodyArg: string | undefined, flags: Flags): Promi
 export declare function resolve(id: string, flags: Flags): Promise<void>;
 export declare function del(id: string | undefined, flags: Flags): Promise<void>;
 export declare function widget(sub: string | undefined, arg: string | undefined, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/feedback.js

@@ -284,7 +284,7 @@ export async function widget(sub, arg, flags) {
     }
     error('Usage: myapi feedback widget create <name> [--origins <list>]\n       myapi feedback widget list\n       myapi feedback widget update <id> [--routes <list>] [--origins <list>]\n       myapi feedback widget revoke <id>');
 }
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'delete': `myapi feedback delete <id> [--yes] [--org <id>]
 
 Erases an item. \`resolve\` closes one and keeps it; this removes it — for spam,

package/dist/commands/fn.d.ts

@@ -15,4 +15,5 @@ export declare function _parseSetPairs(raw: string | string[]): Record<string, s
 export declare function scopes(id: string | undefined, flags: Flags): Promise<void>;
 export declare function setEnv(id: string, name: string, value: string, flags: Flags): Promise<void>;
 export declare function runs(id: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/fn.js

@@ -320,7 +320,7 @@ export async function runs(id, flags) {
     });
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': `myapi fn create --name <name> [--cron <expr>] [--scope <slot>[,<slot>...]] [--org <id>]
 
 Persists a function record + issues a scoped API key. Deploy code separately

package/dist/commands/funnel.d.ts

@@ -24,4 +24,5 @@ export declare function push(slug: string, flags: Flags): Promise<void>;
 export declare function formCmd(funnelArg: string | undefined, flags: Flags): Promise<void>;
 export declare function verify(slug: string, flags: Flags): Promise<void>;
 export declare function publish(dir: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/funnel.js

@@ -614,7 +614,7 @@ Publishing to the prod channel replaces the entire live site.
     info(`Live:   ${result.published_url}`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': 'myapi funnel create [--name <name>] [--org <id>]',
     'delete': 'myapi funnel delete <id> [--org <id>]',
     'form': `myapi funnel form [funnel-id] [--slug <slug>] [--fields <spec>]

package/dist/commands/git.d.ts

@@ -19,4 +19,5 @@ export declare function deleteBranch(repo: string, branch: string, flags: Flags)
 export declare function tag(repo: string, name: string, flags: Flags): Promise<void>;
 export declare function merge(repo: string, flags: Flags): Promise<void>;
 export declare function repack(repo: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/git.js

@@ -345,7 +345,7 @@ export async function repack(repo, flags) {
     info(`Packs: ${res.packs_before} → ${res.packs_after}  ·  ${res.objects} objects`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': 'myapi git create <name> [--default-branch <b>] [--org <id>]',
     'list': 'myapi git list [--org <id>] [--json]',
     'get': 'myapi git get <repo> [--org <id>] [--json]',

package/dist/commands/image.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/image.js

@@ -153,7 +153,7 @@ async function models(flags) {
     })), { flags, empty: 'No image models available.' });
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'list': 'myapi image list [--org <id>] [--json]',
     'generate': `myapi image generate <prompt> [--model <id>] [--ratio 1:1|16:9|9:16|4:3|3:4] [--style <s>] [--colors <hex,hex>] [--text] [--org <id>]
        myapi image generate --prompt "<text>" ...

package/dist/commands/llm.d.ts

@@ -4,4 +4,5 @@ import type { Exposes } from '../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
 export declare function _parseJsonObjectFlag(raw: unknown, flagName: string): Record<string, unknown> | undefined;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/llm.js

@@ -314,7 +314,7 @@ async function draft(inputArg, flags) {
     printVerbFooter(res.usage);
 }
 // ── help ─────────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     complete: `myapi llm complete "<prompt>" [--model <id>]
        [--system "<system msg>"] [--max-tokens N] [--temperature 0..1]
        [--stop <csv>] [--file <path>] [--org <id>] [--json]

package/dist/commands/manifest.d.ts

@@ -0,0 +1,17 @@
+import type { Exposes } from '../exposes.js';
+export declare const EXPOSES: Exposes;
+export interface CommandPath {
+    /** Space-joined path after the binary, e.g. "email mailbox create". */
+    path: string;
+    /** The command's own usage line, when it publishes one. */
+    usage?: string;
+}
+export interface Manifest {
+    binary: string;
+    version: string;
+    paths: CommandPath[];
+    /** Disagreements between the two sources. Non-empty means this file lies. */
+    warnings: string[];
+}
+export declare function buildManifest(version: string): Promise<Manifest>;
+export declare function run(version: string, flags: Record<string, unknown>): Promise<void>;

package/dist/commands/manifest.js

@@ -0,0 +1,149 @@
+// `myapi __commands` — the CLI's own list of what it can be asked to do.
+//
+// WHY THIS EXISTS
+//
+// myapihq.com, mydomainapi.com and myemailapi.com each spent months telling
+// visitors to install an npm package that 404s (`myapihq`, `mydomainapi`,
+// `myemailapi`) and to run a binary that has never existed (`myapihq login`;
+// it is `myapi`). Every command on those pages was unrunnable. Nothing
+// noticed, because the pages live in a different repo from the CLI and
+// nothing connected the two.
+//
+// A checker in that repo needs one thing: an authoritative answer to "is
+// `myapi domain records list` a real command?". The obvious way to get it —
+// run `myapi <path> --help` and look for an error — does not work:
+//
+//   $ myapi domain bogus --help          # exit 0, "Unknown subcommand"
+//   $ myapi domain records bogus --help  # exit 0, prints the records help
+//
+// Exit codes do not distinguish, and at depth three the help text does not
+// either. A probe-based checker would pass on a typo and report success,
+// which is the failure this whole exercise is about. So the CLI states its
+// command list outright, in a form another program can read.
+//
+// The output is a flat list of paths on purpose: a checker asks "does this
+// string start with a known path", which is a set lookup, not a tree walk.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { COMMANDS, SUBCOMMANDS } from '../completion.js';
+// Reads the CLI's own dist directory and nothing else — no network, no auth.
+// That is what lets the site checker run it against the published package
+// without credentials.
+export const EXPOSES = [];
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+// Modules whose filename is not the command that reaches them. Anything else
+// unmapped becomes a warning rather than being dropped — a command silently
+// missing from this list would make the checker reject a valid command, and
+// "your marketing page is wrong" is an expensive thing to be wrong about.
+const MODULE_ALIAS = {
+    authproduct: 'auth',
+};
+// Commands implemented inline in index.ts, with no module of their own.
+const INLINE = new Set(['completion', 'help', 'install-skills', 'whoami', 'login', 'setup', 'status', 'update', 'doctor']);
+async function usageMapFor(file) {
+    const mod = await import(pathToFileURL(file).href).catch(() => null);
+    const usage = mod?.SUBCOMMAND_USAGE;
+    return usage && typeof usage === 'object' ? usage : null;
+}
+// Shipped code runs from dist/ (.js); the test suite runs the sources (.ts).
+// Matching only .js made the enrichment pass find nothing under vitest and
+// return a manifest with every path present and not one usage string — no
+// error, no warning, just quietly less than it claimed.
+const MODULE_RE = /\.(js|ts)$/;
+const isModule = (name) => MODULE_RE.test(name) && !name.endsWith('.test.js') && !name.endsWith('.test.ts') && !name.endsWith('.d.ts');
+export async function buildManifest(version) {
+    const paths = [];
+    const warnings = [];
+    const seen = new Set();
+    const byPath = new Map();
+    const add = (p, usage) => {
+        const existing = byPath.get(p);
+        if (existing) {
+            // The completion tables are walked first and carry no usage strings, so
+            // a plain `return` here would mean every usage string is silently
+            // dropped — the manifest still looked complete, which is the exact
+            // shape of bug this file exists to prevent.
+            if (usage && !existing.usage)
+                existing.usage = usage;
+            return;
+        }
+        seen.add(p);
+        const entry = usage ? { path: p, usage } : { path: p };
+        byPath.set(p, entry);
+        paths.push(entry);
+    };
+    // Spine: the completion tables. They are the one place that already had to
+    // enumerate every command, and a smoke test fails if `myapi --help` lists a
+    // top-level command they omit.
+    for (const cmd of COMMANDS)
+        add(cmd);
+    for (const [cmd, subs] of Object.entries(SUBCOMMANDS)) {
+        if (!COMMANDS.includes(cmd))
+            warnings.push(`SUBCOMMANDS has "${cmd}", which is not in COMMANDS`);
+        for (const sub of subs)
+            add(`${cmd} ${sub}`);
+    }
+    // Enrichment: usage strings, and the third level. `email mailbox create` is
+    // real and the completion tables stop one level above it.
+    for (const entry of fs.readdirSync(HERE, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            const ns = entry.name;
+            if (!COMMANDS.includes(ns)) {
+                warnings.push(`command directory "${ns}" is not in COMMANDS`);
+                continue;
+            }
+            for (const f of fs.readdirSync(path.join(HERE, ns))) {
+                if (!isModule(f))
+                    continue;
+                const group = f.replace(MODULE_RE, '');
+                const usage = await usageMapFor(path.join(HERE, ns, f));
+                if (!usage)
+                    continue;
+                if (group === 'index') {
+                    for (const [sub, u] of Object.entries(usage))
+                        add(`${ns} ${sub}`, u);
+                }
+                else {
+                    add(`${ns} ${group}`);
+                    for (const [sub, u] of Object.entries(usage))
+                        add(`${ns} ${group} ${sub}`, u);
+                }
+            }
+            continue;
+        }
+        if (!isModule(entry.name))
+            continue;
+        const base = entry.name.replace(MODULE_RE, '');
+        const cmd = MODULE_ALIAS[base] ?? base;
+        const usage = await usageMapFor(path.join(HERE, entry.name));
+        if (!usage)
+            continue;
+        if (!COMMANDS.includes(cmd)) {
+            // Not fatal: `verify.js` backs `email verify`, not a top-level command.
+            if (!INLINE.has(cmd))
+                warnings.push(`module "${base}.js" publishes subcommands but "${cmd}" is not a top-level command`);
+            continue;
+        }
+        for (const [sub, u] of Object.entries(usage))
+            add(`${cmd} ${sub}`, u);
+    }
+    // The spine alone always yields a plausible-looking manifest, so "the
+    // enrichment pass found nothing" is invisible unless it is stated. It means
+    // the walk is looking in the wrong place — and a checker trusting a manifest
+    // that is quietly missing a level will call correct copy wrong.
+    if (!paths.some(p => p.usage)) {
+        warnings.push(`no command modules found under ${HERE} — the manifest covers only the completion tables`);
+    }
+    paths.sort((a, b) => a.path.localeCompare(b.path));
+    return { binary: 'myapi', version, paths, warnings };
+}
+export async function run(version, flags) {
+    const manifest = await buildManifest(version);
+    if (flags.json === false) {
+        for (const p of manifest.paths)
+            console.log(p.path);
+        return;
+    }
+    console.log(JSON.stringify(manifest, null, 2));
+}

package/dist/commands/manifest.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/manifest.test.js

@@ -0,0 +1,60 @@
+// The manifest is consumed by a checker in another repo (myapi-hq) that
+// decides whether the marketing sites advertise commands that exist. Two ways
+// it can do harm, and a test for each:
+//
+//   - claiming a real command is unknown → CI fails on correct copy, and the
+//     next person deletes the check rather than debug it;
+//   - claiming an unknown command is real → the thing it was built to catch
+//     walks straight past it, which is how three domains spent months telling
+//     visitors to run `myapihq login`.
+import { describe, it, expect } from 'vitest';
+import { buildManifest } from './manifest.js';
+import { COMMANDS, SUBCOMMANDS } from '../completion.js';
+const manifest = await buildManifest('0.0.0-test');
+const paths = new Set(manifest.paths.map(p => p.path));
+describe('command manifest', () => {
+    it('reports no disagreement between its two sources', () => {
+        // Non-empty warnings mean the completion tables and the command modules
+        // describe different CLIs, so neither can be trusted to answer "is this
+        // real". Surfacing that is the point; passing anyway would not be.
+        expect(manifest.warnings).toEqual([]);
+    });
+    it('contains every top-level command and every completion subcommand', () => {
+        for (const c of COMMANDS)
+            expect(paths, `missing top-level "${c}"`).toContain(c);
+        for (const [cmd, subs] of Object.entries(SUBCOMMANDS)) {
+            for (const sub of subs)
+                expect(paths, `missing "${cmd} ${sub}"`).toContain(`${cmd} ${sub}`);
+        }
+    });
+    it('contains the commands the public sites advertise', () => {
+        // Verbatim from myapi-hq/frontend/configs/{myapihq,mydomainapi,myemailapi}.com.json.
+        // If a rename drops one of these, the site is wrong the moment it ships and
+        // this is where that gets said.
+        for (const p of [
+            'account setup', 'install-skills', 'status', 'keys create',
+            'domain check', 'domain register', 'domain import', 'domain list', 'domain records',
+            'email mailbox', 'email message', 'email verify', 'billing balance',
+        ]) {
+            expect(paths, `site advertises "myapi ${p}"`).toContain(p);
+        }
+    });
+    it('does not invent commands', () => {
+        for (const bogus of ['bogus', 'domain bogus', 'email bogus', 'myapihq login']) {
+            expect(paths).not.toContain(bogus);
+        }
+    });
+    it('attaches usage strings, not just paths', () => {
+        // Regression guard. The completion tables are walked first and carry no
+        // usage; an early `return` on an already-seen path silently dropped every
+        // usage string while the manifest still looked complete. Assert on a
+        // command that only the module registry can describe.
+        const withUsage = manifest.paths.filter(p => p.usage);
+        expect(withUsage.length).toBeGreaterThan(100);
+        const del = manifest.paths.find(p => p.path === 'queue delete');
+        expect(del?.usage).toContain('myapi queue delete');
+    });
+    it('states the binary name the sites must use', () => {
+        expect(manifest.binary).toBe('myapi');
+    });
+});

package/dist/commands/org.d.ts

@@ -9,4 +9,5 @@ export declare function get(id: string, flags: Flags): Promise<void>;
 export declare function del(id: string, flags: Flags): Promise<void>;
 export declare function update(restArgs: string[], flags: Flags): Promise<void>;
 export declare function importOrg(args: string[], flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/org.js

@@ -192,7 +192,7 @@ export async function importOrg(args, flags) {
     success(`Import complete! Org ID: ${org.id}`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'list': 'myapi org list [--json]',
     'update': `myapi org update [<id>] [--name <str>] [--tagline <str>] [--description <str>] [--business-sector <str>] [--logo-url <url>] [--json]
 

package/dist/commands/payments.d.ts

@@ -10,4 +10,5 @@ export declare function charge(flags: Flags): Promise<void>;
 export declare function list(flags: Flags): Promise<void>;
 export declare function get(id: string, flags: Flags): Promise<void>;
 export declare function refund(id: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/payments.js

@@ -173,7 +173,7 @@ export async function refund(id, flags) {
     success(`Charge ${res.id} refunded (status: ${res.status}).`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'connect': `myapi payments connect --stripe-key <sk_...> [--org <id>]
 
 Links your own Stripe account (T0 — bring-your-own-Stripe). The key is

package/dist/commands/people.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/people.js

@@ -83,7 +83,7 @@ async function get(personId, flags) {
     const res = await sdkPeople.getPerson(config.api_key, orgId, personId);
     printJson(res);
 }
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'search': `myapi people search [--confidence <csv>] [--country <csv>] [--country-consistent]
        [--email-type <csv>] [--seniority <csv>] [--tld-class <csv>]
        [--has-c-level] [--has-careers-page] [--has-decision-maker]

package/dist/commands/pixel.d.ts

@@ -8,5 +8,6 @@ export declare function visits(flags: Flags): Promise<void>;
 export declare function events(flags: Flags): Promise<void>;
 export declare function audience(flags: Flags): Promise<void>;
 export declare function identity(pixelId: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function identify(pixelId: string | undefined, flags: Flags): Promise<void>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/pixel.js

@@ -152,7 +152,7 @@ export async function identity(pixelId, flags) {
     printJson(res);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'interactions': 'myapi pixel interactions [--website <domain>] [--campaign-id <id>] [--domain <domain>] [--from <iso8601>] [--to <iso8601>] [--limit <num>] [--offset <num>] [--org <id>] [--json]',
     'visits': 'myapi pixel visits --website <domain> [--from <iso8601>] [--to <iso8601>] [--limit <num>] [--offset <num>] [--org <id>] [--json]',
     'events': 'myapi pixel events [--campaign-id <id>] [--domain <domain>] [--from <iso8601>] [--to <iso8601>] [--limit <num>] [--offset <num>] [--org <id>] [--json]',

package/dist/commands/queue.d.ts

@@ -12,4 +12,5 @@ export declare function enqueue(name: string, flags: Flags, extraArgs?: string[]
 export declare function jobs(name: string, flags: Flags): Promise<void>;
 export declare function job(jobId: string, flags: Flags): Promise<void>;
 export declare function del(name: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/queue.js

@@ -187,7 +187,7 @@ export async function del(name, flags) {
     success(`Deleted queue: ${name} (org ${orgId})`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': 'myapi queue create <name> --consumer-url <url> [--max-attempts <n>] [--max-concurrency <n>] [--org <id>]',
     'list': 'myapi queue list [--org <id>] [--json]',
     'get': 'myapi queue get <name> [--org <id>] [--json]',

package/dist/commands/storage.d.ts

@@ -3,4 +3,5 @@ import { type Flags } from '../helpers.js';
 import type { Exposes } from '../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/storage.js

@@ -238,7 +238,7 @@ async function del(id, flags) {
     success(`Asset ${id} deleted`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'list': 'myapi storage list [--org <id>] [--json]',
     'ingest': `myapi storage ingest <url> [--name <name>] [--org <id>]
 

package/dist/commands/task.d.ts

@@ -15,4 +15,5 @@ export declare function extend(id: string, flags: Flags): Promise<void>;
 export declare function resolve(id: string, flags: Flags): Promise<void>;
 export declare function fail(id: string, flags: Flags): Promise<void>;
 export declare function cancel(id: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/task.js

@@ -242,7 +242,7 @@ export async function cancel(id, flags) {
     success(`Cancelled task ${id}`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': 'myapi task create "<description>" [--body <md|@file>] [--importance <i>] [--due <rfc3339>] [--assignee <email>] [--tag <t,t>] [--depends-on <id,id>] [--dedup-key <k>] [--resolve-on <event[:field=value]>] [--origin <s>] [--org <id>]',
     'list': 'myapi task list [--status <s>] [--tag <t>] [--importance <i>] [--assignee <email>] [--origin <s>] [--limit <n>] [--org <id>] [--json]',
     'get': 'myapi task get <id> [--body] [--org <id>] [--json]\n\n--body additionally fetches the Markdown body tier (a separate read).',

package/dist/commands/url.d.ts

@@ -4,4 +4,5 @@ import type { FlagSchema } from '../flags.js';
 export declare const SCHEMA: FlagSchema;
 export declare const EXPOSES: Exposes;
 export declare function shorten(targetUrl: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/url.js

@@ -19,7 +19,7 @@ export async function shorten(targetUrl, flags) {
         success(`Shortened URL: ${res.short_url}\nCode: ${res.short_code}`);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'shorten': 'myapi url shorten <url> [--org <id>] [--json]',
 };
 export async function run(subcommand, args, flags) {

package/dist/commands/webhook.d.ts

@@ -10,4 +10,5 @@ export declare function _validateForwardUrl(url: string): string | null;
 export declare function del(id: string, flags: Flags): Promise<void>;
 export declare function delivery(id: string, flags: Flags): Promise<void>;
 export declare function deliveries(endpointArg: string | undefined, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/webhook.js

@@ -192,7 +192,7 @@ function summarizePayload(payload) {
     return entries.length > 3 ? `${shown} +${entries.length - 3}` : shown;
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'list': 'myapi webhook list [--org <id>] [--json]',
     'create': `myapi webhook create <name> [--description <desc>] [--crm-email-path <path>] [--org <id>]
        myapi webhook create --name <name> [...]

package/dist/commands/workflow.d.ts

@@ -13,4 +13,5 @@ export declare function disable(id: string, flags: Flags): Promise<void>;
 export declare function del(id: string, flags: Flags): Promise<void>;
 export declare function runs(id: string, flags: Flags): Promise<void>;
 export declare function getRun(runId: string, flags: Flags): Promise<void>;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/workflow.js

@@ -313,7 +313,7 @@ export async function getRun(runId, flags) {
     printJson(run);
 }
 // ── Dispatcher ───────────────────────────────────────────────────────────────
-const SUBCOMMAND_USAGE = {
+export const SUBCOMMAND_USAGE = {
     'list': 'myapi workflow list [--org <id>] [--json]',
     'get': 'myapi workflow get <id> [--org <id>]',
     'create': `myapi workflow create <name> --endpoint-id <id> --steps <json> [--no-enable] [--org <id>]

package/dist/exposes.test.js

@@ -26,6 +26,7 @@ const COMMAND_MODULES = [
     './commands/image.js',
     './commands/keys.js',
     './commands/llm.js',
+    './commands/manifest.js',
     './commands/org.js',
     './commands/pixel.js',
     './commands/audience.js',

package/dist/index.js

@@ -194,6 +194,14 @@ async function main() {
     await adoptSoleOrg(command, flags, key => hq.listOrgs(key));
     try {
         switch (command) {
+            // Machine-readable command list. Deliberately absent from --help and
+            // from completion: it is an interface for other programs (the site-copy
+            // checker in myapi-hq), not a thing to teach a person.
+            case '__commands': {
+                const manifestCmd = await import('./commands/manifest.js');
+                await manifestCmd.run(pkg.version, flags);
+                break;
+            }
             case 'auth':
                 // `auth` is the end-user auth product (my-auth-api). Operator/account
                 // commands live under `myapi account`.

package/dist/skills/my-domain-api/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: my-domain-api
-version: 1.0.0
+version: 1.0.1
 description: >
   Register new domains and manage edge settings. Required before a funnel can go live on a custom URL.
 triggers: [domain, register domain, dns, custom domain, edge, cdn, security level, browser check, renew, namecheap]
-checksum: sha256-ffe00d434534f444320a3e84323e87168c0c5797445fa0f39eeb55ad8278f721
+checksum: sha256-b08b28804b6e3ab69cc5b75c39e5b22312aa40474dcf53e3bc71fd6db8491d22
 ---
 
 # MyDomainAPI
@@ -56,6 +56,7 @@ Resolution at register time (highest wins): `--registrant-json` → per-field fl
 | `myapi domain status <domain> [--watch]` | Registration + DNS propagation status. `--watch` polls until terminal (10s × 30 → 30s × 60) |
 | `myapi domain settings <domain>` | View edge/CDN settings |
 | `myapi domain update-settings <domain>` | Change security level, browser check, purge cache |
+| `myapi domain mail-server-resync <domain>` | Re-run mail-server provisioning when inbox/create is broken on a domain |
 | `myapi domain records list <domain> [--type T]` | List DNS records in the zone |
 | `myapi domain records get <domain> <id>` | Fetch one record |
 | `myapi domain records create <domain> --type T --name n --content c` | Create a record (priority required for MX) |

package/dist/skills/my-image-api/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: my-image-api
-version: 1.0.0
+version: 1.0.1
 description: >
   Generate AI images from a text prompt. Async — submit a prompt, the CLI polls until the image is ready, then returns a public CDN URL. Image lands automatically in your org's storage.
 triggers: [image, generate image, ai image, hero image, logo, illustration, watercolor, prompt, cyberpunk, ratio, aspect ratio]
-checksum: sha256-c12686cd9f53f18dbc692c3aca9391409cc1540b693b6f2059074e02bafff72c
+checksum: sha256-08b7b7e6deb6a5c6ff4ec149561470b54a4bad02a914455a41c270dfceca7a2e
 ---
 
 # MyImageAPI
@@ -27,6 +27,7 @@ The output URL is public — anyone with it can view. Don't generate sensitive c
 | `myapi image generate <prompt>` | Async generate, polls up to 90s, returns id + URL |
 | `myapi image list` | List all generated images for the org |
 | `myapi image get <job_id>` | Get full job details (status, URL, prompt, ratio) |
+| `myapi image get-url <job_id>` | Print just the asset URL — for piping into another command |
 | `myapi image models` | List available image models with per-image pricing |
 | `myapi image delete <job_id>` | Delete the asset (job record kept for history) |
 

package/dist/skills/my-queue-api/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: my-queue-api
-version: 1.0.0
+version: 1.0.1
 description: >
   Durable job queue — enqueue work and have it retried against your HTTP consumer, with concurrency caps and a dependency DAG.
 triggers: [queue, job queue, background job, enqueue, retry, async work, dead letter, delayed job, concurrency]
-checksum: sha256-e3079f05a9f0b6eb1860749e42a3feea3cc4f18997b8bd6a0d5ff892e29bc628
+checksum: sha256-ad874e1229df9381fc92881b2a1fada40859983c24fe4386d43922398323b05c
 ---
 
 # MyQueueAPI
@@ -39,6 +39,7 @@ A job carries an arbitrary JSON `payload` (≤256 KB). Jobs support:
 | `myapi queue create <name> --consumer-url <url> [--max-attempts <n>] [--max-concurrency <n>]` | Create a queue |
 | `myapi queue list` | List queues in your org |
 | `myapi queue get <name>` | Show a queue's retry/concurrency policy |
+| `myapi queue delete <name>` | Delete a queue |
 | `myapi queue enqueue <name> --payload <json> [--dedup-key <k>] [--delay <s>] [--depends-on <id,id>]` | Enqueue a job |
 | `myapi queue jobs <name> [--status <s>] [--limit <n>]` | List a queue's jobs |
 | `myapi queue job <job_id>` | Show a single job's status |

package/dist/skills/my-webhook-api/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: my-webhook-api
-version: 1.0.0
+version: 1.0.1
 description: >
   Inbound webhook endpoints for non-funnel sources — Stripe, GitHub, custom services. Funnel forms use the my-funnel-api proxy.
 triggers: [webhook, inbound, receiver, stripe events, github webhook, slack notification, delivery, payload, event ingest]
-checksum: sha256-82459af69db91d535209978c09e011f5b893ba0f04f90d8b6a658058e0dc2374
+checksum: sha256-737e0572ef7c414dab568e60af676aa8e50900ed368ba7bcdf81fc65516be9eb
 ---
 
 # MyWebhookAPI
@@ -31,6 +31,7 @@ Treat the webhook slug as a secret — anyone with the URL can POST.
 |---|---|
 | `myapi webhook create "<name>" [--description "..."]` | Create an endpoint, returns id + inbound URL |
 | `myapi webhook list` | List all endpoints in your org |
+| `myapi webhook update <id> [--name <n>] [--description <d>]` | Change an endpoint in place, without re-creating it |
 | `myapi webhook delete <id>` | Delete an endpoint and all its deliveries |
 | `myapi webhook deliveries [endpoint_id]` | List what came in, newest first (`--limit`, `--cursor`) |
 | `myapi webhook delivery <delivery_id>` | Get the full payload + headers for one delivery |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/cli",
   "license": "Apache-2.0",
-  "version": "2.16.1",
+  "version": "2.16.2",
   "description": "MyAPI command-line interface",
   "repository": {
     "type": "git",
@@ -46,7 +46,7 @@
     "lint:skills:strict": "node scripts/copy-skills.js && node scripts/lint-skills.js --strict"
   },
   "dependencies": {
-    "@myapihq/sdk": "^2.16.1"
+    "@myapihq/sdk": "^2.16.2"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",