Default-language captions (CE4899), drop names lost grants, theme names unvendored fonts (#944 items 2-4)

[ako]

Part of #944 — items 2, 3 and 4 (items 1 and 5 are another group's).

Item 2 — CE4899: a required caption with no text in the default language

Measured first (fresh 11.14.0 app, cached mxbuild): a page title, tab page caption, group box caption, action and link button captions, data grid column header, input labels, dynamic text, title widget, enumeration value captions, a navigation menu item and a show-message text were written en_US-only; the default was then switched to de_DE (once with en_US still enabled, once with it dropped). mx check reported CE4899 only on the tab pages (both runs: the new tpA and the stock Administration.Account_Overview tabPage2). A snippet's tab page fails too; the 22 en_US-only tab pages in Atlas_Web_Content's page templates / building blocks are not checked by mxbuild. So only Forms$TabPage.Caption in pages, snippets and layouts is flagged.

How mxcli writes a caption literal: into the project's default language (authoringLanguage, #970) — so a script's own captions are fine unless the script changes the default. That surfaced a real bug: the authoring language was cached once per session, so a page created after alter settings language (DefaultLanguageCode: 'de_DE') in the same script was still written in en_US and failed the build (measured: tpAfter CE4899). Fixed — the cache is dropped when the default changes.

• (a) lint rule QUAL006 (RequiredCaptionMissingDefaultLanguage, error): reads the stored units through the backend, so it does not depend on refresh catalog full. (Note: mxcli lint's built-in list never included QUAL005 at all — only the REPL lint ran it; left as is, see follow-up.)
• (b) check -p → MDL-I18N01 for a script that changes the default: stored tab captions, plus tab pages a create page/snippet wrote before the change; a document created/altered/dropped after the change is not reported.
• (c) alter settings language (DefaultLanguageCode: …) prints how many required captions lack the new default, lists up to 10, and names the fixing statement (alter page P { set (Caption: '…') on tabPage2; };).
• Shared core: translations.MissingRequiredCaptions (+ Site.OwnerName).

mx check evidence (11.14.0, scratch app):

Scenario	mx check	mxcli
stock app, de_DE default, en_US dropped	1× CE4899 (tabPage2)	lint QUAL006: 1 error (tabPage2) — before the template filter it said 23
same, control: pristine en_US app	0 errors	lint QUAL006: no issues
script: snippet + page before switch, page after	3× CE4899 (tpSnip, tabPage2, tpBefore) — tpAfter was a 4th before the cache fix	check -p: 3 MDL-I18N01 errors (same three); exec note: same three
after alter page/snippet … { set (Caption: …) on … } for each	0 errors	lint QUAL006: no issues

Item 3 — drop names the grants it removes

drop microflow, drop nanoflow and drop page now print the removed module roles, whether a create carries them (flows: only later in the same script/session; a page never — it is not remembered), and the grant that restores them. Snippets have no access roles. The splice-refusal message now says to drop and create in the same script, and why; the write-microflows (via reference/pitfalls.md, SKILL.md is held to 700 lines) and write-nanoflows skills say the same. Verified on the scratch app: drop microflow MyFirstModule.DoIt prints Removed its execute grants to MyFirstModule.User ….

Item 4 — theme create --from names unvendored fonts

The primary (first) family of each seeded --mxt-font* stack that the base theme does not load with @font-face is reported (CreateResult.UnvendoredFonts) and printed as a note naming mxcli-fonts/ and the partial. Generic stacks (system-ui, sans-serif, …) and vendored families are silent. Verified: theme create acme --from design.css with "Inter", system-ui, sans-serif prints the note.

Test plan

• make build, make lint, make check-conformance, make check-findings, make check-skill-mdl, make check-mdl
• go test ./mdl/executor/ ./mdl/catalog/ ./mdl/translations/ ./mdl/linter/... ./cmd/mxcli/... — all pass
• New tests: mdl/translations/required_test.go, mdl/linter/rules/required_captions_test.go, mdl/executor/default_language_captions_test.go, mdl/executor/drop_grants_note_test.go, flow_verdict_test.go (refusal text), cmd/mxcli/theme/create_seeded_test.go (TestCreate_NamesSeededFontsItDoesNotVendor), each with controls (en_US present / no switch / rewritten after the switch / no grants / vendored font / generic stack)
• Revert checks (fix removed → test fails with the symptom, restored → passes):
  • fonts: dropping res.UnvendoredFonts = … → UnvendoredFonts = [], want [Inter]
  • drop: removing the three writeDroppedGrantsNote calls → all three drop tests fail
  • (c) removing the note → TestAlterDefaultLanguage_ReportsRequiredCaptionsWithoutIt fails
  • cache: removing the authoring-language reset → TestAlterDefaultLanguage_NewTextsUseTheNewDefault fails (and tpAfter CE4899 in the mx check run)
  • (b) disabling CheckDefaultLanguageCaptions → TestCheckDefaultLanguageCaptions fails
  • lint: the end-to-end count against mx check (23 → 1 after skipping templates) was the control for the unit-type filter
• Findings appended (cmd-mxcli, mdl-executor ×2); CHANGELOG entries under Unreleased; docs: builtin-rules.md (QUAL006, MDL-I18N01), error-messages.md (MDL-I18N01), mxcli syntax settings.alter text corrected (it said mx check is 0 errors either way).

Follow-up (not done here)

• mxcli lint (CLI) does not run QUAL005 at all — only the REPL lint does. Adding it changes what every project reports, so it is a decision, not a fix.
• MDL-I18N01 does not model an alter page … set Caption issued before the switch, or a create that carries a stored translation in the new default; both would only make it over-report on unusual scripts.
• Layout tab pages are flagged by the shared check (pages/snippets/layouts) but only page and snippet were measured; no alter layout exists, so the suggestion points at Studio Pro.

🤖 Generated with Claude Code