apt-ostree/docs/cli-parity-checklist.md
robojerk 3dec23f8f7 Fix YAML linting issues and update system requirements to Debian 13+
- Fix trailing spaces and blank lines in Forgejo workflows
- Update system requirements from Ubuntu Jammy/Bookworm to Debian 13+ (Trixie)
- Update test treefile to use Debian Trixie instead of Ubuntu Jammy
- Update documentation to reflect modern system requirements
- Fix yamllint errors for CI/CD functionality
- Ensure compatibility with modern OSTree and libapt versions
2025-08-18 11:39:58 -07:00

101 lines
2.6 KiB
Markdown

## CLI Parity Checklist (apt-ostree vs rpm-ostree)
Source references:
- rpm-ostree builtins: `inspiration/rpm-ostree/src/app/` (files named `rpmostree-builtin-*.cxx` and related `*-builtins*`)
- apt-ostree CLI: `src/cli.rs`
### rpm-ostree top-level commands detected
- status
- upgrade
- rollback
- deploy
- rebase
- initramfs
- initramfs-etc
- kargs
- reload
- cancel
- reset
- refresh-md
- compose
- override
- apply-live
- finalize-deployment
- cleanup
- start-daemon
- db
- ex (group)
- testutils (hidden)
- shlib-backend (hidden)
### apt-ostree top-level commands (src/cli.rs)
- Status
- Upgrade
- Rollback
- Deploy
- Rebase
- Install
- Uninstall
- Search
- Initramfs
- InitramfsEtc
- Kargs
- Reload
- Cancel
- Transaction (group)
- Compose (group)
- Db (group)
- Override (group)
- Reset
- RefreshMd
- ApplyLive
- Usroverlay
- Cleanup
- FinalizeDeployment
- Metrics
- StartDaemon
- Ex (group)
- Countme
- Container (group)
- Testutils (hidden)
- ShlibBackend (hidden)
- Internals (hidden)
### Parity status
- status: present (Status)
- upgrade: present (Upgrade)
- rollback: present (Rollback)
- deploy: present (Deploy)
- rebase: present (Rebase)
- initramfs: present (Initramfs)
- initramfs-etc: present (InitramfsEtc)
- kargs: present (Kargs)
- reload: present (Reload)
- cancel: present (Cancel)
- reset: present (Reset)
- refresh-md: present (RefreshMd)
- compose: present (Compose)
- override: present (Override)
- apply-live: present (ApplyLive)
- finalize-deployment: present (FinalizeDeployment)
- cleanup: present (Cleanup)
- start-daemon: present (StartDaemon)
- db: present (Db)
- ex: present (Ex)
- testutils (hidden): present (Testutils)
- shlib-backend (hidden): present (ShlibBackend)
### Differences and extras
- install/uninstall: present in apt-ostree; maps to rpm-ostree package layering builtins (expected)
- search: present in apt-ostree; rpm-ostree has `db search` flows (OK)
- transaction (group): apt-ostree adds management helpers; aligns with rpm-ostree transaction concepts
- usroverlay: extra in apt-ostree (not a top-level in rpm-ostree; keep as experimental)
- metrics: extra in apt-ostree (telemetry; not in rpm-ostree)
- countme: extra in apt-ostree (dnf concept; not in rpm-ostree)
- container (group): extra in apt-ostree (rpm-ostree has container helpers but not a top-level group)
- internals (hidden): extra diagnostics; acceptable as hidden
### Next actions for strict parity
- Review and align flags/options per command against rpm-ostree
- Ensure help text and defaults match where applicable
- Gate non-parity extras (`usroverlay`, `metrics`, `countme`, `container`) behind experimental or hidden flags if needed