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

{boost_skill_cli-1.2.209 → boost_skill_cli-1.2.211}/.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.211}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.2.209
+Version: 1.2.211
 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.211/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.211}/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.211'
+__version_tuple__ = version_tuple = (1, 2, 211)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.2.209 → boost_skill_cli-1.2.211}/boost_cli/commands/configuration.py

@@ -35,6 +35,7 @@ from ..core import (
     installscan,
     integrity,
     journal,
+    localembed,
     lockfile,
     mcp,
     mcphost,
@@ -207,7 +208,6 @@ def cmd_clean(argv) -> int:
             and store.points_into_store(link)
         )
 
-    configured = {t.safe_name for t in registry.list_taps()}
     # 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.
@@ -219,11 +219,13 @@ def cmd_clean(argv) -> int:
         # 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
-        # paths.INTERNAL_CACHE_FILES.
+        # paths.INTERNAL_CACHE_FILES. A live tap's cache spelled in another
+        # case on disk is the same file, and `stale_caches` asks the disk.
         items.extend(
             (f, "stale tap cache", f.stat().st_size)
-            for f in sorted(paths.cache_dir().glob("*.json"))
-            if f.stem not in configured and f.name not in paths.INTERNAL_CACHE_FILES
+            for f in registry.stale_caches([
+                c for c in sorted(paths.cache_dir().glob("*.json"))
+                if c.name not in paths.INTERNAL_CACHE_FILES])
         )
 
     if paths.lock_history_dir().is_dir():
@@ -1993,9 +1995,12 @@ def _install_lines(res: store.InstallResult, entry: dict) -> list[str]:
     # A workflow's copy in the skill store is how a skills-only agent reaches
     # it; an agent told nothing concludes the same as above.
     if res.skill_copy is not None:
-        lines.append("as a skill: %s" % res.skill_copy)
+        lines.append("as a skill: %s%s" % (
+            res.skill_copy, " (linked for %s)" % ", ".join(res.copy_linked)
+            if res.copy_linked else ""))
     if res.skill_note:
         lines.append(res.skill_note)
+    lines += ["skill copy not linked: %s" % why for why in res.copy_blocked]
     # Skill-only, as `boost install` prints it: a rule or workflow has no
     # score, and "quality score: 0/100" told the agent a valid one scored zero.
     if res.kind == "skill":
@@ -2110,6 +2115,14 @@ def _tool_doctor(args: dict):
         "out_of_scope_links": lambda rows: [
             "%s is linked for %s, outside its declared scope — `boost sync "
             "--prune` removes the link" % (n, a) for n, a in rows],
+        "missing_copy_links": lambda rows: [
+            "workflow %s's skill copy is not linked for %s — `boost sync` "
+            "links it" % (n, a) for n, a in rows],
+        "stale_copy_links": lambda rows: [
+            "workflow %s's skill copy is linked for %s, %s — `boost sync` "
+            "removes the link"
+            % (n, a, store.stale_copy_reason(lockfile.get_workflow(n) or {},
+                                             a)) for n, a in rows],
         "unrecorded_store": unrecorded,
     }
     for key, vals in plan.items():
@@ -2915,9 +2928,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 +2978,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.211}/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.211}/boost_cli/commands/pkg.py

@@ -281,6 +281,19 @@ def _report_result(res: store.InstallResult, no_mcp: bool = False) -> None:
         where = " (this repo)" if res.scope == "project" else ""
         out.ok("materialized%s → %s"
                % (where, " · ".join(res.linked) or "(no enabled agents)"))
+        # An agent the config keeps out gets no row, so nothing after this
+        # report would ever name it (`store.skipped_agents`) -- unless a
+        # workflow's skill copy was linked into it, which the line says.
+        copied = set(getattr(res, "copy_linked", None) or ())
+        for agent, why in getattr(res, "skipped_agents", None) or ():
+            out.dim("  %s" % agents.skip_line(agent, why,
+                                              via_copy=agent in copied),
+                    wrap=True)
+        # A subagent is not `/<name>`, and the install line alone reads as
+        # though it were (`workflows.invocation_hint`). It quotes the
+        # frontmatter `name`, a tap's text, so it is printed plain.
+        for line in getattr(res, "invocation", None) or ():
+            out.dim("  %s" % out.plain(line), wrap=True)
         _report_skill_copy(res)
         _warn_unwritable(res)
         out.ok("lock updated (.skill-lock.json)")
