@cbnventures/nova 0.14.0 → 0.15.0

package/build/templates/generators/must-haves/agent-conventions/conventions/universal.md

@@ -0,0 +1,202 @@
+# Universal Coding Conventions
+
+Rules that apply across all programming languages and platforms.
+
+## AI Agent Behavior
+
+### Task Tracking
+
+Every top-level user request must be tracked as a task. Break multi-step requests into discrete sub-tasks. Mark each task as in-progress before starting and completed when done.
+
+**Claude Code:**
+
+| Tool         | Purpose                                                                    |
+|--------------|----------------------------------------------------------------------------|
+| `TaskCreate` | Create a new task with subject, description, and optional spinner text.    |
+| `TaskGet`    | Retrieve a task by ID to check its current state.                          |
+| `TaskList`   | List all tasks to find the next available work.                            |
+| `TaskUpdate` | Update status (`pending` / `in_progress` / `completed`), add dependencies. |
+
+**Codex CLI / Cursor / Other agents:**
+
+If your platform does not provide dedicated task tracking tools, maintain a checklist in your working memory or output. State what you are about to do before starting and confirm completion before moving on.
+
+### Command Output Caching
+
+When a command produces output that may be referenced later, save it to a file in the agent's designated temporary directory. Read from the cached file instead of re-running the command. Do not rely on conversation memory for command output — files survive context compaction.
+
+### Command Transparency
+
+Run commands from explicit, full directory paths so every invocation is unambiguous. Prefix commands with `cd` to the target directory so the working directory is visible in the output.
+
+```bash
+# BAD — ambiguous which workspace
+npm run build
+
+# GOOD — explicit directory
+cd /path/to/packages/nova && npm run build
+```
+
+### Web Browser Debugging
+
+Use the `agent-browser` command for visual testing and web page interaction. Do not use `curl`, `wget`, or other HTTP clients for tasks that require rendering, clicking, or inspecting a page.
+
+Run `agent-browser --help` for available commands.
+
+## Workflow
+
+### Scope
+
+- **Only apply version and changelog rules to user-requested product changes.** Process-only edits, tooling updates, and non-product changes do not trigger version bumps or changelog entries.
+- **Confirm your understanding before making changes.** For each user request, state exactly what you understood and what you plan to do before starting work.
+
+### Per-Change Mechanics
+
+- **Update the changelog with every change.** Add bullet points under the current version section. If the platform uses build numbers, recalculate using the bullet-count formula.
+- **Build after every change.** Run the platform build command and verify success before moving on.
+- **Do not add changelog entries for version bumps alone** or for incidental implementation fallout unless there is a clear user-visible behavior change.
+
+### Version Lifecycle
+
+- **Keep the version unchanged while working within a release line.** Do not bump the version until the user signals a new release.
+- **Start a new version only when the working tree is clean** — all current changes committed and `git status --short` is empty.
+- **When starting a new version, ask first.** Confirm whether the bump is major, minor, or bugfix (semver). Then create a new changelog section, bump the version, and carry forward the prior build number.
+- **Do not commit a version bump by itself.** Keep version bump changes in the working copy until at least one user-requested change is included. Do not run a build when only starting a new version line.
+
+### Wrapping Up
+
+- **Keep working until the user says "all done."** Continue executing per-change bumps and builds until explicitly told to stop.
+- **On "all done":** consolidate the changelog, recalculate the build number (if applicable), sync the version across all version files, and commit with a version subject line. Do not add co-author credits.
+- **Keep version numbers and CHANGELOG.md synchronized** at all times before commit.
+
+## General Code Style
+
+- Semicolons at statement ends.
+- Commas as separators in arrays, dictionaries, and argument lists (not semicolons).
+- Trailing commas in multiline constructs.
+- Ternary form: `(condition) ? valueA : valueB` — parenthesized condition, single-line.
+- Curly braces required for all control structures (no braceless `if`/`else`/`for`).
+- LF line endings.
+- Final newline required at end of file.
+- No abbreviations in variable names, type names, or any identifiers — spell everything out fully. External API names (e.g., `tmpdir()`) are fine as-is, but the variable storing the result must be spelled out.
+
+### Quotes and Indentation
+
+| Language                | Quotes                           | Indentation |
+|-------------------------|----------------------------------|-------------|
+| TypeScript / JavaScript | Single                           | 2-space     |
+| Swift                   | Double (only option)             | 4-space     |
+| Java                    | Double (only option)             | 4-space     |
+| Kotlin                  | Double (only option)             | 4-space     |
+| C#                      | Double (only option)             | 4-space     |
+| PHP                     | Single (non-interpolated)        | 4-space     |
+| Python                  | Double (Black/Google convention) | 4-space     |
+| CSS                     | N/A                              | 2-space     |
+| Docker                  | Double (for variable expansion)  | 2-space     |
+| Shell                   | Double (for variable expansion)  | 2-space     |
+
+### File Naming
+
+| Language                | Convention                       | Example                                     |
+|-------------------------|----------------------------------|---------------------------------------------|
+| TypeScript / JavaScript | kebab-case                       | `markdown-table.ts`, `cli-header.d.ts`      |
+| Swift                   | PascalCase + role suffix         | `TunnelFormView.swift`, `TunnelModel.swift` |
+| Java                    | PascalCase matching class name   | `EntityRepository.java`                     |
+| Kotlin                  | PascalCase matching class name   | `EntityRepository.kt`                       |
+| C#                      | PascalCase matching class name   | `EntityRepository.cs`                       |
+| PHP                     | PascalCase (PSR-4) or snake_case | `EntityRepository.php`                      |
+| Python                  | snake_case (PEP 8)               | `entity_repository.py`                      |
+| CSS                     | kebab-case                       | `user-profile.css`                          |
+| Docker                  | kebab-case                       | `api-gateway.Dockerfile`                    |
+| Shell                   | kebab-case                       | `backup-config.sh`                          |
+
+## Documentation Style
+
+### General Rules
+
+- Every member documented — public, private, protocol stubs (`var body`). No exceptions.
+- Required body paragraph: every doc comment MUST include a body paragraph after the summary line that explains why the declaration exists, who uses it, or when it matters. Body must be 2–3 lines, max 80 characters per line (not counting the comment prefix). Prefer 2 lines — fill the first line as fully as possible, remainder on line 2. Use 3 lines only when content truly needs it. For 3-line bodies, the second line must be the longest (diamond/belly shape) — keep the 1st and 3rd lines at reasonable length. Structured tags (`- Parameter`, `- Returns`, `- Throws`, `@param`, `@returns`, etc.) go after the body.
+- No file-level comments above imports.
+
+### Summary Line Convention
+
+- Summary line uses the hierarchy chain format: `ClassName - Member Name.`
+- Summary line ends with a period.
+- `var body: some View` is documented as `TypeName - Body.`
+
+### Hierarchy Chain
+
+- Top-level declarations: `ClassName.`
+- Members: `ClassName - MemberName.`
+- Nested types: `OuterClass.InnerClass - MemberName.`
+- Enum cases: `EnumName - CaseName.`
+
+## Platform Build Rules
+
+### Apple (Xcode)
+
+- **Version file:** `project.pbxproj` (`MARKETING_VERSION` + `CURRENT_PROJECT_VERSION`)
+- **Build number:** Yes — equals total count of changelog bullet lines across `CHANGELOG.md`
+- **Build command:** `xcodebuild build` (with project-specific scheme/destination)
+- **Changelog header:** `## X.Y.Z (build) - YYYY-MM-DD`
+
+### TypeScript / JavaScript (Node.js)
+
+- **Version file:** `package.json` `version`
+- **Build number:** No
+- **Build command:** `npm run build`
+- **Changelog header:** `## X.Y.Z - YYYY-MM-DD`
+
+### Android (Gradle)
+
+- **Version file:** `build.gradle` (`versionName` + `versionCode`)
+- **Build number:** Yes — equals total count of changelog bullet lines across `CHANGELOG.md`
+- **Build command:** `./gradlew assembleDebug`
+- **Changelog header:** `## X.Y.Z (build) - YYYY-MM-DD`
+
+### Windows (.NET)
+
+- **Version file:** `.csproj` (`Version`)
+- **Build number:** No
+- **Build command:** `dotnet build`
+- **Changelog header:** `## X.Y.Z - YYYY-MM-DD`
+
+### PHP (Composer)
+
+- **Version file:** `composer.json` `version`
+- **Build number:** No
+- **Build command:** `composer test`
+- **Changelog header:** `## X.Y.Z - YYYY-MM-DD`
+
+### Python (pip / Poetry)
+
+- **Version file:** `pyproject.toml` `version`
+- **Build number:** No
+- **Build command:** `python -m build`
+- **Changelog header:** `## X.Y.Z - YYYY-MM-DD`
+
+### Docker
+
+- **Version file:** `Dockerfile` `ARG VERSION` or none
+- **Build number:** No
+- **Build command:** `docker build .`
+- **Changelog header:** `## X.Y.Z - YYYY-MM-DD`
+
+## Release Notes Format
+
+```markdown
+## 1.2.0 - 2026-01-01
+
+### UPDATED
+- Enhanced the changelog release summary output.
+
+### FIXED
+- Fixed version bump calculation for major releases.
+
+### ADDED
+- Added dry-run mode to the release command.
+```
+
+- Use headings in this order: `### UPDATED`, `### FIXED`, `### ADDED`, `### REMOVED`.
+- Leave out any heading that has no entries.
+- Use only ASCII characters and standard US keyboard quotes.

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 ####
+#############################

