space-architect 8.0.0 → 9.0.0

data/lib/space_core/xdg.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-
-module Space::Core
-  module XDG
-    module_function
-
-    def config_home(env: ENV)
-      Pathname.new(env.fetch("XDG_CONFIG_HOME", File.join(home(env: env), ".config")))
-    end
-
-    def state_home(env: ENV)
-      Pathname.new(env.fetch("XDG_STATE_HOME", File.join(home(env: env), ".local", "state")))
-    end
-
-    def home(env: ENV)
-      env.fetch("HOME", Dir.home)
-    end
-
-    def expand_user(path, env: ENV)
-      value = path.to_s
-
-      if value == "~"
-        home(env: env)
-      elsif value.start_with?("~/")
-        File.join(home(env: env), value[2..])
-      else
-        File.expand_path(value)
-      end
-    end
-  end
-end

data/lib/space_core.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require "space_core/version"
-
-module Space::Core
-end
-
-require "space_core/errors"
-require "space_core/warnings"
-Space::Core::Warnings.disable_experimental!
-require "space_core/atomic_write"
-require "space_core/xdg"
-require "space_core/paths"
-require "space_core/commands"
-require "space_core/config"
-require "space_core/state"
-require "space_core/slugger"
-require "space_core/space"
-require "space_core/repo_reference"
-require "space_core/repo_resolver"
-require "space_core/git_client"
-require "space_core/mise_client"
-require "space_core/space_store"
-require "space_core/shell_integration"
-require "space_core/terminal"
-require "space_core/cli"

data/lib/space_src/cli/clone.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-require "pastel"
-require "dry/monads"
-require "space_src/cli/options"
-require "space_src/cloner"
-
-module Space::Src
-  module CLI
-    # `clone` command: APFS COW copy of an evergreen repo into a working dir.
-    # Resolves each NAME against config.base_dir and copies via cp -Rc.
-    # Multiple names are processed independently; a per-name failure is
-    # reported on err and does not abort the others. Exit code is 1 if any
-    # name failed, else 0.
-    class Clone < Dry::CLI::Command
-      include GlobalOptions
-
-      desc "Clone evergreen repo(s) into a working directory (APFS COW copy)"
-      argument :names, type: :array, required: true,
-        desc: "Repo name(s): bare name, owner/name, or host/owner/name"
-      option :into, default: ".",
-        desc: "Destination parent directory (default: current working directory)"
-
-      def call(names:, into: ".", 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
-        cloner = Cloner.new(base_dir: config.base_dir)
-
-        any_failure = false
-        names.each do |name|
-          result = cloner.call(name: name, into: into)
-          if result.success?
-            dest = result.success
-            out.puts pastel.green("cloned: #{name} → #{dest}")
-          else
-            err.puts result.failure
-            any_failure = true
-          end
-        end
-
-        CLI.record_outcome(Outcome.new(exit_code: any_failure ? 1 : 0))
-      end
-    end
-  end
-end
-
-Space::Src::CLI::Registry.register "clone", Space::Src::CLI::Clone

data/lib/space_src/cli/config.rb

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-require "pastel"
-require "yaml"
-require "space_src/ui/mode"
-require "space_src/cli/options"
-
-module Space::Src
-  module CLI
-    # `config` command group: path / show.
-    module ConfigCmd
-      class Path < Dry::CLI::Command
-        include GlobalOptions
-
-        desc "Print the resolved config file path (honors $XDG_CONFIG_HOME)"
-
-        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
-          out.puts pastel.cyan(paths.config_file)
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-
-      class Show < Dry::CLI::Command
-        include GlobalOptions
-
-        desc "Print the effective (validated, defaults-applied) config as 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
-          config = Config::Store.load(paths.config_file).success
-          # Emit via the store's own emit() so the format matches
-          # what `config.yaml` looks like on disk (stable key order
-          # per Slice 1's emit implementation). This makes
-          # `config show` a faithful round-trip preview.
-          out.puts pastel.cyan(Config::Store.emit(config.to_h).chomp)
-          CLI.record_outcome(Outcome.new(exit_code: 0))
-        end
-      end
-    end
-  end
-end
-
-# `config` is the name of both our config-store module (Config) and
-# the CLI command group. We register under a different module name
-# (ConfigCmd) to avoid the constant clash, then alias the
-# registration key as "config".
-Space::Src::CLI::Registry.register "config" do |prefix|
-  prefix.register "path", Space::Src::CLI::ConfigCmd::Path
-  prefix.register "show", Space::Src::CLI::ConfigCmd::Show
-end

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