0xray 2.1.4 → 2.2.1

package/dist/cli/index.js

@@ -364,60 +364,6 @@ program
         process.exit(1);
     }
 });
-// Analytics command - pattern analysis, insights, and consent management
-program
-    .command("analytics")
-    .description("xray Central Analytics - Pattern analysis, insights, and consent management\n" +
-    "  In v1.7.2+: Includes consent management with granular control\n" +
-    "  Use 'npx xray analytics enable' to opt-in to data sharing\n" +
-    "  Core classes: ConsentManager, AnonymizationEngine available programmatically")
-    .option("-l, --limit <number>", "Limit analysis to last N task completions")
-    .option("-o, --output <file>", "Save report to file")
-    .action(async (opts) => {
-    console.log("📊 xray Pattern Analytics");
-    console.log("==============================");
-    console.log("");
-    try {
-        // Dynamic import to avoid loading analytics module unless needed
-        const { SimplePatternAnalyzer } = await import("../analytics/simple-pattern-analyzer.js");
-        // Get default limit from features.json
-        const fs = await import("fs");
-        const path = await import("path");
-        let defaultLimit = 500;
-        try {
-            const featuresPath = path.join(process.cwd(), ".opencode", "plugins", "features.json"); // plain xray primary (min compat .xray/ handled in getConfigDir per Scope Rule)
-            if (fs.existsSync(featuresPath)) {
-                const features = JSON.parse(fs.readFileSync(featuresPath, "utf-8"));
-                defaultLimit = features.analytics?.default_limit || 500;
-            }
-        }
-        catch { /* use default */ }
-        const analyzer = new SimplePatternAnalyzer();
-        const limit = parseInt(opts.limit) || defaultLimit;
-        console.log(`Analyzing last ${limit} task completions...`);
-        console.log("");
-        const insights = await analyzer.analyze(limit);
-        const insightsLines = analyzer.generateInsights(insights);
-        // Print insights
-        insightsLines.forEach((line) => {
-            console.log(line);
-        });
-        // Save to file if requested
-        if (opts.output) {
-            const fs = await import("fs");
-            const report = await analyzer.generateReport();
-            fs.writeFileSync(opts.output, report);
-            console.log("");
-            console.log(`✅ Report saved to: ${opts.output}`);
-        }
-        console.log("");
-        console.log("💡 Run regularly to track agent performance and complexity accuracy");
-    }
-    catch (error) {
-        console.error("❌ Analytics failed:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
 program
     .command("doctor")
     .description("Diagnose framework issues (does not fix them)")
@@ -494,40 +440,6 @@ program
         process.exit(1);
     }
 });
-// Archive logs command - standalone, no framework boot required
-program
-    .command("archive-logs")
-    .description("Archive log files without framework boot (for git hooks)")
-    .option("--dry-run", "Show what would be archived without making changes")
-    .option("-v, --verbose", "Verbose output")
-    .action(async (opts) => {
-    console.log("📦 xray Log Archive");
-    console.log("========================");
-    if (opts.dryRun) {
-        console.log("(Dry run mode - no changes will be made)");
-    }
-    try {
-        // Import and run standalone archiver
-        const archiveModule = await import("./commands/archive-logs.js");
-        const result = await archiveModule.archiveLogFiles({
-            maxFileSizeMB: 10,
-            rotationIntervalHours: 24,
-            compressionEnabled: true,
-            maxArchives: 10,
-        }, `cli-${Date.now()}`);
-        console.log(`\n📊 Results:`);
-        console.log(`  Archived: ${result.archived} files`);
-        if (result.errors.length > 0) {
-            console.log(`  Errors: ${result.errors.length}`);
-            result.errors.forEach((e) => console.log(`    - ${e}`));
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        console.error("Archive failed:", error);
-        process.exit(1);
-    }
-});
 // Inference improvement command
 program
     .command('inference:improve')
@@ -691,7 +603,7 @@ program
     const projectRoot = process.cwd();
     const inferenceDir = `${projectRoot}/docs/inference`;
     const stateDir = `${projectRoot}/.xray/inference`;
-    const stateFile = `${stateDir}/inference-cycle-state.json`;
+    const stateFile = `${stateDir}/inference-state.json`;
     if (!options.json) {
         console.log('xray Inference Cycle');
         console.log('====================');
@@ -765,35 +677,6 @@ program
         }
     }
 });
