0xray 3.0.12 → 3.1.0

package/dist/cli/index.js

@@ -60,7 +60,7 @@ program
         frameworkLogger.log('cli', 'install-success', 'info', { message: 'xray framework installed' });
         // UX banner kept for user visibility post-install (non-removable per exception)
         console.log("✅ xray framework installed!");
-        console.log("💡 Run 'npx 0xray setup' for full configuration (hooks, Hermes, symlinks)");
+        console.log("💡 Run 'npx xray setup' for full configuration (hooks, Hermes, symlinks)");
     }
     catch (error) {
         frameworkLogger.log('cli', 'install-error', 'error', { error: error instanceof Error ? error.message : String(error) });
@@ -181,7 +181,7 @@ program
     console.log("  2. Use @architect for complex development tasks");
     console.log("  3. Access skills for specialized capabilities");
     console.log("  4. Check framework-reporting-system for activity reports");
-    console.log('  5. Run "npx 0xray capabilities" anytime for this overview');
+    console.log('  5. Run "npx xray capabilities" anytime for this overview');
 });
 program
     .command("health")
@@ -248,7 +248,7 @@ program
             console.log("  • framework-reporting-system");
         }
         else {
-            console.log('⚠️ Some components need attention. Run "npx 0xray install" to fix.');
+            console.log('⚠️ Some components need attention. Run "npx xray install" to fix.');
         }
     }
     catch (error) {
@@ -324,7 +324,7 @@ program
         console.log("");
         console.log("💡 Troubleshooting:");
         console.log("  • Make sure OpenCode is running");
-        console.log("  • Check framework installation: npx 0xray status");
+        console.log("  • Check framework installation: npx xray status");
         console.log("  • Try manual report: framework-reporting-system generate-report");
         process.exit(1);
     }
@@ -351,7 +351,7 @@ program
         console.log("");
         console.log("💡 Next steps:");
         console.log("  • Restart OpenCode to load the restored configuration");
-        console.log("  • Run: npx 0xray health (to verify everything works)");
+        console.log("  • Run: npx xray health (to verify everything works)");
         console.log("  • Try: @security-auditor scan this project");
     }
     catch (error) {
@@ -359,11 +359,65 @@ program
         console.log("");
         console.log("💡 Manual fix options:");
         console.log("  • Delete .opencode/ and .xray/ directories");
-        console.log("  • Run: npx 0xray install");
+        console.log("  • Run: npx xray install");
         console.log("  • Or manually restore missing configuration files");
         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)")
@@ -396,20 +450,20 @@ program
         else {
             console.log("✅ xray package installed");
         }
-        // Check configuration - check for opencode.json or .xray/ (min compat .xray/ fallback for prior StringRay consumer runtime per Scope Rule; plain xray primary)
+        // Check configuration - check for opencode.json or .xray/ (min compat .xray/ fallback for prior 0xRay consumer runtime per Scope Rule; plain xray primary)
         const cwd = process.cwd();
         const opencodeConfigPath = path.join(cwd, "opencode.json");
-        const xrayDir = getConfigDir(cwd);
+        const strrayDir = getConfigDir(cwd);
         const opencodeExists = fs.existsSync(opencodeConfigPath);
-        const xrayDirExists = fs.existsSync(xrayDir);
+        const configDirExists = fs.existsSync(strrayDir);
         if (opencodeExists) {
             console.log("✅ opencode configuration found");
         }
-        else if (xrayDirExists) {
-            console.log(`✅ Configuration directory found: ${xrayDir}`);
+        else if (configDirExists) {
+            console.log(`✅ Configuration directory found: ${strrayDir}`);
         }
         else {
-            console.log("ℹ️  No opencode.json or config directory found (run: npx 0xray fix to create)");
+            console.log("ℹ️  No opencode.json or config directory found (run: npx xray fix to create)");
         }
         // Check for common issues
         const mcpConfigExists = fs.existsSync(path.join(process.cwd(), ".mcp.json"));
@@ -423,8 +477,8 @@ program
             console.log("");
             console.log("💡 Pro tips:");
             console.log("  • Use @security-auditor for code quality checks");
-            console.log("  • Run reports regularly: npx 0xray report");
-            console.log("  • Check health anytime: npx 0xray health");
+            console.log("  • Run reports regularly: npx xray report");
+            console.log("  • Check health anytime: npx xray health");
         }
         else {
             console.log("⚠️ Issues found:");
@@ -432,7 +486,7 @@ program
                 console.log(`  ${i + 1}. ${issue}`);
             });
             console.log("");
