@defai.digital/ax-cli 4.4.6 → 4.4.10

package/dist/utils/init-validator.d.ts

@@ -1,65 +0,0 @@
-/**
- * Validation utilities for init command
- */
-import type { ProjectInfo } from '../types/project-analysis.js';
-export interface ValidationResult {
-    valid: boolean;
-    warnings: string[];
-    errors: string[];
-    suggestions: string[];
-}
-export interface ValidationChecks {
-    hasPackageJson?: boolean;
-    hasGitRepo?: boolean;
-    hasExistingConfig?: boolean;
-    hasValidStructure?: boolean;
-    hasMinimumFiles?: boolean;
-}
-export declare class InitValidator {
-    private projectRoot;
-    constructor(projectRoot: string);
-    /** Helper to resolve path relative to project root */
-    private resolvePath;
-    /** Helper to check if path exists */
-    private pathExists;
-    /**
-     * Run all validation checks
-     */
-    validate(projectInfo?: ProjectInfo): ValidationResult;
-    /**
-     * Check for package.json
-     */
-    private checkPackageJson;
-    /**
-     * Check for git repository
-     */
-    private checkGitRepo;
-    /**
-     * Check for existing AX CLI configuration
-     */
-    private checkExistingConfig;
-    /**
-     * Check project structure
-     */
-    private checkProjectStructure;
-    /**
-     * Check for minimum files
-     */
-    private checkMinimumFiles;
-    /**
-     * Validate project info
-     */
-    private validateProjectInfo;
-    /**
-     * Validate custom instructions content
-     */
-    static validateCustomInstructions(content: string): ValidationResult;
-    /**
-     * Check if force flag is needed
-     */
-    needsForceFlag(): boolean;
-    /**
-     * Get validation summary string
-     */
-    static formatValidationResult(result: ValidationResult): string;
-}

package/dist/utils/init-validator.js

