0xray 3.0.12 → 3.0.14

package/dist/mcps/shared/knowledge-skill-base.js

@@ -43,4 +43,3 @@ export class XrayKnowledgeSkillBase {
         await frameworkLogger.log(serverName, "server-started", "success");
     }
 }
-//# sourceMappingURL=knowledge-skill-base.js.map

package/dist/mcps/shared/prompt-security-validator.js

@@ -146,4 +146,3 @@ export class PromptSecurityValidator {
 }
 // Export singleton instance
 export const promptSecurityValidator = new PromptSecurityValidator();
-//# sourceMappingURL=prompt-security-validator.js.map

package/dist/mcps/shared/security-scanner.js

@@ -427,4 +427,3 @@ export class SecurityScanner {
 }
 // Export singleton instance
 export const securityScanner = new SecurityScanner();
-//# sourceMappingURL=security-scanner.js.map

package/dist/mcps/simulation/index.js

@@ -10,4 +10,3 @@
  */
 export { SimulationEngine } from './simulation-engine.js';
 export { getAllServerSimulations, codeReviewSimulations, securityAuditSimulations, performanceOptimizationSimulations, testingStrategySimulations, researcherSimulations, frameworkHelpSimulations, skillInvocationSimulations, } from './server-simulations.js';
-//# sourceMappingURL=index.js.map

package/dist/mcps/simulation/server-simulations.js

