@cbnventures/nova 0.16.2 → 0.17.0

package/build/src/types/lib/utility.d.ts

@@ -11,6 +11,42 @@ import type {
   SharedWorkspaceManifestFileContents,
 } from '../shared.d.ts';
 
+/**
+ * Lib - Utility - Build Generated File Header.
+ *
+ * @since 0.16.3
+ */
+export type LibUtilityBuildGeneratedFileHeaderOptionsCommand = string;
+
+export type LibUtilityBuildGeneratedFileHeaderOptionsDocsSlug = string;
+
+export type LibUtilityBuildGeneratedFileHeaderOptionsTargetPath = string;
+
+export type LibUtilityBuildGeneratedFileHeaderOptionsMode = 'strict' | 'fillable';
+
+export type LibUtilityBuildGeneratedFileHeaderOptions = {
+  command: LibUtilityBuildGeneratedFileHeaderOptionsCommand;
+  docsSlug: LibUtilityBuildGeneratedFileHeaderOptionsDocsSlug;
+  targetPath: LibUtilityBuildGeneratedFileHeaderOptionsTargetPath;
+  mode: LibUtilityBuildGeneratedFileHeaderOptionsMode;
+};
+
+export type LibUtilityBuildGeneratedFileHeaderReturns = string;
+
+export type LibUtilityBuildGeneratedFileHeaderBaseName = string;
+
+export type LibUtilityBuildGeneratedFileHeaderExtension = string;
+
+export type LibUtilityBuildGeneratedFileHeaderDocsUrl = string;
+
+export type LibUtilityBuildGeneratedFileHeaderRuleLine = string;
+
+export type LibUtilityBuildGeneratedFileHeaderIsHashStyle = boolean;
+
+export type LibUtilityBuildGeneratedFileHeaderIsMarkdownStyle = boolean;
+
+export type LibUtilityBuildGeneratedFileHeaderLines = string[];
+
 /**
  * Lib - Utility - Current Timestamp.
  *
@@ -462,6 +498,18 @@ export type LibUtilitySaveGeneratedFileContents = string;
 
 export type LibUtilitySaveGeneratedFileReplaceFile = boolean;
 
+export type LibUtilitySaveGeneratedFileHeaderCommand = string;
+
+export type LibUtilitySaveGeneratedFileHeaderDocsSlug = string;
+
+export type LibUtilitySaveGeneratedFileHeaderMode = 'strict' | 'fillable';
+
+export type LibUtilitySaveGeneratedFileHeader = {
+  command: LibUtilitySaveGeneratedFileHeaderCommand;
+  docsSlug: LibUtilitySaveGeneratedFileHeaderDocsSlug;
+  mode: LibUtilitySaveGeneratedFileHeaderMode;
+};
+
 export type LibUtilitySaveGeneratedFileReturns = Promise<void>;
 
 export type LibUtilitySaveGeneratedFileParentDirectory = string;
@@ -470,6 +518,10 @@ export type LibUtilitySaveGeneratedFileCurrentDirectory = string;
 
 export type LibUtilitySaveGeneratedFileDisplayName = string;
 
+export type LibUtilitySaveGeneratedFilePrefixedContents = string | undefined;
+
+export type LibUtilitySaveGeneratedFileHeaderBanner = string;
+
 /**
  * Lib - Utility - Save Workspace Manifest.
  *

package/build/src/types/tests/cli/generate/github/funding.test.d.ts

@@ -3,24 +3,14 @@
  *
  * @since 0.15.0
  */
-export type TestsCliGenerateGithubFundingRunOriginalCwd = string;
+export type TestsCliGenerateGithubFundingRunIsProjectRootSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateGithubFundingRunTemporaryDirectory = string;
+export type TestsCliGenerateGithubFundingRunLoadSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateGithubFundingRunTemporaryPrefix = string;
+export type TestsCliGenerateGithubFundingRunSaveSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateGithubFundingRunSandboxRoot = string;
+export type TestsCliGenerateGithubFundingRunSaveCalls = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined][];
 
-export type TestsCliGenerateGithubFundingRunProjectDirectory = string;
+export type TestsCliGenerateGithubFundingRunTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
 
-export type TestsCliGenerateGithubFundingRunPackageJson = string;
-
-export type TestsCliGenerateGithubFundingRunPackageJsonPath = string;
-
-export type TestsCliGenerateGithubFundingRunNovaConfig = string;
-
-export type TestsCliGenerateGithubFundingRunNovaConfigPath = string;
-
-export type TestsCliGenerateGithubFundingRunExists = boolean;
-
-export type TestsCliGenerateGithubFundingRunFundingYmlPath = string;
+export type TestsCliGenerateGithubFundingRunHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;

