@chude/memory 4.0.0

package/dist/presentation/cli/commands/search.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Search Command Handler
+ *
+ * CLI command for full-text and hybrid search across synced sessions.
+ * Wires to HybridSearchService supporting auto, FTS, vector, and hybrid modes.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+import type { SearchResult } from "../../../domain/value-objects/search-result.js";
+import type { SearchMode } from "../../../domain/ports/services.js";
+/**
+ * Options for the search command.
+ */
+export interface SearchCommandOptions {
+    /** Maximum results to return (as string, parsed to integer) */
+    limit?: string;
+    /** Filter by project name */
+    project?: string;
+    /** Filter by session ID */
+    session?: string;
+    /** Filter by role: user, assistant, or both (comma-separated) */
+    role?: string;
+    /** Results after date (e.g., 'yesterday', '2 weeks ago') */
+    since?: string;
+    /** Results before date */
+    before?: string;
+    /** Results from last N days (includes today) */
+    days?: number;
+    /** Output results as JSON */
+    json?: boolean;
+    /** Case-insensitive search (default) */
+    ignoreCase?: boolean;
+    /** Case-sensitive search */
+    caseSensitive?: boolean;
+    /** Show detailed output with execution info */
+    verbose?: boolean;
+    /** Suppress headers and decorations */
+    quiet?: boolean;
+    /** Search mode: auto, fts, vector, or hybrid */
+    mode?: string;
+    /** Set to false via --no-vector to disable vector search */
+    vector?: boolean;
+    /** Set to false via --no-decay to disable temporal decay scoring */
+    decay?: boolean;
+    /**
+     * Output format. Phase 32 (CLI-03) normalized choices: `brief`,
+     * `ai`. `default` retained as deprecated alias (one-minor cadence;
+     * CHANGELOG documents removal). Undefined = no-flag default text
+     * output (backward compatible).
+     */
+    format?: "brief" | "ai" | "default";
+    /** Search markdown files via qmd (requires qmd installed) */
+    files?: boolean;
+    /** Override database path (for testing) */
+    dbPath?: string;
+}
+/**
+ * Resolve the effective search mode from CLI flags.
+ *
+ * --no-vector always forces FTS mode (DEGRADE-04), overriding --mode.
+ * --mode auto returns undefined to let HybridSearchService decide.
+ * Explicit modes (fts, vector, hybrid) are returned directly.
+ *
+ * @param options Partial options with mode and noVector flags
+ * @returns Resolved SearchMode or undefined for auto
+ */
+export declare function resolveSearchMode(options: {
+    mode?: string;
+    vector?: boolean;
+}): SearchMode | undefined;
+/**
+ * Create the search command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createSearchCommand(): Command;
+/**
+ * Execute the search command programmatically.
+ *
+ * Searches sessions using FTS5 or hybrid semantic search. Handles its own
+ * database initialization and teardown.
+ *
+ * @param query - The search string (must be non-empty)
+ * @param options - Search command options
+ * @returns CommandResult with exitCode 0 (success) or 1 (error)
+ */
+export declare function executeSearchCommand(query: string, options: SearchCommandOptions): Promise<CommandResult>;
+/**
+ * Internal implementation of the search query execution.
+ */
+export declare function runSearchInternal(query: string, options: SearchCommandOptions): Promise<CommandResult>;
+/**
+ * Filter results to only include those with case-sensitive match in snippet.
+ *
+ * @param results Search results from FTS5
+ * @param query Original query string
+ * @param limit Maximum results to return after filtering
+ * @returns Filtered results matching exact case
+ */
+export declare function filterCaseSensitive(results: SearchResult[], query: string, limit: number): SearchResult[];

