space-architect 1.1.0

data/lib/space_architect/cli/new.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    class New < Dry::CLI::Command
+      include GlobalOptions
+      include Helpers
+
+      desc "Create a new project space"
+      argument :title, required: true, desc: "Space title"
+      argument :repos, type: :array, required: false, desc: "Repo refs to clone"
+      option :git, type: :boolean, default: true, desc: "Initialize the space as a Git repository (use --no-git to skip)"
+
+      def call(title:, repos: [], git: true, **opts)
+        setup_terminal(**opts.slice(:color, :colors))
+        result = store.create(title, git: git).bind do |space|
+          terminal.success "Created #{space.id}"
+
+          repo_specs = Array(repos).compact
+          repo_specs.each { |spec| terminal.say "Queued #{spec}" }
+
+          next Success(space) if repo_specs.empty?
+
+          progress = RepoProgress.new(repo_specs.length)
+          terminal.with_spinner(-> { progress.message }) do
+            store.add_repos_to(space, repo_specs, reporter: progress)
+          end.fmap do |results|
+            results.each do |r|
+              terminal.success "Added #{r.fetch(:repo).fetch('full_name')}"
+              terminal.say terminal.path(r.fetch(:path))
+            end
+            space
+          end
+        end
+        render(result) do |space|
+          terminal.say terminal.path(space.path)
+          CLI.record_outcome(Outcome.new(exit_code: 0))
+        end
+      end
+    end
+  end
+end
+

data/lib/space_architect/cli/options.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    module GlobalOptions
+      def self.included(base)
+        base.option :color, type: :string, default: "auto", desc: "Color output: auto, always, never"
+        base.option :colors, type: :string, desc: "Alias for --color"
+      end
+    end
+  end
+end

data/lib/space_architect/cli/path.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    class Path < Dry::CLI::Command
+      include GlobalOptions
+      include Helpers
+
+      desc "Print the path for a space or the current space"
+      argument :identifier, required: false, desc: "Space ID or title slug"
+
+      def call(identifier: nil, **opts)
+        setup_terminal(**opts.slice(:color, :colors))
+        render(store.path_for(identifier)) do |path|
+          terminal.say terminal.path(path)
+          CLI.record_outcome(Outcome.new(exit_code: 0))
+        end
+      end
+    end
+  end
+end
+

data/lib/space_architect/cli/repo.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    module Repo
+      class Add < Dry::CLI::Command
+        include GlobalOptions
+        include Helpers
+
+        desc "Clone repos into the current space"
+        argument :repos, type: :array, required: false, desc: "REPO [REPO...]"
+
+        def call(repos: [], **opts)
+          setup_terminal(**opts.slice(:color, :colors))
+          handle_errors do
+            specs = Array(repos).compact
+            if specs.empty?
+              terminal.error("Usage: space repo add REPO [REPO...]")
+              CLI.record_outcome(Outcome.new(exit_code: 1))
+              next
+            end
+
+            progress = RepoProgress.new(specs.length)
+            add_result = terminal.with_spinner(-> { progress.message }) do
+              store.add_repos(specs, reporter: progress)
+            end
+            render(add_result) do |results|
+              results.each do |result|
+                terminal.success "Added #{result.fetch(:repo).fetch('full_name')}"
+                terminal.say terminal.path(result.fetch(:path))
+              end
+              CLI.record_outcome(Outcome.new(exit_code: 0))
+            end
+          end
+        end
+      end
+
+      class RepoList < Dry::CLI::Command
+        include GlobalOptions
+        include Helpers
+
+        desc "List repos in the current space"
+
+        def call(**opts)
+          setup_terminal(**opts.slice(:color, :colors))
+          handle_errors do
+            render(store.repos) do |repos|
+              if repos.empty?
+                id = store.find.fmap(&:id).value_or("(unknown space)")
+                terminal.say "No repos found in #{id}"
+                next
+              end
+
+              rows = repos.map { |repo| [repo.fetch("full_name", repo["name"]), repo.fetch("path", "")] }
+              terminal.say terminal.table(["Repo", "Path"], rows)
+              CLI.record_outcome(Outcome.new(exit_code: 0))
+            end
+          end
+        end
+      end
+
+      class Resolve < Dry::CLI::Command
+        include GlobalOptions
+        include Helpers
+
+        desc "Resolve repo refs without cloning"
+        argument :repos, type: :array, required: false, desc: "REPO [REPO...]"
+
+        def call(repos: [], **opts)
+          setup_terminal(**opts.slice(:color, :colors))
+          handle_errors do
+            specs = Array(repos).compact
+            if specs.empty?
+              terminal.error("Usage: space repo resolve REPO [REPO...]")
+              CLI.record_outcome(Outcome.new(exit_code: 1))
+              next
+            end
+
+            references = specs.map { |spec| RepoResolver.new(project_config).resolve(spec) }
+            terminal.say terminal.table(["Repo", "Clone URL"], references.map { |ref| [ref.full_name, ref.clone_url] })
+            CLI.record_outcome(Outcome.new(exit_code: 0))
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/space_architect/cli/shell.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    module Shell
+      class ShellInit < Dry::CLI::Command
+        include GlobalOptions
+        include Helpers
+
+        desc "Print shell integration script"
+        argument :shell_name, required: true, desc: "Shell name (e.g. fish)"
+
+        def call(shell_name:, **opts)
+          setup_terminal(**opts.slice(:color, :colors))
+          handle_errors do
+            terminal.say ShellIntegration.for(shell_name)
+            CLI.record_outcome(Outcome.new(exit_code: 0))
+          end
+        end
+      end
+
+      class Fish < Dry::CLI::Command
+        include GlobalOptions
+        include Helpers
+
+        desc "Manage fish shell integration: install, uninstall, path"
+        argument :subcommand, required: false, desc: "install, uninstall, or path (default: install)"
+        option :force, type: :boolean, default: false, desc: "Overwrite or remove existing shell files"
+
+        def call(subcommand: "install", force: false, **opts)
+          setup_terminal(**opts.slice(:color, :colors))
+          handle_errors do
+            case subcommand
+            when "install"
+              result = ShellIntegration.install("fish", env: project_config.env, force: force)
+              terminal.success fish_install_message(result.fetch(:action), result.fetch(:path))
+              terminal.success fish_completions_install_message(result.fetch(:completions_action), result.fetch(:completions_path))
+              terminal.say "Restart fish to load the integration in this terminal: exec fish"
+            when "uninstall"
+              result = ShellIntegration.uninstall("fish", env: project_config.env, force: force)
+              terminal.success fish_uninstall_message(result.fetch(:action), result.fetch(:path))
+              terminal.success fish_completions_uninstall_message(result.fetch(:completions_action), result.fetch(:completions_path))
+            when "path"
+              terminal.say "Function:    #{terminal.path(ShellIntegration.path_for('fish', env: project_config.env))}"
+              terminal.say "Completions: #{terminal.path(ShellIntegration.completions_path_for('fish', env: project_config.env))}"
+            else
+              err.puts "Usage: space shell fish [install|uninstall|path]"
+              CLI.record_outcome(Outcome.new(exit_code: 1))
+              next
+            end
+            CLI.record_outcome(Outcome.new(exit_code: 0))
+          end
+        end
+
+        private
+
+        def fish_install_message(action, path)
+          case action
+          when :unchanged then "Fish integration already installed: #{terminal.path(path)}"
+          when :updated   then "Updated fish integration: #{terminal.path(path)}"
+          else                 "Installed fish integration: #{terminal.path(path)}"
+          end
+        end
+
+        def fish_uninstall_message(action, path)
+          case action
+          when :missing then "Fish integration was not installed: #{terminal.path(path)}"
+          else               "Removed fish integration: #{terminal.path(path)}"
+          end
+        end
+
+        def fish_completions_install_message(action, path)
+          case action
+          when :unchanged then "Fish completions already installed: #{terminal.path(path)}"
+          when :updated   then "Updated fish completions: #{terminal.path(path)}"
+          else                 "Installed fish completions: #{terminal.path(path)}"
+          end
+        end
+
+        def fish_completions_uninstall_message(action, path)
+          case action
+          when :missing then "Fish completions were not installed: #{terminal.path(path)}"
+          else               "Removed fish completions: #{terminal.path(path)}"
+          end
+        end
+      end
+
+      class Complete < Dry::CLI::Command
+        include GlobalOptions
+        include Helpers
+
+        desc "Print completion candidates"
+        argument :kind, required: true, desc: "Completion kind"
+        argument :extra, type: :array, required: false, desc: "Extra args for completion"
+
+        def call(kind:, extra: [], **opts)
+          setup_terminal(**opts.slice(:color, :colors))
+          handle_errors do
+            completion_candidates(kind, Array(extra)).each { |c| terminal.say c }
+            CLI.record_outcome(Outcome.new(exit_code: 0))
+          end
+        end
+
+        private
+
+        def completion_candidates(kind, args)
+          case kind
+          when "spaces"          then store.list.map { |space| "#{space.id}\t#{space.title}" }
+          when "statuses"        then Space::VALID_STATUSES
+          when "config-keys"     then SpaceArchitect::Config::EDITABLE_KEYS
+          when "config-values"   then completion_values_for_config_key(args.first)
+          when "shells"          then ["fish"]
+          when "color-modes"     then %w[auto always never]
+          when "repo-subcommands"   then %w[add list ls resolve]
+          when "config-subcommands" then %w[show path set]
+          when "fish-subcommands"   then %w[install uninstall path]
+          else
+            raise SpaceArchitect::Error, "Usage: space shell complete #{completion_kinds.join('|')}"
+          end
+        end
+
+        def completion_values_for_config_key(key)
+          case key
+          when "git_clone_protocol" then SpaceArchitect::Config::VALID_GIT_CLONE_PROTOCOLS
+          when "default_provider"   then %w[github.com gitlab.com]
+          else []
+          end
+        end
+
+        def completion_kinds
+          %w[spaces statuses config-keys config-values shells color-modes repo-subcommands config-subcommands fish-subcommands]
+        end
+      end
+    end
+  end
+end
+