package/build/src/types/tests/cli/generate/github/issue-template.test.d.ts

@@ -3,12 +3,14 @@
  *
  * @since 0.15.0
  */
-export type TestsCliGenerateGithubIssueTemplateRunOriginalCwd = string;
+export type TestsCliGenerateGithubIssueTemplateRunIsProjectRootSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateGithubIssueTemplateRunTemporaryDirectory = string;
+export type TestsCliGenerateGithubIssueTemplateRunLoadSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateGithubIssueTemplateRunTemporaryPrefix = string;
+export type TestsCliGenerateGithubIssueTemplateRunSaveSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateGithubIssueTemplateRunSandboxRoot = string;
+export type TestsCliGenerateGithubIssueTemplateRunSaveCalls = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined][];
 
-export type TestsCliGenerateGithubIssueTemplateRunProjectDirectory = string;
+export type TestsCliGenerateGithubIssueTemplateRunTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
+
+export type TestsCliGenerateGithubIssueTemplateRunHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;

package/build/src/types/tests/cli/generate/github/workflows-helpers.test.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Tests - CLI - Generate - GitHub - Workflows Helpers - Build Artifact Name.
+ *
+ * @since 0.16.3
+ */
+export type TestsCliGenerateGithubWorkflowsHelpersBuildArtifactNameResult = string;
+
 /**
  * Tests - CLI - Generate - GitHub - Workflows Helpers - Build Command.
  *
@@ -21,19 +28,34 @@ export type TestsCliGenerateGithubWorkflowsHelpersDetectTurboTurboConfigPath = s
 export type TestsCliGenerateGithubWorkflowsHelpersDetectTurboResult = boolean;
 
 /**
- * Tests - CLI - Generate - GitHub - Workflows Helpers - Render Artifact Paths.
+ * Tests - CLI - Generate - GitHub - Workflows Helpers - Render Upload Artifact Steps.
  *
- * @since 0.16.0
+ * @since 0.16.3
  */
-export type TestsCliGenerateGithubWorkflowsHelpersRenderArtifactPathsTargetMetadata = Record<string, {
-  artifactPaths: string[];
-}>;
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetMetadataEntryArtifactPath = string;
 
-export type TestsCliGenerateGithubWorkflowsHelpersRenderArtifactPathsTargets = Array<{
-  type: string; workingDir: string;
-}>;
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetMetadataEntryArtifactPaths = TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetMetadataEntryArtifactPath[];
+
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetMetadataEntry = {
+  artifactPaths: TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetMetadataEntryArtifactPaths;
+};
+
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetMetadata = Record<string, TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetMetadataEntry>;
+
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetType = string;
+
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetWorkingDir = string;
+
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTarget = {
+  type: TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetType;
+  workingDir: TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargetWorkingDir;
+};
+
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTargets = TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsTarget[];
+
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsResult = string;
 
-export type TestsCliGenerateGithubWorkflowsHelpersRenderArtifactPathsResult = string;
+export type TestsCliGenerateGithubWorkflowsHelpersRenderUploadArtifactStepsExpected = string;
 
 /**
  * Tests - CLI - Generate - GitHub - Workflows Helpers - Resolve Workspace Name.

package/build/src/types/tests/cli/generate/github/workflows.test.d.ts

@@ -58,3 +58,15 @@ export type TestsCliGenerateGithubWorkflowsBuildEntrySetupLinesSetupLines = stri
 export type TestsCliGenerateGithubWorkflowsBuildEntrySetupLinesStripAnsiPattern = RegExp;
 
 export type TestsCliGenerateGithubWorkflowsBuildEntrySetupLinesJoined = string;
+
+export type TestsCliGenerateGithubWorkflowsRunIsProjectRootSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
+
+export type TestsCliGenerateGithubWorkflowsRunLoadSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
+
+export type TestsCliGenerateGithubWorkflowsRunSaveSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
+
+export type TestsCliGenerateGithubWorkflowsRunSaveCalls = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined][];
+
+export type TestsCliGenerateGithubWorkflowsRunTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
+
+export type TestsCliGenerateGithubWorkflowsRunHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;

package/build/src/types/tests/cli/generate/must-haves/dotenv.test.d.ts

@@ -3,12 +3,16 @@
  *
  * @since 0.15.0
  */
