@seriousgaming/sdk-tools 1.6.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (135) hide show
  1. package/dist/agent/guidance.md +350 -0
  2. package/dist/{cli-I355WTAF.js → cli-2DQJACAH.js} +20 -12
  3. package/dist/{cli-PTT5RGKO.js → cli-3PIJLSRQ.js} +5 -5
  4. package/dist/{cli-O6PWMJTZ.js → cli-4CHKF4DQ.js} +1 -1
  5. package/dist/{cli-UJ4UCL2Z.js → cli-4VZIJYKU.js} +1 -1
  6. package/dist/{cli-O5KP4OVN.js → cli-4XCQUM3E.js} +2 -2
  7. package/dist/{cli-6WXLXJVX.js → cli-57C72YKJ.js} +14 -14
  8. package/dist/{cli-GFBGYFYD.js → cli-57V4ARER.js} +1 -1
  9. package/dist/{cli-IRZ5KB7D.js → cli-5G7TZHD3.js} +14 -14
  10. package/dist/{cli-QEVDDBNO.js → cli-64AA7367.js} +8 -8
  11. package/dist/{cli-LMDJCHHD.js → cli-6HB6HTC6.js} +47 -47
  12. package/dist/{cli-TCY5LJ7E.js → cli-6ZSMW4HR.js} +10 -10
  13. package/dist/{cli-RN6IWTL2.js → cli-7MBLH4M3.js} +14 -14
  14. package/dist/{cli-K2B6WHKA.js → cli-7RYIEKMB.js} +10 -10
  15. package/dist/{cli-ZVSFYDPQ.js → cli-7TOLC62D.js} +16 -14
  16. package/dist/{cli-LXYPE3L5.js → cli-ATI6OLJU.js} +12 -12
  17. package/dist/{cli-ROT3DRKU.js → cli-BOXXMDSX.js} +16 -18
  18. package/dist/{cli-UKQYZYFK.js → cli-C3OERMIR.js} +1 -1
  19. package/dist/{cli-VCKOC2EV.js → cli-C6G65H6S.js} +2 -2
  20. package/dist/{cli-ORIG557O.js → cli-CV4JGVJR.js} +17 -27
  21. package/dist/{cli-HYY64SUD.js → cli-CXCL7VRK.js} +13 -13
  22. package/dist/{cli-FBTRTIZJ.js → cli-DEBCP7UH.js} +10 -10
  23. package/dist/{cli-BPYMTOUL.js → cli-DHOWZCXT.js} +10 -10
  24. package/dist/{cli-E6DJIMYD.js → cli-EDCAH2TC.js} +17 -23
  25. package/dist/{cli-C6TH5S7K.js → cli-EJVAQCMQ.js} +30 -3
  26. package/dist/{cli-DZW3XD5F.js → cli-ESA6YNPF.js} +17 -25
  27. package/dist/{cli-UTJU4IYG.js → cli-FP32D3T6.js} +10 -10
  28. package/dist/{cli-EVFS55WN.js → cli-FXWWYBYU.js} +22 -25
  29. package/dist/{cli-MBNMPVDC.js → cli-FXY3DKPW.js} +8 -5
  30. package/dist/{cli-G6UE5NL4.js → cli-FZ7QAZZP.js} +11 -11
  31. package/dist/{cli-KL3756X6.js → cli-G5DQGZ2E.js} +17 -19
  32. package/dist/{cli-JFU22EJ2.js → cli-GEQUJF4L.js} +11 -11
  33. package/dist/{cli-WAE26SVW.js → cli-GHLILDH7.js} +9 -9
  34. package/dist/{cli-PFFCNGHI.js → cli-GPAN6XK2.js} +3 -3
  35. package/dist/{cli-LFGRFIEO.js → cli-GTWEGYSU.js} +12 -12
  36. package/dist/{cli-4BV45LBH.js → cli-H3J3ICCQ.js} +2 -2
  37. package/dist/{cli-3E3MD5U4.js → cli-HHPMAV4F.js} +1 -1
  38. package/dist/{cli-M6BCQRID.js → cli-HM7CD4VU.js} +18 -29
  39. package/dist/{cli-DMW2OQIJ.js → cli-HYEU3QS6.js} +1 -1
  40. package/dist/{cli-TPU4TUR6.js → cli-IPP5FDCH.js} +12 -12
  41. package/dist/{cli-UELGBQG7.js → cli-JGFJWZFU.js} +1 -1
  42. package/dist/{cli-2GOFEW26.js → cli-JIZTQVL2.js} +8 -8
  43. package/dist/{cli-GXD36NF2.js → cli-JPAXKLVT.js} +8 -8
  44. package/dist/{cli-YVVXUD2G.js → cli-JR5AZLLK.js} +7 -2
  45. package/dist/{cli-PQBXVLEU.js → cli-JRIIAZ33.js} +8 -8
  46. package/dist/{cli-3HE4AVZG.js → cli-JRMHSMYT.js} +17 -21
  47. package/dist/{cli-SIPDUBFL.js → cli-L5IG7MY2.js} +14 -14
  48. package/dist/{cli-FYINNRML.js → cli-LE5ICDAF.js} +27 -70
  49. package/dist/{cli-LFM7GJHI.js → cli-LQ4VSM5R.js} +0 -0
  50. package/dist/{cli-RA673NGF.js → cli-LQERHJFE.js} +4 -4
  51. package/dist/{cli-ZWPYIXNI.js → cli-LRQDF3ZO.js} +7 -7
  52. package/dist/{cli-V4GHRWOV.js → cli-M7WEAIRF.js} +5 -5
  53. package/dist/{cli-GUXKQMJ7.js → cli-MM3A4SPH.js} +1 -1
  54. package/dist/{cli-5JEGTVTG.js → cli-MULKSLA4.js} +12 -12
  55. package/dist/{cli-B4TN6PJP.js → cli-MYJGGLC5.js} +2 -2
  56. package/dist/{cli-7OGYADZ3.js → cli-NEOLMC2P.js} +12 -12
  57. package/dist/{cli-IDKYF5XB.js → cli-NOQBWJQN.js} +1 -1
  58. package/dist/{cli-TLLA6KAP.js → cli-NPPY557S.js} +10 -10
  59. package/dist/{cli-GTSGLN3Z.js → cli-OANH3BTQ.js} +1 -1
  60. package/dist/{cli-UMFFURZ7.js → cli-OQG3Y4RU.js} +10 -10
  61. package/dist/{cli-6RRVEGFB.js → cli-PIO7NWMH.js} +10 -10
  62. package/dist/{cli-GDQ6ILJY.js → cli-PKQNOGBO.js} +7 -7
  63. package/dist/{cli-DL2CVMRF.js → cli-PVA52RC2.js} +11 -11
  64. package/dist/{cli-JZM7XTNV.js → cli-R7RG2VMW.js} +10 -10
  65. package/dist/{cli-ZISJ36MM.js → cli-SOFCTQAL.js} +10 -10
  66. package/dist/{cli-6AMT3BUO.js → cli-SOMIB4B4.js} +12 -12
  67. package/dist/{cli-E33CJRRQ.js → cli-SPGUVL6Z.js} +14 -14
  68. package/dist/{cli-4AKVLEC4.js → cli-SWZY7L7K.js} +3 -3
  69. package/dist/{cli-C3NVCKO6.js → cli-SX3ULO5P.js} +8 -8
  70. package/dist/{cli-S5QDONIQ.js → cli-T4HWGMY4.js} +7 -7
  71. package/dist/{cli-272KBNJH.js → cli-TDYKRXUA.js} +12 -12
  72. package/dist/{cli-UNJ5X6BU.js → cli-TFMNNVJ7.js} +10 -10
  73. package/dist/{cli-PNLYX6R6.js → cli-TFZ53OA2.js} +12 -12
  74. package/dist/{cli-KNOOKGYW.js → cli-TJ3PLRHF.js} +10 -10
  75. package/dist/{cli-JMZLT65J.js → cli-TPNQLYPC.js} +1 -1
  76. package/dist/{cli-QEVE5HUM.js → cli-UBQCSUDH.js} +11 -11
  77. package/dist/{cli-E2NLWIFE.js → cli-UTM4QU67.js} +1 -1
  78. package/dist/{cli-U2UE7I7J.js → cli-UY4VDI7W.js} +8 -8
  79. package/dist/{cli-XCO2VQOH.js → cli-VPON5HGB.js} +19 -17
  80. package/dist/{cli-Q2XJF5AS.js → cli-VYR326C6.js} +18 -21
  81. package/dist/{cli-G522CPRL.js → cli-WAZD75KE.js} +10 -10
  82. package/dist/{cli-R4PCG5YX.js → cli-WG36UJRK.js} +12 -12
  83. package/dist/{cli-GBFM76BF.js → cli-WM6SQJ6Q.js} +5 -5
  84. package/dist/{cli-G6KELFSX.js → cli-X7E3637I.js} +84 -17
  85. package/dist/{cli-AK7OIPWY.js → cli-XR2XSWQN.js} +13 -17
  86. package/dist/{cli-GGPDQNM3.js → cli-XTANOFQR.js} +2 -2
  87. package/dist/{cli-BYJWFFCF.js → cli-YSPZZQCP.js} +2 -2
  88. package/dist/{cli-EEFJKIGL.js → cli-Z5HWENER.js} +17 -25
  89. package/dist/{cli-57RXC3HQ.js → cli-ZBTFLZUL.js} +14 -14
  90. package/dist/{cli-SMFSZF2G.js → cli-ZF7IFB54.js} +21 -4
  91. package/dist/{cli-VCI3CG36.js → cli-ZKG3OPZ6.js} +9 -9
  92. package/dist/{cli-WOGIAU2E.js → cli-ZQ2Y3U7F.js} +7 -7
  93. package/dist/{cli-QUIJCBYB.js → cli-ZRPWZOCW.js} +15 -7
  94. package/dist/{cli-UHSZBKYO.js → cli-ZTZ5H55T.js} +12 -12
  95. package/dist/cli.js +36 -34
  96. package/dist/client.js +178 -69
  97. package/dist/core/game-settings.d.ts +5 -3
  98. package/dist/core/session-roster.d.ts +10 -0
  99. package/dist/dev/console/assets/{index-CuMOOH9m.js → index-CnXlPeLX.js} +47 -47
  100. package/dist/dev/console/index.html +1 -1
  101. package/dist/dev/routes.d.ts +5 -2
  102. package/dist/dev/shell.d.ts +9 -1
  103. package/dist/dev/view/batch.d.ts +11 -1
  104. package/dist/dev/view/route.d.ts +18 -1
  105. package/dist/dev/view/view.d.ts +9 -0
  106. package/dist/docs/ai-agents.md +1 -1
  107. package/dist/docs/api/index.md +1 -1
  108. package/dist/docs/api/sdk-commands.md +4 -0
  109. package/dist/docs/api/sdk-e2e.md +5 -0
  110. package/dist/docs/api/sdk-tools-client.md +4 -0
  111. package/dist/docs/api/sdk-ui-testing.md +1 -0
  112. package/dist/docs/api/sdk-ui.md +28 -0
  113. package/dist/docs/api/sdk.md +2 -0
  114. package/dist/docs/changelog.md +26 -0
  115. package/dist/docs/cli-and-dev-server.md +4 -0
  116. package/dist/docs/cli-reference.md +17 -2
  117. package/dist/docs/getting-started.md +1 -1
  118. package/dist/docs/guides/presentation.md +11 -10
  119. package/dist/docs/guides/session-hooks.md +16 -0
  120. package/dist/docs/guides/settings.md +4 -2
  121. package/dist/docs/guides/starter-game.md +1 -1
  122. package/dist/docs/guides/upgrading.md +31 -2
  123. package/dist/docs/page-index.md +6 -6
  124. package/dist/host/protocol.d.ts +10 -1
  125. package/dist/host.js +1 -0
  126. package/dist/playwright.js +178 -69
  127. package/dist/runtime/manifest-version.d.ts +1 -1
  128. package/dist/runtime.js +1 -1
  129. package/dist/schema.json +10 -1
  130. package/dist/templates/package/CLAUDE.md.template +7 -346
  131. package/dist/templates/package/claude/rules/workflow-create-engine.md +2 -2
  132. package/dist/templates/package/claude/rules/workflow-create-guide.md +2 -2
  133. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  134. package/dist/templates/package/claude/rules/workflow-update-sdk-version.md +3 -3
  135. package/package.json +3 -3
