@seriousgaming/sdk-tools 1.6.0 → 1.6.1

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 (107) hide show
  1. package/dist/agent/guidance.md +350 -0
  2. package/dist/{cli-6WXLXJVX.js → cli-2GZYGRVL.js} +14 -14
  3. package/dist/{cli-UHSZBKYO.js → cli-2NU2LPEE.js} +12 -12
  4. package/dist/{cli-TPU4TUR6.js → cli-3BRC32CP.js} +12 -12
  5. package/dist/{cli-3HE4AVZG.js → cli-3D3ZXWOV.js} +17 -21
  6. package/dist/{cli-5JEGTVTG.js → cli-3ZKWV3PN.js} +12 -12
  7. package/dist/{cli-GXD36NF2.js → cli-45OCBG53.js} +8 -8
  8. package/dist/{cli-K2B6WHKA.js → cli-4PXNOJQX.js} +10 -10
  9. package/dist/{cli-FYINNRML.js → cli-4SIWLHQO.js} +27 -70
  10. package/dist/{cli-YVVXUD2G.js → cli-4VFZHLDG.js} +7 -2
  11. package/dist/{cli-3E3MD5U4.js → cli-5ACDPCXI.js} +1 -1
  12. package/dist/{cli-UJ4UCL2Z.js → cli-5IAW3LIF.js} +1 -1
  13. package/dist/{cli-U2UE7I7J.js → cli-5SM367K7.js} +8 -8
  14. package/dist/{cli-O6PWMJTZ.js → cli-64AB62PM.js} +1 -1
  15. package/dist/{cli-GTSGLN3Z.js → cli-6K3VQQUS.js} +1 -1
  16. package/dist/{cli-6RRVEGFB.js → cli-6QB2VFPY.js} +10 -10
  17. package/dist/{cli-PQBXVLEU.js → cli-6SGCYEEC.js} +8 -8
  18. package/dist/{cli-ZVSFYDPQ.js → cli-6UTPHWRQ.js} +16 -14
  19. package/dist/{cli-QUIJCBYB.js → cli-6VNKQ3OX.js} +7 -7
  20. package/dist/{cli-O5KP4OVN.js → cli-72XDEFU3.js} +2 -2
  21. package/dist/{cli-I355WTAF.js → cli-7A6MKCUJ.js} +10 -10
  22. package/dist/{cli-JMZLT65J.js → cli-7XLHO2FE.js} +1 -1
  23. package/dist/{cli-AK7OIPWY.js → cli-AV2FYC5G.js} +13 -17
  24. package/dist/{cli-V4GHRWOV.js → cli-BJMS3VX3.js} +5 -5
  25. package/dist/{cli-C3NVCKO6.js → cli-BUQI5UU4.js} +8 -8
  26. package/dist/{cli-E2NLWIFE.js → cli-BYCHKSSH.js} +1 -1
  27. package/dist/{cli-JZM7XTNV.js → cli-C3CMJSNL.js} +10 -10
  28. package/dist/{cli-B4TN6PJP.js → cli-C6ZLPK2U.js} +2 -2
  29. package/dist/{cli-WAE26SVW.js → cli-CD5CIJZI.js} +9 -9
  30. package/dist/{cli-SIPDUBFL.js → cli-DDJYUKQG.js} +14 -14
  31. package/dist/{cli-QEVE5HUM.js → cli-DFBTZEBX.js} +11 -11
  32. package/dist/{cli-QEVDDBNO.js → cli-DOXRQ3S5.js} +8 -8
  33. package/dist/{cli-TLLA6KAP.js → cli-EVI36HEM.js} +10 -10
  34. package/dist/{cli-LFM7GJHI.js → cli-FQRVFGN6.js} +0 -0
  35. package/dist/{cli-KNOOKGYW.js → cli-G6CANSPL.js} +10 -10
  36. package/dist/{cli-XCO2VQOH.js → cli-GFNDW2DL.js} +19 -17
  37. package/dist/{cli-DMW2OQIJ.js → cli-HFX3YPUL.js} +1 -1
  38. package/dist/{cli-RA673NGF.js → cli-HKORECAG.js} +4 -4
  39. package/dist/{cli-VCI3CG36.js → cli-HOE3WLFH.js} +9 -9
  40. package/dist/{cli-JFU22EJ2.js → cli-HSIHDN6K.js} +11 -11
  41. package/dist/{cli-UNJ5X6BU.js → cli-HW53ICZC.js} +10 -10
  42. package/dist/{cli-S5QDONIQ.js → cli-IDVUHGKG.js} +7 -7
  43. package/dist/{cli-4AKVLEC4.js → cli-IEMKI7J7.js} +3 -3
  44. package/dist/{cli-GDQ6ILJY.js → cli-ILFDANBR.js} +7 -7
  45. package/dist/{cli-G6KELFSX.js → cli-IP4RXGHM.js} +5 -5
  46. package/dist/{cli-BYJWFFCF.js → cli-J4UBELKF.js} +2 -2
  47. package/dist/{cli-ZISJ36MM.js → cli-JJSWBW4H.js} +10 -10
  48. package/dist/{cli-ZWPYIXNI.js → cli-JVI24FI6.js} +7 -7
  49. package/dist/{cli-DZW3XD5F.js → cli-JZCLIT3O.js} +17 -25
  50. package/dist/{cli-PNLYX6R6.js → cli-JZOZOEZM.js} +12 -12
  51. package/dist/{cli-HYY64SUD.js → cli-KGM6RRQW.js} +13 -13
  52. package/dist/{cli-GUXKQMJ7.js → cli-KGT5L7VZ.js} +1 -1
  53. package/dist/{cli-BPYMTOUL.js → cli-KOGRWFN7.js} +10 -10
  54. package/dist/{cli-UELGBQG7.js → cli-KSGB2ZLK.js} +1 -1
  55. package/dist/{cli-PFFCNGHI.js → cli-L7VYSXQK.js} +3 -3
  56. package/dist/{cli-57RXC3HQ.js → cli-LK3V4RI5.js} +14 -14
  57. package/dist/{cli-4BV45LBH.js → cli-LQOHATY2.js} +2 -2
  58. package/dist/{cli-EEFJKIGL.js → cli-MJV47HKI.js} +17 -25
  59. package/dist/{cli-G522CPRL.js → cli-MOPSZ3CS.js} +10 -10
  60. package/dist/{cli-E6DJIMYD.js → cli-MU5LB43S.js} +17 -23
  61. package/dist/{cli-IRZ5KB7D.js → cli-N24OHSAN.js} +14 -14
  62. package/dist/{cli-LXYPE3L5.js → cli-N45DREM4.js} +12 -12
  63. package/dist/{cli-EVFS55WN.js → cli-NROTDF5Y.js} +22 -25
  64. package/dist/{cli-FBTRTIZJ.js → cli-O5ABH2WK.js} +10 -10
  65. package/dist/{cli-VCKOC2EV.js → cli-OMWC75CC.js} +2 -2
  66. package/dist/{cli-GFBGYFYD.js → cli-OXAUOWCN.js} +1 -1
  67. package/dist/{cli-ROT3DRKU.js → cli-PGCIHPU7.js} +16 -18
  68. package/dist/{cli-GGPDQNM3.js → cli-Q6ZBZYK2.js} +2 -2
  69. package/dist/{cli-M6BCQRID.js → cli-QUSCIUOM.js} +18 -29
  70. package/dist/{cli-6AMT3BUO.js → cli-QY5NZAR7.js} +12 -12
  71. package/dist/{cli-PTT5RGKO.js → cli-R2MUZQE2.js} +5 -5
  72. package/dist/{cli-RN6IWTL2.js → cli-RCIWBCXD.js} +14 -14
  73. package/dist/{cli-2GOFEW26.js → cli-RLEGRWFM.js} +8 -8
  74. package/dist/{cli-DL2CVMRF.js → cli-RSW6EBBD.js} +11 -11
  75. package/dist/{cli-MBNMPVDC.js → cli-TT36JCU5.js} +8 -5
  76. package/dist/{cli-WOGIAU2E.js → cli-TTKICM5P.js} +7 -7
  77. package/dist/{cli-R4PCG5YX.js → cli-TTMBBEJC.js} +12 -12
  78. package/dist/{cli-GBFM76BF.js → cli-UMEBPAZQ.js} +5 -5
  79. package/dist/{cli-LFGRFIEO.js → cli-UZZFNXRX.js} +12 -12
  80. package/dist/{cli-UMFFURZ7.js → cli-VDBW23SS.js} +10 -10
  81. package/dist/{cli-LMDJCHHD.js → cli-VPRRICZA.js} +47 -47
  82. package/dist/{cli-SMFSZF2G.js → cli-VQ6HVQW4.js} +1 -0
  83. package/dist/{cli-E33CJRRQ.js → cli-WR3NOY74.js} +14 -14
  84. package/dist/{cli-UTJU4IYG.js → cli-XAT25PRU.js} +10 -10
  85. package/dist/{cli-KL3756X6.js → cli-XOTNXEJA.js} +17 -19
  86. package/dist/{cli-C6TH5S7K.js → cli-XSLNH5PR.js} +3 -3
  87. package/dist/{cli-Q2XJF5AS.js → cli-XZCJIKIV.js} +18 -21
  88. package/dist/{cli-272KBNJH.js → cli-Y3DDNMPX.js} +12 -12
  89. package/dist/{cli-G6UE5NL4.js → cli-Y3O5F4JN.js} +11 -11
  90. package/dist/{cli-7OGYADZ3.js → cli-Z56ZIVA6.js} +12 -12
  91. package/dist/{cli-IDKYF5XB.js → cli-ZBN5KAIB.js} +1 -1
  92. package/dist/{cli-UKQYZYFK.js → cli-ZDOTXEKL.js} +1 -1
  93. package/dist/{cli-TCY5LJ7E.js → cli-ZDUADFBY.js} +10 -10
  94. package/dist/{cli-ORIG557O.js → cli-ZJFQ7EEA.js} +17 -27
  95. package/dist/cli.js +34 -34
  96. package/dist/docs/ai-agents.md +1 -1
  97. package/dist/docs/changelog.md +15 -0
  98. package/dist/docs/getting-started.md +1 -1
  99. package/dist/docs/guides/starter-game.md +1 -1
  100. package/dist/docs/guides/upgrading.md +19 -2
  101. package/dist/docs/page-index.md +2 -2
  102. package/dist/templates/package/CLAUDE.md.template +7 -346
  103. package/dist/templates/package/claude/rules/workflow-create-engine.md +2 -2
  104. package/dist/templates/package/claude/rules/workflow-create-guide.md +2 -2
  105. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  106. package/dist/templates/package/claude/rules/workflow-update-sdk-version.md +3 -3
  107. package/package.json +3 -3
