@eventmodelers/cli 1.0.71 → 1.0.73

package/shared/demo-slices/Understanding Eventsourcing/removeitem/slice.json

@@ -0,0 +1,239 @@
+{
+  "id": "f263e451-78a6-475e-a112-bff181295e65",
+  "status": "Planned",
+  "title": "Remove Item",
+  "context": "Understanding Eventsourcing",
+  "sliceType": "STATE_CHANGE",
+  "commands": [
+    {
+      "id": "f04eb51d-6afd-4a33-8e3d-941dea5a3abc",
+      "tags": [],
+      "lane": "Interaction",
+      "modelContext": "Understanding Eventsourcing",
+      "slice": "Remove Item",
+      "title": "Remove Item",
+      "fields": [
+        {
+          "name": "aggregateId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "itemId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        }
+      ],
+      "type": "COMMAND",
+      "description": "",
+      "aggregate": "default",
+      "aggregateDependencies": [],
+      "dependencies": [
+        {
+          "id": "b5b7ae0a-d0a7-4b2b-bc14-2086993eface",
+          "type": "OUTBOUND",
+          "title": "Item Removed",
+          "elementType": "EVENT"
+        },
+        {
+          "id": "9e7ae82a-42f0-4298-85f4-fc2f0f689f43",
+          "type": "INBOUND",
+          "title": "title",
+          "elementType": "SCREEN"
+        }
+      ],
+      "apiEndpoint": "",
+      "createsAggregate": false,
+      "triggers": [],
+      "elementCopy": false,
+      "linkedId": "f04eb51d-6afd-4a33-8e3d-941dea5a3abc",
+      "sketched": false,
+      "prototype": {
+        "activeByDefault": false
+      },
+      "comments": []
+    }
+  ],
+  "events": [
+    {
+      "id": "b5b7ae0a-d0a7-4b2b-bc14-2086993eface",
+      "tags": [],
+      "lane": "Events",
+      "modelContext": "Understanding Eventsourcing",
+      "slice": "Remove Item",
+      "title": "Item Removed",
+      "fields": [
+        {
+          "name": "aggregateId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "itemId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        }
+      ],
+      "type": "EVENT",
+      "description": "",
+      "aggregate": "default",
+      "aggregateDependencies": [],
+      "dependencies": [
+        {
+          "id": "22511305-2296-43ba-b8e8-d786d53cd25f",
+          "type": "OUTBOUND",
+          "title": "Carts with Products",
+          "elementType": "READMODEL"
+        },
+        {
+          "id": "631c5aa8-0f9e-4a8f-b7f6-91174cae2b82",
+          "type": "OUTBOUND",
+          "title": "cart items",
+          "elementType": "READMODEL"
+        },
+        {
+          "id": "f04eb51d-6afd-4a33-8e3d-941dea5a3abc",
+          "type": "INBOUND",
+          "title": "Remove Item",
+          "elementType": "COMMAND"
+        }
+      ],
+      "apiEndpoint": "",
+      "createsAggregate": false,
+      "triggers": [],
+      "elementCopy": false,
+      "linkedId": "b5b7ae0a-d0a7-4b2b-bc14-2086993eface",
+      "sketched": false,
+      "prototype": {
+        "activeByDefault": false
+      },
+      "comments": []
+    }
+  ],
+  "readmodels": [],
+  "screens": [
+    {
+      "id": "9e7ae82a-42f0-4298-85f4-fc2f0f689f43",
+      "tags": [],
+      "lane": "Actor",
+      "modelContext": "Understanding Eventsourcing",
+      "slice": "Remove Item",
+      "title": "title",
+      "fields": [
+        {
+          "name": "aggregateId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "description",
+          "type": "String",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "image",
+          "type": "String",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "itemId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "price",
+          "type": "Double",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "totalPrice",
+          "type": "Double",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        }
+      ],
+      "type": "SCREEN",
+      "description": "",
+      "aggregate": "default",
+      "aggregateDependencies": [],
+      "dependencies": [
+        {
+          "id": "f04eb51d-6afd-4a33-8e3d-941dea5a3abc",
+          "type": "OUTBOUND",
+          "title": "Remove Item",
+          "elementType": "COMMAND"
+        },
+        {
+          "id": "631c5aa8-0f9e-4a8f-b7f6-91174cae2b82",
+          "type": "INBOUND",
+          "title": "cart items",
+          "elementType": "READMODEL"
+        }
+      ],
+      "apiEndpoint": "",
+      "createsAggregate": false,
+      "triggers": [],
+      "elementCopy": false,
+      "linkedId": "9e7ae82a-42f0-4298-85f4-fc2f0f689f43",
+      "sketched": false,
+      "prototype": {
+        "activeByDefault": false
+      },
+      "comments": []
+    }
+  ],
+  "screenImages": [],
+  "screenLayouts": [],
+  "processors": [],
+  "tables": [],
+  "specifications": [],
+  "storylines": [],
+  "chapter": "Understanding Eventsourcing",
+  "codeGen": {},
+  "notes": [],
+  "comments": [],
+  "aggregates": []
+}

