## :pencil: Summary Track delivery of the **S04 Phase 1 Foundation Harness**: the binary + `pkg/` code that makes S04's three contract layers executable end-to-end against empty per-format catalogs. After this plan's last MR merges, `registry-conformance run --format=npm --registry-url=…` exits cleanly: prints a Summary, emits valid JUnit XML on `--report`, logs to stderr with `run_id` on every entry. Per-format catalogs and test cases (\~100 MRs across three formats) plug into this foundation. ## :link: Spec and plan - :scroll: Spec: [S04 Contracts](https://gitlab.com/gitlab-org/ops/registry-conformance/-/blob/main/docs/specs/S04-contracts.md) - :clipboard: Plan: [2026-05-08 S04 Foundation](https://gitlab.com/gitlab-org/ops/registry-conformance/-/blob/main/docs/plans/2026-05-08-s04-foundation.md) ## :tools: Scope Per the plan's Approach section, \~26 MRs across four MR Groups: 1. **MR Group 1 — `pkg/conformance` foundation** (\~12 MRs): Public type vocabulary, runner, redaction primitives, per-format module shells, per-format HTTP client shells. 2. **MR Group 2 — `internal/cli` + binary entry-point** (\~8 MRs): Flag parsing, validation, credential parsing, `run` and `list` subcommands, exit-code mapping. 3. **MR Group 3 — `internal/report`** (\~5 MRs): Stdout report renderer, redacting slog JSON handler, JUnit XML serializer. 4. **MR Group 4 — `pkg/conformance/cliexec`** (1 MR): Concrete `Executor` type implementing `CLIExecutor`. ## :chart_with_upwards_trend: Status | Step | Description | MR | Status | Done | Assignee | Dependencies | |------|-------------|----|--------|------|----------|--------------| | 1 | pkg/conformance types and config (MR 1.1) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/39 | ~"workflow::complete" | [x] | @radbatnag | — | | 2 | runid (MR 1.2) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/48 | ~"workflow::complete" | [x] | @sylviashen | — | | 3 | Module interfaces (MR 1.3) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/50 | ~"workflow::complete" | [x] | @radbatnag | Step 1 | | 4 | redact primitives (MR 1.4) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/43 | ~"workflow::complete" | [x] | @mkhalifa3 | | | 5 | logger helpers (MR 1.5) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/45 | ~"workflow::complete" | [x] | @radbatnag | — | | 6 | Config validation (MR 1.6) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/55 | ~"workflow::complete" | [x] | @mkhalifa3 | Step 1 | | 7 | per-format Module shells (MR 1.7) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/56 | ~"workflow::complete" | [x] | @mkhalifa3 | Steps 1, 3 | | 8 | per-format Client shells (MR 1.8) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/57 | ~"workflow::complete" | [x] | @mkhalifa3 | Steps 1, 4 | | 9 | Run and RunModule + smoke tests (MR 1.9) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/68 | ~"workflow::complete" | [x] | @mkhalifa3 | Steps 1, 2, 3, 5, 6, 7 | | 10 | filter and priority tests (MR 1.10) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/134 | ~"workflow::complete" | [x] | @mkhalifa3 | Step 9 | | 11 | lifecycle tests (MR 1.11) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/136 | ~"workflow::complete" | [x] | @mkhalifa3 | Step 9 | | 12 | CLI flags (MR 2.1) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/61 | ~"workflow::complete" | [x] | @radbatnag | Step 1 | | 13 | credential parsing (MR 2.2) | !64 | ~"workflow::complete" | [x] | @radbatnag | Step 1 | | 14 | CLI run-id resolution (MR 2.3) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/58 | ~"workflow::complete" | [x] | @sylviashen | — | | 15 | CLI logger wiring (MR 2.4) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/62 | ~"workflow::complete" | [x] | @radbatnag | Step 1 | | 16 | exit-code mapping (MR 2.5) | !66 | ~"workflow::complete" | [x] | @sylviashen | Step 6 | | 17 | list subcommand (MR 2.6) | !76 | ~"workflow::complete" | [x] | @radbatnag | Steps 12, 7 | | 18 | run subcommand (MR 2.7) | !79 | ~"workflow::complete" | [x] | @mkhalifa3 | Steps 12, 13, 14, 15, 9 | | 19 | binary entry-point (MR 2.8) | !83 | ~"workflow::complete" | [x] | @radbatnag | Steps 16, 17, 18 | | 20 | duration and detail rendering (MR 3.1) | !74 | ~"workflow::complete" | [x] | @sylviashen | Steps 1, 4 | | 21 | stdout renderer (MR 3.2) | !87 | ~"workflow::complete" | [x] | @mkhalifa3 | Steps 1, 20 | | 22 | redacting slog handler (MR 3.3) | !71 | ~"workflow::complete" | [x] | @radbatnag | Step 4 | | 23 | JUnit XML renderer (MR 3.4) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/90 | ~"workflow::complete" | [x] | @mkhalifa3 | Steps 1, 20 | | 24 | report wire-up (MR 3.5) | https://gitlab.com/gitlab-org/ops/registry-conformance/-/merge_requests/117 | ~"workflow::complete" | [x] | @mkhalifa3 | Steps 21, 22, 23, 15, 19 | | 25 | cliexec Executor (MR 4.1) | !84 | ~"workflow::complete" | [x] | @radbatnag | Steps 3, 4 | | 26 | catalogparse cross-format helper (MR 1.12) | !89 | ~"workflow::complete" | [x] | @radbatnag | — | ## :link: Dependencies - **Spec S04** (`docs/specs/S04-contracts.md`) — merged and locked. - **Per-format specs S05 (Maven), S06 (npm), S07 (OCI)** — not required for this plan, but required before per-format implementation plans can begin. ## :no_entry_sign: Deferred Acceptance Criteria Per the plan's Deferred Acceptance Criteria section: - **AC #60 (exit-0 iff)** — deferred to per-format plans - **AC #61 (exit-1 outcome)** — deferred to per-format plans - **AC #62 partial** — env-setup failed, ctx cancelled e2e, output channel write failure conditions deferred - **AC #72 second clause** — `"registry unreachable: "` prefix deferred to per-format plans