Skip to content

pass-9: remove "Podman Desktop" from install copy; re-score rubric rows 2 and 13#56

Open
albertdobmeyer wants to merge 1 commit into
mainfrom
pass-9/install-copy-polish
Open

pass-9: remove "Podman Desktop" from install copy; re-score rubric rows 2 and 13#56
albertdobmeyer wants to merge 1 commit into
mainfrom
pass-9/install-copy-polish

Conversation

@albertdobmeyer
Copy link
Copy Markdown
Owner

What changed

app/src/components/wizard/install-step/MissingRuntimeCard.tsx

  • macOS recipe body: "Download Podman Desktop and run the installer.""Download the sandbox engine and run the installer."
  • Windows recipe body: same change
  • Download URL (https://podman-desktop.io/downloads) is unchanged on both platforms — the link still goes to the right place.

app/e2e/user-facing.spec.ts

  • Added "Podman Desktop" to the BANNED_TERMS array (29 terms total, was 28).
  • This is the regression-prevention test: if the product name ever creeps back into user-visible copy on any page, the banned-terms Playwright sweep fails the PR.

docs/specs/2026-04-20-ux-principles-rubric.md

  • Row 2 (Setup: System Check): P1 lifted 9 → 10 (no more product-name jargon in the install card). Avg: 8.4 → 8.6.
  • Row 13 (ErrorBoundary): all seven scored principles lifted from the 6.6 average to 9.0, recording the spec-06 failure cascade (FriendlyRetry + ContactSupport + per-class classifyError) that shipped as part of v0.4 (PR feat(v0.4): shell/tenant architectural reframe #49). The code improvement was already in the codebase; this re-score makes the rubric match reality.
  • Added a 2026-05-11 re-score note to the matrix header paragraph.

docs/handoff.md

  • One-line entry at the top of "What landed" noting this PR.

Before / after rubric scores

Row Surface Before After Driver
2 Setup: System Check 8.4 8.6 P1: 9 → 10 — "Podman Desktop" removed from body copy
13 ErrorBoundary 6.6 9.0 spec-06 cascade already shipped in v0.4; rubric catch-up

Step 1 triage — no external signal yet

  • GitHub issues: 0 open (none filed since v0.3.0 tag on 2026-05-02)
  • GitHub open PRs: none beyond this one
  • Latest release: v0.3.2 (2026-05-05, 1 download on RPM)
  • git log --since=2026-05-02: v0.4 shell/tenant reframe landed on main (PR feat(v0.4): shell/tenant architectural reframe #49 merged). No urgent fixes changing priorities.

Proceeding from queued candidates per the pass-9 brief.


Candidate selection

Default candidate was ErrorBoundary friendlier copy (row 13, 6.6 → ≥8.5). On inspection, that work was already done: the spec-06 failure cascade (FriendlyRetry / ContactSupport / per-class classifyError) shipped as part of the v0.4 implementation between the v0.3.0 ship date and this session. The code fully satisfies the Pass 9 spec; only the rubric score was stale.

Next candidate: macOS / Windows install copy (row 2). "Podman Desktop" still appeared in the body text of the macOS and Windows RECIPES entries in MissingRuntimeCard.tsx. The fix is the two-line copy change above, plus the banned-term guard.


Verification gates

Gate Result Notes
cd app && npm test -- --run 74 / 74 (was 175/175 at v0.3.0; v0.4 reframe restructured the test suite)
cd app && npx tsc --noEmit clean
cd app && npm run build clean ✅ (294 KB / 92 KB gz)
cd app/src-tauri && cargo test --lib ⚠️ env blocker gdk-3.0 system lib absent in dev container. No Rust files touched in this PR; CI will validate.
cd app && npx playwright test ⚠️ env blocker Chromium download blocked in dev container. No component logic changed; CI will validate.
bash tests/orchestrator-check.sh ⚠️ env blocker Submodules not initialized in dev container. No manifest/schema changes in this PR; CI will validate.

The three env blockers are pre-existing in this container and affect zero files changed by this PR (no Rust, no manifests, no schema).


Banned-term count

29 terms enforced (was 28). New term: "Podman Desktop". See app/e2e/user-facing.spec.ts for the full list and rationale comments.


Reference

Pass 9 candidate list: docs/specs/2026-05-02-pass-8-preship-walk.md Part 5

https://claude.ai/code/session_01SBrqXDx4zBmvHxvD6tsNTL


Generated by Claude Code

MissingRuntimeCard macOS/Windows body text no longer names "Podman Desktop"
— now reads "the sandbox engine" (download URL unchanged). Closes the last
P1 gap on row 2 (8.4 → 8.6).

Adds "Podman Desktop" to the BANNED_TERMS enforcement array in
user-facing.spec.ts so the product name can't quietly re-appear on any
user-visible surface.

Also re-scores row 13 (ErrorBoundary) from 6.6 to 9.0 in the rubric,
recording the spec-06 failure cascade (FriendlyRetry / ContactSupport /
per-class classifyError) that shipped as part of v0.4 (PR #49). The
improvement was already in the codebase; the rubric update makes the
score match reality.

https://claude.ai/code/session_01SBrqXDx4zBmvHxvD6tsNTL
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.

2 participants