# aubepkg/aube architecture

> Architecture diagram of the GitHub repository aubepkg/aube, 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/aubepkg/aube
- Repository: https://github.com/aubepkg/aube

## Overview

aube is a Rust Node.js package manager. Its central workflow is a user invoking `aubr`/`aube run`: it checks dependency freshness, resolves and installs dependencies when needed, then runs the project script. The architecture also covers lockfile compatibility, shared package storage and linking, workspace management, Node runtime selection, and dependency-build security. Some subsystem paths are directories because their implementation was not sampled; relationships are limited to README claims or SOURCE INDEX references.

Main entry points: [`crates/aube/src/commands/install`](https://github.com/aubepkg/aube/tree/main/crates/aube/src/commands/install) (Install workflow), [`crates/aube/src/commands/run.rs`](https://github.com/aubepkg/aube/blob/main/crates/aube/src/commands/run.rs) (Run scripts), [`crates/aube/src/commands`](https://github.com/aubepkg/aube/tree/main/crates/aube/src/commands) (CLI commands), [`crates/aube-resolver/src/resolve/driver.rs`](https://github.com/aubepkg/aube/blob/main/crates/aube-resolver/src/resolve/driver.rs) (Dependency resolver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and execution"]
  node_cli["CLI commands"]
  node_run["Run scripts<br/>[run.rs]"]
end

subgraph group_dependency["Dependency management"]
  node_resolver["Dependency resolver<br/>[driver.rs]"]
  node_registry["Registry client<br/>[client.rs]"]
  node_lockfiles["Lockfile formats"]
  node_manifest["Manifest handling"]
end

subgraph group_install["Install and storage"]
  node_install_cmd["Install workflow"]
  node_store[("Package store<br/>[lib.rs]")]
  node_linker["Package linking"]
end

subgraph group_policy["Workspace and security"]
  node_lifecycle["Lifecycle scripts<br/>[lib.rs]"]
  node_build_policy["Build policy and jail<br/>[policy.rs]"]
  node_workspace["Workspace selection<br/>[selector.rs]"]
  node_security["Advisory checks"]
end

subgraph group_runtime["Runtime support"]
  node_node_runtime["Node runtime management"]
  node_settings["Configuration settings<br/>[values.rs]"]
end

node_user(("Project user"))
node_registry_service(("Package registry"))
node_osv_service(("OSV advisory service"))

node_user -->|"runs script"| node_run
node_user -->|"invokes commands"| node_cli
node_run -->|"checks freshness"| node_install_cmd
node_install_cmd -.->|"resolves dependencies"| node_resolver
node_resolver -->|"fetches metadata"| node_registry
node_registry -.->|"requests packages"| node_registry_service
node_install_cmd -->|"reads and writes"| node_lockfiles
node_install_cmd -->|"shares package files"| node_store
node_install_cmd -.->|"links packages"| node_linker
node_install_cmd -->|"runs approved hooks"| node_lifecycle
node_lifecycle -->|"applies policy"| node_build_policy
node_resolver -.->|"checks advisories"| node_security
node_security -->|"confirms candidates"| node_osv_service
node_cli -->|"selects workspace packages"| node_workspace
node_cli -.->|"updates dependencies"| node_manifest
node_run -->|"uses project runtime"| node_node_runtime
node_install_cmd -.->|"uses install settings"| node_settings
node_run -.->|"executes project script"| node_lifecycle

click node_cli "https://github.com/aubepkg/aube/tree/main/crates/aube/src/commands"
click node_run "https://github.com/aubepkg/aube/blob/main/crates/aube/src/commands/run.rs"
click node_install_cmd "https://github.com/aubepkg/aube/tree/main/crates/aube/src/commands/install"
click node_resolver "https://github.com/aubepkg/aube/blob/main/crates/aube-resolver/src/resolve/driver.rs"
click node_registry "https://github.com/aubepkg/aube/blob/main/crates/aube-registry/src/client.rs"
click node_lockfiles "https://github.com/aubepkg/aube/tree/main/crates/aube-lockfile/src"
click node_manifest "https://github.com/aubepkg/aube/tree/main/crates/aube-manifest/src"
click node_store "https://github.com/aubepkg/aube/blob/main/crates/aube-store/src/lib.rs"
click node_linker "https://github.com/aubepkg/aube/tree/main/crates/aube-linker/src"
click node_lifecycle "https://github.com/aubepkg/aube/blob/main/crates/aube-scripts/src/lib.rs"
click node_build_policy "https://github.com/aubepkg/aube/blob/main/crates/aube-scripts/src/policy.rs"
click node_workspace "https://github.com/aubepkg/aube/blob/main/crates/aube-workspace/src/selector.rs"
click node_security "https://github.com/aubepkg/aube/blob/main/crates/aube-registry/src/osv_bloom_client.rs"
click node_node_runtime "https://github.com/aubepkg/aube/tree/main/crates/aube-runtime/src"
click node_settings "https://github.com/aubepkg/aube/blob/main/crates/aube-settings/src/values.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_run,node_user toneBlue
class node_resolver,node_registry,node_lockfiles,node_manifest toneAmber
class node_install_cmd,node_store,node_linker toneMint
class node_lifecycle,node_build_policy,node_workspace,node_security toneRose
class node_node_runtime,node_settings,node_registry_service,node_osv_service toneIndigo
```

## Components

### CLI and execution

- [CLI commands](https://github.com/aubepkg/aube/tree/main/crates/aube/src/commands): `crates/aube/src/commands`
- [Run scripts](https://github.com/aubepkg/aube/blob/main/crates/aube/src/commands/run.rs): `crates/aube/src/commands/run.rs`

### Dependency management

- [Dependency resolver](https://github.com/aubepkg/aube/blob/main/crates/aube-resolver/src/resolve/driver.rs): `crates/aube-resolver/src/resolve/driver.rs`
- [Registry client](https://github.com/aubepkg/aube/blob/main/crates/aube-registry/src/client.rs): `crates/aube-registry/src/client.rs`
- [Lockfile formats](https://github.com/aubepkg/aube/tree/main/crates/aube-lockfile/src): `crates/aube-lockfile/src`
- [Manifest handling](https://github.com/aubepkg/aube/tree/main/crates/aube-manifest/src): `crates/aube-manifest/src`

### Install and storage

- [Install workflow](https://github.com/aubepkg/aube/tree/main/crates/aube/src/commands/install): `crates/aube/src/commands/install`
- [Package store](https://github.com/aubepkg/aube/blob/main/crates/aube-store/src/lib.rs): `crates/aube-store/src/lib.rs`
- [Package linking](https://github.com/aubepkg/aube/tree/main/crates/aube-linker/src): `crates/aube-linker/src`

### Workspace and security

- [Lifecycle scripts](https://github.com/aubepkg/aube/blob/main/crates/aube-scripts/src/lib.rs): `crates/aube-scripts/src/lib.rs`
- [Build policy and jail](https://github.com/aubepkg/aube/blob/main/crates/aube-scripts/src/policy.rs): `crates/aube-scripts/src/policy.rs`
- [Workspace selection](https://github.com/aubepkg/aube/blob/main/crates/aube-workspace/src/selector.rs): `crates/aube-workspace/src/selector.rs`
- [Advisory checks](https://github.com/aubepkg/aube/blob/main/crates/aube-registry/src/osv_bloom_client.rs): `crates/aube-registry/src/osv_bloom_client.rs`

### Runtime support

- [Node runtime management](https://github.com/aubepkg/aube/tree/main/crates/aube-runtime/src): `crates/aube-runtime/src`
- [Configuration settings](https://github.com/aubepkg/aube/blob/main/crates/aube-settings/src/values.rs): `crates/aube-settings/src/values.rs`

### Other components

- **Project user**
- **Package registry**
- **OSV advisory service**

## Connections

- Project user → Run scripts: runs script (evidence: `README.md`)
- Project user → CLI commands: invokes commands (evidence: `README.md`)
- Run scripts → Install workflow: checks freshness (evidence: `README.md`)
- Install workflow → Dependency resolver: resolves dependencies
- Dependency resolver → Registry client: fetches metadata (evidence: `crates/aube-resolver/src/resolve/driver.rs`)
- Registry client → Package registry: requests packages
- Install workflow → Lockfile formats: reads and writes (evidence: `README.md`)
- Install workflow → Package store: shares package files (evidence: `README.md`)
- Install workflow → Package linking: links packages
- Install workflow → Lifecycle scripts: runs approved hooks (evidence: `README.md`)
- Lifecycle scripts → Build policy and jail: applies policy (evidence: `crates/aube-scripts/src/lib.rs`)
- Dependency resolver → Advisory checks: checks advisories
- Advisory checks → OSV advisory service: confirms candidates (evidence: `crates/aube-registry/src/osv_bloom_client.rs`)
- CLI commands → Workspace selection: selects workspace packages (evidence: `crates/aube/src/commands/query.rs`)
- CLI commands → Manifest handling: updates dependencies
- Run scripts → Node runtime management: uses project runtime (evidence: `README.md`)
- Install workflow → Configuration settings: uses install settings
- Run scripts → Lifecycle scripts: executes project script
