agentic-qe 3.14.3 → 3.14.4

package/dist/domains/test-generation/services/test-generator.js

@@ -29,6 +29,7 @@ import { resolveRequest } from '../../../shared/language-detector.js';
 import { compilationValidator } from './compilation-validator.js';
 import { resolveTestFilePath } from './test-file-resolver.js';
 import { getPromptConfig } from '../prompts/language-prompts.js';
+import { getClaudeModelForTier } from '../../../shared/llm/model-registry.js';
 // ============================================================================
 // ADR-062 Tier 2: Holdout Test Selection
 // ============================================================================
@@ -116,13 +117,7 @@ export class TestGeneratorService {
      * Get model ID for the configured tier
      */
     getModelForTier(tier) {
-        switch (tier) {
-            case 1: return 'claude-haiku-4-5-20251001';
-            case 2: return 'claude-sonnet-4-6';
-            case 3: return 'claude-sonnet-4-6';
-            case 4: return 'claude-opus-4-7';
-            default: return 'claude-sonnet-4-6';
-        }
+        return getClaudeModelForTier(tier);
     }
     /**
      * Enhance generated test code using LLM

package/dist/domains/visual-accessibility/services/visual-tester.js

@@ -7,6 +7,7 @@ import { v4 as uuidv4 } from 'uuid';
 import { ok, err } from '../../../shared/types/index.js';
 import { FilePath } from '../../../shared/value-objects/index.js';
 import { toError } from '../../../shared/error-utils.js';
+import { getClaudeModelForTier } from '../../../shared/llm/model-registry.js';
 const DEFAULT_CONFIG = {
     baselineDirectory: '.visual-tests/baselines',
     diffDirectory: '.visual-tests/diffs',
@@ -88,13 +89,7 @@ export class VisualTesterService {
      * ADR-051: Get model name for specified tier
      */
     getModelForTier(tier) {
-        const models = {
-            1: 'claude-haiku-4-5',
-            2: 'claude-sonnet-4-6',
-            3: 'claude-sonnet-4-6',
-            4: 'claude-opus-4-7',
-        };
-        return models[tier] || models[2];
+        return getClaudeModelForTier(tier);
     }
     /**
      * Capture screenshot of URL

package/dist/init/init-wizard-steps.js

@@ -497,7 +497,7 @@ export function configToYAML(config) {
     lines.push('# Set provider/model to override auto-detection from environment API keys');
     lines.push('advisor:');
     lines.push('  # provider: "openrouter"        # openrouter | claude | ollama (auto-detected if not set)');
-    lines.push('  # model: "anthropic/claude-opus-4.7"  # provider-specific model ID');
+    lines.push('  # model: "anthropic/claude-opus-5.5"    # provider-specific model ID');
     lines.push('  # maxUses: "3"                  # per-task advisor call cap');
     lines.push('  redact: "strict"                # strict | balanced | off');
     lines.push('');

package/dist/init/kiro-installer.js

@@ -10,6 +10,7 @@ import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { toErrorMessage } from '../shared/error-utils.js';
 import { findPackageRoot } from './find-package-root.js';
+import { DEFAULT_HAIKU_MODEL, DEFAULT_OPUS_MODEL, DEFAULT_SONNET_MODEL, } from '../shared/llm/model-registry.js';
 // ESM compatibility
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -239,15 +240,15 @@ export class KiroInstaller {
         // Map model from frontmatter, falling back to category/priority heuristics
         const rawModel = getField('model');
         const priority = getField('priority');
-        let model = 'claude-sonnet-4-6';
+        let model = DEFAULT_SONNET_MODEL;
         if (rawModel) {
             if (rawModel.includes('opus'))
-                model = 'claude-opus-4-7';
+                model = DEFAULT_OPUS_MODEL;
             else if (rawModel.includes('haiku'))
-                model = 'claude-haiku-4-5';
+                model = DEFAULT_HAIKU_MODEL;
         }
         else if (priority === 'critical') {
-            model = 'claude-sonnet-4-6';
+            model = DEFAULT_SONNET_MODEL;
         }
         return {
             name: agentName,
@@ -339,12 +340,12 @@ export class KiroInstaller {
         }
         const allowedTools = [...allowedToolsSet];
         // Map model names
-        let model = 'claude-sonnet-4-6';
+        let model = DEFAULT_SONNET_MODEL;
         if (agent.model) {
             if (agent.model.includes('opus'))
-                model = 'claude-opus-4-7';
+                model = DEFAULT_OPUS_MODEL;
             else if (agent.model.includes('haiku'))
-                model = 'claude-haiku-4-5';
+                model = DEFAULT_HAIKU_MODEL;
         }
         // Convert mcp:agentic-qe: references in prompt text to Kiro @agentic-qe/ format
         const rawPrompt = agent.systemPrompt ?? `You are ${agent.name}, a specialized QE agent in the Agentic QE v3 platform.`;
@@ -372,7 +373,7 @@ export class KiroInstaller {
         const agent = {
             name: 'qe-specialist',
             description: 'Quality Engineering specialist powered by Agentic QE',
-            model: 'claude-sonnet-4-6',
+            model: DEFAULT_SONNET_MODEL,
             prompt: 'You are a QE specialist. Use AQE tools for test generation, coverage analysis, and quality assessment. Always call fleet_init before other AQE tools.',
             mcpServers: {
                 'agentic-qe': {

package/dist/init/opencode-installer.js

@@ -205,7 +205,7 @@ export class OpenCodeInstaller {
                     mode: 'subagent',
                 };
                 // NOTE: `model` is intentionally omitted so agents inherit the user's
-                // default OpenCode model. AQE ships model "claude-sonnet-4-6" which may
+                // default OpenCode model. AQE ships Claude model IDs (e.g. "claude-sonnet-5") which may
                 // not resolve in OpenCode's provider registry; inheriting avoids
                 // hard-failing the agent at invocation time.
                 const permission = this.buildPermission(name, data.permissions, permissionsYaml);

package/dist/init/phases/07-hooks.js

@@ -79,14 +79,16 @@ export class HooksPhase extends BasePhase {
         // Add AQE environment variables without clobbering any value the user
         // already set — including AQE_-prefixed overrides (only missing keys added).
         const existingEnv = settings.env;
-        settings.env = mergeAqeEnv(existingEnv, generateAqeEnvVars(config));
+        const backendOptions = { memoryBackend: context.options.memoryBackend };
+        settings.env = mergeAqeEnv(existingEnv, generateAqeEnvVars(config, backendOptions), backendOptions);
         // Apply v3 settings sections non-destructively:
         //  - permissions union-merged (preserve user entries, #362)
         //  - statusLine / includeCoAuthoredBy preserved when user-set (#362 follow-up)
         //  - AQE-owned sections deep-merged so user additions survive
-        const v3Sections = generateV3SettingsSections(config, projectRoot);
+        const v3Sections = generateV3SettingsSections(config, projectRoot, backendOptions);
         applyV3Sections(settings, v3Sections, {
             statusLine: !context.options.noStatusLine,
+            ...backendOptions,
         });
         // Enable MCP servers (deduplicate, replace old 'aqe' with 'agentic-qe')
         let existingMcp = settings.enabledMcpjsonServers || [];

package/dist/init/phases/12-verification.js

@@ -364,7 +364,7 @@ export class VerificationPhase extends BasePhase {
             '# Set provider/model to override auto-detection from environment API keys',
             'advisor:',
             '  # provider: "openrouter"        # openrouter | claude | ollama (auto-detected if not set)',
-            '  # model: "anthropic/claude-opus-4.7"  # provider-specific model ID',
+            '  # model: "anthropic/claude-opus-5.5"    # provider-specific model ID',
             '  # maxUses: "3"                  # per-task advisor call cap',
             '  redact: "strict"                # strict | balanced | off',
             '',

package/dist/init/settings-merge.d.ts

@@ -44,11 +44,15 @@ export declare function mergeHooksSmart(existingHooks: Record<string, unknown[]>
  * `AQE_LEARNING_ENABLED=false` keeps their choice. Non-AQE env vars are always
  * preserved. Returns a new object; inputs are not mutated.
  */
-export declare function mergeAqeEnv(existingEnv: Record<string, string> | undefined, aqeEnv: Record<string, string>): Record<string, string>;
+export declare function mergeAqeEnv(existingEnv: Record<string, string> | undefined, aqeEnv: Record<string, string>, options?: {
+    memoryBackend?: string;
+}): Record<string, string>;
 /**
  * Generate the full set of AQE environment variables for settings.json.
  */
-export declare function generateAqeEnvVars(config: AQEInitConfig): Record<string, string>;
+export declare function generateAqeEnvVars(config: AQEInitConfig, options?: {
+    memoryBackend?: string;
+}): Record<string, string>;
 /**
  * Detect whether a `statusLine` block is one AQE generated (vs. a user's own).
  * AQE's status line invokes the statusline-v3.cjs helper (or falls back to the
@@ -72,10 +76,13 @@ export declare function isAqeStatusLine(statusLine: unknown): boolean;
  */
 export declare function applyV3Sections(settings: Record<string, unknown>, sections: Record<string, unknown>, options?: {
     statusLine?: boolean;
+    memoryBackend?: string;
 }): Record<string, unknown>;
 /**
  * Generate v3-specific settings sections for settings.json.
  * These sections enable the self-learning system, status line, and permissions.
  */
-export declare function generateV3SettingsSections(config: AQEInitConfig, projectRoot?: string): Record<string, unknown>;
+export declare function generateV3SettingsSections(config: AQEInitConfig, projectRoot?: string, options?: {
+    memoryBackend?: string;
+}): Record<string, unknown>;
 //# sourceMappingURL=settings-merge.d.ts.map

package/dist/init/settings-merge.js

@@ -104,19 +104,44 @@ export function mergeHooksSmart(existingHooks, newAqeHooks) {
  * `AQE_LEARNING_ENABLED=false` keeps their choice. Non-AQE env vars are always
  * preserved. Returns a new object; inputs are not mutated.
  */
-export function mergeAqeEnv(existingEnv, aqeEnv) {
+export function mergeAqeEnv(existingEnv, aqeEnv, options = {}) {
     // AQE defaults first, then existing values win on any key collision.
-    return { ...aqeEnv, ...(existingEnv || {}) };
+    const merged = { ...aqeEnv, ...(existingEnv || {}) };
+    if (options.memoryBackend === 'memory') {
+        // An explicit --no-database re-init must replace stale AQE persistence
+        // settings, even if the previous init wrote them into this env block.
+        // Custom paths remain inert under the memory backend and are needed when
+        // switching back. Only discard AQE's generated database locations.
+        for (const key of ['AQE_MEMORY_PATH', 'AQE_V3_REASONING_BANK']) {
+            if (merged[key] === '.agentic-qe/memory.db')
+                delete merged[key];
+        }
+        merged.AQE_MEMORY_BACKEND = 'memory';
+        merged.AQE_LEARNING_ENABLED = 'false';
+        merged.AQE_WORKERS_ENABLED = 'false';
+    }
+    else if (existingEnv?.AQE_MEMORY_BACKEND === 'memory') {
+        // Undo the overrides written by memory-mode init. Ordinary user overrides
+        // still win when there is no memory-mode marker.
+        for (const key of ['AQE_MEMORY_BACKEND', 'AQE_LEARNING_ENABLED', 'AQE_WORKERS_ENABLED']) {
+            if (Object.prototype.hasOwnProperty.call(aqeEnv, key))
+                merged[key] = aqeEnv[key];
+            else
+                delete merged[key];
+        }
+    }
+    return merged;
 }
 /**
  * Generate the full set of AQE environment variables for settings.json.
  */
-export function generateAqeEnvVars(config) {
+export function generateAqeEnvVars(config, options = {}) {
     const domains = config.domains?.enabled || [];
+    const dbFree = options.memoryBackend === 'memory';
     return {
-        AQE_MEMORY_PATH: '.agentic-qe/memory.db',
+        ...(dbFree ? { AQE_MEMORY_BACKEND: 'memory', AQE_WORKERS_ENABLED: 'false' } : { AQE_MEMORY_PATH: '.agentic-qe/memory.db' }),
         AQE_MEMORY_ENABLED: 'true',
-        AQE_LEARNING_ENABLED: config.learning?.enabled ? 'true' : 'false',
+        AQE_LEARNING_ENABLED: dbFree ? 'false' : config.learning?.enabled ? 'true' : 'false',
         AQE_V3_MODE: 'true',
         AQE_V3_DDD_ENABLED: 'true',
         AQE_V3_DOMAINS: domains.join(','),
@@ -126,7 +151,7 @@ export function generateAqeEnvVars(config) {
         AQE_V3_HNSW_ENABLED: config.learning?.hnswConfig ? 'true' : 'false',
         AQE_V3_HOOKS_ENABLED: 'true',
         AQE_V3_AISP_ENABLED: 'true',
-        AQE_V3_REASONING_BANK: '.agentic-qe/memory.db',
+        ...(!dbFree ? { AQE_V3_REASONING_BANK: '.agentic-qe/memory.db' } : {}),
         AQE_V3_PATTERN_PROMOTION_THRESHOLD: String(config.learning?.promotionThreshold ?? 3),
         AQE_V3_SUCCESS_RATE_THRESHOLD: String(config.learning?.qualityThreshold ?? 0.7),
     };
@@ -206,14 +231,20 @@ export function applyV3Sections(settings, sections, options = {}) {
             settings[key] = deepMergeOwned(settings[key], value);
         }
     }
+    if (options.memoryBackend === 'memory') {
+        const learning = settings.v3Learning;
+        if (learning?.reasoningBank)
+            delete learning.reasoningBank.dbPath;
+    }
     return settings;
 }
 /**
  * Generate v3-specific settings sections for settings.json.
  * These sections enable the self-learning system, status line, and permissions.
  */
-export function generateV3SettingsSections(config, projectRoot) {
+export function generateV3SettingsSections(config, projectRoot, options = {}) {
     const domains = config.domains?.enabled || [];
+    const dbFree = options.memoryBackend === 'memory';
     return {
         aqe: {
             version: config.version ?? '3.0.0',
@@ -243,9 +274,9 @@ export function generateV3SettingsSections(config, projectRoot) {
             },
         },
         v3Learning: {
-            enabled: config.learning?.enabled ?? true,
+            enabled: dbFree ? false : config.learning?.enabled ?? true,
             reasoningBank: {
-                dbPath: '.agentic-qe/memory.db',
+                ...(!dbFree ? { dbPath: '.agentic-qe/memory.db' } : {}),
                 enableHNSW: !!config.learning?.hnswConfig,
             },
             patternPromotion: {

package/dist/integrations/agentic-flow/model-router/types.js

@@ -11,6 +11,7 @@
  *
  * @module integrations/agentic-flow/model-router/types
  */
+import { CLAUDE_TIER_MODELS, DEFAULT_OPUS_MODEL, DEFAULT_SONNET_MODEL, } from '../../../shared/llm/model-registry.js';
 /**
  * Metadata for all model tiers
  */
@@ -46,7 +47,7 @@ export const TIER_METADATA = {
         ],
         typicalLatencyMs: 500,
         relativeCost: 1,
-        exampleModels: ['claude-haiku-4-5-20251001', 'gpt-4o-mini', 'gemini-flash'],
+        exampleModels: [CLAUDE_TIER_MODELS[1], 'gpt-4o-mini', 'gemini-flash'],
         requiresNetwork: true,
         complexityRange: [10, 35],
     },
@@ -63,7 +64,7 @@ export const TIER_METADATA = {
         ],
         typicalLatencyMs: 3000,
         relativeCost: 2,
-        exampleModels: ['claude-sonnet-4-6', 'gpt-4o', 'gemini-pro'],
+        exampleModels: [DEFAULT_SONNET_MODEL, 'gpt-4o', 'gemini-pro'],
         requiresNetwork: true,
         complexityRange: [35, 70],
     },
@@ -79,7 +80,7 @@ export const TIER_METADATA = {
         ],
         typicalLatencyMs: 7000,
         relativeCost: 3,
-        exampleModels: ['claude-sonnet-4-6'],
+        exampleModels: [DEFAULT_SONNET_MODEL],
         requiresNetwork: true,
         complexityRange: [60, 85],
     },
@@ -96,7 +97,7 @@ export const TIER_METADATA = {
         ],
         typicalLatencyMs: 5000,
         relativeCost: 4,
-        exampleModels: ['claude-opus-4-7', 'gpt-4-turbo'],
+        exampleModels: [DEFAULT_OPUS_MODEL, 'gpt-4-turbo'],
         requiresNetwork: true,
         complexityRange: [75, 100],
     },
@@ -177,10 +178,7 @@ export const DEFAULT_ROUTER_CONFIG = {
     fallbackTier: 2, // Sonnet as fallback
     tierModels: {
         0: 'agent-booster',
-        1: 'claude-haiku-4-5-20251001',
-        2: 'claude-sonnet-4-6',
-        3: 'claude-sonnet-4-6',
-        4: 'claude-opus-4-7',
+        ...CLAUDE_TIER_MODELS,
     },
 };
 // ============================================================================

package/dist/integrations/ruvector/brain-exporter.js

@@ -20,7 +20,7 @@
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
 import { join, resolve } from 'path';
 import { safeJsonParse } from '../../shared/safe-json.js';
-import { sha256, queryAll, queryIterator, countRows, domainFilterForColumn, writeJsonl, writeJsonlStreaming, readJsonl, ensureTargetTables, serializeRowBlobs, deserializeRowBlobs, mergeGenericRow, mergeAppendOnlyRow, TABLE_CONFIGS, PK_COLUMNS, CONFIDENCE_COLUMNS, TIMESTAMP_COLUMNS, } from './brain-shared.js';
+import { sha256, queryAll, queryIterator, countRows, domainFilterForColumn, writeJsonl, writeJsonlStreaming, readJsonl, runImportTransaction, serializeRowBlobs, deserializeRowBlobs, mergeGenericRow, remapPatternReferences, mergeAppendOnlyRow, TABLE_CONFIGS, PK_COLUMNS, CONFIDENCE_COLUMNS, TIMESTAMP_COLUMNS, } from './brain-shared.js';
 // ============================================================================
 // Internal helpers
 // ============================================================================
@@ -219,20 +219,13 @@ export function importBrain(db, containerPath, options) {
             'The export may have been tampered with or corrupted.');
     }
     const configs = tablesToImport(manifest.version);
-    if (options.dryRun) {
-        let total = 0;
-        for (const config of configs) {
-            const rows = readJsonl(join(dir, config.fileName), safeJsonParse);
-            total += rows.length;
-        }
-        return { imported: total, skipped: 0, conflicts: 0 };
-    }
-    ensureTargetTables(db);
     let imported = 0;
     let skipped = 0;
     let conflicts = 0;
     // Wrap entire import in a transaction for atomicity (Risk #3 from plan)
-    const importAll = db.transaction(() => {
+    const importAll = () => {
+        const patternIds = new Map();
+        const patternWinners = new Map();
         for (const config of configs) {
             const filePath = join(dir, config.fileName);
             let rows = readJsonl(filePath, safeJsonParse);
@@ -240,7 +233,8 @@ export function importBrain(db, containerPath, options) {
             if (config.blobColumns && config.blobColumns.length > 0) {
                 rows = rows.map(r => deserializeRowBlobs(r, config.blobColumns));
             }
-            for (const row of rows) {
+            for (const originalRow of rows) {
+                const row = remapPatternReferences(originalRow, patternIds);
                 let result;
                 if (config.dedupColumns && config.dedupColumns.length > 0) {
                     // Append-only tables (witness_chain, qe_pattern_usage)
@@ -251,15 +245,15 @@ export function importBrain(db, containerPath, options) {
                     const idCol = PK_COLUMNS[config.tableName] || 'id';
                     const tsCol = TIMESTAMP_COLUMNS[config.tableName];
                     const confCol = CONFIDENCE_COLUMNS[config.tableName];
-                    result = mergeGenericRow(db, config.tableName, row, idCol, options.mergeStrategy, tsCol, confCol);
+                    result = mergeGenericRow(db, config.tableName, row, idCol, options.mergeStrategy, tsCol, confCol, patternIds, patternWinners, originalRow.pattern_id);
                 }
                 imported += result.imported;
                 skipped += result.skipped;
                 conflicts += result.conflicts;
             }
         }
-    });
-    importAll();
+    };
+    runImportTransaction(db, options.dryRun ?? false, importAll);
     return { imported, skipped, conflicts };
 }
 // ============================================================================

package/dist/integrations/ruvector/brain-rvf-exporter.js

@@ -6,7 +6,7 @@
 import { existsSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'fs';
 import { basename, dirname, join, resolve } from 'path';
 import { createRvfStore, openRvfStore, openRvfStoreReadonly, isRvfNativeAvailable, } from './rvf-native-adapter.js';
-import { sha256, tableExists, queryAll, domainFilterForColumn, ensureTargetTables, mergeGenericRow, mergeAppendOnlyRow, TABLE_CONFIGS, TABLE_BLOB_COLUMNS, PK_COLUMNS, CONFIDENCE_COLUMNS, TIMESTAMP_COLUMNS, serializeRowBlobs, deserializeRowBlobs, } from './brain-shared.js';
+import { sha256, tableExists, queryAll, domainFilterForColumn, runImportTransaction, mergeGenericRow, remapPatternReferences, mergeAppendOnlyRow, TABLE_CONFIGS, TABLE_BLOB_COLUMNS, PK_COLUMNS, CONFIDENCE_COLUMNS, TIMESTAMP_COLUMNS, serializeRowBlobs, deserializeRowBlobs, } from './brain-shared.js';
 // --- Export ---
 /**
  * Sidecar suffixes that make up a complete store on disk. `''` is the store
@@ -355,7 +355,7 @@ export function importBrainFromRvf(db, rvfPath, options) {
         throw new Error(`RVF file not found: ${filePath}`);
     }
     // Open read-write so compact() can reclaim space after conflict resolution (4.5)
-    const rvf = openRvfStore(filePath);
+    const rvf = options.dryRun ? openRvfStoreReadonly(filePath) : openRvfStore(filePath);
     try {
         // --- Verify HNSW index integrity before importing (4.1) ---
         // Fresh RVF files report valid=false with totalEntries=0 and no errors —
@@ -379,22 +379,6 @@ export function importBrainFromRvf(db, rvfPath, options) {
         catch (parseErr) {
             throw new Error(`Failed to parse brain kernel data as JSON: ${parseErr instanceof Error ? parseErr.message : parseErr}`);
         }
-        if (options.dryRun) {
-            let total = 0;
-            if (brainData.tables) {
-                for (const rows of Object.values(brainData.tables)) {
-                    total += (rows?.length ?? 0);
-                }
-            }
-            else {
-                total = (brainData.patterns?.length ?? 0) +
-                    (brainData.qValues?.length ?? 0) +
-                    (brainData.dreamInsights?.length ?? 0) +
-                    (brainData.witnessChain?.length ?? 0);
-            }
-            return { imported: total, skipped: 0, conflicts: 0, embeddingsRestored: 0 };
-        }
-        ensureTargetTables(db);
         let imported = 0;
         let skipped = 0;
         let conflicts = 0;
@@ -414,7 +398,9 @@ export function importBrainFromRvf(db, rvfPath, options) {
             }
         }
         // Wrap entire import in a transaction for atomicity (Risk #3 from plan)
-        const importAll = db.transaction(() => {
+        const importAll = () => {
+            const patternIds = new Map();
+            const patternWinners = new Map();
             // Import in TABLE_CONFIGS order (FK-aware)
             for (const config of TABLE_CONFIGS) {
                 let rows = tablesMap[config.tableName];
@@ -424,14 +410,9 @@ export function importBrainFromRvf(db, rvfPath, options) {
                 const blobCols = TABLE_BLOB_COLUMNS[config.tableName];
                 if (blobCols && blobCols.length > 0) {
                     rows = rows.map(r => deserializeRowBlobs(r, blobCols));
-                    for (const row of rows) {
-                        for (const col of blobCols) {
-                            if (row[col] instanceof Buffer)
-                                embeddingsRestored++;
-                        }
-                    }
                 }
-                for (const row of rows) {
+                for (const originalRow of rows) {
+                    const row = remapPatternReferences(originalRow, patternIds);
                     let result;
                     if (config.dedupColumns && config.dedupColumns.length > 0) {
                         result = mergeAppendOnlyRow(db, config.tableName, row, config.dedupColumns, config.preserveId);
@@ -440,17 +421,23 @@ export function importBrainFromRvf(db, rvfPath, options) {
                         const idCol = PK_COLUMNS[config.tableName] || 'id';
                         const tsCol = TIMESTAMP_COLUMNS[config.tableName];
                         const confCol = CONFIDENCE_COLUMNS[config.tableName];
-                        result = mergeGenericRow(db, config.tableName, row, idCol, options.mergeStrategy, tsCol, confCol);
+                        result = mergeGenericRow(db, config.tableName, row, idCol, options.mergeStrategy, tsCol, confCol, patternIds, patternWinners, originalRow.pattern_id);
+                    }
+                    if (result.imported) {
+                        for (const col of blobCols ?? []) {
+                            if (row[col] instanceof Buffer)
+                                embeddingsRestored++;
+                        }
                     }
                     imported += result.imported;
                     skipped += result.skipped;
                     conflicts += result.conflicts;
                 }
             }
-        });
-        importAll();
+        };
+        runImportTransaction(db, options.dryRun ?? false, importAll);
         // Compact after conflict resolution (best-effort)
-        if (conflicts > 0) {
+        if (!options.dryRun && conflicts > 0) {
             try {
                 rvf.compact();
             }

package/dist/integrations/ruvector/brain-shared.d.ts

@@ -131,11 +131,13 @@ export declare function writeJsonl(filePath: string, rows: unknown[]): void;
  */
 export declare function writeJsonlStreaming(filePath: string, rows: Iterable<unknown>, transform?: (row: unknown) => unknown): number;
 export declare function readJsonl<T = unknown>(filePath: string, parser?: (line: string) => T): T[];
+/** Remap relational pattern references without rewriting signed witness payloads. */
+export declare function remapPatternReferences(row: Record<string, unknown>, patternIds: ReadonlyMap<string, string>): Record<string, unknown>;
 /**
  * Generic merge for tables with a TEXT PRIMARY KEY.
  * Uses strategy-based conflict resolution identical to the pattern-specific merges.
  */
-export declare function mergeGenericRow(db: Database.Database, tableName: string, row: Record<string, unknown>, idColumn: string, strategy: MergeStrategy, timestampColumn?: string, confidenceColumn?: string): MergeResult;
+export declare function mergeGenericRow(db: Database.Database, tableName: string, row: Record<string, unknown>, idColumn: string, strategy: MergeStrategy, timestampColumn?: string, confidenceColumn?: string, patternIds?: Map<string, string>, patternWinners?: Map<string, string | null>, originalPatternId?: unknown): MergeResult;
 /**
  * Merge for append-only tables (AUTOINCREMENT PK).
  * Deduplicates by checking composite columns; inserts if no match found.
@@ -154,4 +156,6 @@ export declare function updateDreamInsight(db: Database.Database, ins: DreamInsi
 export declare function insertWitnessEntry(db: Database.Database, entry: WitnessRow): void;
 /** Ensure all brain-related tables exist in the target database. */
 export declare function ensureTargetTables(db: Database.Database): void;
+/** Execute the real importer; dry runs roll back rows and schema, including nested calls. */
+export declare function runImportTransaction(db: Database.Database, dryRun: boolean, importer: () => void): void;
 //# sourceMappingURL=brain-shared.d.ts.map

package/dist/integrations/ruvector/brain-shared.js

@@ -190,6 +190,16 @@ export function readJsonl(filePath, parser = (line) => JSON.parse(line)) {
         return [];
     return content.split('\n').map(parser);
 }
+/** Remap relational pattern references without rewriting signed witness payloads. */
+export function remapPatternReferences(row, patternIds) {
+    const mapped = { ...row };
+    for (const column of ['pattern_id', 'source_pattern_id', 'target_pattern_id']) {
+        const id = mapped[column];
+        if (typeof id === 'string' && patternIds.has(id))
+            mapped[column] = patternIds.get(id);
+    }
+    return mapped;
+}
 // --- Generic merge for TEXT PK tables ---
 /** Dynamically insert a row into any table using its column keys. */
 function dynamicInsert(db, tableName, row) {
@@ -212,18 +222,57 @@ function dynamicUpdate(db, tableName, row, idColumn) {
  * Generic merge for tables with a TEXT PRIMARY KEY.
  * Uses strategy-based conflict resolution identical to the pattern-specific merges.
  */
-export function mergeGenericRow(db, tableName, row, idColumn, strategy, timestampColumn, confidenceColumn) {
+export function mergeGenericRow(db, tableName, row, idColumn, strategy, timestampColumn, confidenceColumn, patternIds, patternWinners, originalPatternId) {
     const validated = validateTableName(tableName);
+    const incomingId = String(row.id);
     if (!tableExists(db, validated)) {
         dynamicInsert(db, validated, row);
         return { imported: 1, skipped: 0, conflicts: 0 };
     }
-    const existing = db.prepare(`SELECT * FROM ${validated} WHERE ${idColumn} = ?`)
+    let existing = db.prepare(`SELECT * FROM ${validated} WHERE ${idColumn} = ?`)
         .get(row[idColumn]);
+    if (!existing && tableName === 'qe_patterns') {
+        existing = db.prepare('SELECT * FROM qe_patterns WHERE name = ? AND qe_domain = ? AND pattern_type = ?').get(row.name, row.qe_domain, row.pattern_type);
+    }
+    if (existing && tableName === 'qe_patterns') {
+        // Keep the destination identity: existing children must remain attached,
+        // and incoming children are remapped after all patterns have merged.
+        if (typeof row.id === 'string' && typeof existing.id === 'string') {
+            patternIds?.set(row.id, existing.id);
+        }
+        row = { ...row, id: existing.id };
+        if (!patternWinners?.has(String(existing.id)))
+            patternWinners?.set(String(existing.id), null);
+    }
+    if (tableName === 'qe_pattern_embeddings' && patternWinners?.has(String(row.pattern_id))) {
+        if (patternWinners.get(String(row.pattern_id)) !== originalPatternId) {
+            return { imported: 0, skipped: 1, conflicts: existing ? 1 : 0 };
+        }
+        if (existing)
+            dynamicUpdate(db, validated, row, idColumn);
+        else
+            dynamicInsert(db, validated, row);
+        return { imported: 1, skipped: 0, conflicts: existing ? 1 : 0 };
+    }
     if (!existing) {
+        if (tableName === 'qe_patterns')
+            patternWinners?.set(String(row.id), incomingId);
         dynamicInsert(db, validated, row);
         return { imported: 1, skipped: 0, conflicts: 0 };
     }
+    const replaceExisting = () => {
+        if (tableName === 'qe_patterns' && patternWinners) {
+            patternWinners.set(String(row.id), incomingId);
+            // An embedding describes pattern content, not its confidence or usage.
+            // Keep a valid vector for metadata-only updates when no vector is supplied.
+            const contentColumns = ['name', 'description', 'pattern_type', 'qe_domain', 'domain', 'template_json', 'context_json'];
+            if (contentColumns.some(column => Object.hasOwn(row, column) && (row[column] ?? null) !== (existing[column] ?? null)) &&
+                tableExists(db, 'qe_pattern_embeddings')) {
+                db.prepare('DELETE FROM qe_pattern_embeddings WHERE pattern_id = ?').run(row.id);
+            }
+        }
+        dynamicUpdate(db, validated, row, idColumn);
+    };
     switch (strategy) {
         case 'skip-conflicts':
             return { imported: 0, skipped: 1, conflicts: 1 };
@@ -232,7 +281,7 @@ export function mergeGenericRow(db, tableName, row, idColumn, strategy, timestam
             const existingTime = existing[ts] || '';
             const incomingTime = row[ts] || '';
             if (incomingTime > existingTime) {
-                dynamicUpdate(db, validated, row, idColumn);
+                replaceExisting();
                 return { imported: 1, skipped: 0, conflicts: 1 };
             }
             return { imported: 0, skipped: 1, conflicts: 1 };
@@ -241,7 +290,7 @@ export function mergeGenericRow(db, tableName, row, idColumn, strategy, timestam
             const cc = confidenceColumn || 'confidence';
             if (typeof row[cc] === 'number' && typeof existing[cc] === 'number') {
                 if (row[cc] > existing[cc]) {
-                    dynamicUpdate(db, validated, row, idColumn);
+                    replaceExisting();
                     return { imported: 1, skipped: 0, conflicts: 1 };
                 }
             }
@@ -349,4 +398,21 @@ export function insertWitnessEntry(db, entry) {
 export function ensureTargetTables(db) {
     ensureAllBrainTables(db);
 }
+/** Execute the real importer; dry runs roll back rows and schema, including nested calls. */
+export function runImportTransaction(db, dryRun, importer) {
+    const rollback = Symbol('brain import dry run');
+    const transaction = db.transaction(() => {
+        ensureTargetTables(db);
+        importer();
+        if (dryRun)
+            throw rollback;
+    });
+    try {
+        transaction();
+    }
+    catch (error) {
+        if (error !== rollback)
+            throw error;
+    }
+}
 //# sourceMappingURL=brain-shared.js.map