specforge-cli 0.1.1

package/dist/lib/auth.js

@@ -0,0 +1,92 @@
+import { loadConfig, saveConfig } from "./config";
+import { ExitCode } from "./exit-codes";
+/**
+ * Resolve auth credentials by priority:
+ * 1. SPECFORGE_API_KEY env var
+ * 2. --api-key CLI flag
+ * 3. Config file credential
+ * 4. Legacy config accessToken (auto-migrate)
+ * 5. None → error + exit
+ */
+export function resolveAuth(args) {
+    // 1. Env var (highest priority — CI/CD override)
+    const envKey = process.env.SPECFORGE_API_KEY;
+    if (envKey) {
+        return { token: envKey, source: "env", expiresAt: null };
+    }
+    // 2. CLI flag (one-off override)
+    if (args?.apiKey) {
+        return { token: args.apiKey, source: "api-key", expiresAt: null };
+    }
+    // 3. Config file (persistent login)
+    const config = loadConfig();
+    // 3a. New credential format
+    if (config.credential?.token) {
+        if (config.credential.expiresAt && new Date(config.credential.expiresAt) < new Date()) {
+            console.error("Session expired. Run `specforge auth login` to re-authenticate.");
+            process.exit(ExitCode.AUTH_ERROR);
+        }
+        return config.credential;
+    }
+    // 3b. Legacy format (auto-migrate)
+    if (config.accessToken) {
+        const cred = {
+            token: config.accessToken,
+            source: "oauth",
+            expiresAt: null,
+        };
+        // Auto-migrate to new format
+        saveCredential(cred);
+        return cred;
+    }
+    // 4. No credentials
+    console.error("Not authenticated. Run `specforge auth login` first.");
+    process.exit(ExitCode.AUTH_ERROR);
+}
+export function saveCredential(credential) {
+    const config = loadConfig();
+    const updated = {
+        ...config,
+        credential,
+    };
+    delete updated.accessToken; // Remove legacy field
+    saveConfig(updated);
+}
+export function clearCredential() {
+    const config = loadConfig();
+    const updated = { ...config };
+    delete updated.credential;
+    delete updated.accessToken;
+    saveConfig(updated);
+}
+export function getAuthStatus() {
+    // Check env var directly (avoids process.exit from resolveAuth)
+    const envKey = process.env.SPECFORGE_API_KEY;
+    if (envKey) {
+        return {
+            authenticated: true,
+            credential: { token: envKey, source: "env", expiresAt: null },
+        };
+    }
+    const config = loadConfig();
+    // Check new credential format
+    if (config.credential?.token) {
+        if (config.credential.expiresAt && new Date(config.credential.expiresAt) < new Date()) {
+            return { authenticated: false };
+        }
+        return { authenticated: true, credential: config.credential };
+    }
+    // Check legacy format
+    if (config.accessToken) {
+        return {
+            authenticated: true,
+            credential: {
+                token: config.accessToken,
+                source: "oauth",
+                expiresAt: null,
+            },
+        };
+    }
+    return { authenticated: false };
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAUxC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAA0B;IACrD,iDAAiD;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;IAED,oCAAoC;IACpC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,4BAA4B;IAC5B,IAAI,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YACvF,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,MAAM,CAAC,UAAU,CAAC;IAC1B,CAAC;IAED,mCAAmC;IACnC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,GAAmB;YAC5B,KAAK,EAAE,MAAM,CAAC,WAAW;YACzB,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,IAAI;SACf,CAAC;QACF,6BAA6B;QAC7B,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,oBAAoB;IACpB,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAA0B;IACxD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAoB;QAChC,GAAG,MAAM;QACT,UAAU;KACV,CAAC;IACF,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,sBAAsB;IAClD,UAAU,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,eAAe;IAC9B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAoB,EAAE,GAAG,MAAM,EAAE,CAAC;IAC/C,OAAO,OAAO,CAAC,UAAU,CAAC;IAC1B,OAAO,OAAO,CAAC,WAAW,CAAC;IAC3B,UAAU,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa;IAI5B,gEAAgE;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,MAAM,EAAE,CAAC;QACZ,OAAO;YACN,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE;SAC7D,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,8BAA8B;IAC9B,IAAI,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YACvF,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QACD,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC/D,CAAC;IAED,sBAAsB;IACtB,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO;YACN,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE;gBACX,KAAK,EAAE,MAAM,CAAC,WAAW;gBACzB,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,IAAI;aACf;SACD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/lib/client.d.ts

@@ -0,0 +1,6 @@
+export type CliClientConfig = {
+    readonly baseUrl: string;
+    readonly accessToken: string;
+};
+export declare function createCliClient(config: CliClientConfig): import("specforge-sdk").SpecKitClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,yCAKtD"}

package/dist/lib/client.js

@@ -0,0 +1,8 @@
+import { createClient } from "specforge-sdk";
+export function createCliClient(config) {
+    return createClient({
+        baseUrl: config.baseUrl,
+        auth: { accessToken: config.accessToken },
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAO7C,MAAM,UAAU,eAAe,CAAC,MAAuB;IACtD,OAAO,YAAY,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;KACzC,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,15 @@
+export interface SpecForgeConfig {
+    baseUrl: string;
+    accessToken?: string;
+    credential?: {
+        token: string;
+        source: "env" | "api-key" | "oauth";
+        expiresAt: string | null;
+    };
+    defaultProjectId?: string;
+}
+export declare function loadConfig(): SpecForgeConfig;
+export declare function saveConfig(config: SpecForgeConfig): void;
+export declare function getConfigPath(): string;
+export declare function requireAuth(config: SpecForgeConfig): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;QACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD,wBAAgB,UAAU,IAAI,eAAe,CAU5C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAGxD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAM3D"}

package/dist/lib/config.js

@@ -0,0 +1,41 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { ExitCode } from "./exit-codes";
+const CONFIG_DIR = join(homedir(), ".specforge");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const DEFAULT_CONFIG = {
+    baseUrl: "https://api.specforge.dev",
+};
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const raw = readFileSync(CONFIG_FILE, "utf-8");
+        return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+export function saveConfig(config) {
+    ensureConfigDir();
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+export function requireAuth(config) {
+    if (!config.accessToken) {
+        console.error("Not authenticated. Run `specforge auth login` first.");
+        process.exit(ExitCode.AUTH_ERROR);
+    }
+    return config.accessToken;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAapD,MAAM,cAAc,GAAoB;IACvC,OAAO,EAAE,2BAA2B;CACpC,CAAC;AAEF,SAAS,eAAe;IACvB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU;IACzB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC9B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAuB;IACjD,eAAe,EAAE,CAAC;IAClB,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,aAAa;IAC5B,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAuB;IAClD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC;AAC3B,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,21 @@
+export { ExitCode, exitCodeFromStatus } from "./exit-codes";
+export declare function handleError(error: unknown): never;
+interface ApiErrorDetail {
+    field: string;
+    message: string;
+}
+interface ApiError {
+    code?: string;
+    message?: string;
+    status?: number;
+    error?: ApiError;
+    details?: ApiErrorDetail[];
+}
+export declare function handleApiResult(result: {
+    data?: unknown;
+    error?: ApiError;
+    response?: {
+        status: number;
+    };
+}): unknown;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE5D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAuBjD;AAED,UAAU,cAAc;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,QAAQ;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B,GAAG,OAAO,CAcV"}

package/dist/lib/errors.js

@@ -0,0 +1,41 @@
+import { isSpecKitError } from "specforge-sdk";
+import { ExitCode, exitCodeFromStatus } from "./exit-codes";
+export { ExitCode, exitCodeFromStatus } from "./exit-codes";
+export function handleError(error) {
+    if (isSpecKitError(error)) {
+        const code = exitCodeFromStatus(error.status);
+        console.error(`Error [${error.code}]: ${error.message}`);
+        if (error.details?.length) {
+            for (const detail of error.details) {
+                console.error(`  - ${detail.field}: ${detail.message}`);
+            }
+        }
+        process.exit(code);
+    }
+    if (error instanceof Error) {
+        if (error.message.includes("fetch") || error.message.includes("ECONNREFUSED")) {
+            console.error(`Network error: ${error.message}`);
+            process.exit(ExitCode.GENERAL_ERROR);
+        }
+        console.error(`Error: ${error.message}`);
+        process.exit(ExitCode.GENERAL_ERROR);
+    }
+    console.error("An unexpected error occurred.");
+    process.exit(ExitCode.GENERAL_ERROR);
+}
+export function handleApiResult(result) {
+    if (result.error) {
+        const err = result.error.error ?? result.error;
+        const status = result.response?.status ?? err.status ?? 500;
+        const code = exitCodeFromStatus(status);
+        console.error(`Error [${err.code ?? "UNKNOWN"}]: ${err.message ?? "Unknown error"}`);
+        if (err.details?.length) {
+            for (const detail of err.details) {
+                console.error(`  - ${detail.field}: ${detail.message}`);
+            }
+        }
+        process.exit(code);
+    }
+    return result.data;
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACpC,OAAO,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;QACF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC/E,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAeD,MAAM,UAAU,eAAe,CAAC,MAI/B;IACA,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;QAC5D,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,IAAI,SAAS,MAAM,GAAG,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;QACrF,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACzB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;QACF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/lib/exit-codes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CLI exit codes as defined in the CLI contract.
+ *
+ * @see specs/001-spec-versioning-saas/contracts/cli-commands.md
+ *
+ * | Code | Meaning          |
+ * | ---- | ---------------- |
+ * | 0    | Success          |
+ * | 1    | General error    |
+ * | 2    | Auth error       |
+ * | 3    | Validation error |
+ * | 4    | Not found        |
+ * | 5    | Permission denied|
+ * | 6    | Conflict         |
+ */
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly AUTH_ERROR: 2;
+    readonly VALIDATION_ERROR: 3;
+    readonly NOT_FOUND: 4;
+    readonly PERMISSION_DENIED: 5;
+    readonly CONFLICT: 6;
+};
+export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+/**
+ * Map an HTTP status code to the appropriate CLI exit code.
+ */
+export declare function exitCodeFromStatus(status: number): ExitCode;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/lib/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/lib/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ;;;;;;;;CAQX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAO3D"}

package/dist/lib/exit-codes.js

@@ -0,0 +1,41 @@
+/**
+ * CLI exit codes as defined in the CLI contract.
+ *
+ * @see specs/001-spec-versioning-saas/contracts/cli-commands.md
+ *
+ * | Code | Meaning          |
+ * | ---- | ---------------- |
+ * | 0    | Success          |
+ * | 1    | General error    |
+ * | 2    | Auth error       |
+ * | 3    | Validation error |
+ * | 4    | Not found        |
+ * | 5    | Permission denied|
+ * | 6    | Conflict         |
+ */
+export const ExitCode = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    AUTH_ERROR: 2,
+    VALIDATION_ERROR: 3,
+    NOT_FOUND: 4,
+    PERMISSION_DENIED: 5,
+    CONFLICT: 6,
+};
+/**
+ * Map an HTTP status code to the appropriate CLI exit code.
+ */
+export function exitCodeFromStatus(status) {
+    if (status === 401)
+        return ExitCode.AUTH_ERROR;
+    if (status === 403)
+        return ExitCode.PERMISSION_DENIED;
+    if (status === 404)
+        return ExitCode.NOT_FOUND;
+    if (status === 400 || status === 422)
+        return ExitCode.VALIDATION_ERROR;
+    if (status === 409)
+        return ExitCode.CONFLICT;
+    return ExitCode.GENERAL_ERROR;
+}
+//# 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;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,UAAU,EAAE,CAAC;IACb,gBAAgB,EAAE,CAAC;IACnB,SAAS,EAAE,CAAC;IACZ,iBAAiB,EAAE,CAAC;IACpB,QAAQ,EAAE,CAAC;CACF,CAAC;AAIX;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAChD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAC;IAC/C,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,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,gBAAgB,CAAC;IACvE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC7C,OAAO,QAAQ,CAAC,aAAa,CAAC;AAC/B,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Output helpers for JSON and table formatting.
+ */
+export declare function outputJson(data: unknown): void;
+export declare function outputTable(rows: Record<string, unknown>[], columns?: string[]): void;
+export declare function outputResult(data: unknown, json: boolean, columns?: string[]): void;
+//# 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;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAuCrF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAmBnF"}

package/dist/lib/output.js

@@ -0,0 +1,60 @@
+/**
+ * Output helpers for JSON and table formatting.
+ */
+export function outputJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+export function outputTable(rows, columns) {
+    if (rows.length === 0) {
+        console.log("No results.");
+        return;
+    }
+    const firstRow = rows[0];
+    const keys = columns ?? (firstRow ? Object.keys(firstRow) : []);
+    // Calculate column widths
+    const widths = new Map();
+    for (const key of keys) {
+        widths.set(key, key.length);
+    }
+    for (const row of rows) {
+        for (const key of keys) {
+            const value = String(row[key] ?? "");
+            const current = widths.get(key) ?? 0;
+            if (value.length > current) {
+                widths.set(key, Math.min(value.length, 60));
+            }
+        }
+    }
+    // Header
+    const header = keys.map((k) => k.toUpperCase().padEnd(widths.get(k) ?? 0)).join("  ");
+    console.log(header);
+    console.log(keys.map((k) => "-".repeat(widths.get(k) ?? 0)).join("  "));
+    // Rows
+    for (const row of rows) {
+        const line = keys
+            .map((k) => {
+            const value = String(row[k] ?? "");
+            return value.slice(0, 60).padEnd(widths.get(k) ?? 0);
+        })
+            .join("  ");
+        console.log(line);
+    }
+}
+export function outputResult(data, json, columns) {
+    if (json) {
+        outputJson(data);
+        return;
+    }
+    if (Array.isArray(data)) {
+        outputTable(data, columns);
+        return;
+    }
+    if (typeof data === "object" && data !== null) {
+        for (const [key, value] of Object.entries(data)) {
+            console.log(`${key}: ${typeof value === "object" ? JSON.stringify(value) : value}`);
+        }
+        return;
+    }
+    console.log(String(data));
+}
+//# 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/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "specforge-cli",
+	"version": "0.1.1",
+	"description": "SpecForge CLI — specification versioning and signing from the terminal",
+	"type": "module",
+	"bin": {
+		"specforge": "./dist/index.js"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"typecheck": "tsc --noEmit",
+		"build": "tsc",
+		"prepublishOnly": "tsc",
+		"test": "vitest run"
+	},
+	"keywords": [
+		"specforge",
+		"cli",
+		"specifications",
+		"versioning",
+		"signing"
+	],
+	"license": "MIT",
+	"author": "Léo Brival",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/leobrival/specifications",
+		"directory": "packages/cli"
+	},
+	"dependencies": {
+		"specforge-sdk": "0.1.0",
+		"citty": "^0.1.6"
+	},
+	"devDependencies": {
+		"typescript": "^5",
+		"vitest": "^4.1.0"
+	}
+}