-// Publish agent command
-program
-    .command('publish-agent')
-    .description('Package and publish agents to AgentStore')
-    .option('-a, --agent <name>', 'Agent name to publish')
-    .option('-v, --version <version>', 'Version to publish (default: 1.0.0)')
-    .option('-d, --dry-run', 'Show what would be published without publishing')
-    .action(async () => {
-    const { publishAgentCommand } = await import('./commands/publish-agent.js');
-    await publishAgentCommand();
-});
-// Antigravity status command
-program
-    .command('antigravity status')
-    .description('Show status of all installed skills')
-    .action(async () => {
-    const { antigravityStatusCommand } = await import('./commands/antigravity-status.js');
-    await antigravityStatusCommand();
-});
-// Credible init command
-program
-    .command('credible init')
-    .description('Initialize Credible Pod infrastructure')
-    .option('-n, --name <name>', 'Pod name')
-    .option('-t, --template <template>', 'Pod template to use')
-    .action(async () => {
-    const { credibleInitCommand } = await import('./commands/credible-init.js');
-    await credibleInitCommand();
-});
 // Skill registry command
 program
     .command('skill:registry [action]')
@@ -816,51 +699,6 @@ program
     const { skillInstallCommand } = await import('./commands/skill-install.js');
     await skillInstallCommand(sourceArg, options);
 });
-// Storyteller command
-program
-    .command('storyteller [type]')
-    .description('Write reflections, sagas, journeys, or narratives')
-    .option('-t, --title <title>', 'Title for the story')
-    .option('-f, --framework <framework>', 'Storytelling framework (three_act_structure, hero_journey, spiral)')
-    .option('-o, --output <file>', 'Output file path')
-    .option('--dry-run', 'Show prompt without creating file')
-    .action(async (type, options) => {
-    const { storytellerCommand } = await import('./commands/storyteller.js');
-    await storytellerCommand(type, options);
-});
-// MCP install commands - support both hyphen and colon formats
-program
-    .command('mcp-list')
-    .alias('mcp:list')
-    .description('List available community MCP servers')
-    .action(async () => {
-    const { listMCPsCommand } = await import('./commands/mcp-install.js');
-    listMCPsCommand();
-});
-program
-    .command('mcp-status')
-    .alias('mcp:status')
-    .description('Show installed MCP servers')
-    .action(async () => {
-    const { showMCPStatusCommand } = await import('./commands/mcp-install.js');
-    showMCPStatusCommand();
-});
-program
-    .command('mcp-install <name>')
-    .alias('mcp:install')
-    .description('Install an MCP server from the registry')
-    .action(async (name) => {
-    const { installMCPCommand } = await import('./commands/mcp-install.js');
-    await installMCPCommand(name);
-});
-program
-    .command('mcp-remove <name>')
-    .alias('mcp:remove')
-    .description('Remove an installed MCP server')
-    .action(async (name) => {
-    const { removeMCPCommand } = await import('./commands/mcp-install.js');
-    removeMCPCommand(name);
-});
 // MCP server subprocess launchers (used by Grok plugin .mcp.json via npx)
 program
     .command('mcp')
@@ -905,51 +743,6 @@ registerOpenClawCommands(openclawCmd);
 const opencodeCmd = program.command('opencode').description('OpenCode integration commands');
 const { registerOpencodeCommands } = await import('./commands/opencode-install.js');
 registerOpencodeCommands(opencodeCmd);
-// Analytics enable command
-// Plugin subcommands
-const pluginCmd = program.command('plugin').description('Manage plugins');
-pluginCmd
-    .command('list')
-    .description('List installed plugins')
-    .action(async () => {
-    const { pluginListCommand } = await import('./commands/plugin-commands.js');
-    await pluginListCommand();
-});
-pluginCmd
-    .command('install <name>')
-    .description('Install a plugin')
-    .action(async (name) => {
-    const { pluginInstallCommand } = await import('./commands/plugin-commands.js');
-    await pluginInstallCommand(name);
-});
-pluginCmd
-    .command('enable <name>')
-    .description('Enable a plugin')
-    .action(async (name) => {
-    const { pluginEnableCommand } = await import('./commands/plugin-commands.js');
-    await pluginEnableCommand(name);
-});
-pluginCmd
-    .command('disable <name>')
-    .description('Disable a plugin')
-    .action(async (name) => {
-    const { pluginDisableCommand } = await import('./commands/plugin-commands.js');
-    await pluginDisableCommand(name);
-});
-pluginCmd
-    .command('status <name>')
-    .description('Show plugin details')
-    .action(async (name) => {
-    const { pluginStatusCommand } = await import('./commands/plugin-commands.js');
-    await pluginStatusCommand(name);
-});
-pluginCmd
-    .command('uninstall <name>')
-    .description('Uninstall a plugin')
-    .action(async (name) => {
-    const { pluginUninstallCommand } = await import('./commands/plugin-commands.js');
-    await pluginUninstallCommand(name);
-});
 // Security audit command
 program
     .command("security-audit")
