omaship 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 17a560c4acd3fcb2a3ddc1f2dc878d7fa3a3bfce501821cd9ad2a0aaf6b5a0f8
+  data.tar.gz: e07f76c6417e4714473a5a699c3b3169e4934d3d5b38df61ca742d17a25fa786
+SHA512:
+  metadata.gz: 8d0724a6d3f68a050d3f24bb131c4ff17965f6d992d8555288afbadb5472a6f7116c3c196d5179258fbb8214a1057e9c2fac73fcb8d110a67b5c25243538f705
+  data.tar.gz: de10cb82315db0621c4b612477391c20344535de035652d9374bbac0f3e6b60f78a9d4f4e2e7b26871e3232d26b7325d4df1e5c8cc617f742ca9814c371fb165

data/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## [0.2.1](https://github.com/bloomedai/omaship/compare/omaship/v0.2.0...omaship/v0.2.1) (2026-03-06)
+
+
+### Bug Fixes
+
+* 🐛 enable trusted publishing for cli gem publish ([9e5a9ff](https://github.com/bloomedai/omaship/commit/9e5a9ff1c529a89a323db4b71282deb787251a3c))
+
+## [0.2.0](https://github.com/bloomedai/omaship/compare/omaship-v0.1.0...omaship/v0.2.0) (2026-03-06)
+
+
+### Features
+
+* ✨ ship cli auth mvp, consent controls, and provisioning hardening ([e8b2fd0](https://github.com/bloomedai/omaship/commit/e8b2fd0f9e06e746886a666e7f1a7bd247ac1e35))
+
+
+### Code Refactoring
+
+* ♻️ migrate CLAUDE.md references to AGENTS.md across codebase ([1d2323c](https://github.com/bloomedai/omaship/commit/1d2323c0b20e5cc255ca71c412bb0ad30431e75a))
+* ♻️ Rename Project → Ship + add Infrastructure model [skip preview] ([#201](https://github.com/bloomedai/omaship/issues/201)) ([6541804](https://github.com/bloomedai/omaship/commit/65418042f501f350ea14a57234108872222c93c5))
+
+
+### Documentation
+
+* 📝 update readmes for local proxy fallback and deploy workflows ([1683d5e](https://github.com/bloomedai/omaship/commit/1683d5ed801428c75a49d82b5745d85e4493e365))
+
+## [0.1.0] - 2026-03-04
+
+- Initial public CLI packaging as the `omaship` gem.
+- Added Thor-based commands for `login`, `new`, `configure`, `deploy`, and `whoami`.
+- Added credentials storage and API client support for `/api/v1/cli`.

data/README.md

@@ -0,0 +1,140 @@
+# Omaship CLI
+
+## Install
+
+RubyGems:
+
+```bash
+gem install omaship
+```
+
+Homebrew:
+
+```bash
+brew tap bloomedai/homebrew-tap
+brew install omaship
+```
+
+## Quick Start
+
+```bash
+omaship login --token <token> --host https://build.omaship.com
+omaship list
+omaship use <ship-ref>
+omaship info
+```
+
+Examples for `SHIP_REF` (from `omaship list` output):
+
+```bash
+omaship use omaship/acme
+omaship use 17
+```
+
+## Ship Selection
+
+`info`, `configure`, and `deploy` resolve the target ship in this order:
+
+1. `--ship <ship-ref>`
+2. saved default from `omaship use <ship-ref>`
+3. if exactly one accessible ship exists: auto-select it and persist it as default
+4. otherwise: command fails and asks you to run `omaship list` + `omaship use ...`
+
+Preferred ship reference format is full ship name (`org/repo`).
+Numeric ids are also accepted.
+
+## Commands
+
+- `omaship login --token <token>`
+- `omaship whoami`
+- `omaship list`
+- `omaship use <ship-ref>`
+- `omaship info [--ship <ship-ref>]` (`status` and `ship` are aliases)
+- `omaship new <name>` (requires Full CLI access)
+- `omaship configure --payments <provider> [--ship <ship-ref>]` (requires Full CLI access)
+- `omaship deploy [--ship <ship-ref>]` (requires Full CLI access)
+- `omaship complete <bash|zsh|fish>` (print shell completion script)
+- `omaship logout`
+
+## Local Development Provisioning
+
+When you run `omaship new <name>` against local Omaship development (`OMASHIP_HOST=http://localhost:3000`), provisioning 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`.
+
+## Shell Completion
+
+Bash:
+
+```bash
+mkdir -p ~/.local/share/bash-completion/completions
+omaship complete bash > ~/.local/share/bash-completion/completions/omaship
+```
+
+Zsh:
+
+```bash
+mkdir -p ~/.zfunc
+omaship complete zsh > ~/.zfunc/_omaship
+```
+
+Then ensure `~/.zfunc` is in `fpath` and reload completions:
+
+```bash
+autoload -Uz compinit
+compinit
+```
+
+Fish:
+
+```bash
+mkdir -p ~/.config/fish/completions
+omaship complete fish > ~/.config/fish/completions/omaship.fish
+```
+
+## Environment
+
+- `OMASHIP_HOST` (default: `http://localhost:3000`)
+- `OMASHIP_TOKEN` (optional alternative for `login`)
+
+## Credentials
+
+- Stored at `~/.config/omaship/credentials.json`
+- File mode is `0600`
+- Includes host, token, user, and optional `default_ship`
+
+## Local Development
+
+Run from repository root:
+
+```bash
+mise exec ruby@4.0.1 -- 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}" }'
+```
+
+## Release Automation
+
+CLI releases are created by `release-please` (`omaship/v*` tags).
+
+Required repository secrets:
+
+- `RELEASE_PLEASE_PAT`
+- `HOMEBREW_TAP_GITHUB_TOKEN` (must have push access to the tap repository)
+
+Optional repository variable:
+
+- `HOMEBREW_TAP_REPOSITORY` (default: `bloomedai/homebrew-tap`)
+
+RubyGems publish uses Trusted Publishing via GitHub OIDC.
+
+Configure a trusted publisher for gem `omaship`:
+
+- repository owner: `bloomedai`
+- repository name: `omaship`
+- workflow filename: `publish-gem.yml`

data/bin/omaship

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+require "omaship"
+
+begin
+  Omaship::CLI.start(ARGV)
+rescue StandardError => error
+  warn error.message
+  exit 1
+end

data/lib/omaship/api_client.rb

@@ -0,0 +1,89 @@
+require "faraday"
+require "faraday/retry"
+require "json"
+
+module Omaship
+  class ApiClient
+    class Error < StandardError; end
+    class UnauthorizedError < Error; end
+    class PermissionDeniedError < Error; end
+    class NotFoundError < Error; end
+
+    def initialize(host:, token:)
+      @host = host.to_s
+      @token = token.to_s
+    end
+
+    def authenticate
+      get_json("/api/v1/cli/auth")
+    end
+
+    def list_ships
+      get_json("/api/v1/cli/ships").fetch("ships")
+    end
+
+    def create_ship(root_domain:, visibility: "private")
+      post_json("/api/v1/cli/ships", { ship: { root_domain: root_domain, visibility: visibility } })
+    end
+
+    def ship(ship_id:)
+      get_json("/api/v1/cli/ships/#{ship_id}")
+    end
+
+    def ship_logs(ship_id:)
+      get_json("/api/v1/cli/ships/#{ship_id}/logs")
+    end
+
+    def create_configuration(ship_id:, package:)
+      post_json("/api/v1/cli/ships/#{ship_id}/configurations", { configuration: { package: package } })
+    end
+
+    def create_deploy(ship_id:)
+      post_json("/api/v1/cli/ships/#{ship_id}/deploys", {})
+    end
+
+    def latest_deploy(ship_id:)
+      get_json("/api/v1/cli/ships/#{ship_id}/deploys/latest")
+    end
+
+    private
+      def get_json(path)
+        parse_response(connection.get(path))
+      end
+
+      def post_json(path, payload)
+        parse_response(connection.post(path) do |request|
+          request.body = JSON.dump(payload)
+          request.headers["Content-Type"] = "application/json"
+        end)
+      end
+
+      def parse_response(response)
+        case response.status
+        when 200..299
+          if response.body.to_s.empty?
+            {}
+          else
+            JSON.parse(response.body)
+          end
+        when 401
+          raise UnauthorizedError, "Unauthorized"
+        when 403
+          raise PermissionDeniedError, "Forbidden"
+        when 404
+          raise NotFoundError, "Not found"
+        else
+          raise Error, "Request failed (#{response.status}): #{response.body}"
+        end
+      end
+
+      def connection
+        @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"
+        end
+      end
+  end
+end

data/lib/omaship/cli.rb

@@ -0,0 +1,700 @@
+require "thor"
+
+module Omaship
+  class CLI < Thor
+    map "new" => :new_ship
+    map "status" => :info
+    map "ship" => :info
+
+    class_option :host, type: :string, desc: "API host"
+
+    def self.exit_on_failure?
+      true
+    end
+
+    def self.start(given_args = ARGV, config = {})
+      normalized_args = normalize_help_args(given_args)
+      super(normalized_args, config)
+    end
+
+    def self.normalize_help_args(given_args)
+      args = given_args.dup
+
+      if root_help_requested?(args)
+        []
+      else
+        help_flag_index = args.index("-h") || args.index("--help")
+        if help_flag_index
+          [ "help", args.first ]
+        else
+          args
+        end
+      end
+    end
+
+    def self.root_help_requested?(args)
+      args == [ "-h" ] || args == [ "--help" ] || args == [ "help" ]
+    end
+
+    def self.help(shell, subcommand = false)
+      if subcommand
+        super
+      else
+        shell.say "Usage:"
+        shell.say "  omaship COMMAND [options]"
+        shell.say
+        shell.say "You must specify a command. The most common commands are:"
+        shell.say
+        shell.say "  login      Store API token credentials locally"
+        shell.say "  whoami     Show authenticated user"
+        shell.say "  list       List ships you can access"
+        shell.say "  use        Set default ship from `omaship list` (for example: `omaship use omaship/acme`)"
+        shell.say "  info       Show details for a ship (aliases: ship, status)"
+        shell.say "  new        Create and provision a new ship"
+        shell.say "  configure  Configure a ship (requires Full CLI access)"
+        shell.say "  deploy     Deploy a ship (requires Full CLI access)"
+        shell.say "  complete   Print shell completion script (bash, zsh, fish)"
+        shell.say "  logout     Remove local CLI credentials"
+        shell.say
+        shell.say "Global options:"
+        shell.say "  --host=HOST  API host"
+        shell.say
+        shell.say "All commands can be run with -h (or --help) for more information."
+      end
+    end
+
+    desc "login", "Store API token credentials locally"
+    method_option :token, type: :string, desc: "API token from omaship settings"
+    def login
+      token = options[:token] || ENV["OMASHIP_TOKEN"] || ask("API token:", echo: false)
+      if token.to_s.strip.empty?
+        raise Thor::Error, "Missing API token. Pass --token or set OMASHIP_TOKEN."
+      end
+
+      user_payload = build_api_client(token: token).authenticate.fetch("user")
+      credentials.write(
+        host: resolved_host,
+        token: token,
+        user: user_payload
+      )
+
+      say "Logged in as #{user_payload.fetch("email_address")}"
+      say "Credentials saved to #{credentials.path}"
+    rescue Omaship::ApiClient::UnauthorizedError
+      message = "Authentication failed. Check your API token. #{existing_credentials_status_message}"
+      raise Thor::Error, message
+    rescue Omaship::ApiClient::Error => error
+      raise Thor::Error, error.message
+    end
+
+    desc "logout", "Remove local CLI credentials"
+    def logout
+      credentials.clear
+      say "Logged out."
+    end
+
+    desc "whoami", "Show authenticated user"
+    def whoami
+      with_api_error_handling(command: :whoami) do
+        token = current_token
+        client = build_api_client(token: token)
+        auth_payload = client.authenticate
+        user_payload = auth_payload.fetch("user")
+        account_payload = auth_payload.fetch("account", {})
+        token_payload = auth_payload.fetch("token", {})
+        ship_count = account_payload.fetch("ship_count", 0).to_i
+        orgs = normalize_orgs(account_payload["orgs"])
+        access_level = token_payload.fetch("access_level", "unknown").to_s.strip
+        if access_level.empty?
+          access_level = "unknown"
+        end
+        default_ship_reference = credentials.default_ship.to_s.strip
+
+        say "User: #{user_payload.fetch("email_address")}"
+        say "Host: #{resolved_host}"
+        say "Access: #{access_level}"
+        say "Ships: #{ship_count}"
+        if ship_count.zero?
+          say "Orgs: none (no ships yet)"
+        elsif orgs.empty?
+          say "Orgs: unavailable"
+        else
+          say "Orgs: #{orgs.join(", ")}"
+        end
+
+        if default_ship_reference.empty?
+          say "Default Ship: -"
+        else
+          say "Default Ship: #{default_ship_reference}"
+        end
+      end
+    end
+
+    desc "list", "List ships you can access"
+    def list
+      with_api_error_handling(command: :list) do
+        token = current_token
+        ships = build_api_client(token: token).list_ships
+        default_ship_reference = credentials.default_ship.to_s.strip
+
+        if ships.empty?
+          say "No ships available yet."
+        else
+          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}"
+          end
+
+          if !default_ship_reference.empty?
+            say
+            say "* default ship: #{default_ship_reference}"
+          end
+        end
+      end
+    end
+
+    desc "use SHIP", "Set default ship from `omaship list`"
+    long_desc <<~DESC
+      Set the default ship used by commands when `--ship` is omitted.
+
+      Get available values with `omaship list`.
+      Preferred format is full ship name (`org/repo`), for example `omaship/acme`.
+      Numeric ship ids from `omaship list` also work.
+
+      Examples:
+        omaship use omaship/acme
+        omaship use 17
+    DESC
+    def use(ship_reference)
+      with_api_error_handling(command: :use) do
+        token = current_token
+        ship = find_ship_by_reference(token: token, ship_reference: ship_reference)
+        persist_default_ship(ship)
+
+        say "Default ship set to #{ship.fetch("full_name")}."
+      end
+    end
+
+    desc "info", "Show ship info"
+    method_option :ship, type: :string, desc: "Ship from `omaship list` (preferred: omaship/acme; 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 "ID: #{ship.fetch("id")}"
+        say "Status: #{ship.fetch("status")}"
+        say "App URL: #{ship["app_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")}"
+        end
+      end
+    end
+
+    desc "new NAME", "Create and provision a new ship"
+    method_option :domain, type: :string, desc: "Root domain (defaults to NAME.com)"
+    def new_ship(name)
+      with_api_error_handling(command: :new_ship) do
+        token = current_token
+        root_domain = options[:domain] || "#{name}.com"
+        payload = build_api_client(token: token).create_ship(root_domain: root_domain)
+        ship = payload.fetch("ship")
+
+        progress_renderer.step("Setting up your codebase")
+        final_ship = poll_until_terminal(ship_id: ship.fetch("id"), token: token)
+
+        if final_ship.fetch("status") == "live"
+          progress_renderer.step("Ready. Customers can sign up and pay at #{final_ship.fetch("root_domain")}")
+        else
+          message = final_ship["error_message"] || "Provisioning failed"
+          raise Thor::Error, message
+        end
+      end
+    end
+
+    desc "configure --payments PROVIDER", "Configure a ship"
+    method_option :payments, type: :string, required: true
+    method_option :ship, type: :string, desc: "Ship from `omaship list` (preferred: omaship/acme; id also works)"
+    def configure
+      with_api_error_handling(command: :configure) do
+        payments_provider = options[:payments].to_s.strip.downcase
+
+        token = current_token
+        ship = resolve_ship(token: token)
+        build_api_client(token: token).create_configuration(ship_id: ship.fetch("id"), package: payments_provider)
+
+        progress_renderer.step("Configuration queued.")
+
+        poll_until_configuration_complete(ship_id: ship.fetch("id"), token: token)
+        progress_renderer.step("Configuration applied.")
+      end
+    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)"
+    def deploy
+      with_api_error_handling(command: :deploy) do
+        token = current_token
+        ship = resolve_ship_for_deploy(token: token)
+        ship_name = ship.fetch("full_name", "##{ship.fetch("id")}")
+
+        progress_renderer.step("Target ship: #{ship_name}.")
+
+        build_api_client(token: token).create_deploy(ship_id: ship.fetch("id"))
+        progress_renderer.step("Deploy requested.")
+
+        poll_until_deploy_finished(ship_id: ship.fetch("id"), token: token)
+      end
+    end
+
+    desc "complete SHELL", "Print shell completion script (bash, zsh, fish)"
+    long_desc <<~DESC
+      Print a shell completion script to stdout.
+
+      Supported shells:
+        bash
+        zsh
+        fish
+
+      Examples:
+        omaship complete bash
+        omaship complete zsh
+        omaship complete fish
+    DESC
+    def complete(shell_name)
+      normalized_shell = shell_name.to_s.strip.downcase
+      script = completion_script_for(shell: normalized_shell)
+      say script
+    end
+
+    private
+      def completion_script_for(shell:)
+        if shell == "bash"
+          bash_completion_script
+        elsif shell == "zsh"
+          zsh_completion_script
+        elsif shell == "fish"
+          fish_completion_script
+        else
+          raise Thor::Error, "Unsupported shell `#{shell}`. Supported shells: bash, zsh, fish."
+        end
+      end
+
+      def bash_completion_script
+        <<~BASH
+          _omaship() {
+            local cur prev command
+            COMPREPLY=()
+            cur="${COMP_WORDS[COMP_CWORD]}"
+            prev=""
+            command="${COMP_WORDS[1]}"
+
+            if [[ ${COMP_CWORD} -gt 0 ]]; then
+              prev="${COMP_WORDS[COMP_CWORD-1]}"
+            fi
+
+            if [[ ${COMP_CWORD} -eq 1 ]]; then
+              COMPREPLY=( $(compgen -W "login whoami list use info status ship new configure deploy logout complete help" -- "${cur}") )
+              return 0
+            fi
+
+            if [[ "${prev}" == "complete" ]]; then
+              COMPREPLY=( $(compgen -W "bash zsh fish" -- "${cur}") )
+              return 0
+            fi
+
+            if [[ "${prev}" == "--payments" ]]; then
+              COMPREPLY=( $(compgen -W "stripe" -- "${cur}") )
+              return 0
+            fi
+
+            if [[ "${prev}" == "--ship" ]]; then
+              COMPREPLY=( $(compgen -W "$(omaship list 2>/dev/null | awk '/^[* ] [0-9]+  / { print $3 }')" -- "${cur}") )
+              return 0
+            fi
+
+            if [[ "${command}" == "use" && ${COMP_CWORD} -eq 2 ]]; then
+              COMPREPLY=( $(compgen -W "$(omaship list 2>/dev/null | awk '/^[* ] [0-9]+  / { print $3 }')" -- "${cur}") )
+              return 0
+            fi
+
+            case "${command}" in
+              login)
+                COMPREPLY=( $(compgen -W "--token --host -h --help" -- "${cur}") )
+                ;;
+              whoami|list|logout)
+                COMPREPLY=( $(compgen -W "--host -h --help" -- "${cur}") )
+                ;;
+              use)
+                COMPREPLY=( $(compgen -W "--host -h --help" -- "${cur}") )
+                ;;
+              info|status|ship|deploy)
+                COMPREPLY=( $(compgen -W "--ship --host -h --help" -- "${cur}") )
+                ;;
+              new)
+                COMPREPLY=( $(compgen -W "--domain --host -h --help" -- "${cur}") )
+                ;;
+              configure)
+                COMPREPLY=( $(compgen -W "--payments --ship --host -h --help" -- "${cur}") )
+                ;;
+              complete)
+                COMPREPLY=( $(compgen -W "bash zsh fish" -- "${cur}") )
+                ;;
+              *)
+                COMPREPLY=( $(compgen -W "--host -h --help" -- "${cur}") )
+                ;;
+            esac
+          }
+
+          complete -o default -F _omaship omaship
+        BASH
+      end
+
+      def zsh_completion_script
+        <<~ZSH
+          #compdef omaship
+
+          _omaship_ship_refs() {
+            local -a refs
+            refs=(${(f)"$(omaship list 2>/dev/null | awk '/^[* ] [0-9]+  / { print $3 }')"})
+            _describe 'ship' refs
+          }
+
+          _omaship() {
+            local context state line
+            local -a commands
+
+            commands=(
+              'login:Store API token credentials locally'
+              'whoami:Show authenticated user'
+              'list:List ships you can access'
+              'use:Set default ship from omaship list'
+              'info:Show ship info'
+              'status:Alias for info'
+              'ship:Alias for info'
+              'new:Create and provision a new ship'
+              'configure:Configure a ship'
+              'deploy:Deploy a ship'
+              'logout:Remove local CLI credentials'
+              'complete:Print shell completion script'
+              'help:Describe available commands'
+            )
+
+            _arguments -C \
+              '--host[API host]:host:' \
+              '1:command:->command' \
+              '*::arg:->args'
+
+            case $state in
+              command)
+                _describe -t commands 'command' commands
+                ;;
+              args)
+                case $line[1] in
+                  login)
+                    _arguments '--token[API token from omaship settings]:token:' '--host[API host]:host:'
+                    ;;
+                  whoami|list|logout)
+                    _arguments '--host[API host]:host:'
+                    ;;
+                  use)
+                    _arguments '--host[API host]:host:' '1:ship reference:_omaship_ship_refs'
+                    ;;
+                  info|status|ship|deploy)
+                    _arguments '--ship[Ship from omaship list]:ship:_omaship_ship_refs' '--host[API host]:host:'
+                    ;;
+                  new)
+                    _arguments '--domain[Root domain]:domain:' '--host[API host]:host:' '1:name:'
+                    ;;
+                  configure)
+                    _arguments '--payments[Payments provider]:provider:(stripe)' '--ship[Ship from omaship list]:ship:_omaship_ship_refs' '--host[API host]:host:'
+                    ;;
+                  complete)
+                    _arguments '1:shell:(bash zsh fish)'
+                    ;;
+                  *)
+                    _arguments '--host[API host]:host:'
+                    ;;
+                esac
+                ;;
+            esac
+          }
+
+          compdef _omaship omaship
+        ZSH
+      end
+
+      def fish_completion_script
+        <<~FISH
+          function __fish_omaship_ship_refs
+            omaship list 2>/dev/null | awk '/^[* ] [0-9]+  / { print $3 }'
+          end
+
+          complete -c omaship -f
+          complete -c omaship -n '__fish_use_subcommand' -a 'login whoami list use info status ship new configure deploy logout complete help'
+          complete -c omaship -l host -d 'API host'
+
+          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 configure' -l payments -d 'Payments provider' -a 'stripe'
+          complete -c omaship -n '__fish_seen_subcommand_from configure' -l ship -d 'Ship from omaship list' -a '(__fish_omaship_ship_refs)'
+          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 current_token
+        value = credentials.token
+        if value.to_s.strip.empty?
+          raise Thor::Error, "Not logged in. Run `omaship login` first."
+        end
+        value
+      end
+
+      def resolve_ship(token:)
+        requested_ship_reference = options[:ship].to_s.strip
+
+        if requested_ship_reference.empty?
+          resolve_ship_without_explicit_selection(token: token)
+        else
+          find_ship_by_reference(token: token, ship_reference: requested_ship_reference)
+        end
+      end
+
+      def resolve_ship_without_explicit_selection(token:)
+        ships = build_api_client(token: token).list_ships
+        default_ship_reference = credentials.default_ship.to_s.strip
+
+        if !default_ship_reference.empty?
+          default_ship = match_ship(ships: ships, ship_reference: default_ship_reference)
+
+          if default_ship
+            return default_ship
+          else
+            credentials.clear_default_ship
+          end
+        end
+
+        if ships.empty?
+          raise Thor::Error, no_ships_message
+        elsif ships.one?
+          ship = ships.first
+          persist_default_ship(ship)
+          ship
+        else
+          raise Thor::Error, multiple_ships_message
+        end
+      end
+
+      def find_ship_by_reference(token:, ship_reference:)
+        ships = build_api_client(token: token).list_ships
+        ship = match_ship(ships: ships, ship_reference: ship_reference)
+
+        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."
+        end
+      end
+
+      def match_ship(ships:, ship_reference:)
+        ships.find do |ship|
+          default_ship_match?(ship: ship, ship_reference: ship_reference)
+        end
+      end
+
+      def default_ship_match?(ship:, ship_reference:)
+        ship.fetch("id").to_s == ship_reference || ship.fetch("full_name") == ship_reference
+      end
+
+      def persist_default_ship(ship)
+        credentials.write_default_ship(ship.fetch("full_name"))
+      end
+
+      def resolve_ship_for_deploy(token:)
+        resolve_ship(token: token)
+      rescue Thor::Error => error
+        if options[:ship].to_s.strip.empty? && selection_error_message?(error.message)
+          raise Thor::Error, "#{error.message} `omaship deploy` also requires a full-access token."
+        end
+
+        raise
+      end
+
+      def selection_error_message?(message)
+        message == no_ships_message || message == multiple_ships_message
+      end
+
+      def no_ships_message
+        "No ships available yet. Run `omaship new <name>` first."
+      end
+
+      def multiple_ships_message
+        "Multiple ships found. Run `omaship list` and `omaship use <org/repo>` (or a ship id)."
+      end
+
+      def with_api_error_handling(command:)
+        yield
+      rescue Omaship::ApiClient::UnauthorizedError
+        raise Thor::Error, "Authentication failed. Check your API token and run `omaship login` again."
+      rescue Omaship::ApiClient::PermissionDeniedError
+        raise Thor::Error, permission_denied_message(command: command)
+      rescue Omaship::ApiClient::Error => error
+        raise Thor::Error, error.message
+      end
+
+      def permission_denied_message(command:)
+        if command == :new_ship
+          "`omaship new` requires a full-access token. Create a token with Full CLI access and run `omaship login` again."
+        elsif command == :configure
+          "`omaship configure` 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."
+        else
+          "Permission denied for this action. Check your token scopes and run `omaship login` again."
+        end
+      end
+
+      def build_api_client(token:)
+        Omaship::ApiClient.new(host: resolved_host, token: token)
+      end
+
+      def credentials
+        @credentials ||= Omaship::Credentials.new
+      end
+
+      def progress_renderer
+        @progress_renderer ||= Omaship::ProgressRenderer.new(out: $stdout)
+      end
+
+      def emit_logs(log_entries)
+        log_entries.each do |entry|
+          message = entry.fetch("message")
+          progress_renderer.step(message)
+        end
+      end
+
+      def poll_until_terminal(ship_id:, token:)
+        client = build_api_client(token: token)
+        last_log_id = 0
+        90.times do
+          ship_payload = client.ship(ship_id: ship_id).fetch("ship")
+          logs_payload = client.ship_logs(ship_id: ship_id)
+          logs = logs_payload.fetch("logs").select { |entry| entry.fetch("id") > last_log_id }
+          if logs.any?
+            last_log_id = logs.last.fetch("id")
+          end
+
+          emit_logs(logs)
+          status = ship_payload.fetch("status")
+          if %w[live error].include?(status)
+            return ship_payload
+          end
+          sleep 2
+        end
+
+        raise Thor::Error, "Provisioning timed out."
+      end
+
+      def poll_until_configuration_complete(ship_id:, token:)
+        client = build_api_client(token: token)
+        60.times do
+          ship_payload = client.ship(ship_id: ship_id).fetch("ship")
+          pending = ship_payload.fetch("package_update_pending")
+          if pending
+            progress_renderer.step("Applying configuration changes.")
+            sleep 2
+          else
+            error_message = ship_payload["error_message"].to_s.strip
+            if error_message.empty?
+              return
+            end
+
+            raise Thor::Error, error_message
+          end
+        end
+
+        raise Thor::Error, "Configuration timed out."
+      end
+
+      def poll_until_deploy_finished(ship_id:, token:)
+        client = build_api_client(token: token)
+        last_status = nil
+        90.times do
+          deploy_payload = client.latest_deploy(ship_id: ship_id).fetch("deploy")
+          status = deploy_payload.fetch("status")
+          conclusion = deploy_payload["conclusion"]
+          if status != last_status
+            emit_deploy_status(status: status)
+            last_status = status
+          end
+
+          if status == "completed"
+            if conclusion == "success"
+              progress_renderer.step("Live. 34 seconds, zero downtime.")
+              return
+            end
+            raise Thor::Error, "Deploy failed with conclusion: #{conclusion || 'unknown'}"
+          end
+
+          sleep 2
+        end
+
+        raise Thor::Error, "Deploy timed out."
+      end
+
+      def deploy_status_summary(deploy_payload)
+        status = deploy_payload.fetch("status")
+        conclusion = deploy_payload["conclusion"].to_s.strip
+
+        if conclusion.empty?
+          status
+        else
+          "#{status} (#{conclusion})"
+        end
+      end
+
+      def emit_deploy_status(status:)
+        if status == "not_found"
+          progress_renderer.step("Waiting for deploy workflow run.")
+        elsif %w[queued requested waiting pending].include?(status)
+          progress_renderer.step("Deploy queued.")
+        elsif status == "in_progress"
+          progress_renderer.step("Deploy in progress.")
+        elsif status != "completed"
+          progress_renderer.step("Deploy status: #{status}.")
+        end
+      end
+
+      def resolved_host
+        options[:host] || credentials.host || ENV["OMASHIP_HOST"] || "http://localhost:3000"
+      end
+
+      def existing_credentials_status_message
+        saved_email = credentials.read.dig("user", "email_address").to_s.strip
+        if saved_email.empty?
+          "No local credentials were changed."
+        else
+          "Existing login kept for #{saved_email}."
+        end
+      end
+
+      def normalize_orgs(orgs)
+        Array(orgs).map(&:to_s).map(&:strip).reject(&:empty?).uniq.sort
+      end
+  end
+end

