agentic-qe 3.14.2 → 3.14.4

package/dist/domains/test-execution/services/retry-handler.js

@@ -4,6 +4,7 @@
  */
 import { LoggerFactory } from '../../../logging/index.js';
 import { spawn } from 'node:child_process';
+import { createVitestJsonReport } from '../../../shared/vitest-json-report.js';
 import { existsSync, readFileSync } from 'node:fs';
 import { ok, err } from '../../../shared/types/index.js';
 import { TEST_EXECUTION_CONSTANTS, RETRY_CONSTANTS } from '../../constants.js';
@@ -262,9 +263,9 @@ export class RetryHandlerService {
                 `or configure testRunner in RetryHandlerConfig. Cannot execute retry for: ${testFile}`);
         }
         // Build command based on runner
-        const { command, args } = this.buildTestCommand(runner, testFile, testName);
+        const { command, args, report } = this.buildTestCommand(runner, testFile, testName);
         // Execute the test
-        return this.spawnTestProcess(command, args, cwd);
+        return this.spawnTestProcess(command, args, cwd, report);
     }
     /**
      * Detect which test runner is available in the project
@@ -323,7 +324,7 @@ export class RetryHandlerService {
                     return 'mocha';
             }
         }
-        catch (error) {
+        catch {
             // Non-critical: package.json read errors during test runner detection
             logger.debug('package.json read failed:');
         }
@@ -337,12 +338,15 @@ export class RetryHandlerService {
         switch (runner) {
             case 'vitest':
                 // vitest run --reporter=json testFile -t "testName"
+                // --outputFile: Vitest 5 no longer prints the JSON report to stdout.
                 {
+                    const report = createVitestJsonReport();
                     const vitestArgs = ['vitest', 'run', '--reporter=json', testFile];
                     if (testName && testName !== testFile) {
                         vitestArgs.push('-t', testName);
                     }
-                    return { command: npx, args: vitestArgs };
+                    vitestArgs.push(...report.args);
+                    return { command: npx, args: vitestArgs, report };
                 }
             case 'jest':
                 // jest --json testFile -t "testName"
@@ -369,12 +373,16 @@ export class RetryHandlerService {
     /**
      * Spawn a test process and parse the result
      */
