ruby_native 0.19.0 → 0.19.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 491f0a1e2130f57fed894e6135f335799520c8050790ab19065f5719124bfdf9
-  data.tar.gz: ba626083a16d9f075905a9739245dc626f9b21c8dd6302727beafb53263c176a
+  metadata.gz: 781df25f5a04d4f1d797f8004248c71e5e9f6b73d18965b4036e51bd8990f021
+  data.tar.gz: b232c5cdfd1f2cda62214936b27ae08e840f1666c0feecdd4e92bd7fd7b70c1c
 SHA512:
-  metadata.gz: f2c5079d15d1ab0497534dd09df22def4fef55816620518ed6405cc6b7ce2329d0cd4a2e6470fa280c4c785c77076ee3cf0402433f9c3fe9f7d581899d49a84d
-  data.tar.gz: 62580eabcc487edb2ac827a19071733e565fdab8ca41764127e0c5854b0257b136305324758865c141841fbe26e6f84485c0970f88761cd6eacb77318b1526a3
+  metadata.gz: 5afe36bca245ee30724d854b2d11b8684090ae7fd4d441f1d5d8f6267113c3abbc18533fedfe0654ee3800d8e78509b0322b41675d282483ae3dc4a6de247695
+  data.tar.gz: d2334ac64c9a9283ddacbd4230fb6e965ddf9fec9f909bb91b6c0675e73c0e15ebcb064d77e93c8aa15c31733cec9ae47adc7531cefdeb8d9386880cfe4d1715

data/lib/ruby_native/cli/link.rb

@@ -10,7 +10,26 @@ module RubyNative
     class Link < Command
       def run
         ensure_authenticated!
-        finish(self.class.link(positional.first || flag("app")))
+        return finish(self.class.link(positional.first || flag("app"))) unless @argv.include?("--new")
+
+        name, url = flag("name"), flag("url")
+        if name.to_s.strip.empty? || url.to_s.strip.empty?
+          puts "Usage: ruby_native link --new --name=\"App name\" --url=https://example.com"
+          exit 1
+        end
+        finish(self.class.create(name: name, url: url))
+      end
+
+      # Creates the app on the account and links it, so an agent never sends
+      # the person to Create your app.
+      def self.create(name:, url:)
+        result = Mcp::Platform.post("/api/v1/apps", { name: name, url: url })
+        return failure(result) unless result.ok?
+
+        app = result.value
+        Mcp::Platform.write_app_id(app["public_id"])
+        success("Created #{app["name"]} (#{app["public_id"]}) for #{app["url"]} and linked it. Wrote ruby_native.app_id to #{Mcp::Platform::CONFIG_PATH}.",
+          { "app_id" => app["public_id"], "name" => app["name"], "url" => app["url"] })
       end
 
       def self.link(app_id = nil)
@@ -18,7 +37,7 @@ module RubyNative
         return failure(result) unless result.ok?
 
         apps = Array(result.value)
-        return Outcome.new(ok: false, text: "No apps on this account yet. Create one at #{Mcp::Platform::HOST}/apps/new, then run this again.", data: { "apps" => [] }) if apps.empty?
+        return Outcome.new(ok: false, text: "No apps on this account yet. Create one with `ruby_native link --new --name=\"App name\" --url=https://example.com`.", data: { "apps" => [] }) if apps.empty?
 
         app = if app_id.to_s.strip.empty?
           apps.one? ? apps.first : nil

data/lib/ruby_native/cli/mcp/prompts.rb

@@ -81,22 +81,27 @@ module RubyNative
           pass.
 
           When you are done, run `validate_config` and `check_views` and fix what they report. Then