@@ -1,46 +1,48 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  promptForSettings
4
- } from "./cli-UKQYZYFK.js";
4
+ } from "./cli-ZDOTXEKL.js";
5
5
  import {
6
6
  loadResourceIdentifiers
7
- } from "./cli-GGPDQNM3.js";
7
+ } from "./cli-Q6ZBZYK2.js";
8
8
  import {
9
9
  readAuthoredBundle
10
- } from "./cli-YVVXUD2G.js";
10
+ } from "./cli-4VFZHLDG.js";
11
11
  import {
12
12
  resolveInputSource
13
13
  } from "./cli-4UWFQNGF.js";
14
14
  import {
15
15
  createWaitingRoomUserInterfaceFiles
16
- } from "./cli-FYINNRML.js";
16
+ } from "./cli-4SIWLHQO.js";
17
17
  import "./cli-IUS2YCD3.js";
18
18
  import "./cli-QUNIRH7A.js";
19
- import "./cli-BYJWFFCF.js";
19
+ import "./cli-J4UBELKF.js";
20
20
  import {
21
21
  loadPackageContext
22
22
  } from "./cli-XSVGKI3R.js";
23
- import "./cli-MBNMPVDC.js";
24
- import "./cli-GFBGYFYD.js";
23
+ import {
24
+ presentFields
25
+ } from "./cli-TT36JCU5.js";
26
+ import "./cli-OXAUOWCN.js";
25
27
  import {
26
28
  BUILD_COMMAND,
27
29
  generateTypes,
28
30
  operationError,
29
31
  printOperationResult
30
- } from "./cli-UELGBQG7.js";
32
+ } from "./cli-KSGB2ZLK.js";
31
33
  import {
32
34
  checkbox,
33
35
  input
34
36
  } from "./cli-ZTWOE3ZT.js";
