0xray 4.0.13 → 4.0.14

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

@@ -0,0 +1,189 @@
+/**
+ * Processor Types
+ *
+ * Type definitions for the processor activation system.
+ * Replaces `any` types with proper interfaces for type safety.
+ * This file is the central source of truth for shared processor types
+ * to avoid circular dependencies.
+ *
+ * @since 2026-01-07
+ */
+/**
+ * Tool argument structure passed to processors
+ */
+export interface ToolInputArgs {
+    filePath?: string;
+    content?: string;
+    operation?: string;
+    directory?: string;
+    args?: Record<string, string>;
+}
+/**
+ * Tool input containing execution details
+ */
+export interface ToolInput {
+    tool?: string;
+    args?: ToolInputArgs;
+}
+/**
+ * Processor execution context - used by processors to understand their environment
+ */
+export interface ProcessorContext {
+    /** Tool input (for pre-processors) */
+    toolInput?: ToolInput;
+    /** File path being processed */
+    filePath?: string;
+    /** Operation being performed */
+    operation?: string;
+    /** Content being processed */
+    content?: string;
+    /** Working directory */
+    directory?: string;
+    /** Tool being executed */
+    tool?: string;
+    /** Additional context - string, numeric, boolean, or object values */
+    [key: string]: ToolInput | ToolInputArgs | string | number | boolean | object | undefined;
+}
+/**
+ * Standard result returned by all processors
+ * Uses unknown for data to handle any processor-specific return type
+ */
+export interface ProcessorResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    duration: number;
+    processorName: string;
+}
+export interface PreValidateContext {
+    operation: string;
+    data?: string;
+    syntaxCheck?: boolean;
+    codexCompliance?: boolean;
+    agentName?: string;
+    filesChanged?: string[];
+    riskLevel?: "low" | "medium" | "high" | "critical";
+    tool?: string;
+    directory?: string;
+    args?: ToolInputArgs;
+    config?: Record<string, unknown>;
+}
+export interface PostValidateContext {
+    operation: string;
+    data?: string;
+    preResults: ProcessorExecutionResult[];
+    testResults?: TestResults;
+    regressionResults?: RegressionResults;
+    stateValidation?: boolean;
+    tool?: string;
+    directory?: string;
+    args?: ToolInputArgs;
+}
+export interface ProcessorHook {
+    name: string;
+    execute: (context: PreValidateContext | PostValidateContext) => Promise<ProcessorExecutionResult>;
+    priority: number;
+    enabled: boolean;
+    before?: (context: PreValidateContext | PostValidateContext) => Promise<void>;
+    after?: (result: ProcessorExecutionResult) => Promise<void>;
+    onError?: (error: Error) => Promise<void>;
+}
+export interface ProcessorRegistration {
+    name: string;
+    type: "pre" | "post";
+    hook: ProcessorHook;
+}
+export interface ProcessorExecutionResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    duration: number;
+    processorName: string;
+    data?: unknown;
+}
+export interface ProcessorHealthCheck {
+    name: string;
+    status: "healthy" | "degraded" | "failed";
+    lastRun: number;
+    successRate: number;
+    averageExecutionTime: number;
+    totalRuns: number;
+    failedRuns: number;
+}
+export interface TestResults {
+    passed: number;
+    failed: number;
+    total: number;
+    duration: number;
+}
+export interface RegressionResults {
+    issues: string[];
+    passed: boolean;
+}
+export interface VersionComplianceProcessorResult {
+    success: boolean;
+    errors: string[];
+    warnings: string[];
+    checkedAt: string;
+}
+export interface CodexComplianceProcessorResult {
+    compliant: boolean;
+    violations: string[];
+    warnings: string[];
+    termsChecked: number;
+    operation: string;
+    timestamp: string;
+    error?: boolean;
+}
+export interface ErrorBoundaryResult {
+    boundaries: string;
+}
+export interface LogProtectionProcessorResult {
+    allowed: boolean;
+    reason?: string;
+}
+export interface AgentsMdValidationProcessorResult {
+    success: boolean;
+    blocked: boolean;
+    message?: string;
+    errors: string[];
+    warnings: string[];
+    checkedAt: string;
+}
+export interface TestExecutionResult {
+    testsExecuted: number;
+    passed: number;
+    failed: number;
+    exitCode?: number;
+    output?: string;
+    success: boolean;
+    error?: string;
+}
+export interface RegressionTestingResult {
+    regressions: string;
+    issues: string[];
+}
+export interface StateValidationResult {
+    stateValid: boolean;
+}
+export interface RefactoringLoggingResult {
+    logged: boolean;
+    success: boolean;
+    message: string;
+    error?: string;
+}
+export interface TestAutoCreationResult {
+    success: boolean;
+    message?: string;
+    data?: string[];
+    error?: string;
+}
+export interface CoverageAnalysisResult {
+    success: boolean;
+    message: string;
+    coverage: number;
+}
+export interface RuleViolationEntry {
+    rule: string;
+    message: string;
+}

