@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
@@ -341,57 +341,14 @@ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntri
341
341
 
342
342
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_WorkspaceDirectory = string;
343
343
 
344
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_ChangelogDirectory = string;
344
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_RealWorkspaceDirectory = string;
345
345
 
346
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_SourcePath = string;
346
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_ChangelogDirectory = string;
347
347
 
348
348
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_RemainingFiles = string[];
349
349
 
350
350
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_RemainingMdFiles = string[];
351
351
 
352
- /**
353
- * Tests - CLI - Utility - Changelog - Run - Prerelease Version Skips Stamp.
354
- *
355
- * Note: the normal bump arithmetic (split('.').map(Number)) always produces clean
356
- * semver (no '-' suffix), so the prerelease guard in stampUnreleased is not
357
- * reachable through the public run() API. This test exercises the closest
358
- * observable behavior: confirming that a non-prerelease release DOES stamp
359
- * (proving the guard is not blocking normal releases).
360
- *
361
- * @since 0.20.0
362
- */
363
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_ProjectDirectory = string;
364
-
365
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_WorkspaceDirectory = string;
366
-
367
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_ChangelogDirectory = string;
368
-
369
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_SrcDirectory = string;
370
-
371
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_PackageJsonPath = string;
372
-
373
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_PackageJsonContents = string;
374
-
375
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_ConfigPath = string;
376
-
377
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_ConfigContents = string;
378
-
379
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_WorkspacePackagePath = string;
380
-
381
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_WorkspacePackageContents = string;
382
-
383
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_SourceFilePath = string;
384
-
385
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_SourceFileContents = string;
386
-
387
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_EntryPath = string;
388
-
389
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_EntryContents = string;
390
-
391
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_SourceAfterRelease = string;
392
-
393
- export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_PrereleaseVersionSkipsStamp_StampWasApplied = boolean;
394
-
395
352
  /**
396
353
  * Tests - CLI - Utility - Changelog - Run - Records Entry In Non Interactive Mode.
397
354
  *
@@ -690,8 +647,40 @@ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDT
690
647
 
691
648
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_SourceFixturePaths = string[];
692
649
 
650
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_SwiftSourceFixturePaths = string[];
651
+
652
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_SwiftSourceFileContents = string;
653
+
654
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_CsharpSourceFilePath = string;
655
+
656
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_CsharpSourceFileContents = string;
657
+
658
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_GoSourceFilePath = string;
659
+
660
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_GoSourceFileContents = string;
661
+
662
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_PythonSourceFilePath = string;
663
+
664
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_PythonSourceFileContents = string;
665
+
666
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_RustSourceFilePath = string;
667
+
668
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_RustSourceFileContents = string;
669
+
670
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_InlineSourceFilePath = string;
671
+
672
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_InlineSourceFileContents = string;
673
+
674
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_ExtensionlessSourceFilePath = string;
675
+
676
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_ExtensionlessSourceFileContents = string;
677
+
678
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_NonSourceExtensionlessPath = string;
679
+
693
680
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_IgnoredSourceFixturePaths = string[];
694
681
 
682
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_EmbeddedRepositorySourcePath = string;
683
+
695
684
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_RootScriptPath = string;
696
685
 
697
686
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_RootScriptContents = string;
@@ -710,6 +699,20 @@ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDT
710
699
 
711
700
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_StringLiteralPreserved = boolean;
712
701
 
702
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_UpdatedCsharpSource = string;
703
+
704
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_UpdatedGoSource = string;
705
+
706
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_UpdatedPythonSource = string;
707
+
708
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_UpdatedRustSource = string;
709
+
710
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_PythonStampedSentinel = string;
711
+
712
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_PythonStringSentinel = string;
713
+
714
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_StampsUNRELEASEDTokensInSourceFilesOnRelease_UpdatedInlineSource = string;
715
+
713
716
  /**
714
717
  * Tests - CLI - Utility - Changelog - Run - Stamps Workspace Versions Without Entries.
715
718
  *
@@ -81,6 +81,7 @@ export type Tests_Cli_Utility_Configure_ConfigFieldCoverage_Editor =
81
81
  'promptAgents'
82
82
  | 'promptEmails'
83
83
  | 'promptEntities'
84
+ | 'promptEnvironment'
84
85
  | 'promptEnvironmentProject'
85
86
  | 'promptEnvironmentValueForm'
86
87
  | 'promptEnvironmentWorkflow'
@@ -234,6 +234,35 @@ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsAnExplicitP
234
234
 
235
235
  export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsAnExplicitProductionEnvironmentWithoutMutatingTheParent_Output = string;
236
236
 
237
+ /**
238
+ * Tests - CLI - Utility - Run Scripts - Run - Sets Cloudflare Environment Only For Explicit Profiles.
239
+ *
240
+ * @since 0.36.0
241
+ */
242
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ExplicitProjectRoot = string;
243
+
244
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ImplicitProjectRoot = string;
245
+
246
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_PackageJson = string;
247
+
248
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_OriginalCloudflareEnvironment = string | undefined;
249
+
250
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_PackageJsonPath = string;
251
+
252
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ConfigPath = string;
253
+
254
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ExplicitRealProjectRoot = string;
255
+
256
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ExplicitOutputPath = string;
257
+
258
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ExplicitOutput = string;
259
+
260
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ImplicitRealProjectRoot = string;
261
+
262
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ImplicitOutputPath = string;
263
+
264
+ export type Tests_Cli_Utility_RunScripts_CliUtilityRunScriptsRun_SetsCloudflareEnvironmentOnlyForExplicitProfiles_ImplicitOutput = string;
265
+
237
266
  /**
238
267
  * Tests - CLI - Utility - Run Scripts - Run - Stops On First Failure In Sequential Mode.
239
268
  *
@@ -43,6 +43,20 @@ export type Tests_Lib_DockerPackaging_LibDockerPackaging_AssemblesMixedStaticNex
43
43
  export type Tests_Lib_DockerPackaging_LibDockerPackaging_AssemblesMixedStaticNextAndContainerNativeProfilesInsideTheNodeRuntimeClosure_NativeWorkspaceDirectory = string;
44
44
  export type Tests_Lib_DockerPackaging_LibDockerPackaging_AssemblesMixedStaticNextAndContainerNativeProfilesInsideTheNodeRuntimeClosure_DockerfileContent = string;
45
45
 
46
+ /**
47
+ * Tests - Lib - Docker Packaging - LibDockerPackaging - DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces.
48
+ *
49
+ * @since 0.37.0
50
+ */
51
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_ProjectDirectory = string;
52
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_DocsWorkspaceDirectory = string;
53
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_WebWorkspaceDirectory = string;
54
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_ManifestPath = string;
55
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_GeneratedManifestContent = string;
56
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_LegacyManifestContent = string;
57
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_ManifestContent = string;
58
+ export type Tests_Lib_DockerPackaging_LibDockerPackaging_DropsTheLegacyBuildDirectoryFieldFromExistingManifestWorkspaces_DockerfileContent = string;
59
+
46
60
  /**
47
61
  * Tests - Lib - Docker Packaging - LibDockerPackaging - GeneratesOneRootS6ApplianceAndAPrivatePackagesDockerWorkspace.
48
62
  *
@@ -0,0 +1,20 @@
1
+ import type { Shared_NovaConfigEnvironment } from '../../shared.d.ts';
2
+
3
+ /**
4
+ * Tests - Lib - Env Profiles - Migrate Environment Profiles.
5
+ *
6
+ * @since 0.36.0
7
+ */
8
+ export type Tests_Lib_EnvProfiles_MigrateEnvironmentProfiles_SandboxRoot = string;
9
+
10
+ export type Tests_Lib_EnvProfiles_MigrateEnvironmentProfiles_PreservesOriginalModeWhileProfileFilesRoundTripReversibly_WorkspaceDirectory = string;
11
+
12
+ export type Tests_Lib_EnvProfiles_MigrateEnvironmentProfiles_PreservesOriginalModeWhileProfileFilesRoundTripReversibly_OriginalEnv = string;
13
+
14
+ export type Tests_Lib_EnvProfiles_MigrateEnvironmentProfiles_PreservesOriginalModeWhileProfileFilesRoundTripReversibly_OriginalSample = string;
15
+
16
+ export type Tests_Lib_EnvProfiles_MigrateEnvironmentProfiles_PreservesOriginalModeWhileProfileFilesRoundTripReversibly_Environment = Shared_NovaConfigEnvironment;
17
+
18
+ export type Tests_Lib_EnvProfiles_MigrateEnvironmentProfiles_PreservesOriginalModeWhileProfileFilesRoundTripReversibly_StagingContents = string;
19
+
20
+ export type Tests_Lib_EnvProfiles_MigrateEnvironmentProfiles_PreservesOriginalModeWhileProfileFilesRoundTripReversibly_WorkspaceEntries = string[];
@@ -16,19 +16,22 @@ Read and follow the conventions and rules defined in the files below.
16
16
 
17
17
  - [conventions/universal.md](conventions/universal.md) — Workflow, general code style, documentation style, platform build rules, and release notes format.
18
18
  - [conventions/documentation.md](conventions/documentation.md) — Documentation conventions (Docusaurus MDX page structure, voice, and style).
19
+ - [conventions/nova.md](conventions/nova.md) — Nova project configuration, command boundaries, recipes, scaffolds, verification, and release handoff.
19
20
 
20
21
  ### Per Language
21
22
 
22
- - [conventions/typescript.md](conventions/typescript.md) — TypeScript / JavaScript conventions (type system, imports, class structure, code style, TSConfig).
23
- - [conventions/swift.md](conventions/swift.md) — Swift conventions (documentation style, code style).
23
+ - [conventions/csharp.md](conventions/csharp.md) — C# conventions (documentation style, code style).
24
+ - [conventions/css.md](conventions/css.md) — CSS conventions (documentation style, code style).
25
+ - [conventions/docker.md](conventions/docker.md) — Docker conventions (documentation style, code style).
26
+ - [conventions/go.md](conventions/go.md) — Go conventions (documentation, APIs, ownership, errors, concurrency, and tests).
24
27
  - [conventions/java.md](conventions/java.md) — Java conventions (documentation style, code style).
25
28
  - [conventions/kotlin.md](conventions/kotlin.md) — Kotlin conventions (documentation style, code style).