35
- import "./cli-4BV45LBH.js";
36
- import "./cli-4AKVLEC4.js";
37
- import "./cli-VCKOC2EV.js";
38
- import "./cli-E2NLWIFE.js";
37
+ import "./cli-LQOHATY2.js";
38
+ import "./cli-IEMKI7J7.js";
39
+ import "./cli-OMWC75CC.js";
40
+ import "./cli-BYCHKSSH.js";
39
41
  import "./cli-25RWY5BQ.js";
40
42
  import "./cli-QWQMPCL6.js";
41
43
  import {
42
44
  validateSDKWaitingRoomUserInterface
43
- } from "./cli-SMFSZF2G.js";
45
+ } from "./cli-VQ6HVQW4.js";
44
46
  import "./cli-F2D4GGUA.js";
45
47
  import {
46
48
  logger
@@ -62,21 +64,11 @@ async function createWaitingRoomUserInterface(definitionInput, options) {
62
64
  command: "new",
63
65
  validate: validateSDKWaitingRoomUserInterface
64
66
  });
65
- const definition = uiInput.definition;
66
- const reads2 = definition.reads || [];
67
- const crossTeamReads = definition.crossTeamReads || [];
68
- const writes2 = definition.writes || [];
69
- const endpoints = definition.endpoints || [];
70
- const settings2 = definition.settings || [];
71
67
  logger.info("Creating waiting room user interface files...\n");
