# thisismeamir/unipac architecture

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

- Interactive diagram: https://gitdiagram.com/thisismeamir/unipac
- Repository: https://github.com/thisismeamir/unipac

## Overview

Unipac is presented as a Linux package and environment manager. The intended user workflow is to define repositories and package sets (universes), then use them to manage software and isolated environments. The visible implementation is chiefly a Kotlin configuration DSL plus a small C++ CLI/core interface; the README’s translation, installation, and environment-management claims are not backed by sampled runtime code, so those operational links are not inferred.

Main entry points: [`src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt`](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt) (Universe builder), [`src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryBuilder.kt`](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryBuilder.kt) (Repository builder), [`src/dsl/app/src/main/kotlin/io/unipac/dsl/models/UnipacConfig.kt`](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/UnipacConfig.kt) (Unipac config), [`src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryImpl.kt`](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryImpl.kt) (Repository implementation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and Core"]
  node_cli["CLI<br/>[main.cpp]"]
  node_core_repo["Core repository API<br/>[repository.h]"]
  node_core_package["Core package API<br/>[package.h]"]
end

subgraph group_config["Configuration DSL"]
  node_config["Unipac config<br/>[UnipacConfig.kt]"]
end

subgraph group_repos["Repositories"]
  node_repo_builder["Repository builder"]
  node_repo_impl["Repository implementation<br/>[RepositoryImpl.kt]"]
  node_repo_api["Repository contract<br/>[Repository.kt]"]
end

subgraph group_universe["Packages and Universes"]
  node_package_model["Package model<br/>[Package.kt]"]
  node_universe_builder["Universe builder<br/>[UniverseBuilder.kt]"]
  node_universe_model["Universe model<br/>[Universe.kt]"]
  node_package_ref["Package reference"]
end

node_user(("Linux user"))

node_user -.->|"invokes"| node_cli
node_config -->|"builds repositories"| node_repo_builder
node_config -->|"builds universes"| node_universe_builder
node_repo_builder -->|"constructs"| node_repo_impl
node_repo_impl -->|"implements"| node_repo_api
node_repo_builder -->|"configures fetch results"| node_package_model
node_universe_builder -->|"builds inline repository"| node_repo_builder
node_universe_builder -->|"records package requests"| node_package_ref
node_universe_builder -->|"constructs"| node_universe_model
node_core_repo -->|"returns packages"| node_core_package
node_user -.->|"defines setup"| node_config

click node_cli "https://github.com/thisismeamir/unipac/blob/master/src/cli/main.cpp"
click node_core_repo "https://github.com/thisismeamir/unipac/blob/master/src/core/repository/repository.h"
click node_core_package "https://github.com/thisismeamir/unipac/blob/master/src/core/package/package.h"
click node_config "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/UnipacConfig.kt"
click node_repo_builder "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryBuilder.kt"
click node_repo_impl "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryImpl.kt"
click node_repo_api "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/Repository.kt"
click node_package_model "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/packages/Package.kt"
click node_universe_builder "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt"
click node_universe_model "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/Universe.kt"
click node_package_ref "https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/packages/PackageReference.kt"

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_core_repo,node_core_package,node_user toneBlue
class node_config toneAmber
class node_repo_builder,node_repo_impl,node_repo_api toneMint
class node_package_model,node_universe_builder,node_universe_model,node_package_ref toneRose
```

## Components

### CLI and Core

- [CLI](https://github.com/thisismeamir/unipac/blob/master/src/cli/main.cpp): `src/cli/main.cpp`
- [Core repository API](https://github.com/thisismeamir/unipac/blob/master/src/core/repository/repository.h): `src/core/repository/repository.h`
- [Core package API](https://github.com/thisismeamir/unipac/blob/master/src/core/package/package.h): `src/core/package/package.h`

### Configuration DSL

- [Unipac config](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/UnipacConfig.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/UnipacConfig.kt`

### Repositories

- [Repository builder](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryBuilder.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryBuilder.kt`
- [Repository implementation](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryImpl.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryImpl.kt`
- [Repository contract](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/Repository.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/Repository.kt`

### Packages and Universes

- [Package model](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/packages/Package.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/packages/Package.kt`
- [Universe builder](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt`
- [Universe model](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/Universe.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/Universe.kt`
- [Package reference](https://github.com/thisismeamir/unipac/blob/master/src/dsl/app/src/main/kotlin/io/unipac/dsl/models/packages/PackageReference.kt): `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/packages/PackageReference.kt`

### Other components

- **Linux user**

## Connections

- Linux user → CLI: invokes
- Unipac config → Repository builder: builds repositories (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/UnipacConfig.kt`)
- Unipac config → Universe builder: builds universes (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/UnipacConfig.kt`)
- Repository builder → Repository implementation: constructs (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryBuilder.kt`)
- Repository implementation → Repository contract: implements (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryImpl.kt`)
- Repository builder → Package model: configures fetch results (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/repository/RepositoryBuilder.kt`)
- Universe builder → Repository builder: builds inline repository (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt`)
- Universe builder → Package reference: records package requests (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt`)
- Universe builder → Universe model: constructs (evidence: `src/dsl/app/src/main/kotlin/io/unipac/dsl/models/universe/UniverseBuilder.kt`)
- Core repository API → Core package API: returns packages (evidence: `src/core/package/package.h`)
- Linux user → Unipac config: defines setup
