0xray 3.1.0 → 3.1.1

package/dist/README.md

@@ -1,6 +1,6 @@
 # xray — MCP-Centric AI Governance OS
 
-**v2.0.0** — 9 agents · 44 skills · 16 MCPs governance servers · 60 codex terms · 2,2527 tests
+**v2.0.0** — 9 agents · 44 skills · 1 MCPs governance servers · 60 codex terms · 2,2500 tests
 
 xray is the pure v2 three-subsystem AI orchestration framework, now **MCP-centric** with dedicated skill servers for governance deliberation:
 
@@ -32,7 +32,7 @@ The installation seeds YML surfaces and MCP servers. Place agent definitions in
 ├─────────────────────────────────────────────────┤
 │           External Governance (Dynamo)           │
 │  Codex enforcement · Resonance/Isotopic · SSOT  │
-│  16 MCPs skill servers deliberate proposals       │
+│  1 MCPs skill servers deliberate proposals       │
 ├─────────────────────────────────────────────────┤
 │          Autonomous Engine (thinDispatch)        │
 │  7-flow MCP · Delegation · Governance gate      │
@@ -94,21 +94,21 @@ Codex enforcement is integrated at every level:
 - **60 terms** across categories: core, architecture, testing, performance, security, operations, governance
 - CodexPolicyService — canonical Governance-owned SSOT for Codex loading
 - Pre-governance gate blocks non-compliant proposals before execution
-- 16 MCPs skill servers deliberate each proposal
+- 1 MCPs skill servers deliberate each proposal
 - frameworkLogger structured logging throughout (never console.*)
 - Active codex snapshot available via `get_active_codex` MCP tool
 
-## Testing (2,2527 tests)
+## Testing (2,2500 tests)
 
 | Suite | Status |
 |-------|--------|
 | Unit / Integration | 158 files, all pass |
-| Performance | 2527 tests, all pass |
-| Infrastructure | 2527 tests, all pass |
+| Performance | 2500 tests, all pass |
+| Infrastructure | 2500 tests, all pass |
 | Consumer E2E | 4 platforms, all pass |
 | OpenCode E2E | 42/42 solo, 34/34 orchestrator, all pass |
-| OpenClaw E2E | 2527 tests, all pass |
-| Hermes E2E | 2527 tests, all pass |
+| OpenClaw E2E | 2500 tests, all pass |
+| Hermes E2E | 2500 tests, all pass |
 | Grok CLI E2E | 60/60 solo, 59/59 orchestrator, all pass |
 
 ## Release

package/dist/SKILLS.md

