export type AutomaticWorkspaceSource = "knowledge_rail_marker" | "project_marker" | "cwd";
export interface AutomaticWorkspaceResolution {
    root: string;
    source: AutomaticWorkspaceSource;
}
export declare function unsafeAutomaticRootReason(candidate: string): string | null;
export declare function canonicalizeExistingDirectory(candidate: string): Promise<string>;
/**
 * Canonicalize a selected project root and repair the common case where a
 * client selected the canonical wiki directory (or one of its descendants)
 * as the workspace. KnowledgeRail APIs always store a project root and append
 * `wiki/` themselves.
 */
export declare function canonicalizeProjectRoot(candidate: string): Promise<string>;
/**
 * Discover only below the cwd ancestry. This deliberately never scans a disk
 * or a home directory and therefore behaves the same on Windows, Linux/macOS,
 * containers and WSL.
 */
export declare function discoverWorkspaceFromCwd(cwd?: string): Promise<AutomaticWorkspaceResolution>;
//# sourceMappingURL=workspace-discovery.d.ts.map