@chude/memory 4.0.0

package/dist/presentation/cli/commands/friction/list.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Friction List Handler
+ *
+ * Handles the friction list subcommand.
+ */
+import type { CommandResult } from "../../command-result.js";
+import type { FrictionExecuteOptions } from "./types.js";
+import type { FrictionService } from "../../../../application/services/friction-service.js";
+/**
+ * Handle the list action.
+ */
+export declare function handleList(service: FrictionService, options: FrictionExecuteOptions): Promise<CommandResult>;

package/dist/presentation/cli/commands/friction/log.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Friction Log Handler
+ *
+ * Handles the friction log subcommand.
+ */
+import type { CommandResult } from "../../command-result.js";
+import type { FrictionExecuteOptions } from "./types.js";
+import type { FrictionService } from "../../../../application/services/friction-service.js";
+/**
+ * Handle the log action.
+ */
+export declare function handleLog(service: FrictionService, options: FrictionExecuteOptions): Promise<CommandResult>;

package/dist/presentation/cli/commands/friction/purge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Friction Purge Handler
+ *
+ * Handles the friction purge subcommand.
+ */
+import type { CommandResult } from "../../command-result.js";
+import type { FrictionExecuteOptions } from "./types.js";
+import type { FrictionService } from "../../../../application/services/friction-service.js";
+/**
+ * Handle the purge action.
+ */
+export declare function handlePurge(service: FrictionService, options: FrictionExecuteOptions): Promise<CommandResult>;

package/dist/presentation/cli/commands/friction/resolve.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Friction Resolve Handler
+ *
+ * Handles the friction resolve subcommand.
+ */
+import type { CommandResult } from "../../command-result.js";
+import type { FrictionExecuteOptions } from "./types.js";
+import type { FrictionService } from "../../../../application/services/friction-service.js";
+/**
+ * Handle the resolve action.
+ */
+export declare function handleResolve(service: FrictionService, options: FrictionExecuteOptions): Promise<CommandResult>;

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

@@ -0,0 +1,86 @@
+/**
+ * Friction Command Types
+ *
+ * Type definitions and interfaces for friction command handlers.
+ */
+/**
+ * Function type for opening a file in the system browser.
+ */
+export type BrowserOpener = (filePath: string) => void;
+/**
+ * Runtime dependencies for executeFrictionCommand.
+ *
+ * Operational dependencies that tests substitute for isolation.
+ * Defaults to production resolution when omitted.
+ */
+export interface FrictionCommandDeps {
+    /** Database path. Defaults to getDefaultDbPath(). */
+    dbPath?: string;
+    /** Browser opener for --html mode. Defaults to system default. */
+    openInBrowser?: BrowserOpener;
+}
+/**
+ * Base options shared by all friction subcommands.
+ */
+export interface FrictionCommandOptions {
+    json?: boolean;
+    /** Output format: default or ai */
+    format?: "default" | "ai";
+}
+/**
+ * Options for the friction log subcommand.
+ */
+export interface FrictionLogOptions extends FrictionCommandOptions {
+    severity?: string;
+    category?: string;
+    source?: string;
+    context?: string;
+    tool?: string;
+}
+/**
+ * Options for the friction list subcommand.
+ */
+export interface FrictionListOptions extends FrictionCommandOptions {
+    all?: boolean;
+    status?: string;
+    category?: string;
+    tool?: string;
+    limit?: string;
+}
+/**
+ * Options for the friction resolve/wont-fix subcommands.
+ */
+export interface FrictionResolveOptions extends FrictionCommandOptions {
+    resolution: string;
+}
+/**
+ * Options for the friction purge subcommand.
+ */
+export interface FrictionPurgeOptions extends FrictionCommandOptions {
+    dryRun?: boolean;
+    force?: boolean;
+}
+/**
+ * Options passed to executeFrictionCommand.
+ */
+export interface FrictionExecuteOptions {
+    action: "log" | "list" | "resolve" | "wont-fix" | "dashboard" | "purge";
+    description?: string;
+    pattern?: string;
+    id?: string;
+    json?: boolean;
+    /** Output format: default or ai */
+    format?: "default" | "ai";
+    severity?: string;
+    category?: string;
+    source?: string;
+    context?: string;
+    all?: boolean;
+    status?: string;
+    limit?: string;
+    resolution?: string;
+    tool?: string;
+    html?: boolean;
+    dryRun?: boolean;
+    force?: boolean;
+}