@@ -0,0 +1,350 @@
1
+ # Serious Gaming SDK guidance
2
+
3
+ Guidance for an AI coding agent working in a Serious Gaming SDK package. A package is a game. This file ships inside `@seriousgaming/sdk-tools`, so it describes the SDK version the package has installed and changes when the package upgrades. What this particular game is, and any rules of its own, belong in the package's own `CLAUDE.md`, which imports this file. Read the package's files rather than assuming what they hold.
4
+
5
+ ## Non-negotiables
6
+
7
+ - **Logic returns what it writes under `capabilities`**, and removes keys with `deletes` beside it. Never mutate `context`: spread
8
+ - **Declare `reads`, `writes`, `settings` and `uses`.** A resource receives exactly what it declares; a write or a service outside them is refused
9
+ - **Await every `setData`**, through `useMutationReporter`, so a refusal reaches the person. Never retry a write automatically
10
+ - **Never start `pnpm start`, `pnpm run sdk dev` or watch-mode `pnpm test`.** The user starts long-running processes
11
+ - **No host globals in logic.** `meta.now`, not `Date.now()`; `meta.seed` with `deriveSeed` and `seededRandom`, not `Math.random()`; no `fetch`, timers or Node built-ins
12
+ - **Use `update`, not `new`, for a slot that is already filled** (`engine`, `ui`, `session`, …). Change bundles through the CLI, not by hand
13
+ - **Never edit a generated `types.ts`, and never use `any`**
14
+ - **Never publish, and never `pnpm add`, unless the user asks**
15
+
16
+ ## Workflows
17
+
18
+ Before touching a resource, read its rule in the package's `.claude/rules/`. A tool that loads only this file still finds them here:
19
+
20
+ - `capabilities/`: `.claude/rules/workflow-create-capability.md`
21
+ - `engine/`: `.claude/rules/workflow-create-engine.md`
22
+ - `ui/`, `session/`, `waiting_room/`, `setup/`, `scenario_editor/`: `.claude/rules/workflow-create-user-interface.md`
23
+ - `endpoints/`: `.claude/rules/workflow-create-endpoint.md`
24
+ - `guide/`: `.claude/rules/workflow-create-guide.md`
25
+ - `presentation/`: `.claude/rules/workflow-create-presentation.md`
26
+ - Any `*.test.ts` or `*.test.tsx`: `.claude/rules/workflow-test-engine-or-ui.md`
27
+ - `package.json` and an SDK upgrade: `.claude/rules/workflow-update-sdk-version.md`
28
+ - Publishing: `.claude/rules/workflow-publish-package.md`
29
+
30
+ ## Documentation
31
+
32
+ The SDK's documentation ships inside it, so it describes the version the package has installed. **Read the recipe before you start a task; do not guess.**
33
+
34
+ ```bash
35
+ pnpm run --silent sdk docs view # the documentation tree
36
+ pnpm run --silent sdk docs view page-index.md # every page: summary and length
37
+ pnpm run --silent sdk docs view recipes/index.md # every recipe, one line each
38
+ pnpm run --silent sdk docs view recipes/create-hook.md # one document
39
+ pnpm run --silent sdk docs view guides/session.md --outline # the headings of a page, with section lengths
40
+ pnpm run --silent sdk docs view guides/session.md --section 'Building the session UI' # one section
41
+ pnpm run --silent sdk docs view cli-reference.md # every command and flag
42
+ ```
43
+
44
+ Some guides run past 50,000 characters, more than one read may show you. Before reading a long page whole, find it in `page-index.md`, list its headings with `--outline`, and read the section you need with `--section`.
45
+
46
+ The same files are on disk in `node_modules/@seriousgaming/sdk-tools/dist/docs/`, so you can search them with `grep -rn`. Start from `recipes/` for a task, `guides/` for a whole subject, and `concepts/` for the model.
47
+
48
+ `pnpm run sdk docs export` copies them into the package, for a tool that cannot read `node_modules`. The same docs for the newest release are at https://sdk.seriousgaming.com/llms.txt; prefer the installed copy, which matches the version this package runs.
49
+
50
+ ## Patterns to keep
51
+
52
+ Four things are easy to get wrong and expensive to retrofit. Build them in from the start, whatever the game is about:
53
+
54
+ - **Key state so participants cannot overwrite each other.** Where several people edit one capability, key it by item or by person (a hook can put each participant in charge of one key), so two people changing two values write two different keys. See `recipes/design-state-for-concurrent-writes.md`
55
+ - **Put a validator on what they share.** Two changes can each fit while their merged result breaks a limit, so a validator checks the merged result and refuses it out loud
56
+ - **Await every write.** Route each `setData` through one mutation reporter, so a refusal reaches the person who made it
57
+ - **Choose how teams play.** In independent mode each team runs its own rounds, and the facilitator watches from `session/` and can undo
58
+
59
+ The starter game (`sdk new package` without `--empty`) is a worked example of all four. A package that began from it may since have been reskinned or rebuilt, so read the files on disk rather than assuming the starter's. `pnpm run --silent sdk docs view guides/starter-game.md` walks through the starter file by file, and `recipes/start-from-an-empty-package.md` begins without it.
60
+
61
+ ## How a game is built
62
+
63
+ ### Mental model
64
+
65
+ A game works like a **reactive spreadsheet**:
66
+
67
+ - **Capabilities**: column headers (named groups of variables, schema only)
68
+ - **Settings**: read-only parameters, each property with a default, overridden by scenarios
69
+ - **The engine**: the formulas (`Init` sets up, `Run` computes one tick)
70
+ - **User interfaces**: charts and input cells (`ui/` for participants, `session/` for the facilitator, `waiting_room/` before play, `setup/` and `scenario_editor/` for settings)
71
+ - **Validators**: data validation on input cells (reject a write, never change it), and an optional `Scenario` gate that refuses a scenario breaking the game's rules
72
+ - **Hooks**: handlers that run outside the tick on a signal such as `participantJoin`
73
+ - **Endpoints**: server-side functions a surface, or with `visibility: "external"` a caller outside the game, calls by identifier
74
+ - **Guide and presentation**: the facilitator's run-sheet and slide deck
75
+
76
+ Data flows: surfaces write decisions with `setData`, a tick runs the engine, and surfaces show the results.
77
+
78
+ ### Layout
79
+
80
+ ```
81
+ .
82
+ ├── seriousgaming.sdk.json # The package identifier, locales, maxTicks and teams
83
+ ├── engine/ # THE engine: Init and Run
84
+ ├── ui/ # THE participant interface
85
+ ├── session/ # THE facilitator's screen
86
+ ├── waiting_room/ # THE holding screen
87
+ ├── setup/ # THE settings form at session creation (sdk new setup)
88
+ ├── scenario_editor/ # THE scenario authoring screen (sdk new scenario_editor)
89
+ ├── presentation/ # THE slide deck the facilitator projects
90
+ ├── tick_controller/ # THE timer, for timed rounds (sdk new tick_controller)
91
+ ├── guide/ # THE facilitator guide (markdown per locale, plus assets)
92
+ ├── capabilities/<name>/ # Data definitions
93
+ ├── settings/<name>/ # Read-only parameters
94
+ ├── endpoints/<name>/ # Server-side functions
95
+ ├── hooks/<name>/ # Lifecycle handlers
96
+ ├── validators/<name>/ # Reject-only gates on writes and tick requests
97
+ ├── scenarios/<name>/ # Settings overrides, plus assets
98
+ ├── testing/engine/ # Whole-game tests (createTestSession)
99
+ └── testing/e2e/ # Playwright specs, and the global setup that starts their server
100
+ ```
101
+
102
+ A game holds one of each slot resource, so it lives in its slot and carries no name. Everything else sits at `<plural>/<name>/` and is named by its directory: `"identifier": "sales"` makes `capabilities/sales/`, `context.sales`, and `"sales"` in `reads`. A name is lowercase letters, digits, and underscores, starting with a letter. Only the package carries a dotted reverse-DNS identifier, and its game is that identifier with `.game` appended. There is no list to keep in step: a package declares whatever is on disk.
103
+
104
+ ## The loop: edit, validate, test
105
+
106
+ Pass `--json` to any command (or set `SERIOUSGAMING_JSON=1`) and it prints exactly one JSON document on stdout, success or failure, with progress on stderr. Always invoke it as `pnpm run --silent sdk …`, so no pnpm banner precedes the JSON.
107
+
108
+ ```json
109
+ { "ok": true, "command": "tick", "data": { "completedTicks": 1 }, "diagnostics": [], "warnings": [] }
110
+ { "ok": false, "command": "build", "error": { "code": "PACKAGE_INVALID", "message": "…", "hint": "…" }, "diagnostics": [{ "severity": "error", "code": "SETTINGS_UNKNOWN_KEY", "file": "scenarios/hard/scenario.sdk.json", "pointer": "/definition/settings/engine/BaseDemnd", "hint": "Did you mean 'BaseDemand'?", "message": "…" }], "warnings": [] }
111
+ ```
112
+
113
+ After every change, run these in order and stop at the first that fails:
114
+
115
+ ```bash
116
+ pnpm run --silent sdk build --validate-only --json # the package: bundles, references, settings
117
+ pnpm run typecheck # tsc over the whole package
118
+ pnpm run lint # oxlint, warnings included
119
+ pnpm test:run # unit and component tests beside each resource
120
+ pnpm test:engine # whole games, in-process
121
+ pnpm run --silent sdk tick --no-server --json # one tick in the restricted production runtime
122
+ ```
123
+
124
+ Branch on `ok`, the exit code and `error.code`, never on the message:
125
+
126
+ | Exit | Meaning | What to do |
127
+ | ---- | ------------------- | -------------------------------------------------------------------------- |
128
+ | 0 | Success | |
129
+ | 1 | A bug in the CLI | Report it; do not retry blindly |
130
+ | 2 | Usage error | Fix the command: a flag, an argument, or input you did not pass |
131
+ | 3 | Invalid package | Fix the package: `diagnostics` says which file and where |
132
+ | 4 | Refused by the game | The game said no (`REFUSED_VALIDATION`, `TICK_FAILED`, …): read the reason |
133
+ | 5 | Environment | No session, a port in use, the platform unreachable: fix the environment |
134
+
135
+ **On a failure, read `diagnostics[]` first.** `file` is relative to the package root; `pointer` is an RFC 6901 pointer into that JSON file (`/definition/reads/0` is the bundle's first read), and `line` and `column` locate a TypeScript file instead. Open it there, apply the `hint`, and rerun the same command. Branch on each diagnostic's `code` (`SCHEMA_INVALID`, `REFERENCE_UNKNOWN`, `SETTINGS_UNKNOWN_KEY`, `REMOVED_FIELD`, `LOGIC_ERROR`, …). Logic that throws during `init`, `tick` or `endpoint call` exits 4 with a `LOGIC_ERROR` naming the source line, `tick` and `team`. Warnings do not fail a command, but are usually worth fixing.
136
+
137
+ The CLI never prompts without a terminal: a command that would ask fails with `PROMPT_REQUIRED` (exit 2). Pass definitions as an argument, with `--file`, or on stdin, and pass `--yes` to `delete`. `pnpm run --silent sdk docs view recipes/check-a-package-from-a-script.md` has the whole contract.
138
+
139
+ ## Commands
140
+
141
+ ### Resources
142
+
143
+ ```bash
144
+ pnpm run sdk new capability --help # every type prints its JSON format with --help
145
+ pnpm run sdk new capability '{...}' # likewise hook, validator, endpoint, settings, scenario
146
+ pnpm run sdk new setup '{...}' # an empty slot: setup, scenario_editor, presentation, tick_controller
147
+ pnpm run sdk update engine --patch '[{"op":"add","path":"/definition/writes/-","value":"results"}]'
148
+ pnpm run sdk update capability <name> '{...}' # full replacement
149
+ pnpm run sdk update package --patch '[{"op":"replace","path":"/maxTicks","value":12}]'
150
+ pnpm run sdk delete capability <name> --yes
151
+ pnpm run generate # regenerate types after a hand edit (new and update already do)
152
+ pnpm run build # validate, generate and bundle into dist/
153
+ ```
154
+
155
+ A slot command takes no identifier. `new` refuses a slot that is already filled, so check what is on disk first and `update` a slot the package already has. `update package` changes the manifest, which takes no identifier either.
156
+
157
+ ### Playing the game from the CLI
158
+
159
+ ```bash
160
+ pnpm run --silent sdk init # start the session, or rebuild it at tick 0
161
+ pnpm run --silent sdk tick --patch '[{"op":"replace","path":"/<capability>/<variable>","value":70}]'
162
+ pnpm run --silent sdk patch '[{"op":"replace","path":"/<capability>/<variable>","value":0}]'
163
+ pnpm run --silent sdk view # the current state (--full for the whole projection)
164
+ pnpm run --silent sdk undo # undo the last tick
165
+ pnpm run --silent sdk reset # back to tick 0
166
+ ```
167
+
168
+ Patch paths start at the capability. `--team N` picks the team in a game with several. `pnpm run sdk configure '{"<settings>":{"<property>":60}}'` overrides settings for the session, keyed by settings identifier, and restarts a running session on the new values.
169
+
170
+ **Know which session a command touches:**
171
+
172
+ - **If a dev server is running**, session commands act on its session, which is what the user is watching
173
+ - **If none is running**, they start one in the background and say so on stderr
174
+ - **With `--no-server`**, they run in-process against a fresh session and leave nothing behind; each starts again at tick 0
175
+
176
+ Edits to logic and bundles reach a running dev server from its next tick, without a reset. Prefer `--no-server` and `pnpm test:engine` for your own checks. Use the shared session only when the user wants to watch. `pnpm run sdk dev status` says whether a server is running; never stop one you did not start. `pnpm test:e2e` starts an isolated server of its own on free ports, beside the user's.
177
+
178
+ ## How things work
179
+
180
+ ### Reads, writes and what the runtime owns
181
+
182
+ Every resource declares its data flow as arrays of capability identifiers: `reads` for what it consumes, `writes` for what it produces (a capability may appear in both). A capability you forgot to declare is absent from `context` (or a surface's `data`), and the generated `Context` says so. A game holds one engine; a simulation with several steps calls them as plain functions from its `Run`.
183
+
184
+ Do not rebuild runtime concerns in context:
185
+
186
+ - **Ticks**: no `CurrentRound` variable; read `meta.tick`, the tick being run
187
+ - **Time**: `meta.now`, the instant the operation started, which a re-run sees again
188
+ - **Who is on a team**: the read-only `participants` argument, not a roster kept from hooks
189
+ - **Lifecycle**: set `maxTicks` in `seriousgaming.sdk.json`, or return `complete: true` from `Run`. A tick controller is for timed rounds, or ending on a participant's write between ticks
190
+ - **Undo and reset**: built in
191
+ - **Parameters**: a settings resource (`settings/<name>/settings.sdk.json`, a default on every property), read by each resource that lists it in `settings`
192
+
193
+ `setData` updates context immediately, and other surfaces see it at once; the engine's `Run` sees it on the next tick.
194
+
195
+ ### Logic
196
+
197
+ Every logic function is async, takes one args object, and returns what it writes under `capabilities`, always by spreading:
198
+
199
+ ```typescript
200
+ import type { InitializationFunction, RunFunction } from '@seriousgaming/sdk';
201
+ import type { Context, Settings } from './types';
202
+
203
+ export const Init: InitializationFunction<Context, Settings> = async ({ context, settings }) => ({
204
+ capabilities: { ...context },
205
+ });
206
+
207
+ export const Run: RunFunction<Context, Settings> = async ({ context, meta }) => ({
208
+ capabilities: {
209
+ ...context,
210
+ results: { ...context.results, Day: meta.tick }, // never context.results.Day = …
211
+ },
212
+ });
213
+ ```
214
+
215
+ - The args are `{ context, settings, callbacks, meta, participants }`, plus `state` for an engine. `settings` is keyed by settings identifier and already resolved for the session; `guides/settings.md` has the order
216
+ - Hooks, aggregate engines (`{ shared: { capabilities }, teams: [{ capabilities }] }`) and writing endpoints (`{ response, capabilities }`) return the same way. A flat return fails the call
217
+ - **To remove a key**, return its path in `deletes` beside `capabilities` (`deletes: [['orders', 'Open', id]]`), under a capability in `writes`. Leaving a key out never removes it
218
+ - `Init` is optional: without it each team starts from the capabilities' defaults
219
+ - `Run` may return `complete: true` to end the game, and an engine may return `state` beside `capabilities` for private memory between ticks (type it with `RunFunction`'s fourth parameter)
220
+ - A step of a split engine is a `StepFunction<Context, Settings>`: steps pass the context flat, and only the exported function wraps the result
221
+
222
+ ### The logic runtime: ECMAScript intrinsics only
223
+
224
+ Engine, hook, validator, endpoint, and tick controller logic runs in a **bare V8 isolate** in production. `process`, `require`, `fetch`, timers, `structuredClone`, `Buffer`, `TextEncoder`, `URL`, `crypto`, `atob`, `window`, `document` and `localStorage` are absent and throw at tick time. `console.log` is fine.
225
+
226
+ | Instead of | Use |
227
+ | ----------------------------- | -------------------------------------------------------------- |
228
+ | `structuredClone(v)` | `JSON.parse(JSON.stringify(v))` |
229
+ | `TextEncoder`, `TextDecoder` | `encodeUtf8`, `decodeUtf8` from `@seriousgaming/sdk` |
230
+ | `fetch(...)` | The injected `callbacks`, or an endpoint |
231
+ | `setTimeout(...)` | Nothing: ticks are the scheduling primitive |
232
+ | `process.env.X` | The `settings` argument |
233
+ | `Math.random()` for kept data | `deriveSeed` and `seededRandom` from the SDK, from `meta.seed` |
234
+ | `Date.now()`, `new Date()` | `meta.now` |
235
+
236
+ Importing a Node built-in (`node:fs`, `path`, `os`, …), directly or through a library, fails `build`, `dev` and `tick` with `LOGIC_NODE_BUILTIN`. `pnpm run lint` refuses the globals above as errors in every logic file, and fails on any warning, so run it before you call logic done. It cannot see `globalThis.fetch`, and it is off for tests, which run in Node: **a green unit test does not prove logic is portable**, so finish with `tick --no-server`.
237
+
238
+ ### Type safety
239
+
240
+ `variablesSchema` and `settingsSchema` are full JSON Schema 7 objects, and the generated types are only as precise as they are:
241
+
242
+ - **Wrap every schema**: `type: 'object'`, `properties`, `additionalProperties: false` (and `required` in a `variablesSchema`)
243
+ - **Type every field.** Never a string holding JSON; give an object its `properties` and an array its `items`
244
+ - **Key collections by id** where several people write at once (`additionalProperties` with a schema): two writes to two keys cannot collide, and an entry leaves through `deletes`. See `recipes/design-state-for-concurrent-writes.md`
245
+ - **A `default` must satisfy its own schema**: `build --validate-only` fails one that does not
246
+
247
+ ```json
248
+ {
249
+ "definition": {
250
+ "identifier": "market",
251
+ "variablesSchema": {
252
+ "type": "object",
253
+ "properties": {
254
+ "Competitors": {
255
+ "type": "object",
256
+ "properties": {
257
+ "count": { "type": "number", "minimum": 1 },
258
+ "priceList": {
259
+ "type": "array",
260
+ "items": { "type": "number", "minimum": 0 }
261
+ }
262
+ },
263
+ "required": ["count", "priceList"],
264
+ "additionalProperties": false,
265
+ "default": { "count": 5, "priceList": [10, 15, 20] }
266
+ }
267
+ },
268
+ "required": ["Competitors"],
269
+ "additionalProperties": false
270
+ }
271
+ }
272
+ }
273
+ ```
274
+
275
+ Every resource with logic or a surface has a generated `types.ts` beside it: `Context` holds exactly the capabilities it declares, `Settings` the settings resources it lists, and `Callbacks` the services in its `uses`. Import from `./types` (or `../types` from a `logic/` directory), never edit it or `defaults.ts`, and never write your own. `pnpm run --silent sdk docs view guides/type-safety.md` has the rest.
276
+
277
+ ### Testing logic
278
+
279
+ Call a logic function with `logicArgs` from `@seriousgaming/sdk/testing`, which fills `meta`, the roster and offline stub callbacks around what you name; pass the generated `defaultSettings`. A whole game runs in `createTestSession<Context, SharedContext>` (`testing/engine/`), whose `setData` and `requestTick` act as a participant, so validators judge them. Never cast an argument or a context:
280
+
281
+ ```ts
282
+ const result = await Run(
283
+ logicArgs.run({ context: defaultContext, settings: defaultSettings, meta: { tick: 3 } })
284
+ );
285
+
286
+ const session = await createTestSession<Context, SharedContext>({ packagePath });
287
+ await session.setData(0, { decisions: { Price: 4 } }); // a write to a capability the UI declares
288
+ await session.tick();
289
+ expect(session.team(0).context.results.Day).toBe(1);
290
+ ```
291
+
292
+ ## User interfaces
293
+
294
+ - **Default to MUI** (`@mui/material`), as the starter game does. Build each surface's theme with `createTheme(createSurfaceTheme(theme, { fonts: { body: 'Work Sans Variable' } }), { ...your shapes })`, as the starter game's `ui/src/theme.ts` does: it applies the host's colours, their `contrastText`, and the brand's fonts. Another library must integrate with `useUserInterfaceTheme` the same way, so colours and dark mode work, and text on a theme colour uses that colour's `contrastText` (`colors.contrastText.primary`)
295
+ - **Honour the host's brand.** A white-label host may send a logo and fonts; `useBrandLogo()` gives the logo for the current mode, or nothing, as the starter game's `ui/src/HostLogo.tsx` shows, and `useBrandIcon()` the square mark. Do not hard-code a platform's logo in its place: the host's brand is the host's to send. For join sheets, open the host's `'print-sheets'` overlay where it offers one rather than drawing your own
296
+ - **Await writes.** `setData` rejects when the host refuses the write. Route writes through `useMutationReporter`, as the starter game's `ui/src/writes.ts` does; on a `conflict`, offer `failure.retry` behind a 'Try again' button
297
+ - **Endpoint calls fail typed.** `callbacks.endpoints['<name>'](request)` rejects with an `EndpointError` whose `kind` says why; a non-empty `applied` means some effects landed. Never retry one automatically
298
+ - **A viewer's own choices** (a tab, a collapsed panel) go in `useViewerStorage(key, initial)`, never `localStorage`, which collides across sessions
299
+ - **Assets and history through the hooks.** `useAssetUrl(ref)` for a `src`, `useAsset(ref, { as })` to read a file (it finds the locale's copy in `<dir>/<locale>/<file>`), and `usePastState(query)` for past rounds, rather than hand-rolled effects. The wrapper already sets `lang`, `dir` and `color-scheme` on the document
300
+ - **Every string** goes through `src/i18n.ts`
301
+ - **The facilitator's screen** is `session/`: rendered full-bleed beneath a thin band of host chrome, it owns teams, participants and game controls (`guides/session.md`)
302
+
303
+ ### Testing a surface
304
+
305
+ Every surface but the presentation scaffolds an `App.test.tsx`; the starter game's own tests are worked examples, and `pnpm run --silent sdk docs view guides/testing.md` is the reference. A deck is tested through what its slides show, kept in plain functions (the starter game's `presentation/src/stalls.test.ts`), and a Playwright spec that it opens.
306
+
307
+ - **Render through the helper**: `renderUserInterface()` from `@seriousgaming/sdk/ui/testing` (or `renderSessionUserInterface<SessionData>()`, or `renderSettingsEditor()` for setup and the scenario editor). It supplies every provider the host does; pass `data`, `settings`, `callbacks` and the rest as options
308
+ - **Never `vi.mock` the SDK, and never wire its providers by hand**
309
+ - **Use `fireEvent.change` on controlled inputs**: the mock `setData` does not update the value between `userEvent.type` keystrokes
310
+ - **Look at every screen you change**, at phone and desktop size: `pnpm run --silent sdk screenshot /team/1/player/1 --width 390 --height 844 --json`, then again with `--width 1280 --height 800`. Open each PNG, fix text that is cut off, overlaps or is hard to read, and clear the `consoleErrors`, `failedRequests` and `uncaughtExceptions` it lists. Reach the state first with `sdk tick` (`recipes/screenshot-a-surface.md`)
311
+
312
+ ## Presentations
313
+
314
+ The `presentation/` slot holds the facilitator's slide deck, built with `@seriousgaming/deck` at the SDK's version. It reads every team's state and writes nothing. The starter game's deck is a worked example: a title, a slide a day, and the results. A facilitator exports it to PDF or PowerPoint and edits the copy, so:
315
+
316
+ - **Use the building blocks** (`Heading`, `Text`, `Bullets`, `Table`) for anything a facilitator might edit; anything else exports as a picture
317
+ - **Render with `session === null`**, showing labelled sample figures where results would go
318
+ - **Branch on settings, not the scenario name**, and draw a custom animation's end state when `useSlide().mode` is `'static'`
319
+ - **Route every word through i18n**, and keep one element per slide
320
+
321
+ ## LLM integration
322
+
323
+ Logic calls `callbacks.generateText()` only if its bundle lists `generateText` in `uses`; once listed it is always present on the generated `Callbacks`, so call it without `?.`. A surface reaches an LLM only through an endpoint. The dev server needs `SERIOUSGAMING_API_KEY` in the environment or `.env`, and `createTestSession` stubs it offline. See `guides/llm-integration.md`.
324
+
325
+ ## Keeping the SDK up to date
326
+
327
+ ```bash
328
+ pnpm run --silent sdk version # the installed version
329
+ pnpm run sdk docs view changelog.md # newest first: read every entry above your version
330
+ pnpm run sdk docs view guides/upgrading.md # a step for each breaking change
331
+ ```
332
+
333
+ Upgrade only when the user asks, or when the changelog has a fix the task needs, and then follow `.claude/rules/workflow-update-sdk-version.md`: it bumps the SDK, its tools and the deck together, and adopts newer rules without overwriting the package's own. This guidance updates with the installed version and needs no merging.
334
+
335
+ ## Troubleshooting
336
+
337
+ | Problem | Solution |
338
+ | ------------------------------------- | ------------------------------------------------------------------------------------------ |
339
+ | Types not updating | `pnpm run generate` |
340
+ | A capability is missing in code | Add it to the resource's `reads` or `writes`; `update` regenerates the types |
341
+ | A surface's write is refused | Add the capability to that surface's `writes` |
342
+ | Build failing | `pnpm run --silent sdk build --validate-only --json`, then read `diagnostics` |
343
+ | Edit not showing, or `SETTINGS_STALE` | A setting, `teams` or a capability's scope applies only at init: `sdk init` |
344
+ | A hook reads empty data in a surface | Two copies of a package with React context: add it to `resolve.dedupe` in `vite.config.ts` |
345
+ | Anything else | `pnpm run --silent sdk docs view troubleshooting.md` |
346
+
347
+ Keep `DESIGN.md` up to date as the game changes, and hold to two habits for every surface:
348
+
349
+ - **Brief first.** Before you build or redesign a screen, write its brief under 'User interfaces' in `DESIGN.md`: who uses it and on what device, its one main action, its layout, the states it must handle, and the game's identity
350
+ - **Check, then go round once more.** Once it is built, check every screen at phone and desktop size against `pnpm run --silent sdk docs view guides/designing-screens.md`, fix what you find, and check again
@@ -2,32 +2,33 @@
2
2
  import {
3
3
  connectSession,
4
4
  resolveSession
5
- } from "./cli-GTSGLN3Z.js";
5
+ } from "./cli-OANH3BTQ.js";
6
6
  import "./cli-WU43JT4T.js";
7
7
  import {
8
8
  DevShell,
9
+ LOCAL_ORIGINS_FLAG,
9
10
  parseRoute
10
- } from "./cli-G6KELFSX.js";
11
+ } from "./cli-X7E3637I.js";
11
12
  import "./cli-BWX5E7TQ.js";
12
- import "./cli-V4GHRWOV.js";
13
+ import "./cli-M7WEAIRF.js";
13
14
  import "./cli-ILKCQNM6.js";
14
- import "./cli-JMZLT65J.js";
15
- import "./cli-LFM7GJHI.js";
16
- import "./cli-C6TH5S7K.js";
15
+ import "./cli-TPNQLYPC.js";
16
+ import "./cli-LQ4VSM5R.js";
17
+ import "./cli-EJVAQCMQ.js";
17
18
  import {
18
19
  loadEnvironmentConfig
19
20
  } from "./cli-TDSQSCX4.js";
20
21
  import "./cli-SRHBXZCN.js";
21
- import "./cli-GUXKQMJ7.js";
22
+ import "./cli-MM3A4SPH.js";
22
23
  import "./cli-4LKXZQ2B.js";
23
24
  import "./cli-MMN4BPO4.js";
24
25
  import "./cli-YOTGR3NB.js";
25
26
  import "./cli-QUNIRH7A.js";
26
- import "./cli-VCKOC2EV.js";
27
- import "./cli-E2NLWIFE.js";
27
+ import "./cli-C6G65H6S.js";
28
+ import "./cli-UTM4QU67.js";
28
29
  import "./cli-25RWY5BQ.js";
29
30
  import "./cli-QWQMPCL6.js";
30
- import "./cli-SMFSZF2G.js";
31
+ import "./cli-ZF7IFB54.js";
31
32
  import "./cli-F2D4GGUA.js";
32
33
  import "./cli-4YB3ROVR.js";
33
34
  import {
@@ -136,6 +137,7 @@ function planScreenshot(path, options, packagePath) {
136
137
  );
137
138
  }
138
139
  url.searchParams.set("bare", "");
140
+ url.searchParams.set(LOCAL_ORIGINS_FLAG, "");
139
141
  if (scheme !== void 0) url.searchParams.set("scheme", scheme);
140
142
  if (options.brand !== void 0) url.searchParams.set("brand", options.brand);
141
143
  const width = dimension(options.width, "--width", DEFAULT_WIDTH);
@@ -151,8 +153,8 @@ function planScreenshot(path, options, packagePath) {
151
153
  throw new CliError("USAGE_BAD_FLAG", `--out names a PNG file, and got "${options.out}"`);
152
154
  }
153
155
  return {
154
- // `bare` is a flag, not a value: `?bare=` reads as one, as the console's own links avoid.
155
- target: `${url.pathname}${url.search.replace(/([?&]bare)=(?=&|$)/, "$1")}`,
156
+ // Flags, not values: `?bare=` reads as one, as the console's own links avoid.
157
+ target: `${url.pathname}${url.search.replace(/=(?=&|$)/g, "")}`,
156
158
  route,
157
159
  width,
158
160
  height,
@@ -343,6 +345,12 @@ async function capture(chromium, url, plan) {
343
345
  });
344
346
  const page = await context.newPage();
345
347
  watch(page, problems);
348
+ const consoleHost = new URL(url).host;
349
+ await page.routeWebSocket(
350
+ (socket) => socket.host !== consoleHost,
351
+ () => {
352
+ }
353
+ );
346
354
  const deadline = Date.now() + plan.timeoutMs;
347
355
  try {
348
356
  await page.goto(url, { waitUntil: "load", timeout: plan.timeoutMs });
@@ -1,19 +1,19 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  resolveSession
4
- } from "./cli-GTSGLN3Z.js";
4
+ } from "./cli-OANH3BTQ.js";
5
5
  import "./cli-WU43JT4T.js";
