@enactprotocol/cli 2.0.0 → 2.0.2

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

@@ -0,0 +1,83 @@
+/**
+ * Exit codes for CLI commands
+ *
+ * Standardized exit codes following Unix conventions:
+ * - 0: Success
+ * - 1: General error
+ * - 2: Misuse of shell command (invalid args)
+ * - 64-78: BSD sysexits.h codes
+ * - 128+: Signal-based exits
+ *
+ * @see https://www.freebsd.org/cgi/man.cgi?query=sysexits
+ */
+/** Success - command completed successfully */
+export declare const EXIT_SUCCESS = 0;
+/** General error - unspecified failure */
+export declare const EXIT_FAILURE = 1;
+/** Usage error - invalid command line arguments */
+export declare const EXIT_USAGE = 2;
+/** Data error - input data was incorrect */
+export declare const EXIT_DATAERR = 65;
+/** No input - input file did not exist or was not readable */
+export declare const EXIT_NOINPUT = 66;
+/** No user - user does not exist */
+export declare const EXIT_NOUSER = 67;
+/** No host - host does not exist */
+export declare const EXIT_NOHOST = 68;
+/** Service unavailable - a required service is unavailable */
+export declare const EXIT_UNAVAILABLE = 69;
+/** Software error - internal error */
+export declare const EXIT_SOFTWARE = 70;
+/** OS error - system error */
+export declare const EXIT_OSERR = 71;
+/** OS file - system file missing or not creatable */
+export declare const EXIT_OSFILE = 72;
+/** Can't create - output file cannot be created */
+export declare const EXIT_CANTCREAT = 73;
+/** I/O error - input/output error */
+export declare const EXIT_IOERR = 74;
+/** Temp failure - temporary failure, try again */
+export declare const EXIT_TEMPFAIL = 75;
+/** Protocol error - remote error in protocol */
+export declare const EXIT_PROTOCOL = 76;
+/** No permission - permission denied */
+export declare const EXIT_NOPERM = 77;
+/** Configuration error - configuration error */
+export declare const EXIT_CONFIG = 78;
+/** Tool not found */
+export declare const EXIT_TOOL_NOT_FOUND = 100;
+/** Manifest error - invalid or missing manifest */
+export declare const EXIT_MANIFEST_ERROR = 101;
+/** Execution error - tool execution failed */
+export declare const EXIT_EXECUTION_ERROR = 102;
+/** Timeout error - operation timed out */
+export declare const EXIT_TIMEOUT = 103;
+/** Trust error - trust verification failed */
+export declare const EXIT_TRUST_ERROR = 104;
+/** Registry error - registry communication failed */
+export declare const EXIT_REGISTRY_ERROR = 105;
+/** Authentication error - not authenticated or token expired */
+export declare const EXIT_AUTH_ERROR = 106;
+/** Validation error - input validation failed */
+export declare const EXIT_VALIDATION_ERROR = 107;
+/** Network error - network communication failed */
+export declare const EXIT_NETWORK_ERROR = 108;
+/** Container error - container runtime error */
+export declare const EXIT_CONTAINER_ERROR = 109;
+/**
+ * Get description for an exit code
+ */
+export declare function getExitCodeDescription(code: number): string;
+/**
+ * Exit with a specific code
+ */
+export declare function exit(code: number): never;
+/**
+ * Exit with success
+ */
+export declare function exitSuccess(): never;
+/**
+ * Exit with failure
+ */
+export declare function exitFailure(): never;
+//# sourceMappingURL=exit-codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/utils/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,0CAA0C;AAC1C,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,mDAAmD;AACnD,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,4CAA4C;AAC5C,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,8DAA8D;AAC9D,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,oCAAoC;AACpC,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,oCAAoC;AACpC,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,sCAAsC;AACtC,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,8BAA8B;AAC9B,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,qDAAqD;AACrD,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,mDAAmD;AACnD,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,qCAAqC;AACrC,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,kDAAkD;AAClD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,gDAAgD;AAChD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,wCAAwC;AACxC,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,gDAAgD;AAChD,eAAO,MAAM,WAAW,KAAK,CAAC;AAM9B,qBAAqB;AACrB,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,0CAA0C;AAC1C,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,gEAAgE;AAChE,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,gDAAgD;AAChD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAoCxC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAExC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,KAAK,CAEnC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,KAAK,CAEnC"}

package/dist/utils/exit-codes.js

