nova-cli 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3369c06e4e1eb282de30f034c0e2f398238d7f40265bdf4d858a8d5fbecf8865
-  data.tar.gz: c566c64cb770d1234ca2b355577372f92426c2ff9a2854ee0909c77a53483f71
+  metadata.gz: f8b99f85d7869cb38a51e77f845c5024a0722410717205d266e4be1853cd7876
+  data.tar.gz: ea0cae7df11648890f4ca155c79dcf3af194d24f762632e0228587b32b77f928
 SHA512:
-  metadata.gz: 50590d35273831fc52d2916fa9e743ab7e0cef95bc9f6a6b498311f9d82f09ba037c3d30ac11de652452675af116fa52b4a86f8b9559ad07d60593a75291f7f1
-  data.tar.gz: c35f124a8a7f87c189e083013d2c943ecdfa23aff34052681fb101fce3cc2be621302781f491e3d2859618ca5c89308ace50fc2485e9e410b23328f8279175f6
+  metadata.gz: d33874c8e33aace96667afbadd4d43666776474627821c8edada6ee51163522c26b8e76ff9cc2561e5ed702919f33b0cb215deb21a400269ceab9db057d38cc3
+  data.tar.gz: 44fa471d9dab514a7d8f1fe081898b58aa478da8d86aca996489b023e1c5a1bcc2575d2e760ab5d9e0a17f06a6bbd607c85a73d65a38f7ddf08b66c8c1e5f7ea

data/lib/nova/generator.rb

@@ -39,6 +39,7 @@ module Nova
       { path: 'shape/4_tasks', template: nil }, # directory
       { path: 'shape/4_tasks/1_generate_application.md', template: 'tasks_examples/1_generate_application.md' },
       { path: 'shape/4_tasks/2_generate_static_pages.md', template: 'tasks_examples/2_generate_static_pages.md' },
+      { path: 'shape/4_tasks/3_deploy_to_heroku.md', template: 'tasks_examples/3_deploy_to_heroku.md' },
       
       # Code directory
       { path: 'code', template: nil } # directory
@@ -51,7 +52,7 @@ module Nova
     def generate
       create_main_directories
       create_all_files_and_directories
-      initialize_shape_git_repo
+      initialize_git_repo
       display_success_message
     end
 
@@ -106,7 +107,8 @@ module Nova
       puts "  │   │   └── example.md"
       puts "  │   └── 4_tasks/"
       puts "  │       ├── 1_generate_application.md"
-      puts "  │       └── 2_generate_static_pages.md"
+      puts "  │       ├── 2_generate_static_pages.md"
+      puts "  │       └── 3_deploy_to_heroku.md"
       puts "  └── code/"
     end
 
@@ -151,11 +153,9 @@ module Nova
       end
     end
 
-    def initialize_shape_git_repo
-      shape_path = File.join(app_name, 'shape')
-      
-      # Initialize git repository in shape directory
-      Dir.chdir(shape_path) do
+    def initialize_git_repo
+      # Initialize git repository at the project root (mono repo)
+      Dir.chdir(app_name) do
         system('git init', out: File::NULL, err: File::NULL)
         
         # Configure git user for initial commit (using system defaults)
@@ -167,16 +167,16 @@ module Nova
         system('git add .', out: File::NULL, err: File::NULL)
         
         # Make initial commit
-        system('git commit -m "Initial nova shape documentation structure"', out: File::NULL, err: File::NULL)
+        system('git commit -m "Initial commit: Nova project structure"', out: File::NULL, err: File::NULL)
         
         # Remove the local git config so user's global config takes over
         system('git config --unset user.email', out: File::NULL, err: File::NULL)
         system('git config --unset user.name', out: File::NULL, err: File::NULL)
       end
       
-      puts "\n✓ Git repository initialized in shape/ directory with initial commit"
+      puts "\n✓ Git repository initialized at project root with initial commit"
     rescue => e
-      puts "\n⚠ Warning: Could not initialize git repository in shape/ directory: #{e.message}"
+      puts "\n⚠ Warning: Could not initialize git repository: #{e.message}"
     end
   end
 end

data/lib/nova/templates/nova.mdc