6
- import "./cli-C6TH5S7K.js";
6
+ import "./cli-EJVAQCMQ.js";
7
7
  import "./cli-TDSQSCX4.js";
8
8
  import "./cli-SRHBXZCN.js";
9
- import "./cli-GUXKQMJ7.js";
9
+ import "./cli-MM3A4SPH.js";
10
10
  import "./cli-4LKXZQ2B.js";
11
11
  import "./cli-MMN4BPO4.js";
12
12
  import "./cli-QUNIRH7A.js";
13
- import "./cli-E2NLWIFE.js";
13
+ import "./cli-UTM4QU67.js";
14
14
  import "./cli-25RWY5BQ.js";
15
15
  import "./cli-QWQMPCL6.js";
16
- import "./cli-SMFSZF2G.js";
16
+ import "./cli-ZF7IFB54.js";
17
17
  import "./cli-F2D4GGUA.js";
18
18
  import "./cli-4YB3ROVR.js";
19
19
  import {
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  normalizeSettingsSchema
4
- } from "./cli-FYINNRML.js";
4
+ } from "./cli-LE5ICDAF.js";
5
5
  import {
6
6
  CliError
7
7
  } from "./cli-N6H6T2E2.js";
@@ -4,7 +4,7 @@ import {
4
4
  } from "./cli-S5IVGDDD.js";
