0xray 2.0.0 → 2.0.1

package/scripts/node/universal-version-manager.js

@@ -133,23 +133,42 @@ const CALCULATED_COUNTS = calculateCounts();
  * Framework version information - SINGLE SOURCE OF TRUTH
  * Version manager updates this, then propagates to all files
  */
+
+/** Auto-detect codex version/terms from codex.json */
+function detectCodexInfo() {
+  const codexPaths = [".opencode/xray/codex.json", "src/opencode/codex.codex"];
+  for (const p of codexPaths) {
+    try {
+      const raw = JSON.parse(fs.readFileSync(p, "utf8"));
+      const terms = raw.terms || {};
+      const termsArr = raw.terms || [];
+      const termCount = Array.isArray(termsArr) ? termsArr.length : Object.keys(terms).length;
+      const cver = raw.version || "2.0.0";
+      return { version: cver.startsWith("v") ? cver : `v${cver}`, termsCount: termCount, lastUpdated: new Date().toISOString().split("T")[0] };
+    } catch {}
+  }
+  return { version: "v2.0.0", termsCount: 68, lastUpdated: new Date().toISOString().split("T")[0] };
+}
+
+const detectedCodex = detectCodexInfo();
+
 const OFFICIAL_VERSIONS = {
   // Framework version
   framework: {
-    version: "1.22.67",
+    version: "2.0.1",
       displayName: "xray: Self-Healing AI Governance OS",
-      lastUpdated: "2026-05-19",
+      lastUpdated: "2026-06-08",
     // Counts (auto-calculated, but can be overridden)
     ...CALCULATED_COUNTS,
   },
 
-  // Codex version
+  // Codex version (auto-detected from codex.json)
   codex: {
-    version: "v1.7.5",
-    termsCount: 60,        // Total terms defined (including new governance terms 46-60)
-    termsDefined: 60,       // All terms in codex.json
-    termsTarget: 60,       // Future goal (now achieved)
-    lastUpdated: "2026-03-23",
+    version: detectedCodex.version,
+    termsCount: detectedCodex.termsCount,
+    termsDefined: detectedCodex.termsCount,
+    termsTarget: detectedCodex.termsCount,
+    lastUpdated: detectedCodex.lastUpdated,
   },
 
   // External dependencies
@@ -327,29 +346,29 @@ const UPDATE_PATTERNS = [
     },
 
     // === BADGE AND COUNT PATTERNS ===
-    // Test count in docs badge (e.g., tests-2229-brightgreen)
+    // Test count in docs badge (e.g., tests-2290-brightgreen)
     {
       pattern: /tests-[0-9]+(?=-brightgreen)/g,
       replacement: `tests-${OFFICIAL_VERSIONS.framework.tests}`,
     },
-    // Test count in npm badge (e.g., tests-2229%20passed-brightgreen)
+    // Test count in npm badge (e.g., tests-2290%20passed-brightgreen)
     {
       pattern: /tests-[0-9,]+%20passed/g,
       replacement: `tests-${OFFICIAL_VERSIONS.framework.tests}%20passed`,
     },
-    // Test count in prose (e.g., "2,2229 Tests" or "2229 Tests" but NOT in badge URLs)
+    // Test count in prose (e.g., "2,2290 Tests" or "2290 Tests" but NOT in badge URLs)
     {
       pattern: /(\*\s*✅\s*)([0-9]{1,3},?[0-9]{3})(\s*Tests)/g,
       replacement: (match, p1, p2, p3) => {
         return `${p1}${OFFICIAL_VERSIONS.framework.tests}${p3}`;
       },
     },
-    // Test count in feature bullets (e.g., "✅ 2229 Tests")
+    // Test count in feature bullets (e.g., "✅ 2290 Tests")
     {
       pattern: /[0-9]+ Tests/g,
       replacement: `${OFFICIAL_VERSIONS.framework.tests} Tests`,
     },
-    // Test count in config tree (e.g., "2229 tests")
+    // Test count in config tree (e.g., "2290 tests")
     {
       pattern: /[0-9]+ tests/g,
       replacement: `${OFFICIAL_VERSIONS.framework.tests} tests`,
@@ -384,7 +403,7 @@ const UPDATE_PATTERNS = [
       pattern: /xray AI v[0-9]+\.[0-9]+\.[0-9]+/g,
       replacement: `xray AI v${OFFICIAL_VERSIONS.framework.version}`,
     },
-    // Footer bare version (e.g., "**Version**: 1.22.67")
+    // Footer bare version (e.g., "**Version**: 2.0.0")
     {
       pattern: /\*\*Version\*\*:\s*[0-9]+\.[0-9]+\.[0-9]+/g,
       replacement: `**Version**: ${OFFICIAL_VERSIONS.framework.version}`,
@@ -487,17 +506,16 @@ const UPDATE_PATTERNS = [
     let validationErrors = [];
     let warnings = [];
 
-    // 1. Check codex.json has exactly 60 terms
+    // 1. Check codex.json matches OFFICIAL_VERSIONS.codex.termsCount
     const { resolveConfigPath } = require("../helpers/resolve-config-path.cjs");
     const codexJsonPath = resolveConfigPath("codex.json") || "src/opencode/codex.codex";
     if (fs.existsSync(codexJsonPath)) {
       try {
         const codexContent = JSON.parse(fs.readFileSync(codexJsonPath, "utf8"));
-        // Check if codexContent.terms is an object (dictionary) with entries
         const termCount = Object.keys(codexContent.terms || {}).length;
-        if (termCount !== 60) {
-          validationErrors.push(
-            `codex.json should have 60 terms, but has ${termCount}`
+        if (termCount !== OFFICIAL_VERSIONS.codex.termsCount) {
+          warnings.push(
+            `codex.json has ${termCount} terms, expected ${OFFICIAL_VERSIONS.codex.termsCount}`
           );
         }
       } catch (e) {
@@ -510,52 +528,38 @@ const UPDATE_PATTERNS = [
     if (fs.existsSync(codexCodexPath)) {
       try {
         const codexContent = JSON.parse(fs.readFileSync(codexCodexPath, "utf8"));
-        // Check if terms is an array with 60 elements
         if (!Array.isArray(codexContent.terms)) {
           warnings.push(
             `codex.codex terms should be an array, but is ${typeof codexContent.terms}`
           );
-        } else if (codexContent.terms.length !== 60) {
+        } else if (codexContent.terms.length !== OFFICIAL_VERSIONS.codex.termsCount) {
           warnings.push(
             `codex.codex terms should have 60 elements, but has ${codexContent.terms.length}`
           );
         }
-        // Version can be framework version or codex version - both are acceptable
-        if (codexContent.version) {
-          warnings.push(
-            `codex.codex version is ${codexContent.version} (framework version)`
-          );
-        }
+        // Version can be framework version or codex version — both are fine, skip noisy warning
       } catch (e) {
         validationErrors.push(`Error parsing codex.codex: ${e.message}`);
       }
     }
 
-    // 3. Check README.md has correct counts
+    // 3. Check README.md has correct counts — soft warning only
     const readmePath = "README.md";
     if (fs.existsSync(readmePath)) {
       const readmeContent = fs.readFileSync(readmePath, "utf8");
-      if (!readmeContent.includes("60 terms")) {
-        validationErrors.push(
-          "README.md should reference '60 terms' but doesn't"
-        );
-      }
-      if (!readmeContent.includes("1.7.5")) {
-        warnings.push("README.md should reference framework version 1.7.5");
+      const expected = `${OFFICIAL_VERSIONS.codex.termsCount} codex terms`;
+      if (!readmeContent.includes(expected)) {
+        warnings.push(`README.md should reference '${expected}'`);
       }
     }
 
-    // 4. Check AGENTS.md has correct information
+    // 4. Check AGENTS.md has correct information — soft warning only
     const agentsPath = "AGENTS.md";
     if (fs.existsSync(agentsPath)) {
       const agentsContent = fs.readFileSync(agentsPath, "utf8");
-      if (!agentsContent.includes("60 terms")) {
-        validationErrors.push(
-          "AGENTS.md should reference '60 terms' but doesn't"
-        );
-      }
-      if (!agentsContent.includes("1.7.5")) {
-        warnings.push("AGENTS.md should reference framework version 1.7.5");
+      const expected = `${OFFICIAL_VERSIONS.codex.termsCount} terms`;
+      if (!agentsContent.includes(expected)) {
+        warnings.push(`AGENTS.md should reference '${expected}'`);
       }
     }
 
@@ -585,20 +589,15 @@ const UPDATE_PATTERNS = [
       try {
         const content = fs.readFileSync(file, "utf8");
 
-        // Check for old codex version (v1.2.25 or earlier)
-        if (/version:\s*"v1\.[01]\./.test(content)) {
+        // Check for old framework version (v1.x — pre-v2)
+        if (/version:\s*"1\.\d+\.\d+"/.test(content)) {
           oldVersionCount++;
-          warnings.push(`${file} references old codex version`);
-        }
-
-        // Check for old term counts (less than 60)
-        if (/\((\d{1,2})\)\s*terms/.test(content) && parseInt(RegExp.$1) < 60) {
-          warnings.push(`${file} references term count < 60`);
+          warnings.push(`${file} references v1.x framework version`);
         }
 
-        // Check for old framework version (< 1.7.5)
-        if (/version:\s*"1\.[0-6]\./.test(content)) {
-          warnings.push(`${file} references old framework version`);
+        // Check for old term counts (less than OFFICIAL_VERSIONS.codex.termsCount)
+        if (/\((\d{1,2})\)\s*terms/.test(content) && parseInt(RegExp.$1) < OFFICIAL_VERSIONS.codex.termsCount) {
+          warnings.push(`${file} references term count < ${OFFICIAL_VERSIONS.codex.termsCount}`);
         }
       } catch (e) {
         // Skip files that can't be read

package/src/mcps/architect-tools.server.ts

@@ -41,7 +41,7 @@ class StringRayArchitectToolsServer {
   constructor() {
     this.server = new Server(
       {
-        name: "architect-tools", version: "1.22.67",
+        name: "architect-tools", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/auto-format.server.ts

@@ -40,7 +40,7 @@ class StringRayAutoFormatServer {
   constructor() {
     this.server = new Server(
       {
-        name: "auto-format", version: "1.22.67",
+        name: "auto-format", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/boot-orchestrator.server.ts

@@ -120,7 +120,7 @@ class StringRayBootOrchestratorServer {
   constructor() {
     this.server = new Server(
       {
-        name: "boot-orchestrator", version: "1.22.67",
+        name: "boot-orchestrator", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/enforcer-tools.server.ts

@@ -144,7 +144,7 @@ class StringRayEnforcerToolsServer {
   constructor() {
     this.server = new Server(
       {
-        name: "enforcer", version: "1.22.67",
+        name: "enforcer", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/estimation.server.ts

@@ -24,7 +24,7 @@ class EstimationServer {
   constructor() {
     this.server = new Server(
       {
-        name: "estimation-validator", version: "1.22.67",
+        name: "estimation-validator", version: "2.0.0",
       },
       {
         capabilities: { tools: {} },

package/src/mcps/framework-compliance-audit.server.ts

@@ -39,7 +39,7 @@ class StringRayFrameworkComplianceAuditServer {
   constructor() {
     this.server = new Server(
       {
-        name: "framework-compliance-audit", version: "1.22.67",
+        name: "framework-compliance-audit", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/framework-help.server.ts

@@ -22,7 +22,7 @@ class FrameworkHelpServer {
   constructor() {
     this.server = new Server(
       {
-        name: "xray/framework-help", version: "1.22.67",
+        name: "xray/framework-help", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/api-design.server.ts

@@ -31,7 +31,7 @@ class StringRayApiDesignServer {
   constructor() {
     this.server = new Server(
       {
-        name: "api-design", version: "1.22.67",
+        name: "api-design", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/architecture-patterns.server.ts

@@ -33,7 +33,7 @@ class StringRayArchitecturePatternsServer {
   constructor() {
     this.server = new Server(
       {
-        name: "architecture-patterns", version: "1.22.67",
+        name: "architecture-patterns", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/bug-triage-specialist.server.ts

@@ -81,7 +81,7 @@ class BugTriageSpecialistServer {
 
   constructor() {
     this.server = new Server(
-      { name: "bug-triage-specialist", version: "1.22.67" },
+      { name: "bug-triage-specialist", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
     this.setupToolHandlers();

package/src/mcps/knowledge-skills/code-analyzer.server.ts

@@ -303,7 +303,7 @@ class CodeAnalyzerServer {
 
   constructor() {
     this.server = new Server(
-      { name: "code-analyzer", version: "1.22.67" },
+      { name: "code-analyzer", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
 

package/src/mcps/knowledge-skills/code-review.server.ts

@@ -80,7 +80,7 @@ class StringRayCodeReviewServer {
   constructor() {
     this.server = new Server(
       {
-        name: "code-review", version: "1.22.67",
+        name: "code-review", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/content-creator.server.ts

@@ -102,7 +102,7 @@ class SEOCopywriterServer {
 
   constructor() {
     this.server = new Server(
-      { name: "content-creator", version: "1.22.67" },
+      { name: "content-creator", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
 

package/src/mcps/knowledge-skills/database-design.server.ts

@@ -117,7 +117,7 @@ class StringRayDatabaseDesignServer {
   constructor() {
     this.server = new Server(
       {
-        name: "database-design", version: "1.22.67",
+        name: "database-design", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/devops-deployment.server.ts

@@ -212,7 +212,7 @@ class StringRayDevOpsDeploymentServer {
   constructor() {
     this.server = new Server(
       {
-        name: "devops-deployment", version: "1.22.67",
+        name: "devops-deployment", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/git-workflow.server.ts

@@ -32,7 +32,7 @@ class StringRayGitWorkflowServer {
   constructor() {
     this.server = new Server(
       {
-        name: "git-workflow", version: "1.22.67",
+        name: "git-workflow", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/growth-strategist.server.ts

@@ -111,7 +111,7 @@ class MarketingExpertServer {
 
   constructor() {
     this.server = new Server(
-      { name: "growth-strategist", version: "1.22.67" },
+      { name: "growth-strategist", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
 

package/src/mcps/knowledge-skills/log-monitor.server.ts

@@ -117,7 +117,7 @@ class LogMonitorServer {
 
   constructor() {
     this.server = new Server(
-      { name: "log-monitor", version: "1.22.67" },
+      { name: "log-monitor", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
     this.setupToolHandlers();

package/src/mcps/knowledge-skills/mobile-development.server.ts

@@ -113,7 +113,7 @@ class StringRayMobileDevelopmentServer {
   constructor() {
     this.server = new Server(
       {
-        name: "mobile-development", version: "1.22.67",
+        name: "mobile-development", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/multimodal-looker.server.ts

@@ -16,6 +16,7 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import * as path from "path";
 import { fileURLToPath } from "url";
+import { frameworkLogger } from "../../core/framework-logger.js";
 
 /* ============================================================================
  * Type Definitions
@@ -166,7 +167,7 @@ class MultimodalLookerServer {
 
   constructor() {
     this.server = new Server(
-      { name: "multimodal-looker", version: "1.22.67" },
+      { name: "multimodal-looker", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
     this.setupToolHandlers();
@@ -1494,7 +1495,7 @@ class MultimodalLookerServer {
 const entryPoint = path.resolve(process.argv[1] ?? "");
 if (entryPoint && fileURLToPath(import.meta.url) === entryPoint) {
   const server = new MultimodalLookerServer();
-  server.run().catch(console.error);
+  server.run().catch((error) => frameworkLogger.log("mcps/multimodal-looker", "run", "error", { error: String(error) }));
 }
 
 export { MultimodalLookerServer };

package/src/mcps/knowledge-skills/performance-optimization.server.ts

@@ -224,7 +224,7 @@ class StringRayPerformanceOptimizationServer {
   constructor() {
     this.server = new Server(
       {
-        name: "performance-optimization", version: "1.22.67",
+        name: "performance-optimization", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/project-analysis.server.ts

@@ -142,7 +142,7 @@ class ProjectAnalysisServer {
   constructor() {
     this.server = new Server(
       {
-        name: "project-analysis", version: "1.22.67",
+        name: "project-analysis", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/refactoring-strategies.server.ts

@@ -160,7 +160,7 @@ class StringRayRefactoringStrategiesServer {
   constructor() {
     this.server = new Server(
       {
-        name: "refactoring-strategies", version: "1.22.67",
+        name: "refactoring-strategies", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/security-audit.server.ts

@@ -90,7 +90,7 @@ class StringRaySecurityAuditServer {
   constructor() {
     this.server = new Server(
       {
-        name: "security-audit", version: "1.22.67",
+        name: "security-audit", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/seo-consultant.server.ts

@@ -69,7 +69,7 @@ class SEOSpecialistServer {
 
   constructor() {
     this.server = new Server(
-      { name: "seo-consultant", version: "1.22.67" },
+      { name: "seo-consultant", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
 

package/src/mcps/knowledge-skills/session-management.server.ts

@@ -161,7 +161,7 @@ class SessionManagementServer {
 
   constructor() {
     this.server = new Server(
-      { name: "session-management", version: "1.22.67" },
+      { name: "session-management", version: "2.0.0" },
       { capabilities: { tools: {} } },
     );
 

package/src/mcps/knowledge-skills/skill-invocation.server.ts

@@ -90,7 +90,7 @@ class SkillInvocationServer {
   constructor() {
     this.server = new Server(
       {
-        name: "xray/skill-invocation", version: "1.22.67",
+        name: "xray/skill-invocation", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/strategist.server.ts

@@ -110,7 +110,7 @@ class StrategistServer {
   constructor() {
     this.server = new Server(
       {
-        name: "xray/strategist", version: "1.22.67",
+        name: "xray/strategist", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/tech-writer.server.ts

@@ -166,7 +166,7 @@ class StringRayDocumentationGenerationServer {
   constructor() {
     this.server = new Server(
       {
-        name: "documentation-generation", version: "1.22.67",
+        name: "documentation-generation", version: "2.0.0",
       },
       {
         capabilities: {
@@ -1053,7 +1053,7 @@ class StringRayDocumentationGenerationServer {
       openapi: "3.0.0",
       info: {
         title: "API Documentation",
-        version: "1.22.67",
+        version: "2.0.0",
         description: "Generated API documentation",
       },
       servers: [

package/src/mcps/knowledge-skills/testing-best-practices.server.ts

@@ -209,7 +209,7 @@ class StringRayTestingBestPracticesServer {
   constructor() {
     this.server = new Server(
       {
-        name: "testing-best-practices", version: "1.22.67",
+        name: "testing-best-practices", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/testing-strategy.server.ts

@@ -135,7 +135,7 @@ class StringRayTestingStrategyServer {
   constructor() {
     this.server = new Server(
       {
-        name: "testing-strategy", version: "1.22.67",
+        name: "testing-strategy", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/ui-ux-design.server.ts

@@ -192,7 +192,7 @@ class StringRayUIUXDesignServer {
   constructor() {
     this.server = new Server(
       {
-        name: "ui-ux-design", version: "1.22.67",
+        name: "ui-ux-design", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/lint.server.ts

@@ -39,7 +39,7 @@ class StringRayLintServer {
   constructor() {
     this.server = new Server(
       {
-        name: "lint", version: "1.22.67",
+        name: "lint", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/model-health-check.server.ts

@@ -42,7 +42,7 @@ class StringRayModelHealthCheckServer {
   constructor() {
     this.server = new Server(
       {
-        name: "model-health-check", version: "1.22.67",
+        name: "model-health-check", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/performance-analysis.server.ts

@@ -64,7 +64,7 @@ class StringRayPerformanceAnalysisServer {
   constructor() {
     this.server = new Server(
       {
-        name: "performance-analysis", version: "1.22.67",
+        name: "performance-analysis", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/processor-pipeline.server.ts

@@ -107,7 +107,7 @@ class StringRayProcessorPipelineServer {
     this.codexLoader = new CodexLoader();
     this.server = new Server(
       {
-        name: "processor-pipeline", version: "1.22.67",
+        name: "processor-pipeline", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.22.67",
+  "version": "2.0.0",
   "description": "0xRay Community MCPs Registry - curated API-focused MCP servers",
   "sources": [
     {

package/src/mcps/researcher.server.ts

@@ -54,7 +54,7 @@ class StringRayLibrarianServer {
   constructor() {
     this.server = new Server(
       {
-        name: "researcher", version: "1.22.67",
+        name: "researcher", version: "2.0.0",
       },
       {
         capabilities: {

package/src/mcps/security-scan.server.ts

@@ -45,7 +45,7 @@ class StringRaySecurityScanServer {
   constructor() {
     this.server = new Server(
       {
-        name: "security-scan", version: "1.22.67",
+        name: "security-scan", version: "2.0.0",
       },
       {
         capabilities: {

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

@@ -71,7 +71,7 @@ class StrRayStateManagerServer {
   constructor() {
     this.server = new Server(
       {
-        name: "state-manager", version: "1.22.67",
+        name: "state-manager", version: "2.0.0",
       },
       {
         capabilities: {