package/dist/presentation/cli/commands/friction/wontfix.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Friction Won't-Fix Handler
+ *
+ * Handles the friction wont-fix subcommand.
+ */
+import type { CommandResult } from "../../command-result.js";
+import type { FrictionExecuteOptions } from "./types.js";
+import type { FrictionService } from "../../../../application/services/friction-service.js";
+/**
+ * Handle the wont-fix action.
+ */
+export declare function handleWontFix(service: FrictionService, options: FrictionExecuteOptions): Promise<CommandResult>;

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

@@ -0,0 +1,38 @@
+/**
+ * Import Command Handler
+ *
+ * CLI command for importing database from a JSON backup file.
+ * Supports clear option, quiet mode, and JSON output for scripting.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the import command.
+ */
+export interface ImportOptions {
+    /** Clear existing data before import */
+    clear?: boolean;
+    /** Suppress output except errors */
+    quiet?: boolean;
+    /** Output stats as JSON */
+    json?: boolean;
+    /** Skip confirmation when merging with existing data */
+    force?: boolean;
+}
+/**
+ * Create the import command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createImportCommand(): Command;
+/**
+ * Execute the import command programmatically.
+ *
+ * Imports a previously exported JSON database file. Handles its own
+ * database initialization and teardown.
+ *
+ * @param inputFile - Source file path for the JSON backup
+ * @param options - Import command options
+ * @returns CommandResult with exitCode 0 (success) or 1 (file not found/error)
+ */
+export declare function executeImportCommand(inputFile: string, options?: ImportOptions): Promise<CommandResult>;

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

@@ -0,0 +1,51 @@
+/**
+ * CLI Commands
+ *
+ * Command handlers for the memory CLI.
+ */
+export type { CommandResult } from "../command-result.js";
+export { createSyncCommand, executeSyncCommand } from "./sync/index.js";
+export { createSearchCommand, executeSearchCommand } from "./search.js";
+export { createListCommand, executeListCommand } from "./list.js";
+export { createStatsCommand, executeStatsCommand } from "./stats.js";
+export { createContextCommand, executeContextCommand } from "./context.js";
+export { createRelatedCommand, executeRelatedCommand } from "./related.js";
+export { createShowCommand, executeShowCommand } from "./show.js";
+export { createBrowseCommand, executeBrowseCommand } from "./browse.js";
+export { createQueryCommand, executeQueryCommand } from "./query.js";
+export { createRemoteCommand, executeRemoteSetCommand, executeRemoteRemoveCommand, executeRemoteStatusCommand } from "./remote.js";
+export { createInstallCommand, executeInstallCommand } from "./install.js";
+export { createUninstallCommand, executeUninstallCommand } from "./uninstall.js";
+export { createStatusCommand, executeStatusCommand } from "./status.js";
+export { createDoctorCommand, executeDoctorCommand } from "./doctor.js";
+export { createPurgeCommand, executePurgeCommand } from "./purge.js";
+export { createMigrateCommand, executeMigrateCommand } from "./migrate.js";
+export { createExportCommand, executeExportCommand } from "./export.js";
+export { createImportCommand, executeImportCommand } from "./import.js";
+export { createCompletionCommand, executeCompletionCommand } from "./completion.js";
+export { createFrictionCommand, executeFrictionCommand } from "./friction/index.js";
+export { createBackfillCommand, executeBackfillCommand } from "./backfill.js";
+export { createExtractCommand, executeExtractCommand } from "./extract.js";
+export { createFactsCommand, executeFactsCommand } from "./facts.js";
+export type { SyncCommandOptions } from "./sync/index.js";
+export type { EmbeddingPassDeps, BackgroundModeDeps } from "./sync/index.js";
+export type { SearchCommandOptions } from "./search.js";
+export type { ListCommandOptions } from "./list.js";
+export type { StatsCommandOptions } from "./stats.js";
+export type { ContextCommandOptions } from "./context.js";
+export type { RelatedCommandOptions } from "./related.js";
+export type { ShowCommandOptions } from "./show.js";
+export type { QueryCommandOptions } from "./query.js";
+export type { RemoteCommandOptions } from "./remote.js";
+export type { BrowseCommandOptions } from "./browse.js";
+export type { InstallOptions } from "./install.js";
+export type { UninstallOptions } from "./uninstall.js";
+export type { DoctorOptions } from "./doctor.js";
+export type { PurgeCommandOptions, PurgeResult } from "./purge.js";
+export type { ExportOptions } from "./export.js";
+export type { ImportOptions } from "./import.js";
+export type { ShellType } from "./completion.js";
+export type { StatusOptions, StatusInfo, EmbeddingStatus, GatherStatusOptions } from "./status.js";
+export type { FrictionCommandOptions, FrictionLogOptions, FrictionListOptions, FrictionResolveOptions, FrictionExecuteOptions, } from "./friction/index.js";
+export type { BackfillCommandOptions, BackfillServiceDeps, } from "./backfill.js";
+export type { MigrateCommandOptions } from "./migrate.js";

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

