@cbnventures/nova 0.39.0 → 0.40.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/build/package.json +1 -1
  2. package/build/scaffold-versions.json +0 -19
  3. package/build/src/api/docker-hub.d.ts +14 -0
  4. package/build/src/api/docker-hub.d.ts.map +1 -0
  5. package/build/src/api/docker-hub.js +275 -0
  6. package/build/src/api/docker-hub.js.map +1 -0
  7. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts +2 -2
  8. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts.map +1 -1
  9. package/build/src/cli/generate/github/workflows-blueprint-validate.js +60 -57
  10. package/build/src/cli/generate/github/workflows-blueprint-validate.js.map +1 -1
  11. package/build/src/cli/generate/github/workflows-blueprint.d.ts +3 -3
  12. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  13. package/build/src/cli/generate/github/workflows-blueprint.js +15 -72
  14. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  15. package/build/src/cli/index.js +29 -0
  16. package/build/src/cli/index.js.map +1 -1
  17. package/build/src/cli/recipe/docker-hub/docker-hub-precheck.d.ts +3 -0
  18. package/build/src/cli/recipe/docker-hub/docker-hub-precheck.d.ts.map +1 -0
  19. package/build/src/cli/recipe/docker-hub/docker-hub-precheck.js +72 -0
  20. package/build/src/cli/recipe/docker-hub/docker-hub-precheck.js.map +1 -0
  21. package/build/src/cli/recipe/docker-hub/sync-identity.d.ts +5 -0
  22. package/build/src/cli/recipe/docker-hub/sync-identity.d.ts.map +1 -0
  23. package/build/src/cli/recipe/docker-hub/sync-identity.js +124 -0
  24. package/build/src/cli/recipe/docker-hub/sync-identity.js.map +1 -0
  25. package/build/src/cli/recipe/docker-hub/sync-policies.d.ts +5 -0
  26. package/build/src/cli/recipe/docker-hub/sync-policies.d.ts.map +1 -0
  27. package/build/src/cli/recipe/docker-hub/sync-policies.js +63 -0
  28. package/build/src/cli/recipe/docker-hub/sync-policies.js.map +1 -0
  29. package/build/src/cli/recipe/index.d.ts.map +1 -1
  30. package/build/src/cli/recipe/index.js +12 -0
  31. package/build/src/cli/recipe/index.js.map +1 -1
  32. package/build/src/cli/recipe/nova-config/normalize-order.js +3 -3
  33. package/build/src/cli/recipe/nova-config/normalize-order.js.map +1 -1
  34. package/build/src/cli/utility/configure.d.ts +1 -0
  35. package/build/src/cli/utility/configure.d.ts.map +1 -1
  36. package/build/src/cli/utility/configure.js +200 -4
  37. package/build/src/cli/utility/configure.js.map +1 -1
  38. package/build/src/lib/item.d.ts.map +1 -1
  39. package/build/src/lib/item.js +5 -0
  40. package/build/src/lib/item.js.map +1 -1
  41. package/build/src/lib/nova-config-order.d.ts.map +1 -1
  42. package/build/src/lib/nova-config-order.js +35 -1
  43. package/build/src/lib/nova-config-order.js.map +1 -1
  44. package/build/src/lib/nova-config.d.ts +1 -0
  45. package/build/src/lib/nova-config.d.ts.map +1 -1
  46. package/build/src/lib/nova-config.js +132 -1
  47. package/build/src/lib/nova-config.js.map +1 -1
  48. package/build/src/lib/regex.d.ts +2 -0
  49. package/build/src/lib/regex.d.ts.map +1 -1
  50. package/build/src/lib/regex.js +2 -0
  51. package/build/src/lib/regex.js.map +1 -1
  52. package/build/src/lib/schema.d.ts +34 -0
  53. package/build/src/lib/schema.d.ts.map +1 -1
  54. package/build/src/lib/schema.js +31 -0
  55. package/build/src/lib/schema.js.map +1 -1
  56. package/build/src/lib/workflow-templates.d.ts.map +1 -1
  57. package/build/src/lib/workflow-templates.js +2 -30
  58. package/build/src/lib/workflow-templates.js.map +1 -1
  59. package/build/src/types/api/docker-hub.d.ts +237 -0
  60. package/build/src/types/cli/generate/github/workflows-blueprint-validate.d.ts +17 -16
  61. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +14 -15
  62. package/build/src/types/cli/index.d.ts +2 -0
  63. package/build/src/types/cli/recipe/docker-hub/docker-hub-precheck.d.ts +78 -0
  64. package/build/src/types/cli/recipe/docker-hub/sync-identity.d.ts +80 -0
  65. package/build/src/types/cli/recipe/docker-hub/sync-policies.d.ts +57 -0
  66. package/build/src/types/cli/recipe/index.d.ts +3 -1
  67. package/build/src/types/cli/utility/configure.d.ts +107 -0
  68. package/build/src/types/lib/item.d.ts +4 -0
  69. package/build/src/types/lib/nova-config-order.d.ts +34 -1
  70. package/build/src/types/lib/nova-config.d.ts +76 -0
  71. package/build/src/types/shared.d.ts +114 -3
  72. package/build/src/types/tests/api/docker-hub.test.d.ts +93 -0
  73. package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +4 -4
  74. package/build/src/types/tests/cli/generate/github/workflows-blueprint-validate.test.d.ts +21 -5
  75. package/build/src/types/tests/cli/recipe/nova-config/normalize-order.test.d.ts +4 -0
  76. package/build/src/types/tests/cli/utility/configure.test.d.ts +35 -0
  77. package/build/src/types/tests/lib/nova-config.test.d.ts +1 -1
  78. package/build/src/types/tests/scaffold-output-contract.test.d.ts +57 -0
  79. package/build/templates/generators/must-haves/agent-conventions/conventions/nova.md +6 -0
  80. package/build/templates/scaffold/app/android/package.json +1 -1
  81. package/build/templates/scaffold/app/apple/package.json +1 -1
  82. package/build/templates/scaffold/app/astro/package.json +1 -1
  83. package/build/templates/scaffold/app/discord-bot/package.json +1 -1
  84. package/build/templates/scaffold/app/express/package.json +1 -1
  85. package/build/templates/scaffold/app/nextjs/package.json +1 -1
  86. package/build/templates/scaffold/app/vite/package.json +1 -1
  87. package/build/templates/scaffold/docs/docusaurus/package.json +2 -2
  88. package/build/templates/scaffold/package/github-action/package.json +1 -1
  89. package/build/templates/scaffold/package/homebridge/package.json +1 -1
  90. package/build/templates/scaffold/package/pfsense/package.json +2 -2
  91. package/build/templates/scaffold/package/pfsense/scripts/build-package.sh +7 -0
  92. package/build/templates/scaffold/package/pfsense/scripts/stage-package.mjs +48 -2
  93. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/package.json +1 -1
  94. package/build/templates/scaffold-options/tool/serverless/vercel-functions/package.json +1 -1
  95. package/package.json +1 -1
