# =============================================================================
# .worktreeinclude — Files to copy into agent worktrees on provisioning
# =============================================================================
# Canonical location: <projectRoot>/.worktreeinclude (matches Claude Code
# Desktop, worktrunk-core, and the broader git-worktree-tooling convention).
#
# Legacy location: <projectRoot>/.cleo/worktree-include (still read for one
# deprecation cycle with a `process.emitWarning`; will be removed in v6.1.x).
# Run `cleo doctor --migrate-worktree-include` to auto-migrate.
#
# SYNTAX: gitignore-style globs (parsed by ignore::gitignore via
# @cleocode/worktree-napi). Lines starting with `!` are negations.
#
# COMMON USE CASES:
#   - Local environment files (.env.local) that are gitignored but needed
#     for the project to run in a worktree context
#   - Package-manager config files (.npmrc, .yarnrc) that configure registry
#     auth or resolution rules but are never committed
#   - IDE settings that should be present in every worktree
#
# NOTE: node_modules/ is intentionally NOT listed here.
# Symlinking node_modules across worktrees causes pnpm store races that
# corrupt .pnpm/ with @@-prefixed doubled directories (T9938).
# Each worktree gets its own node_modules installed during provisioning
# via a serialized pnpm install step in createWorktree.
#
# IMPORTANT: Files are COPIED (not symlinked) into each worktree, preserving
# full worktree isolation (T10077). Modifications in one worktree do NOT
# affect any other worktree or the project root.
#   target/                # Rust — cargo build cache (large; reflink-aware)
#   .venv/                 # Python — virtualenv
#   vendor/                # Go — dependencies
#   .gradle/               # Java — Gradle cache
#   build/                 # Generic — compiled artifacts
#
# CLEO copies these in parallel via @cleocode/worktree-napi (rayon +
# reflink-or-copy). Reflink (copy-on-write) makes large directory copies
# effectively free on supported FS (APFS/btrfs/XFS).
#
# SAFETY: Only list files that are SAFE to propagate across worktrees.
# Never list secrets, session data, or machine-specific caches here.
# =============================================================================

# Local environment overrides (gitignored but required for dev)
.env.local
.env.development.local

# Package-manager configuration (registry auth, resolution rules)
.npmrc
.yarnrc
.pnpmrc

# IDE / editor settings that are project-wide but not committed
.vscode/settings.json
.idea/runConfigurations/

# Build-tool local overrides
justfile.local
Makefile.local
