Project Utilities

find_project_root() → Path

Find the project root directory.

Searches current directory and parent directories for a .brisk/ directory (new format) or a .briskconfig file (legacy). The new format takes precedence. When only the legacy format is found, a deprecation warning is issued and the user is offered an interactive migration prompt.

Can be overridden in tests using ProjectRootContext.

Returns:

pathlib.Path

Path to project root directory

Raises:

FileNotFoundError

If no project marker can be found in any parent directory