26
- - [conventions/csharp.md](conventions/csharp.md) — C# conventions (documentation style, code style).
27
29
  - [conventions/php.md](conventions/php.md) — PHP conventions (documentation style, code style).
28
30
  - [conventions/python.md](conventions/python.md) — Python conventions (documentation style, code style).
29
- - [conventions/css.md](conventions/css.md) — CSS conventions (documentation style, code style).
30
- - [conventions/docker.md](conventions/docker.md) — Docker conventions (documentation style, code style).
31
+ - [conventions/rust.md](conventions/rust.md) — Rust conventions (documentation, ownership, errors, unsafe code, and tests).
31
32
  - [conventions/shell.md](conventions/shell.md) — Shell conventions (documentation style, code style).
33
+ - [conventions/swift.md](conventions/swift.md) — Swift conventions (documentation style, code style).
34
+ - [conventions/typescript.md](conventions/typescript.md) — TypeScript / JavaScript conventions (type system, imports, class structure, code style, TSConfig).
32
35
 
33
36
  ## Agent Directives
34
37
 
@@ -16,19 +16,22 @@ Read and follow the conventions and rules defined in the files below.
16
16
 
17
17
  - [conventions/universal.md](conventions/universal.md) — Workflow, general code style, documentation style, platform build rules, and release notes format.
18
18
  - [conventions/documentation.md](conventions/documentation.md) — Documentation conventions (Docusaurus MDX page structure, voice, and style).
19
+ - [conventions/nova.md](conventions/nova.md) — Nova project configuration, command boundaries, recipes, scaffolds, verification, and release handoff.
19
20
 
20
21
  ### Per Language
21
22
 
22
- - [conventions/typescript.md](conventions/typescript.md) — TypeScript / JavaScript conventions (type system, imports, class structure, code style, TSConfig).
23
- - [conventions/swift.md](conventions/swift.md) — Swift conventions (documentation style, code style).
23
+ - [conventions/csharp.md](conventions/csharp.md) — C# conventions (documentation style, code style).
24
+ - [conventions/css.md](conventions/css.md) — CSS conventions (documentation style, code style).
25
+ - [conventions/docker.md](conventions/docker.md) — Docker conventions (documentation style, code style).
26
+ - [conventions/go.md](conventions/go.md) — Go conventions (documentation, APIs, ownership, errors, concurrency, and tests).
24
27
  - [conventions/java.md](conventions/java.md) — Java conventions (documentation style, code style).
25
28
  - [conventions/kotlin.md](conventions/kotlin.md) — Kotlin conventions (documentation style, code style).
26
- - [conventions/csharp.md](conventions/csharp.md) — C# conventions (documentation style, code style).
27
29
  - [conventions/php.md](conventions/php.md) — PHP conventions (documentation style, code style).
28
30
  - [conventions/python.md](conventions/python.md) — Python conventions (documentation style, code style).
29
- - [conventions/css.md](conventions/css.md) — CSS conventions (documentation style, code style).
30
- - [conventions/docker.md](conventions/docker.md) — Docker conventions (documentation style, code style).
31
+ - [conventions/rust.md](conventions/rust.md) — Rust conventions (documentation, ownership, errors, unsafe code, and tests).
31
32
  - [conventions/shell.md](conventions/shell.md) — Shell conventions (documentation style, code style).
33
+ - [conventions/swift.md](conventions/swift.md) — Swift conventions (documentation style, code style).
34
+ - [conventions/typescript.md](conventions/typescript.md) — TypeScript / JavaScript conventions (type system, imports, class structure, code style, TSConfig).
32
35
 
33
36
  ## Agent Directives
34
37
 
@@ -5,7 +5,7 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
5
5
  ## Documentation Style
6
6
 
7
7
  - Comment syntax: `///`
8
- - Padding tag: `<remarks>Since v1.0.0</remarks>` (XML doc tag)
8
+ - Padding tag: `<remarks>Since: UNRELEASED</remarks>` (XML documentation) — tag new or changed API with the sentinel; Nova stamps the real version during the workspace release, so never hand-write a version number.
9
9
  - Param format: `<param name="x">X</param>` (description matches the parameter name, capitalized, no trailing period inside XML tags)
10
10
  - Return format: `<returns>Type</returns>`
11
11
  - Blank `///` at top and bottom of every comment block.
@@ -17,13 +17,13 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
17
17
  ///
18
18
  /// Entity Repository.
19
19
  ///
20
- /// <remarks>Since v1.0.0</remarks>
20
+ /// <remarks>Since: UNRELEASED</remarks>
21
21
  ///
