Skip to content

docs(dev): plan amendments — runtime port surface, engine-aware doctor, testing plan#758

Merged
VijitSingh97 merged 1 commit into
developfrom
docs/plan-runtime-port-surface
Jul 24, 2026
Merged

docs(dev): plan amendments — runtime port surface, engine-aware doctor, testing plan#758
VijitSingh97 merged 1 commit into
developfrom
docs/plan-runtime-port-surface

Conversation

@VijitSingh97

Copy link
Copy Markdown
Collaborator

Amends docs/dev/dual-distribution-plan.md with the findings from the runtime-independence review. Dev doc only — no behaviour change.

  • Runtime port surface (new section): container-engine independence defined as a short, mapped port list, not an abstraction layer. Names the three engine-neutral contracts (OCI images by digest; the four container-API endpoints behind the socket-proxy allowlists; config.json as the only path to runtime files), the four-item engine-specific residue (firewall implementation, doctor host checks, render target, proxy socket), and the structural guardrails — plus the review rule that a PR growing the surface must update the section.
  • Engine-aware doctor (phase 2): doctor's Docker-shaped trio — daemon reachable, docker group, docker.service boot persistence (pithead:720) — misreports under Podman/systemd, and doctor --json is the appliance commit gate. Appliance variants land behind the same check names and --json shape.
  • Testing plan (new section): mapped onto the existing four-tier model, no new model. Parity test at tier 1 with derivation mechanics and the closed-set lock (unrecognized compose key = fail); a Podman lane for the tier-3 mini-stack suite; the appliance tier-4 matrix (A/B commit, fault-injection fallback, migration-withhold proof, netavark egress, first-boot, resets, 7-day soak); installer smoke on the release checklist.
  • One-line manifest note: image ownership is per-service — the Tari node already pins from a foreign registry.

lint-docs-voice + markdownlint pass.

🤖 Generated with Claude Code

…r, testing plan

Three additions to the dual-distribution ADR from the runtime-independence
review:

- A "Runtime port surface" section: the three engine-neutral contracts
  (OCI images by digest, four container-API endpoints behind the proxy
  allowlists, config.json as the only path to runtime files), the four-item
  engine-specific residue, and the review rule that a PR growing the
  surface updates the section.
- Phase 2: doctor grows engine-aware host checks — its Docker-shaped trio
  (daemon reachable, docker group, boot persistence) misreports under
  Podman/systemd, and doctor --json is the appliance commit gate.
- A testing plan mapped onto the existing four-tier model: the parity
  test's derivation mechanics and closed-set lock at tier 1, a Podman
  lane for the tier-3 mini-stack, the appliance tier-4 matrix additions,
  and the installer smoke on the release checklist.
- One-line manifest note: image ownership is per-service (the Tari node
  already pins from a foreign registry).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@VijitSingh97
VijitSingh97 merged commit ebc9b98 into develop Jul 24, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant