Skip to content

fix(gates 56-64): six gates passed over an unopened scope, and three could not see the defect they exist to catch - #278

Merged
rubenvdlinde merged 5 commits into
mainfrom
fix/gates-56-64-acceptance
Aug 9, 2026
Merged

fix(gates 56-64): six gates passed over an unopened scope, and three could not see the defect they exist to catch#278
rubenvdlinde merged 5 commits into
mainfrom
fix/gates-56-64-acceptance

Conversation

@rubenvdlinde

@rubenvdlinde rubenvdlinde commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

What this is

The acceptance test applied to all nine gates in the 56–64 band: plant one textbook true positive in a real fleet repo, require the gate to FAIL and name it, remove the plant, require the prior verdict back, and require a clean fixture to still pass. Then three further arms a planted TP cannot reach: a crashed checker, an na over a repo full of the subject, and a count returned as an exit status.

Measured against gate package 48c88ba; this branch is 298f975.

gate planted true positive repos (two shapes) fired? repaired?
56 register-handler-resolution missing guard class + real class/missing method; enum/interface/trait/final readonly at a DI-bound path shillinq (153 registers) + fixture ⚠️ 4 false positives ✅ + crash + scope
57 orphaned-write-capability publishScore() with zero callers shillinq (316 services) + fixture ✅ MCP seam + crash + scope
58 e2e-networkidle live waitForLoadState + goto(waitUntil:), comment on the line above shillinq (60 e2e files) + fleet glob audit ✅ 2 calls, comment ignored scope verdict only
59 unclosable-gate config key read, never written docudesk + fixture wrong in both directions
60 icon-vocabulary invented MDI · Tier A on wrong glyph · unbridged icon-* shillinq (233 manifests) + fixture ✅ all three states scope verdict only
61 listener-work-placement post-ObjectCreatedEvent listener doing HTTP I/O shillinq (15 registrations) scope verdict only
62 store-plane Store menu entry on ViewGridOutline shillinq scope verdict only
63 settings-surface adminSettings[] in the manifest shillinq + controller-only fixture ✅ reason was an overclaim
64 apphost-autoload-prelude class_exists() on AppHost — all four spellings larpingapp (eager) + launchpad (lazy) ⚠️ 1 of 4, and a false positive

Seven defects

1. An unopened scope is not a PASS — gates 56, 57, 58, 59, 60, 61. #242/#240/#268 reached gates 19, 25, 62, 63 and nothing else. On shillinq with one docs-only commit, all six printed PASS over scopes they never opened, beside 62/63 correctly printing NOT APPLICABLE. --require-full-coverage cannot see a PASS.

2. Gate 59 could not run a full-tree audit at all. CHANGED_FILES is populated only under --scope-to-diff; the guard grepped it unconditionally, so every unscoped run printed PASS having walked no PHP.