72
68
  const result2 = await createWaitingRoomUserInterfaceFiles({
73
69
  packagePath: options.workingDir,
74
70
  name: "Waiting room",
75
- reads: reads2,
76
- crossTeamReads,
77
- writes: writes2,
78
- endpoints,
79
- settings: settings2
71
+ definition: uiInput.definition
80
72
  });
81
73
  if (!result2.success) {
82
74
  throw operationError(result2, "Failed to create waiting room user interface files");
@@ -122,9 +114,7 @@ async function createWaitingRoomUserInterface(definitionInput, options) {
122
114
  const result = await createWaitingRoomUserInterfaceFiles({
123
115
  packagePath: options.workingDir,
124
116
  name,
125
- reads,
126
- writes,
127
- settings
117
+ definition: presentFields({ reads, writes, settings })
128
118
  });
129
119
  if (!result.success) {
130
120
  throw operationError(result, "Failed to create waiting room user interface files");
package/dist/cli.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  RESOURCE_DESCRIPTORS,
4
4
  lazy
5
- } from "./cli-LMDJCHHD.js";
5
+ } from "./cli-VPRRICZA.js";
6
6
  import {
7
7
  DEV_PORT_ENV_VAR,
8
8
  ERROR_OVERLAY_ENV_VAR,
@@ -139,27 +139,27 @@ function newFileHelp(spec) {
139
139
 
140
140
  // cli/program.ts
141
141
  var blobUploadCommand = lazy(() => import("./cli-FWFRKQNE.js"), "blobUploadCommand");
142
- var buildCommand = lazy(() => import("./cli-PQBXVLEU.js"), "buildCommand");
143
- var buildEngineCommand = lazy(() => import("./cli-O5KP4OVN.js"), "buildEngineCommand");
142
+ var buildCommand = lazy(() => import("./cli-6SGCYEEC.js"), "buildCommand");
143
+ var buildEngineCommand = lazy(() => import("./cli-72XDEFU3.js"), "buildEngineCommand");
144
144
  var configGetCommand = lazy(() => import("./cli-VL2P354N.js"), "configGetCommand");
145
145
  var configPathCommand = lazy(() => import("./cli-VL2P354N.js"), "configPathCommand");
146
146
  var configSetCommand = lazy(() => import("./cli-VL2P354N.js"), "configSetCommand");
147
- var configureCommand = lazy(() => import("./cli-GDQ6ILJY.js"), "configureCommand");
148
- var deleteCommand = lazy(() => import("./cli-GXD36NF2.js"), "deleteCommand");
149
- var devCommand = lazy(() => import("./cli-FBTRTIZJ.js"), "devCommand");
147
+ var configureCommand = lazy(() => import("./cli-ILFDANBR.js"), "configureCommand");
148
+ var deleteCommand = lazy(() => import("./cli-45OCBG53.js"), "deleteCommand");
149
+ var devCommand = lazy(() => import("./cli-O5ABH2WK.js"), "devCommand");
150
150
  var devStatusCommand = lazy(() => import("./cli-C47GJATR.js"), "devStatusCommand");
151
151
  var devStopCommand = lazy(() => import("./cli-C47GJATR.js"), "devStopCommand");
152
152
  var docsCommand = lazy(() => import("./cli-TIDQ4WUE.js"), "docsCommand");
153
153
  var docsExportCommand = lazy(() => import("./cli-MYJGMA6U.js"), "docsExportCommand");
154
154
  var endpointAuditCommand = lazy(
155
- () => import("./cli-PTT5RGKO.js"),
155
+ () => import("./cli-R2MUZQE2.js"),
156
156
  "endpointAuditCommand"
157
157
  );
158
- var endpointCallCommand = lazy(() => import("./cli-S5QDONIQ.js"), "endpointCallCommand");
159
- var endpointListCommand = lazy(() => import("./cli-IDKYF5XB.js"), "endpointListCommand");
160
- var generateCommand = lazy(() => import("./cli-GBFM76BF.js"), "generateCommand");
161
- var initCommand = lazy(() => import("./cli-ZWPYIXNI.js"), "initCommand");
162
- var newCommand = lazy(() => import("./cli-C3NVCKO6.js"), "newCommand");
158
+ var endpointCallCommand = lazy(() => import("./cli-IDVUHGKG.js"), "endpointCallCommand");
159
+ var endpointListCommand = lazy(() => import("./cli-ZBN5KAIB.js"), "endpointListCommand");
160
+ var generateCommand = lazy(() => import("./cli-UMEBPAZQ.js"), "generateCommand");
161
+ var initCommand = lazy(() => import("./cli-JVI24FI6.js"), "initCommand");
162
+ var newCommand = lazy(() => import("./cli-BUQI5UU4.js"), "newCommand");
163
163
  var packageBundleCommand = lazy(
164
164
  () => import("./cli-MJUYJIEP.js"),
165
165
  "packageBundleCommand"
@@ -172,32 +172,32 @@ var packageVersionCommand = lazy(
172
172
  () => import("./cli-QVASWX2A.js"),
173
173
  "packageVersionCommand"
174
174
  );
175
- var patchCommand = lazy(() => import("./cli-2GOFEW26.js"), "patchCommand");
176
- var resolveCommand = lazy(() => import("./cli-3E3MD5U4.js"), "resolveCommand");
177
- var screenshotCommand = lazy(() => import("./cli-I355WTAF.js"), "screenshotCommand");
178
- var clockAdvanceCommand = lazy(() => import("./cli-QUIJCBYB.js"), "clockAdvanceCommand");
179
- var faultCommand = lazy(() => import("./cli-QUIJCBYB.js"), "faultCommand");
180
- var localeCommand = lazy(() => import("./cli-QUIJCBYB.js"), "localeCommand");
181
- var participantAddCommand = lazy(() => import("./cli-QUIJCBYB.js"), "participantAddCommand");
182
- var participantMoveCommand = lazy(() => import("./cli-QUIJCBYB.js"), "participantMoveCommand");
175
+ var patchCommand = lazy(() => import("./cli-RLEGRWFM.js"), "patchCommand");
176
+ var resolveCommand = lazy(() => import("./cli-5ACDPCXI.js"), "resolveCommand");
177
+ var screenshotCommand = lazy(() => import("./cli-7A6MKCUJ.js"), "screenshotCommand");
178
+ var clockAdvanceCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "clockAdvanceCommand");
179
+ var faultCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "faultCommand");
180
+ var localeCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "localeCommand");
181
+ var participantAddCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "participantAddCommand");
182
+ var participantMoveCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "participantMoveCommand");
183
183
  var participantRenameCommand = lazy(
184
- () => import("./cli-QUIJCBYB.js"),
184
+ () => import("./cli-6VNKQ3OX.js"),
185
185
  "participantRenameCommand"
186
186
  );
