@fractary/core-cli 0.1.0

package/dist/utils/config.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Configuration Management Utilities
+ *
+ * Handles configuration file discovery, loading, and migration from old paths.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findConfigPath = findConfigPath;
+exports.findLegacyConfigPath = findLegacyConfigPath;
+exports.loadConfig = loadConfig;
+exports.writeConfig = writeConfig;
+exports.getDefaultConfigPath = getDefaultConfigPath;
+exports.configExists = configExists;
+exports.getConfigDir = getConfigDir;
+exports.mergeConfig = mergeConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Configuration paths
+ */
+const CONFIG_DIR = '.fractary/core';
+const CONFIG_FILE = 'config.json';
+const LEGACY_CONFIG_DIR = '.fractary/faber';
+/**
+ * Find the configuration file path by walking up the directory tree
+ *
+ * @param startDir - Directory to start searching from (default: current working directory)
+ * @returns Path to config file or null if not found
+ */
+function findConfigPath(startDir = process.cwd()) {
+    let currentDir = startDir;
+    while (true) {
+        const configPath = path.join(currentDir, CONFIG_DIR, CONFIG_FILE);
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+        const parentDir = path.dirname(currentDir);
+        // Reached filesystem root
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Find the legacy configuration file path
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Path to legacy config file or null if not found
+ */
+function findLegacyConfigPath(startDir = process.cwd()) {
+    let currentDir = startDir;
+    while (true) {
+        const legacyPath = path.join(currentDir, LEGACY_CONFIG_DIR, CONFIG_FILE);
+        if (fs.existsSync(legacyPath)) {
+            return legacyPath;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Load configuration from file
+ *
+ * @param configPath - Path to config file (optional, will auto-discover if not provided)
+ * @returns Configuration object or null if not found
+ */
+function loadConfig(configPath) {
+    try {
+        const actualPath = configPath || findConfigPath();
+        if (!actualPath) {
+            // Try to migrate from legacy path
+            const legacyPath = findLegacyConfigPath();
+            if (legacyPath) {
+                return migrateLegacyConfig(legacyPath);
+            }
+            return null;
+        }
+        const content = fs.readFileSync(actualPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        // Failed to load config
+        return null;
+    }
+}
+/**
+ * Migrate legacy configuration from .fractary/faber to .fractary/core
+ *
+ * @param legacyPath - Path to legacy config file
+ * @returns Migrated configuration
+ */
+function migrateLegacyConfig(legacyPath) {
+    try {
+        console.log(chalk_1.default.yellow('Notice:'), 'Migrating configuration from', LEGACY_CONFIG_DIR, 'to', CONFIG_DIR);
+        const content = fs.readFileSync(legacyPath, 'utf-8');
+        const legacyConfig = JSON.parse(content);
+        // Extract relevant configuration sections
+        const coreConfig = {
+            work: legacyConfig.work,
+            repo: legacyConfig.repo,
+            spec: legacyConfig.spec,
+            logs: legacyConfig.logs,
+            file: legacyConfig.file,
+            docs: legacyConfig.docs,
+        };
+        // Write to new location
+        const legacyDir = path.dirname(legacyPath);
+        const projectRoot = path.dirname(path.dirname(legacyDir));
+        const newPath = path.join(projectRoot, CONFIG_DIR, CONFIG_FILE);
+        writeConfig(coreConfig, newPath);
+        console.log(chalk_1.default.green('✓'), 'Configuration migrated successfully');
+        return coreConfig;
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('Failed to migrate configuration:'), error);
+        return null;
+    }
+}
+/**
+ * Write configuration to file
+ *
+ * @param config - Configuration object
+ * @param configPath - Path to write config to (optional, will use default if not provided)
+ */
+function writeConfig(config, configPath) {
+    const actualPath = configPath || getDefaultConfigPath();
+    // Ensure directory exists
+    const dir = path.dirname(actualPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Write configuration with pretty formatting
+    fs.writeFileSync(actualPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+/**
+ * Get the default configuration file path for the current project
+ *
+ * @returns Default config path
+ */
+function getDefaultConfigPath() {
+    return path.join(process.cwd(), CONFIG_DIR, CONFIG_FILE);
+}
+/**
+ * Check if configuration exists
+ *
+ * @returns True if config exists, false otherwise
+ */
+function configExists() {
+    return findConfigPath() !== null || findLegacyConfigPath() !== null;
+}
+/**
+ * Get configuration directory path
+ *
+ * @returns Config directory path
+ */
+function getConfigDir() {
+    return path.join(process.cwd(), CONFIG_DIR);
+}
+/**
+ * Merge configuration objects
+ *
+ * @param base - Base configuration
+ * @param override - Configuration to merge in
+ * @returns Merged configuration
+ */
+function mergeConfig(base, override) {
+    return {
+        work: override.work !== undefined ? override.work : base.work,
+        repo: override.repo !== undefined ? override.repo : base.repo,
+        spec: override.spec !== undefined ? override.spec : base.spec,
+        logs: override.logs !== undefined ? override.logs : base.logs,
+        file: override.file !== undefined ? override.file : base.file,
+        docs: override.docs !== undefined ? override.docs : base.docs,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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AAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAC7D,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAC7D,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAC7D,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAC7D,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAC7D,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;KAC9D,CAAC;AACJ,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Error Handling Utilities
+ *
+ * Provides centralized error handling for the CLI with proper exit codes
+ * and formatted error messages for both JSON and text output modes.
+ */
+import type { OutputOptions } from './output';
+/**
+ * Custom CLI error class
+ */
+export declare class CLIError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Exit codes for different error types
+ */
+export declare const ExitCodes: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly INVALID_ARGUMENT: 2;
+    readonly NOT_FOUND: 3;
+    readonly PERMISSION_DENIED: 4;
+    readonly CONFLICT: 5;
+    readonly SDK_NOT_AVAILABLE: 9;
+};
+/**
+ * Handle errors and exit with appropriate code
+ *
+ * @param error - The error to handle
+ * @param options - Output options (JSON mode, etc.)
+ */
+export declare function handleError(error: unknown, options?: OutputOptions): never;
+/**
+ * Wrap a function with error handling
+ *
+ * @param fn - The async function to wrap
+ * @param options - Output options
+ * @returns Wrapped function that handles errors
+ */
+export declare function withErrorHandling<T extends any[], R>(fn: (...args: T) => Promise<R>, options?: OutputOptions): (...args: T) => Promise<R>;
+//# 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":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACd,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,KAAK,CA+E9E;AA+BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EAClD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,aAAkB,GAC1B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAQ5B"}

package/dist/utils/errors.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Error Handling Utilities
+ *
+ * Provides centralized error handling for the CLI with proper exit codes
+ * and formatted error messages for both JSON and text output modes.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExitCodes = exports.CLIError = void 0;
+exports.handleError = handleError;
+exports.withErrorHandling = withErrorHandling;
+const chalk_1 = __importDefault(require("chalk"));
+const factory_1 = require("../sdk/factory");
+/**
+ * Custom CLI error class
+ */
+class CLIError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'CLIError';
+    }
+}
+exports.CLIError = CLIError;
+/**
+ * Exit codes for different error types
+ */
+exports.ExitCodes = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    INVALID_ARGUMENT: 2,
+    NOT_FOUND: 3,
+    PERMISSION_DENIED: 4,
+    CONFLICT: 5,
+    SDK_NOT_AVAILABLE: 9,
+};
+/**
+ * Handle errors and exit with appropriate code
+ *
+ * @param error - The error to handle
+ * @param options - Output options (JSON mode, etc.)
+ */
+function handleError(error, options = {}) {
+    if (error instanceof factory_1.SDKNotAvailableError) {
+        if (options.json) {
+            console.error(JSON.stringify({
+                status: 'error',
+                error: {
+                    code: 'SDK_NOT_AVAILABLE',
+                    message: error.message,
+                    sdk: error.sdk,
+                },
+            }, null, 2));
+        }
+        else {
+            console.error(chalk_1.default.red('Error:'), error.message);
+            console.error(chalk_1.default.gray('\nMake sure @fractary/core is installed:'), chalk_1.default.cyan('npm install @fractary/core'));
+        }
+        process.exit(exports.ExitCodes.SDK_NOT_AVAILABLE);
+    }
+    if (error instanceof CLIError) {
+        if (options.json) {
+            console.error(JSON.stringify({
+                status: 'error',
+                error: {
+                    code: error.code,
+                    message: error.message,
+                },
+            }, null, 2));
+        }
+        else {
+            console.error(chalk_1.default.red('Error:'), error.message);
+        }
+        // Map error codes to exit codes
+        const exitCode = getExitCodeForError(error.code);
+        process.exit(exitCode);
+    }
+    // Handle generic errors
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    if (options.json) {
+        console.error(JSON.stringify({
+            status: 'error',
+            error: {
+                code: 'UNKNOWN_ERROR',
+                message: errorMessage,
+            },
+        }, null, 2));
+    }
+    else {
+        console.error(chalk_1.default.red('Error:'), errorMessage);
+        // Include stack trace in non-JSON mode for debugging
+        if (error instanceof Error && error.stack) {
+            console.error(chalk_1.default.gray('\nStack trace:'));
+            console.error(chalk_1.default.gray(error.stack));
+        }
+    }
+    process.exit(exports.ExitCodes.GENERAL_ERROR);
+}
+/**
+ * Get exit code for a CLI error code
+ */
+function getExitCodeForError(code) {
+    switch (code) {
+        case 'INVALID_ARGUMENT':
+        case 'INVALID_INPUT':
+        case 'VALIDATION_ERROR':
+            return exports.ExitCodes.INVALID_ARGUMENT;
+        case 'NOT_FOUND':
+        case 'ISSUE_NOT_FOUND':
+        case 'SPEC_NOT_FOUND':
+        case 'LOG_NOT_FOUND':
+            return exports.ExitCodes.NOT_FOUND;
+        case 'PERMISSION_DENIED':
+        case 'UNAUTHORIZED':
+            return exports.ExitCodes.PERMISSION_DENIED;
+        case 'CONFLICT':
+        case 'ALREADY_EXISTS':
+            return exports.ExitCodes.CONFLICT;
+        default:
+            return exports.ExitCodes.GENERAL_ERROR;
+    }
+}
+/**
+ * Wrap a function with error handling
+ *
+ * @param fn - The async function to wrap
+ * @param options - Output options
+ * @returns Wrapped function that handles errors
+ */
+function withErrorHandling(fn, options = {}) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            handleError(error, options);
+        }
+    };
+}
+//# 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":"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"}

package/dist/utils/output.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Output Formatting Utilities
+ *
+ * Provides standardized output formatting for both JSON and text modes.
+ */
+/**
+ * Output options
+ */
+export interface OutputOptions {
+    json?: boolean;
+}
+/**
+ * Output a success message with data
+ *
+ * @param data - The data to output
+ * @param options - Output options
+ */
+export declare function success(data: any, options?: OutputOptions): void;
+/**
+ * Output an error message
+ *
+ * @param message - The error message
+ * @param code - The error code
+ * @param options - Output options
+ */
+export declare function error(message: string, code: string, options?: OutputOptions): void;
+/**
+ * Output a warning message
+ *
+ * @param message - The warning message
+ * @param options - Output options
+ */
+export declare function warning(message: string, options?: OutputOptions): void;
+/**
+ * Output an info message
+ *
+ * @param message - The info message
+ * @param options - Output options
+ */
+export declare function info(message: string, options?: OutputOptions): void;
+/**
+ * Create a formatted table
+ *
+ * @param headers - Table headers
+ * @param rows - Table rows
+ * @returns Formatted table as string
+ */
+export declare function formatTable(headers: string[], rows: string[][]): string;
+/**
+ * Format a list of items
+ *
+ * @param items - The items to format
+ * @param bullet - The bullet character (default: •)
+ * @returns Formatted list as string
+ */
+export declare function formatList(items: string[], bullet?: string): string;
+/**
+ * Format a key-value pair
+ *
+ * @param key - The key
+ * @param value - The value
+ * @param options - Formatting options
+ * @returns Formatted key-value as string
+ */
+export declare function formatKeyValue(key: string, value: string | number | boolean, options?: {
+    color?: boolean;
+}): string;
+/**
+ * Format a section with title and content
+ *
+ * @param title - The section title
+ * @param content - The section content
+ * @returns Formatted section as string
+ */
+export declare function formatSection(title: string, content: string): string;
+/**
+ * Format a success checkmark
+ *
+ * @param message - The success message
+ * @returns Formatted success message
+ */
+export declare function formatSuccess(message: string): string;
+/**
+ * Format an error cross
+ *
+ * @param message - The error message
+ * @returns Formatted error message
+ */
+export declare function formatError(message: string): string;
+/**
+ * Format a spinner/loading message
+ *
+ * @param message - The loading message
+ * @returns Formatted loading message
+ */
+export declare function formatLoading(message: string): string;
+/**
+ * Truncate a string to a maximum length
+ *
+ * @param str - The string to truncate
+ * @param maxLength - The maximum length
+ * @returns Truncated string
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Format a timestamp
+ *
+ * @param date - The date to format
+ * @param options - Formatting options
+ * @returns Formatted timestamp
+ */
+export declare function formatTimestamp(date: Date | string, options?: {
+    relative?: boolean;
+}): string;
+//# 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;AAKH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAQpE;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAMtF;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAM1E;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAMvE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAYvE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAY,GAAG,MAAM,CAExE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAChC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,MAAM,CAiBR"}