Release v1.0.4 — The Guardian Protocol

Release v1.0.4 — The Guardian Protocol

Modern tools promise speed, but often just accelerate environment destruction. This release introduces the ultimate undo button for your Python workspace: omnipkg revert.

omnipkg now functions as a guardian for your environment. After every successful omnipkg operation, it automatically saves a “last known good” snapshot. If you ever make a mistake with another package manager, omnipkg can now restore your environment to its last pristine state in seconds.

✨ Highlights

• ↩️ Introducing omnipkg revert: A new top-level command to instantly restore your environment from damage.
• 📸 Automatic Environment Snapshots: Every successful omnipkg operation now automatically creates a recovery point.
• ❤️‍🩹 Self-Healing Workflow: omnipkg is no longer just a preventative tool; it can now actively repair damage done by others.

💥 The Proof: Reverting a High-Speed Disaster

Let’s see it in action.

Step 1: Create a Complex “Last Known Good” State

First, we'll demonstrate omnipkg's core intelligence. We'll install an older version of a package, forcing the Downgrade Protection to activate and create our snapshot.

# We ask omnipkg to install an older version over a newer one.
$ omnipkg install flask-login==0.4.1```
Instead of failing, `omnipkg` performs surgery:
```bash
# It detects the conflict and activates its core feature.
🛡️  DOWNGRADE PROTECTION ACTIVATED!
    -> Fixing downgrade: flask-login from v0.6.3 to v0.4.1
🫧 Creating isolated bubble for flask-login v0.4.1
    📊 Space efficiency: 55.5% saved.
    🔄 Restoring 'flask-login' to safe version v0.6.3 in main environment...
✅ Environment protection complete!

# Finally, it saves the perfect state as our recovery point.
📸 Saving snapshot of the current environment as 'last known good'...
   ✅ Snapshot saved.

At the end of this operation, our environment is pristine: flask-login==0.6.3 is active, and the older 0.4.1 is safely isolated in a bubble.

Step 2: The “Accident” with uv

Now, we simulate a user accidentally using uv to downgrade the package.

$ uv pip install flask-login==0.4.1
Uninstalled 1 package in 0.41ms
Installed 1 package in 2ms
 - flask-login==0.6.3
 + flask-login==0.4.1

# Fast? Yes. Correct? No. The environment is now broken.

Step 3: The Guardian Protocol

With the environment in a damaged state, we call on omnipkg to fix it.

$ omnipkg revert

# omnipkg loads the snapshot and instantly knows what's wrong.
⚖️  Comparing current environment to the last known good snapshot...

📝 The following actions will be taken to restore the environment:
  - Fix Version: flask-login==0.6.3

🤔 Are you sure you want to proceed? (y/N): y

# It executes the plan with surgical precision.
🚀 Starting revert operation...
# ... (omnipkg uninstalls the wrong version and installs the right one) ...
✅ Environment successfully reverted to the last known good state.

The Final State: Perfection

A final check confirms the environment has been perfectly restored.

$ omnipkg info flask-login

📋 KEY DATA for 'flask-login':
----------------------------------------
🎯 Active Version: 0.6.3
🫧 Bubbled Versions: 0.4.1

The magic is in the details: omnipkg not only restored the correct active version (0.6.3) but also ensured the bubbled version (0.4.1) was still perfectly preserved. It has a complete memory of the ideal state, ensuring your workflow continues uninterrupted.

---

This isn’t just a new feature; it’s peace of mind. You can now work, knowing that omnipkg always has your back.