5
5
  import {
6
6
  findBundleFile
7
- } from "./cli-GFBGYFYD.js";
7
+ } from "./cli-57V4ARER.js";
8
8
  import {
9
9
  CliError
10
10
  } from "./cli-N6H6T2E2.js";
@@ -1,13 +1,13 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  validateEngine
4
- } from "./cli-JMZLT65J.js";
4
+ } from "./cli-TPNQLYPC.js";
5
5
  import "./cli-4LKXZQ2B.js";
6
6
  import {
7
7
  LOGIC_NODE_BUILTIN,
8
8
  Transpile,
9
9
  loadConfig
10
- } from "./cli-SMFSZF2G.js";
10
+ } from "./cli-ZF7IFB54.js";
11
11
  import "./cli-F2D4GGUA.js";
12
12
  import "./cli-4YB3ROVR.js";
13
13
  import {
@@ -1,28 +1,28 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  createSettingsEditor
4
- } from "./cli-AK7OIPWY.js";
5
- import "./cli-GGPDQNM3.js";
6
- import "./cli-UJ4UCL2Z.js";
4
+ } from "./cli-XR2XSWQN.js";
5
+ import "./cli-XTANOFQR.js";
6
+ import "./cli-4VZIJYKU.js";
7
7
  import "./cli-S5IVGDDD.js";