package/dist/presentation/cli/commands/show.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Show Command Handler
+ *
+ * CLI command for displaying session details with conversation thread format.
+ * Supports partial session ID matching and multiple output modes.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the show command.
+ */
+export interface ShowCommandOptions {
+    /** Output as JSON */
+    json?: boolean;
+    /** Show detailed output */
+    verbose?: boolean;
+    /** Minimal output (message content only) */
+    quiet?: boolean;
+    /** Show detailed tool inputs and outputs */
+    tools?: boolean;
+    /**
+     * Output format. Phase 32 (CLI-03) normalized choices: `brief`,
+     * `ai`. `default` retained as deprecated alias (one-minor cadence;
+     * CHANGELOG documents removal). Undefined = no-flag default
+     * (backward compatible).
+     */
+    format?: "brief" | "ai" | "default";
+}
+/**
+ * Runtime dependencies for executeShowCommand.
+ *
+ * Separated from ShowCommandOptions because these are not user-facing
+ * CLI flags — they are operational dependencies that tests substitute
+ * to achieve isolation. Defaults to production resolution
+ * (getDefaultDbPath()) when omitted.
+ */
+export interface ShowCommandDeps {
+    /** Database path. Defaults to getDefaultDbPath(). */
+    dbPath?: string;
+}
+/**
+ * Create the show command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createShowCommand(): Command;
+export declare function executeShowCommand(sessionId: string, options: ShowCommandOptions, deps?: ShowCommandDeps): Promise<CommandResult>;
+/**
+ * Internal implementation of the show query execution.
+ */
+export declare function runShowInternal(sessionId: string, options: ShowCommandOptions, deps?: ShowCommandDeps): Promise<CommandResult>;

package/dist/presentation/cli/commands/stats.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Stats Command Handler (Wrapper)
+ *
+ * Thin view that delegates database stats overview to executeStatusCommand.
+ * Maintained for backwards compatibility.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the stats command.
+ */
+export interface StatsCommandOptions {
+    /** Output as JSON */
+    json?: boolean;
+    /** Show detailed output with timing */
+    verbose?: boolean;
+    /** Minimal output */
+    quiet?: boolean;
+    /** Number of projects to show in breakdown */
+    projects?: string;
+    /** Output format */
+    format?: "brief" | "ai" | "default";
+}
+/**
+ * Runtime dependencies for executeStatsCommand.
+ */
+export interface StatsCommandDeps {
+    /** Database path. Defaults to getDefaultDbPath(). */
+    dbPath?: string;
+}
+/**
+ * Create the stats command for Commander.js.
+ */
+export declare function createStatsCommand(): Command;
+/**
+ * Execute the stats command programmatically by wrapping executeStatusCommand.
+ */
+export declare function executeStatsCommand(options: StatsCommandOptions, deps?: StatsCommandDeps): Promise<CommandResult>;

package/dist/presentation/cli/commands/status.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Status Command Handler
+ *
+ * CLI command for displaying hook installation status, configuration, health diagnostics,
+ * and database statistics. Unifies status, doctor, and stats commands per Phase 32.5.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+import { type HookStatus, type MemoryConfig } from "../../../infrastructure/hooks/index.js";
+import { type HealthCheckResult } from "../../../infrastructure/database/index.js";
+import { type MigrationStatusResult } from "../../../infrastructure/migration.js";
+import type { QmdHealthInfo } from "../../../domain/ports/index.js";
+import { type ExtendedStatsResult } from "../formatters/stats-formatter.js";
+/**
+ * Options for the status command.
+ */
+export interface StatusOptions {
+    /** Output as JSON */
+    json?: boolean | undefined;
+    /** Output Database Health Section */
+    db?: boolean | undefined;
+    /** Output Hooks Section */
+    hooks?: boolean | undefined;
+    /** Output Embedding Section */
+    embedding?: boolean | undefined;
+    /** Output Configuration Section */
+    config?: boolean | undefined;
+    /** Output Statistics Section */
+    stats?: boolean | undefined;
+    /** Output all sections */
+    all?: boolean | undefined;
+    /** Attempt to fix common issues automatically */
+    fix?: boolean | undefined;
+    /** Number of projects to show in breakdown */
+    projects?: string | undefined;
+    /** Output format for stats */
+    format?: "brief" | "ai" | "default" | undefined;
+    /** Verbose option for stats */
+    verbose?: boolean | undefined;
+    /** Quiet option for stats */
+    quiet?: boolean | undefined;
+}
+/**
+ * Runtime dependencies for executeStatusCommand.
+ */
+export interface StatusCommandDeps {
+    /** Database path. Defaults to getDefaultDbPath(). */
+    dbPath?: string | undefined;
+    /** Sync log file path. Defaults to XDG-resolved sync.log. */
+    logPath?: string | undefined;
+    /** Config file path. Defaults to XDG-resolved config.json. */
+    configPath?: string | undefined;
+    /** Hook-related path overrides */
+    hookOverrides?: import("../../../infrastructure/hooks/settings-manager.js").PathOverrides | undefined;
+    /** Status gatherer seam for tests and alternate hosts. Defaults to gatherStatus(). */
+    gatherStatus?: ((options: GatherStatusOptions) => Promise<StatusInfo>) | undefined;
+}
+/**
+ * Embedding background process status.
+ */
+export interface EmbeddingStatus {
+    /** Whether a background embedding process is currently running */
+    active: boolean;
+    /** PID of the background embedding process */
+    pid?: number;
+    /** ISO timestamp when the background process started */
+    startedAt?: string;
+    /** Number of messages that have been embedded so far */
+    embeddedCount?: number;
+    /** Total number of messages in the database */
+    totalMessages?: number;
+}
+/**
+ * Aggregated status information.
+ */
+export interface StatusInfo {
+    /** Hook installation status */
+    hooks: HookStatus;
+    /** Current configuration */
+    config: MemoryConfig;
+    /** ISO timestamp of the last sync, or null if never synced */
+    lastSync: string | null;
+    /** Number of sessions pending sync */
+    pendingSessions: number;
+    /** Number of recent log entries */
+    recentLogs: number;
+    /** Background embedding process status */
+    embedding: EmbeddingStatus;
+    /** Comprehensive health check results */
+    health: HealthCheckResult;
+    /** Database statistics (if DB exists) */
+    stats?: ExtendedStatsResult | undefined;
+    /** Legacy migration status */
+    migration: MigrationStatusResult;
+    /** External qmd tool availability status */
+    qmd: QmdHealthInfo;
+    /** List of automatic fixes applied */
+    fixes: string[];
+}
+/**
+ * Options for gathering status.
+ */
+export interface GatherStatusOptions {
+    /** Override database path for testing */
+    dbPath?: string | undefined;
+    /** Override log file path for testing */
+    logPath?: string | undefined;
+    /** Override config file path for testing */
+    configPath?: string | undefined;
+    /** Hook-related path overrides */
+    hookOverrides?: import("../../../infrastructure/hooks/settings-manager.js").PathOverrides | undefined;
+    /** Attempt to fix common issues automatically */
+    fix?: boolean | undefined;
+    /** Number of projects in breakdown */
+    projects?: number | undefined;
+    /** Whether stats are requested */
+    stats?: boolean | undefined;
+}
+/**
+ * Create the status command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createStatusCommand(): Command;
+/**
+ * Gather all status information exactly once.
+ *
+ * @param options Optional configuration including database and log paths
+ * @returns Aggregated status information
+ */
+export declare function gatherStatus(options?: GatherStatusOptions): Promise<StatusInfo>;
+/**
+ * Execute the status command programmatically.
+ */
+export declare function executeStatusCommand(options: StatusOptions, deps?: StatusCommandDeps): Promise<CommandResult>;
+/**
+ * Attempt automatic fixes for common issues.
+ */
+export declare function attemptFixes(result: HealthCheckResult, useColor: boolean): string[];
+/**
+ * Format and display status output to console.
+ *
+ * @param status Status information to display
+ */
+export declare function formatStatusOutput(status: StatusInfo): void;
+/**
+ * Format an ISO timestamp as a human-readable relative time.
+ *
+ * @param isoTimestamp ISO 8601 timestamp string
+ * @returns Relative time string (e.g., "5 min ago", "2h ago")
+ */
+export declare function formatTimeAgo(isoTimestamp: string): string;

package/dist/presentation/cli/commands/sync/ambient.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sync Ambient Context
+ *
+ * Generates ambient context files for the current project after
+ * memory file sync. Writes context.md and updates MEMORY.md in the
+ * current project's Claude Code auto memory directory.
+ */
+import type { initializeDatabase } from "../../../../infrastructure/database/index.js";
+import type { SyncCommandOptions, AmbientContextDeps } from "./types.js";
+/**
+ * Generate ambient context files for the current project.
+ *
+ * Runs after memory file sync. Writes context.md and updates MEMORY.md
+ * in the current project's Claude Code auto memory directory.
+ *
+ * Failure is non-fatal: logs error and continues sync.
+ *
+ * @param db Database connection
+ * @param options Sync command options
+ * @param deps Optional dependency overrides for testing
+ */
+export declare function runAmbientContextGeneration(db: ReturnType<typeof initializeDatabase>["db"], options: SyncCommandOptions, deps?: AmbientContextDeps): Promise<void>;