@@ -14,17 +14,17 @@ alwaysApply: true
 You are working in a Nova project that follows a structured product development workflow from abstract ideas to concrete implementation.
 
 ## Project Structure
-- `shape/` - Product documentation (no code here) - **Has its own git repository**
+- `shape/` - Product documentation (no code here)
   - `1_big-picture/` - PRD, flowchart
   - `2_user-stories/` - User stories and their acceptance criteria  
   - `3_design-system/` - UI/UX standards and components
   - `4_tasks/` - Implementation tasks with progress tracking
-- `code/` - Application implementation - **Each app within has its own git repository**
+- `code/` - Application implementation
 
 ## Git Repository Structure
-- The `shape/` folder maintains its own git repository for tracking product documentation changes
-- Each application within the `code/` folder has its own separate git repository
-- This separation allows for independent version control of documentation and individual applications
+- The project uses a mono repo structure with a single git repository at the project root
+- Both `shape/` and `code/` directories are tracked in the same repository
+- This allows for atomic commits that include both documentation updates and code changes
 
 ## Workflow
 1. **Big Picture**: Define PRD and flowchart

data/lib/nova/templates/tasks_examples/1_generate_application.md

@@ -10,15 +10,13 @@ In the code/ directory generate a Rails 8 application with PostgreSQL, Tailwind
 
 ## Tasks
 
-- [ ] 1.0 Create Rails Application & Initialize Git
+- [ ] 1.0 Create Rails Application
   - [ ] 1.1 Generate Rails app: `rails _8.0.2_ new app_name --database=postgresql --css=tailwind`
   - [ ] 1.2 Navigate to app directory: `cd app_name`
-  - [ ] 1.3 Initialize git repository: `git init`
-  - [ ] 1.4 Initial commit: `git add . && git commit -m "Initial commit: New Rails app"`
-  - [ ] 1.5 Install Tailwind: `bundle exec rails tailwindcss:install`
-  - [ ] 1.6 Setup database: `bundle exec rails db:create db:migrate`
-  - [ ] 1.7 Install RSpec: `bundle exec rails generate rspec:install`
-  - [ ] 1.8 Verify RSpec works: `bundle exec rspec`
+  - [ ] 1.3 Install Tailwind: `bundle exec rails tailwindcss:install`
+  - [ ] 1.4 Setup database: `bundle exec rails db:create db:migrate`
+  - [ ] 1.5 Install RSpec: `bundle exec rails generate rspec:install`
+  - [ ] 1.6 Verify RSpec works: `bundle exec rspec`
 
 - [ ] 2.0 Set up Core Gems
   - [ ] 2.1 Add production gems to Gemfile (figaro, decanter)
@@ -45,31 +43,38 @@ In the code/ directory generate a Rails 8 application with PostgreSQL, Tailwind
   - [ ] 5.3 Add selenium-webdriver to Gemfile if not present: `bundle add selenium-webdriver --group test`
   - [ ] 5.4 Verify tests run: `bundle exec rspec spec/system`
 
-- [ ] 6.0 Final Setup & Verification
-  - [ ] 6.1 Verify all tests pass (RSpec including system tests)
-  - [ ] 6.2 Verify server starts cleanly: `bin/dev`
-  - [ ] 6.3 Create git commit for baseline setup
+- [ ] 6.0 Commit Changes
+  - [ ] 6.1 Stage all changes: `git add .`
+  - [ ] 6.2 Commit: `git commit -m "Generate Rails application with core dependencies"`
+
+- [ ] 7.0 Final Setup & Verification
+  - [ ] 7.1 Run full test suite: `bundle exec rspec`
+  - [ ] 7.2 Start Rails server: `rails server`
+  - [ ] 7.3 Visit `http://localhost:3000/hello` and verify everything works
+  - [ ] 7.4 Check that all JavaScript components load correctly
+  - [ ] 7.5 Review logs for any errors or warnings
 
 ## File Tracking
 
-### Files to Create
 | File Path | Purpose | Task Ref | Status |