-          tell the person to run `bundle exec ruby_native preview` and scan the code it prints with
-          the Ruby Native app on their phone. Do not run preview yourself: it opens a tunnel and
-          waits for a phone. List what you changed and what they should look at on the device,
+          get the preview ready so the person only has to scan: call `preview_check`. If cloudflared
+          is missing, run the install command it gives you, or hand over the download link when
+          there is no Homebrew. If the Rails server is not running, ask the person to start it in
+          its own terminal; if it answers with an error, fix what the check reports. Call
+          `preview_check` again until it says ready.
+
+          Then tell the person to run `bundle exec ruby_native preview`, long-press the Ruby Native
+          app on their phone, tap Switch website, and scan the code it prints. No Ruby Native app
+          yet? It is at https://rubynative.com/try. Do not run preview yourself: it opens a tunnel
+          and waits for a phone. List what you changed and what they should look at on the device,
           since you cannot see the app running in the native shell.
 
           ## 3. The account and the app
 
-          If `status` says there is no login or no linked app, the person does two things, and you
-          wait after each one:
+          If `status` says there is no login, run `bundle exec ruby_native login`. It opens the
+          browser, where the person signs in, or creates an account and enters the code we email
+          them, then clicks Approve. Wait for them. No password goes through the terminal.
 
-          1. Create the app at #{Platform::HOST}/apps/new: a name and the site's URL, and an account
-             if they do not have one.
-          2. Run `bundle exec ruby_native login` on this machine. It opens the browser and they click
-             Approve. No password goes through the terminal.
-
-          Then call `link_app`.
+          Then, with no linked app, call `link_app`. If the account has no app for this project yet,
+          call `app_create` with the app's name and its production URL. Take both from the codebase
+          when it says, and ask the person when it does not; never use localhost or a staging host.
 
           ## 4. The stores
 

data/lib/ruby_native/cli/mcp.rb

@@ -9,6 +9,7 @@ require "ruby_native/cli/demo_account"
 require "ruby_native/cli/icon"
 require "ruby_native/cli/listing"
 require "ruby_native/cli/permissions"
+require "ruby_native/cli/preview"
 require "ruby_native/cli/screenshots"
 require "ruby_native/cli/link"
 require "ruby_native/cli/status"
@@ -114,6 +115,22 @@ module RubyNative
           },
           annotations: { title: "Validate config", readOnlyHint: true, openWorldHint: false }
         },
+        {
+          name: "preview_check",
+          description: "Check what `bundle exec ruby_native preview` needs before handing it to the person: whether " \
+                       "cloudflared is installed, with the command that installs it, and whether the Rails server " \
+                       "answers on its port with a Ruby Native config. Opens no tunnel and reaches only the local " \
+                       "server. Run it, fix what it reports, and run it again until it says ready.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              port: { type: "integer", description: "The Rails server's port. Defaults to PORT, then 3000, like preview." },
+              url: { type: "string", description: "The Rails server's URL, for a server not on localhost. Overrides port." }
+            },
+            additionalProperties: false
+          },
+          annotations: { title: "Check preview", readOnlyHint: true, openWorldHint: false }
+        },
         {
           name: "config_errors",
           description: "Report what the app your users are running is failing on: the config errors real devices " \
@@ -184,6 +201,23 @@ module RubyNative
           },
           annotations: { title: "Link app", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
         },
