@cratis/pi 7.65.0 → 7.67.0

package/package/corpus/skills/cratis-screenplay-render-and-gap-fill/references/renderability-gate.md

@@ -31,7 +31,7 @@ ESM). Only the probe answers renderability. `PLAY0270` entries are information,
 | Class | Meaning | Typical examples (each verified in `admission.md`) | Action |
 | --- | --- | --- | --- |
 | **Model fix (in mode)** | the model is in, or the user chose, renderable mode and breaks its own subset in a way that has a renderable equivalent with the same meaning | a `produces` whose `for` is not the command identifier; two projections for one read model (`-007`); a policy Stage cannot express portably (`-015`; role-only and opaque pure policies render) | edit request to the modeler session with address, change and rationale |
-| **Capability gap** | the intended meaning needs a construct Stage does not render yet | DateTime equality filters and required parameters after optional filters (`-010`); context/single-result filters, opaque `scoped to`/`performer` and composite `by` remain PLAY0268; Translate, clocks, captures, non-event triggers and opaque reaction bodies (`-024`); claim-reading/opaque `runs as` gates (`-034`), legacy `from` (`-035`), mixed effects in one handler (`-037`, retries can duplicate events; keep it whole), unsupported reaction mappings (`-039`); unsupported generated types/result combinations (`-028`/`-038`); `then no readmodel` (`-027`); evolved events (`STAGE-ESM-026`); unsupported expression/enum production conditions (`-006`; supported conditional productions render); legacy reads (`PLAY0271`), protected-read rendering (STAGE-ESM-044 despite v25 admission; semantic Host/executor support is separate); code validation (`-005`); protected identities/enums (`-040`) or unadmitted explicit subject lineage (`PLAY0268`); attached command handlers (PLAY0268), described handlers (v23, STAGE-IMPL-002 even Stub mode), atomic mode (STAGE-ESM-016 for v22, STAGE-ESM-043 in admitted v23–v25) | keep the model; fallback record entry; options a to c in `SKILL.md`; link the Stage issue |
+| **Capability gap** | the intended meaning needs a construct Stage does not render yet | DateTime equality filters and required parameters after optional filters (`-010`); context/single-result filters, opaque `scoped to`/`performer` and a list-query `by` block remain PLAY0268; a read model with several key parts (v27) refuses `STAGE-ESM-016`; Translate, clocks, captures, non-event triggers and opaque reaction bodies (`-024`); claim-reading/opaque `runs as` gates (`-034`), legacy `from` (`-035`), mixed effects in one handler (`-037`, retries can duplicate events; keep it whole), unsupported reaction mappings (`-039`); unsupported generated types/result combinations (`-028`/`-038`); `then no readmodel` (`-027`); evolved events (`STAGE-ESM-026`); unsupported expression/enum production conditions (`-006`; supported conditional productions render); legacy reads (`PLAY0271`), protected-read rendering (STAGE-ESM-044 despite v25 admission; semantic Host/executor support is separate); code validation (`-005`); protected identities/enums (`-040`) or unadmitted explicit subject lineage (`PLAY0268`); attached command handlers (PLAY0268), described handlers (v23, STAGE-IMPL-002 even Stub mode), atomic mode (STAGE-ESM-016 for v22, STAGE-ESM-043 in admitted v23–v26) | keep the model; fallback record entry; options a to c in `SKILL.md`; link the Stage issue |
 | **Tool skew** | the bundled compiler disagrees with documented semantics | the false `PLAY0285` on reaction cascades from an older bundle; codes the standalone compiler does not raise | record in the session state and the fallback record; never "fix" a correct model |
 | **Environment** | not the model | restore failures, missing SDK, a destination that is not writable | fix the environment or report blocked |
 

package/package/corpus/skills/cratis-screenplay-scenario-coverage/references/scenario-examples.md

