import { type ResultEnvelope } from 'peaks-loop-shared/result';
import type { ProjectMemoryKind } from '../../services/memory/memory-search-service.js';
export interface MemorySearchCommandOptions {
    query: string;
    kind?: string;
    limit?: number;
    project?: string;
    json?: boolean;
}
export interface MemoryListCommandOptions {
    kind?: string;
    pick?: boolean;
    fzfBin?: string;
    project?: string;
    json?: boolean;
    /** Slice B: emit counts + names-of-first-N instead of the full entry array. */
    summary?: boolean;
}
export interface MemoryReindexCommandOptions {
    project?: string;
    dryRun?: boolean;
    apply?: boolean;
    json?: boolean;
    /** Slice B: emit counts + names-of-first-N instead of the full arrays. */
    summary?: boolean;
}
export interface MemoryIngestCommandOptions {
    project?: string;
    sourceDir?: string;
    dryRun?: boolean;
    apply?: boolean;
    json?: boolean;
}
export interface MemoryRotateCommandOptions {
    project?: string;
    dryRun?: boolean;
    apply?: boolean;
    json?: boolean;
}
/** `--project` canonicalised, else the nearest project root above cwd, else cwd. */
export declare function resolveMemoryProjectRoot(project?: string): string;
/** The CLI kind flag, narrowed to the canonical vocabulary; unknown ⇒ no filter. */
export declare function resolveKindFilter(kind: string | undefined): ProjectMemoryKind | undefined;
/**
 * The failed envelope for a memory verb: the error's own `code` when it carries
 * one, the verb's `<VERB>_FAILED` otherwise. `byCode` names the one action worth
 * recommending for a specific failure; anything else falls back to
 * `suggestions`, so a caller that has no code-specific advice omits it.
 */
export declare function memoryFailure(input: {
    readonly command: string;
    readonly fallbackCode: string;
    readonly error: unknown;
    readonly projectRoot: string;
    readonly suggestions?: readonly string[];
    readonly byCode?: Readonly<Record<string, string>>;
}): ResultEnvelope<{
    projectRoot: string;
}>;