0xray 2.2.4 → 3.0.0

package/dist/integrations/governance/index.js

@@ -94,25 +94,32 @@ export class InferenceGovernanceIntegration extends BaseIntegration {
      * Routes to govern_with_solar (strategic proposals) or evaluate_governance
      * (technical proposals) based on proposal type.
      */
-    async checkProposal(proposal, agentReviews = [], historicalIds = []) {
+    async checkProposal(proposal, agentReviews = [], historicalIds = [], source, tags, onChain) {
         if (!this.isAvailable()) {
             throw new Error('Governance integration not available');
         }
         const isTechnical = proposal.type === 'fix' || proposal.type === 'guard';
         if (isTechnical) {
-            return this.evaluateProposal(proposal, agentReviews, historicalIds);
+            return this.evaluateProposal(proposal, agentReviews, historicalIds, source, tags, onChain);
         }
-        return this.governWithSolarProposal(proposal);
+        return this.governWithSolarProposal(proposal, source, tags, onChain);
     }
     /**
      * Route: evaluate_governance — for purely technical proposals (fix, guard)
      */
-    async evaluateProposal(proposal, agentReviews, historicalIds) {
+    async evaluateProposal(proposal, agentReviews, historicalIds, source, tags, onChain) {
+        const defaults = this.configData.proposalDefaults ?? { source: 'agent', onChain: false, tags: [] };
+        const finalSource = source ?? defaults.source;
+        const finalTags = tags ?? defaults.tags;
+        const finalOnChain = onChain ?? defaults.onChain;
         const response = await this.client.evaluateGovernance({
             proposalId: proposal.id,
             proposalText: `${proposal.title}\n\n${proposal.description}`,
             agentReviews,
             historicalSignalIds: historicalIds,
+            source: finalSource,
+            tags: finalTags,
+            onChain: finalOnChain,
         });
         return this.applyDecisionLogic(response);
     }
@@ -122,14 +129,21 @@ export class InferenceGovernanceIntegration extends BaseIntegration {
      * Brings real-time NOAA GOES solar context into the decision, adjusting
      * vote weight and adding warnings based on current solar activity.
      */
-    async governWithSolarProposal(proposal) {
+    async governWithSolarProposal(proposal, source, tags, onChain) {
         frameworkLogger.log('inference-governance', 'solar-check-start', 'info', {
             proposalId: proposal.id,
             proposalTitle: proposal.title,
         });
+        const defaults = this.configData.proposalDefaults ?? { source: 'agent', onChain: false, tags: [] };
+        const finalSource = source ?? defaults.source;
+        const finalTags = tags ?? defaults.tags;
+        const finalOnChain = onChain ?? defaults.onChain;
         const solarResponse = await this.client.governWithSolar({
             proposal: `${proposal.title}\n\n${proposal.description}`,
             baseVoteWeight: this.configData.decisionLogic.voteWeightMultiplier,
+            source: finalSource,
+            tags: finalTags,
+            onChain: finalOnChain,
         });
         const adjustment = solarResponse.confidenceAdjustment;
         const recommendation = adjustment <= -0.10 ? 'NEEDS_REVISION' : 'PASS';
@@ -291,6 +305,7 @@ export class InferenceGovernanceIntegration extends BaseIntegration {
             const content = fs.readFileSync(configPath, 'utf-8');
             const features = JSON.parse(content);
             if (features.inference_governance) {
+                const defaults = features.inference_governance.proposal_defaults;
                 this.configData = {
                     ...DEFAULT_GOVERNANCE_CONFIG,
                     enabled: features.inference_governance.enabled ?? false,
@@ -302,6 +317,11 @@ export class InferenceGovernanceIntegration extends BaseIntegration {
                         revisionConfidenceMax: features.inference_governance.decision_logic?.revision_confidence_max ?? DEFAULT_GOVERNANCE_CONFIG.decisionLogic.revisionConfidenceMax,
                         voteWeightMultiplier: features.inference_governance.decision_logic?.vote_weight_multiplier ?? DEFAULT_GOVERNANCE_CONFIG.decisionLogic.voteWeightMultiplier,
                     },
+                    proposalDefaults: {
+                        source: defaults?.source ?? DEFAULT_GOVERNANCE_CONFIG.proposalDefaults.source,
+                        onChain: defaults?.on_chain ?? DEFAULT_GOVERNANCE_CONFIG.proposalDefaults.onChain,
+                        tags: defaults?.tags ?? DEFAULT_GOVERNANCE_CONFIG.proposalDefaults.tags,
+                    },
                 };
             }
             await this.log('info', 'Configuration loaded', {
@@ -371,3 +391,4 @@ export async function shutdownGovernanceIntegration() {
 // ============================================================================
 export * from './types.js';
 export * from './governance-client.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/governance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/governance/index.ts"],"names":[],"mappings":"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"}

package/dist/integrations/governance/types.d.ts

@@ -18,6 +18,12 @@ export interface GovernanceCheckRequest {
     codeDiff?: string;
     agentReviews: string[];
     historicalSignalIds?: string[];
+    /** Source classification for grouping/correlation */
+    source?: DynamoProposalSource;
+    /** Freeform tags for filtering/grouping */
+    tags?: string[];
+    /** Whether to persist this proposal on-chain */
+    onChain?: boolean;
 }
 /**
  * Governance check response from Dynamo endpoint
@@ -56,6 +62,15 @@ export interface GovernanceIntegrationConfig {
         /** Multiplier for vote weight from governance */
         voteWeightMultiplier: number;
     };
+    /** Default proposal metadata sent to Dynamo */
+    proposalDefaults: {
+        /** Default source classification (default: 'agent') */
+        source: DynamoProposalSource;
+        /** Whether to persist on-chain by default (default: false) */
+        onChain: boolean;
+        /** Default tags applied to every proposal */
+        tags: string[];
+    };
 }
 /**
  * Default governance configuration
@@ -80,6 +95,11 @@ export interface SolarContext {
     /** Human-readable recommendation based on solar conditions */
     recommendation: string;
 }
+/**
+ * Dynamo source classification — labels where a proposal originated.
+ * Not a computational seed; purely for grouping/correlation.
+ */
+export type DynamoProposalSource = 'human' | 'agent' | 'ambient' | 'system';
 /**
  * Solar-enhanced governance check request
  */
@@ -92,6 +112,12 @@ export interface SolarGovernanceCheckRequest {
     sharePublicly?: boolean;
     /** Spectral quality score for resonance analysis */
     spectralQuality?: number;
+    /** Source classification for grouping/correlation */
+    source?: DynamoProposalSource;
+    /** Freeform tags for filtering/grouping (e.g. ["0xray"], ["my-project"]) */
+    tags?: string[];
+    /** Whether to persist this proposal on-chain */
+    onChain?: boolean;
 }
 /**
  * Solar-enhanced governance check response

package/dist/integrations/governance/types.js

@@ -11,15 +11,20 @@
  * Default governance configuration
  */
 export const DEFAULT_GOVERNANCE_CONFIG = {
-    enabled: false,
-    endpointUrl: process.env.GOVERNANCE_ENDPOINT || '',
-    requestTimeoutMs: 10000,
+    enabled: true,
+    endpointUrl: process.env.GOVERNANCE_ENDPOINT || 'https://mcp-production-80e2.up.railway.app/governance',
+    requestTimeoutMs: 30000,
     minConfidenceThreshold: 0.5,
     decisionLogic: {
-        passConfidenceMin: 0.9,
-        revisionConfidenceMax: 0.89,
+        passConfidenceMin: 0.7,
+        revisionConfidenceMax: 0.4,
         voteWeightMultiplier: 1.0,
     },
+    proposalDefaults: {
+        source: 'agent',
+        onChain: false,
+        tags: [],
+    },
 };
 // ============================================================================
 // Error Types
@@ -95,3 +100,4 @@ export function isGovernanceError(error) {
     return (error instanceof GovernanceError ||
         (error instanceof Error && error.name === 'GovernanceError'));
 }
+//# sourceMappingURL=types.js.map

package/dist/integrations/governance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/integrations/governance/types.ts"],"names":[],"mappings":"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"}

package/dist/integrations/grok/grok-cli.js

@@ -60,7 +60,7 @@ export async function installForGrokCLI(options = {}) {
         const govMcpPath = path.resolve(__dirname, '..', '..', '..', 'dist/mcps/governance.server.js');
         const skillsMcpPath = path.resolve(__dirname, '..', '..', '..', 'dist/mcps/knowledge-skills/skill-invocation.server.js');
         try {
-            execSync(`grok mcp add xray-governance --command node --args "${govMcpPath}" --env "XRAY_FORCE_MCP_GOVERNANCE=true" --env "XRAY_ROOT=${process.cwd()}"`, { stdio: 'pipe' });
+            execSync(`grok mcp add xray-governance --command node --args "${govMcpPath}" --env "XRAY_ROOT=${process.cwd()}"`, { stdio: 'pipe' });
             execSync(`grok mcp add xray-skills --command node --args "${skillsMcpPath}" --env "XRAY_ROOT=${process.cwd()}"`, { stdio: 'pipe' });
             frameworkLogger.log('grok-cli', 'Registered xray MCP servers with Grok CLI', 'info', {});
         }
@@ -81,3 +81,4 @@ export async function installForGrokCLI(options = {}) {
 export default {
     installForGrokCLI,
 };
+//# sourceMappingURL=grok-cli.js.map

package/dist/integrations/grok/grok-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-cli.js","sourceRoot":"","sources":["../../../src/integrations/grok/grok-cli.ts"],"names":[],"mappings":"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"}

package/dist/integrations/grok/hooks/pre-tool-use.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Grok PreToolUse Hook for 0xRay
+ *
+ * This hook is called before any tool is executed in Grok.
+ * It can be used to enforce governance rules via the Dynamo Solar SSOT.
+ *
+ * For now this is a skeleton. Full implementation will call GovernanceService.
+ *
+ * Phase 0.4 E2E hardening: every exit path now emits a valid JSON decision
+ * object with fallback defaults. The hook never produces partial or missing
+ * output, even when env context is absent.
+ */
+interface PreToolUseInput {
+    tool: string;
+    args?: any;
+}
+export declare function handlePreToolUse(input: PreToolUseInput, output: any): Promise<void>;
+export default handlePreToolUse;

package/dist/integrations/grok/hooks/pre-tool-use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-use.js","sourceRoot":"","sources":["../../../../src/integrations/grok/hooks/pre-tool-use.ts"],"names":[],"mappings":"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"}

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

@@ -2,10 +2,7 @@
   "mcpServers": {
     "xray-governance": {
       "command": "npx",
-      "args": ["-y", "0xray", "mcp", "governance"],
-      "env": {
-        "XRAY_FORCE_MCP_GOVERNANCE": "true"
-      }
+      "args": ["-y", "0xray", "mcp", "governance"]
     },
     "xray-skills": {
       "command": "npx",

package/dist/integrations/hermes-agent/bridge.mjs

@@ -53,7 +53,7 @@ console.warn = (...args) => { _stderrWrite('[WARN] ' + args.join(' ') + '\n'); }
 
 // ── Framework components (lazy-loaded) ───────────────────────
 let ProcessorManager = null;
-let StrRayStateManager = null;
+let XrayStateManager = null;
 let featuresConfigLoader = null;
 let runQualityGateWithLogging = null;
 let enforcerValidators = null;
@@ -158,11 +158,11 @@ async function loadFramework(projectRoot) {
         }
       }
 
-      if (!StrRayStateManager) {
+      if (!XrayStateManager) {
         const smPath = join(distDir, "state", "state-manager.js");
         if (existsSync(smPath)) {
           const sm = await import(smPath);
-          StrRayStateManager = sm.StrRayStateManager;
+          XrayStateManager = sm.XrayStateManager || sm.StrRayStateManager;
         }
       }
 
@@ -239,7 +239,7 @@ async function runQualityGateCheck(context, projectRoot, logDir) {
 
 // ── Processor Pipeline ───────────────────────────────────────
 async function runProcessors(tool, args, phase, projectRoot, logDir) {
-  if (!ProcessorManager || !StrRayStateManager) {
+    if (!ProcessorManager || !XrayStateManager) {
     return { ran: false, reason: "framework modules not loaded" };
   }
 
@@ -247,7 +247,7 @@ async function runProcessors(tool, args, phase, projectRoot, logDir) {
 
   try {
     const stateDir = join(projectRoot, ".xray", "state");
-    const stateManager = new StrRayStateManager(stateDir);
+    const stateManager = new XrayStateManager(stateDir);
     const processorManager = new ProcessorManager(stateManager);
 
     // Register processors matching OpenCode plugin
@@ -368,7 +368,7 @@ async function handleHealth(input) {
   const components = {
     qualityGate: !!runQualityGateWithLogging,
     processorManager: !!ProcessorManager,
-    stateManager: !!StrRayStateManager,
+    stateManager: !!XrayStateManager,
     featuresConfig: !!featuresConfigLoader,
   };
 
@@ -507,21 +507,7 @@ async function handleCodexCheck(input, projectRoot, logDir) {
   // Phase 2: Enforcement validators (deep code analysis — security, quality, architecture)
   //    Use ValidatorRegistry directly instead of RuleEnforcer.validateOperation()
   //    to avoid the dependency chain cascade that blocks validators on snippet analysis.
-  //    Only run content-analysis validators — skip project-level validators that
-  //    require full context (docs, tests, CI, package.json) and always fail on snippets.
-  const SNIPPET_SAFE_RULES = new Set([
-    "security-by-design",
-    "input-validation",
-    "clean-debug-logs",
-    "console-log-usage",
-    "no-duplicate-code",
-    "loop-safety",
-    "no-over-engineering",
-    "single-responsibility",
-    "error-resolution",
-    "module-system-consistency",
-  ]);
-
+  //    Run all registered validators — v3: full registry
   if (enforcerValidators && codeLen > 0) {
     try {
       const ctx = { operation: "write", newCode: code, files: [] };
@@ -529,18 +515,9 @@ async function handleCodexCheck(input, projectRoot, logDir) {
       let enforcerViolations = 0;
 
       for (const v of validators) {
-        // Only run snippet-safe validators, or respect focus areas
-        if (!SNIPPET_SAFE_RULES.has(v.ruleId)) {
-          // Still run if focus area explicitly requests this category
-          if (focusAreas && focusAreas !== "all" && Array.isArray(focusAreas)) {
-            if (focusAreas.includes(v.category)) {
-              // Fall through to validate
-            } else {
-              continue;
-            }
-          } else {
-            continue;
-          }
+        // Run all registered validators — v3: full registry
+        if (focusAreas && focusAreas !== "all" && Array.isArray(focusAreas) && focusAreas.length > 0) {
+          if (!focusAreas.includes(v.category)) continue;
         }
 
         try {
@@ -561,7 +538,7 @@ async function handleCodexCheck(input, projectRoot, logDir) {
       }
 
       enforcerRan = true;
-      logToActivity(logDir, `codex-check: Validators ran against ${validators.length} rules (${SNIPPET_SAFE_RULES.size} snippet-safe), ${enforcerViolations} violations`);
+      logToActivity(logDir, `codex-check: Validators ran against ${validators.length} rules, ${enforcerViolations} violations`);
     } catch (e) {
       logToActivity(logDir, `codex-check: Validator error: ${e.message}`);
     }

package/dist/integrations/hermes-agent/hermes-agent-integration.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Hermes Agent Integration
+ *
+ * Bridges 0xRay framework components to the Hermes CLI agent.
+ * Manages the bridge.mjs subprocess and wires tool event hooks
+ * through the framework's quality gate, processors, and state manager.
+ *
+ * Extends BaseIntegration for consistent lifecycle management with
+ * the integration registry.
+ *
+ * @version 2.0.0
+ * @since 2026-03-27
+ */
+import { BaseIntegration, type IntegrationConfig, type HealthResult } from "../base/index.js";
+import type { HermesAgentConfig, HermesAgentStatistics, BridgeRequest, BridgeResponse, BridgeHealthResponse, BridgeValidateResponse, BridgeCodexCheckResponse, BridgeStatsResponse } from "./types.js";
+/**
+ * Hermes Agent Integration
+ *
+ * Manages the bridge subprocess and provides tool event hooks
+ * that pipe through 0xRay's quality gate and processor pipeline.
+ */
+export declare class HermesAgentIntegration extends BaseIntegration {
+    private bridgePath;
+    private pluginDir;
+    private projectRoot;
+    private bridgeTimeout;
+    private hooksEnabled;
+    private loggingEnabled;
+    /** Runtime statistics (separate from base IntegrationStats) */
+    private hermesStats;
+    /** Bridge health cache */
+    private cachedHealth;
+    private lastHealthCheck;
+    private readonly HEALTH_CACHE_TTL;
+    constructor(config?: Partial<IntegrationConfig> & HermesAgentConfig);
+    protected performInitialization(): Promise<void>;
+    protected performShutdown(): Promise<void>;
+    protected performHealthCheck(): Promise<HealthResult>;
+    /**
+     * Send a command to the bridge subprocess
+     */
+    sendToBridge<T extends BridgeResponse>(request: BridgeRequest, timeout?: number): Promise<T>;
+    /**
+     * Check bridge health (with caching)
+     */
+    checkBridgeHealth(): Promise<BridgeHealthResponse>;
+    /**
+     * Pre-tool-call hook
+     *
+     * Called before a tool executes. Runs quality gate and pre-processors
+     * for code-producing tools. Returns instructions for the caller.
+     */
+    onPreToolCall(tool: string, args: Record<string, unknown> | null, toolId: string): Promise<{
+        allowed: boolean;
+        nudge?: string;
+        bridgeResult?: unknown;
+    }>;
+    /**
+     * Post-tool-call hook
+     *
+     * Called after a tool executes. Runs post-processors
+     * for code-producing tools.
+     */
+    onPostToolCall(tool: string, args: Record<string, unknown> | null, result: unknown, error: string | null, toolId: string): Promise<void>;
+    /**
+     * Run xray_validate — validate files against quality gate
+    */
+    validate(files: string[], operation?: string): Promise<BridgeValidateResponse>;
+    /**
+     * Run xray_codex_check — check code against codex rules
+    */
+    codexCheck(code: string | undefined, focusAreas?: string[]): Promise<BridgeCodexCheckResponse>;
+    /**
+     * Run xray_health — framework health check
+    */
+    health(): Promise<BridgeHealthResponse>;
+    /**
+     * Check if a tool name belongs to a 0xRay MCP server
+     */
+    isStrrayMcp(tool: string): boolean;
+    /**
+     * Get a nudge message for a native tool
+     */
+    private getToolNudge;
+    /**
+     * Create empty statistics object
+     */
+    private createEmptyStats;
+    /**
+     * Get current Hermes Agent statistics
+     */
+    getHermesStats(): Readonly<HermesAgentStatistics>;
+    /**
+     * Reset statistics (e.g., new session)
+     */
+    resetStats(): void;
+    /**
+     * Get the bridge path
+     */
+    getBridgePath(): string;
+    /**
+     * Get the plugin directory path
+     */
+    getPluginDir(): string;
+    /**
+     * Get the project root
+     */
+    getProjectRoot(): string;
+    /**
+     * Check if hooks are enabled
+     */
+    isHooksEnabled(): boolean;
+    /**
+     * Enable or disable hooks
+     */
+    setHooksEnabled(enabled: boolean): void;
+    /**
+     * Get the bridge stats response
+     */
+    getBridgeStats(): Promise<BridgeStatsResponse>;
+}
+/**
+ * Get or create the global Hermes Agent integration instance
+ */
+export declare function getHermesAgentIntegration(config?: Partial<IntegrationConfig> & HermesAgentConfig): HermesAgentIntegration;
+/**
+ * Initialize the global Hermes Agent integration
+ */
+export declare function initializeHermesAgentIntegration(config?: Partial<IntegrationConfig> & HermesAgentConfig): Promise<HermesAgentIntegration>;
+/**
+ * Shutdown the global Hermes Agent integration
+ */
+export declare function shutdownHermesAgentIntegration(): Promise<void>;