@cratis/pi 7.36.1 → 7.38.0

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/sandbox-and-specrunner.md

@@ -3,6 +3,7 @@
 ## Contents
 
 - Current behavior at Stage 4.73.1 (source reading; Docker not run)
+- Specification engine selection at Stage 4.78.0 and CLI 3.53.1
 - The sandbox: a partial, disposable runtime
 - The specification runner
 - Choosing between them
@@ -25,6 +26,31 @@ it prints a deprecation notice, refuses routes with exit 1 and writes no results
 `0`/`1`/`2` are as in `SKILL.md`. The sections below describe the 4.24-era behavior and remain the
 engine comparison.
 
+## Specification engine selection at Stage 4.78.0 and CLI 3.53.1
+
+Re-verified from Stage `v4.78.0`, `Source/SpecRunner/SpecRunnerArguments.cs:18,76`,
+`Program.cs:46–78,86–113`, and
+`Source/Specifications/SemanticSpecificationExecutor.cs:115–136,183–197`:
+
+- The runner still defaults to deprecated `structural`, which executes no slice.
+  Pass `--engine semantic` to the **Stage specification runner**, not to `cratis run`.
+- Semantic execution creates a fresh Chronicle in-memory event log per
+  specification and dispatches admitted commands through Arc's in-memory
+  pipeline. The `stage-spec-run/1` report carries `Passed`, `Failed`, `Unsupported`
+  or `Cancelled`; exit `0` only proves the report was written, not that specs passed
+  (`Documentation/docker/spec-runner.md:150–174`).
+- CLI `v3.53.1` does **not** expose `--engine` or a Stage specification-runner
+  command. Its `run` command starts the **sandbox**, with path, tag, port,
+  workbench-port and verbose settings only (`Source/Cli/Commands/Run/RunSettings.cs:9–52`,
+  `RunCommand.cs:10–23,100–105`). Changing `--tag` does not select an engine.
+  For semantic specifications use the runner directly, for example
+  `cratis/stage-specrunner:4.78.0 --engine semantic`; for the sandbox, engine
+  selection is the separate `Stage__Runtime__Engine=semantic` environment setting.
+
+This is source verification, not an executed Docker run. It updates engine
+selection only; the historical capability lists below are not a complete
+admission inventory for Stage `v4.78.0`.
+
 ## The sandbox: a partial, disposable runtime
 
 `cratis/stage` is the Stage host plus an in-memory Chronicle kernel. Each session starts

package/package/corpus/skills/cratis-stage-rendering-and-sandbox/verification.json

@@ -23,6 +23,9 @@
     { "kind": "skill-contains", "value": "`Customizations/`" },
     { "kind": "skill-contains", "value": "`Stage__Runtime__Engine=semantic`" },
     { "kind": "skill-contains", "value": "`--engine semantic`" },
+    { "kind": "skill-contains", "value": "Stage `v4.78.0`", "file": "references/sandbox-and-specrunner.md" },
+    { "kind": "skill-contains", "value": "does **not** expose `--engine`", "file": "references/sandbox-and-specrunner.md" },
+    { "kind": "skill-contains", "value": "fresh Chronicle in-memory event log per", "file": "references/sandbox-and-specrunner.md" },
     { "kind": "skill-contains", "value": "through v10" },
     { "kind": "skill-contains", "value": "CLI-RENDER-004" },
     { "kind": "skill-contains", "value": "STAGE-ESM-024" },

package/package/profile-catalog.json

@@ -631,6 +631,8 @@
       "id": "cratis/components",
       "availableTargets": [
         "cratis-components-accessibility",
+        "cratis-components-common-controls",
+        "cratis-components-data-surfaces",
         "cratis-components-schema-editor",
         "cratis-components-stepper-command-dialog",
         "cratis-components-styling",
@@ -760,7 +762,8 @@
     {
       "id": "cratis/fundamentals",
       "availableTargets": [
-        "cratis-fundamentals-concept"
+        "cratis-fundamentals-concept",
+        "cratis-fundamentals-telemetry"
       ],
       "languages": [
         "csharp"
@@ -993,7 +996,8 @@
         "cratis/engineering/core"
       ],
       "availableTargets": [
-        "cratis-engineering-csharp-conventions"
+        "cratis-engineering-csharp-conventions",
+        "cratis-orleans-jobs"
       ],
       "languages": [
         "csharp"

package/package.json

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