@llm-dev-ops/agentics-cli 1.4.13 → 1.4.15

package/dist/gates/readiness-gate.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Readiness Gate — Gate 7 (Execution Safety Enforcement)
+ *
+ * PURPOSE: Enforce that write-path commands (deploy run, erp export in
+ * execute mode, rollback, live sync) are blocked when the platform state
+ * is INTEGRATION_READY_EXECUTION_GATED. This gate ensures no ERP writes
+ * or production deployments occur until all prerequisites are met.
+ *
+ * INVARIANTS ENFORCED:
+ * - No production writes when execution_gate is LOCKED
+ * - No deploy run / deploy rollback when connectors are missing
+ * - No erp export --mode=execute when systems are BLOCKED
+ * - Read-only and integration-mode commands always allowed
+ *
+ * EXIT CODE: 111 (READINESS_GATE_VIOLATION)
+ *
+ * BEHAVIOR:
+ * - Commands that perform external writes (deploy run, deploy rollback)
+ *   are blocked when the readiness state has execution_gate.locked = true.
+ * - Commands that are read-only (readiness show, inspect, erp list) are
+ *   always permitted regardless of readiness state.
+ * - The gate reads state from ~/.agentics/exports/decision-readiness/readiness-state.json.
+ *   If the file does not exist, the gate assumes INSPECTION_ONLY (most restrictive).
+ */
+import type { CommandObject } from '../types/index.js';
+export declare const READINESS_GATE_EXIT_CODE = 111;
+/**
+ * Canonical readiness states.
+ * Transitions: INSPECTION_ONLY -> INTEGRATION_READY_EXECUTION_GATED -> EXECUTION_READY
+ */
+export type ReadinessState = 'INSPECTION_ONLY' | 'INTEGRATION_READY_EXECUTION_GATED' | 'EXECUTION_READY';
+export interface ReadinessGateResult {
+    /** Whether the command passed readiness validation */
+    allowed: boolean;
+    /** Error message if validation failed */
+    message: string;
+    /** Exit code if validation failed */
+    exitCode: number;
+    /** Whether this command requires readiness validation */
+    readinessRequired: boolean;
+    /** Current readiness state (if loaded) */
+    state?: ReadinessState;
+}
+export interface ReadinessStateFile {
+    schema: string;
+    state: ReadinessState;
+    simulation_id: string;
+    plan_ref: string;
+    determined_at: string;
+    execution_gate: {
+        locked: boolean;
+        reason: string;
+        prerequisites_total: number;
+        prerequisites_completed: number;
+        critical_blockers: Array<{
+            id: number;
+            system: string;
+            severity: string;
+            effort: string;
+        }>;
+    };
+    integration_readiness: {
+        entities_ready: number;
+        entities_blocked: number;
+        entities_total: number;
+        readiness_pct: number;
+        systems_ready: string[];
+        systems_blocked: string[];
+    };
+    financial_posture: {
+        annual_api_spend_usd: number;
+        year1_investment_usd: number;
+        annual_savings_usd: number;
+        roi_payback_months: number;
+        npv_5yr_usd: number;
+    };
+    audit_matrix: {
+        result: string;
+        checks_passed: number;
+        checks_total: number;
+        last_audit: string;
+    };
+}
+/**
+ * Load readiness state from the canonical artifact path.
+ * Returns null if the file does not exist or is invalid.
+ */
+export declare function loadReadinessState(): ReadinessStateFile | null;
+/**
+ * Check whether a command passes readiness validation.
+ * Returns a result indicating whether the command is allowed.
+ *
+ * Write-path commands are blocked when:
+ * 1. The readiness state file exists AND execution_gate.locked === true
+ * 2. The readiness state file does not exist (defaults to most restrictive)
+ *
+ * Read-only commands always pass.
+ */
+export declare function checkReadinessGate(cmd: CommandObject): ReadinessGateResult;
+/**
+ * Enforce readiness gate — exits the process if validation fails.
+ */
+export declare function enforceReadinessGate(cmd: CommandObject): void;
+/**
+ * Check if a command requires readiness validation.
+ */
+export declare function requiresReadinessValidation(primary: string, sub?: string): boolean;
+//# sourceMappingURL=readiness-gate.d.ts.map