@@ -73,13 +73,13 @@ export const researcherSimulations = {
  * Framework Help server simulations
  */
 export const frameworkHelpSimulations = {
-    xray_get_capabilities: () => ({
+    strray_get_capabilities: () => ({
         content: [
             {
                 type: 'text',
                 text: `**0xRay Framework Capabilities:**
 
-**41 Specialized Agents:**
+**42 Specialized Agents:**
 - enforcer: Codex compliance & error prevention
 - architect: System design & technical decisions
 - orchestrator: Multi-agent workflow coordination
@@ -104,7 +104,7 @@ export const frameworkHelpSimulations = {
             },
         ],
     }),
-    xray_get_commands: () => ({
+    strray_get_commands: () => ({
         content: [
             {
                 type: 'text',
@@ -131,7 +131,7 @@ framework-reporting-system - Generate comprehensive framework reports
             },
         ],
     }),
-    xray_explain_capability: () => ({
+    strray_explain_capability: () => ({
         content: [
             {
                 type: 'text',
@@ -217,4 +217,3 @@ export function getAllServerSimulations() {
         'skill-invocation': skillInvocationSimulations,
     };
 }
-//# sourceMappingURL=server-simulations.js.map

package/dist/mcps/simulation/simulation-engine.js

@@ -94,4 +94,3 @@ export class SimulationEngine {
         return count;
     }
 }
-//# sourceMappingURL=simulation-engine.js.map

package/dist/mcps/state-manager.server.js

@@ -3,128 +3,25 @@
  *
  * Advanced state management with persistence, synchronization, and conflict resolution
  */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import fs from "fs";
 import path from "path";
 import { frameworkLogger, generateJobId } from "../core/framework-logger.js";
-import { XrayKnowledgeSkillBase } from "./shared/knowledge-skill-base.js";
-class StrRayStateManagerServer extends XrayKnowledgeSkillBase {
+class StrRayStateManagerServer {
+    server;
     state = new Map();
     stateFile;
     backups = new Map();
     constructor() {
-        super("state-manager", "2.0.1");
-        this.tools = [
-            {
-                name: "get-state",
-                description: "Get state value by key with type safety and validation",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        key: { type: "string" },
-                        defaultValue: {
-                            oneOf: [
-                                { type: "string" },
-                                { type: "number" },
-                                { type: "boolean" },
-                                { type: "object" },
-                                { type: "array" },
-                            ],
-                        },
-                        validate: { type: "boolean", default: true },
-                    },
-                    required: ["key"],
-                },
-            },
-            {
-                name: "set-state",
-                description: "Set state value by key with conflict resolution and persistence",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        key: { type: "string" },
-                        value: {
-                            oneOf: [
-                                { type: "string" },
-                                { type: "number" },
-                                { type: "boolean" },
-                                { type: "object" },
-                                { type: "array" },
-                            ],
-                        },
-                        persist: { type: "boolean", default: true },
-                        backup: { type: "boolean", default: false },
-                    },
-                    required: ["key", "value"],
-                },
-            },
-            {
-                name: "delete-state",
-                description: "Delete state value by key with cleanup and validation",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        key: { type: "string" },
-                        force: { type: "boolean", default: false },
-                    },
-                    required: ["key"],
-                },
-            },
-            {
-                name: "list-state",
-                description: "List all state keys with filtering and metadata",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        prefix: { type: "string" },
-                        includeValues: { type: "boolean", default: false },
-                        limit: { type: "number", default: 100 },
-                    },
-                },
-            },
-            {
-                name: "backup-state",
-                description: "Create backup of current state or specific keys",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        keys: { type: "array", items: { type: "string" } },
-                        name: { type: "string" },
-                    },
-                },
-            },
-            {
-                name: "restore-state",
-                description: "Restore state from backup",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        name: { type: "string" },
-                        keys: { type: "array", items: { type: "string" } },
-                    },
-                    required: ["name"],
-                },
+        this.server = new Server({
+            name: "state-manager", version: "1.22.67",
+        }, {
+            capabilities: {
+                tools: {},
             },
-            {
-                name: "validate-state",
-                description: "Validate state integrity and consistency",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        deep: { type: "boolean", default: false },
-                        repair: { type: "boolean", default: false },
-                    },
-                },
-            },
-        ];
-        this.handlers = {
-            "get-state": async (args) => this.handleGetState(args),
-            "set-state": async (args) => this.handleSetState(args),
-            "delete-state": async (args) => this.handleDeleteState(args),
-            "list-state": async (args) => this.handleListState(args),
-            "backup-state": async (args) => this.handleBackupState(args),
-            "restore-state": async (args) => this.handleRestoreState(args),
-            "validate-state": async (args) => this.handleValidateState(args),
-        };
+        });
         this.stateFile = path.join(process.cwd(), ".opencode", "state", "mcp-state.json");
         this.ensureStateDirectory();
         this.loadState();
@@ -164,6 +61,148 @@ class StrRayStateManagerServer extends XrayKnowledgeSkillBase {
             throw error;
         }
     }
+    setupToolHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    {
+                        name: "get-state",
+                        description: "Get state value by key with type safety and validation",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                key: { type: "string" },
+                                defaultValue: {
+                                    oneOf: [
+                                        { type: "string" },
+                                        { type: "number" },
+                                        { type: "boolean" },
+                                        { type: "object" },
+                                        { type: "array" },
+                                    ],
+                                },
+                                validate: { type: "boolean", default: true },
+                            },
+                            required: ["key"],
+                        },
+                    },
+                    {
+                        name: "set-state",
+                        description: "Set state value by key with conflict resolution and persistence",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                key: { type: "string" },
+                                value: {
+                                    oneOf: [
+                                        { type: "string" },
+                                        { type: "number" },
+                                        { type: "boolean" },
+                                        { type: "object" },
+                                        { type: "array" },
+                                    ],
+                                },
+                                persist: { type: "boolean", default: true },
+                                backup: { type: "boolean", default: false },
+                            },
+                            required: ["key", "value"],
+                        },
+                    },
+                    {
+                        name: "delete-state",
+                        description: "Delete state value by key with cleanup and validation",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                key: { type: "string" },
+                                force: { type: "boolean", default: false },
+                            },
+                            required: ["key"],
+                        },
+                    },
+                    {
+                        name: "list-state",
+                        description: "List all state keys with filtering and metadata",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                prefix: { type: "string" },
+                                includeValues: { type: "boolean", default: false },
+                                limit: { type: "number", default: 100 },
+                            },
+                        },
+                    },
+                    {
+                        name: "backup-state",
+                        description: "Create backup of current state or specific keys",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                keys: { type: "array", items: { type: "string" } },
+                                name: { type: "string" },
+                            },
+                        },
+                    },
+                    {
+                        name: "restore-state",
+                        description: "Restore state from backup",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                name: { type: "string" },
+                                keys: { type: "array", items: { type: "string" } },
+                            },
+                            required: ["name"],
+                        },
+                    },
+                    {
+                        name: "validate-state",
+                        description: "Validate state integrity and consistency",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                deep: { type: "boolean", default: false },
+                                repair: { type: "boolean", default: false },
+                            },
+                        },
+                    },
+                ],
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            try {
+                const { name, arguments: args } = request.params;
+                switch (name) {
+                    case "get-state":
+                        return await this.handleGetState(args);
+                    case "set-state":
+                        return await this.handleSetState(args);
+                    case "delete-state":
+                        return await this.handleDeleteState(args);
+                    case "list-state":
+                        return await this.handleListState(args);
+                    case "backup-state":
+                        return await this.handleBackupState(args);
+                    case "restore-state":
+                        return await this.handleRestoreState(args);
+                    case "validate-state":
+                        return await this.handleValidateState(args);
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Error handling tool '${request.params.name}': ${error instanceof Error ? error.message : String(error)}`,
+                        }],
+                };
+            }
+        });
+    }
     async handleGetState(args) {
         const key = args.key;
         const defaultValue = args.defaultValue;
@@ -583,11 +622,16 @@ ${results.repairedKeys.length > 0 ? `**Repaired Keys:**\n${results.repairedKeys.
         }
         return dependents;
     }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        const jobId = generateJobId("mcp-state-manager-start");
+        frameworkLogger.log("mcps/state-manager", "start", "success", {}, undefined, jobId);
+    }
 }
 // Start the server if run directly
 if (import.meta.url === `file://${process.argv[1]}`) {
     const server = new StrRayStateManagerServer();
-    server.run("state-manager").catch((error) => frameworkLogger.log("mcps/state-manager", "run", "error", { error: String(error) }));
+    server.run().catch((error) => frameworkLogger.log("mcps/state-manager", "run", "error", { error: String(error) }));
 }
 export { StrRayStateManagerServer };
-//# sourceMappingURL=state-manager.server.js.map

package/dist/mcps/tools/index.js

@@ -12,4 +12,3 @@ export { ToolRegistry } from './tool-registry.js';
 export { ToolDiscovery } from './tool-discovery.js';
 export { ToolExecutor } from './tool-executor.js';
 export { ToolCache } from './tool-cache.js';
-//# sourceMappingURL=index.js.map

package/dist/mcps/tools/tool-cache.js

@@ -110,4 +110,3 @@ export class ToolCache {
         }
     }
 }