-            console.log('🔧 Run "npx 0xray fix" to automatically fix these issues');
+            console.log('🔧 Run "npx xray fix" to automatically fix these issues');
         }
     }
     catch (error) {
@@ -440,6 +494,40 @@ 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')
@@ -547,7 +635,7 @@ program
         console.log('✅ Tuning cycle complete');
         return;
     }
-    console.log('Usage: npx 0xray inference:tuner [options]');
+    console.log('Usage: npx xray inference:tuner [options]');
     console.log('  --start     Start the tuner service');
     console.log('  --stop      Stop the tuner service');
     console.log('  --run-once  Run a single tuning cycle');
@@ -596,14 +684,14 @@ program
         }
         else {
             console.log('Inference feature is disabled in features.json.');
-            console.log('Enable it by setting inference.enabled = true in .opencode/plugins/features.json (min compat .xray/ fallback for prior StringRay consumer runtime per Scope Rule)');
+            console.log('Enable it by setting inference.enabled = true in .opencode/plugins/features.json (min compat .xray/ fallback for prior 0xRay consumer runtime per Scope Rule)');
         }
         return;
     }
     const projectRoot = process.cwd();
     const inferenceDir = `${projectRoot}/docs/inference`;
     const stateDir = `${projectRoot}/.xray/inference`;
-    const stateFile = `${stateDir}/inference-state.json`;
+    const stateFile = `${stateDir}/inference-cycle-state.json`;
     if (!options.json) {
         console.log('xray Inference Cycle');
         console.log('====================');
@@ -677,6 +765,35 @@ 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]')
@@ -699,21 +816,64 @@ 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')
     .description('Run an MCP server subprocess (used by Grok/OpenCode .mcp.json)')
-    .argument('<server>', 'Server name: governance, skills, enforcer, orchestrator')
+    .argument('<server>', 'Server name: governance or skills')
     .action(async (server) => {
     const serverMap = {
         governance: 'dist/mcps/governance.server.js',
         skills: 'dist/mcps/knowledge-skills/skill-invocation.server.js',
-        enforcer: 'dist/mcps/enforcer-tools.server.js',
-        orchestrator: 'dist/mcps/orchestrator/server.js',
     };
     const relPath = serverMap[server];
     if (!relPath) {
-        console.error(`Unknown MCP server: ${server}. Use: governance, skills, enforcer, orchestrator`);
+        console.error(`Unknown MCP server: ${server}. Use: governance, skills`);
         process.exit(1);
     }
     const serverPath = resolve(join(packageRoot, relPath));
@@ -722,6 +882,9 @@ program
         process.exit(1);
     }
     const env = { ...process.env };
+    if (server === 'governance') {
+        env.STRRAY_FORCE_MCP_GOVERNANCE = 'true';
+    }
     const child = spawn(process.execPath, [serverPath], { stdio: 'inherit', env });
     child.on('exit', (code) => process.exit(code ?? 0));
 });
@@ -741,37 +904,50 @@ registerOpenClawCommands(openclawCmd);
 const opencodeCmd = program.command('opencode').description('OpenCode integration commands');
 const { registerOpencodeCommands } = await import('./commands/opencode-install.js');
 registerOpencodeCommands(opencodeCmd);
-// Security audit command
-program
-    .command("security-audit")
-    .description("Run comprehensive security audit with vulnerability scanning, compliance checking, and architectural decisions")
+// Analytics enable command
+// Plugin subcommands
+const pluginCmd = program.command('plugin').description('Manage plugins');
+pluginCmd
+    .command('list')
+    .description('List installed plugins')
     .action(async () => {
-    const { securityAuditCommand } = await import("./commands/security-audit.js");
-    await securityAuditCommand();
+    const { pluginListCommand } = await import('./commands/plugin-commands.js');
+    await pluginListCommand();
 });
-// 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);
+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);
 });
 // Add help text
 program.addHelpText("after", `
@@ -786,11 +962,13 @@ 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 security-audit --deep  # Run deep security audit
-    $ 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"}]'
+    $ 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 storyteller saga "v1.18.0 Journey"  # Write a saga
+    $ npx 0xray storyteller reflection "API Fix"     # Write a reflection
 
 Quick Start:
    1. Install: npx 0xray install
@@ -798,19 +976,11 @@ Quick Start:
    3. Use agents: @security-auditor scan
    4. Generate reports: npx 0xray report
    5. Fix issues: npx 0xray fix
-   6. Add skills: npx 0xray skill:install agency-agents
+   6. View analytics: npx 0xray analytics
+   7. Add skills: npx 0xray skill:install agency-agents
 
 For more information, visit: https://github.com/0xRayAI/xray
 `);
 // Parse command line arguments
 program.exitOverride();