3. Gate 59 was wrong in both directions at once (#184's shape). A commented-out // TODO: setValueString(…) counted as a write; a double-quoted key was invisible; read 'k' + write "k" was a false positive with no remedy but changing quote style; a key in a class constant was invisible.

4. Gate 57's MCP seam dissolved on a leading backslash. Both halves of the #200/#215 seam required every namespace segment to start with a letter, so \OCA\App\Mcp\Impl::class and #[\OCA\OpenRegister\Mcp\Attribute\McpTool(…)] matched neither — reinstating the finding whose only remedy is deleting a live MCP write tool.

5. A crashed checker reported PASS — gates 56 and 57. Both ran >> log 2>/dev/null || true and read the verdict from wc -l. With a python3 shim exiting 1: [gate-56] PASS, [gate-57] PASS — and gate-57 had reported 20 real findings over the same tree one run earlier. Now SKIPPED (wiring), stderr kept on disk.

6. Gate 56 called a real class absent. The fallback walk — the thing that finds a type where PSR-4 does not predict, i.e. gate-30's DI-bound shape — matched class only, with at most one modifier. enum, interface, trait and final readonly class all reported guard-class-not-found, and the action that invites is to write the class twice.

7. Gate 64 saw one of PHP's three ways to name a class, and flagged the lazy form. ::class (FQ or imported) and a class constant read as compliant. Separately, a lazy service closure naming Bootstrap reported identically to an eager reference — the exemption this module's header has always documented and never implemented. Measured on launchpad, whose entire composition root is built on that pattern: the gate would have failed the one repo doing it correctly.

The one thing this does NOT fix, deliberately

Gate 64's hard rule is scoped to AppHost\, but the mechanism is not: during register() the whole OCA\OpenRegister\ prefix is absent for any app sorting earlier. Measured, no prelude:

  • larpingapp 3 — the last two carry its server-authoritative skill-requirement / XP-budget enforcement on character writes, which therefore never registers.
  • hermiq 3 — flow-node, leaf-provider, shareable-config registration. nldesign 1.

A non-blocking NOTE, printed by the runner. Not a FAIL: gate 64 is not diff-scoped, so failing it blocks every PR in three repos on untouched code — the trap check_store_and_settings_surface.py already records. A probe in boot() is not noted.

Gate 63 on a controller-only diff — the recommendation

Every blocking rule reads the manifest or menu-layout.json; the two rules touching lib/Settings are WARNs and never fail it. So a controller-only diff lands in the empty-scope branch and the old line read "this PR introduces no settings placement (ADR-079) to judge" — false when the author just changed a settings controller.

Not widened. Reading the controller was tried and reverted; check_store() records that it "blocked EVERY manifest-touching PR in that repo, permanently". na stays — no change the author could make puts a manifest into a diff that does not touch one. What changes: the line now names which half it inspected and, when the diff contains lib/Settings or a settings controller, says so explicitly, so na cannot be read as a clearance.

Evidence

  • Count-as-exit-status (19/26/52's defect): checked all nine — none has it. 56/57 put the count on stdout; the rest return status codes.
  • na over a repo full of subject: audited gate-58's tests/e2e/ glob fleet-wide — 193 live networkidle calls inside, 0 outside. No blind spot.
  • Fleet sweeps, 21 repos, old vs new: gate-56 0 verdict changes · gate-57 0 · gate-59 0 · gate-64 0 (3 new NOTEs; the 3 pre-existing FAILs survive).
  • Both fix(gates): an empty ADR-020 diff scope is na, not structural (#268) #270 arms: empty scope → NOT APPLICABLE, exit 0 under --require-full-coverage; genuine structural gap → SKIPPED (structural), exit 98.
  • Gate-60 three states: real finding · SKIPPED (wiring) naming the dependency · clean pass.

Tests

  • test_check_unclosable_gate.pyNEW; gate 59 had no suite at all. 23 cases + the mutant proving the comment mask is load-bearing.
  • test_gate_5661_empty_scope_is_not_a_pass.shNEW; 28 assertions over 56–61. Against 48c88ba it reports 13 failures, naming the six PASSes.
  • test_gate_crashed_checker_is_not_a_finding.sh — +2 gates, 5 assertions, two arms so "always skip" cannot pass. Against 48c88ba it reports the two PASSes.
  • test_check_register_handler_resolution.py +8 · test_check_apphost_autoload_prelude.py +23 · test_check_orphaned_write_capability.py +5 (mutant restores both pre-fix regexes together).

59 of 60 discovered helper suites green, 2 quarantined.

Not mine, reported not fixed

test_gate_45_to_55_acceptance.sh fails 4 gate-53 assertions identically on pristine 48c88ba and on this branch — the suite expects blocking behaviour for pre-existing orphans that #250/#260/#280 deliberately made advisory. Out of this band; flagged, not touched.

🤖 Generated with Claude Code

…could not see the defect they exist to catch

Acceptance test applied to all nine gates in the 56-64 band: plant one
textbook true positive in a real fleet repo, require the gate to FAIL and
NAME it, remove the plant, require the prior verdict back, and require a
clean fixture to still pass. Five gates passed unchanged (56, 58, 60, 62,
63). Four did not.

AN UNOPENED SCOPE IS NOT A PASS — gates 56, 57, 58, 59, 60, 61
--------------------------------------------------------------
#242/#240 established that a gate must not report PASS over a scope it
never opened, and #268 that an empty ADR-020 scope is `na` rather than
`structural`. Both were applied to gates 19, 25, 62 and 63 and to nothing
else. Measured on shillinq, one docs-only commit, --scope-to-diff:

  [gate-56] register-handler-resolution: PASS   <- 153 registers, 0 opened
  [gate-57] orphaned-write-capability:   PASS   <- 316 services,  0 opened
  [gate-58] e2e-networkidle:             PASS   <-  60 e2e files, 0 opened
  [gate-59] unclosable-gate:             PASS   <- lib/ untouched
  [gate-60] icon-vocabulary:             PASS   <- no manifest in the diff
  [gate-61] listener-work-placement:     PASS   <- all 15 out of scope
  [gate-62] store-plane:                 NOT APPLICABLE   (already fixed)
  [gate-63] settings-surface:            NOT APPLICABLE   (already fixed)

Six gates asserting a verdict about code the run had not looked at, beside
two that had already learned not to — and --require-full-coverage cannot
see a PASS, so nothing reported that six gates had gone quiet. All six now
emit `na` with a reason naming the rule and the count of subjects that
exist but were not inspected.

GATE 59 COULD NOT RUN A FULL-TREE AUDIT AT ALL
----------------------------------------------
CHANGED_FILES is populated only under --scope-to-diff. Gate 59's guard read
`grep -qE '^lib/.*\.php$'` against it unconditionally, so on every unscoped
run the guard was false and the gate printed PASS having walked no PHP.
That is #240's sentence — "a full-tree audit was the one mode this gate
could never reach" — in a gate #240 did not visit. The scoping now applies
only when the caller asked for it.

Gate 61's unconditional --base is DELIBERATE by contrast (it is about new
debt; the fleet's 149-registration backlog is a work-list). Switching it to
--all was tried and reverted: the builder runs unscoped, so it would have
surfaced the whole backlog as blocking findings on every build. Recorded in
the code so the next reader does not repeat it.

GATE 59 WAS WRONG IN BOTH DIRECTIONS AT ONCE (#184's shape)
-----------------------------------------------------------
It caught the textbook case and then failed on the next four mutations,
each reproduced against docudesk:

  false GREEN     a COMMENTED-OUT setter counted as a write. `// TODO:
                  setValueString('app','configuration_version',$v)` closed
                  the finding — and that is the single most likely comment
                  to sit beside a key nobody writes. The gate whose subject
                  is "this guard never closes" was itself closed by a
                  comment promising to close a guard.
  false GREEN     `"key"` in double quotes was invisible on both sides.
  false POSITIVE  read 'key' / write "key" — code that closes its gate
                  correctly reported as never closing it, with no remedy
                  available to the app but changing its quote style.
  false GREEN     a key held in a class constant was invisible on both
                  sides — and a constant is the idiomatic way to write a key
                  used twice, which is the shape a CLOSABLE gate has.

Fixed with the established remedies: source_scope.php_mask for the comment
regions (offsets preserved; string contents kept, because the key literal
is the evidence), both quote styles, and constant resolution that keeps
read and write symmetric. The suppression keeps reading raw text because it
is authored as a comment — and it now requires the key QUOTED ON THE
MARKER'S OWN LINE, because the old four-line window spanned the read and so
suppressed whatever was near it rather than what it named.

Fleet sweep: 21 repos, zero verdict changes.

GATE 57'S MCP SEAM DISSOLVED ON A LEADING BACKSLASH
---------------------------------------------------
Both halves of the attribute seam (#200/#215) matched a namespace prefix as
`(?:[A-Za-z_]\w*\s*\\+\s*)*` — every segment had to start with a letter. So
the fully-qualified spelling, which is how you write a name with no `use`
import for it, matched neither:

    registerServiceAlias('…::app', \OCA\App\Mcp\Impl::class)
    #[\OCA\OpenRegister\Mcp\Attribute\McpTool(name: 'createLead')]

Either miss alone empties the seam and puts every #[McpTool] write method
in the app back on the finding list — which is #200 verbatim, a finding
whose only remedy is deleting a live, curated MCP write tool. Reproduced on
shillinq with the two spellings side by side.

The regression test's mutant restores BOTH pre-fix patterns together,
because the seam needs both and reverting one alone reads as "the fix
changed nothing".

Fleet sweep: 21 repos, zero verdict changes — the trap is latent, not live.

GATE 64 SAW ONE OF PHP'S THREE WAYS TO NAME A CLASS
---------------------------------------------------
Rule 2 required a QUOTED literal, so of these four only the first was a
finding; the other three were injected into larpingapp's register() and the
gate reported OK for every one:

    class_exists('OCA\OpenRegister\AppHost\…\GenericHealthController')
    class_exists(\OCA\OpenRegister\AppHost\…\GenericHealthController::class)
    use …\GenericHealthController;  class_exists(GenericHealthController::class)
    const AH = 'OCA\OpenRegister\AppHost\…';  class_exists(self::AH)

That is #184's lesson in the file where it was learned. All four spellings
now resolve through one resolver, so a spelling that escapes it escapes
both rules rather than whichever was written second. A bare `use` import
stays clean on purpose — `use` is a compile-time alias and does not
autoload; flagging it would newly redden four repos for code that works.

AND A GREEN GATE-64 WAS NOT EVIDENCE ABOUT THE WIDER PROBE
----------------------------------------------------------
The hard rule is scoped to OCA\OpenRegister\AppHost\, but the autoloader
mechanism has nothing to do with AppHost: during register() the whole
OCA\OpenRegister\ prefix is absent for any app sorting earlier, so ANY
class_exists() on it answers FALSE and everything it guards silently never
happens. Measured across apps-extra, no prelude present:

    larpingapp  3  Event\{DeepLinkRegistration,ObjectCreating,ObjectUpdating}
                   — the last two carry larpingapp's server-authoritative
                     skill-requirement / XP-budget enforcement on character
                     writes, which therefore never registers
    hermiq      3  flow-node, leaf-provider and shareable-config registration
    nldesign    1  shareable-config registration

Reported as a non-blocking NOTE, printed by the runner, and deliberately
not a FAIL: this gate is not diff-scoped, so failing it would block every
PR in three repos on code the PR did not touch — the trap
check_store_and_settings_surface.py already records. A probe in boot() is
NOT noted, because boot() runs after every app has registered.

ALSO
----
Gate 64's log path was a hardcoded /tmp/hydra-gate-apphost-autoload-prelude
.log — the shared-path non-determinism HYDRA_GATE_LOG_DIR exists to remove,
left behind in one gate.

TESTS
-----
  test_check_unclosable_gate.py                    NEW — gate 59 shipped
                                                   with no helper suite at
                                                   all; 23 cases, every arm
                                                   of the matrix above plus
                                                   the mutant that proves
                                                   the comment mask is
                                                   load-bearing
  test_gate_5661_empty_scope_is_not_a_pass.sh      NEW — 28 assertions over
                                                   gates 56-61: clean
                                                   in-scope subject PASSes,
                                                   empty scope is `na` with
                                                   a reason and exit 0 under
                                                   --require-full-coverage,
                                                   and a planted true
                                                   positive per gate still
                                                   FAILs. Against the
                                                   pre-fix package it
                                                   reports 13 failures,
                                                   naming the six PASSes
  test_check_apphost_autoload_prelude.py           +14 cases
  test_check_orphaned_write_capability.py          +5 cases
  test_check_listener_placement.py                 EXIT_EMPTY_SCOPE

51 discovered helper suites green (2 quarantined, unchanged). Full-tree run
on shillinq before/after: verdicts byte-identical for all nine gates.
…could not see the defect they exist to catch

Acceptance test applied to all nine gates in the 56-64 band: plant one
textbook true positive in a real fleet repo, require the gate to FAIL and
NAME it, remove the plant, require the prior verdict back, and require a
clean fixture to still pass. Five gates passed unchanged (56, 58, 60, 62,
63). Four did not.

AN UNOPENED SCOPE IS NOT A PASS — gates 56, 57, 58, 59, 60, 61
--------------------------------------------------------------
#242/#240 established that a gate must not report PASS over a scope it
never opened, and #268 that an empty ADR-020 scope is `na` rather than
`structural`. Both were applied to gates 19, 25, 62 and 63 and to nothing
else. Measured on shillinq, one docs-only commit, --scope-to-diff:

  [gate-56] register-handler-resolution: PASS   <- 153 registers, 0 opened
  [gate-57] orphaned-write-capability:   PASS   <- 316 services,  0 opened
  [gate-58] e2e-networkidle:             PASS   <-  60 e2e files, 0 opened
  [gate-59] unclosable-gate:             PASS   <- lib/ untouched
  [gate-60] icon-vocabulary:             PASS   <- no manifest in the diff
  [gate-61] listener-work-placement:     PASS   <- all 15 out of scope
  [gate-62] store-plane:                 NOT APPLICABLE   (already fixed)
  [gate-63] settings-surface:            NOT APPLICABLE   (already fixed)

Six gates asserting a verdict about code the run had not looked at, beside
two that had already learned not to — and --require-full-coverage cannot
see a PASS, so nothing reported that six gates had gone quiet. All six now
emit `na` with a reason naming the rule and the count of subjects that
exist but were not inspected.

GATE 59 COULD NOT RUN A FULL-TREE AUDIT AT ALL
----------------------------------------------
CHANGED_FILES is populated only under --scope-to-diff. Gate 59's guard read
`grep -qE '^lib/.*\.php$'` against it unconditionally, so on every unscoped
run the guard was false and the gate printed PASS having walked no PHP.
That is #240's sentence — "a full-tree audit was the one mode this gate
could never reach" — in a gate #240 did not visit. The scoping now applies
only when the caller asked for it.

Gate 61's unconditional --base is DELIBERATE by contrast (it is about new
debt; the fleet's 149-registration backlog is a work-list). Switching it to
--all was tried and reverted: the builder runs unscoped, so it would have
surfaced the whole backlog as blocking findings on every build. Recorded in
the code so the next reader does not repeat it.

GATE 59 WAS WRONG IN BOTH DIRECTIONS AT ONCE (#184's shape)
-----------------------------------------------------------
It caught the textbook case and then failed on the next four mutations,
each reproduced against docudesk:

  false GREEN     a COMMENTED-OUT setter counted as a write. `// TODO:
                  setValueString('app','configuration_version',$v)` closed
                  the finding — and that is the single most likely comment
                  to sit beside a key nobody writes. The gate whose subject
                  is "this guard never closes" was itself closed by a
                  comment promising to close a guard.
  false GREEN     `"key"` in double quotes was invisible on both sides.
  false POSITIVE  read 'key' / write "key" — code that closes its gate
                  correctly reported as never closing it, with no remedy
                  available to the app but changing its quote style.
  false GREEN     a key held in a class constant was invisible on both
                  sides — and a constant is the idiomatic way to write a key
                  used twice, which is the shape a CLOSABLE gate has.

Fixed with the established remedies: source_scope.php_mask for the comment
regions (offsets preserved; string contents kept, because the key literal
is the evidence), both quote styles, and constant resolution that keeps
read and write symmetric. The suppression keeps reading raw text because it
is authored as a comment — and it now requires the key QUOTED ON THE
MARKER'S OWN LINE, because the old four-line window spanned the read and so
suppressed whatever was near it rather than what it named.

Fleet sweep: 21 repos, zero verdict changes.

GATE 57'S MCP SEAM DISSOLVED ON A LEADING BACKSLASH
---------------------------------------------------
Both halves of the attribute seam (#200/#215) matched a namespace prefix as
`(?:[A-Za-z_]\w*\s*\\+\s*)*` — every segment had to start with a letter. So
the fully-qualified spelling, which is how you write a name with no `use`
import for it, matched neither:

    registerServiceAlias('…::app', \OCA\App\Mcp\Impl::class)
    #[\OCA\OpenRegister\Mcp\Attribute\McpTool(name: 'createLead')]

Either miss alone empties the seam and puts every #[McpTool] write method
in the app back on the finding list — which is #200 verbatim, a finding
whose only remedy is deleting a live, curated MCP write tool. Reproduced on
shillinq with the two spellings side by side.

The regression test's mutant restores BOTH pre-fix patterns together,
because the seam needs both and reverting one alone reads as "the fix
changed nothing".

Fleet sweep: 21 repos, zero verdict changes — the trap is latent, not live.

GATE 64 SAW ONE OF PHP'S THREE WAYS TO NAME A CLASS
---------------------------------------------------
Rule 2 required a QUOTED literal, so of these four only the first was a
finding; the other three were injected into larpingapp's register() and the
gate reported OK for every one:

    class_exists('OCA\OpenRegister\AppHost\…\GenericHealthController')
    class_exists(\OCA\OpenRegister\AppHost\…\GenericHealthController::class)
    use …\GenericHealthController;  class_exists(GenericHealthController::class)
    const AH = 'OCA\OpenRegister\AppHost\…';  class_exists(self::AH)

That is #184's lesson in the file where it was learned. All four spellings
now resolve through one resolver, so a spelling that escapes it escapes
both rules rather than whichever was written second. A bare `use` import
stays clean on purpose — `use` is a compile-time alias and does not
autoload; flagging it would newly redden four repos for code that works.

AND A GREEN GATE-64 WAS NOT EVIDENCE ABOUT THE WIDER PROBE
----------------------------------------------------------
The hard rule is scoped to OCA\OpenRegister\AppHost\, but the autoloader
mechanism has nothing to do with AppHost: during register() the whole
OCA\OpenRegister\ prefix is absent for any app sorting earlier, so ANY
class_exists() on it answers FALSE and everything it guards silently never
happens. Measured across apps-extra, no prelude present:

    larpingapp  3  Event\{DeepLinkRegistration,ObjectCreating,ObjectUpdating}
                   — the last two carry larpingapp's server-authoritative
                     skill-requirement / XP-budget enforcement on character
                     writes, which therefore never registers
    hermiq      3  flow-node, leaf-provider and shareable-config registration
    nldesign    1  shareable-config registration

Reported as a non-blocking NOTE, printed by the runner, and deliberately
not a FAIL: this gate is not diff-scoped, so failing it would block every
PR in three repos on code the PR did not touch — the trap
check_store_and_settings_surface.py already records. A probe in boot() is
NOT noted, because boot() runs after every app has registered.

ALSO
----
Gate 64's log path was a hardcoded /tmp/hydra-gate-apphost-autoload-prelude
.log — the shared-path non-determinism HYDRA_GATE_LOG_DIR exists to remove,
left behind in one gate.

TESTS
-----
  test_check_unclosable_gate.py                    NEW — gate 59 shipped
                                                   with no helper suite at
                                                   all; 23 cases, every arm
                                                   of the matrix above plus
                                                   the mutant that proves
                                                   the comment mask is
                                                   load-bearing
  test_gate_5661_empty_scope_is_not_a_pass.sh      NEW — 28 assertions over
                                                   gates 56-61: clean
                                                   in-scope subject PASSes,
                                                   empty scope is `na` with
                                                   a reason and exit 0 under
                                                   --require-full-coverage,
                                                   and a planted true
                                                   positive per gate still
                                                   FAILs. Against the
                                                   pre-fix package it
                                                   reports 13 failures,
                                                   naming the six PASSes
  test_check_apphost_autoload_prelude.py           +14 cases
  test_check_orphaned_write_capability.py          +5 cases
  test_check_listener_placement.py                 EXIT_EMPTY_SCOPE

51 discovered helper suites green (2 quarantined, unchanged). Full-tree run
on shillinq before/after: verdicts byte-identical for all nine gates.
…l class read as absent, and a lazy closure read as an eager one

Second pass over the 56-64 band, planting in a SECOND repo of a different
shape per gate. Four more defects, all measured against gate package
48c88ba.

A CRASHED CHECKER REPORTED PASS — gates 56 and 57
--------------------------------------------------
Both invoked their helper as `>> log 2>/dev/null || true` and then derived
the verdict from `wc -l` on the log. Stderr discarded, exit status
discarded, empty log — so a checker that never started reported PASS.
Measured on shillinq with a python3 shim that exits 1 for exactly these two
helpers:

    [gate-56] register-handler-resolution: PASS      <- 153 registers
    [gate-57] orphaned-write-capability:   PASS      <- 316 services

and gate-57 had reported 20 real findings over that same tree on the
previous run. That is gate-40's defect verbatim. Both helpers ALWAYS exit 0
when they run, by design (#209 — the count goes to stdout, never into the
exit byte), so a non-zero exit can only be a crash and never a finding
count. Both now emit SKIPPED (wiring) and keep the stderr on disk.

Every gate in this band was re-checked for the count-as-exit-status defect
found in gates 19, 26 and 52: none of the nine has it. 56 and 57 put the
count on stdout and the runner counts lines; 58/59/60/61/62/63/64 return
status codes only.

A REAL CLASS READ AS ABSENT — gate 56
--------------------------------------
The PSR-4 path guess handles the conventional layout; the fallback walk
over lib/ is what finds a type living where PSR-4 does NOT predict — a
DI-bound registration, a type not named after its file. That is the shape
gate-30 was caught mis-resolving (`AppHost\Controller\GenericHealth`
PSR-4-maps to lib/Controller/AppHost/Controller/… while openregister
DI-binds it to lib/AppHost/Controller/).

The walk matched `class` only, with at most ONE modifier. So every other
declaration form was a FALSE POSITIVE on a type that genuinely exists — and
the action `guard-class-not-found` invites is to write the class a second
time. Measured, each against a real declaration at a non-conventional path:

    enum ProbeState: string { … }        -> guard-class-not-found
    interface ProbeContract { … }        -> guard-class-not-found
    trait ProbeTrait { … }               -> guard-class-not-found
    final readonly class ReadonlyProbe   -> guard-class-not-found

`final readonly` is ordinary PHP 8.2. Only the DECLARATION FORMS widen; the
line anchor that keeps docblock prose out is unchanged and asserted in both
directions.

A LAZY CLOSURE READ AS AN EAGER REFERENCE — gate 64
----------------------------------------------------
This module's header has always said lazy service closures that merely
MENTION an AppHost class are deliberately NOT flagged, because their bodies
run at resolution time. Both rules ran over the whole file, so they did not.

Measured on launchpad — deliberately a DIFFERENT repo shape from
larpingapp. launchpad's whole composition root resolves OpenRegister
lazily inside closures (it already does this for
AppHost\Observability\ManifestLoader); that is the documented leaf pattern
and the reason launchpad is green. A closure body naming Bootstrap reported
byte-identically to an eager `Bootstrap::register($context, …)`. The gate
would have failed the one repo doing it correctly, for doing it correctly,
and the only remedy is to stop writing the lazy form.

Anonymous and arrow-function bodies are now blanked before both rules.
Named methods are untouched (`public function register(` has an identifier
between `function` and `(`), and an eager reference AFTER or BETWEEN
closures is still caught — both asserted.

GATE 63 ON A CONTROLLER-ONLY DIFF — the reason was an overclaim
---------------------------------------------------------------
Every BLOCKING rule in this gate reads src/manifest.json, src/manifest.d/
or src/menu-layout.json. The two rules that touch lib/Settings are WARNs
and never fail it. So a PR that changes a settings CONTROLLER, or adds or
deletes a lib/Settings/*Admin.php section, lands in the empty-scope branch —
and the line read "this PR introduces no settings placement (ADR-079) to
judge", which on such a diff is false. The author changed the settings
surface; this gate does not adjudicate that half of it.

NOT WIDENED, on purpose. Reading the controller was tried and reverted, and
check_store_and_settings_surface.py records why: a gate that only RUNS when
a manifest changed and then judges code the PR never touched "blocked EVERY
manifest-touching PR in that repo, permanently". The verdict stays `na` —
the correct category, since no change the author could make puts a manifest
into a diff that does not touch one.

What changes is that the line now names which half it looked at, and when
the diff contains lib/Settings or a settings controller it says so
explicitly, so `na` cannot be read as a clearance for the change the author
actually made.

VERIFIED, BOTH ARMS OF THE #270 CONTRACT
-----------------------------------------
  * empty ADR-020 scope   -> NOT APPLICABLE, exit 0 under
                             --require-full-coverage (measured on the
                             controller-only fixture above)
  * genuine structural gap -> SKIPPED (structural), exit 98
                             (test_gate_empty_scope_never_passes.sh ARM 4,
                             gate-33 with --axe-enabled and no report)

And gate-60's three states, all asserted:
real finding · SKIPPED (wiring) naming the missing dependency · clean pass.

FLEET SWEEPS — 21 apps-extra repos, old helper vs new
------------------------------------------------------
  gate-56  zero verdict changes
  gate-64  zero verdict changes; the three pre-existing FAILs (openbuild,
           procest, scholiq) survive, and the three NOTEs (larpingapp,
           hermiq, nldesign) are unchanged

TESTS
-----
  test_gate_crashed_checker_is_not_a_finding.sh  +2 gates, 5 assertions.
      Two arms: the plants must FAIL with a working interpreter, and the
      SAME tree must report SKIPPED (wiring) with a dead one — otherwise
      "always skip" would pass. Against 48c88ba it reports the two PASSes.
  test_check_register_handler_resolution.py      +8 cases incl. the mutant
      that restores the pre-fix pattern and requires all four forms to go
      back to not-found.
  test_check_apphost_autoload_prelude.py         +9 cases, closure and
      anti-widening arms.

REPOS PLANTED IN, by gate
--------------------------
  56  shillinq (register-owning, 153 register.d files) + a synthetic
      DI-bound/non-conventional-path fixture
  57  shillinq (316 services) + fixture
  58  shillinq (60 e2e files); fleet-wide check that no live networkidle
      call in any repo lives outside tests/e2e/ — 193 inside, 0 outside
  59  docudesk (the repo the gate was written against) + fixture
  60  shillinq (233 manifests, fake MDI package) + fixture
  61  shillinq (15 post-event registrations)
  62  shillinq
  63  shillinq + a controller-only fixture
  64  larpingapp (eager class_exists composition root, 3 live probes)
      AND launchpad (lazy-closure composition root, 0 eager references)

NOT MINE, REPORTED NOT FIXED
-----------------------------
test_gate_45_to_55_acceptance.sh fails 4 gate-53 assertions identically on
pristine main (48c88ba) and on this branch — the suite expects blocking
behaviour for pre-existing orphans that #250/#260/#280 deliberately made
advisory. Out of this band; flagged rather than touched.
The branch was rebased from cdfbd7a onto 48c88ba after four gate-package
releases landed mid-session (#272, #275, #276, #280/#282). The rebase gave
the same content a new history, which is a force-push, and force-push is
blocked on shared branches for good reason. The tree here is IDENTICAL to
the rebased HEAD — this commit only re-attaches the old tip as a second
parent so the push is a fast-forward.
…tance

# Conflicts:
#	hydra-gates/scripts/lib/test_gate_crashed_checker_is_not_a_finding.sh
@rubenvdlinde
rubenvdlinde merged commit c51a225 into main Aug 9, 2026
31 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