@cbnventures/nova 0.35.0 → 0.37.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 (147) hide show
  1. package/bin/nova.mjs +17 -0
  2. package/build/package.json +3 -2
  3. package/build/scaffold-versions.json +54 -44
  4. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts +2 -2
  5. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts.map +1 -1
  6. package/build/src/cli/generate/github/workflows-blueprint-validate.js +116 -3
  7. package/build/src/cli/generate/github/workflows-blueprint-validate.js.map +1 -1
  8. package/build/src/cli/generate/github/workflows-blueprint.d.ts +11 -5
  9. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  10. package/build/src/cli/generate/github/workflows-blueprint.js +411 -35
  11. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  12. package/build/src/cli/generate/must-haves/agent-conventions.d.ts.map +1 -1
  13. package/build/src/cli/generate/must-haves/agent-conventions.js +3 -0
  14. package/build/src/cli/generate/must-haves/agent-conventions.js.map +1 -1
  15. package/build/src/cli/generate/must-haves/dotenv.d.ts.map +1 -1
  16. package/build/src/cli/generate/must-haves/dotenv.js +1 -0
  17. package/build/src/cli/generate/must-haves/dotenv.js.map +1 -1
  18. package/build/src/cli/scaffold/app/astro.d.ts.map +1 -1
  19. package/build/src/cli/scaffold/app/astro.js +0 -1
  20. package/build/src/cli/scaffold/app/astro.js.map +1 -1
  21. package/build/src/cli/scaffold/app/vite.d.ts.map +1 -1
  22. package/build/src/cli/scaffold/app/vite.js +0 -1
  23. package/build/src/cli/scaffold/app/vite.js.map +1 -1
  24. package/build/src/cli/scaffold/docs/docusaurus.d.ts.map +1 -1
  25. package/build/src/cli/scaffold/docs/docusaurus.js +0 -1
  26. package/build/src/cli/scaffold/docs/docusaurus.js.map +1 -1
  27. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  28. package/build/src/cli/utility/changelog.js +119 -67
  29. package/build/src/cli/utility/changelog.js.map +1 -1
  30. package/build/src/cli/utility/configure.d.ts.map +1 -1
  31. package/build/src/cli/utility/configure.js +126 -1
  32. package/build/src/cli/utility/configure.js.map +1 -1
  33. package/build/src/lib/corepack.d.ts +2 -2
  34. package/build/src/lib/corepack.d.ts.map +1 -1
  35. package/build/src/lib/corepack.js +16 -6
  36. package/build/src/lib/corepack.js.map +1 -1
  37. package/build/src/lib/docker-packaging.d.ts.map +1 -1
  38. package/build/src/lib/docker-packaging.js +15 -12
  39. package/build/src/lib/docker-packaging.js.map +1 -1
  40. package/build/src/lib/dotenv.d.ts.map +1 -1
  41. package/build/src/lib/dotenv.js +17 -8
  42. package/build/src/lib/dotenv.js.map +1 -1
  43. package/build/src/lib/env-managed-set.d.ts.map +1 -1
  44. package/build/src/lib/env-managed-set.js +55 -11
  45. package/build/src/lib/env-managed-set.js.map +1 -1
  46. package/build/src/lib/env-namespace.d.ts.map +1 -1
  47. package/build/src/lib/env-namespace.js +1 -0
  48. package/build/src/lib/env-namespace.js.map +1 -1
  49. package/build/src/lib/env-profiles.d.ts +3 -0
  50. package/build/src/lib/env-profiles.d.ts.map +1 -0
  51. package/build/src/lib/env-profiles.js +70 -0
  52. package/build/src/lib/env-profiles.js.map +1 -0
  53. package/build/src/lib/env-status.d.ts.map +1 -1
  54. package/build/src/lib/env-status.js +23 -2
  55. package/build/src/lib/env-status.js.map +1 -1
  56. package/build/src/lib/item.d.ts.map +1 -1
  57. package/build/src/lib/item.js +20 -3
  58. package/build/src/lib/item.js.map +1 -1
  59. package/build/src/lib/nova-config.d.ts.map +1 -1
  60. package/build/src/lib/nova-config.js +31 -0
  61. package/build/src/lib/nova-config.js.map +1 -1
  62. package/build/src/lib/regex.d.ts +7 -1
  63. package/build/src/lib/regex.d.ts.map +1 -1
  64. package/build/src/lib/regex.js +7 -1
  65. package/build/src/lib/regex.js.map +1 -1
  66. package/build/src/lib/run-scripts.d.ts.map +1 -1
  67. package/build/src/lib/run-scripts.js +24 -0
  68. package/build/src/lib/run-scripts.js.map +1 -1
  69. package/build/src/lib/scaffold.d.ts.map +1 -1
  70. package/build/src/lib/scaffold.js +7 -0
  71. package/build/src/lib/scaffold.js.map +1 -1
  72. package/build/src/lib/workflow-templates.js +4 -4
  73. package/build/src/lib/workflow-templates.js.map +1 -1
  74. package/build/src/types/cli/generate/github/workflows-blueprint-validate.d.ts +42 -4
  75. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +193 -17
  76. package/build/src/types/cli/utility/changelog.d.ts +49 -6
  77. package/build/src/types/cli/utility/configure.d.ts +52 -0
  78. package/build/src/types/lib/corepack.d.ts +13 -0
  79. package/build/src/types/lib/docker-packaging.d.ts +2 -0
  80. package/build/src/types/lib/dotenv.d.ts +10 -3
  81. package/build/src/types/lib/env-managed-set.d.ts +15 -0
  82. package/build/src/types/lib/env-namespace.d.ts +5 -0
  83. package/build/src/types/lib/env-profiles.d.ts +67 -0
  84. package/build/src/types/lib/env-status.d.ts +9 -0
  85. package/build/src/types/lib/item.d.ts +20 -3
  86. package/build/src/types/lib/nova-config.d.ts +14 -0
  87. package/build/src/types/lib/regex.d.ts +0 -2
  88. package/build/src/types/lib/run-scripts.d.ts +16 -0
  89. package/build/src/types/lib/scaffold.d.ts +8 -0
  90. package/build/src/types/shared.d.ts +47 -6
  91. package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +20 -0
  92. package/build/src/types/tests/cli/generate/github/workflows-blueprint-validate.test.d.ts +22 -0
  93. package/build/src/types/tests/cli/generate/github/workflows-blueprint.test.d.ts +16 -0
  94. package/build/src/types/tests/cli/generate/must-haves/agent-conventions.test.d.ts +40 -0
  95. package/build/src/types/tests/cli/utility/changelog.test.d.ts +48 -45
  96. package/build/src/types/tests/cli/utility/configure.test.d.ts +1 -0
  97. package/build/src/types/tests/cli/utility/run-scripts.test.d.ts +29 -0
  98. package/build/src/types/tests/lib/docker-packaging.test.d.ts +14 -0
  99. package/build/src/types/tests/lib/env-profiles.test.d.ts +20 -0
  100. package/build/templates/generators/must-haves/agent-conventions/AGENTS.md +8 -5
  101. package/build/templates/generators/must-haves/agent-conventions/CLAUDE.md +8 -5
  102. package/build/templates/generators/must-haves/agent-conventions/conventions/csharp.md +6 -6
  103. package/build/templates/generators/must-haves/agent-conventions/conventions/go.md +241 -0
  104. package/build/templates/generators/must-haves/agent-conventions/conventions/nova.md +155 -0
  105. package/build/templates/generators/must-haves/agent-conventions/conventions/python.md +7 -7
  106. package/build/templates/generators/must-haves/agent-conventions/conventions/rust.md +227 -0
  107. package/build/templates/generators/must-haves/agent-conventions/conventions/swift.md +9 -9
  108. package/build/templates/generators/must-haves/agent-conventions/conventions/typescript.md +145 -23
  109. package/build/templates/generators/must-haves/agent-conventions/conventions/universal.md +112 -103
  110. package/build/templates/generators/must-haves/ignore-files/gitignore +1 -0
  111. package/build/templates/scaffold/app/android/package.json +1 -1
  112. package/build/templates/scaffold/app/apple/Sources/App.swift +15 -2
  113. package/build/templates/scaffold/app/apple/Tests/AppTests.swift +14 -2
  114. package/build/templates/scaffold/app/apple/package.json +1 -1
  115. package/build/templates/scaffold/app/apple/project.yml +1 -0
  116. package/build/templates/scaffold/app/astro/package.json +1 -1
  117. package/build/templates/scaffold/app/discord-bot/package.json +1 -1
  118. package/build/templates/scaffold/app/express/package.json +1 -1
  119. package/build/templates/scaffold/app/nextjs/package.json +1 -1
  120. package/build/templates/scaffold/app/vite/package.json +2 -2
  121. package/build/templates/scaffold/app/vite/vite.config.mts +3 -0
  122. package/build/templates/scaffold/docs/docusaurus/package.json +4 -4
  123. package/build/templates/scaffold/docs/docusaurus/static/images/nova.svg +13 -5
  124. package/build/templates/scaffold/docs/docusaurus/vitest.config.mts +9 -0
  125. package/build/templates/scaffold/package/github-action/package.json +1 -1
  126. package/build/templates/scaffold/package/homebridge/package.json +1 -1
  127. package/build/templates/scaffold/package/pfsense/package.json +1 -1
  128. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc +10 -0
  129. package/build/templates/scaffold/package/pfsense-root/.github/workflows/pfsense-[__WORKSPACE_NAME__].yml +62 -0
  130. package/build/templates/scaffold-options/app/android-native/.gitattributes +2 -0
  131. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/MainActivity.kt +16 -2
  132. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/NavigationKeys.kt +7 -1
  133. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/data/DataRepository.kt +28 -4
  134. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Color.kt +40 -6
  135. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Theme.kt +22 -1
  136. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Type.kt +8 -2
  137. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModel.kt +42 -6
  138. package/build/templates/scaffold-options/app/android-native/app/src/test/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModelTest.kt +31 -4
  139. package/build/templates/scaffold-options/app/android-native/gradle/wrapper/gradle-wrapper.jar +0 -0
  140. package/build/templates/scaffold-options/app/android-native/gradlew +189 -113
  141. package/build/templates/scaffold-options/app/android-native/gradlew.bat +79 -51
  142. package/build/templates/scaffold-options/app/astro/cloudflare/public/.assetsignore +15 -0
  143. package/build/templates/scaffold-options/app/web-launchpad/public/favicon.svg +13 -5
  144. package/build/templates/scaffold-options/docker-image/common/dockerignore +2 -0
  145. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/package.json +1 -1
  146. package/build/templates/scaffold-options/tool/serverless/vercel-functions/package.json +1 -1
  147. package/package.json +3 -2
