# okralinux/okrapm architecture

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

- Interactive diagram: https://gitdiagram.com/okralinux/okrapm
- Repository: https://github.com/okralinux/okrapm

## Overview

OkraPM/Lunar is a user-space package-management toolchain: Lunar accepts CLI requests, resolves packages and dependencies from repositories, plans and commits install/remove/update/upgrade transactions, and supports snapshots and rollback. OAA tools build, inspect, verify, extract, and install archive packages; repository synchronization supplies metadata for search and resolution. The graph also shows package lifecycle scripting and the optional repository server. Relationships for unsampled implementations are omitted or marked unverified; documented capabilities are retained from the README.

Main entry points: [`lib/okrapmlib/src/lunar_core.cpp`](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/lunar_core.cpp) (Lunar core), [`src/lunar/src/main.cpp`](https://github.com/okralinux/okrapm/blob/main/src/lunar/src/main.cpp) (Lunar CLI), [`lib/okrapmlib/src/repository.cpp`](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/repository.cpp) (Repository manager), [`lib/okrapmlib/src/resolver.cpp`](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/resolver.cpp) (Dependency resolver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["User interfaces"]
  node_lunar_cli["Lunar CLI<br/>[main.cpp]"]
  node_oaa_cli["OAA CLI<br/>[main.cpp]"]
end

subgraph group_package["Packages and scripts"]
  node_oaa_lib["OAA tools<br/>[oaa_core.cpp]"]
  node_artifact["Artifact engine"]
  node_opsis["OPSIS runtime<br/>[engine.cpp]"]
end

subgraph group_core["Package management core"]
  node_core["Lunar core<br/>[lunar_core.cpp]"]
  node_pipeline["Pipeline engine"]
  node_resolver["Dependency resolver<br/>[resolver.cpp]"]
  node_transaction["Transaction engine<br/>[transaction.cpp]"]
  node_objects["Package objects<br/>[object.cpp]"]
  node_references["Object references<br/>[object_ref.cpp]"]
  node_version["Version model<br/>[version.cpp]"]
end

subgraph group_state["System state"]
  node_store[("System store<br/>[system_store.cpp]")]
  node_snapshots["Snapshots<br/>[snapshot.cpp]"]
end

subgraph group_repo["Repositories"]
  node_repositories["Repository manager<br/>[repository.cpp]"]
  node_downloader["Network downloader"]
  node_repo_server["Repository server<br/>[server.py]"]
end

node_user(("Operator"))

node_user -->|"runs commands"| node_lunar_cli
node_user -->|"runs commands"| node_oaa_cli
node_lunar_cli -->|"dispatches requests"| node_core
node_lunar_cli -->|"verifies artifacts"| node_artifact
node_lunar_cli -.->|"executes pipelines"| node_pipeline
node_oaa_cli -->|"dispatches commands"| node_oaa_lib
node_oaa_lib -.->|"builds and inspects"| node_artifact
node_core -->|"resolves requests"| node_resolver
node_core -->|"commits transactions"| node_transaction
node_core -->|"uses repositories"| node_repositories
node_core -.->|"records system state"| node_store
node_core -->|"creates rollback points"| node_snapshots
node_core -->|"handles package artifacts"| node_artifact
node_core -->|"runs lifecycle scripts"| node_opsis
node_resolver -->|"queries package metadata"| node_repositories
node_resolver -->|"produces operations"| node_transaction
node_repositories -->|"downloads indexes"| node_downloader
node_repositories -.->|"syncs remotely"| node_repo_server
node_objects -->|"uses versions"| node_version
node_references -->|"matches objects"| node_objects

click node_lunar_cli "https://github.com/okralinux/okrapm/blob/main/src/lunar/src/main.cpp"
click node_oaa_cli "https://github.com/okralinux/okrapm/blob/main/oaatools/src/main.cpp"
click node_oaa_lib "https://github.com/okralinux/okrapm/blob/main/oaatools/src/oaa_core.cpp"
click node_artifact "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/artifact_engine.cpp"
click node_opsis "https://github.com/okralinux/okrapm/blob/main/opsis/src/engine.cpp"
click node_core "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/lunar_core.cpp"
click node_pipeline "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/pipeline_engine.cpp"
click node_resolver "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/resolver.cpp"
click node_transaction "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/transaction.cpp"
click node_objects "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/object.cpp"
click node_references "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/object_ref.cpp"
click node_repositories "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/repository.cpp"
click node_downloader "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/network_downloader.cpp"
click node_repo_server "https://github.com/okralinux/okrapm/blob/main/repo-server/server.py"
click node_store "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/system_store.cpp"
click node_snapshots "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/snapshot.cpp"
click node_version "https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/version.cpp"

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_lunar_cli,node_oaa_cli toneBlue
class node_oaa_lib,node_artifact,node_opsis toneAmber
class node_core,node_pipeline,node_resolver,node_transaction,node_objects,node_references,node_version toneMint
class node_store,node_snapshots toneRose
class node_repositories,node_downloader,node_repo_server,node_user toneIndigo
```

## Components

### User interfaces

- [Lunar CLI](https://github.com/okralinux/okrapm/blob/main/src/lunar/src/main.cpp): `src/lunar/src/main.cpp`
- [OAA CLI](https://github.com/okralinux/okrapm/blob/main/oaatools/src/main.cpp): `oaatools/src/main.cpp`

### Packages and scripts

- [OAA tools](https://github.com/okralinux/okrapm/blob/main/oaatools/src/oaa_core.cpp): `oaatools/src/oaa_core.cpp`
- [Artifact engine](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/artifact_engine.cpp): `lib/okrapmlib/src/artifact_engine.cpp`
- [OPSIS runtime](https://github.com/okralinux/okrapm/blob/main/opsis/src/engine.cpp): `opsis/src/engine.cpp`

### Package management core

- [Lunar core](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/lunar_core.cpp): `lib/okrapmlib/src/lunar_core.cpp`
- [Pipeline engine](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/pipeline_engine.cpp): `lib/okrapmlib/src/pipeline_engine.cpp`
- [Dependency resolver](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/resolver.cpp): `lib/okrapmlib/src/resolver.cpp`
- [Transaction engine](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/transaction.cpp): `lib/okrapmlib/src/transaction.cpp`
- [Package objects](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/object.cpp): `lib/okrapmlib/src/object.cpp`
- [Object references](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/object_ref.cpp): `lib/okrapmlib/src/object_ref.cpp`
- [Version model](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/version.cpp): `lib/okrapmlib/src/version.cpp`

### System state

- [System store](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/system_store.cpp): `lib/okrapmlib/src/system_store.cpp`
- [Snapshots](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/snapshot.cpp): `lib/okrapmlib/src/snapshot.cpp`

### Repositories

- [Repository manager](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/repository.cpp): `lib/okrapmlib/src/repository.cpp`
- [Network downloader](https://github.com/okralinux/okrapm/blob/main/lib/okrapmlib/src/network_downloader.cpp): `lib/okrapmlib/src/network_downloader.cpp`
- [Repository server](https://github.com/okralinux/okrapm/blob/main/repo-server/server.py): `repo-server/server.py`

### Other components

- **Operator**

## Connections

- Operator → Lunar CLI: runs commands
- Operator → OAA CLI: runs commands
- Lunar CLI → Lunar core: dispatches requests (evidence: `src/lunar/src/main.cpp`)
- Lunar CLI → Artifact engine: verifies artifacts (evidence: `src/lunar/src/main.cpp`)
- Lunar CLI → Pipeline engine: executes pipelines
- OAA CLI → OAA tools: dispatches commands (evidence: `oaatools/src/main.cpp`)
- OAA tools → Artifact engine: builds and inspects
- Lunar core → Dependency resolver: resolves requests
- Lunar core → Transaction engine: commits transactions
- Lunar core → Repository manager: uses repositories
- Lunar core → System store: records system state
- Lunar core → Snapshots: creates rollback points
- Lunar core → Artifact engine: handles package artifacts (evidence: `lib/okrapmlib/src/lunar_core.cpp`)
- Lunar core → OPSIS runtime: runs lifecycle scripts (evidence: `lib/okrapmlib/src/lunar_core.cpp`)
- Dependency resolver → Repository manager: queries package metadata
- Dependency resolver → Transaction engine: produces operations
- Repository manager → Network downloader: downloads indexes (evidence: `lib/okrapmlib/src/repository.cpp`)
- Repository manager → Repository server: syncs remotely
- Package objects → Version model: uses versions
- Object references → Package objects: matches objects