package/dist/processors/processor-types.js

@@ -0,0 +1,11 @@
+/**
+ * Processor Types
+ *
+ * Type definitions for the processor activation system.
+ * Replaces `any` types with proper interfaces for type safety.
+ * This file is the central source of truth for shared processor types
+ * to avoid circular dependencies.
+ *
+ * @since 2026-01-07
+ */
+export {};

package/dist/public/XrayService.d.ts

@@ -0,0 +1,17 @@
+import type { BeforeHookResult, AfterHookResult } from "../integrations/enforcement-gate.js";
+export interface XrayServiceConfig {
+    enabled?: boolean;
+    strictMode?: boolean;
+    logLevel?: string;
+}
+export declare class XrayService {
+    private config;
+    private initialized;
+    constructor(config?: XrayServiceConfig);
+    init(): Promise<void>;
+    beforeTool(tool: string, args: Record<string, unknown> | null, context?: {
+        directory?: string;
+    }): Promise<BeforeHookResult>;
+    afterTool(tool: string, args: Record<string, unknown> | null, result: unknown, error?: string | null): Promise<AfterHookResult>;
+    shutdown(): void;
+}

package/dist/public/XrayService.js

@@ -0,0 +1,40 @@
+import { frameworkLogger } from "../core/framework-logger.js";
+import { beforeToolHook, afterToolHook } from "../integrations/enforcement-gate.js";
+const defaultConfig = {
+    enabled: true,
+    strictMode: false,
+    logLevel: "info",
+};
+export class XrayService {
+    config;
+    initialized = false;
+    constructor(config) {
+        this.config = { ...defaultConfig, ...config };
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        await frameworkLogger.log("XrayService", "init", "info", {
+            message: "XrayService initialized",
+            config: this.config,
+        });
+        this.initialized = true;
+    }
+    async beforeTool(tool, args, context) {
+        if (!this.config.enabled) {
+            return { allowed: true, blocked: false, violations: [], resonance: 1, duration: 0 };
+        }
+        const gateCtx = context ? { ...(context.directory ? { directory: context.directory } : {}) } : undefined;
+        return beforeToolHook(tool, args, gateCtx);
+    }
+    async afterTool(tool, args, result, error = null) {
+        if (!this.config.enabled) {
+            return { processed: false, violations: [], processorResults: [], governanceTriggered: false, duration: 0 };
+        }
+        return afterToolHook(tool, args, result, error);
+    }
+    shutdown() {
+        this.initialized = false;
+        frameworkLogger.log("XrayService", "shutdown", "info", { message: "XrayService shut down" });
+    }
+}

package/dist/public/about.html

