# Maat Domain Reference

Generated on May 8, 2026. This folder is the uniform Oshun-local documentation
home for the Maat domain.

## Executive Summary

**Named for Maat (𓁦)** — Egyptian goddess of cosmic order, truth, balance, and
justice, who weighs the hearts of the dead against her feather of truth. Maat
embodies the fundamental principle that society cannot function without order,
and that every organization must be governed by truth, transparency, and
balanced judgment.

## Documentation Contract

- [Feature Inventory](feature-inventory.md)
- [Implementation Map](implementation-map.md)

## Domain Profile

- Domain slug: `maat`
- Display name: Maat
- Aliases: None
- TODO phase coverage: `55`
- TODO phase titles: `Maat - Autonomous Organization Operating System`
- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: Referenced in Oshun apps, libraries, or docs.
- Source confidence: Implementation-backed

## Evidence Profile

| Source                    | Status  | Notes                                  |
| ------------------------- | ------- | -------------------------------------- |
| Repository implementation | present | 30 app/lib/service entries discovered  |
| Standalone domain docs    | absent  | 0 entries under docs/domains/maat      |
| TODO phase coverage       | present | 1 mapped phase(s), 352 checklist items |
| Tests                     | absent  | 0 matching test files discovered       |
| Oshun integration         | present | 1 Oshun-local references discovered    |

## Capability Pillars

