@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.
- package/build/package.json +1 -1
- package/build/src/cli/generate/github/workflows-blueprint.d.ts +1 -0
- package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
- package/build/src/cli/generate/github/workflows-blueprint.js +131 -187
- package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
- package/build/src/cli/recipe/github/gh-precheck.d.ts +3 -0
- package/build/src/cli/recipe/github/gh-precheck.d.ts.map +1 -0
- package/build/src/cli/recipe/github/gh-precheck.js +111 -0
- package/build/src/cli/recipe/github/gh-precheck.js.map +1 -0
- package/build/src/cli/recipe/github/sync-features.d.ts.map +1 -1
- package/build/src/cli/recipe/github/sync-features.js +8 -98
- package/build/src/cli/recipe/github/sync-features.js.map +1 -1
- package/build/src/cli/recipe/github/sync-identity.d.ts.map +1 -1
- package/build/src/cli/recipe/github/sync-identity.js +10 -98
- package/build/src/cli/recipe/github/sync-identity.js.map +1 -1
- package/build/src/cli/recipe/github/sync-policies.d.ts.map +1 -1
- package/build/src/cli/recipe/github/sync-policies.js +8 -98
- package/build/src/cli/recipe/github/sync-policies.js.map +1 -1
- package/build/src/cli/recipe/package-json/normalize-artifacts.d.ts +0 -1
- package/build/src/cli/recipe/package-json/normalize-artifacts.d.ts.map +1 -1
- package/build/src/cli/recipe/package-json/normalize-artifacts.js +6 -21
- package/build/src/cli/recipe/package-json/normalize-artifacts.js.map +1 -1
- package/build/src/cli/recipe/package-json/normalize-dependencies.d.ts +0 -1
- package/build/src/cli/recipe/package-json/normalize-dependencies.d.ts.map +1 -1
- package/build/src/cli/recipe/package-json/normalize-dependencies.js +8 -23
- package/build/src/cli/recipe/package-json/normalize-dependencies.js.map +1 -1
- package/build/src/cli/recipe/package-json/normalize-tooling.d.ts +0 -1
- package/build/src/cli/recipe/package-json/normalize-tooling.d.ts.map +1 -1
- package/build/src/cli/recipe/package-json/normalize-tooling.js +2 -17
- package/build/src/cli/recipe/package-json/normalize-tooling.js.map +1 -1
- package/build/src/cli/recipe/package-json/sync-environment.d.ts +0 -1
- package/build/src/cli/recipe/package-json/sync-environment.d.ts.map +1 -1
- package/build/src/cli/recipe/package-json/sync-environment.js +4 -19
- package/build/src/cli/recipe/package-json/sync-environment.js.map +1 -1
- package/build/src/cli/utility/changelog.d.ts.map +1 -1
- package/build/src/cli/utility/changelog.js +179 -86
- package/build/src/cli/utility/changelog.js.map +1 -1
- package/build/src/cli/utility/initialize.d.ts +1 -0
- package/build/src/cli/utility/initialize.d.ts.map +1 -1
- package/build/src/cli/utility/initialize.js +61 -0
- package/build/src/cli/utility/initialize.js.map +1 -1
- package/build/src/lib/item.d.ts.map +1 -1
- package/build/src/lib/item.js +4 -1
- package/build/src/lib/item.js.map +1 -1
- package/build/src/lib/markdown-slug.js +2 -2
- package/build/src/lib/markdown-slug.js.map +1 -1
- package/build/src/lib/nova-config.d.ts.map +1 -1
- package/build/src/lib/nova-config.js +4 -0
- package/build/src/lib/nova-config.js.map +1 -1
- package/build/src/lib/regex.d.ts +1 -0
- package/build/src/lib/regex.d.ts.map +1 -1
- package/build/src/lib/regex.js +1 -0
- package/build/src/lib/regex.js.map +1 -1
- package/build/src/lib/utility.d.ts +2 -1
- package/build/src/lib/utility.d.ts.map +1 -1
- package/build/src/lib/utility.js +15 -0
- package/build/src/lib/utility.js.map +1 -1
- package/build/src/presets/eslint/dx-ignore.d.ts.map +1 -1
- package/build/src/presets/eslint/dx-ignore.js +4 -0
- package/build/src/presets/eslint/dx-ignore.js.map +1 -1
- package/build/src/toolkit/nova-identity.js +1 -1
- package/build/src/toolkit/nova-identity.js.map +1 -1
- package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +39 -0
- package/build/src/types/cli/recipe/github/gh-precheck.d.ts +86 -0
- package/build/src/types/cli/recipe/github/sync-features.d.ts +6 -43
- package/build/src/types/cli/recipe/github/sync-identity.d.ts +6 -40
- package/build/src/types/cli/recipe/github/sync-policies.d.ts +6 -43
- package/build/src/types/cli/recipe/package-json/normalize-artifacts.d.ts +0 -9
- package/build/src/types/cli/recipe/package-json/normalize-dependencies.d.ts +0 -9
- package/build/src/types/cli/recipe/package-json/normalize-tooling.d.ts +0 -9
- package/build/src/types/cli/recipe/package-json/sync-environment.d.ts +0 -9
- package/build/src/types/cli/utility/changelog.d.ts +25 -2
- package/build/src/types/cli/utility/initialize.d.ts +53 -0
- package/build/src/types/lib/item.d.ts +1 -1
- package/build/src/types/lib/nova-config.d.ts +4 -0
- package/build/src/types/lib/utility.d.ts +9 -0
- package/build/src/types/shared.d.ts +10 -2
- package/build/src/types/tests/cli/utility/changelog.test.d.ts +179 -0
- package/build/src/types/tests/lib/item.test.d.ts +14 -0
- package/build/src/types/tests/lib/markdown-slug.test.d.ts +7 -0
- package/build/templates/generators/must-haves/agent-conventions/conventions/documentation.md +19 -8
- package/build/templates/scaffold/docs/docusaurus/package.json +2 -2
- 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
|
|
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
|
*
|
package/build/templates/generators/must-haves/agent-conventions/conventions/documentation.md
CHANGED
|
@@ -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
|
-
|
|
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,
|
|
94
|
-
- `description` — One sentence,
|
|
95
|
-
- `keywords` —
|
|
96
|
-
- `tags` —
|
|
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..."
|
|
122
|
-
- `keywords`
|
|
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.
|
|
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.
|
|
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",
|