package/dist/gates/readiness-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-gate.d.ts","sourceRoot":"","sources":["../../src/gates/readiness-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMvD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,mCAAmC,GACnC,iBAAiB,CAAC;AAiCtB,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAMD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,mBAAmB,EAAE,MAAM,CAAC;QAC5B,uBAAuB,EAAE,MAAM,CAAC;QAChC,iBAAiB,EAAE,KAAK,CAAC;YACvB,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;KACJ,CAAC;IACF,qBAAqB,EAAE;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,iBAAiB,EAAE;QACjB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAcD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,GAAG,IAAI,CAc9D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,mBAAmB,CA8E1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAc7D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAMlF"}

package/dist/gates/readiness-gate.js

@@ -0,0 +1,194 @@
+/**
+ * Readiness Gate — Gate 7 (Execution Safety Enforcement)
+ *
+ * PURPOSE: Enforce that write-path commands (deploy run, erp export in
+ * execute mode, rollback, live sync) are blocked when the platform state
+ * is INTEGRATION_READY_EXECUTION_GATED. This gate ensures no ERP writes
+ * or production deployments occur until all prerequisites are met.
+ *
+ * INVARIANTS ENFORCED:
+ * - No production writes when execution_gate is LOCKED
+ * - No deploy run / deploy rollback when connectors are missing
+ * - No erp export --mode=execute when systems are BLOCKED
+ * - Read-only and integration-mode commands always allowed
+ *
+ * EXIT CODE: 111 (READINESS_GATE_VIOLATION)
+ *
+ * BEHAVIOR:
+ * - Commands that perform external writes (deploy run, deploy rollback)
+ *   are blocked when the readiness state has execution_gate.locked = true.
+ * - Commands that are read-only (readiness show, inspect, erp list) are
+ *   always permitted regardless of readiness state.
+ * - The gate reads state from ~/.agentics/exports/decision-readiness/readiness-state.json.
+ *   If the file does not exist, the gate assumes INSPECTION_ONLY (most restrictive).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+// ============================================================================
+// Constants
+// ============================================================================
+export const READINESS_GATE_EXIT_CODE = 111;
+/**
+ * Commands + subcommands that require execution mode to be unlocked.
+ * These commands perform writes to external systems and are blocked
+ * when the readiness state is not EXECUTION_READY.
+ */
+const WRITE_COMMANDS = new Map([
+    ['deploy', new Set(['run', 'rollback'])],
+]);
+/**
+ * Commands that are always exempt from readiness validation.
+ * These are identity, read-only, or introspection commands.
+ */
+const READINESS_EXEMPT_COMMANDS = new Set([
+    'help',
+    'version',
+    'login',
+    'logout',
+    'whoami',
+    'usage',
+    'readiness',
+    'inspect',
+    'policy',
+    'audit',
+    'demo',
+]);
+// ============================================================================
+// State Loader
+// ============================================================================
+const READINESS_STATE_PATH = path.join(os.homedir(), '.agentics', 'exports', 'decision-readiness', 'readiness-state.json');
+/**
+ * Load readiness state from the canonical artifact path.
+ * Returns null if the file does not exist or is invalid.
+ */
+export function loadReadinessState() {
+    try {
+        if (!fs.existsSync(READINESS_STATE_PATH)) {
+            return null;
+        }
+        const content = fs.readFileSync(READINESS_STATE_PATH, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!parsed.state || !parsed.execution_gate) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Gate Implementation
+// ============================================================================
+/**
+ * Check whether a command passes readiness validation.
+ * Returns a result indicating whether the command is allowed.
+ *
+ * Write-path commands are blocked when:
+ * 1. The readiness state file exists AND execution_gate.locked === true
+ * 2. The readiness state file does not exist (defaults to most restrictive)
+ *
+ * Read-only commands always pass.
+ */
+export function checkReadinessGate(cmd) {
+    const primary = cmd.command;
+    const sub = cmd.subcommand;
+    // Exempt commands skip readiness validation
+    if (READINESS_EXEMPT_COMMANDS.has(primary)) {
+        return { allowed: true, message: '', exitCode: 0, readinessRequired: false };
+    }
+    // Check if this command+subcommand is a write command
+    const writeSubs = WRITE_COMMANDS.get(primary);
+    if (!writeSubs || !sub || !writeSubs.has(sub)) {
+        // Not a write command — allow
+        return { allowed: true, message: '', exitCode: 0, readinessRequired: false };
+    }
+    // This is a write command — check readiness state
+    const state = loadReadinessState();
+    // No readiness state file → assume most restrictive (block writes)
+    if (!state) {
+        return {
+            allowed: false,
+            message: `Readiness gate: No readiness state found.\n` +
+                `Write command "${primary} ${sub}" requires EXECUTION_READY state.\n` +
+                `\n` +
+                `Run: agentics readiness show <scenario> to check current state.\n` +
+                `Current state: UNKNOWN (no readiness-state.json found)`,
+            exitCode: READINESS_GATE_EXIT_CODE,
+            readinessRequired: true,
+        };
+    }
+    // EXECUTION_READY → allow all commands
+    if (state.state === 'EXECUTION_READY') {
+        return {
+            allowed: true,
+            message: '',
+            exitCode: 0,
+            readinessRequired: true,
+            state: state.state,
+        };
+    }
+    // Any other state with execution_gate.locked → block writes
+    if (state.execution_gate.locked) {
+        const blockers = state.execution_gate.critical_blockers
+            .map(b => `  - ${b.system} (${b.severity}, ${b.effort})`)
+            .join('\n');
+        return {
+            allowed: false,
+            message: `Readiness gate: Execution mode is LOCKED.\n` +
+                `Command "${primary} ${sub}" requires EXECUTION_READY state.\n` +
+                `\n` +
+                `Current state: ${state.state}\n` +
+                `Reason: ${state.execution_gate.reason}\n` +
+                `Prerequisites: ${state.execution_gate.prerequisites_completed}/${state.execution_gate.prerequisites_total} completed\n` +
+                `\n` +
+                `Critical blockers:\n${blockers}\n` +
+                `\n` +
+                `Run: agentics readiness show ${state.simulation_id} for full status.`,
+            exitCode: READINESS_GATE_EXIT_CODE,
+            readinessRequired: true,
+            state: state.state,
+        };
+    }
+    // execution_gate.locked is false but state is not EXECUTION_READY — allow cautiously
+    return {
+        allowed: true,
+        message: '',
+        exitCode: 0,
+        readinessRequired: true,
+        state: state.state,
+    };
+}
+/**
+ * Enforce readiness gate — exits the process if validation fails.
+ */
+export function enforceReadinessGate(cmd) {
+    const result = checkReadinessGate(cmd);
+    if (!result.allowed) {
+        console.error(JSON.stringify({
+            error: {
+                code: 'READINESS_GATE_VIOLATION',
+                message: result.message,
+                command: `${cmd.command} ${cmd.subcommand ?? ''}`.trim(),
+                exit_code: result.exitCode,
+                state: result.state ?? 'UNKNOWN',
+            },
+        }));
+        process.exit(result.exitCode);
+    }
+}
+/**
+ * Check if a command requires readiness validation.
+ */
+export function requiresReadinessValidation(primary, sub) {
+    if (READINESS_EXEMPT_COMMANDS.has(primary))
+        return false;
+    const writeSubs = WRITE_COMMANDS.get(primary);
+    if (!writeSubs)
+        return false;
+    if (!sub)
+        return false;
+    return writeSubs.has(sub);
+}
+//# sourceMappingURL=readiness-gate.js.map

package/dist/gates/readiness-gate.js.map

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

package/dist/gates/ruvector-acceptance-gate.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Ruvector Acceptance Gate — Gate 8 (Mandatory Blocking Persistence)
+ *
+ * PURPOSE: Ensure every enterprise simulation blocks until ruvector-service
+ * accepts the execution. No fallback, no best-effort.
+ *
+ * INVARIANTS ENFORCED:
+ * - ADR-004 Invariant 1: Every simulation has a memory footprint
+ * - Ruvector acceptance is BLOCKING, not best-effort
+ * - Failure to persist to ruvector is a COMMAND FAILURE, not a warning
+ *
+ * EXIT CODE: 141 (RUVECTOR_ACCEPTANCE_FAILED)
+ *
+ * FORBIDDEN:
+ * - try/catch swallowing of ruvector errors
+ * - Fallback to local-only persistence
+ * - Warning-level logging for persistence failures
+ * - Proceeding without ruvector acceptance
+ */
+import type { RuvectorRootedGraph, RuvectorAcceptanceResult, DownstreamSpanDescriptor } from '../types/index.js';
+export declare const RUVECTOR_ACCEPTANCE_EXIT_CODE = 141;
+/**
+ * Block until ruvector-service accepts the simulation memory record.
+ * NO fallback. NO best-effort. Failure throws CLIError.
+ *
+ * @throws CLIError (ECLI-RUVECTOR-001) if ruvector rejects or is unavailable
+ */
+export declare function blockUntilRuvectorAccepts(simulationId: string, memoryRecord: {
+    id: string;
+    type: 'simulation';
+    intent: string;
+    status: string;
+    result?: unknown;
+    attribution: {
+        created_by: string;
+        org_id: string;
+    };
+    artifact_ids: string[];
+    created_at: string;
+    updated_at: string;
+    checksum: string;
+}, correlationId: string): Promise<RuvectorAcceptanceResult>;
+/**
+ * Block until ruvector-service accepts a lineage record.
+ * NO fallback. NO best-effort. Failure throws CLIError.
+ *
+ * @throws CLIError (ECLI-RUVECTOR-002) if ruvector rejects or is unavailable
+ */
+export declare function blockUntilLineageAccepted(lineageRecord: {
+    id: string;
+    artifact_id: string;
+    artifact_category: string;
+    simulation_id: string;
+    plan_id?: string;
+    decision_context: string;
+    attribution: {
+        created_by: string;
+        org_id: string;
+    };
+    governance: {
+        gate_pipeline_version: string;
+        synthesis_classification: string;
+    };
+    created_at: string;
+}, correlationId: string): Promise<void>;
+/**
+ * Build a ruvector-rooted execution graph from downstream span descriptors.
+ * ruvector-service is ALWAYS the root node.
+ */
+export declare function buildRuvectorRootedGraph(ruvectorSpanId: string, downstreamSpans: DownstreamSpanDescriptor[]): RuvectorRootedGraph;
+/**
+ * Validate that an execution graph has ruvector-service as its root.
+ * Throws CLIError if the root is not ruvector-service.
+ *
+ * @throws CLIError (ECLI-RUVECTOR-003) if root is not ruvector-service
+ */
+export declare function validateRuvectorRootedGraph(graph: RuvectorRootedGraph): void;
+//# sourceMappingURL=ruvector-acceptance-gate.d.ts.map

package/dist/gates/ruvector-acceptance-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruvector-acceptance-gate.d.ts","sourceRoot":"","sources":["../../src/gates/ruvector-acceptance-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EAExB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAM3B,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAMjD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,EACD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,wBAAwB,CAAC,CAwDnC;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,UAAU,EAAE;QAAE,qBAAqB,EAAE,MAAM,CAAC;QAAC,wBAAwB,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,UAAU,EAAE,MAAM,CAAC;CACpB,EACD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,wBAAwB,EAAE,GAC1C,mBAAmB,CAgDrB;AAMD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAgB5E"}

package/dist/gates/ruvector-acceptance-gate.js

@@ -0,0 +1,191 @@
+/**
+ * Ruvector Acceptance Gate — Gate 8 (Mandatory Blocking Persistence)
+ *
+ * PURPOSE: Ensure every enterprise simulation blocks until ruvector-service
+ * accepts the execution. No fallback, no best-effort.
+ *
+ * INVARIANTS ENFORCED:
+ * - ADR-004 Invariant 1: Every simulation has a memory footprint
+ * - Ruvector acceptance is BLOCKING, not best-effort
+ * - Failure to persist to ruvector is a COMMAND FAILURE, not a warning
+ *
+ * EXIT CODE: 141 (RUVECTOR_ACCEPTANCE_FAILED)
+ *
+ * FORBIDDEN:
+ * - try/catch swallowing of ruvector errors
+ * - Fallback to local-only persistence
+ * - Warning-level logging for persistence failures
+ * - Proceeding without ruvector acceptance
+ */
+import { RuvectorAdapter } from '../adapters/base-adapter.js';
+import { loadEndpointConfig } from '../config/endpoints.js';
+import { CLIError } from '../errors/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+export const RUVECTOR_ACCEPTANCE_EXIT_CODE = 141;
+// ============================================================================
+// Blocking Acceptance Functions
+// ============================================================================
+/**
+ * Block until ruvector-service accepts the simulation memory record.
+ * NO fallback. NO best-effort. Failure throws CLIError.
+ *
+ * @throws CLIError (ECLI-RUVECTOR-001) if ruvector rejects or is unavailable
+ */
+export async function blockUntilRuvectorAccepts(simulationId, memoryRecord, correlationId) {
+    const startTime = Date.now();
+    const ruvectorSpanId = `ruvector-span-${crypto.randomUUID()}`;
+    const ruvectorConfig = loadEndpointConfig('ruvector-service');
+    const adapter = new RuvectorAdapter(ruvectorConfig, correlationId);
+    try {
+        await adapter.storeSimulation(memoryRecord);
+    }
+    catch (error) {
+        // NO swallowing. Wrap with gate-specific context and re-throw.
+        throw new CLIError({
+            code: 'ECLI-RUVECTOR-001',
+            category: 'DOWNSTREAM_ERROR',
+            message: `Ruvector acceptance failed for simulation ${simulationId}: ${error instanceof Error ? error.message : String(error)}`,
+            details: {
+                simulation_id: simulationId,
+                gate: 'ruvector-acceptance',
+                invariant: 'ADR-004 Invariant 1',
+            },
+            module: 'ruvector-gate',
+            correlationId,
+            recoverable: false,
+            exitCode: RUVECTOR_ACCEPTANCE_EXIT_CODE,
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+    const timing = Date.now() - startTime;
+    const now = new Date().toISOString();
+    const rootSpan = {
+        span_id: ruvectorSpanId,
+        parent_span_id: null,
+        service: 'ruvector-service',
+        operation: 'accept-simulation',
+        status: 'completed',
+        started_at: new Date(startTime).toISOString(),
+        completed_at: now,
+        duration_ms: timing,
+        children: [],
+    };
+    const graph = {
+        graph_id: `graph-${crypto.randomUUID()}`,
+        root: rootSpan,
+        total_spans: 1,
+        created_at: now,
+    };
+    return {
+        accepted: true,
+        ruvector_span_id: ruvectorSpanId,
+        graph,
+        timing_ms: timing,
+    };
+}
+/**
+ * Block until ruvector-service accepts a lineage record.
+ * NO fallback. NO best-effort. Failure throws CLIError.
+ *
+ * @throws CLIError (ECLI-RUVECTOR-002) if ruvector rejects or is unavailable
+ */
+export async function blockUntilLineageAccepted(lineageRecord, correlationId) {
+    const ruvectorConfig = loadEndpointConfig('ruvector-service');
+    const adapter = new RuvectorAdapter(ruvectorConfig, correlationId);
+    try {
+        await adapter.storeLineage(lineageRecord);
+    }
+    catch (error) {
+        throw new CLIError({
+            code: 'ECLI-RUVECTOR-002',
+            category: 'DOWNSTREAM_ERROR',
+            message: `Ruvector acceptance failed for lineage ${lineageRecord.id}: ${error instanceof Error ? error.message : String(error)}`,
+            details: {
+                lineage_id: lineageRecord.id,
+                simulation_id: lineageRecord.simulation_id,
+                gate: 'ruvector-acceptance',
+                invariant: 'ADR-004 Invariant 2',
+            },
+            module: 'ruvector-gate',
+            correlationId,
+            recoverable: false,
+            exitCode: RUVECTOR_ACCEPTANCE_EXIT_CODE,
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+}
+// ============================================================================
+// Graph Construction
+// ============================================================================
+/**
+ * Build a ruvector-rooted execution graph from downstream span descriptors.
+ * ruvector-service is ALWAYS the root node.
+ */
+export function buildRuvectorRootedGraph(ruvectorSpanId, downstreamSpans) {
+    const now = new Date().toISOString();
+    function descriptorToSpan(descriptor, parentSpanId) {
+        const spanId = `span-${crypto.randomUUID()}`;
+        const children = (descriptor.children ?? []).map(child => descriptorToSpan(child, spanId));
+        return {
+            span_id: spanId,
+            parent_span_id: parentSpanId,
+            service: descriptor.service,
+            operation: descriptor.operation,
+            status: descriptor.status,
+            started_at: descriptor.started_at,
+            completed_at: descriptor.completed_at,
+            duration_ms: descriptor.duration_ms,
+            children,
+        };
+    }
+    const childSpans = downstreamSpans.map(d => descriptorToSpan(d, ruvectorSpanId));
+    const root = {
+        span_id: ruvectorSpanId,
+        parent_span_id: null,
+        service: 'ruvector-service',
+        operation: 'accept-simulation',
+        status: 'completed',
+        started_at: now,
+        completed_at: now,
+        duration_ms: 0,
+        children: childSpans,
+    };
+    function countSpans(span) {
+        return 1 + span.children.reduce((sum, child) => sum + countSpans(child), 0);
+    }
+    return {
+        graph_id: `graph-${crypto.randomUUID()}`,
+        root,
+        total_spans: countSpans(root),
+        created_at: now,
+    };
+}
+// ============================================================================
+// Graph Validation
+// ============================================================================
+/**
+ * Validate that an execution graph has ruvector-service as its root.
+ * Throws CLIError if the root is not ruvector-service.
+ *
+ * @throws CLIError (ECLI-RUVECTOR-003) if root is not ruvector-service
+ */
+export function validateRuvectorRootedGraph(graph) {
+    if (graph.root.service !== 'ruvector-service') {
+        throw new CLIError({
+            code: 'ECLI-RUVECTOR-003',
+            category: 'INTERNAL_ERROR',
+            message: `Execution graph root is not ruvector-service (actual: ${graph.root.service})`,
+            details: {
+                graph_id: graph.graph_id,
+                actual_root: graph.root.service,
+                expected_root: 'ruvector-service',
+            },
+            module: 'ruvector-gate',
+            recoverable: false,
+            exitCode: RUVECTOR_ACCEPTANCE_EXIT_CODE,
+        });
+    }
+}
+//# sourceMappingURL=ruvector-acceptance-gate.js.map

package/dist/gates/ruvector-acceptance-gate.js.map

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

package/dist/modules/artifact-handoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-handoff.d.ts","sourceRoot":"","sources":["../../src/modules/artifact-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,yBAAyB,EAE1B,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAErD;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC;IAEtD;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CACvF;AAMD,qBAAa,eAAgB,YAAW,gBAAgB;IACtD;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAKpD;;;;;;;;OAQG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI;IAwDrD;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAMtF;AAMD,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,aAAa,CAExE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,mBAAmB,CAEpF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,eAAe,CAE5E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,eAAe,CAE5E;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,yBAAyB,CAEhG;AAMD,wBAAgB,qBAAqB,IAAI,gBAAgB,CAExD"}
+{"version":3,"file":"artifact-handoff.d.ts","sourceRoot":"","sources":["../../src/modules/artifact-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,yBAAyB,EAE1B,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAErD;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC;IAEtD;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CACvF;AAMD,qBAAa,eAAgB,YAAW,gBAAgB;IACtD;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAKpD;;;;;;;;OAQG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI;IAmFrD;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAMtF;AAMD,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,aAAa,CAExE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,mBAAmB,CAEpF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,eAAe,CAE5E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,eAAe,CAE5E;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,yBAAyB,CAEhG;AAMD,wBAAgB,qBAAqB,IAAI,gBAAgB,CAExD"}

package/dist/modules/artifact-handoff.js

@@ -81,6 +81,32 @@ export class ArtifactHandoff {
                 };
             }
         }
+        // Format 4: Nested response with id inside a domain object
+        // Handles: { export: { id }, execution_metadata }, { diligence_package: { id }, execution_metadata },
+        // { roi_report: { id }, execution_metadata }, { intent: { id }, execution_metadata }
+        const domainKeys = ['export', 'diligence_package', 'roi_report', 'intent', 'deployment', 'simulation'];
+        for (const key of domainKeys) {
+            if (key in obj && typeof obj[key] === 'object' && obj[key] !== null) {
+                const domain = obj[key];
+                if ('id' in domain) {
+                    const typeMap = {
+                        'export': 'ExportReference',
+                        'diligence_package': 'DiligencePackage',
+                        'roi_report': 'ROIReport',
+                        'intent': 'IntentReference',
+                        'deployment': 'DeploymentReference',
+                        'simulation': 'SimulationReference',
+                    };
+                    return {
+                        id: String(domain['id']),
+                        type: typeMap[key] ?? 'Reference',
+                        repository: key,
+                        created_at: 'generated_at' in domain ? String(domain['generated_at']) : new Date().toISOString(),
+                        checksum: '',
+                    };
+                }
+            }
+        }
         return null;
     }
     /**

package/dist/modules/artifact-handoff.js.map

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