0xray 4.0.12 → 4.0.13

package/dist/processors/implementations/typescript-compilation-processor.js

@@ -1,86 +0,0 @@
-/**
- * TypeScript Compilation Processor
- *
- * Runs `tsc --noEmit` to catch type errors before writes land.
- * Parses TypeScript error lines from stderr and returns structured results.
- * Gracefully skips when no tsconfig.json exists.
- *
- * @since 2026-03-28
- */
-import { execSync } from "child_process";
-import { existsSync } from "fs";
-import { frameworkLogger } from "../../core/framework-logger.js";
-/**
- * Parse TypeScript error lines from stderr output.
- * Filters for lines containing "error TS" which is the standard TypeScript error format.
- */
-export function parseTypeScriptErrors(stderr) {
-    return stderr
-        .split("\n")
-        .filter((line) => line.includes("error TS"))
-        .map((line) => line.trim());
-}
-/**
- * Run TypeScript compilation check (tsc --noEmit).
- *
- * @param cwd - Working directory for the command (defaults to process.cwd())
- * @param timeout - Maximum execution time in milliseconds (default 30000)
- * @returns Structured result with success status, errors, and timing
- */
-export function runTypeScriptCompilation(cwd, timeout = 30000) {
-    const startTime = Date.now();
-    const workingDir = cwd || process.cwd();
-    frameworkLogger.log("typescript-compilation-processor", "starting tsc --noEmit check", "info", { cwd: workingDir, timeout });
-    // Check if tsconfig.json exists in the working directory
-    if (!existsSync(`${workingDir}/tsconfig.json`)) {
-        frameworkLogger.log("typescript-compilation-processor", "skipped - no tsconfig.json found", "info", { cwd: workingDir });
-        return {
-            success: true,
-            errors: [],
-            duration: Date.now() - startTime,
-            fileCount: 0,
-            skipped: true,
-            reason: "no tsconfig.json found",
-        };
-    }
-    try {
-        execSync("npx tsc --noEmit", {
-            cwd: workingDir,
-            stdio: "pipe",
-            timeout,
-        });
-        frameworkLogger.log("typescript-compilation-processor", "tsc --noEmit passed with no errors", "success", { duration: Date.now() - startTime });
-        return {
-            success: true,
-            errors: [],
-            duration: Date.now() - startTime,
-            fileCount: 0,
-        };
-    }
-    catch (error) {
-        const err = error;
-        const stderr = err.stderr?.toString() || err.message || "";
-        const errorLines = parseTypeScriptErrors(stderr);
-        frameworkLogger.log("typescript-compilation-processor", "tsc --noEmit found type errors", "error", {
-            errorCount: errorLines.length,
-            duration: Date.now() - startTime,
-            errors: errorLines.slice(0, 10), // Log first 10 errors for debugging
-        });
-        return {
-            success: false,
-            errors: errorLines.length > 0 ? errorLines : [stderr],
-            duration: Date.now() - startTime,
-            fileCount: 0,
-            errorCount: errorLines.length,
-        };
-    }
-}
-export const typescriptCompilationProcessor = {
-    name: "typescriptCompilation",
-    priority: 15,
-    enabled: true,
-    async execute(context) {
-        const cwd = context.directory || process.cwd();
-        return runTypeScriptCompilation(cwd);
-    },
-};

package/dist/processors/implementations/version-compliance-processor.d.ts

@@ -1,80 +0,0 @@
-/**
- * Version Compliance Processor
- *
- * Pre-processor that enforces version compliance rules before allowing
- * commits or publishes. Integrates with 0xRay's processor pipeline.
- *
- * Rules Enforced:
- * 1. package.json version is the SSOT (semver)
- * 2. Mill SSOT is package.json via scripts/foundry/reconcile-version.mjs
- * 3. Do not bump or publish from this processor (foundry mill ships)
- *
- * @processor_type pre
- * @priority 25 (high - runs early, after preValidate, before errorBoundary)
- * @blocking true (blocks on violations)
- *
- * @framework 0xRay 1.3.5
- */
-export interface VersionComplianceResult {
-    compliant: boolean;
-    npmVersion: string;
-    uvmVersion: string;
-    pkgVersion: string;
-    errors: string[];
-    warnings: string[];
-    fixes?: VersionFix[];
-}
-export interface VersionFix {
-    type: "update-uvm" | "sync-source" | "update-readme";
-    description: string;
-    command: string;
-    autoFixable: boolean;
-}
-export declare class VersionComplianceProcessor {
-    private projectRoot;
-    private errors;
-    private warnings;
-    private fixes;
-    constructor(projectRoot?: string);
-    /**
-     * Main execution method - called by ProcessorManager
-     */
-    execute(context: {
-        tool: string;
-        args?: {
-            filePath?: string;
-            content?: string;
-        };
-        operation: string;
-    }): Promise<{
-        success: boolean;
-        blocked: boolean;
-        message: string;
-        result?: VersionComplianceResult;
-    }>;
-    /**
-     * Validate all version compliance rules
-     */
-    validateVersionCompliance(): Promise<VersionComplianceResult>;
-    /**
-     * Get NPM published version
-     */
-    private getNpmVersion;
-    /**
-     * Get package.json version
-     */
-    private getPackageVersion;
-    /**
-     * Auto-fix version compliance issues
-     */
-    autoFix(): Promise<{
-        success: boolean;
-        fixed: string[];
-        failed: string[];
-    }>;
-    /**
-     * Generate compliance report
-     */
-    generateReport(result: VersionComplianceResult): string;
-}
-export declare const versionComplianceProcessor: VersionComplianceProcessor;

package/dist/processors/implementations/version-compliance-processor.js