22
22
  public class EntityRepository {
23
23
  ///
24
24
  /// Entity Repository - Database.
25
25
  ///
26
- /// <remarks>Since v1.0.0</remarks>
26
+ /// <remarks>Since: UNRELEASED</remarks>
27
27
  ///
28
28
  private readonly Database _database;
29
29
 
@@ -32,7 +32,7 @@ public class EntityRepository {
32
32
  ///
33
33
  /// <param name="database">Database</param>
34
34
  ///
35
- /// <remarks>Since v1.0.0</remarks>
35
+ /// <remarks>Since: UNRELEASED</remarks>
36
36
  ///
37
37
  public EntityRepository(Database database) { ... }
38
38
 
@@ -43,7 +43,7 @@ public class EntityRepository {
43
43
  ///
44
44
  /// <returns>Entity?</returns>
45
45
  ///
46
- /// <remarks>Since v1.0.0</remarks>
46
+ /// <remarks>Since: UNRELEASED</remarks>
47
47
  ///
48
48
  public async Task<Entity?> FindById(Guid id) { ... }
49
49
  }
@@ -314,4 +314,4 @@ Don't inline complex expressions into string interpolation or other expressions.
314
314
 
315
315
  - **Creator** (method designer): may design a method to throw on failure — that's the API contract.
316
316
  - **Consumer** (method caller): always wraps calls to throwing methods in try/catch.
317
- - CLI entry points never throw — set the appropriate exit code with `Environment.ExitCode` and return.
317
+ - CLI entry points never throw — set the appropriate exit code with `Environment.ExitCode` and return.
@@ -0,0 +1,241 @@
1
+ # Go Conventions
2
+
3
+ Formatting: `gofmt`. Import grouping: `goimports`-compatible. File naming:
4
+ lowercase snake_case where separation improves readability (for example,
5
+ `release_client.go` and `release_client_test.go`).
6
+
7
+ These rules preserve the intent of Nova's TypeScript conventions while using
8
+ idiomatic Go. They do not translate TypeScript syntax mechanically.
9
+
10
+ ## Documentation Style
11
+
12
+ - Comment syntax: `//` for declarations and packages.
13
+ - Exported declarations start with the declaration's exact name.
14
+ - Package comments start with `Package <name>` and appear once per package.
15
+ - Add a 2–3 line body explaining why the declaration exists, who uses it, or
16
+ when it matters.
17
+ - New or changed declarations end with `Since: UNRELEASED`. Nova stamps that
18
+ sentinel during the workspace release; never write the release version by
19
+ hand.
20
+ - Document unexported declarations when their contract, concurrency, security,
21
+ or side effects are not obvious from the implementation.
22
+
23
+ ### Example
24
+
25
+ ```go
26
+ // Package release coordinates validated project publication.
27
+ //
28
+ // The package keeps version preparation separate from provider-specific
29
+ // publishing so callers can verify the release state before any upload.
30
+ package release
31
+
32
+ // Client publishes prepared release artifacts.
33
+ //
34
+ // Command handlers depend on Client rather than a concrete provider so tests
35
+ // can exercise release behavior without external network calls.
36
+ //
37
+ // Since: UNRELEASED
38
+ type Client interface {
39
+ Publish(ctx context.Context, request PublishRequest) error
40
+ }
41
+
42
+ // Publish sends a prepared artifact to the configured provider.
43
+ //
44
+ // Callers receive wrapped provider errors with enough context to identify the
45
+ // artifact and operation that failed.
46
+ //
47
+ // Since: UNRELEASED
48
+ func (runner *Runner) Publish(ctx context.Context, request PublishRequest) error {
49
+ err := runner.client.Publish(ctx, request)
50
+ if err != nil {
51
+ return fmt.Errorf("publish %q: %w", request.Name, err)
52
+ }
53
+
54
+ return nil
55
+ }
56
+ ```
57
+
58
+ ## Naming and Files
59
+
60
+ - Package names are short, lowercase, singular words without underscores.
61
+ - Exported names use PascalCase; unexported names use camelCase.
62
+ - Initialisms use Go's established casing (`ID`, `URL`, `HTTP`), including
63
+ inside longer identifiers such as `workspaceID` and `HTTPClient`.
64
+ - Test files end in `_test.go` and live beside the code they exercise.
65
+ - Platform files use Go build suffixes or build constraints rather than runtime
66
+ branching when the implementation is genuinely platform-specific.
67
+ - Avoid abbreviations invented by the project. Established domain and Go
68
+ initialisms remain acceptable.
69
+
70
+ ## Imports
71
+
72
+ - Let `gofmt` preserve blocks and use `goimports` grouping semantics: standard
73
+ library, blank line, third-party, blank line, project-local packages.
74
+ - Import packages by their declared name. Add an alias only to resolve a real
75
+ collision or to clarify an otherwise misleading package name.
76
+ - Never use dot imports outside narrowly justified test helpers.
77
+ - Use blank imports only for deliberate registration side effects and explain
78
+ the side effect in a nearby comment.
79
+
80
+ ## Types and APIs
81
+
82
+ ### Interfaces Belong to Consumers
83
+
84
+ Declare an interface where it is consumed, not beside the concrete type by
85
+ default. Keep interfaces as small as the behavior the consumer actually needs.
86
+ Return concrete types unless abstraction is part of the public contract.
87
+
88
+ ```go
89
+ // GOOD — the consumer owns the capability it needs.
90
+ type tokenValidator interface {
91
+ Validate(ctx context.Context, token string) error
92
+ }
93
+ ```
94
+
95
+ ### Context Placement
96
+
97
+ Functions that accept `context.Context` place it first and name it `ctx`. Do not
98
+ store contexts in structs. Propagate cancellation to every blocking operation
99
+ that supports it.
100
+
101
+ ### Options and Zero Values
102
+
103
+ - Prefer a useful zero value when the type can provide one safely.
104
+ - Use an options struct when a function needs several related or optional
105
+ values.
106
+ - Avoid boolean parameters whose meaning is unclear at the call site; use a
107
+ named option or domain type instead.
108
+ - Do not add getters mechanically. Export a field only when it is intentionally
109
+ part of the data contract; otherwise expose behavior.
110
+
111
+ ### Pointer and Value Semantics
112
+
113
+ - Use pointer receivers when a method mutates the receiver, the type contains a
114
+ synchronization primitive, or copying is materially expensive.
115
+ - Keep the receiver form consistent across a type's method set.
116
+ - Do not use a pointer solely to signal optionality when an explicit result or
117
+ option type communicates the state better.
118
+ - Never copy values containing `sync.Mutex`, `sync.Once`, or related state.
119
+
120
+ ## Control Flow
121
+
122
+ ### Errors Are Explicit
123
+
124
+ - Handle every returned error unless the API contract proves it cannot matter.
125
+ - Return errors as the last result.
126
+ - Wrap errors with operation and subject context using `%w` so callers can use
127
+ `errors.Is` and `errors.As`.
128
+ - Do not compare error strings.
129
+ - Reserve `panic` for broken invariants or process-startup conditions that
130
+ cannot be represented as a recoverable error.
131
+
132
+ ```go
133
+ contents, err := os.ReadFile(configPath)
134
+ if err != nil {
135
+ return fmt.Errorf("read config %q: %w", configPath, err)
136
+ }
137
+ ```
138
+
139
+ ### Early Returns
140
+
141
+ Handle invalid input and failures first. Keep the successful path at the lowest
142
+ indentation level. Avoid `else` after a branch that returns, continues, breaks,
143
+ or panics.
144
+
145
+ ### Switches
146
+
147
+ - Prefer a `switch` when one value or state has several meaningful branches.
148
+ - Keep each case focused and avoid implicit control flow through `fallthrough`.
149
+ - Include a default branch when unknown input is possible; omit it for a closed
150
+ type switch only when the compiler and tests make completeness clear.
151
+
152
+ ### Loops and Collections
153
+
154
+ - Use `range` when the index or key/value pair is meaningful.
155
+ - Name loop values after the singular collection element; do not use one-letter
156
+ names except conventional, tiny mathematical scopes.
157
+ - Preallocate slices or maps when the final size is known and materially useful.
158
+ - Preserve the contract distinction between `nil` and empty collections when
159
+ serializing or crossing an API boundary.
160
+
161
+ ## Concurrency
162
+
163
+ - Every goroutine has an identifiable owner, completion path, and cancellation
164
+ strategy.
165
+ - Do not start a goroutine merely to avoid blocking the current function.
166
+ - Close channels from the sending side. Do not close a channel when multiple
167
+ senders cannot agree on ownership.
168
+ - Use `errgroup`-style coordination when sibling operations must cancel and
169
+ report one another's errors.
170
+ - Protect shared mutable state explicitly; do not rely on timing or incidental
171
+ execution order.
172
+ - Run the race detector for concurrency-sensitive changes when the environment
173
+ supports it.
174
+
175
+ ## Code Organization
176
+
177
+ - Keep declarations near the behavior they support rather than collecting
178
+ unrelated helpers into a utility package.
179
+ - Order a file so its public contract is discoverable first: exported types,
180
+ constructors, exported functions and methods, then private helpers.
181
+ - Keep initialization explicit. Avoid `init()` unless registration must happen
182
+ before `main` and no ordinary constructor can express it.
183
+ - Extract nested calls into named values when doing so clarifies validation,
184
+ error reporting, or side effects.
185
+ - Separate distinct operations with blank lines; do not stack process comments
186
+ without the code they describe.
187
+
188
+ ## Tests
189
+
190
+ - Prefer table-driven tests when several cases exercise the same contract.
191
+ - Give each case a stable descriptive name and run subtests with `t.Run`.
192
+ - Mark shared test helpers with `t.Helper()`.
193
+ - Keep tests deterministic and isolated from the network, wall clock, and user
194
+ machine unless the suite explicitly provides those dependencies.
195
+ - Use temporary directories from `t.TempDir()` and automatic cleanup through
196
+ `t.Cleanup()`.
197
+ - Test exported behavior and important failure paths; do not duplicate the
198
+ implementation inside the assertion logic.
199
+
200
+ ```go
201
+ func TestParseMode(t *testing.T) {
202
+ tests := []struct {
203
+ name string
204
+ input string
205
+ want Mode
206
+ }{
207
+ {
208
+ name: "production",
209
+ input: "production",
210
+ want: ModeProduction,
211
+ },
212
+ }
213
+
214
+ for _, test := range tests {
215
+ t.Run(test.name, func(t *testing.T) {
216
+ got, err := ParseMode(test.input)
217
+ if err != nil {
218
+ t.Fatalf("ParseMode() error = %v", err)
219
+ }
220
+
221
+ if got != test.want {
222
+ t.Fatalf("ParseMode() = %q, want %q", got, test.want)
223
+ }
224
+ })
225
+ }
226
+ }
227
+ ```
228
+
229
+ ## Verification
230
+
231
+ Run the project's configured commands. When working directly with a Go
232
+ workspace, the minimum language checks are:
233
+
234
+ ```bash
235
+ go fmt ./...
236
+ go vet ./...
237
+ go test ./...
238
+ ```
239
+
240
+ Use the repository's Nova scripts when they wrap these commands; do not bypass
241
+ additional project checks defined in `nova.config.json` or `package.json`.