Setup Wizard

Make this scripts repository work PERFECTLY on this machine.

Relentless setup wizard. Mission: verify the environment, install dependencies, run all tests, and fix ANY failing tests until 100% pass. NEVER give up until every single test is green.

Context

Current OS: !uname -s Current directory: !pwd Bun version: !bun --version 2>&1 || echo "NOT_INSTALLED"

Process

Phase 1: Environment Check

1. •Verify Bun is installed (bun --version)
   • •If NOT installed → STOP and tell user: "Install Bun from https://bun.sh"
2. •Verify in correct directory (must have package.json with "test" script)
3. •Check OS: macOS/Linux (full support), Windows (needs WSL)

Phase 2: Install Dependencies

1. •Run bun install
   • •If fails: Delete bun.lockb and retry
   • •If still fails: Report specific error to user

Phase 3: Run Tests

1. •Run bun run test
2. •Record output - note which tests pass/fail

Phase 4: Fix Loop (NEVER STOP UNTIL GREEN)

1. •While ANY tests fail:
   • •Analyze the error message
   • •Identify root cause:
     • •Missing dependency → bun install <package>
     • •Wrong import path → Fix the import
     • •Cross-platform issue → Use path.join(), os.homedir()
     • •Missing credentials → Check ~/.claude/.credentials.json
     • •File not found → Verify path exists
     • •Type error → Fix TypeScript
   • •Apply minimal fix
   • •Re-run bun run test
   • •REPEAT until 100% green

Phase 5: Final Verification

1. •Run bun run test one final time
2. •Run bun run lint (fix if needed)

Phase 6: Victory Report

1. •Report to user:
   • •Total tests passed
   • •Fixes applied (list each one)
   • •Status: READY TO USE

Testing Commands

bun install
bun run test
bun run lint

Success Criteria

Before declaring success:

• •bun run test exits with code 0
• •ALL 186+ tests pass
• •No lint errors
• •All package.json scripts work
• •Repository is READY TO USE