@@ -0,0 +1,126 @@
+/**
+ * Exit codes for CLI commands
+ *
+ * Standardized exit codes following Unix conventions:
+ * - 0: Success
+ * - 1: General error
+ * - 2: Misuse of shell command (invalid args)
+ * - 64-78: BSD sysexits.h codes
+ * - 128+: Signal-based exits
+ *
+ * @see https://www.freebsd.org/cgi/man.cgi?query=sysexits
+ */
+/** Success - command completed successfully */
+export const EXIT_SUCCESS = 0;
+/** General error - unspecified failure */
+export const EXIT_FAILURE = 1;
+/** Usage error - invalid command line arguments */
+export const EXIT_USAGE = 2;
+/** Data error - input data was incorrect */
+export const EXIT_DATAERR = 65;
+/** No input - input file did not exist or was not readable */
+export const EXIT_NOINPUT = 66;
+/** No user - user does not exist */
+export const EXIT_NOUSER = 67;
+/** No host - host does not exist */
+export const EXIT_NOHOST = 68;
+/** Service unavailable - a required service is unavailable */
+export const EXIT_UNAVAILABLE = 69;
+/** Software error - internal error */
+export const EXIT_SOFTWARE = 70;
+/** OS error - system error */
+export const EXIT_OSERR = 71;
+/** OS file - system file missing or not creatable */
+export const EXIT_OSFILE = 72;
+/** Can't create - output file cannot be created */
+export const EXIT_CANTCREAT = 73;
+/** I/O error - input/output error */
+export const EXIT_IOERR = 74;
+/** Temp failure - temporary failure, try again */
+export const EXIT_TEMPFAIL = 75;
+/** Protocol error - remote error in protocol */
+export const EXIT_PROTOCOL = 76;
+/** No permission - permission denied */
+export const EXIT_NOPERM = 77;
+/** Configuration error - configuration error */
+export const EXIT_CONFIG = 78;
+// ============================================================================
+// Enact-specific exit codes (100-119)
+// ============================================================================
+/** Tool not found */
+export const EXIT_TOOL_NOT_FOUND = 100;
+/** Manifest error - invalid or missing manifest */
+export const EXIT_MANIFEST_ERROR = 101;
+/** Execution error - tool execution failed */
+export const EXIT_EXECUTION_ERROR = 102;
+/** Timeout error - operation timed out */
+export const EXIT_TIMEOUT = 103;
+/** Trust error - trust verification failed */
+export const EXIT_TRUST_ERROR = 104;
+/** Registry error - registry communication failed */
+export const EXIT_REGISTRY_ERROR = 105;
+/** Authentication error - not authenticated or token expired */
+export const EXIT_AUTH_ERROR = 106;
+/** Validation error - input validation failed */
+export const EXIT_VALIDATION_ERROR = 107;
+/** Network error - network communication failed */
+export const EXIT_NETWORK_ERROR = 108;
+/** Container error - container runtime error */
+export const EXIT_CONTAINER_ERROR = 109;
+// ============================================================================
+// Exit code descriptions
+// ============================================================================
+const EXIT_CODE_DESCRIPTIONS = {
+    [EXIT_SUCCESS]: "Success",
+    [EXIT_FAILURE]: "General error",
+    [EXIT_USAGE]: "Invalid command line arguments",
+    [EXIT_DATAERR]: "Input data was incorrect",
+    [EXIT_NOINPUT]: "Input file not found or not readable",
+    [EXIT_NOUSER]: "User not found",
+    [EXIT_NOHOST]: "Host not found",
+    [EXIT_UNAVAILABLE]: "Service unavailable",
+    [EXIT_SOFTWARE]: "Internal software error",
+    [EXIT_OSERR]: "System error",
+    [EXIT_OSFILE]: "System file missing",
+    [EXIT_CANTCREAT]: "Cannot create output file",
+    [EXIT_IOERR]: "I/O error",
+    [EXIT_TEMPFAIL]: "Temporary failure, try again",
+    [EXIT_PROTOCOL]: "Protocol error",
+    [EXIT_NOPERM]: "Permission denied",
+    [EXIT_CONFIG]: "Configuration error",
+    [EXIT_TOOL_NOT_FOUND]: "Tool not found",
+    [EXIT_MANIFEST_ERROR]: "Manifest error",
+    [EXIT_EXECUTION_ERROR]: "Tool execution failed",
+    [EXIT_TIMEOUT]: "Operation timed out",
+    [EXIT_TRUST_ERROR]: "Trust verification failed",
+    [EXIT_REGISTRY_ERROR]: "Registry error",
+    [EXIT_AUTH_ERROR]: "Authentication error",
+    [EXIT_VALIDATION_ERROR]: "Validation error",
+    [EXIT_NETWORK_ERROR]: "Network error",
+    [EXIT_CONTAINER_ERROR]: "Container runtime error",
+};
+/**
+ * Get description for an exit code
+ */
+export function getExitCodeDescription(code) {
+    return EXIT_CODE_DESCRIPTIONS[code] ?? `Unknown error (code ${code})`;
+}
+/**
+ * Exit with a specific code
+ */
+export function exit(code) {
+    process.exit(code);
+}
+/**
+ * Exit with success
+ */
+export function exitSuccess() {
+    process.exit(EXIT_SUCCESS);
+}
+/**
+ * Exit with failure
+ */
+export function exitFailure() {
+    process.exit(EXIT_FAILURE);
+}
+//# sourceMappingURL=exit-codes.js.map

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

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

