860e36a688
Memory System: - Add category-based memory storage (company, tech, role, location, server) - Silent background saving via saveMemorySilently() - Category-based overwrite (same category replaces old memory) - Server-related pattern detection (AWS, GCP, k8s, traffic info) - Memory management tool (list, delete) Troubleshoot Agent: - Session-based troubleshooting conversation (KV, 1h TTL) - 20-year DevOps/SRE expert persona - Support for server/infra, domain/DNS, code/deploy, network, database issues - Internal tools: search_solution (Brave), lookup_docs (Context7) - Auto-trigger on error-related keywords - Session completion and cancellation support Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Database Migrations
This directory contains database migration scripts for the Telegram Bot Workers project.
Files
| File | Purpose |
|---|---|
001_schema_enhancements.sql |
Migration script - adds CHECK constraints and audit logging |
001_rollback.sql |
Rollback script - reverts migration 001 |
AUDIT_LOG_EXAMPLES.ts |
TypeScript examples for using audit logs |
TEST_RESULTS.md |
Local test results and verification |
README.md |
This file |
Quick Start
Local Testing
# Initialize local database
npm run db:init:local
# Add test data
wrangler d1 execute telegram-conversations --local \
--command "INSERT INTO users (telegram_id, username) VALUES ('123', 'test')"
# Run migration
wrangler d1 execute telegram-conversations --local \
--file migrations/001_schema_enhancements.sql
# Verify constraints work
wrangler d1 execute telegram-conversations --local \
--command "INSERT INTO user_deposits (user_id, balance) VALUES (999, -1000)"
# Expected: CHECK constraint failed
Production Deployment
⚠️ MANDATORY: Read SCHEMA_MIGRATION_GUIDE.md first
# 1. Backup database
wrangler d1 execute telegram-conversations \
--command ".dump" > backup_$(date +%Y%m%d_%H%M%S).sql
# 2. Run migration
wrangler d1 execute telegram-conversations \
--file migrations/001_schema_enhancements.sql
# 3. Verify success
wrangler d1 execute telegram-conversations \
--command "SELECT 'Migration completed' as status, datetime('now') as timestamp"
Migration 001: Schema Enhancements
Date: 2026-01-19
Changes
- user_deposits: Add
balance >= 0CHECK constraint - deposit_transactions: Add
depositor_namelength <= 50 CHECK constraint - audit_logs: Create new table for operation tracking
Benefits
- Prevent negative balances at database level
- Enforce depositor name length limit
- Track all critical operations for compliance and debugging
- Improved data integrity and auditability
Risk Level
- Low: No breaking changes to application code
- No downtime: Migration completes in < 1 second for typical datasets
- Reversible: Rollback script available
Files
- Migration:
001_schema_enhancements.sql - Rollback:
001_rollback.sql - Guide:
../SCHEMA_MIGRATION_GUIDE.md - Examples:
AUDIT_LOG_EXAMPLES.ts - Tests:
TEST_RESULTS.md
Documentation
For detailed information, see:
- SCHEMA_MIGRATION_GUIDE.md: Complete deployment guide
- TEST_RESULTS.md: Local test results and verification
- AUDIT_LOG_EXAMPLES.ts: Usage examples for audit logs
Support
If issues occur during migration:
- Check logs:
wrangler tail - Review SCHEMA_MIGRATION_GUIDE.md troubleshooting section
- Rollback if necessary:
001_rollback.sql - Restore from backup if critical failure