@spec0/cli 0.1.0

package/dist/lib/platform-defaults.js

@@ -0,0 +1,36 @@
+/**
+ * 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 const DEFAULT_PLATFORM_APP_URL = "https://app.spec0.io";
+/**
+ * Spring Boot API base (include servlet context path if your deploy uses one).
+ */
+export const DEFAULT_PLATFORM_API_URL = "https://api.spec0.io/api-management";
+function normalizeOrigin(url) {
+    return url.trim().replace(/\/$/, "");
+}
+/** Web app origin for auth + UI links — never used as the REST base. */
+export function resolvedPlatformAppUrl() {
+    const raw = (process.env.SPEC0_APP_URL ?? process.env.PLATFORM_APP_URL)?.trim();
+    return normalizeOrigin(raw || DEFAULT_PLATFORM_APP_URL);
+}
+/** Backend base for all CLI REST calls — never derived from the app URL. */
+export function resolvedPlatformApiUrl() {
+    const raw = (process.env.SPEC0_API_URL ?? process.env.PLATFORM_API_URL)?.trim();
+    return normalizeOrigin(raw || DEFAULT_PLATFORM_API_URL);
+}
+//# sourceMappingURL=platform-defaults.js.map

package/dist/lib/platform-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-defaults.js","sourceRoot":"","sources":["../../src/lib/platform-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,qCAAqC,CAAC;AAE9E,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC;IAChF,OAAO,eAAe,CAAC,GAAG,IAAI,wBAAwB,CAAC,CAAC;AAC1D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC;IAChF,OAAO,eAAe,CAAC,GAAG,IAAI,wBAAwB,CAAC,CAAC;AAC1D,CAAC"}

package/dist/lib/ref-resolver.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Single source of truth for parsing `<ref>` arguments.
+ *
+ * Accepts:
+ *   - `<org>/<api>[@<tag>]`        — full registry ref
+ *   - `<api>[@<tag>]`              — uses caller-supplied default org slug
+ *   - `<uuid>`                     — API id (no org/api lookup needed)
+ *
+ * For commands that need an apiId from a name, call `resolveApiId(client, ref)`
+ * which hits `/apis/summary` and caches per-process.
+ */
+/** Minimal structural type — avoids dragging the full client surface in. */
+interface ApiSummaryClient {
+    getJson(path: string): Promise<unknown>;
+}
+export type ResolvedRef = {
+    kind: "uuid";
+    apiId: string;
+    tag?: undefined;
+} | {
+    kind: "name";
+    org: string | undefined;
+    api: string;
+    tag?: string;
+};
+export interface ResolveOptions {
+    /** Fallback org slug used when the ref omits one (e.g. plain `api-name`). */
+    defaultOrg?: string;
+}
+export declare function resolveRef(ref: string, opts?: ResolveOptions): ResolvedRef;
+/**
+ * Resolve an apiId from a ref. UUIDs pass through; names hit `/apis/summary`.
+ * Cached per-process so repeated calls in one command are free.
+ */
+export declare function resolveApiId(client: ApiSummaryClient, ref: ResolvedRef): Promise<string>;
+export {};
+//# sourceMappingURL=ref-resolver.d.ts.map

package/dist/lib/ref-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/ref-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,4EAA4E;AAC5E,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAID,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,SAAS,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,WAAW,CAsB9E;AASD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB9F"}

package/dist/lib/ref-resolver.js

