@defai.digital/ax-cli 4.4.6 → 4.4.10

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

@@ -1,72 +0,0 @@
-/**
- * JSON Parsing Utilities
- * Centralized JSON operations with validation and error handling
- *
- * Security: REQ-SEC-005 - Prototype Pollution Prevention
- * - Sanitizes dangerous keys (__proto__, constructor, prototype)
- * - Validates JSON structure before use
- * - Prevents object property injection attacks
- */
-import { z } from 'zod';
-/**
- * Parse JSON string with Zod schema validation
- */
-export declare function parseJson<T>(jsonString: string, schema?: z.ZodSchema<T>): {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: string;
-};
-/**
- * Parse JSON file with Zod schema validation
- */
-export declare function parseJsonFile<T>(filePath: string, schema?: z.ZodSchema<T>): {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: string;
-};
-/**
- * Safely stringify JSON with error handling
- */
-export declare function stringifyJson(data: unknown, pretty?: boolean): {
-    success: true;
-    json: string;
-} | {
-    success: false;
-    error: string;
-};
-/**
- * Write JSON file with validation and formatting
- * Uses atomic write pattern (temp file + rename) to prevent corruption
- *
- * Bug fixes:
- * - Uses unique temp file names (PID + timestamp) to prevent race conditions
- * - Handles cross-filesystem renames with copy+delete fallback
- * - Ensures parent directory exists
- * - Cleans up stale temp files
- */
-export declare function writeJsonFile<T>(filePath: string, data: T, schema?: z.ZodSchema<T>, pretty?: boolean): {
-    success: true;
-} | {
-    success: false;
-    error: string;
-};
-/**
- * Parse JSON with fallback value on error
- */
-export declare function parseJsonWithFallback<T>(jsonString: string, fallback: T, schema?: z.ZodSchema<T>): T;
-/**
- * Parse JSON file with fallback value on error
- */
-export declare function parseJsonFileWithFallback<T>(filePath: string, fallback: T, schema?: z.ZodSchema<T>): T;
-/**
- * Sanitize an object to prevent prototype pollution
- * Exported for testing purposes
- *
- * @param obj - Object to sanitize
- * @returns Sanitized object
- */
-export declare function sanitizeJson<T>(obj: T): T;

package/dist/utils/json-utils.js

