# cnvertbleweathr/life-os-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/cnvertbleweathr/life-os-2026
- Repository: https://github.com/cnvertbleweathr/life-os-2026

## Overview

ONS is a personal analytics platform: domain data is ingested, shaped into analytics marts, served through a read-only FastAPI layer, and presented in a Next.js dashboard; OpenClaw adds generated briefs and sports narratives. Users move from the dashboard’s domain pages or daily check-in to API-backed results. The README documents broader ingestion and analytics capabilities than the sampled code shows; those links are shown where documented, without implying unsampled call details.

Main entry points: [`api/main.py`](https://github.com/cnvertbleweathr/life-os-2026/blob/main/api/main.py) (DuckDB warehouse), [`openclaw/orchestrator.py`](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/orchestrator.py) (OpenClaw runner), [`pipelines`](https://github.com/cnvertbleweathr/life-os-2026/tree/main/pipelines) (Domain pipelines), [`openclaw/analyzers/morning_brief.py`](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/analyzers/morning_brief.py) (Morning brief)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingestion["Data ingestion"]
  node_daily_sync["Daily sync<br/>[daily_sync.py]"]
  node_domain_pipelines["Domain pipelines"]
end

subgraph group_intelligence["Analytics and AI"]
  node_warehouse[("DuckDB warehouse<br/>[main.py]")]
  node_dbt_marts[("Analytics marts")]
  node_openclaw_runner["OpenClaw runner<br/>[orchestrator.py]"]
  node_brief_analyzer["Morning brief<br/>[morning_brief.py]"]
  node_weekly_analyzer["Weekly recap<br/>[weekly_recap.py]"]
  node_cfb_analyzer["CFB narratives<br/>[cfb_narratives.py]"]
  node_openclaw_db["OpenClaw data access<br/>[db.py]"]
  node_rbac["Read policy<br/>[policy.py]"]
  node_audit["Generation audit<br/>[audit.py]"]
end

subgraph group_serving["API serving"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_api_deps["Query helpers<br/>[deps.py]"]
  node_api_routers["Domain routers"]
end

subgraph group_experience["Dashboard"]
  node_web_api["API client<br/>[api.ts]"]
  node_web_pages["Dashboard pages"]
  node_checkin["Daily check-in<br/>[page.tsx]"]
end

node_user(("User"))
node_external_data{{"External data sources"}}
node_local_inputs["Local inputs"]
node_claude{{"Anthropic Claude"}}

node_user -->|"views"| node_web_pages
node_user -->|"logs daily data"| node_checkin
node_daily_sync -->|"runs ingestion"| node_domain_pipelines
node_domain_pipelines -->|"ingests from"| node_external_data
node_domain_pipelines -->|"loads"| node_local_inputs
node_domain_pipelines -->|"loads data"| node_warehouse
node_warehouse -->|"feeds transforms"| node_dbt_marts
node_openclaw_runner -->|"runs"| node_brief_analyzer
node_openclaw_runner -->|"runs Sundays"| node_weekly_analyzer
node_openclaw_runner -->|"runs"| node_cfb_analyzer
node_brief_analyzer -->|"queries and writes"| node_openclaw_db
node_brief_analyzer -->|"generates text"| node_claude
node_openclaw_db -->|"checks write policy"| node_rbac
node_openclaw_runner -->|"logs runs"| node_audit
node_openclaw_db -->|"reads and writes"| node_warehouse
node_api_app -->|"opens read-only"| node_warehouse
node_api_app -->|"registers routes"| node_api_routers
node_api_routers -->|"queries through"| node_api_deps
node_api_routers -->|"queries"| node_warehouse
node_dbt_marts -->|"serves query data"| node_api_app
node_web_pages -->|"requests data"| node_web_api
node_web_api -->|"calls API"| node_api_app
node_brief_analyzer -->|"reads habit metrics"| node_dbt_marts

click node_daily_sync "https://github.com/cnvertbleweathr/life-os-2026/blob/main/scripts/daily_sync.py"
click node_domain_pipelines "https://github.com/cnvertbleweathr/life-os-2026/tree/main/pipelines"
click node_warehouse "https://github.com/cnvertbleweathr/life-os-2026/blob/main/api/main.py"
click node_openclaw_runner "https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/orchestrator.py"
click node_brief_analyzer "https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/analyzers/morning_brief.py"
click node_weekly_analyzer "https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/analyzers/weekly_recap.py"
click node_cfb_analyzer "https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/analyzers/cfb_narratives.py"
click node_openclaw_db "https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/db.py"
click node_rbac "https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/rbac/policy.py"
click node_audit "https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/audit.py"
click node_api_app "https://github.com/cnvertbleweathr/life-os-2026/blob/main/api/main.py"
click node_api_deps "https://github.com/cnvertbleweathr/life-os-2026/blob/main/api/deps.py"
click node_api_routers "https://github.com/cnvertbleweathr/life-os-2026/tree/main/api/routers"
click node_web_api "https://github.com/cnvertbleweathr/life-os-2026/blob/main/web/lib/api.ts"
click node_web_pages "https://github.com/cnvertbleweathr/life-os-2026/tree/main/web/app"
click node_checkin "https://github.com/cnvertbleweathr/life-os-2026/blob/main/web/app/checkin/page.tsx"

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_daily_sync,node_domain_pipelines,node_user toneBlue
class node_warehouse,node_dbt_marts,node_openclaw_runner,node_brief_analyzer,node_weekly_analyzer,node_cfb_analyzer,node_openclaw_db,node_rbac,node_audit toneAmber
class node_api_app,node_api_deps,node_api_routers toneMint
class node_web_api,node_web_pages,node_checkin toneRose
class node_external_data,node_local_inputs,node_claude toneIndigo
```

## Components

### Data ingestion

- [Daily sync](https://github.com/cnvertbleweathr/life-os-2026/blob/main/scripts/daily_sync.py): `scripts/daily_sync.py`
- [Domain pipelines](https://github.com/cnvertbleweathr/life-os-2026/tree/main/pipelines): `pipelines`

### Analytics and AI

- [DuckDB warehouse](https://github.com/cnvertbleweathr/life-os-2026/blob/main/api/main.py): `api/main.py`
- **Analytics marts**
- [OpenClaw runner](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/orchestrator.py): `openclaw/orchestrator.py`
- [Morning brief](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/analyzers/morning_brief.py): `openclaw/analyzers/morning_brief.py`
- [Weekly recap](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/analyzers/weekly_recap.py): `openclaw/analyzers/weekly_recap.py`
- [CFB narratives](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/analyzers/cfb_narratives.py): `openclaw/analyzers/cfb_narratives.py`
- [OpenClaw data access](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/db.py): `openclaw/db.py`
- [Read policy](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/rbac/policy.py): `openclaw/rbac/policy.py`
- [Generation audit](https://github.com/cnvertbleweathr/life-os-2026/blob/main/openclaw/audit.py): `openclaw/audit.py`

### API serving

- [FastAPI app](https://github.com/cnvertbleweathr/life-os-2026/blob/main/api/main.py): `api/main.py`
- [Query helpers](https://github.com/cnvertbleweathr/life-os-2026/blob/main/api/deps.py): `api/deps.py`
- [Domain routers](https://github.com/cnvertbleweathr/life-os-2026/tree/main/api/routers): `api/routers`

### Dashboard

- [API client](https://github.com/cnvertbleweathr/life-os-2026/blob/main/web/lib/api.ts): `web/lib/api.ts`
- [Dashboard pages](https://github.com/cnvertbleweathr/life-os-2026/tree/main/web/app): `web/app`
- [Daily check-in](https://github.com/cnvertbleweathr/life-os-2026/blob/main/web/app/checkin/page.tsx): `web/app/checkin/page.tsx`

### Other components

- **User**
- **External data sources**
- **Local inputs**
- **Anthropic Claude**

## Connections

- User → Dashboard pages: views
- User → Daily check-in: logs daily data
- Daily sync → Domain pipelines: runs ingestion
- Domain pipelines → External data sources: ingests from
- Domain pipelines → Local inputs: loads
- Domain pipelines → DuckDB warehouse: loads data
- DuckDB warehouse → Analytics marts: feeds transforms
- OpenClaw runner → Morning brief: runs (evidence: `openclaw/orchestrator.py`)
- OpenClaw runner → Weekly recap: runs Sundays (evidence: `openclaw/orchestrator.py`)
- OpenClaw runner → CFB narratives: runs (evidence: `openclaw/orchestrator.py`)
- Morning brief → OpenClaw data access: queries and writes (evidence: `openclaw/analyzers/morning_brief.py`)
- Morning brief → Anthropic Claude: generates text (evidence: `openclaw/analyzers/morning_brief.py`)
- OpenClaw data access → Read policy: checks write policy (evidence: `openclaw/db.py`)
- OpenClaw runner → Generation audit: logs runs (evidence: `openclaw/orchestrator.py`)
- OpenClaw data access → DuckDB warehouse: reads and writes (evidence: `openclaw/db.py`)
- FastAPI app → DuckDB warehouse: opens read-only (evidence: `api/main.py`)
- FastAPI app → Domain routers: registers routes (evidence: `api/main.py`)
- Domain routers → Query helpers: queries through (evidence: `api/routers/cfb.py`)
- Domain routers → DuckDB warehouse: queries (evidence: `api/routers/cfb.py`)
- Analytics marts → FastAPI app: serves query data
- Dashboard pages → API client: requests data
- API client → FastAPI app: calls API
- Morning brief → Analytics marts: reads habit metrics (evidence: `openclaw/analyzers/morning_brief.py`)