package/dist/presentation/cli/commands/sync/background.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Sync Background Mode
+ *
+ * Handles --background flag for embedding generation.
+ * Spawns a detached background process to run embedding asynchronously.
+ */
+import type { CommandResult } from "../../command-result.js";
+import type { SyncCommandOptions, BackgroundModeDeps } from "./types.js";
+/**
+ * Handle --background mode for embedding.
+ *
+ * Checks that --embed is also set, then spawns a detached background
+ * process to run embedding asynchronously. Returns immediately with
+ * a status message including the PID.
+ *
+ * Accepts optional dependency overrides for testing (avoid spawning
+ * real child processes in tests).
+ *
+ * @param options Sync command options
+ * @param deps Optional dependency overrides (testing support)
+ * @returns Command result with exit code
+ */
+export declare function handleBackgroundMode(options: SyncCommandOptions, deps?: BackgroundModeDeps): Promise<CommandResult>;

package/dist/presentation/cli/commands/sync/embedding-pass.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Sync Embedding Pass
+ *
+ * Handles embedding generation after sync completes.
+ * Lazy-loads embedding infrastructure to avoid ONNX runtime overhead
+ * when --embed is not used.
+ */
+import type { initializeDatabase } from "../../../../infrastructure/database/index.js";
+import type { ModelState } from "../../../../application/services/index.js";
+import type { SyncCommandOptions, EmbeddingPassDeps } from "./types.js";
+/**
+ * Run the embedding pass after sync completes.
+ *
+ * Lazy-loads embedding infrastructure to avoid ONNX runtime overhead
+ * when --embed is not used. All embedding modules are dynamically imported.
+ *
+ * @param db Database connection
+ * @param options Sync command options
+ * @param deps Optional dependency overrides for testing
+ */
+export declare function runEmbeddingPass(db: ReturnType<typeof initializeDatabase>["db"], options: SyncCommandOptions, deps?: EmbeddingPassDeps): Promise<void>;
+/**
+ * Handle model change detection with user confirmation.
+ *
+ * Uses human-readable model names from ModelState for prompts.
+ * Auto-confirms with --force, skips in non-interactive mode.
+ *
+ * @param modelState Model state comparison result
+ * @param options Sync command options
+ * @returns true if embedding should proceed, false to skip
+ */
+export declare function handleModelChange(modelState: ModelState, options: SyncCommandOptions): Promise<boolean>;

package/dist/presentation/cli/commands/sync/helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Sync Command Helpers
+ *
+ * Shared utility functions for dry-run, error handling, result reporting,
+ * and lazy-loading infrastructure dependencies.
+ */
+import type { SyncCommandOptions } from "./types.js";
+import type { CommandResult } from "../../command-result.js";
+import type { SyncResult } from "../../../../application/services/index.js";
+import { initializeDatabase } from "../../../../infrastructure/database/index.js";
+import { ProjectNameResolver } from "../../../../infrastructure/sources/index.js";
+/** Load embedding provider factory via dynamic import. */
+export declare function loadFactory(): Promise<import("../../../../infrastructure/embedding/embedding-provider-factory.js").EmbeddingProviderFactory>;
+/** Load memory config via dynamic import. */
+export declare function loadConfig(): Promise<import("../../../../infrastructure/index.js").MemoryConfig>;
+/** Load embedding repository via dynamic import. */
+export declare function loadRepository(db: ReturnType<typeof initializeDatabase>["db"]): Promise<import("../../../../infrastructure/index.js").EmbeddingRepository>;
+/** Execute dry-run mode: show what would be synced without syncing. */
+export declare function executeDryRun(options: SyncCommandOptions): Promise<CommandResult>;
+/** Handle error with appropriate formatting. */
+export declare function handleError(error: unknown, options: SyncCommandOptions): void;
+/** Report sync results to console. */
+export declare function reportResults(result: SyncResult, startTime: number, options: SyncCommandOptions): void;
+/** Create a ProjectNameResolver rooted at the system drive. */
+export declare function createDriveResolver(): ProjectNameResolver;