-try {
-    program.parse();
-}
-catch (err) {
-    if (err instanceof Error && 'code' in err && err.code === 'commander.help') {
-        process.exit(0);
-    }
-    throw err;
-}
-//# sourceMappingURL=index.js.map
+program.parse();

package/dist/cli/server.js

@@ -0,0 +1,147 @@
+import express from "express";
+import { exec } from "child_process";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import * as fs from "fs";
+import * as crypto from "crypto";
+import { frameworkLogger } from "../core/framework-logger.js";
+import { resolveConfigPath } from "../core/config-paths.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT_DIR = join(__dirname, "..", "..");
+const PUBLIC_DIR = join(ROOT_DIR, "public");
+// Read version dynamically from package.json
+const packageJsonPath = join(ROOT_DIR, "package.json");
+const { version } = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+const app = express();
+const PORT = 3000;
+const API_KEY = process.env.XRAY_API_KEY || undefined;
+function timingSafeCompare(a, b) {
+    const aBuf = Buffer.from(a, "utf-8");
+    const bBuf = Buffer.from(b, "utf-8");
+    if (aBuf.length !== bBuf.length)
+        return false;
+    return crypto.timingSafeEqual(aBuf, bBuf);
+}
+function requireAuth(req, res, next) {
+    if (!API_KEY) {
+        frameworkLogger.log("cli-server", "auth-skipped", "warning", {
+            message: "No XRAY_API_KEY set — API is unauthenticated. Set XRAY_API_KEY in production.",
+        });
+        return next();
+    }
+    const providedKey = req.headers["x-api-key"];
+    if (typeof providedKey !== "string") {
+        return res.status(401).json({ error: "API key required. Set XRAY_API_KEY environment variable." });
+    }
+    if (!timingSafeCompare(providedKey, API_KEY)) {
+        return res.status(403).json({ error: "Invalid API key" });
+    }
+    next();
+}
+// Lazy load security headers middleware
+let securityMiddleware = null;
+const getSecurityMiddleware = async () => {
+    if (!securityMiddleware) {
+        try {
+            const { securityHeadersMiddleware } = await import("../security/security-headers");
+            securityMiddleware = securityHeadersMiddleware.getExpressMiddleware();
+        }
+        catch (error) {
+            frameworkLogger.log("cli-server", "security-middleware-unavailable", "warning", {
+                message: "Security middleware not available, continuing without security headers",
+            });
+            securityMiddleware = (req, res, next) => next(); // No-op middleware
+        }
+    }
+    return securityMiddleware;
+};
+// Apply security headers middleware lazily
+app.use(async (req, res, next) => {
+    try {
+        const middleware = await getSecurityMiddleware();
+        middleware(req, res, next);
+    }
+    catch (error) {
+        frameworkLogger.log("cli-server", "security-middleware-load-failed", "warning", {
+            error,
+            message: "Security middleware failed to load, continuing without it",
+        });
+        next();
+    }
+});
+// Serve static files
+app.use(express.static(PUBLIC_DIR));
+// API endpoints
+app.get("/api/status", requireAuth, (req, res) => {
+    // Return framework status
+    res.json({
+        framework: "0xRay",
+        version,
+        status: "active",
+        agents: 8,
+        timestamp: new Date().toISOString(),
+    });
+});
+app.get("/api/agents", requireAuth, (req, res) => {
+    // Return agent configurations
+    res.json({
+        agents: [
+            "architect",
+            "bug-triage-specialist",
+            "code-reviewer",
+            "security-auditor",
+            "refactorer",
+            "testing-lead",
+        ],
+    });
+});
+// Performance monitoring middleware
+app.use((req, res, next) => {
+    const start = process.hrtime.bigint();
+    res.on("finish", () => {
+        const end = process.hrtime.bigint();
+        const duration = Number(end - start) / 1e6; // Convert to milliseconds
+        // HTTP request logging - operational, keep for monitoring
+    });
+    next();
+});
+// Add route for root path
+app.get("/", (req, res) => {
+    res.sendFile(join(PUBLIC_DIR, "index.html"));
+});
+// Add route for refactoring logs
+app.get("/logs", requireAuth, async (req, res) => {
+    const logPath = resolveConfigPath("REFACTORING_LOG.md") || join(__dirname, "..", ".xray", "REFACTORING_LOG.md");
+    // Server debug logging - remove for production
+    try {
+        if (fs.existsSync(logPath)) {
+            const content = fs.readFileSync(logPath, "utf-8");
+            res.setHeader("Content-Type", "text/markdown");
+            res.send(content);
+        }
+        else {
+            res
+                .status(404)
+                .send("Refactoring log not found. The framework may not have generated any logs yet.");
+        }
+    }
+    catch (error) {
+        // File read error - remove debug logging
+        res.status(500).send("Server error reading log file.");
+    }
+});
+// Global error handler (4-param middleware must be registered before listen)
+app.use((err, req, res, _next) => {
+    frameworkLogger.log("cli-server", "unhandled-error", "error", { error: err, path: req.path });
+    res.status(500).send("Internal Server Error");
+});
+app.listen(PORT, () => {
+    // Auto-open browser
+    const start = process.platform === "darwin"
+        ? "open"
+        : process.platform === "win32"
+            ? "start"
+            : "xdg-open";
+    exec(`${start} http://localhost:${PORT}`);
+});