+        {
+          name: "app_create",
+          description: "Create the app on the person's rubynative.com account and link this project to it, in place of " \
+                       "sending them to Create your app. Use the app's name and its production URL, never localhost " \
+                       "or a staging host; ask the person when the codebase doesn't say. Call `link_app` instead when " \
+                       "the account already has this app. Reaches rubynative.com and needs `ruby_native login`.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              name: { type: "string", description: "What the person's customers see under the icon on their Home Screen." },
+              url: { type: "string", description: "The production Rails root URL, like https://example.com." }
+            },
+            required: [ "name", "url" ],
+            additionalProperties: false
+          },
+          annotations: { title: "Create app", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+        },
         {
           name: "status",
           description: "Report where the app is on the way to the App Store and Google Play and what is in the way: " \
@@ -532,8 +566,8 @@ module RubyNative
         (2) In the layout <head>, add `<%= stylesheet_link_tag :ruby_native %>` and put
         `viewport-fit=cover` in the viewport meta tag. (3) In the layout <body>, add
         `<%= native_tabs_tag %>` and `<%= native_identity_tag(current_user&.id) %>`.
-        (4) Run `validate_config` and `check_views`, then `bundle exec ruby_native preview` to see it
-        on a phone. Full docs: https://rubynative.com/llms.txt (index) and llms-full.txt (everything).
+        (4) Run `validate_config` and `check_views`, then `preview_check` until it says ready, and
+        hand the person `bundle exec ruby_native preview` to see it on a phone. Full docs: https://rubynative.com/llms.txt (index) and llms-full.txt (everything).
 
         Signals fail silently: an attribute the app does not know is ignored with no error anywhere.
         Call `lookup_signals` before writing one and `check_views` after editing any view.
@@ -564,10 +598,14 @@ module RubyNative
           when "check_views" then check_views(arguments)
           when "lookup_signals" then lookup_signals(arguments)
           when "validate_config" then validate_config(arguments)
+          when "preview_check" then preview_check(arguments)
           when "config_errors" then config_errors(arguments)
           when "deployed_builds" then deployed_builds(arguments)
           when "build_status" then build_status(arguments)
           when "status" then status(arguments)
+          when "app_create"
+            outcome = Link.create(name: string!(arguments, "name"), url: string!(arguments, "url"))
+            tool_result(outcome.text, outcome.data, is_error: !outcome.ok)
           when "link_app"
             outcome = Link.link(arguments["app_id"].to_s.strip.empty? ? nil : arguments["app_id"].to_s.strip)
             tool_result(outcome.text, outcome.data, is_error: !outcome.ok)
@@ -677,6 +715,27 @@ module RubyNative
         })
       end
 
+      def preview_check(arguments)
+        argv = []
+        argv += [ "--port", arguments["port"].to_s ] if arguments["port"]
+        argv += [ "--url", arguments["url"].to_s ] if arguments["url"].is_a?(String) && !arguments["url"].strip.empty?
+        ready = Preview.new(argv).readiness
+
+        lines = []
+        if ready[:cloudflared]
+          lines << "cloudflared is installed."
+        else
+          lines << "cloudflared is not installed. Install it with: #{ready[:cloudflared_install]}"
+        end
+        lines << (ready[:server_ready] ? "The Rails server answers at #{ready[:upstream]} with a Ruby Native config." : ready[:server_problem])
+        if ready[:cloudflared] && ready[:server_ready]
+          lines << "Ready. Tell the person to run `bundle exec ruby_native preview`, long-press the Ruby Native app " \
+                   "on their phone, tap Switch website, and scan the code it prints."
+        end
+
+        tool_result(lines.join("\n\n"), ready.merge(ready: ready[:cloudflared] && ready[:server_ready]))
+      end
+
       # --- Tools that read the API ---
 
       def config_errors(arguments)

data/lib/ruby_native/cli/preview.rb

@@ -2,6 +2,7 @@ require "open3"
 require "net/http"
 require "uri"
 require "resolv"
+require "stringio"
 require "ruby_native/cli/credentials"
 
 module RubyNative
@@ -17,6 +18,8 @@ module RubyNative
       OUTPUT_TAIL_LINES = 5
       DEPLOY_URL = "https://rubynative.com/deploy"
       QR_QUIET_ZONE = 4
+      BREW_INSTALL = "brew install cloudflare/cloudflare/cloudflared".freeze
+      CLOUDFLARED_DOWNLOADS = "https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/".freeze
 
       def initialize(argv)
         @url = parse_option(argv, "--url")
@@ -30,6 +33,19 @@ module RubyNative
         start_tunnel
       end
 
+      # What `run` would stop on, without opening a tunnel. The MCP's
+      # preview_check reads this so an agent can fix it before handing over.
+      def readiness
+        problem = upstream_problem
+        {
+          cloudflared: cloudflared_installed?,
+          cloudflared_install: homebrew_installed? ? BREW_INSTALL : CLOUDFLARED_DOWNLOADS,
+          upstream: @upstream,
+          server_ready: problem.nil?,
+          server_problem: problem
+        }
+      end
+
       private
 
       def check_upstream!
@@ -189,17 +205,58 @@ module RubyNative
       end
 
       def check_cloudflared!
-        unless system("which cloudflared > /dev/null 2>&1")
-          puts "cloudflared is not installed."
+        return if cloudflared_installed?
+
+        puts "cloudflared is not installed."
+        puts ""
+        return if offer_to_install_cloudflared
+
+        puts "Install it with Homebrew:"
+        puts "  #{BREW_INSTALL}"
+        puts ""
+        puts "Or see: #{CLOUDFLARED_DOWNLOADS}"
+        exit 1
+      end
+
+      # Only someone at a terminal can say yes; an agent or CI gets the command instead.
+      def offer_to_install_cloudflared
+        return false unless homebrew_installed? && $stdin.tty?
+
+        print "Install it now with Homebrew? [Y/n] "
+        answer = $stdin.gets.to_s.strip.downcase
+        return false unless answer.empty? || answer.start_with?("y")
+
+        if system(BREW_INSTALL) && cloudflared_installed?
+          puts ""
+          true
+        else
           puts ""
-          puts "Install it with Homebrew:"
-          puts "  brew install cloudflare/cloudflare/cloudflared"
+          puts "Homebrew could not install cloudflared."
           puts ""
-          puts "Or see: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/"
-          exit 1
+          false
         end
       end
 
+      def cloudflared_installed?
+        system("which cloudflared > /dev/null 2>&1")
+      end
+
+      def homebrew_installed?
+        system("which brew > /dev/null 2>&1")
+      end
+
+      # check_upstream! prints its advice and exits; this keeps the advice as text.
+      def upstream_problem
+        original = $stdout
+        $stdout = StringIO.new
+        check_upstream!
+        nil
+      rescue SystemExit
+        $stdout.string.strip
+      ensure
+        $stdout = original
+      end
+
       def start_tunnel
         puts "Starting tunnel to #{@upstream}..."
         if @url

data/lib/ruby_native/cli/status.rb

@@ -93,8 +93,8 @@ module RubyNative
           "the first native pass, the seven changes in the `ship` prompt (`ruby_native ship` prints it). " \
             "Then `bundle exec ruby_native preview` to see it on a phone."
         elsif !local["logged_in"]
-          "create the app at #{Mcp::Platform::HOST}/apps/new (a name, the site's URL, and an account if you have none), " \
-            "then `ruby_native login` and `ruby_native link`."
+          "`ruby_native login` (it opens the browser to sign in, or to create an account and confirm the email), " \
+            "then `ruby_native link --new --name=NAME --url=URL` to create the app, or `ruby_native link` if it already exists."
         else
           "run `ruby_native link` to pick the app on your account."
         end

data/lib/ruby_native/cli.rb

@@ -83,6 +83,7 @@ module RubyNative
       puts "Commands:"
       puts "  Every command that talks to rubynative.com reads the app from config/ruby_native.yml, or takes --app=ID."
       puts "  link [APP_ID]  Link this project to an app on your account (writes ruby_native.app_id)"
+      puts "    --new --name=NAME --url=URL  Create the app on your account first, then link it"
       puts "  apple key PATH --key-id=KEY --issuer-id=ISSUER --team-id=TEAM"
       puts "                Hand over the App Store Connect key (.p8) and wait for Apple to accept it"
       puts "  check         Validate your views against the signal vocabulary"

data/lib/ruby_native/version.rb

@@ -1,3 +1,3 @@
 module RubyNative
-  VERSION = "0.19.0"
+  VERSION = "0.19.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_native
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.19.1
 platform: ruby
 authors:
 - Joe Masilotti