data/lib/space_architect/cli/show.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    class Show < Dry::CLI::Command
+      include GlobalOptions
+      include Helpers
+
+      desc "Show metadata for a space or the current space"
+      argument :identifier, required: false, desc: "Space ID or title slug"
+
+      def call(identifier: nil, **opts)
+        setup_terminal(**opts.slice(:color, :colors))
+        render(store.find(identifier)) do |space|
+          terminal.say "ID:         #{space.id}"
+          terminal.say "Title:      #{space.title}"
+          terminal.say "Status:     #{space.status}"
+          terminal.say "Path:       #{terminal.path(space.path)}"
+          terminal.say "Created:    #{space.data['created_at']}"
+          terminal.say "Updated:    #{space.data['updated_at']}"
+          CLI.record_outcome(Outcome.new(exit_code: 0))
+        end
+      end
+    end
+  end
+end
+

data/lib/space_architect/cli/space.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+SpaceArchitect::CLI::Registry.register "space" do |prefix|
+  prefix.register "init",    SpaceArchitect::CLI::Init
+  prefix.register "new",     SpaceArchitect::CLI::New
+  prefix.register "list",    SpaceArchitect::CLI::List
+  prefix.register "ls",      SpaceArchitect::CLI::List
+  prefix.register "show",    SpaceArchitect::CLI::Show
+  prefix.register "path",    SpaceArchitect::CLI::Path
+  prefix.register "use",     SpaceArchitect::CLI::Use
+  prefix.register "current", SpaceArchitect::CLI::Current
+  prefix.register "status",  SpaceArchitect::CLI::Status
+  prefix.register "config" do |c|
+    c.register "show", SpaceArchitect::CLI::Config::Show
+    c.register "path", SpaceArchitect::CLI::Config::ConfigPath
+    c.register "set",  SpaceArchitect::CLI::Config::Set
+  end
+  prefix.register "repo" do |r|
+    r.register "add",     SpaceArchitect::CLI::Repo::Add
+    r.register "list",    SpaceArchitect::CLI::Repo::RepoList
+    r.register "ls",      SpaceArchitect::CLI::Repo::RepoList
+    r.register "resolve", SpaceArchitect::CLI::Repo::Resolve
+  end
+  prefix.register "repos" do |r|
+    r.register "add",     SpaceArchitect::CLI::Repo::Add
+    r.register "list",    SpaceArchitect::CLI::Repo::RepoList
+    r.register "ls",      SpaceArchitect::CLI::Repo::RepoList
+    r.register "resolve", SpaceArchitect::CLI::Repo::Resolve
+  end
+  prefix.register "shell" do |s|
+    s.register "init",     SpaceArchitect::CLI::Shell::ShellInit
+    s.register "fish",     SpaceArchitect::CLI::Shell::Fish
+    s.register "complete", SpaceArchitect::CLI::Shell::Complete
+  end
+end