-|-----------|---------|----------|--------|
-| `Gemfile` | Ruby dependencies | 2.1-2.3 | ⏳ |
-| `config/importmap.rb` | JavaScript imports | 3.1 | ⏳ |
-| `app/javascript/application.js` | JS entry point | 3.2 | ⏳ |
-| `app/controllers/pages_controller.rb` | Static pages controller | 4.1 | ⏳ |
-| `app/views/pages/hello.html.erb` | Hello world view | 4.3 | ⏳ |
-| `spec/system/hello_world_spec.rb` | System test | 5.2 | ⏳ |
-
-### Files to Modify
-| File Path | Changes | Task Ref | Status |
-|-----------|---------|----------|--------|
-| `config/routes.rb` | Add hello route | 4.2 | ⏳ |
-| `spec/rails_helper.rb` | Configure Capybara | 5.1 | ⏳ |
+|-----------|---------|----------|---------|
+| code/app_name/Gemfile | Core gem dependencies | 2.0 | ⏳ |
+| code/app_name/config/database.yml | Database configuration | 1.1 | ⏳ |
+| code/app_name/config/importmap.rb | JavaScript imports | 3.1 | ⏳ |
+| code/app_name/app/controllers/pages_controller.rb | Static pages controller | 4.1 | ⏳ |
+| code/app_name/config/routes.rb | Application routes | 4.2 | ⏳ |
+| code/app_name/spec/rails_helper.rb | RSpec configuration | 1.5, 5.1 | ⏳ |
+| code/app_name/spec/system/hello_world_spec.rb | E2E test | 5.2 | ⏳ |
 
 ## Notes
-- Follow Tailwind v4 documentation as many conventions have changed from v3
-- Ensure PostgreSQL is running before database creation
-- This sets up the foundation for all subsequent development tasks
-- Refer to design system in ../3_design-system/ for styling consistency 
+
+- Ensure PostgreSQL is running before creating the database
+- The app uses importmap-rails for JavaScript management (no webpack/yarn)
+- Flowbite provides pre-built Tailwind components
+- Run tests frequently to catch issues early
+
+## Troubleshooting
+
+- If database creation fails, check PostgreSQL is running: `brew services list`
+- For JavaScript issues, check browser console and `rails assets:precompile`
+- If tests fail, check Capybara configuration and Chrome/ChromeDriver versions 

data/lib/nova/templates/tasks_examples/3_deploy_to_heroku.md

