0xray 2.0.1 → 2.1.1

package/src/mcps/model-health-check.server.ts

@@ -36,13 +36,13 @@ interface ModelHealthReportData {
   summary: { total: number; healthy: number; issues: number };
 }
 
-class StringRayModelHealthCheckServer {
+class XrayModelHealthCheckServer {
   private server: Server;
 
   constructor() {
     this.server = new Server(
       {
-        name: "model-health-check", version: "2.0.0",
+        name: "model-health-check", version: "2.0.1",
       },
       {
         capabilities: {
@@ -285,8 +285,8 @@ class StringRayModelHealthCheckServer {
 
 // Start the server if this file is run directly
 if (import.meta.url === `file://${process.argv[1]}`) {
-  const server = new StringRayModelHealthCheckServer();
+  const server = new XrayModelHealthCheckServer();
   server.start().catch((error) => frameworkLogger.log("mcps/model-health-check", "run", "error", { error: String(error) }));
 }
 
-export default StringRayModelHealthCheckServer;
+export default XrayModelHealthCheckServer;

package/src/mcps/orchestrator/server.ts

@@ -12,7 +12,7 @@ import {
   ListToolsRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
 import { frameworkLogger } from '../../core/framework-logger.js';
-import { StringRayStateManager } from '../../state/state-manager.js';
+import { XrayStateManager } from '../../state/state-manager.js';
 import { MultiAgentOrchestrationCoordinator } from '../../orchestrator/multi-agent-orchestration-coordinator.js';
 
 import { TaskHandler } from './handlers/task-handler.js';
@@ -45,7 +45,7 @@ export class OrchestratorServer {
 
   constructor() {
     // Initialize actual coordinator
-    const stateManager = new StringRayStateManager();
+    const stateManager = new XrayStateManager();
     this.coordinator = new MultiAgentOrchestrationCoordinator(stateManager);
     
     // Initialize handlers

package/src/mcps/performance-analysis.server.ts

@@ -57,14 +57,14 @@ interface ResourceMetrics {
   recommendations: string[];
 }
 
-class StringRayPerformanceAnalysisServer {
+class XrayPerformanceAnalysisServer {
   private server: Server;
   private startTime: number;
 
   constructor() {
     this.server = new Server(
       {
-        name: "performance-analysis", version: "2.0.0",
+        name: "performance-analysis", version: "2.0.1",
       },
       {
         capabilities: {
@@ -708,8 +708,8 @@ ${results.recommendations.map((r) => `• 💡 ${r}`).join("\n") || "No recommen
 
 // Start the server if run directly
 if (import.meta.url === `file://${process.argv[1]}`) {
-  const server = new StringRayPerformanceAnalysisServer();
+  const server = new XrayPerformanceAnalysisServer();
   server.run().catch((error) => frameworkLogger.log("mcps/performance-analysis", "run", "error", { error: String(error) }));
 }
 
-export { StringRayPerformanceAnalysisServer };
+export { XrayPerformanceAnalysisServer };

package/src/mcps/processor-pipeline.server.ts

@@ -87,7 +87,7 @@ interface FrameworkComplianceResult {
   approved: boolean;
 }
 
-class StringRayProcessorPipelineServer {
+class XrayProcessorPipelineServer {
   private server: Server;
   private codexLoader: CodexLoader;
   private codexRules: RuleDefinition[] = [];
@@ -107,7 +107,7 @@ class StringRayProcessorPipelineServer {
     this.codexLoader = new CodexLoader();
     this.server = new Server(
       {
-        name: "processor-pipeline", version: "2.0.0",
+        name: "processor-pipeline", version: "2.0.1",
       },
       {
         capabilities: {
@@ -771,8 +771,8 @@ ${complianceResults.actions.map((a: string) => `• 🔧 ${a}`).join("\n") || "N
 
 // Start the server if run directly
 if (import.meta.url === `file://${process.argv[1]}`) {
-  const server = new StringRayProcessorPipelineServer();
+  const server = new XrayProcessorPipelineServer();
   server.run().catch((error) => frameworkLogger.log("mcps/processor-pipeline", "run", "error", { error: String(error) }));
 }
 
-export { StringRayProcessorPipelineServer };
+export { XrayProcessorPipelineServer };

package/src/mcps/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "0xRay Community MCPs Registry - curated API-focused MCP servers",
   "sources": [
     {

package/src/mcps/researcher.server.ts

@@ -4,7 +4,7 @@
  * Knowledge skill for codebase documentation lookup, implementation examples,
  * and multi-repo analysis - serves as the universal documentation reference
  *
- * NOTE: Class is named StringRayLibrarianServer but the MCP server name is
+ * NOTE: Class is named XrayLibrarianServer but the MCP server name is
  * "researcher" for backwards compatibility with existing tool references.
  */
 
@@ -48,13 +48,13 @@ interface AnalyzeProposalArgs {
   proposalType?: string;
 }
 
-class StringRayLibrarianServer {
+class XrayLibrarianServer {
   private server: Server;
 
   constructor() {
     this.server = new Server(
       {
-        name: "researcher", version: "2.0.0",
+        name: "researcher", version: "2.0.1",
       },
       {
         capabilities: {
@@ -588,8 +588,8 @@ class StringRayLibrarianServer {
 
 // Run the server if this file is executed directly
 if (import.meta.url === `file://${process.argv[1]}`) {
-  const server = new StringRayLibrarianServer();
+  const server = new XrayLibrarianServer();
   server.run().catch((error) => frameworkLogger.log("mcps/researcher", "run", "error", { error: String(error) }));
 }
 
-export { StringRayLibrarianServer };
+export { XrayLibrarianServer };

package/src/mcps/security-scan.server.ts

@@ -39,13 +39,13 @@ interface SecuritySummaryResults {
   summary: string;
 }
 
-class StringRaySecurityScanServer {
+class XraySecurityScanServer {
   private server: Server;
 
   constructor() {
     this.server = new Server(
       {
-        name: "security-scan", version: "2.0.0",
+        name: "security-scan", version: "2.0.1",
       },
       {
         capabilities: {
@@ -644,8 +644,8 @@ ${results.recommendations.map((r) => `• ${r}`).join("\n") || "No recommendatio
 
 // Start the server if run directly
 if (import.meta.url === `file://${process.argv[1]}`) {
-  const server = new StringRaySecurityScanServer();
+  const server = new XraySecurityScanServer();
   server.run().catch((error) => frameworkLogger.log("mcps/security-scan", "run", "error", { error: String(error) }));
 }
 
-export { StringRaySecurityScanServer };
+export { XraySecurityScanServer };

package/src/mcps/simulation/server-simulations.ts

@@ -86,7 +86,7 @@ export const researcherSimulations: Record<string, SimulatorFunction> = {
  * Framework Help server simulations
  */
 export const frameworkHelpSimulations: Record<string, SimulatorFunction> = {
-  strray_get_capabilities: (): MCPToolResult => ({
+  xray_get_capabilities: (): MCPToolResult => ({
     content: [
       {
         type: 'text',
@@ -118,7 +118,7 @@ export const frameworkHelpSimulations: Record<string, SimulatorFunction> = {
     ],
   }),
 
-  strray_get_commands: (): MCPToolResult => ({
+  xray_get_commands: (): MCPToolResult => ({
     content: [
       {
         type: 'text',
@@ -146,7 +146,7 @@ framework-reporting-system - Generate comprehensive framework reports
     ],
   }),
 
-  strray_explain_capability: (): MCPToolResult => ({
+  xray_explain_capability: (): MCPToolResult => ({
     content: [
       {
         type: 'text',

package/src/mcps/state-manager.server.ts

@@ -71,7 +71,7 @@ class StrRayStateManagerServer {
   constructor() {
     this.server = new Server(
       {
-        name: "state-manager", version: "2.0.0",
+        name: "state-manager", version: "2.0.1",
       },
       {
         capabilities: {

package/src/opencode/codex.codex

@@ -1,5 +1,5 @@
 {
-  "version": "2.0.0",
+  "version": "2.0.1",
   "terms": [
      1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68
   ],

package/src/opencode/commands/dependency-audit.md

@@ -69,7 +69,7 @@ Comprehensive dependency analysis and security audit for all project dependencie
   "vulnerabilities": [
     {
       "package": "lodash",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "severity": "high",
       "cve": "CVE-2021-23337",
       "description": "Command injection vulnerability"
@@ -85,14 +85,14 @@ Security-focused format for CI/CD integration:
 
 ```json
 {
-  "version": "2.0.0",
+  "version": "2.0.1",
   "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json",
   "runs": [
     {
       "tool": {
         "driver": {
           "name": "Dependency Audit",
-          "version": "2.0.0"
+          "version": "2.0.1"
         }
       },
       "results": [...]

package/src/opencode/enforcer-config.json

@@ -1,6 +1,6 @@
 {
   "framework": "xray 2.0",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Codex-compliant framework configuration for Credible UI project",
   "thresholds": {
     "bundleSize": {
@@ -220,7 +220,7 @@
       }
     },
     "codex": {
-      "version": "2.0.0",
+      "version": "2.0.1",
       "terms": [
         1,
         2,

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

@@ -1,21 +1,21 @@
 ---
 name: hermes-agent
-description: Manage StringRay framework from Hermes Agent via the native strray-hermes plugin. Covers the 4 plugin tools (validate, codex_check, health, hooks), lifecycle hooks, slash commands, bridge architecture, and CLI fallback.
+description: Manage 0xRay framework from Hermes Agent via the native strray-hermes plugin. Covers the 4 plugin tools (validate, codex_check, health, hooks), lifecycle hooks, slash commands, bridge architecture, and CLI fallback.
 version: 2.1.0
-author: StringRay AI
+author: 0xRay AI
 metadata:
   hermes:
-    tags: [StringRay, Plugin, Validation, Codex, GitHooks, Bridge]
+    tags: [0xRay, Plugin, Validation, Codex, GitHooks, Bridge]
     related_skills: []
 ---
 
-# StringRay Hermes Plugin (strray-hermes)
+# 0xRay Hermes Plugin (strray-hermes)
 
-Native Hermes plugin providing StringRay framework integration — quality gates, codex enforcement, git hooks, and full pre/post processing pipeline. Runs via a Node.js bridge to compiled framework components.
+Native Hermes plugin providing 0xRay framework integration — quality gates, codex enforcement, git hooks, and full pre/post processing pipeline. Runs via a Node.js bridge to compiled framework components.
 
 ## When to Use
 
-- User asks about StringRay health, validation, or codex checks
+- User asks about 0xRay health, validation, or codex checks
 - User wants to install/manage git hooks for automated enforcement
 - User asks about the plugin's tools, hooks, or slash commands
 - User asks about bridge errors or framework not loading
@@ -28,7 +28,7 @@ Native Hermes plugin providing StringRay framework integration — quality gates
 ├── __init__.py         # Plugin registration, hooks, slash commands
 ├── tools.py            # 4 tool handlers (validate, codex_check, health, hooks)
 ├── schemas.py          # JSON schemas the LLM sees
-├── bridge.mjs          # Node.js bridge to compiled StringRay framework
+├── bridge.mjs          # Node.js bridge to compiled 0xRay framework
 ├── plugin.yaml         # Plugin metadata (name, version, tools, hooks)
 ├── types.py            # TypeScript-equivalent type definitions
 ├── after-install.md    # Post-install instructions
@@ -43,7 +43,7 @@ Native Hermes plugin providing StringRay framework integration — quality gates
 
 **Fallback:** When bridge is unavailable, tools fall back to `npx 0xray` CLI commands.
 
-**Config path resolution:** `STRRAY_CONFIG_DIR/` > `.strray/` > `.opencode/strray/` > built-in defaults.
+**Config path resolution:** `STRRAY_CONFIG_DIR/` > `.xray/` > `.opencode/xray/` > built-in defaults.
 
 ## 4 Tools
 
@@ -90,7 +90,7 @@ Returns: framework status, version, component availability, node version.
 
 ### strray_hooks
 
-Manage StringRay git hooks (install, uninstall, list, status).
+Manage 0xRay git hooks (install, uninstall, list, status).
 
 ```
 strray_hooks(action="install")
@@ -122,7 +122,7 @@ Fires before ANY tool executes:
 1. Tracks session stats
 2. Logs tool-start event to `logs/framework/plugin-tool-events.log`
 3. For code-producing tools (write_file, patch, execute_code, write, edit): runs quality gate + pre-processors via bridge
-4. For other tools: nudges when a StringRay MCP alternative exists (e.g., grep → search_codebase, eslint → strray_lint)
+4. For other tools: nudges when a 0xRay MCP alternative exists (e.g., grep → search_codebase, eslint → strray_lint)
 
 ### post_tool_call
 
@@ -164,7 +164,7 @@ All logs go to `logs/framework/` in the project root:
 
 | User Says | Tool / Command |
 |----------|---------------|
-| "Is StringRay working?" | `strray_health()` or `/strray status` |
+| "Is 0xRay working?" | `strray_health()` or `/strray status` |
 | "Check these files before I commit" | `strray_validate(files=[...], operation="commit")` |
 | "Is this code codex compliant?" | `strray_codex_check(code=..., operation="create")` |
 | "Set up git hooks" | `strray_hooks(action="install")` |
@@ -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, `strray_hooks(action="install")` skips those hooks.
-- Project root detection walks up from CWD looking for `node_modules/0xray`, `.opencode/strray/features.json`, or `package.json`. Override with `STRRAY_PROJECT_ROOT` env var.
+- Project root detection walks up from CWD looking for `node_modules/0xray`, `.opencode/xray/features.json`, or `package.json`. Override with `STRRAY_PROJECT_ROOT` env var.
 - `logs/framework/` is created automatically. Never breaks the agent if permissions fail.

package/src/skills/registry.json

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

package/src/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/strray/codex.json)
+- Related Codex terms: [codex.json](../../.opencode/xray/codex.json)
 - Next story to write: [suggestion]
 ```
 

package/src/skills/xray-orchestrator/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: xray-orchestrator
+description: |
+  Main orchestration skill for xray agents.
+  Provides commands to coordinate agent work and invoke xray APIs
+  through the local HTTP API server.
+metadata:
+  openclaw:
+    primaryEnv: XRAY_API_KEY
+    emoji: 🤖
+  author: xray
+  tags:
+    - ai
+    - orchestration
+    - agent
+user-invocable: true
+---
+
+# xray Orchestrator Commands
+
+## /xray
+
+Display xray status and available commands.
+
+**Usage:** `/xray`
+
+**Example:**
+```
+/xray
+```
+
+## /xray-status
+
+Get detailed status of xray integration including connection status.
+
+**Usage:** `/xray-status`
+
+**Example:**
+```
+/xray-status
+```
+
+## /xray-analyze
+
+Analyze code using xray code analysis capabilities.
+
+**Usage:** `/xray-analyze <file-path>`
+
+**Arguments:**
+- `file-path`: Path to file to analyze (required)
+
+**Example:**
+```
+/xray-analyze src/index.ts
+```
+
+## /xray-code
+
+Perform code review on a file.
+
+**Usage:** `/xray-code <file-path> [options]`
+
+**Arguments:**
+- `file-path`: Path to file to review (required)
+- `--fix`: Attempt to fix issues automatically (optional)
+
+**Example:**
+```
+/xray-code src/utils/helper.ts
+/xray-code src/utils/helper.ts --fix
+```
+
+## /xray-file
+
+Read file using xray file tools.
+
+**Usage:** `/xray-file <file-path> [line-start:line-end]`
+
+**Arguments:**
+- `file-path`: Path to file to read (required)
+- `line-start:line-end`: Line range to read (optional)
+
+**Example:**
+```
+/xray-file src/index.ts
+/xray-file src/index.ts 1:50
+```
+
+## /xray-exec
+
+Execute arbitrary xray command or script.
+
+**Usage:** `/xray-exec <command>`
+
+**Arguments:**
+- `command`: Command to execute (required)
+
+**Example:**
+```
+/xray-exec list files src/
+```
+
+## /xray-help
+
+Show this help message.
+
+**Usage:** `/xray-help [command]`
+
+**Arguments:**
+- `command`: Specific command to get help for (optional)
+
+**Example:**
+```
+/xray-help
+/xray-help xray-analyze
+```
+
+# Implementation Notes
+
+This skill acts as the main interface between OpenClaw channels and xray agents.
+It processes user commands and forwards them to the xray API server running on localhost:18431.
+
+## API Endpoints
+
+- `POST /api/agent/invoke` - Invoke xray agent
+- `GET /api/agent/status` - Get agent status
+- `GET /health` - Health check
+
+## Authentication
+
+The skill reads the `XRAY_API_KEY` environment variable for authentication.
+
+## Error Handling
+
+All errors are caught and formatted as user-friendly messages.
+Detailed error information is logged for debugging.
+
+# Dependencies
+
+- xray API server running on localhost:18431
+- XRAY_API_KEY environment variable