space-architect 8.0.0 → 9.0.0

data/lib/space_src/cli/org.rb

@@ -1,199 +0,0 @@
-# frozen_string_literal: true
-
-require "pastel"
-require "dry/monads"
-require "space_src/ui/mode"
-require "space_src/cli/options"
-
-module Space::Src
-  module CLI
-    # `org` command group: add / remove / list tracked orgs.
-    # Same shape as `repo` but against `Config::OrgRef` (host + name
-    # + two bool flags). The host defaults to "github.com" per
-    # PRD §3.1 when omitted (so `org add socketry` works as well as
-    # `org add github.com/socketry`).
-    module Org
-      module Helpers
-        module_function
-
-        # Parse an org ref string. Accepts "github.com/socketry" or
-        # bare "socketry" (defaults host to github.com). Anything
-        # with 3+ parts is rejected (org has only host + name).
-        def parse_ref(name, include_archived: false, include_forks: false, ignored_repos: [])
-          parts = name.to_s.split("/")
-          case parts.length
-          when 1
-            org = parts[0]
-            return Dry::Monads::Failure("invalid org reference: empty name in #{name.inspect}") if org.empty?
-            Dry::Monads::Success(Config::OrgRef.new(
-              host: Config::DEFAULT_HOST,
-              name: org,
-              include_archived: include_archived,
-              include_forks: include_forks,
-              ignored_repos: ignored_repos
-            ))
-          when 2
-            host, n = parts
-            return Dry::Monads::Failure("invalid org reference: empty host in #{name.inspect}") if host.empty?
-            return Dry::Monads::Failure("invalid org reference: empty name in #{name.inspect}") if n.empty?
-            Dry::Monads::Success(Config::OrgRef.new(
-              host: host,
-              name: n,
-              include_archived: include_archived,
-              include_forks: include_forks,
-              ignored_repos: ignored_repos
-            ))
-          else
-            Dry::Monads::Failure("invalid org reference: #{name.inspect} (expected \"<name>\" or \"<host>/<name>\")")
-          end
-        end
-
-        def same_org?(a, b) = a.host == b.host && a.name == b.name
-        def format_ref(o) = "#{o.host}/#{o.name}"
-        def format_failure(f) = f.is_a?(Hash) ? f.inspect : f.to_s
-
-        def format_ignored(o)
-          return "" if o.ignored_repos.empty?
-          " ignored_repos=#{o.ignored_repos.inspect}"
-        end
-
-        def fail_with(cmd, msg)
-          cmd.send(:err).puts msg
-          Space::Src::CLI.record_outcome(Outcome.new(exit_code: 1, message: msg))
-        end
-      end
-
-      class Add < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Add a tracked org (idempotent on host/name)"
-        argument :name, required: true,
-          desc: "Org identity as <name> or <host>/<name> (host defaults to github.com)"
-        option :include_archived, type: :boolean, default: false,
-          desc: "Include archived repos when expanding the org"
-        option :include_forks, type: :boolean, default: false,
-          desc: "Include forks when expanding the org"
-        option :ignored_repos, type: :array, default: [],
-          desc: "Repos to exclude from expansion (bare name or owner/name)"
-
-        def call(name:, include_archived: false, include_forks: false, ignored_repos: [], plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
-          pastel = Pastel.new(enabled: mode.color)
-
-          parsed = parse_ref(name,
-            include_archived: include_archived,
-            include_forks: include_forks,
-            ignored_repos: ignored_repos)
-          return fail_with(self, parsed.failure) if parsed.failure?
-
-          new_ref = parsed.success
-          paths = CLI.make_paths
-          config = Config::Store.load(paths.config_file).success
-
-          if config.orgs.any? { |o| same_org?(o, new_ref) }
-            out.puts pastel.yellow("already tracked: #{format_ref(new_ref)}" \
-              " (include_archived=#{new_ref.include_archived}, include_forks=#{new_ref.include_forks})" \
-              "#{format_ignored(new_ref)}")
-            return CLI.record_outcome(Outcome.new(exit_code: 0))
-          end
-
-          result = Config::Store.update(paths.config_file) do |c|
-            Config::Store.with(c, orgs: c.orgs + [new_ref])
-          end
-          if result.failure?
-            return fail_with(self, "failed to update config: #{format_failure(result.failure)}")
-          end
-
-          out.puts pastel.green("added: #{format_ref(new_ref)}" \
-            " (include_archived=#{new_ref.include_archived}, include_forks=#{new_ref.include_forks})" \
-            "#{format_ignored(new_ref)}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class Remove < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Remove a tracked org (host/name)"
-        argument :name, required: true,
-          desc: "Org identity as <name> or <host>/<name> (host defaults to github.com)"
-
-        def call(name:, plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          # The flags don't affect the identity match for remove; we
-          # match on (host, name) only. This matches the user's
-          # expectation that "remove" targets the org, not the flag
-          # combination they added it with.
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
-          pastel = Pastel.new(enabled: mode.color)
-
-          parsed = parse_ref(name)
-          return fail_with(self, parsed.failure) if parsed.failure?
-
-          target = parsed.success
-          paths = CLI.make_paths
-          config = Config::Store.load(paths.config_file).success
-
-          kept = config.orgs.reject { |o| same_org?(o, target) }
-          if kept.size == config.orgs.size
-            return fail_with(self, "not tracked: #{format_ref(target)}")
-          end
-
-          result = Config::Store.update(paths.config_file) do |c|
-            Config::Store.with(c, orgs: kept)
-          end
-          if result.failure?
-            return fail_with(self, "failed to update config: #{format_failure(result.failure)}")
-          end
-
-          out.puts pastel.green("removed: #{format_ref(target)}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class List < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "List tracked orgs"
-
-        def call(plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
-          pastel = Pastel.new(enabled: mode.color)
-
-          paths = CLI.make_paths
-          config = Config::Store.load(paths.config_file).success
-          if config.orgs.empty?
-            out.puts pastel.dim("(no tracked orgs)")
-          else
-            config.orgs.each do |o|
-              out.puts pastel.cyan("#{o.host}/#{o.name}" \
-                " (include_archived=#{o.include_archived}, include_forks=#{o.include_forks})" \
-                "#{format_ignored(o)}")
-            end
-          end
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-    end
-  end
-end
-
-Space::Src::CLI::Registry.register "org" do |prefix|
-  prefix.register "add", Space::Src::CLI::Org::Add
-  prefix.register "remove", Space::Src::CLI::Org::Remove
-  prefix.register "list", Space::Src::CLI::Org::List
-end

data/lib/space_src/cli/repo.rb

@@ -1,169 +0,0 @@
-# frozen_string_literal: true
-
-require "pastel"
-require "dry/monads"
-require "space_src/ui/mode"
-require "space_src/cli/options"
-
-module Space::Src
-  module CLI
-    # `repo` command group: add / remove / list tracked repos.
-    # Backed by Config::Store (the on-disk config.yaml is the
-    # source of truth — the CLI is just the CRUD interface).
-    module Repo
-      # Shared ref parser + formatters used by Add and Remove. Kept
-      # in a module-level Helpers so the parsing rules live in one
-      # place (the "invalid repo reference" message must be identical
-      # across add/remove for G3 consistency).
-      module Helpers
-        module_function
-
-        def parse_ref(ref)
-          parts = ref.to_s.split("/")
-          return Dry::Monads::Failure("invalid repo reference: #{ref.inspect} (expected host/owner/name)") if parts.length != 3
-          host, owner, name = parts
-          return Dry::Monads::Failure("invalid repo reference: empty host in #{ref.inspect}") if host.empty?
-          return Dry::Monads::Failure("invalid repo reference: empty owner in #{ref.inspect}") if owner.empty?
-          return Dry::Monads::Failure("invalid repo reference: empty name in #{ref.inspect}") if name.empty?
-          Dry::Monads::Success(Config::RepoRef.new(host: host, owner: owner, name: name))
-        end
-
-        def same_repo?(a, b)
-          a.host == b.host && a.owner == b.owner && a.name == b.name
-        end
-
-        def format_ref(r) = "#{r.host}/#{r.owner}/#{r.name}"
-
-        def format_failure(f) = f.is_a?(Hash) ? f.inspect : f.to_s
-
-        def fail_with(cmd, msg)
-          cmd.send(:err).puts msg
-          Space::Src::CLI.record_outcome(Outcome.new(exit_code: 1, message: msg))
-        end
-      end
-
-      # Add a tracked repo. Idempotent on the (host, owner, name)
-      # triple: adding the same ref twice prints "already tracked"
-      # and exits 0 (does NOT write a duplicate).
-      class Add < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Add a tracked repo (idempotent on host/owner/name)"
-        argument :ref, required: true,
-          desc: "Repo identity as host/owner/name (e.g. github.com/ruby/ruby)"
-
-        def call(ref:, plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
-          pastel = Pastel.new(enabled: mode.color)
-
-          parsed = parse_ref(ref)
-          return fail_with(self, parsed.failure) if parsed.failure?
-
-          new_ref = parsed.success
-          paths = CLI.make_paths
-          config = Config::Store.load(paths.config_file).success
-
-          if config.repos.any? { |r| same_repo?(r, new_ref) }
-            out.puts pastel.yellow("already tracked: #{format_ref(new_ref)}")
-            return CLI.record_outcome(Outcome.new(exit_code: 0))
-          end
-
-          result = Config::Store.update(paths.config_file) do |c|
-            Config::Store.with(c, repos: c.repos + [new_ref])
-          end
-
-          if result.failure?
-            return fail_with(self, "failed to update config: #{format_failure(result.failure)}")
-          end
-
-          out.puts pastel.green("added: #{format_ref(new_ref)}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      # Remove a tracked repo. Exits 0 with a clear message if the
-      # ref was present; exits 1 with "not tracked" if it wasn't
-      # (and the config is untouched in that case).
-      class Remove < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Remove a tracked repo (host/owner/name)"
-        argument :ref, required: true,
-          desc: "Repo identity as host/owner/name (e.g. github.com/ruby/ruby)"
-
-        def call(ref:, plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
-          pastel = Pastel.new(enabled: mode.color)
-
-          parsed = parse_ref(ref)
-          return fail_with(self, parsed.failure) if parsed.failure?
-
-          target = parsed.success
-          paths = CLI.make_paths
-          config = Config::Store.load(paths.config_file).success
-
-          kept = config.repos.reject { |r| same_repo?(r, target) }
-          if kept.size == config.repos.size
-            return fail_with(self, "not tracked: #{format_ref(target)}")
-          end
-
-          result = Config::Store.update(paths.config_file) do |c|
-            Config::Store.with(c, repos: kept)
-          end
-          if result.failure?
-            return fail_with(self, "failed to update config: #{format_failure(result.failure)}")
-          end
-
-          out.puts pastel.green("removed: #{format_ref(target)}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      # List tracked repos. One per line: "host/owner/name".
-      class List < Dry::CLI::Command
-        include GlobalOptions
-
-        desc "List tracked repos"
-
-        def call(plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
-          pastel = Pastel.new(enabled: mode.color)
-
-          paths = CLI.make_paths
-          config = Config::Store.load(paths.config_file).success
-          if config.repos.empty?
-            out.puts pastel.dim("(no tracked repos)")
-          else
-            config.repos.each do |r|
-              out.puts pastel.cyan("#{r.host}/#{r.owner}/#{r.name}")
-            end
-          end
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-    end
-  end
-end
-
-# Register the `repo` group + its subcommands. The block's `prefix`
-# is a Dry::CLI::Registry::Prefix proxy that namespaces the
-# subcommand names under "repo".
-Space::Src::CLI::Registry.register "repo" do |prefix|
-  prefix.register "add", Space::Src::CLI::Repo::Add
-  prefix.register "remove", Space::Src::CLI::Repo::Remove
-  prefix.register "list", Space::Src::CLI::Repo::List
-end

data/lib/space_src/cli/shell.rb

@@ -1,121 +0,0 @@
-# frozen_string_literal: true
-
-require "space_src/shell_integration"
-
-module Space::Src
-  module CLI
-    module Shell
-      class Init < Dry::CLI::Command
-        desc "Print shell integration script"
-        argument :shell_name, required: true, desc: "Shell name (e.g. fish)"
-
-        def call(shell_name:, **)
-          out.puts ShellIntegration.for(shell_name)
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        rescue => e
-          err.puts "src shell init: #{e.message}"
-          CLI.record_outcome(Outcome.new(exit_code: 1))
-        end
-      end
-
-      class Fish < Dry::CLI::Command
-        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, **)
-          case subcommand
-          when "install"
-            result = ShellIntegration.install("fish", env: CLI.env, force: force)
-            out.puts fish_install_message(result.fetch(:action), result.fetch(:path))
-            out.puts fish_completions_install_message(result.fetch(:completions_action), result.fetch(:completions_path))
-            out.puts "Restart fish to load the integration in this terminal: exec fish"
-            CLI.record_outcome(Outcome.new(exit_code: 0))
-          when "uninstall"
-            result = ShellIntegration.uninstall("fish", env: CLI.env, force: force)
-            out.puts fish_uninstall_message(result.fetch(:action), result.fetch(:path))
-            out.puts fish_completions_uninstall_message(result.fetch(:completions_action), result.fetch(:completions_path))
-            CLI.record_outcome(Outcome.new(exit_code: 0))
-          when "path"
-            out.puts "Function:    #{ShellIntegration.path_for("fish", env: CLI.env)}"
-            out.puts "Completions: #{ShellIntegration.completions_path_for("fish", env: CLI.env)}"
-            CLI.record_outcome(Outcome.new(exit_code: 0))
-          else
-            err.puts "Usage: src shell fish [install|uninstall|path]"
-            CLI.record_outcome(Outcome.new(exit_code: 1))
-          end
-        rescue => e
-          err.puts "src shell fish: #{e.message}"
-          CLI.record_outcome(Outcome.new(exit_code: 1))
-        end
-
-        private
-
-        def fish_install_message(action, path)
-          case action
-          when :unchanged then "Fish integration already installed: #{path}"
-          when :updated   then "Updated fish integration: #{path}"
-          else                 "Installed fish integration: #{path}"
-          end
-        end
-
-        def fish_uninstall_message(action, path)
-          case action
-          when :missing then "Fish integration was not installed: #{path}"
-          else               "Removed fish integration: #{path}"
-          end
-        end
-
-        def fish_completions_install_message(action, path)
-          case action
-          when :unchanged then "Fish completions already installed: #{path}"
-          when :updated   then "Updated fish completions: #{path}"
-          else                 "Installed fish completions: #{path}"
-          end
-        end
-
-        def fish_completions_uninstall_message(action, path)
-          case action
-          when :missing then "Fish completions were not installed: #{path}"
-          else               "Removed fish completions: #{path}"
-          end
-        end
-      end
-
-      class Complete < Dry::CLI::Command
-        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: [], **)
-          case kind
-          when "checkouts"
-            begin
-              paths = CLI.make_paths
-              config = Config::Store.load(paths.config_file).success
-              Nav.scan(config.base_dir).each { |e| out.puts e[:target] }
-            rescue
-              # Never raise on a completion call — missing/unparseable config is fine.
-            end
-            CLI.record_outcome(Outcome.new(exit_code: 0))
-          when "shells"
-            out.puts "fish"
-            CLI.record_outcome(Outcome.new(exit_code: 0))
-          else
-            err.puts "Usage: src shell complete checkouts|shells"
-            CLI.record_outcome(Outcome.new(exit_code: 1))
-          end
-        rescue => e
-          err.puts "src shell complete: #{e.message}"
-          CLI.record_outcome(Outcome.new(exit_code: 1))
-        end
-      end
-    end
-  end
-end
-
-Space::Src::CLI::Registry.register "shell" do |prefix|
-  prefix.register "init",      Space::Src::CLI::Shell::Init
-  prefix.register "fish",      Space::Src::CLI::Shell::Fish
-  prefix.register "complete",  Space::Src::CLI::Shell::Complete
-end

data/lib/space_src/cli/status.rb

@@ -1,75 +0,0 @@
-# frozen_string_literal: true
-
-require "pastel"
-require "space_src/ui/mode"
-require "space_src/cli/options"
-
-module Space::Src
-  module CLI
-    # `status` command: render a per-repo evergreen table from
-    # State::Store. Per G5, the rows must include each repo key
-    # with status, last_synced_at, and default_branch.
-    module Status
-      class Show < Dry::CLI::Command
-        include GlobalOptions
-
-        STATUS_COLORS = {
-          "clean" => :green,
-          "dirty" => :yellow,
-          "diverged" => :yellow,
-          "wrong_branch" => :yellow,
-          "detached" => :yellow,
-          "error" => :red
-        }.freeze
-
-        desc "Show the per-repo evergreen status table (from $XDG_STATE_HOME/space-src/state.yaml)"
-
-        def call(plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
-          pastel = Pastel.new(enabled: mode.color)
-
-          paths = CLI.make_paths
-          state = State::Store.load(paths.state_file).success
-
-          if state.repos.empty?
-            out.puts "(no repos in state — run `src sync` to populate)"
-            return CLI.record_outcome(Outcome.new(exit_code: 0))
-          end
-
-          # Tab-separated columns. The G5 assertion is on captured
-          # stdout containing each repo key and its status string —
-          # tab-separated is the most assertion-friendly (no width
-          # padding complexity, no ANSI codes).
-          out.puts ["REPO", "STATUS", "DEFAULT_BRANCH", "LAST_SYNCED_AT", "LAST_FETCH_AT"].join("\t")
-          state.repos.keys.sort.each do |key|
-            r = state.repos[key]
-            status_str = r.status.to_s
-            color = STATUS_COLORS[status_str]
-            styled_status = color ? pastel.decorate(status_str, color) : status_str
-            out.puts [
-              key,
-              styled_status,
-              r.default_branch.to_s,
-              format_time(r.last_synced_at),
-              format_time(r.last_fetch_at)
-            ].join("\t")
-          end
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-
-        private
-
-        def format_time(t)
-          return "" if t.nil?
-          t.respond_to?(:iso8601) ? t.iso8601 : t.to_s
-        end
-      end
-    end
-  end
-end
-
-Space::Src::CLI::Registry.register "status", Space::Src::CLI::Status::Show