omaship 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb563c444317757eeb0a2a8907d0c6b6b26bd1dc03e2373124270430e8565949
-  data.tar.gz: cbee20a1cd5b4e9e7c3e6af65246f632e4c024522d0caff7a68027bc8c43a0c5
+  metadata.gz: 6cb3e55ca287cec243c7b73d01ecbd5d37b5830fed0707175e3fce4c92168008
+  data.tar.gz: 7f38d4db65faaf778be3af3dd13472793f0d6bc396d82d040a20b39e7c770e13
 SHA512:
-  metadata.gz: 70ac4ca7b97b49bdfd46b0ac34d9193f183c57cad9c72a695434c705f92e342246d28ff2cf27a5d5b321bad22fe2ada28102c9277de888b131689c39bf66f147
-  data.tar.gz: 0432cb652ead9e22d92898bb17bd8d9babf45525b6f2e273248fdd55d47ce2deadf54a014002c9184dce302c024d4bad59abc4d7f2c371aa73217b964e981534
+  metadata.gz: 0f3aba37dd0ab910fb8132e192c9f14dab1678982723c9805d18cd1a2e47e242f5806ce25c847ec38bdb05fa54105f59eec55888c6ad6d8d633e5fe0a6d71636
+  data.tar.gz: 50fc535b1dea46931d96d8e17f894e94af3e6b8a035137aa7b5425f4bdbc8a07df23ec386affff5abc5b3641c2eabf6ea5c140a0c1508c738504607e0d0d734d

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.5.0](https://github.com/bloomedai/omaship/compare/omaship/v0.4.0...omaship/v0.5.0) (2026-04-04)
+
+
+### Features
+
+* ✨ enforce cli semver gate ([39952c0](https://github.com/bloomedai/omaship/commit/39952c0e855043acd1f1bcb3c4f963457032de4c))
+* adopt run-first ship flow and terminology ([#381](https://github.com/bloomedai/omaship/issues/381)) ([8bc857f](https://github.com/bloomedai/omaship/commit/8bc857fe3fcec6213f7d9d90fc9e8511411c8b00))
+
+
+### Bug Fixes
+
+* 🐛 align onboarding cli flow ([611425a](https://github.com/bloomedai/omaship/commit/611425a8d84446312daa33afb0c5ed49e8500e01))
+* 🐛 HTML-escape landing page inputs, prompt injection defense, regenerate on rename ([#353](https://github.com/bloomedai/omaship/issues/353)) ([85822df](https://github.com/bloomedai/omaship/commit/85822dfdc4dba3758ff506b4e08422d9c8be3187))
+* 🐛 move cli ship identity into api ([c331548](https://github.com/bloomedai/omaship/commit/c331548e8953de09524aa780b550bf2100cab502))
+* 🐛 remove cli skip-purpose flag ([b815ff7](https://github.com/bloomedai/omaship/commit/b815ff767430a5301012a1ba44583e305446f1a8))
+* 🐛 support landing ships in cli ([1a2f7fe](https://github.com/bloomedai/omaship/commit/1a2f7fecfa1f1b1ad277e6e007dd7303a1d2420a))
+
+
+### Code Refactoring
+
+* ♻️ rename LandingPage to Landingpage ([#337](https://github.com/bloomedai/omaship/issues/337)) ([16e9467](https://github.com/bloomedai/omaship/commit/16e9467dceea8e9a595f4be2edf8b89e9759bdfa))
+
 ## [0.4.0](https://github.com/bloomedai/omaship/compare/omaship/v0.3.0...omaship/v0.4.0) (2026-03-14)
 
 

data/README.md

@@ -55,9 +55,22 @@ Numeric ids are also accepted.
 - `omaship complete <bash|zsh|fish>` (print shell completion script)
 - `omaship logout`
 
-## Local Development Provisioning
+## Product Direction
 
-When you run `omaship new <name>` against local Omaship development (`OMASHIP_HOST=http://localhost:3000`), provisioning first installs gems from `https://packages.omaship.com`.
+Omaship CLI is evolving to support two complementary use cases:
+
+- standalone Omaship users launching and operating ship runs directly
+- Sokrates-orchestrated workflows where Sokrates calls Omaship capabilities
+
+Related docs:
+
+- [Sokrates × Omaship Vision](../docs/sokrates-omaship-vision.md)
+- [Sokrates Integration Task List](../docs/sokrates-integration-tasklist.md)
+- [Landing Pages Improvement Plan](../docs/landingpages-improvement-plan.md)
+
+## Local Development Run Execution
+
+When you run `omaship new <name>` against local Omaship development (`OMASHIP_HOST=http://localhost:3000`), the initial run first installs gems from `https://packages.omaship.com`.
 
 If that registry endpoint is unavailable, Omaship automatically retries `bundle install` through the local package proxy mirror at `http://build.localhost:3000/packages`.
 
@@ -107,14 +120,14 @@ omaship complete fish > ~/.config/fish/completions/omaship.fish
 Run from repository root:
 
 ```bash
-mise exec ruby@4.0.1 -- env BUNDLE_GEMFILE=cli/Gemfile bundle exec ruby cli/bin/omaship -h
+mise exec ruby@4.0.2 -- env BUNDLE_GEMFILE=cli/Gemfile bundle exec ruby cli/bin/omaship -h
 ```
 
 Run all CLI tests:
 
 ```bash
 cd cli
-mise exec ruby@4.0.1 -- bundle exec ruby -Itest -e 'Dir.glob("test/**/*_test.rb").sort.each { |f| require "./#{f}" }'
+mise exec ruby@4.0.2 -- bundle exec ruby -Itest -e 'Dir.glob("test/**/*_test.rb").sort.each { |f| require "./#{f}" }'
 ```
 
 ## Release Automation

data/lib/omaship/api_client.rb

@@ -8,6 +8,7 @@ module Omaship
     class UnauthorizedError < Error; end
     class PermissionDeniedError < Error; end
     class NotFoundError < Error; end
+    class UpgradeRequiredError < Error; end
 
     def initialize(host:, token:)
       @host = host.to_s
@@ -26,9 +27,9 @@ module Omaship
       post_json("/api/v1/cli/ships", { ship: { root_domain: root_domain, visibility: visibility } })
     end
 
-    def create_landing_page(name:, color_scheme: "mono-dark", purpose_profile: {})
+    def create_landingpage(name:, color_scheme: "mono-dark", purpose_profile: {})
       post_json("/api/v1/cli/ships", {
-        ship: { name: name, landing_page: true, color_scheme: color_scheme },
+        ship: { name: name, landingpage: true, color_scheme: color_scheme },
         purpose_profile: purpose_profile
       })
     end
@@ -60,11 +61,9 @@ module Omaship
       def parse_response(response)
         case response.status
         when 200..299
-          if response.body.to_s.empty?
-            {}
-          else
-            JSON.parse(response.body)
-          end
+          response_json(response)
+        when 426
+          raise upgrade_required_error(response)
         when 401
           raise UnauthorizedError, "Unauthorized"
         when 403
@@ -80,9 +79,55 @@ module Omaship
         @connection ||= Faraday.new(url: @host) do |faraday|
           faraday.request :retry, max: 2, interval: 0.1
           faraday.adapter Faraday.default_adapter
-          faraday.headers["Authorization"] = "Bearer #{@token}"
-          faraday.headers["Accept"] = "application/json"
+          faraday.headers.update(request_headers)
         end
       end
+
+      def request_headers
+        {
+          "Authorization" => "Bearer #{@token}",
+          "Accept" => "application/json",
+          "X-Omaship-CLI-Version" => Omaship::VERSION
+        }
+      end
+
+      def response_json(response)
+        if response.body.to_s.empty?
+          {}
+        else
+          JSON.parse(response.body)
+        end
+      rescue JSON::ParserError
+        {}
+      end
+
+      def upgrade_required_error(response)
+        payload = response_json(response)
+        minimum_version = payload["minimum_version"].to_s.strip
+        current_version = payload["current_version"].to_s.strip
+        upgrade_command = payload["upgrade_command"].to_s.strip
+
+        message = []
+
+        if current_version.empty?
+          message << "Your CLI is no longer supported."
+        else
+          message << "CLI #{current_version} is no longer supported."
+        end
+
+        if minimum_version.empty?
+          message << "Install the latest version."
+        else
+          message << "Minimum supported version is #{minimum_version}."
+        end
+
+        if upgrade_command.empty?
+          message << "Upgrade your CLI and try again."
+        else
+          message << "Run `#{upgrade_command}` and try again."
+        end
+
+        UpgradeRequiredError.new(message.join(" "))
+      end
   end
 end

data/lib/omaship/cli.rb

@@ -143,8 +143,7 @@ module Omaship
           say "Ships:"
           ships.each do |ship|
             marker = default_ship_match?(ship: ship, ship_reference: default_ship_reference) ? "*" : " "
-            app_url = ship["app_url"] || "-"
-            say "#{marker} #{ship.fetch("id")}  #{ship.fetch("full_name")}  #{ship.fetch("status")}  #{app_url}"
+            say "#{marker} #{ship.fetch("id")}  #{ship.fetch("display_name")}  #{ship.fetch("status")}  #{ship.fetch("primary_url", "-") || "-"}"
           end
 
           if !default_ship_reference.empty?
@@ -161,6 +160,7 @@ module Omaship
 
       Get available values with `omaship list`.
       Preferred format is full ship name (`org/repo`), for example `omaship/acme`.
+      Landing pages can also be selected by root domain, for example `acme.omaship.app`.
       Numeric ship ids from `omaship list` also work.
 
       Examples:
@@ -173,44 +173,49 @@ module Omaship
         ship = find_ship_by_reference(token: token, ship_reference: ship_reference)
         persist_default_ship(ship)
 
-        say "Default ship set to #{ship.fetch("full_name")}."
+        say "Default ship set to #{ship.fetch("reference")}."
       end
     end
 
     desc "info", "Show ship info"
-    method_option :ship, type: :string, desc: "Ship from `omaship list` (preferred: omaship/acme; id also works)"
+    method_option :ship, type: :string, desc: "Ship from `omaship list` (preferred: omaship/acme or acme.omaship.app; id also works)"
     def info
       with_api_error_handling(command: :info) do
         token = current_token
         client = build_api_client(token: token)
         resolved_ship = resolve_ship(token: token)
         ship = client.ship(ship_id: resolved_ship.fetch("id")).fetch("ship")
-        deploy = client.latest_deploy(ship_id: ship.fetch("id")).fetch("deploy")
         default_ship_reference = credentials.default_ship.to_s.strip
 
-        say "Ship: #{ship.fetch("full_name")}"
+        say "Ship: #{ship.fetch("display_name")}"
         say "ID: #{ship.fetch("id")}"
         say "Status: #{ship.fetch("status")}"
         say "App URL: #{ship["app_url"] || "-"}"
+        say "Landing URL: #{ship["landing_url"] || "-"}"
         say "Repo URL: #{ship["repo_url"] || "-"}"
         say "Default Ship: #{default_ship_reference.empty? ? "-" : default_ship_reference}"
-        say "Last Deploy: #{deploy_status_summary(deploy)}"
-        if deploy["run_number"]
-          say "Run: ##{deploy.fetch("run_number")}"
-        end
-        if deploy["started_at"]
-          say "Started At: #{deploy.fetch("started_at")}"
+
+        if ship.fetch("deployable")
+          deploy = client.latest_deploy(ship_id: ship.fetch("id")).fetch("deploy")
+
+          say "Last Deploy: #{deploy_status_summary(deploy)}"
+          if deploy["run_number"]
+            say "Run: ##{deploy.fetch("run_number")}"
+          end
+          if deploy["started_at"]
+            say "Started At: #{deploy.fetch("started_at")}"
+          end
         end
       end
     end
 
     desc "new NAME", "Create and provision a new ship"
     method_option :domain, type: :string, desc: "Root domain (defaults to NAME.com)"
-    method_option :skip_purpose, type: :boolean, default: false, desc: "Skip purpose profile questions"
     def new_ship(name)
       with_api_error_handling(command: :new_ship) do
         token = current_token
-        plan = fetch_plan(token: token)
+        auth = fetch_auth(token: token)
+        plan = auth.dig("user", "plan") || "free"
 
         if plan == "free"
           create_free_ship(name: name, token: token)
@@ -221,7 +226,7 @@ module Omaship
     end
 
     desc "deploy", "Deploy a ship (requires Full CLI access)"
-    method_option :ship, type: :string, desc: "Ship from `omaship list` (preferred: omaship/acme; id also works)"
+    method_option :ship, type: :string, desc: "Ship from `omaship list` (preferred: omaship/acme or acme.omaship.app; id also works)"
     def deploy
       with_api_error_handling(command: :deploy) do
         token = current_token
@@ -328,7 +333,7 @@ module Omaship
                 COMPREPLY=( $(compgen -W "--ship --host -h --help" -- "${cur}") )
                 ;;
               new)
-                COMPREPLY=( $(compgen -W "--domain --skip-purpose --host -h --help" -- "${cur}") )
+                COMPREPLY=( $(compgen -W "--domain --host -h --help" -- "${cur}") )
                 ;;
               complete)
                 COMPREPLY=( $(compgen -W "bash zsh fish" -- "${cur}") )
@@ -397,7 +402,7 @@ module Omaship
                     _arguments '--ship[Ship from omaship list]:ship:_omaship_ship_refs' '--host[API host]:host:'
                     ;;
                   new)
-                    _arguments '--domain[Root domain]:domain:' '--skip-purpose[Skip purpose questions]' '--host[API host]:host:' '1:name:'
+                    _arguments '--domain[Root domain]:domain:' '--host[API host]:host:' '1:name:'
                     ;;
                   complete)
                     _arguments '1:shell:(bash zsh fish)'
@@ -426,16 +431,14 @@ module Omaship
 
           complete -c omaship -n '__fish_seen_subcommand_from login' -l token -d 'API token from omaship settings'
           complete -c omaship -n '__fish_seen_subcommand_from new' -l domain -d 'Root domain'
-          complete -c omaship -n '__fish_seen_subcommand_from new' -l skip-purpose -d 'Skip purpose questions'
           complete -c omaship -n '__fish_seen_subcommand_from info status ship deploy' -l ship -d 'Ship from omaship list' -a '(__fish_omaship_ship_refs)'
           complete -c omaship -n '__fish_seen_subcommand_from use' -f -a '(__fish_omaship_ship_refs)'
           complete -c omaship -n '__fish_seen_subcommand_from complete' -f -a 'bash zsh fish'
         FISH
       end
 
-      def fetch_plan(token:)
-        auth = build_api_client(token: token).authenticate
-        auth.dig("user", "plan") || "free"
+      def fetch_auth(token:)
+        build_api_client(token: token).authenticate
       end
 
       def create_paid_ship(name:, token:)
@@ -460,17 +463,15 @@ module Omaship
         purpose_profile = {}
         color_scheme = "mono-dark"
 
-        unless options[:skip_purpose]
-          if ask_purpose_profile?
-            purpose_profile = collect_purpose_profile
-          end
-          color_scheme = pick_color_scheme
+        if ask_purpose_profile?
+          purpose_profile = collect_purpose_profile
         end
+        color_scheme = pick_color_scheme
 
         say
         progress_renderer.step("Creating your landing page...")
 
-        payload = build_api_client(token: token).create_landing_page(
+        payload = build_api_client(token: token).create_landingpage(
           name: name,
           color_scheme: color_scheme,
           purpose_profile: purpose_profile
@@ -614,7 +615,7 @@ module Omaship
         if ship
           ship
         else
-          raise Thor::Error, "Unknown ship `#{ship_reference}`. Run `omaship list` and use the full ship name (for example: `omaship use omaship/acme`) or the numeric id."
+          raise Thor::Error, "Unknown ship `#{ship_reference}`. Run `omaship list` and use a ship name or root domain from the list, or the numeric id."
         end
       end
 
@@ -625,11 +626,11 @@ module Omaship
       end
 
       def default_ship_match?(ship:, ship_reference:)
-        ship.fetch("id").to_s == ship_reference || ship.fetch("full_name") == ship_reference
+        ship.fetch("id").to_s == ship_reference || ship.fetch("reference") == ship_reference
       end
 
       def persist_default_ship(ship)
-        credentials.write_default_ship(ship.fetch("full_name"))
+        credentials.write_default_ship(ship.fetch("reference"))
       end
 
       def resolve_ship_for_deploy(token:)
@@ -651,7 +652,7 @@ module Omaship
       end
 
       def multiple_ships_message
-        "Multiple ships found. Run `omaship list` and `omaship use <org/repo>` (or a ship id)."
+        "Multiple ships found. Run `omaship list` and `omaship use <ship-from-list>` (or a ship id)."
       end
 
       def with_api_error_handling(command:)
@@ -665,7 +666,9 @@ module Omaship
       end
 
       def permission_denied_message(command:)
-        if command == :new_ship
+        if current_access_level == "onboarding"
+          "This onboarding token only supports `omaship new` while you create your first ship. Create a full-access token in Settings after onboarding to use other CLI commands."
+        elsif command == :new_ship
           "`omaship new` requires a full-access token. Create a token with Full CLI access and run `omaship login` again."
         elsif command == :deploy
           "`omaship deploy` requires a full-access token. Create a token with Full CLI access and run `omaship login` again."
@@ -674,6 +677,15 @@ module Omaship
         end
       end
 
+      def current_access_level
+        token = credentials.token
+        return "unknown" if token.to_s.strip.empty?
+
+        build_api_client(token: token).authenticate.dig("token", "access_level").to_s
+      rescue NoMethodError, Omaship::ApiClient::Error
+        "unknown"
+      end
+
       def build_api_client(token:)
         Omaship::ApiClient.new(host: resolved_host, token: token)
       end

data/lib/omaship/version.rb

@@ -1,3 +1,3 @@
 module Omaship
-  VERSION = "0.4.0".freeze
+  VERSION = "0.5.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omaship
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Omaship
@@ -91,7 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Omaship command-line interface
 test_files: []