v0.10.0: Gallery CE0463 root-cause fix on filter/textfilter combination

[ako]

Parent: #529 (unified schema registry, revised phasing) — independent track
Milestone: v0.10.0

Symptom

Pluggable Gallery with a TEXTFILTER inside its filter slot triggers CE0463
("widget definition changed") when opening the project in Studio Pro. Reproduces
on Mendix 11.x with our generated BSON. The MDL syntax is correct; the engine
output doesn't match the widget's expected PropertyTypes.

Existing reproduction:

• mdl-examples/doctype-tests/17-custom-widget-examples.mdl test case 2
  ("GALLERY with FILTER — TEXTFILTER in FILTER block") — marked as KNOWN BUG
• mdl-examples/doctype-tests/31-pluggable-datagrid-gallery-v010-examples.mdl
  test PG02 and MX01 hit the same issue

Hypothesis

Likely cause is one of:

1. The embedded mendix-11.6/datagrid-text-filter.json template is stale
   (PropertyTypes structure has drifted in newer DataWidgets versions)
2. MPK augmentation logic in sdk/widgets/augment.go is dropping or reordering
   PropertyTypes when syncing the embedded template with the installed widget
3. Runtime serialization in cmd_pages_builder_v3_widgets.go is missing required
   fields on the TextFilter widget object

Investigation steps

1. Generate a known-good reference: open Studio Pro 11.x, manually create a
   gallery with a textfilter, save, then decode the resulting .mxunit with
   the BSON debugging skill (.claude/skills/debug-bson.md)
2. Generate the same page via mxcli executor on a Mendix 11.x project
3. Diff the two BSON outputs at the TextFilter widget level — find the
   discrepancy
4. Trace the discrepancy back to its source (template file vs. augmentation
   vs. runtime serialization) and fix

Acceptance criteria

• Gallery with TEXTFILTER inside filter slot opens cleanly in Studio Pro
  11.6 and 11.9 (no CE0463)
• All four filter types (textfilter, numberfilter, datefilter,
  dropdownfilter) work inside Gallery filter slots
• DESCRIBE round-trips Gallery + filter pages back to equivalent MDL
• Test case 2 in 17-custom-widget-examples.mdl updated to remove the
  KNOWN BUG annotation
• Acceptance fixture 31-pluggable-datagrid-gallery-v010-examples.mdl
  tests PG02 and MX01 produce CE0463-free BSON

Independent track

This bug fix doesn't depend on Phase 1 / 2 / 3 work — it's a separate
investigation into widget-template/augmentation logic. Can ship in any order
relative to the other v0.10.0 issues.

🤖 Generated with Claude Code

[github-actions]

Issue Triage

Summary:
The issue describes a CE0463 error that occurs when a Pluggable Gallery contains a TEXTFILTER in its filter slot, caused by a mismatch between the widget’s expected PropertyTypes and the BSON generated by mxcli.

Checklist of required bug‑report information

Required info	Present?	Details
mxcli version (output of mxcli --version or commit/build)	❌	Not mentioned
Mendix version of the project being processed	⚠️	Stated as “Mendix 11.x” but no exact version (e.g., 11.6, 11.9)
Scenario (what the user was trying to do – MDL script, CLI command, etc.)	✅	Described: creating a Pluggable Gallery with a TEXTFILTER inside its filter slot; reproduced via specific test cases
Expected output (what should have happened)	✅	No CE0463 error; the project should open cleanly in Studio Pro
Experienced output (what actually happened – error message, wrong result, crash)	✅	CE0463 (“widget definition changed”) when opening the project in Studio Pro
AI bug report (output of mxcli diag --bundle or at least the session log)	❌	Not provided

What’s missing / needs clarification

• Please share the exact mxcli --version (or commit/hash) you are using.
• Specify the precise Mendix version of the project (e.g., 11.6.0, 11.9.2) to ensure we test against the same runtime.
• Attach the output of mxcli diag --bundle (or at least the relevant session log) so we can see the environment and any internal state that might be relevant.

Once those details are added, the report will be complete and we can move forward with the investigation. Thank you for bringing this to our attention!

---

Automated triage via OpenRouter — workflow source