@inquir/compute-cli 0.1.2 → 0.1.4

package/dist/utils/errors.d.ts

@@ -0,0 +1,54 @@
+/** Exit-code taxonomy (see docs/cli-product-spec.md §6.4). */
+export declare const ExitCode: {
+    readonly OK: 0;
+    readonly ERROR: 1;
+    readonly USAGE: 2;
+    readonly NETWORK: 3;
+    readonly AUTH: 4;
+};
+export interface CliErrorOptions {
+    /** Stable, machine-readable code (mirrors backend error.code when available). */
+    code?: string;
+    exitCode?: number;
+    /** One-line human explanation. */
+    explanation?: string;
+    /** Likely cause. */
+    cause?: string;
+    /** Suggested fix. */
+    fix?: string;
+    /** A command the user can copy/paste. */
+    command?: string;
+    /** Backend request id, if any. */
+    requestId?: string;
+    /** Extra detail shown only with --debug. */
+    details?: unknown;
+}
+/**
+ * A user-facing error with everything needed to render an actionable message:
+ * title, explanation, cause, fix, a suggested command, and a request id.
+ */
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly explanation?: string;
+    readonly cause?: string;
+    readonly fix?: string;
+    readonly command?: string;
+    readonly requestId?: string;
+    readonly details?: unknown;
+    constructor(title: string, options?: CliErrorOptions);
+    /** The short title (the Error message). */
+    get title(): string;
+}
+/** Normalize any thrown value into a {@link CliError}. */
+export declare function toCliError(error: unknown): CliError;
+/** Render a CliError to the user. Honours --json and --debug. */
+export declare function renderError(error: CliError, options: {
+    json?: boolean;
+    debug?: boolean;
+}): void;
+/** Convenience: a "not logged in" error with guidance. */
+export declare function authRequiredError(): CliError;
+/** Convenience: a usage error (bad/missing arguments). */
+export declare function usageError(message: string, command?: string): CliError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAaxD,2CAA2C;IAC3C,IAAI,KAAK,IAAI,MAAM,CAElB;CACF;AA0GD,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAsBnD;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAsC/F;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,IAAI,QAAQ,CAS5C;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAMtE"}

package/dist/utils/errors.js