@@ -0,0 +1,67 @@
+/**
+ * Install Command Handler
+ *
+ * CLI command for installing Claude Code hooks.
+ * Copies hook script and modifies settings.json.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the install command.
+ */
+export interface InstallOptions {
+    /** Reinstall even if hooks are already installed */
+    force?: boolean;
+}
+/**
+ * Runtime dependencies for executeInstallCommand.
+ *
+ * Operational dependencies that tests substitute for isolation.
+ * Defaults to production resolution (multi-path candidate search) when omitted.
+ */
+export interface InstallCommandDeps {
+    /**
+     * Override the hook script source path. When set, findHookScriptSource
+     * checks only this path. Used by tests to point at a fixture file.
+     */
+    hookScriptSourceOverride?: string;
+    /**
+     * Override settings/backup/hook-script paths used by settings-manager.
+     * When set, all settings-manager calls use these paths.
+     */
+    hookOverrides?: import("../../../infrastructure/hooks/settings-manager.js").PathOverrides;
+}
+/**
+ * Create the install command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createInstallCommand(): Command;
+/**
+ * Execute the install command programmatically.
+ *
+ * Installs Claude Code hooks for automatic session sync on session end.
+ * Copies the hook script and modifies settings.json. Idempotent: returns
+ * exitCode 0 if hooks are already installed. Handles its own setup.
+ *
+ * @param options - Install command options
+ * @returns CommandResult with exitCode 0 (success/already installed) or 1 (error)
+ */
+export declare function executeInstallCommand(options: InstallOptions, deps?: InstallCommandDeps): Promise<CommandResult>;
+/**
+ * Scan settings.json for stale memory-nexus hook references.
+ *
+ * After hook installation, checks if any hook commands still reference
+ * the old "memory-nexus" binary name. Prints a warning to stderr if found.
+ */
+export declare function warnStaleHookReferences(overrides?: import("../../../infrastructure/hooks/settings-manager.js").PathOverrides): void;
+/**
+ * Find the hook script source file.
+ *
+ * Checks common locations for the built hook script. When `override` is
+ * provided, checks only that path (used by tests to point at a fixture).
+ *
+ * @param override Optional explicit path to use instead of candidate search
+ * @returns Path to hook script or null if not found
+ */
+export declare function findHookScriptSource(override?: string): string | null;

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