package/dist/utils/ignore.d.ts

@@ -0,0 +1,25 @@
+/**
+ * File ignore utilities for bundling
+ *
+ * Provides gitignore-style pattern matching and default ignore lists
+ * to prevent sensitive files from being included in tool bundles.
+ */
+/** Files/patterns that should never be included in bundles */
+export declare const ALWAYS_IGNORE: string[];
+/**
+ * Load and parse a .gitignore file from a directory
+ */
+export declare function loadGitignore(toolDir: string): string[];
+/**
+ * Parse gitignore content string into patterns
+ */
+export declare function parseGitignoreContent(content: string): string[];
+/**
+ * Check if a path matches a gitignore-style pattern
+ */
+export declare function matchesPattern(relativePath: string, pattern: string): boolean;
+/**
+ * Check if a file should be ignored based on patterns
+ */
+export declare function shouldIgnore(relativePath: string, fileName: string, ignorePatterns?: string[]): boolean;
+//# sourceMappingURL=ignore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../src/utils/ignore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,8DAA8D;AAC9D,eAAO,MAAM,aAAa,UA2CzB,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAkC7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,MAAM,EAAO,GAC5B,OAAO,CAqBT"}

package/dist/utils/ignore.js

@@ -0,0 +1,123 @@
+/**
+ * File ignore utilities for bundling
+ *
+ * Provides gitignore-style pattern matching and default ignore lists
+ * to prevent sensitive files from being included in tool bundles.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Files/patterns that should never be included in bundles */
+export const ALWAYS_IGNORE = [
+    // Environment and secrets
+    ".env",
+    ".env.local",
+    ".env.development",
+    ".env.production",
+    ".env.*.local",
+    "*.pem",
+    "*.key",
+    "*.p12",
+    "*.pfx",
+    // Version control
+    ".git",
+    ".gitignore",
+    ".gitattributes",
+    // IDE/Editor
+    ".vscode",
+    ".idea",
+    "*.swp",
+    "*.swo",
+    "*~",
+    // OS files
+    ".DS_Store",
+    "Thumbs.db",
+    "desktop.ini",
+    // Dependencies
+    "node_modules",
+    "vendor",
+    "__pycache__",
+    "*.pyc",
+    ".venv",
+    "venv",
+    // Build artifacts
+    "dist",
+    "build",
+    "out",
+    "target",
+    "*.log",
+];
+/**
+ * Load and parse a .gitignore file from a directory
+ */
+export function loadGitignore(toolDir) {
+    const gitignorePath = join(toolDir, ".gitignore");
+    if (!existsSync(gitignorePath)) {
+        return [];
+    }
+    const content = readFileSync(gitignorePath, "utf-8");
+    return parseGitignoreContent(content);
+}
+/**
+ * Parse gitignore content string into patterns
+ */
+export function parseGitignoreContent(content) {
+    return content
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith("#"));
+}
+/**
+ * Check if a path matches a gitignore-style pattern
+ */
+export function matchesPattern(relativePath, pattern) {
+    // Handle negation patterns (we don't support re-including for now)
+    if (pattern.startsWith("!")) {
+        return false;
+    }
+    // Normalize pattern
+    let normalizedPattern = pattern;
+    // Handle directory-specific patterns (ending with /)
+    const isDirPattern = pattern.endsWith("/");
+    if (isDirPattern) {
+        normalizedPattern = pattern.slice(0, -1);
+    }
+    // Handle patterns starting with /
+    const isRooted = pattern.startsWith("/");
+    if (isRooted) {
+        normalizedPattern = normalizedPattern.slice(1);
+    }
+    // Simple glob matching
+    const regexPattern = normalizedPattern
+        .replace(/\./g, "\\.")
+        .replace(/\*\*/g, "<<<GLOBSTAR>>>")
+        .replace(/\*/g, "[^/]*")
+        .replace(/<<<GLOBSTAR>>>/g, ".*")
+        .replace(/\?/g, ".");
+    const regex = isRooted
+        ? new RegExp(`^${regexPattern}($|/)`)
+        : new RegExp(`(^|/)${regexPattern}($|/)`);
+    return regex.test(relativePath);
+}
+/**
+ * Check if a file should be ignored based on patterns
+ */
+export function shouldIgnore(relativePath, fileName, ignorePatterns = []) {
+    // Always skip hidden files (starting with .)
+    if (fileName.startsWith(".")) {
+        return true;
+    }
+    // Check against always-ignore list
+    for (const pattern of ALWAYS_IGNORE) {
+        if (matchesPattern(relativePath, pattern) || matchesPattern(fileName, pattern)) {
+            return true;
+        }
+    }
+    // Check against gitignore patterns
+    for (const pattern of ignorePatterns) {
+        if (matchesPattern(relativePath, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=ignore.js.map

package/dist/utils/ignore.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI utilities
+ */
+export { colors, symbols, success, error, warning, info, dim, newline, header, keyValue, listItem, table, json, jsonCompact, formatError, errorWithDetails, suggest, status, clearLine, type TableColumn, } from "./output";
+export { createSpinner, withSpinner, intro, outro, confirm, text, password, select, isCancel, cancel, log, logInfo, logSuccess, logWarning, logError, logStep, type SpinnerInstance, } from "./spinner";
+export { EXIT_SUCCESS, EXIT_FAILURE, EXIT_USAGE, EXIT_DATAERR, EXIT_NOINPUT, EXIT_NOUSER, EXIT_NOHOST, EXIT_UNAVAILABLE, EXIT_SOFTWARE, EXIT_OSERR, EXIT_OSFILE, EXIT_CANTCREAT, EXIT_IOERR, EXIT_TEMPFAIL, EXIT_PROTOCOL, EXIT_NOPERM, EXIT_CONFIG, EXIT_TOOL_NOT_FOUND, EXIT_MANIFEST_ERROR, EXIT_EXECUTION_ERROR, EXIT_TIMEOUT, EXIT_TRUST_ERROR, EXIT_REGISTRY_ERROR, EXIT_AUTH_ERROR, EXIT_VALIDATION_ERROR, EXIT_NETWORK_ERROR, EXIT_CONTAINER_ERROR, getExitCodeDescription, exit, exitSuccess, exitFailure, } from "./exit-codes";
+export { CliError, ToolNotFoundError, ManifestError, ValidationError, AuthError, NetworkError, RegistryError, TrustError, TimeoutError, ExecutionError, ContainerError, FileNotFoundError, PermissionError, ConfigError, UsageError, handleError, withErrorHandling, categorizeError, ErrorMessages, printErrorWithSuggestions, } from "./errors";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,KAAK,EACL,OAAO,EACP,IAAI,EACJ,GAAG,EACH,OAAO,EACP,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,MAAM,EACN,SAAS,EACT,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,EACL,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,EACN,GAAG,EACH,OAAO,EACP,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,IAAI,EACJ,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,yBAAyB,GAC1B,MAAM,UAAU,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,12 @@
+/**
+ * CLI utilities
+ */
+// Output formatting
+export { colors, symbols, success, error, warning, info, dim, newline, header, keyValue, listItem, table, json, jsonCompact, formatError, errorWithDetails, suggest, status, clearLine, } from "./output";
+// Spinner and prompts
+export { createSpinner, withSpinner, intro, outro, confirm, text, password, select, isCancel, cancel, log, logInfo, logSuccess, logWarning, logError, logStep, } from "./spinner";
+// Exit codes
+export { EXIT_SUCCESS, EXIT_FAILURE, EXIT_USAGE, EXIT_DATAERR, EXIT_NOINPUT, EXIT_NOUSER, EXIT_NOHOST, EXIT_UNAVAILABLE, EXIT_SOFTWARE, EXIT_OSERR, EXIT_OSFILE, EXIT_CANTCREAT, EXIT_IOERR, EXIT_TEMPFAIL, EXIT_PROTOCOL, EXIT_NOPERM, EXIT_CONFIG, EXIT_TOOL_NOT_FOUND, EXIT_MANIFEST_ERROR, EXIT_EXECUTION_ERROR, EXIT_TIMEOUT, EXIT_TRUST_ERROR, EXIT_REGISTRY_ERROR, EXIT_AUTH_ERROR, EXIT_VALIDATION_ERROR, EXIT_NETWORK_ERROR, EXIT_CONTAINER_ERROR, getExitCodeDescription, exit, exitSuccess, exitFailure, } from "./exit-codes";
+// Error handling
+export { CliError, ToolNotFoundError, ManifestError, ValidationError, AuthError, NetworkError, RegistryError, TrustError, TimeoutError, ExecutionError, ContainerError, FileNotFoundError, PermissionError, ConfigError, UsageError, handleError, withErrorHandling, categorizeError, ErrorMessages, printErrorWithSuggestions, } from "./errors";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAoB;AACpB,OAAO,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,KAAK,EACL,OAAO,EACP,IAAI,EACJ,GAAG,EACH,OAAO,EACP,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,MAAM,EACN,SAAS,GAEV,MAAM,UAAU,CAAC;AAElB,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,EACL,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,EACN,GAAG,EACH,OAAO,EACP,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,GAER,MAAM,WAAW,CAAC;AAEnB,aAAa;AACb,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,IAAI,EACJ,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,iBAAiB;AACjB,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,yBAAyB,GAC1B,MAAM,UAAU,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Output utilities for CLI
+ *
+ * Provides consistent formatting, colors, and output helpers
+ */
+export declare const colors: {
+    success: import("picocolors/types").Formatter;
+    error: import("picocolors/types").Formatter;
+    warning: import("picocolors/types").Formatter;
+    info: import("picocolors/types").Formatter;
+    dim: import("picocolors/types").Formatter;
+    bold: import("picocolors/types").Formatter;
+    command: import("picocolors/types").Formatter;
+    path: import("picocolors/types").Formatter;
+    value: import("picocolors/types").Formatter;
+    key: import("picocolors/types").Formatter;
+    version: import("picocolors/types").Formatter;
+};
+export declare const symbols: {
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+    arrow: string;
+    bullet: string;
+    check: string;
+    cross: string;
+};
+/**
+ * Print a success message
+ */
+export declare function success(message: string): void;
+/**
+ * Print an error message
+ */
+export declare function error(message: string): void;
+/**
+ * Print a warning message
+ */
+export declare function warning(message: string): void;
+/**
+ * Print an info message
+ */
+export declare function info(message: string): void;
+/**
+ * Print a dim/subtle message
+ */
+export declare function dim(message: string): void;
+/**
+ * Print a newline
+ */
+export declare function newline(): void;
+/**
+ * Print a header
+ */
+export declare function header(text: string): void;
+/**
+ * Print a key-value pair
+ */
+export declare function keyValue(key: string, value: string, indent?: number): void;
+/**
+ * Print a list item
+ */
+export declare function listItem(text: string, indent?: number): void;
+export interface TableColumn {
+    key: string;
+    header: string;
+    width?: number;
+    align?: "left" | "right" | "center";
+}
+/**
+ * Print a simple table
+ */
+export declare function table<T extends Record<string, unknown>>(data: T[], columns: TableColumn[]): void;
+/**
+ * Print data as JSON (for --json flag)
+ */
+export declare function json(data: unknown): void;
+/**
+ * Print data as compact JSON
+ */
+export declare function jsonCompact(data: unknown): void;
+/**
+ * Format an error for display
+ */
+export declare function formatError(err: unknown): string;
+/**
+ * Print an error with details
+ */
+export declare function errorWithDetails(message: string, details?: string): void;
+/**
+ * Print a suggestion after an error
+ */
+export declare function suggest(message: string): void;
+/**
+ * Print a status line that can be updated
+ */
+export declare function status(message: string): void;
+/**
+ * Clear the current line
+ */
+export declare function clearLine(): void;
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,MAAM;;;;;;;;;;;;CAelB,CAAC;AAMF,eAAO,MAAM,OAAO;;;;;;;;;CASnB,CAAC;AAMF;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI,CAGrE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI,CAGvD;AAMD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CA2BhG;AAuBD;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE/C;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAKxE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG7C;AAMD;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC"}