repo-tender 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6a0eecbd892c6f3ca3e1f706ac8e36c9d3b421e4354416a3aaa293224ce7926
-  data.tar.gz: 7d278c8dd24320d2c582b8e8f0fa88e36f0b7e65f777983d3c68b2f3c15e2e7b
+  metadata.gz: 3cdef875cd3f2076b9c58047f9b59844846957ac24a5deee9c615e2cd30a8d7e
+  data.tar.gz: d810d8e25f1ce4262a63994ca7f3c0c752b876f549b33c870e9557736175ac70
 SHA512:
-  metadata.gz: 0d809b8db2a89cd6b0a48bb3fb2735a50b6515a27762b37f030d3a122dc72b26e43e4567c31b08b620da24a630bc7bc8796811268d3667d3e6a1af75e12f34b2
-  data.tar.gz: 176de9eb5000b95274e65111f77cd86fdad73d91616bab75d49b45d7054cdc7eaf5149cb7092b1e66f920692527305bf73f883ab76ff093b3d87d38748bdaa57
+  metadata.gz: 9fe1a7e54338a7806dd7b6c7686a8008a045b28c5ef9afb622548adc0e9e98872c6571752923aa47fb7ce94caf1a529f3f9b72557aefacece14ecd620a48ca54
+  data.tar.gz: e62fd711352b672fa0ab5fb7fc7f76184f21952ade51a88fb585ad4a1bb7253e93332baf037991b43454ea6f4b062a49a6450b6352d29e249f301b25ed6f398d

data/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) ·
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+
+## [1.0.0] - 2026-10-08
+
+### Restored
+
+- **Standalone again.** The evergreen engine was absorbed into
+  [space-architect] v8.0.0 under that gem's namespace (`Space::Src`) and
+  binary name (`src`); this release restores the `repo-tender` identity —
+  same engine, home repo [jetpks/repo-tender] again.
+  Lineage: 0.x repo-tender → absorbed as space-src in space-architect 8.0.0 →
+  restored standalone 1.0.0.
+
+[space-architect]: https://github.com/jetpks/space-architect
+[jetpks/repo-tender]: https://github.com/jetpks/repo-tender
+
+### Changed
+
+- **Binaries:** `repo-tender` is the primary binary again. `src` ships as a
+  deprecation shim — it still works, but prints
+  `src is deprecated; use repo-tender instead` on stderr on every invocation,
+  then forwards argv/stdout/exit codes to the primary binary unchanged.
+- **State/config locations:** `repo-tender` is the app name for
+  `$XDG_STATE_HOME` / `$XDG_CONFIG_HOME` dirs and the launchd label is
+  `io.github.jetpks.repo-tender.sync` again.
+- **Identity migration inverted:** a one-shot data-preserving migration moves
+  `space-src`-named config/state dirs to their `repo-tender` locations and
+  flags the stale `io.github.jetpks.space-src.sync` launchd agent. Moves only,
+  never deletes; pre-existing `repo-tender` dirs are a clean no-op.
+- **Module namespace:** `Space::Src` → `RepoTender` throughout.
+- **Ruby floor:** `>= 4.0.5` (was `>= 3.3` in the 0.x gem).
+- **Default clone home:** `~/src/evergreen` (was the absorbed identity's
+  `~/architect/src`).
+
+### Added
+
+- Fish shell integration and completions, installed as
+  `~/.config/fish/functions/repo-tender.fish` /
+  `~/.config/fish/completions/repo-tender.fish` via
+  `repo-tender shell fish install`.

data/README.md

@@ -74,7 +74,7 @@ git clone git@github.com:jetpks/repo-tender.git
 cd repo-tender
 mise install        # installs Ruby 4.0.5 per mise.toml
 bundle install
-bin/repo-tender --help
+exe/repo-tender --help
 ```
 
 Make sure `gh` is logged in (otherwise org listing drops to an anonymous
@@ -120,6 +120,17 @@ repo-tender org add socketry              # host defaults to github.com
 repo-tender org add github.com/socketry   # equivalent, explicit host
 ```
 
