0xray 3.1.0 → 3.2.0

package/dist/skills/hermes-agent/SKILL.md

@@ -43,7 +43,7 @@ Native Hermes plugin providing 0xRay framework integration — quality gates, co
 
 **Fallback:** When bridge is unavailable, tools fall back to `npx 0xray` CLI commands.
 
-**Config path resolution:** `XRAY_CONFIG_DIR/` > `.xray/` > `.opencode/xray/` > built-in defaults.
+**Config path resolution:** `XRAY_CONFIG_DIR/` > `.xray/` > built-in defaults.
 
 ## 4 Tools
 
@@ -208,5 +208,5 @@ The plugin's pre_tool_call hook nudges when an MCP alternative exists (e.g., "us
 - CLI fallback requires `npx 0xray` in PATH. If bridge fails and CLI isn't available, tools return errors.
 - Quality gate blocks are logged but NOT enforced (advisory). The tool returns violations; the agent decides what to do.
 - Git hooks use symlinks from `.git/hooks/` → `hooks/`. If the `hooks/` directory doesn't exist in the project, `xray_hooks(action="install")` skips those hooks.
-- Project root detection walks up from CWD looking for `node_modules/0xray`, `.opencode/xray/features.json`, or `package.json`. Override with `XRAY_PROJECT_ROOT` env var.
+- Project root detection walks up from CWD looking for `node_modules/0xray`, `.xray/features.json`, or `package.json`. Override with `XRAY_PROJECT_ROOT` env var.
 - `logs/framework/` is created automatically. Never breaks the agent if permissions fail.

package/dist/skills/inference-improve/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: inference-improve
 description: Autonomous inference improvement through collaborative agent analysis
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [inference, improvement, autonomous, learning]

package/dist/skills/lint/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: lint
 description: Code linting and static analysis
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [quality, lint]

package/dist/skills/log-monitor/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: log-monitor
 description: Log analysis, pattern detection, and alerting
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [monitoring, logging, alerting, observability]

package/dist/skills/model-health-check/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: model-health-check
 description: AI model health monitoring and diagnostics
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [monitoring, model, health, check]

package/dist/skills/multimodal-looker/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: multimodal-looker
 description: Visual content analysis for diagrams, screenshots, and UI mockups
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [visual, diagrams, screenshots, accessibility, ui-analysis]

package/dist/skills/orchestrator/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: orchestrator
 description: Multi-agent workflow coordination and task delegation
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [orchestration, orchestrator]

package/dist/skills/performance-analysis/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: performance-analysis
 description: System performance analysis and optimization
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [performance, performance, analysis]

package/dist/skills/performance-optimization/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: performance-optimization
 description: Application performance optimization and tuning
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [performance, performance, optimization]

package/dist/skills/processor-pipeline/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: processor-pipeline
 description: Data processing pipeline management
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [processing, processor, pipeline]

package/dist/skills/project-analysis/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: project-analysis
 description: Analyze project structure, complexity, and health metrics
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [analysis, project, complexity, health]

package/dist/skills/refactoring-strategies/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: refactoring-strategies
 description: Code refactoring techniques and strategies
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [refactoring, refactoring, strategies]

