@defai.digital/ax-cli 3.14.13 → 3.14.16

package/dist/utils/errors.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Typed Error Classes
+ * Provides consistent, categorized error handling across the application
+ */
+/**
+ * Base error class for AX CLI errors
+ */
+export declare class AxCliError extends Error {
+    readonly category: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, category: string, details?: unknown | undefined);
+}
+/**
+ * Configuration-related errors (YAML, settings, etc.)
+ */
+export declare class ConfigurationError extends AxCliError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Validation errors (Zod, schema, input validation)
+ */
+export declare class ValidationError extends AxCliError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * File system operation errors
+ */
+export declare class FileSystemError extends AxCliError {
+    readonly filePath?: string | undefined;
+    constructor(message: string, filePath?: string | undefined, details?: unknown);
+}
+/**
+ * Network/API errors
+ */
+export declare class NetworkError extends AxCliError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined, details?: unknown);
+}
+/**
+ * MCP (Model Context Protocol) errors
+ */
+export declare class MCPError extends AxCliError {
+    readonly serverName?: string | undefined;
+    constructor(message: string, serverName?: string | undefined, details?: unknown);
+}
+/**
+ * Tool execution errors
+ */
+export declare class ToolExecutionError extends AxCliError {
+    readonly toolName?: string | undefined;
+    constructor(message: string, toolName?: string | undefined, details?: unknown);
+}
+/**
+ * Authentication/Authorization errors
+ */
+export declare class AuthenticationError extends AxCliError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Type guard to check if error is an AxCliError
+ */
+export declare function isAxCliError(error: unknown): error is AxCliError;
+/**
+ * Extract user-friendly error message from any error type
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Format error for logging with details
+ */
+export declare function formatErrorForLogging(error: unknown): string;
+/**
+ * Wrap any error in an appropriate AxCliError
+ */
+export declare function wrapError(error: unknown, category: string, context?: string): AxCliError;

package/dist/utils/errors.js