data/lib/omaship/credentials.rb

@@ -0,0 +1,78 @@
+require "json"
+require "fileutils"
+
+module Omaship
+  class Credentials
+    DEFAULT_PATH = File.join(Dir.home, ".config", "omaship", "credentials.json")
+
+    def initialize(path: DEFAULT_PATH)
+      @path = path
+    end
+
+    attr_reader :path
+
+    def write(host:, token:, user:)
+      payload = read
+      payload["version"] = 1
+      payload["host"] = host
+      payload["token"] = token
+      payload["user"] = user
+
+      write_payload(payload)
+    end
+
+    def read
+      return {} unless File.exist?(@path)
+
+      JSON.parse(File.read(@path))
+    rescue JSON::ParserError
+      {}
+    end
+
+    def token
+      read["token"]
+    end
+
+    def host
+      read["host"]
+    end
+
+    def default_ship
+      read["default_ship"]
+    end
+
+    def write_default_ship(ship_reference)
+      payload = read
+      payload["version"] = 1
+      payload["default_ship"] = ship_reference
+
+      write_payload(payload)
+    end
+
+    def clear_default_ship
+      payload = read
+      payload.delete("default_ship")
+      write_payload(payload)
+    end
+
+    def clear
+      File.delete(@path) if File.exist?(@path)
+    end
+
+    private
+      def write_payload(payload)
+        ensure_parent_directory
+        tmp_path = "#{@path}.tmp"
+        File.write(tmp_path, JSON.pretty_generate(payload) + "\n")
+        File.chmod(0o600, tmp_path)
+        FileUtils.mv(tmp_path, @path)
+        File.chmod(0o600, @path)
+      end
+
+      def ensure_parent_directory
+        directory = File.dirname(@path)
+        FileUtils.mkdir_p(directory)
+        File.chmod(0o700, directory)
+      end
+  end
+end