+Got a few truly enormous repos in an org you never want cloned? Exclude them
+with `--ignored-repos` (bare `name` or `owner/name`, comma-separated):
+
+```bash
+repo-tender org add bigco --ignored-repos monorepo,huge
+# => added: github.com/bigco (… ignored_repos=["monorepo", "huge"])
+```
+
+The ignore list is authoritative at expansion time — an ignored repo never
+enters a sync sweep. ✋
+
 ### Sync everything now ⚡
 
 ```bash
@@ -145,6 +156,23 @@ github.com/ruby/ruby            dirty   trunk           2026-06-14T20:01:36Z  20
 `clean` is the happy path. Anything else is repo-tender telling you a repo needs
 *your* attention — it won't touch it for you. 🔒
 
+### Grab an instant copy ⚡🐄
+
+Need a working copy of an evergreen repo? `clone` makes a near-instant
+copy-on-write clone (macOS APFS `cp -Rc`) from your local mirror — no network,
+barely any disk:
+
+```bash
+repo-tender clone ruby                    # resolves the single ruby/ruby mirror
+repo-tender clone ruby async --into ~/wip # copy several into a parent dir
+```
+
+Name a repo bare (`ruby`), `owner/name`, or `host/owner/name` — bare names that
+match more than one mirror error out and list the candidates so you can qualify.
+`--into` is the destination **parent** (default `.`); each repo lands at
+`<into>/<name>`. And it **never clobbers** — an existing destination is left
+byte-for-byte alone. 🔒
+
 ### Schedule it & forget it 🤖
 
 Install a per-user launchd agent that runs `sync` every `refresh_interval`:
@@ -189,11 +217,13 @@ repo-tender status --json
 
 **Track repos & orgs:**
 - `repo add|remove|list REF` — manage individual repos (`host/owner/name`)
-- `org add|remove|list NAME` — manage whole orgs (`name` or `host/name`)
+- `org add|remove|list NAME` — manage whole orgs (`name` or `host/name`);
+  `org add` takes `--include-archived`, `--include-forks`, `--ignored-repos a,b`
 
 **Run & inspect:**
 - `sync [--repo REF]` — run one sync pass (optionally scoped to one repo)
 - `status` — print the per-repo evergreen status table (reads state, no network)
+- `clone NAME... [--into DIR]` — instant COW copy of mirror(s) into a parent dir
 - `config path|show` — show the config path, or the effective config
 
 **Schedule (launchd):**
@@ -225,11 +255,29 @@ The bits worth knowing the *why* of:
   org expansions). Splitting them keeps machine rewrites away from the file you
   actually wrote.
 
+## The `src` shim & lineage 🧬
+
+repo-tender's story has a detour in it: the engine was absorbed into
+[space-architect] v8.0.0 under that gem's namespace and binary name (`src`,
+state under `~/.local/state/space-src`), and has now been restored standalone
+here as repo-tender 1.0.0 — same engine, own identity again.
+
+[space-architect]: https://github.com/jetpks/space-architect
+
+Two things happen for anyone arriving from the absorbed identity:
+
+- **`src` still works** — it's shipped as a deprecation shim. Every invocation
+  prints `src is deprecated; use repo-tender instead` on stderr, then forwards
+  argv, stdout, and exit codes to the primary binary unchanged.
+- **State migrates automatically** — on first run of any `repo-tender`
+  command, a one-shot data-preserving migration moves your `space-src` config
+  and state dirs to their `repo-tender` locations (a no-clobber move; existing
+  `repo-tender` dirs are never touched) and flags a stale launchd agent with
+  the `repo-tender daemon install` instruction.
+
 ## Documentation 📖
 
-- **[Full Reference](docs/reference.md)** 📘 — every command, flag, config key,
-  status value, file location, and exit code
-- **[Design (PRD)](docs/prd/repo-tender.md)** 🏗️ — the full design & decisions
+- **[Changelog](CHANGELOG.md)** 📜 — what's new (1.0.0: standalone again)
 - **[Builder context](AGENTS.md)** 🤝 — toolchain & conventions
 
 ## Development 🧪

data/exe/repo-tender

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+source_gemfile = File.expand_path("../Gemfile", __dir__)
+if File.exist?(source_gemfile)
+  ENV["BUNDLE_GEMFILE"] ||= source_gemfile
+  require "bundler/setup"
+  $LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+end
+
+require "repo_tender"
+
+RepoTender::CLI.run(ARGV, $stdout, $stderr)

data/exe/src

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Deprecation shim for the `src` binary name (the engine lived briefly under
+# the absorbed identity). Warns on EVERY invocation, then forwards
+# argv/stdout/exit codes to the primary binary unchanged — including the
+# usage output, which renders $PROGRAM_NAME's basename (so the shim presents
+# the primary binary's name for byte-identical --help parity).
+
+warn "src is deprecated; use repo-tender instead"
+
+source_gemfile = File.expand_path("../Gemfile", __dir__)
+if File.exist?(source_gemfile)
+  ENV["BUNDLE_GEMFILE"] ||= source_gemfile
+  require "bundler/setup"
+  $LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+end
+
+$PROGRAM_NAME = File.join(File.expand_path(__dir__), "repo-tender")
+
+require "repo_tender"
+
+RepoTender::CLI.run(ARGV, $stdout, $stderr)

data/lib/repo_tender/cli/clone.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "pastel"
+require "dry/monads"
+require "repo_tender/cli/options"
+require "repo_tender/cloner"
+
+module RepoTender
+  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
+
+RepoTender::CLI::Registry.register "clone", RepoTender::CLI::Clone

data/lib/repo_tender/cli/config.rb

@@ -2,7 +2,6 @@
 
 require "pastel"
 require "yaml"
-require "repo_tender/cli"
 require "repo_tender/ui/mode"
 require "repo_tender/cli/options"
 

data/lib/repo_tender/cli/daemon.rb

@@ -3,11 +3,11 @@
 require "pastel"
 require "fileutils"
 require "dry/monads"
-require "repo_tender/cli"
 require "repo_tender/ui/mode"
 require "repo_tender/cli/options"
 require "repo_tender/launchd/agent"
 require "repo_tender/launchd/plist"
+require "repo_tender/migration"
 
 module RepoTender
   module CLI
@@ -57,7 +57,7 @@ module RepoTender
         #      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>/bin/repo-tender`).