data/lib/space_architect/cli/src.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "space_architect/pristine/cli"
+
+module SpaceArchitect
+  module CLI
+    # Exit-code bridge to the vendored Pristine (repo-tender) CLI engine.
+    # `architect src <args>` hands the raw remainder to Pristine's own dry-cli
+    # registry and translates Pristine's recorded Outcome into the host exit code.
+    # Pristine has its own Registry, Outcome, and :repo_tender_cli_* thread-locals;
+    # this is the seam between the two registries (NOT a re-registration). Pristine's
+    # top-level help/version interceptors call Kernel.exit, so we reproduce that
+    # interception here against the injected IO instead of delegating to them.
+    # dry-cli's internal exit on a bare group / unknown command propagates as
+    # SystemExit — same as the host's own bare groups (e.g. `space repo`) — and is
+    # intentionally NOT rescued (accepted behavior change).
+    def self.dispatch_src(rest, out = $stdout, err = $stderr)
+      if Pristine::CLI::TOP_LEVEL_HELP.include?(rest)
+        out.puts Dry::CLI::Usage.call(Pristine::CLI::Registry.get([]))
+        return 0
+      end
+      if Pristine::CLI::VERSION_REQUEST.include?(rest)
+        out.puts SpaceArchitect::Pristine::VERSION
+        return 0
+      end
+
+      Thread.current[:repo_tender_cli_outcome] = nil
+      Dry::CLI.new(Pristine::CLI::Registry).call(arguments: rest, out: out, err: err)
+      Pristine::CLI.last_outcome&.exit_code || 0
+    end
+  end
+end

data/lib/space_architect/cli/status.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    class Status < Dry::CLI::Command
+      include GlobalOptions
+      include Helpers
+
+      desc "Set a space status: active, paused, done, archived"
+      argument :rest, type: :array, required: false, desc: "[SPACE] STATUS"
+
+      def call(rest: [], **opts)
+        setup_terminal(**opts.slice(:color, :colors))
+        handle_errors do
+          identifier, status_value = parse_status_args(Array(rest))
+          render(store.find(identifier)) do |space|
+            space.update_status(status_value)
+            terminal.success "#{space.id} is #{space.status}"
+            CLI.record_outcome(Outcome.new(exit_code: 0))
+          end
+        end
+      end
+
+      private
+
+      def parse_status_args(args)
+        case args.length
+        when 1
+          [nil, args.first]
+        when 2
+          args
+        else
+          raise SpaceArchitect::Error, "Usage: space status [SPACE] STATUS"
+        end
+      end
+    end
+  end
+end
+

