# guanzi008/linyaps-rust architecture

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

- Interactive diagram: https://gitdiagram.com/guanzi008/linyaps-rust
- Repository: https://github.com/guanzi008/linyaps-rust

## Overview

Linyaps is a Rust-compatible implementation of the Linglong application packaging and runtime system. Its main user workflow is to discover or install a package with ll-cli, manage the resulting package state through the package-manager service and repository, then launch it in a configured container runtime. A separate builder workflow validates a project, obtains sources, builds and postprocesses modules, and exports or pushes packages. The graph preserves documented system integrations; several subsystem links are based on README-level descriptions because their implementation was not sampled.

Main entry points: [`crates/linyaps-repository/src/local.rs`](https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-repository/src/local.rs) (Local repository), [`apps/ll-cli/src/main.rs`](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/main.rs) (ll-cli / llpkg), [`apps/ll-builder/src/main.rs`](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/main.rs) (ll-builder), [`apps/ll-cli/src/runtime.rs`](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/runtime.rs) (Launch runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client and runtime"]
  node_cli["ll-cli / llpkg<br/>[main.rs]"]
  node_cli_args["CLI parsing<br/>[cli11.rs]"]
  node_analysis["Package analysis<br/>[analysis.rs]"]
  node_runtime["Launch runtime<br/>[runtime.rs]"]
  node_namespace["Namespaces<br/>[namespace.rs]"]
  node_wayland["Wayland security"]
  node_box["ll-box runtime"]
end

subgraph group_builder["Package building"]
  node_builder_cli["ll-builder<br/>[main.rs]"]
  node_project["Project validation<br/>[project.rs]"]
  node_sources["Source acquisition<br/>[source.rs]"]
  node_debian["Debian sources<br/>[debian_source.rs]"]
  node_build["Container build<br/>[build.rs]"]
  node_container["Build container<br/>[container.rs]"]
  node_postprocess["Module postprocess<br/>[postprocess.rs]"]
  node_repo_ops["Builder repo operations<br/>[repo_ops.rs]"]
  node_uab["UAB packaging<br/>[uab_packaging.rs]"]
end

subgraph group_management["Package management"]
  node_pm["Package-manager service<br/>[main.rs]"]
  node_operations["Install and lifecycle<br/>[operations.rs]"]
  node_hooks["Install hooks<br/>[install_hooks.rs]"]
  node_run_context["Run context setup<br/>[run_context.rs]"]
  node_dbus["D-Bus tasks<br/>[package_manager.rs]"]
  node_task["Task tracking<br/>[task.rs]"]
end

subgraph group_storage["Repository and formats"]
  node_repository[("Local repository<br/>[local.rs]")]
  node_remote["Remote transport<br/>[remote.rs]"]
  node_layer["Layer and UAB formats<br/>[layer_file.rs]"]
  node_uab_loader["UAB loader<br/>[loader.rs]"]
  node_core["Runtime configuration<br/>[oci_patch.rs]"]
end

subgraph group_system["System integration"]
  node_system_helper["System helper<br/>[main.rs]"]
  node_init["Container init<br/>[main.rs]"]
  node_drivers["Driver detection<br/>[main.rs]"]
  node_polkit["polkit authorization<br/>[polkit.rs]"]
end

node_user(("User"))

node_user -->|"invokes"| node_cli
node_cli -->|"parses commands"| node_cli_args
node_cli -->|"dispatches analysis"| node_analysis
node_cli -->|"dispatches runtime"| node_runtime
node_runtime -->|"uses"| node_namespace
node_runtime -->|"uses"| node_wayland
node_runtime -->|"invokes"| node_box
node_cli -.->|"requests package tasks"| node_pm
node_user -->|"builds packages"| node_builder_cli
node_builder_cli -->|"validates project"| node_project
node_builder_cli -->|"dispatches build"| node_build
node_build -->|"runs build in"| node_container
node_build -->|"obtains sources"| node_sources
node_sources -->|"handles Debian sources"| node_debian
node_build -->|"postprocesses output"| node_postprocess
node_builder_cli -->|"dispatches repository operations"| node_repo_ops
node_builder_cli -->|"dispatches UAB generation"| node_uab
node_builder_cli -.->|"imports and exports packages"| node_repository
node_pm -->|"serves lifecycle operations"| node_operations
node_pm -->|"exposes D-Bus service"| node_dbus
node_dbus -->|"tracks tasks"| node_task
node_operations -->|"runs install hooks"| node_hooks
node_pm -->|"initializes run context"| node_run_context
node_pm -->|"authorizes requests"| node_polkit
node_operations -.->|"manages packages"| node_repository
node_cli -.->|"searches and manages packages"| node_repository
node_repository -->|"uses remote transport"| node_remote
node_repository -.->|"reads and writes layers"| node_layer
node_uab_loader -.->|"imports UAB contents"| node_repository
node_run_context -->|"resolves package layers"| node_repository
node_run_context -->|"configures runtime"| node_core
node_system_helper -.->|"installs system layout"| node_init
node_system_helper -.->|"installs system components"| node_drivers
node_system_helper -.->|"installs runtime companion"| node_box
node_runtime -.->|"uses container initialization"| node_init

click node_cli "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/main.rs"
click node_cli_args "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/cli11.rs"
click node_analysis "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/analysis.rs"
click node_runtime "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/runtime.rs"
click node_namespace "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/namespace.rs"
click node_wayland "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/wayland_security.rs"
click node_builder_cli "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/main.rs"
click node_project "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/project.rs"
click node_sources "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/source.rs"
click node_debian "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/debian_source.rs"
click node_build "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/build.rs"
click node_container "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/container.rs"
click node_postprocess "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/postprocess.rs"
click node_repo_ops "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/repo_ops.rs"
click node_uab "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/uab_packaging.rs"
click node_pm "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/main.rs"
click node_operations "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/operations.rs"
click node_hooks "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/install_hooks.rs"
click node_run_context "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/run_context.rs"
click node_dbus "https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-dbus/src/package_manager.rs"
click node_task "https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-dbus/src/task.rs"
click node_repository "https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-repository/src/local.rs"
click node_remote "https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-repository/src/remote.rs"
click node_layer "https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-repository/src/layer_file.rs"
click node_uab_loader "https://github.com/guanzi008/linyaps-rust/blob/main/apps/uab/src/loader.rs"
click node_core "https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-core/src/oci_patch.rs"
click node_system_helper "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-system-helper/src/main.rs"
click node_init "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-init/src/main.rs"
click node_drivers "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-driver-detect/src/main.rs"
click node_polkit "https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/polkit.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_cli,node_cli_args,node_analysis,node_runtime,node_namespace,node_wayland,node_box,node_user toneBlue
class node_builder_cli,node_project,node_sources,node_debian,node_build,node_container,node_postprocess,node_repo_ops,node_uab toneAmber
class node_pm,node_operations,node_hooks,node_run_context,node_dbus,node_task toneMint
class node_repository,node_remote,node_layer,node_uab_loader,node_core toneRose
class node_system_helper,node_init,node_drivers,node_polkit toneIndigo
```

## Components

### Client and runtime

- [ll-cli / llpkg](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/main.rs): `apps/ll-cli/src/main.rs`
- [CLI parsing](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/cli11.rs): `apps/ll-cli/src/cli11.rs`
- [Package analysis](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/analysis.rs): `apps/ll-cli/src/analysis.rs`
- [Launch runtime](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/runtime.rs): `apps/ll-cli/src/runtime.rs`
- [Namespaces](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/namespace.rs): `apps/ll-cli/src/namespace.rs`
- [Wayland security](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-cli/src/wayland_security.rs): `apps/ll-cli/src/wayland_security.rs`
- **ll-box runtime**

### Package building

- [ll-builder](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/main.rs): `apps/ll-builder/src/main.rs`
- [Project validation](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/project.rs): `apps/ll-builder/src/project.rs`
- [Source acquisition](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/source.rs): `apps/ll-builder/src/source.rs`
- [Debian sources](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/debian_source.rs): `apps/ll-builder/src/debian_source.rs`
- [Container build](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/build.rs): `apps/ll-builder/src/build.rs`
- [Build container](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/container.rs): `apps/ll-builder/src/container.rs`
- [Module postprocess](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/postprocess.rs): `apps/ll-builder/src/postprocess.rs`
- [Builder repo operations](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/repo_ops.rs): `apps/ll-builder/src/repo_ops.rs`
- [UAB packaging](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-builder/src/uab_packaging.rs): `apps/ll-builder/src/uab_packaging.rs`

### Package management

- [Package-manager service](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/main.rs): `apps/ll-package-manager/src/main.rs`
- [Install and lifecycle](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/operations.rs): `apps/ll-package-manager/src/operations.rs`
- [Install hooks](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/install_hooks.rs): `apps/ll-package-manager/src/install_hooks.rs`
- [Run context setup](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/run_context.rs): `apps/ll-package-manager/src/run_context.rs`
- [D-Bus tasks](https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-dbus/src/package_manager.rs): `crates/linyaps-dbus/src/package_manager.rs`
- [Task tracking](https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-dbus/src/task.rs): `crates/linyaps-dbus/src/task.rs`

### Repository and formats

- [Local repository](https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-repository/src/local.rs): `crates/linyaps-repository/src/local.rs`
- [Remote transport](https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-repository/src/remote.rs): `crates/linyaps-repository/src/remote.rs`
- [Layer and UAB formats](https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-repository/src/layer_file.rs): `crates/linyaps-repository/src/layer_file.rs`
- [UAB loader](https://github.com/guanzi008/linyaps-rust/blob/main/apps/uab/src/loader.rs): `apps/uab/src/loader.rs`
- [Runtime configuration](https://github.com/guanzi008/linyaps-rust/blob/main/crates/linyaps-core/src/oci_patch.rs): `crates/linyaps-core/src/oci_patch.rs`

### System integration

- [System helper](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-system-helper/src/main.rs): `apps/ll-system-helper/src/main.rs`
- [Container init](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-init/src/main.rs): `apps/ll-init/src/main.rs`
- [Driver detection](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-driver-detect/src/main.rs): `apps/ll-driver-detect/src/main.rs`
- [polkit authorization](https://github.com/guanzi008/linyaps-rust/blob/main/apps/ll-package-manager/src/polkit.rs): `apps/ll-package-manager/src/polkit.rs`

### Other components

- **User**

## Connections

- User → ll-cli / llpkg: invokes (evidence: `README.md`)
- ll-cli / llpkg → CLI parsing: parses commands (evidence: `apps/ll-cli/src/main.rs`)
- ll-cli / llpkg → Package analysis: dispatches analysis (evidence: `apps/ll-cli/src/main.rs`)
- ll-cli / llpkg → Launch runtime: dispatches runtime (evidence: `apps/ll-cli/src/main.rs`)
- Launch runtime → Namespaces: uses (evidence: `apps/ll-cli/src/runtime.rs`)
- Launch runtime → Wayland security: uses (evidence: `apps/ll-cli/src/runtime.rs`)
- Launch runtime → ll-box runtime: invokes (evidence: `README.md`)
- ll-cli / llpkg → Package-manager service: requests package tasks (evidence: `README.md`)
- User → ll-builder: builds packages (evidence: `README.md`)
- ll-builder → Project validation: validates project (evidence: `apps/ll-builder/src/main.rs`)
- ll-builder → Container build: dispatches build (evidence: `apps/ll-builder/src/main.rs`)
- Container build → Build container: runs build in (evidence: `apps/ll-builder/src/build.rs`)
- Container build → Source acquisition: obtains sources (evidence: `apps/ll-builder/src/build.rs`)
- Source acquisition → Debian sources: handles Debian sources (evidence: `apps/ll-builder/src/source.rs`)
- Container build → Module postprocess: postprocesses output (evidence: `apps/ll-builder/src/build.rs`)
- ll-builder → Builder repo operations: dispatches repository operations (evidence: `apps/ll-builder/src/main.rs`)
- ll-builder → UAB packaging: dispatches UAB generation (evidence: `apps/ll-builder/src/main.rs`)
- ll-builder → Local repository: imports and exports packages (evidence: `README.md`)
- Package-manager service → Install and lifecycle: serves lifecycle operations (evidence: `apps/ll-package-manager/src/main.rs`)
- Package-manager service → D-Bus tasks: exposes D-Bus service (evidence: `README.md`)
- D-Bus tasks → Task tracking: tracks tasks (evidence: `crates/linyaps-dbus/src/package_manager.rs`)
- Install and lifecycle → Install hooks: runs install hooks (evidence: `apps/ll-package-manager/src/operations.rs`)
- Package-manager service → Run context setup: initializes run context (evidence: `apps/ll-package-manager/src/main.rs`)
- Package-manager service → polkit authorization: authorizes requests (evidence: `apps/ll-package-manager/src/main.rs`)
- Install and lifecycle → Local repository: manages packages (evidence: `README.md`)
- ll-cli / llpkg → Local repository: searches and manages packages (evidence: `README.md`)
- Local repository → Remote transport: uses remote transport (evidence: `crates/linyaps-repository/src/local.rs`)
- Local repository → Layer and UAB formats: reads and writes layers (evidence: `README.md`)
- UAB loader → Local repository: imports UAB contents (evidence: `README.md`)
- Run context setup → Local repository: resolves package layers (evidence: `README.md`)
- Run context setup → Runtime configuration: configures runtime (evidence: `README.md`)
- System helper → Container init: installs system layout (evidence: `README.md`)
- System helper → Driver detection: installs system components (evidence: `README.md`)
- System helper → ll-box runtime: installs runtime companion (evidence: `README.md`)
- Launch runtime → Container init: uses container initialization (evidence: `README.md`)