-    spawnTestProcess(command, args, cwd) {
+    spawnTestProcess(command, args, cwd, report) {
         return new Promise((resolve, reject) => {
             const timeout = this.config.testTimeout;
             let stdout = '';
             let stderr = '';
             let timedOut = false;
+            const settle = (fn, value) => {
+                report?.cleanup();
+                fn(value);
+            };
             // Note: shell: false (default) to prevent command injection (CWE-78)
             // Arguments are passed as array to avoid shell interpretation
             const proc = spawn(command, args, {
@@ -396,15 +404,25 @@ export class RetryHandlerService {
             proc.on('close', (code) => {
                 clearTimeout(timeoutHandle);
                 if (timedOut) {
-                    reject(new Error(`Test execution timed out after ${timeout}ms for command: ${command} ${args.join(' ')}`));
+                    settle(reject, new Error(`Test execution timed out after ${timeout}ms for command: ${command} ${args.join(' ')}`));
                     return;
                 }
-                // Parse result based on exit code and output
-                const result = this.parseTestResult(code, stdout, stderr);
-                resolve(result);
+                // Parse result based on exit code and output (Vitest writes the JSON
+                // report to the --outputFile; read it back rather than trusting stdout).
+                try {
+                    const reportText = report ? report.read(stdout) : stdout;
+                    if (reportText === undefined) {
+                        throw new Error('The current Vitest JSON report is missing for the retry run.');
+                    }
+                    settle(resolve, this.parseTestResult(code, reportText, stderr));
+                }
+                catch (error) {
+                    settle(reject, toError(error));
+                }
             });
             proc.on('error', (err) => {
                 clearTimeout(timeoutHandle);
+                report?.cleanup();
                 reject(new Error(`Failed to spawn test process: ${err.message}. ` +
                     `Command: ${command} ${args.join(' ')}. ` +
                     `Ensure the test runner is installed and accessible.`));
@@ -415,55 +433,55 @@ export class RetryHandlerService {
      * Parse test runner output to determine pass/fail status
      */
     parseTestResult(exitCode, stdout, stderr) {
-        // Exit code 0 typically means all tests passed
-        if (exitCode === 0) {
-            return { passed: true };
-        }
-        // Try to parse JSON output for more detailed error info
+        // A passing process and a passing report must agree when JSON is available.
         try {
             // Vitest JSON output
             const vitestMatch = stdout.match(/\{[\s\S]*"testResults"[\s\S]*\}/);
             if (vitestMatch) {
                 const result = safeJsonParse(vitestMatch[0]);
-                if (result.success === true || result.numFailedTests === 0) {
+                if (exitCode === 0 && result.success !== false
+                    && result.numFailedTests === 0 && result.numFailedTestSuites === 0) {
                     return { passed: true };
                 }
                 const failedTest = result.testResults?.[0]?.assertionResults?.find((r) => r.status === 'failed');
                 return {
                     passed: false,
-                    error: failedTest?.failureMessages?.join('\n') ?? `Test failed with exit code ${exitCode}`,
+                    error: failedTest?.failureMessages?.join('\n') || stderr || `Test failed with exit code ${exitCode}`,
                 };
             }
             // Jest JSON output
             const jestMatch = stdout.match(/\{[\s\S]*"numFailedTests"[\s\S]*\}/);
             if (jestMatch) {
                 const result = safeJsonParse(jestMatch[0]);
-                if (result.success === true || result.numFailedTests === 0) {
+                if (exitCode === 0 && result.success !== false
+                    && result.numFailedTests === 0 && result.numFailedTestSuites === 0) {
                     return { passed: true };
                 }
                 const failedTest = result.testResults?.[0]?.assertionResults?.find((r) => r.status === 'failed');
                 return {
                     passed: false,
-                    error: failedTest?.failureMessages?.join('\n') ?? `Test failed with exit code ${exitCode}`,
+                    error: failedTest?.failureMessages?.join('\n') || stderr || `Test failed with exit code ${exitCode}`,
                 };
             }
             // Mocha JSON output
             const mochaMatch = stdout.match(/\{[\s\S]*"stats"[\s\S]*"failures"[\s\S]*\}/);
             if (mochaMatch) {
                 const result = safeJsonParse(mochaMatch[0]);
-                if (result.stats?.failures === 0) {
+                if (exitCode === 0 && result.stats?.failures === 0) {
                     return { passed: true };
                 }
                 const failure = result.failures?.[0];
                 return {
                     passed: false,
-                    error: failure?.err?.message ?? `Test failed with exit code ${exitCode}`,
+                    error: failure?.err?.message || stderr || `Test failed with exit code ${exitCode}`,
                 };
             }
         }
         catch {
             // JSON parsing failed, fall back to simple exit code check
         }
+        if (exitCode === 0)
+            return { passed: true };
         // Non-zero exit code means failure
         const errorOutput = stderr || stdout || `Test failed with exit code ${exitCode}`;
         return {

package/dist/domains/test-execution/services/test-executor.js

@@ -13,6 +13,9 @@ import { toErrorMessage, toError } from '../../../shared/error-utils.js';
 import { safeJsonParse } from '../../../shared/safe-json.js';
 import { secureRandom, secureRandomInt } from '../../../shared/utils/crypto-random.js';
 import { writeQualityEvidence } from '../../quality-assessment/quality-evidence.js';
+import { getTestRunnerExecutionError, TestRunnerExecutionError } from '../../../shared/test-runner-verdict.js';
+import { createVitestJsonReport } from '../../../shared/vitest-json-report.js';
+import { getClaudeModelForTier } from '../../../shared/llm/model-registry.js';
 const DEFAULT_CONFIG = {
     simulateForTesting: false,
     simulatedTestsPerFile: 5,
@@ -239,13 +242,7 @@ export class TestExecutorService {
      * ADR-051: Get model name for 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);
     }
     /**
      * ADR-051: LLM-powered test failure analysis
@@ -271,7 +268,7 @@ Provide:
             });
             return response.content;
         }
-        catch (error) {
+        catch {
             logger.warn('LLM analysis failed:');
             return null;
         }
@@ -340,6 +337,9 @@ Provide:
         // Production mode: spawn actual test runner process
         const result = await this.spawnTestRunner(files, framework, timeout);
         if (result.success === false) {
+            // Runner/suite errors have no trustworthy assertion receipt to aggregate.
+            if (result.error instanceof TestRunnerExecutionError)
+                throw result.error;
             // Return as a failed test rather than throwing — allows other files to still run
             return {
                 total: files.length,
@@ -368,28 +368,44 @@ Provide:
             return err(new Error(`Test file not found: ${missingFile}`));
         }
         // Build command based on framework
-        const { command, args } = this.buildTestCommand(files, framework);
+        const { command, args, report } = this.buildTestCommand(files, framework);
         const fileLabel = files.join(', ');
         return new Promise((resolve) => {
             let stdout = '';
             let stderr = '';
             let killed = false;
+            let settled = false;
+            const finish = (result, cleanup = true) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (cleanup)
+                    report?.cleanup();
+                resolve(result);
+            };
             // Spawn the test runner process
             // Note: shell: false (default) to prevent command injection (CWE-78)
             // Arguments are passed as array to avoid shell interpretation
-            const proc = spawn(command, args, {
-                cwd: process.cwd(),
-                env: {
-                    ...process.env,
-                    FORCE_COLOR: '0', // Disable color codes for easier parsing
-                    CI: 'true', // Enable CI mode for consistent output
-                },
-            });
+            let proc;
+            try {
+                proc = spawn(command, args, {
+                    cwd: process.cwd(),
+                    env: {
+                        ...process.env,
+                        FORCE_COLOR: '0', // Disable color codes for easier parsing
+                        CI: 'true', // Enable CI mode for consistent output
+                    },
+                });
+            }
+            catch (error) {
+                finish(err(new Error(`Failed to spawn test runner: ${toErrorMessage(error)}. Is '${command}' installed?`)));
+                return;
+            }
             // Set timeout
             const timeoutId = setTimeout(() => {
                 killed = true;
                 proc.kill('SIGTERM');
-                resolve(err(new Error(`Test execution timed out after ${timeout}ms for files: ${fileLabel}`)));
+                finish(err(new Error(`Test execution timed out after ${timeout}ms for files: ${fileLabel}`)), false);
             }, timeout);
             proc.stdout?.on('data', (data) => {
                 stdout += data.toString();
@@ -400,10 +416,24 @@ Provide:
             proc.on('close', (code) => {
                 clearTimeout(timeoutId);
                 if (killed) {
-                    return; // Already handled by timeout
+                    report?.cleanup();
+                    return; // Timeout result was already returned; child has now closed.
+                }
+                // Parse results based on framework. Vitest 5 writes the JSON report to
+                // a file instead of stdout, so read it back through the report handle.
+                let reportText;
+                try {
+                    reportText = report ? report.read(stdout) : stdout;
+                }
+                catch (error) {
+                    finish(err(toError(error)));
+                    return;
                 }
-                // Parse results based on framework
-                const parseResult = this.parseTestOutput(stdout, stderr, fileLabel, framework, code);
+                if (reportText === undefined) {
+                    finish(err(new Error(`The current Vitest JSON report is missing for ${fileLabel}.`)));
+                    return;
+                }
+                const parseResult = this.parseTestOutput(reportText, stderr, fileLabel, framework, code);
                 // If no coverage in stdout JSON, try reading from disk
                 // (vitest/jest write coverage to coverage/coverage-summary.json)
                 if (parseResult.success && !parseResult.value.coverage && ['vitest', 'jest'].includes(framework.toLowerCase())) {
@@ -415,11 +445,13 @@ Provide:
                         }
                     }
                 }
-                resolve(parseResult);
+                finish(parseResult);
             });
             proc.on('error', (error) => {
                 clearTimeout(timeoutId);
-                resolve(err(new Error(`Failed to spawn test runner: ${error.message}. Is '${command}' installed?`)));
+                if (killed)
+                    return;
+                finish(err(new Error(`Failed to spawn test runner: ${error.message}. Is '${command}' installed?`)));
             });
         });
     }
@@ -429,11 +461,16 @@ Provide:
     buildTestCommand(fileOrFiles, framework) {
         const files = Array.isArray(fileOrFiles) ? fileOrFiles : [fileOrFiles];
         switch (framework.toLowerCase()) {
-            case 'vitest':
+            case 'vitest': {
+                // --outputFile makes Vitest 4 and 5 both write the JSON report to a
+                // file we own; Vitest 5 no longer prints it to stdout.
+                const report = createVitestJsonReport();
                 return {
                     command: 'npx',
-                    args: ['vitest', 'run', ...files, '--reporter=json', '--no-color'],
+                    args: ['vitest', 'run', ...files, '--reporter=json', '--no-color', ...report.args],
+                    report,
                 };
+            }
             case 'jest':
                 return {
                     command: 'npx',
@@ -452,12 +489,15 @@ Provide:
                     command: process.execPath,
                     args: ['--test', ...files],
                 };
-            default:
+            default: {
                 // Default to vitest
+                const report = createVitestJsonReport();
                 return {
                     command: 'npx',
-                    args: ['vitest', 'run', ...files, '--reporter=json', '--no-color'],
+                    args: ['vitest', 'run', ...files, '--reporter=json', '--no-color', ...report.args],
+                    report,
                 };
+            }
         }
     }
     /**
@@ -555,11 +595,14 @@ Provide:
                                 duration: assertion.duration || 0,
                             });
                         }
-                        else if (assertion.status === 'skipped' || assertion.status === 'pending') {
+                        else if (assertion.status === 'skipped' || assertion.status === 'pending' || assertion.status === 'todo') {
                             skipped++;
                         }
                     }
                 }
+                const executionError = getTestRunnerExecutionError('vitest', file, exitCode, { passed, failed, skipped }, stderr + '\n' + stdout, json);
+                if (executionError)
+                    return err(executionError);
                 const covData = this.extractCoverageFromJson(json);
                 return ok({
                     total: passed + failed + skipped,
@@ -606,11 +649,14 @@ Provide:
                             duration: assertion.duration || 0,
                         });
                     }
-                    else if (assertion.status === 'skipped' || assertion.status === 'pending') {
+                    else if (assertion.status === 'skipped' || assertion.status === 'pending' || assertion.status === 'todo') {
                         skipped++;
                     }
                 }
             }
+            const executionError = getTestRunnerExecutionError('jest', file, exitCode, { passed, failed, skipped }, stderr + '\n' + stdout, json);
+            if (executionError)
+                return err(executionError);
             const covData = this.extractCoverageFromJson(json);
             return ok({
                 total: passed + failed + skipped,
@@ -646,6 +692,9 @@ Provide:
                     duration: failure.duration || 0,
                 });
             }
+            const executionError = getTestRunnerExecutionError('mocha', file, exitCode, { passed, failed, skipped }, stderr + '\n' + stdout);
+            if (executionError)
+                return err(executionError);
             return ok({
                 total: passed + failed + skipped,
                 passed,
@@ -673,6 +722,9 @@ Provide:
             const passed = parseInt(vitestMatch[1], 10) || 0;
             const failed = parseInt(vitestMatch[2], 10) || 0;
             const skipped = parseInt(vitestMatch[3], 10) || 0;
+            const executionError = getTestRunnerExecutionError('Test runner', file, exitCode, { passed, failed, skipped }, combinedOutput);
+            if (executionError)
+                return err(executionError);
             return ok({
                 total: passed + failed + skipped,
                 passed,
@@ -688,6 +740,9 @@ Provide:
             const failed = parseInt(jestMatch[1], 10) || 0;
             const skipped = parseInt(jestMatch[2], 10) || 0;
             const passed = parseInt(jestMatch[3], 10) || 0;
+            const executionError = getTestRunnerExecutionError('Test runner', file, exitCode, { passed, failed, skipped }, combinedOutput);
+            if (executionError)
+                return err(executionError);
             return ok({
                 total: passed + failed + skipped,
                 passed,

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-hooks.js

@@ -406,9 +406,9 @@ mcp__agentic-qe__test_generate_enhanced({
   detectAntiPatterns: true
 })
 
-// Parallel test execution with retry
+// Parallel test execution with retry (concrete paths; expand globs before calling)
 mcp__agentic-qe__test_execute_parallel({
-  testFiles: ["tests/**/*.test.ts"],
+  testFiles: ["tests/auth.test.ts", "tests/session.test.ts"],
   parallelism: 4,
   retryFailures: true,
   maxRetries: 3,

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