-//# sourceMappingURL=tool-cache.js.map

package/dist/mcps/tools/tool-discovery.js

@@ -63,4 +63,3 @@ export class ToolDiscovery {
             t.inputSchema !== null);
     }
 }
-//# sourceMappingURL=tool-discovery.js.map

package/dist/mcps/tools/tool-executor.js

@@ -73,4 +73,3 @@ export class ToolExecutor {
         this.requestId = 0;
     }
 }
-//# sourceMappingURL=tool-executor.js.map

package/dist/mcps/tools/tool-registry.js

@@ -65,4 +65,3 @@ export class ToolRegistry {
         return count;
     }
 }
-//# sourceMappingURL=tool-registry.js.map

package/dist/mcps/types/index.js

@@ -13,4 +13,3 @@
 export * from './mcp.types.js';
 // JSON-RPC Protocol Types
 export * from './json-rpc.types.js';
-//# sourceMappingURL=index.js.map

package/dist/mcps/types/json-rpc.types.js

@@ -5,4 +5,3 @@
  * Used for MCP server communication.
  */
 export {};
-//# sourceMappingURL=json-rpc.types.js.map

package/dist/mcps/types/mcp.types.js

@@ -5,4 +5,3 @@
  * Extracted from mcp-client.ts as part of Phase 1 refactoring.
  */
 export {};