@@ -0,0 +1,93 @@
1
+ import type { spawnSync } from 'node:child_process';
2
+
3
+ import type { vi } from 'vitest';
4
+
5
+ import type {
6
+ Shared_DockerHubCategories,
7
+ Shared_DockerHubCredentials,
8
+ Shared_DockerHubRepository,
9
+ Shared_DockerHubResponse,
10
+ } from '../../shared.d.ts';
11
+
12
+ /**
13
+ * Tests - API - Docker Hub - Repository Fixture.
14
+ *
15
+ * @since 0.40.0
16
+ */
17
+ export type Tests_Api_DockerHub_RepositoryFixture = Shared_DockerHubRepository;
18
+
19
+ /**
20
+ * Tests - API - Docker Hub - Fetch Categories - Caches The Live List.
21
+ *
22
+ * @since 0.40.0
23
+ */
24
+ export type Tests_Api_DockerHub_ApiDockerHubFetchCategories_CachesTheLiveList_FetchSpy = ReturnType<typeof vi['spyOn']>;
25
+
26
+ export type Tests_Api_DockerHub_ApiDockerHubFetchCategories_CachesTheLiveList_First = Shared_DockerHubCategories | undefined;
27
+
28
+ export type Tests_Api_DockerHub_ApiDockerHubFetchCategories_CachesTheLiveList_Second = Shared_DockerHubCategories | undefined;
29
+
30
+ /**
31
+ * Tests - API - Docker Hub - Find Credentials - Falls Back To Config Auth.
32
+ *
33
+ * @since 0.40.0
34
+ */
35
+ export type Tests_Api_DockerHub_ApiDockerHubFindCredentials_FallsBackToConfigAuth_Credentials = Shared_DockerHubCredentials | undefined;
36
+
37
+ /**
38
+ * Tests - API - Docker Hub - Find Credentials - Uses Credential Helpers In Order.
39
+ *
40
+ * @since 0.40.0
41
+ */
42
+ export type Tests_Api_DockerHub_ApiDockerHubFindCredentials_UsesCredentialHelpersInOrder_HelperResult = ReturnType<typeof spawnSync>;
43
+
44
+ export type Tests_Api_DockerHub_ApiDockerHubFindCredentials_UsesCredentialHelpersInOrder_Credentials = Shared_DockerHubCredentials | undefined;
45
+
46
+ /**
47
+ * Tests - API - Docker Hub - Login - Posts Credentials And Returns The Token.
48
+ *
49
+ * @since 0.40.0
50
+ */
51
+ export type Tests_Api_DockerHub_ApiDockerHubLogin_PostsCredentialsAndReturnsTheToken_FetchSpy = ReturnType<typeof vi['spyOn']>;
52
+
53
+ export type Tests_Api_DockerHub_ApiDockerHubLogin_PostsCredentialsAndReturnsTheToken_Token = string | undefined;
54
+
55
+ /**
56
+ * Tests - API - Docker Hub - Repository Requests - Reads A Missing Overview And Null Description As Empty.
57
+ *
58
+ * @since 0.40.1
59
+ */
60
+ export type Tests_Api_DockerHub_ApiDockerHubRepositoryRequests_ReadsAMissingOverviewAndNullDescriptionAsEmpty_NewRepositoryFixture = Record<string, unknown>;
61
+
62
+ export type Tests_Api_DockerHub_ApiDockerHubRepositoryRequests_ReadsAMissingOverviewAndNullDescriptionAsEmpty_Repository = Shared_DockerHubResponse<Shared_DockerHubRepository | undefined>;
63
+
64
+ /**
65
+ * Tests - API - Docker Hub - Repository Requests - Use The Documented Methods And Bodies.
66
+ *
67
+ * @since 0.40.0
68
+ */
69
+ export type Tests_Api_DockerHub_ApiDockerHubRepositoryRequests_UsesTheDocumentedMethodsAndBodies_FetchSpy = ReturnType<typeof vi['spyOn']>;
70
+
71
+ export type Tests_Api_DockerHub_ApiDockerHubRepositoryRequests_UsesTheDocumentedMethodsAndBodies_Repository = Shared_DockerHubResponse<Shared_DockerHubRepository | undefined>;
72
+
73
+ /**
74
+ * Tests - API - Docker Hub - Node Child Process.
75
+ *
76
+ * @since 0.40.0
77
+ */
78
+ export type Tests_Api_DockerHub_NodeChildProcess_MockModule_SpawnSync = ReturnType<typeof vi['fn']>;
79
+
80
+ export type Tests_Api_DockerHub_NodeChildProcess_MockModule = Readonly<{
81
+ spawnSync: Tests_Api_DockerHub_NodeChildProcess_MockModule_SpawnSync;
82
+ }>;
83
+
84
+ /**
85
+ * Tests - API - Docker Hub - Node Fs.
86
+ *
87
+ * @since 0.40.0
88
+ */
89
+ export type Tests_Api_DockerHub_NodeFs_MockModule_ReadFileSync = ReturnType<typeof vi['fn']>;
90
+
91
+ export type Tests_Api_DockerHub_NodeFs_MockModule = Readonly<{
92
+ readFileSync: Tests_Api_DockerHub_NodeFs_MockModule_ReadFileSync;
93
+ }>;
@@ -102,6 +102,10 @@ export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsB
102
102
 
103
103
  export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_Entry = Shared_BlueprintConfigWorkflow;
104
104
 
105
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_OmitsDockerHubDescriptionSync_DisabledEntry = Shared_BlueprintConfigWorkflow;
106
+
107
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_OmitsDockerHubDescriptionSync_Generated = string;
108
+
105
109
  export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_ReproducesTheSyntheticContainersWorkflowByteForByte_Generated = string;
106
110
 
107
111
  export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_ReproducesTheSyntheticContainersWorkflowByteForByte_FixturesDir = string;
@@ -110,10 +114,6 @@ export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsB
110
114
 
111
115
  export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_ReproducesTheSyntheticContainersWorkflowByteForByte_Committed = string;
112
116
 
113
- export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_SkipsDockerHubDescriptionSyncWhenDisabled_DisabledEntry = Shared_BlueprintConfigWorkflow;
114
-
115
- export type Tests_Cli_Generate_Github_WorkflowsBlueprintPublishParity_WorkflowsBlueprintPublishParityContainers_SkipsDockerHubDescriptionSyncWhenDisabled_Generated = string;
116
-
117
117
  /**
118
118
  * Tests - CLI - Generate - GitHub - Workflows Blueprint Publish Parity - Invariant.
119
119
  *
@@ -2,6 +2,7 @@ import type {
2
2
  Shared_BlueprintConfigWorkflow,
3
3
  Shared_BlueprintValidationResult,
4
4
  Shared_NovaConfig_Artifacts,
5
+ Shared_NovaConfig_DockerHub,
5
6
  Shared_NovaConfig_Workspaces,
6
7
  Shared_NovaConfigEnvironment,
7
8
  Shared_NovaConfigWorkspace,
@@ -288,15 +289,30 @@ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValida
288
289
  };
289
290
 
290
291
  /**
291
- * Tests - CLI - Generate - GitHub - Workflows Blueprint Validate - Validator Validate - Docker Hub Description Length Uses UTF-8 Bytes.
292
+ * Tests - CLI - Generate - GitHub - Workflows Blueprint Validate - Validator Validate - Docker Hub Config Is Required.
292
293
  *
293
- * @since 0.39.0
294
+ * @since 0.40.0
294
295
  */
295
- export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubDescriptionLengthUsesUTF8Bytes_RawWorkflows = unknown[];
296
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubConfigIsRequired_RawWorkflows = unknown[];
297
+
298
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubConfigIsRequired_OverLimitResult = Shared_BlueprintValidationResult;
299
+
300
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubConfigIsRequired_WithinLimitResult = Shared_BlueprintValidationResult;
301
+
302
+ /**
303
+ * Tests - CLI - Generate - GitHub - Workflows Blueprint Validate - Validator Validate - Docker Hub Rejects Removed Target Settings.
304
+ *
305
+ * @since 0.40.0
306
+ */
307
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubRejectsRemovedTargetSettings_DockerHub = Shared_NovaConfig_DockerHub;
308
+
309
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubRejectsRemovedTargetSettings_CoordinateWorkflows = unknown[];
310
+
311
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubRejectsRemovedTargetSettings_OverviewWorkflows = unknown[];
296
312
 
297
- export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubDescriptionLengthUsesUTF8Bytes_OverLimitResult = Shared_BlueprintValidationResult;
313
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubRejectsRemovedTargetSettings_CoordinateResult = Shared_BlueprintValidationResult;
298
314
 
299
- export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubDescriptionLengthUsesUTF8Bytes_WithinLimitResult = Shared_BlueprintValidationResult;
315
+ export type Tests_Cli_Generate_Github_WorkflowsBlueprintValidate_ValidatorValidate_DockerHubRejectsRemovedTargetSettings_OverviewResult = Shared_BlueprintValidationResult;
300
316
 