package/build/templates/generators/must-haves/editorconfig/.editorconfig

@@ -0,0 +1,212 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+max_line_length = off
+tab_width = 2
+trim_trailing_whitespace = true
+
+[*.xml]
+indent_size = 4
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_xml_space_inside_empty_tag = true
+
+[*.json]
+indent_size = 2
+indent_style = space
+
+[{*.yml,*.yaml}]
+indent_size = 2
+indent_style = space
+
+[Makefile]
+indent_size = tab
+indent_style = tab
+tab_width = 8
+
+[{*.ts,*.mts,*.cts,*.tsx}]
+indent_size = 2
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_html_do_not_indent_children_of_tags = none
+ij_html_space_inside_empty_tag = true
+ij_typescript_brace_style = end_of_line
+ij_typescript_force_control_statements_braces = always_add
+ij_typescript_force_quote_style = true
+ij_typescript_force_semicolon_style = true
+ij_typescript_keep_simple_methods_in_one_line = true
+ij_typescript_method_call_chain_wrap = normal
+ij_typescript_object_literal_wrap = off
+ij_typescript_spaces_within_imports = true
+ij_typescript_spaces_within_object_literal_braces = true
+ij_typescript_use_double_quotes = false
+ij_typescript_use_semicolon_after_statement = true
+ij_typescript_var_declaration_wrap = split_into_lines
+
+# JetBrains - ReSharper
+resharper_js_brace_style = end_of_line
+resharper_js_force_control_statements_braces = always_add
+resharper_js_quote_style = singlequoted
+resharper_js_termination_style = ensure_semicolon
+
+[{*.js,*.mjs,*.cjs,*.jsx}]
+indent_size = 2
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_html_do_not_indent_children_of_tags = none
+ij_html_space_inside_empty_tag = true
+ij_javascript_brace_style = end_of_line
+ij_javascript_force_control_statements_braces = always_add
+ij_javascript_force_quote_style = true
+ij_javascript_force_semicolon_style = true
+ij_javascript_keep_simple_methods_in_one_line = true
+ij_javascript_method_call_chain_wrap = normal
+ij_javascript_object_literal_wrap = off
+ij_javascript_spaces_within_imports = true
+ij_javascript_spaces_within_object_literal_braces = true
+ij_javascript_use_double_quotes = false
+ij_javascript_use_semicolon_after_statement = true
+ij_javascript_var_declaration_wrap = split_into_lines
+
+# JetBrains - ReSharper
+resharper_js_brace_style = end_of_line
+resharper_js_force_control_statements_braces = always_add
+resharper_js_quote_style = singlequoted
+resharper_js_termination_style = ensure_semicolon
+
+[*.ets]
+indent_size = 2
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_html_do_not_indent_children_of_tags = none
+ij_html_space_inside_empty_tag = true
+ij_typescript_brace_style = end_of_line
+ij_typescript_force_control_statements_braces = always_add
+ij_typescript_force_quote_style = true
+ij_typescript_force_semicolon_style = true
+ij_typescript_keep_simple_methods_in_one_line = true
+ij_typescript_method_call_chain_wrap = normal
+ij_typescript_object_literal_wrap = off
+ij_typescript_spaces_within_imports = true
+ij_typescript_spaces_within_object_literal_braces = true
+ij_typescript_use_double_quotes = false
+ij_typescript_use_semicolon_after_statement = true
+ij_typescript_var_declaration_wrap = split_into_lines
+
+[{*.ejs,*.html}]
+indent_size = 4
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_html_attribute_wrap = off
+ij_html_do_not_indent_children_of_tags = none
+ij_html_space_inside_empty_tag = true
+ij_html_text_wrap = off
+
+[*.php]
+indent_size = 4
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_php_block_brace_style = end_of_line
+ij_php_class_brace_style = end_of_line
+ij_php_comma_after_last_array_element = true
+ij_php_do_while_brace_force = always
+ij_php_for_brace_force = always
+ij_php_if_brace_force = always
+ij_php_indent_code_in_php_tags = true
+ij_php_method_brace_style = end_of_line
+ij_php_new_line_after_php_opening_tag = true
+ij_php_while_brace_force = always
+
+[{*.markdown,*.md}]
+indent_size = 2
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_markdown_max_lines_around_block_elements = 0
+ij_markdown_max_lines_around_header = 0
+
+[*.py]
+indent_size = 4
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_python_blank_lines_around_top_level_classes_functions = 2
+ij_python_from_import_trailing_comma_if_multiline = true
+ij_python_optimize_imports_sort_imports = true
+
+[*.swift]
+indent_size = 4
+indent_style = space
+
+[*.java]
+indent_size = 4
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_java_block_brace_style = end_of_line
+ij_java_class_brace_style = end_of_line
+ij_java_class_count_to_use_import_on_demand = 999
+ij_java_do_while_brace_force = always
+ij_java_for_brace_force = always
+ij_java_if_brace_force = always
+ij_java_imports_layout = $*, |, *
+ij_java_lambda_brace_style = end_of_line
+ij_java_layout_static_imports_separately = true
+ij_java_method_brace_style = end_of_line
+ij_java_names_count_to_use_import_on_demand = 999
+ij_java_use_single_class_imports = true
+ij_java_while_brace_force = always
+
+[{*.kt,*.kts}]
+indent_size = 4
+indent_style = space
+
+# JetBrains - IntelliJ
+ij_kotlin_allow_trailing_comma = true
+ij_kotlin_allow_trailing_comma_on_call_site = true
+ij_kotlin_catch_on_new_line = false
+ij_kotlin_code_style_defaults = KOTLIN_OFFICIAL
+ij_kotlin_else_on_new_line = false
+ij_kotlin_finally_on_new_line = false
+ij_kotlin_imports_layout = *
+ij_kotlin_name_count_to_use_star_import = 9999
+ij_kotlin_name_count_to_use_star_import_for_members = 9999
+
+[*.cs]
+indent_size = 4
+indent_style = space
+
+# JetBrains - ReSharper
+resharper_csharp_brace_style = end_of_line
+resharper_csharp_braces_for_dowhile = required
+resharper_csharp_braces_for_for = required
+resharper_csharp_braces_for_foreach = required
+resharper_csharp_braces_for_ifelse = required
+resharper_csharp_braces_for_lock = required
+resharper_csharp_braces_for_using = required
+resharper_csharp_braces_for_while = required
+resharper_csharp_trailing_comma_in_multiline_lists = true
+resharper_csharp_trailing_comma_in_singleline_lists = false
+
+# Microsoft - Visual Studio
+csharp_new_line_before_catch = false
+csharp_new_line_before_else = false
+csharp_new_line_before_finally = false
+csharp_new_line_before_open_brace = none
+csharp_prefer_braces = true
+csharp_preserve_single_line_blocks = true
+csharp_preserve_single_line_statements = false
+csharp_using_directive_placement = outside_namespace
+dotnet_separate_import_directive_groups = true
+dotnet_sort_system_directives_first = true