| # UNIFICATION BLUEPRINT: PROJECT DRIFT |
| **Target:** Consolidate `infj_bot`, `DRIFT`, and `hive_mind` into a single, cohesive 5-layer organism. |
| **Date Initiated:** May 2026 |
|
|
| ## 1. The Executive Mandate |
| We are moving from three isolated, overlapping codebases into a single robust product. |
| - `infj_bot` owns the Interface and Tools. It is the destination shell. |
| - `DRIFT` (`/core/*`) owns canonical Cognition. It is the subconscious. |
| - `hive_mind` owns Coordination. It is the distributed frontal lobe. |
|
|
| ## 2. The 5-Layer Target Architecture |
| 1. **Interface Layer:** cli.py, api.py, web_app.py, mcp_server.py |
| 2. **Cognition Layer:** DRIFT core (being, embodiment, homeostasis, global workspace) |
| 3. **Coordination Layer:** Hive threads, consensus, multi-role review, planning |
| 4. **Memory Layer:** Unified hierarchy (Working, Episodic, Semantic/ChromaDB, Shared Hive) |
| 5. **Tool / Safety Layer:** One permission model, one audit log, one rollback story |
|
|
| ## 3. Module Ownership & Cut Lines |
| | Module / Capability | Target Owner | Action Plan | |
| | :--- | :--- | :--- | |
| | **Interface (CLI/API/Web)** | `infj_bot` | Keep in place. Stabilize public routes. | |
| | **User Commands** | `infj_bot` | Keep in place. Route internal calls to adapters. | |
| | **Cognition (Being/Emotion)** | `DRIFT` | Import to `infj_bot`. Wrap duplicate modules as facades, then retire. | |
| | **Embodiment & Homeostasis** | `DRIFT` | Import to `infj_bot` as canonical source of truth. | |
| | **Coordination (Hive/DCP)**| `hive_mind`| Keep `hive_mind/` inside `infj_bot`. Wire to planning. | |
| | **Memory (Semantic/Episodic)**| **UNIFIED** | Merge `infj_bot` memory + `DRIFT` memory into one ChromaDB/SQLite spine. | |
| | **Tools (Nuclei/ffuf etc.)** | **UNIFIED** | Create one unified tool registry in `infj_bot`. | |
|
|
| ## 4. The Surgical Phases |
| * **Phase 0 (Freeze):** `infj_bot` declared destination. No simultaneous feature development. |
| * **Phase 1 (Compatibility Spine):** Introduce adapter modules. No immediate rewrites. |
| * **Phase 2 (Unify State):** Choose ONE config contract and ONE data root policy. Prevent dual-write database corruption. |
| * **Phase 3 (Pick Canonical):** `drift/core/` overrides duplicate `infj_bot` cognition modules. |
| * **Phase 4 (Unify Memory):** Merge ChromaDB and SQLite paths into a single hierarchical memory system. |
| * **Phase 5 (First-Class Hive):** Route all high-risk or planning actions through Propose -> Critique -> Integrate -> Resolve. |
| * **Phase 6 (Unify Tools/Safety):** One audit log, one rollback system. |
| * **Phase 7 (Consolidate API):** Expose all 5 layers through `infj_bot/api.py`. |
| * **Phase 8 (Retire):** Delete the shadow copies/facades after runtime test parity. |
|
|
| ## 5. Absolute Safety Rules |
| 1. **No destructive data migration without snapshots.** |
| 2. **Keep the old module behind an adapter until the new path passes all tests.** |
| 3. **No simultaneous replacement of Memory, Brain, and Tools in a single phase.** |
| 4. **Verify every phase with:** Unit tests, 1 CLI flow, 1 API flow, 1 Hive proposal flow, 1 Memory retrieval flow. |
