space-architect 8.0.0 → 9.1.0

data/lib/space_core/repo_resolver.rb

@@ -1,167 +0,0 @@
-# frozen_string_literal: true
-
-require "uri"
-
-module Space::Core
-  class RepoResolver
-    SCP_LIKE_PATTERN = /\A(?:[^@\/]+@)?(?<provider>[^:\/]+):(?<path>.+)\z/
-    URL_PATTERN = %r{\A[A-Za-z][A-Za-z0-9+\-.]*://}
-
-    attr_reader :config
-
-    def initialize(config)
-      @config = config
-    end
-
-    def resolve(spec)
-      value = spec.to_s.strip
-      raise RepoResolutionError, "Repo cannot be blank" if value.empty?
-
-      if url_like?(value)
-        resolve_url(value)
-      elsif (match = value.match(SCP_LIKE_PATTERN))
-        reference_from_parts(
-          provider: match[:provider],
-          path_parts: split_repo_path(match[:path]),
-          clone_url: value,
-          source: value
-        )
-      else
-        resolve_shorthand(value)
-      end
-    end
-
-    private
-
-    def resolve_url(value)
-      uri = URI.parse(value)
-      provider = uri.host
-      path = uri.path.to_s.delete_prefix("/")
-      raise RepoResolutionError, "Could not determine provider from '#{value}'" if provider.to_s.empty?
-
-      reference_from_parts(
-        provider: provider,
-        path_parts: split_repo_path(path),
-        clone_url: value,
-        source: value
-      )
-    rescue URI::InvalidURIError
-      raise RepoResolutionError, "Could not parse repo URL '#{value}'"
-    end
-
-    def resolve_shorthand(value)
-      parts = split_repo_path(value)
-
-      if parts.length == 1
-        resolve_default_organization_repo(parts.first, value)
-      elsif provider_like?(parts.first) && parts.length >= 3
-        reference_from_parts(
-          provider: parts.first,
-          path_parts: parts[1..],
-          clone_url: nil,
-          source: value
-        )
-      else
-        resolve_default_provider_repo(parts, value)
-      end
-    end
-
-    def resolve_default_organization_repo(name, source)
-      provider = require_default_provider(source)
-      owner = config.default_organization
-      unless owner
-        raise RepoResolutionError,
-              "Repo '#{source}' needs an organization. Set one with: space config set default_organization ORG"
-      end
-
-      reference(provider:, owner:, name:, clone_url: nil, source:)
-    end
-
-    def resolve_default_provider_repo(parts, source)
-      provider = require_default_provider(source)
-      reference_from_parts(provider:, path_parts: parts, clone_url: nil, source:)
-    end
-
-    def reference_from_parts(provider:, path_parts:, clone_url:, source:)
-      if path_parts.length < 2
-        raise RepoResolutionError, "Repo '#{source}' must include an organization and repo name"
-      end
-
-      name = path_parts.last
-      owner = path_parts[0...-1].join("/")
-      reference(provider:, owner:, name:, clone_url:, source:)
-    end
-
-    def reference(provider:, owner:, name:, clone_url:, source:)
-      normalized_provider = normalize_provider(provider)
-      normalized_owner = normalize_path_part(owner)
-      normalized_name = normalize_repo_name(name)
-
-      RepoReference.new(
-        provider: normalized_provider,
-        owner: normalized_owner,
-        name: normalized_name,
-        clone_url: clone_url || clone_url_for(normalized_provider, normalized_owner, normalized_name),
-        source: source
-      )
-    end
-
-    def clone_url_for(provider, owner, name)
-      case config.git_clone_protocol
-      when "ssh"
-        "git@#{provider}:#{owner}/#{name}.git"
-      when "https"
-        "https://#{provider}/#{owner}/#{name}.git"
-      end
-    end
-
-    def split_repo_path(value)
-      normalized = value.to_s.strip.delete_prefix("/").delete_suffix("/")
-      normalized = normalized.delete_suffix(".git")
-      parts = normalized.split("/").reject(&:empty?)
-      raise RepoResolutionError, "Repo '#{value}' must include a repo name" if parts.empty?
-
-      parts
-    end
-
-    def require_default_provider(source)
-      config.default_provider || raise(
-        RepoResolutionError,
-        "Repo '#{source}' needs a provider. Set one with: space config set default_provider PROVIDER"
-      )
-    end
-
-    def normalize_provider(value)
-      normalized = value.to_s.strip
-      normalized = normalized.delete_prefix("https://")
-      normalized = normalized.delete_prefix("http://")
-      normalized = normalized.delete_prefix("ssh://")
-      normalized = normalized.delete_suffix("/")
-      raise RepoResolutionError, "Provider cannot be blank" if normalized.empty?
-
-      normalized
-    end
-
-    def normalize_path_part(value)
-      normalized = value.to_s.strip.delete_prefix("/").delete_suffix("/")
-      raise RepoResolutionError, "Organization cannot be blank" if normalized.empty?
-
-      normalized
-    end
-
-    def normalize_repo_name(value)
-      normalized = value.to_s.strip.delete_suffix(".git")
-      raise RepoResolutionError, "Repo name cannot be blank" if normalized.empty?
-
-      normalized
-    end
-
-    def url_like?(value)
-      value.match?(URL_PATTERN)
-    end
-
-    def provider_like?(value)
-      value.include?(".") || value.include?(":") || value == "localhost"
-    end
-  end
-end

data/lib/space_core/shell_integration.rb

@@ -1,438 +0,0 @@
-# frozen_string_literal: true
-
-require "fileutils"
-
-module Space::Core
-  module ShellIntegration
-    FISH_TEMPLATE = <<~'FISH'
-      # Generated by space-architect. Do not edit by hand.
-
-      function __space_architect_command
-          set -l __ps_index 1
-
-          while test $__ps_index -le (count $argv)
-              set -l __ps_arg $argv[$__ps_index]
-
-              switch "$__ps_arg"
-                  case "--"
-                      set __ps_index (math $__ps_index + 1)
-                      if test $__ps_index -le (count $argv)
-                          echo $argv[$__ps_index]
-                      end
-                      return 0
-                  case "--color" "--colors"
-                      set __ps_index (math $__ps_index + 2)
-                      continue
-                  case "--color=*" "--colors=*"
-                      set __ps_index (math $__ps_index + 1)
-                      continue
-                  case "-*"
-                      return 0
-                  case "*"
-                      echo $__ps_arg
-                      return 0
-              end
-          end
-      end
-
-      function __space_architect_has_color_option
-          set -l __ps_index 1
-
-          while test $__ps_index -le (count $argv)
-              set -l __ps_arg $argv[$__ps_index]
-
-              switch "$__ps_arg"
-                  case "--color" "--colors" "--color=*" "--colors=*"
-                      return 0
-                  case "--"
-                      return 1
-              end
-
-              set __ps_index (math $__ps_index + 1)
-          end
-
-          return 1
-      end
-
-      function space --wraps space --description "Create and manage project spaces"
-          if not set -q __space_architect_compat_checked
-              set -g __space_architect_compat_checked 1
-              set -l __space_architect_installed_version __SPACE_ARCHITECT_VERSION__
-              set -l __space_architect_binary_version (command space --version 2>/dev/null)
-              if test "$__space_architect_binary_version" != "$__space_architect_installed_version"
-                  echo "space-architect: shell integration version $__space_architect_installed_version does not match binary version $__space_architect_binary_version; re-run 'space shell fish install'" >&2
-              end
-          end
-
-          set -l __space_command (__space_architect_command $argv)
-          set -l __space_args $argv
-
-          if test -t 1; and not __space_architect_has_color_option $argv
-              set __space_args --color=always $__space_args
-          end
-
-          switch "$__space_command"
-              case new use
-                  set -l __space_output (command space $__space_args)
-                  set -l __space_status $status
-
-                  if test (count $__space_output) -gt 0
-                      printf "%s\n" $__space_output
-                  end
-
-                  if test $__space_status -eq 0
-                      set -l __space_target $__space_output[-1]
-                      set __space_target (string replace -r "^~(?=/|\$)" $HOME -- $__space_target)
-                      if test -d "$__space_target"
-                          cd "$__space_target"
-                      end
-                  end
-
-                  return $__space_status
-              case "*"
-                  command space $__space_args
-                  return $status
-          end
-      end
-    FISH
-
-    FISH_COMPLETIONS = <<~'FISH'
-      # Generated by space-architect. Do not edit by hand.
-
-      function __space_architect_complete_command
-          set -l tokens (commandline -opc)
-          set -l index 2
-
-          while test $index -le (count $tokens)
-              set -l token $tokens[$index]
-
-              switch "$token"
-                  case "--"
-                      set index (math $index + 1)
-                      if test $index -le (count $tokens)
-                          echo $tokens[$index]
-                      end
-                      return 0
-                  case "--color" "--colors"
-                      set index (math $index + 2)
-                      continue
-                  case "--color=*" "--colors=*"
-                      set index (math $index + 1)
-                      continue
-                  case "-*"
-                      set index (math $index + 1)
-                      continue
-                  case "*"
-                      echo $token
-                      return 0
-              end
-          end
-      end
-
-      function __space_architect_complete_needs_command
-          test -z "$(__space_architect_complete_command)"
-      end
-
-      function __space_architect_complete_using_command
-          contains -- (__space_architect_complete_command) $argv
-      end
-
-      function __space_architect_complete_first_argument_after
-          set -l commands $argv
-          set -l tokens (commandline -opc)
-          set -l index 2
-          set -l matched_command 0
-
-          while test $index -le (count $tokens)
-              set -l token $tokens[$index]
-
-              switch "$token"
-                  case "--color" "--colors"
-                      set index (math $index + 2)
-                      continue
-                  case "--color=*" "--colors=*" "-*"
-                      set index (math $index + 1)
-                      continue
-              end
-
-              if test $matched_command -eq 0
-                  if contains -- "$token" $commands
-                      set matched_command 1
-                  else
-                      return 1
-                  end
-              else
-                  echo $token
-                  return 0
-              end
-
-              set index (math $index + 1)
-          end
-
-          return 1
-      end
-
-      function __space_architect_complete_has_first_argument_after
-          set -q argv[1]; or return 1
-          set -l first_argument (__space_architect_complete_first_argument_after $argv)
-          test -n "$first_argument"
-      end
-
-      function __space_architect_complete_second_argument_after
-          set -q argv[1]; or return 1
-          set -l command $argv[1]
-          set -l tokens (commandline -opc)
-          set -l index 2
-          set -l matched_command 0
-          set -l matched_first_argument 0
-
-          while test $index -le (count $tokens)
-              set -l token $tokens[$index]
-
-              switch "$token"
-                  case "--color" "--colors"
-                      set index (math $index + 2)
-                      continue
-                  case "--color=*" "--colors=*" "-*"
-                      set index (math $index + 1)
-                      continue
-              end
-
-              if test $matched_command -eq 0
-                  test "$token" = "$command"; or return 1
-                  set matched_command 1
-              else if test $matched_first_argument -eq 0
-                  set matched_first_argument 1
-              else
-                  echo $token
-                  return 0
-              end
-
-              set index (math $index + 1)
-          end
-
-          return 1
-      end
-
-      function __space_architect_complete_has_second_argument_after
-          set -q argv[1]; or return 1
-          set -l second_argument (__space_architect_complete_second_argument_after $argv)
-          test -n "$second_argument"
-      end
-
-      function __space_architect_complete_first_argument_is
-          set -q argv[1]; or return 1
-          set -l expected $argv[1]
-          set -e argv[1]
-          test "$(__space_architect_complete_first_argument_after $argv)" = "$expected"
-      end
-
-      function __space_architect_complete_spaces
-          command space shell complete spaces 2>/dev/null
-      end
-
-      function __space_architect_complete_statuses
-          command space shell complete statuses 2>/dev/null
-      end
-
-      function __space_architect_complete_config_keys
-          command space shell complete config-keys 2>/dev/null
-      end
-
-      function __space_architect_complete_config_set_key
-          set -l tokens (commandline -opc)
-          set -l index 2
-          set -l matched_config 0
-          set -l matched_set 0
-
-          while test $index -le (count $tokens)
-              set -l token $tokens[$index]
-
-              switch "$token"
-                  case "--color" "--colors"
-                      set index (math $index + 2)
-                      continue
-                  case "--color=*" "--colors=*" "-*"
-                      set index (math $index + 1)
-                      continue
-              end
-
-              if test $matched_config -eq 0
-                  test "$token" = "config"; or return 1
-                  set matched_config 1
-              else if test $matched_set -eq 0
-                  test "$token" = "set"; or return 1
-                  set matched_set 1
-              else
-                  echo $token
-                  return 0
-              end
-
-              set index (math $index + 1)
-          end
-
-          return 1
-      end
-
-      function __space_architect_complete_config_set_has_key
-          test -n "$(__space_architect_complete_config_set_key)"
-      end
-
-      function __space_architect_complete_config_set_key_is
-          test "$(__space_architect_complete_config_set_key)" = "$argv[1]"
-      end
-
-      complete -c space -f -l color -x -a "auto always never" -d "Color output"
-      complete -c space -f -l colors -x -a "auto always never" -d "Color output"
-      complete -c space -f -n "__space_architect_complete_using_command init shell" -l force -d "Overwrite existing files"
-      complete -c space -f -n "__space_architect_complete_using_command new" -s r -l repo -x -d "Clone a repo into the new space"
-
-      complete -c space -f -n "__space_architect_complete_needs_command" -a init -d "Create default XDG config and state files"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a new -d "Create a new project space"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a list -d "List spaces"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a ls -d "List spaces"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a show -d "Show space metadata"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a path -d "Print a space path"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a use -d "Select and cd to a space with fish integration"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a current -d "Show the current space"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a status -d "Report or set a space status"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a config -d "Show or update config"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a repo -d "Manage repos in the current space"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a repos -d "Manage repos in the current space"
-      complete -c space -f -n "__space_architect_complete_needs_command" -a shell -d "Manage shell integration"
-
-      complete -c space -f -n "__space_architect_complete_using_command show path use" -a "(__space_architect_complete_spaces)" -d "Space"
-      complete -c space -f -n "__space_architect_complete_using_command status" -a "(__space_architect_complete_spaces)" -d "Space"
-      complete -c space -f -n "__space_architect_complete_using_command status" -a "(__space_architect_complete_statuses)" -d "Status"
-      complete -c space -f -n "__space_architect_complete_first_argument_is init shell; and not __space_architect_complete_has_second_argument_after shell" -a fish -d "Fish shell"
-
-      complete -c space -f -n "__space_architect_complete_using_command repo repos; and not __space_architect_complete_has_first_argument_after repo repos" -a add -d "Clone repos into the current space"
-      complete -c space -f -n "__space_architect_complete_using_command repo repos; and not __space_architect_complete_has_first_argument_after repo repos" -a list -d "List repos in the current space"
-      complete -c space -f -n "__space_architect_complete_using_command repo repos; and not __space_architect_complete_has_first_argument_after repo repos" -a ls -d "List repos in the current space"
-      complete -c space -f -n "__space_architect_complete_using_command repo repos; and not __space_architect_complete_has_first_argument_after repo repos" -a resolve -d "Resolve repo names without cloning"
-
-      complete -c space -f -n "__space_architect_complete_using_command config; and not __space_architect_complete_has_first_argument_after config" -a show -d "Show config"
-      complete -c space -f -n "__space_architect_complete_using_command config; and not __space_architect_complete_has_first_argument_after config" -a path -d "Print config path"
-      complete -c space -f -n "__space_architect_complete_using_command config; and not __space_architect_complete_has_first_argument_after config" -a set -d "Set a config value"
-      complete -c space -f -n "__space_architect_complete_first_argument_is set config; and not __space_architect_complete_config_set_has_key" -a "(__space_architect_complete_config_keys)" -d "Config key"
-      complete -c space -f -n "__space_architect_complete_config_set_key_is git_clone_protocol" -a "ssh https" -d "Clone protocol"
-      complete -c space -f -n "__space_architect_complete_config_set_key_is default_provider" -a "github.com gitlab.com" -d "Git provider"
-
-      complete -c space -f -n "__space_architect_complete_using_command shell; and not __space_architect_complete_has_first_argument_after shell" -a init -d "Print shell integration"
-      complete -c space -f -n "__space_architect_complete_using_command shell; and not __space_architect_complete_has_first_argument_after shell" -a fish -d "Manage fish integration and completions"
-      complete -c space -f -n "__space_architect_complete_using_command shell; and not __space_architect_complete_has_first_argument_after shell" -a complete -d "Print completion candidates"
-      complete -c space -f -n "__space_architect_complete_first_argument_is fish shell; and not __space_architect_complete_has_second_argument_after shell" -a install -d "Install fish integration and completions"
-      complete -c space -f -n "__space_architect_complete_first_argument_is fish shell; and not __space_architect_complete_has_second_argument_after shell" -a uninstall -d "Remove fish integration and completions"
-      complete -c space -f -n "__space_architect_complete_first_argument_is fish shell; and not __space_architect_complete_has_second_argument_after shell" -a path -d "Print fish integration paths"
-      complete -c space -f -n "__space_architect_complete_first_argument_is complete shell; and not __space_architect_complete_has_second_argument_after shell" -a "spaces statuses config-keys config-values shells color-modes repo-subcommands config-subcommands fish-subcommands" -d "Completion kind"
-    FISH
-
-    def self.for(shell)
-      case shell.to_s
-      when "fish"
-        FISH_TEMPLATE.gsub("__SPACE_ARCHITECT_VERSION__", VERSION)
-      else
-        raise Error, "Unsupported shell '#{shell}'. Expected: fish"
-      end
-    end
-
-    def self.completions_for(shell)
-      case shell.to_s
-      when "fish"
-        FISH_COMPLETIONS
-      else
-        raise Error, "Unsupported shell '#{shell}'. Expected: fish"
-      end
-    end
-
-    def self.path_for(shell, env: ENV)
-      case shell.to_s
-      when "fish"
-        XDG.config_home(env: env).join("fish", "functions", "space.fish")
-      else
-        raise Error, "Unsupported shell '#{shell}'. Expected: fish"
-      end
-    end
-
-    def self.completions_path_for(shell, env: ENV)
-      case shell.to_s
-      when "fish"
-        XDG.config_home(env: env).join("fish", "completions", "space.fish")
-      else
-        raise Error, "Unsupported shell '#{shell}'. Expected: fish"
-      end
-    end
-
-    def self.install(shell, env: ENV, force: false)
-      function_result = write_managed_file(
-        path: path_for(shell, env:),
-        content: self.for(shell),
-        force: force,
-        description: "fish function"
-      )
-      completions_result = write_managed_file(
-        path: completions_path_for(shell, env:),
-        content: completions_for(shell),
-        force: force,
-        description: "fish completions"
-      )
-
-      function_result.merge(
-        completions_action: completions_result.fetch(:action),
-        completions_path: completions_result.fetch(:path)
-      )
-    end
-
-    def self.uninstall(shell, env: ENV, force: false)
-      function_result = remove_managed_file(
-        path: path_for(shell, env:),
-        content: self.for(shell),
-        force: force,
-        description: "fish function"
-      )
-      completions_result = remove_managed_file(
-        path: completions_path_for(shell, env:),
-        content: completions_for(shell),
-        force: force,
-        description: "fish completions"
-      )
-
-      function_result.merge(
-        completions_action: completions_result.fetch(:action),
-        completions_path: completions_result.fetch(:path)
-      )
-    end
-
-    def self.managed_fish?(content)
-      content.include?("Generated by space-architect") ||
-        (content.include?("function __space_architect_command") && content.include?("function space --wraps space"))
-    end
-
-    def self.write_managed_file(path:, content:, force:, description:)
-      existing = path.read if path.exist?
-
-      if existing && existing != content && !force && !managed_fish?(existing)
-        raise Error, "Refusing to overwrite existing #{description} at #{path}. Re-run with --force."
-      end
-
-      if existing == content
-        { action: :unchanged, path: path }
-      else
-        AtomicWrite.write(path, content)
-        { action: existing ? :updated : :installed, path: path }
-      end
-    end
-
-    def self.remove_managed_file(path:, content:, force:, description:)
-      return { action: :missing, path: path } unless path.exist?
-
-      existing = path.read
-      if existing != content && !force && !managed_fish?(existing)
-        raise Error, "Refusing to remove existing #{description} at #{path}. Re-run with --force."
-      end
-
-      FileUtils.rm_f(path)
-      { action: :removed, path: path }
-    end
-  end
-end

data/lib/space_core/slugger.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-module Space::Core
-  module Slugger
-    module_function
-
-    def slug(value)
-      slug = value.to_s.downcase.strip
-                  .gsub(/[^a-z0-9]+/, "-")
-                  .gsub(/\A-+|-+\z/, "")
-                  .gsub(/-+/, "-")
-
-      slug.empty? ? "space" : slug
-    end
-  end
-end