gemstack-cli 0.2.5 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fece916078245099b1b1a2772b7e53645d7e2420dd1fe28703593beb5e99d6f
-  data.tar.gz: 5f4d02f6371f8d95e05a2d9b8b942a70c7806f0848970d8be8d023bc6fc26d72
+  metadata.gz: ab399dd6760509d66d90e70758bce4f29efa781370b27efb79ed4d10d3af48f8
+  data.tar.gz: 66cbedd295830f20ef439a229ee9e99c2d8b4efc07fb77cce1386dc0eb42a555
 SHA512:
-  metadata.gz: f2c6ca47b6f4d6297d5d5a4e1ef7fe54013c479319de64f8db9ffec9a9ad6816c079d956979fbbe0c0fdef720234e3c0dabe3319702d852dfbe2949aa25c101a
-  data.tar.gz: fb4a50901dc646436500d6e934d9e0a51f9f211315740c887f147b476d96a3dd0f457993082b0b86c2ecafe4a7e19e5149ea8cc1b6a360423bb59eb55222ff5e
+  metadata.gz: a8b5b0134b58bb69bff5b2f1a8e415da32024c8ca5adc7a1820391166d3b382b584d152d991cd0b78114461a484bf10700bd1e6a2d8a0f53be78cd5e307bf474
+  data.tar.gz: f0d6dc52d9bbc96db7aa0c424798c04ca66ffc0636455fff3d9b122e45bbbcd91c437fe78601642e52b3520322a72dac8780aeea7cef383f23814deba556922a

data/CHANGELOG.md

@@ -1,29 +1,7 @@
 # Changelog
 
-## 0.2.5
+## 0.3.0
 
-See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
+Only the `gemstack` executable; the CLI code moved into the gemstack gem. See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
 
-## 0.2.4
-
-See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
-
-## 0.2.3
-
-See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
-
-## 0.2.2
-
-See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
-
-## 0.2.1
-
-See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
-
-## 0.2.0
-
-See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
-
-## 0.1.0
-
-First release. See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
+Earlier versions: see the GemStack changelog.

data/README.md

@@ -1,23 +1,12 @@
 # gemstack-cli
 