187
- var playCommand = lazy(() => import("./cli-QUIJCBYB.js"), "playCommand");
188
- var reconfigureCommand = lazy(() => import("./cli-QUIJCBYB.js"), "reconfigureCommand");
189
- var resetCommand = lazy(() => import("./cli-QUIJCBYB.js"), "resetCommand");
190
- var scenarioCommand = lazy(() => import("./cli-QUIJCBYB.js"), "scenarioCommand");
191
- var teamAddCommand = lazy(() => import("./cli-QUIJCBYB.js"), "teamAddCommand");
192
- var teamRemoveCommand = lazy(() => import("./cli-QUIJCBYB.js"), "teamRemoveCommand");
193
- var teamRenameCommand = lazy(() => import("./cli-QUIJCBYB.js"), "teamRenameCommand");
194
- var timerCommand = lazy(() => import("./cli-QUIJCBYB.js"), "timerCommand");
195
- var undoCommand = lazy(() => import("./cli-QUIJCBYB.js"), "undoCommand");
196
- var waitingRoomCommand = lazy(() => import("./cli-QUIJCBYB.js"), "waitingRoomCommand");
197
- var tickCommand = lazy(() => import("./cli-U2UE7I7J.js"), "tickCommand");
198
- var updateCommand = lazy(() => import("./cli-QEVDDBNO.js"), "updateCommand");
187
+ var playCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "playCommand");
188
+ var reconfigureCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "reconfigureCommand");
189
+ var resetCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "resetCommand");
190
+ var scenarioCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "scenarioCommand");
191
+ var teamAddCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "teamAddCommand");
192
+ var teamRemoveCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "teamRemoveCommand");
193
+ var teamRenameCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "teamRenameCommand");
194
+ var timerCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "timerCommand");
195
+ var undoCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "undoCommand");
196
+ var waitingRoomCommand = lazy(() => import("./cli-6VNKQ3OX.js"), "waitingRoomCommand");
197
+ var tickCommand = lazy(() => import("./cli-5SM367K7.js"), "tickCommand");
198
+ var updateCommand = lazy(() => import("./cli-DOXRQ3S5.js"), "updateCommand");
199
199
  var versionCommand = lazy(() => import("./cli-HCRTYQQS.js"), "versionCommand");
