Distillation

Date: Aug 24, 2026

• 🔴 (16:45) User specified package-management policy: always use pnpm; never use npm or yarn.
• 🔴 (16:45) User stated Node.js is managed by Volta and currently uses Node.js v22.12.0.
• 🔴 (16:45) User specified dependencies must be installed with pnpm install --frozen-lockfile.
• 🟡 (16:45) Craft build/run command documented as pnpm build && ./dist/craft.
• 🟡 (16:45) Craft implementation convention: use getGitClient() from src/utils/git.ts, or createGitClient(directory) for operations in specific directories.
• 🟡 (16:45) Craft implementation convention: use getGitHubClient() from src/utils/githubApi.ts for GitHub API access.
• 🟡 (16:45) Craft implementation convention: use safeFs from src/utils/dryRun.ts for file writes.
• 🟡 (16:45) Craft implementation convention: use safeExec() or safeExecSync() from src/utils/dryRun.ts for non-file actions.