BAZINGA-DB (Deprecated Router)

BAZINGA-DB (Deprecated Router)

This skill is deprecated. Use domain-specific skills instead:

Command Routing Table

Quick Reference

⚠️ DO NOT use CLI directly. Instead, invoke the domain-specific skill:

Reference docs (for skill authors only):

• Schema: .claude/​skills/​bazinga-db/​references/​schema.md
• Examples: .claude/​skills/​bazinga-db/​references/​command_examples.md

If You're Here By Mistake

1. Identify what you're trying to do
2. Invoke the correct domain skill:
   • Session ops? → Skill(command: "bazinga-db-core")
   • Task groups? → Skill(command: "bazinga-db-workflow")
   • Logging/​reasoning? → Skill(command: "bazinga-db-agents")
   • Context packages? → Skill(command: "bazinga-db-context")

Migration Notes

The original monolithic bazinga-db skill (v1.x, 887 lines) has been split into 4 domain-focused skills for better maintainability and to stay within file size limits.

All scripts remain in this directory:

• scripts/​bazinga_db.py - Main CLI (unchanged)
• scripts/​init_db.py - Database initialization
• scripts/​init_session.py - Session creation helper

All references remain in this directory:

• references/​schema.md - Full database schema
• references/​command_examples.md - Detailed command examples

Technical Notes

Event Idempotency (v17+)

Events support idempotency keys via idx_logs_idempotency unique index:

• Index: (session_id, event_subtype, group_id, idempotency_key) WHERE idempotency_key IS NOT NULL AND log_type = 'event'
• Pattern: INSERT-first, catch IntegrityError, return existing row
• Recommended key format: {session_id}|{group_id}|{event_type}|{iteration}

Group ID Validation (v18+)

Three explicit validators for group_id scope (See: research/​domain-skill-migration-phase6-ultrathink.md):

Reserved identifiers (cannot be used as task_group_id): global, session, all, default

Legacy Data Diagnostic

# Scan for invalid group_ids (CI/​CD)
python3 .claude/​skills/​bazinga-db/​scripts/​bazinga_db.py diagnose-group-ids

# Auto-fix issues
python3 .claude/​skills/​bazinga-db/​scripts/​bazinga_db.py diagnose-group-ids --fix