Release 0.7.13
Release Notes - Paideia LMS v0.7.13
Release Date: January 10, 2026
Version: 0.7.13
Type: Critical Bug Fix
Impact: High - Fixes critical issue preventing sandbox database reset from working correctly
Changelog: N/A
Overview
Paideia LMS v0.7.13 is a critical bug fix release that resolves a critical issue with the sandbox database reset functionality introduced in v0.7.12. This release fixes a bug that prevented the first user from being registered during the sandbox reset process, causing the entire reset operation to fail. Users are strongly urged to upgrade to v0.7.13 immediately if they are using sandbox mode.
Critical Bug Fix
🔧 Sandbox Reset First User Registration
Bug Fix: Fixed sandbox database reset failing to register the first user, causing the entire reset process to fail with "Failed to register first user" error.
What Was Wrong:
- Sandbox reset was failing during the seed process when attempting to register the first admin user
- The
tryRegisterFirstUserfunction was missing thereqparameter in the user existence check - This caused the function to fail when checking if users already exist in the system
- Sandbox reset would fail with error: "Failed to register first user. There can be bugs with this version. Please turn off sandbox mode and try the normal mode."
- Database would remain in an inconsistent state after failed reset
What Changed:
- Added missing
reqparameter topayload.findcall intryRegisterFirstUserfunction - User existence check now properly uses the transaction context
- First user registration now works correctly during sandbox reset
- Sandbox reset process completes successfully and seeds fresh data
Technical Details:
- Fixed
tryRegisterFirstUserto passreqparameter topayload.findwhen checking for existing users - Ensures the user existence check runs within the proper request context
- First user registration now completes successfully within the transaction
Impact:
- ✅ Sandbox mode now correctly resets and seeds database on startup
- ✅ First admin user is properly created during seed process
- ✅ Sandbox reset completes successfully without errors
- ✅ Sandbox environment works as intended
Error Message Before Fix:
⚠️ seed.json not found in project root, using predefined test data
🌱 Checking if database needs seeding...
🌱 Database is fresh, starting seed process...
📦 Creating Users
👤 Creating admin user...
❌ Failed to reset sandbox database: Failed to register first user. There can be bugs with this version. Please turn off sandbox mode and try the normal mode.
Summary
This release fixes a critical bug that prevented sandbox database reset from working correctly:
Bug Fixes
- ✅ Sandbox reset now correctly registers the first admin user
- ✅ Seed process completes successfully after database reset
- ✅ Request context properly passed to user existence check
- ✅ Sandbox environment fully functional
Breaking Changes
None
This release maintains full backward compatibility:
- ✅ All existing functionality works exactly as before
- ✅ No API changes
- ✅ No configuration changes required
- ✅ No database migrations needed
- ✅ No user-facing breaking changes
Upgrade Instructions
⚠️ URGENT: Upgrade Immediately if Using Sandbox Mode
If you are using sandbox mode, you must upgrade to v0.7.13 immediately. The bug in v0.7.12 prevents sandbox reset from working correctly, which can cause the application to fail on startup.
From v0.7.12
-
Upgrade to v0.7.13:
git pull origin next # or your branch -
Install dependencies:
bun install
-
Start the server:
bun run dev
No Additional Steps Required:
- No database migrations needed
- No configuration changes required
- No manual data migration needed
- Everything works automatically after upgrade
For Sandbox Mode Users:
- After upgrading, the sandbox reset will work correctly
- The first admin user will be created successfully
- Database will be properly seeded with fresh data
- No manual intervention required
What's Next
This release ensures sandbox mode works correctly for development and testing:
- Reliable Sandbox Reset: Database reset now works as expected
- Proper Seed Process: First user registration completes successfully
- Stable Development Environment: Sandbox mode is fully functional
- Continued Improvements: Ongoing enhancements to sandbox functionality
The fix in this release makes sandbox mode reliable for development and testing, ensuring that developers can reset their database and start with fresh seed data without issues.
Thank You
Thank you for using Paideia LMS. This release fixes a critical bug that affected sandbox mode functionality. We strongly recommend upgrading to v0.7.13 immediately if you are using sandbox mode, as v0.7.12 has a bug that prevents the sandbox reset from working correctly.
For questions, issues, or contributions, please visit our GitHub repository: https://github.com/paideia-lms/paideia
Complete Changelog Reference
This release includes the following improvements:
Bug Fixes
- Sandbox Reset First User Registration: Fixed missing
reqparameter intryRegisterFirstUserfunction - User Existence Check: Fixed user existence check to use proper request context
- Sandbox Reset Completion: Sandbox reset now completes successfully
Previous Release: See v0.7.12 Release Notes for previous features.