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

{boost_skill_cli-1.2.209 → 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.209/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.209
+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.209/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.209
-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.209 → 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.209'
-__version_tuple__ = version_tuple = (1, 2, 209)
+__version__ = version = '1.2.210'
+__version_tuple__ = version_tuple = (1, 2, 210)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.2.209 → 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,
@@ -2915,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)
@@ -2947,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.209 → boost_skill_cli-1.2.210}/boost_cli/commands/discovery.py

@@ -753,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"):

{boost_skill_cli-1.2.209 → boost_skill_cli-1.2.210}/boost_cli/commands/quality.py

@@ -1831,9 +1831,13 @@ def _report_search_engine(rep) -> None:
                  hint=fix, wrap=True)
         return
 
+    # "not configured" is wrong for `no-local-wheel`: the extra is installed,
+    # and it is this interpreter that cannot carry its model runtime.
+    what = ("unavailable on this Python" if st["reason"] == "no-local-wheel"
+            else "not configured")
     rep.note("search-engine",
-             "semantic search not configured — using the full-content BM25 "
-             "engine (%s)" % fix, hint=fix, wrap=True)
+             "semantic search %s — using the full-content BM25 "
+             "engine (%s)" % (what, fix), hint=fix, wrap=True)
 
 
 def _print_skipped(skipped: list[dict]) -> None:

{boost_skill_cli-1.2.209 → boost_skill_cli-1.2.210}/boost_cli/commands/quickstart.py

@@ -17,7 +17,11 @@ them, and left alone.
 """
 from __future__ import annotations
 
-from .. import cliparse, spin
+import os
+import shlex
+import sys
+
+from .. import __version__, cliparse, spin
 from ..core import (
     bootstrap,
     catalog,
@@ -25,8 +29,10 @@ from ..core import (
     config,
     dense,
     journal,
+    localembed,
     rag,
     registry,
+    selfupdate,
     shards,
     util,
 )
@@ -342,8 +348,75 @@ def _reindex_moved(moved: list[str]) -> int:
     return entries
 
 
+def _relocate(argv: list[str], dry_run: bool) -> None:
+    """Move a pipx or uv install to the recommended Python, then start over.
+
+    A plain `pipx install 'boost-skill-cli[rag]'` on a Python onnxruntime has
+    no wheel for installs the store and no model, and a wheel cannot run code
+    at install time to fix that. Quickstart is the first command a new user
+    runs, so it offers the move (`selfupdate.relocation_reason` decides) and
+    re-execs itself on the rebuilt venv, where this process's imports are
+    stale. `RELOCATED_ENV` marks the child, so a move that did not take
+    continues here with the usual hint instead of looping.
+
+    Returns only when quickstart should carry on in this process.
+    """
+    if selfupdate.relocated():
+        return
+    method = selfupdate.detect()
+    reason = selfupdate.relocation_reason(method)
+    if not reason:
+        return
+    py = localembed.RECOMMENDED_PYTHON
+    try:
+        cmd = selfupdate.relocation_command(method)
+    except BoostError as e:
+        # pipx or uv is not on PATH, e.g. pipx run as `python3 -m pipx`.
+        # Quickstart still works without the move, so it says why there is
+        # none and carries on keyword-only.
+        out.warn("%s, so quickstart cannot move boost to Python %s"
+                 % (e.message, py), wrap=True)
+        if e.hint:
+            out.info(e.hint, wrap=True)
+        out.info("`--keep-python` skips this check", wrap=True)
+        return
+    out.warn(selfupdate.relocation_offer(method, reason), wrap=True)
+    if dry_run:
+        out.info("would run: %s, then `boost quickstart` again"
+                 % shlex.join(cmd), wrap=True)
+        return
+    if not out.confirm("Move boost to Python %s?" % py):
+        out.info("staying on this Python; `boost self-update --python %s` "
+                 "moves it later" % py, wrap=True)
+        return
+    out.info("reinstalling via %s: %s" % (method, shlex.join(cmd)), wrap=True)
+    # The manager rebuilds the venv this process runs from: everything used
+    # below is imported at the top of this module, never lazily.
+    selfupdate.run_upgrade(cmd, timeout=selfupdate.REINSTALL_TIMEOUT)
+    seen = selfupdate.observed_python()
+    # The manager replays the spec unpinned, so the move can land a newer
+    # release; this process imported its version before it, so ask a fresh one.
+    new = selfupdate.observed_version()
+    journal.log("self-update", new or __version__, previous=__version__,
+                method=method, python=seen[0] if seen else py)
+    ok, warn = selfupdate.python_report(method, seen)
+    out.ok(ok)
+    if warn:
+        out.warn(warn, wrap=True)
+    again = selfupdate.reexec_argv(["quickstart", *argv])
+    if again is None:
+        raise BoostError(
+            "boost moved to Python %s, but the rebuilt install was not found "
+            "to continue from" % py,
+            hint="run `boost quickstart` again")
+    os.environ[selfupdate.RELOCATED_ENV] = "1"
+    sys.stdout.flush()
+    sys.stderr.flush()
+    os.execv(again[0], again)  # noqa: S606 -- argv list, no shell; the venv just rebuilt
+
+
 def cmd_quickstart(argv) -> int:
-    """boost quickstart [--catalog] [--no-vectors] [--dry-run]"""
+    """boost quickstart [--catalog] [--no-vectors] [--keep-python] [--dry-run]"""
     p = cliparse.parser(
         prog="boost quickstart",
         description="Tap the starter registries and load prebuilt vectors")
@@ -352,9 +425,13 @@ def cmd_quickstart(argv) -> int:
                         "starters, and fetch vectors for all of them")
     p.add_argument("--no-vectors", action="store_true",
                    help="set up taps and keyword search only, skip shards")
+    p.add_argument("--keep-python", action="store_true",
+                   help="skip moving to the recommended Python")
     p.add_argument("--dry-run", action="store_true",
                    help="print what would happen, change nothing")
     args = p.parse_args(argv)
+    if not args.keep_python:
+        _relocate(list(argv), args.dry_run)
 
     manifest = None
     pins: dict[str, dict] = {}
@@ -428,7 +505,7 @@ def cmd_quickstart(argv) -> int:
             elif not dense.have_backend():
                 out.info("0 because semantic search needs the extra: `%s` — "
                          "keyword search works without it"
-                         % dense.install_extra(), wrap=True)
+                         % dense.extra_hint(), wrap=True)
             elif manifest is None:
                 _muted("(0 because the shard manifest could not be read — "
                        "keyword search is unaffected)")
@@ -470,7 +547,7 @@ def cmd_quickstart(argv) -> int:
         out.info(out.role("skipped vectors as asked", "muted"))
     elif not dense.have_backend():
         out.info("semantic search needs the extra: `%s`, then `boost "
-                 "quickstart` again" % dense.install_extra(), wrap=True)
+                 "quickstart` again" % dense.extra_hint(), wrap=True)
     elif want_vectors:
         # The whole vector step was skipped, and the only word about it was a
         # warning many screens back. Without this the run ends "✓ ready" as