V1: unify pkg6repo import commands into `import archive` and `import source` #55

New issue

Open

opened 2026-09-27 13:13:18 +00:00 by toasterson · 0 comments

toasterson commented

2026-09-27 13:13:18 +00:00

Owner

Part of #24. Decided in ADR-015 item 4 (wayfinder ticket #25); raised in #40.

Task

Rename before the v1.0.0 tag so operators and the CI import script never see a rename after release:

pkg6repo import-pkg5 <p5p|dir> becomes pkg6repo import archive <p5p|dir>: whole-batch, validated in memory, one generation switch or full rejection (ADR-007, ADR-013 budgets).
pkg6repo import-historical plan|run|publish|status <dir> becomes pkg6repo import source plan|run|publish|status <dir>: staged batches, durable progress, one final switch (ADR-014).

Backend contracts (repository::pkg5_import, repository::historical_import) are unchanged. Update together: clap surface, the release/CI import script, test-release-scripts.sh inventory, the illumos pkg6repo(1) page, the mdBook importing and historical-imports chapters, and CONTEXT.md (archive import / source import). Old names may remain as hidden aliases for one release with a deprecation warning, or be removed outright; either is acceptable, document which.

Done when

pkg6repo import --help lists exactly archive and source; old spellings either warn or fail with a pointer.
The same atomic and staged test suites pass under the new names on Linux and illumos CI.
Man page and book render the new names; check-book.sh passes.

Part of #24. Decided in ADR-015 item 4 (wayfinder ticket #25); raised in #40. ## Task Rename before the `v1.0.0` tag so operators and the CI import script never see a rename after release: - `pkg6repo import-pkg5 <p5p|dir>` becomes **`pkg6repo import archive <p5p|dir>`**: whole-batch, validated in memory, one generation switch or full rejection (ADR-007, ADR-013 budgets). - `pkg6repo import-historical plan|run|publish|status <dir>` becomes **`pkg6repo import source plan|run|publish|status <dir>`**: staged batches, durable progress, one final switch (ADR-014). Backend contracts (`repository::pkg5_import`, `repository::historical_import`) are unchanged. Update together: clap surface, the release/CI import script, `test-release-scripts.sh` inventory, the illumos `pkg6repo(1)` page, the mdBook importing and historical-imports chapters, and `CONTEXT.md` (archive import / source import). Old names may remain as hidden aliases for one release with a deprecation warning, or be removed outright; either is acceptable, document which. ## Done when - `pkg6repo import --help` lists exactly `archive` and `source`; old spellings either warn or fail with a pointer. - The same atomic and staged test suites pass under the new names on Linux and illumos CI. - Man page and book render the new names; `check-book.sh` passes.

toasterson added this to the Release 1 (server only) milestone

2026-09-27 13:13:18 +00:00

toasterson added the

Kind/Enhancement

wayfinder:task

labels

2026-09-27 13:13:18 +00:00

toasterson referenced this issue

2026-09-27 13:13:25 +00:00

Define what 'v1.0 server release' must include and its acceptance criteria #25

toasterson referenced this issue

2026-09-27 13:14:08 +00:00