@@ -1,222 +0,0 @@
-/**
- * Version Compliance Processor
- *
- * Pre-processor that enforces version compliance rules before allowing
- * commits or publishes. Integrates with 0xRay's processor pipeline.
- *
- * Rules Enforced:
- * 1. package.json version is the SSOT (semver)
- * 2. Mill SSOT is package.json via scripts/foundry/reconcile-version.mjs
- * 3. Do not bump or publish from this processor (foundry mill ships)
- *
- * @processor_type pre
- * @priority 25 (high - runs early, after preValidate, before errorBoundary)
- * @blocking true (blocks on violations)
- *
- * @framework 0xRay 1.3.5
- */
-import * as fs from "fs";
-import * as path from "path";
-import { exec as execSync } from "child_process";
-import { promisify } from "util";
-import { frameworkLogger } from "../../core/framework-logger.js";
-const exec = promisify(execSync);
-export class VersionComplianceProcessor {
-    projectRoot;
-    errors = [];
-    warnings = [];
-    fixes = [];
-    constructor(projectRoot = process.cwd()) {
-        this.projectRoot = projectRoot;
-    }
-    /**
-     * Main execution method - called by ProcessorManager
-     */
-    async execute(context) {
-        try {
-            // Only validate on relevant operations
-            const relevantOperations = [
-                "write",
-                "edit",
-                "multiedit",
-                "version",
-                "publish",
-            ];
-            if (!relevantOperations.includes(context.tool) &&
-                !context.operation.includes("version")) {
-                return {
-                    success: true,
-                    blocked: false,
-                    message: "Version compliance skipped (not a version-related operation)",
-                };
-            }
-            const result = await this.validateVersionCompliance();
-            if (!result.compliant) {
-                await frameworkLogger.log("version-compliance-processor", "-version-compliance-failed-", "error", {
-                    errors: result.errors,
-                    warnings: result.warnings,
-                    npmVersion: result.npmVersion,
-                    uvmVersion: result.uvmVersion,
-                    pkgVersion: result.pkgVersion,
-                });
-                return {
-                    success: false,
-                    blocked: true,
-                    message: `Version compliance failed: ${result.errors.join(", ")}`,
-                    result,
-                };
-            }
-            // Log success
-            await frameworkLogger.log("version-compliance-processor", "-version-compliance-passed-", "info", {
-                npmVersion: result.npmVersion,
-                uvmVersion: result.uvmVersion,
-                pkgVersion: result.pkgVersion,
-                warnings: result.warnings,
-            });
-            return {
-                success: true,
-                blocked: false,
-                message: result.warnings.length > 0
-                    ? `Version compliance passed with ${result.warnings.length} warnings`
-                    : "Version compliance passed",
-                result,
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            await frameworkLogger.log("version-compliance-processor", "-validation-error-", "error", { message: errorMessage });
-            return {
-                success: false,
-                blocked: true,
-                message: `Version compliance error: ${errorMessage}`,
-            };
-        }
-    }
-    /**
-     * Validate all version compliance rules
-     */
-    async validateVersionCompliance() {
-        this.errors = [];
-        this.warnings = [];
-        this.fixes = [];
-        const npmVersion = await this.getNpmVersion();
-        const pkgVersion = this.getPackageVersion();
-        const uvmVersion = "FROZEN";
-        if (!/^\d+\.\d+\.\d+/.test(pkgVersion)) {
-            this.errors.push(`package.json version is not semver (${pkgVersion})`);
-        }
-        this.warnings.push("SSOT is package.json via scripts/foundry/reconcile-version.mjs");
-        return {
-            compliant: this.errors.length === 0,
-            npmVersion,
-            uvmVersion,
-            pkgVersion,
-            errors: this.errors,
-            warnings: this.warnings,
-            fixes: this.fixes,
-        };
-    }
-    /**
-     * Get NPM published version
-     */
-    async getNpmVersion() {
-        try {
-            const { stdout } = await exec('npm view 0xray@latest version 2>/dev/null || echo "NOT_PUBLISHED"', {
-                cwd: this.projectRoot,
-                timeout: 10000,
-            });
-            return stdout?.trim() || "NOT_PUBLISHED";
-        }
-        catch {
-            return "NOT_PUBLISHED";
-        }
-    }
-    /**
-     * Get package.json version
-     */
-    getPackageVersion() {
-        try {
-            const pkgPath = path.join(this.projectRoot, "package.json");
-            if (!fs.existsSync(pkgPath)) {
-                return "NOT_FOUND";
-            }
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-            return pkg?.version || "NOT_FOUND";
-        }
-        catch {
-            return "ERROR";
-        }
-    }
-    /**
-     * Auto-fix version compliance issues
-     */
-    async autoFix() {
-        const result = await this.validateVersionCompliance();
-        const fixed = [];
-        const failed = [];
-        for (const fix of result.fixes || []) {
-            if (fix.autoFixable) {
-                try {
-                    const { stdout, stderr } = await exec(fix.command, {
-                        cwd: this.projectRoot,
-                        timeout: 30000,
-                    });
-                    if (stderr) {
-                        failed.push(`${fix.type}: ${stderr}`);
-                    }
-                    else {
-                        fixed.push(fix.type);
-                    }
-                }
-                catch (error) {
-                    failed.push(`${fix.type}: ${error instanceof Error ? error.message : String(error)}`);
-                }
-            }
-            else {
-                failed.push(`${fix.type}: Manual fix required`);
-            }
-        }
-        return {
-            success: failed.length === 0,
-            fixed,
-            failed,
-        };
-    }
-    /**
-     * Generate compliance report
-     */
-    generateReport(result) {
-        const lines = [
-            "🔍 Version Compliance Report",
-            "============================",
-            "",
-            `NPM Published: ${result.npmVersion}`,
-            `UVM: ${result.uvmVersion}`,
-            `package.json: ${result.pkgVersion}`,
-            "",
-            result.compliant ? "✅ COMPLIANT" : "❌ NON-COMPLIANT",
-            "",
-        ];
-        if (result.errors.length > 0) {
-            lines.push("Errors:");
-            result.errors.forEach((e) => lines.push(`  ❌ ${e}`));
-            lines.push("");
-        }
-        if (result.warnings.length > 0) {
-            lines.push("Warnings:");
-            result.warnings.forEach((w) => lines.push(`  ⚠️  ${w}`));
-            lines.push("");
-        }
-        if (result.fixes && result.fixes.length > 0) {
-            lines.push("Suggested Fixes:");
-            result.fixes.forEach((f) => {
-                lines.push(`  🔧 ${f.description}`);
-                lines.push(`     Command: ${f.command}`);
-                lines.push(`     Auto-fixable: ${f.autoFixable ? "Yes" : "No"}`);
-            });
-        }
-        return lines.join("\n");
-    }
-}
-// Export singleton for processor registration
-export const versionComplianceProcessor = new VersionComplianceProcessor();

package/dist/processors/processor-interfaces.d.ts

@@ -1,126 +0,0 @@
-/**
- * Processor Interface and Base Classes
- *
- * Defines the contract for all processors in the 0xRay framework.
- * Replaces the switch statement anti-pattern in ProcessorManager with
- * polymorphic processor classes.
- *
- * @module processors/interfaces
- */
-import { ProcessorContext, ProcessorResult, LogProtectionProcessorResult, TestExecutionResult, CodexComplianceProcessorResult, VersionComplianceProcessorResult, TestAutoCreationResult, CoverageAnalysisResult } from "./processor-types.js";
-/**
- * Union of all known processor result types for type safety
- */
-export type ProcessorResultData = LogProtectionProcessorResult | TestExecutionResult | CodexComplianceProcessorResult | VersionComplianceProcessorResult | TestAutoCreationResult | CoverageAnalysisResult;
-/**
- * Processor interface - all processors must implement this
- */
-export interface IProcessor {
-    /** Unique processor identifier */
-    readonly name: string;
-    /** Processor type: pre or post */
-    readonly type: "pre" | "post";
-    /** Execution priority (lower = earlier) */
-    readonly priority: number;
-    /** Whether processor is enabled */
-    enabled: boolean;
-    /**
-     * Execute the processor
-     * @param context Processor execution context
-     * @returns Processor result
-     */
-    execute(context: ProcessorContext): Promise<ProcessorResult>;
-}
-/**
- * Base processor class with common functionality
- */
-export type ProcessorDependency = "stateManager" | "config" | "logger";
-export interface ProcessorDependencies {
-    stateManager?: unknown;
-    config?: unknown;
-    logger?: unknown;
-}
-export declare abstract class BaseProcessor implements IProcessor {
-    abstract readonly name: string;
-    abstract readonly type: "pre" | "post";
-    abstract readonly priority: number;
-    enabled: boolean;
-    static readonly dependencies?: ProcessorDependency[];
-    /**
-     * Execute the processor with error handling and metrics
-     * @param context Processor execution context
-     * @returns Processor result
-     */
-    execute(context: ProcessorContext): Promise<ProcessorResult>;
-    /**
-     * Override this method in subclasses to implement processor logic
-     * @param context Processor execution context
-     * @returns Processor data
-     */
-    protected abstract run(context: ProcessorContext): Promise<unknown>;
-    /**
-     * Safely extract file path from context
-     */
-    protected getFilePath(context: ProcessorContext): string | undefined;
-    /**
-     * Safely extract content from context
-     */
-    protected getContent(context: ProcessorContext): string | undefined;
-}
-/**
- * Pre-processor base class
- */
-export declare abstract class PreProcessor extends BaseProcessor {
-    readonly type: "pre";
-}
-/**
- * Post-processor base class
- */
-export declare abstract class PostProcessor extends BaseProcessor {
-    readonly type: "post";
-}
-/**
- * Processor registry for managing processor instances
- */
-export declare class ProcessorRegistry {
-    private processors;
-    /**
-     * Register a processor
-     * @param processor Processor instance
-     */
-    register(processor: IProcessor): void;
-    /**
-     * Unregister a processor
-     * @param name Processor name
-     */
-    unregister(name: string): void;
-    /**
-     * Get a processor by name
-     * @param name Processor name
-     * @returns Processor instance or undefined
-     */
-    get(name: string): IProcessor | undefined;
-    /**
-     * Get all registered processors
-     * @returns Array of processors
-     */
-    getAll(): IProcessor[];
-    /**
-     * Get processors by type
-     * @param type Processor type
-     * @returns Array of processors
-     */
-    getByType(type: "pre" | "post"): IProcessor[];
-    /**
-     * Check if processor exists
-     * @param name Processor name
-     * @returns True if processor exists
-     */
-    has(name: string): boolean;
-    /**
-     * Clear all processors
-     */
-    clear(): void;
-}
-export type { ProcessorContext, ProcessorResult } from "./processor-types.js";
-export declare const processorRegistry: ProcessorRegistry;

package/dist/processors/processor-interfaces.js

@@ -1,125 +0,0 @@
-/**
- * Processor Interface and Base Classes
- *
- * Defines the contract for all processors in the 0xRay framework.
- * Replaces the switch statement anti-pattern in ProcessorManager with
- * polymorphic processor classes.
- *
- * @module processors/interfaces
- */
-export class BaseProcessor {
-    enabled = true;
-    static dependencies;
-    /**
-     * Execute the processor with error handling and metrics
-     * @param context Processor execution context
-     * @returns Processor result
-     */
-    async execute(context) {
-        const startTime = Date.now();
-        try {
-            const data = await this.run(context);
-            const duration = Date.now() - startTime;
-            return {
-                success: true,
-                data,
-                duration,
-                processorName: this.name,
-            };
-        }
-        catch (error) {
-            const duration = Date.now() - startTime;
-            return {
-                success: false,
-                error: error instanceof Error ? error.message : String(error),
-                duration,
-                processorName: this.name,
-            };
-        }
-    }
-    /**
-     * Safely extract file path from context
-     */
-    getFilePath(context) {
-        return context.toolInput?.args?.filePath || context.filePath;
-    }
-    /**
-     * Safely extract content from context
-     */
-    getContent(context) {
-        return context.toolInput?.args?.content;
-    }
-}
-/**
- * Pre-processor base class
- */
-export class PreProcessor extends BaseProcessor {
-    type = "pre";
-}
-/**
- * Post-processor base class
- */
-export class PostProcessor extends BaseProcessor {
-    type = "post";
-}
-/**
- * Processor registry for managing processor instances
- */
-export class ProcessorRegistry {
-    processors = new Map();
-    /**
-     * Register a processor
-     * @param processor Processor instance
-     */
-    register(processor) {
-        this.processors.set(processor.name, processor);
-    }
-    /**
-     * Unregister a processor
-     * @param name Processor name
-     */
-    unregister(name) {
-        this.processors.delete(name);
-    }
-    /**
-     * Get a processor by name
-     * @param name Processor name
-     * @returns Processor instance or undefined
-     */
-    get(name) {
-        return this.processors.get(name);
-    }
-    /**
-     * Get all registered processors
-     * @returns Array of processors
-     */
-    getAll() {
-        return Array.from(this.processors.values());
-    }
-    /**
-     * Get processors by type
-     * @param type Processor type
-     * @returns Array of processors
-     */
-    getByType(type) {
-        return this.getAll()
-            .filter((p) => p.type === type)
-            .sort((a, b) => a.priority - b.priority);
-    }
-    /**
-     * Check if processor exists
-     * @param name Processor name
-     * @returns True if processor exists
-     */
-    has(name) {
-        return this.processors.has(name);
-    }
-    /**
-     * Clear all processors
-     */
-    clear() {
-        this.processors.clear();
-    }
-}
-// Singleton registry instance
-export const processorRegistry = new ProcessorRegistry();