How jsonbored/aio-fleet works
AIO Fleet is a Python control plane and CLI for managing a fleet of Unraid app repositories. Its main workflow starts with manifest-driven repository discovery, runs validation and required GitHub checks, then coordinates upstream updates, release readiness, registry verification, and fleet reporting. Separate branches cover catalog synchronization, alerting, cleanup, and local check overlays. The README documents these capabilities; source excerpts and the SOURCE INDEX establish some internal links, but unsampled implementation details are not inferred.
Main entry points: cli.py Fleet CLI · upstream.py Upstream monitor · hooks.py Local hooks · control_plane.py Control plane
Components 29
Fleet control
- Fleet CLI
src/aio_fleet/cli.py - Fleet manifest
src/aio_fleet/manifest.py - Repository polling
src/aio_fleet/poll.py - Control plane
src/aio_fleet/control_plane.py
Validation and checks
- Required checks
src/aio_fleet/checks.py - Repository validators
src/aio_fleet/validators.py - Change safety
src/aio_fleet/safety.py - Workflow security
src/aio_fleet/workflow_security.py - App test support
src/aio_fleet/app_testing.py
Updates and releases
- Upstream monitor
src/aio_fleet/upstream.py - Release planning
src/aio_fleet/release_plan.py - Changelog rendering
src/aio_fleet/changelog.py - Release execution
src/aio_fleet/release_transaction.py - Commit signing
src/aio_fleet/signing.py - Registry operations
src/aio_fleet/registry.py
Fleet operations
- Catalog sync
src/aio_fleet/catalog.py - Fleet dashboard
src/aio_fleet/fleet_dashboard.py - Fleet reports
src/aio_fleet/report.py - Fleet alerts
src/aio_fleet/alerts.py - Repository cleanup
src/aio_fleet/cleanup.py - Local hooks
src/aio_fleet/hooks.py - Trunk overlay
src/aio_fleet/trunk_overlay.py - App manifest export
src/aio_fleet/app_manifest.py
External integrations
- GitHub
- App repositories
- Docker Hub and GHCR
- awesome-unraid catalog
- Heartbeat and webhooks
Other components
- Operator
Connections 32
- Operator → Fleet CLI: runs commands
README.md - Fleet CLI → Fleet manifest: validates and reads
README.md - Fleet CLI → Repository polling: starts polling
README.md - Repository polling → Required checks: creates or updates
README.md - Required checks → GitHub: posts check runs
src/aio_fleet/checks.py - Fleet CLI → Control plane: runs control path
README.md - Control plane → App repositories: runs repo checks
README.md - Fleet CLI → Repository validators: validates repositories
README.md - Fleet CLI → Change safety: assesses changes
README.md - Fleet CLI → Workflow security: audits workflows
README.md - Fleet CLI → App test support: supports app tests
README.md - Fleet CLI → Upstream monitor: monitors upstream
README.md - Upstream monitor → App repositories: updates and opens PRs
README.md - Upstream monitor → GitHub: writes PRs
src/aio_fleet/upstream.py - Fleet CLI → Release planning: plans releases
README.md - Release planning → Changelog rendering: uses release data
src/aio_fleet/release_plan.py - Fleet CLI → Release execution: prepares and publishes
README.md - Release execution → Commit signing: checks signatures
src/aio_fleet/release_transaction.py - Fleet CLI → Registry operations: verifies and publishes
README.md - Registry operations → Docker Hub and GHCR: checks image tags
README.md - Fleet CLI → Catalog sync: syncs catalog assets
README.md - Catalog sync → awesome-unraid catalog: stages assets
README.md - Fleet CLI → Fleet dashboard: updates dashboard
README.md - Fleet CLI → Fleet reports: generates reports
README.md - Fleet CLI → Fleet alerts: sends alerts
README.md - Fleet alerts → Heartbeat and webhooks: sends heartbeat and digests
README.md - Fleet CLI → Repository cleanup: checks repository drift
README.md - Fleet CLI → Local hooks: installs hooks
README.md - Local hooks → Control plane: runs central checks
src/aio_fleet/hooks.py - Local hooks → Trunk overlay: uses overlay
src/aio_fleet/hooks.py - Fleet CLI → App manifest export: exports app contract
README.md - Fleet manifest → App repositories: defines fleet metadata
README.md