@cbnventures/nova 0.16.2 → 0.18.0

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

@@ -25,6 +25,12 @@ If your platform does not provide dedicated task tracking tools, maintain a chec
 
 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.
 
+### File Writes
+
+Use your platform's dedicated file-editing tool to create or modify files. In Claude Code, that is `Write` or `Edit`; in Codex CLI, `apply_patch`; other agents have equivalents. Do not write files through shell redirection (`cat > file`, `echo >>`, `tee`, heredocs), in-place editors (`sed -i`, `awk -i`), inline scripts (`node -e`, `python -c`, PowerShell `Set-Content`), or any other script- or batch-file-driven write. Shell-driven writes routinely produce malformed output — quoting errors, encoding mismatches, missing newlines, partial writes — that then has to be repaired by hand.
+
+Reading files via the shell (`cat`, `head`, `tail`, `grep`, `rg`) is fine. The restriction applies only to writes.
+
 ### 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.
@@ -39,9 +45,27 @@ 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.
+For visual testing and web page interaction, prefer the Claude-in-Chrome MCP tools (`mcp__claude-in-chrome__*` — `tabs_*`, `navigate`, `javascript_tool`, `read_page`, `read_console_messages`, etc.) when available. They drive the user's real Chrome session and provide richer page inspection.
+
+If the Claude-in-Chrome MCP is not available, fall back to Vercel's `agent-browser` command for headless rendering and interaction. Run `agent-browser --help` for available commands.
+
+Do not use `curl`, `wget`, or other plain HTTP clients for tasks that require rendering, clicking, or inspecting a page.
+
+### Web Research
+
+When stuck on an unfamiliar API, error message, library behavior, or design choice, do web research before guessing. The right direction or answer turns up the majority of the time. Cite URLs so the user can verify.
+
+Before searching, check what you already have. If the answer lives in the repo, the dependency's source, `--help`, a man page, a `README`, or a `CHANGELOG.md`, read those first — web research for local-knowledge questions is wasted motion. When you do search, sanitize the query: no secrets, internal URLs, proprietary code, or unique identifiers — strip to a generic reproduction.
+
+Prefer authoritative sources in this order: official docs → source code → GitHub issues → Stack Overflow → other. Check each result's date and the library version it covers against yours; articles age and APIs deprecate. Treat AI-generated SEO content as untrustworthy by default — verify every claim against an authoritative source before applying it.
+
+If a search returns no useful results, that is ambiguous: it may mean the **query** is wrong (wrong terms, too narrow), or that the **approach** is wrong (unusual framing of the problem). Reformulate the query 2–3 times before concluding the approach itself is off; when it is, step back and restate the problem rather than searching harder. Watch for confirmation bias — once early results push you toward a hypothesis, follow-up searches will keep surfacing "evidence" for it; periodically ask whether you're searching to understand or to justify. Conversely, when the first few authoritative results all agree "this isn't supported" or "isn't possible," that *is* the answer — don't keep searching for a workaround the ecosystem clearly hasn't built.
+
+### Honest Acknowledgment
+
+Don't open responses with performative agreement like "you're right" or "great catch." It hides the reasoning behind your change, obscures what's actually being updated, and lets the same class of mistake recur silently elsewhere. The user can't correct compounding behavior they haven't seen disclosed.
 
-Run `agent-browser --help` for available commands.
+When the user corrects you, state what you're actually updating, why the prior approach was wrong, and whether the same fix needs to apply elsewhere. Push back if the correction is itself mistaken — silent compliance is worse than honest disagreement.
 
 ## Workflow
 
@@ -66,7 +90,7 @@ Run `agent-browser --help` for available commands.
 ### 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.
+- **On "all done":** consolidate the changelog, recalculate the build number (if applicable), sync the version across all version files, and commit with a thematic subject line listing 3-5 themes in imperative form (e.g. `Add reconnect action, bandwidth polish, persistent TOTP lockout, and docs screenshots`). Do not use the version number as the subject (no `1.2.0 (295)` style); the version pointer lives in the tag, not the subject. Do not add co-author credits.
 - **Keep version numbers and CHANGELOG.md synchronized** at all times before commit.
 
 ## General Code Style

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

