Pressure-testing Ota on Discourse: repo-wrapper truth matters more than a passing bundle command

Discourse turned out to be a good pressure repo for a narrow but important reason:

the difference between bundle existing and the repo's real Bundler path being truthful is not cosmetic.

This repo already had a wrapper at bin/bundle. That wrapper is part of how the repo expresses and activates its Bundler lane. If a readiness contract ignores that and just says "run bundle", it is not preserving repo truth. It is flattening it.

That is exactly the kind of thing pressure testing should catch.

Before the contract was tightened, the repo already had real working paths:

• Ruby and Bundler were core to the baseline contributor surface
• the repo shipped a Bundler wrapper
• the container path depended on the repo-owned dev image

The problem was not that the repo lacked commands. The problem was that a naive contract can choose the wrong command and still look plausible.

That is dangerous because a readiness contract is supposed to make execution semantics more honest, not more generic.

The key contract mistake was simple:

• using plain bundle ...
• instead of the repo wrapper bin/bundle ...

That looked harmless until it was pressure-tested through real execution.

It was not harmless.

The wrapper is where repo truth lives. It is what ties command execution back to the Bundler lane the repo actually expects. If the contract bypasses it, then the contract is no longer modeling the repo. It is modeling an easier parallel story.

That is the wrong standard.

Discourse also exposed a real Ota product gap.

Ota initially treated the Bundler ownership/version surface too literally around the executable name. The contract could declare Bundler truth, but execution and diagnosis still needed to understand that bundle is the real command surface for Bundler, and that a repo-local wrapper like bin/bundle is not the same thing as a global host tool.

That pressure produced two useful fixes:

• Bundler alias/version truth had to stay attached when the executable path was bundle
• repo-local executables like bin/bundle could not be inferred as global host tools

Those are the right product fixes. They belong in Ota, not in repo-local workarounds.

The cleared Discourse slice is intentionally narrow.

It models:

• baseline Ruby and Bundler verification
• repo-wrapper-based Bundler truth through bin/bundle
• native and container verification on the repo-owned dev image

It does not claim the broader mixed Ruby plus pnpm frontend pressure lane in the upstream-ready branch.

That matters.

A pressure branch can explore broader surfaces. A PR-ready contract should only claim what has been proven and what the repo should actually own as a stable readiness path.

For Discourse, the honest baseline is the Ruby and Bundler slice.

The matrix is doing the right kind of work:

• ota validate
• ota doctor
• ota tasks --use
• native dry-runs
• container dry-runs
• native execution
• container execution
• workflow verification through the declared verify path

That gives us something stronger than a contract that merely parses.

It proves that the contract and the repo agree about the baseline execution surface they are claiming.

Discourse is a good example of a subtle but important rule:

repo readiness is not just about whether a command works. It is about whether the contract preserves the command boundary the repo itself depends on.

If a repo ships a wrapper because that wrapper carries real execution meaning, the contract should model that wrapper. It should not sand it down into a generic command just because the generic command feels simpler.

That is where readiness tooling either becomes infrastructure or stays documentation theater.

This pass pushed Ota in the right direction:

• keep executable truth attached to repo-owned tool semantics
• respect repo-local wrappers when they are part of the real path
• keep the upstream contract on the narrower proven slice instead of over-claiming a broader mixed-stack story

That is the standard pressure testing should enforce more often.

Links:

• Contract: discourse ota.yaml
• Matrix workflow: test-ota-contract-matrix.yml
• Green matrix run: #27070708318
• PR: discourse/discourse#40620