0xray 3.0.11 → 3.0.14

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

@@ -120,7 +120,7 @@ function calculateCounts() {
       } catch {}
     }
   } catch (e) {
-    console.warn("⚠️  Could not calculate counts:", e.message);
+    process.stderr.write("⚠️  Could not calculate counts: " + e.message + "\n");
   }
 
   return counts;
@@ -133,42 +133,23 @@ 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: "v3.0.9", termsCount: 68, lastUpdated: new Date().toISOString().split("T")[0] };
-}
-
-const detectedCodex = detectCodexInfo();
-
 const OFFICIAL_VERSIONS = {
   // Framework version
   framework: {
-    version: "3.0.11",
+    version: "3.0.14",
       displayName: "xray: Self-Healing AI Governance OS",
-      lastUpdated: "2026-06-13",
+      lastUpdated: "2026-06-14",
     // Counts (auto-calculated, but can be overridden)
     ...CALCULATED_COUNTS,
   },
 
-  // Codex version (auto-detected from codex.json)
+  // Codex version
   codex: {
-    version: detectedCodex.version,
-    termsCount: detectedCodex.termsCount,
-    termsDefined: detectedCodex.termsCount,
-    termsTarget: detectedCodex.termsCount,
-    lastUpdated: detectedCodex.lastUpdated,
+    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",
   },
 
   // External dependencies
@@ -177,13 +158,13 @@ const OFFICIAL_VERSIONS = {
   },
 };
 
