0xray 3.1.1 → 3.3.0

package/dist/postprocessor/redeploy/RetryHandler.js

@@ -0,0 +1,118 @@
+/**
+ * Retry Handler for Redeploy Operations
+ */
+import { frameworkLogger } from "../../core/framework-logger.js";
+export class RetryHandler {
+    config;
+    constructor(config = {
+        maxRetries: 3,
+        baseDelay: 30000,
+        backoffStrategy: "exponential",
+    }) {
+        this.config = config;
+    }
+    /**
+     * Execute an operation with retry logic
+     */
+    async executeWithRetry(operation, shouldRetry) {
+        let lastError = {};
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                const retryable = error;
+                lastError = retryable;
+                // Don't retry on the last attempt
+                if (attempt === this.config.maxRetries) {
+                    break;
+                }
+                // Check if we should retry this error
+                if (shouldRetry && !shouldRetry(retryable, attempt)) {
+                    break;
+                }
+                // Calculate delay and wait
+                const delay = this.calculateDelay(attempt);
+                await frameworkLogger.log("-retry-handler", "-operation-failed-attempt-attempt-1-retrying-in-de", "error", {
+                    message: `⏳ Operation failed (attempt ${attempt + 1}), retrying in ${delay}ms...`,
+                });
+                await this.wait(delay);
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Calculate delay based on backoff strategy
+     */
+    calculateDelay(attempt) {
+        const { baseDelay, backoffStrategy } = this.config;
+        switch (backoffStrategy) {
+            case "exponential":
+                return baseDelay * Math.pow(2, attempt);
+            case "linear":
+                return baseDelay * (attempt + 1);
+            default:
+                return baseDelay;
+        }
+    }
+    /**
+     * Wait for the specified duration
+     */
+    async wait(duration) {
+        return new Promise((resolve) => setTimeout(resolve, duration));
+    }
+    /**
+     * Default retry conditions for deployment operations
+     */
+    static shouldRetryDeployment(error, attempt) {
+        // Don't retry certain types of errors
+        const nonRetryableErrors = [
+            "authentication_failed",
+            "authorization_failed",
+            "invalid_configuration",
+            "quota_exceeded",
+        ];
+        if (nonRetryableErrors.some((type) => error.type?.includes(type))) {
+            return false;
+        }
+        // Don't retry after too many attempts for transient errors
+        if (attempt >= 2 && error.type === "transient") {
+            return false;
+        }
+        // Retry network and timeout errors
+        if (error.code === "ECONNRESET" ||
+            error.code === "ETIMEDOUT" ||
+            error.code === "ENOTFOUND") {
+            return true;
+        }
+        // Retry 5xx HTTP errors
+        if (error.statusCode >= 500 && error.statusCode < 600) {
+            return true;
+        }
+        // Default: retry for most errors
+        return true;
+    }
+    /**
+     * Specialized retry handler for deployment operations
+     */
+    async executeDeploymentWithRetry(deploymentOperation) {
+        return this.executeWithRetry(deploymentOperation, RetryHandler.shouldRetryDeployment);
+    }
+    /**
+     * Specialized retry handler for API calls
+     */
+    async executeApiCallWithRetry(apiCall) {
+        return this.executeWithRetry(apiCall, (error, attempt) => {
+            // Retry on network errors and 5xx status codes
+            return (error.code === "ECONNRESET" ||
+                error.code === "ETIMEDOUT" ||
+                (error.statusCode >= 500 && error.statusCode < 600));
+        });
+    }
+    /**
+     * Get retry statistics
+     */
+    getStats() {
+        return { ...this.config };
+    }
+}

package/dist/postprocessor/services/RegressionAnalysisService.js

@@ -5,7 +5,6 @@
  * AI code removal attempts, and other critical issues.
  * Triggers multi-agent conferences when analysis is required.
  *
- * @version 1.0.0
  * @since 2026-03-08
  */
 import { getKernel } from '../../core/kernel-patterns.js';

package/dist/postprocessor/triggers/APITrigger.js

@@ -5,7 +5,6 @@
  * operations. Useful for CI/CD pipelines, manual test triggers,
  * and retry mechanisms.
  *
- * @version 2.0.0
  * @since 2026-03-08
  */
 import express from 'express';

package/dist/postprocessor/triggers/WebhookTrigger.js

@@ -5,7 +5,6 @@
  * services (GitHub, GitLab, Bitbucket, Stripe) and routes them
  * to the PostProcessor for execution.
  *
- * @version 2.0.0
  * @since 2026-03-08
  */
 import express from 'express';

package/dist/processors/implementations/agents-md-validation-processor.js

@@ -8,7 +8,6 @@
  * @priority 90 (high - runs early)
  * @blocking true (blocks commit if AGENTS.md is invalid)
  *
- * @version 1.0.0
  * @framework 0xRay 1.3.5
  */
 import * as fs from "fs";

package/dist/processors/implementations/async-pattern-processor.js

@@ -5,7 +5,6 @@
  * Detects anti-patterns in async code: callback patterns, long promise chains,
  * missing await inside async functions, and mixed callback/promise styles.
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/console-log-guard-processor.js

@@ -5,7 +5,6 @@
  * Scans code for forbidden console.log/warn/error/info/debug usage,
  * ensuring all logging goes through frameworkLogger instead.
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/coverage-analysis-processor.js

@@ -4,7 +4,6 @@
  * Analyzes test coverage for modified files and reports coverage gaps.
  *
  * @module processors/implementations
- * @version 1.0.0
  */
 import { PostProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/inference-improvement-processor.js

@@ -12,6 +12,7 @@ import * as path from "path";
 import { PostProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";
 import { getConfigDir } from "../../core/config-paths.js";
+import { featuresConfigLoader } from "../../core/features-config.js";
 export class InferenceImprovementProcessor extends PostProcessor {
     name = "inferenceImprovement";
     priority = 5;
@@ -37,15 +38,7 @@ export class InferenceImprovementProcessor extends PostProcessor {
     }
     loadInferenceConfig() {
         try {
-            const configPaths = [
-                path.join(process.cwd(), ".xray", "features.json"),
-            ];
-            for (const configPath of configPaths) {
-                if (fs.existsSync(configPath)) {
-                    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-                    return config.inference || config;
-                }
-            }
+            return featuresConfigLoader.loadConfig().inference ?? null;
         }
         catch (e) {
             // ignore - use defaults

package/dist/processors/implementations/log-protection-processor.js

@@ -14,7 +14,6 @@
  * - Copy operations to create new archive files
  *
  * @module processors/implementations
- * @version 1.1.0
  */
 import { PreProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/nudge-processor.js

@@ -5,7 +5,6 @@
  * when stuck patterns are detected.
  *
  * @module processors/implementations
- * @version 1.0.0
  */
 import { PostProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/performance-budget-processor.js

@@ -5,7 +5,6 @@
  * Checks code content against configurable size, function-length, nesting-depth,
  * and parameter-count budgets. Returns structured violation lists.
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/postprocessor-chain-validator.js

@@ -5,7 +5,6 @@
  * Checks that all registered postprocessors executed without errors,
  * validates priority ordering, and detects skipped or crashed processors.
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/publish-preflight-processor.js

@@ -11,13 +11,13 @@
  * @priority 10 (runs early after post-processing starts)
  * @blocking true (blocks publish on violations)
  *
- * @version 1.0.0
  * @framework 0xRay 1.15.41
  */
 import * as fs from "fs";
 import * as path from "path";
 import { PostProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";
+import { featuresConfigLoader } from "../../core/features-config.js";
 export class PublishPreflightProcessor extends PostProcessor {
     name = "publishPreflight";
     priority = 10;
@@ -44,17 +44,9 @@ export class PublishPreflightProcessor extends PostProcessor {
     }
     loadConfig() {
         try {
-            const configPaths = [
-                path.join(process.cwd(), ".xray", "features.json"),
-            ];
-            for (const configPath of configPaths) {
-                if (fs.existsSync(configPath)) {
-                    const configData = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-                    if (configData.publish) {
-                        this.config = { ...this.config, ...configData.publish };
-                    }
-                    break;
-                }
+            const publishConfig = featuresConfigLoader.loadConfig().publish;
+            if (publishConfig) {
+                this.config = { ...this.config, ...publishConfig };
             }
         }
         catch (e) {

package/dist/processors/implementations/session-summary-processor.js

@@ -4,13 +4,11 @@
  * Generates emoji-formatted session summaries after tool execution.
  * Uses features.json -> auto_reporting config for control.
  *
- * @version 1.0.0
  * @since 2026-04-04
  */
 import { PostProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";
-import * as path from "path";
-import * as fs from "fs";
+import { featuresConfigLoader } from "../../core/features-config.js";
 export class SessionSummaryProcessor extends PostProcessor {
     name = "sessionSummary";
     priority = 15;
@@ -30,19 +28,13 @@ export class SessionSummaryProcessor extends PostProcessor {
     }
     loadConfig() {
         try {
-            const featuresPath = path.join(process.cwd(), ".xray", "features.json");
-            const altPath = path.join(process.cwd(), ".opencode", "xray", "features.json");
-            const configPath = fs.existsSync(featuresPath) ? featuresPath :
-                fs.existsSync(altPath) ? altPath : null;
-            if (configPath) {
-                const configData = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-                const autoReporting = configData.auto_reporting;
-                if (autoReporting) {
-                    this.config.enabled = autoReporting.mode !== "off";
-                    this.config.include_emojis = autoReporting.display?.indicators?.emojis !== false;
-                    this.config.include_recommendations = autoReporting.report_types?.session_summary?.include_recommendations !== false;
-                    this.config.include_agent_activities = autoReporting.report_types?.session_summary?.include_agent_activities !== false;
-                }
+            const configData = featuresConfigLoader.loadConfig();
+            const autoReporting = configData.auto_reporting;
+            if (autoReporting) {
+                this.config.enabled = autoReporting.mode !== "off";
+                this.config.include_emojis = autoReporting.display?.indicators?.emojis !== false;
+                this.config.include_recommendations = autoReporting.report_types?.session_summary?.include_recommendations !== false;
+                this.config.include_agent_activities = autoReporting.report_types?.session_summary?.include_agent_activities !== false;
             }
         }
         catch (error) {

package/dist/processors/implementations/spawn-governance-processor.js

@@ -9,7 +9,6 @@
  *  - #56 Infinite Spawn Pattern Detection
  *  - #57 Spawn Rate Limiting
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 import { frameworkLogger } from "../../core/framework-logger.js";

package/dist/processors/implementations/storytelling-trigger-processor.js

@@ -3,6 +3,7 @@ import * as path from "path";
 import { execSync } from "child_process";
 import { PostProcessor } from "../processor-interfaces.js";
 import { frameworkLogger } from "../../core/framework-logger.js";
+import { featuresConfigLoader } from "../../core/features-config.js";
 import { analyzeStructuralPatterns, } from "../../inference/semantic-patterns.js";
 import { captureSessionInference, saveSessionInference, } from "../../inference/session-capture.js";
 export class StorytellingTriggerProcessor extends PostProcessor {
@@ -13,34 +14,8 @@ export class StorytellingTriggerProcessor extends PostProcessor {
     deepReflectionsDir = "docs/reflections/deep";
     constructor() {
         super();
-        this.loadConfig();
-    }
-    loadConfig() {
-        try {
-            const configPath = this.resolveConfigPath("features.json");
-            if (configPath && fs.existsSync(configPath)) {
-                const content = fs.readFileSync(configPath, "utf-8");
-                const parsed = JSON.parse(content);
-                if (parsed.storytelling) {
-                    this.config = parsed.storytelling;
-                }
-            }
-        }
-        catch (error) {
-            frameworkLogger.log("storytelling-trigger", "config-load-failed", "warning", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    }
-    resolveConfigPath(filename) {
-        const candidates = [
-            path.join(process.cwd(), ".xray", filename),
-        ];
-        for (const candidate of candidates) {
-            if (fs.existsSync(candidate))
-                return candidate;
-        }
-        return null;
+        const features = featuresConfigLoader.loadConfig();
+        this.config = features.storytelling ?? null;
     }
     async run(context) {
         if (!this.config?.enabled) {

package/dist/processors/implementations/test-auto-creation-processor.js

@@ -5,7 +5,6 @@
  * Supports multiple languages: TypeScript, JavaScript, Python, Go, Rust, Java, C#
  * Uses direct skill calls (no MCP overhead) for instant test generation.
  *
- * @version 1.1.0
  * @since 2026-02-15
  */
 import * as fs from "fs";

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

@@ -5,7 +5,6 @@
  * Parses TypeScript error lines from stderr and returns structured results.
  * Gracefully skips when no tsconfig.json exists.
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 import { execSync } from "child_process";

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

@@ -14,7 +14,6 @@
  * @priority 25 (high - runs early, after preValidate, before errorBoundary)
  * @blocking true (blocks on violations)
  *
- * @version 1.0.0
  * @framework 0xRay 1.3.5
  */
 import * as fs from "fs";

package/dist/processors/processor-interfaces.js

@@ -6,7 +6,6 @@
  * polymorphic processor classes.
  *
  * @module processors/interfaces
- * @version 1.0.0
  */
 export class BaseProcessor {
     enabled = true;

package/dist/processors/processor-types.js

@@ -6,7 +6,6 @@
  * This file is the central source of truth for shared processor types
  * to avoid circular dependencies.
  *
- * @version 1.2.0
  * @since 2026-01-07
  */
 export {};

package/dist/scripts/integration.js

@@ -5,7 +5,6 @@
  * Main CLI bridge for external systems (like Jelly commercial modules) to call into 0xRay.
  * Allows spawning OpenCode CLI with 0xRay agents to execute real tasks.
  *
- * @version 1.1.0
  * @since 2026-02-14
  *
  * Usage:

package/dist/security/comprehensive-security-audit.js

@@ -5,7 +5,6 @@
  * automated remediation, compliance checking, and weighted voting
  * for architectural decisions.
  *
- * @version 1.22.13
  */
 import { readFileSync, readdirSync, statSync, writeFileSync } from "fs";
 import { join } from "path";

package/dist/security/security-agent-coordinator.js

@@ -4,7 +4,6 @@
  * Integrates the security orchestration layer with the framework's agent system.
  * Provides coordination between security agents using weighted voting.
  *
- * @version 1.22.13
  */
 import { EventEmitter } from "events";
 import { frameworkLogger } from "../core/framework-logger.js";

package/dist/security/security-auditor.js

@@ -4,7 +4,6 @@
  * Comprehensive security auditing for the framework and its components.
  * Identifies vulnerabilities, misconfigurations, and security weaknesses.
  *
- * @version 1.0.0
  * @since 2026-01-07
  */
 import { readFileSync, readdirSync, statSync } from "fs";

package/dist/security/security-hardener.js

@@ -4,7 +4,6 @@
  * Implements additional security measures and hardening for the framework.
  * Addresses vulnerabilities identified during security audit.
  *
- * @version 1.0.0
  * @since 2026-01-07
  */
 import { promises as fs } from "fs";

package/dist/security/security-hardening-system.js

@@ -4,7 +4,6 @@
  * Comprehensive security hardening implementation with OWASP compliance.
  * Implements defense-in-depth security architecture for enterprise applications.
  *
- * @version 1.0.0
  * @since 2026-01-08
  */
 import { EventEmitter } from "events";

package/dist/security/security-headers.js

@@ -4,7 +4,6 @@
  * Comprehensive security headers implementation for HTTP responses.
  * Integrates with boot orchestrator and API endpoints.
  *
- * @version 1.0.0
  * @since 2026-01-07
  */
 import { frameworkLogger } from "../core/framework-logger.js";

package/dist/security/security-orchestration-layer.js

@@ -5,7 +5,6 @@
  * automated remediation, and compliance validation using weighted voting
  * for architectural decisions.
  *
- * @version 1.22.13
  */
 import { EventEmitter } from "events";
 import { frameworkLogger } from "../core/framework-logger.js";

package/dist/services/inference-tuner.js

@@ -8,7 +8,6 @@
  * 4. Updates configuration automatically
  *
  * @module services
- * @version 1.0.0
  */
 import * as fs from "fs";
 import * as path from "path";

package/dist/session/session-cleanup-manager.js

@@ -4,7 +4,6 @@
  * Manages automatic cleanup of sessions with TTL-based expiration,
  * idle session detection, and manual cleanup utilities.
  *
- * @version 1.0.0
  * @since 2026-01-07
  */
 import { frameworkLogger } from "../core/framework-logger.js";

package/dist/session/session-monitor.js

@@ -4,7 +4,6 @@
  * Provides real-time monitoring of sessions with health checks,
  * performance tracking, and alerting capabilities.
  *
- * @version 1.0.0
  * @since 2026-01-07
  */
 import { frameworkLogger } from "../core/framework-logger.js";

package/dist/session/session-state-manager.js

@@ -4,7 +4,6 @@
  * Manages cross-session state sharing, dependency tracking,
  * and coordination for complex workflows.
  *
- * @version 1.0.0
  * @since 2026-01-07
  */
 import { frameworkLogger } from "../core/framework-logger.js";

package/dist/skills/xray-orchestrator/index.js

@@ -3,7 +3,6 @@
  *
  * OpenClaw skill that provides xray orchestration commands.
  *
- * @version 1.0.0
  * @since 2026-03-14
  */
 const API_BASE = process.env.XRAY_API_URL || 'http://localhost:18431';

package/dist/utils/codex-parser.js

@@ -4,7 +4,6 @@
  * Unified parsing utility for codex content in both JSON and Markdown formats.
  * Provides consistent parsing across all components with format detection and validation.
  *
- * @version 1.0.1
  * @since 2026-01-07
  */
 import { frameworkLogger } from "../core/framework-logger.js";

package/dist/utils/language-detector.js

@@ -4,7 +4,6 @@
  * Detects project language and test framework from project files.
  * Supports: TypeScript, JavaScript, Python, Go, Rust, Java, C++, Ruby, PHP
  *
- * @version 1.0.0
  * @since 2026-02-25
  */
 import * as fs from "fs";

package/dist/utils/shutdown-handler.js

@@ -4,7 +4,6 @@
  * Centralized shutdown handling for MCP servers.
  * Extracts common shutdown patterns to reduce code duplication.
  *
- * @version 1.0.0
  * @since 2026-03-22
  */
 import { frameworkLogger } from "../core/framework-logger.js";