export interface ProjectInfo {
    name: string;
    path: string;
    type: 'repo' | 'worktree';
    branch: string;
}
export interface ProjectScanOptions {
    includeWorktrees?: boolean;
}
/**
 * Describe a single directory as a project: its basename + current git ref,
 * or null if the directory isn't a git repo/worktree. Used by `/repo <path>`
 * to label an explicitly given path that may sit outside the scanned roots
 * (the card's project list, by contrast, only covers the scan dirs).
 */
export declare function describeProjectDir(dir: string): {
    name: string;
    branch: string;
} | null;
/**
 * Scan a directory for git repositories and their worktrees.
 */
export declare function scanProjects(baseDir: string, maxDepth?: number, options?: ProjectScanOptions): ProjectInfo[];
/**
 * Scan multiple directories and deduplicate by path.
 */
export declare function scanMultipleProjects(baseDirs: string[], maxDepth?: number, options?: ProjectScanOptions): ProjectInfo[];
//# sourceMappingURL=project-scanner.d.ts.map