data/lib/omaship/progress_renderer.rb

@@ -0,0 +1,15 @@
+module Omaship
+  class ProgressRenderer
+    def initialize(out:)
+      @out = out
+      @seen = {}
+    end
+
+    def step(message)
+      return if @seen[message]
+
+      @seen[message] = true
+      @out.puts message
+    end
+  end
+end

data/lib/omaship/ship_detector.rb

@@ -0,0 +1,47 @@
+require "open3"
+
+module Omaship
+  class ShipDetector
+    class DetectionError < StandardError; end
+    SHIP_CONTEXT_ERROR_MESSAGE = "Could not determine which ship to use automatically. Pass --ship <org/repo> (or ship id) to choose a ship.".freeze
+
+    def initialize(api_client:)
+      @api_client = api_client
+    end
+
+    def detect_current_ship
+      remote = git_remote_url
+      full_name = parse_full_name(remote)
+      ships = @api_client.list_ships
+      match = ships.find { |ship| ship.fetch("full_name") == full_name }
+
+      if match
+        match
+      else
+        raise DetectionError, SHIP_CONTEXT_ERROR_MESSAGE
+      end
+    end
+
+    private
+      def git_remote_url
+        stdout, stderr, status = Open3.capture3("git", "remote", "get-url", "origin")
+        unless status.success?
+          raise DetectionError, SHIP_CONTEXT_ERROR_MESSAGE
+        end
+
+        stdout.strip
+      end
+
+      def parse_full_name(remote_url)
+        if remote_url.match?(/\Agit@github\.com:/)
+          remote_url.sub(/\Agit@github\.com:/, "").sub(/\.git\z/, "")
+        elsif remote_url.match?(/\Ahttps:\/\/github\.com\//)
+          remote_url.sub(/\Ahttps:\/\/github\.com\//, "").sub(/\.git\z/, "")
+        elsif remote_url.match?(/\Ahttps:\/\/[^@]+@github\.com\//)
+          remote_url.sub(/\Ahttps:\/\/[^@]+@github\.com\//, "").sub(/\.git\z/, "")
+        else
+          raise DetectionError, SHIP_CONTEXT_ERROR_MESSAGE
+        end
+      end
+  end
+end

data/lib/omaship/version.rb

@@ -0,0 +1,3 @@
+module Omaship
+  VERSION = "0.2.1".freeze
+end

data/lib/omaship.rb

@@ -0,0 +1,9 @@
+module Omaship
+end
+
+require_relative "omaship/version"
+require_relative "omaship/api_client"
+require_relative "omaship/credentials"
+require_relative "omaship/progress_renderer"
+require_relative "omaship/ship_detector"
+require_relative "omaship/cli"

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: omaship
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- Omaship
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: CLI for login, ship provisioning, configuration, and deploy operations
+  against Omaship.
+email:
+- hello@omaship.com
+executables:
+- omaship
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- bin/omaship
+- lib/omaship.rb
+- lib/omaship/api_client.rb
+- lib/omaship/cli.rb
+- lib/omaship/credentials.rb
+- lib/omaship/progress_renderer.rb
+- lib/omaship/ship_detector.rb
+- lib/omaship/version.rb
+homepage: https://omaship.com
+licenses:
+- Nonstandard
+metadata:
+  homepage_uri: https://omaship.com
+  source_code_uri: https://github.com/bloomedai/omaship
+  changelog_uri: https://github.com/bloomedai/omaship/blob/main/cli/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Omaship command-line interface
+test_files: []