package/bin/nova.mjs CHANGED
@@ -7,7 +7,24 @@ import {
7
7
  pathToFileURL,
8
8
  } from 'node:url';
9
9
 
10
+ /**
11
+ * Nova - Root.
12
+ *
13
+ * Stores this module-level value in one named location.
14
+ * Related code reuses it instead of duplicating the definition.
15
+ *
16
+ * @since 0.36.0
17
+ */
10
18
  const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
19
+
20
+ /**
21
+ * Nova - CLI.
22
+ *
23
+ * Stores this module-level value in one named location.
24
+ * Related code reuses it instead of duplicating the definition.
25
+ *
26
+ * @since 0.36.0
27
+ */
11
28
  const cli = resolve(root, 'build', 'src', 'cli', 'index.js');
12
29
 
13
30
  if (existsSync(cli) === false) {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cbnventures/nova",
3
- "version": "0.35.0",
3
+ "version": "0.37.0",
4
4
  "description": "Scripts, templates, and project configuration for the common JavaScript and TypeScript developer",
5
5
  "keywords": [
6
6
  "eslint",
@@ -107,7 +107,7 @@
107
107
  "clean:build": "shx rm -rf ./build"
108
108
  },
109
109
  "engines": {
110
- "node": "^22 || ^24"
110
+ "node": "^22 || ^24 || ^26"
111
111
  },
112
112
  "dependencies": {
113
113
  "@eslint/js": "9.39.3",
@@ -118,6 +118,7 @@
118
118
  "astro-eslint-parser": "1.4.0",
119
119
  "chalk": "5.6.2",
120
120
  "commander": "14.0.3",
121
+ "corepack": "0.36.0",
121
122
  "eslint-mdx": "3.8.1",
122
123
  "eslint-plugin-astro": "1.7.0",
123
124
  "eslint-plugin-import": "2.32.0",
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "entries": {
4
4
  "nodeEngine": {
5
- "value": "^22 || ^24",
5
+ "value": "^22 || ^24 || ^26",
6
6
  "placeholder": "[__SCAFFOLD_VERSION_NODE_ENGINE__]",
7
7
  "group": "javascript",
8
8
  "source": {
@@ -11,7 +11,7 @@
11
11
  }
12
12
  },
13
13
  "nodeEnginePfsense": {
14
- "value": ">=22.3 <23 || ^24",
14
+ "value": ">=22.3 <23 || ^24 || ^26",
15
15
  "placeholder": "[__SCAFFOLD_VERSION_NODE_ENGINE_PFSENSE__]",
16
16
  "group": "pfsense",
17
17
  "source": {
@@ -19,8 +19,18 @@
19
19
  "reason": "The pfSense tooling baseline preserves its tested Node 22.3 minimum."
20
20
  }
21
21
  },
22
+ "corepack": {
23
+ "value": "0.36.0",
24
+ "placeholder": "[__SCAFFOLD_VERSION_COREPACK__]",
25
+ "group": "javascript",
26
+ "source": {
27
+ "type": "npm",
28
+ "package": "corepack",
29
+ "strategy": "same-major"
30
+ }
31
+ },
22
32
  "npmPackageManager": {
23
- "value": "npm@11.18.0",
33
+ "value": "npm@11.21.1",
24
34
  "placeholder": "[__SCAFFOLD_VERSION_NPM_PACKAGE_MANAGER__]",
25
35
  "group": "javascript",
26
36
  "source": {
@@ -31,7 +41,7 @@
31
41
  }
32
42
  },
33
43
  "typesNode24": {
34
- "value": "24.9.1",
44
+ "value": "24.19.2",
35
45
  "placeholder": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
36
46
  "group": "javascript",
37
47
  "source": {
@@ -41,7 +51,7 @@
41
51
  }
42
52
  },
43
53
  "typesNode22": {
44
- "value": "22.15.17",
54
+ "value": "22.20.5",
45
55
  "placeholder": "[__SCAFFOLD_VERSION_TYPES_NODE_22__]",
46
56
  "group": "javascript",
47
57
  "source": {
@@ -91,7 +101,7 @@
91
101
  }
92
102
  },
93
103
  "vitest": {
94
- "value": "4.1.11",
104
+ "value": "4.1.12",
95
105
  "placeholder": "[__SCAFFOLD_VERSION_VITEST__]",
96
106
  "group": "javascript",
97
107
  "source": {
@@ -111,7 +121,7 @@
111
121
  }
112
122
  },
113
123
  "tsxExpress": {
114
- "value": "4.19.4",
124
+ "value": "4.23.15",
115
125
  "placeholder": "[__SCAFFOLD_VERSION_TSX_EXPRESS__]",
116
126
  "group": "express",
117
127
  "source": {
@@ -121,7 +131,7 @@
121
131
  }
122
132
  },
123
133
  "astro": {
124
- "value": "7.3.5",
134
+ "value": "7.4.4",
125
135
  "placeholder": "[__SCAFFOLD_VERSION_ASTRO__]",
126
136
  "group": "astro",
127
137
  "source": {
@@ -131,7 +141,7 @@
131
141
  }
132
142
  },
133
143
  "astroCheck": {
134
- "value": "0.9.10",
144
+ "value": "0.9.12",
135
145
  "placeholder": "[__SCAFFOLD_VERSION_ASTRO_CHECK__]",
136
146
  "group": "astro",
137
147
  "source": {
@@ -141,7 +151,7 @@
141
151
  }
142
152
  },
143
153
  "astroNode": {
144
- "value": "11.1.7",
154
+ "value": "11.1.9",
145
155
  "placeholder": "[__SCAFFOLD_VERSION_ASTRO_NODE__]",
146
156
  "group": "astro",
147
157
  "source": {
@@ -151,7 +161,7 @@
151
161
  }
152
162
  },
153
163
  "astroCloudflare": {
154
- "value": "14.3.4",
164
+ "value": "14.4.3",
155
165
  "placeholder": "[__SCAFFOLD_VERSION_ASTRO_CLOUDFLARE__]",
156
166
  "group": "cloudflare",
157
167
  "source": {
@@ -171,7 +181,7 @@
171
181
  }
172
182
  },
173
183
  "cloudflareWorkersTypes": {
174
- "value": "5.20261015.1",
184
+ "value": "5.20261030.1",
175
185
  "placeholder": "[__SCAFFOLD_VERSION_CLOUDFLARE_WORKERS_TYPES__]",
176
186
  "group": "cloudflare",
177
187
  "source": {
@@ -181,7 +191,7 @@
181
191
  }
182
192
  },
183
193
  "wrangler": {
184
- "value": "4.151.0",
194
+ "value": "4.156.0",
185
195
  "placeholder": "[__SCAFFOLD_VERSION_WRANGLER__]",
186
196
  "group": "cloudflare",
187
197
  "source": {
@@ -191,7 +201,7 @@
191
201
  }
192
202
  },
193
203
  "vercel": {
194
- "value": "64.4.0",
204
+ "value": "64.7.0",
195
205
  "placeholder": "[__SCAFFOLD_VERSION_VERCEL__]",
196
206
  "group": "serverless-tool",
197
207
  "source": {
@@ -201,7 +211,7 @@
201
211
  }
202
212
  },
203
213
  "cloudflareCompatibilityDate": {
204
- "value": "2026-10-14",
214
+ "value": "2026-10-30",
205
215
  "placeholder": "[__SCAFFOLD_VERSION_CLOUDFLARE_COMPATIBILITY_DATE__]",
206
216
  "group": "cloudflare",
207
217
  "source": {
@@ -210,7 +220,7 @@
210
220
  }
211
221
  },
212
222
  "discordJs": {
213
- "value": "14.27.0",
223
+ "value": "14.28.0",
214
224
  "placeholder": "[__SCAFFOLD_VERSION_DISCORD_JS__]",
215
225
  "group": "discord",
216
226
  "source": {
@@ -220,7 +230,7 @@
220
230
  }
221
231
  },
222
232
  "express": {
223
- "value": "5.1.0",
233
+ "value": "5.3.0",
224
234
  "placeholder": "[__SCAFFOLD_VERSION_EXPRESS__]",
225
235
  "group": "express",
226
236
  "source": {
@@ -230,7 +240,7 @@
230
240
  }
231
241
  },
232
242
  "typesExpress": {
233
- "value": "5.0.2",
243
+ "value": "5.0.6",
234
244
  "placeholder": "[__SCAFFOLD_VERSION_TYPES_EXPRESS__]",
235
245
  "group": "express",
236
246
  "source": {
@@ -240,7 +250,7 @@
240
250
  }
241
251
  },
242
252
  "next": {
243
- "value": "16.3.4",
253
+ "value": "16.4.3",
244
254
  "placeholder": "[__SCAFFOLD_VERSION_NEXT__]",
245
255
  "group": "nextjs",
246
256
  "source": {
@@ -250,7 +260,7 @@
250
260
  }
251
261
  },
252
262
  "react": {
253
- "value": "19.2.8",
263
+ "value": "19.3.1",
254
264
  "placeholder": "[__SCAFFOLD_VERSION_REACT__]",
255
265
  "group": "react",
256
266
  "source": {
@@ -260,7 +270,7 @@
260
270
  }
261
271
  },
262
272
  "reactDom": {
263
- "value": "19.2.8",
273
+ "value": "19.3.1",
264
274
  "placeholder": "[__SCAFFOLD_VERSION_REACT_DOM__]",
265
275
  "group": "react",
266
276
  "source": {
@@ -270,7 +280,7 @@
270
280
  }
271
281
  },
272
282
  "typesReact": {
273
- "value": "19.2.18",
283
+ "value": "19.3.0",
274
284
  "placeholder": "[__SCAFFOLD_VERSION_TYPES_REACT__]",
275
285
  "group": "react",
276
286
  "source": {
@@ -280,7 +290,7 @@
280
290
  }
281
291
  },
282
292
  "typesReactDom": {
283
- "value": "19.2.7",
293
+ "value": "19.3.0",
284
294
  "placeholder": "[__SCAFFOLD_VERSION_TYPES_REACT_DOM__]",
285
295
  "group": "react",
286
296
  "source": {
@@ -290,7 +300,7 @@
290
300
  }
291
301
  },
292
302
  "typesReactDomDocusaurus": {
293
- "value": "19.2.4",
303
+ "value": "19.3.0",
294
304
  "placeholder": "[__SCAFFOLD_VERSION_TYPES_REACT_DOM_DOCUSAURUS__]",
295
305
  "group": "docusaurus",
296
306
  "source": {
@@ -300,7 +310,7 @@
300
310
  }
301
311
  },
302
312
  "vite": {
303
- "value": "6.4.3",
313
+ "value": "6.4.5",
304
314
  "placeholder": "[__SCAFFOLD_VERSION_VITE__]",
305
315
  "group": "vite",
306
316
  "source": {
@@ -320,7 +330,7 @@
320
330
  }
321
331
  },
322
332
  "vue": {
323
- "value": "3.5.43",
333
+ "value": "3.5.44",
324
334
  "placeholder": "[__SCAFFOLD_VERSION_VUE__]",
325
335
  "group": "vite",
326
336
  "source": {
@@ -330,7 +340,7 @@
330
340
  }
331
341
  },
332
342
  "viteVuePlugin": {
333
- "value": "6.0.9",
343
+ "value": "6.0.10",
334
344
  "placeholder": "[__SCAFFOLD_VERSION_VITE_VUE_PLUGIN__]",
335
345
  "group": "vite",
336
346
  "source": {
@@ -340,7 +350,7 @@
340
350
  }
341
351
  },
342
352
  "svelte": {
343
- "value": "5.57.2",
353
+ "value": "5.57.3",
344
354
  "placeholder": "[__SCAFFOLD_VERSION_SVELTE__]",
345
355
  "group": "vite",
346
356
  "source": {
@@ -470,7 +480,7 @@
470
480
  }
471
481
  },
472
482
  "workflowActionSetupNode": {
473
- "value": "actions/setup-node@v6",
483
+ "value": "actions/setup-node@v7",
474
484
  "placeholder": "[__SCAFFOLD_VERSION_WORKFLOW_ACTION_SETUP_NODE__]",
475
485
  "group": "github-workflow",
476
486
  "source": {
@@ -520,7 +530,7 @@
520
530
  }
521
531
  },
522
532
  "workflowActionDockerSetupBuildx": {
523
- "value": "docker/setup-buildx-action@v3",
533
+ "value": "docker/setup-buildx-action@v4",
524
534
  "placeholder": "[__SCAFFOLD_VERSION_WORKFLOW_ACTION_DOCKER_SETUP_BUILDX__]",
525
535
  "group": "github-workflow",
526
536
  "source": {
@@ -530,7 +540,7 @@
530
540
  }
531
541
  },
532
542
  "workflowActionDockerSetupQemu": {
533
- "value": "docker/setup-qemu-action@v3",
543
+ "value": "docker/setup-qemu-action@v4",
534
544
  "placeholder": "[__SCAFFOLD_VERSION_WORKFLOW_ACTION_DOCKER_SETUP_QEMU__]",
535
545
  "group": "github-workflow",
536
546
  "source": {
@@ -618,7 +628,7 @@
618
628
  }
619
629
  },
620
630
  "dockerNode": {
621
- "value": "24.22.0-trixie-slim",
631
+ "value": "24.22.2-trixie-slim",
622
632
  "placeholder": "[__SCAFFOLD_VERSION_DOCKER_NODE__]",
623
633
  "group": "docker",
624
634
  "source": {
@@ -629,7 +639,7 @@
629
639
  }
630
640
  },
631
641
  "dockerDebian": {
632
- "value": "trixie-20261005-slim",
642
+ "value": "trixie-20261027-slim",
633
643
  "placeholder": "[__SCAFFOLD_VERSION_DOCKER_DEBIAN__]",
634
644
  "group": "docker",
635
645
  "source": {
@@ -649,7 +659,7 @@
649
659
  }
650
660
  },
651
661
  "androidGradlePlugin": {
652
- "value": "9.0.1",
662
+ "value": "9.5.0",
653
663
  "placeholder": "[__SCAFFOLD_VERSION_ANDROID_GRADLE_PLUGIN__]",
654
664
  "group": "android",
655
665
  "source": {
@@ -659,7 +669,7 @@
659
669
  }
660
670
  },
661
671
  "androidxCore": {
662
- "value": "1.18.0",
672
+ "value": "1.19.1",
663
673
  "placeholder": "[__SCAFFOLD_VERSION_ANDROIDX_CORE__]",
664
674
  "group": "android",
665
675
  "source": {
@@ -669,7 +679,7 @@
669
679
  }
670
680
  },
671
681
  "androidxLifecycle": {
672
- "value": "2.10.0",
682
+ "value": "2.11.0",
673
683
  "placeholder": "[__SCAFFOLD_VERSION_ANDROIDX_LIFECYCLE__]",
674
684
  "group": "android",
675
685
  "source": {
@@ -689,7 +699,7 @@
689
699
  }
690
700
  },
691
701
  "androidxComposeBom": {
692
- "value": "2026.03.01",
702
+ "value": "2026.09.00",
693
703
  "placeholder": "[__SCAFFOLD_VERSION_ANDROIDX_COMPOSE_BOM__]",
694
704
  "group": "android",
695
705
  "source": {
@@ -699,7 +709,7 @@
699
709
  }
700
710
  },
701
711
  "kotlinCoroutines": {
702
- "value": "1.10.2",
712
+ "value": "1.11.0",
703
713
  "placeholder": "[__SCAFFOLD_VERSION_KOTLIN_COROUTINES__]",
704
714
  "group": "android",
705
715
  "source": {
@@ -719,7 +729,7 @@
719
729
  }
720
730
  },
721
731
  "kotlin": {
722
- "value": "2.3.20",
732
+ "value": "2.4.21",
723
733
  "placeholder": "[__SCAFFOLD_VERSION_KOTLIN__]",
724
734
  "group": "android",
725
735
  "source": {
@@ -729,7 +739,7 @@
729
739
  }
730
740
  },
731
741
  "androidxNavigation3": {
732
- "value": "1.0.1",
742
+ "value": "1.2.0",
733
743
  "placeholder": "[__SCAFFOLD_VERSION_ANDROIDX_NAVIGATION_3__]",
734
744
  "group": "android",
735
745
  "source": {
@@ -739,7 +749,7 @@
739
749
  }
740
750
  },
741
751
  "androidxLifecycleNavigation3": {
742
- "value": "2.10.0",
752
+ "value": "2.11.0",
743
753
  "placeholder": "[__SCAFFOLD_VERSION_ANDROIDX_LIFECYCLE_NAVIGATION_3__]",
744
754
  "group": "android",
745
755
  "source": {
@@ -759,7 +769,7 @@
759
769
  }
760
770
  },
761
771
  "gradle": {
762
- "value": "9.1.0",
772
+ "value": "9.8.2",
763
773
  "placeholder": "[__SCAFFOLD_VERSION_GRADLE__]",
764
774
  "group": "android",
765
775
  "source": {
@@ -768,7 +778,7 @@
768
778
  }
769
779
  },
770
780
  "gradleSha256": {
771
- "value": "a17ddd85a26b6a7f5ddb71ff8b05fc5104c0202c6e64782429790c933686c806",
781
+ "value": "21bd5da2de49b642904077f38c0efdc7778e92b3ed0889392dca61b97e389607",
772
782
  "placeholder": "[__SCAFFOLD_VERSION_GRADLE_SHA256__]",
773
783
  "group": "android",
774
784
  "source": {
@@ -778,7 +788,7 @@
778
788
  }
779
789
  },
780
790
  "androidCompileSdk": {
781
- "value": "36",
791
+ "value": "37",
782
792
  "placeholder": "[__SCAFFOLD_VERSION_ANDROID_COMPILE_SDK__]",
783
793
  "group": "android",
784
794
  "source": {
@@ -1,6 +1,6 @@
1
- import type { Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_RawWorkflows, Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Returns, Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_VersionStrategy, Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Workspaces } from '../../../types/cli/generate/github/workflows-blueprint-validate.d.ts';
1
+ import type { Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Environment, Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_RawWorkflows, Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Returns, Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_VersionStrategy, Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Workspaces } from '../../../types/cli/generate/github/workflows-blueprint-validate.d.ts';
2
2
  export declare class Runner {
3
- static validate(rawWorkflows: Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_RawWorkflows, workspaces: Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Workspaces, versionStrategy?: Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_VersionStrategy): Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Returns;
3
+ static validate(rawWorkflows: Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_RawWorkflows, workspaces: Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Workspaces, versionStrategy?: Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_VersionStrategy, environment?: Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Environment): Cli_Generate_Github_WorkflowsBlueprintValidate_Runner_Validate_Returns;
4
4
  private static detectCircularDependsOn;
5
5
  private static isNonEmptyStringArray;
6
6
  private static isContainerCoordinateComponent;
@@ -1 +1 @@
1
- {"version":3,"file":"workflows-blueprint-validate.d.ts","sourceRoot":"","sources":["../../../../../src/cli/generate/github/workflows-blueprint-validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAgFV,2EAA2E,EAK3E,sEAAsE,EAuCtE,8EAA8E,EAM9E,yEAAyE,EAI1E,MAAM,sEAAsE,CAAC;AAqF9E,qBAAa,MAAM;WAeH,QAAQ,CAAC,YAAY,EAAE,2EAA2E,EAAE,UAAU,EAAE,yEAAyE,EAAE,eAAe,GAAE,8EAAyF,GAAG,sEAAsE;IAwwB5X,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAoEtC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAoBpC,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAsD7C,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA2BpC,OAAO,CAAC,MAAM,CAAC,aAAa;IAoB5B,OAAO,CAAC,MAAM,CAAC,4BAA4B;IA+C3C,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAsCpC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA8ClC,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAahC"}
1
+ {"version":3,"file":"workflows-blueprint-validate.d.ts","sourceRoot":"","sources":["../../../../../src/cli/generate/github/workflows-blueprint-validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAwDV,0EAA0E,EA0C1E,2EAA2E,EAK3E,sEAAsE,EAuCtE,8EAA8E,EAM9E,yEAAyE,EAI1E,MAAM,sEAAsE,CAAC;AAqF9E,qBAAa,MAAM;WAgBH,QAAQ,CAAC,YAAY,EAAE,2EAA2E,EAAE,UAAU,EAAE,yEAAyE,EAAE,eAAe,GAAE,8EAAyF,EAAE,WAAW,GAAE,0EAA+E,GAAG,sEAAsE;IA+4B1d,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAoEtC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAoBpC,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAsD7C,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA2BpC,OAAO,CAAC,MAAM,CAAC,aAAa;IAoB5B,OAAO,CAAC,MAAM,CAAC,4BAA4B;IA+C3C,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAsCpC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA8ClC,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAahC"}
@@ -8,11 +8,11 @@ const buildableTargetTypes = [
8
8
  'npm',
9
9
  'github-action',
10
10
  'github-packages',
11
- 'cloudflare-pages-docusaurus',
11
+ 'cloudflare-pages',
12
12
  'cloudflare-workers',
13
13
  'docker-hub',
14
14
  'ghcr',
15
- 'github-pages-docusaurus',
15
+ 'github-pages',
16
16
  'vercel-nextjs',
17
17
  ];
18
18
  const allowedContainerPlatforms = [
@@ -39,7 +39,7 @@ const validTriggersByTemplate = {
39
39
  ],
40
40
  };
41
41
  export class Runner {
42
- static validate(rawWorkflows, workspaces, versionStrategy = 'semver') {
42
+ static validate(rawWorkflows, workspaces, versionStrategy = 'semver', environment = {}) {
43
43
  const diagnostics = [];
44
44
  const workflows = [];
45
45
  const seenKeys = new Set();
@@ -125,8 +125,11 @@ export class Runner {
125
125
  const workflowKey = `${templateName}-${suffixValue}`;
126
126
  const runsOn = entry['runsOn'];
127
127
  const timeoutMinutes = entry['timeoutMinutes'];
128
+ const rawEnvironmentSelection = entry['environmentSelection'];
128
129
  const containerPlatforms = entry['containerPlatforms'];
129
130
  const validTriggers = validTriggersByTemplate[templateName];
131
+ let environmentSelection = undefined;
132
+ let hasEnvironmentSelection = false;
130
133
  if (runsOn !== undefined && runsOn !== 'ubuntu-latest') {
131
134
  diagnostics.push({
132
135
  severity: 'error',
@@ -145,6 +148,67 @@ export class Runner {
145
148
  });
146
149
  hasError = true;
147
150
  }
151
+ if (rawEnvironmentSelection !== undefined) {
152
+ hasEnvironmentSelection = true;
153
+ if (Runner.isPlainObject(rawEnvironmentSelection) === false) {
154
+ diagnostics.push({
155
+ severity: 'error',
156
+ message: `Workflow "${workflowKey}" has an invalid "environmentSelection" value. Configure exact "versionTags" and "manual" fields. Skipping.`,
157
+ });
158
+ hasError = true;
159
+ }
160
+ else {
161
+ const environmentSelectionEntry = rawEnvironmentSelection;
162
+ const environmentSelectionKeys = Object.keys(environmentSelectionEntry);
163
+ const environmentSelectionVersionTags = environmentSelectionEntry['versionTags'];
164
+ const hasExactEnvironmentSelectionKeys = environmentSelectionKeys.length === 2
165
+ && environmentSelectionKeys.includes('versionTags') === true
166
+ && environmentSelectionKeys.includes('manual') === true;
167
+ if (hasExactEnvironmentSelectionKeys === false
168
+ || Runner.isPlainObject(environmentSelectionVersionTags) === false
169
+ || typeof environmentSelectionEntry['manual'] !== 'boolean') {
170
+ diagnostics.push({
171
+ severity: 'error',
172
+ message: `Workflow "${workflowKey}" must configure environmentSelection as { "versionTags": { "prerelease": "staging", "stable": "production" }, "manual": <boolean> }. Skipping.`,
173
+ });
174
+ hasError = true;
175
+ }
176
+ else {
177
+ const environmentSelectionVersionTagsEntry = environmentSelectionVersionTags;
178
+ const environmentSelectionVersionTagKeys = Object.keys(environmentSelectionVersionTagsEntry);
179
+ const hasExactEnvironmentSelectionVersionTagKeys = environmentSelectionVersionTagKeys.length === 2
180
+ && environmentSelectionVersionTagKeys.includes('prerelease') === true
181
+ && environmentSelectionVersionTagKeys.includes('stable') === true;
182
+ if (hasExactEnvironmentSelectionVersionTagKeys === false
183
+ || environmentSelectionVersionTagsEntry['prerelease'] !== 'staging'
184
+ || environmentSelectionVersionTagsEntry['stable'] !== 'production') {
185
+ diagnostics.push({
186
+ severity: 'error',
187
+ message: `Workflow "${workflowKey}" must map prerelease tags to "staging" and stable tags to "production". Skipping.`,
188
+ });
189
+ hasError = true;
190
+ }
191
+ else {
192
+ environmentSelection = rawEnvironmentSelection;
193
+ }
194
+ }
195
+ }
196
+ if (templateName !== 'publish') {
197
+ diagnostics.push({
198
+ severity: 'error',
199
+ message: `Workflow "${workflowKey}" declares "environmentSelection", but only publish workflows targeting Cloudflare Workers support deployment environments. Skipping.`,
200
+ });
201
+ hasError = true;
202
+ }
203
+ const environmentProfiles = environment['profiles'];
204
+ if (environmentProfiles === undefined || environmentProfiles['enabled'] !== true) {
205
+ diagnostics.push({
206
+ severity: 'error',
207
+ message: `Workflow "${workflowKey}" declares "environmentSelection", but environment.profiles.enabled is not true. Enable profiles before selecting deployment environments. Skipping.`,
208
+ });
209
+ hasError = true;
210
+ }
211
+ }
148
212
  if (containerPlatforms !== undefined) {
149
213
  if (Array.isArray(containerPlatforms) === false || containerPlatforms.length === 0) {
150
214
  diagnostics.push({
@@ -277,6 +341,35 @@ export class Runner {
277
341
  hasError = true;
278
342
  }
279
343
  }
344
+ if (hasEnvironmentSelection === true && environmentSelection !== undefined) {
345
+ let hasVersionTagTrigger = false;
346
+ let hasUnsupportedEnvironmentTrigger = false;
347
+ for (const environmentTriggerValue of triggerList) {
348
+ const environmentTrigger = environmentTriggerValue;
349
+ const environmentTriggerObject = (typeof environmentTrigger === 'string') ? {} : environmentTrigger;
350
+ const environmentTriggerName = (typeof environmentTrigger === 'string') ? environmentTrigger : environmentTriggerObject['name'];
351
+ if (environmentTriggerName === 'release' || environmentTriggerName === 'tag-push') {
352
+ hasVersionTagTrigger = true;
353
+ }
354
+ else {
355
+ hasUnsupportedEnvironmentTrigger = true;
356
+ }
357
+ }
358
+ if (hasVersionTagTrigger === false) {
359
+ diagnostics.push({
360
+ severity: 'error',
361
+ message: `Workflow "${workflowKey}" selects deployment environments from version tags, but it has no "release" or "tag-push" trigger. Skipping.`,
362
+ });
363
+ hasError = true;
364
+ }
365
+ if (hasUnsupportedEnvironmentTrigger === true) {
366
+ diagnostics.push({
367
+ severity: 'error',
368
+ message: `Workflow "${workflowKey}" declares "environmentSelection" with a branch or workflow-run trigger that cannot identify staging versus production. Use only release and tag-push triggers. Skipping.`,
369
+ });
370
+ hasError = true;
371
+ }
372
+ }
280
373
  if (hasError === true) {
281
374
  continue;
282
375
  }
@@ -317,6 +410,7 @@ export class Runner {
317
410
  const scopes = entry['build'];
318
411
  let dockerHubTargetCount = 0;
319
412
  let ghcrTargetCount = 0;
413
+ let nonCloudflareTargetCount = 0;
320
414
  if (Array.isArray(scopes) === true) {
321
415
  for (const scopeValue of scopes) {
322
416
  const scope = scopeValue;
@@ -353,6 +447,9 @@ export class Runner {
353
447
  if (targetTypeName === 'ghcr') {
354
448
  ghcrTargetCount += 1;
355
449
  }
450
+ if (targetTypeName !== 'cloudflare-workers') {
451
+ nonCloudflareTargetCount += 1;
452
+ }
356
453
  if (typeof targetType !== 'string' || buildableTargetTypes.includes(targetTypeName) === false) {
357
454
  diagnostics.push({
358
455
  severity: 'error',
@@ -424,6 +521,22 @@ export class Runner {
424
521
  }
425
522
  }
426
523
  }
524
+ if (hasEnvironmentSelection === true) {
525
+ if (Array.isArray(targets) === false || targets.length === 0) {
526
+ diagnostics.push({
527
+ severity: 'error',
528
+ message: `Workflow "${workflowKey}" declares "environmentSelection" without a Cloudflare Workers deploy target. Skipping.`,
529
+ });
530
+ hasError = true;
531
+ }
532
+ else if (nonCloudflareTargetCount > 0) {
533
+ diagnostics.push({
534
+ severity: 'error',
535
+ message: `Workflow "${workflowKey}" mixes Cloudflare Workers environment selection with another deploy target. Keep environment-aware Workers in a dedicated publish workflow. Skipping.`,
536
+ });
537
+ hasError = true;
538
+ }
539
+ }
427
540
  if (dockerHubTargetCount > 1 || ghcrTargetCount > 1) {
428
541
  diagnostics.push({
429
542
  severity: 'error',