Module coordination 

Symlink wiring for coordination worktrees. Symlink wiring for coordination worktrees.

When Ito operates in a coordination-worktree layout, the canonical .ito/ subdirectories (changes, specs, modules, workflows, audit) are replaced by symlinks that point into a shared coordination worktree. This module provides the helpers to create, verify, and tear down those symlinks, as well as health-check utilities for detecting missing or broken setups.

Enums

CoordinationHealthStatus

Health status of the coordination worktree setup.

Constants

COORDINATION_DIRS

Subdirectories of .ito/ that are wired to the coordination worktree.

Functions

check_coordination_health

Inspect the coordination worktree and symlink state, returning a CoordinationHealthStatus that describes any problem found.

create_dir_link

Create a directory symlink dst → src in a platform-appropriate way.

format_health_message

Return an actionable error message for an unhealthy coordination state, or None when the status is CoordinationHealthStatus::Healthy or CoordinationHealthStatus::Embedded.

remove_coordination_symlinks

Tear down coordination symlinks and restore real directories.

update_gitignore_for_symlinks

Append coordination-symlink entries to <project_root>/.gitignore.

wire_coordination_symlinks

Wire .ito/<dir> → <worktree_ito_path>/<dir> for every coordination directory.