branchyard/RELEASE_v1.2.3.md

branchyard — Your shipyard for parallel development workflows. Maintain your digital yard with clean branches, productive workflows, and AI-era readiness.

# branchyard v1.2.3 - Critical Fix 🚨

## Critical Bug Fix

Fixed a critical import issue where `writeFileSync` was incorrectly imported from `bun` instead of `node:fs`. This caused worktree creation to fail.

## What Was Fixed

❌ **Before (broken):**
```ts
import { $, writeFileSync } from "bun";
```

✅ **After (fixed):**
```ts
import { $ } from "bun";
import { existsSync, writeFileSync } from "node:fs";
```

## Important Note

**From Bun, we should ONLY import `$` for shell execution.** All filesystem operations must use Node.js built-in modules (`node:fs`, `node:path`, etc.).

## Affected Versions

- v1.2.0 - v1.2.2 had this bug
- v1.2.3 fixes the issue

## Update Instructions

If you installed v1.2.0-v1.2.2, please update immediately:

```bash
# Using Bun
bun install -g branchyard@latest

# Using npm
npm install -g branchyard@latest
```

## Verification

After updating, verify the version:
```bash
branchyard --help
# Should show: ⚓ branchyard v1.2.3
```

---

We apologize for any inconvenience. This fix ensures branchyard works correctly when creating worktrees.