@spec0/cli 0.1.0

package/dist/commands/publish.js

@@ -0,0 +1,242 @@
+/**
+ * spec0 publish — publish an OpenAPI spec to the public API registry.
+ *
+ * Unlike `spec0 register` (which is team-scoped and private), `publish` creates
+ * org-scoped public APIs accessible via a shareable URL with no authentication.
+ *
+ * URL convention: {platform}/public/registry/{org-slug}/{api-slug}
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { existsSync, readFileSync } from "fs";
+import { runSpectral } from "../lib/lint.js";
+import { formatLintText, formatGitHubAnnotation } from "../lib/output.js";
+import { createOrgApiClient, is401, is402 } from "../lib/api-client.js";
+import { requireOrgContext } from "../lib/auth-context.js";
+import { ExitCode, exit, exitCodeForHttpStatus } from "../lib/exit-codes.js";
+import { resolveCliSpecPathFromFlags } from "../lib/cli-spec-path.js";
+import { resolvedPlatformApiUrl } from "../lib/platform-defaults.js";
+const API_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+function toSlug(input) {
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function publishUsageExamples() {
+    return [
+        "Examples:",
+        "  spec0 publish --spec-file ./openapi.yaml --name payments-api --version v1.0.0",
+        "  spec0 publish ./openapi.yaml --name payments-api --version v1.0.0 --visibility published",
+        "  spec0 publish --spec-file ./openapi.yaml --public-api-id <uuid> --version v1.1.0",
+        "  spec0 publish ./openapi.yaml --version v1.0.0  # slug inferred from spec info.title",
+    ].join("\n");
+}
+function formatPublishPublicText(output) {
+    const lines = [];
+    lines.push(chalk.green("Published!"));
+    lines.push(`  Public URL:  ${output.apiUrl}${output.publicUrl}`);
+    lines.push(`  Version:     ${output.version}`);
+    lines.push(`  Visibility:  ${output.visibility}`);
+    lines.push(`  API ID:      ${output.publicApiId}`);
+    return lines.join("\n");
+}
+export function registerPublishCommand(program) {
+    program
+        .command("publish")
+        .description("Publish an API spec to the public registry (org-scoped, shareable URL, no team required)")
+        .argument("[spec-file]", "Path to OpenAPI spec (or use --spec-file / global --spec-file)")
+        .option("--spec-file <path>", "Path to OpenAPI spec file")
+        .option("--public-api-id <id>", "Existing public API ID to update")
+        .option("--name <slug>", "URL-safe API slug (e.g. payments-api). Inferred from spec info.title if omitted.")
+        .option("--title <title>", "Human-readable display title. Defaults to --name if omitted.")
+        .option("--description <text>", "Short description of the API")
+        .requiredOption("--version <version>", "Version tag (e.g. v1.0.0)")
+        .option("--visibility <state>", "Visibility: draft | published | unlisted (default: published)", "published")
+        .option("--release-notes <text>", "Release notes for this version")
+        .option("--git-sha <sha>", "Git commit SHA for provenance")
+        .option("--strict", "Fail on any Spectral lint warning")
+        .option("--skip-lint", "Skip lint gate")
+        .option("--dry-run", "Validate only, do not call the API")
+        .option("--format <fmt>", "Output format: text | json | github", "text")
+        .option("--org <org>", "Override default org (UUID)")
+        .action(async (specArg, opts, command) => {
+        const cwd = process.cwd();
+        const specPath = resolveCliSpecPathFromFlags(command, cwd, opts.specFile, specArg);
+        if (!specPath || !existsSync(specPath)) {
+            console.error(chalk.red("Spec file not found. Pass a path via --spec-file, global spec0 --spec-file, or positional [spec-file].\n"));
+            console.error(chalk.yellow(publishUsageExamples()));
+            exit(ExitCode.USAGE);
+        }
+        const publicApiId = opts["publicApiId"];
+        const nameOpt = opts.name;
+        const titleOpt = opts.title;
+        const description = opts.description;
+        const version = opts.version;
+        const visibilityRaw = opts.visibility ?? "published";
+        const releaseNotes = opts["releaseNotes"];
+        const gitSha = opts["gitSha"] ?? "";
+        const strict = !!opts.strict;
+        const skipLint = !!opts.skipLint;
+        const format = opts.format ?? "text";
+        // Validate visibility
+        const validVisibilities = ["draft", "published", "unlisted"];
+        if (!validVisibilities.includes(visibilityRaw.toLowerCase())) {
+            console.error(chalk.red(`Invalid --visibility '${visibilityRaw}'. Must be: draft | published | unlisted.`));
+            exit(ExitCode.USAGE);
+        }
+        const visibility = visibilityRaw.toUpperCase();
+        const openapiSpec = readFileSync(specPath, "utf-8");
+        // Infer slug from spec info.title if --name not provided and no --public-api-id
+        let apiSlug = nameOpt?.trim();
+        if (!apiSlug && !publicApiId) {
+            try {
+                const titleMatch = openapiSpec.match(/^\s*title:\s*(.+)$/m);
+                if (titleMatch) {
+                    const inferred = toSlug(titleMatch[1].trim().replace(/['"]/g, ""));
+                    if (inferred && API_SLUG_PATTERN.test(inferred)) {
+                        if (format === "text") {
+                            console.log(chalk.yellow(`No --name provided. Inferred slug: "${inferred}"`));
+                        }
+                        apiSlug = inferred;
+                    }
+                }
+            }
+            catch {
+                // ignore parse errors
+            }
+        }
+        if (!publicApiId && (!apiSlug || !API_SLUG_PATTERN.test(apiSlug))) {
+            console.error(chalk.red(`--name is required (or provide --public-api-id to update existing). ` +
+                `Use a slug like 'payments-api' (lowercase letters, digits, hyphens).\n`));
+            console.error(chalk.yellow(publishUsageExamples()));
+            exit(ExitCode.USAGE);
+        }
+        const title = titleOpt?.trim() || apiSlug;
+        // -----------------------------------------------------------------------
+        // Lint gate
+        // -----------------------------------------------------------------------
+        const spinner = ora("Linting...").start();
+        if (!skipLint) {
+            try {
+                const lintResult = await runSpectral(specPath);
+                spinner.succeed("Lint passed");
+                if (format === "github") {
+                    for (const e of lintResult.errors) {
+                        console.log(formatGitHubAnnotation(specPath, e.line ?? 0, "error", e.message));
+                    }
+                    for (const w of lintResult.warnings) {
+                        console.log(formatGitHubAnnotation(specPath, w.line ?? 0, "warning", w.message));
+                    }
+                }
+                else if (format !== "json") {
+                    console.log(formatLintText(lintResult));
+                }
+                if (lintResult.errors.length > 0) {
+                    console.error(chalk.red("Lint errors block publish. Fix them or use --skip-lint."));
+                    exit(ExitCode.VALIDATION);
+                }
+                if (strict && lintResult.warnings.length > 0) {
+                    console.error(chalk.red("Strict mode: warnings block publish."));
+                    exit(ExitCode.VALIDATION);
+                }
+            }
+            catch (e) {
+                spinner.fail("Lint failed");
+                console.error(e);
+                exit(ExitCode.GENERIC);
+            }
+        }
+        else {
+            spinner.succeed("Lint skipped");
+        }
+        // -----------------------------------------------------------------------
+        // Org context
+        // -----------------------------------------------------------------------
+        let ctx;
+        try {
+            ctx = requireOrgContext(opts.org);
+        }
+        catch (e) {
+            console.error(chalk.red(e.message));
+            exit(ExitCode.AUTH_MISSING);
+        }
+        if (opts.dryRun) {
+            console.log(chalk.green(`Dry run — would publish apiSlug=${apiSlug ?? "-"} version=${version} visibility=${visibility}`));
+            return;
+        }
+        // -----------------------------------------------------------------------
+        // API call
+        // -----------------------------------------------------------------------
+        spinner.start("Publishing to public registry...");
+        const client = createOrgApiClient(ctx);
+        const body = {
+            publicApiId,
+            apiSlug,
+            title,
+            description,
+            visibility,
+            version,
+            openapiSpec,
+            gitSha: gitSha || undefined,
+            releaseNotes: releaseNotes || undefined,
+        };
+        try {
+            const reg = (await client.postJson("/api-management/cli/v1/public-publish", body));
+            spinner.stop();
+            const resolvedApiId = reg.publicApiId ?? "";
+            const resolvedPublicUrl = reg.publicUrl ?? `/public/registry/-/${apiSlug ?? ""}`;
+            const apiBaseUrl = resolvedPlatformApiUrl();
+            if (format === "json") {
+                console.log(JSON.stringify({
+                    publicApiId: resolvedApiId,
+                    apiSlug: reg.apiSlug ?? apiSlug,
+                    orgSlug: reg.orgSlug,
+                    version,
+                    visibility: reg.visibility ?? visibility,
+                    created: reg.created ?? false,
+                    versionCreated: reg.versionCreated ?? false,
+                    publicUrl: `${apiBaseUrl}${resolvedPublicUrl}`,
+                }, null, 2));
+            }
+            else {
+                console.log(formatPublishPublicText({
+                    publicApiId: resolvedApiId,
+                    version,
+                    visibility: reg.visibility ?? visibility,
+                    publicUrl: resolvedPublicUrl,
+                    apiUrl: apiBaseUrl,
+                }));
+            }
+        }
+        catch (err) {
+            spinner.stop();
+            if (is401(err)) {
+                console.error(chalk.red("Token invalid. Run 'spec0 auth login' to re-authenticate."));
+                exit(ExitCode.AUTH_MISSING);
+            }
+            if (is402(err)) {
+                const msg = err?.response?.body?.detail ??
+                    "Plan limit exceeded. Upgrade your plan to publish more public APIs or use PUBLISHED visibility.";
+                console.error(chalk.red(`Plan limit: ${msg}`));
+                // 402 isn't in the stable table; PERMISSION_DENIED is closest semantic.
+                exit(ExitCode.PERMISSION_DENIED);
+            }
+            const statusCode = err?.response?.statusCode;
+            if (statusCode === 409) {
+                console.error(chalk.red(`Version conflict: version tag '${version}' already exists with different content.`));
+                console.error(chalk.yellow("Use a new version tag (e.g. bump the patch version)."));
+                exit(ExitCode.CONFLICT);
+            }
+            const msg = err?.response?.body
+                ?.detail ??
+                err.message ??
+                String(err);
+            console.error(chalk.red(`Publish failed: ${msg}\n`));
+            console.error(chalk.yellow(publishUsageExamples()));
+            exit(exitCodeForHttpStatus(statusCode));
+        }
+    });
+}
+//# sourceMappingURL=publish.js.map

package/dist/commands/publish.js.map

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

package/dist/commands/pull.d.ts

@@ -0,0 +1,6 @@
+/**
+ * spec0 pull <org>/<name> — download spec from registry
+ */
+import { Command } from "commander";
+export declare function registerPullCommand(program: Command): void;
+//# sourceMappingURL=pull.d.ts.map

