Module paths 

Shared path helpers (used by workspace and machine_registry to avoid import cycles).

Functions

canonical

claude_code_slug

Claude Code project slug: leading / becomes -, then / and . → -.

cursor_slug

Cursor project slug: strips leading /, then replaces / and . with -.

descendant_dir_for_write

descendant_file_for_write

descendant_path

kaizen_dir

KAIZEN_HOME or ~/.kaizen (requires HOME), or None if undiscoverable.

project_data_child

Existing project-data child path with symlink and traversal rejection.

project_data_dir

Project data path, created on demand for write-capable callers.

project_data_path

~/.kaizen/projects/<slug>/ (or $KAIZEN_HOME/projects/<slug>/) without I/O.

project_dir_for_write

Project-data directory prepared for a write.

project_file_for_write

Project-data file path whose parent is prepared for a write.

workspace_slug

/Users/lucas/Projects/kaizen → Users-lucas-Projects-kaizen