@@ -324,8 +337,14 @@ def _report_skill_copy(res) -> None:
     predicts. Why there is none is :func:`_warn_unwritable`'s to say, so
     update, reinstall and sync say it too."""
     copy = getattr(res, "skill_copy", None)
+    linked = getattr(res, "copy_linked", None) or []
     if copy is not None:
-        out.ok("as a skill → %s" % _tilde(copy))
+        # The agents that reach it through a link: those with no file of
+        # the workflow's own (`store.copy_link_targets`).
+        out.ok("as a skill → %s%s" % (_tilde(copy), ", linked → %s"
+                                      % " · ".join(linked) if linked else ""))
+    for agent in getattr(res, "copy_unlinked", None) or ():
+        out.dim("  %s: unlinked its skill copy" % agent, wrap=True)
 
 
 def _warn_submodules(res, stream=None) -> None:
@@ -353,9 +372,16 @@ def _warn_unwritable(res, stream=None) -> None:
     note = getattr(res, "skill_note", None)
     if note:
         out.info(note, stream=stream, wrap=True)
+    # A link to that copy something of the user's held the place of.
+    for line in getattr(res, "copy_blocked", None) or ():
+        out.warn("%s: skill copy not linked: %s" % (res.name, line),
+                 stream=stream, wrap=True)
     # Written, but not everything in the source survived the conversion.
+    # Plain: a note may quote the file it is about (a subagent's `tools`
+    # entries), and that file is a tap's.
     for line in getattr(res, "render_notes", None) or ():
-        out.warn("%s: %s" % (res.name, line), stream=stream, wrap=True)
+        out.warn("%s: %s" % (res.name, out.plain(line)), stream=stream,
+                 wrap=True)
     # A link in the skill the copy left out: the rest installed, and this
     # names the file the skill may still expect.
     for line in getattr(res, "skipped_links", None) or ():
@@ -549,9 +575,16 @@ def _install_closure(entries: list[dict], *, scope: str = scopes.SCOPE_USER,
 # ── install ──────────────────────────────────────────────────────────────
 
 def _preview_skill_copy(e: dict, seen: dict | None, as_skill: bool | None,
-                        scope: str) -> None:
+                        scope: str, written=(), narrowed: bool = False
+                        ) -> None:
     """The dry run's line for a workflow's skill copy, asked the way the run
-    decides it, so the two agree."""
+    decides it, so the two agree.
+
+    Its links go to the linking agents outside ``written``, the agents the
+    run writes the workflow's file for, and nowhere under a ``narrowed``
+    scope. A path the user's own file holds, or an agent that would reject
+    the file, is only found by the run, which leaves those out too.
+    """
     from ..core import workflows
     if scope == scopes.SCOPE_PROJECT or not store.wants_skill_copy(as_skill,
                                                                    seen):
@@ -570,7 +603,10 @@ def _preview_skill_copy(e: dict, seen: dict | None, as_skill: bool | None,
     if blocker:
         out.info("  %s" % blocker, wrap=True)
         return
-    out.info("  as a skill → %s" % _tilde(store.skill_store_dir(e["name"])))
+    linked = store.copy_link_agents(set(written), narrowed=narrowed)
+    out.info("  as a skill → %s%s"
+             % (_tilde(store.skill_store_dir(e["name"])),
+                ", linked → %s" % " · ".join(linked) if linked else ""))
 
 
 def _refuse_preview_by_policy(e: dict, scope: str, pbase, seen) -> None:
@@ -792,8 +828,10 @@ def cmd_install(argv: list[str]) -> int:
                                 e["tap"], where))
                     out.info("  materialize → %s" % " · ".join(mat))
                     if k == "workflow":
-                        _preview_skill_copy(e, seen, args.as_skill,
-                                            args.scope)
+                        _preview_skill_copy(
+                            e, seen, args.as_skill, args.scope, written=mat,
+                            narrowed=bool(only or (seen or {}).get(
+                                "only_agents")))
                     continue
                 # Same refusal as the run ("already installed", "is pinned");
                 # past it, a seen record is one --force overwrites.
@@ -1150,10 +1188,14 @@ _PLAN_LABELS = [
     ("unrecorded_store", "store dirs the lock file has lost"),
     ("missing_materializations", "missing rule/workflow files"),
     ("out_of_scope_links", "linked outside declared scope"),
+    ("missing_copy_links", "workflow skill copies missing a link"),
+    ("stale_copy_links", "workflow skill copies linked beside the "
+                         "workflow's own file or outside its --agent scope"),
 ]
 
 #: Plan keys whose items are ``(skill, agent)`` pairs rather than paths.