@@ -0,0 +1,221 @@
+import { ApiError } from '../sdk.js';
+import { bold, dim, red } from './output.js';
+import { redact } from './redact.js';
+/** Exit-code taxonomy (see docs/cli-product-spec.md §6.4). */
+export const ExitCode = {
+    OK: 0,
+    ERROR: 1,
+    USAGE: 2,
+    NETWORK: 3,
+    AUTH: 4,
+};
+/**
+ * A user-facing error with everything needed to render an actionable message:
+ * title, explanation, cause, fix, a suggested command, and a request id.
+ */
+export class CliError extends Error {
+    code;
+    exitCode;
+    explanation;
+    cause;
+    fix;
+    command;
+    requestId;
+    details;
+    constructor(title, options = {}) {
+        super(title);
+        this.name = 'CliError';
+        this.code = options.code ?? 'ERROR';
+        this.exitCode = options.exitCode ?? ExitCode.ERROR;
+        this.explanation = options.explanation;
+        this.cause = options.cause;
+        this.fix = options.fix;
+        this.command = options.command;
+        this.requestId = options.requestId;
+        this.details = options.details;
+    }
+    /** The short title (the Error message). */
+    get title() {
+        return this.message;
+    }
+}
+const NETWORK_CODES = new Set([
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'ETIMEDOUT',
+    'ECONNRESET',
+    'EAI_AGAIN',
+    'EPIPE',
+    'ERR_SOCKET_CONNECTION_TIMEOUT',
+]);
+function isNetworkError(error) {
+    const candidates = [error];
+    if (error && typeof error === 'object' && 'cause' in error) {
+        candidates.push(error.cause);
+    }
+    for (const candidate of candidates) {
+        const code = candidate && typeof candidate === 'object' && 'code' in candidate
+            ? String(candidate.code)
+            : '';
+        if (NETWORK_CODES.has(code))
+            return true;
+    }
+    const message = (error instanceof Error ? error.message : String(error)).toLowerCase();
+    return (message.includes('fetch failed') ||
+        message.includes('network') ||
+        message.includes('timed out') ||
+        message.includes('timeout'));
+}
+/** Map an {@link ApiError} (HTTP failure) to a friendly {@link CliError}. */
+function fromApiError(error) {
+    const base = {
+        code: error.code ?? `HTTP_${error.status}`,
+        requestId: error.requestId,
+        details: error.payload,
+    };
+    if (error.status === 401) {
+        return new CliError('Authentication required', {
+            ...base,
+            code: 'AUTH_REQUIRED',
+            exitCode: ExitCode.AUTH,
+            explanation: error.message,
+            cause: 'Your credentials are missing, expired, or invalid.',
+            fix: 'Log in again, or set INQUIR_TOKEN for non-interactive use.',
+            command: 'inquir login',
+        });
+    }
+    if (error.status === 403) {
+        return new CliError('Permission denied', {
+            ...base,
+            code: error.code ?? 'FORBIDDEN',
+            exitCode: ExitCode.AUTH,
+            explanation: error.message,
+            cause: 'Your account lacks access to this workspace or resource.',
+            fix: 'Confirm the active workspace and your role.',
+            command: 'inquir whoami',
+        });
+    }
+    if (error.status === 404) {
+        return new CliError('Not found', {
+            ...base,
+            code: error.code ?? 'NOT_FOUND',
+            exitCode: ExitCode.ERROR,
+            explanation: error.message,
+            cause: 'The requested resource does not exist in this workspace.',
+            fix: 'Check the name/id and the active workspace.',
+            command: 'inquir list --remote',
+        });
+    }
+    if (error.status === 400 || error.status === 422) {
+        return new CliError('Request rejected', {
+            ...base,
+            code: error.code ?? 'VALIDATION_ERROR',
+            exitCode: ExitCode.USAGE,
+            explanation: error.message,
+            cause: 'The server could not validate the request.',
+        });
+    }
+    if (error.status === 429) {
+        return new CliError('Rate limited', {
+            ...base,
+            code: error.code ?? 'RATE_LIMITED',
+            exitCode: ExitCode.ERROR,
+            explanation: error.message,
+            fix: 'Wait a moment and try again.',
+        });
+    }
+    return new CliError('Server error', {
+        ...base,
+        code: error.code ?? `HTTP_${error.status}`,
+        exitCode: ExitCode.ERROR,
+        explanation: error.message,
+        cause: 'The Inquir Compute API returned an error.',
+        fix: error.requestId ? 'Retry; if it persists, contact support with the request id.' : 'Retry shortly.',
+    });
+}
+/** Normalize any thrown value into a {@link CliError}. */
+export function toCliError(error) {
+    if (error instanceof CliError) {
+        return error;
+    }
+    if (error instanceof ApiError) {
+        return fromApiError(error);
+    }
+    if (isNetworkError(error)) {
+        return new CliError('Network error', {
+            code: 'NETWORK',
+            exitCode: ExitCode.NETWORK,
+            explanation: error instanceof Error ? error.message : String(error),
+            cause: 'Could not reach the Inquir Compute API.',
+            fix: 'Check your connection and --api-url, then retry.',
+            command: 'inquir doctor',
+        });
+    }
+    return new CliError(error instanceof Error ? error.message : String(error), {
+        code: 'ERROR',
+        exitCode: ExitCode.ERROR,
+        details: error instanceof Error ? error.stack : undefined,
+    });
+}
+/** Render a CliError to the user. Honours --json and --debug. */
+export function renderError(error, options) {
+    if (options.json) {
+        const envelope = {
+            ok: false,
+            error: {
+                code: error.code,
+                title: error.title,
+                message: error.explanation ?? error.title,
+                ...(error.requestId ? { requestId: error.requestId } : {}),
+                ...(options.debug && error.details !== undefined ? { details: error.details } : {}),
+            },
+        };
+        process.stdout.write(`${redact(JSON.stringify(envelope, null, 2))}\n`);
+        return;
+    }
+    // Human-readable errors go to stderr so stdout stays clean for piping.
+    const errLine = (value = '') => {
+        process.stderr.write(`${redact(value)}\n`);
+    };
+    errLine(red(`✗ ${error.title}`));
+    if (error.explanation && error.explanation !== error.title) {
+        errLine(`  ${error.explanation}`);
+    }
+    if (error.cause)
+        errLine(dim(`  Cause: ${error.cause}`));
+    if (error.fix)
+        errLine(`  ${bold('Fix:')} ${error.fix}`);
+    if (error.command)
+        errLine(`  ${bold('Try:')} ${error.command}`);
+    if (error.requestId)
+        errLine(dim(`  Request ID: ${error.requestId}`));
+    if (options.debug && error.details !== undefined) {
+        errLine('');
+        errLine(dim('Debug details:'));
+        const detail = typeof error.details === 'string' ? error.details : JSON.stringify(error.details, null, 2);
+        errLine(dim(redact(detail)));
+    }
+    else if (!options.debug) {
+        errLine(dim('  (run with --debug for details)'));
+    }
+}
+/** Convenience: a "not logged in" error with guidance. */
+export function authRequiredError() {
+    return new CliError('You are not logged in', {
+        code: 'AUTH_REQUIRED',
+        exitCode: ExitCode.AUTH,
+        explanation: 'This command needs Inquir Compute credentials.',
+        cause: 'No Personal Access Token or API key was found.',
+        fix: 'Log in on your machine, or set INQUIR_TOKEN for CI.',
+        command: 'inquir login',
+    });
+}
+/** Convenience: a usage error (bad/missing arguments). */
+export function usageError(message, command) {
+    return new CliError(message, {
+        code: 'USAGE',
+        exitCode: ExitCode.USAGE,
+        command,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;CACC,CAAC;AAoBX;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,QAAQ,CAAS;IACjB,WAAW,CAAU;IACrB,KAAK,CAAU;IACf,GAAG,CAAU;IACb,OAAO,CAAU;IACjB,SAAS,CAAU;IACnB,OAAO,CAAW;IAE3B,YAAY,KAAa,EAAE,UAA2B,EAAE;QACtD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,2CAA2C;IAC3C,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,cAAc;IACd,WAAW;IACX,WAAW;IACX,YAAY;IACZ,WAAW;IACX,OAAO;IACP,+BAA+B;CAChC,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,UAAU,GAAc,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC3D,UAAU,CAAC,IAAI,CAAE,KAA6B,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,IAAI,SAAS;YAC5E,CAAC,CAAC,MAAM,CAAE,SAAgC,CAAC,IAAI,CAAC;YAChD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAC3C,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACvF,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,YAAY,CAAC,KAAe;IACnC,MAAM,IAAI,GAAoB;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,QAAQ,KAAK,CAAC,MAAM,EAAE;QAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,QAAQ,CAAC,yBAAyB,EAAE;YAC7C,GAAG,IAAI;YACP,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,KAAK,EAAE,oDAAoD;YAC3D,GAAG,EAAE,4DAA4D;YACjE,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE;YACvC,GAAG,IAAI;YACP,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,WAAW;YAC/B,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,KAAK,EAAE,0DAA0D;YACjE,GAAG,EAAE,6CAA6C;YAClD,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE;YAC/B,GAAG,IAAI;YACP,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,WAAW;YAC/B,QAAQ,EAAE,QAAQ,CAAC,KAAK;YACxB,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,KAAK,EAAE,0DAA0D;YACjE,GAAG,EAAE,6CAA6C;YAClD,OAAO,EAAE,sBAAsB;SAChC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACjD,OAAO,IAAI,QAAQ,CAAC,kBAAkB,EAAE;YACtC,GAAG,IAAI;YACP,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,kBAAkB;YACtC,QAAQ,EAAE,QAAQ,CAAC,KAAK;YACxB,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,KAAK,EAAE,4CAA4C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE;YAClC,GAAG,IAAI;YACP,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,cAAc;YAClC,QAAQ,EAAE,QAAQ,CAAC,KAAK;YACxB,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,GAAG,EAAE,8BAA8B;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE;QAClC,GAAG,IAAI;QACP,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,QAAQ,KAAK,CAAC,MAAM,EAAE;QAC1C,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,WAAW,EAAE,KAAK,CAAC,OAAO;QAC1B,KAAK,EAAE,2CAA2C;QAClD,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,6DAA6D,CAAC,CAAC,CAAC,gBAAgB;KACxG,CAAC,CAAC;AACL,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,QAAQ,CAAC,eAAe,EAAE;YACnC,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,QAAQ,CAAC,OAAO;YAC1B,WAAW,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YACnE,KAAK,EAAE,yCAAyC;YAChD,GAAG,EAAE,kDAAkD;YACvD,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC1E,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,KAAe,EAAE,OAA4C;IACvF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG;YACf,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK;gBACzC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpF;SACF,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvE,OAAO;IACT,CAAC;IAED,uEAAuE;IACvE,MAAM,OAAO,GAAG,CAAC,KAAK,GAAG,EAAE,EAAQ,EAAE;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3D,OAAO,CAAC,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,GAAG;QAAE,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAEtE,IAAI,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjD,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1G,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,QAAQ,CAAC,uBAAuB,EAAE;QAC3C,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,WAAW,EAAE,gDAAgD;QAC7D,KAAK,EAAE,gDAAgD;QACvD,GAAG,EAAE,qDAAqD;QAC1D,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;AACL,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAAgB;IAC1D,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE;QAC3B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/output.d.ts

@@ -1,3 +1,11 @@
+/** Apply resolved global flags (called once at startup from the runtime layer). */
+export declare function configureOutput(options: {
+    color?: boolean;
+    quiet?: boolean;
+}): void;
+/** For tests. */
+export declare function resetOutput(): void;
+export declare function colorEnabled(): boolean;
 export declare function bold(value: string): string;
 export declare function dim(value: string): string;
 export declare function green(value: string): string;
@@ -5,11 +13,13 @@ export declare function yellow(value: string): string;
 export declare function red(value: string): string;
 export declare function cyan(value: string): string;
 export declare function printLine(value?: string): void;
+/** Like printLine, but suppressed in --quiet mode (status chatter, not results). */
+export declare function printInfo(value?: string): void;
 export declare function printError(value: string): void;
 export declare function printSuccess(value: string): void;
 export declare function printWarning(value: string): void;
 export declare function printUsage(value: string): void;
-export declare function printCommandHelp(name: string, usage: string, flags: string[]): void;
+export declare function printCommandHelp(name: string, usage: string, flags: string[], examples?: string[]): void;
 export declare function formatDiagnostic(diag: {
     code: string;
     filePath?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAWA,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAK,GAAG,IAAI,CAE1C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9C;AAMD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CASnF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrH;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAgB/G"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAoBA,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAGnF;AAED,iBAAiB;AACjB,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AASD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAK,GAAG,IAAI,CAE1C;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,KAAK,SAAK,GAAG,IAAI,CAG1C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9C;AAMD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,GAAE,MAAM,EAAO,GACtB,IAAI,CAgBN;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrH;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAgB/G"}

package/dist/utils/output.js

@@ -1,10 +1,37 @@
 import path from 'node:path';
-const ENABLE_COLOR = process.stdout.isTTY;
+import { redact } from './redact.js';
+/** Default color decision: honour NO_COLOR / FORCE_COLOR, else TTY. */
+function defaultColor() {
+    if (process.env.FORCE_COLOR && process.env.FORCE_COLOR !== '0')
+        return true;
+    if (process.env.NO_COLOR !== undefined)
+        return false;
+    return Boolean(process.stdout.isTTY);
+}
+const state = {
+    color: defaultColor(),
+    quiet: false,
+};
+/** Apply resolved global flags (called once at startup from the runtime layer). */
+export function configureOutput(options) {
+    if (options.color !== undefined)
+        state.color = options.color;
+    if (options.quiet !== undefined)
+        state.quiet = options.quiet;
+}
+/** For tests. */
+export function resetOutput() {
+    state.color = defaultColor();
+    state.quiet = false;
+}
+export function colorEnabled() {
+    return state.color;
+}
 function wrap(code, value) {
-    if (!ENABLE_COLOR) {
+    if (!state.color) {
         return value;
     }
-    return `\u001b[${code}m${value}\u001b[0m`;
+    return `[${code}m${value}`;
 }
 export function bold(value) {
     return wrap('1', value);
@@ -25,15 +52,25 @@ export function cyan(value) {
     return wrap('36', value);
 }
 export function printLine(value = '') {
-    process.stdout.write(`${value}\n`);
+    process.stdout.write(`${redact(value)}\n`);
+}
+/** Like printLine, but suppressed in --quiet mode (status chatter, not results). */
+export function printInfo(value = '') {
+    if (state.quiet)
+        return;
+    printLine(value);
 }
 export function printError(value) {
-    process.stderr.write(`${red(value)}\n`);
+    process.stderr.write(`${redact(red(value))}\n`);
 }
 export function printSuccess(value) {
+    if (state.quiet)
+        return;
     printLine(green(value));
 }
 export function printWarning(value) {
+    if (state.quiet)
+        return;
     printLine(yellow(value));
 }
 export function printUsage(value) {
@@ -42,15 +79,22 @@ export function printUsage(value) {
 function padEnd(value, width) {
     return value.padEnd(width, ' ');
 }
-export function printCommandHelp(name, usage, flags) {
+export function printCommandHelp(name, usage, flags, examples = []) {
     printLine(`Usage: inquir ${usage}`);
-    printLine('');
     if (flags.length > 0) {
+        printLine('');
         printLine('Options:');
         for (const flag of flags) {
             printLine(`  ${flag}`);
         }
     }
+    if (examples.length > 0) {
+        printLine('');
+        printLine('Examples:');
+        for (const example of examples) {
+            printLine(`  ${dim('$')} ${example}`);
+        }
+    }
 }
 export function formatDiagnostic(diag, rootDir) {
     const location = diag.filePath

package/dist/utils/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,uEAAuE;AACvE,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC5E,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,KAAK,GAAgB;IACzB,KAAK,EAAE,YAAY,EAAE;IACrB,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,OAA6C;IAC3E,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AAC/D,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,WAAW;IACzB,KAAK,CAAC,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,KAAK,CAAC;AACrB,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,KAAa;IACvC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAK,GAAG,EAAE;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,KAAK,GAAG,EAAE;IAClC,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO;IACxB,SAAS,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO;IACxB,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO;IACxB,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,KAAa;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,KAAa,EACb,KAAe,EACf,WAAqB,EAAE;IAEvB,SAAS,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,SAAS,CAAC,WAAW,CAAC,CAAC;QACvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,SAAS,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAA0D,EAAE,OAAgB;IAC3G,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;QAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACnE,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAwD,EAAE,OAAiB;IACrG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACpC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAChF,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9F,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC5B,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC5F,CAAC;IAEF,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/utils/package-metadata.d.ts

@@ -0,0 +1,3 @@
+export declare function getCliVersion(): string;
+export declare function getSdkDependencyRange(): string;
+//# sourceMappingURL=package-metadata.d.ts.map

package/dist/utils/package-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-metadata.d.ts","sourceRoot":"","sources":["../../src/utils/package-metadata.ts"],"names":[],"mappings":"AAyBA,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/utils/package-metadata.js

@@ -0,0 +1,22 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+let cachedPackageJson;
+function readCliPackageJson() {
+    if (cachedPackageJson) {
+        return cachedPackageJson;
+    }
+    try {
+        cachedPackageJson = require('../../package.json');
+    }
+    catch {
+        cachedPackageJson = {};
+    }
+    return cachedPackageJson;
+}
+export function getCliVersion() {
+    return readCliPackageJson().version ?? '0.1.0';
+}
+export function getSdkDependencyRange() {
+    return readCliPackageJson().dependencies?.['@inquir/compute'] ?? '^0.1.0';
+}
+//# sourceMappingURL=package-metadata.js.map

package/dist/utils/package-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-metadata.js","sourceRoot":"","sources":["../../src/utils/package-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,IAAI,iBAA6C,CAAC;AAElD,SAAS,kBAAkB;IACzB,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC;QACH,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAmB,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,kBAAkB,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,EAAE,CAAC,YAAY,EAAE,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC;AAC5E,CAAC"}

package/dist/utils/payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAO3F;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrE"}
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAM3F;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrE"}

package/dist/utils/payload.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs/promises';
+import { readFlagValue } from './args.js';
 function parseJsonPayload(raw) {
     const trimmed = raw.trim();
     if (!trimmed) {
@@ -18,11 +19,10 @@ async function readStdin() {
     });
 }
 export function parsePayloadArgs(args) {
-    const payloadIndex = args.indexOf('--payload');
-    const payloadFileIndex = args.indexOf('--payload-file');
+    // Use the shared reader so both `--payload value` and `--payload=value` work.
     return {
-        payload: payloadIndex >= 0 ? args[payloadIndex + 1] : undefined,
-        payloadFile: payloadFileIndex >= 0 ? args[payloadFileIndex + 1] : undefined,
+        payload: readFlagValue(args, '--payload'),
+        payloadFile: readFlagValue(args, '--payload-file'),
     };
 }
 export async function readPayload(args) {

package/dist/utils/payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOlC,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC3C,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxD,OAAO;QACL,OAAO,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAC/D,WAAW,EAAE,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;QAC9B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAO1C,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC3C,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,8EAA8E;IAC9E,OAAO;QACL,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC;QACzC,WAAW,EAAE,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;QAC9B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Interactive prompts are TTY-gated: never prompt in CI, non-TTY, JSON, or
+ * --yes mode. Callers must always supply a sensible non-interactive fallback.
+ */
+export declare function canPrompt(): boolean;
+/** Yes/no confirmation. Returns `defaultValue` when prompting is unavailable; true under --yes. */
+export declare function confirm(question: string, defaultValue?: boolean): Promise<boolean>;
+/** Free-text input. Returns the default when prompting is unavailable. */
+export declare function input(question: string, options?: {
+    default?: string;
+}): Promise<string>;
+export interface SelectChoice<T> {
+    label: string;
+    value: T;
+    hint?: string;
+}
+/**
+ * Single-select from a numbered list. Returns `defaultValue` when prompting is
+ * unavailable (callers should pass a safe default or handle `undefined`).
+ */
+export declare function select<T>(question: string, choices: Array<SelectChoice<T>>, defaultValue?: T): Promise<T | undefined>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAOnC;AAWD,mGAAmG;AACnG,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtF;AAED,0EAA0E;AAC1E,wBAAsB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjG;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC/B,YAAY,CAAC,EAAE,CAAC,GACf,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAkBxB"}

package/dist/utils/prompt.js

@@ -0,0 +1,67 @@
+import * as readline from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { runtime } from './context.js';
+import { bold, cyan, printLine } from './output.js';
+/**
+ * Interactive prompts are TTY-gated: never prompt in CI, non-TTY, JSON, or
+ * --yes mode. Callers must always supply a sensible non-interactive fallback.
+ */
+export function canPrompt() {
+    return (Boolean(stdin.isTTY && stdout.isTTY) &&
+        !runtime().json &&
+        !runtime().yes &&
+        !process.env.CI);
+}
+async function ask(question) {
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    try {
+        return (await rl.question(question)).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Yes/no confirmation. Returns `defaultValue` when prompting is unavailable; true under --yes. */
+export async function confirm(question, defaultValue = false) {
+    if (runtime().yes)
+        return true;
+    if (!canPrompt())
+        return defaultValue;
+    const hint = defaultValue ? 'Y/n' : 'y/N';
+    const answer = (await ask(`${question} (${hint}) `)).toLowerCase();
+    if (answer === '')
+        return defaultValue;
+    return answer === 'y' || answer === 'yes';
+}
+/** Free-text input. Returns the default when prompting is unavailable. */
+export async function input(question, options = {}) {
+    if (!canPrompt())
+        return options.default ?? '';
+    const suffix = options.default ? ` (${options.default})` : '';
+    const answer = await ask(`${question}${suffix}: `);
+    return answer || options.default || '';
+}
+/**
+ * Single-select from a numbered list. Returns `defaultValue` when prompting is
+ * unavailable (callers should pass a safe default or handle `undefined`).
+ */
+export async function select(question, choices, defaultValue) {
+    if (choices.length === 0)
+        return defaultValue;
+    if (!canPrompt())
+        return defaultValue ?? choices[0].value;
+    printLine(bold(question));
+    choices.forEach((choice, index) => {
+        const marker = `  ${cyan(String(index + 1))})`;
+        printLine(`${marker} ${choice.label}${choice.hint ? `  ${choice.hint}` : ''}`);
+    });
+    for (;;) {
+        const answer = await ask('Select a number: ');
+        const index = Number.parseInt(answer, 10) - 1;
+        if (Number.isInteger(index) && index >= 0 && index < choices.length) {
+            return choices[index].value;
+        }
+        printLine('Please enter a valid number.');
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/utils/prompt.js.map

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

package/dist/utils/redact.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Secret redaction. Tokens and API keys must never appear in output, logs, or
+ * `--debug` traces. We redact by (a) known patterns and (b) any value explicitly
+ * registered at runtime (the resolved credential, env values, etc.).
+ */
+/** Register a concrete secret value so it is masked wherever it appears. */
+export declare function registerSecret(value: string | undefined | null): void;
+/** For tests / isolation. */
+export declare function clearRegisteredSecrets(): void;
+/** Mask a single token for display: keep a hint of the prefix + last 4 chars. */
+export declare function maskToken(value: string | undefined): string;
+/** Redact all known secrets from an arbitrary string. */
+export declare function redact(input: string): string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/utils/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAIrE;AAED,6BAA6B;AAC7B,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM3D;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW5C"}