@spec0/cli 0.1.0

package/dist/lib/exit-codes.js

@@ -0,0 +1,78 @@
+/**
+ * Stable exit-code contract. These values are part of the CLI's public API —
+ * once shipped, they MUST NOT be reused or repurposed. CI pipelines depend on
+ * them.
+ *
+ * See README "Exit codes" section for the user-facing reference.
+ */
+export const ExitCode = {
+    /** Operation succeeded. */
+    SUCCESS: 0,
+    /** Generic / unclassified failure. Avoid; pick a specific code instead. */
+    GENERIC: 1,
+    /** Bad invocation: missing required arg, conflicting flags, etc. */
+    USAGE: 2,
+    /** No credentials available, or token expired. Hint at SPEC0_TOKEN. */
+    AUTH_MISSING: 3,
+    /** Authenticated but lacking required permission (HTTP 403). */
+    PERMISSION_DENIED: 4,
+    /** Resource (API, mock, environment, …) does not exist (HTTP 404). */
+    NOT_FOUND: 5,
+    /** Conflict on create/update — e.g. name already taken (HTTP 409). */
+    CONFLICT: 6,
+    /** Validation failure — e.g. spec lint score below threshold (HTTP 422 or local). */
+    VALIDATION: 7,
+    /** Rate limit hit (HTTP 429). */
+    RATE_LIMITED: 8,
+    /** Server-side failure the user can't act on directly (HTTP 5xx). */
+    SERVER_ERROR: 9,
+    /** Network unreachable, timeout, DNS failure. */
+    NETWORK_ERROR: 10,
+};
+/**
+ * Classifies an HTTP-style error into the corresponding exit code. Anything
+ * unrecognised falls back to `GENERIC` so callers can chain this safely.
+ */
+export function exitCodeForHttpStatus(status) {
+    if (status === undefined)
+        return ExitCode.NETWORK_ERROR;
+    if (status === 401)
+        return ExitCode.AUTH_MISSING;
+    if (status === 403)
+        return ExitCode.PERMISSION_DENIED;
+    if (status === 404)
+        return ExitCode.NOT_FOUND;
+    if (status === 409)
+        return ExitCode.CONFLICT;
+    if (status === 422)
+        return ExitCode.VALIDATION;
+    if (status === 429)
+        return ExitCode.RATE_LIMITED;
+    if (status >= 500 && status < 600)
+        return ExitCode.SERVER_ERROR;
+    return ExitCode.GENERIC;
+}
+/**
+ * Single exit point. Logs `message` to stderr (if provided) before exiting.
+ * Commands MUST go through this rather than calling `process.exit` directly so
+ * that future logging / telemetry can hook one place.
+ */
+export function exit(code, message) {
+    if (message) {
+        process.stderr.write(message.endsWith("\n") ? message : `${message}\n`);
+    }
+    process.exit(code);
+}
+/**
+ * Reverse-lookup: turn a numeric exit code into its stable string name
+ * ("AUTH_MISSING", "NOT_FOUND", …). Used when emitting structured errors
+ * so agents can branch on the symbolic code rather than the number.
+ */
+export function exitCodeName(code) {
+    for (const [name, value] of Object.entries(ExitCode)) {
+        if (value === code)
+            return name;
+    }
+    return "GENERIC";
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/lib/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/lib/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,2BAA2B;IAC3B,OAAO,EAAE,CAAC;IACV,2EAA2E;IAC3E,OAAO,EAAE,CAAC;IACV,oEAAoE;IACpE,KAAK,EAAE,CAAC;IACR,uEAAuE;IACvE,YAAY,EAAE,CAAC;IACf,gEAAgE;IAChE,iBAAiB,EAAE,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,CAAC;IACZ,sEAAsE;IACtE,QAAQ,EAAE,CAAC;IACX,qFAAqF;IACrF,UAAU,EAAE,CAAC;IACb,iCAAiC;IACjC,YAAY,EAAE,CAAC;IACf,qEAAqE;IACrE,YAAY,EAAE,CAAC;IACf,iDAAiD;IACjD,aAAa,EAAE,EAAE;CACT,CAAC;AAKX;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA0B;IAC9D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,aAAa,CAAC;IACxD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,YAAY,CAAC;IACjD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,iBAAiB,CAAC;IACtD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC9C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC7C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAC;IAC/C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,YAAY,CAAC;IACjD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,QAAQ,CAAC,YAAY,CAAC;IAChE,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,IAAmB,EAAE,OAAgB;IACxD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAoC,EAAE,CAAC;QACxF,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/lint.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Spectral runner for OpenAPI linting
+ */
+export interface LintResult {
+    score: number;
+    errors: Array<{
+        line?: number;
+        message: string;
+        rule: string;
+    }>;
+    warnings: Array<{
+        line?: number;
+        message: string;
+        rule: string;
+    }>;
+}
+export declare function runSpectral(specPath: string, rulesetPath?: string): Promise<LintResult>;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/lib/lint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmC7F"}

package/dist/lib/lint.js

@@ -0,0 +1,41 @@
+/**
+ * Spectral runner for OpenAPI linting
+ */
+import { readFileSync } from "fs";
+import spectralCore from "@stoplight/spectral-core";
+const { Spectral } = spectralCore;
+import { oas } from "@stoplight/spectral-rulesets";
+export async function runSpectral(specPath, rulesetPath) {
+    const spectral = new Spectral();
+    if (rulesetPath) {
+        try {
+            // Spectral 6+: load custom ruleset file (YAML/JSON)
+            await spectral.loadRuleset(rulesetPath);
+        }
+        catch {
+            spectral.setRuleset(oas);
+        }
+    }
+    else {
+        spectral.setRuleset(oas);
+    }
+    const specContent = readFileSync(specPath, "utf-8");
+    const results = await spectral.run(specContent);
+    const errors = [];
+    const warnings = [];
+    for (const r of results) {
+        const item = {
+            line: r.range?.start?.line,
+            message: r.message,
+            rule: String(r.code ?? "unknown"),
+        };
+        if (r.severity === 0)
+            errors.push(item);
+        else
+            warnings.push(item);
+    }
+    const total = errors.length + warnings.length;
+    const score = total === 0 ? 100 : Math.max(0, 100 - errors.length * 10 - warnings.length * 2);
+    return { score, errors, warnings };
+}
+//# sourceMappingURL=lint.js.map

package/dist/lib/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/lib/lint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,YAAY,MAAM,0BAA0B,CAAC;AACpD,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AAQnD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,WAAoB;IACtE,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,oDAAoD;YACpD,MAAO,QAAqE,CAAC,WAAW,CACtF,WAAW,CACZ,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,UAAU,CAAC,GAAgD,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,UAAU,CAAC,GAAgD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI;YAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC;SAClC,CAAC;QACF,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACnC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9F,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC"}

package/dist/lib/local-config-yaml.d.ts

@@ -0,0 +1,14 @@
+export interface Spec0Yaml {
+    spec?: string;
+    name?: string;
+    owner?: string;
+    namespace?: string;
+    strict?: boolean;
+    checkBreaking?: boolean;
+    "auto-create-team"?: boolean;
+    "check-breaking"?: boolean;
+}
+export declare function loadSpec0Yaml(cwd: string): Spec0Yaml | null;
+export declare function checkBreakingFromYaml(y: Spec0Yaml | null): boolean;
+export declare function strictFromYaml(y: Spec0Yaml | null): boolean;
+//# sourceMappingURL=local-config-yaml.d.ts.map

package/dist/lib/local-config-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-config-yaml.d.ts","sourceRoot":"","sources":["../../src/lib/local-config-yaml.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAO3D;AACD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAKlE;AACD,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAG3D"}

package/dist/lib/local-config-yaml.js

@@ -0,0 +1,29 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import YAML from "yaml";
+const CONFIG_FILENAME = ".spec0.yaml";
+export function loadSpec0Yaml(cwd) {
+    const path = join(cwd, CONFIG_FILENAME);
+    if (!existsSync(path))
+        return null;
+    const content = readFileSync(path, "utf-8");
+    const doc = YAML.parse(content);
+    if (!doc || typeof doc !== "object")
+        return null;
+    return doc;
+}
+export function checkBreakingFromYaml(y) {
+    if (!y)
+        return false;
+    if (typeof y.checkBreaking === "boolean")
+        return y.checkBreaking;
+    if (typeof y["check-breaking"] === "boolean")
+        return y["check-breaking"];
+    return false;
+}
+export function strictFromYaml(y) {
+    if (!y)
+        return false;
+    return !!y.strict;
+}
+//# sourceMappingURL=local-config-yaml.js.map

package/dist/lib/local-config-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-config-yaml.js","sourceRoot":"","sources":["../../src/lib/local-config-yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AAWxB,MAAM,eAAe,GAAG,aAAa,CAAC;AACtC,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,GAAgB,CAAC;AAC1B,CAAC;AACD,MAAM,UAAU,qBAAqB,CAAC,CAAmB;IACvD,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,aAAa,CAAC;IACjE,IAAI,OAAO,CAAC,CAAC,gBAAgB,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,CAAmB;IAChD,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACpB,CAAC"}

package/dist/lib/output/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Unified output for every command. One way to do a thing — see ROADMAP.md.
+ *
+ * Usage:
+ *
+ *   const ctx = resolveOutputContext(opts);
+ *   emit(ctx, data, (d) => formatTextLines(d));
+ *
+ * - Progress / log messages always go to stderr (use `progress(ctx, msg)`).
+ * - Final result always goes to stdout via `emit()` — exactly one document.
+ * - Default format is `text`, auto-coloured when stdout is a TTY.
+ */
+import { type ExitCodeValue } from "../exit-codes.js";
+export type OutputFormat = "text" | "json" | "yaml";
+export interface OutputContext {
+    format: OutputFormat;
+    /** Whether the stdout we'll print to is a real terminal (colour OK). */
+    isTTY: boolean;
+    /** Suppress non-essential progress messages on stderr. */
+    quiet: boolean;
+    /** Print extra diagnostics on stderr (e.g. HTTP traces). */
+    verbose: boolean;
+}
+export interface OutputOptions {
+    output?: string;
+    format?: string;
+    json?: boolean;
+    quiet?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Build an OutputContext from CLI options. Accepts the new `--output` flag
+ * plus the legacy `--json` and `--format` flags for one-minor backwards
+ * compatibility (callers that hand-roll deprecation warnings should still do
+ * so explicitly via `lib/deprecation.ts`).
+ */
+export declare function resolveOutputContext(opts?: OutputOptions): OutputContext;
+/**
+ * Print the final result. Exactly one call per command.
+ * `textRenderer` receives the data and returns a single string for `text` mode.
+ */
+export declare function emit<T>(ctx: OutputContext, data: T, textRenderer: (data: T) => string): void;
+export interface FailOptions {
+    /** Short actionable hint ("Set SPEC0_TOKEN", "Run 'spec0 auth login'"). */
+    hint?: string;
+    /** Additional context the caller wants surfaced in the structured payload. */
+    details?: Record<string, unknown>;
+}
+/**
+ * Single structured failure point. Companions `emit()` — same output contract:
+ *
+ *   - In text mode: writes `message` (and hint, if given) to stderr. Matches
+ *     what the bare `exit(code, message)` helper produces, so human UX is
+ *     unchanged.
+ *   - In json / yaml mode: emits `{error: {code, message, hint?, details?}}`
+ *     on **stdout** so agents see one machine-readable document per invocation
+ *     regardless of success vs failure. The `code` field uses the symbolic
+ *     name ("AUTH_MISSING", "NOT_FOUND", …) from exit-codes.ts.
+ *
+ * Always exits with the numeric exit code — callers can rely on `never`.
+ */
+export declare function fail(ctx: OutputContext, code: ExitCodeValue, message: string, opts?: FailOptions): never;
+/** Guard against accidental use of GENERIC in fail(); callers should pick a specific code. */
+export declare function failGeneric(ctx: OutputContext, message: string, opts?: FailOptions): never;
+/** Progress / status — only printed when not `--quiet`. Always to stderr. */
+export declare function progress(ctx: OutputContext, message: string): void;
+/** Verbose-only diagnostic. */
+export declare function debug(ctx: OutputContext, message: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/output/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG9E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,aAAkB,GAAG,aAAa,CAkB5E;AAWD;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAY5F;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAClB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,KAAK,CAoBP;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,KAAK,CAE1F;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGlE;AAED,+BAA+B;AAC/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAG/D"}

package/dist/lib/output/index.js

@@ -0,0 +1,120 @@
+/**
+ * Unified output for every command. One way to do a thing — see ROADMAP.md.
+ *
+ * Usage:
+ *
+ *   const ctx = resolveOutputContext(opts);
+ *   emit(ctx, data, (d) => formatTextLines(d));
+ *
+ * - Progress / log messages always go to stderr (use `progress(ctx, msg)`).
+ * - Final result always goes to stdout via `emit()` — exactly one document.
+ * - Default format is `text`, auto-coloured when stdout is a TTY.
+ */
+import { stringify as yamlStringify } from "yaml";
+import { ExitCode, exitCodeName } from "../exit-codes.js";
+import { isAgentMode } from "../agent-mode.js";
+/**
+ * Build an OutputContext from CLI options. Accepts the new `--output` flag
+ * plus the legacy `--json` and `--format` flags for one-minor backwards
+ * compatibility (callers that hand-roll deprecation warnings should still do
+ * so explicitly via `lib/deprecation.ts`).
+ */
+export function resolveOutputContext(opts = {}) {
+    const fromOutput = normaliseFormat(opts.output);
+    const fromFormat = normaliseFormat(opts.format);
+    const fromJson = opts.json ? "json" : undefined;
+    // Agent mode: default format is json unless the caller passed an explicit
+    // --output / --format / --json flag.
+    const agent = isAgentMode();
+    const fallback = agent ? "json" : "text";
+    const format = (fromOutput ?? fromFormat ?? fromJson ?? fallback);
+    return {
+        format,
+        // Agent mode suppresses TTY heuristics (colour, progress bars) regardless
+        // of the actual stdout.
+        isTTY: agent ? false : Boolean(process.stdout.isTTY),
+        quiet: Boolean(opts.quiet) || agent,
+        verbose: Boolean(opts.verbose),
+    };
+}
+function normaliseFormat(raw) {
+    if (!raw)
+        return undefined;
+    const v = raw.toLowerCase().trim();
+    if (v === "text" || v === "json" || v === "yaml")
+        return v;
+    // Legacy --format=github survives until we add native annotations.
+    if (v === "github")
+        return "text";
+    return undefined;
+}
+/**
+ * Print the final result. Exactly one call per command.
+ * `textRenderer` receives the data and returns a single string for `text` mode.
+ */
+export function emit(ctx, data, textRenderer) {
+    if (ctx.format === "json") {
+        // Pretty when interactive so humans can read; compact when piped so
+        // downstream tools don't get extra whitespace they didn't ask for.
+        process.stdout.write(JSON.stringify(data, null, ctx.isTTY ? 2 : 0) + "\n");
+        return;
+    }
+    if (ctx.format === "yaml") {
+        process.stdout.write(yamlStringify(data));
+        return;
+    }
+    process.stdout.write(textRenderer(data) + "\n");
+}
+/**
+ * Single structured failure point. Companions `emit()` — same output contract:
+ *
+ *   - In text mode: writes `message` (and hint, if given) to stderr. Matches
+ *     what the bare `exit(code, message)` helper produces, so human UX is
+ *     unchanged.
+ *   - In json / yaml mode: emits `{error: {code, message, hint?, details?}}`
+ *     on **stdout** so agents see one machine-readable document per invocation
+ *     regardless of success vs failure. The `code` field uses the symbolic
+ *     name ("AUTH_MISSING", "NOT_FOUND", …) from exit-codes.ts.
+ *
+ * Always exits with the numeric exit code — callers can rely on `never`.
+ */
+export function fail(ctx, code, message, opts = {}) {
+    if (ctx.format === "json" || ctx.format === "yaml") {
+        const payload = {
+            error: {
+                code: exitCodeName(code),
+                message,
+                ...(opts.hint ? { hint: opts.hint } : {}),
+                ...(opts.details ? { details: opts.details } : {}),
+            },
+        };
+        if (ctx.format === "json") {
+            process.stdout.write(JSON.stringify(payload, null, ctx.isTTY ? 2 : 0) + "\n");
+        }
+        else {
+            process.stdout.write(yamlStringify(payload));
+        }
+    }
+    else {
+        const tail = opts.hint ? `${message}\n  ${opts.hint}` : message;
+        process.stderr.write(tail.endsWith("\n") ? tail : `${tail}\n`);
+    }
+    process.exit(code);
+}
+/** Guard against accidental use of GENERIC in fail(); callers should pick a specific code. */
+export function failGeneric(ctx, message, opts) {
+    return fail(ctx, ExitCode.GENERIC, message, opts);
+}
+/** Progress / status — only printed when not `--quiet`. Always to stderr. */
+export function progress(ctx, message) {
+    if (ctx.quiet)
+        return;
+    process.stderr.write(message.endsWith("\n") ? message : `${message}\n`);
+}
+/** Verbose-only diagnostic. */
+export function debug(ctx, message) {
+    if (!ctx.verbose)
+        return;
+    process.stderr.write(message.endsWith("\n") ? message : `${message}\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/output/index.js.map

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

package/dist/lib/output/table.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Table renderer. Wraps cli-table3 with a small, opinionated API:
+ *
+ *   renderTable(rows, [
+ *     { key: "name",    header: "Name" },
+ *     { key: "version", header: "Ver" },
+ *     { key: "team",    header: "Team", format: (v) => v ?? "—" },
+ *   ]);
+ *
+ * Always returns a string (caller decides where to write it). Uses no colour;
+ * the caller is responsible for any chalk wrapping if a TTY is attached.
+ */
+export interface ColumnSpec<T> {
+    key: keyof T & string;
+    header: string;
+    format?: (value: T[keyof T], row: T) => string;
+}
+export declare function renderTable<T extends Record<string, unknown>>(rows: T[], columns: ColumnSpec<T>[]): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/lib/output/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/lib/output/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;CAChD;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GACvB,MAAM,CAmCR"}

package/dist/lib/output/table.js

@@ -0,0 +1,48 @@
+/**
+ * Table renderer. Wraps cli-table3 with a small, opinionated API:
+ *
+ *   renderTable(rows, [
+ *     { key: "name",    header: "Name" },
+ *     { key: "version", header: "Ver" },
+ *     { key: "team",    header: "Team", format: (v) => v ?? "—" },
+ *   ]);
+ *
+ * Always returns a string (caller decides where to write it). Uses no colour;
+ * the caller is responsible for any chalk wrapping if a TTY is attached.
+ */
+import Table from "cli-table3";
+export function renderTable(rows, columns) {
+    const table = new Table({
+        head: columns.map((c) => c.header),
+        style: { head: [], border: [] }, // disable cli-table3's own colouring
+        chars: {
+            top: "─",
+            "top-mid": "┬",
+            "top-left": "┌",
+            "top-right": "┐",
+            bottom: "─",
+            "bottom-mid": "┴",
+            "bottom-left": "└",
+            "bottom-right": "┘",
+            left: "│",
+            "left-mid": "├",
+            mid: "─",
+            "mid-mid": "┼",
+            right: "│",
+            "right-mid": "┤",
+            middle: "│",
+        },
+    });
+    for (const row of rows) {
+        table.push(columns.map((c) => {
+            const v = row[c.key];
+            if (c.format)
+                return c.format(v, row);
+            if (v === null || v === undefined)
+                return "—";
+            return String(v);
+        }));
+    }
+    return table.toString();
+}
+//# sourceMappingURL=table.js.map

package/dist/lib/output/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/lib/output/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,YAAY,CAAC;AAQ/B,MAAM,UAAU,WAAW,CACzB,IAAS,EACT,OAAwB;IAExB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAClC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,qCAAqC;QACtE,KAAK,EAAE;YACL,GAAG,EAAE,GAAG;YACR,SAAS,EAAE,GAAG;YACd,UAAU,EAAE,GAAG;YACf,WAAW,EAAE,GAAG;YAChB,MAAM,EAAE,GAAG;YACX,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,GAAG;YAClB,cAAc,EAAE,GAAG;YACnB,IAAI,EAAE,GAAG;YACT,UAAU,EAAE,GAAG;YACf,GAAG,EAAE,GAAG;YACR,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,GAAG;YAChB,MAAM,EAAE,GAAG;SACZ;KACF,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAChB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAe,EAAE,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO,GAAG,CAAC;YAC9C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Formatters: text, json, github (GH Actions annotations)
+ */
+export type OutputFormat = "text" | "json" | "github";
+export declare function formatLintText(result: {
+    score: number;
+    errors: Array<{
+        line?: number;
+        message: string;
+        rule: string;
+    }>;
+    warnings: Array<{
+        line?: number;
+        message: string;
+        rule: string;
+    }>;
+}): string;
+export declare function formatPublishText(output: {
+    apiId: string;
+    version: string;
+    specUrl: string;
+    mockUrl?: string;
+    apiName?: string;
+    teamName?: string;
+    registryUrl?: string;
+    noChanges?: boolean;
+    versionUnchanged?: boolean;
+    versionUnchangedHint?: string;
+    created?: boolean;
+}): string;
+export declare function formatGitHubAnnotation(file: string, line: number, level: "error" | "warning", message: string): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE,GAAG,MAAM,CAsBT;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CAgCT;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}

package/dist/lib/output.js

@@ -0,0 +1,64 @@
+/**
+ * Formatters: text, json, github (GH Actions annotations)
+ */
+import chalk from "chalk";
+export function formatLintText(result) {
+    const lines = [];
+    lines.push(`  Score: ${result.score}/100`);
+    lines.push("");
+    lines.push(`  Errors (${result.errors.length}):`);
+    for (const e of result.errors) {
+        lines.push(`    line ${e.line ?? "?"}  ${e.rule}  ${e.message}`);
+    }
+    if (result.errors.length === 0)
+        lines.push("    (none)");
+    lines.push("");
+    lines.push(`  Warnings (${result.warnings.length}):`);
+    for (const w of result.warnings) {
+        lines.push(`    line ${w.line ?? "?"}  ${w.rule}  ${w.message}`);
+    }
+    if (result.warnings.length === 0)
+        lines.push("    (none)");
+    lines.push("");
+    if (result.errors.length === 0) {
+        lines.push(chalk.green("  ✓ 0 errors. Spec is publishable."));
+    }
+    else {
+        lines.push(chalk.red(`  ✗ ${result.errors.length} errors. Fix before publishing.`));
+    }
+    return lines.join("\n");
+}
+export function formatPublishText(output) {
+    const lines = [];
+    if (output.noChanges) {
+        lines.push(chalk.green("✓ Already up to date") + chalk.gray(" (git SHA unchanged)"));
+        if (output.apiName)
+            lines.push(`  api:      ${output.apiName} @ v${output.version}`);
+        if (output.registryUrl)
+            lines.push(`  registry: ${output.registryUrl}`);
+        return lines.join("\n");
+    }
+    const label = output.created ? chalk.green("✓ Created") : chalk.green("✓ Updated");
+    const nameLabel = output.apiName ?? output.apiId;
+    lines.push(`${label} ${chalk.bold(nameLabel)} v${output.version}`);
+    if (output.apiName)
+        lines.push(`  api:      ${output.apiName}`);
+    if (output.teamName)
+        lines.push(`  team:     ${output.teamName}`);
+    if (output.registryUrl)
+        lines.push(`  registry: ${output.registryUrl}`);
+    lines.push(`  spec page: ${output.specUrl}`);
+    if (output.mockUrl)
+        lines.push(`  mock:     ${output.mockUrl}`);
+    if (output.versionUnchanged) {
+        lines.push("");
+        lines.push(chalk.yellow("⚠ ") +
+            chalk.yellow(output.versionUnchangedHint ??
+                `Spec changed but version is still ${output.version}. Pass --semver to auto-bump.`));
+    }
+    return lines.join("\n");
+}
+export function formatGitHubAnnotation(file, line, level, message) {
+    return `::${level} file=${file},line=${line}::${message.replace(/\n/g, "%0A")}`;
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

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

package/dist/lib/platform-defaults.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Two origins — do not conflate them:
+ *
+ * - **`SPEC0_APP_URL`** — Web app only: opening the browser for `spec0 auth login`
+ *   (`/cli-auth`). Also used when printing dashboard links in `spec0 push` output (`specUrl`);
+ *   that is not an API request.
+ * - **`SPEC0_API_URL`** — Spring backend base for **all** programmatic HTTP (push, pull, mock,
+ *   lint, search, registry, …). Stored on login as `org.apiUrl` and used by
+ *   `createOrgApiClient` / `createApiClient`.
+ *
+ * Defaults below match local dev (Next :3000, Spring :8080 + context path). Override both for
+ * staging/production. `SPEC0_API_URL` should align with `NEXT_PUBLIC_API_BASE_URL` in
+ * api-management-ui, not the Next.js site origin alone.
+ *
+ * Legacy: `PLATFORM_APP_URL` / `PLATFORM_API_URL` are still accepted as fallbacks.
+ */
+/** Next.js / browser app — CLI auth (`/cli-auth`) and push output links. */
+export declare const DEFAULT_PLATFORM_APP_URL = "https://app.spec0.io";
+/**
+ * Spring Boot API base (include servlet context path if your deploy uses one).
+ */
+export declare const DEFAULT_PLATFORM_API_URL = "https://api.spec0.io/api-management";
+/** Web app origin for auth + UI links — never used as the REST base. */
+export declare function resolvedPlatformAppUrl(): string;
+/** Backend base for all CLI REST calls — never derived from the app URL. */
+export declare function resolvedPlatformApiUrl(): string;
+//# sourceMappingURL=platform-defaults.d.ts.map

package/dist/lib/platform-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-defaults.d.ts","sourceRoot":"","sources":["../../src/lib/platform-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAM9E,wEAAwE;AACxE,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C"}