package/shared/demo-slices/Understanding Eventsourcing/submitcart/slice.json

@@ -0,0 +1,199 @@
+{
+  "id": "46e2eee1-54ef-4a9c-9403-a3403bf45943",
+  "status": "Planned",
+  "title": "Submit Cart",
+  "context": "Understanding Eventsourcing",
+  "sliceType": "STATE_CHANGE",
+  "commands": [
+    {
+      "id": "af612742-5aba-4d05-950a-fae77c5f6307",
+      "tags": [],
+      "lane": "Interaction",
+      "modelContext": "Understanding Eventsourcing",
+      "slice": "Submit Cart",
+      "title": "Submit Cart",
+      "fields": [
+        {
+          "name": "aggregateId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "orderedProducts",
+          "type": "Custom",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "List",
+          "idAttribute": false
+        }
+      ],
+      "type": "COMMAND",
+      "description": "",
+      "aggregate": "default",
+      "aggregateDependencies": [],
+      "dependencies": [
+        {
+          "id": "29ae25b9-56cd-4086-bbfe-a64efb30d240",
+          "type": "OUTBOUND",
+          "title": "Cart Submitted",
+          "elementType": "EVENT"
+        },
+        {
+          "id": "0e77e668-00df-404a-9334-3f22153c7ab6",
+          "type": "INBOUND",
+          "title": "title",
+          "elementType": "SCREEN"
+        }
+      ],
+      "apiEndpoint": "",
+      "createsAggregate": false,
+      "triggers": [],
+      "elementCopy": false,
+      "linkedId": "af612742-5aba-4d05-950a-fae77c5f6307",
+      "sketched": false,
+      "prototype": {
+        "activeByDefault": false
+      },
+      "comments": []
+    }
+  ],
+  "events": [
+    {
+      "id": "29ae25b9-56cd-4086-bbfe-a64efb30d240",
+      "tags": [],
+      "lane": "Events",
+      "modelContext": "Understanding Eventsourcing",
+      "slice": "Submit Cart",
+      "title": "Cart Submitted",
+      "fields": [
+        {
+          "name": "aggregateId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "orderedProducts",
+          "type": "Custom",
+          "example": "productId, price",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "List",
+          "idAttribute": false
+        },
+        {
+          "name": "totalPrice",
+          "type": "Double",
+          "example": "",
+          "mapping": "orderedProducts",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        }
+      ],
+      "type": "EVENT",
+      "description": "",
+      "aggregate": "default",
+      "aggregateDependencies": [],
+      "dependencies": [
+        {
+          "id": "e3dc2c7e-7327-480a-bdb4-4b2055327540",
+          "type": "OUTBOUND",
+          "title": "Submitted Cart Data",
+          "elementType": "READMODEL"
+        },
+        {
+          "id": "af612742-5aba-4d05-950a-fae77c5f6307",
+          "type": "INBOUND",
+          "title": "Submit Cart",
+          "elementType": "COMMAND"
+        }
+      ],
+      "apiEndpoint": "",
+      "createsAggregate": false,
+      "triggers": [],
+      "elementCopy": false,
+      "linkedId": "29ae25b9-56cd-4086-bbfe-a64efb30d240",
+      "sketched": false,
+      "prototype": {
+        "activeByDefault": false
+      },
+      "comments": []
+    }
+  ],
+  "readmodels": [],
+  "screens": [
+    {
+      "id": "0e77e668-00df-404a-9334-3f22153c7ab6",
+      "tags": [],
+      "lane": "Actor",
+      "modelContext": "Understanding Eventsourcing",
+      "slice": "Submit Cart",
+      "title": "title",
+      "fields": [
+        {
+          "name": "aggregateId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "orderedProducts",
+          "type": "Custom",
+          "example": "{\"productid\":UUID, \"price\":Double}",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "Single",
+          "idAttribute": false
+        }
+      ],
+      "type": "SCREEN",
+      "description": "",
+      "aggregate": "default",
+      "aggregateDependencies": [],
+      "dependencies": [
+        {
+          "id": "af612742-5aba-4d05-950a-fae77c5f6307",
+          "type": "OUTBOUND",
+          "title": "Submit Cart",
+          "elementType": "COMMAND"
+        }
+      ],
+      "apiEndpoint": "",
+      "createsAggregate": false,
+      "triggers": [],
+      "elementCopy": false,
+      "linkedId": "0e77e668-00df-404a-9334-3f22153c7ab6",
+      "sketched": false,
+      "prototype": {
+        "activeByDefault": false
+      },
+      "comments": []
+    }
+  ],
+  "screenImages": [],
+  "screenLayouts": [],
+  "processors": [],
+  "tables": [],
+  "specifications": [],
+  "storylines": [],
+  "chapter": "Understanding Eventsourcing",
+  "codeGen": {},
+  "notes": [],
+  "comments": [],
+  "aggregates": []
+}