8
- import "./cli-YVVXUD2G.js";
8
+ import "./cli-JR5AZLLK.js";
9
9
  import "./cli-4UWFQNGF.js";
10
- import "./cli-FYINNRML.js";
10
+ import "./cli-LE5ICDAF.js";
11
11
  import "./cli-IUS2YCD3.js";
12
12
  import "./cli-QUNIRH7A.js";
13
- import "./cli-BYJWFFCF.js";
13
+ import "./cli-YSPZZQCP.js";
14
14
  import "./cli-XSVGKI3R.js";
15
- import "./cli-MBNMPVDC.js";
16
- import "./cli-GFBGYFYD.js";
17
- import "./cli-UELGBQG7.js";
15
+ import "./cli-FXY3DKPW.js";
16
+ import "./cli-57V4ARER.js";
17
+ import "./cli-JGFJWZFU.js";
18
18
  import "./cli-ZTWOE3ZT.js";
19
- import "./cli-4BV45LBH.js";
20
- import "./cli-4AKVLEC4.js";
21
- import "./cli-VCKOC2EV.js";
22
- import "./cli-E2NLWIFE.js";
19
+ import "./cli-H3J3ICCQ.js";
20
+ import "./cli-SWZY7L7K.js";
21
+ import "./cli-C6G65H6S.js";
22
+ import "./cli-UTM4QU67.js";
23
23
  import "./cli-25RWY5BQ.js";