package/dist/presentation/cli/commands/sync/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sync Command
+ *
+ * Orchestrates session extraction, memory file sync, ambient context,
+ * and optional embedding generation.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../../command-result.js";
+import type { SyncCommandDeps, SyncCommandOptions } from "./types.js";
+/** Create the sync command for Commander.js. */
+export declare function createSyncCommand(): Command;
+/** Execute the sync command programmatically. */
+export declare function executeSyncCommand(options: SyncCommandOptions, deps?: SyncCommandDeps): Promise<CommandResult>;
+export type { SyncCommandOptions, EmbeddingPassDeps, BackgroundModeDeps, AmbientContextDeps } from "./types.js";
+export { runEmbeddingPass, handleModelChange } from "./embedding-pass.js";
+export { handleBackgroundMode } from "./background.js";
+export { runAmbientContextGeneration } from "./ambient.js";

package/dist/presentation/cli/commands/sync/memory-files.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Sync Memory Files
+ *
+ * Discovers and indexes legacy markdown memory files after session extraction.
+ */
+import type { initializeDatabase } from "../../../../infrastructure/database/index.js";
+import type { MemoryFileSyncResult } from "../../../../application/services/index.js";
+import type { SyncCommandOptions } from "./types.js";
+/**
+ * Run memory file sync: discover and index legacy markdown memory files.
+ *
+ * Runs after session extraction. Returns null if no memory files
+ * were processed (for example, the legacy memory-file root does not exist).
+ *
+ * @param db Database connection
+ * @param options Sync command options
+ * @returns Sync result, or null if nothing to report
+ */
+export declare function runMemoryFileSync(db: ReturnType<typeof initializeDatabase>["db"], options: SyncCommandOptions): Promise<MemoryFileSyncResult | null>;
+/**
+ * Report memory file sync results to console.
+ *
+ * @param result Memory file sync result
+ * @param options Command options
+ */
+export declare function reportMemoryFileResults(result: MemoryFileSyncResult, options: SyncCommandOptions): void;