@@ -0,0 +1,120 @@
+# Deploy to Heroku
+
+## Task Overview
+Deploy the Rails application to Heroku using a mono repo structure with proper buildpack configuration and environment setup.
+
+## Prerequisites
+- [ ] Rails application created and tested locally (Task 1 completed)
+- [ ] Heroku CLI installed and authenticated
+- [ ] Git repository initialized at project root
+
+## Tasks
+
+- [ ] 1.0 Create app.json Configuration
+  - [ ] 1.1 Create `app.json` file in the Rails app directory (code/[app_name]/app.json)
+  - [ ] 1.2 Configure with the following structure:
+    ```json
+    {
+      "name": "[app-name]",
+      "scripts": {
+        "postdeploy": "rake db:migrate && rake db:seed"
+      },
+      "addons": [
+        {
+          "plan": "heroku-redis:mini"
+        },
+        {
+          "plan": "heroku-postgresql:essential-0"
+        }
+      ],
+      "formation": {
+        "web": {
+          "quantity": 1,
+          "size": "basic"
+        },
+        "worker": {
+          "quantity": 1,
+          "size": "basic"
+        }
+      },
+      "buildpacks": [
+        {
+          "url": "https://github.com/lstoll/heroku-buildpack-monorepo"
+        },
+        {
+          "url": "heroku/ruby"
+        }
+      ],
+      "env": {
+        "APP_BASE": {
+          "required": true,
+          "value": "code/[app-name]"
+        },
+        "RAILS_MASTER_KEY": {
+          "required": true
+        }
+      }
+    }
+    ```
+  - [ ] 1.3 Replace [app-name] with actual application name
+  - [ ] 1.4 Adjust addons and formation based on project requirements
+
+- [ ] 2.0 Prepare Rails Application for Heroku
+  - [ ] 2.1 Ensure `config/master.key` exists (or create if missing)
+  - [ ] 2.2 Update `config/database.yml` production settings if needed
+  - [ ] 2.3 Add `ruby` version to Gemfile if not specified
+  - [ ] 2.4 Ensure all gems are compatible with Heroku
+
+- [ ] 3.0 Create Heroku Application
+  - [ ] 3.1 Navigate to project root directory
+  - [ ] 3.2 Create Heroku app: `heroku create [app-name]`
+  - [ ] 3.3 Set buildpacks in order:
+    - `heroku buildpacks:add https://github.com/lstoll/heroku-buildpack-monorepo`
+    - `heroku buildpacks:add heroku/ruby`
+  - [ ] 3.4 Set APP_BASE config var: `heroku config:set APP_BASE=code/[app-name]`
+  - [ ] 3.5 Set Rails master key: `heroku config:set RAILS_MASTER_KEY=$(cat code/[app-name]/config/master.key)`
+
+- [ ] 4.0 Configure Addons
+  - [ ] 4.1 Add PostgreSQL: `heroku addons:create heroku-postgresql:essential-0`
+  - [ ] 4.2 Add Redis if needed: `heroku addons:create heroku-redis:mini`
+  - [ ] 4.3 Verify addons: `heroku addons`
+
+- [ ] 5.0 Deploy Application
+  - [ ] 5.1 Commit all changes: `git add . && git commit -m "Configure for Heroku deployment"`
+  - [ ] 5.2 Push to Heroku: `git push heroku main`
+  - [ ] 5.3 Run database migrations: `heroku run rake db:migrate`
+  - [ ] 5.4 Seed database if needed: `heroku run rake db:seed`
+
+- [ ] 6.0 Verify Deployment
+  - [ ] 6.1 Open application: `heroku open`
+  - [ ] 6.2 Check logs: `heroku logs --tail`
+  - [ ] 6.3 Verify all pages load correctly
+  - [ ] 6.4 Test critical user flows
+
+- [ ] 7.0 Set Up Continuous Deployment (Optional)
+  - [ ] 7.1 Connect GitHub repository to Heroku
+  - [ ] 7.2 Enable automatic deploys from main branch
+  - [ ] 7.3 Configure review apps if needed
+
+## Notes
+
+- The mono repo buildpack must be set before the Ruby buildpack
+- APP_BASE environment variable tells Heroku where to find the Rails app within the mono repo
+- Ensure sensitive credentials are never committed to the repository
+- Use `heroku logs --tail` to debug deployment issues
+- Consider setting up Heroku pipelines for staging/production environments
+
+## File Tracking
+
+| File Path | Purpose | Task Ref | Status |
+|-----------|---------|----------|---------|
+| code/[app-name]/app.json | Heroku app configuration | 1.1 | ⏳ |
+| .gitignore | Ensure secrets are ignored | - | ✅ |
+| code/[app-name]/Gemfile | Ruby version specification | 2.3 | ⏳ |
+| code/[app-name]/config/database.yml | Production database config | 2.2 | ⏳ |
+
+## Resources
+
+- [Heroku Mono Repo Buildpack](https://github.com/lstoll/heroku-buildpack-monorepo)
+- [Heroku Rails Deployment Guide](https://devcenter.heroku.com/articles/getting-started-with-rails7)
+- [app.json Schema](https://devcenter.heroku.com/articles/app-json-schema) 

data/lib/nova.rb

@@ -2,5 +2,5 @@ require_relative 'nova/cli'
 require_relative 'nova/generator'
 
 module Nova
-  VERSION = '0.2.7'
+  VERSION = '0.2.8'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nova-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - Ryan Francis
@@ -45,6 +45,7 @@ files:
 - lib/nova/templates/readme_template.md
 - lib/nova/templates/tasks_examples/1_generate_application.md
 - lib/nova/templates/tasks_examples/2_generate_static_pages.md
+- lib/nova/templates/tasks_examples/3_deploy_to_heroku.md
 - lib/nova/templates/user_story_example.md
 - lib/nova/templates/windsurfrules_template.txt
 homepage: https://github.com/LaunchPadLab/nova