301
317
  /**
302
318
  * Tests - CLI - Generate - GitHub - Workflows Blueprint Validate - Validator Validate.
@@ -29,3 +29,7 @@ export type Tests_Cli_Recipe_NovaConfig_NormalizeOrder_CliRecipeNovaConfigNormal
29
29
  export type Tests_Cli_Recipe_NovaConfig_NormalizeOrder_CliRecipeNovaConfigNormalizeOrderRun_OrdersKnownSectionsWhilePreservingNestedAndUnknownValues_ParsedOutput = Record<string, unknown>;
30
30
 
31
31
  export type Tests_Cli_Recipe_NovaConfig_NormalizeOrder_CliRecipeNovaConfigNormalizeOrderRun_OrdersKnownSectionsWhilePreservingNestedAndUnknownValues_Keys = string[];
32
+
33
+ export type Tests_Cli_Recipe_NovaConfig_NormalizeOrder_CliRecipeNovaConfigNormalizeOrderRun_OrdersKnownSectionsWhilePreservingNestedAndUnknownValues_DockerHub = Record<string, unknown>;
34
+
35
+ export type Tests_Cli_Recipe_NovaConfig_NormalizeOrder_CliRecipeNovaConfigNormalizeOrderRun_OrdersKnownSectionsWhilePreservingNestedAndUnknownValues_DockerHubKeys = string[];
@@ -7,6 +7,8 @@ import type {
7
7
  Cli_Utility_Configure_Runner_CheckPath_Returns,
8
8
  Cli_Utility_Configure_Runner_PromptAgents_Config,
9
9
  Cli_Utility_Configure_Runner_PromptAgents_Returns,
10
+ Cli_Utility_Configure_Runner_PromptDockerHub_Config,
11
+ Cli_Utility_Configure_Runner_PromptDockerHub_Returns,
10
12
  Cli_Utility_Configure_Runner_PromptEnvironment_Config,
11
13
  Cli_Utility_Configure_Runner_PromptEnvironment_Returns,
12
14
  Cli_Utility_Configure_Runner_PromptEnvironmentReconcile_Config,
@@ -28,6 +30,8 @@ import type {
28
30
  Cli_Utility_Configure_Runner_PromptGithubSecurity_Returns,
29
31
  Cli_Utility_Configure_Runner_PromptIgnoreFiles_Config,
30
32
  Cli_Utility_Configure_Runner_PromptIgnoreFiles_Returns,
33
+ Cli_Utility_Configure_Runner_PromptProject_Config,
34
+ Cli_Utility_Configure_Runner_PromptProject_Returns,
31
35
  Cli_Utility_Configure_Runner_PromptRecipes_Config,
32
36
  Cli_Utility_Configure_Runner_PromptRecipes_Returns,
33
37
  Cli_Utility_Configure_Runner_PromptSettings_Config,
@@ -80,6 +84,7 @@ export type Tests_Cli_Utility_Configure_ConfigFieldCoverage_Value<Value, Key ext
80
84
  export type Tests_Cli_Utility_Configure_ConfigFieldCoverage_Editor =
81
85
  'promptAgents'
82
86
  | 'promptArtifacts'
87
+ | 'promptDockerHub'
83
88
  | 'promptEmails'
84
89
  | 'promptEntities'
85
90
  | 'promptEnvironment'
@@ -211,6 +216,17 @@ export type Tests_Cli_Utility_Configure_PromptAgents_RemovesTheOptionalFieldWhen
211
216
 
212
217
  export type Tests_Cli_Utility_Configure_PromptAgents_RemovesTheOptionalFieldWhenNoToolsAreSelected_Result = Awaited<Cli_Utility_Configure_Runner_PromptAgents_Returns>;
213
218
 
219
+ /**
220
+ * Tests - CLI - Utility - Configure - Prompt Docker Hub - Configures Repository Settings And Recipes.
221
+ *
222
+ * @since 0.40.0
223
+ */
224
+ export type Tests_Cli_Utility_Configure_PromptDockerHub_ConfiguresRepositorySettingsAndRecipes_Config = Shared_NovaConfig;
225
+
226
+ export type Tests_Cli_Utility_Configure_PromptDockerHub_ConfiguresRepositorySettingsAndRecipes_PromptDockerHub = (config: Cli_Utility_Configure_Runner_PromptDockerHub_Config) => Cli_Utility_Configure_Runner_PromptDockerHub_Returns;
227
+
228
+ export type Tests_Cli_Utility_Configure_PromptDockerHub_ConfiguresRepositorySettingsAndRecipes_Result = Awaited<Cli_Utility_Configure_Runner_PromptDockerHub_Returns>;
229
+
214
230
  /**
215
231
  * Tests - CLI - Utility - Configure - Prompt Environment Section - Adds A Global Secret Value.
216
232
  *
@@ -434,6 +450,25 @@ export type Tests_Cli_Utility_Configure_PromptIgnoreFiles_AddsBundlesAndPatterns
434
450
 
435
451
  export type Tests_Cli_Utility_Configure_PromptIgnoreFiles_AddsBundlesAndPatternsForAPhysicalIgnoreFile_Result = Awaited<Cli_Utility_Configure_Runner_PromptIgnoreFiles_Returns>;
436
452
 
453
+ /**
454
+ * Tests - CLI - Utility - Configure - Prompt Project - Enforces The Docker Hub Short Description Limit.
455
+ *
456
+ * @since 0.40.0
457
+ */
458
+ export type Tests_Cli_Utility_Configure_PromptProject_EnforcesTheDockerHubShortDescriptionLimit_CapturedQuestions = PromptObject[];
459
+
460
+ export type Tests_Cli_Utility_Configure_PromptProject_EnforcesTheDockerHubShortDescriptionLimit_Config = Shared_NovaConfig;
461
+
462
+ export type Tests_Cli_Utility_Configure_PromptProject_EnforcesTheDockerHubShortDescriptionLimit_PromptProject = (config: Cli_Utility_Configure_Runner_PromptProject_Config) => Cli_Utility_Configure_Runner_PromptProject_Returns;
463
+
464
+ export type Tests_Cli_Utility_Configure_PromptProject_EnforcesTheDockerHubShortDescriptionLimit_Result = Awaited<Cli_Utility_Configure_Runner_PromptProject_Returns>;
465
+
466
+ export type Tests_Cli_Utility_Configure_PromptProject_EnforcesTheDockerHubShortDescriptionLimit_ShortQuestion = PromptObject | undefined;
467
+
468
+ export type Tests_Cli_Utility_Configure_PromptProject_EnforcesTheDockerHubShortDescriptionLimit_Validate = (value: unknown) => unknown | Promise<unknown>;
469
+
470
+ export type Tests_Cli_Utility_Configure_PromptProject_EnforcesTheDockerHubShortDescriptionLimit_ValidationResult = unknown;
471
+
437
472
  /**
438
473
  * Tests - CLI - Utility - Configure - Prompt Recipes - Edits Closed Operating System Cleanup Settings.
439
474
  *
@@ -1113,7 +1113,7 @@ export type Tests_Lib_NovaConfig_SharedNovaConfigLoad_LoadReadsConfigFromFilesys
1113
1113
 
1114
1114
  export type Tests_Lib_NovaConfig_SharedNovaConfigLoad_LoadReadsConfigFromFilesystem_Config = LibNovaConfig;
1115
1115
 
1116
- export type Tests_Lib_NovaConfig_SharedNovaConfigLoad_LoadReadsConfigFromFilesystem_Loaded = Pick<Shared_NovaConfigConfig, 'project' | 'workspaces' | 'entities' | 'urls' | 'github' | 'workflows'>;
1116
+ export type Tests_Lib_NovaConfig_SharedNovaConfigLoad_LoadReadsConfigFromFilesystem_Loaded = Pick<Shared_NovaConfigConfig, 'project' | 'workspaces' | 'entities' | 'urls' | 'github' | 'dockerHub' | 'workflows'>;
1117
1117
 
1118
1118
  export type Tests_Lib_NovaConfig_SharedNovaConfigLoad_LoadReadsConfigFromFilesystem_LoadedProject = Shared_NovaConfig_Project | undefined;
1119
1119
 
@@ -1,4 +1,7 @@
1
1
  import type { SpawnSyncReturns } from 'node:child_process';
2
+ import type { Stats } from 'node:fs';
3
+
4
+ import type { Linter } from '@typescript-eslint/utils/ts-eslint';
2
5
 
3
6
  import type { Shared_ScaffoldOutputContract } from '../shared.d.ts';
4
7
 
@@ -58,6 +61,31 @@ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_KeepsTheDockerIm
58
61
 
59
62
  export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_KeepsTheDockerImageOCILabelContract_DockerfileContent = string;
60
63
 
64
+ /**
65
+ * Tests - Scaffold Output Contract - Scaffold Output Contract - Lints The PfSense Staging Script Against The Shared Node Engine Range.
66
+ *
67
+ * @since 0.40.0
68
+ */
69
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_GeneratedWorkspaceDirectory = string;
70
+
71
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_PackageJsonPath = string;
72
+
73
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_PackageJsonRaw = string;
74
+
75
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_PackageJson = Record<string, unknown>;
76
+
77
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_PackageEngines = unknown;
78
+
79
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_NodeEngine = unknown;
80
+
81
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_StageScriptPath = string;
82
+
83
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_StageScriptContent = string;
84
+
85
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_Linter = Linter;
86
+
87
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_LintsThePfSenseStagingScriptAgainstTheSharedNodeEngineRange_Messages = Linter.LintMessage[];
88
+
61
89
  /**
62
90
  * Tests - Scaffold Output Contract - Scaffold Output Contract - Marks pfSense Release Packages For Any FreeBSD Version And Keeps Them Vital.
63
91
  *
@@ -150,6 +178,35 @@ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSense
150
178
 
151
179
  export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_UpdateTestsContent = string;
152
180
 
181
+ /**
182
+ * Tests - Scaffold Output Contract - Scaffold Output Contract - Stages PfSense Port Permissions And Empty Directories And Rejects Symlinks.
183
+ *
184
+ * @since 0.40.0
185
+ */
186
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_GeneratedWorkspaceDirectory = string;
187
+
188
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_SourceExecutablePath = string;
189
+
190
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_StagedExecutablePath = string;
191
+
192
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_SourceEmptyDirectoryPath = string;
193
+
194
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_StagedEmptyDirectoryPath = string;
195
+
196
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_SymlinkPath = string;
197
+
198
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_ExecutableMode = number;
199
+
200
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_StagingResult = SpawnSyncReturns<string>;
201
+
202
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_SourceExecutableStats = Stats;
203
+
204
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_StagedExecutableStats = Stats;
205
+
206
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_StagedEmptyDirectoryEntries = string[];
207
+
208
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_StagesPfSensePortPermissionsAndEmptyDirectoriesAndRejectsSymlinks_SymlinkResult = SpawnSyncReturns<string>;
209
+
153
210
  /**
154
211
  * Tests - Scaffold Output Contract - Scaffold Output Contract - Validates pfSense Release Signing Key Files With Line Numbered Diagnostics.
155
212
  *
@@ -45,6 +45,12 @@ check and build remain the final repository contract.
45
45
  - Do not place secrets, tokens, private keys, or credential paths in
46
46
  `nova.config.json`. Use the vendor's official credential location or the
47
47
  environment contract documented for that integration.
48
+ - Environment keys are declared without their namespace. The environment
49
+ manager adds the project, workspace, or workflow prefix when it syncs a value
50
+ to GitHub, so `RELEASE_SIGNING_KEY` under a `PFSENSE_` workspace is stored
51
+ and read as `PFSENSE_RELEASE_SIGNING_KEY`. Generator setup lists show the
52
+ declared key, not the GitHub name; run `nova utility configure --status` to
53
+ see the GitHub names.
48
54
 
49
55
  ## Command Boundaries
50
56
 
@@ -22,7 +22,7 @@
22
22
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
23
23
  },
24
24
  "dependencies": {
25
- "@cbnventures/nova": "0.39.0"
25
+ "@cbnventures/nova": "0.40.1"
26
26
  },
27
27
  "devDependencies": {
28
28
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
@@ -23,7 +23,7 @@
23
23
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
24
24
  },
25
25
  "dependencies": {
26
- "@cbnventures/nova": "0.39.0"
26
+ "@cbnventures/nova": "0.40.1"
27
27
  },
28
28
  "devDependencies": {
29
29
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
@@ -23,7 +23,7 @@
23
23
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
24
24
  },
25
25
  "dependencies": {
26
- "@cbnventures/nova": "0.39.0",
26
+ "@cbnventures/nova": "0.40.1",
27
27
  "astro": "[__SCAFFOLD_VERSION_ASTRO__]",
28
28
  "cookie": "[__SCAFFOLD_VERSION_COOKIE__]"
29
29
  },
@@ -24,7 +24,7 @@
24
24
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
25
25
  },
26
26
  "dependencies": {
27
- "@cbnventures/nova": "0.39.0",
27
+ "@cbnventures/nova": "0.40.1",
28
28
  "discord.js": "[__SCAFFOLD_VERSION_DISCORD_JS__]"
29
29
  },
30
30
  "devDependencies": {
@@ -24,7 +24,7 @@
24
24
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
25
25
  },
26
26
  "dependencies": {
27
- "@cbnventures/nova": "0.39.0",
27
+ "@cbnventures/nova": "0.40.1",
28
28
  "express": "[__SCAFFOLD_VERSION_EXPRESS__]"
29
29
  },
30
30
  "devDependencies": {
@@ -24,7 +24,7 @@
24
24
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
25
25
  },
26
26
  "dependencies": {
27
- "@cbnventures/nova": "0.39.0",
27
+ "@cbnventures/nova": "0.40.1",
28
28
  "next": "[__SCAFFOLD_VERSION_NEXT__]",
29
29
  "react": "[__SCAFFOLD_VERSION_REACT__]",
30
30
  "react-dom": "[__SCAFFOLD_VERSION_REACT_DOM__]"
@@ -22,7 +22,7 @@
22
22
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
23
23
  },
24
24
  "dependencies": {
25
- "@cbnventures/nova": "0.39.0"
25
+ "@cbnventures/nova": "0.40.1"
26
26
  },
27
27
  "devDependencies": {
28
28
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_22__]",
@@ -27,8 +27,8 @@
27
27
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
28
28
  },
29
29
  "dependencies": {
30
- "@cbnventures/docusaurus-preset-nova": "0.39.0",
31
- "@cbnventures/nova": "0.39.0",
30
+ "@cbnventures/docusaurus-preset-nova": "0.40.1",
31
+ "@cbnventures/nova": "0.40.1",
32
32
  "@docusaurus/core": "[__SCAFFOLD_VERSION_DOCUSAURUS__]",
33
33
  "react": "[__SCAFFOLD_VERSION_REACT__]",
34
34
  "react-dom": "[__SCAFFOLD_VERSION_REACT_DOM__]"
@@ -26,7 +26,7 @@
26
26
  },
27
27
  "dependencies": {
28
28
  "@actions/core": "[__SCAFFOLD_VERSION_ACTIONS_CORE__]",
29
- "@cbnventures/nova": "0.39.0"
29
+ "@cbnventures/nova": "0.40.1"
30
30
  },
31
31
  "devDependencies": {
32
32
  "@github/local-action": "[__SCAFFOLD_VERSION_GITHUB_LOCAL_ACTION__]",
@@ -43,7 +43,7 @@
43
43
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
44
44
  },
45
45
  "dependencies": {
46
- "@cbnventures/nova": "0.39.0"
46
+ "@cbnventures/nova": "0.40.1"
47
47
  },
48
48
  "devDependencies": {
49
49
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
@@ -26,10 +26,10 @@
26
26
  "clean:build": "shx rm -rf ./build"
27
27
  },
28
28
  "engines": {
29
- "node": "[__SCAFFOLD_VERSION_NODE_ENGINE_PFSENSE__]"
29
+ "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
30
30
  },
31
31
  "dependencies": {
32
- "@cbnventures/nova": "0.39.0"
32
+ "@cbnventures/nova": "0.40.1"
33
33
  },
34
34
  "devDependencies": {
35
35
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
@@ -42,6 +42,13 @@ main() {
42
42
  exit 1
43
43
  fi
44
44
 
45
+ if [ -f "${SCRIPT_DIR}/check-freebsd.sh" ]; then
46
+ if ! (cd "${WORKSPACE_DIR}" && /bin/sh "${SCRIPT_DIR}/check-freebsd.sh"); then
47
+ echo 'FreeBSD checks failed; the package was not built.' >&2
48
+ exit 1
49
+ fi
50
+ fi
51
+
45
52
  trap cleanup EXIT HUP INT TERM
46
53
 
47
54
  mkdir -p -- "$(dirname -- "${PORT_DESTINATION}")"
@@ -1,8 +1,11 @@
1
1
  import {
2
- cp,
2
+ chmod,
3
+ copyFile,
3
4
  mkdir,
5
+ readdir,
4
6
  readFile,
5
7
  rm,
8
+ stat,
6
9
  writeFile,
7
10
  } from 'node:fs/promises';
8
11
  import { dirname, join, resolve } from 'node:path';
@@ -48,6 +51,49 @@ const buildDirectory = join(workspaceDirectory, 'build');
48
51
  */