-console.log("📊 Auto-calculated counts:");
-console.log(`   Agents: ${OFFICIAL_VERSIONS.framework.agents}`);
-console.log(`   Skills: ${OFFICIAL_VERSIONS.framework.skills}`);
-console.log(`   MCP Servers: ${OFFICIAL_VERSIONS.framework.mcpServers}`);
-console.log(`   Tests: ${OFFICIAL_VERSIONS.framework.tests}`);
-console.log(`   Codex Terms: ${OFFICIAL_VERSIONS.codex.termsCount}`);
-console.log("");
+process.stdout.write("📊 Auto-calculated counts:\n");
+process.stdout.write("   Agents: " + OFFICIAL_VERSIONS.framework.agents + "\n");
+process.stdout.write("   Skills: " + OFFICIAL_VERSIONS.framework.skills + "\n");
+process.stdout.write("   MCP Servers: " + OFFICIAL_VERSIONS.framework.mcpServers + "\n");
+process.stdout.write("   Tests: " + OFFICIAL_VERSIONS.framework.tests + "\n");
+process.stdout.write("   Codex Terms: " + OFFICIAL_VERSIONS.codex.termsCount + "\n");
+process.stdout.write("\n");
 
 // Simple recursive file finder - necessary for explaining complex directory traversal logic
 function findFiles(
@@ -346,29 +327,29 @@ const UPDATE_PATTERNS = [
     },
 
     // === BADGE AND COUNT PATTERNS ===
-    // Test count in docs badge (e.g., tests-2290-brightgreen)
+    // Test count in docs badge (e.g., tests-2527-brightgreen)
     {
       pattern: /tests-[0-9]+(?=-brightgreen)/g,
       replacement: `tests-${OFFICIAL_VERSIONS.framework.tests}`,
     },
-    // Test count in npm badge (e.g., tests-2290%20passed-brightgreen)
+    // Test count in npm badge (e.g., tests-2527%20passed-brightgreen)
     {
       pattern: /tests-[0-9,]+%20passed/g,
       replacement: `tests-${OFFICIAL_VERSIONS.framework.tests}%20passed`,
     },
-    // Test count in prose (e.g., "2,2290 Tests" or "2290 Tests" but NOT in badge URLs)
+    // Test count in prose (e.g., "2,2527 Tests" or "2527 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., "✅ 2290 Tests")
+    // Test count in feature bullets (e.g., "✅ 2527 Tests")
     {
       pattern: /[0-9]+ Tests/g,
       replacement: `${OFFICIAL_VERSIONS.framework.tests} Tests`,
     },
-    // Test count in config tree (e.g., "2290 tests")
+    // Test count in config tree (e.g., "2527 tests")
     {
       pattern: /[0-9]+ tests/g,
       replacement: `${OFFICIAL_VERSIONS.framework.tests} tests`,
@@ -403,7 +384,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**: 3.0.10")
+    // Footer bare version (e.g., "**Version**: 1.22.67")
     {
       pattern: /\*\*Version\*\*:\s*[0-9]+\.[0-9]+\.[0-9]+/g,
       replacement: `**Version**: ${OFFICIAL_VERSIONS.framework.version}`,
@@ -438,7 +419,7 @@ const UPDATE_PATTERNS = [
   async function createBackup() {
     try {
       const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-      backupDir = `docs/reflections/backups/version-manager-${timestamp}`;
+      backupDir = `backups/version-manager-backup-${timestamp}`;
 
       // Create backup directory
       fs.mkdirSync(backupDir, { recursive: true });
@@ -506,16 +487,17 @@ const UPDATE_PATTERNS = [
     let validationErrors = [];
     let warnings = [];
 
-    // 1. Check codex.json matches OFFICIAL_VERSIONS.codex.termsCount
+    // 1. Check codex.json has exactly 60 terms
     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 !== OFFICIAL_VERSIONS.codex.termsCount) {
-          warnings.push(
-            `codex.json has ${termCount} terms, expected ${OFFICIAL_VERSIONS.codex.termsCount}`
+        if (termCount !== 60) {
+          validationErrors.push(
+            `codex.json should have 60 terms, but has ${termCount}`
           );
         }
       } catch (e) {
@@ -528,38 +510,52 @@ 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 !== OFFICIAL_VERSIONS.codex.termsCount) {
+        } else if (codexContent.terms.length !== 60) {
           warnings.push(
             `codex.codex terms should have 60 elements, but has ${codexContent.terms.length}`
           );
         }
-        // Version can be framework version or codex version — both are fine, skip noisy warning
+        // Version can be framework version or codex version - both are acceptable
+        if (codexContent.version) {
+          warnings.push(
+            `codex.codex version is ${codexContent.version} (framework version)`
+          );
+        }
       } catch (e) {
         validationErrors.push(`Error parsing codex.codex: ${e.message}`);
       }
     }
 
-    // 3. Check README.md has correct counts — soft warning only
+    // 3. Check README.md has correct counts
     const readmePath = "README.md";
     if (fs.existsSync(readmePath)) {
       const readmeContent = fs.readFileSync(readmePath, "utf8");
-      const expected = `${OFFICIAL_VERSIONS.codex.termsCount} codex terms`;
-      if (!readmeContent.includes(expected)) {
-        warnings.push(`README.md should reference '${expected}'`);
+      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");
       }
     }
 
-    // 4. Check AGENTS.md has correct information — soft warning only
+    // 4. Check AGENTS.md has correct information
     const agentsPath = "AGENTS.md";
     if (fs.existsSync(agentsPath)) {
       const agentsContent = fs.readFileSync(agentsPath, "utf8");
-      const expected = `${OFFICIAL_VERSIONS.codex.termsCount} terms`;
-      if (!agentsContent.includes(expected)) {
-        warnings.push(`AGENTS.md should reference '${expected}'`);
+      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");
       }
     }
 
@@ -589,15 +585,20 @@ const UPDATE_PATTERNS = [
       try {
         const content = fs.readFileSync(file, "utf8");
 
-        // Check for old framework version (v1.x — pre-v2)
-        if (/version:\s*"1\.\d+\.\d+"/.test(content)) {
+        // Check for old codex version (v1.2.25 or earlier)
+        if (/version:\s*"v1\.[01]\./.test(content)) {
           oldVersionCount++;
-          warnings.push(`${file} references v1.x framework version`);
+          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`);
         }
 
-        // 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}`);
+        // Check for old framework version (< 1.7.5)
+        if (/version:\s*"1\.[0-6]\./.test(content)) {
+          warnings.push(`${file} references old framework version`);
         }
       } catch (e) {
         // Skip files that can't be read
@@ -702,7 +703,8 @@ const UPDATE_PATTERNS = [
   const documentationFiles = [
     "README.md",
     "AGENTS.md",
-    "xray/agents_template.md",
+    "src/opencode/AGENTS-consumer.md",
+    rcp("agents_template.md") || "src/opencode/agents_template.md",
     "docs/reference/templates/agents_template.md",
     "docs/reference/templates/master-agent-template.md",
     "docs/reference/templates/agent-template-dev.md",
@@ -981,7 +983,7 @@ const UPDATE_PATTERNS = [
  * =====================================
  *
  * ✅ COMPLETED FEATURES:
- * - Comprehensive documentation management (AGENTS.md, xray/agents_template.md, etc.)
+ * - Comprehensive documentation management (AGENTS.md, AGENTS-consumer.md, etc.)
  * - File categorization (critical, documentation, historical, test assertions)
  * - Validation step for consistency checking
  * - Changelog generation
@@ -997,7 +999,7 @@ const UPDATE_PATTERNS = [
  *
  * 📋 FILE CATEGORIES:
  * - Critical: src/opencode/codex.codex, etc.
- * - Documentation: AGENTS.md, xray/agents_template.md, docs/*.md
+ * - Documentation: AGENTS.md, AGENTS-consumer.md, docs/*.md
  * - Historical: docs/reflections/, docs/archive/
  * - Test Assertions: context-loader.test.ts, codex-parser.test.ts
  *
@@ -1013,7 +1015,7 @@ const UPDATE_PATTERNS = [
  * - No files reference old versions
  *
  * 💾 BACKUP LOCATION:
- * - Created in 'docs/reflections/backups/version-manager-[timestamp]/'
+ * - Created in 'backups/version-manager-backup-[timestamp]/'
  * - Includes changelog.md with all changes
  *
  * 📝 TO ROLLBACK:

package/scripts/node/validate-mcp-connectivity.js

@@ -3,7 +3,7 @@
 /**
  * MCP Server Connectivity Validator
  *
- * Tests all xray v39 MCP servers for proper startup and protocol compliance
+ * Tests all xray v41 MCP servers for proper startup and protocol compliance
  * Validates external integration points that internal tests miss
  * 
  * FIXED: Converted to ES module syntax

package/scripts/node/version-manager.mjs

@@ -158,22 +158,6 @@ function generateChangelogFromCommits(commits) {
   return sections.join('\n\n') || '- Version bump';
 }
 
-function findTestFiles(dir) {
-  let count = 0;
-  try {
-    for (const entry of fs.readdirSync(dir)) {
-      const full = path.join(dir, entry);
-      const stat = fs.statSync(full);
-      if (stat.isDirectory()) {
-        count += findTestFiles(full);
-      } else if (entry.endsWith('.test.ts') || entry.endsWith('.spec.ts')) {
-        count++;
-      }
-    }
-  } catch {}
-  return count;
-}
-
 /**
  * Count actual framework components
  */
@@ -181,9 +165,7 @@ function getFrameworkCounts() {
   const counts = {
     agents: 0,
     mcps: 0,
-    skills: 0,
-    codexTerms: 0,
-    tests: 0
+    skills: 0
   };
   
   // Count agents (.yml files in src/opencode/agents/ — source of truth)
@@ -218,27 +200,6 @@ function getFrameworkCounts() {
       .filter(f => fs.existsSync(path.join(skillsDir, f, 'SKILL.md')))
       .length;
   }
-
-  // Count codex terms (xray/codex.json is SSOT)
-  const codexPath = path.join(rootDir, 'xray/codex.json');
-  if (fs.existsSync(codexPath)) {
-    try {
-      const codex = JSON.parse(fs.readFileSync(codexPath, 'utf-8'));
-      counts.codexTerms = Object.keys(codex.terms || codex.rules || codex).length;
-    } catch {
-      counts.codexTerms = 0;
-    }
-  }
-
-  // Count test files across all of src/
-  try {
-    const srcDir = path.join(rootDir, 'src');
-    if (fs.existsSync(srcDir)) {
-      counts.tests = findTestFiles(srcDir);
-    }
-  } catch {
-    counts.tests = 0;
-  }
   
   return counts;
 }
@@ -329,15 +290,8 @@ function updateReadme(counts, newVersion) {
     `${counts.agents} agents, ${counts.mcps} MCP servers`
   );
   
-  // Update only the version in the summary line.
-  // Counts are marketing copy — not auto-mutated on release (see audit:counts for observability).
-  readme = readme.replace(
-    /\*\*v[\d.]+?\*\*/,
-    `**v${newVersion}**`
-  );
-  
   fs.writeFileSync(readmePath, readme);
-  console.log(`✅ Updated README.md (version only: ${newVersion})`);
+  console.log(`✅ Updated README.md (version: ${newVersion}, agents: ${counts.agents}, mcps: ${counts.mcps}, skills: ${counts.skills})`);
 }
 
 /**
@@ -354,8 +308,8 @@ function updateAgentsMd(counts) {
   
   // Legacy header count update (min compat for old consumer AGENTS.md files only; xray v2 YML SSOT primary)
   agentsMd = agentsMd.replace(
-    /0xRay\s*2\.0\s*-\s*\d+\s+Agents|xray\s*v2\s*-\s*\d+\s+Agents/,
-    `xray v3 - ${counts.agents} Agents`
+    /0xRay\s*2\.0\s*-\s*\d+\s+Agents|StringRay\s*-\s*\d+\s+Agents/,
+    `xray v2 - ${counts.agents} Agents`
   );
   
   agentsMd = agentsMd.replace(

package/src/integrations/grok/plugin/0xray/.mcp.json

@@ -1,20 +1,23 @@
 {
   "mcpServers": {
-    "xray-governance": {
+    "0xray-governance": {
       "command": "npx",
-      "args": ["-y", "0xray", "mcp", "governance"]
+      "args": ["-y", "0xray", "mcp", "governance"],
+      "env": {
+        "XRAY_FORCE_MCP_GOVERNANCE": "true"
+      }
     },
-    "xray-skills": {
+    "0xray-skills": {
       "command": "npx",
       "args": ["-y", "0xray", "mcp", "skills"]
     },
-    "xray-enforcer": {
+    "0xray-orchestrator": {
       "command": "npx",
-      "args": ["-y", "0xray", "mcp", "enforcer"]
+      "args": ["-y", "0xray", "mcp", "orchestrator"]
     },
-    "xray-orchestrator": {
+    "0xray-enforcer": {
       "command": "npx",
-      "args": ["-y", "0xray", "mcp", "orchestrator"]
+      "args": ["-y", "0xray", "mcp", "enforcer"]
     }
   }
-}
+}

package/src/integrations/grok/plugin/0xray/hooks/hooks.json

@@ -8,7 +8,7 @@
             "type": "command",
             "command": "node",
             "args": [
-              "${XRAY_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/pre-tool-use.js"
+              "${STRRAY_AI_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/pre-tool-use.js"
             ],
             "timeout": 30000
           }
@@ -21,7 +21,7 @@
           {
             "type": "command",
             "command": "echo",
-            "args": ["[0xRay] Grok session started with 0xRay governance enabled"]
+            "args": ["[0xRay] Grok session started with StringRay governance enabled"]
           }
         ]
       }