boost-skill-cli 1.2.208__tar.gz → 1.2.210__tar.gz

{boost_skill_cli-1.2.208 → boost_skill_cli-1.2.210}/.vale/styles/config/vocabularies/boost/accept.txt

@@ -111,6 +111,7 @@ nodeid
 nonces
 npm
 onboards
+onnxruntime
 OpenShift
 OpenSSF
 overclaiming

{boost_skill_cli-1.2.208/boost_skill_cli.egg-info → boost_skill_cli-1.2.210}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.2.208
+Version: 1.2.210
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License-Expression: Apache-2.0
@@ -17,13 +17,14 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Build Tools
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: rag
 Requires-Dist: sqlite-vec>=0.1.6; extra == "rag"
-Requires-Dist: onnxruntime>=1.17; extra == "rag"
+Requires-Dist: onnxruntime>=1.17; python_version < "3.15" and extra == "rag"
 Requires-Dist: tokenizers>=0.15; extra == "rag"
 Provides-Extra: eval
 Requires-Dist: ranx>=0.3.20; extra == "eval"
@@ -44,7 +45,7 @@ Dynamic: license-file
 
 [![CI](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml/badge.svg)](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/v/release/jonnyeclectic/boost)](https://github.com/jonnyeclectic/boost/releases/latest)
-[![Python 3.12–3.14](https://img.shields.io/badge/python-3.12%E2%80%933.14-blue)](https://github.com/jonnyeclectic/boost/blob/main/.github/workflows/ci.yml)
+[![Python 3.12–3.15](https://img.shields.io/badge/python-3.12%E2%80%933.15-blue)](https://github.com/jonnyeclectic/boost/blob/main/.github/workflows/ci.yml)
 [![Coverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjonnyeclectic%2Fboost%2Fbadges%2Fcoverage.json)](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml)
 [![Mutation score](https://img.shields.io/badge/mutation_score-%E2%89%A580%25_killed-blueviolet)](https://github.com/jonnyeclectic/boost/blob/main/scripts/mutation_gate.py)
 [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey)](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml)
@@ -132,11 +133,42 @@ way to end up at `boost: command not found`.
 ## Install
 
 ```bash
-pipx install boost-skill-cli
+pipx install --python 3.13 --fetch-python=always "boost-skill-cli[rag]"
 boost --version
 boost tap --defaults
 ```
 
+With uv it is
+`uv tool install --managed-python --python 3.13 "boost-skill-cli[rag]"`.
+Plain `pipx install boost-skill-cli` also works if you only want keyword
+search.
+
+The command pins the interpreter because pipx and uv build boost's
+environment on one Python and keep a link to it. When Homebrew upgrades past
+a `python@3.X` formula it deletes the old one, the link breaks, and `boost`
+fails before it starts with `bad interpreter: no such file or directory`.
+[DEBUGGING](docs/DEBUGGING.md#boost-bad-interpreter-after-a-homebrew-upgrade)
+has the one-command fix. `--fetch-python=always` (pipx 1.18 or later) makes
+pipx download its own 3.13 even when Homebrew has one, and
+`--managed-python` does the same for uv, so a Homebrew cleanup can't touch
+either. The older flag, `--fetch-missing-python`, only downloads when no
+`python3.13` is on PATH. On a Mac with Homebrew's 3.13 it uses that one, and
+you are back where you started.
+
+The install command pins 3.13 rather than the newest Python because the
+`[rag]` extra's local embedding model runs on onnxruntime, and onnxruntime
+has wheels for 3.11 to 3.14 but not 3.15. On 3.15 the extra installs without
+it. Keyword search still works, and so does semantic search if you set
+`VOYAGE_API_KEY` or `OPENAI_API_KEY`.
+
+If you installed with plain `pipx install "boost-skill-cli[rag]"` or
+`uv tool install "boost-skill-cli[rag]"` and landed on 3.15 with no key set,
+`boost quickstart` and `boost self-update` offer to move boost to a Python
+3.13 that pipx or uv downloads and manages. They ask first. Say yes and the
+manager rebuilds boost's environment on 3.13 with the extra, and quickstart
+then carries on from the new install. Pass `--keep-python` to either command
+to stay where you are.
+
 `pipx` keeps boost in its own isolated environment, which is why it is the recommended
 route. Without pipx, use an explicit interpreter — a bare `pip` is often absent
 or points at the wrong Python:
@@ -154,8 +186,16 @@ Upgrading later is one command, whichever way you installed:
 ```bash
 boost self-update             # detects pipx / pip / uv / a git checkout and drives it
 boost self-update --dry-run   # print the command it would run, change nothing
+boost self-update --python 3.13   # rebuild a pipx / uv install on another Python, extras kept
+boost self-update --keep-python   # upgrade only, never move to Python 3.13
 ```
 
+On a Python the `[rag]` extra has no onnxruntime wheel for, a pipx or uv
+install with the extra and no API key gets one extra question: move to Python
+3.13 first? Yes runs a single `pipx reinstall` or `uv tool install` on 3.13,
+which also picks up the latest release. No runs the normal upgrade. `--dry-run`
+prints the reason and the exact command without running it.
+
 It reads evidence on disk — `.git`, then `pipx_metadata.json` or `uv-receipt.toml`,
 then installed package metadata — and for a pip install runs `sys.executable -m pip`
 rather than a bare `pip`, which can belong to a different interpreter and would
@@ -195,6 +235,11 @@ pipx inject boost-skill-cli "boost-skill-cli[rag]"   # or: uv tool install "boos
 boost quickstart                                     # downloads prebuilt vectors
 ```
 
+The keyless model needs Python 3.14 or older until onnxruntime publishes 3.15
+wheels. On 3.15, `boost quickstart` offers to move a pipx or uv install to
+3.13 and keeps the extra. `boost self-update --python 3.13` does the same move
+on its own.
+
 `boost quickstart` is the fast path: it taps the starter registries **pinned to
 the commits the published vectors were built from**, then downloads and imports
 those vectors. It pins them even before the extra is installed, so running it

boost_skill_cli-1.2.208/PKG-INFO → boost_skill_cli-1.2.210/README.md

@@ -1,50 +1,8 @@
-Metadata-Version: 2.4
-Name: boost-skill-cli
-Version: 1.2.208
-Summary: boost — Homebrew for AI coding skills
-Author: Jonathan Reyes
-License-Expression: Apache-2.0
-Project-URL: Homepage, https://github.com/jonnyeclectic/boost
-Project-URL: Repository, https://github.com/jonnyeclectic/boost
-Project-URL: Changelog, https://github.com/jonnyeclectic/boost/releases
-Keywords: ai,skills,package-manager,claude-code,cursor,windsurf,cli
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Software Development :: Build Tools
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: rag
-Requires-Dist: sqlite-vec>=0.1.6; extra == "rag"
-Requires-Dist: onnxruntime>=1.17; extra == "rag"
-Requires-Dist: tokenizers>=0.15; extra == "rag"
-Provides-Extra: eval
-Requires-Dist: ranx>=0.3.20; extra == "eval"
-Requires-Dist: ragas<0.3,>=0.2; extra == "eval"
-Requires-Dist: langchain-core<0.4; extra == "eval"
-Requires-Dist: langchain-community<0.4; extra == "eval"
-Requires-Dist: langchain-openai<1; extra == "eval"
-Provides-Extra: langchain
-Requires-Dist: langchain-core<2,>=1; extra == "langchain"
-Requires-Dist: pydantic>=2; extra == "langchain"
-Provides-Extra: bdd
-Requires-Dist: behave>=1.2.6; extra == "bdd"
-Provides-Extra: perf
-Requires-Dist: pytest-benchmark>=4.0; extra == "perf"
-Dynamic: license-file
-
 # boost — a package manager for AI coding skills
 
 [![CI](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml/badge.svg)](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/v/release/jonnyeclectic/boost)](https://github.com/jonnyeclectic/boost/releases/latest)
-[![Python 3.12–3.14](https://img.shields.io/badge/python-3.12%E2%80%933.14-blue)](https://github.com/jonnyeclectic/boost/blob/main/.github/workflows/ci.yml)
+[![Python 3.12–3.15](https://img.shields.io/badge/python-3.12%E2%80%933.15-blue)](https://github.com/jonnyeclectic/boost/blob/main/.github/workflows/ci.yml)
 [![Coverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjonnyeclectic%2Fboost%2Fbadges%2Fcoverage.json)](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml)
 [![Mutation score](https://img.shields.io/badge/mutation_score-%E2%89%A580%25_killed-blueviolet)](https://github.com/jonnyeclectic/boost/blob/main/scripts/mutation_gate.py)
 [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey)](https://github.com/jonnyeclectic/boost/actions/workflows/ci.yml)
@@ -132,11 +90,42 @@ way to end up at `boost: command not found`.
 ## Install
 
 ```bash
-pipx install boost-skill-cli
+pipx install --python 3.13 --fetch-python=always "boost-skill-cli[rag]"
 boost --version
 boost tap --defaults
 ```
 
+With uv it is
+`uv tool install --managed-python --python 3.13 "boost-skill-cli[rag]"`.
+Plain `pipx install boost-skill-cli` also works if you only want keyword
+search.
+
+The command pins the interpreter because pipx and uv build boost's
+environment on one Python and keep a link to it. When Homebrew upgrades past
+a `python@3.X` formula it deletes the old one, the link breaks, and `boost`
+fails before it starts with `bad interpreter: no such file or directory`.
+[DEBUGGING](docs/DEBUGGING.md#boost-bad-interpreter-after-a-homebrew-upgrade)
+has the one-command fix. `--fetch-python=always` (pipx 1.18 or later) makes
+pipx download its own 3.13 even when Homebrew has one, and
+`--managed-python` does the same for uv, so a Homebrew cleanup can't touch
+either. The older flag, `--fetch-missing-python`, only downloads when no
+`python3.13` is on PATH. On a Mac with Homebrew's 3.13 it uses that one, and
+you are back where you started.
+
+The install command pins 3.13 rather than the newest Python because the
+`[rag]` extra's local embedding model runs on onnxruntime, and onnxruntime
+has wheels for 3.11 to 3.14 but not 3.15. On 3.15 the extra installs without
+it. Keyword search still works, and so does semantic search if you set
+`VOYAGE_API_KEY` or `OPENAI_API_KEY`.
+
+If you installed with plain `pipx install "boost-skill-cli[rag]"` or
+`uv tool install "boost-skill-cli[rag]"` and landed on 3.15 with no key set,
+`boost quickstart` and `boost self-update` offer to move boost to a Python
+3.13 that pipx or uv downloads and manages. They ask first. Say yes and the
+manager rebuilds boost's environment on 3.13 with the extra, and quickstart
+then carries on from the new install. Pass `--keep-python` to either command
+to stay where you are.
+
 `pipx` keeps boost in its own isolated environment, which is why it is the recommended
 route. Without pipx, use an explicit interpreter — a bare `pip` is often absent
 or points at the wrong Python:
@@ -154,8 +143,16 @@ Upgrading later is one command, whichever way you installed:
 ```bash
 boost self-update             # detects pipx / pip / uv / a git checkout and drives it
 boost self-update --dry-run   # print the command it would run, change nothing
+boost self-update --python 3.13   # rebuild a pipx / uv install on another Python, extras kept
+boost self-update --keep-python   # upgrade only, never move to Python 3.13
 ```
 
+On a Python the `[rag]` extra has no onnxruntime wheel for, a pipx or uv
+install with the extra and no API key gets one extra question: move to Python
+3.13 first? Yes runs a single `pipx reinstall` or `uv tool install` on 3.13,
+which also picks up the latest release. No runs the normal upgrade. `--dry-run`
+prints the reason and the exact command without running it.
+
 It reads evidence on disk — `.git`, then `pipx_metadata.json` or `uv-receipt.toml`,
 then installed package metadata — and for a pip install runs `sys.executable -m pip`
 rather than a bare `pip`, which can belong to a different interpreter and would
@@ -195,6 +192,11 @@ pipx inject boost-skill-cli "boost-skill-cli[rag]"   # or: uv tool install "boos
 boost quickstart                                     # downloads prebuilt vectors
 ```
 
+The keyless model needs Python 3.14 or older until onnxruntime publishes 3.15
+wheels. On 3.15, `boost quickstart` offers to move a pipx or uv install to
+3.13 and keeps the extra. `boost self-update --python 3.13` does the same move
+on its own.
+
 `boost quickstart` is the fast path: it taps the starter registries **pinned to
 the commits the published vectors were built from**, then downloads and imports
 those vectors. It pins them even before the extra is installed, so running it

{boost_skill_cli-1.2.208 → boost_skill_cli-1.2.210}/boost_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.2.208'
-__version_tuple__ = version_tuple = (1, 2, 208)
+__version__ = version = '1.2.210'
+__version_tuple__ = version_tuple = (1, 2, 210)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.2.208 → boost_skill_cli-1.2.210}/boost_cli/commands/_common.py

@@ -63,8 +63,9 @@ def _require_lock_integrity() -> None:
         raise BoostError(
             "lock file missing — the store has skills but nothing is recorded",
             hint="run `boost sync`")
-    if integ.problem == "corrupt":
-        raise BoostError("lock file is corrupt — %s" % lockfile.remedy(integ))
+    if integ.problem in ("corrupt", "unreadable"):
+        raise BoostError("lock file %s — %s"
+                         % (lockfile.fault(integ), lockfile.remedy(integ)))
     if lockfile.newer(integ):
         raise BoostError("lock file %s" % lockfile.fault(integ),
                          hint=lockfile.remedy(integ))

{boost_skill_cli-1.2.208 → boost_skill_cli-1.2.210}/boost_cli/commands/bmad.py

@@ -813,23 +813,47 @@ def _status(scope) -> int:
 
 def _uninstall(scope, yes, force: bool = False) -> int:
     scope = scope or "project"
-    if not (yes or out.confirm(
-            "Remove BMAD (%s)? deletes bmad-* skills%s" % (
-                scope, " + _bmad/, _bmad-output/" if scope == "project" else ""))):
+    skills, kept = core.skill_dirs(_skills_dir(scope))
+    extras: list[Path] = []
+    linked_extras: list[Path] = []
+    for extra in ("_bmad", "_bmad-output") if scope == "project" else ():
+        pth = Path.cwd() / extra
+        if pth.is_symlink():
+            linked_extras.append(pth)    # remove_dirs never follows a link
+        elif pth.is_dir():
+            extras.append(pth)
+    # The confirm names what it deletes: "deletes bmad-* skills" was all a
+    # user approved, which hid both a count of nothing and a symlink the run
+    # then could not remove.
+    doomed = [*skills, *extras]
+    what = ("deletes %s" % ", ".join(paths.tilde(p) for p in doomed)
+            if doomed else "no bmad-* skills to delete")
+    if not (yes or out.confirm("Remove BMAD (%s)? %s" % (scope, what))):
         out.info("aborted")
         return 1
-    _remove_hook_everywhere(scope, _ORIENT_HOOK, _ROUTE_HOOK, force=force)
-    removed = _rm_skills(_skills_dir(scope))
+    hooks = _remove_hook_everywhere(scope, _ORIENT_HOOK, _ROUTE_HOOK,
+                                    force=force)
+    removed = len(core.remove_dirs(skills))
     removed += len(core.remove_personas(_agents_dir(scope)))
-    if scope == "project":
-        for extra in ("_bmad", "_bmad-output"):
-            pth = Path.cwd() / extra
-            if pth.exists():
-                shutil.rmtree(pth, ignore_errors=True)
-                removed += 1
+    removed += len(core.remove_dirs(extras))
+    for entry in kept:
+        out.info(out.role("kept %s — not a BMAD install (a %s); `boost "
+                          "uninstall %s` removes one boost installed"
+                          % (paths.tilde(entry), "symlink" if entry.is_symlink()
+                             else "file", entry.name), "muted"), wrap=True)
+    for entry in linked_extras:
+        # Not a skill, so `boost uninstall <name>` is no answer for it: the
+        # link may well lead to the user's real BMAD runtime elsewhere.
+        out.info(out.role("kept %s — a symlink, and uninstall never deletes "
+                          "through one; remove it yourself if it is BMAD's"
+                          % paths.tilde(entry), "muted"), wrap=True)
     _clear_scope_state(scope)
+    if not (removed or hooks):
+        out.info("nothing of BMAD's to remove (%s)" % scope)
+        return 0
     journal.log("bmad-uninstall", scope, count=removed)
-    out.ok("removed BMAD (%s): %d item(s)" % (scope, removed))
+    out.ok("removed BMAD (%s): %d item(s)%s" % (
+        scope, removed, ", %d hook(s)" % hooks if hooks else ""))
     return 0
 
 
@@ -953,15 +977,6 @@ def _count_skills(skills_dir: Path) -> int:
     return sum(1 for d in skills_dir.glob("bmad-*") if d.is_dir())
 
 
-def _rm_skills(skills_dir: Path) -> int:
-    n = 0
-    if skills_dir.exists():
-        for d in sorted(skills_dir.glob("bmad-*")):
-            shutil.rmtree(d, ignore_errors=True)
-            n += 1
-    return n
-
-
 def _quarantine_dir(scope) -> Path:
     key = "global" if scope == "global" else _fs_slug(str(Path.cwd().resolve()))
     return paths.state_dir() / "bmad-quarantine" / key
@@ -1071,9 +1086,17 @@ def _set_scope_state(scope, **patch) -> None:
 
 
 def _clear_scope_state(scope) -> None:
-    d = _state_read()
+    """Forget ``scope``'s BMAD state, writing nothing when there is none.
+
+    An uninstall on a machine BMAD never touched used to create
+    ``bmad.json`` just to record that nothing was there. A corrupt file is
+    still written through, which is what quarantines it.
+    """
+    d, err = _state_load()
     if scope == "global":
+        held = bool(d["global"])
         d["global"] = {}
     else:
-        d["projects"].pop(_proj_key(), None)
-    _state_write(d)
+        held = d["projects"].pop(_proj_key(), None) is not None
+    if held or err is not None:
+        _state_write(d)

{boost_skill_cli-1.2.208 → boost_skill_cli-1.2.210}/boost_cli/commands/configuration.py

@@ -35,6 +35,7 @@ from ..core import (
     installscan,
     integrity,
     journal,
+    localembed,
     lockfile,
     mcp,
     mcphost,
@@ -190,8 +191,9 @@ def cmd_clean(argv) -> int:
     # clean deleted it anyway when it walked `known_agents`. The exception is
     # a native-store dir boost recorded linking into before that agent's
     # `links_skills` went false: what dangles into the store there is boost's.
-    for adir in (*agents.sweep_dirs(),
-                 *(d for _a, d in agents.remembered_native_dirs())):
+    for adir in agents.unique_dirs(
+            [*agents.sweep_dirs(),
+             *(d for _a, d in agents.remembered_native_dirs())]):
         # ``os.path``: ``Path.is_dir`` raises under a dir with no search bit
         # on Python 3.12 and 3.13.
         if not os.path.isdir(adir):  # noqa: FURB146
@@ -207,7 +209,14 @@ def cmd_clean(argv) -> int:
         )
 
     configured = {t.safe_name for t in registry.list_taps()}
-    if paths.cache_dir().is_dir():
+    # With config.json unreadable or corrupt, the tap list is DEFAULTS' empty
+    # one, so every tap's cache read as stale and was deleted — on a file
+    # whose bytes, under a mode-000 config, still list every one of them.
+    cfg_err = config.check()
+    if cfg_err:
+        out.warn("left the tap caches alone: %s" % cfg_err,
+                 stream=sys.stderr, wrap=True)
+    elif paths.cache_dir().is_dir():
         # Skip boost's own derived artifacts. They live in the same directory and
         # end in .json, but no tap is named `rag_index` or `discovery`, so the
         # stem test alone called both stale and deleted them every run — see
@@ -494,8 +503,9 @@ def cmd_compact(argv) -> int:
         except BoostError as e:
             broken += 1
             rows.append({"tap": tap.name, "error": str(e)})
-            out.warn("could not compact %s: %s" % (tap.name, e),
-                     stream=sys.stderr if args.json else None)
+            out.warn("could not compact %s: %s%s"
+                     % (tap.name, e, " — %s" % e.hint if e.hint else ""),
+                     stream=sys.stderr if args.json else None, wrap=True)
             continue
         after = util.dir_size(tap.path)
         # A re-clone did real work — refreshed the clone, possibly moved it
@@ -2586,9 +2596,9 @@ def _seed_catalog_for_mcp(force: bool) -> None:
     # 14-45s of network with nothing to show for it until it finishes — on
     # the one command a first-time user was told to run, silence that long
     # reads as a hang.
-    if bootstrap.will_seed(force=force):
+    if plan := bootstrap.seed_plan(force=force):
         out.info("no registries tapped yet — adding the %d recommended ones "
-                 "(one-time, needs the network)" % len(config.DEFAULT_TAPS))
+                 "(one-time, needs the network)" % len(plan))
     res = bootstrap.seed_catalog(force=force)
     if res.skipped:
         return
@@ -2609,39 +2619,24 @@ def _seed_catalog_for_mcp(force: bool) -> None:
 NO_RULE_ENV = "BOOST_NO_RULE"
 
 
-def _offer_boost_first(hosts: list[str]) -> None:
-    """Offer to install boost's own rule into the agent's standing instructions.
-
-    This is the most invasive thing boost can propose, and the only text it
-    asks to put in a file the user reads every session, in every project — so
-    the consent has to be real rather than procedural. The body is printed in
-    full BEFORE the question, the target paths are named, the answer defaults
-    to NO, and the reversal command is shown whether or not they accept.
-
-    Why it exists at all: Gemini never delivers MCP server `instructions` in
-    interactive mode, and in an untrusted folder — which a brand-new project
-    directory is by default — it does not start the server, so boost has no
-    tools there either. `~/.gemini/GEMINI.md` is loaded unconditionally and is
-    the only boost surface that survives both. Declining is a perfectly good
-    answer; the tool descriptions still carry the trigger on every host that
-    delivers them.
+def _boost_first_targets(hosts: list[str]) -> list[str]:
+    """The files :func:`_offer_boost_first` would offer to write; [] for no offer.
 
-    Non-fatal by construction. The user asked to register an MCP server; a
-    failure to materialise an optional rule must never turn that into an
-    error, so everything below degrades to a warning.
+    Every gate that does not need the registration to have run, in one place,
+    so `boost mcp register --dry-run` names the offer exactly when the real
+    run would make it.
     """
     from ..core import builtin
 
     if typedvalue.env_flag(NO_RULE_ENV, unknown=True):
-        return
+        return []
     # Scoped to hosts where boost actually registered a server. Offering it for
     # an agent with no boost tools would install standing text naming
     # `boost_search` to an agent that does not have it.
     if not hosts or not builtin.rule_is_available():
-        return
+        return []
     if lockfile.get_rule(builtin.BUILTIN_RULES[0]):
-        return                      # already installed; do not re-ask
-    body = (builtin.source_dir() / (builtin.BUILTIN_RULES[0] + ".mdc"))
+        return []                   # already installed; do not re-ask
     scoped_agents = {builtin.AGENT_FOR_HOST.get(h) for h in hosts}
     # materializing_agents, not enabled_agents: this is a *rule*, so the
     # preview has to be built from the set the rule install actually writes to,
@@ -2658,12 +2653,40 @@ def _offer_boost_first(hosts: list[str]) -> None:
     # below means the offer is never made and `store.install` never runs. So
     # the failure this prevents is a printed path that no install backs, not a
     # refusal.
-    targets = [str(rules.rule_target(agent, skills_dir,
-                                     builtin.BUILTIN_RULES[0])[1])
-               for agent, skills_dir in agents.materializing_agents().items()
-               if agent in scoped_agents]
+    return [str(rules.rule_target(agent, skills_dir,
+                                  builtin.BUILTIN_RULES[0])[1])
+            for agent, skills_dir in agents.materializing_agents().items()
+            if agent in scoped_agents]
+
+
+def _offer_boost_first(hosts: list[str]) -> None:
+    """Offer to install boost's own rule into the agent's standing instructions.
+
+    This is the most invasive thing boost can propose, and the only text it
+    asks to put in a file the user reads every session, in every project — so
+    the consent has to be real rather than procedural. The body is printed in
+    full BEFORE the question, the target paths are named, the answer defaults
+    to NO, and the reversal command is shown whether or not they accept.
+
+    Why it exists at all: Gemini never delivers MCP server `instructions` in
+    interactive mode, and in an untrusted folder — which a brand-new project
+    directory is by default — it does not start the server, so boost has no
+    tools there either. `~/.gemini/GEMINI.md` is loaded unconditionally and is
+    the only boost surface that survives both. Declining is a perfectly good
+    answer; the tool descriptions still carry the trigger on every host that
+    delivers them.
+
+    Non-fatal by construction. The user asked to register an MCP server; a
+    failure to materialise an optional rule must never turn that into an
+    error, so everything below degrades to a warning.
+    """
+    from ..core import builtin
+
+    targets = _boost_first_targets(hosts)
     if not targets:
         return
+    body = (builtin.source_dir() / (builtin.BUILTIN_RULES[0] + ".mdc"))
+    scoped_agents = {builtin.AGENT_FOR_HOST.get(h) for h in hosts}
     out.info("")
     out.info("boost can also add its own rule, `%s`, to your agents' standing "
              "instructions:" % builtin.BUILTIN_RULES[0])
@@ -2748,7 +2771,9 @@ def cmd_mcp(argv) -> int:
     shim = str(paths.launcher())
     verb = "register" if args.action == "register" else "unregister"
 
+    seeding = args.action == "register" and (args.seed_ok or args.seed)
     if args.dry_run:
+        would_settle: list[str] = []
         # Before seeding and before any subprocess runs — the flag exists so
         # the argv boost would run is visible in the one case that mattered
         # (`--host gemini` with `gemini` on PATH), not only the one case that
@@ -2769,6 +2794,20 @@ def cmd_mcp(argv) -> int:
             note = "  — outside this $HOME, refused without --force" \
                 if escape else ""
             out.dim("  writes %s%s" % (cfg, note))
+            if installed and not escape:
+                would_settle.append(host)
+        if seeding and (plan := bootstrap.seed_plan(force=args.seed)):
+            # The real run taps these before it touches any host — 14-45s of
+            # network a preview that stayed quiet about it would hide.
+            out.info("would tap %d recommended %s first (needs the network): "
+                     "%s" % (len(plan), "registry" if len(plan) == 1
+                             else "registries", ", ".join(plan)), wrap=True)
+        if args.action == "register" and (
+                rule_targets := _boost_first_targets(would_settle)):
+            from ..core import builtin
+            out.info("would then offer to add the `%s` rule to %s (asks first)"
+                     % (builtin.BUILTIN_RULES[0], ", ".join(rule_targets)),
+                     wrap=True)
         out.dim("  dry run — nothing was %sed, nothing tapped" % verb, wrap=True)
         return 0
 
@@ -2777,7 +2816,7 @@ def cmd_mcp(argv) -> int:
     # typo'd `--host` spent 14-45s and half a gigabyte before argparse's own
     # error, and seeding last would have registered a server the user then
     # watches answer nothing while the clones run.
-    if args.action == "register" and (args.seed_ok or args.seed):
+    if seeding:
         _seed_catalog_for_mcp(args.seed)
 
     # `auto` skips hosts that are not installed; naming a host explicitly (or
@@ -2877,9 +2916,27 @@ def cmd_self_update(argv) -> int:
         description="Update boost itself to the latest version")
     p.add_argument("--dry-run", action="store_true",
                    help="show how boost would update itself, change nothing")
+    p.add_argument("--python", type=util.nonempty_str, metavar="VERSION",
+                   help="rebuild boost's pipx or uv tool venv on this Python "
+                        "(e.g. 3.13), downloading the manager's own build "
+                        "of it, and keep its extras — the way off an "
+                        "interpreter Homebrew removed, or one the [rag] "
+                        "extra has no wheel for")
+    p.add_argument("--keep-python", action="store_true",
+                   help="skip moving to the recommended Python")
     args = p.parse_args(argv)
 
     method = selfupdate.detect()
+    if args.python is not None:
+        return _self_update_python(method, args.python, dry_run=args.dry_run)
+    reason = None if args.keep_python else selfupdate.relocation_reason(method)
+    if reason:
+        py = localembed.RECOMMENDED_PYTHON
+        out.warn(selfupdate.relocation_offer(method, reason), wrap=True)
+        if args.dry_run or out.confirm("Move boost to Python %s?" % py):
+            return _self_update_python(method, py, dry_run=args.dry_run)
+        out.info("staying on this Python; `boost self-update --python %s` "
+                 "moves it later" % py, wrap=True)
     if method != selfupdate.GIT:
         return _self_update_package(method, dry_run=args.dry_run)
     return _self_update_git(dry_run=args.dry_run)
@@ -2909,6 +2966,36 @@ def _self_update_package(method: str, dry_run: bool) -> int:
     return _report_no_op(method, new)
 
 
+def _self_update_python(method: str, python: str, dry_run: bool) -> int:
+    """Rebuild a pipx / uv-tool venv on another interpreter, keeping extras.
+
+    The observed interpreter is reported, not the requested one: the venv
+    keeps its path, so a fresh process at `sys.executable` is the honest
+    witness — and a manager that resolved `3.13` to something else says so.
+    """
+    cmd = selfupdate.reinstall_command(method, python)  # refuses pip/git
+    if dry_run:
+        out.info("installed with: %s" % method)
+        out.info("would run: %s" % shlex.join(cmd))
+        return 0
+    out.info("reinstalling via %s on Python %s: %s"
+             % (method, python, shlex.join(cmd)), wrap=True)
+    # The manager deletes and rebuilds the venv this process runs from, so
+    # from here on only modules already imported may be used.
+    selfupdate.run_upgrade(cmd, timeout=selfupdate.REINSTALL_TIMEOUT)
+    seen = selfupdate.observed_python()
+    new = selfupdate.observed_version()
+    journal.log("self-update", new or __version__, previous=__version__,
+                method=method, python=seen[0] if seen else python)
+    if new and new != __version__:
+        out.ok("boost v%s → v%s" % (__version__, new))
+    ok, warn = selfupdate.python_report(method, seen)
+    out.ok(ok)
+    if warn:
+        out.warn(warn, wrap=True)
+    return 0
+
+
 def _report_no_op(method: str, here: str) -> int:
     """Explain a manager that exited 0 without moving the version.
 

{boost_skill_cli-1.2.208 → boost_skill_cli-1.2.210}/boost_cli/commands/discovery.py

@@ -34,6 +34,7 @@ from ..core import (
     installscan,
     integrity,
     journal,
+    jsonstate,
     lockfile,
     paths,
     prereq,
@@ -140,6 +141,12 @@ def cmd_search(argv):
         # query at all, so it gets the same answer and argparse's rc 2.
         p.error("the query is empty — give at least one search term")
     if not registry.list_taps():
+        cfg_err = config.check()
+        if isinstance(cfg_err, jsonstate.Unreadable):
+            # The taps may all be in it; `tap --defaults` is refused over it.
+            raise BoostError("%s — no taps are read, so nothing was searched"
+                             % cfg_err,
+                             hint=jsonstate.read_remedy(cfg_err, paths.tilde))
         raise BoostError("no taps configured — nothing to search",
                         hint="add the recommended registries with `boost tap --defaults`")
     # Full-content (RAG) search is the default: build the index on first use so
@@ -746,10 +753,11 @@ def cmd_reindex(argv):
         if dense_stats is None:
             from ..core import dense
             st = dense.status()
-            # The extra is here and cannot load: "install the extra" would
-            # name the step this machine already took.
+            # The extra is here and cannot load, or is here without the
+            # model runtime this interpreter has no wheel for: "install the
+            # extra" would name the step this machine already took.
             note = (dense.fix_hint(st["reason"], st)
-                    if st["reason"] == "no-extension-load"
+                    if st["reason"] in ("no-extension-load", "no-local-wheel")
                     else embed.fallback_note())
             out.warn("dense index skipped — %s" % note, wrap=True)
         elif dense_stats.get("refused"):