How aubepkg/aube works
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: install Install workflow · run.rs Run scripts · commands CLI commands · driver.rs Dependency resolver
Components 18
CLI and execution
- CLI commands
crates/aube/src/commands - Run scripts
crates/aube/src/commands/run.rs
Dependency management
- Dependency resolver
crates/aube-resolver/src/resolve/driver.rs - Registry client
crates/aube-registry/src/client.rs - Lockfile formats
crates/aube-lockfile/src - Manifest handling
crates/aube-manifest/src
Install and storage
- Install workflow
crates/aube/src/commands/install - Package store
crates/aube-store/src/lib.rs - Package linking
crates/aube-linker/src
Workspace and security
- Lifecycle scripts
crates/aube-scripts/src/lib.rs - Build policy and jail
crates/aube-scripts/src/policy.rs - Workspace selection
crates/aube-workspace/src/selector.rs - Advisory checks
crates/aube-registry/src/osv_bloom_client.rs
Runtime support
- Node runtime management
crates/aube-runtime/src - Configuration settings
crates/aube-settings/src/values.rs
Other components
- Project user
- Package registry
- OSV advisory service
Connections 18
- Project user → Run scripts: runs script
README.md - Project user → CLI commands: invokes commands
README.md - Run scripts → Install workflow: checks freshness
README.md - Install workflow → Dependency resolver: resolves dependencies
- Dependency resolver → Registry client: fetches metadata
crates/aube-resolver/src/resolve/driver.rs - Registry client → Package registry: requests packages
- Install workflow → Lockfile formats: reads and writes
README.md - Install workflow → Package store: shares package files
README.md - Install workflow → Package linking: links packages
- Install workflow → Lifecycle scripts: runs approved hooks
README.md - Lifecycle scripts → Build policy and jail: applies policy
crates/aube-scripts/src/lib.rs - Dependency resolver → Advisory checks: checks advisories
- Advisory checks → OSV advisory service: confirms candidates
crates/aube-registry/src/osv_bloom_client.rs - CLI commands → Workspace selection: selects workspace packages
crates/aube/src/commands/query.rs - CLI commands → Manifest handling: updates dependencies
- Run scripts → Node runtime management: uses project runtime
README.md - Install workflow → Configuration settings: uses install settings
- Run scripts → Lifecycle scripts: executes project script