Debugging

# 1. Start bisect session
wit bisect start

# 2. Mark current commit as bad (has the bug)
wit bisect bad

# 3. Mark a known good commit (before the bug existed)
wit bisect good v1.0.0

# 4. wit checks out a commit in the middle - test it
# ... test the code ...

# 5. Mark as good or bad based on your test
wit bisect good   # Bug not present
# or
wit bisect bad    # Bug is present

# 6. Repeat step 4-5 until wit finds the culprit
# ✓ Found the first bad commit!
# abc1234 is the first bad commit
#   John Doe: Add new feature

# 7. End the session
wit bisect reset

wit bisect start           # Start bisect session
wit bisect good [<rev>]    # Mark commit as good (no bug)
wit bisect bad [<rev>]     # Mark commit as bad (has bug)
wit bisect skip            # Skip current commit (can't test)
wit bisect reset           # End session, return to original state
wit bisect log             # Show bisect history
wit bisect status          # Show current bisect state

# Start bisect
wit bisect start
# ✓ Bisect session started
# Now mark commits as good or bad

# We know HEAD is broken
wit bisect bad
# ✗ Marked as bad

# We know v1.0.0 worked
wit bisect good v1.0.0
# ✓ Marked as good
# Bisecting: 15 commits left to test
# (roughly 4 steps remaining)
# Testing: abc1234
#   Jane Doe: Refactor API

# Test the code at this commit
npm test

# It passes, so this commit is good
wit bisect good
# ✓ Marked as good
# Bisecting: 7 commits left to test
# (roughly 3 steps remaining)
# Testing: def5678

# Keep going until...
# ✓ Found the first bad commit!
# ghi9012 is the first bad commit
#   Bob Smith: Update dependencies

wit bisect reset
# ✓ Bisect session ended
# Restored to branch: main

wit bisect status
# Bisect Status:
# Current commit: abc1234
# Good commits: 3
# Bad commits: 2
# Skipped: 1
# Steps taken: 5
#
# 8 commits left to test
# (roughly 3 steps remaining)

wit bisect log
# Bisect Log:
# 10:30:00 ● Bisect started from abc1234
# 10:31:00 ✓ Marked abc1234 as good
# 10:32:00 ✗ Marked def5678 as bad
# 10:33:00 ○ Skipped ghi9012

# Can't test this commit
wit bisect skip
# ○ Skipped current commit
# Testing: next-commit

# Show the last commit
wit show

# Show specific commit
wit show abc1234

# Show with stats only
wit show --stat abc1234

# Show file names only
wit show --name-only abc1234

wit show abc1234

# commit abc1234def5678...
# Author: Jane Doe <jane@example.com>
# Date:   Fri Mar 15 14:30:00 2024 -0500
#
#     Add user authentication
#
#     - Implement JWT tokens
#     - Add login/logout endpoints
#
# diff --git a/src/auth.ts b/src/auth.ts
# new file mode 100644
# --- /dev/null
# +++ b/src/auth.ts
# @@ -0,0 +1,50 @@
# +export class Auth {
# ...

# Show file contents at a specific commit
wit show abc1234:src/config.ts

# Show file at HEAD
wit show HEAD:package.json

# Show file from 3 commits ago
wit show HEAD~3:README.md

wit show v1.0.0

# tag v1.0.0
# Tagger: Jane Doe <jane@example.com>
# Date:   Fri Mar 15 14:30:00 2024
#
#     Release version 1.0.0
#
# commit abc1234...
# Author: Jane Doe <jane@example.com>
# ...

# See what changed in a commit (summary)
wit show --stat HEAD
# src/auth.ts    | 50 +++++++++++++++
# src/routes.ts  | 12 ++--
# 2 files changed, 55 insertions(+), 5 deletions(-)

# List files changed in a commit
wit show --name-only abc1234
# src/auth.ts
# src/routes.ts

# See file status
wit show --name-status abc1234
# A    src/auth.ts
# M    src/routes.ts

# Preview what would be deleted (always do this first!)
wit clean -n

# Actually delete files
wit clean -f

# Delete files and directories
wit clean -fd

# Also delete ignored files (like node_modules, build/)
wit clean -fx

# See what would be cleaned
wit clean -n
# Would remove:
#   × temp.txt
#   × debug.log
#   × src/test.tmp
#
# 3 file(s)
# Use -f to actually delete these files

# Remove untracked files
wit clean -f
# ✓ Removed temp.txt
# ✓ Removed debug.log
# ✓ Removed src/test.tmp
# ✓ Removed 3 file(s)

# Remove files and directories
wit clean -fd
# ✓ Removed temp.txt
# ✓ Removed build/
# ✓ Removed 1 file(s), 1 directory(ies)

# Nuclear option: remove everything including ignored files
wit clean -fdx
# This will remove node_modules, build artifacts, etc.
# Use with caution!

# Clean, but exclude certain files
wit clean -f -e "*.log" -e "config.local.json"

# Clean up after a failed build
wit clean -fd

# Start completely fresh (like a new clone)
wit clean -fdx
npm install

# Clean up temp files but keep build artifacts
wit clean -f -e "build/*" -e "dist/*"

# 1. Clean up the workspace
wit clean -n          # Preview
wit clean -f          # Clean

# 2. Find when bug was introduced
wit bisect start
wit bisect bad HEAD
wit bisect good v1.0.0

# ... test and mark commits ...

wit bisect reset

# 3. Examine the bad commit
wit show <bad-commit>
wit show <bad-commit>:path/to/file.ts

# 4. Check what the file looked like before
wit show <bad-commit>~1:path/to/file.ts