import { type GitCommandRunner } from './git.js';
/**
 * Store identity (FR-24, AD-10).
 *
 * One store per repository, addressed by a hash of the absolute realpath of
 * `git rev-parse --git-common-dir`. Every worktree of a repository resolves to
 * the same store — worktree partitioning is already handled inside the store by
 * `scope_key`, not by file layout — while two clones resolve to two stores.
 *
 * The realpath is not decoration. Measured on win32: `path.resolve` preserves
 * `c:\repo` as typed while the canonical path is `C:\repo`, and it resolves a
 * junction to the link rather than its target. Either one splits a single
 * repository across two stores, silently, with memory divided between them.
 */
/** Hex characters kept from the sha256. Matches `hookTemplateDigest`. */
export declare const STORE_ID_LENGTH = 16;
/** Directory under the user's home when `CORTEX_HOME` is unset. */
export declare const DEFAULT_HOME_DIR_NAME = ".cortex";
/** Store filename inside its per-project directory. */
export declare const STORE_FILENAME = "cortex.db";
/** The pre-relocation filename, still read for migration and still ignored by git. */
export declare const LEGACY_STORE_FILENAME = ".cortex.db";
export interface StoreIdentity {
    /** Hash of the absolute realpath of the git common dir, or of cwd when degraded. */
    storeId: string;
    /** `<home>/projects/<label>-<storeId>`. */
    storeDir: string;
    /** The database this project resolves to. */
    dbPath: string;
    /** Resolved Cortex home. */
    home: string;
    /** Realpath of the working tree (or of `startDir` without git). */
    projectRoot: string;
    /** Realpath of `git rev-parse --git-common-dir`; null without git. */
    gitCommonDir: string | null;
    /**
     * AD-10's repair anchor; null for an empty repo or without git.
     *
     * A memoized thunk rather than a field, because resolving it costs a git
     * subprocess (~100 ms on win32) and almost nothing needs it: the meta write
     * happens once per store and the adoption scan only runs when a repository
     * has no store at all. Every ambient open would otherwise pay for it.
     */
    readRootCommitOid(): string | null;
    /** True when identity fell back to the working directory (AC #5). */
    degraded: boolean;
    /** Human-readable reason, present only when `degraded`. */
    degradedReason: string | null;
    /** Pre-relocation database locations to consider migrating, most likely first. */
    legacyDbPaths: string[];
}
/**
 * Absolute realpath, falling back when the path cannot be resolved.
 *
 * `realpathSync.native` canonicalises drive-letter case and 8.3 short names on
 * win32 and resolves symlinks everywhere; `path.resolve` does neither.
 */
export declare function resolveRealPath(target: string): string;
/**
 * Cortex home: `CORTEX_HOME` when set and non-empty, else `~/.cortex`.
 *
 * Follows `CORTEX_SPOOL_DIR`'s existing shape. This override is also the test
 * hermeticity boundary — a test that does not set it writes into the developer's
 * real memory store, which is the incident story 2.4 recorded.
 */
export declare function cortexHome(env?: NodeJS.ProcessEnv): string;
/**
 * Cosmetic directory prefix so `~/.cortex/projects/` is browsable.
 *
 * Never parsed and never used for lookup: the hash is the only authoritative
 * part, and adoption reads each candidate store's `meta` rather than its name.
 */
export declare function sanitizeLabel(name: string): string;
/** sha256 of the identifying path, truncated to `STORE_ID_LENGTH`. */
export declare function computeStoreId(identifyingPath: string): string;
/**
 * The label must derive from the same input as the hash.
 *
 * Deriving it from the *worktree* basename would give two worktrees of one
 * repository the same `storeId` but different directory names — and therefore
 * different stores, breaking AC #1 while every hash assertion still passed.
 */
export declare function storeLabelFor(gitCommonDir: string): string;
/**
 * Root-commit OIDs, sorted and joined.
 *
 * A repository with merged histories or grafts has more than one root commit,
 * and `git rev-list --max-parents=0 HEAD` returns all of them in traversal
 * order — so taking the first is order-dependent and not an identity. An empty
 * repository has no HEAD and no anchor; adoption is simply unavailable there.
 */
export declare function readRootCommitOid(cwd: string, runGit: GitCommandRunner): string | null;
export interface ResolveStoreIdentityOptions {
    env?: NodeJS.ProcessEnv;
    runGit?: GitCommandRunner;
}
/**
 * Resolve where this project's store lives.
 *
 * Never throws and never touches the filesystem beyond realpath resolution:
 * ambient callers run inside hooks, where AD-12 requires that any failure
 * degrade to silence rather than surface.
 */
export declare function resolveStoreIdentity(startDir: string, options?: ResolveStoreIdentityOptions): StoreIdentity;
//# sourceMappingURL=identity.d.ts.map