package/dist/config/default-agents.js

@@ -14,4 +14,3 @@ export function getDefaultAgents() {
 export function getDefaultAgentByName(name) {
     return DEFAULT_AGENTS.find(agent => agent.name === name);
 }
-//# sourceMappingURL=default-agents.js.map

package/dist/config/routing-mappings.js

@@ -130,4 +130,22 @@ export function queryRoutingMappings(keywords) {
 export function getAllRoutingMappings() {
     return ROUTING_MAPPINGS;
 }
-//# sourceMappingURL=routing-mappings.js.map
+/**
+ * Validate that all agent names in routing mappings exist in the SSOT.
+ * Call at boot to detect drift.
+ */
+export function validateRoutingMappings(validAgents) {
+    const errors = [];
+    const seen = new Set();
+    for (const mapping of ROUTING_MAPPINGS) {
+        if (!validAgents.includes(mapping.agent)) {
+            errors.push(`Routing mapping references unknown agent "${mapping.agent}" (keywords: ${mapping.keywords.slice(0, 2).join(", ")})`);
+        }
+        const key = `${mapping.agent}:${mapping.skill}`;
+        if (seen.has(key)) {
+            errors.push(`Duplicate routing mapping: agent="${mapping.agent}" skill="${mapping.skill}"`);
+        }
+        seen.add(key);
+    }
+    return errors;
+}

package/dist/core/activity-logger.js

@@ -9,8 +9,8 @@
  * - Test results
  *
  * Enable/Disable via:
- *   XRAY_ACTIVITY_LOGGING=true  (enable)
- *   XRAY_ACTIVITY_LOGGING=false (disable, default)
+ *   STRRAY_ACTIVITY_LOGGING=true  (enable)
+ *   STRRAY_ACTIVITY_LOGGING=false (disable, default)
  *
  * @module core/activity-logger
  * @version 1.0.0
@@ -21,7 +21,7 @@ import * as zlib from "zlib";
 import { frameworkLogger } from "./framework-logger.js";
 const MAX_LOG_SIZE_BYTES = 5 * 1024 * 1024; // 5MB before rotation
 // Global state
-let activityLoggerEnabled = process.env.XRAY_ACTIVITY_LOGGING !== "false";
+let activityLoggerEnabled = process.env.STRRAY_ACTIVITY_LOGGING !== "false";
 let activityLogPath;
 let sessionId;
 let sessionStartTime;
@@ -184,7 +184,7 @@ export function logActivity(category, level, action, message, details, options)
     // Write to report JSON
     writeToReportFile(record);
     // Console output for debug mode
-    if (process.env.XRAY_ACTIVITY_CONSOLE === "true") {
+    if (process.env.STRRAY_ACTIVITY_CONSOLE === "true") {
         frameworkLogger.log("activity-logger", "console-output", "info", { message: `[${record.timestamp}] [${record.category}] ${level.toUpperCase()}: ${message}`, details: details || "" });
     }
 }
@@ -258,4 +258,3 @@ process.on("exit", () => {
         duration: Date.now() - sessionStartTime,
     });
 });
-//# sourceMappingURL=activity-logger.js.map