@@ -0,0 +1,228 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>About 0xRay - Enterprise AI Orchestration</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      line-height: 1.6;
+      color: #e0e0e0;
+      background: linear-gradient(135deg, #0d1117 0%, #161b22 50%, #0d1117 100%);
+      min-height: 100vh;
+    }
+    .container { max-width: 1100px; margin: 0 auto; padding: 40px 20px; }
+    header {
+      text-align: center;
+      padding: 40px 0;
+      border-bottom: 1px solid #30363d;
+    }
+    h1 {
+      font-size: 3rem;
+      color: #58a6ff;
+      margin-bottom: 8px;
+    }
+    .version {
+      display: inline-block;
+      background: #238636;
+      color: white;
+      padding: 4px 12px;
+      border-radius: 12px;
+      font-size: 0.9rem;
+      font-weight: 600;
+    }
+    .tagline {
+      font-size: 1.3rem;
+      color: #8b949e;
+      margin-top: 15px;
+    }
+    .section {
+      margin: 50px 0;
+      padding: 30px;
+      background: rgba(22, 27, 34, 0.8);
+      border-radius: 12px;
+      border: 1px solid #30363d;
+    }
+    .section h2 {
+      color: #58a6ff;
+      margin-bottom: 20px;
+      font-size: 1.8rem;
+    }
+    .grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+      gap: 20px;
+      margin-top: 25px;
+    }
+    .card {
+      background: rgba(13, 17, 23, 0.6);
+      border: 1px solid #30363d;
+      border-radius: 8px;
+      padding: 20px;
+      transition: border-color 0.2s;
+    }
+    .card:hover { border-color: #58a6ff; }
+    .card h3 {
+      color: #7ee787;
+      font-size: 1.1rem;
+      margin-bottom: 10px;
+    }
+    .card p { color: #8b949e; font-size: 0.95rem; }
+    .stats {
+      display: flex;
+      justify-content: center;
+      gap: 50px;
+      margin: 40px 0;
+      flex-wrap: wrap;
+    }
+    .stat { text-align: center; }
+    .stat-num {
+      font-size: 2.5rem;
+      font-weight: 700;
+      color: #58a6ff;
+    }
+    .stat-label { color: #8b949e; font-size: 0.9rem; }
+    .pipeline-diagram {
+      background: #0d1117;
+      border-radius: 8px;
+      padding: 25px;
+      font-family: 'Monaco', 'Menlo', monospace;
+      font-size: 0.85rem;
+      overflow-x: auto;
+    }
+    .pipeline-diagram .arrow { color: #7ee787; }
+    .pipeline-diagram .name { color: #ffa657; }
+    code {
+      background: rgba(110, 118, 129, 0.3);
+      padding: 2px 6px;
+      border-radius: 4px;
+      font-size: 0.9em;
+    }
+    footer {
+      text-align: center;
+      padding: 30px;
+      border-top: 1px solid #30363d;
+      color: #6e7681;
+      font-size: 0.9rem;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <span class="version">v1.4.20</span>
+      <h1>0xRay</h1>
+      <p class="tagline">Enterprise AI Orchestration Framework</p>
+    </header>
+
+    <div class="stats">
+      <div class="stat">
+        <div class="stat-num">9</div>
+        <div class="stat-label">Specialized Agents</div>
+      </div>
+      <div class="stat">
+        <div class="stat-num">28</div>
+        <div class="stat-label">MCP Servers</div>
+      </div>
+      <div class="stat">
+        <div class="stat-num">8</div>
+        <div class="stat-label">Pipelines</div>
+      </div>
+      <div class="stat">
+        <div class="stat-num">59</div>
+        <div class="stat-label">Codex Terms</div>
+      </div>
+      <div class="stat">
+        <div class="stat-num">99.6%</div>
+        <div class="stat-label">Error Prevention</div>
+      </div>
+    </div>
+
+    <section class="section">
+      <h2>🎯 What is 0xRay?</h2>
+      <p>0xRay is an enterprise-grade AI orchestration framework that provides intelligent task routing, systematic error prevention, and comprehensive monitoring for AI-driven development workflows.</p>
+    </section>
+
+    <section class="section">
+      <h2>🧠 Intelligent Agents</h2>
+      <div class="grid">
+        <div class="card">
+          <h3>🛡️ Enforcer</h3>
+          <p>Codex compliance & error prevention. Central coordinator for all rule enforcement.</p>
+        </div>
+        <div class="card">
+          <h3>🏗️ Architect</h3>
+          <p>System design & technical decisions. High-complexity task specialist.</p>
+        </div>
+        <div class="card">
+          <h3>🎭 Orchestrator</h3>
+          <p>Multi-agent workflow coordination. Enterprise-level task orchestration.</p>
+        </div>
+        <div class="card">
+          <h3>🔍 Bug Triage</h3>
+          <p>Error investigation & fixes. Debug operations specialist.</p>
+        </div>
+        <div class="card">
+          <h3>📝 Code Reviewer</h3>
+          <p>Quality assessment & standards. All code changes reviewed.</p>
+        </div>
+        <div class="card">
+          <h3>🔒 Security Auditor</h3>
+          <p>Vulnerability detection. Security operations specialist.</p>
+        </div>
+        <div class="card">
+          <h3>♻️ Refactorer</h3>
+          <p>Technical debt elimination. Refactoring operations specialist.</p>
+        </div>
+        <div class="card">
+          <h3>🧪 Test Architect</h3>
+          <p>Testing strategy & coverage. Test operations specialist.</p>
+        </div>
+        <div class="card">
+          <h3>📚 Librarian</h3>
+          <p>Codebase exploration & documentation. Analysis operations.</p>
+        </div>
+      </div>
+    </section>
+
+    <section class="section">
+      <h2>🔄 8 Pipeline System</h2>
+      <div class="pipeline-diagram">
+┌─────────────────────────────────────────────────────────────────┐
+│                    0xRAY FRAMEWORK v3.0.0                      │
+├─────────────────────────────────────────────────────────────────┤
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────┐ │
+│  │    INIT     │─▶│  AGENT      │─▶│   RULE      │─▶│  POST   │ │
+│  │ FRAMEWORK   │  │ DELEGATION  │  │ ENFORCEMENT │  │ PROCESS │ │
+│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────┘ │
+│         │              │              │              │           │
+│         ▼              ▼              ▼              ▼           │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────┐ │
+│  │  SECURITY   │◀▶│    MCP      │◀▶│   PLUGIN    │◀▶│ TESTING │ │
+│  │ MONITORING  │  │   SERVERS   │  │   SYSTEM    │  │ VALIDATE│ │
+│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────┘ │
+└─────────────────────────────────────────────────────────────────┘
+      </div>
+    </section>
+
+    <section class="section">
+      <h2>📊 Complexity Analysis</h2>
+      <p>Tasks are automatically scored 0-100 based on:</p>
+      <div class="grid">
+        <div class="card"><h3>File Count</h3><p>0-20 points based on affected files</p></div>
+        <div class="card"><h3>Change Volume</h3><p>0-25 points for lines changed</p></div>
+        <div class="card"><h3>Dependencies</h3><p>0-15 points for component relationships</p></div>
+        <div class="card"><h3>Risk Level</h3><p>Multipliers: low (0.8x) to critical (1.6x)</p></div>
+      </div>
+      <p style="margin-top: 20px;"><strong>Routing:</strong> <code>≤25</code> single-agent | <code>26-95</code> multi-agent | <code>>95</code> orchestrator-led</p>
+    </section>
+
+    <footer>
+      <p>0xRay Framework &copy; 2026 | Built for Enterprise AI Orchestration</p>
+      <p style="margin-top: 10px; color: #6e7681;">338 logging points | 51 core files | JobId tracking enabled</p>
+    </footer>
+  </div>
+</body>
+</html>

package/dist/public/enterprise.html

@@ -0,0 +1,27 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Enterprise - 0xRay</title>
+  <style>
+    body { margin: 0; padding: 0; background: #0a0a0f; color: #e0e0e0; font-family: system-ui, sans-serif; }
+    .container { max-width: 900px; margin: 0 auto; padding: 40px 20px; }
+    h1 { color: #6366f1; font-size: 2.5rem; }
+    .feature { background: #1a1a2e; padding: 20px; margin: 15px 0; border-radius: 8px; border-left: 4px solid #6366f1; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>Enterprise Solutions</h1>
+    <div class="feature">
+      <h2>Multi-Agent Orchestration</h2>
+      <p>Scale your AI workflows with intelligent agent coordination.</p>
+    </div>
+    <div class="feature">
+      <h2>Security & Compliance</h2>
+      <p>Enterprise-grade security with comprehensive audit trails.</p>
+    </div>
+  </div>
+</body>
+</html>

package/dist/public/features.html

@@ -0,0 +1,102 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>0xRay - Features</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      background: linear-gradient(135deg, #0f172a 0%, #1e293b 100%);
+      color: #e2e8f0;
+      min-height: 100vh;
+    }
+    .container { max-width: 1000px; margin: 0 auto; padding: 60px 20px; }
+    header { text-align: center; margin-bottom: 60px; }
+    h1 {
+      font-size: 3rem;
+      background: linear-gradient(135deg, #3b82f6, #8b5cf6);
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      margin-bottom: 10px;
+    }
+    .subtitle { color: #94a3b8; font-size: 1.2rem; }
+    .features {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+      gap: 24px;
+    }
+    .feature {
+      background: rgba(30, 41, 59, 0.8);
+      border: 1px solid rgba(148, 163, 184, 0.1);
+      border-radius: 12px;
+      padding: 28px;
+      transition: transform 0.2s, box-shadow 0.2s;
+    }
+    .feature:hover {
+      transform: translateY(-4px);
+      box-shadow: 0 20px 40px rgba(0, 0, 0, 0.3);
+    }
+    .feature-icon {
+      font-size: 2rem;
+      margin-bottom: 16px;
+    }
+    .feature h2 {
+      color: #60a5fa;
+      font-size: 1.3rem;
+      margin-bottom: 12px;
+    }
+    .feature p {
+      color: #94a3b8;
+      line-height: 1.6;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>0xRay Features</h1>
+      <p class="subtitle">Enterprise AI Orchestration Platform</p>
+    </header>
+    
+    <div class="features">
+      <div class="feature">
+        <div class="feature-icon">🤖</div>
+        <h2>9 AI Agents</h2>
+        <p>Specialized agents for every task: Enforcer, Architect, Orchestrator, Bug Triage, Code Reviewer, Security Auditor, Refactorer, Test Architect, and Librarian.</p>
+      </div>
+      
+      <div class="feature">
+        <div class="feature-icon">⚡</div>
+        <h2>Complexity Analysis</h2>
+        <p>Automatic task complexity scoring from 0-100. Routes tasks intelligently: single-agent for simple, multi-agent for complex, orchestrator-led for enterprise.</p>
+      </div>
+      
+      <div class="feature">
+        <div class="feature-icon">🛡️</div>
+        <h2>99.6% Error Prevention</h2>
+        <p>Universal Development Codex with 59 mandatory terms. Systematic validation at every pipeline stage.</p>
+      </div>
+      
+      <div class="feature">
+        <div class="feature-icon">📊</div>
+        <h2>Full Observability</h2>
+        <p>338 logging points across 51 files. JobId correlation, activity reports, and real-time monitoring.</p>
+      </div>
+      
+      <div class="feature">
+        <div class="feature-icon">🔌</div>
+        <h2>28 MCP Servers</h2>
+        <p>Knowledge skills, utilities, and framework servers. Code review, security audit, testing strategy, and more.</p>
+      </div>
+      
+      <div class="feature">
+        <div class="feature-icon">🔄</div>
+        <h2>8 Pipelines</h2>
+        <p>Framework Init, Agent Delegation, Rule Enforcement, Post-Processing, Security, MCP Servers, Plugins, and Testing.</p>
+      </div>
+    </div>
+  </div>
+</body>
+</html>

package/dist/public/index.d.ts

@@ -0,0 +1,4 @@
+export { XrayService } from "./XrayService.js";
+export type { XrayServiceConfig } from "./XrayService.js";
+export { beforeToolHook, afterToolHook } from "../integrations/enforcement-gate.js";
+export type { BeforeHookResult, AfterHookResult, GateViolation } from "../integrations/enforcement-gate.js";