@@ -1,226 +0,0 @@
-/**
- * JSON Parsing Utilities
- * Centralized JSON operations with validation and error handling
- *
- * Security: REQ-SEC-005 - Prototype Pollution Prevention
- * - Sanitizes dangerous keys (__proto__, constructor, prototype)
- * - Validates JSON structure before use
- * - Prevents object property injection attacks
- */
-import { readFileSync, writeFileSync, renameSync, unlinkSync, existsSync, copyFileSync, mkdirSync } from 'fs';
-import { dirname } from 'path';
-/**
- * Dangerous keys that can cause prototype pollution
- * These keys should never be allowed in parsed JSON
- */
-const DANGEROUS_KEYS = ['__proto__', 'constructor', 'prototype'];
-/**
- * Sanitize parsed JSON by removing dangerous keys
- * Prevents prototype pollution attacks (REQ-SEC-005)
- *
- * @param obj - Object to sanitize (recursively)
- * @returns Sanitized object with dangerous keys removed
- */
-function sanitizeObject(obj) {
-    if (obj === null || typeof obj !== 'object') {
-        return obj;
-    }
-    // Handle arrays
-    if (Array.isArray(obj)) {
-        return obj.map(item => sanitizeObject(item));
-    }
-    // Handle objects
-    const sanitized = {};
-    for (const key in obj) {
-        // Skip dangerous keys
-        if (DANGEROUS_KEYS.includes(key)) {
-            continue;
-        }
-        // Skip inherited properties
-        if (!Object.prototype.hasOwnProperty.call(obj, key)) {
-            continue;
-        }
-        // Recursively sanitize nested objects
-        const value = obj[key];
-        sanitized[key] = sanitizeObject(value);
-    }
-    return sanitized;
-}
-/**
- * Parse JSON string with Zod schema validation
- */
-export function parseJson(jsonString, schema) {
-    try {
-        const rawData = JSON.parse(jsonString);
-        // SECURITY: Sanitize to prevent prototype pollution (REQ-SEC-005)
-        const data = sanitizeObject(rawData);
-        if (schema) {
-            const result = schema.safeParse(data);
-            if (!result.success) {
-                return {
-                    success: false,
-                    error: `Validation failed: ${result.error.message}`,
-                };
-            }
-            return { success: true, data: result.data };
-        }
-        return { success: true, data: data };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : 'Invalid JSON',
-        };
-    }
-}
-/**
- * Parse JSON file with Zod schema validation
- */
-export function parseJsonFile(filePath, schema) {
-    try {
-        const content = readFileSync(filePath, 'utf8');
-        return parseJson(content, schema);
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : 'Failed to read file',
-        };
-    }
-}
-/**
- * Safely stringify JSON with error handling
- */
-export function stringifyJson(data, pretty = false) {
-    try {
-        const json = JSON.stringify(data, null, pretty ? 2 : 0);
-        return { success: true, json };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : 'Failed to stringify',
-        };
-    }
-}
-/**
- * Write JSON file with validation and formatting
- * Uses atomic write pattern (temp file + rename) to prevent corruption
- *
- * Bug fixes:
- * - Uses unique temp file names (PID + timestamp) to prevent race conditions
- * - Handles cross-filesystem renames with copy+delete fallback
- * - Ensures parent directory exists
- * - Cleans up stale temp files
- */
-export function writeJsonFile(filePath, data, schema, pretty = true) {
-    let tempFile;
-    try {
-        // Validate before writing
-        if (schema) {
-            const result = schema.safeParse(data);
-            if (!result.success) {
-                return {
-                    success: false,
-                    error: `Validation failed: ${result.error.message}`,
-                };
-            }
-        }
-        const stringifyResult = stringifyJson(data, pretty);
-        if (!stringifyResult.success) {
-            return stringifyResult;
-        }
-        // Ensure parent directory exists (Bug #24 fix)
-        const dir = dirname(filePath);
-        if (!existsSync(dir)) {
-            try {
-                mkdirSync(dir, { recursive: true });
-            }
-            catch (mkdirError) {
-                return {
-                    success: false,
-                    error: `Cannot create directory ${dir}: ${mkdirError instanceof Error ? mkdirError.message : 'Unknown error'}`,
-                };
-            }
-        }
-        // Create unique temp file name to prevent race conditions (Bug #21 fix)
-        // Format: <filepath>.tmp.<pid>.<timestamp>
-        tempFile = `${filePath}.tmp.${process.pid}.${Date.now()}`;
-        // Clean up any stale temp files from this process (Bug #23 fix)
-        // Check if our specific temp file already exists from a crashed previous write
-        try {
-            if (existsSync(tempFile)) {
-                unlinkSync(tempFile);
-            }
-        }
-        catch {
-            // Ignore stale file cleanup errors
-        }
-        // Atomic write pattern: write to temp file, then rename
-        // This prevents corruption if process crashes during write
-        writeFileSync(tempFile, stringifyResult.json, 'utf8');
-        // Atomic rename - if this succeeds, we know the write was complete
-        try {
-            renameSync(tempFile, filePath);
-        }
-        catch (renameError) {
-            // Handle cross-filesystem rename (Bug #22 fix)
-            if (renameError.code === 'EXDEV') {
-                // Fallback: copy + delete (not atomic, but works across filesystems)
-                try {
-                    copyFileSync(tempFile, filePath);
-                    unlinkSync(tempFile);
-                }
-                catch (copyError) {
-                    throw new Error(`Cross-filesystem copy failed: ${copyError instanceof Error ? copyError.message : 'Unknown error'}`);
-                }
-            }
-            else {
-                throw renameError;
-            }
-        }
-        return { success: true };
-    }
-    catch (error) {
-        // Clean up temp file if it exists
-        if (tempFile) {
-            try {
-                if (existsSync(tempFile)) {
-                    unlinkSync(tempFile);
-                }
-            }
-            catch {
-                // Ignore cleanup errors
-            }
-        }
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : 'Failed to write file',
-        };
-    }
-}
-/**
- * Parse JSON with fallback value on error
- */
-export function parseJsonWithFallback(jsonString, fallback, schema) {
-    const result = parseJson(jsonString, schema);
-    return result.success ? result.data : fallback;
-}
-/**
- * Parse JSON file with fallback value on error
- */
-export function parseJsonFileWithFallback(filePath, fallback, schema) {
-    const result = parseJsonFile(filePath, schema);
-    return result.success ? result.data : fallback;
-}
-/**
- * Sanitize an object to prevent prototype pollution
- * Exported for testing purposes
- *
- * @param obj - Object to sanitize
- * @returns Sanitized object
- */
-export function sanitizeJson(obj) {
-    return sanitizeObject(obj);
-}
-//# sourceMappingURL=json-utils.js.map

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

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

package/dist/utils/llm-optimized-instruction-generator.d.ts

@@ -1,36 +0,0 @@
-/**
- * LLM-Optimized Instruction Generator
- * Generates token-efficient, comprehension-optimized project instructions
- */
-import type { ProjectInfo } from '../types/project-analysis.js';
-interface OptimizationConfig {
-    compressionLevel: 'none' | 'moderate' | 'aggressive';
-    hierarchyEnabled: boolean;
-    criticalRulesCount: number;
-    includeDODONT: boolean;
-    includeTroubleshooting: boolean;
-}
-export declare class LLMOptimizedInstructionGenerator {
-    private config;
-    constructor(config?: Partial<OptimizationConfig>);
-    /**
-     * Generate LLM-optimized custom instructions
-     */
-    generateInstructions(projectInfo: ProjectInfo): string;
-    private generateGotchas;
-    private generateHeader;
-    private generateCriticalRules;
-    private generateProjectOverview;
-    private generateCodePatterns;
-    private generateWorkflow;
-    private generateTroubleshooting;
-    /**
-     * Generate project index JSON
-     */
-    generateIndex(projectInfo: ProjectInfo): string;
-    /**
-     * Generate file organization section
-     */
-    private generateFileOrganization;
-}
-export {};