docs: the four claims the capability matrix did not reach, and the gate caught the author of this commit (#591) - #596
Merged
Conversation
…te caught the author of this commit (#591) An external audit read `main` on 2026-08-28 and found four sentences the matrix #592 shipped does not yet cover. Each was measured in the files before being touched. **The Quick Start's four commands install feint and not the engine they run.** `examples/quickstart/scaleway/feint.yaml` declares `iac.engine: terraform` and its `main.tf` requires `>= 1.7.0`, so a reader on a bare machine cannot reach the `Apply complete!` the block prints underneath — #593's own complaint, one level out. The block now names Git and the engine above the commands, and the version is read from the declaration and the `required_version` rather than typed beside them: a number written next to a file that owns it goes stale in silence, which is exactly what happened to the resource count. **"No credentials" was not what is true.** The quickstart carries a fake access key and secret key on purpose, because the official client requires syntactically valid values. It says "no cloud credentials" now, in both languages. **Two sentences asserted an implicit matrix.** `docs/install.md` said "`scw`, `octl`, `exo` and Terraform drive it" without saying which packs an engine drives. And the safety block said "`scw`, `octl`, `exo`, Terraform and OpenTofu run against the emulator in CI". That last one is the part worth recording. The first rewrite of it — naming three CLIs and two providers in one unit — was **refused by the gate #592 shipped two hours earlier**, four times over: `exo`×Outscale, `exo`×Scaleway, `octl`×Scaleway, `scw`×Outscale, none of which the matrix carries. The claim reader treats a unit naming several packs and several clients as asserting every pair, which is the argument that lot's own report made, and which the author of this commit then walked into. The sentence now names no pair at all: each pack's own official CLI, and an infrastructure engine wherever a pack admits one. The repository description on GitHub carried the same ambiguity and is corrected by hand — it is outside everything `feint docs --check` can reach, and that is worth knowing rather than assuming a gate covers it. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
`maquettes-site/` sat untracked in the working tree. Untracked is not pushed — git ships commits and it was in none — but untracked is also one `git add -A` away from being staged by somebody in a hurry, and the ignore line that was there had already been lost once to a pre-commit stash and restore. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Four sentences the capability matrix of #592 does not yet reach, each measured in
the files before being touched. Part of #591, and deliberately not its
P1s.
The Quick Start's four commands install feint and not the engine they run
examples/quickstart/scaleway/feint.yamldeclaresiac.engine: terraformandits
main.tfrequires>= 1.7.0. The block installs feint, clones, changesdirectory and runs — so a reader on a bare machine cannot reach the
Apply complete!the block prints underneath. That is #593's own complaint,one level out: a Quick Start displaying an output its own commands cannot
produce.
It now names Git and the engine above the commands:
The version is read, never typed — from the declaration's
engine:and theconfiguration's
required_version. A number written beside a file that owns itgoes stale in silence, which is precisely what happened to the resource count
this same block had to stop inventing. When either is missing the line is
omitted rather than guessed: a prerequisite naming a version nobody declared is
worse than none, because a reader installs it and still fails.
"No credentials" was not what is true
The quickstart carries a fake access key and secret key on purpose — the
official client requires syntactically valid values, and they are deliberately
public. It says "no cloud credentials" now, in both languages.
Two sentences asserted an implicit matrix
docs/install.mdsaid "scw,octl,exoand Terraform drive it" withoutsaying which packs an engine drives.
And the safety block said "
scw,octl,exo, Terraform and OpenTofu runagainst the emulator in CI".
The part worth recording: the gate caught the author of this commit
The first rewrite of that safety sentence named three CLIs and two providers
in one unit.
docs:checkrefused it four times over:The claim reader treats a unit naming several packs and several clients as
asserting every pair — which is exactly the argument #592's own report made
two hours earlier, and which the author of this commit then walked into.
The sentence now names no pair at all: each pack's own official CLI, and an
infrastructure engine wherever a pack admits one.
A gate shipped this afternoon refusing this afternoon's next commit is the best
evidence it works that this branch could offer.
Outside every gate: the repository description
Corrected by hand, because it is outside everything
feint docs --checkcanreach. Worth knowing rather than assuming a gate covers it.
Also here, and unrelated
maquettes-site/sat untracked in the working tree. Untracked is not pushed— git ships commits and it was in none, verified — but untracked is one
git add -Aaway from being staged, and the ignore line that had been there wasalready lost once to a pre-commit stash and restore. It is ignored now.
Gates
mise run prepush0 ·mise run docs:check0 — and 2 on the first rewrite,which is the finding above.
What is deliberately not here
The P1s of #591 — a
docs/index, the user-versus-fidelity CLI split, a shortlimits summary above the 3489-line record,
confidence.mdas an entry point —are structure, not fidelity, and they deserve their own lot.
docs/limits.mdis untouched because another lot is measuring #587 and may write there.