@cbnventures/nova 0.22.6 → 0.24.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 (83) hide show
  1. package/build/package.json +1 -1
  2. package/build/src/cli/generate/github/workflows-blueprint.d.ts +1 -0
  3. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  4. package/build/src/cli/generate/github/workflows-blueprint.js +131 -187
  5. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  6. package/build/src/cli/recipe/github/gh-precheck.d.ts +3 -0
  7. package/build/src/cli/recipe/github/gh-precheck.d.ts.map +1 -0
  8. package/build/src/cli/recipe/github/gh-precheck.js +111 -0
  9. package/build/src/cli/recipe/github/gh-precheck.js.map +1 -0
  10. package/build/src/cli/recipe/github/sync-features.d.ts.map +1 -1
  11. package/build/src/cli/recipe/github/sync-features.js +8 -98
  12. package/build/src/cli/recipe/github/sync-features.js.map +1 -1
  13. package/build/src/cli/recipe/github/sync-identity.d.ts.map +1 -1
  14. package/build/src/cli/recipe/github/sync-identity.js +10 -98
  15. package/build/src/cli/recipe/github/sync-identity.js.map +1 -1
  16. package/build/src/cli/recipe/github/sync-policies.d.ts.map +1 -1
  17. package/build/src/cli/recipe/github/sync-policies.js +8 -98
  18. package/build/src/cli/recipe/github/sync-policies.js.map +1 -1
  19. package/build/src/cli/recipe/package-json/normalize-artifacts.d.ts +0 -1
  20. package/build/src/cli/recipe/package-json/normalize-artifacts.d.ts.map +1 -1
  21. package/build/src/cli/recipe/package-json/normalize-artifacts.js +6 -21
  22. package/build/src/cli/recipe/package-json/normalize-artifacts.js.map +1 -1
  23. package/build/src/cli/recipe/package-json/normalize-dependencies.d.ts +0 -1
  24. package/build/src/cli/recipe/package-json/normalize-dependencies.d.ts.map +1 -1
  25. package/build/src/cli/recipe/package-json/normalize-dependencies.js +8 -23
  26. package/build/src/cli/recipe/package-json/normalize-dependencies.js.map +1 -1
  27. package/build/src/cli/recipe/package-json/normalize-tooling.d.ts +0 -1
  28. package/build/src/cli/recipe/package-json/normalize-tooling.d.ts.map +1 -1
  29. package/build/src/cli/recipe/package-json/normalize-tooling.js +2 -17
  30. package/build/src/cli/recipe/package-json/normalize-tooling.js.map +1 -1
  31. package/build/src/cli/recipe/package-json/sync-environment.d.ts +0 -1
  32. package/build/src/cli/recipe/package-json/sync-environment.d.ts.map +1 -1
  33. package/build/src/cli/recipe/package-json/sync-environment.js +4 -19
  34. package/build/src/cli/recipe/package-json/sync-environment.js.map +1 -1
  35. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  36. package/build/src/cli/utility/changelog.js +179 -86
  37. package/build/src/cli/utility/changelog.js.map +1 -1
  38. package/build/src/cli/utility/initialize.d.ts +1 -0
  39. package/build/src/cli/utility/initialize.d.ts.map +1 -1
  40. package/build/src/cli/utility/initialize.js +61 -0
  41. package/build/src/cli/utility/initialize.js.map +1 -1
  42. package/build/src/lib/item.d.ts.map +1 -1
  43. package/build/src/lib/item.js +4 -1
  44. package/build/src/lib/item.js.map +1 -1
  45. package/build/src/lib/markdown-slug.js +2 -2
  46. package/build/src/lib/markdown-slug.js.map +1 -1
  47. package/build/src/lib/nova-config.d.ts.map +1 -1
  48. package/build/src/lib/nova-config.js +4 -0
  49. package/build/src/lib/nova-config.js.map +1 -1
  50. package/build/src/lib/regex.d.ts +1 -0
  51. package/build/src/lib/regex.d.ts.map +1 -1
  52. package/build/src/lib/regex.js +1 -0
  53. package/build/src/lib/regex.js.map +1 -1
  54. package/build/src/lib/utility.d.ts +2 -1
  55. package/build/src/lib/utility.d.ts.map +1 -1
  56. package/build/src/lib/utility.js +15 -0
  57. package/build/src/lib/utility.js.map +1 -1
  58. package/build/src/presets/eslint/dx-ignore.d.ts.map +1 -1
  59. package/build/src/presets/eslint/dx-ignore.js +4 -0
  60. package/build/src/presets/eslint/dx-ignore.js.map +1 -1
  61. package/build/src/toolkit/nova-identity.js +1 -1
  62. package/build/src/toolkit/nova-identity.js.map +1 -1
  63. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +39 -0
  64. package/build/src/types/cli/recipe/github/gh-precheck.d.ts +86 -0
  65. package/build/src/types/cli/recipe/github/sync-features.d.ts +6 -43
  66. package/build/src/types/cli/recipe/github/sync-identity.d.ts +6 -40
  67. package/build/src/types/cli/recipe/github/sync-policies.d.ts +6 -43
  68. package/build/src/types/cli/recipe/package-json/normalize-artifacts.d.ts +0 -9
  69. package/build/src/types/cli/recipe/package-json/normalize-dependencies.d.ts +0 -9
  70. package/build/src/types/cli/recipe/package-json/normalize-tooling.d.ts +0 -9
  71. package/build/src/types/cli/recipe/package-json/sync-environment.d.ts +0 -9
  72. package/build/src/types/cli/utility/changelog.d.ts +25 -2
  73. package/build/src/types/cli/utility/initialize.d.ts +53 -0
  74. package/build/src/types/lib/item.d.ts +1 -1
  75. package/build/src/types/lib/nova-config.d.ts +4 -0
  76. package/build/src/types/lib/utility.d.ts +9 -0
  77. package/build/src/types/shared.d.ts +10 -2
  78. package/build/src/types/tests/cli/utility/changelog.test.d.ts +179 -0
  79. package/build/src/types/tests/lib/item.test.d.ts +14 -0
  80. package/build/src/types/tests/lib/markdown-slug.test.d.ts +7 -0
  81. package/build/templates/generators/must-haves/agent-conventions/conventions/documentation.md +19 -8
  82. package/build/templates/scaffold/docs/docusaurus/package.json +2 -2
  83. package/package.json +1 -1