package/shared/demo-slices/Understanding Eventsourcing/submittedcartdata/slice.json

@@ -0,0 +1,90 @@
+{
+  "id": "412dfce9-0843-4ac0-82e5-4e645716d502",
+  "status": "Planned",
+  "title": "Submitted Cart Data",
+  "context": "Understanding Eventsourcing",
+  "sliceType": "STATE_VIEW",
+  "commands": [],
+  "events": [],
+  "readmodels": [
+    {
+      "id": "e3dc2c7e-7327-480a-bdb4-4b2055327540",
+      "tags": [],
+      "lane": "Interaction",
+      "modelContext": "Understanding Eventsourcing",
+      "slice": "Submitted Cart Data",
+      "title": "Submitted Cart Data",
+      "fields": [
+        {
+          "name": "aggregateId",
+          "type": "UUID",
+          "example": "",
+          "mapping": "",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        },
+        {
+          "name": "orderedProducts",
+          "type": "Custom",
+          "example": "productId, price",
+          "mapping": "",
+          "optional": false,
+          "cardinality": "List",
+          "idAttribute": false
+        },
+        {
+          "name": "totalPrice",
+          "type": "Double",
+          "example": "",
+          "mapping": "orderedProducts",
+          "optional": false,
+          "subfields": [],
+          "cardinality": "Single",
+          "idAttribute": false
+        }
+      ],
+      "type": "READMODEL",
+      "description": "",
+      "aggregate": "default",
+      "aggregateDependencies": [],
+      "dependencies": [
+        {
+          "id": "e3073105-b883-444b-b7d2-170de493e093",
+          "type": "OUTBOUND",
+          "title": "automation",
+          "elementType": "AUTOMATION"
+        },
+        {
+          "id": "29ae25b9-56cd-4086-bbfe-a64efb30d240",
+          "type": "INBOUND",
+          "title": "Cart Submitted",
+          "elementType": "EVENT"
+        }
+      ],
+      "apiEndpoint": "",
+      "createsAggregate": false,
+      "triggers": [],
+      "elementCopy": false,
+      "linkedId": "e3dc2c7e-7327-480a-bdb4-4b2055327540",
+      "sketched": false,
+      "prototype": {
+        "activeByDefault": false
+      },
+      "comments": []
+    }
+  ],
+  "screens": [],
+  "screenImages": [],
+  "screenLayouts": [],
+  "processors": [],
+  "tables": [],
+  "specifications": [],
+  "storylines": [],
+  "chapter": "Understanding Eventsourcing",
+  "codeGen": {},
+  "notes": [],
+  "comments": [],
+  "aggregates": []
+}