@@ -0,0 +1,56 @@
+/**
+ * Single source of truth for parsing `<ref>` arguments.
+ *
+ * Accepts:
+ *   - `<org>/<api>[@<tag>]`        — full registry ref
+ *   - `<api>[@<tag>]`              — uses caller-supplied default org slug
+ *   - `<uuid>`                     — API id (no org/api lookup needed)
+ *
+ * For commands that need an apiId from a name, call `resolveApiId(client, ref)`
+ * which hits `/apis/summary` and caches per-process.
+ */
+import { parseRegistryRef } from "./registry-ref.js";
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function resolveRef(ref, opts = {}) {
+    const trimmed = ref.trim();
+    if (!trimmed)
+        throw new Error("Empty ref. Expected <org>/<api>[@<tag>] or a UUID.");
+    if (UUID_RE.test(trimmed)) {
+        return { kind: "uuid", apiId: trimmed };
+    }
+    if (trimmed.includes("/")) {
+        const p = parseRegistryRef(trimmed);
+        return { kind: "name", org: p.org, api: p.api, tag: p.tag };
+    }
+    // No slash + not a UUID → treat as `<api>[@<tag>]` against defaultOrg.
+    let api = trimmed;
+    let tag;
+    const at = trimmed.lastIndexOf("@");
+    if (at !== -1) {
+        tag = trimmed.slice(at + 1);
+        api = trimmed.slice(0, at);
+    }
+    return { kind: "name", org: opts.defaultOrg, api, tag };
+}
+const idCache = new Map(); // key = `${org}/${api}` → apiId
+/**
+ * Resolve an apiId from a ref. UUIDs pass through; names hit `/apis/summary`.
+ * Cached per-process so repeated calls in one command are free.
+ */
+export async function resolveApiId(client, ref) {
+    if (ref.kind === "uuid")
+        return ref.apiId;
+    const key = `${ref.org ?? ""}/${ref.api}`;
+    const cached = idCache.get(key);
+    if (cached)
+        return cached;
+    const rows = (await client.getJson("/apis/summary"));
+    const wantedName = ref.api.toLowerCase();
+    const hit = rows.find((r) => (r.apiName ?? "").toLowerCase() === wantedName);
+    if (!hit?.apiId) {
+        throw new Error(`No API named '${ref.api}' found${ref.org ? ` in '${ref.org}'` : ""}. Run 'spec0 api list' to see what exists.`);
+    }
+    idCache.set(key, hit.apiId);
+    return hit.apiId;
+}
+//# sourceMappingURL=ref-resolver.js.map

package/dist/lib/ref-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.js","sourceRoot":"","sources":["../../src/lib/ref-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOrD,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAWlF,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAAuB,EAAE;IAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAEpF,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IAC9D,CAAC;IAED,uEAAuE;IACvE,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,IAAI,GAAuB,CAAC;IAC5B,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACd,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5B,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC1D,CAAC;AAOD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,gCAAgC;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAwB,EAAE,GAAgB;IAC3E,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IAE1C,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAiB,CAAC;IACrE,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IAC7E,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,iBAAiB,GAAG,CAAC,GAAG,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,4CAA4C,CAChH,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,GAAG,CAAC,KAAK,CAAC;AACnB,CAAC"}

package/dist/lib/registry-ref.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parse registry refs like acme/order-api or acme/order-api@v1.2.0
+ */
+export interface ParsedRegistryRef {
+    org: string;
+    api: string;
+    tag?: string;
+}
+export declare function parseRegistryRef(ref: string): ParsedRegistryRef;
+//# sourceMappingURL=registry-ref.d.ts.map

package/dist/lib/registry-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-ref.d.ts","sourceRoot":"","sources":["../../src/lib/registry-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAa/D"}

package/dist/lib/registry-ref.js

@@ -0,0 +1,18 @@
+/**
+ * Parse registry refs like acme/order-api or acme/order-api@v1.2.0
+ */
+export function parseRegistryRef(ref) {
+    let rest = ref.trim();
+    let tag;
+    const at = rest.lastIndexOf("@");
+    if (at !== -1) {
+        tag = rest.slice(at + 1);
+        rest = rest.slice(0, at);
+    }
+    const slash = rest.indexOf("/");
+    if (slash === -1) {
+        throw new Error("Expected <org-slug>/<api-name>[@version]");
+    }
+    return { org: rest.slice(0, slash), api: rest.slice(slash + 1), tag };
+}
+//# sourceMappingURL=registry-ref.js.map