@@ -0,0 +1,55 @@
+# .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.
+- [conventions/documentation.md](conventions/documentation.md) — Documentation conventions (Docusaurus MDX page structure, voice, and style).
+
+### 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 ####
+#############################

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

package/build/templates/generators/must-haves/gitignore/gitignore

@@ -0,0 +1,179 @@
+################
+#### Shared ####
+################
+build/
+coverage/
+local.properties
+.env
+.env.*
+!.env.sample
+
+##################################
+#### Operating System - Linux ####
+##################################
+*~
+.fuse_hidden*
+.directory
+.Trash-*
+.nfs*
+
+##################################
+#### Operating System - macOS ####
+##################################
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+Icon
+
+####################################
+#### Operating System - Windows ####
+####################################
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.stackdump
+[Dd]esktop.ini
+$RECYCLE.BIN/
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+*.lnk
+
+#########################
+#### IDE - JetBrains ####
+#########################
+.idea/
+
+#############################
+#### IDE - Swift / Xcode ####
+#############################
+xcuserdata/
+DerivedData/
+.build/
+.swiftpm/
+*.xcresult
+*.moved-aside
+*.hmap
+*.ipa
+*.dSYM.zip
+*.dSYM
+
+##################################
+#### IDE - Visual Studio Code ####
+##################################
+.vscode/
+
+#########################
+#### Language - .NET ####
+#########################
+bin/
+obj/
+*.user
+.vs/
+
+############################
+#### Language - Node.js ####
+############################
+node_modules/
+package-lock.json
+
+###########################
+#### Language - Python ####
+###########################
+.venv/
+__pycache__/
+*.pyc
+
+###############################
+#### Language - TypeScript ####
+###############################
+*.tsbuildinfo
+
+################################
+#### Framework - Docusaurus ####
+################################
+.docusaurus/
+
+#############################
+#### Framework - Next.js ####
+#############################
+.next/
+
+#############################
+#### Tooling - AI Agents ####
+#############################
+.aider*
+.amazonq/
+.claude/
+.cline/
+.codex/
+.continue/
+.cursor/
+.gemini/
+.junie/
+.roo/
+.windsurf/
+
+##########################
+#### Tooling - Gradle ####
+##########################
+.gradle/
+*.class
+
+########################
+#### Tooling - Nova ####
+########################
+*.nova-backup
+*.nova-backup.*
+
+#############################
+#### Tooling - Turborepo ####
+#############################
+.turbo/
+
+###################################
+#### Web Hosting - AWS Amplify ####
+###################################
+amplify/.config/local-*
+amplify/backend/.temp
+amplify/backend/amplify-meta.json
+amplify/\#current-cloud-backend
+amplify/hooks/*.sample
+amplify/logs
+amplify/mock-api-resources
+amplify/mock-data
+src/amplifyconfiguration.json
+src/aws-exports.js
+
+##########################################
+#### Web Hosting - Cloudflare Workers ####
+##########################################
+.wrangler/
+worker-configuration.d.ts
+
+################################
+#### Web Hosting - Firebase ####
+################################
+.firebase
+.firebaserc
+firebase-debug.log
+
+##########################
+#### Project Excludes ####
+##########################

package/build/templates/scaffold/app/nextjs/next.config.mjs

@@ -1,4 +1,6 @@
 /** @type {import('next').NextConfig} */
-const nextConfig = {};
+const nextConfig = {
+  distDir: 'build',
+};
 
 export default nextConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cbnventures/nova",
-  "version": "0.16.2",
+  "version": "0.18.0",
   "description": "Scripts, templates, and project configuration for the common JavaScript and TypeScript developer",
   "keywords": [
     "eslint",