export declare const GIT_METADATA_INSPECTION_FAILED_NOTE = "Git metadata could not be inspected safely.";
export declare const GIT_METADATA_CONTAINMENT_FAILED_NOTE = "Git metadata failed containment validation.";
export interface VerifiedGitWorkspace {
    readonly commonDir: string;
    readonly configOverrides: readonly string[];
    readonly gitDir: string;
    readonly kind: "directory" | "linked-worktree";
    readonly trustRoot: string;
    readonly worktreeRoot: string;
}
export type GitWorkspaceInspection = {
    readonly status: "missing";
} | {
    readonly note: typeof GIT_METADATA_INSPECTION_FAILED_NOTE | typeof GIT_METADATA_CONTAINMENT_FAILED_NOTE;
    readonly status: "unsafe";
    readonly worktreeRoot: string;
} | {
    readonly status: "verified";
    readonly workspace: VerifiedGitWorkspace;
};
/**
 * Resolve one physical Git worktree without trusting ambient Git discovery.
 *
 * A regular `.git` file is accepted only for Git's exact linked-worktree
 * topology: `<common>/.git/worktrees/<name>` plus single-link `commondir` and
 * `gitdir` backpointer files. Arbitrary `gitdir:` redirects (including valid
 * separate-git-dir repositories) are deliberately unavailable because they
 * delegate metadata authority outside the selected project without a
 * verifiable backlink.
 */
export declare function inspectVerifiedGitWorkspace(cwdInput: string): Promise<GitWorkspaceInspection>;