agentic-qe 3.14.3 → 3.14.5

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/codex-installer.js

@@ -9,6 +9,7 @@ import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSyn
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { toErrorMessage } from '../shared/error-utils.js';
+import { findPackageRoot } from './find-package-root.js';
 import { selectCodexSkills } from './codex-skill-manifest.js';
 import { createPlatformConfigGenerator, } from './platform-config-generator.js';
 export const CODEX_COMPACT_GUIDANCE_MAX_BYTES = 512;
@@ -111,7 +112,7 @@ export class CodexInstaller {
                 result.ownedGuidanceBytes = Buffer.byteLength(marked);
                 result.components.rules.status = 'installed';
             }
-            else if (this.overwrite || policy === 'compact') {
+            else {
                 const content = policy === 'compact' ? COMPACT_CODEX_GUIDANCE : rules.content;
                 const existing = readFileSync(agentsMdPath, 'utf-8');
                 const merged = this.mergeExistingAgentsMdContent(existing, content);
@@ -125,10 +126,6 @@ export class CodexInstaller {
                 }
                 result.ownedGuidanceBytes = this.measureOwnedAgentsSection(merged);
             }
-            else {
-                result.components.rules.status = 'preserved';
-                result.ownedGuidanceBytes = this.measureOwnedAgentsSection(readFileSync(agentsMdPath, 'utf-8'));
-            }
         }
         catch (error) {
             this.recordComponentFailure(result, 'rules', error);
@@ -147,6 +144,13 @@ export class CodexInstaller {
         catch (error) {
             this.recordComponentFailure(result, 'skills', error);
         }
+        for (const component of ['hooks', 'skills']) {
+            if (result.components[component].status === 'unavailable') {
+                const message = `Codex ${component} unavailable: packaged assets could not be located`;
+                result.components[component].error = message;
+                result.errors.push(message);
+            }
+        }
         result.success = result.errors.length === 0;
         return result;
     }
@@ -297,6 +301,11 @@ export class CodexInstaller {
         }
     }
     resolvePackageRoot() {
+        // Bundled chunks retain their real package location even when npm's aqe
+        // bin is a symlink in a global prefix.
+        const packagedRoot = findPackageRoot(import.meta.url);
+        if (packagedRoot)
+            return packagedRoot;
         const moduleDir = dirname(fileURLToPath(import.meta.url));
         const candidates = [
             join(moduleDir, '..', '..'),
@@ -348,7 +357,10 @@ export class CodexInstaller {
             return merged;
         if (existing.length === 0)
             return marked;
-        return existing.trimEnd() + `${eol}${eol}---${eol}${eol}` + marked;
+        // The owned block starts at the original EOF. Keeping every pre-existing
+        // byte outside the sentinel lets `none` remove the block exactly, even
+        // when the user's file has no trailing newline.
+        return existing + marked;
     }
     removeOwnedAgentsSections(existing) {
         this.assertOwnedAgentsSectionsWellFormed(existing);

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/orchestrator.js

@@ -158,6 +158,7 @@ export class ModularInitOrchestrator {
                 claudeMdGenerated: claudeMdResult?.data?.generated ?? false,
                 workersStarted: workersResult?.data?.workersConfigured ?? 0,
                 codexGuidance: assetsResult?.data?.codexGuidance,
+                codexComponents: assetsResult?.data?.codexComponents,
             },
             totalDurationMs: Date.now() - startTime,
             timestamp: new Date(),

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/09-assets.d.ts

@@ -20,6 +20,16 @@ export interface AssetsResult {
         policy: 'full' | 'compact' | 'none';
         ownedBytes: number;
     };
+    codexComponents?: {
+        hooks: {
+            status: string;
+            error?: string;
+        };
+        skills: {
+            status: string;
+            error?: string;
+        };
+    };
 }
 /**
  * Assets phase - installs skills and agents

package/dist/init/phases/09-assets.js

@@ -37,6 +37,7 @@ export class AssetsPhase extends BasePhase {
         let kiroSkills = 0;
         let kiroHooks = 0;
         let codexGuidance;
+        let codexComponents;
         if (options.upgrade) {
             context.services.log(`  Upgrade mode: overwriting existing files`);
         }
@@ -303,6 +304,7 @@ export class AssetsPhase extends BasePhase {
             });
             const res = await installer.install();
             codexGuidance = { policy: res.guidancePolicy, ownedBytes: res.ownedGuidanceBytes };
+            codexComponents = { hooks: res.components.hooks, skills: res.components.skills };
             if (res.mcpConfigured)
                 platformsConfigured.push('codex');
             if (res.errors.length > 0)
@@ -361,6 +363,7 @@ export class AssetsPhase extends BasePhase {
             platformsConfigured,
             browserEngine,
             codexGuidance,
+            codexComponents,
         };
     }
     /**

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/init/token-bootstrap.d.ts

@@ -13,7 +13,7 @@ export interface TokenBootstrapConfig {
     enableOptimization: boolean;
     /** Enable persistence (default: true) */
     enablePersistence: boolean;
-    /** Storage directory for metrics (default: .aqe) */
+    /** Storage directory for metrics (default: <project>/.agentic-qe) */
     storagePath: string;
     /** Auto-save interval in ms (default: 60000 = 1 minute) */
     autoSaveIntervalMs: number;

package/dist/init/token-bootstrap.js

@@ -12,10 +12,11 @@ import * as fs from 'fs';
 import { initializeTokenOptimizer, TokenOptimizerService } from '../optimization/token-optimizer-service.js';
 import { TokenMetricsCollector } from '../learning/token-tracker.js';
 import { createDefaultMemoryBackend } from '../kernel/memory-factory.js';
+import { findProjectRoot } from '../kernel/project-root.js';
 const DEFAULT_CONFIG = {
     enableOptimization: true,
     enablePersistence: true,
-    storagePath: process.env.AQE_STORAGE_PATH ?? '.agentic-qe',
+    storagePath: '.agentic-qe',
     autoSaveIntervalMs: 60000,
     verbose: process.env.AQE_VERBOSE === 'true',
 };
@@ -36,7 +37,16 @@ export async function bootstrapTokenTracking(config) {
     if (initialized) {
         return;
     }
-    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // Resolve the project before creating any directory: a new cwd-local store
+    // would otherwise become the nearest AQE root and split project memory.
+    // A relative AQE_STORAGE_PATH is anchored at the project root too, so it
+    // cannot recreate a cwd-local store from a subdirectory.
+    const envStorage = process.env.AQE_STORAGE_PATH;
+    const cfg = {
+        ...DEFAULT_CONFIG, ...config,
+        storagePath: config?.storagePath
+            ?? (envStorage ? path.resolve(findProjectRoot(), envStorage) : path.join(findProjectRoot(), '.agentic-qe')),
+    };
     if (cfg.verbose) {
         console.log('[TokenBootstrap] Initializing token tracking...');
     }

package/dist/init/types.d.ts

@@ -227,6 +227,16 @@ export interface InitResult {
             policy: 'full' | 'compact' | 'none';
             ownedBytes: number;
         };
+        codexComponents?: {
+            hooks: {
+                status: string;
+                error?: string;
+            };
+            skills: {
+                status: string;
+                error?: string;
+            };
+        };
     };
     totalDurationMs: number;
     timestamp: Date;

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,8 @@
 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';
+import { appendBrainImportWitness } from './brain-import-audit.js';
 // ============================================================================
 // Internal helpers
 // ============================================================================
@@ -219,28 +220,30 @@ 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();
+        let sourceWitnessRows = 0;
         for (const config of configs) {
             const filePath = join(dir, config.fileName);
             let rows = readJsonl(filePath, safeJsonParse);
+            if (config.tableName === 'witness_chain') {
+                // Source rows are signed/linked to a different store. Copying them into
+                // this live chain would make the first imported predecessor invalid.
+                sourceWitnessRows += rows.length;
+                skipped += rows.length;
+                continue;
+            }
             // Deserialize BLOBs from Base64
             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 +254,23 @@ 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();
+        appendBrainImportWitness(db, {
+            sourceChecksum: manifest.checksum,
+            sourceWitnessRows,
+            importedRecords: imported,
+            skippedRecords: skipped,
+            conflicts,
+        });
+        imported += 1;
+    };
+    runImportTransaction(db, options.dryRun ?? false, importAll);
     return { imported, skipped, conflicts };
 }
 // ============================================================================

package/dist/integrations/ruvector/brain-import-audit.d.ts

@@ -0,0 +1,20 @@
+/** Record a brain import without grafting another store's witness history. */
+import type Database from 'better-sqlite3';
+interface BrainImportAuditDetails {
+    sourceChecksum: string;
+    sourceWitnessRows: number;
+    importedRecords: number;
+    skippedRecords: number;
+    conflicts: number;
+}
+/**
+ * Call inside the import transaction, after merging all non-witness tables.
+ *
+ * Reuses WitnessChain's own hashing/serialization so the link format cannot
+ * drift from what WitnessChain.verify() checks. The row is intentionally left
+ * unsigned: the target DB may belong to a different project than the CWD, so
+ * the process-default signing key is not necessarily the target's key.
+ */
+export declare function appendBrainImportWitness(db: Database.Database, details: BrainImportAuditDetails): void;
+export {};
+//# sourceMappingURL=brain-import-audit.d.ts.map

package/dist/integrations/ruvector/brain-import-audit.js

@@ -0,0 +1,22 @@
+import { GENESIS_PREV_HASH, hashWith, serializeEntry, } from '../../audit/witness-chain.js';
+/**
+ * Call inside the import transaction, after merging all non-witness tables.
+ *
+ * Reuses WitnessChain's own hashing/serialization so the link format cannot
+ * drift from what WitnessChain.verify() checks. The row is intentionally left
+ * unsigned: the target DB may belong to a different project than the CWD, so
+ * the process-default signing key is not necessarily the target's key.
+ */
+export function appendBrainImportWitness(db, details) {
+    const algo = 'shake256';
+    const actionData = JSON.stringify(details);
+    const last = db.prepare('SELECT * FROM witness_chain ORDER BY id DESC LIMIT 1')
+        .get();
+    const previousHash = last ? hashWith(algo, serializeEntry(last)) : GENESIS_PREV_HASH;
+    db.prepare(`
+    INSERT INTO witness_chain
+      (prev_hash, action_hash, action_type, action_data, timestamp, actor, hash_algo)
+    VALUES (?, ?, 'BRAIN_IMPORT', ?, ?, 'brain-import', ?)
+  `).run(previousHash, hashWith(algo, actionData), actionData, new Date().toISOString(), algo);
+}
+//# sourceMappingURL=brain-import-audit.js.map