-//# sourceMappingURL=mcp.types.js.map

package/dist/metrics/agent-metrics.js

@@ -1,4 +1,4 @@
-// Consumer runtime compat shim (primary xray paths)
+// 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";
 const DEFAULT_RETENTION_CONFIG = {
     maxEntries: 10000,
@@ -572,4 +572,3 @@ export function resetAgentMetricsSystem() {
         globalMetricsSystem = null;
     }
 }
-//# sourceMappingURL=agent-metrics.js.map

package/dist/metrics/index.js

@@ -4,4 +4,3 @@
  * Re-exports all metrics-related functionality from the Agent Metrics System.
  */
 export { AgentMetricsSystem, getAgentMetricsSystem, initializeAgentMetrics, resetAgentMetricsSystem, } from "./agent-metrics.js";
-//# sourceMappingURL=index.js.map

package/dist/monitoring/advanced-profiler.js

@@ -230,4 +230,3 @@ export class AdvancedProfiler extends EventEmitter {
     }
 }
 export const advancedProfiler = new AdvancedProfiler();
-//# sourceMappingURL=advanced-profiler.js.map

package/dist/monitoring/memory-monitor.js

@@ -313,4 +313,3 @@ export function checkMemoryHealth() {
         issues,
     };
 }
-//# sourceMappingURL=memory-monitor.js.map

package/dist/monitoring/nudge-watchdog.js

@@ -354,4 +354,3 @@ export function getNudgeWatchdog() {
 export function recordProcessorFix(filePath, fixed, errorPersisted) {
     nudgeWatchdog.recordProcessorFix(filePath, fixed, errorPersisted);
 }
-//# sourceMappingURL=nudge-watchdog.js.map

package/dist/monitoring/test-auto-generation-monitor.js

@@ -155,4 +155,3 @@ if (process.argv[1] &&
         message: testAutoGenerationMonitor.generateReport(),
     });
 }
-//# sourceMappingURL=test-auto-generation-monitor.js.map

package/dist/nucleus/default-plugins.js

@@ -8,6 +8,18 @@
  */
 import { frameworkLogger } from '../core/framework-logger.js';
 import { pluginRegistry } from './plugin-registry.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+const origSetRequestHandler = Server.prototype.setRequestHandler;
+Server.prototype.setRequestHandler = function (schema, handler) {
+    if (schema === ListToolsRequestSchema) {
+        this.__xrayListToolsHandler = handler;
+    }
+    if (schema === CallToolRequestSchema) {
+        this.__xrayCallToolHandler = handler;
+    }
+    return origSetRequestHandler.call(this, schema, handler);
+};
 // ── Named exports (17 servers) ──────────────────────────────────────────────
 import { XrayCodeReviewServer } from '../mcps/knowledge-skills/code-review.server.js';
 import { XraySecurityAuditServer } from '../mcps/knowledge-skills/security-audit.server.js';
@@ -36,15 +48,36 @@ import SessionManagementServer from '../mcps/knowledge-skills/session-management
 import XrayApiDesignServer from '../mcps/knowledge-skills/api-design.server.js';
 import XrayGitWorkflowServer from '../mcps/knowledge-skills/git-workflow.server.js';
 import XrayArchitecturePatternsServer from '../mcps/knowledge-skills/architecture-patterns.server.js';
