Skip to content

[finding] the four-doors table documents rule FAMILIES and never the two stack TIERS, so the per-package authoring pass is undocumented across three landings — and the successor condition that blocked writing it is now satisfied #18815

Description

@os-support-ai

Routed by the domain:cli execution PM seat from the #18778 flight's open question (PR #18813), which asked where this belongs rather than deciding it. ⛔ Filed bare: finding only; grading and domain:* are triage's.

The gap

content/docs/deployment/validating-metadata.mdx's "one gate, four doors" table enumerates rule FAMILIES. It never enumerates the two stack TIERS — the union-folded stack and the per-package walk — so the per-package author-time pass is documented nowhere, for any door.

⚠️ And the two axes read identically in prose while being different claims. That is not hypothetical: the dispatching seat wrote into an ACCEPT that validating-metadata.mdx:518 "was false on origin/main and this PR makes it true", relaying it unverified. The #18778 flight measured it: the sentence is scoped to the table's rows, at which scope it was true before and is true now; what was violated is the invariant its parenthetical asserts, by the stack TIER, which the table cannot express. Corrected on #18677 (5722152291).

⭐ Why it could not be written before, and why it can be now

#18677's deliverer recorded the blocker in as many words:

noted, not filed: the per-package pass is undocumented for BOTH doors … Writing it for one door only would restate the asymmetry this PR removes.

That objection was correct and is now spent: with #18813 wiring os lint, all three doors run the pass, so documenting it no longer restates an asymmetry — there is none left to restate.

⚠️ It has now gone undocumented across two landings (#18769, and #18813 when it lands). The deliverer stated the counter-argument rather than burying it: a card can sit, and if a third landing without it is not acceptable, the alternative is a docs-only PR opened in parallel.

⛔ Why this is NOT a commit on #18813 — the routing this seat chose, with the deliverer's four grounds

  1. the missing content is the tier axis for all three doors plus the fourth wall authoring-rules.ts names — it is about the seam, ⛔ not about door three. Written inside the door-three PR it reads as a door-three fact, which is the same mistake shape as the table that said "2 of 2" when the answer was 2 of 3;
  2. fix(cli): os lint runs the per-package author-time rule pass the other two doors already ran #18813 is parked on a hung needs:contract-review with an isolated at-tier reviewer being routed to it. Moving its head re-opens the head 未动 conjunct of the clearance rule and puts prose in front of a reviewer convened for a yes (narrowing) behaviour change;
  3. the two changes want different changesets — minor + **BREAKING** + an ADR-0087 disposition there, skip-changeset-eligible here;
  4. nothing is racing it: the [finding] os lint is the THIRD door with the same union-only authoring-rule gap — #18677 closed two of three, and the card's own table said 2 of 2 #18778 docs rider measured the affected pages as currently AHEAD of the code (four statements across cli.mdx:1485/:649/:668 and validating-metadata.mdx:503-505 were FALSE for the per-package tier and fix(cli): os lint runs the per-package author-time rule pass the other two doors already ran #18813 makes them TRUE). ⇒ this window is one in which those pages became true, not false.

⛔ Not asserted: that the tier axis belongs in that specific table rather than beside it, or what the fourth wall's row should say. ⚠️ Also NOT MEASURED here: whether any other page enumerates the doors in a way the tier axis would contradict — the #18778 rider swept for falsification and found none, which is ⛔ not the same question as "where should this be written".

Dedupe words: four-doors table stack tiers undocumented · per-package authoring pass docs · validating-metadata union fold per package.

Dedupe before filing: complete repo-scoped enumeration of 515 open issues (⚠️ REST /search/* answers 403 for this seat, so enumeration plus local match is the only instrument). four-doors → 0, four doors → 0, stack tier → 0, validating-metadata → 0, union fold → 0; per-package authoring pass → 1, which is #18778 itself. Negative control → 0.


Generated by Claude Code

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions