@spec0/cli 0.1.0

package/dist/commands/diff.js

@@ -0,0 +1,102 @@
+/**
+ * spec0 diff — compare two OpenAPI specs (registry refs and/or local files)
+ */
+import chalk from "chalk";
+import { existsSync, readFileSync } from "fs";
+import { createTwoFilesPatch } from "diff";
+import { createOrgApiClient, is401, extractErrorMessage } from "../lib/api-client.js";
+import { requireOrgContext } from "../lib/auth-context.js";
+import { resolveRef } from "../lib/ref-resolver.js";
+import { ExitCode, exit, exitCodeForHttpStatus } from "../lib/exit-codes.js";
+async function loadSpecContent(token, ctx) {
+    const trimmed = token.trim();
+    if (existsSync(trimmed)) {
+        return readFileSync(trimmed, "utf-8");
+    }
+    const client = createOrgApiClient(ctx);
+    const parsed = resolveRef(trimmed);
+    if (parsed.kind !== "name" || !parsed.org) {
+        throw new Error(`Diff requires '<org>/<api>[@<tag>]' or a local file. Got '${trimmed}'.`);
+    }
+    const path = parsed.tag
+        ? `/registry/${encodeURIComponent(parsed.org)}/${encodeURIComponent(parsed.api)}/versions/${encodeURIComponent(parsed.tag)}`
+        : `/registry/${encodeURIComponent(parsed.org)}/${encodeURIComponent(parsed.api)}?format=yaml`;
+    return client.getText(path);
+}
+async function breakingChangesViaBackend(ctx, leftContent, rightContent, leftLabel, rightLabel) {
+    const client = createOrgApiClient(ctx);
+    const result = await client.postMultipart("/api-management/cli/v1/diff", {
+        base: { content: leftContent, filename: leftLabel },
+        revision: { content: rightContent, filename: rightLabel },
+    });
+    if (!result.hasBreakingChanges) {
+        console.log(chalk.green("No breaking changes detected."));
+        return;
+    }
+    console.log(chalk.red(`Breaking changes detected:`));
+    if (result.breakingChanges?.length) {
+        for (const bc of result.breakingChanges) {
+            const id = bc["id"] ?? bc["text"] ?? JSON.stringify(bc);
+            const level = bc["level"] ?? "";
+            const msg = bc["message"] ?? bc["text"] ?? "";
+            console.log(chalk.red(`  [${level}] ${id}${msg ? ": " + msg : ""}`));
+        }
+    }
+}
+export function registerDiffCommand(program) {
+    program
+        .command("diff")
+        .description("Diff two specs: each side is a file path or registry ref org/api[@tag] (latest if tag omitted)")
+        .argument("<a>", "Left: local path or org/api[@tag]")
+        .argument("<b>", "Right: local path or org/api[@tag]")
+        .option("--breaking-only", "Show breaking changes only (via backend oasdiff service)")
+        .option("--org <uuid>", "Org id override for registry fetches")
+        .action(async (a, b, opts) => {
+        let ctx;
+        try {
+            ctx = requireOrgContext(opts.org);
+        }
+        catch (e) {
+            console.error(chalk.red(e.message));
+            exit(ExitCode.AUTH_MISSING);
+        }
+        let left;
+        let right;
+        try {
+            left = await loadSpecContent(a, ctx);
+            right = await loadSpecContent(b, ctx);
+        }
+        catch (err) {
+            if (is401(err)) {
+                console.error(chalk.red("Token invalid. Run 'spec0 auth login'."));
+                exit(ExitCode.AUTH_MISSING);
+            }
+            const status = err?.response?.statusCode;
+            console.error(chalk.red(`Failed to load spec: ${err.message}`));
+            exit(status ? exitCodeForHttpStatus(status) : ExitCode.GENERIC);
+        }
+        if (opts.breakingOnly) {
+            try {
+                await breakingChangesViaBackend(ctx, left, right, a, b);
+            }
+            catch (err) {
+                if (is401(err)) {
+                    console.error(chalk.red("Token invalid. Run 'spec0 auth login'."));
+                    exit(ExitCode.AUTH_MISSING);
+                }
+                const status = err?.response?.statusCode;
+                const msg = extractErrorMessage(err) ?? err.message;
+                console.error(chalk.red(`Breaking change check failed: ${msg}`));
+                exit(status ? exitCodeForHttpStatus(status) : ExitCode.GENERIC);
+            }
+            return;
+        }
+        const patch = createTwoFilesPatch(a, b, left, right, "", "", { context: 3 });
+        if (!patch.trim()) {
+            console.log(chalk.green("No textual differences."));
+            return;
+        }
+        process.stdout.write(patch);
+    });
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * spec0 doctor — print which config sources are in effect.
+ *
+ * Useful when an `auth missing` or `wrong URL` error fires and the user
+ * wants to know "which env var or config file is the CLI actually reading?".
+ *
+ * Exits 0 when token + orgId resolve, otherwise the corresponding ExitCode.
+ */
+import { Command } from "commander";
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAiBrD"}

package/dist/commands/doctor.js

@@ -0,0 +1,54 @@
+/**
+ * spec0 doctor — print which config sources are in effect.
+ *
+ * Useful when an `auth missing` or `wrong URL` error fires and the user
+ * wants to know "which env var or config file is the CLI actually reading?".
+ *
+ * Exits 0 when token + orgId resolve, otherwise the corresponding ExitCode.
+ */
+import chalk from "chalk";
+import { ExitCode, exit } from "../lib/exit-codes.js";
+import { emit, resolveOutputContext } from "../lib/output/index.js";
+import { buildDoctorReport, describeSource } from "../lib/doctor.js";
+export function registerDoctorCommand(program) {
+    program
+        .command("doctor")
+        .description("Diagnose CLI configuration: where each setting is being read from.")
+        .option("--output <format>", "Output format: text, json, or yaml (default: text)")
+        .action((opts) => {
+        const ctx = resolveOutputContext(opts);
+        const report = buildDoctorReport();
+        emit(ctx, report, renderDoctorText);
+        if (!report.ok) {
+            // No message here — emit() already printed the diagnostic.
+            process.exit(ExitCode.AUTH_MISSING);
+        }
+        exit(ExitCode.SUCCESS);
+    });
+}
+function renderDoctorText(report) {
+    const lines = [];
+    lines.push(chalk.bold("spec0 configuration"));
+    lines.push("");
+    const colWidth = Math.max(...report.settings.map((s) => s.name.length));
+    for (const s of report.settings) {
+        const name = s.name.padEnd(colWidth);
+        const src = describeSource(s.source);
+        const colour = s.source.kind === "missing" ? chalk.red : chalk.gray;
+        // describeSource for "missing" returns "(not set)" already; everything else is bare text.
+        const srcDisplay = s.source.kind === "missing" ? src : `(${src})`;
+        lines.push(`  ${name}  ${s.value}  ${colour(srcDisplay)}`);
+    }
+    lines.push("");
+    lines.push(`  config file:  ${report.configPath}`);
+    lines.push("");
+    if (report.ok) {
+        lines.push(chalk.green("✓ ready to talk to the platform"));
+    }
+    else {
+        lines.push(chalk.red("✗ missing required settings — see above"));
+        lines.push(chalk.gray("  Set SPEC0_TOKEN + SPEC0_ORG_ID for non-interactive use, or run 'spec0 auth login'."));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * spec0 init — onboarding, spec auto-detect, CODEOWNERS, .spec0.yaml, optional register
+ */
+import { Command } from "commander";
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

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

package/dist/commands/init.js

@@ -0,0 +1,67 @@
+/**
+ * spec0 init — onboarding, spec auto-detect, CODEOWNERS, .spec0.yaml, optional register
+ */
+import chalk from "chalk";
+import { findSpecInDir } from "../lib/spec-finder.js";
+import { getTeamFromCodeowners } from "../lib/codeowners.js";
+import { writeFileSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+import { ExitCode, exit } from "../lib/exit-codes.js";
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Detect your OpenAPI spec and create a .spec0.yaml config file")
+        .option("--all", "Scan subdirectories for .spec0.yaml (monorepo)")
+        .option("--push", "Run spec0 push after writing config")
+        .action(async (opts) => {
+        const cwd = process.cwd();
+        const specPath = findSpecInDir(cwd);
+        if (!specPath) {
+            console.error(chalk.red("No OpenAPI spec found. Add openapi.yaml, openapi.json, or swagger.yaml"));
+            exit(ExitCode.USAGE);
+        }
+        const specName = specPath.split("/").pop() ?? "openapi.yaml";
+        const team = getTeamFromCodeowners(cwd, specPath);
+        const defaultName = specPath.split("/").slice(-2, -1)[0] ?? "api";
+        const suggestedName = defaultName.replace(/[^a-z0-9-]/gi, "-").toLowerCase();
+        console.log(chalk.blue(`Found ${specName}. Suggested API name: ${suggestedName}`));
+        if (team)
+            console.log(chalk.blue(`Team from CODEOWNERS: ${team}`));
+        const config = {
+            spec: specName,
+            name: suggestedName,
+            owner: team ?? "default",
+            namespace: `${team ?? "default"}/${suggestedName}`,
+            autoCreateTeam: false,
+            strict: false,
+            checkBreaking: true,
+        };
+        const yamlPath = join(cwd, ".spec0.yaml");
+        const yaml = [
+            `# Spec0 config — generated by spec0 init`,
+            `spec: ${specName}`,
+            `name: ${config.name}`,
+            `owner: ${config.owner}`,
+            `namespace: ${config.namespace}`,
+            `auto-create-team: ${config.autoCreateTeam}`,
+            `strict: ${config.strict}`,
+            `check-breaking: ${config.checkBreaking}`,
+        ].join("\n");
+        writeFileSync(yamlPath, yaml);
+        console.log(chalk.green("Initialized! Spec0 config written to .spec0.yaml"));
+        if (opts.push) {
+            try {
+                execSync("spec0 push", { stdio: "inherit", cwd });
+            }
+            catch {
+                console.error(chalk.red("Push failed. Run 'spec0 push' manually."));
+                exit(ExitCode.GENERIC);
+            }
+        }
+        else {
+            console.log(chalk.blue("Run 'spec0 push' to upload your spec (or use --push)."));
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/lint.d.ts

@@ -0,0 +1,6 @@
+/**
+ * spec0 lint — Spectral bundled, org ruleset fetch, JSON/text/github output
+ */
+import { Command } from "commander";
+export declare function registerLintCommand(program: Command): void;
+//# sourceMappingURL=lint.d.ts.map

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

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

package/dist/commands/lint.js

@@ -0,0 +1,109 @@
+/**
+ * spec0 lint — Spectral bundled, org ruleset fetch, JSON/text/github output
+ */
+import chalk from "chalk";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import { findSpecInDir } from "../lib/spec-finder.js";
+import { resolveCliSpecPathFromFlags } from "../lib/cli-spec-path.js";
+import { runSpectral } from "../lib/lint.js";
+import { formatLintText, formatGitHubAnnotation } from "../lib/output.js";
+import { createOrgApiClient } from "../lib/api-client.js";
+import { requireOrgContext } from "../lib/auth-context.js";
+import { ExitCode, exit } from "../lib/exit-codes.js";
+export function registerLintCommand(program) {
+    program
+        .command("lint")
+        .description("Lint OpenAPI spec with Spectral")
+        .argument("[spec-file]", "Path to OpenAPI spec (or use --spec-file / global --spec-file)")
+        .option("--spec-file <path>", "Path to OpenAPI spec file")
+        .option("--ruleset <file>", "Use custom ruleset file")
+        .option("--org-ruleset", "Fetch org ruleset from server")
+        .option("--save-ruleset <file>", "Upload <file> as the org's stored Spectral ruleset (skips the lint step)")
+        .option("--format <fmt>", "Output: text, json, github, sarif", "text")
+        .option("--min-score <n>", "Exit 1 if score below n (0-100)", "0")
+        .option("--strict", "Exit 1 on any warning")
+        .action(async (specArg, opts, command) => {
+        // --save-ruleset is an upload-only mode; short-circuit the lint path.
+        if (typeof opts.saveRuleset === "string" && opts.saveRuleset) {
+            await uploadRuleset(opts.saveRuleset);
+            return;
+        }
+        const cwd = process.cwd();
+        const specPath = resolveCliSpecPathFromFlags(command, cwd, opts.specFile, specArg) ??
+            findSpecInDir(cwd);
+        if (!specPath || !existsSync(specPath)) {
+            console.error(chalk.red("Spec file not found."));
+            exit(ExitCode.USAGE);
+        }
+        let rulesetFile = opts.ruleset;
+        if (opts.orgRuleset) {
+            try {
+                const ctx = requireOrgContext();
+                const client = createOrgApiClient(ctx);
+                const res = (await client.getJson("/api-management/cli/v1/spectral-ruleset"));
+                const yaml = res.rulesetYaml?.trim() ?? "";
+                if (!yaml) {
+                    console.warn(chalk.yellow("No org ruleset stored on the server; using built-in OAS ruleset."));
+                }
+                else {
+                    rulesetFile = join(tmpdir(), `spec0-org-ruleset-${Date.now()}.yaml`);
+                    writeFileSync(rulesetFile, yaml, "utf-8");
+                }
+            }
+            catch (e) {
+                console.error(chalk.red(e.message));
+                exit(ExitCode.AUTH_MISSING);
+            }
+        }
+        const result = await runSpectral(specPath, rulesetFile);
+        if (opts.format === "json") {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (opts.format === "github") {
+            for (const e of result.errors) {
+                console.log(formatGitHubAnnotation(specPath, e.line ?? 0, "error", e.message));
+            }
+            for (const w of result.warnings) {
+                console.log(formatGitHubAnnotation(specPath, w.line ?? 0, "warning", w.message));
+            }
+        }
+        else {
+            console.log(`Linting ${specPath}... (oas ruleset)\n`);
+            console.log(formatLintText(result));
+        }
+        const minScore = parseInt(String(opts.minScore ?? "0"), 10);
+        if (result.score < minScore)
+            exit(ExitCode.VALIDATION);
+        if (opts.strict === true && result.warnings.length > 0)
+            exit(ExitCode.VALIDATION);
+        if (result.errors.length > 0)
+            exit(ExitCode.VALIDATION);
+    });
+}
+async function uploadRuleset(filePath) {
+    if (!existsSync(filePath)) {
+        console.error(chalk.red(`Ruleset file not found: ${filePath}`));
+        exit(ExitCode.USAGE);
+    }
+    const rulesetYaml = readFileSync(filePath, "utf-8");
+    let ctx;
+    try {
+        ctx = requireOrgContext();
+    }
+    catch (e) {
+        console.error(chalk.red(e.message));
+        exit(ExitCode.AUTH_MISSING);
+    }
+    const client = createOrgApiClient(ctx);
+    try {
+        await client.putJson("/api-management/cli/v1/spectral-ruleset", { rulesetYaml });
+        console.log(chalk.green(`✓ uploaded ${filePath} as the org's Spectral ruleset`));
+    }
+    catch (err) {
+        console.error(chalk.red(`Failed to upload ruleset: ${err.message}`));
+        exit(ExitCode.GENERIC);
+    }
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/commands/log.d.ts

@@ -0,0 +1,6 @@
+/**
+ * spec0 log — version history from registry
+ */
+import { Command } from "commander";
+export declare function registerLogCommand(program: Command): void;
+//# sourceMappingURL=log.d.ts.map

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

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

package/dist/commands/log.js

@@ -0,0 +1,95 @@
+/**
+ * spec0 log — version history from registry
+ */
+import chalk from "chalk";
+import { createOrgApiClient, is401 } from "../lib/api-client.js";
+import { requireOrgContext } from "../lib/auth-context.js";
+import { getDefaultOrgId, getOrgConfig } from "../lib/config.js";
+import { parseRegistryRef } from "../lib/registry-ref.js";
+import { ExitCode, exit } from "../lib/exit-codes.js";
+import { emit, resolveOutputContext } from "../lib/output/index.js";
+import { renderTable } from "../lib/output/table.js";
+import { warnDeprecated } from "../lib/deprecation.js";
+export function registerLogCommand(program) {
+    program
+        .command("log <api-ref>")
+        .description("Show published version history. api-ref: api-name (default org) or org-slug/api-name")
+        .option("--org <uuid>", "Org id override (auth)")
+        .option("--org-slug <slug>", "Organisation slug/name for registry path when api-ref has no slash (default: name from spec0 auth config)")
+        .option("--output <format>", "Output format: text, json, or yaml (default: text)")
+        .option("--json", "Deprecated. Use --output=json instead.")
+        .action(async (apiRef, opts) => {
+        if (opts.json) {
+            warnDeprecated({
+                what: "the --json flag on `spec0 log`",
+                removeIn: "v1.0.0",
+                alternative: "--output=json",
+            });
+        }
+        const outCtx = resolveOutputContext(opts);
+        let orgSlug;
+        let apiName;
+        try {
+            if (apiRef.includes("/")) {
+                const p = parseRegistryRef(apiRef);
+                orgSlug = p.org;
+                apiName = p.api;
+            }
+            else {
+                const orgId = process.env.PLATFORM_ORG_ID ?? getDefaultOrgId();
+                const cfg = orgId ? getOrgConfig(orgId) : undefined;
+                const fallback = cfg?.name?.trim();
+                orgSlug = (opts.orgSlug ?? fallback ?? "").trim();
+                if (!orgSlug) {
+                    exit(ExitCode.USAGE, "Set --org-slug <slug> or use org-slug/api-name, or run 'spec0 auth login'.");
+                }
+                apiName = apiRef.trim();
+            }
+        }
+        catch (e) {
+            exit(ExitCode.USAGE, e.message);
+        }
+        let authCtx;
+        try {
+            authCtx = requireOrgContext(opts.org);
+        }
+        catch (e) {
+            exit(ExitCode.AUTH_MISSING, e.message);
+        }
+        const client = createOrgApiClient(authCtx);
+        const path = `/registry/${encodeURIComponent(orgSlug)}/${encodeURIComponent(apiName)}/versions`;
+        try {
+            const rows = (await client.getJson(path));
+            emit(outCtx, rows, (data) => renderLogText(data, orgSlug, apiName));
+        }
+        catch (err) {
+            if (is401(err)) {
+                exit(ExitCode.AUTH_MISSING, "Token invalid or expired. Run 'spec0 auth login'.");
+            }
+            exit(ExitCode.GENERIC, `Log failed: ${err.message}`);
+        }
+    });
+}
+function renderLogText(rows, orgSlug, apiName) {
+    if (!rows.length)
+        return chalk.yellow("No published versions found.");
+    const table = renderTable(rows, [
+        { key: "tag", header: "Tag" },
+        { key: "publishedAt", header: "Published" },
+        { key: "gitSha", header: "Git SHA", format: (v) => String(v ?? "—").slice(0, 12) },
+        {
+            key: "breakingChangesRecorded",
+            header: "Breaking",
+            format: (v) => (v ? "yes" : "—"),
+        },
+    ]);
+    const lines = [chalk.blue(`${orgSlug}/${apiName} version history:`), table];
+    for (const r of rows) {
+        if (r.breakingChangeSummary) {
+            const prev = (r.breakingChangeSummary ?? "").slice(0, 500);
+            lines.push("", chalk.gray(`${r.tag}: ${prev}${prev.length >= 500 ? "…" : ""}`));
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=log.js.map

package/dist/commands/log.js.map

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

package/dist/commands/mcp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * spec0 mcp url | test
+ */
+import { Command } from "commander";
+export declare function registerMcpCommands(program: Command): void;
+//# sourceMappingURL=mcp.d.ts.map

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

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

package/dist/commands/mcp.js

@@ -0,0 +1,59 @@
+/**
+ * spec0 mcp url | test
+ */
+import chalk from "chalk";
+import got from "got";
+import { getDefaultOrgId, getOrgConfig } from "../lib/config.js";
+import { ExitCode, exit, exitCodeForHttpStatus } from "../lib/exit-codes.js";
+export function registerMcpCommands(program) {
+    const mcp = program.command("mcp").description("MCP server URL and config");
+    mcp
+        .command("url")
+        .description("Print MCP server URL for Cursor/Claude config")
+        .action(async () => {
+        const orgId = process.env.PLATFORM_ORG_ID ?? getDefaultOrgId();
+        if (!orgId || !getOrgConfig(orgId)) {
+            console.error(chalk.red("Not authenticated. Run 'spec0 auth login'."));
+            exit(ExitCode.AUTH_MISSING);
+        }
+        const org = getOrgConfig(orgId);
+        const mcpUrl = `https://mcp.spec0.io/org/${orgId}/mcp`;
+        console.log("Your MCP server URL:");
+        console.log(`  ${mcpUrl}`);
+        console.log("");
+        console.log("Add to Cursor settings:");
+        console.log(JSON.stringify({
+            mcpServers: {
+                spec0: {
+                    url: mcpUrl,
+                    apiKey: org.apiKey,
+                },
+            },
+        }, null, 2));
+    });
+    mcp
+        .command("test")
+        .description("Verify MCP server is responding")
+        .action(async () => {
+        const orgId = process.env.PLATFORM_ORG_ID ?? getDefaultOrgId();
+        if (!orgId || !getOrgConfig(orgId)) {
+            console.error(chalk.red("Not authenticated. Run 'spec0 auth login'."));
+            exit(ExitCode.AUTH_MISSING);
+        }
+        const org = getOrgConfig(orgId);
+        const base = org.apiUrl.replace(/\/$/, "");
+        const url = `${base}/mcp/org/${orgId}/health`;
+        try {
+            const res = await got.get(url, {
+                headers: { Authorization: `Bearer ${org.apiKey}`, "X-Org-Id": orgId },
+            });
+            console.log(chalk.green("MCP gateway OK:"), res.body);
+        }
+        catch (e) {
+            const status = e?.response?.statusCode;
+            console.error(chalk.red("MCP health check failed:"), e.message);
+            exit(status ? exitCodeForHttpStatus(status) : ExitCode.NETWORK_ERROR);
+        }
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/mock/create.d.ts

@@ -0,0 +1,14 @@
+/**
+ * spec0 mock create — provision (or fetch) the default mock server for an API.
+ *
+ * The backend endpoint is idempotent: POST /api-management/cli/v1/mocks either
+ * returns the existing mock or creates a fresh one. The API key is only ever
+ * returned once (on initial creation), so CI callers should capture it on the
+ * very first run — we surface it prominently in text mode and include it in
+ * the JSON payload.
+ */
+import { Command } from "commander";
+import type { components } from "../../types.js";
+export declare function registerMockCreateCommand(mock: Command): void;
+export type MockItem = components["schemas"]["MockItem"];
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/mock/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/mock/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,gBAAgB,CAAC;AAexD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,QAsDtD;AAeD,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC"}