package/dist/lib/registry-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-ref.js","sourceRoot":"","sources":["../../src/lib/registry-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,GAAuB,CAAC;IAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACd,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;AACxE,CAAC"}

package/dist/lib/spec-finder.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Find openapi.yaml / openapi.json in current repo
+ */
+export declare function findSpecInDir(cwd?: string): string | null;
+export declare function findSpecsInMonorepo(cwd: string): string[];
+//# sourceMappingURL=spec-finder.d.ts.map

package/dist/lib/spec-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-finder.d.ts","sourceRoot":"","sources":["../../src/lib/spec-finder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAMxE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBzD"}

package/dist/lib/spec-finder.js

@@ -0,0 +1,42 @@
+/**
+ * Find openapi.yaml / openapi.json in current repo
+ */
+import { existsSync, readdirSync } from "fs";
+import { join } from "path";
+const DEFAULT_SPEC_NAMES = [
+    "openapi.yaml",
+    "openapi.yml",
+    "openapi.json",
+    "swagger.yaml",
+    "swagger.json",
+    "api-spec.yaml",
+    "api-spec.json",
+];
+export function findSpecInDir(cwd = process.cwd()) {
+    for (const name of DEFAULT_SPEC_NAMES) {
+        const p = join(cwd, name);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+export function findSpecsInMonorepo(cwd) {
+    const found = [];
+    // Simple scan: look for .spec0.yaml in subdirs, then resolve spec from each
+    // For v1, just scan one level
+    try {
+        const entries = readdirSync(cwd, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.isDirectory() && !e.name.startsWith(".")) {
+                const subSpec = findSpecInDir(join(cwd, e.name));
+                if (subSpec)
+                    found.push(subSpec);
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return found;
+}
+//# sourceMappingURL=spec-finder.js.map

package/dist/lib/spec-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-finder.js","sourceRoot":"","sources":["../../src/lib/spec-finder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,kBAAkB,GAAG;IACzB,cAAc;IACd,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,eAAe;IACf,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACvD,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjD,IAAI,OAAO;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/update-check.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Non-blocking update check against npm registry.
+ * Caches the result for 24 hours in ~/.spec0/config.json.
+ * Only runs in interactive (non-CI) terminals.
+ */
+export declare function isNewer(candidate: string, current: string): boolean;
+/**
+ * Prints an update notice if a newer version was cached from the last check.
+ * Then fires a background fetch to refresh the cache (fire-and-forget).
+ */
+export declare function notifyUpdateIfAvailable(currentVersion: string): void;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/lib/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/lib/update-check.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQnE;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAgCpE"}

package/dist/lib/update-check.js

@@ -0,0 +1,62 @@
+/**
+ * Non-blocking update check against npm registry.
+ * Caches the result for 24 hours in ~/.spec0/config.json.
+ * Only runs in interactive (non-CI) terminals.
+ */
+import chalk from "chalk";
+import Conf from "conf";
+const store = new Conf({
+    projectName: "spec0-update",
+    defaults: { lastCheck: 0, latestVersion: "" },
+});
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 1 day
+export function isNewer(candidate, current) {
+    const c = candidate.split(".").map(Number);
+    const v = current.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((c[i] ?? 0) > (v[i] ?? 0))
+            return true;
+        if ((c[i] ?? 0) < (v[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+function shouldSkip() {
+    return !!(process.env.CI || process.env.GITHUB_ACTIONS || !process.stdout.isTTY);
+}
+/**
+ * Prints an update notice if a newer version was cached from the last check.
+ * Then fires a background fetch to refresh the cache (fire-and-forget).
+ */
+export function notifyUpdateIfAvailable(currentVersion) {
+    if (shouldSkip())
+        return;
+    const cached = store.get("latestVersion");
+    if (cached && isNewer(cached, currentVersion)) {
+        process.stderr.write("\n" +
+            chalk.yellow(`  Update available: `) +
+            chalk.bold(`${currentVersion} → ${cached}`) +
+            "\n" +
+            chalk.gray(`  Run `) +
+            chalk.cyan(`npm install -g @spec0/cli`) +
+            chalk.gray(` to update\n`) +
+            "\n");
+    }
+    const now = Date.now();
+    const lastCheck = store.get("lastCheck", 0);
+    if (now - lastCheck < CHECK_INTERVAL_MS)
+        return;
+    // Fire-and-forget background fetch
+    store.set("lastCheck", now);
+    fetch("https://registry.npmjs.org/@spec0/cli/latest", {
+        signal: AbortSignal.timeout(3000),
+    })
+        .then((r) => r.json())
+        .then((data) => {
+        const latest = data.version;
+        if (latest)
+            store.set("latestVersion", latest);
+    })
+        .catch(() => { });
+}
+//# sourceMappingURL=update-check.js.map

package/dist/lib/update-check.js.map

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

package/dist/lib/version.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI version from package.json next to dist/ (works when installed or from repo root).
+ */
+export type VersionInfo = {
+    name: string;
+    version: string;
+    node: string;
+    /** Set via SPEC0_CLI_GIT_REF for local multi-branch builds */
+    gitRef?: string;
+};
+export declare function readPackageVersion(): {
+    name: string;
+    version: string;
+};
+export declare function getCliVersion(): string;
+export declare function getVersionInfo(): VersionInfo;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAQF,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAOtE;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,cAAc,IAAI,WAAW,CAS5C"}

package/dist/lib/version.js

@@ -0,0 +1,33 @@
+/**
+ * CLI version from package.json next to dist/ (works when installed or from repo root).
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function packageJsonPath() {
+    const dir = dirname(fileURLToPath(import.meta.url));
+    // dist/lib/version.js -> ../../package.json
+    return join(dir, "..", "..", "package.json");
+}
+export function readPackageVersion() {
+    const raw = readFileSync(packageJsonPath(), "utf8");
+    const pkg = JSON.parse(raw);
+    return {
+        name: pkg.name ?? "@spec0/cli",
+        version: pkg.version ?? "0.0.0",
+    };
+}
+export function getCliVersion() {
+    return readPackageVersion().version;
+}
+export function getVersionInfo() {
+    const { name, version } = readPackageVersion();
+    const gitRef = process.env.SPEC0_CLI_GIT_REF?.trim() || undefined;
+    return {
+        name,
+        version,
+        node: process.version,
+        ...(gitRef ? { gitRef } : {}),
+    };
+}
+//# sourceMappingURL=version.js.map

package/dist/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUzC,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,4CAA4C;IAC5C,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwC,CAAC;IACnE,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,YAAY;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,kBAAkB,EAAE,CAAC,OAAO,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IAClE,OAAO;QACL,IAAI;QACJ,OAAO;QACP,IAAI,EAAE,OAAO,CAAC,OAAO;QACrB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/lib/winspect-yaml.d.ts

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

package/dist/lib/winspect-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winspect-yaml.d.ts","sourceRoot":"","sources":["../../src/lib/winspect-yaml.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,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,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAOjE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAKrE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAG9D"}

package/dist/lib/winspect-yaml.js

@@ -0,0 +1,28 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import YAML from "yaml";
+export function loadWinspectYaml(cwd) {
+    const path = join(cwd, ".winspect.yaml");
+    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=winspect-yaml.js.map

package/dist/lib/winspect-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winspect-yaml.js","sourceRoot":"","sources":["../../src/lib/winspect-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;AAaxB,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IACzC,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,GAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAsB;IAC1D,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;AAED,MAAM,UAAU,cAAc,CAAC,CAAsB;IACnD,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACpB,CAAC"}