0xray 3.0.14 → 3.1.1

package/dist/CHANGELOG.md

@@ -4,6 +4,40 @@ 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.1] - 2026-06-16
+
+### 🔄 Changes
+
+### ✨ Features
+- feat: add root .mcp.json and .grok-plugin/plugin.json for marketplace discovery (f8d084cc0)
+- feat: ship .gitignore.default template + SKILLS.md to consumers via postinstall (44bba8c4c)
+
+### 🐛 Bug Fixes
+- fix: restore .mcp.json (deleted by test writing to same path) (e22202cfc)
+- fix: support mcpServers format in ConfigLoader, fix tests for real .mcp.json (a930aa034)
+- fix: add missing fs imports, process.argv[1]! assertions, and vitest v4 config (0dffc5683)
+- fix: remove .opencode/xray/ fallback from auto-reflection-generator.mjs (de7633152)
+- fix: Railway deployment - MCP host, in-process skills, Hermes OAuth decode, OAuth daemon mode (a519338c3)
+- fix: pre-publish-guard handles missing features.json (855e3cfdb)
+
+### ♻️ Refactoring
+- refactor: complete StringRay→0xRay rename, archive cleanup, skill syncing, MCP tools (d78bc3763)
+
+### 🔎 Other Changes
+- Revert "Add marketplace files: .grok-plugin/plugin.json and .mcp.json for xAI plugin catalog" (05feb6fba)
+- Add marketplace files: .grok-plugin/plugin.json and .mcp.json for xAI plugin catalog (5824d5776)
+
+---
+
+## [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/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 StrRay Framework Team
+Copyright (c) 2026 Xray Framework Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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,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)
+// 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 StringRayPerformanceBenchmark {
+export class XrayPerformanceBenchmark {
     results = [];
     activeBenchmarks = new Map();
     /**
@@ -369,4 +369,5 @@ export class StringRayPerformanceBenchmark {
     }
 }
 // Export singleton instance
-export const performanceBenchmark = new StringRayPerformanceBenchmark();
+export const performanceBenchmark = new XrayPerformanceBenchmark();
+// Backward compat alias

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
@@ -16,14 +17,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 +33,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;
         }
@@ -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)) {
@@ -56,7 +64,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(), ".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
@@ -14,7 +16,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;
@@ -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/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

@@ -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", "strray", "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;
+}