-_PAIR_KEYS = ("missing_links", "out_of_scope_links")
+_PAIR_KEYS = ("missing_links", "out_of_scope_links", "missing_copy_links",
+              "stale_copy_links")
 
 #: ``unrecorded_store``'s label over a lock that is corrupt or in another
 #: schema: sync re-records what a missing lock lost, and nothing over these.

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

@@ -704,6 +704,13 @@ def cmd_doctor(argv):
                          "boost does not link into it"
                          % (aname, _tilde(spec["dir"]),
                             agents.display_name(aname)), wrap=True)
+        # A note, not an issue: `skills_only` is the user's own setting, and
+        # boost honours it. It is said because a profile copied from the
+        # antigravity row loses every subagent, command and rule with no
+        # line anywhere saying so (`store.skipped_agents`).
+        for aname in agents.claude_profile_rows():
+            rep.note("agent-config", agents.claude_profile_note(aname),
+                     wrap=True)
     for aname, err in agent_errs:
         key = "agents.%s.dir" % aname
         bad("agent-config", "%s: %s — %s, or set a path with `boost config set "
@@ -1351,6 +1358,20 @@ def cmd_doctor(argv):
                 mat_issues += 1
         if mat_issues == before:
             mat_issues += _drifted("workflow", name, entry, bad)
+        # Its skill copy's links, read as `boost sync` reads them, so the
+        # remedy named is the one that runs. A live link to the copy is
+        # expected; only a missing one, or one beside the workflow's own
+        # file or outside its `--agent` scope, is a fault.
+        for agent in store.missing_copy_links(name, entry):
+            bad("workflow", "workflow %s's skill copy is not linked for %s — "
+                "run `boost sync`" % (name, agent), wrap=True)
+            mat_issues += 1
+        for agent in store.stale_copy_links(name, entry):
+            bad("workflow", "workflow %s's skill copy is linked for %s, %s — "
+                "run `boost sync`"
+                % (name, agent, store.stale_copy_reason(entry, agent)),
+                wrap=True)
+            mat_issues += 1
     # A note, not an issue: the workflow works for every agent with a workflow
     # format. Only an agent that reads skills alone (Codex) misses it.
     unreached = store.workflows_without_skill_copy() if agents_ok else []
@@ -1375,6 +1396,20 @@ def cmd_doctor(argv):
                  % (len(off), _s(len(off)), "s" if len(off) == 1 else "",
                     ", ".join(shown), _mat_remedy(off)),
                  wrap=True)
+    # The agents the note above cannot see: excluded from the write set from
+    # the start, so they never got a row to be stale. A note for the same
+    # reason that one is -- the config said so -- and each agent once, with
+    # the items it skips, rather than a line per item.
+    left_out = store.skipped_agent_items() if agents_ok else []
+    if left_out:
+        rep.note("skipped-agents", "; ".join(
+            "%s for %s" % (agents.skip_line(agent, why, via_copy=copied),
+                           ", ".join(items[:_MAT_NOTE_SHOWN]
+                                     + (["and %d more"
+                                         % (len(items) - _MAT_NOTE_SHOWN)]
+                                        if len(items) > _MAT_NOTE_SHOWN
+                                        else [])))
+            for agent, why, copied, items in left_out), wrap=True)
     # The per-row note above answers "which row, which agent, why". This
     # answers a different question the surfaces had nowhere to put: skip every
     # row an item has and the item reached no agent at all. `rep.note`, not
@@ -1417,10 +1452,11 @@ def cmd_doctor(argv):
                 bits.append("%d workflow%s" % (quarantined_workflows,
                                                _s(quarantined_workflows)))
             note = " (%s quarantined)" % " and ".join(bits)
-        if off:
+        if off or left_out:
             # Without this the line reads as a flat contradiction of the note
             # right above it: "fully materialized" is true of the agents boost
-            # writes, and that is now a smaller set than the rows record.
+            # writes, and that is now a smaller set than the rows record --
+            # or than the agents a skill reaches.
             note += " for every agent boost writes"
         # Counted over the items that reach at least one agent. The suffix
         # above is what the note said this line contradicted -- "fully
@@ -1831,9 +1867,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: