@cbnventures/nova 0.35.0 → 0.36.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.
- package/bin/nova.mjs +17 -0
- package/build/package.json +3 -2
- package/build/scaffold-versions.json +16 -6
- package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts +2 -2
- package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts.map +1 -1
- package/build/src/cli/generate/github/workflows-blueprint-validate.js +116 -3
- package/build/src/cli/generate/github/workflows-blueprint-validate.js.map +1 -1
- package/build/src/cli/generate/github/workflows-blueprint.d.ts +11 -5
- package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
- package/build/src/cli/generate/github/workflows-blueprint.js +411 -35
- package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
- package/build/src/cli/generate/must-haves/agent-conventions.d.ts.map +1 -1
- package/build/src/cli/generate/must-haves/agent-conventions.js +3 -0
- package/build/src/cli/generate/must-haves/agent-conventions.js.map +1 -1
- package/build/src/cli/generate/must-haves/dotenv.d.ts.map +1 -1
- package/build/src/cli/generate/must-haves/dotenv.js +1 -0
- package/build/src/cli/generate/must-haves/dotenv.js.map +1 -1
- package/build/src/cli/scaffold/app/vite.js +1 -1
- package/build/src/cli/scaffold/app/vite.js.map +1 -1
- package/build/src/cli/utility/changelog.d.ts.map +1 -1
- package/build/src/cli/utility/changelog.js +119 -67
- package/build/src/cli/utility/changelog.js.map +1 -1
- package/build/src/cli/utility/configure.d.ts.map +1 -1
- package/build/src/cli/utility/configure.js +126 -1
- package/build/src/cli/utility/configure.js.map +1 -1
- package/build/src/lib/corepack.d.ts +2 -2
- package/build/src/lib/corepack.d.ts.map +1 -1
- package/build/src/lib/corepack.js +16 -6
- package/build/src/lib/corepack.js.map +1 -1
- package/build/src/lib/docker-packaging.d.ts.map +1 -1
- package/build/src/lib/docker-packaging.js +5 -4
- package/build/src/lib/docker-packaging.js.map +1 -1
- package/build/src/lib/dotenv.d.ts.map +1 -1
- package/build/src/lib/dotenv.js +17 -8
- package/build/src/lib/dotenv.js.map +1 -1
- package/build/src/lib/env-managed-set.d.ts.map +1 -1
- package/build/src/lib/env-managed-set.js +55 -11
- package/build/src/lib/env-managed-set.js.map +1 -1
- package/build/src/lib/env-namespace.d.ts.map +1 -1
- package/build/src/lib/env-namespace.js +1 -0
- package/build/src/lib/env-namespace.js.map +1 -1
- package/build/src/lib/env-profiles.d.ts +3 -0
- package/build/src/lib/env-profiles.d.ts.map +1 -0
- package/build/src/lib/env-profiles.js +70 -0
- package/build/src/lib/env-profiles.js.map +1 -0
- package/build/src/lib/env-status.d.ts.map +1 -1
- package/build/src/lib/env-status.js +23 -2
- package/build/src/lib/env-status.js.map +1 -1
- package/build/src/lib/item.d.ts.map +1 -1
- package/build/src/lib/item.js +20 -3
- package/build/src/lib/item.js.map +1 -1
- package/build/src/lib/nova-config.d.ts.map +1 -1
- package/build/src/lib/nova-config.js +31 -0
- package/build/src/lib/nova-config.js.map +1 -1
- package/build/src/lib/regex.d.ts +7 -0
- package/build/src/lib/regex.d.ts.map +1 -1
- package/build/src/lib/regex.js +7 -0
- package/build/src/lib/regex.js.map +1 -1
- package/build/src/lib/run-scripts.d.ts.map +1 -1
- package/build/src/lib/run-scripts.js +24 -0
- package/build/src/lib/run-scripts.js.map +1 -1
- package/build/src/lib/scaffold.d.ts.map +1 -1
- package/build/src/lib/scaffold.js +7 -0
- package/build/src/lib/scaffold.js.map +1 -1
- package/build/src/lib/workflow-templates.js +4 -4
- package/build/src/lib/workflow-templates.js.map +1 -1
- package/build/src/types/cli/generate/github/workflows-blueprint-validate.d.ts +42 -4
- package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +193 -17
- package/build/src/types/cli/utility/changelog.d.ts +49 -6
- package/build/src/types/cli/utility/configure.d.ts +52 -0
- package/build/src/types/lib/corepack.d.ts +13 -0
- package/build/src/types/lib/docker-packaging.d.ts +1 -0
- package/build/src/types/lib/dotenv.d.ts +10 -3
- package/build/src/types/lib/env-managed-set.d.ts +15 -0
- package/build/src/types/lib/env-namespace.d.ts +5 -0
- package/build/src/types/lib/env-profiles.d.ts +67 -0
- package/build/src/types/lib/env-status.d.ts +9 -0
- package/build/src/types/lib/item.d.ts +20 -3
- package/build/src/types/lib/nova-config.d.ts +14 -0
- package/build/src/types/lib/run-scripts.d.ts +16 -0
- package/build/src/types/lib/scaffold.d.ts +8 -0
- package/build/src/types/shared.d.ts +47 -0
- package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +20 -0
- package/build/src/types/tests/cli/generate/github/workflows-blueprint-validate.test.d.ts +22 -0
- package/build/src/types/tests/cli/generate/github/workflows-blueprint.test.d.ts +16 -0
- package/build/src/types/tests/cli/generate/must-haves/agent-conventions.test.d.ts +40 -0
- package/build/src/types/tests/cli/utility/changelog.test.d.ts +48 -45
- package/build/src/types/tests/cli/utility/configure.test.d.ts +1 -0
- package/build/src/types/tests/cli/utility/run-scripts.test.d.ts +29 -0
- package/build/src/types/tests/lib/env-profiles.test.d.ts +20 -0
- package/build/templates/generators/must-haves/agent-conventions/AGENTS.md +8 -5
- package/build/templates/generators/must-haves/agent-conventions/CLAUDE.md +8 -5
- package/build/templates/generators/must-haves/agent-conventions/conventions/csharp.md +6 -6
- package/build/templates/generators/must-haves/agent-conventions/conventions/go.md +241 -0
- package/build/templates/generators/must-haves/agent-conventions/conventions/nova.md +155 -0
- package/build/templates/generators/must-haves/agent-conventions/conventions/python.md +7 -7
- package/build/templates/generators/must-haves/agent-conventions/conventions/rust.md +227 -0
- package/build/templates/generators/must-haves/agent-conventions/conventions/swift.md +9 -9
- package/build/templates/generators/must-haves/agent-conventions/conventions/typescript.md +145 -23
- package/build/templates/generators/must-haves/agent-conventions/conventions/universal.md +112 -103
- package/build/templates/generators/must-haves/ignore-files/gitignore +1 -0
- package/build/templates/scaffold/app/android/package.json +1 -1
- package/build/templates/scaffold/app/apple/Sources/App.swift +15 -2
- package/build/templates/scaffold/app/apple/Tests/AppTests.swift +14 -2
- package/build/templates/scaffold/app/apple/package.json +1 -1
- package/build/templates/scaffold/app/astro/package.json +1 -1
- package/build/templates/scaffold/app/discord-bot/package.json +1 -1
- package/build/templates/scaffold/app/express/package.json +1 -1
- package/build/templates/scaffold/app/nextjs/package.json +1 -1
- package/build/templates/scaffold/app/vite/package.json +2 -2
- package/build/templates/scaffold/app/vite/vite.config.mts +3 -0
- package/build/templates/scaffold/docs/docusaurus/package.json +2 -2
- package/build/templates/scaffold/docs/docusaurus/vitest.config.mts +9 -0
- package/build/templates/scaffold/package/github-action/package.json +1 -1
- package/build/templates/scaffold/package/homebridge/package.json +1 -1
- package/build/templates/scaffold/package/pfsense/package.json +1 -1
- package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc +10 -0
- package/build/templates/scaffold/package/pfsense-root/.github/workflows/pfsense-[__WORKSPACE_NAME__].yml +62 -0
- package/build/templates/scaffold-options/app/android-native/.gitattributes +2 -0
- package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/MainActivity.kt +16 -2
- package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/NavigationKeys.kt +7 -1
- package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/data/DataRepository.kt +28 -4
- package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Color.kt +40 -6
- package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Theme.kt +22 -1
- package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Type.kt +8 -2
- package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModel.kt +42 -6
- package/build/templates/scaffold-options/app/android-native/app/src/test/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModelTest.kt +31 -4
- package/build/templates/scaffold-options/app/astro/cloudflare/public/.assetsignore +15 -0
- package/build/templates/scaffold-options/docker-image/common/dockerignore +2 -0
- package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/package.json +1 -1
- package/build/templates/scaffold-options/tool/serverless/vercel-functions/package.json +1 -1
- 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
|
|
344
|
+
export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_KeepsPendingEntriesWhenStampingFails_RealWorkspaceDirectory = string;
|
|
345
345
|
|
|
346
|
-
export type
|
|
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
|
*
|
|
@@ -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
|
*
|
|
@@ -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/
|
|
23
|
-
- [conventions/
|
|
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/
|
|
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/
|
|
23
|
-
- [conventions/
|
|
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/
|
|
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
|
|
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
|
|
20
|
+
/// <remarks>Since: UNRELEASED</remarks>
|
|
21
21
|
///
|
|
22
22
|
public class EntityRepository {
|
|
23
23
|
///
|
|
24
24
|
/// Entity Repository - Database.
|
|
25
25
|
///
|
|
26
|
-
/// <remarks>Since
|
|
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
|
|
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
|
|
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`.
|