-// ── Helpers ─────────────────────────────────────────────────────────────────
-/**
- * Extract tools and handler dispatch from a server instance.
- * Protected members are accessed via any-cast (contained compromise).
- */
-function toServerDescriptor(instance, serverName) {
+// ── Named exports (additional servers) ──────────────────────────────────────
+import { XrayTestingBestPracticesServer } from '../mcps/knowledge-skills/testing-best-practices.server.js';
+async function toServerDescriptor(instance, serverName) {
     const srv = instance;
     const tools = srv.tools ?? [];
     const handlers = srv.handlers ?? {};
+    // Try captured handlers from the inner MCP Server instance
+    const mcp = srv.server;
+    const listHandler = mcp?.__xrayListToolsHandler ?? srv.__xrayListToolsHandler;
+    const callHandler = mcp?.__xrayCallToolHandler ?? srv.__xrayCallToolHandler;
+    if (tools.length === 0 && listHandler) {
+        try {
+            const listResult = await listHandler();
+            if (listResult?.tools?.length) {
+                return {
+                    name: serverName,
+                    tools: listResult.tools,
+                    callTool: async (toolName, args) => {
+                        if (!callHandler) {
+                            throw new Error(`Unknown tool '${toolName}' on server '${serverName}'`);
+                        }
+                        return callHandler({ params: { name: toolName, arguments: args } });
+                    },
+                };
+            }
+        }
+        catch {
+            // fall through to default
+        }
+    }
     return {
         name: serverName,
         tools,
@@ -57,10 +90,10 @@ function toServerDescriptor(instance, serverName) {
         },
     };
 }
-function registerOne(label, create, serverName) {
+async function registerOne(label, create, serverName) {
     try {
         const instance = create();
-        const descriptor = toServerDescriptor(instance, serverName);
+        const descriptor = await toServerDescriptor(instance, serverName);
         pluginRegistry.registerServer(descriptor);
         frameworkLogger.log('default-plugins', `register-${label}`, 'info', { serverName });
         return true;
@@ -74,10 +107,10 @@ function registerOne(label, create, serverName) {
     }
 }
 // ── Batches ─────────────────────────────────────────────────────────────────
-function registerBatch(tag, servers) {
+async function registerBatch(tag, servers) {
     let count = 0;
     for (const s of servers) {
-        if (registerOne(s.label, s.create, s.serverName)) {
+        if (await registerOne(s.label, s.create, s.serverName)) {
             count++;
         }
     }
@@ -91,16 +124,16 @@ function registerBatch(tag, servers) {
  * Register all knowledge-skill servers as SkillToolPlugins.
  * Called once at boot. Returns counts of registered and failed servers.
  */
-export function registerDefaultPlugins() {
+export async function registerDefaultPlugins() {
     const failed = [];
     // ── Batch 1: Governance-critical (priority) ──
-    const batch1Count = registerBatch('governance', [
+    const batch1Count = await registerBatch('governance', [
         { label: 'code-review', create: () => new XrayCodeReviewServer(), serverName: 'code-review' },
         { label: 'security-audit', create: () => new XraySecurityAuditServer(), serverName: 'security-audit' },
         { label: 'researcher', create: () => new XrayLibrarianServer(), serverName: 'researcher' },
     ]);
     // ── Batch 2: Design & Architecture ──
-    const batch2Count = registerBatch('design-architecture', [
+    const batch2Count = await registerBatch('design-architecture', [
         { label: 'api-design', create: () => new XrayApiDesignServer(), serverName: 'api-design' },
         { label: 'architecture-patterns', create: () => new XrayArchitecturePatternsServer(), serverName: 'architecture-patterns' },
         { label: 'database-design', create: () => new XrayDatabaseDesignServer(), serverName: 'database-design' },
@@ -108,7 +141,7 @@ export function registerDefaultPlugins() {
         { label: 'ui-ux-design', create: () => new XrayUIUXDesignServer(), serverName: 'ui-ux-design' },
     ]);
     // ── Batch 3: Analysis & Quality ──
-    const batch3Count = registerBatch('analysis-quality', [
+    const batch3Count = await registerBatch('analysis-quality', [
         { label: 'code-analyzer', create: () => new CodeAnalyzerServer(), serverName: 'code-analyzer' },
         { label: 'performance-optimization', create: () => new XrayPerformanceOptimizationServer(), serverName: 'performance-optimization' },
         { label: 'project-analysis', create: () => new ProjectAnalysisServer(), serverName: 'project-analysis' },
@@ -116,7 +149,7 @@ export function registerDefaultPlugins() {
         { label: 'testing-strategy', create: () => new XrayTestingStrategyServer(), serverName: 'testing-strategy' },
     ]);
     // ── Batch 4: Operations & Workflow ──
-    const batch4Count = registerBatch('operations-workflow', [
+    const batch4Count = await registerBatch('operations-workflow', [
         { label: 'devops-deployment', create: () => new XrayDevOpsDeploymentServer(), serverName: 'devops-deployment' },
         { label: 'git-workflow', create: () => new XrayGitWorkflowServer(), serverName: 'git-workflow' },
         { label: 'log-monitor', create: () => new LogMonitorServer(), serverName: 'log-monitor' },
@@ -124,7 +157,7 @@ export function registerDefaultPlugins() {
         { label: 'strategist', create: () => new StrategistServer(), serverName: 'xray/strategist' },
     ]);
     // ── Batch 5: Content & Growth ──
-    const batch5Count = registerBatch('content-growth', [
+    const batch5Count = await registerBatch('content-growth', [
         { label: 'content-creator', create: () => new SEOCopywriterServer(), serverName: 'content-creator' },
         { label: 'growth-strategist', create: () => new MarketingExpertServer(), serverName: 'growth-strategist' },
         { label: 'multimodal-looker', create: () => new MultimodalLookerServer(), serverName: 'multimodal-looker' },
@@ -132,9 +165,10 @@ export function registerDefaultPlugins() {
         { label: 'documentation-generation', create: () => new XrayDocumentationGenerationServer(), serverName: 'documentation-generation' },
     ]);
     // ── Batch 6: Specialized ──
-    const batch6Count = registerBatch('specialized', [
+    const batch6Count = await registerBatch('specialized', [
         { label: 'bug-triage-specialist', create: () => new BugTriageSpecialistServer(), serverName: 'bug-triage-specialist' },
         { label: 'skill-invocation', create: () => new SkillInvocationServer(), serverName: 'xray/skill-invocation' },
+        { label: 'testing-best-practices', create: () => new XrayTestingBestPracticesServer(), serverName: 'testing-best-practices' },
     ]);
     const registered = batch1Count + batch2Count + batch3Count + batch4Count + batch5Count + batch6Count;
     frameworkLogger.log('default-plugins', 'register-default-plugins-complete', 'info', {
@@ -143,4 +177,3 @@ export function registerDefaultPlugins() {
     });
     return { registered, failed };
 }
-//# sourceMappingURL=default-plugins.js.map

package/dist/nucleus/govern-http.js

@@ -173,4 +173,3 @@ if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith
     });
 }
 /* c8 ignore stop */
-//# sourceMappingURL=govern-http.js.map

package/dist/nucleus/index.js

@@ -10,4 +10,3 @@ export { NucleusOrchestrator } from './orchestrator.js';
 export { scoreComplexity, routeToAgent, scoreAndRoute } from './thin-dispatch.js';
 export { NUCLEUS_THIN_DISPATCH_VERSION } from './thin-dispatch.js';
 export { registerDefaultPlugins } from './default-plugins.js';
-//# sourceMappingURL=index.js.map

package/dist/nucleus/kernel.js

@@ -60,4 +60,3 @@ export async function governSingle(proposal, context, options) {
     };
     return handleGovernRequest(fullRequest);
 }
-//# sourceMappingURL=kernel.js.map