# tank550/focus_os architecture

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

- Interactive diagram: https://gitdiagram.com/tank550/focus_os
- Repository: https://github.com/tank550/focus_os

## Overview

Focus OS is a local-first personal execution desktop app: users capture thoughts in Inbox, explicitly request AI analysis and confirm actionable proposals, organize work as projects/goals/tasks, then plan and run focus sessions. Settings and GitHub-based portfolio review are separate capabilities. The graph follows the frontend-to-command-to-application flow where evidence supports it; unsampled command and service wiring is represented conservatively. SQLite is the local source of truth; the README documents NIM and GitHub workflows.

Main entry points: [`src-tauri/src/commands`](https://github.com/tank550/focus_os/tree/master/src-tauri/src/commands) (Tauri commands), [`src-tauri/src/application/tasks.rs`](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/tasks.rs) (Task execution), [`src-tauri/src/application/agent.rs`](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/agent.rs) (Proposal agent), [`src/lib/tauri.ts`](https://github.com/tank550/focus_os/blob/master/src/lib/tauri.ts) (Tauri bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop experience"]
  node_screens["Product screens"]
  node_stores["UI state"]
  node_bridge["Tauri bridge<br/>[tauri.ts]"]
  node_contracts["IPC contracts<br/>[contracts.ts]"]
end

subgraph group_core["Application workflows"]
  node_commands["Tauri commands"]
  node_inbox["Inbox analysis<br/>[inbox.rs]"]
  node_agent["Proposal agent<br/>[agent.rs]"]
  node_tasks["Task execution<br/>[tasks.rs]"]
  node_projects["Project management<br/>[projects.rs]"]
  node_goals["Goals sidecar<br/>[goals.rs]"]
  node_planner["Daily planner<br/>[planner.rs]"]
  node_portfolio["Portfolio review<br/>[portfolio.rs]"]
  node_settings["Settings service<br/>[settings.rs]"]
end

subgraph group_infra["Persistence and integrations"]
  node_state["Shared app state<br/>[state.rs]"]
  node_db[("SQLite database<br/>[mod.rs]")]
  node_taskrepo["Task repository<br/>[tasks_repo.rs]"]
  node_goalrepo["Goal repository<br/>[goals_repo.rs]"]
  node_repositories["Domain repositories"]
  node_ai["AI provider<br/>[ai.rs]"]
  node_github["GitHub integration<br/>[github.rs]"]
end

subgraph group_domain["Domain model"]
  node_domain["Focus domain<br/>[status.rs]"]
end

node_user(("User"))
node_nim{{"NVIDIA NIM"}}
node_githubsvc{{"GitHub"}}

node_user -->|"uses"| node_screens
node_screens -->|"dispatches"| node_stores
node_stores -->|"invokes"| node_bridge
node_bridge -->|"types with"| node_contracts
node_bridge -->|"invokes commands"| node_commands
node_commands -->|"delegates"| node_tasks
node_tasks -->|"reads and writes"| node_taskrepo
node_tasks -->|"records sidecar"| node_goalrepo
node_taskrepo -->|"queries"| node_db
node_goalrepo -->|"queries"| node_db
node_state -->|"pools connections"| node_db
node_tasks -->|"leases connection"| node_state
node_goals -->|"uses"| node_goalrepo
node_goals -->|"leases connection"| node_state
node_commands -.->|"routes inbox"| node_inbox
node_inbox -.->|"requests proposals"| node_agent
node_agent -.->|"requests analysis"| node_ai
node_ai -.->|"sends analysis"| node_nim
node_agent -.->|"applies confirmed task"| node_tasks
node_agent -.->|"applies confirmed project"| node_projects
node_commands -.->|"routes planning"| node_planner
node_planner -.->|"loads and saves plan"| node_repositories
node_commands -.->|"routes assessment"| node_portfolio
node_portfolio -.->|"inspects repository"| node_github
node_github -.->|"lists repositories"| node_githubsvc
node_portfolio -.->|"assesses summary"| node_ai
node_commands -.->|"routes settings"| node_settings
node_settings -.->|"persists settings"| node_repositories
node_tasks -->|"validates task status"| node_domain

click node_screens "https://github.com/tank550/focus_os/tree/master/src/features"
click node_stores "https://github.com/tank550/focus_os/tree/master/src/stores"
click node_bridge "https://github.com/tank550/focus_os/blob/master/src/lib/tauri.ts"
click node_contracts "https://github.com/tank550/focus_os/blob/master/src/shared/contracts.ts"
click node_commands "https://github.com/tank550/focus_os/tree/master/src-tauri/src/commands"
click node_inbox "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/inbox.rs"
click node_agent "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/agent.rs"
click node_tasks "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/tasks.rs"
click node_projects "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/projects.rs"
click node_goals "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/goals.rs"
click node_planner "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/planner.rs"
click node_portfolio "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/portfolio.rs"
click node_settings "https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/settings.rs"
click node_state "https://github.com/tank550/focus_os/blob/master/src-tauri/src/state.rs"
click node_db "https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/db/mod.rs"
click node_taskrepo "https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/repositories/tasks_repo.rs"
click node_goalrepo "https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/repositories/goals_repo.rs"
click node_repositories "https://github.com/tank550/focus_os/tree/master/src-tauri/src/infrastructure/repositories"
click node_ai "https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/ai.rs"
click node_github "https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/github.rs"
click node_domain "https://github.com/tank550/focus_os/blob/master/crates/focus-domain/src/status.rs"

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_screens,node_stores,node_bridge,node_contracts,node_user toneBlue
class node_commands,node_inbox,node_agent,node_tasks,node_projects,node_goals,node_planner,node_portfolio,node_settings toneAmber
class node_state,node_db,node_taskrepo,node_goalrepo,node_repositories,node_ai,node_github toneMint
class node_domain toneRose
class node_nim,node_githubsvc toneIndigo
```

## Components

### Desktop experience

- [Product screens](https://github.com/tank550/focus_os/tree/master/src/features): `src/features`
- [UI state](https://github.com/tank550/focus_os/tree/master/src/stores): `src/stores`
- [Tauri bridge](https://github.com/tank550/focus_os/blob/master/src/lib/tauri.ts): `src/lib/tauri.ts`
- [IPC contracts](https://github.com/tank550/focus_os/blob/master/src/shared/contracts.ts): `src/shared/contracts.ts`

### Application workflows

- [Tauri commands](https://github.com/tank550/focus_os/tree/master/src-tauri/src/commands): `src-tauri/src/commands`
- [Inbox analysis](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/inbox.rs): `src-tauri/src/application/inbox.rs`
- [Proposal agent](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/agent.rs): `src-tauri/src/application/agent.rs`
- [Task execution](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/tasks.rs): `src-tauri/src/application/tasks.rs`
- [Project management](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/projects.rs): `src-tauri/src/application/projects.rs`
- [Goals sidecar](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/goals.rs): `src-tauri/src/application/goals.rs`
- [Daily planner](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/planner.rs): `src-tauri/src/application/planner.rs`
- [Portfolio review](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/portfolio.rs): `src-tauri/src/application/portfolio.rs`
- [Settings service](https://github.com/tank550/focus_os/blob/master/src-tauri/src/application/settings.rs): `src-tauri/src/application/settings.rs`

### Persistence and integrations

- [Shared app state](https://github.com/tank550/focus_os/blob/master/src-tauri/src/state.rs): `src-tauri/src/state.rs`
- [SQLite database](https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/db/mod.rs): `src-tauri/src/infrastructure/db/mod.rs`
- [Task repository](https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/repositories/tasks_repo.rs): `src-tauri/src/infrastructure/repositories/tasks_repo.rs`
- [Goal repository](https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/repositories/goals_repo.rs): `src-tauri/src/infrastructure/repositories/goals_repo.rs`
- [Domain repositories](https://github.com/tank550/focus_os/tree/master/src-tauri/src/infrastructure/repositories): `src-tauri/src/infrastructure/repositories`
- [AI provider](https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/ai.rs): `src-tauri/src/infrastructure/ai.rs`
- [GitHub integration](https://github.com/tank550/focus_os/blob/master/src-tauri/src/infrastructure/github.rs): `src-tauri/src/infrastructure/github.rs`

### Domain model

- [Focus domain](https://github.com/tank550/focus_os/blob/master/crates/focus-domain/src/status.rs): `crates/focus-domain/src/status.rs`

### Other components

- **User**
- **NVIDIA NIM**
- **GitHub**

## Connections

- User → Product screens: uses
- Product screens → UI state: dispatches (evidence: `src/App.tsx`)
- UI state → Tauri bridge: invokes (evidence: `src/stores/appStore.ts`)
- Tauri bridge → IPC contracts: types with (evidence: `src/lib/tauri.ts`)
- Tauri bridge → Tauri commands: invokes commands (evidence: `src/lib/tauri.ts`)
- Tauri commands → Task execution: delegates (evidence: `src-tauri/src/commands/tasks.rs`)
- Task execution → Task repository: reads and writes (evidence: `src-tauri/src/application/tasks.rs`)
- Task execution → Goal repository: records sidecar (evidence: `src-tauri/src/application/tasks.rs`)
- Task repository → SQLite database: queries (evidence: `src-tauri/src/infrastructure/repositories/tasks_repo.rs`)
- Goal repository → SQLite database: queries (evidence: `src-tauri/src/infrastructure/repositories/goals_repo.rs`)
- Shared app state → SQLite database: pools connections (evidence: `src-tauri/src/state.rs`)
- Task execution → Shared app state: leases connection (evidence: `src-tauri/src/application/tasks.rs`)
- Goals sidecar → Goal repository: uses (evidence: `src-tauri/src/application/goals.rs`)
- Goals sidecar → Shared app state: leases connection (evidence: `src-tauri/src/application/goals.rs`)
- Tauri commands → Inbox analysis: routes inbox
- Inbox analysis → Proposal agent: requests proposals
- Proposal agent → AI provider: requests analysis
- AI provider → NVIDIA NIM: sends analysis (evidence: `README.md`)
- Proposal agent → Task execution: applies confirmed task (evidence: `README.md`)
- Proposal agent → Project management: applies confirmed project (evidence: `README.md`)
- Tauri commands → Daily planner: routes planning
- Daily planner → Domain repositories: loads and saves plan
- Tauri commands → Portfolio review: routes assessment
- Portfolio review → GitHub integration: inspects repository (evidence: `README.md`)
- GitHub integration → GitHub: lists repositories (evidence: `README.md`)
- Portfolio review → AI provider: assesses summary (evidence: `README.md`)
- Tauri commands → Settings service: routes settings
- Settings service → Domain repositories: persists settings
- Task execution → Focus domain: validates task status (evidence: `src-tauri/src/application/tasks.rs`)