@@ -958,6 +751,30 @@ program
     const { securityAuditCommand } = await import("./commands/security-audit.js");
     await securityAuditCommand();
 });
+// v3 nucleus: primary governance command
+program
+    .command("govern")
+    .description("Run the xray governance kernel")
+    .option("--status", "Show framework status")
+    .option("--audit", "Run security audit")
+    .option("--mcp <server>", "Run an MCP server subprocess (governance, skills)")
+    .option("--plugin-install <name>", "Install a plugin")
+    .option("--proposals <json>", "Run governance on JSON proposals")
+    .option("--skill-install [source]", "Install skills from registry")
+    .option("--skill-registry [action]", "Manage skill registry sources")
+    .option("--storyteller <type>", "Write a story (reflection|saga|journey|narrative)")
+    .option("--mcp-list", "List available MCP servers")
+    .option("--mcp-status", "Show installed MCP servers")
+    .option("--mcp-install <name>", "Install an MCP server")
+    .option("--mcp-remove <name>", "Remove an MCP server")
+    .option("--publish-agent", "Publish an agent to AgentStore")
+    .option("--archive-logs", "Archive log files")
+    .option("--credible-init [name]", "Initialize Credible Pod")
+    .option("--antigravity-status", "Show installed skills status")
+    .action(async (options) => {
+    const { governCommand } = await import("./commands/govern.js");
+    await governCommand(options);
+});
 // Add help text
 program.addHelpText("after", `
 
@@ -971,14 +788,11 @@ Examples:
     $ npx 0xray report        # Generate activity and health reports
     $ npx 0xray fix           # Automatically restore missing config files
     $ npx 0xray doctor        # Diagnose issues (does not fix them)
-    $ npx 0xray analytics     # Pattern analytics and insights
     $ npx 0xray inference:improve  # Run autonomous inference improvement
-    $ npx 0xray skill:install agency-agents  # Install 170+ agency agent skills
-    $ npx 0xray skill:install superpowers      # Install 14 agentic workflow skills
-    $ npx 0xray skill:install <github-url>     # Install from any repo
     $ npx 0xray security-audit --deep  # Run deep security audit
-    $ npx 0xray storyteller saga "v1.18.0 Journey"  # Write a saga
-    $ npx 0xray storyteller reflection "API Fix"     # Write a reflection
+    $ npx 0xray govern                  # Run the governance kernel
+    $ npx 0xray govern --status        # Show status (v3 nucleus)
+    $ npx 0xray govern --proposals '[{"type":"fix","title":"Test","description":"A test"}]'
 
 Quick Start:
    1. Install: npx 0xray install
@@ -986,8 +800,7 @@ Quick Start:
    3. Use agents: @security-auditor scan
    4. Generate reports: npx 0xray report
    5. Fix issues: npx 0xray fix
-   6. View analytics: npx 0xray analytics
-   7. Add skills: npx 0xray skill:install agency-agents
+   6. Add skills: npx 0xray skill:install agency-agents
 
 For more information, visit: https://github.com/0xRayAI/xray
 `);

package/dist/core/boot-orchestrator.js

