Module path_utils 

Path canonicalization and resolution utilities for Project root handling

Implements the path handling strategy from PROJECT_ROOT_SPEC.md and 02_DESIGN.md [H1]. All file paths are canonicalized before root resolution to ensure the invariant “at most one Project per index_root” holds regardless of how paths are accessed.

Constants

DEFAULT_IGNORED_DIRS

Default directories to skip during repository detection.

Functions

absolutize_without_resolution

Absolutize a path without touching the filesystem.

canonicalize_path

Canonicalize a path, resolving symlinks where possible.

is_ignored_dir

Check if a directory entry should be ignored during repository detection.

is_ignored_dir_with_config

Check if a directory entry should be ignored, using a custom ignore list.

normalize_path_components

Normalize path components lexically (without filesystem access).