-GemStack command-line interface and generators.
+The `gemstack` command. It is installed with the [`gemstack`](https://rubygems.org/gems/gemstack) gem —
+`gem install gemstack` — and its code (generators, development server, `db:*` and `jobs` commands) lives
+there; this gem only provides the executable.
 
-Part of [GemStack](https://github.com/gemstack-rb/gemstack), a modular Ruby API framework for Next.js
-applications by [Adware Technologies](https://www.adwaretech.com). All GemStack gems are developed together in that repository and released with the same
-version.
-
-## Installation
-
-Installed with the `gemstack` gem; you rarely need to add it yourself.
-
-## Documentation
-
-- [Guide](https://github.com/gemstack-rb/gemstack/blob/main/docs/getting-started.md)
-- [All guides](https://github.com/gemstack-rb/gemstack/tree/main/docs) ·
-  [Architecture](https://github.com/gemstack-rb/gemstack/blob/main/ARCHITECTURE.md)
-
-Source, issues and pull requests: [gemstack-rb/gemstack](https://github.com/gemstack-rb/gemstack)
-(this gem lives in `gems/gemstack-cli`).
+GemStack is a modular Ruby API framework for Next.js applications by
+[Adware Technologies](https://www.adwaretech.com) — [gemstack-rb/gemstack](https://github.com/gemstack-rb/gemstack).
+Command reference: [docs/cli.md](https://github.com/gemstack-rb/gemstack/blob/main/docs/cli.md).
 
 ## License
 

data/exe/gemstack

@@ -1,6 +1,13 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "gemstack/cli"
+# The `gemstack` command. Its code lives in the gemstack gem (lib/gemstack/cli);
+# this gem only owns the executable, so installs from before 0.3.0 upgrade
+# without an executable conflict.
+begin
+  require "gemstack/cli"
+rescue LoadError
+  abort "gemstack: the gemstack gem is missing — install it with: gem install gemstack"
+end
 
 GemStack::CLI.start(ARGV)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gemstack-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.0
 platform: ruby
 authors:
 - Adware Technologies
@@ -9,49 +9,9 @@ authors:
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: gemstack-core
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.2.5
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.2.5
-- !ruby/object:Gem::Dependency
-  name: gemstack-dev
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.2.5
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.2.5
-- !ruby/object:Gem::Dependency
-  name: thor
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
+dependencies: []
+description: Owns the gemstack executable. The CLI itself — generators, dev server,
+  db and jobs commands — is part of the gemstack gem, which installs this one.
 email:
 - gemstack26@gmail.com
 executables:
@@ -63,126 +23,13 @@ files:
 - LICENSE.txt
 - README.md
 - exe/gemstack
-- lib/gemstack/cli.rb
-- lib/gemstack/cli/add_generator.rb
-- lib/gemstack/cli/app_generator.rb
-- lib/gemstack/cli/commands/db.rb
-- lib/gemstack/cli/commands/jobs.rb
-- lib/gemstack/cli/controller_generator.rb
-- lib/gemstack/cli/deploy_generator.rb
-- lib/gemstack/cli/doctor.rb
-- lib/gemstack/cli/generator.rb
-- lib/gemstack/cli/job_generator.rb
-- lib/gemstack/cli/migration_generator.rb
-- lib/gemstack/cli/policy_generator.rb
-- lib/gemstack/cli/project.rb
-- lib/gemstack/cli/resource_generator.rb
-- lib/gemstack/cli/resource_spec.rb
-- templates/app/Gemfile.tt
-- templates/app/README.md.tt
-- templates/app/app/controllers/application_controller.rb
-- templates/app/app/jobs/application_job.rb
-- templates/app/app/mailers/application_mailer.rb
-- templates/app/app/mailers/templates/dot_keep
-- templates/app/app/models/application_model.rb
-- templates/app/app/serializers/application_serializer.rb
-- templates/app/bin/gemstack
-- templates/app/config.ru
-- templates/app/config/app.rb.tt
-- templates/app/config/database.yml.tt
-- templates/app/config/environments/development.rb.tt
-- templates/app/config/environments/production.rb.tt
-- templates/app/config/environments/test.rb.tt
-- templates/app/config/puma.rb
-- templates/app/config/routes.rb
-- templates/app/db/migrations/dot_keep
-- templates/app/db/seeds.rb
-- templates/app/dot_env.example.tt
-- templates/app/dot_gitignore
-- templates/app/dot_node-version.tt
-- templates/app/dot_nvmrc.tt
-- templates/app/dot_ruby-version.tt
-- templates/app/dot_tool-versions.tt
-- templates/app/test/health_test.rb
-- templates/app/test/test_helper.rb.tt
-- templates/auth/app/controllers/api_tokens_controller.rb
-- templates/auth/app/controllers/email_verifications_controller.rb
-- templates/auth/app/controllers/password_resets_controller.rb
-- templates/auth/app/controllers/registrations_controller.rb
-- templates/auth/app/controllers/sessions_controller.rb
-- templates/auth/app/mailers/auth_mailer.rb
-- templates/auth/app/mailers/templates/auth_mailer/email_verification.html.erb
-- templates/auth/app/mailers/templates/auth_mailer/email_verification.text.erb
-- templates/auth/app/mailers/templates/auth_mailer/password_reset.html.erb
-- templates/auth/app/mailers/templates/auth_mailer/password_reset.text.erb
-- templates/auth/app/models/auth_token.rb
-- templates/auth/app/models/user.rb
-- templates/auth/app/policies/application_policy.rb
-- templates/auth/app/serializers/api_token_serializer.rb
-- templates/auth/app/serializers/new_api_token_serializer.rb
-- templates/auth/app/serializers/user_serializer.rb
-- templates/auth/db/migrations/%timestamp%_create_auth_tables.rb
-- templates/auth/frontend/app/account/page.tsx
-- templates/auth/frontend/app/forgot-password/page.tsx
-- templates/auth/frontend/app/login/page.tsx
-- templates/auth/frontend/app/reset-password/page.tsx
-- templates/auth/frontend/app/signup/page.tsx
-- templates/auth/frontend/app/verify-email/page.tsx
-- templates/auth/frontend/components/auth/CredentialsForm.tsx
-- templates/auth/frontend/components/auth/ResetPasswordForm.tsx
-- templates/auth/frontend/components/auth/VerifyEmail.tsx
-- templates/auth/frontend/lib/auth.ts
-- templates/auth/test/controllers/auth_test.rb
-- templates/controller/app/controllers/%file_name%_controller.rb.tt
-- templates/controller/test/controllers/%file_name%_controller_test.rb.tt
-- templates/deploy/Caddyfile.tt
-- templates/deploy/Dockerfile.tt
-- templates/deploy/Procfile.tt
-- templates/deploy/compose.yaml.tt
-- templates/deploy/dot_dockerignore
-- templates/frontend/app/globals.css
-- templates/frontend/app/layout.tsx.tt
-- templates/frontend/app/page.module.css
-- templates/frontend/app/page.tsx.tt
-- templates/frontend/app/providers.tsx
-- templates/frontend/lib/gemstack/client.ts
-- templates/frontend/next-env.d.ts
-- templates/frontend/next.config.ts
-- templates/frontend/package.json.tt
-- templates/frontend/tsconfig.json
-- templates/job/app/jobs/%file_name%.rb.tt
-- templates/job/test/jobs/%file_name%_test.rb.tt
-- templates/migration/db/migrations/%timestamp%_%file_name%.rb.tt
-- templates/policy/app/policies/%file_name%_policy.rb.tt
-- templates/policy/test/policies/%file_name%_policy_test.rb.tt
-- templates/realtime/config/channels.rb
-- templates/realtime/frontend/lib/gemstack/realtime.ts
-- templates/resource/controller/app/controllers/%plural%_controller.rb.tt
-- templates/resource/controller/test/controllers/%plural%_controller_test.rb.tt
-- templates/resource/frontend/frontend/app/%url_segment%/[id]/edit/page.tsx.tt
-- templates/resource/frontend/frontend/app/%url_segment%/[id]/page.tsx.tt
-- templates/resource/frontend/frontend/app/%url_segment%/new/page.tsx.tt
-- templates/resource/frontend/frontend/app/%url_segment%/page.tsx.tt
-- templates/resource/frontend/frontend/components/%url_segment%/%class_name%Card.tsx.tt
-- templates/resource/frontend/frontend/components/%url_segment%/%class_name%Form.tsx.tt
-- templates/resource/frontend/frontend/components/%url_segment%/%class_name%Table.tsx.tt
-- templates/resource/frontend/frontend/lib/format.ts
-- templates/resource/frontend/frontend/lib/queries/%url_segment%.ts.tt
-- templates/resource/migration/db/migrations/%timestamp%_create_%table%.rb.tt
-- templates/resource/model/app/models/%file_name%.rb.tt
-- templates/resource/model/test/models/%file_name%_test.rb.tt
-- templates/resource/serializer/app/serializers/%file_name%_serializer.rb.tt
-- templates/storage/app/controllers/uploads_controller.rb.tt
-- templates/storage/app/serializers/upload_serializer.rb
-- templates/storage/frontend/lib/upload.ts
-- templates/storage/test/controllers/uploads_test.rb.tt
 homepage: https://github.com/gemstack-rb/gemstack
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/gemstack-rb/gemstack/tree/main/gems/gemstack-cli
-  changelog_uri: https://github.com/gemstack-rb/gemstack/blob/main/gems/gemstack-cli/CHANGELOG.md
+  changelog_uri: https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/gemstack-rb/gemstack/issues
   documentation_uri: https://github.com/gemstack-rb/gemstack/tree/main/docs
 rdoc_options: []
@@ -201,5 +48,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.20
 specification_version: 4
-summary: GemStack command-line interface and generators
+summary: The gemstack command (installed with the gemstack gem)
 test_files: []

data/lib/gemstack/cli/add_generator.rb

@@ -1,239 +0,0 @@
-# frozen_string_literal: true
-
-module GemStack
-  class CLI < Thor
-    # `gemstack add FEATURE` — opt-in modules, so apps that don't use them
-    # pay nothing: realtime, auth, storage.
-    class AddGenerator < Generator
-      FEATURES = %w[realtime auth storage].freeze
-
-      AUTH_ROUTES = <<~RUBY
-        # Authentication (gemstack add auth) — docs/authentication.md
-        post "/auth/signup", to: "registrations#create"
-        post "/auth/login", to: "sessions#create"
-        get "/auth/me", to: "sessions#show"
-        delete "/auth/logout", to: "sessions#destroy"
-        post "/auth/password/forgot", to: "password_resets#create"
-        post "/auth/password/reset", to: "password_resets#update"
-        post "/auth/email/resend", to: "email_verifications#create"
-        post "/auth/email/verify", to: "email_verifications#update"
-        get "/auth/tokens", to: "api_tokens#index"
-        post "/auth/tokens", to: "api_tokens#create"
-        delete "/auth/tokens/:id", to: "api_tokens#destroy"
-      RUBY
-
-      MAIL_ENV = <<~ENV
-
-        # Email. In development messages are saved to tmp/mail instead of being sent.
-        # SMTP_URL=smtp://user:password@smtp.example.com:587
-        # MAIL_FROM="My App <hello@example.com>"
-        # APP_URL=https://example.com   # the frontend, for links in emails (default http://localhost:3000)
-      ENV
-
-      def initialize(feature, root:, output: $stdout, install: true)
-        super(output: output)
-        unless FEATURES.include?(feature)
-          raise Thor::Error,
-                "Unknown feature #{feature.inspect}. Available: #{FEATURES.join(", ")}"
-        end
-
-        @feature = feature
-        @root = root
-        @install = install
-      end
-
-      def run
-        public_send(:"add_#{@feature}")
-        self
-      end
-
-      def add_realtime
-        add_gem("gemstack-realtime")
-        template_files("realtime", override_root: @root).each do |rel, source|
-          next if rel.start_with?("frontend/") && !File.directory?(File.join(@root, "frontend"))
-
-          write(File.join(@root, rel), File.read(source))
-        end
-        add_test_support('require "gemstack/realtime/testing"', "GemStack::Realtime::Testing")
-        bundle_install
-      end
-
-      STORAGE_ENV = <<~ENV
-
-        # File storage. Development and tests store files under storage/ (git-ignored).
-        # STORAGE_SERVICE=s3            # production default
-        # S3_BUCKET=my-app-uploads
-        # AWS_REGION=eu-west-3
-        # AWS_ACCESS_KEY_ID=...  AWS_SECRET_ACCESS_KEY=...   (or an instance role)
-        # S3_ENDPOINT=https://<account>.r2.cloudflarestorage.com   # S3-compatible services
-      ENV
-
-      def add_storage
-        add_gem("gemstack-storage")
-        ensure_base_classes(@root, :serializer)
-        copy_feature_templates("storage")
-        add_routes(%(post "/uploads", to: "uploads#create" # direct uploads (gemstack add storage)\n),
-                   marker: "uploads#create")
-        append_env_example(STORAGE_ENV, marker: "STORAGE_SERVICE")
-        append_line(".gitignore", "/storage/")
-        add_test_support('require "gemstack/storage/testing"', "GemStack::Storage::Testing")
-        status("note", "Gemfile", "add gem \"aws-sdk-s3\" for S3 in production (docs/storage.md)")
-        bundle_install
-      end
-
-      # For templates: whether `gemstack add auth` ran.
-      def auth? = File.read(File.join(@root, "Gemfile")).match?(/^\s*gem "gemstack-auth"/)
-
-      def add_auth
-        require_database!("auth")
-        user_model = File.join(@root, "app/models/user.rb")
-        if File.file?(user_model) && !File.read(user_model).include?("GemStack::Auth::User")
-          raise Thor::Error, "app/models/user.rb already exists. Add `include GemStack::Auth::User` to it and " \
-                             "see docs/authentication.md (\"Existing users table\") instead."
-        end
-
-        add_gem("gemstack-mail")
-        add_gem("gemstack-auth")
-        JobGenerator.install_migration(@root, output: @output) # emails are sent from background jobs
-        ensure_base_classes(@root, :model, :serializer, :mailer)
-        copy_feature_templates("auth", skip_migration: "*_create_auth_tables.rb")
-        include_in_application_controller("GemStack::Auth::Controller")
-        add_routes(AUTH_ROUTES, marker: "/auth/login")
-        append_env_example(MAIL_ENV, marker: "SMTP_URL")
-        add_test_support('require "gemstack/mail/testing"', "GemStack::Mail::Testing")
-        add_test_support('require "gemstack/auth/testing"', "GemStack::Auth::Testing")
-        bundle_install
-      end
-
-      private
-
-      def frontend? = File.directory?(File.join(@root, "frontend"))
-
-      def require_database!(feature)
-        return if File.read(File.join(@root, "Gemfile")).match?(/^\s*gem "gemstack-db"/)
-
-        raise Thor::Error, "#{feature} stores its data in PostgreSQL; this app was created without a database " \
-                           "(add gem \"gemstack-db\" first — docs/database.md)"
-      end
-
-      # Writes a feature's templates (frontend/ files only when the app has
-      # one). %timestamp% in a path becomes a fresh migration version, unless a
-      # migration matching skip_migration already exists.
-      def copy_feature_templates(name, skip_migration: nil)
-        has_migration = skip_migration && !Dir.glob(File.join(@root, "db/migrations", skip_migration)).empty?
-        template_files(name, override_root: @root).sort.each do |rel, source|
-          next if rel.start_with?("frontend/") && !frontend?
-
-          if rel.include?("%timestamp%")
-            next status("identical", rel, "migration already present") if has_migration
-
-            rel = rel.sub("%timestamp%", Generator.migration_timestamp(@root))
-          end
-          content = File.read(source)
-          content = render(content, source) if rel.end_with?(".tt")
-          write(File.join(@root, rel.delete_suffix(".tt")), content)
-        end
-      end
-
-      def include_in_application_controller(mixin)
-        path = File.join(@root, "app/controllers/application_controller.rb")
-        return status("skip", path, "not found — add `include #{mixin}` yourself") unless File.file?(path)
-
-        content = File.read(path)
-        return status("identical", path, mixin) if content.include?(mixin)
-
-        updated = content.sub(/^class ApplicationController < .*\n/) { |line| "#{line}  include #{mixin}\n" }
-        return status("skip", path, "add `include #{mixin}` yourself") if updated == content
-
-        File.write(path, updated)
-        status("update", path, mixin)
-      end
-
-      def add_routes(block, marker:)
-        path = File.join(@root, "config/routes.rb")
-        content = File.file?(path) ? File.read(path) : ""
-        return status("identical", path, "routes") if content.include?(marker)
-        return status("skip", path, "no `GemStack.routes do` block — add the routes yourself") unless
-          content.match?(ControllerGenerator::ROUTES_BLOCK)
-
-        File.write(path, content.sub(ControllerGenerator::ROUTES_BLOCK) { |open| open + block.gsub(/^/, "  ") })
-        status("route", path)
-      end
-
-      def append_line(file, line)
-        path = File.join(@root, file)
-        return unless File.file?(path)
-
-        content = File.read(path)
-        return if content.lines.map(&:strip).include?(line)
-
-        File.write(path, "#{content.rstrip}\n#{line}\n")
-        status("update", path, line)
-      end
-
-      def append_env_example(text, marker:)
-        path = File.join(@root, ".env.example")
-        return unless File.file?(path)
-
-        content = File.read(path)
-        return if content.include?(marker)
-
-        File.write(path, "#{content.rstrip}\n#{text}")
-        status("update", path)
-      end
-
-      # Adds the gem inside the GemStack `path` block (checkout apps) or as a
-      # versioned dependency next to gem "gemstack".
-      def add_gem(name)
-        path = File.join(@root, "Gemfile")
-        content = File.read(path)
-        return status("identical", path, name) if content.match?(/^\s*gem "#{name}"/)
-
-        updated = content.match?(/^path ".*" do\n/) ? add_to_path_block(content, name) : add_versioned(content, name)
-        if updated == content
-          raise Thor::Error,
-                "couldn't find where to add #{name} in the Gemfile; add `gem \"#{name}\"` yourself"
-        end
-
-        File.write(path, updated)
-        status("gemfile", path, name)
-      end
-
-      # Keeps the block's gems in alphabetical order (Bundler/OrderedGems).
-      def add_to_path_block(content, name)
-        content.sub(/^(path ".*" do\n)((?:  gem .*\n)*)/) do
-          opening = ::Regexp.last_match(1)
-          lines = ::Regexp.last_match(2) # before sort_by's regexes reset last_match
-          gems = (lines.lines + ["  gem \"#{name}\"\n"]).sort_by { |line| line[/"([^"]+)"/, 1] }
-          opening + gems.join
-        end
-      end
-
-      def add_versioned(content, name)
-        content.sub(/^gem "gemstack",.*\n/) { |line| "#{line}gem \"#{name}\", \"~> #{GemStack::VERSION}\"\n" }
-      end
-
-      def add_test_support(require_line, mixin)
-        path = File.join(@root, "test/test_helper.rb")
-        return unless File.file?(path)
-
-        content = File.read(path)
-        return status("identical", path) if content.include?(mixin)
-
-        content = content.sub(%(require "gemstack/testing"\n)) { |line| "#{line}#{require_line}\n" }
-        content = "#{content.rstrip}\nGemStack::TestCase.include #{mixin}\n"
-        File.write(path, content)
-        status("update", path, mixin)
-      end
-
-      def bundle_install
-        return unless @install
-
-        status("run", "bundle install")
-        install = -> { system("bundle", "install", "--quiet", chdir: @root) }
-        ok = defined?(Bundler) ? Bundler.with_unbundled_env(&install) : install.call
-        status("warning", "bundle install failed — run it yourself") unless ok
-      end
-    end
-  end
-end

data/lib/gemstack/cli/app_generator.rb

@@ -1,142 +0,0 @@
-# frozen_string_literal: true
-
-require "gemstack/dev"
-
-module GemStack
-  class CLI < Thor
-    # `gemstack new NAME` — a Ruby API + Next.js application containing the
-    # framework infrastructure and deliberately no business resources.
-    class AppGenerator < Generator
-      NAME = /\A[a-z][a-z0-9_-]*\z/
-      # `--database` values (Rails' names) and aliases.
-      DATABASES = { "sqlite3" => "sqlite3", "sqlite" => "sqlite3", "postgresql" => "postgresql",
-                    "postgres" => "postgresql", "pg" => "postgresql", "mysql2" => "mysql2", "mysql" => "mysql2",
-                    "trilogy" => "trilogy" }.freeze
-      DRIVERS = { "sqlite3" => ["sqlite3", "~> 2.0"], "postgresql" => ["pg", "~> 1.5"],
-                  "mysql2" => ["mysql2", "~> 0.5"], "trilogy" => ["trilogy", "~> 2.9"] }.freeze
-
-      # The gems/ directory of the GemStack checkout this CLI runs from, if any.
-      CHECKOUT = File.expand_path("../../../..", __dir__)
-
-      attr_reader :name, :module_name, :destination, :gemstack_path, :api_path
-
-      def initialize(name, options = {}, output: $stdout)
-        super(output: output)
-        @name = File.basename(name.to_s)
-        @destination = File.expand_path(name.to_s)
-        @options = options
-        @module_name = Inflector.camelize(@name.tr("-", "_"))
-        @gemstack_path = options[:gemstack_path] ? File.expand_path(options[:gemstack_path]) : detect_checkout
-        @api_path = "/api"
-      end
-
-      def version = GemStack::VERSION
-
-      # Pins the app to the Ruby that generated it, in files every version
-      # manager reads (.ruby-version: rbenv, rvm, chruby, asdf, mise;
-      # .tool-versions: asdf, mise), and Node.js likewise (.node-version,
-      # .nvmrc, .tool-versions).
-      def ruby_version = RUBY_VERSION
-      def node_version = @node_version ||= Dev::Toolchain.pinned_node_version
-      def frontend? = !@options[:skip_frontend]
-      def database? = !@options[:skip_database]
-
-      # sqlite3 (default), postgresql, mysql2 or trilogy.
-      def database_adapter
-        @database_adapter ||= DATABASES.fetch(@options[:database].to_s.downcase.then do |d|
-          d.empty? ? "sqlite3" : d
-        end) do
-          raise Thor::Error,
-                "Unknown --database #{@options[:database].inspect}. Use: sqlite3, postgresql, mysql2, trilogy"
-        end
-      end
-
-      def driver_gem = DRIVERS.fetch(database_adapter).first
-      def driver_version = DRIVERS.fetch(database_adapter).last
-      def database_name = name.tr("-", "_")
-
-      def run
-        validate!
-        database_adapter if database? # fail early on an unknown --database
-        @output.puts("Creating GemStack application #{name} in #{destination}")
-        render_directory("app", destination, skip: lambda { |rel|
-          (!database? && (rel.start_with?("db/", "app/models/") || rel == "config/database.yml.tt")) ||
-            (!frontend? && %w[dot_node-version.tt dot_nvmrc.tt].include?(rel))
-        })
-        render_directory("frontend", File.join(destination, "frontend")) if frontend?
-        install unless @options[:skip_install]
-        git_init unless @options[:skip_git]
-        summary
-        self
-      end
-
-      private
-
-      def validate!
-        unless NAME.match?(name)
-          raise Thor::Error,
-                "Invalid name #{name.inspect}: use lowercase letters, digits, - and _, starting with a letter"
-        end
-        return unless File.exist?(destination) && !Dir.empty?(destination)
-
-        raise Thor::Error, "#{destination} already exists and is not empty"
-      end
-
-      def detect_checkout
-        File.file?(File.join(CHECKOUT, "gemstack", "gemstack.gemspec")) ? CHECKOUT : nil
-      end
-
-      def install
-        bundled = run_step("bundle install", destination, "bundle", "install", "--quiet")
-        create_database if bundled && database?
-        return unless frontend?
-
-        run_step("npm install", File.join(destination, "frontend"), "npm", "install", "--no-fund",
-                 "--no-audit")
-        # The TypeScript contract, so frontend/lib/api/generated exists from the start.
-        run_step("gemstack contract", destination, "bin/gemstack", "contract", "--quiet") if bundled
-      end
-
-      # Best effort: a missing or password-protected database server shouldn't fail `new`.
-      def create_database
-        @output.puts("  #{"run".rjust(9)}  gemstack db:create")
-        ok = unbundled { system("bin/gemstack", "db:create", chdir: destination, out: File::NULL, err: File::NULL) }
-        return if ok
-
-        @output.puts("  #{"warning".rjust(9)}  couldn't create the database — " \
-                     "check config/database.yml (or set DATABASE_URL in .env), then run `gemstack db:create`")
-      end
-
-      def git_init
-        return if File.directory?(File.join(destination, ".git")) || !system("git --version", out: File::NULL)
-
-        run_step("git init", destination, "git", "init", "--quiet")
-      end
-
-      def run_step(label, dir, *command)
-        @output.puts("  #{"run".rjust(9)}  #{label}")
-        ok = unbundled { system(*command, chdir: dir) }
-        @output.puts("  #{"warning".rjust(9)}  `#{label}` failed — run it manually in #{dir}") unless ok
-        ok
-      end
-
-      # Run child commands with the new app's bundle, not the CLI's.
-      def unbundled(&)
-        defined?(Bundler) ? Bundler.with_unbundled_env(&) : yield
-      end
-
-      def summary
-        @output.puts <<~TEXT
-
-          GemStack application #{name} created.
-
-            cd #{name}
-            gemstack dev        # → http://localhost:3000
-
-          Next: gemstack generate resource Product name:string price:decimal
-          Useful commands: gemstack routes · gemstack test · gemstack console · gemstack db:migrate
-        TEXT
-      end
-    end
-  end
-end