@@ -0,0 +1,139 @@
+/**
+ * Typed Error Classes
+ * Provides consistent, categorized error handling across the application
+ */
+/**
+ * Base error class for AX CLI errors
+ */
+export class AxCliError extends Error {
+    category;
+    details;
+    constructor(message, category, details) {
+        super(message);
+        this.category = category;
+        this.details = details;
+        this.name = 'AxCliError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Configuration-related errors (YAML, settings, etc.)
+ */
+export class ConfigurationError extends AxCliError {
+    constructor(message, details) {
+        super(message, 'Configuration', details);
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Validation errors (Zod, schema, input validation)
+ */
+export class ValidationError extends AxCliError {
+    constructor(message, details) {
+        super(message, 'Validation', details);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * File system operation errors
+ */
+export class FileSystemError extends AxCliError {
+    filePath;
+    constructor(message, filePath, details) {
+        super(message, 'FileSystem', details);
+        this.filePath = filePath;
+        this.name = 'FileSystemError';
+    }
+}
+/**
+ * Network/API errors
+ */
+export class NetworkError extends AxCliError {
+    statusCode;
+    constructor(message, statusCode, details) {
+        super(message, 'Network', details);
+        this.statusCode = statusCode;
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * MCP (Model Context Protocol) errors
+ */
+export class MCPError extends AxCliError {
+    serverName;
+    constructor(message, serverName, details) {
+        super(message, 'MCP', details);
+        this.serverName = serverName;
+        this.name = 'MCPError';
+    }
+}
+/**
+ * Tool execution errors
+ */
+export class ToolExecutionError extends AxCliError {
+    toolName;
+    constructor(message, toolName, details) {
+        super(message, 'ToolExecution', details);
+        this.toolName = toolName;
+        this.name = 'ToolExecutionError';
+    }
+}
+/**
+ * Authentication/Authorization errors
+ */
+export class AuthenticationError extends AxCliError {
+    constructor(message, details) {
+        super(message, 'Authentication', details);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Type guard to check if error is an AxCliError
+ */
+export function isAxCliError(error) {
+    return error instanceof AxCliError;
+}
+/**
+ * Extract user-friendly error message from any error type
+ */
+export function getErrorMessage(error) {
+    if (error instanceof AxCliError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'An unknown error occurred';
+}
+/**
+ * Format error for logging with details
+ */
+export function formatErrorForLogging(error) {
+    if (error instanceof AxCliError) {
+        let message = `[${error.category}] ${error.message}`;
+        if (error.details) {
+            message += `\nDetails: ${JSON.stringify(error.details, null, 2)}`;
+        }
+        if (error.stack) {
+            message += `\nStack: ${error.stack}`;
+        }
+        return message;
+    }
+    if (error instanceof Error) {
+        return error.stack || error.message;
+    }
+    return String(error);
+}
+/**
+ * Wrap any error in an appropriate AxCliError
+ */
+export function wrapError(error, category, context) {
+    const message = context
+        ? `${context}: ${getErrorMessage(error)}`
+        : getErrorMessage(error);
+    return new AxCliError(message, category, error);
+}
+//# 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;;;GAGG;AAEH;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,QAAgB,EAChB,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAG3B;IAFlB,YACE,OAAe,EACC,QAAiB,EACjC,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAHtB,aAAQ,GAAR,QAAQ,CAAS;QAIjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAGxB;IAFlB,YACE,OAAe,EACC,UAAmB,EACnC,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAHnB,eAAU,GAAV,UAAU,CAAS;QAInC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,UAAU;IAGpB;IAFlB,YACE,OAAe,EACC,UAAmB,EACnC,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAHf,eAAU,GAAV,UAAU,CAAS;QAInC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAG9B;IAFlB,YACE,OAAe,EACC,QAAiB,EACjC,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QAHzB,aAAQ,GAAR,QAAQ,CAAS;QAIjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,UAAU,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,OAAO,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QAErD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,IAAI,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACpE,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC;QACvC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;IACtC,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,QAAgB,EAAE,OAAgB;IAC1E,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,GAAG,OAAO,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE;QACzC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAE3B,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/incremental-analyzer.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Incremental Analyzer
+ *
+ * Analyzes only changed files and their dependencies using git integration.
+ * Provides 10-50x speedup by avoiding analysis of unchanged files.
+ *
+ * Quick Win #2: Git-Based Incremental Analysis (Est. time: 1 hour)
+ * Impact: 10-50x reduction in files to analyze
+ */
+/**
+ * Configuration for incremental analysis
+ */
+export interface IncrementalConfig {
+    /** Base directory for git operations (default: cwd) */
+    baseDir?: string;
+    /** File patterns to include (default: all) */
+    include?: string[];
+    /** File patterns to exclude (default: none) */
+    exclude?: string[];
+    /** Compare against specific commit/branch (default: HEAD) */
+    compareWith?: string;
+    /** Include untracked files (default: true) */
+    includeUntracked?: boolean;
+    /** Build dependency graph (default: false, for future use) */
+    trackDependencies?: boolean;
+}
+/**
+ * Changed file info
+ */
+export interface ChangedFile {
+    /** File path relative to base directory */
+    path: string;
+    /** Type of change */
+    status: 'modified' | 'added' | 'deleted' | 'renamed' | 'untracked';
+    /** Previous path (for renamed files) */
+    oldPath?: string;
+}
+/**
+ * Result of incremental analysis
+ */
+export interface IncrementalResult {
+    /** Files that need analysis */
+    filesToAnalyze: string[];
+    /** Files that are cached */
+    cachedFiles: string[];
+    /** Changed files detected */
+    changedFiles: ChangedFile[];
+    /** Total files in project */
+    totalFiles: number;
+    /** Estimated speedup */
+    speedup: number;
+}
+/**
+ * Check if directory is a git repository
+ */
+export declare function isGitRepo(dir?: string): boolean;
+/**
+ * Get changed files from git
+ *
+ * @param config - Configuration options
+ * @returns Array of changed files
+ *
+ * @example
+ * ```typescript
+ * const changed = await getChangedFiles({
+ *   compareWith: 'main',
+ *   include: ['*.ts', '*.tsx'],
+ * });
+ *
+ * console.log(`${changed.length} files changed`);
+ * ```
+ */
+export declare function getChangedFiles(config?: IncrementalConfig): Promise<ChangedFile[]>;
+/**
+ * Get files to analyze incrementally
+ *
+ * Returns only files that need analysis based on git changes.
+ *
+ * @param allFiles - All files in project
+ * @param config - Configuration options
+ * @returns Incremental analysis result
+ *
+ * @example
+ * ```typescript
+ * const allFiles = await glob('src/** /*.ts');
+ * const result = await getFilesToAnalyze(allFiles);
+ *
+ * console.log(`Analyzing ${result.filesToAnalyze.length} of ${result.totalFiles} files`);
+ * console.log(`Speedup: ${result.speedup.toFixed(1)}x`);
+ * ```
+ */
+export declare function getFilesToAnalyze(allFiles: string[], config?: IncrementalConfig): Promise<IncrementalResult>;
+/**
+ * Get git repository info
+ *
+ * @param baseDir - Base directory (default: cwd)
+ * @returns Repository information
+ */
+export declare function getGitInfo(baseDir?: string): {
+    branch: string;
+    commit: string;
+    isDirty: boolean;
+    ahead: number;
+    behind: number;
+} | null;
+/**
+ * Simple dependency tracker (for future use)
+ *
+ * Parses import/require statements to build a dependency graph.
+ */
+export declare class DependencyTracker {
+    private graph;
+    private reverseGraph;
+    /**
+     * Add a file and its dependencies
+     */
+    addFile(filePath: string): Promise<void>;
+    /**
+     * Get files that depend on the given file
+     */
+    getDependents(filePath: string): string[];
+    /**
+     * Get all affected files (transitive dependencies)
+     */
+    getAffectedFiles(changedFiles: string[]): string[];
+    /**
+     * Parse import statements from file content
+     */
+    private parseImports;
+    /**
+     * Resolve import path to absolute path
+     */
+    private resolveImport;
+}