@@ -0,0 +1,140 @@
+# 0xray Skills
+
+xray ships **46 skills** that provide domain expertise across the full software lifecycle. Skills are loaded on demand and invoked via MCP servers, agents, or direct API.
+
+---
+
+## Governance & Compliance
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `code-review` | @code-reviewer | Proposal quality, code analysis, best practices |
+| `security-audit` | @security-auditor | Vulnerability detection, threat modeling |
+| `security-scan` | — | Security vulnerability scanning and assessment |
+| `enforcer` | @enforcer | Codex compliance validation and error prevention |
+| `framework-compliance-audit` | — | Framework compliance auditing and validation |
+
+## Architecture & Design
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `architect-tools` | — | System design and technical architecture tools |
+| `architecture-patterns` | — | Software architecture patterns and best practices |
+| `api-design` | — | RESTful API design and validation |
+| `database-engineer` | — | SQL/NoSQL schema design, query optimization, migrations |
+| `state-manager` | — | Application state management and persistence |
+| `session-management` | — | Manage user sessions and persistent state |
+
+## Engineering
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `backend-engineer` | — | REST/GraphQL APIs, microservices, auth, server architecture |
+| `frontend-engineer` | — | React/Vue/Angular/Svelte, responsive design, accessibility |
+| `frontend-ui-ux-engineer` | — | Visual design, CSS systems, accessibility, UX |
+| `mobile-developer` | — | iOS (Swift/SwiftUI), Android (Kotlin/Compose), RN, Flutter |
+| `devops-engineer` | — | CI/CD, IaaC, containers, cloud deployment, reliability |
+
+## Code Quality & Analysis
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `code-analyzer` | — | Deep code analysis, metrics extraction, pattern detection |
+| `project-analysis` | — | Analyze project structure, complexity, and health metrics |
+| `lint` | — | Code linting and static analysis |
+| `auto-format` | — | Automated code formatting and style consistency |
+| `refactoring-strategies` | @refactorer | Code refactoring techniques and strategies |
+
+## Testing
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `testing-strategy` | @testing-lead | Comprehensive testing strategies and coverage |
+| `testing-best-practices` | — | Testing best practices and patterns |
+
+## Performance
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `performance-analysis` | — | System performance analysis and optimization |
+| `performance-engineer` | — | Profiling, benchmarking, load testing, optimization |
+| `performance-optimization` | — | Application performance optimization and tuning |
+
+## Debugging & Monitoring
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `bug-triage` | @bug-triage-specialist | Bug triage, debugging analysis, issue prioritization |
+| `log-monitor` | — | Log analysis, pattern detection, alerting |
+| `model-health-check` | — | AI model health monitoring and diagnostics |
+
+## Orchestration & Workflow
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `orchestrator` | @orchestrator | Multi-agent workflow coordination and task delegation |
+| `xray-orchestrator` | — | Main orchestration skill for xray agents |
+| `processor-pipeline` | — | Data processing pipeline management |
+| `boot-orchestrator` | — | Framework initialization and boot orchestration |
+
+## Research & Content
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `researcher` | @researcher | Codebase exploration, implementation lookup |
+| `content-creator` | — | Marketing copy, technical docs, blog posts, social media |
+| `tech-writer` | — | API docs, READMEs, ADRs, changelogs, DX |
+| `storyteller` | — | Deep narrative reflections, sagas, technical stories |
+| `seo-consultant` | — | Technical SEO, schema markup, Core Web Vitals |
+| `growth-strategist` | — | Campaign strategy, market analysis, brand positioning |
+
+## UX & Design
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `ui-ux-design` | — | Mobile-first, cognitive simplicity, accessibility-first |
+| `multimodal-looker` | — | Visual content analysis for diagrams, screenshots, UI mockups |
+
+## Strategy
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `strategist` | @strategist | Strategic guidance, architectural decisions, risk analysis |
+| `inference-improve` | — | Autonomous inference improvement through collaborative analysis |
+
+## Git & Workflow
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `git-workflow` | — | Git workflow management and collaboration tools |
+
+## Integration
+
+| Skill | Agent | Description |
+|-------|-------|-------------|
+| `hermes-agent` | — | Manage xray from Hermes Agent via native plugin |
+
+---
+
+## Invoking Skills
+
+Skills are invoked automatically by agents or via MCP:
+
+```bash
+# Via agent mention (in any chat)
+@code-reviewer review this PR
+
+# Via MCP tool call
+npx xray mcp call code-review analyze_code_quality --args '{"path": "src/"}' 
+
+# Via direct agent
+npx xray agent run @refactorer "optimize src/core/"
+```
+
+## Skill Locations
+
+Each skill has a `SKILL.md` with full reference:
+
+- **Source**: `src/skills/<name>/SKILL.md`
+- **Consumer**: `node_modules/0xray/dist/skills/<name>/SKILL.md`
+- **Opend**: `.opencode/skills/<name>/SKILL.md` (copied on `npx xray setup`)

package/dist/agents/index.js

@@ -19,6 +19,7 @@ import { performanceEngineer } from "./performance-engineer.js";
 import { seoConsultant } from "./seo-consultant.js";
 import { strategist } from "./strategist.js";
 import { techWriter } from "./tech-writer.js";
