0xray 3.1.0 → 3.2.0

package/dist/cli/commands/antigravity-status.js

@@ -10,30 +10,30 @@ import { join } from "path";
 import { getConfigDir } from "../../core/config-paths.js";
 function getSkillsFromSkills(cwd) {
     const skills = [];
-    const skillsPath = join(getConfigDir(cwd), "skills");
-    if (!existsSync(skillsPath)) {
-        return skills;
-    }
-    const dirs = readdirSync(skillsPath).filter((f) => {
-        const skillPath = join(skillsPath, f, "SKILL.md");
-        return existsSync(skillPath);
-    });
-    for (const dir of dirs) {
-        const skillPath = join(skillsPath, dir, "SKILL.md");
-        const content = readFileSync(skillPath, "utf-8");
-        const sourceMatch = content.match(/^source:\s*(.+)/m);
-        const sourceNameMatch = content.match(/^source_name:\s*(.+)/m);
-        const licenseMatch = content.match(/License:\s*(.+)/m);
-        const rawName = dir.includes("--") ? dir.split("--").slice(1).join("--") : dir;
-        const communitySource = sourceNameMatch ? sourceNameMatch[1].trim() : null;
-        skills.push({
-            name: rawName,
-            source: sourceMatch && sourceMatch[1] ? sourceMatch[1].trim() : "custom",
-            communitySource,
-            license: licenseMatch ? licenseMatch[1].trim() : "unknown",
-            category: extractCategory(content),
-            path: skillPath,
+    for (const skillsPath of [join(getConfigDir(cwd), "skills"), join(cwd, ".opencode", "skills")]) {
+        if (!existsSync(skillsPath))
+            continue;
+        const dirs = readdirSync(skillsPath).filter((f) => {
+            const skillPath = join(skillsPath, f, "SKILL.md");
+            return existsSync(skillPath);
         });
+        for (const dir of dirs) {
+            const skillPath = join(skillsPath, dir, "SKILL.md");
+            const content = readFileSync(skillPath, "utf-8");
+            const sourceMatch = content.match(/^source:\s*(.+)/m);
+            const sourceNameMatch = content.match(/^source_name:\s*(.+)/m);
+            const licenseMatch = content.match(/License:\s*(.+)/m);
+            const rawName = dir.includes("--") ? dir.split("--").slice(1).join("--") : dir;
+            const communitySource = sourceNameMatch ? sourceNameMatch[1].trim() : null;
+            skills.push({
+                name: rawName,
+                source: sourceMatch && sourceMatch[1] ? sourceMatch[1].trim() : "custom",
+                communitySource,
+                license: licenseMatch ? licenseMatch[1].trim() : "unknown",
+                category: extractCategory(content),
+                path: skillPath,
+            });
+        }
     }
     return skills;
 }

package/dist/cli/commands/archive-logs.js

@@ -5,7 +5,6 @@
  * Archives log files without requiring framework boot.
  * Used by git hooks to prevent log truncation.
  *
- * @version 1.0.0
  */
 import * as fs from "fs";
 import * as path from "path";

package/dist/cli/commands/credible-init.js

@@ -60,7 +60,7 @@ function showNotImplemented() {
     console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
     console.log("");
     console.log("💡 To be notified when this feature is available:");
-    console.log("   Track the evolution spec at docs/roadmap/STRINGRAY_EVOLUTION_SPEC.md");
+    console.log("   Track the evolution spec at docs/roadmap/XRAY_EVOLUTION_SPEC.md");
     console.log("");
     console.log("🔜 Roadmap: Phase 3 (Polishing & Release)");
     console.log("");

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

@@ -2,6 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import { homedir } from 'os';
 import { frameworkLogger } from '../../core/framework-logger.js';
+import { syncBuiltinSkills } from './skill-install.js';
 const __dirname = path.dirname(new URL(import.meta.url).pathname);
 export function registerHermesCommands(hermesCmd) {
     hermesCmd
@@ -49,6 +50,13 @@ async function installForHermes(options = {}) {
         }
         frameworkLogger.log('hermes-integration', 'plugin-copied', 'info', { destination: targetPluginDir });
         console.log(`\x1b[32m✓ Copied Hermes plugin to ${targetPluginDir}\x1b[0m`);
+        // Sync builtin skills to Hermes plugin skills dir
+        const hermesSkillsDir = path.join(targetPluginDir, 'skills');
+        const skillsCopied = syncBuiltinSkills(hermesSkillsDir);
+        if (skillsCopied > 0) {
+            console.log(`\x1b[32m✓ Synced ${skillsCopied} builtin skills to Hermes plugin\x1b[0m`);
+        }
+        frameworkLogger.log('hermes-integration', 'skills-synced', 'info', { count: skillsCopied });
         // Write after-install instructions
         const afterInstallPath = path.join(targetPluginDir, 'after-install.md');
         if (fs.existsSync(afterInstallPath)) {

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", "xray", "mcp-registry.json");
+    return join(process.cwd(), ".xray", "mcp-registry.json");
 }
 function getBundledMCPRegistry() {
     const paths = [

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

@@ -1,6 +1,8 @@
 import fs from 'fs';
 import path from 'path';
+import { homedir } from 'os';
 import { frameworkLogger } from '../../core/framework-logger.js';
+import { syncBuiltinSkills } from './skill-install.js';
 import { OpenClawConfigLoader } from '../../integrations/openclaw/config.js';
 export function registerOpenClawCommands(openclawCmd) {
     openclawCmd
@@ -29,6 +31,13 @@ async function installForOpenClaw(options = {}) {
         loader.createSampleConfig();
         const relative = path.relative(process.cwd(), configPath);
         console.log(`\x1b[32m✓ Created OpenClaw config at ${relative}\x1b[0m`);
+        // Sync builtin skills to ~/.openclaw/skills/
+        const openclawSkillsDir = path.join(homedir(), '.openclaw', 'skills');
+        const skillsCopied = syncBuiltinSkills(openclawSkillsDir);
+        if (skillsCopied > 0) {
+            console.log(`\x1b[32m✓ Synced ${skillsCopied} builtin skills to ~/.openclaw/skills/\x1b[0m`);
+        }
+        frameworkLogger.log('openclaw-integration', 'skills-synced', 'info', { count: skillsCopied });
         console.log('\n✅ 0xRay OpenClaw integration configured!');
         console.log('Edit the config file to set your gateway URL, auth token, and device ID.');
         console.log('');

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

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import { frameworkLogger } from '../../core/framework-logger.js';
+import { syncBuiltinSkills } from './skill-install.js';
 const __dirname = path.dirname(new URL(import.meta.url).pathname);
 export function registerOpencodeCommands(opencodeCmd) {
     opencodeCmd
@@ -80,6 +81,20 @@ async function installForOpencode(options = {}) {
         return;
     }
     try {
+        // Auto-create package.json if missing (OpenCode requires it)
+        const consumerPkgPath = path.join(process.cwd(), 'package.json');
+        if (!fs.existsSync(consumerPkgPath)) {
+            const pkg = {
+                name: path.basename(process.cwd()),
+                version: '1.0.0',
+                private: true,
+                dependencies: {
+                    '0xray': '*',
+                },
+            };
+            fs.writeFileSync(consumerPkgPath, JSON.stringify(pkg, null, 2) + '\n');
+            console.log(`\x1b[32m✓ Created package.json with 0xray dependency\x1b[0m`);
+        }
         if (fs.existsSync(opencodeDest) && !options.force) {
             console.log('[Opencode] .opencode/ directory already exists.');
             console.log('Use --force to reinstall.');
@@ -87,6 +102,26 @@ async function installForOpencode(options = {}) {
         }
         copyDir(opencodeSource, opencodeDest);
         frameworkLogger.log('opencode-integration', 'opencode-copied', 'info', { destination: opencodeDest });
+        // Copy plugin from dist/ to .opencode/plugin/
+        const pluginSource = path.join(__dirname, '..', '..', '..', 'dist', 'plugin', 'xray-codex-injection.js');
+        const pluginDest = path.join(opencodeDest, 'plugin', 'xray-codex-injection.js');
+        if (fs.existsSync(pluginSource)) {
+            const pluginDestDir = path.dirname(pluginDest);
+            if (!fs.existsSync(pluginDestDir))
+                fs.mkdirSync(pluginDestDir, { recursive: true });
+            fs.copyFileSync(pluginSource, pluginDest);
+            console.log(`\x1b[32m✓ Copied plugin to .opencode/plugin/\x1b[0m`);
+        }
+        else {
+            console.log('ℹ️  Plugin source not found (build may be needed)');
+        }
+        // Sync builtin skills to .opencode/skills/
+        const opencodeSkillsDir = path.join(opencodeDest, 'skills');
+        const skillsCopied = syncBuiltinSkills(opencodeSkillsDir);
+        if (skillsCopied > 0) {
+            console.log(`\x1b[32m✓ Synced ${skillsCopied} builtin skills to .opencode/skills/\x1b[0m`);
+        }
+        frameworkLogger.log('opencode-integration', 'skills-synced', 'info', { count: skillsCopied });
         console.log(`\x1b[32m✓ Copied OpenCode config to .opencode/\x1b[0m`);
         console.log('\n✅ 0xRay OpenCode plugin installed!');
         console.log('Restart OpenCode or run `opencode` to load the plugin.');

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

@@ -9,7 +9,6 @@
  * - plugin status
  * - plugin uninstall
  *
- * @version 1.1.0
  */
 import * as fs from "fs";
 import * as path from "path";

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

@@ -1,8 +1,9 @@
-import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync, cpSync, rmSync, statSync, unlinkSync } from "fs";
+import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync, cpSync, rmSync, statSync, unlinkSync, copyFileSync } from "fs";
 import { join, basename, dirname } from "path";
+import { fileURLToPath } from "url";
 import { execSync } from "child_process";
 function getLocalRegistryPath() {
-    return join(process.cwd(), ".opencode", "xray", "skill-registry.json");
+    return join(process.cwd(), ".xray", "skill-registry.json");
 }
 function getBundledRegistry() {
     const paths = [
@@ -479,3 +480,39 @@ export async function skillRegistryCommand(action, args) {
     console.log(`  Unknown action: ${action}`);
     console.log("  Usage: npx 0xray skill:registry [list|add|remove]");
 }
+// ── Cross-platform builtin skill sync ────────────────────────────────
+// Each platform's install command calls this to copy framework skills.
+export function syncBuiltinSkills(targetSkillsDir, packageRoot) {
+    const root = packageRoot ?? join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+    const candidateDirs = [
+        join(root, "dist", "skills"),
+        join(root, "src", "skills"),
+    ];
+    const sourceDir = candidateDirs.find(existsSync);
+    if (!sourceDir)
+        return 0;
+    let copied = 0;
+    try {
+        if (!existsSync(targetSkillsDir))
+            mkdirSync(targetSkillsDir, { recursive: true });
+        for (const entry of readdirSync(sourceDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const skillMd = join(sourceDir, entry.name, "SKILL.md");
+            if (!existsSync(skillMd))
+                continue;
+            const destMd = join(targetSkillsDir, entry.name, "SKILL.md");
+            const destDir = dirname(destMd);
+            if (!existsSync(destDir))
+                mkdirSync(destDir, { recursive: true });
+            if (existsSync(destMd) && statSync(skillMd).mtime <= statSync(destMd).mtime)
+                continue;
+            copyFileSync(skillMd, destMd);
+            copied++;
+        }
+    }
+    catch {
+        // best-effort
+    }
+    return copied;
+}

package/dist/cli/commands/status.js

@@ -13,6 +13,7 @@
 import { readdirSync, existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { getConfigDir } from "../../core/config-paths.js";
+import { featuresConfigLoader } from "../../core/features-config.js";
 function getSkillsList(cwd) {
     const skills = [];
     const configDir = getConfigDir(cwd);
@@ -26,6 +27,11 @@ function getSkillsList(cwd) {
         const skillDirs = readdirSync(skillsPath).filter((f) => existsSync(join(skillsPath, f, "SKILL.md")));
         skills.push(...skillDirs);
     }
+    const opencodeSkillsPath = join(cwd, ".opencode", "skills");
+    if (existsSync(opencodeSkillsPath)) {
+        const skillDirs = readdirSync(opencodeSkillsPath).filter((f) => existsSync(join(opencodeSkillsPath, f, "SKILL.md")));
+        skills.push(...skillDirs);
+    }
     const uniqueSkills = [...new Set(skills)];
     return { count: uniqueSkills.length, names: uniqueSkills.sort() };
 }
@@ -51,21 +57,18 @@ function getAgentsList(cwd) {
         }
         catch { /* ignore */ }
     }
-    const featuresPath = join(configDir, "xray", "features.json");
-    if (existsSync(featuresPath)) {
-        try {
-            const features = JSON.parse(readFileSync(featuresPath, "utf-8"));
-            if (features.agent_management?.disabled_agents) {
-                const disabled = features.agent_management.disabled_agents;
-                agentsFromSkills.forEach((agent) => {
-                    if (!disabled.includes(agent) && !configuredAgents.includes(agent)) {
-                        configuredAgents.push(agent);
-                    }
-                });
-            }
+    try {
+        const features = featuresConfigLoader.loadConfig();
+        if (features.agent_management?.disabled_agents) {
+            const disabled = features.agent_management.disabled_agents;
+            agentsFromSkills.forEach((agent) => {
+                if (!disabled.includes(agent) && !configuredAgents.includes(agent)) {
+                    configuredAgents.push(agent);
+                }
+            });
         }
-        catch { /* ignore */ }
     }
+    catch { /* ignore */ }
     if (configuredAgents.length === 0) {
         configuredAgents.push(...agentsFromSkills);
     }

package/dist/cli/commands/storyteller.js

@@ -16,8 +16,8 @@ import { execSync } from "child_process";
 const STORY_TYPES = ["reflection", "saga", "journey", "narrative"];
 function loadConfig(cwd) {
     const candidates = [
-        join(cwd, ".opencode", "strray", "features.json"),
         join(cwd, ".xray", "features.json"),
+        join(cwd, ".opencode", "xray", "features.json"),
     ];
     for (const path of candidates) {
         if (existsSync(path)) {

package/dist/cli/index.js

@@ -381,15 +381,10 @@ program
         // Dynamic import to avoid loading analytics module unless needed
         const { SimplePatternAnalyzer } = await import("../analytics/simple-pattern-analyzer.js");
         // Get default limit from features.json
-        const fs = await import("fs");
-        const path = await import("path");
         let defaultLimit = 500;
         try {
-            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;
-            }
+            const { featuresConfigLoader } = await import("../core/features-config.js");
+            defaultLimit = featuresConfigLoader.loadConfig().analytics?.default_limit ?? 500;
         }
         catch { /* use default */ }
         const analyzer = new SimplePatternAnalyzer();
@@ -453,14 +448,14 @@ program
         // 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 xrayDir = getConfigDir(cwd);
         const opencodeExists = fs.existsSync(opencodeConfigPath);
-        const configDirExists = fs.existsSync(strrayDir);
+        const configDirExists = fs.existsSync(xrayDir);
         if (opencodeExists) {
             console.log("✅ opencode configuration found");
         }
         else if (configDirExists) {
-            console.log(`✅ Configuration directory found: ${strrayDir}`);
+            console.log(`✅ Configuration directory found: ${xrayDir}`);
         }
         else {
             console.log("ℹ️  No opencode.json or config directory found (run: npx xray fix to create)");
@@ -865,15 +860,20 @@ program
 program
     .command('mcp')
     .description('Run an MCP server subprocess (used by Grok/OpenCode .mcp.json)')
-    .argument('<server>', 'Server name: governance or skills')
+    .argument('<server>', 'Server name: governance, skills, researcher, code-review, architect-tools, enforcer, orchestrator')
     .action(async (server) => {
     const serverMap = {
         governance: 'dist/mcps/governance.server.js',
         skills: 'dist/mcps/knowledge-skills/skill-invocation.server.js',
+        researcher: 'dist/mcps/researcher.server.js',
+        'code-review': 'dist/mcps/knowledge-skills/code-review.server.js',
+        'architect-tools': 'dist/mcps/architect-tools.server.js',
+        enforcer: 'dist/mcps/enforcer-tools.server.js',
+        orchestrator: 'dist/mcps/orchestrator.server.js',
     };
     const relPath = serverMap[server];
     if (!relPath) {
-        console.error(`Unknown MCP server: ${server}. Use: governance, skills`);
+        console.error(`Unknown MCP server: ${server}. Use: governance, skills, researcher, code-review, architect-tools, enforcer, orchestrator`);
         process.exit(1);
     }
     const serverPath = resolve(join(packageRoot, relPath));
@@ -883,7 +883,8 @@ program
     }
     const env = { ...process.env };
     if (server === 'governance') {
-        env.STRRAY_FORCE_MCP_GOVERNANCE = 'true';
+        env.XRAY_FORCE_MCP_GOVERNANCE = 'true';
+        env.XRAY_FORCE_MCP_GOVERNANCE = 'true';
     }
     const child = spawn(process.execPath, [serverPath], { stdio: 'inherit', env });
     child.on('exit', (code) => process.exit(code ?? 0));

package/dist/core/activity-logger.js

@@ -9,11 +9,10 @@
  * - Test results
  *
  * Enable/Disable via:
- *   STRRAY_ACTIVITY_LOGGING=true  (enable)
- *   STRRAY_ACTIVITY_LOGGING=false (disable, default)
+ *   XRAY_ACTIVITY_LOGGING=true  (enable)
+ *   XRAY_ACTIVITY_LOGGING=false (disable, default)
  *
  * @module core/activity-logger
- * @version 1.0.0
  */
 import * as fs from "fs";
 import * as path from "path";
@@ -21,7 +20,7 @@ import * as zlib from "zlib";
 import { frameworkLogger } from "./framework-logger.js";
 const MAX_LOG_SIZE_BYTES = 5 * 1024 * 1024; // 5MB before rotation
 // Global state
-let activityLoggerEnabled = process.env.STRRAY_ACTIVITY_LOGGING !== "false";
+let activityLoggerEnabled = process.env.XRAY_ACTIVITY_LOGGING !== "false";
 let activityLogPath;
 let sessionId;
 let sessionStartTime;
@@ -184,7 +183,7 @@ export function logActivity(category, level, action, message, details, options)
     // Write to report JSON
     writeToReportFile(record);
     // Console output for debug mode
-    if (process.env.STRRAY_ACTIVITY_CONSOLE === "true") {
+    if (process.env.XRAY_ACTIVITY_CONSOLE === "true") {
         frameworkLogger.log("activity-logger", "console-output", "info", { message: `[${record.timestamp}] [${record.category}] ${level.toUpperCase()}: ${message}`, details: details || "" });
     }
 }

package/dist/core/adaptive-kernel.js

@@ -4,7 +4,6 @@
  * Composes with existing Kernel to add self-modifying pattern learning capabilities.
  * Enables continuous pattern improvement based on performance data.
  *
- * @version 1.0.0
  * @since 2026-03-05
  */
 import { getKernel } from "../core/kernel-patterns.js";

package/dist/core/agent-spawn-gate.js

@@ -1,7 +1,7 @@
 /**
  * Agent Spawn Gate — Singleton (provider-agnostic)
  *
- * CENTRALIZED CONTROL for all agent process spawning across StringRay
+ * CENTRALIZED CONTROL for all agent process spawning across 0xRay
  * (OpenCode, Hermes, or any other MCP-compatible host).
  *
  * Purpose:

package/dist/core/boot-orchestrator.js

@@ -1,15 +1,13 @@
 /**
- * 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).
+ * Boot Orchestrator (min documented consumer runtime compat shim from prior 0xRay releases; primary Xray paths + .xray fallbacks only; 1-line per Scope Rule).
  */
 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.XRAY_AGENTS_PATH || process.env.STRRAY_AGENTS_PATH || "../agents";
+const AGENTS_BASE_PATH = process.env.XRAY_AGENTS_PATH || process.env.XRAY_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";
@@ -20,7 +18,7 @@ import { frameworkLogger } from "../core/framework-logger.js";
 import { featuresConfigLoader } from "../core/features-config.js";
 import { memoryMonitor } from "../monitoring/memory-monitor.js";
 import { advancedProfiler } from "../monitoring/advanced-profiler.js";
-import { strRayConfigLoader } from "./config-loader.js";
+import { xrayConfigLoader } from "./config-loader.js";
 import { PluginRegistry } from "../integrations/plugins/index.js";
 import { PluginServerConfigRegistry } from "../mcps/config/index.js";
 import { initializeGovernanceIntegration } from "../integrations/governance/index.js";
@@ -47,7 +45,7 @@ function setupGracefulShutdown() {
         }
         catch (error) {
             // Suppress error output in CLI mode to avoid breaking interface
-            if (process.env.STRRAY_CLI_MODE !== "true" &&
+            if (process.env.XRAY_CLI_MODE !== "true" &&
                 process.env.OPENCODE_CLI !== "true") {
                 frameworkLogger.log("boot-orchestrator", "shutdown-error", "error", { error, message: "Error during graceful shutdown" });
             }
@@ -69,7 +67,7 @@ function setupGracefulShutdown() {
     // Handle uncaught exceptions that might cause JSON parsing errors
     process.on("uncaughtException", (error) => {
         // Suppress error output in CLI mode to avoid breaking interface
-        if (process.env.STRRAY_CLI_MODE !== "true" &&
+        if (process.env.XRAY_CLI_MODE !== "true" &&
             process.env.OPENCODE_CLI !== "true") {
             frameworkLogger.log("boot-orchestrator", "uncaught-exception", "error", { error, message: "Uncaught Exception" });
         }
@@ -79,7 +77,7 @@ function setupGracefulShutdown() {
     });
     process.on("unhandledRejection", (reason, promise) => {
         // Suppress error output in CLI mode to avoid breaking interface
-        if (process.env.STRRAY_CLI_MODE !== "true" &&
+        if (process.env.XRAY_CLI_MODE !== "true" &&
             process.env.OPENCODE_CLI !== "true") {
             frameworkLogger.log("boot-orchestrator", "unhandled-rejection", "error", { promise, reason, message: "Unhandled Rejection" });
         }
@@ -115,7 +113,7 @@ export class BootOrchestrator {
      */
     async initializeDelegationSystem() {
         try {
-            const agentDelegator = createAgentDelegator(this.stateManager, strRayConfigLoader);
+            const agentDelegator = createAgentDelegator(this.stateManager, xrayConfigLoader);
             this.stateManager.set("delegation:agent_delegator", agentDelegator);
             const sessionCoordinator = createSessionCoordinator(this.stateManager);
             this.stateManager.set("delegation:session_coordinator", sessionCoordinator);
@@ -130,19 +128,10 @@ export class BootOrchestrator {
     }
     loadProcessorsConfig() {
         try {
-            const configPaths = [
-                path.join(process.cwd(), ".xray", "features.json"),
-                path.join(process.cwd(), ".opencode", "xray", "features.json"),
-            ];
-            for (const configPath of configPaths) {
-                if (existsSync(configPath)) {
-                    const config = JSON.parse(readFileSync(configPath, "utf-8"));
-                    return config.processors || null;
-                }
-            }
+            return featuresConfigLoader.loadConfig().processors ?? null;
         }
         catch {
-            // ignore - use defaults
+            // use defaults
         }
         return null;
     }
@@ -189,7 +178,7 @@ export class BootOrchestrator {
                 });
                 return false;
             }
-            const orchestratorInstance = orchestratorModule.strRayOrchestrator;
+            const orchestratorInstance = orchestratorModule.xrayOrchestrator;
             if (!orchestratorInstance) {
                 frameworkLogger.log("boot-orchestrator", "orchestrator-not-found", "error", { message: "Orchestrator instance not found in module" });
                 return false;
@@ -596,7 +585,7 @@ export class BootOrchestrator {
         };
         try {
             frameworkLogger.log("boot-orchestrator", "loading xray configuration", "info", { jobId });
-            // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .xray fallbacks)
+            // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + .xray fallbacks)
             await this.loadXrayConfiguration(jobId);
             frameworkLogger.log("boot-orchestrator", "xray configuration loaded", "success", { jobId });
             // Phase 1: Initialize core systems
@@ -727,12 +716,12 @@ export class BootOrchestrator {
         this.stateManager.set("boot:errors", result.errors);
         return result;
     }
-    // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .xray fallbacks)
+    // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + .xray fallbacks)
     async loadXrayConfiguration(jobId) {
         try {
-            // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .xray fallbacks)
+            // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + .xray fallbacks)
             const xrayConfig = {
-                version: "1.22.67",
+                version: "3.1.0",
                 codex_enabled: true,
                 codex_version: "v1.7.5",
                 codex_terms: [

package/dist/core/bridge.mjs

@@ -33,7 +33,6 @@
  *   node bridge.mjs --http --port 18431 --cwd /path
  *   curl -X POST http://localhost:18431 -d '{"command":"get-codex-prompt"}'
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 
@@ -69,7 +68,7 @@ let frameworkLoadAttempted = false;
 // ============================================================================
 
 function findProjectRoot() {
-  const envHome = process.env.STRRAY_HOME;
+  const envHome = process.env.XRAY_HOME;
   if (envHome && existsSync(join(envHome, "package.json"))) return envHome;
 
   const candidates = [
@@ -219,7 +218,7 @@ async function handleHealth(input) {
  */
 /** Codex candidate paths — single source of truth for both loadCodexFromFs and handleGetConfig */
 function getCodexCandidates(projectRoot) {
-  const envDir = process.env.STRRAY_CONFIG_DIR;
+  const envDir = process.env.XRAY_CONFIG_DIR;
   const candidates = [];
   if (envDir) candidates.push(join(projectRoot, envDir, "codex.json"));
   candidates.push(join(projectRoot, ".xray", "codex.json"));
@@ -747,8 +746,8 @@ function startHttpServer(port, projectRoot) {
 
   return new Promise((resolve, reject) => {
     const server = createServer(async (req, res) => {
-      // CORS headers (wildcard — restrict via STRRAY_HTTP_CORS_ORIGIN env var in production)
-      const corsOrigin = process.env.STRRAY_HTTP_CORS_ORIGIN || "*";
+      // CORS headers (wildcard — restrict via XRAY_HTTP_CORS_ORIGIN env var in production)
+      const corsOrigin = process.env.XRAY_HTTP_CORS_ORIGIN || "*";
       res.setHeader("Content-Type", "application/json");
       res.setHeader("Access-Control-Allow-Origin", corsOrigin);
       res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");

package/dist/core/codex-formatter.js

@@ -13,7 +13,6 @@
  *   const prompt = formatCodexPrompt({ projectRoot: '/path' });
  *   // Append to system prompt
  *
- * @version 1.0.0
  * @since 2026-03-28
  */
 import { readFileSync, existsSync } from "fs";
@@ -84,13 +83,12 @@ export const BUILTIN_CODEX = {
  */
 export function findCodexPath(projectRoot) {
     const root = projectRoot || process.cwd();
-    const envDir = process.env.STRRAY_CONFIG_DIR;
+    const envDir = process.env.XRAY_CONFIG_DIR;
     const candidates = [];
     if (envDir) {
         candidates.push(resolve(root, envDir, "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"));

package/dist/core/codex-injector.js

@@ -4,7 +4,6 @@
  * Injects Universal Development Codex v1.2.0 context into agent operations.
  * Follows production-tested pattern from rules-injector.
  *
- * @version 1.0.0
  * @since 2026-01-06
  */
 import * as fs from "fs";
@@ -38,7 +37,7 @@ async function initializeImports() {
 const codexCache = new Map();
 /**
  * Codex file locations resolved through the standard priority chain.
- * Uses config-paths.ts resolver so STRRAY_CONFIG_DIR and .xray/ work.
+ * Uses config-paths.ts resolver so XRAY_CONFIG_DIR and .xray/ work.
  */
 function getCodexFileLocations(projectRoot) {
     const root = projectRoot || process.cwd();
@@ -170,7 +169,7 @@ export function createXrayCodexInjectorHook() {
                     });
                     // Skip codex enforcement during testing
                     if (process.env.NODE_ENV === "test" ||
-                        process.env.STRRAY_TEST_MODE === "true") {
+                        process.env.XRAY_TEST_MODE === "true") {
                         await frameworkLogger.log("codex-injector", "skipping enforcement in test mode", "info", { jobId });
                         return;
                     }
@@ -263,7 +262,7 @@ export function createXrayCodexInjectorHook() {
                     frameworkLogger.log("codex-injector", "tool.execute.after hook triggered", "info", { jobId, tool: input.tool, sessionId });
                     // Skip codex enforcement during testing
                     if (process.env.NODE_ENV === "test" ||
-                        process.env.STRRAY_TEST_MODE === "true") {
+                        process.env.XRAY_TEST_MODE === "true") {
                         frameworkLogger.log("codex-injector", "skipping injection in test mode", "info", { jobId });
                         return output;
                     }