0xray 2.0.1 → 2.1.0

package/dist/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")` |

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

package/dist/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

package/dist/skills/xray-orchestrator/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * xray Orchestrator Skill
+ *
+ * OpenClaw skill that provides xray orchestration commands.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+export declare function handleSkill(input: string): Promise<string>;
+declare const _default: {
+    handleSkill: typeof handleSkill;
+};
+export default _default;

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

@@ -0,0 +1,224 @@
+/**
+ * xray Orchestrator Skill
+ *
+ * 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';
+const API_KEY = process.env.XRAY_API_KEY;
+function parseArgs(input) {
+    const parts = input.trim().split(/\s+/);
+    const command = parts[0] || '';
+    const args = {};
+    for (const part of parts.slice(1)) {
+        if (part.startsWith('--')) {
+            const key = part.slice(2);
+            args[key] = true;
+        }
+        else if (part.includes(':')) {
+            const colonIdx = part.indexOf(':');
+            const key = part.slice(0, colonIdx);
+            const value = part.slice(colonIdx + 1);
+            if (key && value)
+                args[key] = value;
+        }
+        else if (!args._) {
+            args._ = [];
+            args._.push(part);
+        }
+        else {
+            args._.push(part);
+        }
+    }
+    return { command, args };
+}
+async function callAPI(endpoint, data) {
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (API_KEY) {
+        headers['Authorization'] = `Bearer ${API_KEY}`;
+    }
+    const response = await fetch(`${API_BASE}${endpoint}`, {
+        method: data ? 'POST' : 'GET',
+        headers,
+        body: data ? JSON.stringify(data) : null,
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+        throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    return response.json();
+}
+export async function handleSkill(input) {
+    const { command, args } = parseArgs(input);
+    try {
+        switch (command.toLowerCase()) {
+            // xray primary
+            case 'xray':
+            case 'xray-status':
+                return await handleStatus();
+            case 'xray-analyze':
+                return await handleAnalyze(args);
+            case 'xray-code':
+                return await handleCodeReview(args);
+            case 'xray-file':
+                return await handleFileRead(args);
+            case 'xray-exec':
+                return await handleExec(args);
+            case 'xray-help':
+                return handleHelp(args._);
+            default:
+                return formatHelp();
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return `❌ Error: ${message}`;
+    }
+}
+async function handleStatus() {
+    const health = await callAPI('/health');
+    return `🤖 xray Status
+
+• Status: ${health.status}
+• Version: ${health.version}
+• Uptime: ${formatUptime(health.uptime)}
+
+Use /xray-help for available commands.`;
+}
+async function handleAnalyze(args) {
+    const filePath = args._?.[0];
+    if (!filePath) {
+        return '❌ Usage: /xray-analyze <file-path>';
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'analyze',
+        args: { filePath },
+    });
+    if (!result.success) {
+        return `❌ Analysis failed: ${result.error}`;
+    }
+    return `✅ Analysis complete for ${filePath}\n\n${JSON.stringify(result.result, null, 2)}`;
+}
+async function handleCodeReview(args) {
+    const filePath = args._?.[0];
+    const fix = args.fix === true;
+    if (!filePath) {
+        return '❌ Usage: /xray-code <file-path> [--fix]';
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'code-review',
+        args: { filePath, fix },
+    });
+    if (!result.success) {
+        return `❌ Code review failed: ${result.error}`;
+    }
+    return `✅ Code review complete for ${filePath}\n\n${JSON.stringify(result.result, null, 2)}`;
+}
+async function handleFileRead(args) {
+    const rest = args._;
+    const filePath = rest?.[0];
+    const range = rest?.[1];
+    if (!filePath) {
+        return '❌ Usage: /xray-file <file-path> [line-start:line-end]';
+    }
+    let lineRange;
+    if (range?.includes(':')) {
+        const [rawStart, rawEnd] = range.split(':');
+        lineRange = {};
+        if (rawStart)
+            lineRange.start = Number(rawStart);
+        if (rawEnd)
+            lineRange.end = Number(rawEnd);
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'read',
+        args: { filePath, ...lineRange },
+    });
+    if (!result.success) {
+        return `❌ File read failed: ${result.error}`;
+    }
+    return `📄 ${filePath}\n\`\`\`\n${result.result}\n\`\`\``;
+}
+async function handleExec(args) {
+    const command = args._?.[0];
+    if (!command) {
+        return '❌ Usage: /xray-exec <command>';
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'exec',
+        args: { command },
+    });
+    if (!result.success) {
+        return `❌ Execution failed: ${result.error}`;
+    }
+    return `✅ Command executed\n\n${JSON.stringify(result.result, null, 2)}`;
+}
+function handleHelp(command) {
+    if (command) {
+        switch (command) {
+            case 'xray-analyze':
+                return `📖 /xray-analyze <file-path>
+
+Analyze code in a file.
+
+Example: /xray-analyze src/index.ts`;
+            case 'xray-code':
+                return `📖 /xray-code <file-path> [--fix]
+
+Perform code review on a file.
+Use --fix to attempt automatic fixes.
+
+Example: /xray-code src/utils/helper.ts
+Example: /xray-code src/utils/helper.ts --fix`;
+            case 'xray-file':
+                return `📖 /xray-file <file-path> [line-start:line-end]
+
+Read a file.
+Optionally specify line range.
+
+Example: /xray-file src/index.ts
+Example: /xray-file src/index.ts 1:50`;
+            case 'xray-exec':
+                return `📖 /xray-exec <command>
+
+Execute an arbitrary command.
+
+Example: /xray-exec list files src/`;
+            default:
+                return `Unknown command: ${command}`;
+        }
+    }
+    return formatHelp();
+}
+function formatHelp() {
+    return `🤖 xray Orchestrator
+
+Available Commands:
+• /xray - Show status
+• /xray-analyze <file> - Analyze code
+• /xray-code <file> [--fix] - Code review
+• /xray-file <file> [lines] - Read file
+• /xray-exec <command> - Execute command
+• /xray-help [command] - Show help
+
+Use /xray-help <command> for detailed usage.`;
+}
+function formatUptime(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ${hours % 24}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes % 60}m`;
+    if (minutes > 0)
+        return `${minutes}m`;
+    return `${seconds}s`;
+}
+// Export for OpenClaw
+export default { handleSkill };

package/dist/state/index.d.ts

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

package/dist/state/index.js

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

package/dist/state/state-manager.d.ts

@@ -3,7 +3,7 @@ export interface StateManager {
     set: <T>(key: string, value: T) => void;
     clear: (key: string) => void;
 }
-export declare class StringRayStateManager implements StateManager {
+export declare class XrayStateManager implements StateManager {
     private store;
     private persistencePath;
     private persistenceEnabled;
@@ -39,4 +39,4 @@ export declare class StringRayStateManager implements StateManager {
         value2: unknown;
     }): unknown;
 }
-export { StringRayStateManager as StrRayStateManager };
+export { XrayStateManager as StringRayStateManager, XrayStateManager as StrRayStateManager };

package/dist/state/state-manager.js

@@ -1,6 +1,6 @@
 import { frameworkLogger } from "../core/framework-logger.js";
 import { resolveStateFilePath } from "../core/config-paths.js";
-export class StringRayStateManager {
+export class XrayStateManager {
     store = new Map();
     persistencePath;
     persistenceEnabled;
@@ -190,7 +190,7 @@ export class StringRayStateManager {
     }
     // Enterprise features for advanced state management
     getStateVersion() {
-        return StringRayStateManager.VERSION || "1.1.1";
+        return XrayStateManager.VERSION || "1.1.1";
     }
     getAuditLog() {
         return []; // Simplified implementation for testing
@@ -204,5 +204,6 @@ export class StringRayStateManager {
         return conflict.value2; // Prefer the second value as newer
     }
 }
-// Export alias for scripts expecting StrRayStateManager (backward compatibility)
-export { StringRayStateManager as StrRayStateManager };
+// Export alias for scripts expecting XrayStateManager
+// Backward compat: StringRayStateManager and StrRayStateManager aliases
+export { XrayStateManager as StringRayStateManager, XrayStateManager as StrRayStateManager };

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/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/token-manager.js

@@ -3,7 +3,7 @@ import * as path from "path";
 import { resolveConfigPath } from "../core/config-paths.js";
 export class TokenManager {
     config;
-    constructor(configPath = resolveConfigPath("config.json") || path.join(process.cwd(), ".strray", "config.json")) {
+    constructor(configPath = resolveConfigPath("config.json") || path.join(process.cwd(), ".xray", "config.json")) {
         this.config = this.loadConfig(configPath);
     }
     loadConfig(configPath) {

package/dist/validation/estimation-validator.js

@@ -12,7 +12,7 @@ import { frameworkLogger } from '../core/framework-logger.js';
 export class EstimationValidator {
     estimations = new Map();
     calibrations = new Map();
-    STORAGE_KEY = 'strray-estimations';
+    STORAGE_KEY = 'xray-estimations';
     constructor() {
         this.loadFromStorage();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Multi-agent orchestration and Codex governance for OpenCode, Hermes, Grok Build, and OpenClaw",
   "readme": "README.md",
   "license": "MIT",
@@ -120,7 +120,6 @@
     "scripts/mjs/test-mcp-functionality.mjs",
     "scripts/mjs/validate-mcp-connectivity.cjs",
     "scripts/mjs/validate-postinstall-config.mjs",
-    "scripts/validate-stringray-comprehensive.js",
     "src/opencode/",
     "src/opencode/AGENTS-consumer.md",
     "src/opencode/codex.codex",
@@ -149,6 +148,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
+    "0xray": "^2.0.1",
     "commander": "^11.1.0",
     "express": "^5.2.1",
     "jsonwebtoken": "^9.0.3",

package/scripts/hooks/pre-command

@@ -1,5 +1,5 @@
 #!/bin/bash
-# Pre-Command Hook for StringRay
+# Pre-Command Hook for 0xRay
 # 
 # Checks context window usage before each command.
 # If context is at 95%+ (configurable), auto-generates a reflection.

package/scripts/hooks/run-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * StringRay Git Hook Runner
+ * 0xRay Git Hook Runner
  *
  * Called by git hooks (pre-commit, post-commit, pre-push, post-push)
  * to perform validation, logging, and monitoring.
@@ -565,6 +565,6 @@ handler()
   })
   .catch((err) => {
     logError(`Hook crashed: ${err.message}`);
-    console.error(`StringRay hook error: ${err.message}`);
+    console.error(`0xRay hook error: ${err.message}`);
     process.exit(1);
   });

package/scripts/node/auto-reflection-generator.mjs

@@ -107,9 +107,9 @@ function getChangedFiles(count = 20) {
 }
 
 function loadConfig() {
-  // Primary: .opencode/xray/ YML SSOT. Min legacy fallbacks for .opencode/strray/ + .strray/ (transitional consumer compat; documented per Term 61)
+  // Primary: .opencode/xray/ YML SSOT. Min legacy fallbacks (transitional consumer compat; documented per Term 61)
   const configPath = join(process.cwd(), ".opencode", "xray", "features.json");
-  const fallbackPath = join(process.cwd(), ".opencode", "strray", "features.json");
+  const fallbackPath = join(process.cwd(), ".opencode", "xray", "features.json");
   const legacyPath = join(process.cwd(), ".strray", "features.json");
   
   for (const p of [configPath, fallbackPath, legacyPath]) {

package/scripts/node/postinstall.cjs

@@ -46,7 +46,7 @@ if (resolvedPackage !== resolvedTarget) {
     const xrayRoot = targetDir;
 
     execSync(
-      `grok mcp add xray-governance --command node --args "${govServer}" --env "STRRAY_FORCE_MCP_GOVERNANCE=true" --env "XRAY_ROOT=${xrayRoot}"`,
+      `grok mcp add xray-governance --command node --args "${govServer}" --env "XRAY_FORCE_MCP_GOVERNANCE=true" --env "XRAY_ROOT=${xrayRoot}"`,
       { stdio: 'pipe' }
     );
     structuredLog('postinstall', 'Registered xray-governance with Grok CLI', 'info');