data/lib/space_architect/cli/use.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module SpaceArchitect
+  module CLI
+    class Use < Dry::CLI::Command
+      include GlobalOptions
+      include Helpers
+
+      desc "Remember a space in recent state and print its path"
+      argument :identifier, required: true, desc: "Space ID or title slug"
+
+      def call(identifier:, **opts)
+        setup_terminal(**opts.slice(:color, :colors))
+        render(store.use(identifier)) do |space|
+          terminal.success "Recent space: #{space.id}"
+          terminal.say terminal.path(space.path)
+          CLI.record_outcome(Outcome.new(exit_code: 0))
+        end
+      end
+    end
+  end
+end
+

data/lib/space_architect/cli.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "dry/cli"
+
+module SpaceArchitect
+  module CLI
+    Outcome = Data.define(:exit_code, :message) do
+      def initialize(exit_code:, message: nil) = super
+    end
+
+    def self.record_outcome(o) = (Thread.current[:space_architect_outcome] = o)
+    def self.last_outcome = Thread.current[:space_architect_outcome]
+
+    module Registry
+      extend Dry::CLI::Registry
+    end
+
+    TOP_LEVEL_HELP    = [[], ["--help"], ["-h"], ["help"]].freeze
+    VERSION_REQUEST   = [["version"], ["--version"]].freeze
+
+    def self.call(argv, out = $stdout, err = $stderr)
+      Thread.current[:space_architect_outcome] = nil
+
+      if TOP_LEVEL_HELP.include?(argv)
+        out.puts Dry::CLI::Usage.call(Registry.get([]))
+        return 0
+      end
+
+      if VERSION_REQUEST.include?(argv)
+        out.puts SpaceArchitect::VERSION
+        return 0
+      end
+
+      if argv.first == "src"
+        return dispatch_src(argv[1..], out, err)
+      end
+
+      Dry::CLI.new(Registry).call(arguments: normalize_args(argv), out: out, err: err)
+      last_outcome&.exit_code || 0
+    end
+
+    # Move --color/--colors options to the end of the argument list so dry-cli's
+    # command routing is not confused by options before the subcommand name.
+    #
+    # Two passes:
+    #   1. Leading: extract two-token form (--color VALUE) and =-form from the
+    #      front while args still look like options.
+    #   2. Non-leading: extract =-form (--color=VALUE / --colors=VALUE) from any
+    #      position before the -- separator. The bare two-token form is ambiguous
+    #      with a subcommand name in non-leading position and is left in place.
+    def self.normalize_args(argv)
+      args = argv.dup
+      extracted = []
+
+      # Pass 1: leading two-token and =-form (existing behavior, unchanged)
+      while (arg = args.first) && arg != "--" && arg.start_with?("-")
+        if %w[--color --colors].include?(arg)
+          extracted << args.shift
+          extracted << args.shift if args.first && !args.first.start_with?("-")
+        elsif arg.start_with?("--color=", "--colors=")
+          extracted << args.shift
+        else
+          break
+        end
+      end
+
+      # Pass 2: =-form from any non-leading position, stop at --
+      sep = args.index("--")
+      head = sep ? args[0, sep] : args
+      tail = sep ? args[sep..] : []
+      mid_color, head = head.partition { |a| a.start_with?("--color=", "--colors=") }
+      extracted += mid_color
+      args = head + tail
+
+      extracted.empty? ? args : args + extracted
+    end
+
+    def self.run(argv, out = $stdout, err = $stderr)
+      Kernel.exit(call(argv, out, err))
+    rescue Interrupt
+      err.puts "interrupted"
+      Kernel.exit(130)
+    end
+  end
+end
+
+require_relative "cli/options"
+require_relative "cli/helpers"
+require_relative "cli/init"
+require_relative "cli/new"
+require_relative "cli/list"
+require_relative "cli/show"
+require_relative "cli/path"
+require_relative "cli/use"
+require_relative "cli/current"
+require_relative "cli/status"
+require_relative "cli/config"
+require_relative "cli/repo"
+require_relative "cli/shell"
+require_relative "cli/architect"
+require_relative "cli/space"
+require_relative "cli/src"