Documentation: Restore deleted functions in plotting_functions.ipynb

UNDO_INSTRUCTIONS.md

@@ -0,0 +1,135 @@
+# How to Undo Yesterday's Changes
+
+## What Happened
+
+On **January 10, 2026 at 11:51 AM**, a commit was made with the message "reduced functions in plotting_functions.ipynb" (SHA: `effb9dbfedd2d6c23774d6b913d553f004f8a7c9`).
+
+This commit modified `/code/plotting_functions.ipynb`:
+- **Deleted**: 373 lines
+- **Added**: 33 lines  
+- **Net change**: -340 lines (reduction in file size)
+
+## Current State
+
+The file currently contains:
+- 1,735 lines total
+- 8 function definitions:
+  1. `transform_dict_columns()`
+  2. `plot_prediction_accuracy()`
+  3. `ci95()`
+  4. `plot_error_events()`
+  5. `plot_coherence_events()`
+  6. `make_coherence_table_combined()`
+  7. `make_coherence_table()`
+  8. `plot_model_comparison()`
+
+## How to Undo
+
+Since I cannot access the repository's full history in this environment, you have several options:
+
+### Option 1: Revert Locally (Recommended)
+
+If you have a local clone with full history:
+
+```bash
+# Navigate to your local repository
+cd path/to/LLM-BayesianInference
+
+# Fetch the latest changes
+git fetch origin main
+
+# Create a new branch
+git checkout -b restore-plotting-functions main
+
+# Revert the problematic commit
+git revert effb9dbfedd2d6c23774d6b913d553f004f8a7c9
+
+# Push the changes
+git push origin restore-plotting-functions
+```
+
+### Option 2: Reset to Previous Commit
+
+If you want to completely remove the "reduced functions" commit:
+
+```bash
+# Checkout the commit before the problematic one
+git checkout eb82698beff2cdf6d0b01391acebf90e569d4ea8
+
+# Create a new branch from there
+git checkout -b restore-plotting-functions
+
+# Retrieve the old version of the file
+git checkout eb82698 -- code/plotting_functions.ipynb
+
+# Commit the restoration
+git commit -m "Restore plotting_functions.ipynb to state before function reduction"
+
+# Push the branch
+git push origin restore-plotting-functions
+```
+
+### Option 3: Manual File Restoration
+
+If you have a backup or can access an earlier commit:
+
+1. Checkout the file from before the problematic commit:
+   ```bash
+   git checkout eb82698beff2cdf6d0b01391acebf90e569d4ea8 -- code/plotting_functions.ipynb
+   ```
+
+2. Commit the restored file:
+   ```bash
+   git add code/plotting_functions.ipynb
+   git commit -m "Restore deleted functions in plotting_functions.ipynb"
+   git push
+   ```
+
+## Why I Couldn't Do This Automatically
+
+The repository clone in this environment is "shallow" - it only contains the most recent commit (`effb9db`) and doesn't have access to the parent commits where the original file existed. Additionally:
+
+1. Network access to GitHub's raw content is blocked
+2. The GitHub token doesn't have sufficient permissions for some API operations
+3. The git credential helper cannot authenticate to fetch additional history
+
+## Quick Restoration Script
+
+Here's a simple script you can run to restore the file:
+
+```bash
+#!/bin/bash
+# Save this as restore_functions.sh and run with: bash restore_functions.sh
+
+cd path/to/your/local/repository
+
+# Fetch latest changes
+git fetch origin
+
+# Create a new branch
+git checkout -b restore-plotting-functions origin/main
+
+# Revert the commit that reduced functions
+git revert --no-commit effb9dbfedd2d6c23774d6b913d553f004f8a7c9
+
+# Review the changes
+git diff --stat
+
+# If everything looks good, commit
+git commit -m "Revert 'reduced functions in plotting_functions.ipynb'
+
+This restores the ~340 lines that were removed on January 10, 2026."
+
+# Push the branch
+git push origin restore-plotting-functions
+
+echo "Done! Create a pull request to merge restore-plotting-functions into main"
+```
+
+## Next Steps
+
+Please choose one of the options above and perform the restoration locally, or provide me with:
+1. The previous version of `plotting_functions.ipynb` file (from before January 10)
+2. Or instructions on which functions need to be restored
+
+Once you have the file or can access the repository history, the revert operation should be straightforward.