@cratis/pi 7.37.0 → 7.38.1

package/package/corpus/skills/cratis-screenplay-toolchain/references/screenplay-contract.version

@@ -1 +1 @@
-4.142.0
+4.144.0

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

@@ -5,6 +5,7 @@
 - Pin set
 - Two compilers, one rule
 - Commands and exit codes
+- Model notes gate
 - Admission boundaries
 - Historical probes
 - Revisions and descriptions
@@ -17,7 +18,7 @@ probe; older probes retain their original labels in the other references.
 
 | Source | Pin | Evidence |
 | --- | --- | --- |
-| Screenplay language, standalone tool and MCP | **4.142.0** (`e6439548`) | Released tag `v4.142.0` and its unchanged published contract; property additions join rename/remove, with concept compliance/ESM v13 retained |
+| Screenplay language, standalone tool and MCP | **4.144.0** (`b5da55a2`) | Released tag `v4.144.0` and its unchanged published contract; committed model notes and the standalone open-question gate; equality query filters admitted as ESM v14 since 4.143.0 |
 | cratis CLI | **3.53.1** | Released tag `v3.53.1`; source-checked, not a new render/browser probe |
 | Screenplay bundled by CLI | **4.137.0** | CLI `v3.53.1:Directory.Packages.props`; enum-number authoring, not v12 binding |
 | Stage bundled by CLI | **4.73.1** | Same file; Stage's own `Directory.Packages.props` also pins Screenplay 4.137.0 |
@@ -53,7 +54,7 @@ or renderer probes below as results from the newer bundle.
 
 ## Two compilers, one rule
 
-Standalone Screenplay 4.142.0 and CLI 3.53.1's 4.137.0 bundle are different releases.
+Standalone Screenplay 4.144.0 and CLI 3.53.1's 4.137.0 bundle are different releases.
 Prefer standalone for the current language checks; CLI owns generation, Prologue
 and rendering. Name the tool/version with every verdict. No verdict transfers
 between differing compilers without checking the same inputs there.
@@ -83,10 +84,39 @@ in-memory and does not run opaque attachments or external services. CLI-derived
 specification IDs need not match persisted MCP identities after renames; use MCP
 for identity-stable selection.
 
+## Model notes gate
+
+**Standalone Screenplay 4.144.0** ships `--open-questions report|fail`.
+**Cratis CLI 3.53.1 does not have this gate** and bundles Screenplay 4.137.0,
+which also predates the notes MCP tools. Do not add this option to
+`cratis screenplay validate` or assume its bundled MCP supports model notes.
+Sources: Screenplay `v4.144.0:Source/DotNET/Tool/ModelOpenQuestions.cs:18-69,87-131`;
+CLI `v3.53.1:Source/Cli/Commands/Screenplay/ValidateScreenplaySettings.cs:11-85`
+and `Directory.Packages.props:8,35-37`. No newer Cratis CLI gate was verified.
+
+```shell
+screenplay <model-folder> --open-questions report --no-color
+screenplay <model-folder> --scope Library.Loans.CheckIn --open-questions fail --no-color
+```
+
+`report` emits info `model-note.open-question` findings without failing for
+questions. `fail` exits **1** when the selected set has an open question;
+unreadable notes exit **2** when the flag is given. Compilation still runs with
+its own verdict; question findings are MCP/CLI only, **no PLAY code**. With no
+flag the sidecar is ignored, and `--warnaserror` does not gate questions. Tasks
+and ordinary notes do not fail this gate.
+
+Scope includes descendants and ancestor notes (application notes too). An
+unscoped report includes orphaned open questions. Absent identity state reports
+all open questions unscoped as orphaned with `identity-state-absent`, rather than
+hiding them behind a scope. Notes never change ESM or V1–V5 verdicts. Read
+model-authoring [model notes](../../cratis-screenplay-model-authoring/references/model-notes.md)
+when recording, resolving, paging or reviewing orphan impact.
+
 ## Admission boundaries
 
-Screenplay `v4.142.0:Source/DotNET/Screenplay/Semantics/Versions.cs` supports
-schema pairs through v13. Admission selects by use:
+Screenplay `v4.144.0:Source/DotNET/Screenplay/Semantics/Versions.cs` supports
+schema pairs through v14. Admission selects by use:
 
 - v7: generated values/responses and policy negation.
 - v8: sources/streams and command/specification routes.
@@ -125,6 +155,12 @@ schema pairs through v13. Admission selects by use:
   explicit `subject` mark refuse PLAY0268. See command-surface
   `references/compliance.md` and Screenplay decision 0068. Stage 4.76.0 admits
   only through v12; no current cli bundles this compiler or admits v13.