200
- var viewCommand = lazy(() => import("./cli-WOGIAU2E.js"), "viewCommand");
200
+ var viewCommand = lazy(() => import("./cli-TTKICM5P.js"), "viewCommand");
201
201
  function commandPath(command) {
202
202
  const names = [];
203
203
  for (let current = command; current?.parent; current = current.parent) {
@@ -34,7 +34,7 @@ mkdir my-game && cd my-game
34
34
  pnpm dlx @seriousgaming/sdk-tools new package '{"identifier":"com.example.mygame","name":"My Game","version":"0.1.0"}'
35
35
  ```
36
36
 
37
- You get the starter game, a complete lemonade stand, with tests at every level, a `CLAUDE.md`, and `.claude/rules/`. Read `CLAUDE.md` before changing anything: it holds the rules that are expensive to get wrong. Pass `--empty` for the package files and the agent guidance alone.
37
+ You get the starter game, a complete lemonade stand, with tests at every level, a `CLAUDE.md`, and `.claude/rules/`. Read `CLAUDE.md` before changing anything. Its first line imports the SDK's guidance, the rules that are expensive to get wrong, from `node_modules/@seriousgaming/sdk-tools/dist/agent/guidance.md`, so it describes the installed version; the rest of the file is the package's own, for what this game is. Pass `--empty` for the package files and the agent guidance alone.
38
38
 
39
39
  Without a terminal, the CLI never prompts: a command that would ask fails with `PROMPT_REQUIRED` and exit code 2. Every `new` and `update` takes its definition as an argument, with `--file`, or on stdin, and `delete` takes `--yes`.
40
40
 
@@ -31,6 +31,21 @@ are in the [0.x changelog](changelog-0.x.md).
31
31
 
32
32
  ## [Unreleased]
33
33
 
34
+ ## [1.6.1] — 2026-11-02
35
+
36
+ ### Changed
37
+
38
+ - **A new package's agent guidance no longer describes the starter game as the package.** The SDK's guidance (`guidance.md`, below; until now `CLAUDE.md.template`) replaces its 'This package' section with four patterns worth keeping in any game (keyed state, a validator on shared state, awaited writes, and a deliberate team mode), citing the starter as one worked example, and its command examples use placeholders such as `/<capability>/<variable>` in place of the starter's paths. The `workflow-create-engine.md`, `workflow-create-user-interface.md` and `workflow-create-guide.md` rules read the same way for a package that has since been reskinned. Merge the rules into an existing package's `.claude/rules/`, and import the guidance as below, so an agent stops being told a reskinned game is a lemonade stand
39
+ - **A package's `CLAUDE.md` imports the SDK's agent guidance instead of copying it.** The guidance ships in `@seriousgaming/sdk-tools` at `dist/agent/guidance.md`, so it always matches the installed version and updates when you upgrade. A new package's `CLAUDE.md` (`CLAUDE.md.template`) starts with `@node_modules/@seriousgaming/sdk-tools/dist/agent/guidance.md`, then a sentence naming that path for a tool that does not follow imports, then a section of its own for describing the game. `workflow-update-sdk-version.md` says the same. An existing package can replace its copied SDK text with the import, keeping what it wrote about the game; see [Import the SDK's agent guidance](guides/upgrading.md#optional-import-the-sdks-agent-guidance-in-claudemd)
40
+
41
+ ### Fixed
42
+
43
+ - **`new <type>` keeps every field you write.** It used to drop some fields from the written bundle without an error: an endpoint's `actions` and `roster`, a capability's `lifetime`, `endpoints` and `crossTeamParticipants` on the participant interface, `endpoints` on the session interface, `crossTeamParticipants` on the waiting room, and `settings` on the guide. A generated field the build derives from the code, a validator's `gates` or an endpoint's `responds`, is now refused rather than dropped. Interactive `update engine` also keeps the engine's `uses`. On an earlier version, add a dropped field after creating the resource with `pnpm run sdk update <type> <id> --patch '[...]'`
44
+
45
+ ### Security
46
+
47
+ - **The `body-parser` advisory is cleared.** The SDK's lockfile now takes `body-parser` 2.4.0 through `express` in the dev server, as 1.5.0 said the next release would. A game's own install already resolves it
48
+
34
49
  ## [1.6.0] — 2026-11-02
35
50
 
36
51
  ### Added
@@ -146,7 +146,7 @@ pnpm test:engine
146
146
 
147
147
  ## Working with an AI coding agent
148
148
 
149
- A scaffolded package includes a `CLAUDE.md` and `.claude/rules/` written for coding agents. They cover the workflows an agent needs (creating resources, testing, publishing) and tell the agent to leave `sdk dev` for you to start. The points worth knowing:
149
+ A scaffolded package includes a `CLAUDE.md` and `.claude/rules/` written for coding agents. `CLAUDE.md` imports the SDK's guidance from the installed `@seriousgaming/sdk-tools`, so it stays current as you upgrade, and leaves the rest of the file for you to describe your game. They cover the workflows an agent needs (creating resources, testing, publishing) and tell the agent to leave `sdk dev` for you to start. The points worth knowing:
150
150
 
151
151
  - Session commands print JSON, so an agent can read state with `view` and make decisions with `tick --patch`
152
152
  - Use `pnpm run --silent` when parsing output, so pnpm's banner stays out of the JSON
@@ -199,7 +199,7 @@ These are written by `new package` for every package, starter game or not:
199
199
  | `pnpm-workspace.yaml` | Dependency overrides and install-script decisions the SDK tooling needs |
200
200
  | `.oxlintrc.json`, `.oxfmtrc.json` | Lint and format settings |
201
201
  | `README.md`, `DESIGN.md` | A readme, and prompts for writing down your game's design as you build it |
202
- | `CLAUDE.md`, `.claude/` | Guidance and permissions for an AI coding agent working in the package |
202
+ | `CLAUDE.md`, `.claude/` | Guidance and permissions for an AI coding agent. `CLAUDE.md` imports the SDK's guidance, then leaves a section to describe your game |
203
203
  | `.gitignore` | Keeps `dist/`, `node_modules/`, `.seriousgaming-sdk/`, and Playwright's `test-results/` and `playwright-report/` out of version control |
204
204
 
205
205
  Two directories appear once you use the package. `dist/` is what `sdk build` writes. `.seriousgaming-sdk/` holds the dev server's lock file (`session.json`) and the session overrides `sdk configure` writes (`configuration.json`); the session itself lives only in the dev server's memory.
@@ -634,7 +634,7 @@ Optional, but each item fixes a trap. A package created by `sdk new package` at
634
634
  - **Playwright's output stays out of git.** Merge `gitignore.template` into `.gitignore`: it ignores `test-results/` and `playwright-report/`
635
635
  - **A stray `test.only` fails CI.** `playwright.config.ts.liquid` sets `forbidOnly` when `CI` is set, so one focused test no longer skips every other test. Merge it into `playwright.config.ts` if you did not replace that file above
636
636
  - **The wrappers set `lang` and `dir`.** Delete the lines in each `main.tsx` that set them on the document
637
- - **A shorter `CLAUDE.md` and refreshed rules.** Merge in the new `CLAUDE.md.template` and `claude/rules/` if you have not customised them heavily, as `workflow-update-sdk-version.md` describes
637
+ - **A current `CLAUDE.md` and refreshed rules.** Replace the SDK's text in `CLAUDE.md` with the import described in [Optional: import the SDK's agent guidance](#optional-import-the-sdks-agent-guidance-in-claudemd), and merge in the new `claude/rules/` if you have not customised them heavily, as `workflow-update-sdk-version.md` describes
638
638
  - **Refreshed dependencies.** Merge the versions in `package.json.liquid`, and after the Playwright bump run `pnpm exec playwright install chromium --only-shell` (drop `--only-shell` if you run tests with `--headed` or `--ui`)
639
639
 
640
640
  Nothing breaks if you skip the new features 1.0 adds, but several replace workarounds games carry: the engine's private `state` and `complete: true` (see [Engine](./engine.md#keeping-memory-between-ticks) and [Game completion](./tick-controller.md#game-completion)), capabilities with `"lifetime": "session"` that undo and reset leave alone ([Lifetime](./capabilities.md#lifetime)), a facilitator's slide deck in the `presentation/` slot ([Building presentations](./presentation.md)), endpoints that act on the session or take files ([Endpoints](./endpoints.md)), and the `useAsset`, `usePastState` and `useViewerStorage` hooks ([User interfaces](./ui.md)).
@@ -667,7 +667,7 @@ pnpm run test:e2e
667
667
 
668
668
  ## After 1.0
669
669
 
670
- A minor release that changes a public type a test may build by hand lists it here as well as in the [changelog](../changelog.md).
670
+ A minor release that changes a public type a test may build by hand lists it here as well as in the [changelog](../changelog.md), and so does an optional step that keeps an older package's scaffold current.
671
671
 
672
672
  ### 1.2: give `Brand.icon` a variant for each background
673
673
 
@@ -684,6 +684,23 @@ renderUserInterface(<App />, { callbacks: { requestTick } });
684
684
 
685
685
  These types are outside semantic versioning from 1.3, so the helpers are the way to keep up with later additions too. See [What a minor release may change](./testing.md#what-a-minor-release-may-change).
686
686
 
687
+ ### Optional: import the SDK's agent guidance in `CLAUDE.md`
688
+
689
+ A new package's `CLAUDE.md` no longer holds a copy of the SDK's guidance. Its first line imports the copy that ships with `@seriousgaming/sdk-tools`, so the guidance always matches the installed version, and the rest of the file is the package's own. An older package keeps the copy it was scaffolded with, which goes stale with every upgrade and, in a package that began as the starter game, describes the lemonade stand after a reskin.
690
+
691
+ Nothing breaks if you skip this. To adopt it:
692
+
693
+ 1. Replace the SDK's text in `CLAUDE.md` (everything copied from the old template) with the first three lines of `node_modules/@seriousgaming/sdk-tools/dist/templates/package/CLAUDE.md.template`. The first is the import:
694
+
695
+ ```
696
+ @node_modules/@seriousgaming/sdk-tools/dist/agent/guidance.md
697
+ ```
698
+
699
+ 2. Keep anything you wrote about the game itself below them, under a heading of its own
700
+ 3. Leave `.claude/rules/` as it is: the rules are still copied into the package and merged by hand, as `workflow-update-sdk-version.md` describes
701
+
702
+ There is no command that refreshes the file: from here on, upgrading the SDK updates the guidance.
703
+
687
704
  ## Before you publish
688
705
 
689
706
  A 1.0 build is a manifest version 3 package, and the platform must accept version 3 before you publish one. Until it does, the platform refuses the upload, and a version 2 package you published from 0.6 keeps running as it is. Check with Business Simulations that the platform you publish to accepts version 3 packages, and keep publishing from 0.6 until it does.
@@ -21,7 +21,7 @@ This index lists pages; `--outline` lists a page's sections, each with its slug
21
21
  ## Start here and reference
22
22
 
23
23
  - [`index.md`](index.md), about 6k characters: The Serious Gaming SDK is for building serious games: facilitated learning experiences, such as business simulations and experiential learning, in which teams make decisions and see the consequences.
24
- - [`ai-agents.md`](ai-agents.md), about 5k characters: An AI coding agent can build, check, and play a serious game with this SDK from the terminal alone, with no browser and no prompt to answer.
24
+ - [`ai-agents.md`](ai-agents.md), about 6k characters: An AI coding agent can build, check, and play a serious game with this SDK from the terminal alone, with no browser and no prompt to answer.
25
25
  - [`changelog-0.x.md`](changelog-0.x.md): Every release before 1.0, from 0.0.1 to 0.6.0, kept as history.
26
26
  - [`changelog.md`](changelog.md): All notable changes to the Serious Gaming SDK are recorded here.
27
27
  - [`cli-and-dev-server.md`](cli-and-dev-server.md), about 15k characters: The dev server runs your game on your own machine, with every screen in the browser, and the CLI plays and inspects the same session from the terminal.
@@ -76,7 +76,7 @@ This index lists pages; `--outline` lists a page's sections, each with its slug
76
76
  - [`guides/ui-styling.md`](guides/ui-styling.md), about 11k characters: How a game UI handles language, theme, and screen size, and how to customise the Vite build that serves and bundles it.
77
77
  - [`guides/ui-ticks.md`](guides/ui-ticks.md), about 15k characters: How a game UI ends a round and shows the time left: requesting a tick, awaiting a write or tick and handling a `MutationError`, and driving a countdown from the tick timer.
78
78
  - [`guides/ui.md`](guides/ui.md), about 17k characters: The game UI is what each participant sees and plays: where they read the situation, make decisions, and see what those decisions caused.
79
- - [`guides/upgrading.md`](guides/upgrading.md), about 66k characters: This guide takes a game package on 0.6 to 1.0, in 13 steps.
79
+ - [`guides/upgrading.md`](guides/upgrading.md), about 67k characters: This guide takes a game package on 0.6 to 1.0, in 13 steps.
80
80
  - [`guides/validators.md`](guides/validators.md), about 23k characters: A validator is a read-only gate on what a participant does: a context write before it is applied, and a request for the next tick before it runs.
81
81
  - [`guides/waiting-room.md`](guides/waiting-room.md), about 14k characters: The waiting room is the holding screen participants see while a session is parked, and you can replace the host's stock panel with your own.
82
82