BrainDrive v0.4.5 – Persona System, Unified Plugin Installer, and Migration Overhaul

🧠 BrainDrive v0.4.5 – Persona System, Unified Plugin Installer, and Migration Overhaul

Release Date: 2025-07-14
Version: 0.4.5

---

🚀 Highlights

This release introduces powerful new features and critical backend improvements:

• ✅ Persona System for reusable, customizable AI behavior
• ✅ Unified Plugin Installer with support for GitHub & local uploads
• ✅ Safe Alembic Migration Chain with validation tooling & CI support

---

🧩 Persona System Integration

Define AI behavior profiles and seamlessly reuse them across conversations.

🔧 Backend Features

• Full CRUD API:
  GET /personas, POST /personas, PUT /personas/{id}, DELETE /personas/{id}, etc.
• Enhancements to chat_completion():
  • Inject system prompt from persona
  • Apply custom model settings
  • Link conversation metadata to persona
• Sample greeting support on conversation start
• New endpoints:
  • GET /conversations/by-persona/{id}
  • PUT /conversations/{id}/persona
  • GET /conversations/{id}/with-persona

🖥️ Frontend

• New route: /personas
• Pages:
  • PersonasPage (Grid view)
  • PersonaFormPage (Create/Edit)
• Components:
  • PersonaCard, PersonaForm, DeleteConfirmationDialog
• Hook: usePersonas for data management
• Navigation auto-updated via migration

🧪 Validated

• Persona-based prompt injection in chat
• Sample greetings
• UI tests for persona management

---

🔌 Unified Plugin Installer

Seamless plugin installation via GitHub repo or local file upload.

⚙️ Backend

• New endpoint:
  POST /api/v1/plugins/install (method = github | local-file)
• Supports:
  • GitHub repo cloning or release/tag download
  • Archive upload (.zip, .tar.gz, .rar placeholder)
• Handles:
  • Extraction
  • Validation
  • Installation
  • Metadata indexing

🖼️ Frontend

• InstallMethodTabs UI with:
  • GitHub Install
  • Local File Upload (drag-and-drop)
• FileUploadZone component with:
  • Format detection
  • File size validation
  • Upload previews
• Visual progress flow & dynamic step control

🧪 Validated

• GitHub installs from repo and tag
• ZIP/TAR file installs
• Size/format error handling

---

🛠️ Alembic Migration Chain Fix & Tooling

Critical refactor to prevent migration corruption and improve dev confidence.

🧱 Safe Migrations

• Wrapped all upgrade() / downgrade() logic with conditional checks
• Prevents duplicate index/table/column creation
• Repaired broken or missing Alembic down_revision links

🧰 Tooling & CI Support

• New CLI support:
  • Makefile
  • migrate.bat for Windows
• New scripts:
  • validate_migrations.py
  • test_migrations.py
  • migration_monitor.py
  • migration_recovery.py
• Pre-commit hooks:
  • Alembic file checks
  • Black / Flake8 linting
• migration_health_history.json snapshot tracking

📊 Migration Health Snapshot