[ako]

Syncs ako/mxcli:main into upstream: 14 commits — the code behind several v0.31.0 release-note entries, plus page round-trip, MOVE, lint and docker fixes. 7 upstream issues fixed.

Lint API and catalog

• annotations() and CATALOG.ANNOTATIONS — domain model annotations, one row each with module, full caption (newlines kept) and canvas position. A microflow's annotations reached a rule as activities; a domain model's were in no table, so a "no TODO notes" rule passed every domain model. Schema 39. Fixes Starlark lint API: domain model annotations are not readable (only microflow annotations are) #1309
• An enumeration value's id in Starlark rules — the value's $ID, which is the element_id of its caption rows in strings(), so a rule can resolve getCaption(Module.Enum.Value) per language. Fixes Starlark lint API: enumeration values and their captions are not readable, so getCaption() cannot be resolved #1310
• folders() and CATALOG.FOLDERS, empty folders included — module, path, parent path, depth and direct contents. FOLDERS (and, found by a new test that parses every catalog table name, AGENTS) is a keyword, so select … from CATALOG.FOLDERS parsed to nothing and printed nothing. Schema 38. Fixes lint: no folders() and empty folders are invisible #1538

Pages

• The Data grid 2 / Gallery empty placeholder builds. emptyplaceholder { … } was accepted while showEmptyPlaceholder was its default none, which hides the slot — CE0463 on the grid. MDL-WIDGET10 now counts a slot filled by a child block as set, and a filled hidden slot is an error naming the property. mxcli syntax page.widgets documents the form that builds (showEmptyPlaceholder: 'custom' plus the block) and its ALTER PAGE equivalent. Fixes Data grid 2: no MDL form for the emptyPlaceholder slot #1704
• An unchanged page's round trip no longer rewrites it. describe → exec reported "Replaced page" with nothing changed, for 15 of one test app's 68 pages: a tab container's null default tab was written as the first tab (a stored second-tab default was reset every pass — a real loss), an expression's trailing newline was dropped, and an empty screen-reader label was written null. Reconcile now carries each from the stored element; all 15 report Unchanged, and 24 documents leave the round-trip suites' known-failure lists.
• A snippet parameter may come from any enclosing data container of the parameter's entity, a specialisation or a generalisation — as Studio Pro and mx check accept — not only the nearest. And an association hop whose stored destination is neither end of its association prints Assoc/Destination, so the rebuild arrives at the stored entity instead of the association's end.

MOVE between modules

Splitting a module left an entity access rule's XPath naming the old module ([Src.Order_Customer/Src.Customer/…], CE1613), its rules on the old module's roles, and a moved nanoflow's grants unmapped. Path steps in XPaths and expressions are now rewritten when the moved element is an entity or association, and an entity's access rules and a nanoflow's grants move to the target's same-named roles (a role the target lacks is kept, with a warning). Measured on 11.12.6: the issue's split leaves 2 errors before, 0 after. Fixes #1687

lint

• CONV013 no longer flags Rollback where it's the only valid choice: inside a loop (CE0644), and on a call to a Java action that exists to throw, such as CommunityCommons.ThrowException. Fixes CONV013 flags a deliberate ThrowException call and java action calls in a loop, where Rollback is the only valid handling #1689

docker build / run / reload

They ran mx update-widgets on their temporary copy before the check and build, so a project with stale stored widget definitions built while docker check, run --local and Studio Pro reported CE0463 — the deployment was not built from what is committed. The pre-build check now checks the stored copy and labels each CE0463 as one mxcli fix widgets clears or one that persists, and MxBuild builds the model as stored. --update-widgets keeps the old behaviour (and says the project still has stale widgets); --no-update-widgets skips the labelling re-check.

init --tool opencode

The generated opencode.json listed both skill trees as instructions, which OpenCode inlines whole: 150 files, 2.7 MB, ~73% of a 1M context window before the user typed anything. Its instructions are now AGENTS.md alone; OpenCode discovers .opencode/skills/ and loads a skill when its description matches. Those copies no longer get a second frontmatter whose title-based description OpenCode read instead of the skill's own. Fixes #1683

Tests

EntityToRefresh = "CustomModule"."NPActivity" on a JavaScript action argument is pinned: main stores the bare qualified name and mx check 11.14 reports 0 errors, so the regression reported against 0.26.0 is caught by name. Refs #1785