package/dist/presentation/cli/commands/sync/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Sync Command Types
+ *
+ * Shared interfaces for the sync command modules.
+ */
+/**
+ * Options for the sync command.
+ */
+export interface SyncCommandOptions {
+    /** Force re-sync of all sessions, ignoring extraction state */
+    force?: boolean;
+    /** Filter to sessions from a specific project */
+    project?: string;
+    /** Filter to a specific session by ID */
+    session?: string;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Show detailed output with timing information */
+    verbose?: boolean;
+    /** Output results as JSON */
+    json?: boolean;
+    /** Preview sync without modifying the database */
+    dryRun?: boolean;
+    /** Fix project names using the resolver */
+    fixNames?: boolean;
+    /** Generate embeddings for synced messages */
+    embed?: boolean;
+    /** Run embedding generation in a background process */
+    background?: boolean;
+    /** Explicitly index legacy ~/.memory / MEMORY_HOME markdown files */
+    includeMemoryFiles?: boolean;
+}
+export interface RemoteSyncer {
+    sync(machineId: string, remoteUrl: string, autoPull?: boolean, autoPush?: boolean): Promise<{
+        success: boolean;
+        rebuildNeeded: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * Dependency overrides for executeSyncCommand.
+ *
+ * Keep user options separate from operational dependencies. This is the
+ * canonical test-isolation seam for command orchestration.
+ */
+export interface SyncCommandDeps {
+    /** Override background-mode handling */
+    handleBackgroundMode?: (options: SyncCommandOptions) => Promise<import("../../command-result.js").CommandResult>;
+    /** Override process signal setup */
+    setupSignalHandlers?: () => void;
+    /** Override checkpoint presence check */
+    hasCheckpoint?: () => boolean;
+    /** Override checkpoint loading */
+    loadCheckpoint?: () => {
+        completedSessions: number;
+        totalSessions: number;
+    } | null;
+    /** Override progress reporter construction */
+    createProgressReporter?: (options: SyncCommandOptions) => {
+        log(message: string): void;
+        start(total: number): void;
+        update(current: number, sessionId?: string): void;
+        stop(): void;
+    };
+    /** Override database path resolution */
+    getDefaultDbPath?: () => string;
+    /** Override dry-run execution */
+    executeDryRun?: typeof import("./helpers.js").executeDryRun;
+    /** Override error handling */
+    handleError?: typeof import("./helpers.js").handleError;
+    /** Override text/JSON result reporting */
+    reportResults?: typeof import("./helpers.js").reportResults;
+    /** Override drive resolver creation */
+    createDriveResolver?: typeof import("./helpers.js").createDriveResolver;
+    /** Override database initialization */
+    initializeDatabase?: typeof import("../../../../infrastructure/database/index.js").initializeDatabase;
+    /** Override database close */
+    closeDatabase?: typeof import("../../../../infrastructure/database/index.js").closeDatabase;
+    /** Override bulk checkpoint flush */
+    bulkOperationCheckpoint?: typeof import("../../../../infrastructure/database/index.js").bulkOperationCheckpoint;
+    /** Override cleanup registration */
+    registerCleanup?: typeof import("../../../../infrastructure/signals/index.js").registerCleanup;
+    /** Override cleanup unregistration */
+    unregisterCleanup?: typeof import("../../../../infrastructure/signals/index.js").unregisterCleanup;
+    /** Override sync service construction */
+    createSyncService?: (deps: {
+        db: import("bun:sqlite").Database;
+        resolver: unknown;
+    }) => {
+        fixProjectNames: (resolver: unknown) => Promise<number>;
+        sync: (options: import("../../../../application/services/index.js").SyncOptions) => Promise<import("../../../../application/services/index.js").SyncResult>;
+    };
+    /** Override config loading */
+    loadConfig?: () => import("../../../../infrastructure/hooks/config-manager.js").MemoryConfig;
+    /** Override remote syncer construction */
+    createGitSyncer?: () => RemoteSyncer | Promise<RemoteSyncer>;
+    /** Override projection rebuild after remote pulls */
+    rebuildProjections?: (db: import("bun:sqlite").Database) => Promise<void>;
+    /** Explicitly enable the unfinished Phase 38 remote-sync prototype */
+    experimentalRemoteSync?: boolean;
+    /** Override memory file sync */
+    runMemoryFileSync?: typeof import("./memory-files.js").runMemoryFileSync;
+    /** Override memory file sync reporting */
+    reportMemoryFileResults?: typeof import("./memory-files.js").reportMemoryFileResults;
+    /** Override ambient context generation */
+    runAmbientContextGeneration?: typeof import("./ambient.js").runAmbientContextGeneration;
+    /** Override embedding pass */
+    runEmbeddingPass?: typeof import("./embedding-pass.js").runEmbeddingPass;
+    /** Override background embedding lock removal */
+    removeBackgroundLock?: () => void;
+}
+/**
+ * Dependency overrides for runEmbeddingPass (testing support).
+ *
+ * When not provided, real dependencies are loaded via dynamic import.
+ */
+export interface EmbeddingPassDeps {
+    /** Override embedding provider factory (avoids loading real ONNX runtime) */
+    factory?: import("../../../../infrastructure/embedding/embedding-provider-factory.js").EmbeddingProviderFactory;
+    /** Override configuration (avoids reading config file) */
+    config?: import("../../../../infrastructure/hooks/config-manager.js").MemoryConfig;
+    /** Override embedding repository (avoids real database operations) */
+    repositoryOverride?: import("../../../../infrastructure/database/repositories/embedding-repository.js").EmbeddingRepository;
+}
+/**
+ * Dependency overrides for handleBackgroundMode (testing support).
+ *
+ * Allows injection of background-embedder functions for unit testing
+ * without spawning real child processes.
+ */
+export interface BackgroundModeDeps {
+    /** Override background process spawning */
+    spawnBackgroundEmbedding: (options?: any) => import("../../../../infrastructure/embedding/background-embedder.js").SpawnResult;
+    /** Override lock file reading */
+    readLock: (dataDir?: string) => import("../../../../infrastructure/embedding/background-embedder.js").LockData | null;
+    /** Override process liveness check */
+    isProcessAlive: (pid: number) => boolean;
+}
+/**
+ * Dependency overrides for runAmbientContextGeneration (testing support).
+ *
+ * When not provided, real dependencies are loaded via dynamic import.
+ */
+export interface AmbientContextDeps {
+    /** Override config loading */
+    loadConfig: () => {
+        ambientContext: {
+            enabled: boolean;
+            budget: number;
+        };
+    };
+    /** Override auto memory directory resolution */
+    resolveAutoMemoryDir: () => string;
+    /** Override project name resolution */
+    resolveProjectName: () => string;
+    /** Override ambient service creation */
+    createAmbientService: () => {
+        generateAmbientContext: (opts: any) => Promise<{
+            success: boolean;
+            contextTokens?: number;
+        }>;
+    };
+}