0xray 3.0.14 → 3.1.0

package/.opencode/hooks/post-commit

@@ -21,7 +21,7 @@ BRANCH=$(git rev-parse --abbrev-ref HEAD)
 ) &
 
 # Load auto_reflection config from features.json
-CONFIG_FILE="$PROJECT_ROOT/.opencode/strray/features.json"
+CONFIG_FILE="$PROJECT_ROOT/.opencode/xray/features.json"
 MODE="minimal"
 COMMIT_THRESHOLD=25
 DAYS_THRESHOLD=14

package/.opencode/init.sh

@@ -30,7 +30,7 @@ fi
 
 # 0xRay Framework Version - read from FRAMEWORK_ROOT (already resolved above)
 # FRAMEWORK_ROOT correctly picks source in dev mode, node_modules in consumer mode
-STRRAY_VERSION=$(node -e "console.log(require('$FRAMEWORK_ROOT/package.json').version)" 2>/dev/null || echo "unknown")
+XRAY_VERSION=$(node -e "console.log(require('$FRAMEWORK_ROOT/package.json').version)" 2>/dev/null || echo "unknown")
 
 # Dedup guard — prevent duplicate runs during startup
 # Uses a TTL lockfile (10s window) since OpenCode may trigger config hook
@@ -90,10 +90,10 @@ if [ "$AGENTS_COUNT" -eq 0 ]; then
     AGENTS_COUNT=$(ls -1 "$PROJECT_ROOT/node_modules/0xray/.opencode/agents/"*.yml 2>/dev/null | wc -l | tr -d ' ')
 fi
 
-# Skills - check .opencode/skills, then .strray/skills (Hermes), then node_modules
+# Skills - check .opencode/skills, then .xray/skills (Hermes), then node_modules
 SKILLS_COUNT=$(ls -1d "$PROJECT_ROOT/.opencode/skills/"* 2>/dev/null | wc -l | tr -d ' ')
 if [ "$SKILLS_COUNT" -eq 0 ]; then
-    SKILLS_COUNT=$(ls -1d "$PROJECT_ROOT/.strray/skills/"* 2>/dev/null | wc -l | tr -d ' ')
+    SKILLS_COUNT=$(ls -1d "$PROJECT_ROOT/.xray/skills/"* 2>/dev/null | wc -l | tr -d ' ')
 fi
 if [ "$SKILLS_COUNT" -eq 0 ]; then
     SKILLS_COUNT=$(ls -1d "$PROJECT_ROOT/node_modules/0xray/.opencode/skills/"* 2>/dev/null | wc -l | tr -d ' ')
@@ -124,7 +124,7 @@ if [ ! -f "$PROJECT_ROOT/.opencode/enforcer-config.json" ]; then
 fi
 
 echo ""
-echo "⚡ 0xRay v$STRRAY_VERSION"
+echo "⚡ 0xRay v$XRAY_VERSION"
 echo "🤖 Agents: $AGENTS_COUNT | ⚙️ MCPs: $MCPS_COUNT | 💡 Skills: $SKILLS_COUNT"
 
 # BootOrchestrator check (check dev and consumer paths)

package/AGENTS.md

@@ -86,9 +86,9 @@ xray enforces the Universal Development Codex (60 terms) via Dynamo governance.
 
 Pure v16 MCPs. Clean. Complete.
 
-## Session: v3.0.13 Release Polish
+## Session: v3.0.14 Rename Polish
 
-- Package: `0xray` (npm), `github.com/0xRayAI/xray`. Version `3.0.13`.
+- Package: `0xray` (npm), `github.com/0xRayAI/xray`. Version `3.0.14`.
 - **All 182 test files pass**: 2527 tests, 0 failures, 36 skipped.
 - **Build fix**: removed stale `.opencode/plugin/` copy; `package.json` → `dist/plugin/xray-codex-injection.js`.
 - **default-plugins.ts**: monkey-patch `Server.prototype.setRequestHandler` to capture tool definitions from MCP Server instances; all registration functions async.