package/shared/demo-slices/current_context.json

@@ -0,0 +1,3 @@
+{
+  "name": "Understanding Eventsourcing"
+}

package/shared/skills/learn-eventmodelers-api/SKILL.md

@@ -881,7 +881,7 @@ Set a prompt's status, optionally attaching a progress comment. Auth: `x-token`
 ```
 
 **Response**: `200` — the updated row
-**Errors**: `400` invalid/missing `status` · `403` token not for this prompt's org · `404` prompt not found
+**Errors**: `400` invalid/missing `status` · `403` token not for this prompt's org · `404` prompt not found · `409` (`PROMPT_STATUS_ALREADY_SET`) the prompt already carries that status — another agent already made this transition, so don't retry it
 
 ---
 

package/stacks/modeling-kit/templates/.claude/skills/update-prompt-status/SKILL.md

@@ -52,6 +52,7 @@ Omit `comment` entirely when there isn't one — don't pass an empty string.
 |----------|---------|--------|
 | `400` | `status` missing or not a valid value | Fix the value and retry — do not retry with the same bad value. |
 | `404` | Prompt not found | The prompt may have been deleted by its author while you were working. Report this and move on — do not treat it as a failure of your actual task work. |
+| `409` | The prompt already carries the status you asked for (`PROMPT_STATUS_ALREADY_SET`) | Somebody else — usually another agent working the same queue — already made this transition. Do not retry it; treat the transition as done and carry on. |
 | `401`/`403` | Token invalid or wrong organization | Re-run `connect` to refresh credentials, then retry once. |
 
 ---

package/stacks/modeling-kit/templates/kit/CLAUDE-STANDALONE.md

@@ -14,11 +14,11 @@ Format — stays in `.agent-modeling-kit/CLAUDE.md` and still applies.
 These turns come in two shapes, and both are self-directed — nobody asked you for anything:
 
 ```
-BOARD_CHANGE board_id=<uuid> organization_id=<uuid> seq=118..124 events=9 nodes=3
+BOARD_CHANGE board_id=<uuid> organization_id=<uuid> seq=118..124 events=7 nodes=3
 changed:
 - 9f3c…: node:created, node:changed (4×)
 - a12b…: node:changed (2×) — possibly your own earlier write
-- c771…: edge:added (3×)
+- c771…: node:deleted
 ```
 
 ```
@@ -44,10 +44,12 @@ Steps:
 1. **Get the whole picture, not just the changed nodes — in two reads, not twenty.** The
    whole `changed:` list goes into **one**
    `mcp__eventmodelers__get_nodes { boardId, nodeIds: [...] }` (or the REST equivalent), and
-   the area around it into **one** `get_board_outline` per chapter; `projection: "line"` is
-   enough for both whenever you only need names, types and slice statuses. That pair is your
-   orientation — and the outline half of it you already have from the `SESSION_START` warm-up, so
-   re-read a chapter only where this turn's `changed:` list says it moved on. Widen out from it to what the nodes sit in — their cell, their slice, the
+   the area around it into **one** `get_board_outline` per chapter those nodes land in; `projection: "line"`
+   is enough for both whenever you only need names, types and slice statuses. That pair is your
+   orientation — and you pay for a chapter's half of it **once per session**: the `SESSION_START` warm-up
+   deliberately read no chapter at all, so the first turn that touches one fetches its outline and keeps it,
+   and every later turn works from that copy, re-reading only where this turn's `changed:` list says it moved
+   on. A chapter nothing has changed in is a chapter you never read. Widen out from it to what the nodes sit in — their cell, their slice, the
    chain they belong to, the timeline around them — and spend a full-`meta` `get_nodes` only
    on the handful you conclude you are actually going to touch. One `get_node` per changed
    node, or a second outline call for a chapter you already read this turn, is the same