| Capability Pillar                                          | Primary Source    | Status                           |
| ---------------------------------------------------------- | ----------------- | -------------------------------- |
| Directory Structure & Nx Configuration                     | TODOS.md phase 55 | planned-or-partially-implemented |
| Database & Storage Setup                                   | TODOS.md phase 55 | planned-or-partially-implemented |
| Environment & Docker Configuration                         | TODOS.md phase 55 | planned-or-partially-implemented |
| Event Bus & API Gateway                                    | TODOS.md phase 55 | planned-or-partially-implemented |
| Organization & Company Types                               | TODOS.md phase 55 | planned-or-partially-implemented |
| Strategic & Operational Types                              | TODOS.md phase 55 | planned-or-partially-implemented |
| Agent & Intelligence Types                                 | TODOS.md phase 55 | planned-or-partially-implemented |
| Zod Schemas & Validation                                   | TODOS.md phase 55 | planned-or-partially-implemented |
| Market Monitoring & Data Ingestion                         | TODOS.md phase 55 | planned-or-partially-implemented |
| Competitive Intelligence                                   | TODOS.md phase 55 | planned-or-partially-implemented |
| Sentiment & Trend Analysis                                 | TODOS.md phase 55 | planned-or-partially-implemented |
| LLM-Powered Analysis & Reporting                           | TODOS.md phase 55 | planned-or-partially-implemented |
| Strategic Analysis Frameworks                              | TODOS.md phase 55 | planned-or-partially-implemented |
| Advanced Strategic Tools                                   | TODOS.md phase 55 | planned-or-partially-implemented |
| Scenario Planning & Simulation                             | TODOS.md phase 55 | planned-or-partially-implemented |
| Capital Allocation & Portfolio Optimization                | TODOS.md phase 55 | planned-or-partially-implemented |
| Agent Registry & Lifecycle                                 | TODOS.md phase 55 | planned-or-partially-implemented |
| Specialized Agent Types                                    | TODOS.md phase 55 | planned-or-partially-implemented |
| Task Decomposition & Execution                             | TODOS.md phase 55 | planned-or-partially-implemented |
| Human-in-the-Loop & Performance                            | TODOS.md phase 55 | planned-or-partially-implemented |
| Valuation & Investment Analysis                            | TODOS.md phase 55 | planned-or-partially-implemented |
| Financial Statements & Forecasting                         | TODOS.md phase 55 | planned-or-partially-implemented |
| FX & Treasury Management                                   | TODOS.md phase 55 | planned-or-partially-implemented |
| Tax & Financial Compliance                                 | TODOS.md phase 55 | planned-or-partially-implemented |
| Supplier Mapping & Risk Assessment                         | TODOS.md phase 55 | planned-or-partially-implemented |
| Inventory & Logistics Optimization                         | TODOS.md phase 55 | planned-or-partially-implemented |
| Procurement & Demand Planning                              | TODOS.md phase 55 | planned-or-partially-implemented |
| Trade & Tariff Optimization                                | TODOS.md phase 55 | planned-or-partially-implemented |
| State Model & Data Ingestion                               | TODOS.md phase 55 | planned-or-partially-implemented |
| Cascade & Impact Analysis                                  | TODOS.md phase 55 | planned-or-partially-implemented |
| Temporal Simulation Engine                                 | TODOS.md phase 55 | planned-or-partially-implemented |
| Optimization & Visualization                               | TODOS.md phase 55 | planned-or-partially-implemented |
| Ghana Regulatory Database                                  | TODOS.md phase 55 | planned-or-partially-implemented |
| Compliance Monitoring & Calendar                           | TODOS.md phase 55 | planned-or-partially-implemented |
| Anti-Corruption & ESG                                      | TODOS.md phase 55 | planned-or-partially-implemented |
| Data Protection & IP Management                            | TODOS.md phase 55 | planned-or-partially-implemented |
| Document Ingestion & Processing                            | TODOS.md phase 55 | planned-or-partially-implemented |
| Knowledge Graph Construction                               | TODOS.md phase 55 | planned-or-partially-implemented |
| Semantic Search & Retrieval                                | TODOS.md phase 55 | planned-or-partially-implemented |
| Knowledge Quality & Freshness                              | TODOS.md phase 55 | planned-or-partially-implemented |
| Project Lifecycle Management                               | TODOS.md phase 55 | planned-or-partially-implemented |
| Risk Assessment & Monitoring                               | TODOS.md phase 55 | planned-or-partially-implemented |
| Investment & Treasury Management                           | TODOS.md phase 55 | planned-or-partially-implemented |
| Organizational & Talent Planning                           | TODOS.md phase 55 | planned-or-partially-implemented |
| Report Engine & Dashboards                                 | TODOS.md phase 55 | planned-or-partially-implemented |
| SDK & Tooling                                              | TODOS.md phase 55 | planned-or-partially-implemented |
| Maat ↔ Asase (Food & Agriculture) Synergies                | TODOS.md phase 55 | planned-or-partially-implemented |
| Maat ↔ Freya (Luxury & Fashion) Synergies                  | TODOS.md phase 55 | planned-or-partially-implemented |
| Maat ↔ Cybele (Real Estate & Construction) Synergies       | TODOS.md phase 55 | planned-or-partially-implemented |
| Maat ↔ Brigid (Industrial Automation) Synergies            | TODOS.md phase 55 | planned-or-partially-implemented |
| Maat ↔ Saraswati (Advanced Technology) Synergies           | TODOS.md phase 55 | planned-or-partially-implemented |
| Maat ↔ Iris (AI Assistant) Synergies                       | TODOS.md phase 55 | planned-or-partially-implemented |
| Maat ↔ Aje (Blockchain) Synergies                          | TODOS.md phase 55 | planned-or-partially-implemented |
| apps/maat/dashboard - Executive Dashboard                  | TODOS.md phase 55 | planned-or-partially-implemented |
| apps/maat/war-room - Strategic Planning Interface          | TODOS.md phase 55 | planned-or-partially-implemented |
| apps/maat/intel - Competitive Intelligence Browser         | TODOS.md phase 55 | planned-or-partially-implemented |
| apps/maat/agent-console - Agent Orchestration & Monitoring | TODOS.md phase 55 | planned-or-partially-implemented |
| apps/maat/investor - Capital Deployment Advisor            | TODOS.md phase 55 | planned-or-partially-implemented |
| apps/maat/api - Backend API Gateway                        | TODOS.md phase 55 | planned-or-partially-implemented |
| State-of-the-Art AI & Analytics Integration                | TODOS.md phase 55 | planned-or-partially-implemented |

## Coverage Snapshot

- Code footprint entries: 30
- Standalone domain doc entries: 0
- OpenAPI/API doc entries: 0
- Test evidence files: 0
- Oshun-specific references: 1

## Source Precedence

1. Actual repository implementation under `apps/`, `libs/`, `services/`, and
   `openapi/`
2. Checklist-derived scope from `TODOS.md`
3. Existing standalone domain docs under `docs/domains/maat/`
4. No feature claims are introduced without one of the sources above