49
52
  const stagedPortDirectory = join(buildDirectory, 'port');
50
53
 
54
+ /**
55
+ * Stage Package - Copy Directory.
56
+ *
57
+ * Copies one port directory using APIs supported by every tracked Node release.
58
+ * Each directory and regular file retains its source permission bits.
59
+ *
60
+ * @param {string} portDirectoryToCopyFrom - Port directory to copy from.
61
+ * @param {string} stagingDirectoryToCopyInto - Staging directory to copy into.
62
+ *
63
+ * @returns {Promise<void>}
64
+ *
65
+ * @since 0.0.0
66
+ */
67
+ async function copyDirectory(portDirectoryToCopyFrom, stagingDirectoryToCopyInto) {
68
+ await mkdir(stagingDirectoryToCopyInto, { recursive: true });
69
+
70
+ for (const directoryEntry of await readdir(portDirectoryToCopyFrom, { withFileTypes: true })) {
71
+ if (directoryEntry.isDirectory() === true) {
72
+ await copyDirectory(
73
+ join(portDirectoryToCopyFrom, directoryEntry.name),
74
+ join(stagingDirectoryToCopyInto, directoryEntry.name),
75
+ );
76
+ } else {
77
+ if (directoryEntry.isFile() === false) {
78
+ throw new Error(`Cannot stage pfSense port entry "${join(portDirectoryToCopyFrom, directoryEntry.name)}": only regular files and directories are supported.`);
79
+ }
80
+
81
+ await copyFile(
82
+ join(portDirectoryToCopyFrom, directoryEntry.name),
83
+ join(stagingDirectoryToCopyInto, directoryEntry.name),
84
+ );
85
+ await chmod(
86
+ join(stagingDirectoryToCopyInto, directoryEntry.name),
87
+ (await stat(join(portDirectoryToCopyFrom, directoryEntry.name))).mode,
88
+ );
89
+ }
90
+ }
91
+
92
+ await chmod(stagingDirectoryToCopyInto, (await stat(portDirectoryToCopyFrom)).mode);
93
+
94
+ return;
95
+ }
96
+
51
97
  /**
52
98
  * Stage Package - package.json Raw.
53
99
  *
@@ -87,7 +133,7 @@ await rm(stagedPortDirectory, {
87
133
  recursive: true,
88
134
  });
89
135
  await mkdir(buildDirectory, { recursive: true });
90
- await cp(sourceDirectory, stagedPortDirectory, { recursive: true });
136
+ await copyDirectory(sourceDirectory, stagedPortDirectory);
91
137
 
92
138
  /**
93
139
  * Stage Package - Makefile Template Path.
@@ -49,7 +49,7 @@
49
49
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
50
50
  },
51
51
  "dependencies": {
52
- "@cbnventures/nova": "0.39.0",
52
+ "@cbnventures/nova": "0.40.1",
53
53
  "chalk": "[__SCAFFOLD_VERSION_CHALK__]",
54
54
  "commander": "[__SCAFFOLD_VERSION_COMMANDER__]",
55
55
  "wrangler": "[__SCAFFOLD_VERSION_WRANGLER__]"
@@ -51,7 +51,7 @@
51
51
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
52
52
  },
53
53
  "dependencies": {
54
- "@cbnventures/nova": "0.39.0",
54
+ "@cbnventures/nova": "0.40.1",
55
55
  "chalk": "[__SCAFFOLD_VERSION_CHALK__]",
56
56
  "commander": "[__SCAFFOLD_VERSION_COMMANDER__]",
57
57
  "vercel": "[__SCAFFOLD_VERSION_VERCEL__]"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cbnventures/nova",
3
- "version": "0.39.0",
3
+ "version": "0.40.1",
4
4
  "description": "Scripts, templates, and project configuration for the common JavaScript and TypeScript developer",
5
5
  "keywords": [
6
6
  "eslint",