@@ -11,6 +11,7 @@ import type {
11
11
  Shared_ChangelogOptions,
12
12
  Shared_NovaConfig_Workspaces,
13
13
  Shared_NovaConfigConfig,
14
+ Shared_NovaConfigSettings_VersionStrategy,
14
15
  Shared_NovaConfigWorkspace,
15
16
  Shared_PromptWithCancelReject,
16
17
  Shared_PromptWithCancelResolved,
@@ -70,6 +71,8 @@ export type Cli_Utility_Changelog_Runner_ParseEntries_Value = string;
70
71
 
71
72
  export type Cli_Utility_Changelog_Runner_ParseEntries_Message = string;
72
73
 
74
+ export type Cli_Utility_Changelog_Runner_ParseEntries_Entry = Shared_ChangelogEntry;
75
+
73
76
  /**
74
77
  * CLI - Utility - Changelog - Prompt With Cancel.
75
78
  *
@@ -100,6 +103,8 @@ export type Cli_Utility_Changelog_Runner_Record_Config = Shared_NovaConfigConfig
100
103
 
101
104
  export type Cli_Utility_Changelog_Runner_Record_Workspaces = Shared_NovaConfig_Workspaces;
102
105
 
106
+ export type Cli_Utility_Changelog_Runner_Record_VersionStrategy = Shared_NovaConfigSettings_VersionStrategy;
107
+
103
108
  export type Cli_Utility_Changelog_Runner_Record_EligibleWorkspaces = [string, Shared_NovaConfigWorkspace][];
104
109
 
105
110
  export type Cli_Utility_Changelog_Runner_Record_FilterWorkspaceConfig = Shared_NovaConfigWorkspace;
@@ -209,6 +214,8 @@ export type Cli_Utility_Changelog_Runner_Release_Config = Shared_NovaConfigConfi
209
214
 
210
215
  export type Cli_Utility_Changelog_Runner_Release_Workspaces = Shared_NovaConfig_Workspaces;
211
216
 
217
+ export type Cli_Utility_Changelog_Runner_Release_VersionStrategy = Shared_NovaConfigSettings_VersionStrategy;
218
+
212
219
  export type Cli_Utility_Changelog_Runner_Release_BumpPriority = Record<Shared_ChangelogEntry_Bump, number>;
213
220
 
214
221
  export type Cli_Utility_Changelog_Runner_Release_Release_PackageName = Shared_ChangelogEntry_Package;
@@ -260,6 +267,22 @@ export type Cli_Utility_Changelog_Runner_Release_CurrentVersion = string | undef
260
267
 
261
268
  export type Cli_Utility_Changelog_Runner_Release_HighestBump = Shared_ChangelogEntry_Bump;
262
269
 
270
+ export type Cli_Utility_Changelog_Runner_Release_NewVersion = string;
271
+
272
+ export type Cli_Utility_Changelog_Runner_Release_CalverToday = Date;
273
+
274
+ export type Cli_Utility_Changelog_Runner_Release_CalverYear = number;
275
+
276
+ export type Cli_Utility_Changelog_Runner_Release_CalverMonth = number;
277
+
278
+ export type Cli_Utility_Changelog_Runner_Release_CalverCurrentParts = number[];
279
+
280
+ export type Cli_Utility_Changelog_Runner_Release_CalverCurrentYear = number;
281
+
282
+ export type Cli_Utility_Changelog_Runner_Release_CalverCurrentMonth = number;
283
+
284
+ export type Cli_Utility_Changelog_Runner_Release_CalverCurrentMicro = number;
285
+
263
286
  export type Cli_Utility_Changelog_Runner_Release_VersionParts = number[];
264
287
 
265
288
  export type Cli_Utility_Changelog_Runner_Release_VersionPartsMajor = number;
@@ -268,8 +291,6 @@ export type Cli_Utility_Changelog_Runner_Release_VersionPartsMinor = number;
268
291
 
269
292
  export type Cli_Utility_Changelog_Runner_Release_VersionPartsPatch = number;
270
293
 
271
- export type Cli_Utility_Changelog_Runner_Release_NewVersion = string;
272
-
273
294
  export type Cli_Utility_Changelog_Runner_Release_LockStepVersioning = boolean;
274
295
 
275
296
  export type Cli_Utility_Changelog_Runner_Release_HighestNewVersion = string;
@@ -479,6 +500,8 @@ export type Cli_Utility_Changelog_Runner_WriteChangelog_Version = string;
479
500
 
480
501
  export type Cli_Utility_Changelog_Runner_WriteChangelog_Entries = Shared_ChangelogEntry[];
481
502
 
503
+ export type Cli_Utility_Changelog_Runner_WriteChangelog_VersionStrategy = Shared_NovaConfigSettings_VersionStrategy;
504
+
482
505
  export type Cli_Utility_Changelog_Runner_WriteChangelog_Returns = Promise<void>;
483
506
 
484
507
  export type Cli_Utility_Changelog_Runner_WriteChangelog_ChangelogPath = string;
@@ -43,6 +43,7 @@ import type {
43
43
  Shared_NovaConfig_Recipes_Github,
44
44
  Shared_NovaConfig_Recipes_PackageJson,
45
45
  Shared_NovaConfig_Recipes_PackageJsonWorkspace,
46
+ Shared_NovaConfig_Settings,
46
47
  Shared_NovaConfig_Urls,
47
48
  Shared_NovaConfig_Workspaces,
48
49
  Shared_NovaConfigAgent,
@@ -57,6 +58,7 @@ import type {
57
58
  Shared_NovaConfigEnvironmentValue_Reach,
58
59
  Shared_NovaConfigEnvironmentWorkspace,
59
60
  Shared_NovaConfigProjectPlatform,
61
+ Shared_NovaConfigSettings_VersionStrategy,
60
62
  Shared_NovaConfigWorkflow_Triggers,
61
63
  Shared_NovaConfigWorkflowScope,
62
64
  Shared_NovaConfigWorkflowTarget_Needs,
@@ -1513,6 +1515,57 @@ export type Cli_Utility_Initialize_Runner_PromptProject_CurrentLabel = string;
1513
1515
 
1514
1516
  export type Cli_Utility_Initialize_Runner_PromptProject_Name = string;
1515
1517
 
1518
+ /**
1519
+ * CLI - Utility - Initialize - Prompt Settings.
1520
+ *
1521
+ * @since 0.23.0
1522
+ */
1523
+ export type Cli_Utility_Initialize_Runner_PromptSettings_Config = Shared_NovaConfig;
1524
+
1525
+ export type Cli_Utility_Initialize_Runner_PromptSettings_Returns = Promise<Extract<Shared_DialogAction, 'back'>>;
1526
+
1527
+ export type Cli_Utility_Initialize_Runner_PromptSettings_Settings = Shared_NovaConfig_Settings;
1528
+
1529
+ export type Cli_Utility_Initialize_Runner_PromptSettings_CurrentStrategy = Shared_NovaConfigSettings_VersionStrategy;
1530
+
1531
+ export type Cli_Utility_Initialize_Runner_PromptSettings_CurrentDirectory = string;
1532
+
1533
+ export type Cli_Utility_Initialize_Runner_PromptSettings_IsLocked = boolean;
1534
+
1535
+ export type Cli_Utility_Initialize_Runner_PromptSettings_ChangelogPath = string;
1536
+
1537
+ export type Cli_Utility_Initialize_Runner_PromptSettings_ChangelogContent = string;
1538
+
1539
+ export type Cli_Utility_Initialize_Runner_PromptSettings_HasRelease = boolean;
1540
+
1541
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice_Title = string;
1542
+
1543
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice_Description = string;
1544
+
1545
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice_Value = Shared_NovaConfigSettings_VersionStrategy;
1546
+
1547
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice = {
1548
+ title: Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice_Title;
1549
+ description: Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice_Description;
1550
+ value: Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice_Value;
1551
+ };
1552
+
1553
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoices = Cli_Utility_Initialize_Runner_PromptSettings_StrategyChoice[];
1554
+
1555
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyInitial = number;
1556
+
1557
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutputKey = 'versionStrategy';
1558
+
1559
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutputValue = Shared_NovaConfigSettings_VersionStrategy;
1560
+
1561
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutput = Shared_PromptWithCancelResolved<Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutputKey, Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutputValue> | Shared_PromptWithCancelReject;
1562
+
1563
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutputResult = Record<Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutputKey, Cli_Utility_Initialize_Runner_PromptSettings_StrategyOutputValue>;
1564
+
1565
+ export type Cli_Utility_Initialize_Runner_PromptSettings_StrategyInput = Shared_NovaConfigSettings_VersionStrategy;
1566
+
1567
+ export type Cli_Utility_Initialize_Runner_PromptSettings_UpdatedSettings = Shared_NovaConfig_Settings;
1568
+
1516
1569
  /**
1517
1570
  * CLI - Utility - Initialize - Prompt URLs.
1518
1571
  *
@@ -29,7 +29,7 @@ export type Lib_Item_AllowedPoliciesByRole_Package = Extract<Shared_NovaConfigWo
29
29
 
30
30
  export type Lib_Item_AllowedPoliciesByRole_Tool = Extract<Shared_NovaConfigWorkspace_Policy, 'freezable' | 'trackable'>[];
31
31
 
32
- export type Lib_Item_AllowedPoliciesByRole_Template = Extract<Shared_NovaConfigWorkspace_Policy, 'freezable'>[];
32
+ export type Lib_Item_AllowedPoliciesByRole_Template = Extract<Shared_NovaConfigWorkspace_Policy, 'freezable' | 'trackable'>[];
33
33
 
34
34
  export type Lib_Item_AllowedPoliciesByRole = {
35
35
  project: Lib_Item_AllowedPoliciesByRole_Project;
@@ -40,6 +40,7 @@ import type {
40
40
  Shared_NovaConfigEnvironmentWorkflow,
41
41
  Shared_NovaConfigEnvironmentWorkspace,
42
42
  Shared_NovaConfigProjectPlatform,
43
+ Shared_NovaConfigSettings_VersionStrategy,
43
44
  Shared_NovaConfigWorkflowDeployTarget,
44
45
  Shared_NovaConfigWorkspace,
45
46
  Shared_NovaConfigWorkspace_Name,
@@ -694,10 +695,13 @@ export type Lib_NovaConfig_Runner_ParseSettings_Returns = Shared_NovaConfig_Sett
694
695
 
695
696
  export type Lib_NovaConfig_Runner_ParseSettings_Result = {
696
697
  lockStepVersioning?: boolean;
698
+ versionStrategy?: Shared_NovaConfigSettings_VersionStrategy;
697
699
  };
698
700
 
699
701
  export type Lib_NovaConfig_Runner_ParseSettings_LockStepVersioning = boolean | undefined;
700
702
 
703
+ export type Lib_NovaConfig_Runner_ParseSettings_VersionStrategy = Shared_NovaConfigSettings_VersionStrategy | undefined;
704
+
701
705
  /**
702
706
  * Lib - Nova Config - Parse URLs.
703
707
  *
@@ -382,6 +382,15 @@ export type Lib_Utility_IsCommandExists_Error_Returns = void;
382
382
  */
383
383
  export type Lib_Utility_IsCommandExists_Exit_Returns = void;
384
384
 
385
+ /**
386
+ * Lib - Utility - Is Empty.
387
+ *
388
+ * @since 0.23.0
389
+ */
390
+ export type Lib_Utility_IsEmpty_Value = unknown;
391
+
392
+ export type Lib_Utility_IsEmpty_Returns = boolean;
393
+
385
394
  /**
386
395
  * Lib - Utility - Is Execute Shell Error.
387
396
  *
@@ -65,7 +65,7 @@ export type Shared_ChangelogEntry_FilePath = string;
65
65
  export type Shared_ChangelogEntry = {
66
66
  package: Shared_ChangelogEntry_Package;
67
67
  category: Shared_ChangelogEntry_Category;
68
- bump: Shared_ChangelogEntry_Bump;
68
+ bump?: Shared_ChangelogEntry_Bump;
69
69
  message: Shared_ChangelogEntry_Message;
70
70
  filePath: Shared_ChangelogEntry_FilePath;
71
71
  };
@@ -1380,8 +1380,16 @@ export type Shared_NovaConfig_Recipes = {
1380
1380
  'package-json'?: Shared_NovaConfig_Recipes_PackageJson;
1381
1381
  };
1382
1382
 
1383
+ /**
1384
+ * Shared - Nova Config Settings - Version Strategy.
1385
+ *
1386
+ * @since 0.23.0
1387
+ */
1388
+ export type Shared_NovaConfigSettings_VersionStrategy = 'semver' | 'calver';
1389
+
1383
1390
  export type Shared_NovaConfig_Settings = {
1384
1391
  lockStepVersioning?: boolean;
1392
+ versionStrategy?: Shared_NovaConfigSettings_VersionStrategy;
1385
1393
  };
1386
1394
 
1387
1395
  export type Shared_NovaConfig = {
@@ -1406,7 +1414,7 @@ export type Shared_NovaConfigConfig = Shared_NovaConfig;
1406
1414
  *
1407
1415
  * @since 0.11.0
1408
1416
  */
1409
- export type Shared_NovaConfigCategory = 'project' | 'entities' | 'emails' | 'github' | 'urls' | 'workspaces' | 'workflows' | 'gitignore' | 'agents' | 'environment';
1417
+ export type Shared_NovaConfigCategory = 'project' | 'entities' | 'emails' | 'github' | 'urls' | 'workspaces' | 'workflows' | 'gitignore' | 'agents' | 'environment' | 'settings';
1410
1418
 
1411
1419
  /**
1412
1420
  * Shared - Prompt With Cancel.
@@ -11,6 +11,158 @@ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SandboxPrefix = s
11
11
 
12
12
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SandboxRoot = string;
13
13
 
14
+ /**
15
+ * Tests - CLI - Utility - Changelog - Run - CalVer Entry With Bump Field Errors.
16
+ *
17
+ * @since 0.23.0
18
+ */
19
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_ProjectDirectory = string;
20
+
21
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_WorkspaceDirectory = string;
22
+
23
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_ChangelogDirectory = string;
24
+
25
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_PackageJsonPath = string;
26
+
27
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_PackageJsonContents = string;
28
+
29
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_ConfigPath = string;
30
+
31
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_ConfigContents = string;
32
+
33
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_WorkspacePackagePath = string;
34
+
35
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_WorkspacePackageContents = string;
36
+
37
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_EntryPath = string;
38
+
39
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverEntryWithBumpFieldErrors_EntryContents = string;
40
+
41
+ /**
42
+ * Tests - CLI - Utility - Changelog - Run - CalVer Record Omits Bump From Entry File.
43
+ *
44
+ * @since 0.23.0
45
+ */
46
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_ProjectDirectory = string;
47
+
48
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_PackageJsonPath = string;
49
+
50
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_PackageJsonContents = string;
51
+
52
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_ConfigPath = string;
53
+
54
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_ConfigContents = string;
55
+
56
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_ChangelogDirectory = string;
57
+
58
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_Files = string[];
59
+
60
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_MdFiles = string[];
61
+
62
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_MdFile = string;
63
+
64
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_EntryPath = string;
65
+
66
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_Content = string;
67
+
68
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_HasBump = boolean;
69
+
70
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_HasPackage = boolean;
71
+
72
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverRecordOmitsBumpFromEntryFile_HasCategory = boolean;
73
+
74
+ /**
75
+ * Tests - CLI - Utility - Changelog - Run - CalVer Release Computes Version From Date.
76
+ *
77
+ * @since 0.23.0
78
+ */
79
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ProjectDirectory = string;
80
+
81
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_WorkspaceDirectory = string;
82
+
83
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ChangelogDirectory = string;
84
+
85
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_PackageJsonPath = string;
86
+
87
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_PackageJsonContents = string;
88
+
89
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ConfigPath = string;
90
+
91
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ConfigContents = string;
92
+
93
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_WorkspacePackagePath = string;
94
+
95
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_WorkspacePackageContents = string;
96
+
97
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_EntryPath = string;
98
+
99
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_EntryContents = string;
100
+
101
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_UpdatedPackagePath = string;
102
+
103
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_PackageJsonRaw = string;
104
+
105
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_PackageJson = Record<string, unknown>;
106
+
107
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ExpectedYear = number;
108
+
109
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ExpectedMonth = number;
110
+
111
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ExpectedVersion = string;
112
+
113
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ChangelogPath = string;
114
+
115
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_ChangelogContent = string;
116
+
117
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_HasVersionHeading = boolean;
118
+
119
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_HasDateSuffix = boolean;
120
+
121
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_RemainingFiles = string[];
122
+
123
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseComputesVersionFromDate_RemainingMdFiles = string[];
124
+
125
+ /**
126
+ * Tests - CLI - Utility - Changelog - Run - CalVer Release Increments Micro Within Same Month.
127
+ *
128
+ * @since 0.23.0
129
+ */
130
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_ProjectDirectory = string;
131
+
132
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_WorkspaceDirectory = string;
133
+
134
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_ChangelogDirectory = string;
135
+
136
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_PackageJsonPath = string;
137
+
138
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_PackageJsonContents = string;
139
+
140
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_ConfigPath = string;
141
+
142
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_ConfigContents = string;
143
+
144
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_CurrentYear = number;
145
+
146
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_CurrentMonth = number;
147
+
148
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_CurrentVersion = string;
149
+
150
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_WorkspacePackagePath = string;
151
+
152
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_WorkspacePackageContents = string;
153
+
154
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_EntryPath = string;
155
+
156
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_EntryContents = string;
157
+
158
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_UpdatedPackagePath = string;
159
+
160
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_PackageJsonRaw = string;
161
+
162
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_PackageJson = Record<string, unknown>;
163
+
164
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_CalverReleaseIncrementsMicroWithinSameMonth_ExpectedVersion = string;
165
+
14
166
  /**
15
167
  * Tests - CLI - Utility - Changelog - Run - Dry Run Leaves UNRELEASED Tokens In Place.
16
168
  *
@@ -292,6 +444,33 @@ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_ReleasesAndBumpsV
292
444
 
293
445
  export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_ReleasesAndBumpsVersion_RemainingMdFiles = string[];
294
446
 
447
+ /**
448
+ * Tests - CLI - Utility - Changelog - Run - SemVer Entry Without Bump Field Errors.
449
+ *
450
+ * @since 0.23.0
451
+ */
452
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_ProjectDirectory = string;
453
+
454
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_WorkspaceDirectory = string;
455
+
456
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_ChangelogDirectory = string;
457
+
458
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_PackageJsonPath = string;
459
+
460
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_PackageJsonContents = string;
461
+
462
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_ConfigPath = string;
463
+
464
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_ConfigContents = string;
465
+
466
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_WorkspacePackagePath = string;
467
+
468
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_WorkspacePackageContents = string;
469
+
470
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_EntryPath = string;
471
+
472
+ export type Tests_Cli_Utility_Changelog_CliUtilityChangelogRun_SemverEntryWithoutBumpFieldErrors_EntryContents = string;
473
+
295
474
  /**
296
475
  * Tests - CLI - Utility - Changelog - Run - Skips Release When No Entries Exist.
297
476
  *
@@ -40,6 +40,20 @@ export type Tests_Lib_Item_AllowedRolesAndPolicies_LibItemAllowedRolesContainsEx
40
40
  */
41
41
  export type Tests_Lib_Item_AllowedRolesAndPolicies_LibItemAllowedRolesHasNoDuplicates_Unique = Set<string>;
42
42
 
43
+ /**
44
+ * Tests - Lib - Item - Allowed Roles And Policies - Template Role Accepts Freezable.
45
+ *
46
+ * @since 0.23.0
47
+ */
48
+ export type Tests_Lib_Item_AllowedRolesAndPolicies_TemplateRoleAcceptsFreezable_HasFreezable = boolean;
49
+
50
+ /**
51
+ * Tests - Lib - Item - Allowed Roles And Policies - Template Role Accepts Trackable.
52
+ *
53
+ * @since 0.23.0
54
+ */
55
+ export type Tests_Lib_Item_AllowedRolesAndPolicies_TemplateRoleAcceptsTrackable_HasTrackable = boolean;
56
+
43
57
  /**
44
58
  * Tests - Lib - Item - Changelog Constants - libItemChangelogAdjectives Has No Duplicates.
45
59
  *
@@ -1,3 +1,10 @@
1
+ /**
2
+ * Tests - Lib - Markdown Slug - SlugifyHeading - PreservesConsecutiveHyphensFromPunctuationAdjacentToSpaces.
3
+ *
4
+ * @since 0.24.0
5
+ */
6
+ export type Tests_Lib_MarkdownSlug_SlugifyHeading_PreservesConsecutiveHyphensFromPunctuationAdjacentToSpaces_Slug = string;
7
+
1
8
  /**
2
9
  * Tests - Lib - Markdown Slug - SlugifyHeading - ProducesADocusaurusStyleSlugFromAHeading.
3
10
  *
@@ -87,13 +87,15 @@ The right reader should feel informed; the wrong reader should not feel talked d
87
87
 
88
88
  ## Frontmatter
89
89
 
90
- Every MDX page requires these fields:
90
+ ### Documentation Pages
91
+
92
+ Every documentation page requires these fields:
91
93
 
92
94
  - `id` — kebab-case, matches filename without extension. No prefixes. For `index.mdx` files that serve as a category landing page, use a descriptive id that reflects the page's purpose (e.g., `overview`) instead of `index`.
93
- - `title` — Title Case, 2-5 words. No trailing periods.
94
- - `description` — One sentence, 50-160 characters, SEO-optimized. Starts with a verb or feature name.
95
- - `keywords` — 5-15 terms. Always include the project name first, then the feature name, category, synonyms, and related concepts. Focused pages naturally have fewer keywords; do not pad with filler.
96
- - `tags` — 3-7 terms. First tag is the category (cli, rules, toolkit, quickstart).
95
+ - `title` — Title Case, 1-5 words. Unique enough to distinguish pages in a sidebar. No trailing periods.
96
+ - `description` — One sentence, 120-160 characters. Starts with a verb or the feature name (never "This page explains...", "Learn how to...", or "Discover how...").
97
+ - `keywords` — 3-8 terms. Project name first, then feature name, category, and synonyms. Serves Docusaurus local search only (Google has not used meta keywords for ranking since 2009). Do not repeat the same word in different forms (e.g., "lint" and "linting").
98
+ - `tags` — 1-5 terms. First tag is the category (cli, rules, toolkit, quickstart). Optimized for Docusaurus local search, not external SEO.
97
99
 
98
100
  ```yaml
99
101
  ---
@@ -115,11 +117,20 @@ tags:
115
117
  ---
116
118
  ```
117
119
 
120
+ ### Blog Posts
121
+
122
+ Blog post frontmatter follows the same field set with adjusted ranges for headlines and social sharing:
123
+
124
+ - `title` — Title Case, no word limit. Target under 60 characters for search engine display; subtitles after a colon are acceptable.
125
+ - `description` — One sentence, 120-160 characters. Core message in the first 120 characters (mobile search results truncate there).
126
+ - `keywords` — 3-8 terms.
127
+ - `tags` — 1-5 terms.
128
+
118
129
  ## SEO
119
130
 
120
- - `description` reads as a natural sentence that a search engine would display as a snippet.
121
- - Start with a verb or the feature name, never "This page explains..." or "Learn how to..."
122
- - `keywords` include the feature name, category, synonyms, and related concepts. Do not repeat the same word in different forms (e.g., "lint" and "linting").
131
+ - `description` reads as a natural sentence that a search engine would display as a snippet. Write the core message in the first 120 characters for mobile display; use up to 160 for desktop completeness.
132
+ - Start with a verb or the feature name, never "This page explains...", "Learn how to...", or "Discover how..."
133
+ - `keywords` serve Docusaurus local search only. Google has not used the meta keywords tag for ranking since 2009; Bing treats keyword-stuffed meta keywords as a spam signal.
123
134
  - `tags` are optimized for Docusaurus local search, not external SEO.
124
135
 
125
136
  ## Page Templates
@@ -12,13 +12,13 @@
12
12
  "test": "vitest run"
13
13
  },
14
14
  "dependencies": {
15
- "@cbnventures/docusaurus-preset-nova": "0.22.6",
15
+ "@cbnventures/docusaurus-preset-nova": "0.24.0",
16
16
  "@docusaurus/core": "3.7.0",
17
17
  "react": "19.1.0",
18
18
  "react-dom": "19.1.0"
19
19
  },
20
20
  "devDependencies": {
21
- "@cbnventures/nova": "0.22.6",
21
+ "@cbnventures/nova": "0.24.0",
22
22
  "@docusaurus/types": "3.7.0",
23
23
  "glob": "13.0.6",
24
24
  "typescript": "5.8.3",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cbnventures/nova",
3
- "version": "0.22.6",
3
+ "version": "0.24.0",
4
4
  "description": "Scripts, templates, and project configuration for the common JavaScript and TypeScript developer",
5
5
  "keywords": [
6
6
  "eslint",