solomon-njogo/ChamaDispute

AI-powered mediator for Kenyan Chamas. Resolves member disputes by analyzing bylaws, M-Pesa statements, and contribution logs. Built with Vertex AI, RAG, and Gemini. Supports English, Kiswahili, and Sheng. # Msuluhishi - Umoja Chama AI Arbitrator **Msuluhishi** (The Arbitrator) is a professional AI mediation platform designed to resolve disputes within "Chamas" (informal savings and credit groups) in East Africa. By combining real-time financial records with a group's specific bylaws, it provides neutral, evidence-based advisory rulings. ## ⚖️ The Problem Chamas are essential financial vehicles for millions, yet they are often plagued by internal friction. Lack of transparency in records, complex bylaw interpretations, and perceived bias in leadership decisions can lead to "drama" and group dissolution. Members need a neutral third party that "knows the rules" and "sees the books" to provide instant clarity during heated meetings. ## 🏗️ Agent Architecture ### The Core Agent: Msuluhishi Adjudicator The system is powered by a high-reasoning Gemini 1.5 Flash agent configured as a **Neutral Arbitrator and Treasurer's Assistant**. ### Tools & Capabilities * **Knowledge Base Integration**: Automatically parses and contextualizes multiple data sources: * `bylaws_umoja_chama.md`: The governing "Constitution" of the group. * `contribution_ledger_2024.csv`: Real-time payment tracking. * `loan_register_2024.csv`: Historical and current debt status. * `dispute_log_2024.csv`: Case history for legal precedent. * **Linguistic Fluidity**: A multi-lingual prompt engine that handles inputs in **English**, **Kiswahili**, and **Sheng**, ensuring inclusivity for all members. * **Contextual Streaming**: A custom Express middleware that streams Adjudication reports token-by-token, providing a responsive "live reasoning" experience. ### Communication Flow 1. **Selection**: Member selects an "Active Case" from the Dashboard. 2. **Context Assembly**: The server reads the entire `/data` directory, caches the records, and injects relevant CSV/MD snippets into the prompt. 3. **Adjudication**: Gemini analyzes the dispute against the specific Article numbers in the bylaws. 4. …