0xray 4.0.0 → 4.0.2

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

@@ -1,1043 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Universal Version Management Script
- *
- * Automatically updates all version references across the xray v2 Framework
- * including framework versions, codex versions, and documentation consistency.
- * Ensures single source of truth for all version information.
- *
- * WHAT IT UPDATES:
- * - Framework version (1.14.1)
- * - Codex version and terms count
- * - Framework counts (agents, skills, MCP servers)
- * - Test counts in README
- *
- * WHAT IT DOESN'T UPDATE:
- * - Historical docs (docs/reflections, docs/archive)
- * - Test files with assertions
- *
- * @since 2026-01-15
- * @updated 2026-03-09 - Enhanced with documentation management, validation, and backup
- */
-
-import { createRequire } from 'module';
-const require = createRequire(import.meta.url);
-
-import fs from "fs";
-import path from "path";
-import { execSync } from "child_process";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const rootDir = path.resolve(__dirname, "../..");
-
-function readPackageVersion() {
-  try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf-8"));
-    return pkg.version;
-  } catch {
-    return "0.0.0";
-  }
-}
-
-/**
- * Auto-calculate framework counts from filesystem
- * This ensures counts are always accurate
- */
-/**
- * Count test files in a directory recursively
- */
-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;
-}
-
-function calculateCounts() {
-  const counts = {
-    agents: 0,
-    skills: 0,
-    mcpServers: 0,
-    tests: 0,
-  };
-
-  try {
-    // Count agents from src/opencode/agents/ (source of truth for agent YAMLs)
-    const srcAgentsDir = "src/opencode/agents";
-    if (fs.existsSync(srcAgentsDir)) {
-      counts.agents = fs.readdirSync(srcAgentsDir).filter(f => 
-        f.endsWith(".yml")
-      ).length;
-    }
-
-    // Count skills from src/skills (source of truth for framework skills)
-    const srcSkillsDir = "src/skills";
-    if (fs.existsSync(srcSkillsDir)) {
-      counts.skills = fs.readdirSync(srcSkillsDir).filter(f => {
-        const fullPath = path.join(srcSkillsDir, f);
-        return fs.statSync(fullPath).isDirectory();
-      }).length;
-    }
-
-    // Count MCP servers (root level + knowledge-skills)
-    const mcpsDir = "src/mcps";
-    if (fs.existsSync(mcpsDir)) {
-      // Count root level servers
-      const rootServers = fs.readdirSync(mcpsDir).filter(f => 
-        f.endsWith(".server.ts") && !f.includes(".test.")
-      ).length;
-      
-      // Count knowledge-skills servers
-      const ksDir = path.join(mcpsDir, "knowledge-skills");
-      let ksServers = 0;
-      if (fs.existsSync(ksDir)) {
-        ksServers = fs.readdirSync(ksDir).filter(f => 
-          f.endsWith(".server.ts") && !f.includes(".test.")
-        ).length;
-      }
-      
-      counts.mcpServers = rootServers + ksServers;
-    }
-
-    // Count tests: prefer stored vitest count, then grep as fallback
-    try {
-      const vitestStatePath = ".opencode/test-count.json";
-      if (fs.existsSync(vitestStatePath)) {
-        const state = JSON.parse(fs.readFileSync(vitestStatePath, "utf8"));
-        if (state.totalTests && state.totalTests > 100) {
-          counts.tests = state.totalTests;
-        }
-      }
-    } catch {}
-
-    if (counts.tests === 0) {
-      try {
-        const out = execSync(
-          "grep -rnE '\\b(it|test)\\s*\\(' src/__tests__/ src/mcps/ src/integrations/ --include='*.test.ts' --include='*.spec.ts' 2>/dev/null | wc -l",
-          { encoding: "utf8", timeout: 15000 }
-        );
-        const count = parseInt(out.trim(), 10);
-        if (count > 100) counts.tests = count;
-      } catch {}
-    }
-  } catch (e) {
-    process.stderr.write("⚠️  Could not calculate counts: " + e.message + "\n");
-  }
-
-  return counts;
-}
-
-// Auto-calculate counts
-const CALCULATED_COUNTS = calculateCounts();
-
-/**
- * Framework version information - SINGLE SOURCE OF TRUTH
- * Version manager updates this, then propagates to all files
- */
-const PACKAGE_VERSION = readPackageVersion();
-
-const OFFICIAL_VERSIONS = {
-  // Framework version — SSOT: package.json
-  framework: {
-    version: PACKAGE_VERSION,
-      displayName: "xray: Self-Healing AI Governance OS",
-      lastUpdated: "2026-06-19",
-    // Counts (auto-calculated, but can be overridden)
-    ...CALCULATED_COUNTS,
-  },
-
-  // Codex version
-  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",
-  },
-
-  // External dependencies
-  dependencies: {
-    opencode: "2.14.0",
-  },
-};
-
-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(
-  dir,
-  extensions,
-  ignoreDirs = [
-    "node_modules", ".git", "dist", "build", "temp", "test-install", 
-    "ci-deploy", "test-config", 
-    "docs/reflections", "docs/archive", "docs/user-guide", "docs/pipeline-trees",
-    "docs/superseded", "docs/commands", "docs/advanced", "docs/session-summary",
-    "docs-site", "scripts/mjs", "scripts/test", "scripts/integrations",
-    ".opencode/state",  // Runtime state data
-    "logs", "reports",  // Generated logs/reports
-
-  ],
-   ignoreFiles = [
-     // npm/package files
-     "package-lock.json", ".opencode.json",
-     // Test records - keep original
-     "SIMULATION_TEST_RESULTS.md",
-     "TEST_INVENTORY.md",
-     // Version history - don't update
-     "CHANGELOG.md", "CHANGELOG-v1.2.0.md",
-     // Historical docs
-     "DEEP_REFLECTION_*.md",
-     "KERNEL_*.md",
-     "REFACTORING_LOG.md",
-     "stringray-reflection.md",
-     "SYSTEM_BUG_INVESTIGATION.md",
-     "TEST_*.md",
-     "tweet-*.md",
-     // Files with old agent names in filename (rename manually if needed)
-     "universal-librarian-consultation.ts",
-     "librarian-agents-updater.ts",
-   ],
-) {
-  const files = [];
-
-  function walk(currentDir) {
-    const items = fs.readdirSync(currentDir);
-
-    for (const item of items) {
-      const fullPath = path.join(currentDir, item);
-      const stat = fs.statSync(fullPath);
-
-      if (stat.isDirectory()) {
-        // Check both exact name and partial path match
-        const shouldIgnore = ignoreDirs.some(ignored => 
-          item === ignored || fullPath.includes(ignored)
-        );
-        if (!shouldIgnore) {
-          walk(fullPath);
-        }
-      } else {
-        const ext = path.extname(item);
-        const basename = path.basename(item);
-        // Skip ignored files and check extension
-        if (!ignoreFiles.includes(basename) && extensions.includes(ext)) {
-          files.push(fullPath);
-        }
-      }
-    }
-  }
-
-  walk(dir);
-  return files;
-}
-
-// Comprehensive update patterns for all version types
-const UPDATE_PATTERNS = [
-   // === FRAMEWORK VERSION UPDATES ===
-    {
-      pattern: /"version": "[0-9]+\.[0-9]+\.[0-9]+"/g,
-      replacement: `"version": "${OFFICIAL_VERSIONS.framework.version}"`,
-    },
-    // MCP server version in server definition objects
-    {
-      pattern: /version: "[0-9]+\.[0-9]+\.[0-9]+"/g,
-      replacement: `version: "${OFFICIAL_VERSIONS.framework.version}"`,
-    },
-    // MCP server version in name+version objects (e.g., { name: "xxx", version: "x.x.x" })
-    {
-      pattern: /name: "[^"]+",\s*version: "[0-9]+\.[0-9]+\.[0-9]+"/g,
-      replacement: (match) => {
-        const nameMatch = match.match(/name: "([^"]+)"/);
-        const name = nameMatch ? nameMatch[1] : 'unknown';
-        return `name: "${name}", version: "${OFFICIAL_VERSIONS.framework.version}"`;
-      },
-    },
-    // features-config default version
-    {
-      pattern: /version: "[0-9]+\.[0-9]+\.[0-9]+",\s*$/gm,
-      replacement: `version: "${OFFICIAL_VERSIONS.framework.version}",`,
-    },
-    {
-      pattern: /xray Framework v[0-9]+\.[0-9]+\.[0-9]+/g,
-      replacement: OFFICIAL_VERSIONS.framework.displayName,
-    },
-    {
-      pattern: /!\[Version\]\(https:\/\/img\.shields\.io\/badge\/version-[0-9]+\.[0-9]+\.[0-9]+/g,
-      replacement: `![Version](https://img.shields.io/badge/version-${OFFICIAL_VERSIONS.framework.version}`,
-    },
-    {
-      pattern: /- Framework Version: [0-9]+\.[0-9]+\.[0-9]+/g,
-      replacement: `- Framework Version: ${OFFICIAL_VERSIONS.framework.version}`,
-    },
-    // CLI Version pattern
-    {
-      pattern: /\.version\("[0-9]+\.[0-9]+\.[0-9]+"\)/g,
-      replacement: `.version("${OFFICIAL_VERSIONS.framework.version}")`,
-   },
-    {
-      pattern: /Framework Version: xray v[0-9]+\.[0-9]+\.[0-9]+/g,
-      replacement: `Framework Version: ${OFFICIAL_VERSIONS.framework.displayName}`,
-    },
-
-    // Simple version patterns
-    {
-      pattern: /xray v[0-9]+\.[0-9]+\.[0-9]+/g,
-      replacement: OFFICIAL_VERSIONS.framework.displayName,
-    },
-    // Standalone version in docs (v1.15.6, v1.15.6 patterns)
-    {
-      pattern: /v1\.14\.[0-9]+/g,
-      replacement: `v${OFFICIAL_VERSIONS.framework.version}`,
-    },
-    {
-      pattern: /v1\.9\.[0-9]+/g,
-      replacement: `v${OFFICIAL_VERSIONS.framework.version}`,
-    },
-
-    // Pre-commit introspection patterns
-    {
-      pattern: /xray [0-9]+\.[0-9]+\.[0-9]+ - Pre-commit Introspection/g,
-      replacement: `${OFFICIAL_VERSIONS.framework.displayName} - Pre-commit Introspection`,
-    },
-    {
-      pattern: /🔬 xray [0-9]+\.[0-9]+\.[0-9]+ - Pre-commit Introspection/g,
-      replacement: `🔬 ${OFFICIAL_VERSIONS.framework.displayName} - Pre-commit Introspection`,
-    },
-
-    // Codex version patterns
-    {
-      pattern: /"version":"[0-9]+\.[0-9]+\.[0-9]+"/g,
-      replacement: `"version":"${OFFICIAL_VERSIONS.framework.version}"`,
-    },
-    // Codex-specific version (v1.x.x format)
-    {
-      pattern: /"version":\s*"v[0-9]+\.[0-9]+\.[0-9]+"/g,
-      replacement: `"version": "${OFFICIAL_VERSIONS.codex.version}"`,
-    },
-    {
-      pattern: /version:\s*"v[0-9]+\.[0-9]+\.[0-9]+"/g,
-      replacement: `version: "${OFFICIAL_VERSIONS.codex.version}"`,
-    },
-    // codex_version field
-    {
-      pattern: /"codex_version":\s*"v[0-9]+\.[0-9]+\.[0-9]+"/g,
-      replacement: `"codex_version": "${OFFICIAL_VERSIONS.codex.version}"`,
-    },
-
-    // === BADGE AND COUNT PATTERNS ===
-    // Test count in docs badge (e.g., tests-2500-brightgreen)
-    {
-      pattern: /tests-[0-9]+(?=-brightgreen)/g,
-      replacement: `tests-${OFFICIAL_VERSIONS.framework.tests}`,
-    },
-    // Test count in npm badge (e.g., tests-2500%20passed-brightgreen)
-    {
-      pattern: /tests-[0-9,]+%20passed/g,
-      replacement: `tests-${OFFICIAL_VERSIONS.framework.tests}%20passed`,
-    },
-    // Test count in prose (e.g., "2,2500 Tests" or "2500 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., "✅ 2500 Tests")
-    {
-      pattern: /[0-9]+ Tests/g,
-      replacement: `${OFFICIAL_VERSIONS.framework.tests} Tests`,
-    },
-    // Test count in config tree (e.g., "2500 tests")
-    {
-      pattern: /[0-9]+ tests/g,
-      replacement: `${OFFICIAL_VERSIONS.framework.tests} tests`,
-    },
-    // MCP server count (e.g., "38 MCP" or "40 MCP")
-    {
-      pattern: /[0-9]+ MCP servers/gi,
-      replacement: `${OFFICIAL_VERSIONS.framework.mcpServers} MCP servers`,
-    },
-    {
-      pattern: /[0-9]+ MCP Servers/g,
-      replacement: `${OFFICIAL_VERSIONS.framework.mcpServers} MCP Servers`,
-    },
-    // Agent count
-    {
-      pattern: /[0-9]+ autonomous agents/gi,
-      replacement: `${OFFICIAL_VERSIONS.framework.agents} autonomous agents`,
-    },
-    {
-      pattern: /[0-9]+ autonomous Agents/g,
-      replacement: `${OFFICIAL_VERSIONS.framework.agents} autonomous Agents`,
-    },
-    {
-      pattern: /[0-9]+ Specialized Agents/g,
-      replacement: `${OFFICIAL_VERSIONS.framework.agents} Specialized Agents`,
-    },
-    {
-      pattern: /[0-9]+ agent configurations/g,
-      replacement: `${OFFICIAL_VERSIONS.framework.agents} agent configurations`,
-    },
-    {
-      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.1.0")
-    {
-      pattern: /\*\*Version\*\*:\s*[0-9]+\.[0-9]+\.[0-9]+/g,
-      replacement: `**Version**: ${OFFICIAL_VERSIONS.framework.version}`,
-    },
-    // "v1.22.28" and other specific old version references in docs
-    {
-      pattern: /v1\.15\.0/g,
-      replacement: `v${OFFICIAL_VERSIONS.framework.version}`,
-    },
-    {
-      pattern: /v1\.22\.13/g,
-      replacement: `v${OFFICIAL_VERSIONS.framework.version}`,
-    },
-    // Codex terms count
-    {
-      pattern: /[0-9]+ codex terms/gi,
-      replacement: `${OFFICIAL_VERSIONS.codex.termsCount} codex terms`,
-    },
-    {
-      pattern: /[0-9]+ codex rules/gi,
-      replacement: `${OFFICIAL_VERSIONS.codex.termsCount} codex rules`,
-    },
-
-  ];
-
-  const BASH_VERSION_PATTERNS = [];
-
-  // Backup management
-  let backupCreated = false;
-  let backupDir = null;
-
-  async function createBackup() {
-    try {
-      const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-      backupDir = `backups/version-manager-backup-${timestamp}`;
-
-      // Create backup directory
-      fs.mkdirSync(backupDir, { recursive: true });
-
-      // Create a changelog file
-      const changelog = createChangelog();
-      fs.writeFileSync(`${backupDir}/CHANGELOG.md`, changelog);
-
-      console.log(`✅ Backup created: ${backupDir}`);
-      backupCreated = true;
-
-      return backupDir;
-    } catch (error) {
-      console.error(`❌ Error creating backup:`, error.message);
-      return null;
-    }
-  }
-
-  // Changelog management
-  const versionChanges = [];
-
-  function addToChangelog(type, file) {
-    const timestamp = new Date().toISOString();
-    versionChanges.push({
-      timestamp,
-      type,
-      file,
-    });
-  }
-
-  function createChangelog() {
-    const header = `# Version Management Changelog\n\n`;
-    const date = new Date().toISOString().split('T')[0];
-    const info = `Generated: ${date}\n`;
-    const divider = "=".repeat(60) + "\n\n";
-    const summary = `## Summary\n\n`;
-    const summaryItems = [];
-
-    // Count changes by type
-    const typeCounts = {};
-    versionChanges.forEach(change => {
-      typeCounts[change.type] = (typeCounts[change.type] || 0) + 1;
-    });
-
-    Object.entries(typeCounts).forEach(([type, count]) => {
-      summaryItems.push(`- ${count} files updated (${type})`);
-    });
-
-    const summaryText = summaryItems.join('\n');
-
-    // Detailed changes
-    const details = `## Detailed Changes\n\n`;
-    const changeEntries = versionChanges.map(change => {
-      const time = new Date(change.timestamp).toLocaleTimeString();
-      return `- **[${time}]** (${change.type}): ${change.file}`;
-    }).join('\n');
-
-    return `${header}${info}${divider}${summary}${summaryText}\n${details}${changeEntries}\n`;
-  }
-
-  // Validation function
-  async function validateConsistency() {
-    console.log("\n🔍 Phase 6: Validating version consistency...");
-
-    let validationErrors = [];
-    let warnings = [];
-
-    // 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 !== 60) {
-          validationErrors.push(
-            `codex.json should have 60 terms, but has ${termCount}`
-          );
-        }
-      } catch (e) {
-        validationErrors.push(`Error parsing codex.json: ${e.message}`);
-      }
-    }
-
-    // 2. Check codex.codex has correct terms count
-    const codexCodexPath = "src/opencode/codex.codex";
-    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) {
-          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)`
-          );
-        }
-      } catch (e) {
-        validationErrors.push(`Error parsing codex.codex: ${e.message}`);
-      }
-    }
-
-    // 3. Check README.md has correct counts
-    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");
-      }
-    }
-
-    // 4. Check AGENTS.md has correct information
-    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");
-      }
-    }
-
-    // 5. Check agent counts in MCP servers match actual count (from CALCULATED_COUNTS)
-    const mcpServerFiles = ["src/mcps/framework-help.server.ts"];
-    for (const mcpFile of mcpServerFiles) {
-      if (fs.existsSync(mcpFile)) {
-        const content = fs.readFileSync(mcpFile, "utf8");
-        const match = content.match(/\*\*(\d+)\s+Agents?:\*\*/);
-        if (match) {
-          const reportedCount = parseInt(match[1]);
-          if (reportedCount !== CALCULATED_COUNTS.agents) {
-            validationErrors.push(
-              `${mcpFile} reports ${reportedCount} agents but src/opencode/agents/ has ${CALCULATED_COUNTS.agents}`
-            );
-          }
-        }
-      }
-    }
-
-    // 7. Check that no files reference old versions
-    const extensions = [".ts", ".js", ".md", ".json", ".txt", ".sh"];
-    const files = findFiles(".", extensions);
-    let oldVersionCount = 0;
-
-    for (const file of files) {
-      try {
-        const content = fs.readFileSync(file, "utf8");
-
-        // Check for old codex version (v1.2.25 or earlier)
-        if (/version:\s*"v1\.[01]\./.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`);
-        }
-
-        // 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
-      }
-    }
-
-    if (oldVersionCount > 0) {
-      warnings.push(`Found ${oldVersionCount} files with old version references`);
-    }
-
-    // 6. Summary
-    console.log("\n" + "=".repeat(60));
-    console.log("Validation Summary:");
-    console.log("=".repeat(60));
-
-    if (validationErrors.length > 0) {
-      console.log("\n❌ Errors found:");
-      validationErrors.forEach(error => console.log(`  - ${error}`));
-    } else {
-      console.log("\n✅ No errors found");
-    }
-
-    if (warnings.length > 0) {
-      console.log("\n⚠️  Warnings:");
-      warnings.forEach(warning => console.log(`  - ${warning}`));
-    }
-
-    console.log("\n" + "=".repeat(60));
-
-    // Return validation result
-    return {
-      valid: validationErrors.length === 0,
-      errors: validationErrors,
-      warnings: warnings,
-    };
-  }
-
-  async function standardizeVersions() {
-  console.warn("\n⚠️  universal-version-manager.js is DEPRECATED for releases.");
-  console.warn("    Use: npm run release:patch  or  npm run version:sync");
-  console.warn("    (version-manager.mjs --artifacts-only). Mass JSON version replace is disabled.\n");
-  return;
-  console.log("🔧 Starting Universal Version Standardization");
-  console.log(`📋 Framework: ${OFFICIAL_VERSIONS.framework.displayName}`);
-  console.log(
-    `📋 Codex: ${OFFICIAL_VERSIONS.codex.version} (${OFFICIAL_VERSIONS.codex.termsCount} terms)`,
-  );
-  console.log(
-    `📋 OpenCode: v${OFFICIAL_VERSIONS.dependencies.opencode}`,
-  );
-  console.log("=".repeat(60));
-
-  // Phase 0: Create backup before making changes
-  console.log("\n💾 Phase 0: Creating backup of all modified files...");
-  await createBackup();
-
-  // Phase 1: Update critical config files (source in src/opencode/)
-  console.log("\n📁 Phase 1: Updating configuration files...");
-  const { resolveConfigPath: rcp } = require("../helpers/resolve-config-path.cjs");
-  const codexPath = rcp("codex.json") || "src/opencode/codex.codex";
-  const featuresPath = rcp("features.json") || "src/opencode/features.json";
-  const criticalConfigFiles = [
-    codexPath,                           // Codex config (source)
-    "src/opencode/codex.codex",          // Main codex (source)
-    "src/opencode/config.json",   // Framework config (source)
-    featuresPath,                        // Feature flags (source)
-  ];
-
-  let configFilesUpdated = 0;
-  for (const configFile of criticalConfigFiles) {
-    if (fs.existsSync(configFile)) {
-      try {
-        const content = fs.readFileSync(configFile, "utf8");
-        let updatedContent = content;
-        let fileChanged = false;
-
-        // Apply all patterns to config files
-        for (const { pattern, replacement } of UPDATE_PATTERNS) {
-          const matches = content.match(pattern);
-          if (matches) {
-            updatedContent = updatedContent.replace(pattern, replacement);
-            fileChanged = true;
-          }
-        }
-
-        if (fileChanged) {
-          fs.writeFileSync(configFile, updatedContent, "utf8");
-          console.log(`✅ Updated: ${configFile}`);
-          configFilesUpdated++;
-          addToChangelog("config", configFile);
-        }
-      } catch (error) {
-        console.error(`❌ Error processing ${configFile}:`, error.message);
-      }
-    } else {
-      console.log(`⚠️  Not found: ${configFile}`);
-    }
-  }
-
-  if (configFilesUpdated > 0) {
-    console.log(`✅ Updated ${configFilesUpdated} critical config files`);
-  }
-
-  // Phase 2: Update documentation files (AGENTS.md, etc.)
-  console.log("\n📁 Phase 2: Updating documentation files...");
-  const documentationFiles = [
-    "README.md",
-    "AGENTS.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",
-    "docs/README.md",
-  ];
-
-  let docsUpdated = 0;
-  let userGuideFilesUpdated = 0;
-  let historicalUpdated = 0;
-  for (const docFile of documentationFiles) {
-    if (fs.existsSync(docFile)) {
-      try {
-        const content = fs.readFileSync(docFile, "utf8");
-        let updatedContent = content;
-        let fileChanged = false;
-
-        // Apply all version patterns
-        for (const { pattern, replacement } of UPDATE_PATTERNS) {
-          const matches = content.match(pattern);
-          if (matches) {
-            updatedContent = updatedContent.replace(pattern, replacement);
-            fileChanged = true;
-          }
-        }
-
-        if (fileChanged) {
-          fs.writeFileSync(docFile, updatedContent, "utf8");
-          console.log(`✅ Updated: ${docFile}`);
-          docsUpdated++;
-          addToChangelog("documentation", docFile);
-        } else {
-          console.log(`⏭️  No changes needed in: ${docFile}`);
-        }
-      } catch (error) {
-        console.error(`❌ Error processing ${docFile}:`, error.message);
-      }
-    } else {
-      console.log(`⚠️  Not found: ${docFile}`);
-    }
-  }
-
-  if (docsUpdated > 0) {
-    console.log(`✅ Updated ${docsUpdated} documentation files`);
-  }
-
-// Phase 3: Update user guide files (optional - skip if dir doesn't exist)
-  if (fs.existsSync("docs/user-guide")) {
-    console.log("\n📁 Phase 3: Updating user guide files...");
-    const userGuideFiles = findFiles("docs/user-guide", [".md"]);
-
-    for (const file of userGuideFiles) {
-      try {
-        const content = fs.readFileSync(file, "utf8");
-        let updatedContent = content;
-        let fileChanged = false;
-
-        // Apply all version patterns
-        for (const { pattern, replacement } of UPDATE_PATTERNS) {
-          const matches = content.match(pattern);
-          if (matches) {
-            updatedContent = updatedContent.replace(pattern, replacement);
-            fileChanged = true;
-          }
-        }
-
-        if (fileChanged) {
-          fs.writeFileSync(file, updatedContent, "utf8");
-          console.log(`✅ Updated: ${file}`);
-          userGuideFilesUpdated++;
-          addToChangelog("docs", file);
-        }
-      } catch (e) {
-        console.log(`⚠️  Error updating ${file}: ${e.message}`);
-      }
-    }
-
-    if (userGuideFilesUpdated > 0) {
-      console.log(`✅ Updated ${userGuideFilesUpdated} user guide files`);
-    }
-  }
-
-  // Phase 4: Update historical docs (selective updates for consistency)
-  console.log("\n📁 Phase 4: Updating historical documentation...");
-  const historicalFiles = findFiles("docs", [".md"], [], [
-    "reflections",
-    "archive",
-    "user-guide",
-    "pipeline-trees",
-    "superseded",
-    "commands",
-    "advanced",
-    "session-summary",
-  ]);
-
-  for (const file of historicalFiles) {
-    try {
-      const content = fs.readFileSync(file, "utf8");
-      let updatedContent = content;
-      let fileChanged = false;
-
-      // Apply all version patterns (skip framework counts for historical docs)
-      const countPatterns = UPDATE_PATTERNS.filter(p =>
-        p.pattern.toString().includes("termsCount") ||
-        p.pattern.toString().includes("framework.agents")
-      );
-      const versionPatterns = UPDATE_PATTERNS.filter(p =>
-        !p.pattern.toString().includes("termsCount") &&
-        !p.pattern.toString().includes("framework.agents")
-      );
-
-      for (const { pattern, replacement } of versionPatterns) {
-        const matches = content.match(pattern);
-        if (matches) {
-          updatedContent = updatedContent.replace(pattern, replacement);
-          fileChanged = true;
-        }
-      }
-
-      if (fileChanged) {
-        fs.writeFileSync(file, updatedContent, "utf8");
-        console.log(`✅ Updated (historical): ${file}`);
-        historicalUpdated++;
-        addToChangelog("historical", file);
-      }
-    } catch (error) {
-      console.error(`❌ Error processing ${file}:`, error.message);
-    }
-  }
-
-  if (historicalUpdated > 0) {
-    console.log(`✅ Updated ${historicalUpdated} historical documentation files`);
-  }
-
-  // Phase 5: Find all other files that might contain version references
-  console.log("\n📁 Phase 5: Scanning all other files...");
-  const extensions = [".ts", ".js", ".md", ".json", ".txt", ".sh"];
-  const files = findFiles(".", extensions);
-
-  let totalFilesUpdated = 0;
-  let totalChanges = 0;
-
-  // Additional safety: protected files that should never be modified
-  // Note: Only protect root package.json (npm version manages this)
-  // .opencode/package.json should be updated by this script
-  const PROTECTED_FILES = [
-    "package-lock.json",
-    "package.json",  // Only root package.json (matched by exact path, not subdirs)
-  ];
-
-  const PROTECTED_PATHS = [
-    ".opencode/test-count.json",
-  ];
-
-  // Test files with version assertions - these contain expected version values for testing
-  // and should NOT have their assertions updated by this script
-  const TEST_ASSERTION_FILES = [
-    "context-loader.test.ts",
-    "codex-parser.test.ts",
-    "json-codex-integration.test.ts",
-    "boot-orchestrator.integration.test.ts",
-  ];
-
-  for (const file of files) {
-    // Skip protected files as an additional safety measure
-    // Use path.basename to match filename only, not full path
-    const basename = path.basename(file);
-    const normalizedPath = path.normalize(file);
-    
-    const isProtected = PROTECTED_FILES.some(protectedFile => {
-      if (protectedFile === "package.json") {
-        return normalizedPath === "package.json";
-      }
-      return basename === protectedFile;
-    }) || PROTECTED_PATHS.some(p => normalizedPath === path.normalize(p));
-    
-    if (isProtected) {
-      console.log(`⏭️ Skipping protected file: ${file}`);
-      continue;
-    }
-    
-    // Skip test assertion files - these contain expected version values for testing
-    // and should NOT have their assertions updated by this script
-    const isTestAssertionFile = TEST_ASSERTION_FILES.includes(basename);
-    if (isTestAssertionFile) {
-      console.log(`⏭️ Skipping test assertion file: ${file}`);
-      continue;
-    }
-
-    try {
-      const content = fs.readFileSync(file, "utf8");
-      let updatedContent = content;
-      let fileChanged = false;
-
-      // Apply all version update patterns
-      for (const { pattern, replacement } of UPDATE_PATTERNS) {
-        const matches = content.match(pattern);
-        if (matches) {
-          updatedContent = updatedContent.replace(pattern, replacement);
-          totalChanges += matches.length;
-          fileChanged = true;
-        }
-      }
-
-      // Apply bash script version patterns
-      for (const { pattern, replacement } of BASH_VERSION_PATTERNS) {
-        const matches = content.match(pattern);
-        if (matches) {
-          updatedContent = updatedContent.replace(pattern, replacement);
-          totalChanges += matches.length;
-          fileChanged = true;
-        }
-      }
-
-      // Write back if changed
-      if (fileChanged) {
-        fs.writeFileSync(file, updatedContent, "utf8");
-        console.log(`✅ Updated: ${file}`);
-        totalFilesUpdated++;
-      }
-    } catch (error) {
-      console.error(`❌ Error processing ${file}:`, error.message);
-    }
-  }
-
-  console.log("\n" + "=".repeat(60));
-  console.log("🎉 Universal Version Standardization Complete!");
-  console.log(`📊 Summary:`);
-  console.log(`   Config Files Updated: ${configFilesUpdated}`);
-  console.log(`   Documentation Files Updated: ${docsUpdated}`);
-  console.log(`   User Guide Files Updated: ${userGuideFilesUpdated}`);
-  console.log(`   Historical Files Updated: ${historicalUpdated}`);
-  console.log(`   Other Files Updated: ${totalFilesUpdated}`);
-  console.log(`   Total Changes: ${totalChanges + configFilesUpdated + docsUpdated + userGuideFilesUpdated + historicalUpdated}`);
-  console.log(`   Framework Version: ${OFFICIAL_VERSIONS.framework.version}`);
-  console.log(
-    `   Codex Version: ${OFFICIAL_VERSIONS.codex.version} (${OFFICIAL_VERSIONS.codex.termsCount} terms)`,
-  );
-  console.log(`   Dependencies Updated: ✅`);
-  console.log(`   Last Updated: ${OFFICIAL_VERSIONS.framework.lastUpdated}`);
-  console.log(`   Backup Created: ${backupCreated ? '✅' : '❌'}`);
-
-  // Show rollback information
-  if (backupCreated && backupDir) {
-    console.log(`\n💾 Backup location: ${backupDir}`);
-    console.log("To rollback changes, run: node scripts/rollback.js");
-  }
-
-  // Run validation
-  const validation = await validateConsistency();
-
-  console.log("\n" + "=".repeat(60));
-
-  // Exit with appropriate code
-  if (!validation.valid) {
-    console.log("\n⚠️  Validation failed. Please review errors above.");
-    process.exit(1);
-  } else if (validation.warnings.length > 0) {
-    console.log("\n✅ Validation passed with warnings.");
-    console.log("⚠️  Please review warnings above.");
-    process.exit(0);
-  } else {
-    console.log("\n✅ All validations passed!");
-    console.log("\n💡 To update versions in the future:");
-    console.log("   1. Edit OFFICIAL_VERSIONS object in this script");
-    console.log("   2. Run: node scripts/standardize-codex-versions.js");
-    console.log("   3. Commit the changes");
-    process.exit(0);
-  }
-}
-
-// Run the standardization
-  standardizeVersions().catch(console.error);
-
-/**
- * Version Manager Enhancements (v2.0.0)
- * =====================================
- *
- * ✅ COMPLETED FEATURES:
- * - Comprehensive documentation management (AGENTS.md, AGENTS-consumer.md, etc.)
- * - File categorization (critical, documentation, historical, test assertions)
- * - Validation step for consistency checking
- * - Changelog generation
- * - Backup creation before changes
- * - Rollback capability
- *
- * 🔄 NEXT STEPS:
- * - Create rollback.js script for restoring from backup
- * - Add automated tests for version consistency
- * - Implement incremental updates (only changed files)
- * - Add caching for unchanged files
- * - Parallel processing for large file sets
- *
- * 📋 FILE CATEGORIES:
- * - Critical: src/opencode/codex.codex, etc.
- * - Documentation: AGENTS.md, AGENTS-consumer.md, docs/*.md
- * - Historical: docs/reflections/, docs/archive/
- * - Test Assertions: context-loader.test.ts, codex-parser.test.ts
- *
- * 🛡️ PROTECTED FILES:
- * - package-lock.json (npm manages this)
- * - package.json (root only)
- *
- * 📊 VALIDATION CHECKS:
- * - codex.json has exactly 60 terms
- * - codex.codex has version v1.3.0 and 60 terms
- * - README.md has correct counts
- * - AGENTS.md has correct information
- * - No files reference old versions
- *
- * 💾 BACKUP LOCATION:
- * - Created in 'backups/version-manager-backup-[timestamp]/'
- * - Includes changelog.md with all changes
- *
- * 📝 TO ROLLBACK:
- * - node scripts/rollback.js [backup-id]
- * - Requires backup to exist
- */
-