# eliezerdlr/menaxvi architecture

> Architecture diagram of the GitHub repository eliezerdlr/menaxvi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eliezerdlr/menaxvi
- Repository: https://github.com/eliezerdlr/menaxvi

## Overview

MENAXVI is a local, provider-neutral platform for governed AI-assisted professional workflows. An operator selects and validates a catalog workflow, supplies inputs to produce a plan, reviews and satisfies human approval gates, performs bounded work manually, and records results and evidence; failures can lead to bounded retry or rollback plans. The repository also provides multichannel campaign generation and a local customer dashboard. Edges are limited to README statements and source-index or excerpt evidence; unsampled integrations are not inferred.

Main entry points: [`tooling/menaxvi/dashboard.py`](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/dashboard.py) (Local Dashboard), [`core/dashboard_api.py`](https://github.com/eliezerdlr/menaxvi/blob/main/core/dashboard_api.py) (Dashboard Service), [`tooling/menaxvi/cli.py`](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/cli.py) (Workflow CLI), [`core/loader/catalog.py`](https://github.com/eliezerdlr/menaxvi/blob/main/core/loader/catalog.py) (Catalog Loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User Interfaces"]
  node_cli["Workflow CLI<br/>[cli.py]"]
  node_dashboard["Local Dashboard<br/>[dashboard.py]"]
  node_dashboard_html["Dashboard UI<br/>[dashboard.html]"]
  node_dashboard_api["Dashboard Service<br/>[dashboard_api.py]"]
end

subgraph group_workflow["Workflow Operations"]
  node_validator["Repository Validator<br/>[validator.py]"]
  node_manual["Manual Workflows<br/>[manual.py]"]
  node_campaign["Campaign Generator<br/>[campaign.py]"]
  node_recovery["Retry and Rollback<br/>[recovery.py]"]
end

subgraph group_governance["Governance Core"]
  node_policy["Policy Engine<br/>[engine.py]"]
  node_execution["Governed Execution<br/>[execution.py]"]
  node_evidence_log["Evidence Log<br/>[log.py]"]
end

subgraph group_resources["Catalog Resources"]
  node_catalog_loader["Catalog Loader<br/>[catalog.py]"]
  node_catalog_data["Canonical Catalog"]
  node_schemas["Resource Schemas<br/>[v1alpha1]"]
end

subgraph group_state["Persistence"]
  node_api_db[("Dashboard Database<br/>[dashboard_api.py]")]
  node_dashboard_store[("Dashboard State Store<br/>[dashboard.py]")]
  node_evidence_files["Evidence Files<br/>[dashboard_api.py]"]
end

node_operator(("Operator"))

node_operator -->|"invokes"| node_cli
node_operator -->|"uses"| node_dashboard
node_cli -->|"dispatches workflows"| node_manual
node_cli -->|"starts service"| node_dashboard
node_cli -->|"dispatches recovery"| node_recovery
node_cli -->|"dispatches validation"| node_validator
node_dashboard -.->|"serves UI"| node_dashboard_html
node_dashboard -->|"generates campaigns"| node_campaign
node_dashboard -->|"uses workflows"| node_manual
node_dashboard -->|"uses recovery"| node_recovery
node_dashboard_api -->|"loads catalog"| node_catalog_loader
node_dashboard_api -->|"renders plans"| node_manual
node_dashboard_api -->|"creates recovery plans"| node_recovery
node_catalog_loader -.->|"loads resources"| node_catalog_data
node_catalog_loader -.->|"validates resources"| node_schemas
node_execution -->|"evaluates requests"| node_policy
node_execution -->|"records events"| node_evidence_log
node_dashboard_api -->|"reads and writes"| node_api_db
node_dashboard_api -.->|"stores evidence"| node_evidence_files
node_dashboard -->|"persists state"| node_dashboard_store

click node_cli "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/cli.py"
click node_dashboard "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/dashboard.py"
click node_dashboard_html "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/dashboard.html"
click node_dashboard_api "https://github.com/eliezerdlr/menaxvi/blob/main/core/dashboard_api.py"
click node_validator "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/validator.py"
click node_manual "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/manual.py"
click node_campaign "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/campaign.py"
click node_recovery "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/recovery.py"
click node_catalog_loader "https://github.com/eliezerdlr/menaxvi/blob/main/core/loader/catalog.py"
click node_catalog_data "https://github.com/eliezerdlr/menaxvi/tree/main/catalog"
click node_schemas "https://github.com/eliezerdlr/menaxvi/tree/main/schemas/menaxvi.io/v1alpha1"
click node_policy "https://github.com/eliezerdlr/menaxvi/blob/main/core/policy/engine.py"
click node_execution "https://github.com/eliezerdlr/menaxvi/blob/main/core/evidence/execution.py"
click node_evidence_log "https://github.com/eliezerdlr/menaxvi/blob/main/core/evidence/log.py"
click node_api_db "https://github.com/eliezerdlr/menaxvi/blob/main/core/dashboard_api.py"
click node_dashboard_store "https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/dashboard.py"
click node_evidence_files "https://github.com/eliezerdlr/menaxvi/blob/main/core/dashboard_api.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_dashboard,node_dashboard_html,node_dashboard_api toneBlue
class node_validator,node_manual,node_campaign,node_recovery toneAmber
class node_policy,node_execution,node_evidence_log toneMint
class node_catalog_loader,node_catalog_data,node_schemas toneRose
class node_api_db,node_dashboard_store,node_evidence_files,node_operator toneIndigo
```

## Components

### User Interfaces

- [Workflow CLI](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/cli.py): `tooling/menaxvi/cli.py`
- [Local Dashboard](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/dashboard.py): `tooling/menaxvi/dashboard.py`
- [Dashboard UI](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/dashboard.html): `tooling/menaxvi/dashboard.html`
- [Dashboard Service](https://github.com/eliezerdlr/menaxvi/blob/main/core/dashboard_api.py): `core/dashboard_api.py`

### Workflow Operations

- [Repository Validator](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/validator.py): `tooling/menaxvi/validator.py`
- [Manual Workflows](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/manual.py): `tooling/menaxvi/manual.py`
- [Campaign Generator](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/campaign.py): `tooling/menaxvi/campaign.py`
- [Retry and Rollback](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/recovery.py): `tooling/menaxvi/recovery.py`

### Governance Core

- [Policy Engine](https://github.com/eliezerdlr/menaxvi/blob/main/core/policy/engine.py): `core/policy/engine.py`
- [Governed Execution](https://github.com/eliezerdlr/menaxvi/blob/main/core/evidence/execution.py): `core/evidence/execution.py`
- [Evidence Log](https://github.com/eliezerdlr/menaxvi/blob/main/core/evidence/log.py): `core/evidence/log.py`

### Catalog Resources

- [Catalog Loader](https://github.com/eliezerdlr/menaxvi/blob/main/core/loader/catalog.py): `core/loader/catalog.py`
- [Canonical Catalog](https://github.com/eliezerdlr/menaxvi/tree/main/catalog): `catalog`
- [Resource Schemas](https://github.com/eliezerdlr/menaxvi/tree/main/schemas/menaxvi.io/v1alpha1): `schemas/menaxvi.io/v1alpha1`

### Persistence

- [Dashboard Database](https://github.com/eliezerdlr/menaxvi/blob/main/core/dashboard_api.py): `core/dashboard_api.py`
- [Dashboard State Store](https://github.com/eliezerdlr/menaxvi/blob/main/tooling/menaxvi/dashboard.py): `tooling/menaxvi/dashboard.py`
- [Evidence Files](https://github.com/eliezerdlr/menaxvi/blob/main/core/dashboard_api.py): `core/dashboard_api.py`

### Other components

- **Operator**

## Connections

- Operator → Workflow CLI: invokes (evidence: `README.md`)
- Operator → Local Dashboard: uses (evidence: `README.md`)
- Workflow CLI → Manual Workflows: dispatches workflows (evidence: `tooling/menaxvi/cli.py`)
- Workflow CLI → Local Dashboard: starts service (evidence: `tooling/menaxvi/cli.py`)
- Workflow CLI → Retry and Rollback: dispatches recovery (evidence: `tooling/menaxvi/cli.py`)
- Workflow CLI → Repository Validator: dispatches validation (evidence: `tooling/menaxvi/cli.py`)
- Local Dashboard → Dashboard UI: serves UI
- Local Dashboard → Campaign Generator: generates campaigns (evidence: `tooling/menaxvi/dashboard.py`)
- Local Dashboard → Manual Workflows: uses workflows (evidence: `tooling/menaxvi/dashboard.py`)
- Local Dashboard → Retry and Rollback: uses recovery (evidence: `tooling/menaxvi/dashboard.py`)
- Dashboard Service → Catalog Loader: loads catalog (evidence: `core/dashboard_api.py`)
- Dashboard Service → Manual Workflows: renders plans (evidence: `core/dashboard_api.py`)
- Dashboard Service → Retry and Rollback: creates recovery plans (evidence: `core/dashboard_api.py`)
- Catalog Loader → Canonical Catalog: loads resources
- Catalog Loader → Resource Schemas: validates resources
- Governed Execution → Policy Engine: evaluates requests (evidence: `core/evidence/execution.py`)
- Governed Execution → Evidence Log: records events (evidence: `core/evidence/execution.py`)
- Dashboard Service → Dashboard Database: reads and writes (evidence: `core/dashboard_api.py`)
- Dashboard Service → Evidence Files: stores evidence (evidence: `core/dashboard_api.py`)
- Local Dashboard → Dashboard State Store: persists state (evidence: `tooling/menaxvi/dashboard.py`)