@@ -0,0 +1,61 @@
+/**
+ * List Command Handler
+ *
+ * CLI command for listing sessions with filtering.
+ * Supports project name filter and date range filters.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the list command.
+ */
+export interface ListCommandOptions {
+    /** Maximum sessions to return (as string, parsed to integer) */
+    limit?: string;
+    /** Filter by project name */
+    project?: string;
+    /** Sessions after date (e.g., 'yesterday', '2 weeks ago') */
+    since?: string;
+    /** Sessions before date */
+    before?: string;
+    /** Sessions from last N days (includes today) */
+    days?: number;
+    /** Output as JSON */
+    json?: boolean;
+    /** Show detailed output */
+    verbose?: boolean;
+    /** Minimal output (session IDs only) */
+    quiet?: 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 executeListCommand.
+ *
+ * Separated from ListCommandOptions 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.
+ *
+ * Parity with executeShowCommand (added Plan 32-02 per Codex HIGH-3).
+ */
+export interface ListCommandDeps {
+    /** Database path. Defaults to getDefaultDbPath(). */
+    dbPath?: string;
+}
+/**
+ * Create the list command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createListCommand(): Command;
+export declare function executeListCommand(options: ListCommandOptions, deps?: ListCommandDeps): Promise<CommandResult>;
+/**
+ * Internal implementation of the list query execution.
+ */
+export declare function runListInternal(options: ListCommandOptions, deps?: ListCommandDeps): Promise<CommandResult>;

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

@@ -0,0 +1,36 @@
+/**
+ * Database Migration Command
+ *
+ * Handles cross-environment migrations, checking structural integrity,
+ * checkpointing WAL logs, purging stale sync locks, and natively re-installing hooks.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the migrate command.
+ */
+export interface MigrateCommandOptions {
+    /** Migrate database from Windows host env */
+    fromWindows?: boolean;
+}
+/**
+ * Test overrides and programmatic dependencies.
+ */
+export interface MigrateCommandDeps {
+    /** Database path. Defaults to getDefaultDbPath(). */
+    dbPath?: string;
+    /** Data directory. Defaults to getDataDir(). */
+    dataDir?: string;
+    /** Custom uninstall hooks handler. */
+    uninstallHooks?: () => any;
+    /** Custom install hooks handler. */
+    installHooks?: () => any;
+}
+/**
+ * Create the migrate command for Commander.js.
+ */
+export declare function createMigrateCommand(): Command;
+/**
+ * Execute the migrate command programmatically.
+ */
+export declare function executeMigrateCommand(_options: MigrateCommandOptions, deps?: MigrateCommandDeps): Promise<CommandResult>;

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

@@ -0,0 +1,100 @@
+/**
+ * Purge Command Handler
+ *
+ * CLI command for removing old sessions from the database.
+ * Supports age filtering, dry-run mode, and force (skip confirmation).
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the purge command.
+ */
+export interface PurgeCommandOptions {
+    /** Duration threshold (e.g., "30d", "6m", "1y") -- sessions older than this are purged */
+    olderThan?: string;
+    /** Purge orphaned sessions whose project workspaces no longer exist */
+    orphans?: boolean;
+    /** Skip confirmation prompt */
+    force?: boolean;
+    /** Preview purge without modifying the database */
+    dryRun?: boolean;
+    /** Output results as JSON */
+    json?: boolean;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+}
+/**
+ * Result of a purge operation.
+ */
+export interface PurgeResult {
+    /** Number of sessions deleted (0 if dryRun) */
+    sessionsDeleted: number;
+    /** ISO date string of the cutoff threshold */
+    cutoffDate?: string;
+    /** Whether this was a dry-run (preview only) */
+    dryRun: boolean;
+}
+/**
+ * Parse duration string into a cutoff Date.
+ *
+ * Supported formats:
+ * - "30d" - 30 days
+ * - "6m" - 6 months
+ * - "1y" - 1 year
+ *
+ * @param duration - Duration string (e.g., "90d", "6m", "1y")
+ * @returns Date representing the cutoff time
+ * @throws Error if duration format is invalid
+ */
+export declare function parseDuration(duration: string): Date;
+/**
+ * Runtime dependencies for executePurgeCommand.
+ *
+ * Operational dependencies that tests substitute for isolation.
+ * Defaults to production resolution when omitted.
+ */
+export interface PurgeCommandDeps {
+    /** Database path. Defaults to getDefaultDbPath(). */
+    dbPath?: string;
+    /** Default database path resolver. Defaults to getDefaultDbPath(). */
+    getDefaultDbPath?: () => string;
+    /** Database initializer. Defaults to initializeDatabase(). */
+    initializeDatabase?: (config: {
+        path: string;
+    }) => {
+        db: any;
+    };
+    /** Database closer. Defaults to closeDatabase(). */
+    closeDatabase?: (db: any) => void;
+    /** Session repository factory. Defaults to SqliteSessionRepository. */
+    createSessionRepository?: (db: any) => {
+        findOlderThan(cutoffDate: Date): Promise<any[]>;
+        findFiltered(options: {
+            limit: number;
+        }): Promise<any[]>;
+        delete(id: string): void;
+    };
+    /** Confirmation prompt. Defaults to readline-based askConfirmation. */
+    askConfirmation?: (message: string) => Promise<boolean>;
+    /** File existence checker function. Defaults to existsSync from fs. */
+    existsSync?: (path: string) => boolean;
+}
+/**
+ * Create the purge command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createPurgeCommand(): Command;
+/**
+ * Execute the purge command programmatically.
+ *
+ * Purges sessions from the database older than the specified duration,
+ * or orphaned sessions whose workspaces no longer exist.
+ * Use dryRun to preview without deleting. Handles its own database
+ * initialization and teardown.
+ *
+ * @param options - Purge command options
+ * @param deps - Runtime dependencies
+ * @returns CommandResult with exitCode 0 (success) or 1/2 (error)
+ */
+export declare function executePurgeCommand(options: PurgeCommandOptions, deps?: PurgeCommandDeps): Promise<CommandResult>;

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

@@ -0,0 +1,51 @@
+/**
+ * Unified Query Command Handler (Phase 32.5 Surface Consolidation)
+ *
+ * Single command interface for all read-oriented query commands.
+ * Unifies search, context, related, list, and show under a single primitive
+ * while preserving full backward compatibility.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the query command.
+ */
+export interface QueryCommandOptions {
+    /** Discriminator envelope scope: global or project */
+    scope?: "global" | "project" | undefined;
+    /** Filter by project name */
+    project?: string | undefined;
+    /** Resource kind: message, session, file, stats, context, related */
+    kind?: "message" | "session" | "file" | "stats" | "context" | "related" | undefined;
+    /** Search mode: fts, vector, hybrid, auto */
+    mode?: "fts" | "vector" | "hybrid" | "auto" | undefined;
+    /** Maximum results to return */
+    limit?: string | undefined;
+    /** Output format */
+    format?: "brief" | "ai" | "default" | "detailed" | undefined;
+    /** Output as JSON envelope */
+    json?: boolean | undefined;
+    /** Age filter in days */
+    days?: number | undefined;
+    /** Projects limit count in stats */
+    projects?: string | undefined;
+    /** Show verbose execution logs */
+    verbose?: boolean | undefined;
+    /** Suppress headers and decorations */
+    quiet?: boolean | undefined;
+    /** Database path override (for tests) */
+    dbPath?: string | undefined;
+}
+/**
+ * Create the query command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createQueryCommand(): Command;
+/**
+ * Execute the query command programmatically.
+ *
+ * Routes query to respective underlying commands dynamically to avoid top-level
+ * circular imports, setting the JSON envelope command name override as needed.
+ */
+export declare function executeQueryCommand(argument: string | undefined, options: QueryCommandOptions): Promise<CommandResult>;

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

@@ -0,0 +1,47 @@
+/**
+ * Related Command Handler
+ *
+ * CLI command for finding sessions related through shared topics/entities.
+ * Uses SqliteLinkRepository's findRelatedWithHops() for graph traversal.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+/**
+ * Options for the related command.
+ */
+export interface RelatedCommandOptions {
+    /** Maximum results to return */
+    limit?: number;
+    /** Traversal depth (1-3) */
+    hops?: number;
+    /** Entity type of the ID: session, message, or topic */
+    type?: "session" | "message" | "topic";
+    /**
+     * Output format. Phase 32 (CLI-03) normalized choices: `brief`,
+     * `ai`. `detailed` retained as deprecated alias (one-minor cadence;
+     * CHANGELOG documents removal). Undefined = no-flag default
+     * (existing brief behavior preserved for backward compatibility).
+     */
+    format?: "brief" | "ai" | "detailed";
+    /** Output as JSON */
+    json?: boolean;
+    /** Show detailed output with timing */
+    verbose?: boolean;
+    /** Minimal output (session IDs only) */
+    quiet?: boolean;
+    /** Override database path (for testing) */
+    dbPath?: string;
+}
+/**
+ * Create the related command for Commander.js.
+ *
+ * @returns Configured Command instance
+ */
+export declare function createRelatedCommand(): Command;
+export declare function executeRelatedCommand(id: string, options: RelatedCommandOptions): Promise<CommandResult>;
+/**
+ * Internal implementation of the related query execution.
+ */
+export declare function runRelatedInternal(id: string, options: RelatedCommandOptions, deps?: {
+    dbPath?: string;
+}): Promise<CommandResult>;

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

@@ -0,0 +1,36 @@
+/**
+ * Remote Command Handler
+ *
+ * CLI command for managing multi-device private Git transport synchronization.
+ * Supports set, remove, and status subcommands.
+ */
+import { Command } from "commander";
+import type { CommandResult } from "../command-result.js";
+import { loadConfig, saveConfig } from "../../../infrastructure/hooks/config-manager.js";
+import { GitSyncer } from "../../../infrastructure/hooks/git-syncer.js";
+/**
+ * Options/parameters for remote subcommands.
+ */
+export interface RemoteCommandOptions {
+    configPathOverride?: string;
+    eventsDirOverride?: string;
+    loadConfig?: typeof loadConfig;
+    saveConfig?: typeof saveConfig;
+    createGitSyncer?: (eventsDir?: string) => Pick<GitSyncer, "isGitRepo" | "initRepo" | "configureRemote" | "removeRemote" | "getRemoteUrl">;
+}
+/**
+ * Create the remote command group for Commander.js.
+ */
+export declare function createRemoteCommand(opts?: RemoteCommandOptions): Command;
+/**
+ * Configure the remote sync repository.
+ */
+export declare function executeRemoteSetCommand(repositoryUrl: string, opts?: RemoteCommandOptions): Promise<CommandResult>;
+/**
+ * Remove remote sync configuration.
+ */
+export declare function executeRemoteRemoveCommand(opts?: RemoteCommandOptions): Promise<CommandResult>;
+/**
+ * Display current remote sync configurations and status.
+ */
+export declare function executeRemoteStatusCommand(opts?: RemoteCommandOptions): Promise<CommandResult>;