-export type TestsCliGenerateMustHavesDotenvRunOriginalCwd = string;
+export type TestsCliGenerateMustHavesDotenvRunIsProjectRootSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateMustHavesDotenvRunTemporaryDirectory = string;
+export type TestsCliGenerateMustHavesDotenvRunSaveSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateMustHavesDotenvRunTemporaryPrefix = string;
+export type TestsCliGenerateMustHavesDotenvRunSaveCalls = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined][];
 
-export type TestsCliGenerateMustHavesDotenvRunSandboxRoot = string;
+export type TestsCliGenerateMustHavesDotenvRunEnvTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
 
-export type TestsCliGenerateMustHavesDotenvRunProjectDirectory = string;
+export type TestsCliGenerateMustHavesDotenvRunEnvHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;
+
+export type TestsCliGenerateMustHavesDotenvRunSampleTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
+
+export type TestsCliGenerateMustHavesDotenvRunSampleHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;

package/build/src/types/tests/cli/generate/must-haves/editorconfig.test.d.ts

@@ -3,20 +3,12 @@
  *
  * @since 0.15.0
  */
-export type TestsCliGenerateMustHavesEditorconfigRunOriginalCwd = string;
+export type TestsCliGenerateMustHavesEditorconfigRunIsProjectRootSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateMustHavesEditorconfigRunTemporaryDirectory = string;
+export type TestsCliGenerateMustHavesEditorconfigRunSaveSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateMustHavesEditorconfigRunTemporaryPrefix = string;
+export type TestsCliGenerateMustHavesEditorconfigRunSaveCalls = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined][];
 
-export type TestsCliGenerateMustHavesEditorconfigRunSandboxRoot = string;
+export type TestsCliGenerateMustHavesEditorconfigRunTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
 
-export type TestsCliGenerateMustHavesEditorconfigRunProjectDirectory = string;
-
-export type TestsCliGenerateMustHavesEditorconfigRunPackageJson = string;
-
-export type TestsCliGenerateMustHavesEditorconfigRunPackageJsonPath = string;
-
-export type TestsCliGenerateMustHavesEditorconfigRunExists = boolean;
-
-export type TestsCliGenerateMustHavesEditorconfigRunEditorconfigPath = string;
+export type TestsCliGenerateMustHavesEditorconfigRunHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;

package/build/src/types/tests/cli/generate/must-haves/gitignore.test.d.ts

@@ -3,12 +3,12 @@
  *
  * @since 0.15.0
  */
-export type TestsCliGenerateMustHavesGitignoreRunOriginalCwd = string;
+export type TestsCliGenerateMustHavesGitignoreRunIsProjectRootSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateMustHavesGitignoreRunTemporaryDirectory = string;
+export type TestsCliGenerateMustHavesGitignoreRunSaveSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
 
-export type TestsCliGenerateMustHavesGitignoreRunTemporaryPrefix = string;
+export type TestsCliGenerateMustHavesGitignoreRunSaveCalls = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined][];
 
-export type TestsCliGenerateMustHavesGitignoreRunSandboxRoot = string;
+export type TestsCliGenerateMustHavesGitignoreRunTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
 
-export type TestsCliGenerateMustHavesGitignoreRunProjectDirectory = string;
+export type TestsCliGenerateMustHavesGitignoreRunHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;

package/build/src/types/tests/cli/generate/must-haves/license.test.d.ts

@@ -24,3 +24,5 @@ export type TestsCliGenerateMustHavesLicenseRunNovaConfigPath = string;
 export type TestsCliGenerateMustHavesLicenseRunExists = boolean;
 
 export type TestsCliGenerateMustHavesLicenseRunLicensePath = string;
+
+export type TestsCliGenerateMustHavesLicenseRunResult = 'cancelled' | 'completed';

package/build/src/types/tests/cli/generate/must-haves/read-me.test.d.ts

@@ -11,6 +11,18 @@ export type TestsCliGenerateMustHavesReadMeRunTemporaryPrefix = string;
 
 export type TestsCliGenerateMustHavesReadMeRunSandboxRoot = string;
 
+export type TestsCliGenerateMustHavesReadMeRunIsProjectRootSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
+
+export type TestsCliGenerateMustHavesReadMeRunLoadSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
+
+export type TestsCliGenerateMustHavesReadMeRunSaveSpy = ReturnType<typeof import('vitest')['vi']['spyOn']>;
+
+export type TestsCliGenerateMustHavesReadMeRunSaveCalls = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined][];
+
+export type TestsCliGenerateMustHavesReadMeRunTargetCall = [string, string, boolean, import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined] | undefined;
+
+export type TestsCliGenerateMustHavesReadMeRunHeaderArg = import('../../../../lib/utility.d.ts').LibUtilitySaveGeneratedFileHeader | undefined;
+
 export type TestsCliGenerateMustHavesReadMeRunProjectDirectory = string;
 
 export type TestsCliGenerateMustHavesReadMeRunPackageJson = string;
