@cbnventures/nova 0.32.0 → 0.34.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 (316) hide show
  1. package/bin/nova.mjs +5 -2
  2. package/build/package.json +3 -2
  3. package/build/scaffold-versions.json +21 -14
  4. package/build/src/api/app-store-connect.d.ts +28 -0
  5. package/build/src/api/app-store-connect.d.ts.map +1 -0
  6. package/build/src/api/app-store-connect.js +494 -0
  7. package/build/src/api/app-store-connect.js.map +1 -0
  8. package/build/src/api/google-play-console.d.ts +15 -0
  9. package/build/src/api/google-play-console.d.ts.map +1 -0
  10. package/build/src/api/google-play-console.js +136 -0
  11. package/build/src/api/google-play-console.js.map +1 -0
  12. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts +4 -2
  13. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts.map +1 -1
  14. package/build/src/cli/generate/github/workflows-blueprint-validate.js +219 -3
  15. package/build/src/cli/generate/github/workflows-blueprint-validate.js.map +1 -1
  16. package/build/src/cli/generate/github/workflows-blueprint.d.ts +6 -0
  17. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  18. package/build/src/cli/generate/github/workflows-blueprint.js +469 -59
  19. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  20. package/build/src/cli/index.js +188 -47
  21. package/build/src/cli/index.js.map +1 -1
  22. package/build/src/cli/integration/app-store-connect.d.ts +22 -0
  23. package/build/src/cli/integration/app-store-connect.d.ts.map +1 -0
  24. package/build/src/cli/integration/app-store-connect.js +502 -0
  25. package/build/src/cli/integration/app-store-connect.js.map +1 -0
  26. package/build/src/cli/integration/discord-developer-portal.d.ts +6 -0
  27. package/build/src/cli/integration/discord-developer-portal.d.ts.map +1 -0
  28. package/build/src/cli/integration/discord-developer-portal.js +42 -0
  29. package/build/src/cli/integration/discord-developer-portal.js.map +1 -0
  30. package/build/src/cli/integration/google-play-console.d.ts +16 -0
  31. package/build/src/cli/integration/google-play-console.d.ts.map +1 -0
  32. package/build/src/cli/integration/google-play-console.js +199 -0
  33. package/build/src/cli/integration/google-play-console.js.map +1 -0
  34. package/build/src/cli/integration/index.d.ts +8 -0
  35. package/build/src/cli/integration/index.d.ts.map +1 -0
  36. package/build/src/cli/integration/index.js +139 -0
  37. package/build/src/cli/integration/index.js.map +1 -0
  38. package/build/src/cli/recipe/github/sync-rulesets.js +2 -2
  39. package/build/src/cli/recipe/github/sync-rulesets.js.map +1 -1
  40. package/build/src/cli/recipe/index.d.ts.map +1 -1
  41. package/build/src/cli/recipe/index.js +5 -0
  42. package/build/src/cli/recipe/index.js.map +1 -1
  43. package/build/src/cli/recipe/miscellaneous/fix-markdown-tables.d.ts.map +1 -1
  44. package/build/src/cli/recipe/miscellaneous/fix-markdown-tables.js +15 -0
  45. package/build/src/cli/recipe/miscellaneous/fix-markdown-tables.js.map +1 -1
  46. package/build/src/cli/recipe/nova-config/normalize-order.d.ts +5 -0
  47. package/build/src/cli/recipe/nova-config/normalize-order.d.ts.map +1 -0
  48. package/build/src/cli/recipe/nova-config/normalize-order.js +104 -0
  49. package/build/src/cli/recipe/nova-config/normalize-order.js.map +1 -0
  50. package/build/src/cli/recipe/package-json/normalize-tooling.d.ts.map +1 -1
  51. package/build/src/cli/recipe/package-json/normalize-tooling.js +55 -10
  52. package/build/src/cli/recipe/package-json/normalize-tooling.js.map +1 -1
  53. package/build/src/cli/recipe/package-json/sync-identity.d.ts.map +1 -1
  54. package/build/src/cli/recipe/package-json/sync-identity.js +51 -18
  55. package/build/src/cli/recipe/package-json/sync-identity.js.map +1 -1
  56. package/build/src/cli/scaffold/app/android.d.ts.map +1 -1
  57. package/build/src/cli/scaffold/app/android.js +6 -0
  58. package/build/src/cli/scaffold/app/android.js.map +1 -1
  59. package/build/src/cli/scaffold/app/apple.d.ts.map +1 -1
  60. package/build/src/cli/scaffold/app/apple.js +7 -0
  61. package/build/src/cli/scaffold/app/apple.js.map +1 -1
  62. package/build/src/cli/scaffold/app/astro.d.ts.map +1 -1
  63. package/build/src/cli/scaffold/app/astro.js +15 -0
  64. package/build/src/cli/scaffold/app/astro.js.map +1 -1
  65. package/build/src/cli/scaffold/app/discord-bot.d.ts.map +1 -1
  66. package/build/src/cli/scaffold/app/discord-bot.js +20 -1
  67. package/build/src/cli/scaffold/app/discord-bot.js.map +1 -1
  68. package/build/src/cli/scaffold/app/expressjs.d.ts.map +1 -1
  69. package/build/src/cli/scaffold/app/expressjs.js +20 -1
  70. package/build/src/cli/scaffold/app/expressjs.js.map +1 -1
  71. package/build/src/cli/scaffold/app/nextjs.d.ts.map +1 -1
  72. package/build/src/cli/scaffold/app/nextjs.js +9 -1
  73. package/build/src/cli/scaffold/app/nextjs.js.map +1 -1
  74. package/build/src/cli/scaffold/app/vite.d.ts.map +1 -1
  75. package/build/src/cli/scaffold/app/vite.js +15 -1
  76. package/build/src/cli/scaffold/app/vite.js.map +1 -1
  77. package/build/src/cli/scaffold/docs/docusaurus.d.ts.map +1 -1
  78. package/build/src/cli/scaffold/docs/docusaurus.js +13 -2
  79. package/build/src/cli/scaffold/docs/docusaurus.js.map +1 -1
  80. package/build/src/cli/scaffold/package/github-action.d.ts.map +1 -1
  81. package/build/src/cli/scaffold/package/github-action.js +5 -0
  82. package/build/src/cli/scaffold/package/github-action.js.map +1 -1
  83. package/build/src/cli/scaffold/package/homebridge.d.ts.map +1 -1
  84. package/build/src/cli/scaffold/package/homebridge.js +5 -0
  85. package/build/src/cli/scaffold/package/homebridge.js.map +1 -1
  86. package/build/src/cli/scaffold/package/pfsense.d.ts.map +1 -1
  87. package/build/src/cli/scaffold/package/pfsense.js +5 -0
  88. package/build/src/cli/scaffold/package/pfsense.js.map +1 -1
  89. package/build/src/cli/scaffold/starter/base.d.ts.map +1 -1
  90. package/build/src/cli/scaffold/starter/base.js +2 -1
  91. package/build/src/cli/scaffold/starter/base.js.map +1 -1
  92. package/build/src/cli/scaffold/tool/serverless.d.ts.map +1 -1
  93. package/build/src/cli/scaffold/tool/serverless.js +9 -0
  94. package/build/src/cli/scaffold/tool/serverless.js.map +1 -1
  95. package/build/src/cli/utility/changelog.d.ts +2 -0
  96. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  97. package/build/src/cli/utility/changelog.js +241 -129
  98. package/build/src/cli/utility/changelog.js.map +1 -1
  99. package/build/src/cli/utility/configure.d.ts +4 -1
  100. package/build/src/cli/utility/configure.d.ts.map +1 -1
  101. package/build/src/cli/utility/configure.js +414 -58
  102. package/build/src/cli/utility/configure.js.map +1 -1
  103. package/build/src/cli/utility/run-recipes.d.ts.map +1 -1
  104. package/build/src/cli/utility/run-recipes.js +7 -26
  105. package/build/src/cli/utility/run-recipes.js.map +1 -1
  106. package/build/src/lib/constants.d.ts +2 -1
  107. package/build/src/lib/constants.d.ts.map +1 -1
  108. package/build/src/lib/constants.js +1 -0
  109. package/build/src/lib/constants.js.map +1 -1
  110. package/build/src/lib/docker-packaging.d.ts +22 -1
  111. package/build/src/lib/docker-packaging.d.ts.map +1 -1
  112. package/build/src/lib/docker-packaging.js +1044 -76
  113. package/build/src/lib/docker-packaging.js.map +1 -1
  114. package/build/src/lib/file-discovery.js +1 -1
  115. package/build/src/lib/file-discovery.js.map +1 -1
  116. package/build/src/lib/ignore-files.d.ts.map +1 -1
  117. package/build/src/lib/ignore-files.js +4 -1
  118. package/build/src/lib/ignore-files.js.map +1 -1
  119. package/build/src/lib/integration.d.ts +14 -0
  120. package/build/src/lib/integration.d.ts.map +1 -0
  121. package/build/src/lib/integration.js +323 -0
  122. package/build/src/lib/integration.js.map +1 -0
  123. package/build/src/lib/item.d.ts.map +1 -1
  124. package/build/src/lib/item.js +5 -1
  125. package/build/src/lib/item.js.map +1 -1
  126. package/build/src/lib/nova-config-order.d.ts +3 -0
  127. package/build/src/lib/nova-config-order.d.ts.map +1 -0
  128. package/build/src/lib/nova-config-order.js +38 -0
  129. package/build/src/lib/nova-config-order.js.map +1 -0
  130. package/build/src/lib/nova-config.d.ts +2 -2
  131. package/build/src/lib/nova-config.d.ts.map +1 -1
  132. package/build/src/lib/nova-config.js +73 -8
  133. package/build/src/lib/nova-config.js.map +1 -1
  134. package/build/src/lib/package-scripts.d.ts.map +1 -1
  135. package/build/src/lib/package-scripts.js +2 -1
  136. package/build/src/lib/package-scripts.js.map +1 -1
  137. package/build/src/lib/regex.d.ts +8 -0
  138. package/build/src/lib/regex.d.ts.map +1 -1
  139. package/build/src/lib/regex.js +10 -2
  140. package/build/src/lib/regex.js.map +1 -1
  141. package/build/src/lib/release-history.d.ts +2 -1
  142. package/build/src/lib/release-history.d.ts.map +1 -1
  143. package/build/src/lib/release-history.js +18 -0
  144. package/build/src/lib/release-history.js.map +1 -1
  145. package/build/src/lib/run-workspaces.d.ts +3 -0
  146. package/build/src/lib/run-workspaces.d.ts.map +1 -1
  147. package/build/src/lib/run-workspaces.js +132 -2
  148. package/build/src/lib/run-workspaces.js.map +1 -1
  149. package/build/src/lib/scaffold-allow-scripts.d.ts +4 -0
  150. package/build/src/lib/scaffold-allow-scripts.d.ts.map +1 -0
  151. package/build/src/lib/scaffold-allow-scripts.js +76 -0
  152. package/build/src/lib/scaffold-allow-scripts.js.map +1 -0
  153. package/build/src/lib/scaffold.d.ts +4 -3
  154. package/build/src/lib/scaffold.d.ts.map +1 -1
  155. package/build/src/lib/scaffold.js +287 -44
  156. package/build/src/lib/scaffold.js.map +1 -1
  157. package/build/src/lib/transpile.d.ts.map +1 -1
  158. package/build/src/lib/transpile.js +6 -5
  159. package/build/src/lib/transpile.js.map +1 -1
  160. package/build/src/lib/type-check.d.ts +3 -1
  161. package/build/src/lib/type-check.d.ts.map +1 -1
  162. package/build/src/lib/type-check.js +22 -6
  163. package/build/src/lib/type-check.js.map +1 -1
  164. package/build/src/lib/utility.d.ts.map +1 -1
  165. package/build/src/lib/utility.js +0 -7
  166. package/build/src/lib/utility.js.map +1 -1
  167. package/build/src/lib/version-contract.d.ts +7 -0
  168. package/build/src/lib/version-contract.d.ts.map +1 -0
  169. package/build/src/lib/version-contract.js +80 -0
  170. package/build/src/lib/version-contract.js.map +1 -0
  171. package/build/src/lib/version-strategy-migration.d.ts +6 -0
  172. package/build/src/lib/version-strategy-migration.d.ts.map +1 -0
  173. package/build/src/lib/version-strategy-migration.js +208 -0
  174. package/build/src/lib/version-strategy-migration.js.map +1 -0
  175. package/build/src/lib/workflow-templates.d.ts.map +1 -1
  176. package/build/src/lib/workflow-templates.js +22 -1
  177. package/build/src/lib/workflow-templates.js.map +1 -1
  178. package/build/src/presets/eslint/dx-ignore.d.ts.map +1 -1
  179. package/build/src/presets/eslint/dx-ignore.js +7 -0
  180. package/build/src/presets/eslint/dx-ignore.js.map +1 -1
  181. package/build/src/types/api/app-store-connect.d.ts +427 -0
  182. package/build/src/types/api/google-play-console.d.ts +146 -0
  183. package/build/src/types/cli/generate/github/workflows-blueprint-validate.d.ts +65 -0
  184. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +96 -12
  185. package/build/src/types/cli/index.d.ts +9 -32
  186. package/build/src/types/cli/integration/app-store-connect.d.ts +353 -0
  187. package/build/src/types/cli/integration/discord-developer-portal.d.ts +36 -0
  188. package/build/src/types/cli/integration/google-play-console.d.ts +145 -0
  189. package/build/src/types/cli/integration/index.d.ts +31 -0
  190. package/build/src/types/cli/recipe/index.d.ts +3 -1
  191. package/build/src/types/cli/recipe/miscellaneous/fix-markdown-tables.d.ts +26 -0
  192. package/build/src/types/cli/recipe/nova-config/normalize-order.d.ts +64 -0
  193. package/build/src/types/cli/recipe/package-json/normalize-tooling.d.ts +19 -1
  194. package/build/src/types/cli/recipe/package-json/sync-identity.d.ts +9 -0
  195. package/build/src/types/cli/utility/changelog.d.ts +149 -0
  196. package/build/src/types/cli/utility/configure.d.ts +219 -8
  197. package/build/src/types/cli/utility/run-recipes.d.ts +1 -8
  198. package/build/src/types/lib/constants.d.ts +7 -0
  199. package/build/src/types/lib/docker-packaging.d.ts +447 -47
  200. package/build/src/types/lib/integration.d.ts +264 -0
  201. package/build/src/types/lib/item.d.ts +4 -0
  202. package/build/src/types/lib/nova-config-order.d.ts +31 -0
  203. package/build/src/types/lib/nova-config.d.ts +40 -1
  204. package/build/src/types/lib/package-scripts.d.ts +2 -0
  205. package/build/src/types/lib/release-history.d.ts +15 -0
  206. package/build/src/types/lib/run-workspaces.d.ts +135 -0
  207. package/build/src/types/lib/scaffold-allow-scripts.d.ts +54 -0
  208. package/build/src/types/lib/scaffold.d.ts +157 -2
  209. package/build/src/types/lib/transpile.d.ts +2 -0
  210. package/build/src/types/lib/type-check.d.ts +28 -0
  211. package/build/src/types/lib/utility.d.ts +0 -13
  212. package/build/src/types/lib/version-contract.d.ts +84 -0
  213. package/build/src/types/lib/version-strategy-migration.d.ts +207 -0
  214. package/build/src/types/shared.d.ts +491 -3
  215. package/build/src/types/tests/cli/generate/github/workflows-blueprint-validate.test.d.ts +60 -0
  216. package/build/src/types/tests/cli/generate/github/workflows-blueprint.test.d.ts +11 -0
  217. package/build/src/types/tests/cli/generate/github/workflows-version-contract.test.d.ts +65 -0
  218. package/build/src/types/tests/cli/generate/must-haves/agent-conventions.test.d.ts +4 -0
  219. package/build/src/types/tests/cli/integration.test.d.ts +97 -0
  220. package/build/src/types/tests/cli/recipe/nova-config/normalize-order.test.d.ts +31 -0
  221. package/build/src/types/tests/cli/recipe/package-json/normalize-tooling.test.d.ts +46 -25
  222. package/build/src/types/tests/cli/recipe/package-json/sync-identity-version-contract.test.d.ts +57 -0
  223. package/build/src/types/tests/cli/scaffold/app/android.test.d.ts +8 -0
  224. package/build/src/types/tests/cli/scaffold/app/apple.test.d.ts +6 -0
  225. package/build/src/types/tests/cli/scaffold/app/expressjs.test.d.ts +4 -0
  226. package/build/src/types/tests/cli/scaffold/docs/docusaurus.test.d.ts +26 -0
  227. package/build/src/types/tests/cli/utility/changelog-android.test.d.ts +48 -0
  228. package/build/src/types/tests/cli/utility/changelog-apple.test.d.ts +72 -0
  229. package/build/src/types/tests/cli/utility/changelog.test.d.ts +20 -12
  230. package/build/src/types/tests/cli/utility/configure.test.d.ts +119 -0
  231. package/build/src/types/tests/cli/utility/run-recipes.test.d.ts +7 -56
  232. package/build/src/types/tests/cli/utility/run-scripts.test.d.ts +2 -0
  233. package/build/src/types/tests/cli/utility/run-workspaces.test.d.ts +48 -0
  234. package/build/src/types/tests/lib/docker-packaging.test.d.ts +169 -27
  235. package/build/src/types/tests/lib/ignore-files.test.d.ts +2 -0
  236. package/build/src/types/tests/lib/integration.test.d.ts +60 -0
  237. package/build/src/types/tests/lib/nova-config-run-workspaces-cache.test.d.ts +2 -2
  238. package/build/src/types/tests/lib/nova-config.test.d.ts +17 -0
  239. package/build/src/types/tests/lib/scaffold-allow-scripts.test.d.ts +14 -0
  240. package/build/src/types/tests/lib/scaffold-version-contract.test.d.ts +59 -0
  241. package/build/src/types/tests/lib/scaffold.test.d.ts +33 -0
  242. package/build/src/types/tests/lib/type-check.test.d.ts +26 -0
  243. package/build/src/types/tests/lib/utility.test.d.ts +21 -0
  244. package/build/src/types/tests/lib/version-contract.test.d.ts +66 -0
  245. package/build/src/types/tests/lib/version-strategy-migration.test.d.ts +85 -0
  246. package/build/src/types/tests/lib/workflow-templates.test.d.ts +4 -0
  247. package/build/src/types/tests/presets/eslint/dx-ignore.test.d.ts +14 -0
  248. package/build/src/types/tests/scaffold-output-contract.test.d.ts +26 -0
  249. package/build/templates/generators/must-haves/agent-conventions/PROJECT_RULES.md +107 -196
  250. package/build/templates/generators/must-haves/agent-conventions/VISION.md +91 -22
  251. package/build/templates/generators/must-haves/agent-conventions/conventions/docker.md +4 -4
  252. package/build/templates/generators/must-haves/agent-conventions/conventions/documentation.md +4 -2
  253. package/build/templates/scaffold/app/android/package.json +2 -2
  254. package/build/templates/scaffold/app/android/scripts/run-gradle.mjs +21 -4
  255. package/build/templates/scaffold/app/apple/eslint.config.mts +42 -0
  256. package/build/templates/scaffold/app/apple/package.json +11 -3
  257. package/build/templates/scaffold/app/apple/project.yml +1 -1
  258. package/build/templates/scaffold/app/apple/scripts/run-apple.mjs +2 -1
  259. package/build/templates/scaffold/app/apple/tsconfig.scripts.json +17 -0
  260. package/build/templates/scaffold/app/apple/tsconfig.tests.json +18 -0
  261. package/build/templates/scaffold/app/apple/vitest.config.mts +16 -0
  262. package/build/templates/scaffold/app/astro/package.json +2 -2
  263. package/build/templates/scaffold/app/discord-bot/package.json +2 -2
  264. package/build/templates/scaffold/app/express/package.json +2 -2
  265. package/build/templates/scaffold/app/nextjs/package.json +2 -2
  266. package/build/templates/scaffold/app/vite/package.json +2 -2
  267. package/build/templates/scaffold/docs/docusaurus/docusaurus.config.ts +4 -3
  268. package/build/templates/scaffold/docs/docusaurus/eslint.config.mts +61 -3
  269. package/build/templates/scaffold/docs/docusaurus/package.json +6 -4
  270. package/build/templates/scaffold/docs/docusaurus/src/pages/index.tsx +2 -2
  271. package/build/templates/scaffold/docs/docusaurus/src/tests/dotenv.test.ts +27 -0
  272. package/build/templates/scaffold/docs/docusaurus/src/tests/frontmatter.test.ts +1 -1
  273. package/build/templates/scaffold/docs/docusaurus/src/tests/link.test.ts +1 -1
  274. package/build/templates/scaffold/docs/docusaurus/src/tests/markdown-table.test.ts +1 -1
  275. package/build/templates/scaffold/docs/docusaurus/src/tests/terminology.test.ts +1 -1
  276. package/build/templates/scaffold/docs/docusaurus/src/tests/type-declarations.test.ts +1 -1
  277. package/build/templates/scaffold/docs/docusaurus/src/types/pages/index.d.ts +2 -2
  278. package/build/templates/scaffold/docs/docusaurus/tsconfig.app.json +33 -0
  279. package/build/templates/scaffold/docs/docusaurus/tsconfig.config.json +21 -0
  280. package/build/templates/scaffold/docs/docusaurus/tsconfig.json +11 -17
  281. package/build/templates/scaffold/docs/docusaurus/tsconfig.tests.json +28 -0
  282. package/build/templates/scaffold/docs/docusaurus/vitest.config.mts +1 -14
  283. package/build/templates/scaffold/docs/docusaurus/vitest.setup.ts +3 -3
  284. package/build/templates/scaffold/package/github-action/package.json +2 -2
  285. package/build/templates/scaffold/package/homebridge/bin/repl.mjs +5 -2
  286. package/build/templates/scaffold/package/homebridge/bin/test-api.mjs +5 -2
  287. package/build/templates/scaffold/package/homebridge/package.json +2 -2
  288. package/build/templates/scaffold/package/pfsense/package.json +2 -2
  289. package/build/templates/scaffold/starter/base/assets/README.md +7 -0
  290. package/build/templates/scaffold-options/app/android-native/app/build.gradle.kts +1 -1
  291. package/build/templates/scaffold-options/app/android-native/gradlew.bat +84 -84
  292. package/build/templates/scaffold-options/app/apple-store-connect-root/assets/app-store-connect/[__WORKSPACE_NAME__]/creative-assets/README.md +10 -0
  293. package/build/templates/scaffold-options/app/apple-store-connect-root/assets/app-store-connect/[__WORKSPACE_NAME__]/metadata/ios/en-US.json +8 -0
  294. package/build/templates/scaffold-options/app/apple-store-connect-root/assets/app-store-connect/[__WORKSPACE_NAME__]/metadata/macos/en-US.json +8 -0
  295. package/build/templates/scaffold-options/app/apple-store-connect-root/assets/app-store-connect/[__WORKSPACE_NAME__]/screenshots/README.md +13 -0
  296. package/build/templates/scaffold-options/app/google-play-console-root/assets/google-play-console/[__WORKSPACE_NAME__]/graphic-assets/README.md +12 -0
  297. package/build/templates/scaffold-options/app/google-play-console-root/assets/google-play-console/[__WORKSPACE_NAME__]/metadata/android/en-US.json +6 -0
  298. package/build/templates/scaffold-options/app/google-play-console-root/assets/google-play-console/[__WORKSPACE_NAME__]/screenshots/README.md +13 -0
  299. package/build/templates/scaffold-options/docker-image/common/Dockerfile +81 -0
  300. package/build/templates/scaffold-options/docker-image/common/compose.yml +21 -0
  301. package/build/templates/scaffold-options/docker-image/common/dockerignore +38 -0
  302. package/build/templates/scaffold-options/package/node-cli-core/bin/cli.mjs +5 -2
  303. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/package.json +2 -2
  304. package/build/templates/scaffold-options/tool/serverless/vercel-functions/package.json +2 -2
  305. package/package.json +3 -2
  306. package/build/templates/scaffold-options/docker-image/astro-node/Dockerfile +0 -27
  307. package/build/templates/scaffold-options/docker-image/astro-node/compose.yml +0 -12
  308. package/build/templates/scaffold-options/docker-image/background-service/compose.yml +0 -10
  309. package/build/templates/scaffold-options/docker-image/container-native/Dockerfile +0 -10
  310. package/build/templates/scaffold-options/docker-image/container-native/compose.yml +0 -8
  311. package/build/templates/scaffold-options/docker-image/http-service/compose.yml +0 -11
  312. package/build/templates/scaffold-options/docker-image/nextjs-standalone/Dockerfile +0 -26
  313. package/build/templates/scaffold-options/docker-image/nextjs-standalone/compose.yml +0 -12
  314. package/build/templates/scaffold-options/docker-image/node/Dockerfile +0 -23
  315. package/build/templates/scaffold-options/docker-image/static-site/Dockerfile +0 -18
  316. package/build/templates/scaffold-options/docker-image/static-site/compose.yml +0 -8
@@ -0,0 +1,85 @@
1
+ import type {
2
+ Shared_NovaConfig,
3
+ Shared_NovaConfigSettings_VersionStrategy,
4
+ } from '../../shared.d.ts';
5
+
6
+ /**
7
+ * Tests - Lib - Version Strategy Migration.
8
+ *
9
+ * @since 0.34.0
10
+ */
11
+ export type Tests_Lib_VersionStrategyMigration_TemporaryPrefix = string;
12
+
13
+ export type Tests_Lib_VersionStrategyMigration_SandboxRoot = string;
14
+
15
+ export type Tests_Lib_VersionStrategyMigration_ProjectDirectory = string;
16
+
17
+ export type Tests_Lib_VersionStrategyMigration_PackageAPath = string;
18
+
19
+ export type Tests_Lib_VersionStrategyMigration_PackageBPath = string;
20
+
21
+ export type Tests_Lib_VersionStrategyMigration_ApplePath = string;
22
+
23
+ export type Tests_Lib_VersionStrategyMigration_AndroidPath = string;
24
+
25
+ export type Tests_Lib_VersionStrategyMigration_PackageA = Record<string, unknown>;
26
+
27
+ export type Tests_Lib_VersionStrategyMigration_PackageB = Record<string, unknown>;
28
+
29
+ export type Tests_Lib_VersionStrategyMigration_AppleContent = string;
30
+
31
+ export type Tests_Lib_VersionStrategyMigration_AndroidContent = string;
32
+
33
+ export type Tests_Lib_VersionStrategyMigration_Config = Shared_NovaConfig;
34
+
35
+ export type Tests_Lib_VersionStrategyMigration_Plan_CurrentStrategy = Shared_NovaConfigSettings_VersionStrategy;
36
+
37
+ export type Tests_Lib_VersionStrategyMigration_Plan_NextStrategy = Shared_NovaConfigSettings_VersionStrategy;
38
+
39
+ export type Tests_Lib_VersionStrategyMigration_Plan_Write_Path = string;
40
+
41
+ export type Tests_Lib_VersionStrategyMigration_Plan_Write_Content = string;
42
+
43
+ export type Tests_Lib_VersionStrategyMigration_Plan_Write = {
44
+ path: Tests_Lib_VersionStrategyMigration_Plan_Write_Path;
45
+ content: Tests_Lib_VersionStrategyMigration_Plan_Write_Content;
46
+ };
47
+
48
+ export type Tests_Lib_VersionStrategyMigration_Plan_Writes = Tests_Lib_VersionStrategyMigration_Plan_Write[];
49
+
50
+ export type Tests_Lib_VersionStrategyMigration_Plan = {
51
+ currentStrategy: Tests_Lib_VersionStrategyMigration_Plan_CurrentStrategy;
52
+ nextStrategy: Tests_Lib_VersionStrategyMigration_Plan_NextStrategy;
53
+ writes: Tests_Lib_VersionStrategyMigration_Plan_Writes;
54
+ };
55
+
56
+ export type Tests_Lib_VersionStrategyMigration_UpdatedPackageA = Record<string, unknown>;
57
+
58
+ export type Tests_Lib_VersionStrategyMigration_UpdatedPackageB = Record<string, unknown>;
59
+
60
+ export type Tests_Lib_VersionStrategyMigration_UpdatedApple = string;
61
+
62
+ export type Tests_Lib_VersionStrategyMigration_UpdatedAndroid = string;
63
+
64
+ export type Tests_Lib_VersionStrategyMigration_UpdatedPackageADependencies = Record<string, unknown>;
65
+
66
+ /**
67
+ * Tests - Lib - Version Strategy Migration - Prepare And Apply.
68
+ *
69
+ * @since 0.34.0
70
+ */
71
+ export type Tests_Lib_VersionStrategyMigration_PrepareAndApply_Returns = void;
72
+
73
+ /**
74
+ * Tests - Lib - Version Strategy Migration - Prepare And Apply - Migrates Manifests Exact Pins And Authoritative Native Mirrors Together.
75
+ *
76
+ * @since 0.34.0
77
+ */
78
+ export type Tests_Lib_VersionStrategyMigration_PrepareAndApply_MigratesManifestsExactPinsAndAuthoritativeNativeMirrorsTogether_Returns = void;
79
+
80
+ /**
81
+ * Tests - Lib - Version Strategy Migration - Prepare And Apply - Rejects Pending Entries Before Preparing Any Writes.
82
+ *
83
+ * @since 0.34.0
84
+ */
85
+ export type Tests_Lib_VersionStrategyMigration_PrepareAndApply_RejectsPendingEntriesBeforePreparingAnyWrites_Returns = void;
@@ -19,3 +19,7 @@ export type Tests_Lib_WorkflowTemplates_PublishTargets_MarksPerAppDeployCredsWit
19
19
  export type Tests_Lib_WorkflowTemplates_PublishTargets_MarksPerAppDeployCredsWithAppScopeAndAccountCredsWithAccountScope_Targets = Lib_WorkflowTemplates_Entry_Targets | undefined;
20
20
  export type Tests_Lib_WorkflowTemplates_PublishTargets_MarksPerAppDeployCredsWithAppScopeAndAccountCredsWithAccountScope_Vercel = Shared_WorkflowTemplateTarget | undefined;
21
21
  export type Tests_Lib_WorkflowTemplates_PublishTargets_MarksPerAppDeployCredsWithAppScopeAndAccountCredsWithAccountScope_CloudflareWorkers = Shared_WorkflowTemplateTarget | undefined;
22
+ export type Tests_Lib_WorkflowTemplates_PublishTargets_StoresContainerIdentityAsTargetRequiredLiterals_PublishEntry = Lib_WorkflowTemplates_Entry | undefined;
23
+ export type Tests_Lib_WorkflowTemplates_PublishTargets_StoresContainerIdentityAsTargetRequiredLiterals_Targets = Lib_WorkflowTemplates_Entry_Targets | undefined;
24
+ export type Tests_Lib_WorkflowTemplates_PublishTargets_StoresContainerIdentityAsTargetRequiredLiterals_DockerHub = Shared_WorkflowTemplateTarget | undefined;
25
+ export type Tests_Lib_WorkflowTemplates_PublishTargets_StoresContainerIdentityAsTargetRequiredLiterals_Ghcr = Shared_WorkflowTemplateTarget | undefined;
@@ -0,0 +1,14 @@
1
+ import type { ESLint } from 'eslint';
2
+
3
+ /**
4
+ * Tests - Presets - ESLint - DX Ignore.
5
+ *
6
+ * @since 0.34.0
7
+ */
8
+ export type Tests_Presets_Eslint_DxIgnore_DxIgnore_IgnoresRootAssetsWhilePreservingTheREADMEAndNestedSourceAssets_Eslint = ESLint;
9
+
10
+ export type Tests_Presets_Eslint_DxIgnore_DxIgnore_IgnoresRootAssetsWhilePreservingTheREADMEAndNestedSourceAssets_RootReadmeIgnored = boolean;
11
+
12
+ export type Tests_Presets_Eslint_DxIgnore_DxIgnore_IgnoresRootAssetsWhilePreservingTheREADMEAndNestedSourceAssets_RootAssetIgnored = boolean;
13
+
14
+ export type Tests_Presets_Eslint_DxIgnore_DxIgnore_IgnoresRootAssetsWhilePreservingTheREADMEAndNestedSourceAssets_NestedSourceAssetIgnored = boolean;
@@ -134,6 +134,10 @@ export type Tests_ScaffoldOutputContract_VerifyGeneratedOutput_TsconfigRaw = str
134
134
 
135
135
  export type Tests_ScaffoldOutputContract_VerifyGeneratedOutput_Tsconfig = Record<string, unknown>;
136
136
 
137
+ export type Tests_ScaffoldOutputContract_VerifyGeneratedOutput_TsconfigReferences = unknown;
138
+
139
+ export type Tests_ScaffoldOutputContract_VerifyGeneratedOutput_TsconfigFileList = unknown;
140
+
137
141
  export type Tests_ScaffoldOutputContract_VerifyGeneratedOutput_TsconfigExtends = string[];
138
142
 
139
143
  export type Tests_ScaffoldOutputContract_VerifyGeneratedOutput_PackageJsonIndex = number;
@@ -199,6 +203,10 @@ export type Tests_ScaffoldOutputContract_VerifyScriptContract_HasParent = boolea
199
203
 
200
204
  export type Tests_ScaffoldOutputContract_VerifyScriptContract_ParentIndex = number;
201
205
 
206
+ export type Tests_ScaffoldOutputContract_VerifyScriptContract_WorkspaceParentCommand = string;
207
+
208
+ export type Tests_ScaffoldOutputContract_VerifyScriptContract_RootParentCommand = string;
209
+
202
210
  export type Tests_ScaffoldOutputContract_VerifyScriptContract_ExpectedParentCommand = string;
203
211
 
204
212
  export type Tests_ScaffoldOutputContract_VerifyScriptContract_ExpectedGroupNames = string[];
@@ -226,16 +234,34 @@ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedNovaConf
226
234
 
227
235
  export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedNovaConfig = Record<string, unknown>;
228
236
 
237
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedProject = Record<string, unknown>;
238
+
239
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedSettings = Record<string, unknown>;
240
+
241
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedRunWorkspacesSettings = Record<string, unknown>;
242
+
229
243
  export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedRecipes = Record<string, unknown>;
230
244
 
231
245
  export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedMiscellaneousRecipes = Record<string, unknown>;
232
246
 
247
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedPackageJsonRecipes = Record<string, unknown>;
248
+
249
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedRootPackageJsonRecipes = Record<string, Record<string, unknown>>;
250
+
251
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedPackageJsonRecipeNames = string[];
252
+
253
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedAllowScripts = Record<string, boolean>;
254
+
233
255
  export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedDependencies = Record<string, unknown>;
234
256
 
235
257
  export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedDevDependencies = Record<string, unknown>;
236
258
 
237
259
  export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedScripts = Record<string, unknown>;
238
260
 
261
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedPackageJsonRecipeName = string;
262
+
263
+ export type Tests_ScaffoldOutputContract_VerifyStarterContract_GeneratedPackageJsonRecipe = Record<string, unknown> | undefined;
264
+
239
265
  /**
240
266
  * Tests - Scaffold Output Contract - Verify Template Contract.
241
267
  *
@@ -1,97 +1,62 @@
1
1
  # PROJECT_RULES.md
2
2
 
3
+ <!--
4
+ PROJECT_RULES.md records the repository's current, enforceable operating contract. Describe what
5
+ exists and how contributors work with it today. Product aspirations, future capabilities, and
6
+ unresolved product decisions belong in VISION.md.
7
+
8
+ Keep the top-level sections below in this order. If an enforceable repository rule does not fit a
9
+ canonical section, add a descriptive third-level heading under "Additional Project Rules" rather
10
+ than creating another second-level section. Do not hard-code tool, dependency, platform, or
11
+ release versions; point to the authoritative manifest or configuration instead.
12
+ -->
13
+
3
14
  ## Project Identity
4
15
 
5
16
  ### Name and Description
6
17
 
7
18
  <!--
8
- The canonical project name, a one-line description, and the primary programming language.
9
-
10
- - **Project name:** Name
19
+ - **Project name:** Canonical name.
11
20
  - **Description:** One-line description.
12
- - **Primary language:** Language
13
- - **Framework / runtime:** Framework or runtime (e.g. Next.js, Express, SwiftUI, Spring Boot)
21
+ - **Primary languages:** Languages used by the repository.
22
+ - **Frameworks / runtimes:** Frameworks and runtimes used by the repository.
14
23
  -->
15
24
 
16
25
  ### Repository URL
17
26
 
18
- <!--
19
- The full GitHub URL for this repository.
27
+ <!-- - **URL:** Full canonical repository URL. -->
20
28
 
21
- - **URL:** https://github.com/owner/repo
22
- -->
29
+ ## Repository Structure
23
30
 
24
- ## Repository Layout
31
+ ### Repository Layout
25
32
 
26
33
  <!--
27
- A top-level directory tree showing every folder at the first two levels. Annotate each entry with a short description. Files that live at the root level should also be listed.
34
+ Show the root and the first useful level of every owned directory. Include important root files
35
+ and annotate each entry with its current responsibility. Do not list generated dependency or
36
+ build directories.
28
37
 
29
- ```
30
- repo-root/
31
- ├── .github/ — GitHub Actions workflows, issue templates, funding
32
- ├── docs/ — Documentation site source (Docusaurus)
33
- ├── src/ — Application source code
34
- │ ├── lib/ — Shared libraries and utilities
35
- │ ├── cli/ — CLI entry points and commands
36
- │ ├── types/ — TypeScript type definitions (.d.ts)
37
- │ └── tests/ — Unit and integration tests
38
- ├── scripts/ — Build, deploy, and maintenance scripts
39
- ├── .editorconfig — Editor formatting rules
40
- ├── .gitignore — Git ignore patterns
41
- ├── CHANGELOG.md — Release history
42
- ├── LICENSE — MIT license
43
- ├── README.md — Project overview and badges
44
- ├── package.json — Node.js manifest and scripts
45
- └── tsconfig.json — TypeScript compiler configuration
38
+ ```text
39
+ repository/
40
+ ├── apps/ — Deployable application workspaces
41
+ ├── packages/ — Reusable package workspaces
42
+ ├── scripts/ — Repository maintenance scripts
43
+ ├── nova.config.json — Nova project and workspace configuration
44
+ └── package.json — Root workspace manifest
46
45
  ```
47
46
  -->
48
47
 
49
- ## Source Structure
48
+ ### Source Structure
50
49
 
51
- <!--
52
- A detailed directory tree of the primary source folder (e.g. `src/`, `app/`, `lib/`). Go as deep as needed to show every module, grouped by domain. Annotate each file or folder with its responsibility.
50
+ <!-- Describe each source root deeply enough that a contributor can find the correct ownership boundary without searching the entire repository. -->
53
51
 
54
- ```
55
- src/
56
- ├── cli/
57
- │ ├── commands/
58
- │ │ ├── build.ts — `build` command handler
59
- │ │ └── publish.ts — `publish` command handler
60
- │ └── index.ts — CLI entry point, argument parsing
61
- ├── lib/
62
- │ ├── config.ts — Configuration loader and validator
63
- │ ├── schema.ts — Zod schemas for external API responses
64
- │ └── regex.ts — Shared regex patterns
65
- ├── toolkit/
66
- │ ├── logger.ts — Structured logging utility
67
- │ ├── markdown-table.ts — Markdown table builder
68
- │ └── index.ts — Barrel exports for toolkit
69
- ├── types/
70
- │ ├── cli/
71
- │ │ └── commands.d.ts — Types for CLI commands
72
- │ ├── lib/
73
- │ │ └── config.d.ts — Types for configuration
74
- │ └── shared.d.ts — Shared type aliases
75
- └── tests/
76
- ├── cli/
77
- │ └── commands.test.ts
78
- └── lib/
79
- └── config.test.ts
80
- ```
81
- -->
82
-
83
- ## Key Files
52
+ ### Key Files
84
53
 
85
54
  <!--
86
- List the most important files a contributor or AI agent should know about. Include the file path, what it does, and when you would need to touch it.
87
-
88
- | File | Purpose | When to modify |
89
- |---------------------|-----------------|--------------------------------------------------------|
90
- | `src/cli/index.ts` | CLI entry point | Adding or changing CLI commands |
91
- | `src/lib/config.ts` | Config loader | Changing configuration shape or defaults |
92
- | `package.json` | Manifest | Adding dependencies, changing scripts, bumping version |
93
- | `tsconfig.json` | TS config | Changing compiler options or path aliases |
94
- | `CHANGELOG.md` | Release notes | Every user-facing change |
55
+ List the files a contributor or agent must understand before changing the repository.
56
+
57
+ | File | Purpose | When to modify |
58
+ |------|---------|----------------|
59
+ | Path | Purpose | Trigger |
95
60
  -->
96
61
 
97
62
  ## Build and Tooling
@@ -99,192 +64,138 @@ List the most important files a contributor or AI agent should know about. Inclu
99
64
  ### Prerequisites
100
65
 
101
66
  <!--
102
- List every tool that must be installed before building, with minimum version requirements.
67
+ Reference authoritative version declarations rather than copying mutable version numbers.
103
68
 
104
- | Tool | Version | Purpose |
105
- |---------|---------|-----------------------------|
106
- | Node.js | >= 22.x | Runtime |
107
- | npm | >= 10.x | Package manager |
108
- | Docker | >= 27.x | Container builds (optional) |
69
+ | Tool | Version source | Purpose |
70
+ |------|--------------------------------|---------|
71
+ | Tool | Manifest or configuration path | Purpose |
109
72
  -->
110
73
 
111
74
  ### Commands
112
75
 
113
76
  <!--
114
- List every build, test, lint, and dev command available. Use the exact command the developer runs.
115
-
116
- | Command | What it does |
117
- |-----------------|------------------------------------------|
118
- | `npm install` | Install all dependencies |
119
- | `npm run build` | Compile TypeScript to JavaScript |
120
- | `npm run dev` | Start development server with hot reload |
121
- | `npm run lint` | Run ESLint across the project |
122
- | `npm test` | Run the test suite |
77
+ List the exact supported commands and the directory from which they run.
78
+
79
+ | Command | What it does |
80
+ |---------|--------------|
81
+ | Command | Behavior |
123
82
  -->
124
83
 
125
84
  ### Environment Variables
126
85
 
127
86
  <!--
128
- List every environment variable the project reads, its purpose, and whether it is required or optional.
87
+ List every environment variable the repository reads. Explain its source, sensitivity, and whether
88
+ it is required. State "None" when the repository reads no environment variables.
129
89
 
130
- | Variable | Required | Purpose |
131
- |-------------|----------|-------------------------------------------|
132
- | `API_KEY` | Yes | Authentication token for the external API |
133
- | `LOG_LEVEL` | No | Logging verbosity (default: `info`) |
90
+ | Variable | Required | Sensitive | Purpose |
91
+ |----------|----------|-----------|---------|
92
+ | Variable | Yes / No | Yes / No | Purpose |
134
93
  -->
135
94
 
136
95
  ## Workspace Rules
137
96
 
138
- ### Naming Conventions
97
+ ### Workspace Inventory
139
98
 
140
- <!--
141
- Summarize the naming rules that apply specifically to this project (beyond the universal conventions). Include examples.
99
+ <!-- List every Nova workspace, its role, its policy, and its responsibility. -->
142
100
 
143
- | Entity | Convention | Example |
144
- |-----------------|-------------------|------------------------------------|
145
- | CLI commands | kebab-case verb | `sync-packages`, `write-changelog` |
146
- | Config keys | camelCase | `workingDir`, `packageName` |
147
- | Database tables | snake_case plural | `user_sessions`, `api_tokens` |
148
- -->
101
+ ### Versioning and Release Model
102
+
103
+ <!-- Explain which workspaces are versioned, how their version strategies relate, and where those strategies are configured. Do not copy a mutable release number. -->
104
+
105
+ ### Manifest and Configuration Rules
106
+
107
+ <!-- Record repository-specific rules for manifests and configuration files, including canonical ordering, ownership, and normalization behavior. -->
108
+
109
+ ### Naming Conventions
110
+
111
+ <!-- Record repository-specific naming rules that are not already owned by conventions/*.md. -->
149
112
 
150
113
  ### Do / Don't
151
114
 
152
115
  <!--
153
- Project-specific rules that are not covered by the language convention files. These are guardrails for contributors and AI agents.
116
+ Record enforceable repository-wide guardrails with their rationale.
154
117
 
155
118
  **Do:**
156
- - Rule with rationale.
157
- - Rule with rationale.
119
+ - Rule and rationale.
158
120
 
159
121
  **Don't:**
160
- - Anti-pattern with explanation of why.
161
- - Anti-pattern with explanation of why.
122
+ - Prohibited pattern and rationale.
162
123
  -->
163
124
 
164
- ## Project-Specific Patterns
125
+ ## Architecture and Data
165
126
 
166
127
  ### Architecture
167
128
 
168
- <!--
169
- Describe the high-level architecture pattern this project follows (e.g. layered, hexagonal, MVC, CLI pipeline). Include a diagram if helpful.
129
+ <!-- Describe the current architectural layers, ownership boundaries, and dependency direction. -->
170
130
 
171
- ```
172
- User Input
173
- │
174
- ▼
175
- CLI Layer (argument parsing, validation)
176
- │
177
- ▼
178
- Service Layer (business logic, orchestration)
179
- │
180
- ▼
181
- Data Layer (file I/O, API calls, database)
182
- ```
183
- -->
131
+ ### Data Flow and Ownership
184
132
 
185
- ### Data Flow
133
+ <!-- Explain how data enters, moves through, and leaves the system, including which component owns each persistent or externally visible state. -->
186
134
 
187
- <!--
188
- Describe how data moves through the system from input to output. Name the key stages and the module responsible for each.
135
+ ### Error Strategy
189
136
 
190
- 1. **Input** — Where data enters (CLI args, HTTP request, file read). Module: `src/cli/index.ts`.
191
- 2. **Validation** — How input is validated. Module: `src/lib/config.ts`.
192
- 3. **Processing** — Core transformation or business logic. Module: `src/lib/processor.ts`.
193
- 4. **Output** — Where results go (stdout, file write, API call). Module: `src/cli/index.ts`.
194
- -->
137
+ <!-- Explain how each architectural layer reports, propagates, records, and presents failures. -->
195
138
 
196
- ### Error Strategy
139
+ ## Project Guardrails
197
140
 
198
- <!--
199
- How does this project handle errors at each layer? List the approach per layer.
200
-
201
- | Layer | Strategy |
202
- |--------------------|------------------------------------------------------|
203
- | CLI entry point | Catch all, log, set `process.exitCode = 1`, return |
204
- | Service functions | Throw on failure (caller catches) |
205
- | External API calls | Zod `.parse()` for validation, try/catch for network |
206
- | File I/O | try/catch, descriptive error message with file path |
207
- -->
141
+ ### Security, Privacy, and Secrets
208
142
 
209
- ## Documentation Site
143
+ <!-- Record authentication, authorization, secret-storage, privacy, and sensitive-data rules that contributors must preserve. -->
210
144
 
211
- ### Framework
145
+ ### Platform and Domain Rules
212
146
 
213
- <!--
214
- Which documentation framework is used, and where its source lives.
147
+ <!-- Record rules imposed by the project's platforms or domain. Use fourth-level subsections here when different platforms need separate rules. -->
215
148
 
216
- - **Framework:** Docusaurus / None
217
- - **Source directory:** `docs/`
218
- - **Build output:** `docs/build/`
219
- -->
149
+ ### Compatibility
220
150
 
221
- ### Site Structure
151
+ <!-- Identify supported environments and compatibility contracts by referencing their authoritative declarations rather than copying mutable versions. -->
222
152
 
223
- <!--
224
- A directory tree of the documentation source showing every page and sidebar category.
153
+ ## Testing and Verification
225
154
 
226
- ```
227
- docs/
228
- ├── docusaurus.config.ts — Site configuration
229
- ├── sidebars.ts — Sidebar navigation structure
230
- ├── docs/
231
- │ ├── intro.md — Getting started guide
232
- │ ├── installation.md — Installation instructions
233
- │ ├── configuration.md — Configuration reference
234
- │ └── api/
235
- │ ├── overview.md — API overview
236
- │ └── endpoints.md — Endpoint reference
237
- └── static/
238
- └── img/ — Static images
239
- ```
240
- -->
155
+ ### Test Strategy
241
156
 
242
- ### Commands
157
+ <!-- Describe what is tested at each layer and which behaviors require regression coverage. -->
243
158
 
244
- <!--
245
- Commands for building and previewing the documentation site locally.
159
+ ### Required Verification
246
160
 
247
- | Command | What it does |
248
- |----------------------|----------------------------------------|
249
- | `npm run docs:dev` | Start local dev server with hot reload |
250
- | `npm run docs:build` | Build the static site for production |
251
- -->
161
+ <!-- List the checks required for documentation, implementation, packaging, and release changes. Reference commands defined under Build and Tooling. -->
162
+
163
+ ## Documentation and Ownership
164
+
165
+ ### Documentation Structure
166
+
167
+ <!-- Describe the documentation surfaces, their source directories, and the kind of information each owns. State when there is no dedicated documentation site. -->
168
+
169
+ ### Ownership and Maintenance
170
+
171
+ <!-- State which files are generated, which are edited directly, and what must be updated when repository structure or behavior changes. -->
252
172
 
253
173
  ## Publishing and Deployment
254
174
 
255
175
  ### Release Process
256
176
 
257
- <!--
258
- Step-by-step description of how a new version goes from code to release.
259
-
260
- 1. Run the project's clean install, check, and build gates.
261
- 2. Preview and approve the command-generated changelog release before applying it.
262
- 3. Run the changelog release to fold workspace entries, bump versions, stamp sentinels, and synchronize exact internal pins.
263
- 4. Run check and build again.
264
- 5. Use a separate concise thematic commit message; it is not the same text as the changelog block.
265
- 6. Tag and push the release commit. The publish workflow trigger is project-config dependent; consult the generated workflow.
266
- 7. Build the GitHub Release notes by combining the released workspace changelog files, retaining workspace names while omitting version/date headings.
267
- -->
177
+ <!-- Describe the current release sequence without embedding a release number or a mutable tool version. -->
268
178
 
269
179
  ### CI/CD Workflows
270
180
 
271
181
  <!--
272
- Map each GitHub Actions workflow to what it does and when it runs.
273
-
274
- | Workflow file | Trigger | What it does |
275
- |----------------------------|--------------------|------------------------------------------|
276
- | Generated publish workflow | Project-configured | Build and publish the configured targets |
277
- | `lock-inactive-issues.yml` | Weekly cron | Lock issues inactive > 30 days |
182
+ | Workflow file | Trigger | What it does |
183
+ |---------------|---------|--------------|
184
+ | Path | Trigger | Behavior |
278
185
  -->
279
186
 
280
187
  ### Environments
281
188
 
282
189
  <!--
283
- List every deployment target and its URL or identifier.
190
+ | Environment | URL / Identifier | Purpose |
191
+ |-------------|------------------|---------|
192
+ | Environment | Identifier | Purpose |
193
+ -->
194
+
195
+ ## Additional Project Rules
284
196
 
285
- | Environment | URL / Identifier | Purpose |
286
- |--------------|---------------------------------------|-------------------------|
287
- | npm | `https://www.npmjs.com/package/name` | Public package registry |
288
- | Docker Hub | `https://hub.docker.com/r/owner/name` | Container registry |
289
- | GitHub Pages | `https://owner.github.io/repo` | Documentation site |
197
+ <!--
198
+ Place genuinely repository-specific enforceable rules here under descriptive third-level headings.
199
+ Do not create additional second-level sections. Prefer a canonical section above whenever one fits,
200
+ and move historical context or future intentions to VISION.md instead of placing them here.
290
201
  -->