feat: migrate project from pnpm to Bun

- Update package.json to use bun@1.2.22 as packageManager
- Replace all pnpm commands with bun equivalents in scripts
- Update lefthook.yml to use bun commands in pre-commit hooks
- Remove pnpm-lock.yaml and create bun.lock
- Rename .github/workflows/node.yml to bun.yml and update to use Bun
- Add package manager detection logic to all command documentation
- Update AGENT.md to include package manager detection for manual workflows

Benefits:
- Faster package installation and script execution
- Native TypeScript support in Bun runtime
- Improved performance for development workflows
- Consistent package manager across CI/CD and local development

Author: shunkakinoki

.github/workflows/node.yml .github/workflows/bun.yml.github/workflows/node.yml renamed to .github/workflows/bun.yml

@@ -1,4 +1,4 @@
-name: Node
+name: Bun
 on:
   push:
     branches:
@@ -11,27 +11,25 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.head_ref || github.sha }}
   cancel-in-progress: true
 jobs:
-  node-lint:
+  bun-lint:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v5
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
       - name: Install dependencies
-        run: pnpm install
+        run: bun install
       - name: Check
-        run: pnpm run check
+        run: bun run check
       - name: Format
-        run: pnpm run format
+        run: bun run format
       - name: Lint
-        run: pnpm run lint
-  node-check:
+        run: bun run lint
+  bun-check:
     if: always()
     needs:
-      - node-lint
+      - bun-lint
     runs-on: ubuntu-latest
     steps:
       - name: Alls Green

bun.lock

@@ -14,13 +14,13 @@ Install commitlint for commit message validation:
 
 ```bash
 # Install commitlint CLI and conventional config
-pnpm add -D @commitlint/cli @commitlint/config-conventional
+bun add -D @commitlint/cli @commitlint/config-conventional
 
 # Install lefthook for pre-commit hooks
-pnpm add -D lefthook
+bun add -D lefthook
 
 # Initialize lefthook hooks
-pnpm run lefthook:install
+bun run lefthook:install
 ```
 
 ### Required Dependencies
@@ -41,9 +41,9 @@ The commit linting configuration is defined in `ruler.toml` under the `[commit]`
 [commit]
 enabled = true
 pre_commit_commands = [
-  "pnpm run format",    # Format code with Biome
-  "pnpm run lint",      # Run linting and checks
-  "pnpm run check"      # Run all quality checks
+  "bun run format",    # Format code with Biome
+  "bun run lint",      # Run linting and checks
+  "bun run check"      # Run all quality checks
 ]
 ```
 
@@ -93,17 +93,17 @@ Git hooks are managed through `lefthook.yml` with three main stages:
 
 ## Pre-commit Commands
 
-### 1. Code Formatting (`pnpm run format`)
+### 1. Code Formatting (`bun run format`)
 - Uses Biome to format all code files
 - Ensures consistent indentation, spacing, and line breaks
 - Applies project-specific formatting rules
 
-### 2. Linting (`pnpm run lint`)
+### 2. Linting (`bun run lint`)
 - Runs comprehensive linting checks
 - Validates code quality and style
 - Checks for potential bugs and issues
 
-### 3. Quality Checks (`pnpm run check`)
+### 3. Quality Checks (`bun run check`)
 - Runs all automated quality verification
 - Ensures ruler rules are applied
 - Verifies no uncommitted changes remain
@@ -121,11 +121,11 @@ The linting system targets specific file types to optimize performance:
 
 The system includes auto-fix commands that attempt to resolve issues automatically:
 
-- **Biome Format**: `pnpm run biome:format`
+- **Biome Format**: `bun run biome:format`
   - Automatically formats code
   - Fixes spacing and indentation issues
 
-- **Biome Check**: `pnpm run biome:check --write`
+- **Biome Check**: `bun run biome:check --write`
   - Auto-fixes linting violations where possible
   - Applies safe corrections
 
@@ -141,6 +141,52 @@ When contributing code, AI agents must ensure code quality by:
 6. **Solo Authorship**: DO NOT include co-authorship in commit messages - commits should be solo-authored
 7. **PR Attribution**: Include AI attribution in PR descriptions, not commit messages
 
+## Package Manager Detection
+
+AI agents must automatically detect which package manager is being used and adapt their behavior accordingly:
+
+### Detection Logic
+
+```bash
+# Check for package manager
+if [ -f "bun.lockb" ] || [ -f "bun.lock" ]; then
+  PACKAGE_MANAGER="bun"
+elif [ -f "pnpm-lock.yaml" ]; then
+  PACKAGE_MANAGER="pnpm"
+elif [ -f "yarn.lock" ]; then
+  PACKAGE_MANAGER="yarn"
+elif [ -f "package-lock.json" ]; then
+  PACKAGE_MANAGER="npm"
+else
+  PACKAGE_MANAGER="npm"  # fallback to npm
+fi
+```
+
+#### Fish Detection Logic
+
+```fish
+# Check for package manager (Fish)
+set PACKAGE_MANAGER npm
+if test -f bun.lockb -o -f bun.lock
+  set PACKAGE_MANAGER bun
+else if test -f pnpm-lock.yaml
+  set PACKAGE_MANAGER pnpm
+else if test -f yarn.lock
+  set PACKAGE_MANAGER yarn
+else if test -f package-lock.json
+  set PACKAGE_MANAGER npm
+end
+```
+
+### Package Manager Commands
+
+Based on the detected package manager, use these commands:
+
+- **bun**: `bun add`, `bun run`, `bun install`
+- **pnpm**: `pnpm add`, `pnpm run`, `pnpm install`
+- **yarn**: `yarn add`, `yarn run`, `yarn install`
+- **npm**: `npm install`, `npm run`
+
 ## Pre-commit Hook Detection
 
 AI agents must automatically detect which pre-commit hook system is being used and adapt their behavior accordingly:
@@ -224,10 +270,10 @@ git commit -m "feat: add new feature"
 
 **Manual workflow:**
 ```bash