+        #      gem install, this is `<gem>/exe/repo-tender`).
         #
         # In tests, we inject these via the `Resolve` object
         # (see below) — never call out to the shell.
@@ -113,6 +113,15 @@ module RepoTender
           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))
@@ -264,6 +273,12 @@ module RepoTender
           )
           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 `repo-tender daemon install` to upgrade")
+          end
+
           label = Launchd::Agent::DEFAULT_LABEL
           agent = make_agent
           result = agent.status
@@ -283,11 +298,11 @@ module RepoTender
   end
 end
 
-# Detect the runtime paths the plist needs. The repo-tender
-# 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.
+# Detect the runtime paths the plist needs. The repo-tender 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 RepoTender::CLI::Daemon::Helpers::Resolve
   # @param repo_root [String]  absolute path of the working directory (where mise.toml is expected)
   # @return [Resolve]
@@ -323,10 +338,10 @@ class RepoTender::CLI::Daemon::Helpers::Resolve
   def self.detect_bin_path(repo_root)
     path = ENV["REPO_TENDER_BIN_PATH"]
     return path if path && !path.empty?
-    # Prefer the on-disk dev bin at `<repo_root>/bin/repo-tender`
+    # Prefer the on-disk dev bin at `<repo_root>/exe/repo-tender`
     # — 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, "bin", "repo-tender")
+    dev = File.join(repo_root, "exe", "repo-tender")
     return dev if File.exist?(dev)
     # Next, an installed binary on PATH.
     require "open3"

data/lib/repo_tender/cli/org.rb

@@ -2,7 +2,6 @@
 
 require "pastel"
 require "dry/monads"
-require "repo_tender/cli"
 require "repo_tender/ui/mode"
 require "repo_tender/cli/options"
 
@@ -20,7 +19,7 @@ module RepoTender
         # 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)
+        def parse_ref(name, include_archived: false, include_forks: false, ignored_repos: [])
           parts = name.to_s.split("/")
           case parts.length
           when 1
@@ -30,7 +29,8 @@ module RepoTender
               host: Config::DEFAULT_HOST,
               name: org,
               include_archived: include_archived,
-              include_forks: include_forks
+              include_forks: include_forks,
+              ignored_repos: ignored_repos
             ))
           when 2
             host, n = parts
@@ -40,7 +40,8 @@ module RepoTender
               host: host,
               name: n,
               include_archived: include_archived,
-              include_forks: include_forks
+              include_forks: include_forks,
+              ignored_repos: ignored_repos
             ))
           else
             Dry::Monads::Failure("invalid org reference: #{name.inspect} (expected \"<name>\" or \"<host>/<name>\")")
@@ -51,6 +52,11 @@ module RepoTender
         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
           RepoTender::CLI.record_outcome(Outcome.new(exit_code: 1, message: msg))
@@ -68,8 +74,10 @@ module RepoTender
           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, plain: nil, json: nil, no_color: nil, quiet: nil, **)
+        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,
@@ -79,7 +87,8 @@ module RepoTender
 
           parsed = parse_ref(name,
             include_archived: include_archived,
-            include_forks: include_forks)
+            include_forks: include_forks,
+            ignored_repos: ignored_repos)
           return fail_with(self, parsed.failure) if parsed.failure?
 
           new_ref = parsed.success
@@ -88,7 +97,8 @@ module RepoTender
 
           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})")
+              " (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
 
@@ -100,7 +110,8 @@ module RepoTender
           end
 
           out.puts pastel.green("added: #{format_ref(new_ref)}" \
-            " (include_archived=#{new_ref.include_archived}, include_forks=#{new_ref.include_forks})")
+            " (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
@@ -150,6 +161,7 @@ module RepoTender
       end
 
       class List < Dry::CLI::Command
