Files
proffesor-for-testing__agen…/v2/docs/database/MIGRATION-QUICKSTART.md
Profa fd2f37eaa0 fix(v3): update README claims and init hooks to use correct package name
Changes:
- Fix README.md agent counts (48 QE agents = 41 main + 7 subagents)
- Fix README.md skill counts (15 QE-specific skills)
- Fix v3/README.md agent counts (47 → 48)
- Fix init-wizard.ts hooks from 'npx @agentic-qe/v3' to 'npx agentic-qe'
- Complete v2 → v2/ folder reorganization (54 items moved)
- Update root package.json to point to v3 as main version

Verified claims:
- 48 QE agents (41 main + 7 TDD subagents)
- 15 QE-specific skills
- 12 DDD bounded contexts
- ~5,600+ tests
- HNSW, ReasoningBank, Queen Coordinator features exist

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 18:03:40 +00:00

2.8 KiB

AgentDB Migration - Quick Start

TL;DR

Database migration from agentdb.db → .agentic-qe/agentdb.db is COMPLETE ✅

All 3,710 records migrated successfully with full integrity verification.


For Users

✅ Already Migrated

The migration has been completed. Your database is now at:

.agentic-qe/agentdb.db

🔍 Verify Migration

# Check database exists
ls -lh .agentic-qe/agentdb.db

# Count records
sqlite3 .agentic-qe/agentdb.db "SELECT COUNT(*) FROM episodes"
# Expected: 1853+

📚 Documentation


For Developers

🔄 Re-run Migration

# Preview changes (no actual migration)
npm run migrate:dry-run

# Run migration
npm run migrate:agentdb

# Rollback if needed
npm run migrate:rollback

📝 Migration Features

✅ SHA-256 checksum verification ✅ Automatic backups (timestamped) ✅ Schema v2.0 enhancements (indexes, metadata) ✅ Rollback capability ✅ Dry-run mode ✅ Progress reporting

🗂️ Files Changed

Scripts:

  • scripts/migrate-to-agentdb.ts (migration)
  • scripts/rollback-migration.ts (rollback)

Configuration:

  • src/core/memory/AgentDBManager.ts (default path updated)
  • src/agents/BaseAgent.ts (default path updated)
  • package.json (npm scripts added)

Database:

  • Old: agentdb.db (root)
  • New: .agentic-qe/agentdb.db (✅ migrated)

Quick Commands

# Run migration
npm run migrate:agentdb

# Preview without changes
npm run migrate:dry-run

# Rollback to backup
npm run migrate:rollback

# Verify database
sqlite3 .agentic-qe/agentdb.db "PRAGMA integrity_check"

Backup Files

Located in project root:

agentdb.db.backup.1763295861777  (4.7 MB)
agentdb.db.backup.1763296315616  (4.7 MB)
agentdb.db.backup.1763296417497  (4.7 MB)

Keep for 30 days, then safe to delete.


What Changed?

Database Location

Before After
agentdb.db .agentic-qe/agentdb.db

Schema Enhancements (v2.0)

✅ Performance Indexes - 10-100x faster queries ✅ Metadata Columns - Enhanced tracking ✅ Database Optimization - ANALYZE + VACUUM

Configuration Updates

// Old default path
dbPath: '.agentdb/reasoningbank.db'

// New default path
dbPath: '.agentic-qe/agentdb.db'

Need Help?

  1. Read: Migration Guide
  2. Check: Migration Summary
  3. Rollback: npm run migrate:rollback
  4. Support: Open GitHub issue

Status

✅ Migration Complete ✅ Data Verified (3,710 records) ✅ Checksums Match ✅ Rollback Tested ✅ Production Ready

Last Updated: 2025-11-16