-# Run manual checks
-pnpm run lint
-pnpm run format
-pnpm run check
+# Run manual checks (adapt commands based on detected package manager)
+$PACKAGE_MANAGER run lint
+$PACKAGE_MANAGER run format
+$PACKAGE_MANAGER run check
 
 # Validate commit message format
 echo "feat: add new feature" | npx commitlint
@@ -424,12 +470,12 @@ The system leverages the existing Biome configuration:
 ### Common Issues
 - **Formatting Failures**: Check Biome configuration and file permissions
 - **Linting Errors**: Review error messages and fix manually if auto-fix fails
-- **Command Not Found**: Ensure pnpm and Biome are properly installed
+- **Command Not Found**: Ensure bun and Biome are properly installed
 
 ### Troubleshooting Steps
-1. Verify Biome installation: `pnpm biome --version`
-2. Check configuration: `pnpm run biome:check`
-3. Run manual format: `pnpm run biome:format`
+1. Verify Biome installation: `bun biome --version`
+2. Check configuration: `bun run biome:check`
+3. Run manual format: `bun run biome:format`
 4. Review git status after fixes
 
 ## Quality Standards

commands/commit-lint.md

@@ -26,26 +26,61 @@ git push -u origin <branch-name>
 git push
 ```
 
+## Package Manager Detection
+
+Before running any package manager commands, detect which package manager is being used:
+
+```bash
+# Check for package manager
+if [ -f "bun.lockb" ] || [ -f "bun.lock" ]; then
+  PACKAGE_MANAGER="bun"
+elif [ -f "pnpm-lock.yaml" ]; then
+  PACKAGE_MANAGER="pnpm"
+elif [ -f "yarn.lock" ]; then
+  PACKAGE_MANAGER="yarn"
+elif [ -f "package-lock.json" ]; then
+  PACKAGE_MANAGER="npm"
+else
+  PACKAGE_MANAGER="npm"  # fallback to npm
+fi
+```
+
+### Fish Detection Logic
+
+```fish
+# Check for package manager (Fish)
+set PACKAGE_MANAGER npm
+if test -f bun.lockb -o -f bun.lock
+  set PACKAGE_MANAGER bun
+else if test -f pnpm-lock.yaml
+  set PACKAGE_MANAGER pnpm
+else if test -f yarn.lock
+  set PACKAGE_MANAGER yarn
+else if test -f package-lock.json
+  set PACKAGE_MANAGER npm
+end
+```
+
 ## Pre-commit Quality Checks
 
 Before committing, ensure code quality by running:
 
 ```bash
-# Run formatting with Biome
-pnpm run format
+# Run formatting with Biome (adapt based on detected package manager)
+$PACKAGE_MANAGER run format
 
 # Run linting and checks
-pnpm run lint
+$PACKAGE_MANAGER run lint
 
 # Run all quality checks
-pnpm run check
+$PACKAGE_MANAGER run check
 ```
 
 ### Auto-fix Capabilities
-The system includes auto-fix commands:
+The system includes auto-fix commands (adapt based on detected package manager):
 
-- **Biome Format**: `pnpm run biome:format` - Automatically formats code
-- **Biome Check**: `pnpm run biome:check --write` - Auto-fixes linting violations
+- **Biome Format**: `$PACKAGE_MANAGER run biome:format` - Automatically formats code
+- **Biome Check**: `$PACKAGE_MANAGER run biome:check --write` - Auto-fixes linting violations
 
 ### Quality Verification
 - **Review auto-fixes** for correctness before committing

commands/commit-push.md

@@ -186,11 +186,33 @@ gh pr close <number>
 
 ### Quality Assurance
 - **Ensure all pre-commit hooks pass** before creating PR
-- **Run tests** before creating PR (`uv run pytest` for this project)
+- **Run tests** before creating PR (adapt commands based on detected package manager)
 - **Verify code formatting** (Biome handles this automatically)
 - **Check for breaking changes** and document them clearly
 - **Test manually** for UI/UX changes
 
+#### Package Manager Detection for Testing
+
+Before running tests, detect which package manager is being used:
+
+```bash
+# Check for package manager
+if [ -f "bun.lockb" ] || [ -f "bun.lock" ]; then
+  PACKAGE_MANAGER="bun"
+elif [ -f "pnpm-lock.yaml" ]; then
+  PACKAGE_MANAGER="pnpm"
+elif [ -f "yarn.lock" ]; then
+  PACKAGE_MANAGER="yarn"
+elif [ -f "package-lock.json" ]; then
+  PACKAGE_MANAGER="npm"
+else
+  PACKAGE_MANAGER="npm"  # fallback to npm
+fi
+
+# Run tests with detected package manager
+$PACKAGE_MANAGER run test
+```
+
 ### CI/CD Integration
 - **PRs automatically trigger** CI pipelines
 - **Address failing checks** promptly (tests, linting, formatting)