space-architect 8.0.0 → 9.1.0

data/lib/space_src/cli/daemon.rb

@@ -1,362 +0,0 @@
-# frozen_string_literal: true
-
-require "pastel"
-require "fileutils"
-require "dry/monads"
-require "space_src/ui/mode"
-require "space_src/cli/options"
-require "space_src/launchd/agent"
-require "space_src/launchd/plist"
-require "space_src/migration"
-
-module Space::Src
-  module CLI
-    # `daemon` command group: install / uninstall / start / stop
-    # / restart / status. Installs a per-user launchd agent
-    # (`gui/<UID>`) that fires `src sync` on a
-    # `StartInterval`. The launchctl side is exercised ONLY
-    # through an injected command runner (slice-4 gates G2–G4);
-    # the live domain is proven by the manual real-Mac checklist
-    # in docs/gates/slice-4.md, not by these tests.
-    module Daemon
-      module Helpers
-        module_function
-
-        # Build a `Launchd::Agent` wired against the CLI's env
-        # seam (`CLI.env`). Tests inject a temp HOME (so
-        # `paths.launch_agents_dir` is under the temp HOME, not
-        # the real one) and a `runner:` via `Launchd::Agent.new`
-        # — the daemon commands don't accept a runner flag, so
-        # tests must use a real `Agent` (whose default `runner`
-        # only fires in an ambient Async::Task) OR stub the
-        # `Launchd::Agent` class.
-        def make_agent(uid: Process.uid, label: Launchd::Agent::DEFAULT_LABEL, runner: nil)
-          if runner
-            Launchd::Agent.new(runner: runner, uid: uid, label: label)
-          else
-            Launchd::Agent.new(uid: uid, label: label)
-          end
-        end
-
-        # Resolve the on-disk plist path for the agent label,
-        # rooted at the env's HOME-resolved `LaunchAgents/`
-        # (per slice-4 gate G3).
-        def plist_path(paths, label)
-          File.join(paths.launch_agents_dir, "#{label}.plist")
-        end
-
-        # Build the plist XML by looking up the absolute paths
-        # the launchd runtime needs (mise, ruby, the bin
-        # script, the repo root, the mise.toml). These come
-        # from a few places:
-        #   * `mise_bin` — `which mise` (we shell out at
-        #      install-time; the result is baked into the plist
-        #      as an absolute path so launchd's empty PATH
-        #      doesn't matter).
-        #   * `ruby_bin` — `mise exec -- which ruby` (the
-        #      toolchain-resolved ruby; pinned via mise.toml).
-        #   * `bin_path` — `RbConfig.ruby` + the script path
-        #      (we use `__dir__` of this file's caller; for the
-        #      gem install, this is `<gem>/exe/src`).
-        #
-        # In tests, we inject these via the `Resolve` object
-        # (see below) — never call out to the shell.
-        def build_plist(resolve:, config:, paths:, label:)
-          Launchd::Plist.call(
-            label: label,
-            refresh_interval: config.refresh_interval,
-            log_dir: paths.log_dir,
-            repo_root: resolve.repo_root,
-            mise_toml: resolve.mise_toml,
-            mise_bin: resolve.mise_bin,
-            ruby_bin: resolve.ruby_bin,
-            bin_path: resolve.bin_path
-          )
-        end
-
-        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
-
-        # Bundle of resolved absolute paths the plist needs.
-        # Production code resolves these via the shell (see
-        # `Resolve.detect`); tests construct one directly with
-        # known absolute paths.
-        Resolve = Data.define(:repo_root, :mise_toml, :mise_bin, :ruby_bin, :bin_path) do
-          def initialize(repo_root:, mise_toml:, mise_bin:, ruby_bin:, bin_path:)
-            super
-          end
-        end
-      end
-
-      class Install < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Install the per-user launchd agent (writes the plist + bootstrap)"
-
-        def call(plain: nil, json: nil, no_color: nil, quiet: nil, **)
-          paths = CLI.make_paths
-          paths.ensure!
-          config = Config::Store.load(paths.config_file).success
-
-          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)
-
-          label = Launchd::Agent::DEFAULT_LABEL
-          pp = plist_path(paths, label)
-
-          # Relabel: if old-identity plist exists, bootout (benign-failure-tolerant)
-          # and remove it before bootstrapping the new-label plist.
-          old_pp = plist_path(paths, Migration::OLD_LABEL)
-          if File.exist?(old_pp)
-            old_agent = make_agent(label: Migration::OLD_LABEL)
-            old_agent.uninstall
-            File.delete(old_pp) if File.exist?(old_pp)
-          end
-
-          resolve = Resolve.detect(repo_root: Dir.pwd)
-          xml = build_plist(resolve: resolve, config: config, paths: paths, label: label)
-          FileUtils.mkdir_p(File.dirname(pp))
-          File.write(pp, xml)
-
-          agent = make_agent
-          result = agent.install(pp)
-          if result.failure?
-            return fail_with(self, "bootstrap failed: #{format_failure(result.failure)}")
-          end
-
-          out.puts pastel.green("installed: #{pp}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class Uninstall < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Uninstall the per-user launchd agent (bootout + remove the plist)"
-
-        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
-          label = Launchd::Agent::DEFAULT_LABEL
-          pp = plist_path(paths, label)
-
-          agent = make_agent
-          result = agent.uninstall
-          # CF5 (Slice 5): the Agent maps a not-loaded bootout
-          # (status 3 / "No such process") to Success — the
-          # common case at a 6h refresh interval. A non-benign
-          # bootout Failure (e.g. status 1 "Operation not
-          # permitted") still surfaces here as a real failure
-          # the operator needs to see. We still remove the
-          # plist regardless (idempotent uninstall, Slice-4
-          # gate G3): the bootout is the only best-effort step.
-          if result.failure?
-            err.puts "bootout reported: #{format_failure(result.failure)}"
-          end
-
-          if File.exist?(pp)
-            File.delete(pp)
-            out.puts pastel.green("removed plist: #{pp}")
-          else
-            out.puts pastel.yellow("plist not present: #{pp}")
-          end
-
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class Start < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Start the agent (bootstrap + enable)"
-
-        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
-          label = Launchd::Agent::DEFAULT_LABEL
-          pp = plist_path(paths, label)
-
-          agent = make_agent
-          result = agent.start(pp)
-          if result.failure?
-            return fail_with(self, "start failed: #{format_failure(result.failure)}")
-          end
-          out.puts pastel.green("started: #{label}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class Stop < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Stop the agent (bootout + disable)"
-
-        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)
-
-          label = Launchd::Agent::DEFAULT_LABEL
-          agent = make_agent
-          result = agent.stop
-          if result.failure?
-            return fail_with(self, "stop failed: #{format_failure(result.failure)}")
-          end
-          out.puts pastel.green("stopped: #{label}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class Restart < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Restart the agent (kickstart -k)"
-
-        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)
-
-          label = Launchd::Agent::DEFAULT_LABEL
-          agent = make_agent
-          result = agent.restart
-          if result.failure?
-            return fail_with(self, "restart failed: #{format_failure(result.failure)}")
-          end
-          out.puts pastel.green("restarted: #{label}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class Status < Dry::CLI::Command
-        include Helpers
-        include GlobalOptions
-
-        desc "Print the agent's loaded/running/last-exit state"
-
-        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
-          old_pp = plist_path(paths, Migration::OLD_LABEL)
-          if File.exist?(old_pp)
-            err.puts pastel.yellow("warning: stale agent #{Migration::OLD_LABEL} detected; run `src daemon install` to upgrade")
-          end
-
-          label = Launchd::Agent::DEFAULT_LABEL
-          agent = make_agent
-          result = agent.status
-          if result.failure?
-            return fail_with(self, "status failed: #{format_failure(result.failure)}")
-          end
-          s = result.success
-          out.puts pastel.cyan("label: #{label}")
-          out.puts pastel.cyan("loaded: #{s[:loaded]}")
-          out.puts pastel.cyan("running: #{s[:running]}")
-          out.puts pastel.cyan("pid: #{s[:pid].inspect}")
-          out.puts pastel.cyan("last_exit: #{s[:last_exit].inspect}")
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-    end
-  end
-end
-
-# Detect the runtime paths the plist needs. The src install path
-# matters because the plist stores an absolute `bin_path` — that
-# is the script launchd invokes. We resolve `bin_path` from the
-# on-disk gem layout if we can, else fall back to the directory
-# the daemon command was run from.
-class Space::Src::CLI::Daemon::Helpers::Resolve
-  # @param repo_root [String]  absolute path of the working directory (where mise.toml is expected)
-  # @return [Resolve]
-  def self.detect(repo_root:)
-    mise_bin = detect_mise_bin
-    ruby_bin = detect_ruby_bin(repo_root, mise_bin)
-    bin_path = detect_bin_path(repo_root)
-    mise_toml = File.join(repo_root, "mise.toml")
-    new(repo_root: repo_root, mise_toml: mise_toml, mise_bin: mise_bin, ruby_bin: ruby_bin, bin_path: bin_path)
-  end
-
-  def self.detect_mise_bin
-    path = ENV["SPACE_SRC_MISE_BIN"]
-    return path if path && !path.empty?
-    require "open3"
-    out, _e, st = Open3.capture3("which", "mise")
-    st.success? ? out.strip : "/opt/homebrew/bin/mise"
-  end
-
-  def self.detect_ruby_bin(repo_root, mise_bin)
-    path = ENV["SPACE_SRC_RUBY_BIN"]
-    return path if path && !path.empty?
-    # `mise exec -- which ruby` — but we avoid spawning in tests;
-    # production path goes through here.
-    require "open3"
-    out, _e, st = Open3.capture3(mise_bin, "exec", "--", "which", "ruby", chdir: repo_root)
-    return out.strip if st.success? && !out.strip.empty?
-    # Fall back to the system ruby (last resort).
-    out, _e, st = Open3.capture3("which", "ruby")
-    st.success? ? out.strip : "/usr/bin/ruby"
-  end
-
-  def self.detect_bin_path(repo_root)
-    path = ENV["SPACE_SRC_BIN_PATH"]
-    return path if path && !path.empty?
-    # Prefer the on-disk dev bin at `<repo_root>/exe/src`
-    # — it's what the human runs during testing, and the gem is
-    # typically not `gem install`ed in a source checkout.
-    dev = File.join(repo_root, "exe", "src")
-    return dev if File.exist?(dev)
-    # Next, an installed binary on PATH.
-    require "open3"
-    out, _e, st = Open3.capture3("which", "src")
-    return out.strip if st.success? && !out.strip.empty?
-    # Last resort: the installed gem's bin (raises if not installed).
-    Gem.bin_path("space-architect", "src")
-  end
-end
-
-Space::Src::CLI::Registry.register "daemon" do |prefix|
-  prefix.register "install", Space::Src::CLI::Daemon::Install
-  prefix.register "uninstall", Space::Src::CLI::Daemon::Uninstall
-  prefix.register "start", Space::Src::CLI::Daemon::Start
-  prefix.register "stop", Space::Src::CLI::Daemon::Stop
-  prefix.register "restart", Space::Src::CLI::Daemon::Restart
-  prefix.register "status", Space::Src::CLI::Daemon::Status
-end

data/lib/space_src/cli/options.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module Space::Src
-  module CLI
-    # Shared output mode flags. Include in any command class to add:
-    #   --plain     force plain text output (one line per event, ANSI-free)
-    #   --json      force JSON output (one object per event line, 12-factor)
-    #   --no-color  disable ANSI color
-    #   --quiet/-q  suppress non-essential human output
-    #
-    # Resolved via UI::Mode.resolve in the command's #call.
-    module GlobalOptions
-      def self.included(base)
-        base.option :plain, type: :flag, desc: "Plain text output (one line per event, no color)"
-        base.option :json, type: :flag, desc: "JSON output (one object per event line, 12-factor)"
-        base.option :no_color, type: :flag, desc: "Disable color output"
-        base.option :quiet, type: :flag, aliases: ["-q"], desc: "Suppress non-essential output"
-      end
-    end
-  end
-end

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