package/dist/commands/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAsCnD"}

package/dist/commands/pull.js

@@ -0,0 +1,62 @@
+/**
+ * spec0 pull <org>/<name> — download spec from registry
+ */
+import chalk from "chalk";
+import { writeFileSync } from "fs";
+import { createOrgApiClient, is401 } from "../lib/api-client.js";
+import { requireOrgContext } from "../lib/auth-context.js";
+import { resolveRef } from "../lib/ref-resolver.js";
+import { ExitCode, exit } from "../lib/exit-codes.js";
+export function registerPullCommand(program) {
+    program
+        .command("pull <ref>")
+        .description("Download spec from registry (e.g. acme/order-service or acme/order-service@v1.2.0)")
+        .option("-o, --output <file>", "Write to file instead of stdout")
+        .option("--public", "Reserved for public registry (same endpoint when API is public)")
+        .option("--org <uuid>", "Auth org id (defaults to logged-in org)")
+        .action(async (ref, opts) => {
+        const parsed = resolveRefForPull(ref);
+        let ctx;
+        try {
+            ctx = requireOrgContext(opts.org);
+        }
+        catch (e) {
+            exit(ExitCode.AUTH_MISSING, e.message);
+        }
+        const client = createOrgApiClient(ctx);
+        const path = parsed.tag
+            ? `/registry/${encodeURIComponent(parsed.org)}/${encodeURIComponent(parsed.api)}/versions/${encodeURIComponent(parsed.tag)}`
+            : `/registry/${encodeURIComponent(parsed.org)}/${encodeURIComponent(parsed.api)}?format=yaml`;
+        try {
+            const yaml = await client.getText(path);
+            if (opts.output) {
+                writeFileSync(opts.output, yaml, "utf-8");
+                console.log(chalk.green(`Wrote ${opts.output}`));
+            }
+            else {
+                process.stdout.write(yaml);
+            }
+        }
+        catch (err) {
+            if (is401(err)) {
+                exit(ExitCode.AUTH_MISSING, "Token invalid or expired. Run 'spec0 auth login'.");
+            }
+            exit(ExitCode.GENERIC, `Pull failed: ${err.message}`);
+        }
+    });
+}
+/** Pull only accepts <org>/<api>[@<tag>]; UUIDs and bare names aren't useful. */
+function resolveRefForPull(ref) {
+    let parsed;
+    try {
+        parsed = resolveRef(ref);
+    }
+    catch (e) {
+        exit(ExitCode.USAGE, e.message);
+    }
+    if (parsed.kind !== "name" || !parsed.org) {
+        exit(ExitCode.USAGE, `Pull requires '<org>/<api>[@<tag>]'. Got '${ref}'. UUIDs aren't supported by the registry endpoint.`);
+    }
+    return { org: parsed.org, api: parsed.api, tag: parsed.tag };
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

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

package/dist/commands/push.d.ts

@@ -0,0 +1,18 @@
+/**
+ * spec0 push — zero-config push of an OpenAPI spec to the platform (team-scoped, private).
+ *
+ * The primary publish command for the GitOps workflow:
+ *   spec0 push openapi.yaml
+ *   spec0 push openapi.yaml --name payment-api
+ *   spec0 push openapi.yaml --semver
+ *
+ * Name resolution order: --name > basename(specFilePath) > error
+ * Version resolution order: --version > info.version in spec > default 0.1.0
+ * Team resolution order: --team > "Unassigned APIs" (backend default, reassign later)
+ * Git SHA: --git-sha > CI env > local `git log -1 -- <file>`
+ *
+ * `spec0 register` is a backward-compat alias for this command.
+ */
+import { Command } from "commander";
+export declare function registerPushCommand(program: Command): void;
+//# sourceMappingURL=push.d.ts.map

package/dist/commands/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/commands/push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgUpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAuBnD"}

package/dist/commands/push.js

@@ -0,0 +1,302 @@
+/**
+ * spec0 push — zero-config push of an OpenAPI spec to the platform (team-scoped, private).
+ *
+ * The primary publish command for the GitOps workflow:
+ *   spec0 push openapi.yaml
+ *   spec0 push openapi.yaml --name payment-api
+ *   spec0 push openapi.yaml --semver
+ *
+ * Name resolution order: --name > basename(specFilePath) > error
+ * Version resolution order: --version > info.version in spec > default 0.1.0
+ * Team resolution order: --team > "Unassigned APIs" (backend default, reassign later)
+ * Git SHA: --git-sha > CI env > local `git log -1 -- <file>`
+ *
+ * `spec0 register` is a backward-compat alias for this command.
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { existsSync, readFileSync } from "fs";
+import { basename, extname, relative, resolve } from "path";
+import { runSpectral } from "../lib/lint.js";
+import { formatLintText, formatPublishText, formatGitHubAnnotation } from "../lib/output.js";
+import { createOrgApiClient, is401, is402, extractErrorMessage } from "../lib/api-client.js";
+import { requireOrgContext } from "../lib/auth-context.js";
+import { ExitCode, exit, exitCodeForHttpStatus } from "../lib/exit-codes.js";
+import { resolveCliSpecPathFromFlags } from "../lib/cli-spec-path.js";
+import { resolvedPlatformAppUrl } from "../lib/platform-defaults.js";
+import { detectCI, getGitShaForFile, getGitBranch } from "../lib/ci-detect.js";
+const TEAM_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+function isUuid(v) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(v);
+}
+function validateTeamArg(team) {
+    const t = team.trim();
+    if (!t)
+        return "Missing --team value.";
+    if (isUuid(t))
+        return null;
+    if (!TEAM_SLUG_PATTERN.test(t)) {
+        return `Invalid --team '${team}'. Use a UUID or slug like 'platform-team' (lowercase, hyphens, no spaces).`;
+    }
+    return null;
+}
+/** Derive API name from spec filename: "api/payment-api.yaml" → "payment-api" */
+function nameFromSpecPath(specPath) {
+    const base = basename(specPath);
+    const ext = extname(base);
+    const stem = ext ? base.slice(0, -ext.length) : base;
+    // Only return if it already looks like a valid slug
+    const slug = stem
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || null;
+}
+function usageExamples(cmd) {
+    return [
+        "Examples:",
+        `  spec0 ${cmd} openapi.yaml`,
+        `  spec0 ${cmd} openapi.yaml --name payment-api`,
+        `  spec0 ${cmd} openapi.yaml --name payment-api --team platform-team`,
+        `  spec0 ${cmd} openapi.yaml --semver`,
+        `  spec0 ${cmd} openapi.yaml --version 1.2.0 --git-sha $(git rev-parse HEAD)`,
+    ].join("\n");
+}
+async function runPush(cmdName, specArg, opts, command) {
+    const cwd = process.cwd();
+    const specPath = resolveCliSpecPathFromFlags(command, cwd, opts.specFile, specArg);
+    if (!specPath || !existsSync(specPath)) {
+        console.error(chalk.red("Spec file not found. Pass a path as the first argument or via --spec-file.\n"));
+        console.error(chalk.yellow(usageExamples(cmdName)));
+        exit(ExitCode.USAGE);
+    }
+    const apiId = opts["apiId"];
+    const nameOpt = opts.name;
+    const team = opts.team;
+    const versionOpt = opts.version;
+    const semver = !!opts.semver;
+    const strict = !!opts.strict;
+    const skipLint = !!opts.skipLint;
+    const verbose = !!opts.verbose;
+    const format = opts.format ?? "text";
+    const dryRun = !!opts.dryRun;
+    const vLog = (msg) => {
+        if (verbose)
+            console.error(chalk.gray(`[verbose] ${msg}`));
+    };
+    // ── Name resolution ────────────────────────────────────────────────────────
+    // --name > basename(specFilePath) — never from info.title
+    const resolvedName = nameOpt?.trim() ?? nameFromSpecPath(specPath);
+    if (!apiId && !resolvedName) {
+        console.error(chalk.red("Cannot derive API name from spec path. Use --name payment-api.\n"));
+        console.error(chalk.yellow(usageExamples(cmdName)));
+        exit(ExitCode.USAGE);
+    }
+    // ── Team validation (optional) ─────────────────────────────────────────────
+    if (team) {
+        const teamErr = validateTeamArg(team);
+        if (teamErr) {
+            console.error(chalk.red(`${teamErr}\n`));
+            exit(ExitCode.USAGE);
+        }
+    }
+    // ── Git SHA resolution ─────────────────────────────────────────────────────
+    // Priority: --git-sha flag > CI env > local git log
+    let gitSha = opts["gitSha"] ?? "";
+    let githubRepo = opts["githubRepo"] ?? "";
+    let githubBranch = opts["githubBranch"] ?? "";
+    if (!gitSha) {
+        const ci = detectCI();
+        if (ci?.gitSha) {
+            gitSha = ci.gitSha;
+            githubRepo = githubRepo || (ci.githubRepo ?? "");
+            githubBranch = githubBranch || ci.branch;
+            vLog(`git sha from CI: ${gitSha.slice(0, 8)}…`);
+        }
+        else {
+            // Local git: SHA of last commit that touched this spec file
+            const localSha = getGitShaForFile(specPath);
+            if (localSha) {
+                gitSha = localSha;
+                githubBranch = githubBranch || (getGitBranch() ?? "");
+                vLog(`git sha from local git: ${gitSha.slice(0, 8)}…`);
+            }
+        }
+    }
+    // ── Lint gate ─────────────────────────────────────────────────────────────
+    const spinner = ora("Linting…").start();
+    if (!skipLint) {
+        try {
+            const lintResult = await runSpectral(specPath);
+            if (lintResult.errors.length === 0) {
+                spinner.succeed("Lint passed");
+            }
+            else {
+                spinner.fail("Lint failed");
+            }
+            if (format === "github") {
+                for (const e of lintResult.errors)
+                    console.log(formatGitHubAnnotation(specPath, e.line ?? 0, "error", e.message));
+                for (const w of lintResult.warnings)
+                    console.log(formatGitHubAnnotation(specPath, w.line ?? 0, "warning", w.message));
+            }
+            else if (format !== "json") {
+                console.log(formatLintText(lintResult));
+            }
+            if (lintResult.errors.length > 0) {
+                console.error(chalk.red("Lint errors block push. Fix them or use --skip-lint."));
+                exit(ExitCode.VALIDATION);
+            }
+            if (strict && lintResult.warnings.length > 0) {
+                console.error(chalk.red("Strict mode: lint warnings block push."));
+                exit(ExitCode.VALIDATION);
+            }
+        }
+        catch (e) {
+            spinner.fail("Lint check failed");
+            console.error(e);
+            exit(ExitCode.GENERIC);
+        }
+    }
+    else {
+        spinner.succeed("Lint skipped");
+    }
+    // ── Auth ──────────────────────────────────────────────────────────────────
+    let ctx;
+    try {
+        ctx = requireOrgContext(opts.org);
+    }
+    catch (e) {
+        console.error(chalk.red(e.message));
+        exit(ExitCode.AUTH_MISSING);
+    }
+    const openapiSpec = readFileSync(specPath, "utf-8");
+    const specFilePath = relative(cwd, resolve(specPath));
+    if (dryRun) {
+        console.log(chalk.green(`Dry run — would push: name=${resolvedName ?? apiId ?? "new"} team=${team ?? "(unassigned)"} version=${versionOpt ?? "(from spec)"} sha=${gitSha ? gitSha.slice(0, 8) + "…" : "none"}`));
+        return;
+    }
+    // ── API call ─────────────────────────────────────────────────────────────
+    const client = createOrgApiClient(ctx);
+    const body = {
+        apiId,
+        name: resolvedName ?? undefined,
+        team: team || undefined,
+        version: versionOpt || undefined,
+        openapiSpec,
+        gitSha: gitSha || undefined,
+        githubRepo: githubRepo || undefined,
+        githubBranch: githubBranch || undefined,
+        specFilePath,
+        semver,
+    };
+    vLog(`POST ${ctx.apiUrl}/api-management/cli/v1/publish`);
+    vLog(`payload: name=${resolvedName} team=${team ?? "(unassigned)"} version=${versionOpt ?? "(from spec)"} sha=${gitSha ? gitSha.slice(0, 8) + "…" : "none"} semver=${semver}`);
+    const pushSpinner = ora("Pushing…").start();
+    try {
+        const reg = (await client.postJson("/api-management/cli/v1/publish", body));
+        pushSpinner.stop();
+        vLog(`response: apiId=${reg.apiId} apiName=${reg.apiName ?? "-"} version=${reg.version ?? "-"} created=${reg.created} noChanges=${reg.noChanges} versionUnchanged=${reg.versionUnchanged}`);
+        const resolvedApiId = reg.apiId ?? "";
+        const appBase = resolvedPlatformAppUrl();
+        const specUrl = `${appBase}/apis/${resolvedApiId}`;
+        let mockUrl;
+        try {
+            const mocks = (await client.getJson("/api-management/cli/v1/mocks"));
+            const hit = mocks.find((m) => m.apiId === resolvedApiId);
+            if (hit?.mockBaseUrl) {
+                mockUrl = `${ctx.apiUrl}${hit.mockBaseUrl}`;
+            }
+        }
+        catch {
+            /* best-effort */
+        }
+        const displayVersion = reg.version ?? versionOpt ?? "?";
+        const displayName = reg.apiName ?? resolvedName ?? resolvedApiId;
+        if (format === "json") {
+            console.log(JSON.stringify({
+                apiId: resolvedApiId,
+                apiName: reg.apiName ?? null,
+                version: displayVersion,
+                created: reg.created ?? false,
+                versionCreated: reg.versionCreated ?? false,
+                noChanges: reg.noChanges ?? false,
+                versionUnchanged: reg.versionUnchanged ?? false,
+                versionUnchangedHint: reg.versionUnchangedHint ?? null,
+                teamName: reg.teamName ?? null,
+                orgSlug: reg.orgSlug ?? null,
+                registryUrl: reg.registryUrl ?? null,
+                specUrl,
+                mockUrl: mockUrl ?? null,
+            }, null, 2));
+        }
+        else {
+            console.log(formatPublishText({
+                apiId: resolvedApiId,
+                apiName: displayName,
+                version: displayVersion,
+                specUrl,
+                mockUrl,
+                teamName: reg.teamName,
+                registryUrl: reg.registryUrl,
+                noChanges: reg.noChanges,
+                versionUnchanged: reg.versionUnchanged,
+                versionUnchangedHint: reg.versionUnchangedHint,
+                created: reg.created,
+            }));
+        }
+    }
+    catch (err) {
+        pushSpinner.fail("Push failed");
+        if (is401(err)) {
+            const errBody = err?.response?.body;
+            const errCode = typeof errBody === "object" && errBody !== null
+                ? errBody["error"]
+                : undefined;
+            if (errCode === "API_KEY_EXPIRED") {
+                console.error(chalk.red("Your API key has expired. Run 'spec0 auth login' to re-authenticate."));
+            }
+            else {
+                console.error(chalk.red("Authentication failed. Run 'spec0 auth login' to re-authenticate."));
+            }
+            exit(ExitCode.AUTH_MISSING);
+        }
+        if (is402(err)) {
+            const msg = extractErrorMessage(err) ?? "You've reached your plan limit.";
+            console.error(chalk.red(`Plan limit reached: ${msg}`));
+            console.error(chalk.yellow("Upgrade your plan at your org settings."));
+            // 402 isn't in the stable exit-code table; closest semantic is permission-denied.
+            exit(ExitCode.PERMISSION_DENIED);
+        }
+        const status = err?.response?.statusCode;
+        const detail = extractErrorMessage(err) ?? err.message ?? String(err);
+        console.error(chalk.red(`Push failed: ${detail}\n`));
+        console.error(chalk.yellow(usageExamples(cmdName)));
+        exit(exitCodeForHttpStatus(status));
+    }
+}
+export function registerPushCommand(program) {
+    program
+        .command("push")
+        .description("Push an OpenAPI spec to the platform (team-scoped, private)")
+        .argument("[spec-file]", "Path to OpenAPI spec file (or use --spec-file)")
+        .option("--spec-file <path>", "Path to OpenAPI spec file")
+        .option("--name <name>", "API name (kebab-case). Defaults to spec filename if omitted.")
+        .option("--team <team>", "Team UUID or slug. Defaults to 'Unassigned APIs' if omitted.")
+        .option("--version <version>", "Version tag (e.g. 1.2.0). Defaults to info.version in spec.")
+        .option("--api-id <id>", "Existing API UUID to update (backward compat; prefer --name)")
+        .option("--semver", "Auto-compute next semver via oasdiff diff classification")
+        .option("--git-sha <sha>", "Git commit SHA (auto-detected if .git is present)")
+        .option("--github-repo <repo>", "GitHub repository URL for provenance")
+        .option("--github-branch <branch>", "GitHub branch for provenance")
+        .option("--strict", "Fail on any Spectral lint warning")
+        .option("--skip-lint", "Skip lint gate")
+        .option("--dry-run", "Validate and print what would be sent, without pushing")
+        .option("--verbose", "Print verbose request/response logs")
+        .option("--format <fmt>", "Output format: text, json, github", "text")
+        .option("--org <org>", "Override default org (UUID)")
+        .action(async (specArg, opts, command) => {
+        await runPush("push", specArg, opts, command);
+    });
+}
+//# sourceMappingURL=push.js.map