24
24
  import "./cli-QWQMPCL6.js";
25
- import "./cli-SMFSZF2G.js";
25
+ import "./cli-ZF7IFB54.js";
26
26
  import "./cli-F2D4GGUA.js";
27
27
  import "./cli-4YB3ROVR.js";
28
28
  import "./cli-N6H6T2E2.js";
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  getResourceMeta
4
- } from "./cli-SMFSZF2G.js";
4
+ } from "./cli-ZF7IFB54.js";
5
5
 
6
6
  // cli/utils/resource-scan.ts
7
7
  import { existsSync, readdirSync } from "fs";
@@ -1,28 +1,28 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  createSettingsEditor
4
- } from "./cli-AK7OIPWY.js";
5
- import "./cli-GGPDQNM3.js";
6
- import "./cli-UJ4UCL2Z.js";
4
+ } from "./cli-XR2XSWQN.js";
5
+ import "./cli-XTANOFQR.js";
6
+ import "./cli-4VZIJYKU.js";
7
7
  import "./cli-S5IVGDDD.js";
8
- import "./cli-YVVXUD2G.js";
8
+ import "./cli-JR5AZLLK.js";
9
9
  import "./cli-4UWFQNGF.js";
10
- import "./cli-FYINNRML.js";
10
+ import "./cli-LE5ICDAF.js";
11
11
  import "./cli-IUS2YCD3.js";
