/**
 * Smart project root resolution.
 *
 * Walks up the directory tree from a starting directory, looking for
 * well-known project markers (`.git`, `package.json`, etc.).
 * Returns the absolute path of the nearest directory that contains
 * any marker, or `null` if none is found.
 */
/** Markers that indicate a project root directory. */
export declare const PROJECT_MARKERS: readonly [".git", "package.json", "Cargo.toml", "go.mod", "pyproject.toml", "requirements.txt", "pom.xml", ".specweave"];
/**
 * Walk up the directory tree from `startDir` and return the absolute
 * path of the first directory that contains any project marker.
 *
 * Returns `null` when the filesystem root is reached without finding
 * any marker.
 */
export declare function findProjectRoot(startDir: string): string | null;