@cbnventures/nova 0.18.0 → 0.20.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 +6 -3
- package/build/src/cli/generate/github/issue-template.d.ts.map +1 -1
- package/build/src/cli/generate/github/issue-template.js +4 -93
- package/build/src/cli/generate/github/issue-template.js.map +1 -1
- package/build/src/cli/generate/must-haves/agent-conventions.d.ts.map +1 -1
- package/build/src/cli/generate/must-haves/agent-conventions.js +12 -3
- package/build/src/cli/generate/must-haves/agent-conventions.js.map +1 -1
- package/build/src/cli/generate/must-haves/dotenv.d.ts +4 -7
- package/build/src/cli/generate/must-haves/dotenv.d.ts.map +1 -1
- package/build/src/cli/generate/must-haves/dotenv.js +120 -417
- package/build/src/cli/generate/must-haves/dotenv.js.map +1 -1
- package/build/src/cli/generate/must-haves/gitignore.d.ts +0 -8
- package/build/src/cli/generate/must-haves/gitignore.d.ts.map +1 -1
- package/build/src/cli/generate/must-haves/gitignore.js +7 -395
- package/build/src/cli/generate/must-haves/gitignore.js.map +1 -1
- package/build/src/cli/index.js +31 -31
- package/build/src/cli/index.js.map +1 -1
- package/build/src/cli/recipe/github/sync-identity.js +1 -1
- 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 -1
- package/build/src/cli/recipe/github/sync-policies.js.map +1 -1
- package/build/src/cli/utility/changelog.d.ts +2 -0
- package/build/src/cli/utility/changelog.d.ts.map +1 -1
- package/build/src/cli/utility/changelog.js +154 -2
- package/build/src/cli/utility/changelog.js.map +1 -1
- package/build/src/cli/utility/initialize.d.ts +3 -0
- package/build/src/cli/utility/initialize.d.ts.map +1 -1
- package/build/src/cli/utility/initialize.js +305 -1
- package/build/src/cli/utility/initialize.js.map +1 -1
- package/build/src/lib/dotenv.d.ts +3 -0
- package/build/src/lib/dotenv.d.ts.map +1 -0
- package/build/src/lib/dotenv.js +66 -0
- package/build/src/lib/dotenv.js.map +1 -0
- package/build/src/lib/file-discovery.d.ts +3 -0
- package/build/src/lib/file-discovery.d.ts.map +1 -0
- package/build/src/lib/file-discovery.js +32 -0
- package/build/src/lib/file-discovery.js.map +1 -0
- package/build/src/lib/item.d.ts +3 -1
- package/build/src/lib/item.d.ts.map +1 -1
- package/build/src/lib/item.js +9 -0
- package/build/src/lib/item.js.map +1 -1
- package/build/src/lib/markdown-slug.d.ts +4 -0
- package/build/src/lib/markdown-slug.d.ts.map +1 -0
- package/build/src/lib/markdown-slug.js +25 -0
- package/build/src/lib/markdown-slug.js.map +1 -0
- package/build/src/lib/nova-config.d.ts +5 -0
- package/build/src/lib/nova-config.d.ts.map +1 -1
- package/build/src/lib/nova-config.js +135 -13
- package/build/src/lib/nova-config.js.map +1 -1
- package/build/src/lib/regex.d.ts +68 -0
- package/build/src/lib/regex.d.ts.map +1 -1
- package/build/src/lib/regex.js +70 -2
- package/build/src/lib/regex.js.map +1 -1
- package/build/src/lib/type-declaration-engine.d.ts +32 -0
- package/build/src/lib/type-declaration-engine.d.ts.map +1 -0
- package/build/src/lib/type-declaration-engine.js +770 -0
- package/build/src/lib/type-declaration-engine.js.map +1 -0
- package/build/src/lib/utility.d.ts.map +1 -1
- package/build/src/lib/utility.js +8 -8
- package/build/src/lib/utility.js.map +1 -1
- package/build/src/rules/eslint/conventions/require-kebab-case-filename.d.ts.map +1 -1
- package/build/src/rules/eslint/conventions/require-kebab-case-filename.js.map +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts.map +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js +3 -3
- package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js.map +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-param-alignment.d.ts.map +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-param-alignment.js +3 -2
- package/build/src/rules/eslint/jsdoc/require-jsdoc-param-alignment.js.map +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.js +2 -2
- package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.js.map +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-since.d.ts +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-since.d.ts.map +1 -1
- package/build/src/rules/eslint/jsdoc/require-jsdoc-since.js +102 -6
- package/build/src/rules/eslint/jsdoc/require-jsdoc-since.js.map +1 -1
- package/build/src/rules/eslint/regex/no-regex-literals.d.ts +1 -0
- package/build/src/rules/eslint/regex/no-regex-literals.d.ts.map +1 -1
- package/build/src/rules/eslint/regex/no-regex-literals.js +39 -1
- package/build/src/rules/eslint/regex/no-regex-literals.js.map +1 -1
- package/build/src/rules/eslint/typescript/require-type-naming.js +2 -2
- package/build/src/rules/eslint/typescript/require-type-naming.js.map +1 -1
- package/build/src/rules/vitest/dotenv/register.d.ts +3 -0
- package/build/src/rules/vitest/dotenv/register.d.ts.map +1 -0
- package/build/src/rules/vitest/dotenv/register.js +21 -0
- package/build/src/rules/vitest/dotenv/register.js.map +1 -0
- package/build/src/rules/vitest/dotenv/rules.d.ts +3 -0
- package/build/src/rules/vitest/dotenv/rules.d.ts.map +1 -0
- package/build/src/rules/vitest/dotenv/rules.js +32 -0
- package/build/src/rules/vitest/dotenv/rules.js.map +1 -0
- package/build/src/rules/vitest/enable.d.ts +3 -0
- package/build/src/rules/vitest/enable.d.ts.map +1 -0
- package/build/src/rules/vitest/enable.js +7 -0
- package/build/src/rules/vitest/enable.js.map +1 -0
- package/build/src/rules/vitest/frontmatter/register.d.ts +3 -0
- package/build/src/rules/vitest/frontmatter/register.d.ts.map +1 -0
- package/build/src/rules/vitest/frontmatter/register.js +51 -0
- package/build/src/rules/vitest/frontmatter/register.js.map +1 -0
- package/build/src/rules/vitest/frontmatter/rules.d.ts +15 -0
- package/build/src/rules/vitest/frontmatter/rules.d.ts.map +1 -0
- package/build/src/rules/vitest/frontmatter/rules.js +498 -0
- package/build/src/rules/vitest/frontmatter/rules.js.map +1 -0
- package/build/src/rules/vitest/index.d.ts +8 -0
- package/build/src/rules/vitest/index.d.ts.map +1 -0
- package/build/src/rules/vitest/index.js +7 -0
- package/build/src/rules/vitest/index.js.map +1 -0
- package/build/src/rules/vitest/link/register.d.ts +3 -0
- package/build/src/rules/vitest/link/register.d.ts.map +1 -0
- package/build/src/rules/vitest/link/register.js +43 -0
- package/build/src/rules/vitest/link/register.js.map +1 -0
- package/build/src/rules/vitest/link/rules.d.ts +12 -0
- package/build/src/rules/vitest/link/rules.d.ts.map +1 -0
- package/build/src/rules/vitest/link/rules.js +313 -0
- package/build/src/rules/vitest/link/rules.js.map +1 -0
- package/build/src/rules/vitest/markdown-table/register.d.ts +3 -0
- package/build/src/rules/vitest/markdown-table/register.d.ts.map +1 -0
- package/build/src/rules/vitest/markdown-table/register.js +25 -0
- package/build/src/rules/vitest/markdown-table/register.js.map +1 -0
- package/build/src/rules/vitest/markdown-table/rules.d.ts +3 -0
- package/build/src/rules/vitest/markdown-table/rules.d.ts.map +1 -0
- package/build/src/rules/vitest/markdown-table/rules.js +99 -0
- package/build/src/rules/vitest/markdown-table/rules.js.map +1 -0
- package/build/src/rules/vitest/terminology/register.d.ts +3 -0
- package/build/src/rules/vitest/terminology/register.d.ts.map +1 -0
- package/build/src/rules/vitest/terminology/register.js +38 -0
- package/build/src/rules/vitest/terminology/register.js.map +1 -0
- package/build/src/rules/vitest/terminology/rules.d.ts +10 -0
- package/build/src/rules/vitest/terminology/rules.d.ts.map +1 -0
- package/build/src/rules/vitest/terminology/rules.js +202 -0
- package/build/src/rules/vitest/terminology/rules.js.map +1 -0
- package/build/src/rules/vitest/type-declarations/register.d.ts +3 -0
- package/build/src/rules/vitest/type-declarations/register.d.ts.map +1 -0
- package/build/src/rules/vitest/type-declarations/register.js +30 -0
- package/build/src/rules/vitest/type-declarations/register.js.map +1 -0
- package/build/src/rules/vitest/type-declarations/rules.d.ts +11 -0
- package/build/src/rules/vitest/type-declarations/rules.d.ts.map +1 -0
- package/build/src/rules/vitest/type-declarations/rules.js +666 -0
- package/build/src/rules/vitest/type-declarations/rules.js.map +1 -0
- package/build/src/toolkit/logger.d.ts.map +1 -1
- package/build/src/toolkit/logger.js +3 -1
- package/build/src/toolkit/logger.js.map +1 -1
- package/build/src/types/cli/generate/github/issue-template.d.ts +10 -30
- package/build/src/types/cli/generate/github/workflows.d.ts +7 -7
- package/build/src/types/cli/generate/must-haves/agent-conventions.d.ts +8 -1
- package/build/src/types/cli/generate/must-haves/dotenv.d.ts +79 -327
- package/build/src/types/cli/generate/must-haves/gitignore.d.ts +12 -342
- package/build/src/types/cli/recipe/github/sync-features.d.ts +1 -1
- package/build/src/types/cli/recipe/github/sync-identity.d.ts +2 -2
- package/build/src/types/cli/recipe/github/sync-policies.d.ts +3 -1
- package/build/src/types/cli/utility/changelog.d.ts +92 -0
- package/build/src/types/cli/utility/initialize.d.ts +195 -0
- package/build/src/types/lib/constants.d.ts +1 -1
- package/build/src/types/lib/dotenv.d.ts +67 -0
- package/build/src/types/lib/file-discovery.d.ts +40 -0
- package/build/src/types/lib/item.d.ts +19 -0
- package/build/src/types/lib/markdown-slug.d.ts +25 -0
- package/build/src/types/lib/nova-config.d.ts +108 -16
- package/build/src/types/lib/regex.d.ts +193 -18
- package/build/src/types/lib/type-declaration-engine.d.ts +1036 -0
- package/build/src/types/lib/utility.d.ts +2 -2
- package/build/src/types/lib/workflow-templates.d.ts +1 -1
- package/build/src/types/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts +2 -2
- package/build/src/types/rules/eslint/jsdoc/require-jsdoc-since.d.ts +71 -1
- package/build/src/types/rules/eslint/regex/no-regex-literals.d.ts +44 -0
- package/build/src/types/rules/eslint/typescript/require-type-naming.d.ts +3 -3
- package/build/src/types/rules/vitest/dotenv/register.d.ts +31 -0
- package/build/src/types/rules/vitest/dotenv/rules.d.ts +29 -0
- package/build/src/types/rules/vitest/enable.d.ts +12 -0
- package/build/src/types/rules/vitest/frontmatter/register.d.ts +63 -0
- package/build/src/types/rules/vitest/frontmatter/rules.d.ts +430 -0
- package/build/src/types/rules/vitest/index.d.ts +399 -0
- package/build/src/types/rules/vitest/link/register.d.ts +79 -0
- package/build/src/types/rules/vitest/link/rules.d.ts +368 -0
- package/build/src/types/rules/vitest/markdown-table/register.d.ts +33 -0
- package/build/src/types/rules/vitest/markdown-table/rules.d.ts +55 -0
- package/build/src/types/rules/vitest/terminology/register.d.ts +48 -0
- package/build/src/types/rules/vitest/terminology/rules.d.ts +190 -0
- package/build/src/types/rules/vitest/type-declarations/register.d.ts +46 -0
- package/build/src/types/rules/vitest/type-declarations/rules.d.ts +820 -0
- package/build/src/types/shared.d.ts +71 -4
- package/build/src/types/tests/cli/generate/github/issue-template.test.d.ts +34 -17
- package/build/src/types/tests/cli/generate/github/workflows-helpers.test.d.ts +8 -8
- package/build/src/types/tests/cli/generate/must-haves/agent-conventions.test.d.ts +79 -11
- package/build/src/types/tests/cli/generate/must-haves/dotenv.test.d.ts +105 -15
- package/build/src/types/tests/cli/generate/must-haves/gitignore.test.d.ts +11 -20
- package/build/src/types/tests/cli/recipe/github/handle-gh-failure.test.d.ts +3 -3
- package/build/src/types/tests/cli/recipe/github/sync-features.test.d.ts +17 -17
- package/build/src/types/tests/cli/recipe/github/sync-identity.test.d.ts +69 -23
- package/build/src/types/tests/cli/recipe/github/sync-policies.test.d.ts +89 -20
- package/build/src/types/tests/cli/scaffold/docs/docusaurus.test.d.ts +4 -0
- package/build/src/types/tests/cli/utility/changelog.test.d.ts +262 -0
- package/build/src/types/tests/cli/utility/initialize.test.d.ts +31 -0
- package/build/src/types/tests/lib/dotenv.test.d.ts +95 -0
- package/build/src/types/tests/lib/file-discovery.test.d.ts +37 -0
- package/build/src/types/tests/lib/item.test.d.ts +21 -0
- package/build/src/types/tests/lib/markdown-slug.test.d.ts +24 -0
- package/build/src/types/tests/lib/nova-config.test.d.ts +263 -0
- package/build/src/types/tests/lib/regex.test.d.ts +252 -0
- package/build/src/types/tests/rules/eslint/jsdoc/require-jsdoc-since.test.d.ts +18 -0
- package/build/src/types/tests/rules/vitest/dotenv.test.d.ts +19 -0
- package/build/src/types/tests/rules/vitest/enable.test.d.ts +27 -0
- package/build/src/types/tests/rules/vitest/frontmatter.test.d.ts +8 -0
- package/build/src/types/tests/rules/vitest/link.test.d.ts +74 -0
- package/build/src/types/tests/rules/vitest/markdown-table.test.d.ts +28 -0
- package/build/src/types/tests/rules/vitest/terminology.test.d.ts +39 -0
- package/build/src/types/tests/rules/vitest/type-declarations.test.d.ts +10 -0
- package/build/src/types/tests/scaffold-version-drift.test.d.ts +42 -0
- package/build/src/types/tests/since-version.test.d.ts +137 -0
- package/build/src/types/tests/toolkit/logger.test.d.ts +45 -0
- package/build/src/types/tests/type-declarations.test.d.ts +34 -1821
- package/build/src/types/toolkit/logger.d.ts +4 -0
- package/build/templates/generators/github/workflows/check-sponsor-gated-issues/base.yml +1 -1
- package/build/templates/generators/github/workflows/publish/base.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/aws-amplify-nextjs.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/cloudflare-pages-docusaurus.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/docker-hub.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/ghcr.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/github-action.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/github-packages.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/github-pages-docusaurus.yml +4 -4
- package/build/templates/generators/github/workflows/publish/targets/npm.yml +1 -1
- package/build/templates/generators/github/workflows/publish/targets/vercel-nextjs.yml +1 -1
- package/build/templates/generators/must-haves/agent-conventions/AGENTS.md +1 -2
- package/build/templates/generators/must-haves/agent-conventions/CLAUDE.md +1 -2
- package/build/templates/generators/must-haves/agent-conventions/conventions/java.md +5 -5
- package/build/templates/generators/must-haves/agent-conventions/conventions/kotlin.md +4 -4
- package/build/templates/generators/must-haves/agent-conventions/conventions/php.md +2 -2
- package/build/templates/generators/must-haves/agent-conventions/conventions/typescript.md +6 -6
- package/build/templates/generators/must-haves/dotenv/env +5 -2
- package/build/templates/generators/must-haves/dotenv/env.sample +6 -3
- package/build/templates/generators/must-haves/gitignore/gitignore +6 -0
- package/build/templates/scaffold/app/express/package.json +5 -5
- package/build/templates/scaffold/app/nextjs/package.json +7 -7
- package/build/templates/scaffold/app/vite/package.json +3 -3
- package/build/templates/scaffold/app/workers/package.json +3 -3
- package/build/templates/scaffold/docs/docusaurus/docs/intro.md +6 -0
- package/build/templates/scaffold/docs/docusaurus/package.json +11 -7
- package/build/templates/scaffold/docs/docusaurus/src/tests/frontmatter.test.ts +21 -0
- package/build/templates/scaffold/docs/docusaurus/src/tests/link.test.ts +14 -0
- package/build/templates/scaffold/docs/docusaurus/src/tests/markdown-table.test.ts +14 -0
- package/build/templates/scaffold/docs/docusaurus/src/tests/terminology.test.ts +14 -0
- package/build/templates/scaffold/docs/docusaurus/vitest.config.ts +22 -0
- package/build/templates/scaffold/docs/docusaurus/vitest.setup.ts +26 -0
- package/package.json +6 -3
- package/build/templates/generators/must-haves/agent-conventions/cursorrules +0 -55
|
@@ -180,6 +180,10 @@ export type Toolkit_Logger_Runner_ShouldLog_CurrentLogLevel = string;
|
|
|
180
180
|
|
|
181
181
|
export type Toolkit_Logger_Runner_ShouldLog_DefaultLogLevel = Shared_LogLevel | undefined;
|
|
182
182
|
|
|
183
|
+
export type Toolkit_Logger_Runner_ShouldLog_IsAutoLogLevel = boolean;
|
|
184
|
+
|
|
185
|
+
export type Toolkit_Logger_Runner_ShouldLog_IsUserSelectableLevel = boolean;
|
|
186
|
+
|
|
183
187
|
export type Toolkit_Logger_Runner_ShouldLog_PreferredLogLevelCurrentLogLevel = Shared_LogLevel;
|
|
184
188
|
|
|
185
189
|
export type Toolkit_Logger_Runner_ShouldLog_PreferredLogLevel = Toolkit_Logger_Runner_ShouldLog_PreferredLogLevelCurrentLogLevel;
|
package/build/templates/generators/github/workflows/publish/targets/github-pages-docusaurus.yml
CHANGED
|
@@ -9,7 +9,7 @@ publish-github-pages-docusaurus-[__TARGET_ID__]:
|
|
|
9
9
|
[__JOBS_CONDITION__]
|
|
10
10
|
steps:
|
|
11
11
|
- name: "Checkout repository"
|
|
12
|
-
uses: "actions/checkout@
|
|
12
|
+
uses: "actions/checkout@v7"
|
|
13
13
|
|
|
14
14
|
- name: "Download build artifacts"
|
|
15
15
|
uses: "actions/download-artifact@v8"
|
|
@@ -31,14 +31,14 @@ publish-github-pages-docusaurus-[__TARGET_ID__]:
|
|
|
31
31
|
|
|
32
32
|
- name: "Setup GitHub Pages"
|
|
33
33
|
if: "${{ env.PUBLISH == 'true' && env.PAGES_ENABLED == 'true' }}"
|
|
34
|
-
uses: "actions/configure-pages@
|
|
34
|
+
uses: "actions/configure-pages@v6"
|
|
35
35
|
|
|
36
36
|
- name: "Upload artifact to GitHub Pages"
|
|
37
37
|
if: "${{ env.PUBLISH == 'true' && env.PAGES_ENABLED == 'true' }}"
|
|
38
|
-
uses: "actions/upload-pages-artifact@
|
|
38
|
+
uses: "actions/upload-pages-artifact@v5"
|
|
39
39
|
with:
|
|
40
40
|
path: "[__WORKING_DIR__]/build"
|
|
41
41
|
|
|
42
42
|
- name: "Deploy to GitHub Pages"
|
|
43
43
|
if: "${{ env.PUBLISH == 'true' && env.PAGES_ENABLED == 'true' }}"
|
|
44
|
-
uses: "actions/deploy-pages@
|
|
44
|
+
uses: "actions/deploy-pages@v5"
|
|
@@ -47,9 +47,8 @@ These files contain critical project information — architectural decisions, id
|
|
|
47
47
|
|
|
48
48
|
## Restricted Files
|
|
49
49
|
|
|
50
|
-
These files are managed
|
|
50
|
+
These files are managed by Nova's agent-conventions generator (`nova generate must-haves agent-conventions`) and kept in sync across environments. Do not edit them locally; the generator overwrites them on its next run, so local changes are lost and cause drift.
|
|
51
51
|
|
|
52
|
-
- `.cursorrules`
|
|
53
52
|
- `CLAUDE.md`
|
|
54
53
|
- `AGENTS.md`
|
|
55
54
|
- `conventions/*.md`
|
|
@@ -47,9 +47,8 @@ These files contain critical project information — architectural decisions, id
|
|
|
47
47
|
|
|
48
48
|
## Restricted Files
|
|
49
49
|
|
|
50
|
-
These files are managed
|
|
50
|
+
These files are managed by Nova's agent-conventions generator (`nova generate must-haves agent-conventions`) and kept in sync across environments. Do not edit them locally; the generator overwrites them on its next run, so local changes are lost and cause drift.
|
|
51
51
|
|
|
52
|
-
- `.cursorrules`
|
|
53
52
|
- `CLAUDE.md`
|
|
54
53
|
- `AGENTS.md`
|
|
55
54
|
- `conventions/*.md`
|
|
@@ -5,7 +5,7 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
|
|
|
5
5
|
## Documentation Style
|
|
6
6
|
|
|
7
7
|
- Comment syntax: `/** */`
|
|
8
|
-
- Padding tag: `@since
|
|
8
|
+
- Padding tag: `@since UNRELEASED` (Javadoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
|
|
9
9
|
- Param format: `@param name - Name.` (description matches the parameter name, capitalized, with a trailing period)
|
|
10
10
|
- Return format: `@return Type`
|
|
11
11
|
|
|
@@ -15,13 +15,13 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
|
|
|
15
15
|
/**
|
|
16
16
|
* Entity Repository.
|
|
17
17
|
*
|
|
18
|
-
* @since
|
|
18
|
+
* @since UNRELEASED
|
|
19
19
|
*/
|
|
20
20
|
public class EntityRepository {
|
|
21
21
|
/**
|
|
22
22
|
* Entity Repository - Database.
|
|
23
23
|
*
|
|
24
|
-
* @since
|
|
24
|
+
* @since UNRELEASED
|
|
25
25
|
*/
|
|
26
26
|
private final Database database;
|
|
27
27
|
|
|
@@ -30,7 +30,7 @@ public class EntityRepository {
|
|
|
30
30
|
*
|
|
31
31
|
* @param database - Database.
|
|
32
32
|
*
|
|
33
|
-
* @since
|
|
33
|
+
* @since UNRELEASED
|
|
34
34
|
*/
|
|
35
35
|
public EntityRepository(Database database) { ... }
|
|
36
36
|
|
|
@@ -41,7 +41,7 @@ public class EntityRepository {
|
|
|
41
41
|
*
|
|
42
42
|
* @return Entity
|
|
43
43
|
*
|
|
44
|
-
* @since
|
|
44
|
+
* @since UNRELEASED
|
|
45
45
|
*/
|
|
46
46
|
public Entity findById(UUID id) { ... }
|
|
47
47
|
}
|
|
@@ -5,7 +5,7 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
|
|
|
5
5
|
## Documentation Style
|
|
6
6
|
|
|
7
7
|
- Comment syntax: `/** */`
|
|
8
|
-
- Padding tag: `@since
|
|
8
|
+
- Padding tag: `@since UNRELEASED` (KDoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
|
|
9
9
|
- Param format: `@param name - Name.` (description matches the parameter name, capitalized, with a trailing period)
|
|
10
10
|
- Return format: `@return Type?`
|
|
11
11
|
- Include `@private` tag for private members.
|
|
@@ -16,13 +16,13 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
|
|
|
16
16
|
/**
|
|
17
17
|
* Entity Repository.
|
|
18
18
|
*
|
|
19
|
-
* @since
|
|
19
|
+
* @since UNRELEASED
|
|
20
20
|
*/
|
|
21
21
|
class EntityRepository(
|
|
22
22
|
/**
|
|
23
23
|
* Entity Repository - Database.
|
|
24
24
|
*
|
|
25
|
-
* @since
|
|
25
|
+
* @since UNRELEASED
|
|
26
26
|
*/
|
|
27
27
|
private val database: Database,
|
|
28
28
|
) {
|
|
@@ -33,7 +33,7 @@ class EntityRepository(
|
|
|
33
33
|
*
|
|
34
34
|
* @return Entity?
|
|
35
35
|
*
|
|
36
|
-
* @since
|
|
36
|
+
* @since UNRELEASED
|
|
37
37
|
*/
|
|
38
38
|
suspend fun findById(id: UUID): Entity? { ... }
|
|
39
39
|
}
|
|
@@ -5,7 +5,7 @@ Quotes: Single (non-interpolated). Indentation: 4-space. File naming: PascalCase
|
|
|
5
5
|
## Documentation Style
|
|
6
6
|
|
|
7
7
|
- Comment syntax: `/** */`
|
|
8
|
-
- Padding tag: `@since
|
|
8
|
+
- Padding tag: `@since UNRELEASED` (PHPDoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
|
|
9
9
|
- Param format: `@param type $name - Name.` (description matches the parameter name, capitalized, with a trailing period)
|
|
10
10
|
- Return format: `@return type`
|
|
11
11
|
- Include `@private` tag for private members.
|
|
@@ -22,7 +22,7 @@ Quotes: Single (non-interpolated). Indentation: 4-space. File naming: PascalCase
|
|
|
22
22
|
*
|
|
23
23
|
* @return void
|
|
24
24
|
*
|
|
25
|
-
* @since
|
|
25
|
+
* @since UNRELEASED
|
|
26
26
|
*/
|
|
27
27
|
function backup_config_file(
|
|
28
28
|
string $backup_name,
|
|
@@ -5,7 +5,7 @@ Quotes: Single. Indentation: 2-space. File naming: kebab-case (e.g., `markdown-t
|
|
|
5
5
|
## Documentation Style
|
|
6
6
|
|
|
7
7
|
- Comment syntax: `/** */`
|
|
8
|
-
- Padding tag: `@since
|
|
8
|
+
- Padding tag: `@since UNRELEASED` (JSDoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
|
|
9
9
|
- Param format: `@param {TypeName} name - Name.` (description matches the parameter name, capitalized, with a trailing period)
|
|
10
10
|
- Return format: `@returns {TypeName}`
|
|
11
11
|
- Include `@private` tag for private members.
|
|
@@ -54,7 +54,7 @@ The example below is for the file `src/cli/utility/changelog.ts`. The class is n
|
|
|
54
54
|
/**
|
|
55
55
|
* CLI - Utility - Changelog.
|
|
56
56
|
*
|
|
57
|
-
* @since
|
|
57
|
+
* @since UNRELEASED
|
|
58
58
|
*/
|
|
59
59
|
export class Runner {
|
|
60
60
|
/**
|
|
@@ -64,7 +64,7 @@ export class Runner {
|
|
|
64
64
|
*
|
|
65
65
|
* @returns {Cli_Utility_Changelog_Runner_Run_Returns}
|
|
66
66
|
*
|
|
67
|
-
* @since
|
|
67
|
+
* @since UNRELEASED
|
|
68
68
|
*/
|
|
69
69
|
public static async run(options: Cli_Utility_Changelog_Runner_Run_Options): Cli_Utility_Changelog_Runner_Run_Returns {
|
|
70
70
|
}
|
|
@@ -76,7 +76,7 @@ export class Runner {
|
|
|
76
76
|
*
|
|
77
77
|
* @returns {Cli_Utility_Changelog_Runner_FetchData_Returns}
|
|
78
78
|
*
|
|
79
|
-
* @since
|
|
79
|
+
* @since UNRELEASED
|
|
80
80
|
*/
|
|
81
81
|
private static async fetchData(): Cli_Utility_Changelog_Runner_FetchData_Returns {
|
|
82
82
|
}
|
|
@@ -91,7 +91,7 @@ export class Runner {
|
|
|
91
91
|
*
|
|
92
92
|
* @returns {Cli_Utility_Changelog_Runner_FormatLine_Returns}
|
|
93
93
|
*
|
|
94
|
-
* @since
|
|
94
|
+
* @since UNRELEASED
|
|
95
95
|
*/
|
|
96
96
|
private static formatLine(prefix: Cli_Utility_Changelog_Runner_FormatLine_Prefix, message: Cli_Utility_Changelog_Runner_FormatLine_Message): Cli_Utility_Changelog_Runner_FormatLine_Returns {
|
|
97
97
|
}
|
|
@@ -377,7 +377,7 @@ export type Toolkit_MarkdownTable_Runner_AddRow_Returns = void;
|
|
|
377
377
|
*
|
|
378
378
|
* @returns {Toolkit_MarkdownTable_Runner_AddRow_Returns}
|
|
379
379
|
*
|
|
380
|
-
* @since
|
|
380
|
+
* @since UNRELEASED
|
|
381
381
|
*/
|
|
382
382
|
public addRow(row: Toolkit_MarkdownTable_Runner_AddRow_Row): Toolkit_MarkdownTable_Runner_AddRow_Returns { ... }
|
|
383
383
|
```
|
|
@@ -1,13 +1,16 @@
|
|
|
1
1
|
############################
|
|
2
2
|
#### Node.js - Settings ####
|
|
3
3
|
############################
|
|
4
|
+
# NODE_ENV: development | production | test
|
|
4
5
|
NODE_ENV="development"
|
|
5
6
|
|
|
6
7
|
#########################
|
|
7
8
|
#### Nova - CLI Logs ####
|
|
8
9
|
#########################
|
|
9
|
-
LOG_LEVEL
|
|
10
|
-
|
|
10
|
+
# LOG_LEVEL: debug | info | warn | error | auto (auto derives the level from NODE_ENV)
|
|
11
|
+
LOG_LEVEL="auto"
|
|
12
|
+
# LOG_TIME: true | false
|
|
13
|
+
LOG_TIME="false"
|
|
11
14
|
|
|
12
15
|
#############################
|
|
13
16
|
#### Project - Variables ####
|
|
@@ -1,13 +1,16 @@
|
|
|
1
1
|
############################
|
|
2
2
|
#### Node.js - Settings ####
|
|
3
3
|
############################
|
|
4
|
-
NODE_ENV
|
|
4
|
+
# NODE_ENV: development | production | test
|
|
5
|
+
NODE_ENV="development"
|
|
5
6
|
|
|
6
7
|
#########################
|
|
7
8
|
#### Nova - CLI Logs ####
|
|
8
9
|
#########################
|
|
9
|
-
LOG_LEVEL
|
|
10
|
-
|
|
10
|
+
# LOG_LEVEL: debug | info | warn | error | auto (auto derives the level from NODE_ENV)
|
|
11
|
+
LOG_LEVEL="auto"
|
|
12
|
+
# LOG_TIME: true | false
|
|
13
|
+
LOG_TIME="false"
|
|
11
14
|
|
|
12
15
|
#############################
|
|
13
16
|
#### Project - Variables ####
|
|
@@ -130,6 +130,12 @@ __pycache__/
|
|
|
130
130
|
.roo/
|
|
131
131
|
.windsurf/
|
|
132
132
|
|
|
133
|
+
###############################
|
|
134
|
+
#### Tooling - Claude Code ####
|
|
135
|
+
###############################
|
|
136
|
+
docs/superpowers/
|
|
137
|
+
.worktrees/
|
|
138
|
+
|
|
133
139
|
##########################
|
|
134
140
|
#### Tooling - Gradle ####
|
|
135
141
|
##########################
|
|
@@ -9,12 +9,12 @@
|
|
|
9
9
|
"start": "node build/index.js"
|
|
10
10
|
},
|
|
11
11
|
"dependencies": {
|
|
12
|
-
"express": "
|
|
12
|
+
"express": "5.1.0"
|
|
13
13
|
},
|
|
14
14
|
"devDependencies": {
|
|
15
|
-
"@types/express": "
|
|
16
|
-
"@types/node": "
|
|
17
|
-
"tsx": "
|
|
18
|
-
"typescript": "
|
|
15
|
+
"@types/express": "5.0.2",
|
|
16
|
+
"@types/node": "22.15.17",
|
|
17
|
+
"tsx": "4.19.4",
|
|
18
|
+
"typescript": "5.8.3"
|
|
19
19
|
}
|
|
20
20
|
}
|
|
@@ -9,14 +9,14 @@
|
|
|
9
9
|
"lint": "next lint"
|
|
10
10
|
},
|
|
11
11
|
"dependencies": {
|
|
12
|
-
"next": "
|
|
13
|
-
"react": "
|
|
14
|
-
"react-dom": "
|
|
12
|
+
"next": "15.3.2",
|
|
13
|
+
"react": "19.1.0",
|
|
14
|
+
"react-dom": "19.1.0"
|
|
15
15
|
},
|
|
16
16
|
"devDependencies": {
|
|
17
|
-
"@types/node": "
|
|
18
|
-
"@types/react": "
|
|
19
|
-
"@types/react-dom": "
|
|
20
|
-
"typescript": "
|
|
17
|
+
"@types/node": "22.15.17",
|
|
18
|
+
"@types/react": "19.1.3",
|
|
19
|
+
"@types/react-dom": "19.1.3",
|
|
20
|
+
"typescript": "5.8.3"
|
|
21
21
|
}
|
|
22
22
|
}
|
|
@@ -5,16 +5,20 @@
|
|
|
5
5
|
"scripts": {
|
|
6
6
|
"start": "docusaurus start --port 3000",
|
|
7
7
|
"build": "docusaurus build",
|
|
8
|
-
"serve": "docusaurus serve --port 3000"
|
|
8
|
+
"serve": "docusaurus serve --port 3000",
|
|
9
|
+
"test": "vitest run"
|
|
9
10
|
},
|
|
10
11
|
"dependencies": {
|
|
11
|
-
"@cbnventures/docusaurus-preset-nova": "
|
|
12
|
-
"@docusaurus/core": "
|
|
13
|
-
"react": "
|
|
14
|
-
"react-dom": "
|
|
12
|
+
"@cbnventures/docusaurus-preset-nova": "0.20.0",
|
|
13
|
+
"@docusaurus/core": "3.7.0",
|
|
14
|
+
"react": "19.1.0",
|
|
15
|
+
"react-dom": "19.1.0"
|
|
15
16
|
},
|
|
16
17
|
"devDependencies": {
|
|
17
|
-
"@
|
|
18
|
-
"
|
|
18
|
+
"@cbnventures/nova": "0.20.0",
|
|
19
|
+
"@docusaurus/types": "3.7.0",
|
|
20
|
+
"glob": "13.0.6",
|
|
21
|
+
"typescript": "5.8.3",
|
|
22
|
+
"vitest": "4.1.3"
|
|
19
23
|
}
|
|
20
24
|
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { registerFrontmatterSuite } from '@cbnventures/nova/rules/vitest';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Tests - Frontmatter.
|
|
5
|
+
*
|
|
6
|
+
* This site self-checks its docs frontmatter THROUGH the published kit. The
|
|
7
|
+
* suite logic lives in @cbnventures/nova/rules/vitest; this wrapper supplies
|
|
8
|
+
* the configuration that reproduces this site's conventions.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.20.0
|
|
11
|
+
*/
|
|
12
|
+
registerFrontmatterSuite({
|
|
13
|
+
enable: 'all',
|
|
14
|
+
requiredFields: [
|
|
15
|
+
'id',
|
|
16
|
+
'title',
|
|
17
|
+
'description',
|
|
18
|
+
'keywords',
|
|
19
|
+
'tags',
|
|
20
|
+
],
|
|
21
|
+
});
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { registerLinkSuite } from '@cbnventures/nova/rules/vitest';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Tests - Link.
|
|
5
|
+
*
|
|
6
|
+
* This site self-checks its internal links THROUGH the published kit. The
|
|
7
|
+
* suite logic lives in @cbnventures/nova/rules/vitest; this wrapper supplies
|
|
8
|
+
* the configuration that reproduces this site's conventions.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.20.0
|
|
11
|
+
*/
|
|
12
|
+
registerLinkSuite({
|
|
13
|
+
enable: 'all',
|
|
14
|
+
});
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { registerMarkdownTableSuite } from '@cbnventures/nova/rules/vitest';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Tests - Markdown Table.
|
|
5
|
+
*
|
|
6
|
+
* This site self-checks its documentation tables THROUGH the published kit. The
|
|
7
|
+
* suite logic lives in @cbnventures/nova/rules/vitest; this wrapper supplies
|
|
8
|
+
* the configuration that reproduces this site's conventions.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.20.0
|
|
11
|
+
*/
|
|
12
|
+
registerMarkdownTableSuite({
|
|
13
|
+
enable: 'all',
|
|
14
|
+
});
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { registerTerminologySuite } from '@cbnventures/nova/rules/vitest';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Tests - Terminology.
|
|
5
|
+
*
|
|
6
|
+
* This site self-checks its Terminology components THROUGH the published kit.
|
|
7
|
+
* The suite logic lives in @cbnventures/nova/rules/vitest; this wrapper
|
|
8
|
+
* supplies the configuration that reproduces this site's conventions.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.20.0
|
|
11
|
+
*/
|
|
12
|
+
registerTerminologySuite({
|
|
13
|
+
enable: 'all',
|
|
14
|
+
});
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { defineConfig } from 'vitest/config';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Vitest Configuration.
|
|
5
|
+
*
|
|
6
|
+
* Runs the documentation conformance suites from @cbnventures/nova/rules/vitest
|
|
7
|
+
* against this site. The suites scan from the project root (process.cwd()), so
|
|
8
|
+
* vitest must run from this workspace directory.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.20.0
|
|
11
|
+
*/
|
|
12
|
+
export default defineConfig({
|
|
13
|
+
test: {
|
|
14
|
+
setupFiles: ['./vitest.setup.ts'],
|
|
15
|
+
include: ['src/tests/**/*.test.ts'],
|
|
16
|
+
globals: false,
|
|
17
|
+
testTimeout: 30000, // 30 seconds.
|
|
18
|
+
sequence: {
|
|
19
|
+
concurrent: false,
|
|
20
|
+
},
|
|
21
|
+
},
|
|
22
|
+
});
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { afterEach, beforeEach, vi } from 'vitest';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Vitest Setup.
|
|
5
|
+
*
|
|
6
|
+
* Global test hooks that run before and after every test. Suppresses
|
|
7
|
+
* conformance-suite output by spying on stdout and stderr, and resets the
|
|
8
|
+
* process exit code so each test starts with a clean slate.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.20.0
|
|
11
|
+
*/
|
|
12
|
+
beforeEach(() => {
|
|
13
|
+
vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
|
|
14
|
+
|
|
15
|
+
vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
|
|
16
|
+
|
|
17
|
+
process.exitCode = undefined;
|
|
18
|
+
|
|
19
|
+
return;
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
afterEach(() => {
|
|
23
|
+
vi.restoreAllMocks();
|
|
24
|
+
|
|
25
|
+
return;
|
|
26
|
+
});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cbnventures/nova",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.20.0",
|
|
4
4
|
"description": "Scripts, templates, and project configuration for the common JavaScript and TypeScript developer",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"eslint",
|
|
@@ -49,6 +49,8 @@
|
|
|
49
49
|
"exports": {
|
|
50
50
|
"./rules/eslint": "./build/src/rules/eslint/index.js",
|
|
51
51
|
"./rules/eslint/*": "./build/src/rules/eslint/*.js",
|
|
52
|
+
"./rules/vitest": "./build/src/rules/vitest/index.js",
|
|
53
|
+
"./rules/vitest/*": "./build/src/rules/vitest/*.js",
|
|
52
54
|
"./presets/eslint": "./build/src/presets/eslint/index.js",
|
|
53
55
|
"./presets/eslint/*": "./build/src/presets/eslint/*.js",
|
|
54
56
|
"./presets/tsconfig/dx-essentials.json": "./build/src/presets/tsconfig/dx-essentials.json",
|
|
@@ -110,6 +112,7 @@
|
|
|
110
112
|
"eslint-plugin-n": "17.24.0",
|
|
111
113
|
"eslint-plugin-react": "7.37.5",
|
|
112
114
|
"eslint-plugin-react-hooks": "7.0.1",
|
|
115
|
+
"glob": "13.0.6",
|
|
113
116
|
"globals": "17.4.0",
|
|
114
117
|
"prompts": "2.4.2",
|
|
115
118
|
"typescript-eslint": "8.58.1",
|
|
@@ -124,14 +127,14 @@
|
|
|
124
127
|
"@typescript-eslint/rule-tester": "8.58.1",
|
|
125
128
|
"eslint": "9.39.3",
|
|
126
129
|
"eslint-import-resolver-typescript": "4.4.4",
|
|
127
|
-
"glob": "13.0.6",
|
|
128
130
|
"shx": "0.4.0",
|
|
129
131
|
"typescript": "5.9.3",
|
|
130
132
|
"vitest": "4.1.3"
|
|
131
133
|
},
|
|
132
134
|
"peerDependencies": {
|
|
133
135
|
"eslint": "^9",
|
|
134
|
-
"typescript": "^5"
|
|
136
|
+
"typescript": "^5",
|
|
137
|
+
"vitest": "4.1.3"
|
|
135
138
|
},
|
|
136
139
|
"peerDependenciesMeta": {
|
|
137
140
|
"eslint": {
|