package/dist/skills/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.22.67",
+  "version": "3.1.0",
   "description": "0xRay Skills Registry - recommended skill sources for consumers",
   "sources": [
     {

package/dist/skills/researcher/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: researcher
 description: Multi-repo analysis, documentation lookup, and implementation examples
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [research, researcher]

package/dist/skills/security-audit/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: security-audit
 description: Security auditing and compliance validation
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [security, security, audit]

package/dist/skills/security-scan/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: security-scan
 description: Security vulnerability scanning and assessment
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [security, security, scan]

package/dist/skills/session-management/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: session-management
 description: Manage user sessions and persistent state
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [infrastructure, session, management]

package/dist/skills/state-manager/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: state-manager
 description: Application state management and persistence
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [infrastructure, state, manager]

package/dist/skills/storyteller/SKILL.md

@@ -96,7 +96,7 @@ codex_terms: [5, 7, 32]  # Related Codex term numbers
 ```markdown
 ## What Next?
 
-- Related Codex terms: [codex.json](../../.opencode/xray/codex.json)
+- Related Codex terms: [codex.json](../../../../.xray/codex.json)
 - Next story to write: [suggestion]
 ```
 

package/dist/skills/testing-best-practices/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: testing-best-practices
 description: Testing best practices and quality assurance
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [testing, testing, best, practices]

package/dist/skills/testing-strategy/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: testing-strategy
 description: Design comprehensive testing strategies and optimize test coverage
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [testing, strategy, coverage, quality]

package/dist/skills/ui-ux-design/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: ui-ux-design
 description: User interface and user experience design with mobile-first approach, cognitive simplicity, and accessibility-first principles
-author: StrRay Framework
+author: Xray Framework
 version: 2.1.0
 schema_version: "1.0"
 tags: [design, ui, ux, accessibility, mobile-first, visual-hierarchy, wcag, contrast, color-theory, dont-make-me-think]

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/state/index.js

@@ -5,4 +5,3 @@ export * from "./context-providers.js";
 export * from "./state-types.js";
 // Re-export commonly used state utilities
 export { XrayStateManager } from "./state-manager.js";
-export { XrayStateManager as StringRayStateManager } from "./state-manager.js";

package/dist/state/state-manager.js

@@ -204,5 +204,4 @@ export class XrayStateManager {
         return conflict.value2; // Prefer the second value as newer
     }
 }
-// Export alias for scripts expecting StrRayStateManager (backward compatibility)
-export { XrayStateManager as StringRayStateManager };
+// Export alias for scripts expecting XrayStateManager

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/import-resolver.js

@@ -77,7 +77,7 @@ export class ImportResolver {
     detectInstalled() {
         return (this.currentDir.includes("/node_modules/") ||
             this.currentDir.includes("\\node_modules\\") ||
-            (this.currentDir.includes("strray") &&
+            (this.currentDir.includes("xray") &&
                 !this.currentDir.includes(this.projectRoot)));
     }
     detectTesting() {

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/path-resolver.js

@@ -52,7 +52,7 @@ export class PathResolver {
     detectBuilt() {
         return (this.currentDir.includes("/dist/") ||
             this.currentDir.includes("\\dist\\") ||
-            (this.currentDir.includes("strray") && !this.detectDevelopment()));
+            (this.currentDir.includes("xray") && !this.detectDevelopment()));
     }
     /**
      * Detect if we're running in installed package environment
@@ -60,7 +60,7 @@ export class PathResolver {
     detectInstalled() {
         return (this.currentDir.includes("/node_modules/") ||
             this.currentDir.includes("\\node_modules\\") ||
-            (this.currentDir.includes("strray") && this.detectBuilt()));
+            (this.currentDir.includes("xray") && this.detectBuilt()));
     }
     /**
      * Resolve agent import path for current environment

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";

package/dist/validation/agent-config-validator.js

@@ -0,0 +1,280 @@
+/**
+ * Agent Configuration Validator
+ *
+ * Validates agent configuration files for correctness and completeness
+ * ensuring all required fields are present and properly formatted.
+ *
+ * @since 2026-01-23
+ */
+import { frameworkLogger } from "../core/framework-logger.js";
+import * as fs from "fs";
+import * as path from "path";
+import * as yaml from "yaml";
+export class AgentConfigValidator {
+    requiredFields = [
+        "name",
+        "description",
+        "version",
+        "model",
+        "mode",
+    ];
+    validModes = ["primary", "subagent"];
+    validLogLevels = ["debug", "info", "warn", "error"];
+    validLogFormats = ["json", "text"];
+    validPriorities = ["low", "medium", "high", "critical"];
+    validProcessorTypes = [
+        "validation",
+        "orchestration",
+        "monitoring",
+    ];
+    /**
+     * Validate agent configuration from file
+     */
+    async validateConfigFile(filePath) {
+        const jobId = `validate-config-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+        try {
+            // Check if file exists
+            if (!fs.existsSync(filePath)) {
+                return {
+                    valid: false,
+                    errors: [`Configuration file does not exist: ${filePath}`],
+                    warnings: [],
+                    config: null,
+                };
+            }
+            // Read and parse file
+            const content = fs.readFileSync(filePath, "utf8");
+            let config;
+            if (filePath.endsWith(".yml") || filePath.endsWith(".yaml")) {
+                config = yaml.parse(content);
+            }
+            else if (filePath.endsWith(".json")) {
+                config = JSON.parse(content);
+            }
+            else {
+                return {
+                    valid: false,
+                    errors: [`Unsupported file format: ${path.extname(filePath)}`],
+                    warnings: [],
+                    config: null,
+                };
+            }
+            const result = this.validateConfig(config);
+            frameworkLogger.log("agent-config-validator", `Configuration validation ${result.valid ? "passed" : "failed"} for ${filePath}`, result.valid ? "success" : "error", {
+                jobId,
+                filePath,
+                errorCount: result.errors.length,
+                warningCount: result.warnings.length,
+            });
+            return {
+                ...result,
+                config: result.valid ? config : null,
+            };
+        }
+        catch (error) {
+            frameworkLogger.log("agent-config-validator", `Configuration validation error for ${filePath}`, "error", {
+                jobId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                valid: false,
+                errors: [
+                    `Failed to parse configuration: ${error instanceof Error ? error.message : String(error)}`,
+                ],
+                warnings: [],
+                config: null,
+            };
+        }
+    }
+    /**
+     * Validate agent configuration object
+     */
+    validateConfig(config) {
+        const errors = [];
+        const warnings = [];
+        // Check required fields
+        for (const field of this.requiredFields) {
+            if (!config[field]) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        // Validate mode
+        if (config.mode && !this.validModes.includes(config.mode)) {
+            errors.push(`Invalid mode '${config.mode}'. Must be one of: ${this.validModes.join(", ")}`);
+        }
+        // Validate logging configuration
+        if (config.logging) {
+            this.validateLoggingConfig(config.logging, errors, warnings);
+        }
+        // Validate processor pipeline
+        if (config.processor_pipeline) {
+            this.validateProcessorPipeline(config.processor_pipeline, errors, warnings);
+        }
+        // Validate performance configuration
+        if (config.performance) {
+            this.validatePerformanceConfig(config.performance, errors, warnings);
+        }
+        // Validate security configuration
+        if (config.security) {
+            this.validateSecurityConfig(config.security, errors, warnings);
+        }
+        // Validate error handling configuration
+        if (config.error_handling) {
+            this.validateErrorHandlingConfig(config.error_handling, errors, warnings);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            config: null,
+        };
+    }
+    /**
+     * Validate logging configuration
+     */
+    validateLoggingConfig(logging, errors, warnings) {
+        if (logging.level && !this.validLogLevels.includes(logging.level)) {
+            errors.push(`Invalid log level '${logging.level}'. Must be one of: ${this.validLogLevels.join(", ")}`);
+        }
+        if (logging.format && !this.validLogFormats.includes(logging.format)) {
+            errors.push(`Invalid log format '${logging.format}'. Must be one of: ${this.validLogFormats.join(", ")}`);
+        }
+        if (logging.destinations && !Array.isArray(logging.destinations)) {
+            errors.push("logging.destinations must be an array");
+        }
+        if (logging.retention_days &&
+            (typeof logging.retention_days !== "number" || logging.retention_days < 1)) {
+            errors.push("logging.retention_days must be a positive number");
+        }
+    }
+    /**
+     * Validate processor pipeline configuration
+     */
+    validateProcessorPipeline(pipeline, errors, warnings) {
+        if (!Array.isArray(pipeline)) {
+            errors.push("processor_pipeline must be an array");
+            return;
+        }
+        pipeline.forEach((processor, index) => {
+            if (!processor.name) {
+                errors.push(`processor_pipeline[${index}]: missing 'name' field`);
+            }
+            if (!processor.type) {
+                errors.push(`processor_pipeline[${index}]: missing 'type' field`);
+            }
+            else if (!this.validProcessorTypes.includes(processor.type)) {
+                errors.push(`processor_pipeline[${index}]: invalid type '${processor.type}'. Must be one of: ${this.validProcessorTypes.join(", ")}`);
+            }
+            if (!processor.priority) {
+                errors.push(`processor_pipeline[${index}]: missing 'priority' field`);
+            }
+            else if (!this.validPriorities.includes(processor.priority)) {
+                errors.push(`processor_pipeline[${index}]: invalid priority '${processor.priority}'. Must be one of: ${this.validPriorities.join(", ")}`);
+            }
+            if (processor.timeout_ms &&
+                (typeof processor.timeout_ms !== "number" || processor.timeout_ms < 0)) {
+                errors.push(`processor_pipeline[${index}]: timeout_ms must be a non-negative number`);
+            }
+            if (processor.retry_attempts &&
+                (typeof processor.retry_attempts !== "number" ||
+                    processor.retry_attempts < 0)) {
+                errors.push(`processor_pipeline[${index}]: retry_attempts must be a non-negative number`);
+            }
+        });
+    }
+    /**
+     * Validate performance configuration
+     */
+    validatePerformanceConfig(performance, errors, warnings) {
+        if (performance.timeout_ms &&
+            (typeof performance.timeout_ms !== "number" || performance.timeout_ms < 0)) {
+            errors.push("performance.timeout_ms must be a non-negative number");
+        }
+        if (performance.concurrency_limit &&
+            (typeof performance.concurrency_limit !== "number" ||
+                performance.concurrency_limit < 1)) {
+            errors.push("performance.concurrency_limit must be a positive number");
+        }
+        if (performance.memory_limit_mb &&
+            (typeof performance.memory_limit_mb !== "number" ||
+                performance.memory_limit_mb < 1)) {
+            errors.push("performance.memory_limit_mb must be a positive number");
+        }
+        if (performance.cpu_limit_percent &&
+            (typeof performance.cpu_limit_percent !== "number" ||
+                performance.cpu_limit_percent < 1 ||
+                performance.cpu_limit_percent > 100)) {
+            errors.push("performance.cpu_limit_percent must be between 1 and 100");
+        }
+    }
+    /**
+     * Validate security configuration
+     */
+    validateSecurityConfig(security, errors, warnings) {
+        if (security.permission_level &&
+            typeof security.permission_level !== "string") {
+            errors.push("security.permission_level must be a string");
+        }
+        if (security.data_classification &&
+            typeof security.data_classification !== "string") {
+            errors.push("security.data_classification must be a string");
+        }
+    }
+    /**
+     * Validate error handling configuration
+     */
+    validateErrorHandlingConfig(errorHandling, errors, warnings) {
+        if (errorHandling.retry_attempts &&
+            (typeof errorHandling.retry_attempts !== "number" ||
+                errorHandling.retry_attempts < 0)) {
+            errors.push("error_handling.retry_attempts must be a non-negative number");
+        }
+        if (errorHandling.circuit_breaker) {
+            const cb = errorHandling.circuit_breaker;
+            if (cb.failure_threshold &&
+                (typeof cb.failure_threshold !== "number" || cb.failure_threshold < 1)) {
+                errors.push("error_handling.circuit_breaker.failure_threshold must be a positive number");
+            }
+            if (cb.recovery_timeout_ms &&
+                (typeof cb.recovery_timeout_ms !== "number" ||
+                    cb.recovery_timeout_ms < 0)) {
+                errors.push("error_handling.circuit_breaker.recovery_timeout_ms must be a non-negative number");
+            }
+        }
+    }
+    /**
+     * Validate all agent configurations in a directory
+     */
+    async validateAllAgentConfigs(agentConfigDir = ".opencode/agents") {
+        const results = [];
+        // Gracefully handle missing agent config directory (headless/no .opencode/ mode)
+        if (!fs.existsSync(agentConfigDir)) {
+            frameworkLogger.log("agent-config-validator", `Agent config directory not found, skipping validation: ${agentConfigDir}`, "warning", {});
+            return {
+                results: [],
+                summary: { total: 0, valid: 0, invalid: 0 },
+            };
+        }
+        try {
+            const files = fs.readdirSync(agentConfigDir);
+            const configFiles = files.filter((f) => f.endsWith(".yml") || f.endsWith(".yaml") || f.endsWith(".json"));
+            for (const file of configFiles) {
+                const filePath = path.join(agentConfigDir, file);
+                const result = await this.validateConfigFile(filePath);
+                results.push({ file, result });
+            }
+        }
+        catch (error) {
+            frameworkLogger.log("agent-config-validator", "Failed to read agent config directory", "error", { error: error instanceof Error ? error.message : String(error) });
+        }
+        const summary = {
+            total: results.length,
+            valid: results.filter((r) => r.result.valid).length,
+            invalid: results.length - results.filter((r) => r.result.valid).length,
+        };
+        frameworkLogger.log("agent-config-validator", `Validated ${summary.total} agent configurations: ${summary.valid} valid, ${summary.invalid} invalid`, summary.invalid > 0 ? "error" : "info");
+        return { results, summary };
+    }
+}
+// Export singleton instance
+export const agentConfigValidator = new AgentConfigValidator();