Repository navigation
fix(gate-22): sync the vendored manifest schema to 2.28.0 - #664
Merged
Merged
Conversation
check_manifest.js deliberately prefers the schema vendored here over the app's own node_modules copy, so that a pass means canonically valid rather than valid against whatever generation an app happens to pin. That is the right design, and it means this file has to keep up with nextcloud-vue. It had not. The vendored copy was 2.26.0 while the published package is at 2.28.0, so gate-22 rejected any manifest using an action key added since: advanced createOverride excludeFields fieldOverrides formTitle includeFields `createOverride` has been in nextcloud-vue for a while, so the drift predates the keys that surfaced it. dossiq#1653 is the first manifest to use one. Straight copy from @conduction/nextcloud-vue@2.31.0. Verified as a pure superset: zero schema paths, definitions or page types lost. Verified the gate still FAILS on a planted undeclared key, so this does not trade a stale schema for a permissive one.
rubenvdlinde
added a commit
that referenced
this pull request
Sep 3, 2026
… the widget list (#671) dossiq#1729 failed dossiq's Dashboard on at /pages/0/config/headerActions/0: must NOT have additional properties and the manifest was right. CnActionButtons binds includeFields, excludeFields, fieldOverrides, size and columns straight onto CnFormDialog, so the runtime renders every one of them; the narrowed "New case" form was a deliberate feature (dossiq#1713). What was stale was this package's vendored copy of the schema, 2.26.0, shipped as v1.11.0. That copy is already current on main: #664 synced it to 2.28.0 and #667 to 2.29.0, and it is now byte-identical to nextcloud-vue's development copy. Both syncs landed with no fixture, which is why the drift could ship three times: nothing here could tell a current vendored schema from a stale one. FAMILY K closes that. Its clean arm carries the whole open-form option set and its planted arm carries two independently fatal defects in the same action — an unknown key and an out-of-enum size — so a schema "fixed" by setting additionalProperties to true, or by dropping the enum, passes the clean arm and fails the planted one. Verified by re-introducing the 2.26.0 schema: family K goes red and names the same path #1729 reported. The sweep for the same class found one more, in check_manifest.js rather than in the schema. BUILT_IN_WIDGET_KEYS feeds the ADR-036 Decision 1 rule and had six keys while nextcloud-vue's validator had eleven and its v2 runtime registry fifteen. A dashboard whose single 12x12 widget is a library built-in — banner, header, text, divider, audit-trail, metadata — was told to "declare as type:custom and register the component with kind:page", advice the app cannot follow because it does not own the component. The set is now the union of the library's validator list and the registry CnWidgetGrid actually resolves against. FAMILY L is its pair: a library built-in passes, an app-owned widget still fails, so the anti-pattern rule is updated rather than retired. Verified by restoring the six-key list, which reddens the built-in arm and leaves the app-owned one failing. The dashboard-widget catalog fallback (table, object-list, map, countdown, tabs) is a known remaining gap, recorded in the code: nextcloud-vue's own validator flags those too, so it is a change to make there first. Full helper-suite run green before and after: 104 passed, 0 failed, 2 quarantined with reasons. Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
rubenvdlinde
added a commit
that referenced
this pull request
Sep 4, 2026
…e the store plane
decidiq is red on gate-22 and gate-53 on `development`, four findings with
one cause:
[gate-22] at /: must NOT have additional properties
at /pages/29/type: must be equal to one of the allowed values
[gate-53] the same two, against the ASSEMBLED manifest
The manifest is right and the gate was old. The declarative store plane
(ADR-080 / ADR-114 Decision 4) landed in nextcloud-vue across schema 2.30.0
to 2.32.0: a top-level `store` block and a `store` page type. The vendored
copy here was 2.29.0 and had heard of neither. check_manifest.js deliberately
prefers the CANONICAL vendored schema over the app's pinned node_modules
copy, so the stale copy won, and in the very same run decidiq's own
`npm run check:manifest` passed against 2.32.0 and said so in the advisory
block.
The schema file is now byte-identical to
ConductionNL/nextcloud-vue main:src/schemas/app-manifest-v2.schema.json.
The 2.29.0 to 2.32.0 diff is additive only: the store block, the store page
type, and one description that stopped restating the library widget list.
Nothing was tightened, so no app that passes today can start failing.
FIXTURED THIS TIME. This is the FOURTH time a stale vendored schema has
invented findings: 2.28.0 (#664), 2.29.0 (#667), the open-form option set
(family K), and now the store plane. Family K exists because the first two
landed with no fixture. Family M does for the store plane what K did for
open-form actions, with the same two arms:
M1 a store block and a store page, the shape decidiq ships -> PASS
M2 `cardFieldz` and `type: "storefront"` in that same manifest -> FAIL
M2 is the anti-widening arm. M1 alone would pass just as well against a
schema someone "fixed" by setting the store block's additionalProperties to
true or by deleting the page-type enum, which would retire the check rather
than update it.
Verified locally: test_gate_45_to_55_acceptance.sh ALL GREEN with the sync,
and exactly the two M1 arms FAIL with the 2.29.0 schema stashed back in, so
the fixture discriminates rather than agreeing with whatever is vendored.
rubenvdlinde
added a commit
that referenced
this pull request
Sep 4, 2026
…ema three releases behind (#686) * feat(stubs): ship the OpenRegister AppHost Bootstrap analysis stub decidiq and filinq are both red on psalm on `development` with the same finding, and it is a false positive: UnusedParam - Param context is never referenced in this method private function bindStoreController(IRegistrationContext $context): void The parameter is passed on the very next line, inside a `class_exists(\OCA\OpenRegister\AppHost\Bootstrap::class)` guard. psalm cannot resolve that class in a leaf checkout, because openregister is a sibling Nextcloud app rather than a composer dependency, so it prunes the guarded block as dead code and then reports the parameter as unused. A suppression would hide the next genuinely unused parameter in the same method. A stub answers the question instead, and leaves the call type-checked. Three apps carry the same code: decidiq, filinq and planninq all adopted the shared AppHost route table, which declares /api/store/items whether the app wants it or not. planninq had already hand-vendored a copy of this stub. So the stub belongs here, in the package all three already depend on, not in three separate trees. New directory rather than `contracts/`. The two contract interfaces there are `require`d for real by a leaf app's PHPUnit bootstrap, and the README tells apps to point phpstan's `scanDirectories` at that whole directory. A file that must never be loaded does not belong in a directory apps are told to load wholesale, and an app carrying its own AppHost stub would get a duplicate class declaration out of it. Verified locally: with this file wired into decidiq's psalm.xml <stubs>, psalm goes from 1 error to `No errors found!` (exit 0), and the count of 'other issues' is unchanged at 350, so nothing else moved. * fix(gate-22): sync the vendored manifest schema to 2.32.0, and fixture the store plane decidiq is red on gate-22 and gate-53 on `development`, four findings with one cause: [gate-22] at /: must NOT have additional properties at /pages/29/type: must be equal to one of the allowed values [gate-53] the same two, against the ASSEMBLED manifest The manifest is right and the gate was old. The declarative store plane (ADR-080 / ADR-114 Decision 4) landed in nextcloud-vue across schema 2.30.0 to 2.32.0: a top-level `store` block and a `store` page type. The vendored copy here was 2.29.0 and had heard of neither. check_manifest.js deliberately prefers the CANONICAL vendored schema over the app's pinned node_modules copy, so the stale copy won, and in the very same run decidiq's own `npm run check:manifest` passed against 2.32.0 and said so in the advisory block. The schema file is now byte-identical to ConductionNL/nextcloud-vue main:src/schemas/app-manifest-v2.schema.json. The 2.29.0 to 2.32.0 diff is additive only: the store block, the store page type, and one description that stopped restating the library widget list. Nothing was tightened, so no app that passes today can start failing. FIXTURED THIS TIME. This is the FOURTH time a stale vendored schema has invented findings: 2.28.0 (#664), 2.29.0 (#667), the open-form option set (family K), and now the store plane. Family K exists because the first two landed with no fixture. Family M does for the store plane what K did for open-form actions, with the same two arms: M1 a store block and a store page, the shape decidiq ships -> PASS M2 `cardFieldz` and `type: "storefront"` in that same manifest -> FAIL M2 is the anti-widening arm. M1 alone would pass just as well against a schema someone "fixed" by setting the store block's additionalProperties to true or by deleting the page-type enum, which would retire the check rather than update it. Verified locally: test_gate_45_to_55_acceptance.sh ALL GREEN with the sync, and exactly the two M1 arms FAIL with the 2.29.0 schema stashed back in, so the fixture discriminates rather than agreeing with whatever is vendored.
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.
check_manifest.jsdeliberately prefers the schema vendored here over the app's ownnode_modulescopy, so that a pass means canonically valid rather than valid against whatever generation an app happens to pin. Its own comment says so:That is the right design. It also means this file has to keep up with
@conduction/nextcloud-vue, and it had not: the vendored copy was 2.26.0 while the published package is at 2.28.0.So gate-22 rejected any manifest using an action key added since:
createOverridehas been in nextcloud-vue for a while, so the drift predates the keys that surfaced it. ConductionNL/dossiq#1653 is simply the first manifest to use one, and it fails gate-22 and gate-53 for a reason that is not a defect in that repository.Reproduced before changing anything
The change
Straight copy from
@conduction/nextcloud-vue@2.31.0.Verified a pure superset, by diffing every schema path rather than eyeballing the JSON: zero paths, definitions or page-type enum members lost. 52 insertions, 4 deletions.
Verified it has not gone permissive. With the synced schema the gate passes dossiq's real manifest, and still fails a manifest with a planted undeclared key:
A stale schema and a permissive one fail the same way from the outside, so the negative control is the part that matters.
🤖 Generated with Claude Code