+- **Published v14 in 4.143.0:** caller-supplied equality filters on collection
+  queries with same-named, type-matched scalar read-model properties; no `from`.
+  Optional filters may be omitted, supplied null is refused, and `by` plus supplied
+  filters combine with AND. Models without filters preserve bytes/revision.
+  Screenplay `v4.144.0:decisions/0069-admit-equality-query-filters-as-esm-v14.md:43-88`;
+  this newer standalone admission does not upgrade CLI or Stage.
 
 Decision 0066 freezes a version when any exposing NuGet/npm package is published,
 including prereleases. Later byte-changing features take the next version at

package/package/corpus/skills/cratis-screenplay-toolchain/verification.json

@@ -10,6 +10,12 @@
     { "kind": "skill-contains", "value": "Composite read-model keys/query blocks are also still PLAY0268", "file": "references/versions.md" },
     { "kind": "skill-contains", "value": "the **whole source, stream and stream id**", "file": "references/production-routes-and-filters.md" },
     { "kind": "play-compiles" },
+    { "kind": "skill-contains", "value": "Standalone Screenplay 4.144.0", "file": "references/versions.md" },
+    { "kind": "skill-contains", "value": "Cratis CLI 3.53.1 does not have this gate", "file": "references/versions.md" },
+    { "kind": "skill-contains", "value": "--open-questions fail", "file": "references/versions.md" },
+    { "kind": "skill-contains", "value": "unreadable notes exit **2**", "file": "references/versions.md" },
+    { "kind": "skill-contains", "value": "MCP/CLI only, **no PLAY code**", "file": "references/versions.md" },
+    { "kind": "skill-contains", "value": "identity-state-absent", "file": "references/versions.md" },
     { "kind": "skill-contains", "value": "4.141.0" },
     { "kind": "skill-contains", "value": "Published v12" },
     { "kind": "skill-contains", "value": "PLAY0671", "file": "references/diagnostics.md" },

package/package/corpus/skills/cratis-stage-rendering-and-sandbox/references/admission.md

@@ -70,7 +70,7 @@ model owner's decision.
 | `STAGE-ESM-005` | Code validation or rule predicate bodies; or a command beyond the first capability (optional event property, event revision other than the first, validation or requirement that cannot be rendered, no `produces`) | Use declarative validation; non-initial event generations are not rendered |
 | `STAGE-ESM-006` | `produces` that cannot render without changing its destination or mappings (`produces when`, literal or computed mappings, `for` not a command identifier, mappings not one-to-one with event properties, duplicate tags) | Map properties one to one; conditional outcomes (`produces when`) are a different behavior, so gap-fill unless the owner accepts splitting them into commands |
 | `STAGE-ESM-007`, `-008`, `-009` | Projection count per read model (exactly one projection or reducer each); unresolvable properties or no single read-model transition (**flat** projections only); affected instance not one, not keyed by an event property, or not the event-source identity (flat projections only) | One projection per read model; see "Projections" below |
-| `STAGE-ESM-010` | A query is neither an optional snapshot lookup by the read-model identifier nor an observable collection query (a snapshot list, or an argument concept with validation); each query is checked on its own. Observable list queries (keyed or unkeyed) render since Stage 4.49.0 | Keyed `XById => X optional` queries or `observable` lists; a snapshot list is gap-fill. `filter`, `scoped to`, `performer` queries do not bind (`PLAY0268`) |
+| `STAGE-ESM-010` | A query is neither an optional snapshot lookup by the read-model identifier nor an observable collection query (for example a snapshot list); each query is checked on its own. Observable list queries (keyed or unkeyed) render since Stage 4.49.0. Through Stage 4.79.0 (so in cratis CLI 3.53.1, which bundles 4.73.1) an optional snapshot lookup whose key concept has validation rules is refused; Stage 4.79.1 renders a scalar validated key, in keyed lookups and filtered observable collections, as its primitive and converts it inside the query, so an out-of-rule key finds no instance instead of failing validation, and still refuses a validated concept inside a composite or collection argument (Stage `v4.79.1` `Source/Rendering.Cratis/Semantics/SemanticCratisAdmission.StateView.cs:117-141`) | Keyed `XById => X optional` queries or `observable` lists; a snapshot list is gap-fill. `filter`, `scoped to`, `performer` queries do not bind (`PLAY0268`) |
 | `STAGE-ESM-011` | A specification cannot render (see the rules below) | Reshape it only if the assertion keeps its meaning; otherwise keep the specification, record the gap, and gap-fill with the specification as the oracle. Never weaken or delete it to get a render |
 | `STAGE-ESM-012` | Generated C# names collide (properties, types, namespaces, constraints) | Rename |
 | `STAGE-ESM-013` | An event-context value other than `$context.occurred` mapped in `produces` | Map a command property when that preserves the meaning; otherwise gap-fill |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cratis/pi",
-  "version": "7.37.0",
+  "version": "7.38.1",
   "description": "Configuration-aware Cratis AI integration for Pi",
   "type": "module",
   "files": [