0xray 3.1.1 → 3.3.0

package/src/mcps/state-manager.server.ts

@@ -4,13 +4,11 @@
  * 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,
   type CallToolResult,
 } from "@modelcontextprotocol/sdk/types.js";
+import { XrayKnowledgeSkillBase } from "./shared/knowledge-skill-base.js";
 import fs from "fs";
 import path from "path";
 import { frameworkLogger, generateJobId } from "../core/framework-logger.js";
@@ -62,23 +60,13 @@ interface ValidationResult {
 
 type StateValue = string | number | boolean | object | null | undefined;
 
-class XrayStateManagerServer {
-  private server: Server;
+class XrayStateManagerServer extends XrayKnowledgeSkillBase {
   private state: Map<string, unknown> = new Map();
   private stateFile: string;
   private backups: Map<string, unknown> = new Map();
 
   constructor() {
-    this.server = new Server(
-      {
-        name: "state-manager", version: "3.1.0",
-      },
-      {
-        capabilities: {
-          tools: {},
-        },
-      },
-    );
+    super("state-manager", "3.1.0");
 
     this.stateFile = path.join(
       process.cwd(),
@@ -89,6 +77,123 @@ class XrayStateManagerServer {
     this.ensureStateDirectory();
     this.loadState();
 
+    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"],
+        },
+      },
+      {
+        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 as unknown as GetStateArgs),
+      "set-state": async (args) => this.handleSetState(args as unknown as SetStateArgs),
+      "delete-state": async (args) => this.handleDeleteState(args as unknown as DeleteStateArgs),
+      "list-state": async (args) => this.handleListState(args as unknown as ListStateArgs),
+      "backup-state": async (args) => this.handleBackupState(args as unknown as BackupStateArgs),
+      "restore-state": async (args) => this.handleRestoreState(args as unknown as RestoreStateArgs),
+      "validate-state": async (args) => this.handleValidateState(args as unknown as ValidateStateArgs),
+    };
+
     this.setupToolHandlers();
     const jobId = generateJobId("mcp-state-manager-init");
     frameworkLogger.log(
@@ -151,149 +256,17 @@ class XrayStateManagerServer {
     }
   }
 
-  private 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): Promise<CallToolResult> => {
+  override setupToolHandlers(): void {
+    this.setupListToolsHandler();
+    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      const { name, arguments: args } = request.params;
+      const handler = this.handlers[name];
+      if (!handler) throw new Error(`Unknown tool: ${name}`);
       try {
-        const { name, arguments: args } = request.params;
-
-        switch (name) {
-          case "get-state":
-            return await this.handleGetState(args as unknown as GetStateArgs);
-          case "set-state":
-            return await this.handleSetState(args as unknown as SetStateArgs);
-          case "delete-state":
-            return await this.handleDeleteState(args as unknown as DeleteStateArgs);
-          case "list-state":
-            return await this.handleListState(args as unknown as ListStateArgs);
-          case "backup-state":
-            return await this.handleBackupState(args as unknown as BackupStateArgs);
-          case "restore-state":
-            return await this.handleRestoreState(args as unknown as RestoreStateArgs);
-          case "validate-state":
-            return await this.handleValidateState(args as unknown as ValidateStateArgs);
-          default:
-            throw new Error(`Unknown tool: ${name}`);
-        }
+        return await handler(args);
       } catch (error) {
-        return {
-          content: [{
-            type: "text" as const,
-            text: `Error handling tool '${request.params.name}': ${error instanceof Error ? error.message : String(error)}`,
-          }],
-        };
+        frameworkLogger.log("mcps/state-manager", "tool", "error", { tool: name, error: String(error) });
+        throw error;
       }
     });
   }
@@ -753,19 +726,6 @@ ${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

package/src/opencode/codex.codex

@@ -1,5 +1,5 @@
 {
-  "version": "3.1.0",
+  "version": "3.3.0",
   "terms": [
     1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60
   ],

package/src/opencode/commands/auto-format.md

@@ -5,11 +5,11 @@ description: Automated code formatting hook with Prettier and framework-specific
 
 #!/bin/bash
 
-# xray 2.0 - Auto Format Hook
+# xray - Auto Format Hook
 
 # Ensures consistent code formatting across all files
 
-echo "🎨 xray 2.0 - Auto Format"
+echo "🎨 xray - Auto Format"
 echo "================================================"
 
 # Initialize status
@@ -91,7 +91,7 @@ fi
 if [ "$FORMATTED" = true ]; then
 echo ""
 echo "✅ Code formatting completed successfully"
-echo "🎯 xray 2.0: FORMATTING OPERATIONAL"
+echo "🎯 xray: FORMATTING OPERATIONAL"
 else
 echo ""
 echo "⚠️ Some formatting operations failed"

package/src/opencode/commands/auto-summary-capture.md

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# xray 2.0 - Auto Summary Capture
+# xray - Auto Summary Capture
 
 # Monitors for 'job done print summary' signal and automatically logs summaries
 
@@ -40,7 +40,7 @@
 
 # 🚨 VIOLATION OF THIS RULE WILL BREAK THE PROJECT'S HISTORICAL RECORD 🚨
 
-echo "📝 xray 2.0 - Auto Summary Capture"
+echo "📝 xray - Auto Summary Capture"
 echo "======================================"
 echo "Monitoring for 'job done print summary' signals..."
 echo "All AI-generated summaries will be automatically logged to REFACTORING_LOG.md"

package/src/opencode/commands/enforcer-daily-scan.md

@@ -5,9 +5,9 @@ description: Automated daily framework compliance monitoring with threshold vali
 
 #!/bin/bash
 
-# Daily compliance scan for xray 2.0
+# Daily compliance scan for xray
 
-echo "🔍 xray 2.0 - Daily Compliance Scan"
+echo "🔍 xray - Daily Compliance Scan"
 echo "========================================================="
 
 # Initialize compliance status
@@ -133,5 +133,5 @@ exit 1
 fi
 
 echo ""
-echo "🎯 xray 2.0 Status: OPERATIONAL"
+echo "🎯 xray Status: OPERATIONAL"
 echo "Next scheduled scan: Tomorrow at 09:00"

package/src/opencode/commands/framework-compliance-audit.md

@@ -1,10 +1,10 @@
 #!/bin/bash
 
-# xray 2.0 - Full Framework Compliance Audit
+# xray - Full Framework Compliance Audit
 
 # Comprehensive validation of all framework components and thresholds
 
-echo "📋 xray 2.0 - Full Compliance Audit"
+echo "📋 xray - Full Compliance Audit"
 echo "================================================================"
 
 # Initialize audit results
@@ -171,7 +171,7 @@ echo "===================================="
 
 if [ "$AUDIT_PASSED" = true ]; then
 echo "✅ FRAMEWORK COMPLIANCE AUDIT PASSED"
-echo "xray 2.0 is fully operational"
+echo "xray is fully operational"
 else
 echo "❌ FRAMEWORK COMPLIANCE AUDIT FAILED"
 echo ""
@@ -199,7 +199,7 @@ echo " - $score"
 done
 
 echo ""
-echo "🎯 xray 2.0"
+echo "🎯 xray"
 echo "Status: FULLY COMPLIANT & OPERATIONAL"
 echo "Codex Terms Enforced: [1,2,3,4,5,6,7,8,9,10,15,24,29,32,38,42,43]"
 echo "Runtime Error Prevention: 90% Target Active"

package/src/opencode/commands/interactive-validator.md

@@ -1,10 +1,10 @@
 #!/bin/bash
 
-# xray 2.0 - Interactive Session Validator
+# xray - Interactive Session Validator
 
 # Real-time agent cross-checking during coding sessions
 
-echo "🔍 xray 2.0 - Interactive Session Validation"
+echo "🔍 xray - Interactive Session Validation"
 echo "=================================================================="
 
 # Check if this is an interactive coding session

package/src/opencode/commands/job-summary-logger.md

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# xray 2.0 - AI Summary Auto-Logger
+# xray - AI Summary Auto-Logger
 
 # Automatically captures and logs whatever AI outputs as final summary
 
@@ -40,7 +40,7 @@
 
 # 🚨 VIOLATION OF THIS RULE WILL BREAK THE PROJECT'S HISTORICAL RECORD 🚨
 
-echo "📝 xray 2.0 - AI Summary Auto-Logger"
+echo "📝 xray - AI Summary Auto-Logger"
 echo "==============================="
 
 # This script captures whatever content is piped to it and logs it automatically

package/src/opencode/commands/mode-switch.md

@@ -5,7 +5,7 @@ description: Switch between full (25 agents) and lite (25 agents) modes dynamica
 
 #!/bin/bash
 
-# xray 2.0 - Mode Switch Command
+# xray - Mode Switch Command
 
 # Dynamically switches between full and lite agent configurations
 

package/src/opencode/commands/model-health-check.md

@@ -5,11 +5,11 @@ description: Verify dynamic model loading system health and compatibility
 
 #!/bin/bash
 
-# xray 2.0 - Dynamic Model Health Check
+# xray - Dynamic Model Health Check
 
 # Validates the dynamic model loading system functionality
 
-echo "🏥 xray 2.0 - Dynamic Model Health Check"
+echo "🏥 xray - Dynamic Model Health Check"
 echo "================================================"
 
 # Check if dynamic loader exists

package/src/opencode/commands/performance-analysis.md

@@ -1,10 +1,10 @@
 #!/bin/bash
 
-# xray 2.0 - Performance Analysis
+# xray - Performance Analysis
 
 # Comprehensive metrics analysis for framework integration
 
-echo "📊 xray 2.0 - Performance Analysis"
+echo "📊 xray - Performance Analysis"
 echo "============================================================"
 
 # Initialize performance metrics

package/src/opencode/commands/pre-commit-introspection.md

@@ -5,11 +5,11 @@ description: Batched code quality and architecture introspection before commits
 
 #!/bin/bash
 
-# xray 2.0 - Pre-commit Introspection
+# xray - Pre-commit Introspection
 
 # Comprehensive code quality and architecture validation
 
-echo "🔬 xray 2.0 - Pre-commit Introspection"
+echo "🔬 xray - Pre-commit Introspection"
 echo "============================================================"
 
 # Initialize analysis status
@@ -181,5 +181,5 @@ done
 fi
 
 echo ""
-echo "🎯 xray 2.0: INTROSPECTION COMPLETE"
+echo "🎯 xray: INTROSPECTION COMPLETE"
 echo "Commit ready for integration"

package/src/opencode/commands/security-scan.md

@@ -5,11 +5,11 @@ description: Automated security vulnerability scanning with dependency and code
 
 #!/bin/bash
 
-# xray 2.0 - Security Scan Hook
+# xray - Security Scan Hook
 
 # Comprehensive security analysis for vulnerabilities and threats
 
-echo "🔒 xray 2.0 - Security Scan"
+echo "🔒 xray - Security Scan"
 echo "================================================="
 
 # Initialize security status
@@ -153,5 +153,5 @@ exit 1
 fi
 
 echo ""
-echo "🛡️ xray 2.0 Status: SECURE"
+echo "🛡️ xray Status: SECURE"
 echo "Next security scan: Pre-commit and daily"

package/src/opencode/commands/sisyphus-validation.md

@@ -1,10 +1,10 @@
 #!/bin/bash
 
-# xray 2.0 - Sisyphus Orchestrator Validation
+# xray - Sisyphus Orchestrator Validation
 
 # Tests async multi-agent coordination capabilities
 
-echo "🎭 xray 2.0 - Sisyphus Orchestrator Validation"
+echo "🎭 xray - Sisyphus Orchestrator Validation"
 echo "==================================================================="
 
 # Initialize orchestration test
@@ -124,5 +124,5 @@ echo " - MCP skills integrated: ${#MCP_SKILLS[@]}"
 echo " - Total coordination points: $((${#AGENTS[@]} + ${#WORKFLOW_PATTERNS[@]} + ${#MCP_SKILLS[@]}))"
 
 echo ""
-echo "🎭 xray 2.0: SISYPHUS OPERATIONAL"
+echo "🎭 xray: SISYPHUS OPERATIONAL"
 echo "Async multi-agent orchestration validated"

package/src/opencode/commands/summary-logger.md

@@ -1,4 +1,4 @@
-# xray 2.0 - Summary Logger
+# xray - Summary Logger
 
 # Automatically logs AI-generated summaries and analysis to REFACTORING_LOG.md
 
@@ -38,7 +38,7 @@
 
 # 🚨 VIOLATION OF THIS RULE WILL BREAK THE PROJECT'S HISTORICAL RECORD 🚨
 
-echo "📝 xray 2.0 - Summary Logger" >&2
+echo "📝 xray - Summary Logger" >&2
 echo "====================================" >&2
 
 # Get script directory and project root

package/src/skills/xray-orchestrator/index.ts

@@ -3,7 +3,6 @@
  *
  * OpenClaw skill that provides xray orchestration commands.
  *
- * @version 1.0.0
  * @since 2026-03-14
  */