@@ -199,6 +201,9 @@ Steps:
 
 Keep these turns finished within the turn: wait for the subagents you dispatched, don't leave
 work trailing. Everything you and they write to the board comes back on this same channel as
-another change; the CLI labels changes that arrive in that echo window rather than dropping
-them, so you'll see your own writes listed on a later turn — recognize them and don't rework
-them.
+another change. A burst that is *only* your own writes never becomes a turn at all, so a
+change list you are handed always contains something that isn't yours — but it may still list
+yours alongside it, marked `YOUR OWN earlier write`. Take that mark literally: those lines are
+there for context, not to be reworked. A line marked `unattributed, possibly your own earlier
+write` is the one uncertain case (a write that reached the platform without an agent id);
+anything unmarked was written by someone else and is real work to look at.

package/stacks/modeling-kit/templates/kit/CLAUDE.md

@@ -47,10 +47,13 @@ On that turn, and only that turn:
 2. Run `/connect` with the header's `token=`/`org=`/`baseUrl=` and the turn's `board_id`. This
    is the session's one-time connect; step 2 below then applies unchanged, which means no later
    turn runs `/connect` again unless the board changed or an API call came back `401`/`403`.
-3. Do the orientation read — one `get_board_outline` per chapter, or `get_nodes` with
-   `projection: "line"` — and **keep it**. That is this session's board picture: chapters,
-   columns, elements, slice statuses. Later turns start from it instead of re-reading the board,
-   and refresh it when a turn's own changes invalidate it.
+3. Learn **which chapters exist** — one `get_chapter_bounds` gives every chapter's id and title —
+   and stop there. Do **not** read any chapter's contents on this turn: a board of a dozen chapters
+   read up front is a minute and a dollar spent before anyone has asked for anything, and most of
+   what comes back is never used. A chapter is read on the first turn that has business in it (one
+   `get_board_outline`, or `get_nodes` with `projection: "line"`) and **kept** from then on — that
+   growing set of read chapters is this session's board picture: columns, elements, slice statuses.
+   Later turns answer from it instead of re-reading, and refresh only the part a change invalidated.
 
 It is not a prompt turn and not a self-directed one: there is no `prompt_id` (so no
 `/update-prompt-status` — the "exactly two calls per turn" rule is about prompt turns), nothing
@@ -85,9 +88,11 @@ why; if all of it is, change nothing and post a `COMMENT` on that slice saying w
 blocked it.
 
 **One board read, shared by the whole turn.** Orientation first — `get_board_outline`, or `get_nodes` with
-`projection: "line"` — to establish where the work actually is. In a `standalone=on` session you already hold
-that orientation from the `SESSION_START` warm-up, so use it rather than re-fetching it, and refresh it only
-when this turn's own changes (or a change you were notified of) have made it stale. Then a single full-`meta` `get_nodes`, scoped by
+`projection: "line"` — to establish where the work actually is, and only for the chapter this turn is about.
+In a `standalone=on` session the `SESSION_START` warm-up gave you the chapter list but no chapter's contents,
+so the first turn to touch a chapter pays for its outline once and every later turn in the session reads it
+from memory; refresh only when this turn's own changes (or a change you were notified of) have made your copy
+stale. Then a single full-`meta` `get_nodes`, scoped by
 `chapterId` or `nodeIds`, covering the nodes you concluded you will touch. Both tiers are once per turn: keep what
 came back and answer later questions from it instead of re-fetching a chapter you already hold. `/connect` Step 5
 carries the full discipline — the two tiers, the one-call `submit_node_events` rule for writes, and the per-turn