12
12
  import "./cli-QUNIRH7A.js";
13
- import "./cli-BYJWFFCF.js";
13
+ import "./cli-YSPZZQCP.js";
14
14
  import "./cli-XSVGKI3R.js";
15
- import "./cli-MBNMPVDC.js";
16
- import "./cli-GFBGYFYD.js";
17
- import "./cli-UELGBQG7.js";
15
+ import "./cli-FXY3DKPW.js";
16
+ import "./cli-57V4ARER.js";
17
+ import "./cli-JGFJWZFU.js";
18
18
  import "./cli-ZTWOE3ZT.js";
19
- import "./cli-4BV45LBH.js";
20
- import "./cli-4AKVLEC4.js";
21
- import "./cli-VCKOC2EV.js";
22
- import "./cli-E2NLWIFE.js";
19
+ import "./cli-H3J3ICCQ.js";
20
+ import "./cli-SWZY7L7K.js";
21
+ import "./cli-C6G65H6S.js";
22
+ import "./cli-UTM4QU67.js";
23
23
  import "./cli-25RWY5BQ.js";
24
24
  import "./cli-QWQMPCL6.js";
25
- import "./cli-SMFSZF2G.js";
25
+ import "./cli-ZF7IFB54.js";
26
26
  import "./cli-F2D4GGUA.js";