+import { multimodalLooker } from "./multimodal-looker.js";
 export const builtinAgents = {
     architect,
     "bug-triage-specialist": bugTriageSpecialist,
@@ -41,5 +42,6 @@ export const builtinAgents = {
     "seo-consultant": seoConsultant,
     strategist,
     "tech-writer": techWriter,
+    "multimodal-looker": multimodalLooker,
 };
-export { architect, bugTriageSpecialist, codeReviewer, securityAuditor, refactorer, testingLead, logMonitor, researcher, codeAnalyzer, backendEngineer, contentCreator, databaseEngineer, devopsEngineer, frontendEngineer, frontendUiUxEngineer, growthStrategist, mobileDeveloper, performanceEngineer, seoConsultant, strategist, techWriter, };
+export { architect, bugTriageSpecialist, codeReviewer, securityAuditor, refactorer, testingLead, logMonitor, researcher, codeAnalyzer, backendEngineer, contentCreator, databaseEngineer, devopsEngineer, frontendEngineer, frontendUiUxEngineer, growthStrategist, mobileDeveloper, performanceEngineer, seoConsultant, strategist, techWriter, multimodalLooker, };

package/dist/agents/registry.js

@@ -285,6 +285,19 @@ export const AGENT_REGISTRY = {
         performance: 85,
         expertise: "technical documentation and writing",
     },
+    "multimodal-looker": {
+        name: "multimodal-looker",
+        description: "Visual content analysis for images, diagrams, PDFs, and screenshots",
+        capabilities: ["visual-analysis", "image-processing", "document-analysis", "multimodal-data-processing"],
+        capacity: 60,
+        specialties: ["image", "visual", "diagram", "screenshot", "pdf"],
+        mode: "subagent",
+        maxComplexity: 35,
+        concurrentTasks: 2,
+        status: "active",
+        performance: 80,
+        expertise: "multimodal content analysis and interpretation",
+    },
 };
 export function getActiveAgents() {
     return Object.values(AGENT_REGISTRY)

package/dist/analytics/routing-refiner.js

@@ -36,7 +36,7 @@ class RoutingRefiner {
         const optimizations = this.suggestMappingOptimizations(promptAnalysis, performanceReport);
         const warnings = this.generateWarnings(newMappings, optimizations);
         return {
-            version: "1.22.67",
+            version: "3.1.0",
             generatedAt: new Date(),
             summary: {
                 newMappings: newMappings.length,

package/dist/architect/architectural-integrity.js

@@ -20,17 +20,17 @@ export async function verifyArchitecturalIntegrity() {
     const issues = [];
     const recommendations = [];
     // Check state manager
-    const stateManager = globalThis.strRayStateManager;
+    const stateManager = globalThis.xrayStateManager;
     if (!stateManager) {
         issues.push("State manager not initialized");
         recommendations.push("Ensure boot orchestrator runs before framework activation");
     }
-    const postProcessor = globalThis.strRayPostProcessor;
+    const postProcessor = globalThis.xrayPostProcessor;
     if (!postProcessor) {
         issues.push("Post-processor not activated");
         recommendations.push("Add post-processor activation to xray-activation.ts");
     }
-    const codexInjector = globalThis.strRayCodexInjector;
+    const codexInjector = globalThis.xrayCodexInjector;
     if (!codexInjector) {
         issues.push("Codex injector not initialized");
         recommendations.push("Ensure codex injection is active in plugin context");

package/dist/benchmark/performance-benchmark.js

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

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/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,13 @@ async function installForOpencode(options = {}) {
         }
         copyDir(opencodeSource, opencodeDest);
         frameworkLogger.log('opencode-integration', 'opencode-copied', 'info', { destination: opencodeDest });
+        // 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/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

@@ -26,6 +26,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() };
 }

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

@@ -453,14 +453,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 +865,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 +888,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,8 +9,8 @@
  * - 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
@@ -21,7 +21,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 +184,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/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: