Dependency preparation flow
Swimlane diagram showing that the shared hook synchronously validates root lockfiles plus packageManager declarations. Conflicting lockfiles, mismatches, and unsupported declarations fail the worktree command. Valid metadata starts detached installs and status reporting, but consumers may use the worktree before dependencies are ready.
TRUSTED USER
GIT
SHARED HOOK
DETACHED INSTALLER
STATUS CONSUMERS
ASYNC BOUNDARY
WORKTREE RETURNS
INSTALLS CONTINUE
INVALID
Enable /deps
TRUSTED REPOSITORY
Create worktree
CALL SHARED POST-CHECKOUT
Synchronous validation
ROOT LOCKFILES + packageManager DECLARATIONS
CONFLICTING LOCKFILES · MISMATCHES
UNSUPPORTED DECLARATIONS?
Fail fast
WORKTREE COMMAND
Run frozen installs
NODE + UV · LOCKED
DETACHED
Update status + log
status.json
install.log
Worktree may be used
before installs finish
READINESS NOT GUARANTEED
Pi reports status
THEN REMOVES IT
Other consumers
MUST READ IT THEMSELVES
LEGEND
Step
Decision
Detached / async
State files
Synchronous failure