27
27
  import "./cli-4YB3ROVR.js";
28
28
  import "./cli-N6H6T2E2.js";
@@ -1,20 +1,20 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  runResourceCommand
4
- } from "./cli-DMW2OQIJ.js";
4
+ } from "./cli-HYEU3QS6.js";
5
5
  import {
6
6
  RESOURCE_DESCRIPTORS_BY_TYPE,
7
7
  supportedTypes
8
- } from "./cli-LMDJCHHD.js";
9
- import "./cli-UELGBQG7.js";
8
+ } from "./cli-6HB6HTC6.js";
9
+ import "./cli-JGFJWZFU.js";
10
10
  import "./cli-ZTWOE3ZT.js";
11
- import "./cli-4BV45LBH.js";
12
- import "./cli-4AKVLEC4.js";
13
- import "./cli-VCKOC2EV.js";
14
- import "./cli-E2NLWIFE.js";
11
+ import "./cli-H3J3ICCQ.js";
12
+ import "./cli-SWZY7L7K.js";
13
+ import "./cli-C6G65H6S.js";
14
+ import "./cli-UTM4QU67.js";
15
15
  import "./cli-25RWY5BQ.js";
16
16
  import "./cli-QWQMPCL6.js";
17
- import "./cli-SMFSZF2G.js";
17
+ import "./cli-ZF7IFB54.js";
18
18
  import "./cli-F2D4GGUA.js";
19
19
  import "./cli-4YB3ROVR.js";
20
20
  import {