@@ -21,8 +33,6 @@ export type TestsCliGenerateMustHavesReadMeRunNovaConfig = string;
 
 export type TestsCliGenerateMustHavesReadMeRunNovaConfigPath = string;
 
-export type TestsCliGenerateMustHavesReadMeRunExists = boolean;
-
 export type TestsCliGenerateMustHavesReadMeRunReadmePath = string;
 
 export type TestsCliGenerateMustHavesReadMeRunReadmeContent = string;

package/build/src/types/tests/lib/utility.test.d.ts

@@ -8,6 +8,15 @@ import type {
   SharedWorkspaceManifest,
 } from '../../shared.d.ts';
 
+/**
+ * Tests - Lib - Utility - Build Generated File Header.
+ *
+ * @since 0.16.3
+ */
+export type TestsLibUtilityBuildGeneratedFileHeaderResult = string;
+
+export type TestsLibUtilityBuildGeneratedFileHeaderThrew = boolean;
+
 /**
  * Tests - Lib - Utility - Current Timestamp.
  *
@@ -284,6 +293,39 @@ export type TestsLibUtilityRenameFileWithDateExistingFilePath = string;
 
 export type TestsLibUtilityRenameFileWithDateSecondFile = string | undefined;
 
+/**
+ * Tests - Lib - Utility - SaveGeneratedFile (with Header).
+ *
+ * @since 0.16.3
+ */
+export type TestsLibUtilitySaveGeneratedFileWithHeaderOriginalCwd = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderSandboxRoot = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderProjectDirectory = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderTargetPath = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderWritten = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderExpectedHeader = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderHeaderOptionsCommand = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderHeaderOptionsDocsSlug = string;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderHeaderOptionsMode = 'strict' | 'fillable';
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderHeaderOptions = {
+  command: TestsLibUtilitySaveGeneratedFileWithHeaderHeaderOptionsCommand;
+  docsSlug: TestsLibUtilitySaveGeneratedFileWithHeaderHeaderOptionsDocsSlug;
+  mode: TestsLibUtilitySaveGeneratedFileWithHeaderHeaderOptionsMode;
+};
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderFirstWrite = Stats;
+
+export type TestsLibUtilitySaveGeneratedFileWithHeaderSecondWrite = Stats;
+
 /**
  * Tests - Lib - Utility - Save Workspace Manifest.
  *

package/build/templates/generators/github/workflows/publish/targets/aws-amplify-nextjs.yml

@@ -12,7 +12,7 @@ publish-aws-amplify-nextjs-[__TARGET_ID__]:
     - name: "Download build artifacts"
       uses: "actions/download-artifact@v4"
       with:
-        name: "build-output"
+        name: "[__ARTIFACT_NAME__]"
 
     - name: "Configure AWS credentials"
       if: "${{ env.PUBLISH == 'true' }}"

package/build/templates/generators/github/workflows/publish/targets/cloudflare-pages-docusaurus.yml

@@ -12,7 +12,7 @@ publish-cloudflare-pages-docusaurus-[__TARGET_ID__]:
     - name: "Download build artifacts"
       uses: "actions/download-artifact@v4"
       with:
-        name: "build-output"
+        name: "[__ARTIFACT_NAME__]"
         path: "[__WORKING_DIR__]/build"
 
     - name: "Deploy to Cloudflare Pages"

package/build/templates/generators/github/workflows/publish/targets/github-packages.yml

@@ -36,7 +36,8 @@ publish-github-packages-[__TARGET_ID__]:
     - name: "Download build artifacts"
       uses: "actions/download-artifact@v4"
       with:
-        name: "build-output"
+        name: "[__ARTIFACT_NAME__]"
+        path: "[__WORKING_DIR__]/build"
 
     - name: "Change to scoped package name"
       run: |

package/build/templates/generators/github/workflows/publish/targets/github-pages-docusaurus.yml

@@ -14,7 +14,7 @@ publish-github-pages-docusaurus-[__TARGET_ID__]:
     - name: "Download build artifacts"
       uses: "actions/download-artifact@v4"
       with:
-        name: "build-output"
+        name: "[__ARTIFACT_NAME__]"
         path: "[__WORKING_DIR__]/build"
 
     - name: "Check GitHub Pages status"

package/build/templates/generators/github/workflows/publish/targets/npm.yml

@@ -28,7 +28,8 @@ publish-npm-[__TARGET_ID__]:
     - name: "Download build artifacts"
       uses: "actions/download-artifact@v4"
       with:
-        name: "build-output"
+        name: "[__ARTIFACT_NAME__]"
+        path: "[__WORKING_DIR__]/build"
 
     - name: "Configure authentication"
       env:

package/build/templates/generators/github/workflows/publish/targets/vercel-nextjs.yml

@@ -18,7 +18,7 @@ publish-vercel-nextjs-[__TARGET_ID__]:
     - name: "Download build artifacts"
       uses: "actions/download-artifact@v4"
       with:
-        name: "build-output"
+        name: "[__ARTIFACT_NAME__]"
 
     - name: "Install Vercel CLI"
       if: "${{ env.PUBLISH == 'true' }}"

package/build/templates/generators/must-haves/agent-conventions/cursorrules

@@ -0,0 +1,54 @@
+# .cursorrules
+
+Read and follow the conventions and rules defined in the files below.
+
+## Vision and Purpose
+
+- [VISION.md](VISION.md) — Purpose, marketing copy, and glossary.
+
+## Project Rules
+
+- [PROJECT_RULES.md](PROJECT_RULES.md) — Project identity, repository layout, source structure, key files, build tooling, workspace rules, project-specific patterns, documentation site, and publishing/deployment.
+
+## Coding Conventions
+
+### Universal
+
+- [conventions/universal.md](conventions/universal.md) — Workflow, general code style, documentation style, platform build rules, and release notes format.
+
+### Per Language
+
+- [conventions/typescript.md](conventions/typescript.md) — TypeScript / JavaScript conventions (type system, imports, class structure, code style, TSConfig).
+- [conventions/swift.md](conventions/swift.md) — Swift conventions (documentation style, code style).
+- [conventions/java.md](conventions/java.md) — Java conventions (documentation style, code style).
+- [conventions/kotlin.md](conventions/kotlin.md) — Kotlin conventions (documentation style, code style).
+- [conventions/csharp.md](conventions/csharp.md) — C# conventions (documentation style, code style).
+- [conventions/php.md](conventions/php.md) — PHP conventions (documentation style, code style).
+- [conventions/python.md](conventions/python.md) — Python conventions (documentation style, code style).
+- [conventions/css.md](conventions/css.md) — CSS conventions (documentation style, code style).
+- [conventions/docker.md](conventions/docker.md) — Docker conventions (documentation style, code style).
+- [conventions/shell.md](conventions/shell.md) — Shell conventions (documentation style, code style).
+
+## Agent Directives
+
+- **Plan before acting.** For non-trivial changes that span multiple files, outline the planned modifications and wait for approval before proceeding. The cost of pausing to align is low; the cost of unwanted changes across a codebase is high.
+- **Match the scope of changes to what was requested.** Do not add features, refactor surrounding code, introduce documentation, or make improvements beyond the immediate task. If a bug fix is requested, fix the bug — do not clean up neighboring code.
+- **Read before writing.** Always read existing code before suggesting modifications. Understand the patterns, conventions, and intent already present in the file before making changes.
+- **Ask when intent is unclear.** If a request is ambiguous or could be interpreted multiple ways, ask for clarification rather than guessing. A wrong assumption can be more expensive than a short pause.
+- **Verify your work.** After making changes, run the project's build, lint, or test commands to confirm nothing is broken. Do not leave verification to the user unless the commands are unavailable.
+
+## Sensitive Files
+
+These files contain critical project information — architectural decisions, identity, and positioning that are difficult to reconstruct if lost. Edit with care and do not overwrite or remove existing content without explicit instruction.
+
+- `VISION.md`
+- `PROJECT_RULES.md`
+
+## Restricted Files
+
+These files are managed externally and kept in sync across environments. Modifying them locally will cause drift and merge conflicts.
+
+- `.cursorrules`
+- `CLAUDE.md`
+- `AGENTS.md`
+- `conventions/*.md`

package/build/templates/generators/must-haves/dotenv/env

@@ -0,0 +1,14 @@
+############################
+#### Node.js - Settings ####
+############################
+NODE_ENV="development"
+
+#########################
+#### Nova - CLI Logs ####
+#########################
+LOG_LEVEL=""
+LOG_TIME=""
+
+#############################
+#### Project - Variables ####
+#############################

package/build/templates/generators/must-haves/dotenv/env.sample

@@ -0,0 +1,14 @@
+############################
+#### Node.js - Settings ####
+############################
+NODE_ENV=""
+
+#########################
+#### Nova - CLI Logs ####
+#########################
+LOG_LEVEL=""
+LOG_TIME=""
+
+#############################
+#### Project - Variables ####
+#############################