@@ -717,9 +717,9 @@ export class BootOrchestrator {
         try {
             // Consumer runtime compat (XRAY_ env + .xray fallbacks)
             const xrayConfig = {
-                version: "2.1.3",
+                version: "2.2.0",
                 codex_enabled: true,
-                codex_version: "v2.1.1",
+                codex_version: "v3.0.0",
                 codex_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,

package/dist/core/features-config.js

@@ -286,7 +286,7 @@ export class FeaturesConfigLoader {
      */
     getDefaultConfig() {
         return {
-            version: "2.1.3",
+            version: "2.2.0",
             description: "0xRay Framework - Unified Feature Configuration",
             token_optimization: {
                 enabled: true,

package/dist/core/framework-logger.d.ts

@@ -72,5 +72,6 @@ export declare class FrameworkUsageLogger {
     getRecentLogs(count?: number): FrameworkLogEntry[];
     getComponentUsage(component: string): FrameworkLogEntry[];
     printRundown(): void;
+    flushSync(): void;
 }
 export declare const frameworkLogger: FrameworkUsageLogger;

package/dist/core/framework-logger.js

@@ -1,5 +1,4 @@
-import { isLoggingEnabled, shouldLog, } from "./logging-config.js";
-import { promises as fs, existsSync, mkdirSync } from "fs";
+import { promises as fs, existsSync, mkdirSync, appendFileSync } from "fs";
 import { join } from "path";
 /**
  * Generate a unique job ID for tracking work sessions
@@ -94,6 +93,36 @@ export function withJobContext(operation, jobId) {
         throw error;
     }
 }
+const defaultLoggingConfig = {
+    enabled: (process.env.XRAY_LOGGING_ENABLED) !== "false",
+    level: (process.env.XRAY_LOG_LEVEL) || "info",
+    destinations: ["console", "file"],
+    performanceMode: (process.env.XRAY_PERFORMANCE_MODE) === "true",
+};
+const LOG_LEVELS = ["debug", "info", "warn", "error"];
+let globalLoggingConfig = { ...defaultLoggingConfig };
+function isLoggingEnabled() {
+    return globalLoggingConfig.enabled;
+}
+function shouldLog(level) {
+    if (!globalLoggingConfig.enabled)
+        return false;
+    const currentLevelIndex = LOG_LEVELS.indexOf(globalLoggingConfig.level);
+    const messageLevelIndex = LOG_LEVELS.indexOf(level);
+    if (currentLevelIndex === -1 || messageLevelIndex === -1)
+        return true;
+    return messageLevelIndex >= currentLevelIndex;
+}
+// Module-level side effects for env var config (previously in logging-config.ts)
+if (process.env.XRAY_LOGGING_ENABLED === "false") {
+    globalLoggingConfig.enabled = false;
+}
+if (process.env.XRAY_LOG_LEVEL) {
+    globalLoggingConfig.level = process.env.XRAY_LOG_LEVEL;
+}
+if (process.env.XRAY_PERFORMANCE_MODE === "true") {
+    globalLoggingConfig.performanceMode = true;
+}
 export class JobContext {
     jobId;
     startTime;
@@ -275,8 +304,34 @@ export class FrameworkUsageLogger {
     printRundown() {
         // Framework usage analytics placeholder
     }
+    flushSync() {
+        if (this.flushing || this.buffer.length === 0)
+            return;
+        const toWrite = this.buffer.splice(0, this.buffer.length);
+        const data = toWrite.join("");
+        try {
+            const cwd = process.cwd();
+            if (!cwd)
+                return;
+            const logDir = join(cwd, "logs", "framework");
+            const logFile = join(logDir, "activity.log");
+            if (!existsSync(logDir)) {
+                mkdirSync(logDir, { recursive: true });
+            }
+            appendFileSync(logFile, data);
+        }
+        catch {
+            // flush failure is non-fatal
+        }
+    }
 }
 export const frameworkLogger = new FrameworkUsageLogger();
+// Flush buffer synchronously on exit so CLI commands don't lose log entries
+if (typeof process !== "undefined" && process.env?.NODE_ENV !== "test") {
+    process.on("exit", () => {
+        frameworkLogger.flushSync();
+    });
+}
 // Startup self-test: verify logger works
 if (typeof process !== "undefined" && process.env?.NODE_ENV !== "test") {
     frameworkLogger.log("system", "logger initialized", "info").catch(() => { });

package/dist/delegation/index.d.ts

@@ -13,10 +13,9 @@ export { SessionCoordinator, createSessionCoordinator, } from "./session-coordin
 export { RoutingOutcomeTracker, routingOutcomeTracker, } from "./analytics/index.js";
 export { RoutingAnalytics } from "./analytics/index.js";
 export { LearningEngine, learningEngine } from "./analytics/index.js";
-export { VotingCoordinator, createVotingCoordinator, } from "./voting-coordinator.js";
 export { WeightedVotingAggregator, createWeightedVotingAggregator, createDetailedVotingResult, DEFAULT_HISTORICAL_CONFIG, DEFAULT_CONFIDENCE_CONFIG, } from "./weighted-voting-aggregator.js";
 export { AdaptiveStrategySelector, adaptiveStrategySelector, selectVotingStrategy, } from "./strategy-selector.js";
-export { getAgentExpertise, getAgentExpertiseLevel, getVotingWeight, getAgentsWithExpertiseDomain, getTopExpertsForDomain, } from "./agent-expertise.js";
+export { getAgentExpertise, getAgentExpertiseLevel, getVotingWeight, } from "./agent-expertise.js";
 export type { VotingSession, VotingStrategy, VoteChoice, VotingResult, VotingResultDetail, AgentExpertise, StrategySelectionContext, VotingHistoryEntry, AdaptiveStrategyConfig, VotingMetrics, ConflictResolutionRequest, ConflictResolutionResponse, } from "./voting-types.js";
 export type { ComplexityMetrics, ComplexityScore, ComplexityThresholds, } from "./complexity-analyzer.js";
 export type { DelegationRequest, DelegationResult, AgentCapability, DelegationMetrics, } from "./agent-delegator.js";

package/dist/delegation/index.js

@@ -13,8 +13,7 @@ export { SessionCoordinator, createSessionCoordinator, } from "./session-coordin
 export { RoutingOutcomeTracker, routingOutcomeTracker, } from "./analytics/index.js";
 export { RoutingAnalytics } from "./analytics/index.js";
 export { LearningEngine, learningEngine } from "./analytics/index.js";
-export { VotingCoordinator, createVotingCoordinator, } from "./voting-coordinator.js";
 export { WeightedVotingAggregator, createWeightedVotingAggregator, createDetailedVotingResult, DEFAULT_HISTORICAL_CONFIG, DEFAULT_CONFIDENCE_CONFIG, } from "./weighted-voting-aggregator.js";
 export { AdaptiveStrategySelector, adaptiveStrategySelector, selectVotingStrategy, } from "./strategy-selector.js";
-export { getAgentExpertise, getAgentExpertiseLevel, getVotingWeight, getAgentsWithExpertiseDomain, getTopExpertsForDomain, } from "./agent-expertise.js";
+export { getAgentExpertise, getAgentExpertiseLevel, getVotingWeight, } from "./agent-expertise.js";
 export { AgentMetricsSystem, getAgentMetricsSystem, initializeAgentMetrics, resetAgentMetricsSystem, } from "../metrics/agent-metrics.js";

package/dist/enforcement/enforcer-tools.js

@@ -20,7 +20,7 @@ const ROUTING_MAPPINGS = [
     // Core built-in skills (high confidence)
     { keywords: ["write", "file", "create"], skill: "code-review", agent: "code-reviewer", confidence: 0.9 },
     { keywords: ["review", "audit", "assess", "evaluate", "check", "inspect", "quality", "validate", "code-review"], skill: "code-review", agent: "code-reviewer", confidence: 0.9 },
-    { keywords: ["test", "testing", "jest", "coverage", "unit", "e2e", "cypress", "spec", "verify"], skill: "testing-best-practices", agent: "testing-lead", confidence: 0.95 },
+    { keywords: ["test", "testing", "jest", "coverage", "unit", "e2e", "cypress", "spec", "verify"], skill: "testing-strategy", agent: "testing-lead", confidence: 0.95 },
     { keywords: ["fix", "debug", "triage", "broken", "error", "crash", "bug", "issue", "resolve"], skill: "bug-triage", agent: "bug-triage-specialist", confidence: 0.92 },
     { keywords: ["security", "vulnerability", "threat", "scan", "risk", "exploit", "secure", "pentest"], skill: "security-audit", agent: "security-auditor", confidence: 0.95 },
     { keywords: ["refactor", "cleanup", "improve", "restructure", "modernize", "debt"], skill: "refactoring-strategies", agent: "refactorer", confidence: 0.92 },

package/dist/execution/proposal-applier.d.ts

@@ -6,19 +6,11 @@ export interface ApplyResult {
     details?: string[];
     error?: string;
 }
-export type CodeChangeCallback = (proposal: InferenceProposal) => Promise<boolean>;
-export type ReviewCallback = (proposal: InferenceProposal, prUrl: string) => Promise<"go" | "no-go" | "modify">;
 export declare class ProposalApplier {
     private projectRoot;
-    private codeChangeCallback?;
-    private reviewCallback?;
-    constructor(projectRoot?: string, codeChangeCallback?: CodeChangeCallback | undefined, reviewCallback?: ReviewCallback | undefined);
+    constructor(projectRoot?: string);
     applyProposals(proposals: InferenceProposal[]): Promise<ApplyResult[]>;
-    private applyProposal;
     private applyCodification;
-    private isInsideGitRepo;
     private getAppliedMarkerPath;
     private recordAppliedProposal;
-    private createPR;
 }
-export declare const proposalApplier: ProposalApplier;