+        include Helpers
         include GlobalOptions
 
         desc "List tracked orgs"
@@ -169,7 +181,8 @@ module RepoTender
           else
             config.orgs.each do |o|
               out.puts pastel.cyan("#{o.host}/#{o.name}" \
-                " (include_archived=#{o.include_archived}, include_forks=#{o.include_forks})")
+                " (include_archived=#{o.include_archived}, include_forks=#{o.include_forks})" \
+                "#{format_ignored(o)}")
             end
           end
           CLI.record_outcome(Outcome.new(exit_code: 0))

data/lib/repo_tender/cli/repo.rb

@@ -2,7 +2,6 @@
 
 require "pastel"
 require "dry/monads"
-require "repo_tender/cli"
 require "repo_tender/ui/mode"
 require "repo_tender/cli/options"
 

data/lib/repo_tender/cli/shell.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "repo_tender/shell_integration"
+
+module RepoTender
+  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 "repo-tender 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: repo-tender shell fish [install|uninstall|path]"
+            CLI.record_outcome(Outcome.new(exit_code: 1))
+          end
+        rescue => e
+          err.puts "repo-tender 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: repo-tender shell complete checkouts|shells"
+            CLI.record_outcome(Outcome.new(exit_code: 1))
+          end
+        rescue => e
+          err.puts "repo-tender shell complete: #{e.message}"
+          CLI.record_outcome(Outcome.new(exit_code: 1))
+        end
+      end
+    end
+  end
+end
+
+RepoTender::CLI::Registry.register "shell" do |prefix|
+  prefix.register "init", RepoTender::CLI::Shell::Init
+  prefix.register "fish", RepoTender::CLI::Shell::Fish
+  prefix.register "complete", RepoTender::CLI::Shell::Complete
+end

data/lib/repo_tender/cli/status.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "pastel"
-require "repo_tender/cli"
 require "repo_tender/ui/mode"
 require "repo_tender/cli/options"
 

data/lib/repo_tender/cli/sync.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "dry/monads"
-require "repo_tender/cli"
 require "repo_tender/cli/repo"  # for Repo::Helpers.parse_ref
 require "repo_tender/cli/options"
 require "repo_tender/ui/mode"
@@ -44,6 +43,19 @@ module RepoTender
           # the next spawn. No-op when the log is missing or
           # under-threshold (sync tests in G4 stay green).
           rotate_plist_logs(paths)
+
+          # Resolved BEFORE the scoping block: the "scoping sync to:"
+          # notice below is prose, and must be suppressed in JSON mode
+          # for the same reason the summary line is. Resolution depends
+          # only on flags/env/out, so it is safe this early.
+          mode = UI::Mode.resolve(
+            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
+            env: CLI.env,
+            out: out
+          )
+          # Every line of --json output must parse as one JSON object.
+          human = mode.format != :json
+
           if repo
             target = scope_target(repo)
             return fail_with(self, "invalid repo reference: #{repo.inspect} (expected host/owner/name)") if target.failure?
@@ -58,14 +70,9 @@ module RepoTender
             # exactly the G4 "other repo gets no state row" test
             # path, so we explicitly empty orgs here).
             config = Config::Store.with(config, repos: [found], orgs: [])
-            out.puts "scoping sync to: #{Repo::Helpers.format_ref(found)}"
+            out.puts "scoping sync to: #{Repo::Helpers.format_ref(found)}" if human
           end
 
-          mode = UI::Mode.resolve(
-            flags: {plain: plain, json: json, no_color: no_color, quiet: quiet},
-            env: CLI.env,
-            out: out
-          )
           reporter = if mode.format == :json
             UI::JsonReporter.new(out)
           elsif mode.animate
@@ -74,14 +81,19 @@ module RepoTender
             UI::PlainReporter.new(out, mode: mode)
           end
 
-          result = RepoTender::Sync::Engine.new(reporter: reporter).call(config: config, paths: paths)
+          # prune only on a full sweep. With --repo the config above was
+          # narrowed to one repo, so pruning would delete the state rows
+          # for every OTHER tracked repo.
+          result = RepoTender::Sync::Engine.new(reporter: reporter)
+            .call(config: config, paths: paths, prune: repo.nil?)
           if result.failure?
             return fail_with(self, "sync failed: #{format_failure(result.failure)}")
           end
 
-          new_state = result.success
-          n = new_state.repos.size
-          out.puts "synced #{n} repo(s)"
+          report = result.success
+          # JsonReporter already emits a run_finished event carrying the
+          # summary, so suppressing the prose line loses nothing.
+          out.puts "synced #{report.processed} repo(s)" if human
           CLI.record_outcome(Outcome.new(exit_code: 0))
         end