railstart 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 675d33f74310aa870ad6a167cbd585cc643b3e37096d255732bcf900fa7ab65d
-  data.tar.gz: 460628c266ba316d4ad19e148b9e8044912865c98f6c091dd8a1be25653dab71
+  metadata.gz: 5dd1449c02711ec50bf8b11e6ccfc0465768a4ad9271b0d8f08f7c9246aeb69f
+  data.tar.gz: 56a1956411fb506f35216355bc68be172d7f20dddc537504b31fe2b7e509fd9b
 SHA512:
-  metadata.gz: 344c0860107725a5a56e88bf108a7e7a73891da7f0f7678850af5c47469ed63f91c8c22de71743dc68747557f7d34aac2d001814033dee29533f5b343d8b7e0d
-  data.tar.gz: 2252beeb778c40a048e1156aebd1786a904fa7cf5edec89fd89d924265b223ff742024ceee8491d5b2a5b459a8a560047be60e43a85c13d771ee96db6edd978a
+  metadata.gz: 142b9a8f8ed2fee2f0647ef2cde5c8403080443ad7c312797268874677bc61ac6ab268321bbebc2910a611f1577f1b5d7198e2e8f2fa43666e8602f4838f5416
+  data.tar.gz: f1a77fbfdc5bcaffeb5a35db065583f8aab6cbaf9eb74c9b378bfeb7017448aee1d369dd6a063890ea416c478c1cc161617955702c4e2f9700694c4219029b36

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.1] - 2025-11-23
+
+### Changed
+- **Init command**: `railstart init` now copies the complete `config/rails8_defaults.yaml` as `~/.config/railstart/config.yaml` instead of generating a minimal example with only 2 questions. Users now see all available configuration options immediately.
+- **README**: Updated preset usage documentation to show both interactive and non-interactive modes immediately after custom preset creation example
+- **multi_select architecture**: `ask_multi_select` now transforms value-based defaults (e.g., "action_mailer") to name-based defaults (e.g., "Action Mailer") when calling TTY::Prompt, allowing configs to use stable IDs while maintaining correct UI display
+
+### Fixed
+- **CRITICAL ARCHITECTURE FIX**: Fixed `multi_select` question defaults to use stable choice **values** (internal IDs like "action_mailer") instead of fragile display **names** (like "Action Mailer"). This prevents preset breakage when display text changes.
+  - Updated `lib/railstart/generator.rb` `ask_multi_select` method to transform values → names at the TTY::Prompt boundary
+  - Updated `config/presets/api-only.yaml` to use values in defaults
+  - Updated all examples in `docs/railstart-preset-builder/SKILL.md` to use values
+  - Added comprehensive test coverage (3 new tests) validating transformation and storage behavior
+- **Documentation**: Corrected SKILL.md to explain values-based approach with stability rationale
+- Improved discoverability of configuration options - users no longer need to guess what can be configured
+
 ## [0.4.0] - 2025-11-22
 
 ### Added

data/README.md

@@ -183,7 +183,11 @@ post_actions:
 Then use it:
 
 ```bash
+# Interactive mode - prompts for each question
 railstart new myapp --preset my-team
+
+# Non-interactive mode - uses all preset defaults
+railstart new myapp --preset my-team --default
 ```
 
 ### Built-in Presets
@@ -209,18 +213,18 @@ See the comprehensive **[Creating Presets Guide](docs/railstart-preset-builder/S
 
 ### Initialize Configuration Files
 
-The easiest way to get started with custom configuration is to generate example files:
+The easiest way to get started with custom configuration is to generate template files:
 
 ```bash
 railstart init
 ```
 
 This creates:
-- `~/.config/railstart/config.yaml` - Example user config with common customizations
+- `~/.config/railstart/config.yaml` - Complete configuration template (copy of rails8_defaults.yaml with all available options)
 - `~/.config/railstart/presets/` - Directory for your presets
 - `~/.config/railstart/presets/example.yaml` - Example preset to get started
 
-You can then edit these files to match your preferences.
+The generated `config.yaml` shows all available questions, choices, flags, and post-actions. You can delete or comment out sections you don't want to customize, and modify the defaults for sections you do want to change.
 
 ### Built-in Defaults
 
@@ -228,24 +232,29 @@ Railstart ships with sensible Rails 8 defaults defined in `config/rails8_default
 
 ### Customize for Your Team
 
-You can create `~/.config/railstart/config.yaml` manually or use `railstart init` to generate an example file:
+You can create `~/.config/railstart/config.yaml` manually or use `railstart init` to generate a complete template file. The template includes all available options, so you can simply modify the defaults you want to change:
 
 ```yaml
+# After running `railstart init`, your config.yaml will contain all options.
+# Simply modify the defaults you want to change:
+
 questions:
   - id: database
     choices:
       - name: PostgreSQL (recommended)
         value: postgresql
-        default: true  # Your team's preference
+        default: true  # Changed from SQLite to PostgreSQL
+
+  # ... other questions with their full configuration ...
 
 post_actions:
   - id: bundle_install
-    enabled: false  # Your team manages gems differently
-  
+    enabled: false  # Disabled - your team manages gems differently
+
   - id: setup_auth
     name: "Setup authentication"
     enabled: true
-    command: "bundle exec rails generate devise:install"
+    command: "bundle exec rails generate devise:install"  # New custom action
 ```
 
 **Merge behavior:**

data/lib/railstart/cli.rb

@@ -257,40 +257,9 @@ module Railstart
     end
 
     def example_user_config
-      <<~YAML
-        ---
-        # Railstart User Configuration
-        # This file overrides built-in defaults for all your Rails projects.
-        #
-        # Merge behavior: questions and post_actions are merged by 'id'.
-        # Override individual fields or add new entries.
-
-        questions:
-          # Example: Change database default to PostgreSQL
-          - id: database
-            choices:
-              - name: PostgreSQL
-                value: postgresql
-                default: true
-
-          # Example: Change CSS default to Tailwind
-          - id: css
-            choices:
-              - name: Tailwind
-                value: tailwind
-                default: true
-
-        post_actions:
-          # Example: Disable bundle install (manage gems manually)
-          # - id: bundle_install
-          #   enabled: false
-
-          # Example: Add custom post-action
-          # - id: setup_linting
-          #   name: "Setup RuboCop and StandardRB"
-          #   enabled: true
-          #   command: "bundle add rubocop rubocop-rails standard --group development"
-      YAML
+      # Copy the full rails8_defaults.yaml as the user config template
+      defaults_path = File.expand_path("../../config/rails8_defaults.yaml", __dir__)
+      File.read(defaults_path)
     end
 
     def example_preset_config

data/lib/railstart/generator.rb

@@ -137,9 +137,16 @@ module Railstart
       choices = question["choices"].each_with_object({}) do |choice, hash|
         hash[choice["name"]] = choice["value"]
       end
-      defaults = question["default"] || []
 
-      @prompt.multi_select(question["prompt"], choices, default: defaults)
+      # Transform value-based defaults to name-based defaults for TTY::Prompt
+      # Config uses stable values (e.g., "action_mailer"), TTY::Prompt needs display names
+      value_defaults = question["default"] || []
+      name_defaults = value_defaults.map do |value|
+        choice = question["choices"].find { |c| c["value"] == value }
+        choice ? choice["name"] : nil
+      end.compact
+
+      @prompt.multi_select(question["prompt"], choices, default: name_defaults)
     end
 
     def ask_yes_no?(question)

data/lib/railstart/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Railstart
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railstart
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - dpaluy