@@ -219,6 +219,6 @@ empty-list intent is a separate claim from a keyed row being absent (`view-and-s
 queries are executable too (`ListOpenInvoices` in the backing example); caller-supplied equality filters on collections bind as ESM v14.
 Pass `by` and filters in query arguments; PLAY0468 reports unknown, repeated or
 missing required arguments. Optional filters may be omitted, supplied null is refused.
-Context-sourced/single-result filters, opaque `scoped to`/`performer`, and composite
-`by` remain PLAY0268. Compiled coverage and renderer ceilings:
+Context-sourced/single-result filters, opaque `scoped to`/`performer`, and a list-query
+`by` block remain PLAY0268. Compiled coverage and renderer ceilings:
 read-surface [equality filters](../../cratis-screenplay-read-surface/references/equality-filters.md).

package/package/corpus/skills/cratis-screenplay-scenario-coverage/references/spec-forms-by-mode.md

@@ -18,7 +18,7 @@ Typed example/override forms: `cratis-screenplay-specifications`
 | `then readmodel` / `then query` (keyed `ById`, `arguments`, `result`) | yes | yes | yes |
 | `then query` on an unfiltered list or a list narrowed by one `by` key (observable too) | yes | yes: no `arguments` for an unkeyed list, one `result` per row stating the read-model identifier, no `result` = empty list | snapshot and observable lists render |
 | Collection query with caller-supplied equality `filter`, including observable | yes | yes, ESM v14: same-named scalar property/type, AND with `by`; optional omission allowed, supplied null refused; PLAY0468 checks arguments; row order does not matter | yes on supported snapshot/observable collections; DateTime/filter parameter order refuse -010; independent Stage executor still refuses filtered assertions (-010) |
-| Context `from`, single-result filters, `scoped to`, `performer` or composite `by` | yes | PLAY0268: query context, collection-only filtering, opaque scope/implementation or multipart lookup are unadmitted | no |
+| Context `from`, single-result filters, `scoped to`, `performer` or a list-query `by` block | yes | PLAY0268: query context, collection-only filtering, opaque scope/implementation or a multipart list lookup are unadmitted | no |
 | `then no readmodel <RM> for "<key>"` | yes | yes | no |
 | `when query` -> `then result` / `then no result` | yes | yes | same as `then query`: only the query-only cases below |
 | `given clock` / `when clock`, `when trigger`, record-source `given`/`when capture` | yes | yes (standalone and any cratis whose compiler admits v6; an older bundle does not, see toolchain `references/executable-subset.md`) | no |
@@ -34,12 +34,12 @@ Typed example/override forms: `cratis-screenplay-specifications`
 | Refusal branches, `$refusal` | yes | ESM v19; first matching branch wins | Stage supported subset; -039 for unfaithful refusal details/trigger groups, -011 for specification limits |
 | Query `then error` | yes | ESM v18; one query/one error, no result/denial | requires target v18 admission; a v19-capable renderer does not necessarily admit v18 |
 | Composite (JSON) values in specs | yes | yes | no |
-| Same-primitive `Date`/`DateTime` comparisons in `require`, `produces when` and command or property validation rules (v26; Requires Screenplay 4.199.0; see [date comparisons](../../cratis-screenplay-command-surface/references/date-comparisons.md)) | spec them | binds and executes; a `DateTime` input without an offset is a Validation rejection | v26 STAGE-ESM-016: gap-fill |
+| Same-primitive `Date`/`DateTime` comparisons in `require`, `produces when` and command or property validation rules (v26; Requires Screenplay 4.199.0; see [date comparisons](../../cratis-screenplay-command-surface/references/date-comparisons.md)) | spec them | binds and executes; a `DateTime` input without an offset is a Validation rejection | Host/executor run it (Requires Stage 4.135.0); renderer STAGE-ESM-046: gap-fill |
 | Date rules using `today`, `$context`, mixed `Date`/`DateTime`, concept or reaction-`where` positions; nested paths | spec them in design | rule does not bind: `recorded` | `recorded` |
 | Bodied rules, code policies | spec them | spec reported **unsupported**, never passed | no |
 | Pending described command handlers (v23) | specify intent | binds; denial/validation execute, body-reaching specs Unsupported ImplementationBody; all-Unsupported is not green | STAGE-IMPL-002 even Stub mode |
 | Attached command handlers, `file` constraints, query `performer`s | spec them in design | blocked: PLAY0268 at binding, no spec runs (V3 blocked) | no |
-| Atomic reaction mode (v22) | declare for new models | failed batch adds no facts or view changes; earlier batches/commands remain; `then error` alone is insufficient | v22 STAGE-ESM-016; mode in admitted v23–v25 STAGE-ESM-043 |
+| Atomic reaction mode (v22) | declare for new models | failed batch adds no facts or view changes; earlier batches/commands remain; `then error` alone is insufficient | v22 STAGE-ESM-016; mode in admitted v23–v26 STAGE-ESM-043 |
 | Protected command reads (v25) | declare opt-in for eligible reads | absence Validation; matching intervening facts Conflict; race vectors are not a new spec construct | Cratis C# rendering STAGE-ESM-044; semantic Host/executor execute admitted reads, non-Error protected requirements STAGE-ESM-045; v25 pair admitted |
 
 Requires Screenplay 4.105.0 or later (`screenplay --version`) for list-query specifications, and 4.143.0 or later for collection equality filters (ESM v14).

package/package/corpus/skills/cratis-screenplay-slice-design/SKILL.md

@@ -122,7 +122,7 @@ Ask the batch below only for what the request leaves open: (1) origin of each ac
 
 - At most one `identifier` per command; never on an event property or read-model property (use `key`). At most one builder per read model (`PLAY0191`). Read `references/read-model-design.md` ("Identifier and key contract") for the exact rules.
 
-- A query's `by` goes on its own body line; `from`, single-result filters, scope, performer and composite `by` remain `PLAY0268`; equality filters on collections bind as ESM v14. Read `references/read-model-design.md` ("Query binding") for the binding rules.
+- A query's `by` goes on its own body line; `from`, single-result filters, scope, performer and a list-query `by` block remain `PLAY0268`; equality filters on collections bind as ESM v14. Read `references/read-model-design.md` ("Query binding") for the binding rules.
 
 - A `unique` constraint names a property the event declares directly; the constraint name is
   its identity (renaming starts an empty index).
@@ -146,7 +146,7 @@ collections, invariants, who sees which rows); report a finding only with a doma
 
 ## Public boundaries and view identity
 
-Translate crosses an application boundary (inbound consumes foreign public events; outbound folds private facts into exactly one local public event type); commands never publish public events. Mark view identity with trailing `key`; composite view keys remain unadmitted (`PLAY0268`) - keep the true identity and report the gap. Read [references/public-boundaries-and-keys.md](references/public-boundaries-and-keys.md) when a slice crosses an application boundary or a view needs a composite identity.
+Translate crosses an application boundary (inbound consumes foreign public events; outbound folds private facts into exactly one local public event type); commands never publish public events. Mark view identity with trailing `key`; flat composite view keys bind as ESM v27 (Requires Screenplay 4.204.0) - keep the true identity. Read [references/public-boundaries-and-keys.md](references/public-boundaries-and-keys.md) when a slice crosses an application boundary or a view needs a composite identity.
 
 ## Identity-affecting edits on an existing model
 

package/package/corpus/skills/cratis-screenplay-slice-design/references/public-boundaries-and-keys.md

@@ -11,6 +11,8 @@ the slice outline and trace every exported field; read automations-and-translati
 Mark view identity with trailing `key`. Use a composite key for independent view
 coordinates (resource + period), a natural single id for one entity's state.
 Supply every named part in single-instance queries and command/trigger reads;
-see read-surface `references/named-keys.md`. Composite view keys remain
-unadmitted (PLAY0268), unlike admitted composite stream routes.
-Keep the true identity and report the gap rather than inventing a concatenated id.
+see read-surface `references/named-keys.md`. Flat composite view keys bind as ESM v27
+(older binders refuse with PLAY0268; compiler requirement in named-keys), as do composite
+stream routes. Command and trigger reads by parts stay refused, and Stage does not admit
+v27. Keep the true identity rather than inventing a concatenated id; choosing between
+shapes: streams-and-consistency `references/read-model-keys.md`.

package/package/corpus/skills/cratis-screenplay-slice-design/references/read-model-design.md

@@ -327,8 +327,9 @@ module Berths
 - A query's `by` goes on its own body line. Optional keyed and collection queries
   bind, including observable delivery. Caller-supplied equality filters on collections
   bind as ESM v14; `by` ANDs with supplied filters. `from`, single-result
-  filters, scope, performer and composite `by` remain PLAY0268 for their respective
-  context/cardinality/opaque/multipart gaps. Read read-surface
+  filters, scope, performer and a `by` block on a list query remain PLAY0268 for their
+  respective context/cardinality/opaque/multipart gaps. A composite-keyed optional
+  single-instance query takes a `by` block naming every part (ESM v27). Read read-surface
   [equality filters](../../cratis-screenplay-read-surface/references/equality-filters.md).
 
 ## Executable identity of a read model

package/package/corpus/skills/cratis-screenplay-specifications/SKILL.md

@@ -175,8 +175,9 @@ Use `when append <PrivateEvent>` then `then <PublicEvent>`, not `then readmodel`
 follow-up events are exhaustive and ordered. Read
 [publication and fold cases](../cratis-screenplay-automations-and-translations/references/public-events-and-direction.md)
 when specifying outbound facts or event-source captures: it owns the minimum
-compiler, PLAY0700/0701, key folding and Unsupported boundaries. Composite view
-fixtures remain unadmitted; see read-surface `references/named-keys.md`.
+compiler, PLAY0700/0701, key folding and Unsupported boundaries. Composite-keyed
+view fixtures state every key part (Requires Screenplay 4.204.0, ESM v27); see
+`references/vocabulary.md` and read-surface `references/named-keys.md`.
 
 ## Reusable fixtures, routes and recovery intent
 

package/package/corpus/skills/cratis-screenplay-specifications/references/query-rejections.md

@@ -10,6 +10,10 @@ through their concept's `validate` rules in every ESM version. An omitted option
 filter is not validated. A violation is a Validation rejection carrying the rule's
 message; a valid key with no matching instance is absence.
 
+On a composite-keyed read model every `by` part of a single-instance query is validated
+the same way; an argument that breaks a part's concept rule binds and rejects with
+Validation (Requires Screenplay 4.204.0, ESM v27).
+
 Use exactly one query request and one `then error`, bare or with a message. No
 command/append/reaction action, result, `then no result` or `then denied` may
 accompany it (PLAY0465). An actionless `then query` with `arguments` and no `result`

package/package/corpus/skills/cratis-screenplay-specifications/references/vocabulary.md

@@ -35,6 +35,23 @@ This reference holds the given/when/then construct table and the enumeration and
 | `for <value>` | the event source of a `given`/`then` event, or of the `when` command or appended event |
 | `<property> = <value>` | a literal, `null`, or a one-line JSON-shaped object or list: `lines = [{"sku":"A-1","quantity":2}]` |
 
+## Composite-keyed read models
+
+Requires Screenplay 4.204.0 (ESM v27; `screenplay --version`); older binders refuse a
+read model with two or more `key` marks, and every specification over it, with PLAY0268.
+
+- `given readmodel` and `then readmodel` state every key part (missing part PLAY0351,
+  repeated part PLAY0519).
+- `then no readmodel <Type> for {"part":"value",...}` names every part (missing PLAY0661,
+  unknown PLAY0662, repeated member PLAY0294).
+- `when query` or `then query … arguments` supplies every `by` part of a single-instance
+  query, or the equality filters of a list query (missing, unknown or repeated PLAY0468).
+- A single-instance `then result` may omit parts the arguments supply; list rows state
+  every part. A stated part that disagrees with the argument fails to match at run time.
+- Parts match one by one in any order; Uuid parts compare as ordinal text.
+
+The complete model with these specifications is in read-surface `references/named-keys.md`.
+
 ## Parse and binding diagnostics
 
 PLAY0358 is a syntax error; PLAY0388 also occurs at parse time for extra text

package/package/corpus/skills/cratis-screenplay-streams-and-consistency/SKILL.md

@@ -138,6 +138,8 @@ Requires Chronicle 19.59.6 or later (19.59.3 for the InMemory provider) for the
 
 **Modeling defaults** (deviate with a recorded reason)
 - One business identity per stream; cross-stream references are payload properties.
+- A read model's key is not a stream identity. Read [references/read-model-keys.md](references/read-model-keys.md)
+  when choosing one id, flat composite key parts (v27) or a composite-typed key.
 - Copy the source id into the payload only when a consumer needs it as a value.
 - Give each invariant an authoritative atomic decision point and inspect every path that could
   violate it. A constraint violation rejects that command's whole append set; a reaction cascade
@@ -145,7 +147,7 @@ Requires Chronicle 19.59.6 or later (19.59.3 for the InMemory provider) for the
 - New models declare `reaction batches atomic`: direct productions per trigger
   occurrence and each selected refusal branch are separate batches; invoked commands
   stay independent. Legacy absence retains per-fact appends. Stage refuses v22
-  with STAGE-ESM-016 and atomic mode in admitted v23–v25 with STAGE-ESM-043. Read
+  with STAGE-ESM-016 and atomic mode in admitted v23–v26 with STAGE-ESM-043. Read
   [atomic boundaries](../cratis-screenplay-captures-and-reactions/references/atomic-batches-and-source-mappings.md)
   when defining failure rollback; batching is not redelivery deduplication.
 - Match duplicate protection to scope. A property constraint lets a source re-claim its own

package/package/corpus/skills/cratis-screenplay-streams-and-consistency/references/read-model-keys.md

@@ -0,0 +1,46 @@
+<!-- Copyright (c) Cratis. All rights reserved. -->
+<!-- Licensed under the MIT license. See LICENSE file in the project root for full license information. -->
+
+# Read-model keys: one id, flat parts or a composite-typed key
+
+Requires Screenplay 4.204.0 (ESM v27; `screenplay --version`) for a read model with two or
+more `key` marks; older binders refuse it with PLAY0268. A read model with one `key` mark
+keeps its earlier version and bytes.
+
+A read model's key says which instance a lookup or projection reaches. It is not a stream
+identity and not an atomic decision point: choose it after the streams, and keep invariants
+in constraints and commands.
+
+## Choose the shape
+
+| Business shape | Key | Why |
+| --- | --- | --- |
+| The view is one entity's state | One natural `key` property (default) | Binds on every supported version, and the event source usually supplies it |
+| Independent coordinates identify the view (resource and period, plant and field), read by filtering on some parts or by all parts | Several flat `key` properties (v27) | Each part keeps its name and type; a list narrows by any part with equality filters |
+| One value object already identifies the entity everywhere (it is also a command or event value) | One `key` property whose type is a composite `type` | Executes on earlier versions; projections use a typed `key TypeName` block |
+
+A read model has exactly one of the two composite shapes: mixing flat parts with a
+composite-typed key is PLAY0660, though one application may hold read models of both.
+Do not concatenate parts into a string id to avoid a composite key, and do not invent a
+composite type only to carry flat parts: both hide the identity the model should state.
+
+## What flat parts do and do not do
+
+- **Equality is per part**, in any order. Uuid parts compare as ordinal text with no case
+  folding, so write one spelling of each uuid in events, fixtures and query arguments.
+- **A projection names every part** in an untyped `key` block on each root `from` and
+  `remove with`. The parts come from the event payload; they need not match the event
+  source. `remove with` deletes one instance and a later `from` recreates it.
+- **A composite key does not enforce uniqueness.** Two events can still claim the same
+  part values; use a `unique` constraint over the same properties when the store must
+  refuse the duplicate (`references/consistency-and-concurrency.md`).
+- **Lookups.** An optional single-instance query names every part in a `by` block; a list
+  uses equality filters. A command or reaction that must read the view by parts is refused
+  (PLAY0271, PLAY0781 ByParts, or PLAY0268 for a producing reaction), so decide on a stream
+  the command owns instead, or restructure the read. Do not drop the read to bind.
+- **Limits.** Joins, `children`, `nested`, `every`, `all`, `variant` and reducers on the
+  composite-keyed view are PLAY0268. Stage refuses v27 with STAGE-ESM-016, so deliver it
+  through gap-fill with the model as the contract.
+
+Read read-surface `references/named-keys.md` for one complete executable example and the
+projections skill `references/pdl-grammar.md` for the key block syntax.

package/package/corpus/skills/cratis-screenplay-toolchain/SKILL.md

@@ -101,7 +101,7 @@ changes with the root folder name.
 - **Executable** (binds, V3): `references/executable-subset.md`. Optional keyed lookups, unfiltered
   lists and lists narrowed by one `by` key (observable too) bind; caller-supplied equality
   filters on collections bind as ESM v14. Context `from`, single-result
-  filters, opaque `scoped to`/`performer` and composite `by` remain PLAY0268. Read
+  filters, opaque `scoped to`/`performer` and a `by` block on a list query remain PLAY0268. Read
   read-surface [equality filters](../cratis-screenplay-read-surface/references/equality-filters.md).
   Pending handlers beside unconditional productions bind as described commands (v23),
   but reached bodies are Unsupported; attached handlers remain PLAY0268.
@@ -120,9 +120,10 @@ changes with the root folder name.
 - **Public contracts and routes (v9/v10/v11):** public contracts and direction select v9;
   reaction identity, production overrides and observer filters select v10;
   qualifying retained non-route Double literals select v11.
-  Composite view keys remain authoring-only (PLAY0268), while one explicit
-  `key` binds. Read `references/production-routes-and-filters.md` and read-surface
-  `references/named-keys.md`.
+  Flat composite read-model keys select v27 (Requires Screenplay 4.204.0; older binders
+  report PLAY0268); one explicit `key` keeps its earlier version. Read
+  `references/production-routes-and-filters.md`, [language admission](references/language-admission.md)
+  and read-surface `references/named-keys.md`.
 - **Enum numbers (v12):** read command-surface `references/enum-numbers.md` for
   pins, stored numbers and Stage output; `references/diagnostics.md` owns PLAY0667–0671.
 - **Concept strategies (v15):** read
@@ -189,7 +190,7 @@ Read [references/diagnostics.md](references/diagnostics.md) when a PLAY, STAGE o
 7. Mark read-model identity with trailing `key`, not `identifier`. Otherwise single-instance
    queries must agree on `by`; only with none and an admitted list query can `*Id`
    inference run. Queryless views need `key` (read-surface `references/named-keys.md`).
-   Align projection keys. Multipart keys remain PLAY0268.
+   Align projection keys; several parts need an untyped `key` block (v27).
 8. Projection `key` routes only on `from`; joins never create; `all` is per source.
 9. `null` only for optional read-model properties in specifications.
 10. `then` events are exhaustive and ordered; after `when append` they list only what followed.

package/package/corpus/skills/cratis-screenplay-toolchain/references/cheat-sheet.md

@@ -28,8 +28,8 @@ keeping the capture in Translate. No automatic split.
 Requires Screenplay 4.176.0 or later; older compilers leave that shape unchecked.
 Read
 [public contracts](../../cratis-screenplay-automations-and-translations/references/public-events-and-direction.md).
-View properties use trailing `key`; multipart `by` query/read blocks remain
-PLAY0268, not v10. Read [named keys](../../cratis-screenplay-read-surface/references/named-keys.md).
+View properties use trailing `key`; several parts select v27 (not v10), with a `by` block on
+an optional single-instance query and equality filters on lists. Read [named keys](../../cratis-screenplay-read-surface/references/named-keys.md).
 Production `stream Source.Stream` overrides and reaction/reducer `from Source[.Stream]`
 select released v10: [routes and filters](production-routes-and-filters.md).
 Qualifying non-route Double literals select v11;

package/package/corpus/skills/cratis-screenplay-toolchain/references/diagnostic-arguments.md

@@ -49,6 +49,13 @@ a separate `case` names an expansion. Argument order is immaterial.
 | PLAY0524 | `specification` (declaration), `step` (keyword), `stepIndex` (index), `property`, `type`, `example?`, `case?`, `parameter?` |
 | PLAY0525, PLAY0526 | `example` |
 | PLAY0583 | `case?`, `parameter?`, `type?`, `text?` |
+| PLAY0790, PLAY0794, PLAY0799 | `profile`, `template`, `blueprint?` |
+| PLAY0791 | `profile`, `template` (the layout name) |
+| PLAY0792 | `profile`, `template`, `blueprint` |
+| PLAY0793 | `profile`, `template`, `blueprint`, `version` |
+| PLAY0795 | `profile`, `template`, `blueprint?`, `outlet` |
+| PLAY0796 | `profile`, `template`, `blueprint?`, `option` |
+| PLAY0797 | `profile`, `value` |
 
 For PLAY0524, `step` is given, given readmodel, when, when append or then.
 `stepIndex` counts every authored given/when/then clause once across all forms,

package/package/corpus/skills/cratis-screenplay-toolchain/references/diagnostics.md

@@ -11,6 +11,7 @@
 - Caller identity, compliance and routes
 - Specification metadata, callers, cases and locators
 - Guarded interaction diagnostics
+- UI profile shell: root template, options, appearance
 - Structural completeness and timeline checks
 - Editor versus C# verdicts
 - Consistency errors (V1: the model contradicts itself)
@@ -136,9 +137,11 @@ Target evidence: a renderer must admit ESM v16 and preserve `storedName`, or ref
 | PLAY0665 | E | Invalid/duplicate/child-bearing/unresolved source/stream filter or filtered reaction with a non-event trigger |
 | PLAY0666 | W | Filter excludes all statically known effective producer routes; C# only, handlers/foreign origins suppress it |
 
-Queries and trigger reads have no PLAY0661 repair. Composite view keys, query
-blocks and their fixtures remain PLAY0268, while one explicit key binds
-byte-identically to inference. Fixtures missing any part report PLAY0351.
+Queries and trigger reads have no PLAY0661 repair. Flat composite view keys bind as v27;
+projection or removal key blocks missing a part report PLAY0661 and bad parts PLAY0662.
+One explicit key binds byte-identically to inference. Fixtures missing any part
+report PLAY0351. Joins, children, `every`, `all`, `nested`, `variant`, reducers and
+list-query `by` blocks over a composite-keyed view are PLAY0268.
 Overrides/filters select released ESM v10; malformed routes also use PLAY0504.
 Read read-surface `references/named-keys.md` and
 [production routes and filters](production-routes-and-filters.md).
@@ -248,6 +251,26 @@ comment loss and do not support pinned evidence. TypeScript diagnoses but does
 not offer these repairs. Preview through MCP `propose-repair`, never text-patch
 around a refusal. Condition/subject errors also use guarded-action PLAY0341–0348.
 
+## UI profile shell: root template, options, appearance
+
+Requires Screenplay 4.200.0 or later (`screenplay --version`); 4.197.0 reads the syntax without the checks. The fix for each is in
+`../../cratis-screenplay-ui-composition/references/ui-profile-and-theme.md`.
+
+| Code | Severity | Meaning / fix |
+| --- | --- | --- |
+| PLAY0788 | E | A `root template` / `new screens use template` line is malformed, or pins a version on an own template. |
+| PLAY0789 | E | A malformed or repeated `appearance` line, or a second `appearance` block. |
+| PLAY0790 | E | The template is not declared (or the blueprint does not ship it). Declare it or take it from a blueprint. |
+| PLAY0791 | W | The profile selects its shell with the legacy `layout <Name>`. Write `root template <Name>`; the quick fix rewrites it (or removes the ignored line beside a `root template`). |
+| PLAY0792 | E | The blueprint is not in the profile's `packages` (or not installed). |
+| PLAY0793 | W | The pinned `version` range is not satisfied by the installed blueprint (catalog hosts only). |
+| PLAY0794 | E | The root template cannot be the shell (not a layout or application-scope template, fits a slot, `scopes` without `application`). |
+| PLAY0795 | E | The root template has no `content` slot. |
+| PLAY0796 | W | An `option` the shell does not expose. |
+| PLAY0797 | E | Color scheme is not `light`, `dark` or `system`, or the accent is not a hex colour. |
+| PLAY0798 | E | More than one `root template` in a profile. |
+| PLAY0799 | E | `new screens use template` cannot start a screen in a feature. |
+
 ## Structural completeness and timeline checks
 
 Opt in with `--check <names>` or MCP diagnostics `checks`, then treat warnings
@@ -325,15 +348,16 @@ refusal reasons. Read [language admission](language-admission.md) before changin
 | PLAY0785 | Ambiguous view path; use distinct aliases on repeated reads |
 | PLAY0786 (I) | Eligible legacy model; preview typed preamble repair, individually review absence/conflict semantics |
 | PLAY0787 (W) | Exact deprecated Studio text-rule pattern; repair to literal rule or equality, preserving message/severity |
-| STAGE-ESM-043 | Atomic mode not realized, even in admitted v23–v25; retain declaration and gap-fill |
+| STAGE-ESM-043 | Atomic mode not realized, even in admitted v23–v26; retain declaration and gap-fill |
 | STAGE-ESM-044 | Cratis C# renderer refuses protected reads despite v25 admission; semantic Host/executor support is separate; keep protection and gap-fill generated-app scope |
 | STAGE-ESM-045 | Non-Error protected requirement; semantic Host/executor refuse before execution, including reaction-invoked commands; keep severity and report Unsupported |
 | STAGE-IMPL-002 | Described handler body not realized by Stage, even Stub mode; no stubs emitted |
 
 Invalid match syntax remains PLAY0367. Property/concept text rules bind v24;
 `contains`/`starts with` in conditions only still fail PLAY0268. Stage rejects
-v22/v26 and mixed pairs with STAGE-ESM-016; v23–v25 admission does not implement
-bodies, batches or rendered protected reads (STAGE-ESM-044). Requires Stage 4.129.0
+v22/v27 and mixed pairs with STAGE-ESM-016; v23–v26 admission does not implement
+bodies, batches or rendered protected reads (STAGE-ESM-044), and the renderer refuses
+v26 date comparisons with STAGE-ESM-046. Requires Stage 4.129.0
 for semantic Host/executor protected reads; older engines refuse -044. Read
 [language admission](language-admission.md) for the stricter Host outside-append guard.
 

package/package/corpus/skills/cratis-screenplay-toolchain/references/executable-subset.md

@@ -11,6 +11,7 @@
 - Generated values and responses (ESM v7)
 - Released public boundaries and observer routes
 - Chronological command date comparisons (ESM v26)
+- Flat composite read-model keys (ESM v27)
 - Code attachments (what binds, what never does)
 - Refused (code, reason): fix, or record as a mode gap
 - Not refused, but do not rely on it
@@ -41,7 +42,7 @@ Complete examples that bind live in `executable-example.md`, `pdl-example.md` (p
 `automation-translate-example.md` (ESM v6) and `generated-responses-example.md` (ESM v7).
 
 For atomic batches (v22), described handlers (v23), ordinal text rules (v24) and
-protected reads (v25) and chronological command dates (v26), read
+protected reads (v25), chronological command dates (v26) and composite keys (v27), read
 [language admission](language-admission.md). A later
 version alone does not enable either application opt-in.
 
@@ -86,10 +87,10 @@ Requires Screenplay 4.141.0 or later (`screenplay --version`) to bind concept co
   none supplies identity and an admitted list query exists does conventional
   `*Id` inference run (collection-key exclusions: read-surface `references/named-keys.md`).
   Queryless read models need an explicit `key`. Explicit single keys preserve
-  equivalent inferred ESM bytes. Composite read-model keys, query `by` blocks and
-  their fixtures remain PLAY0268. Collections and observable delivery bind.
+  equivalent inferred ESM bytes. Flat composite read-model keys bind as v27
+  (see below). Collections and observable delivery bind.
   Caller-supplied equality filters on collections also bind as ESM v14; context
-  sources, single-result filters, scope, performer and composite `by` remain blocked.
+  sources, single-result filters, scope, performer and a list-query `by` block remain blocked.
 - One projection per read model: `from`, `every`, `all` (one block per level), `join`,
   `children`, `nested`, `remove with`, `remove via join` (binds; blocks the execution plan at the projection level, see below), `clear with`, counters, `add`,
   `subtract`, `set`, `clear`, variants, and the identifier mapped from the projection's key (`xId = $eventSourceId` only for an event-source key).
@@ -264,15 +265,36 @@ DateTime input needs an offset or `Z`, else Validation rejects before rules, eve
 for skipped comparisons. `then` matching stays ordinal. Invalid date literals or
 offset-less DateTime literals in admitted comparisons report PLAY0273. Read
 [date comparisons](../../cratis-screenplay-command-surface/references/date-comparisons.md)
-for the complete window model and retained PLAY0268 refusals. Stage refuses v26
-with STAGE-ESM-016, independently of standalone binding/reference execution.
+for the complete window model and retained PLAY0268 refusals. The Stage renderer refuses
+v26 date comparisons with STAGE-ESM-046, independently of standalone binding/reference execution.
+
+## Flat composite read-model keys (ESM v27)
+
+Requires Screenplay 4.204.0 (ESM v27; `screenplay --version`); older binders refuse a
+read model with two or more `key` marks with PLAY0268. Binding admits a model with
+several flat scalar key parts when:
+
+- root `from` and `remove with` blocks name every part in an untyped `key` block;
+- a list query narrows with equality filters, and an optional single-instance query
+  names every part in a `by` block;
+- fixtures state every part (`given readmodel`, `then readmodel`, `then no readmodel`).
+
+Models with one `key` mark keep their earlier version and bytes. Refused with PLAY0268:
+joins, `children`, `remove via join`, `every`, `all`, `nested`, `clear with`, `variant`
+and reducers on the composite-keyed read model, a list query with a `by` block, a
+non-optional single-instance return, and command reads (PLAY0271, or PLAY0781
+ByParts under `command reads protected`) or trigger reads that produce directly.
+Stage refuses v27 with STAGE-ESM-016, independently of standalone binding and
+reference execution. Read read-surface
+[named keys](../../cratis-screenplay-read-surface/references/named-keys.md) for the
+complete example.
 
 ## Code attachments (what binds, what never does)
 
 Pending `handler implementation` beside unconditional `produces` binds as a described
 command (v23). Its payload-only body returns Unsupported ImplementationBody when reached;
 denial/validation specs still run. Read [language admission](language-admission.md) for
-v22–v26 and [described handlers](../../cratis-screenplay-command-surface/references/described-handlers.md)
+v22–v27 and [described handlers](../../cratis-screenplay-command-surface/references/described-handlers.md)
 for the result contract. Attached handlers remain unbound.
 
 Inline fences (`csharp`, `typescript`, `react`, `html`, `sql`) and `file <path>` attach
@@ -316,7 +338,7 @@ bodies still leave their owner non-executable.
 | `Automation` or `Translate` slice, `reaction`, `capture`, `trigger`; `given clock`, `when clock`, `when trigger`, `when capture` | PLAY0268 | **older bundled compilers only**; current compilers bind them (ESM v6) |
 | Unquoted `import Other.Contract` | PLAY0268 | external contract import is not bound |
 | `pii` or `secret` on a concept | PLAY0268 | Older compilers refuse it outright. Current compilers admit v13 except enum/identity compliance and events mixing personal or explicitly subject-scoped secret values with explicit subject marks; see `compliance.md` in command-surface references |
-| `query` with a composite `by` block, or `by ... from` context-derived arguments | PLAY0268 | composite `by` blocks remain unadmitted. An optional scalar snapshot lookup, an unfiltered list (`RM[]`) and a list narrowed by one caller-supplied `by` key bind, in their `observable` form too |
+| `query` with a `by` block over a list, or `by ... from` context-derived arguments | PLAY0268 | a `by` block binds only on an optional single-instance query (v27). An optional scalar snapshot lookup, an unfiltered list (`RM[]`) and a list narrowed by one caller-supplied `by` key bind, in their `observable` form too |
 | Context `from`, single-result filters, `scoped to`, `performer` queries | PLAY0268 | Typed query context, filtering of single results, opaque scope and query implementation remain unadmitted; each refusal names its reason. Caller-supplied collection equality filters bind as v14. `observable` goes in the return position (`=> observable RM[]`); as a body line it is PLAY0048 |
 | `contains` or `starts with` in conditions only | PLAY0268 | conditions admit scalar equality and numeric ordering, plus same-primitive command date comparisons from v26; property/concept text rules bind as v24 |
 | Date comparisons with mixed primitives, `$context` (including occurred), `today`, protected read paths, optional condition operands, concept rules or reaction `where` | PLAY0268 | v26 admits only command conditions and command/property literal validation rules |
@@ -338,7 +360,7 @@ bodies still leave their owner non-executable.
 | `generated` or `returns` on an older compiler | PLAY0268 | admitted from ESM v7, see above |
 | Operations or systems, `numbers exact` source mode | PLAY0268 | not admitted by any supported ESM version; one such construct leaves the **whole** application without an executable model. Event sources/streams/routes instead bind as ESM v8 on the current compiler (`sources-and-streams.md`) |
 | Spec of a gated command or query without `given caller` | PLAY0389 | module and feature gates count |
-| `given` or `then readmodel` missing key parts | PLAY0351 | explicit `key` marks replace inference; composite fixtures need every part but remain unadmitted |
+| `given` or `then readmodel` missing key parts | PLAY0351 | explicit `key` marks replace inference; composite fixtures need every part (v27) |
 | When-less spec asserting events or errors | PLAY0352 | |
 | `null` in command or event values | PLAY0350 | Chronicle semantics, not only a binder limit: an optional fact is a separate event (nullable event properties are CHR0012) |
 | `for` with no unambiguous destination type | PLAY0273 | |

package/package/corpus/skills/cratis-screenplay-toolchain/references/language-admission.md

@@ -1,7 +1,7 @@
 <!-- Copyright (c) Cratis. All rights reserved. -->
 <!-- Licensed under the MIT license. See LICENSE file in the project root for full license information. -->
 
-# Language admission: batches, described bodies, text, reads and dates
+# Language admission: batches, described bodies, text, reads, dates and composite keys
 
 Select the highest version required by constructs in the model. A newer version
 alone never opts into either application mode. Consumers must explicitly admit
@@ -9,11 +9,12 @@ exact language/semantic pairs; binding, reference execution and rendering are se
 
 | ESM | Selecting construct | Binding/reference behavior | Stage boundary |
 | --- | --- | --- | --- |
-| v22 | Application-root `reaction batches atomic` | Direct productions per trigger occurrence and each selected refusal branch are separate atomic batches; commands remain independent | v22 refused STAGE-ESM-016; mode in admitted v23–v25 refused STAGE-ESM-043 |
+| v22 | Application-root `reaction batches atomic` | Direct productions per trigger occurrence and each selected refusal branch are separate atomic batches; commands remain independent | v22 refused STAGE-ESM-016; mode in admitted v23–v26 refused STAGE-ESM-043 |
 | v23 | Pending `handler implementation` beside unconditional `produces` | Payload-only body; PLAY0695 information; reaching body gives Unsupported ImplementationBody | v23 admitted, body refused STAGE-IMPL-002 in renderer/Host/executor, even Stub mode |
 | v24 | `contains`, `not contains`, `starts with`, `ends with` property/concept rules | Ordinal UTF-16, absent optional passes; not text-condition operators | v24 admitted; semantic Host/executor and generated ordinal comparisons preserve rules |
 | v25 | Application-root `command reads protected` | Admitted reads in requirements/mappings, absence Validation, matching decide/commit changes Conflict | v25 admitted; Cratis C# renderer refuses STAGE-ESM-044; semantic Host/executor execute reads, non-Error protected requirements refuse STAGE-ESM-045 |
-| v26 | Chronological command Date/DateTime comparisons | Same-primitive `==`, `!=`, `>`, `>=`, `<`, `<=`; DateTime UTC ticks and pre-rule offset validation | v26 refused STAGE-ESM-016 |
+| v26 | Chronological command Date/DateTime comparisons | Same-primitive `==`, `!=`, `>`, `>=`, `<`, `<=`; DateTime UTC ticks and pre-rule offset validation | v26 admitted; Host/executor run it, renderer and legacy engines refuse STAGE-ESM-046 |
+| v27 | A read model with two or more `key` marks | Untyped projection `key` blocks, equality-filter lists, single-instance `by` blocks, per-part fixtures | v27 refused STAGE-ESM-016 |
 
 Requires Screenplay 4.181.0 or later (`screenplay --version`) for atomic batches; older compilers cannot admit the preamble.
 
@@ -25,6 +26,8 @@ Requires Screenplay 4.193.0 or later (`screenplay --version`) for protected read
 
 Requires Screenplay 4.199.0 (ESM v26; `screenplay --version`) for date comparisons; older binders report PLAY0268.
 
+Requires Screenplay 4.204.0 (ESM v27; `screenplay --version`) for composite read-model keys; older binders report PLAY0268.
+
 Requires Stage 4.124.0 for v24 text-rule admission (`cratis --version` identifies the CLI bundle); older renderers refuse v24 with STAGE-ESM-016. V23 admission alone does not implement described bodies.
 
 Requires Stage 4.127.0 for v25 version admission; older renderers refuse v25 with STAGE-ESM-016. The Cratis C# renderer still refuses protected reads with STAGE-ESM-044; no artifacts are emitted.
@@ -56,8 +59,15 @@ positions, invalid date literals or offset-less DateTime literals use PLAY0273.
 Read [date comparisons](../../cratis-screenplay-command-surface/references/date-comparisons.md)
 for the complete interval example and input/target boundaries.
 
-Stage's semantic engines admit exact v1–v21 and v23–v25 pairs. V22/v26 and mixed
-pairs refuse STAGE-ESM-016. Admission of v23–v25 is not admission of described bodies,
+For v27, read read-surface [named keys](../../cratis-screenplay-read-surface/references/named-keys.md)
+for the one complete example and every refusal. Only a model with a read model of two or
+more key parts selects v27; one `key` mark keeps its earlier version and bytes. To see the
+selected version, open the model with the `screenplay` MCP server and call `read-workspace`
+with `view` `executable-model`: `languageVersion` reads `27.0`.
+
+Stage's semantic engines admit exact v1–v21 and v23–v26 pairs. V22/v27 and mixed
+pairs refuse STAGE-ESM-016. Requires Stage 4.135.0 for v26 admission; older Stage
+refuses v26 with STAGE-ESM-016. Admission of v23–v26 is not admission of described bodies,
 atomic mode or rendered protected reads. A CLI may bundle an older compiler/Stage pair: run no-write render
 admission rather than transferring a standalone verdict. Pattern diagnostics arise
 in Screenplay before rendering; diagnostic arguments add no ESM version or new tool.

package/package/corpus/skills/cratis-screenplay-toolchain/references/preferred-syntax.md

@@ -5,7 +5,7 @@
 
 Use these forms when writing or reviewing `.play`. Acceptance of an older
 spelling is not a recommendation to teach it. Information diagnostics do not
-fail `--warnaserror`; the corpus verification gate rejects the eleven style codes
+fail `--warnaserror`; the corpus verification gate rejects the twelve style codes
 below even when a fence declares `expect`, unless an exact, reasoned migration
 exception exists in the verifier's preferred-syntax allowlist. That allowlist also
 covers deliberate legacy explanations in prose; stale entries fail.
@@ -24,6 +24,7 @@ covers deliberate legacy explanations in prose; stale entries fail.
 | Interaction guard | Block-form `when` alternatives | Opaque interaction `where` on click, double click or select | PLAY0564 (warning or information) |
 | Projection transition cardinality | Source binding emits `One` | Constructed/deserialized ESM v1–v3 `ZeroOrOne` / `Many` | PLAY0445 (warning; ESM-only, not a source spelling) |
 | Command decision reads | `command reads protected` after reviewing every read's admission, absence and conflict semantics | Eligible legacy command reads without the application-root preamble | PLAY0786 (information; individual typed repair review, never fix-all) |
+| Profile shell | `root template <Name>` in a `ui profile` | `layout <Name>` in a `ui profile` | PLAY0791 (warning; quick fix) |
 | Literal text rules | `starts with`, `ends with`, `contains`, `not contains` or equality, preserving message and severity | Exact deprecated Studio `matches` shapes | PLAY0787 (warning; not arbitrary regex rewriting) |
 
 `query Q => observable?` is not a legacy optional type suffix and has no keyword

package/package/corpus/skills/cratis-screenplay-toolchain/references/production-routes-and-filters.md

@@ -103,7 +103,7 @@ and wrong source/stream, and unrouted input. Read [specification route forms](so
 
 ESM v10 carries reaction system identity, production route overrides and observer filters as one
 frozen contract. A consumer admitting v10 must include all three, not just identity.
-Composite **read-model** keys are separate and remain unadmitted (PLAY0268).
+Composite **read-model** keys are separate and select v27 (`language-admission.md`).
 
 The CLI/Stage pair admits through its newest version to construct checks: production overrides
 still refuse STAGE-ESM-036; reaction/reducer filters render on the semantic path,

package/package/corpus/skills/cratis-screenplay-toolchain/references/renderable-subset.md

@@ -21,9 +21,9 @@ and concept compliance (v13) render.
 
 ## Current admission
 
-Stage admits exact ESM v1–v21 and v23–v25 pairs; v22/v26 and mixed pairs
+Stage admits exact ESM v1–v21 and v23–v26 pairs; v22/v27 and mixed pairs
 refuse STAGE-ESM-016. Chronological command Date/DateTime comparisons select v26:
-standalone binding/reference execution does not make them renderable. Keep the
+the Host and executor run them, but the renderer refuses STAGE-ESM-046, so they are not renderable. Keep the
 rule and use authorized gap-fill. Version admission is separate from construct support.
 Requires Stage 4.106.0 for v18 admission; older Stage refuses it with `STAGE-ESM-016`.
 For generated-concept v20/v21 admission and construct prerequisites, read
@@ -46,7 +46,7 @@ This table is a reading of the renderer's admission, not a render result: run th
 | Area | Renders | Refused (code) |
 | --- | --- | --- |
 | Slice kinds | `StateChange`, `StateView`, supported event-triggered `Automation` with Chronicle reactors | Translate, captures, non-event triggers, opaque bodies, clock/trigger/capture specs (`-024`); claim-reading/opaque `runs as` gates (`-034`), mixed effects from one handler (`-037`, redelivery can duplicate events), unsupported conditions/destinations/mappings (`-039`). Keep refused reactions whole |
-| Queries | optional keyed snapshot lookups; snapshot or observable collections, keyed or unkeyed, with v14 equality filters | context/single-result filters, opaque `scoped to`/`performer` and composite `by`: PLAY0268. DateTime filters and required parameters after optional filters refuse `-010`; filter-name collisions refuse `-012`; concept arguments retain Arc validation, including nested members/elements; nullable keys or optional concept filters with `not empty` refuse `-010` rather than changing null behavior |
+| Queries | optional keyed snapshot lookups; snapshot or observable collections, keyed or unkeyed, with v14 equality filters | context/single-result filters, opaque `scoped to`/`performer` and a list-query `by` block: PLAY0268; v27 composite keys: STAGE-ESM-016. DateTime filters and required parameters after optional filters refuse `-010`; filter-name collisions refuse `-012`; concept arguments retain Arc validation, including nested members/elements; nullable keys or optional concept filters with `not empty` refuse `-010` rather than changing null behavior |
 | Authorization | role-only, authenticated, opaque pure policies, claim conditions with Uuid, Date, DateTime or text targets (numeric and Boolean claim matches render as always false), `not`/and/or; roles read through the identity's `RoleClaimType` | role-claim URIs, nested opaque policies, unresolved or non-portable policies, no single identifier, opaque-policy subjects that are not text, Uuid, Date or DateTime (`STAGE-ESM-015`, a restriction separate from declarative claim targets) |
 | Event sources, streams, routes (ESM v8) | rendered, including routed read-model/query companion replay | reserved stored names, unformattable routed fixtures (`STAGE-ESM-030`) |
 | Numbers, case tables | whole numbers as `long` from ESM v8; case tables | out-of-`int` literals below v8 (`STAGE-ESM-031`) |