package/dist/AGENTS.md

@@ -86,9 +86,9 @@ xray enforces the Universal Development Codex (60 terms) via Dynamo governance.
 
 Pure v16 MCPs. Clean. Complete.
 
-## Session: v3.0.13 Release Polish
+## Session: v3.0.14 Rename Polish
 
-- Package: `0xray` (npm), `github.com/0xRayAI/xray`. Version `3.0.13`.
+- Package: `0xray` (npm), `github.com/0xRayAI/xray`. Version `3.0.14`.
 - **All 182 test files pass**: 2527 tests, 0 failures, 36 skipped.
 - **Build fix**: removed stale `.opencode/plugin/` copy; `package.json` → `dist/plugin/xray-codex-injection.js`.
 - **default-plugins.ts**: monkey-patch `Server.prototype.setRequestHandler` to capture tool definitions from MCP Server instances; all registration functions async.

package/dist/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Conventional Commits](https://www.conventionalcommits.org/).
 
+## [3.1.0] - 2026-06-15
+
+### 🔄 Changes
+
+### 🐛 Bug Fixes
+- fix: pre-publish-guard handles missing features.json (855e3cfdb)
+
+---
+
 ## [3.0.14] - 2026-06-14
 
 ### 🔄 Changes

package/dist/benchmark/performance-benchmark.js

@@ -1,7 +1,7 @@
 // Consumer runtime compat shim from prior StringRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .strray fallbacks)
 import { frameworkLogger } from "../core/framework-logger.js";
 import crypto from "crypto";
-export class StringRayPerformanceBenchmark {
+export class XrayPerformanceBenchmark {
     results = [];
     activeBenchmarks = new Map();
     /**
@@ -369,4 +369,6 @@ export class StringRayPerformanceBenchmark {
     }
 }
 // Export singleton instance
-export const performanceBenchmark = new StringRayPerformanceBenchmark();
+export const performanceBenchmark = new XrayPerformanceBenchmark();
+// Backward compat alias
+export { XrayPerformanceBenchmark as StringRayPerformanceBenchmark };

package/dist/cli/commands/hermes-install.js

@@ -16,14 +16,14 @@ export function registerHermesCommands(hermesCmd) {
 async function installForHermes(options = {}) {
     frameworkLogger.log('hermes-integration', 'install-start', 'info', { options });
     const home = homedir();
-    const targetPluginDir = path.join(home, '.hermes/plugins/strray-hermes');
+    const targetPluginDir = path.join(home, '.hermes/plugins/xray-hermes');
     const possibleSources = [
         path.join(__dirname, '..', '..', '..', 'dist/integrations/hermes-agent'),
         path.join(__dirname, '..', '..', '..', 'src/integrations/hermes-agent'),
     ];
     let sourceDir = possibleSources.find(p => fs.existsSync(p));
     if (!sourceDir) {
-        console.error('[Hermes] Could not locate the strray-hermes plugin inside the package.');
+        console.error('[Hermes] Could not locate the xray-hermes plugin inside the package.');
         return;
     }
     if (options.dryRun) {
@@ -32,7 +32,7 @@ async function installForHermes(options = {}) {
     }
     try {
         if (fs.existsSync(targetPluginDir) && !options.force) {
-            console.log('[Hermes] strray-hermes plugin is already installed.');
+            console.log('[Hermes] xray-hermes plugin is already installed.');
             console.log('Use --force to reinstall.');
             return;
         }
@@ -56,7 +56,7 @@ async function installForHermes(options = {}) {
         }
         console.log('\n✅ 0xRay is now installed as a Hermes Agent plugin!');
         console.log('Restart Hermes to load the plugin and its tools.');
-        console.log('  Run: /strray status  (to verify)');
+        console.log('  Run: /xray status  (to verify)');
     }
     catch (err) {
         frameworkLogger.log('hermes-integration', 'install-error', 'error', { error: err.message });

package/dist/cli/commands/mcp-install.js

@@ -3,7 +3,7 @@ import { join, dirname } from "path";
 import { execSync } from "child_process";
 import { getConfigDir } from "../../core/config-paths.js";
 function getMCPConfigPath() {
-    return join(process.cwd(), ".opencode", "strray", "mcp-registry.json");
+    return join(process.cwd(), ".opencode", "xray", "mcp-registry.json");
 }
 function getBundledMCPRegistry() {
     const paths = [

package/dist/cli/commands/openclaw-install.js

@@ -14,7 +14,7 @@ export function registerOpenClawCommands(openclawCmd) {
 }
 async function installForOpenClaw(options = {}) {
     frameworkLogger.log('openclaw-integration', 'install-start', 'info', { options });
-    const configPath = path.join(process.cwd(), '.strray', 'config', 'openclaw.json');
+    const configPath = path.join(process.cwd(), '.xray', 'config', 'openclaw.json');
     if (options.dryRun) {
         console.log(`[OpenClaw] Dry run: Would create config at ${configPath}`);
         return;

package/dist/cli/commands/plugin-commands.js

@@ -14,8 +14,8 @@
 import * as fs from "fs";
 import * as path from "path";
 import { spawnSync } from "child_process";
-const PLUGINS_DIR = ".strray/plugins";
-const CONFIG_PATH = ".strray/config/plugin-config.json";
+const PLUGINS_DIR = ".xray/plugins";
+const CONFIG_PATH = ".xray/config/plugin-config.json";
 export async function pluginListCommand() {
     console.log("\n📦 0xRay Plugins\n");
     console.log("═".repeat(60));

package/dist/cli/commands/publish-agent.js

@@ -69,10 +69,10 @@ function getPackageVersion(cwd) {
         }
     }
     catch { /* ignore */ }
-    const strrayPkgPath = join(cwd, ".opencode", "package.json");
+    const xrayPkgPath = join(cwd, ".opencode", "package.json");
     try {
-        if (existsSync(strrayPkgPath)) {
-            const pkg = JSON.parse(readFileSync(strrayPkgPath, "utf-8"));
+        if (existsSync(xrayPkgPath)) {
+            const pkg = JSON.parse(readFileSync(xrayPkgPath, "utf-8"));
             if (pkg.version)
                 return pkg.version;
         }
@@ -89,7 +89,7 @@ function createAgentManifest(agentName, configPath, version, cwd) {
         author: extractYamlField(content, "author") || extractYamlField(content, "maintainer") || "0xRay User",
         license: extractYamlField(content, "license") || "MIT",
         source: extractYamlField(content, "source") || "custom",
-        framework: "stringray",
+        framework: "0xray",
         frameworkVersion: getPackageVersion(cwd),
         publishedAt: new Date().toISOString(),
         skills: [],
@@ -98,7 +98,7 @@ function createAgentManifest(agentName, configPath, version, cwd) {
     };
 }
 function packageAgent(agentName, configPath, version, cwd) {
-    const outputDir = join(cwd, ".strray", "publish", agentName);
+    const outputDir = join(cwd, ".xray", "publish", agentName);
     mkdirSync(outputDir, { recursive: true });
     const manifest = createAgentManifest(agentName, configPath, version, cwd);
     writeFileSync(join(outputDir, "agent.json"), JSON.stringify(manifest, null, 2));

package/dist/cli/commands/skill-install.js

@@ -2,7 +2,7 @@ import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync, cpSync
 import { join, basename, dirname } from "path";
 import { execSync } from "child_process";
 function getLocalRegistryPath() {
-    return join(process.cwd(), ".opencode", "strray", "skill-registry.json");
+    return join(process.cwd(), ".opencode", "xray", "skill-registry.json");
 }
 function getBundledRegistry() {
     const paths = [

package/dist/cli/commands/status.js

@@ -41,7 +41,7 @@ function getAgentsList(cwd) {
     ];
     const configuredAgents = [];
     const configDir = getConfigDir(cwd);
-    const agentsConfigPath = join(configDir, "strray", "agents.json");
+    const agentsConfigPath = join(configDir, "xray", "agents.json");
     if (existsSync(agentsConfigPath)) {
         try {
             const config = JSON.parse(readFileSync(agentsConfigPath, "utf-8"));
@@ -51,7 +51,7 @@ function getAgentsList(cwd) {
         }
         catch { /* ignore */ }
     }
-    const featuresPath = join(configDir, "strray", "features.json");
+    const featuresPath = join(configDir, "xray", "features.json");
     if (existsSync(featuresPath)) {
         try {
             const features = JSON.parse(readFileSync(featuresPath, "utf-8"));
@@ -93,7 +93,7 @@ function getInferenceStatus(cwd) {
     let outcomesCount = 0;
     let patternsCount = 0;
     try {
-        const inferenceDir = join(getConfigDir(cwd), "strray", "inference");
+        const inferenceDir = join(getConfigDir(cwd), "xray", "inference");
         const tunerStatusPath = join(inferenceDir, "tuner-status.json");
         if (existsSync(tunerStatusPath)) {
             const status = JSON.parse(readFileSync(tunerStatusPath, "utf-8"));

package/dist/cli/commands/storyteller.js

@@ -17,7 +17,7 @@ const STORY_TYPES = ["reflection", "saga", "journey", "narrative"];
 function loadConfig(cwd) {
     const candidates = [
         join(cwd, ".opencode", "strray", "features.json"),
-        join(cwd, ".strray", "features.json"),
+        join(cwd, ".xray", "features.json"),
     ];
     for (const path of candidates) {
         if (existsSync(path)) {

package/dist/cli/index.js

@@ -385,7 +385,7 @@ program
         const path = await import("path");
         let defaultLimit = 500;
         try {
-            const featuresPath = path.join(process.cwd(), ".opencode", "plugins", "features.json"); // plain xray primary (min compat .strray/ handled in getConfigDir per Scope Rule)
+            const featuresPath = path.join(process.cwd(), ".opencode", "plugins", "features.json"); // plain xray primary (min compat .xray/ handled in getConfigDir per Scope Rule)
             if (fs.existsSync(featuresPath)) {
                 const features = JSON.parse(fs.readFileSync(featuresPath, "utf-8"));
                 defaultLimit = features.analytics?.default_limit || 500;
@@ -450,16 +450,16 @@ program
         else {
             console.log("✅ xray package installed");
         }
-        // Check configuration - check for opencode.json or .strray/ (min compat .strray/ fallback for prior StringRay consumer runtime per Scope Rule; plain xray primary)
+        // Check configuration - check for opencode.json or .xray/ (min compat .xray/ fallback for prior 0xRay consumer runtime per Scope Rule; plain xray primary)
         const cwd = process.cwd();
         const opencodeConfigPath = path.join(cwd, "opencode.json");
         const strrayDir = getConfigDir(cwd);
         const opencodeExists = fs.existsSync(opencodeConfigPath);
-        const strrayDirExists = fs.existsSync(strrayDir);
+        const configDirExists = fs.existsSync(strrayDir);
         if (opencodeExists) {
             console.log("✅ opencode configuration found");
         }
-        else if (strrayDirExists) {
+        else if (configDirExists) {
             console.log(`✅ Configuration directory found: ${strrayDir}`);
         }
         else {
@@ -684,13 +684,13 @@ program
         }
         else {
             console.log('Inference feature is disabled in features.json.');
-            console.log('Enable it by setting inference.enabled = true in .opencode/plugins/features.json (min compat .strray/ fallback for prior StringRay consumer runtime per Scope Rule)');
+            console.log('Enable it by setting inference.enabled = true in .opencode/plugins/features.json (min compat .xray/ fallback for prior 0xRay consumer runtime per Scope Rule)');
         }
         return;
     }
     const projectRoot = process.cwd();
     const inferenceDir = `${projectRoot}/docs/inference`;
-    const stateDir = `${projectRoot}/.strray/inference`;
+    const stateDir = `${projectRoot}/.xray/inference`;
     const stateFile = `${stateDir}/inference-cycle-state.json`;
     if (!options.json) {
         console.log('xray Inference Cycle');

package/dist/cli/server.js

@@ -15,7 +15,7 @@ const packageJsonPath = join(ROOT_DIR, "package.json");
 const { version } = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
 const app = express();
 const PORT = 3000;
-const API_KEY = process.env.STRRAY_API_KEY || undefined;
+const API_KEY = process.env.XRAY_API_KEY || undefined;
 function timingSafeCompare(a, b) {
     const aBuf = Buffer.from(a, "utf-8");
     const bBuf = Buffer.from(b, "utf-8");
@@ -26,13 +26,13 @@ function timingSafeCompare(a, b) {
 function requireAuth(req, res, next) {
     if (!API_KEY) {
         frameworkLogger.log("cli-server", "auth-skipped", "warning", {
-            message: "No STRRAY_API_KEY set — API is unauthenticated. Set STRRAY_API_KEY in production.",
+            message: "No XRAY_API_KEY set — API is unauthenticated. Set XRAY_API_KEY in production.",
         });
         return next();
     }
     const providedKey = req.headers["x-api-key"];
     if (typeof providedKey !== "string") {
-        return res.status(401).json({ error: "API key required. Set STRRAY_API_KEY environment variable." });
+        return res.status(401).json({ error: "API key required. Set XRAY_API_KEY environment variable." });
     }
     if (!timingSafeCompare(providedKey, API_KEY)) {
         return res.status(403).json({ error: "Invalid API key" });
@@ -112,7 +112,7 @@ app.get("/", (req, res) => {
 });
 // Add route for refactoring logs
 app.get("/logs", requireAuth, async (req, res) => {
-    const logPath = resolveConfigPath("REFACTORING_LOG.md") || join(__dirname, "..", ".strray", "REFACTORING_LOG.md");
+    const logPath = resolveConfigPath("REFACTORING_LOG.md") || join(__dirname, "..", ".xray", "REFACTORING_LOG.md");
     // Server debug logging - remove for production
     try {
         if (fs.existsSync(logPath)) {

package/dist/core/boot-orchestrator.js

@@ -1,15 +1,15 @@
 /**
- * Boot Orchestrator (min documented consumer runtime compat shim from prior StringRay releases; primary Xray* paths + XRAY_||STRRAY_ env + .strray fallbacks only; 1-line per Scope Rule).
+ * Boot Orchestrator (min documented consumer runtime compat shim from prior 0xRay releases; primary Xray* paths + XRAY_||STRRAY_ env + .xray fallbacks only; 1-line per Scope Rule).
  */
-import { StringRayContextLoader } from "./context-loader.js";
-import { StringRayStateManager } from "../state/state-manager.js";
+import { XrayContextLoader } from "./context-loader.js";
+import { XrayStateManager } from "../state/state-manager.js";
 import { ProcessorManager } from "../processors/processor-manager.js";
 import { pathResolver } from "../utils/path-resolver.js";
 import * as fs from "fs";
 import * as path from "path";
 const { existsSync, readFileSync } = fs;
 // Path configuration - can be overridden by environment or use path resolver
-const AGENTS_BASE_PATH = process.env.STRRAY_AGENTS_PATH || "../agents";
+const AGENTS_BASE_PATH = process.env.XRAY_AGENTS_PATH || process.env.STRRAY_AGENTS_PATH || "../agents";
 import { createAgentDelegator, createSessionCoordinator, } from "../delegation/index.js";
 import { createSessionCleanupManager } from "../session/session-cleanup-manager.js";
 import { createSessionMonitor } from "../session/session-monitor.js";
@@ -30,10 +30,10 @@ import { initializeGovernanceIntegration } from "../integrations/governance/inde
  */
 function setupGracefulShutdown() {
     // Prevent duplicate listeners
-    if (process._strrayShutdownSetup) {
+    if (process._xrayShutdownSetup) {
         return;
     }
-    process._strrayShutdownSetup = true;
+    process._xrayShutdownSetup = true;
     let isShuttingDown = false;
     process.on("SIGINT", async () => {
         if (isShuttingDown) {
@@ -98,8 +98,8 @@ export class BootOrchestrator {
     shutdownInitialized = false;
     constructor(config = {}, stateManager) {
         // Initialize components first for state management
-        this.contextLoader = StringRayContextLoader.getInstance();
-        this.stateManager = stateManager || new StringRayStateManager();
+        this.contextLoader = XrayContextLoader.getInstance();
+        this.stateManager = stateManager || new XrayStateManager();
         this.processorManager = new ProcessorManager(this.stateManager);
         this.config = {
             enableEnforcement: true,
@@ -131,8 +131,8 @@ export class BootOrchestrator {
     loadProcessorsConfig() {
         try {
             const configPaths = [
-                path.join(process.cwd(), ".strray", "features.json"),
-                path.join(process.cwd(), ".opencode", "strray", "features.json"),
+                path.join(process.cwd(), ".xray", "features.json"),
+                path.join(process.cwd(), ".opencode", "xray", "features.json"),
             ];
             for (const configPath of configPaths) {
                 if (existsSync(configPath)) {
@@ -152,7 +152,7 @@ export class BootOrchestrator {
     async initializePluginSystem(jobId) {
         try {
             frameworkLogger.log("boot-orchestrator", "initializing plugin system", "info", { jobId });
-            const pluginsDir = path.join(process.cwd(), ".strray", "plugins");
+            const pluginsDir = path.join(process.cwd(), ".xray", "plugins");
             this.pluginRegistry = new PluginRegistry({
                 pluginsDir,
                 autoStart: true,
@@ -596,8 +596,8 @@ export class BootOrchestrator {
         };
         try {
             frameworkLogger.log("boot-orchestrator", "loading xray configuration", "info", { jobId });
-            // Consumer runtime compat shim from prior StringRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .strray fallbacks)
-            await this.loadStringRayConfiguration(jobId);
+            // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .xray fallbacks)
+            await this.loadXrayConfiguration(jobId);
             frameworkLogger.log("boot-orchestrator", "xray configuration loaded", "success", { jobId });
             // Phase 1: Initialize core systems
             frameworkLogger.log("boot-orchestrator", "initializing core systems", "info", { jobId });
@@ -727,11 +727,11 @@ export class BootOrchestrator {
         this.stateManager.set("boot:errors", result.errors);
         return result;
     }
-    // Consumer runtime compat shim from prior StringRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .strray fallbacks)
-    async loadStringRayConfiguration(jobId) {
+    // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .xray fallbacks)
+    async loadXrayConfiguration(jobId) {
         try {
-            // Consumer runtime compat shim from prior StringRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .strray fallbacks)
-            const stringRayConfig = {
+            // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .xray fallbacks)
+            const xrayConfig = {
                 version: "1.22.67",
                 codex_enabled: true,
                 codex_version: "v1.7.5",
@@ -793,13 +793,13 @@ export class BootOrchestrator {
                 },
             };
             // Store configuration in state manager for use by other components
-            this.stateManager.set("strray:config", stringRayConfig);
-            this.stateManager.set("strray:version", stringRayConfig.version);
-            this.stateManager.set("strray:codex_enabled", stringRayConfig.codex_enabled);
-            this.stateManager.set("strray:codex_terms", stringRayConfig.codex_terms);
-            this.stateManager.set("strray:monitoring_metrics", stringRayConfig.monitoring_metrics);
-            this.stateManager.set("strray:monitoring_alerts", stringRayConfig.monitoring_alerts);
-            this.stateManager.set("strray:agent_capabilities", stringRayConfig.agent_capabilities);
+            this.stateManager.set("xray:config", xrayConfig);
+            this.stateManager.set("xray:version", xrayConfig.version);
+            this.stateManager.set("xray:codex_enabled", xrayConfig.codex_enabled);
+            this.stateManager.set("xray:codex_terms", xrayConfig.codex_terms);
+            this.stateManager.set("xray:monitoring_metrics", xrayConfig.monitoring_metrics);
+            this.stateManager.set("xray:monitoring_alerts", xrayConfig.monitoring_alerts);
+            this.stateManager.set("xray:agent_capabilities", xrayConfig.agent_capabilities);
             await frameworkLogger.log("boot-orchestrator", "configuration-loaded", "success", { jobId });
         }
         catch (error) {

package/dist/core/bridge.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 /**
- * StringRay Universal Bridge
+ * 0xRay Universal Bridge
  *
- * Standalone bridge that provides StringRay framework capabilities
+ * Standalone bridge that provides 0xRay framework capabilities
  * to ANY consumer — no OpenCode dependency.
  *
  * Supports three transport modes:
@@ -74,7 +74,7 @@ function findProjectRoot() {
 
   const candidates = [
     process.cwd(),
-    join(homedir(), "dev", "stringray"),
+    join(homedir(), "dev", "xray"),
     join(dirname(__dirname), "..", ".."), // core/ -> project root
     join(dirname(__dirname), "..", "..", ".."), // integrations/ -> project root
   ];
@@ -84,7 +84,7 @@ function findProjectRoot() {
       const pkgPath = join(dir, "package.json");
       if (existsSync(pkgPath)) {
         const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-        if (pkg.name === "strray-ai" || pkg.dependencies?.["strray-ai"] || pkg.name === "0xray" || pkg.dependencies?.["0xray"]) {
+        if (pkg.name === "0xray" || pkg.dependencies?.["0xray"]) {
           return dir;
         }
       }
@@ -222,8 +222,8 @@ function getCodexCandidates(projectRoot) {
   const envDir = process.env.STRRAY_CONFIG_DIR;
   const candidates = [];
   if (envDir) candidates.push(join(projectRoot, envDir, "codex.json"));
-  candidates.push(join(projectRoot, ".strray", "codex.json"));
-  candidates.push(join(projectRoot, ".opencode", "strray", "codex.json"));
+  candidates.push(join(projectRoot, ".xray", "codex.json"));
+  candidates.push(join(projectRoot, ".opencode", "xray", "codex.json"));
   candidates.push(join(projectRoot, "codex.json"));
   return candidates;
 }
@@ -281,7 +281,7 @@ async function handleGetCodexPrompt(input, projectRoot, logDir) {
     terms.sort((a, b) => (severityOrder[a.severity] || 3) - (severityOrder[b.severity] || 3));
     if (maxTerms) terms = terms.slice(0, maxTerms);
 
-    const lines = [`## StringRay Universal Development Codex v${termsSource.version}`];
+    const lines = [`## 0xRay Universal Development Codex v${termsSource.version}`];
     const emojis = { blocking: "🔴", high: "🟡", medium: "🟢" };
     const labels = { blocking: "BLOCKING", high: "HIGH PRIORITY", medium: "MEDIUM" };
 
@@ -348,8 +348,8 @@ async function handleGetConfig(input, projectRoot, logDir) {
   // Load features.json
   const featurePaths = [];
   if (envDir) featurePaths.push(join(projectRoot, envDir, "features.json"));
-  featurePaths.push(join(projectRoot, ".strray", "features.json"));
-  featurePaths.push(join(projectRoot, ".opencode", "strray", "features.json"));
+  featurePaths.push(join(projectRoot, ".xray", "features.json"));
+  featurePaths.push(join(projectRoot, ".opencode", "xray", "features.json"));
 
   let featurePath = null;
   for (const p of featurePaths) {
@@ -604,7 +604,7 @@ function handleHooks(input, projectRoot) {
   const { action, hooks } = input;
   const hookTypes = hooks || ["pre-commit", "post-commit", "pre-push", "post-push"];
   const gitHooksDir = join(projectRoot, ".git", "hooks");
-  const strrayHooksDir = join(projectRoot, "hooks");
+  const xrayHooksDir = join(projectRoot, "hooks");
 
   if (!existsSync(gitHooksDir)) {
     return { error: "Not a git repository — no .git/hooks directory" };
@@ -616,14 +616,14 @@ function handleHooks(input, projectRoot) {
   if (action === "list" || action === "status") {
     for (const hookName of hookTypes) {
       const gitHook = join(gitHooksDir, hookName);
-      const strrayHook = join(strrayHooksDir, hookName);
+      const xrayHook = join(xrayHooksDir, hookName);
 
       if (!existsSync(gitHook)) {
         result.missing.push(hookName);
       } else {
         try {
           const content = readFileSync(gitHook, "utf-8");
-          if (content.includes("StringRay") || content.includes("strray") || content.includes("run-hook.js")) {
+          if (content.includes("0xRay") || content.includes("xray") || content.includes("run-hook.js")) {
             result.managed.push(hookName);
           } else {
             result.external.push(hookName);
@@ -633,8 +633,8 @@ function handleHooks(input, projectRoot) {
         }
       }
 
-      // Check if strray source hook exists
-      if (!existsSync(strrayHook)) {
+      // Check if xray source hook exists
+      if (!existsSync(xrayHook)) {
         result.stale.push(hookName);
       }
     }
@@ -644,7 +644,7 @@ function handleHooks(input, projectRoot) {
       action,
       hooks: result,
       gitHooksDir,
-      strrayHooksDir,
+      xrayHooksDir,
     };
   }
 
@@ -655,7 +655,7 @@ function handleHooks(input, projectRoot) {
     const errors = [];
 
     for (const hookName of hookTypes) {
-      const src = join(strrayHooksDir, hookName);
+      const src = join(xrayHooksDir, hookName);
       const dst = join(gitHooksDir, hookName);
 
       if (!existsSync(src)) {
@@ -664,11 +664,11 @@ function handleHooks(input, projectRoot) {
       }
 
       try {
-        // Backup existing non-strray hooks
+        // Backup existing non-xray hooks
         if (existsSync(dst)) {
           const content = readFileSync(dst, "utf-8");
-          if (!content.includes("StringRay") && !content.includes("strray") && !content.includes("run-hook.js")) {
-            renameSync(dst, `${dst}.strray-backup`);
+          if (!content.includes("0xRay") && !content.includes("xray") && !content.includes("run-hook.js")) {
+            renameSync(dst, `${dst}.xray-backup`);
           } else {
             unlinkSync(dst);
           }
@@ -699,15 +699,15 @@ function handleHooks(input, projectRoot) {
 
     for (const hookName of hookTypes) {
       const dst = join(gitHooksDir, hookName);
-      const backup = `${dst}.strray-backup`;
+      const backup = `${dst}.xray-backup`;
 
       if (!existsSync(dst)) continue;
 
       try {
         const content = readFileSync(dst, "utf-8");
-        const isStrray = content.includes("StringRay") || content.includes("strray") || content.includes("run-hook.js");
+        const isXray = content.includes("0xRay") || content.includes("xray") || content.includes("run-hook.js");
 
-        if (isStrray || lstatSync(dst).isSymbolicLink()) {
+        if (isXray || lstatSync(dst).isSymbolicLink()) {
           unlinkSync(dst);
 
           // Restore backup if exists

package/dist/core/codex-formatter.js

@@ -89,8 +89,8 @@ export function findCodexPath(projectRoot) {
     if (envDir) {
         candidates.push(resolve(root, envDir, "codex.json"));
     }
-    candidates.push(join(root, ".strray", "codex.json"));
-    candidates.push(join(root, ".opencode", "strray", "codex.json"));
+    candidates.push(join(root, ".xray", "codex.json"));
+    candidates.push(join(root, ".opencode", "xray", "codex.json"));
     // Additional fallback locations (for standalone usage)
     candidates.push(join(root, "codex.json"));
     candidates.push(join(root, "src", "codex.json"));