@@ -1,252 +0,0 @@
-/**
- * Validation utilities for init command
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { parseJson, parseJsonFile } from './json-utils.js';
-export class InitValidator {
-    projectRoot;
-    constructor(projectRoot) {
-        this.projectRoot = projectRoot;
-    }
-    /** Helper to resolve path relative to project root */
-    resolvePath(...segments) {
-        return path.join(this.projectRoot, ...segments);
-    }
-    /** Helper to check if path exists */
-    pathExists(...segments) {
-        return fs.existsSync(this.resolvePath(...segments));
-    }
-    /**
-     * Run all validation checks
-     */
-    validate(projectInfo) {
-        const result = {
-            valid: true,
-            warnings: [],
-            errors: [],
-            suggestions: [],
-        };
-        // Check for package.json
-        this.checkPackageJson(result);
-        // Check for git repository
-        this.checkGitRepo(result);
-        // Check for existing AX CLI config
-        this.checkExistingConfig(result);
-        // Check project structure
-        this.checkProjectStructure(result);
-        // Check if project has minimum files
-        this.checkMinimumFiles(result);
-        // Validate project info if provided
-        if (projectInfo) {
-            this.validateProjectInfo(projectInfo, result);
-        }
-        // Set overall validity
-        result.valid = result.errors.length === 0;
-        return result;
-    }
-    /**
-     * Check for package.json
-     */
-    checkPackageJson(result) {
-        const packageJsonPath = this.resolvePath('package.json');
-        if (!this.pathExists('package.json')) {
-            result.warnings.push('No package.json found - may not be a Node.js project');
-            result.suggestions.push('Run: npm init (if this is a Node.js project)');
-        }
-        else {
-            try {
-                const content = fs.readFileSync(packageJsonPath, 'utf-8');
-                // Check for empty file
-                if (!content || content.trim() === '') {
-                    result.errors.push('package.json is empty');
-                    return;
-                }
-                const parseResult = parseJson(content);
-                if (!parseResult.success) {
-                    result.errors.push(`Invalid package.json - ${parseResult.error}`);
-                    return;
-                }
-                const packageJson = parseResult.data;
-                // Check if package.json is actually an object
-                if (typeof packageJson !== 'object' || packageJson === null) {
-                    result.errors.push('package.json is not a valid JSON object');
-                    return;
-                }
-                // Check for common issues
-                if (!packageJson.name) {
-                    result.warnings.push('package.json missing "name" field');
-                }
-                if (!packageJson.version) {
-                    result.warnings.push('package.json missing "version" field');
-                }
-                // Check for type: module (ESM)
-                if (packageJson.type !== 'module') {
-                    result.suggestions.push('Consider adding "type": "module" for ESM support');
-                }
-            }
-            catch (error) {
-                result.errors.push(`Invalid package.json - ${error instanceof Error ? error.message : 'File read error'}`);
-            }
-        }
-    }
-    /**
-     * Check for git repository
-     */
-    checkGitRepo(result) {
-        if (!this.pathExists('.git')) {
-            result.warnings.push('Not a git repository');
-            result.suggestions.push('Run: git init (for version control)');
-        }
-    }
-    /**
-     * Check for existing AX CLI configuration
-     */
-    checkExistingConfig(result) {
-        if (this.pathExists('.ax-cli', 'CUSTOM.md')) {
-            result.warnings.push('Existing CUSTOM.md found - will be overwritten unless --force is used');
-        }
-        if (this.pathExists('.ax-cli', 'index.json')) {
-            const indexPath = this.resolvePath('.ax-cli', 'index.json');
-            const parseResult = parseJsonFile(indexPath);
-            if (parseResult.success) {
-                const indexData = parseResult.data;
-                const lastUpdated = indexData.lastAnalyzed || indexData.templateAppliedAt;
-                if (lastUpdated) {
-                    const date = new Date(lastUpdated);
-                    const daysSince = Math.floor((Date.now() - date.getTime()) / (1000 * 60 * 60 * 24));
-                    if (daysSince > 30) {
-                        result.suggestions.push(`CUSTOM.md is ${daysSince} days old - consider refreshing`);
-                    }
-                }
-            }
-            else {
-                result.warnings.push('Existing index.json is invalid');
-            }
-        }
-    }
-    /**
-     * Check project structure
-     */
-    checkProjectStructure(result) {
-        const commonDirs = ['src', 'lib', 'dist', 'build', 'test', 'tests', '__tests__'];
-        const hasStandardDir = commonDirs.some(dir => this.pathExists(dir));
-        if (!hasStandardDir) {
-            result.warnings.push('No standard project directories found (src/, lib/, etc.)');
-            result.suggestions.push('Project may be empty or have non-standard structure');
-        }
-    }
-    /**
-     * Check for minimum files
-     */
-    checkMinimumFiles(result) {
-        try {
-            const files = fs.readdirSync(this.projectRoot);
-            const nonHiddenFiles = files.filter(f => !f.startsWith('.'));
-            if (nonHiddenFiles.length === 0) {
-                result.errors.push('Project directory is empty');
-                return;
-            }
-            if (nonHiddenFiles.length === 1 && nonHiddenFiles[0] === 'package.json') {
-                result.warnings.push('Project only contains package.json - no source files found');
-                result.suggestions.push('Add source files before initializing AX CLI');
-            }
-        }
-        catch (error) {
-            result.errors.push(`Cannot read project directory: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    /**
-     * Validate project info
-     */
-    validateProjectInfo(projectInfo, result) {
-        // Check if project type was detected
-        if (projectInfo.projectType === 'unknown' || projectInfo.projectType === 'application') {
-            result.warnings.push('Could not determine specific project type');
-            result.suggestions.push('Consider using a template: ax-cli init --template <type>');
-        }
-        // Check if primary language was detected
-        if (projectInfo.primaryLanguage === 'Unknown') {
-            result.warnings.push('Could not determine primary programming language');
-        }
-        // Check if tech stack was detected
-        if (projectInfo.techStack.length === 0) {
-            result.warnings.push('No tech stack detected');
-            result.suggestions.push('Ensure package.json has dependencies listed');
-        }
-        // Check entry point
-        if (!projectInfo.entryPoint) {
-            result.warnings.push('No entry point detected');
-        }
-    }
-    /**
-     * Validate custom instructions content
-     */
-    static validateCustomInstructions(content) {
-        const result = {
-            valid: true,
-            warnings: [],
-            errors: [],
-            suggestions: [],
-        };
-        // Check minimum length
-        if (content.length < 100) {
-            result.errors.push('CUSTOM.md is too short (< 100 characters)');
-        }
-        // Check for required sections
-        const requiredSections = [
-            '## 🎯 Critical Rules',
-            '## 📋 Project Overview',
-            '## 🔧 Code Patterns',
-        ];
-        for (const section of requiredSections) {
-            if (!content.includes(section)) {
-                result.warnings.push(`Missing recommended section: ${section}`);
-            }
-        }
-        // Check token count (rough estimate)
-        const estimatedTokens = Math.ceil(content.length / 4);
-        if (estimatedTokens > 2000) {
-            result.warnings.push(`CUSTOM.md is large (~${estimatedTokens} tokens)`);
-            result.suggestions.push('Consider using template imports or reducing content');
-        }
-        // Check for common issues
-        if (content.includes('TODO') || content.includes('FIXME')) {
-            result.warnings.push('CUSTOM.md contains TODO/FIXME markers');
-        }
-        if (content.includes('__placeholder__') || content.includes('<insert')) {
-            result.errors.push('CUSTOM.md contains placeholder text');
-        }
-        result.valid = result.errors.length === 0;
-        return result;
-    }
-    /**
-     * Check if force flag is needed
-     */
-    needsForceFlag() {
-        return this.pathExists('.ax-cli', 'CUSTOM.md');
-    }
-    /**
-     * Get validation summary string
-     */
-    static formatValidationResult(result) {
-        const parts = [];
-        if (result.errors.length > 0) {
-            parts.push('❌ Errors:');
-            result.errors.forEach(e => parts.push(`   - ${e}`));
-        }
-        if (result.warnings.length > 0) {
-            parts.push('⚠️  Warnings:');
-            result.warnings.forEach(w => parts.push(`   - ${w}`));
-        }
-        if (result.suggestions.length > 0) {
-            parts.push('💡 Suggestions:');
-            result.suggestions.forEach(s => parts.push(`   - ${s}`));
-        }
-        if (result.valid && result.warnings.length === 0 && result.suggestions.length === 0) {
-            parts.push('✅ All validation checks passed');
-        }
-        return parts.join('\n');
-    }
-}
-//# sourceMappingURL=init-validator.js.map

package/dist/utils/init-validator.js.map

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

package/dist/utils/input-sanitizer.d.ts

@@ -1,210 +0,0 @@
-/**
- * Input Sanitization Framework (REQ-SEC-007)
- *
- * Provides comprehensive input validation and sanitization to prevent:
- * - ReDoS (Regular Expression Denial of Service)
- * - Command injection
- * - Path traversal
- * - Unicode attacks
- * - Buffer overflow
- *
- * Security: CVSS 7.3 (High Priority)
- */
-/**
- * Sanitization result with validation and cleaned value
- */
-export interface SanitizationResult {
-    /**
-     * Whether the input passed validation
-     */
-    valid: boolean;
-    /**
-     * Sanitized/cleaned value (only if valid)
-     */
-    value?: string;
-    /**
-     * Error message if validation failed
-     */
-    error?: string;
-    /**
-     * Warning messages (non-fatal issues)
-     */
-    warnings?: string[];
-}
-/**
- * Configuration for input sanitization
- */
-export interface SanitizerOptions {
-    /**
-     * Maximum allowed length (default: 10,000 characters)
-     */
-    maxLength?: number;
-    /**
-     * Whether to normalize Unicode (default: true)
-     */
-    normalizeUnicode?: boolean;
-    /**
-     * Character whitelist pattern (regex)
-     */
-    allowedPattern?: RegExp;
-    /**
-     * Whether to trim whitespace (default: true)
-     */
-    trim?: boolean;
-    /**
-     * Whether to allow empty strings (default: false)
-     */
-    allowEmpty?: boolean;
-}
-/**
- * Default maximum input lengths for different contexts
- */
-export declare const MAX_INPUT_LENGTHS: {
-    readonly COMMAND: 10000;
-    readonly FILE_PATH: 4096;
-    readonly USER_INPUT: 50000;
-    readonly SEARCH_QUERY: 1000;
-    readonly ENV_VALUE: 10000;
-    readonly CONFIG_VALUE: 10000;
-};
-/**
- * Safe characters for different contexts
- */
-export declare const SAFE_PATTERNS: {
-    /**
-     * Alphanumeric, spaces, and common punctuation
-     */
-    readonly BASIC: RegExp;
-    /**
-     * Safe for file paths (no directory traversal)
-     */
-    readonly FILE_PATH: RegExp;
-    /**
-     * Safe for environment variable values
-     */
-    readonly ENV_VALUE: RegExp;
-    /**
-     * Printable ASCII only (most restrictive)
-     */
-    readonly ASCII_PRINTABLE: RegExp;
-};
-/**
- * Normalize Unicode string to prevent homograph attacks
- *
- * Uses NFC (Canonical Decomposition, followed by Canonical Composition)
- * which is the recommended normalization form for most use cases
- *
- * @param input - String to normalize
- * @returns Normalized string
- */
-export declare function normalizeUnicode(input: string): string;
-/**
- * Check for dangerous patterns in input
- *
- * @param input - String to check
- * @returns Array of detected dangerous patterns
- */
-export declare function detectDangerousPatterns(input: string): string[];
-/**
- * Sanitize general user input with configurable options
- *
- * @param input - Raw input string
- * @param options - Sanitization options
- * @returns Sanitization result
- *
- * @example
- * ```typescript
- * const result = sanitizeInput('User input here', {
- *   maxLength: 1000,
- *   normalizeUnicode: true,
- *   allowedPattern: SAFE_PATTERNS.BASIC,
- * });
- *
- * if (result.valid) {
- *   // Use result.value safely
- * } else {
- *   console.error(result.error);
- * }
- * ```
- */
-export declare function sanitizeInput(input: string, options?: SanitizerOptions): SanitizationResult;
-/**
- * Sanitize file path input to prevent path traversal
- *
- * @param path - File path to sanitize
- * @returns Sanitization result
- *
- * @example
- * ```typescript
- * const result = sanitizeFilePath('../../../etc/passwd');
- * if (!result.valid) {
- *   console.error('Invalid path:', result.error);
- * }
- * ```
- */
-export declare function sanitizeFilePath(path: string): SanitizationResult;
-/**
- * Sanitize shell command input
- *
- * NOTE: This is a last line of defense. Prefer execFile over exec
- * and use argument arrays instead of concatenating commands.
- *
- * @param command - Command string to sanitize
- * @returns Sanitization result
- *
- * @example
- * ```typescript
- * const result = sanitizeCommand('ls -la');
- * if (result.valid) {
- *   // Still prefer execFile with args array
- *   execFile(result.value.split(' ')[0], result.value.split(' ').slice(1));
- * }
- * ```
- */
-export declare function sanitizeCommand(command: string): SanitizationResult;
-/**
- * Sanitize search query input
- *
- * @param query - Search query to sanitize
- * @returns Sanitization result
- */
-export declare function sanitizeSearchQuery(query: string): SanitizationResult;
-/**
- * Sanitize environment variable value
- *
- * @param value - Environment variable value to sanitize
- * @returns Sanitization result
- */
-export declare function sanitizeEnvValue(value: string): SanitizationResult;
-/**
- * Escape shell arguments for safe execution
- *
- * NOTE: This is a defense-in-depth measure. Always prefer:
- * 1. execFile with argument array over exec
- * 2. Argument validation/whitelisting
- * 3. This escaping function as a last resort
- *
- * @param arg - Argument to escape
- * @returns Safely escaped argument
- */
-export declare function escapeShellArg(arg: string): string;
-/**
- * Validate regex pattern for ReDoS protection
- *
- * Checks for common ReDoS patterns:
- * - Nested quantifiers (e.g., (a+)+)
- * - Alternation with overlapping patterns
- * - Excessive backtracking potential
- *
- * @param pattern - Regex pattern to validate
- * @returns Validation result
- *
- * @example
- * ```typescript
- * const result = validateRegexPattern('(a+)+b');
- * if (!result.valid) {
- *   console.error('Unsafe regex:', result.error);
- * }
- * ```
- */
-export declare function validateRegexPattern(pattern: string): SanitizationResult;