boost-skill-cli 1.2.99__tar.gz → 1.2.101__tar.gz

{boost_skill_cli-1.2.99/boost_skill_cli.egg-info → boost_skill_cli-1.2.101}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.2.99
+Version: 1.2.101
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License-Expression: Apache-2.0
@@ -480,6 +480,7 @@ purely local operation, for CI images and air-gapped machines.
 |------|-----|---------------|
 | Claude Code | `claude` | `claude mcp add` → its user-scope MCP config |
 | Gemini CLI | `gemini` | `gemini mcp add -s user` → `~/.gemini/settings.json` |
+| Antigravity CLI | `agy` | `agy mcp add` → `~/.gemini/config/mcp_config.json` |
 
 Seven tools are exposed: `boost_search`, `boost_list`, `boost_info`,
 `boost_read`, `boost_install`, `boost_doctor` and

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/README.md

@@ -438,6 +438,7 @@ purely local operation, for CI images and air-gapped machines.
 |------|-----|---------------|
 | Claude Code | `claude` | `claude mcp add` → its user-scope MCP config |
 | Gemini CLI | `gemini` | `gemini mcp add -s user` → `~/.gemini/settings.json` |
+| Antigravity CLI | `agy` | `agy mcp add` → `~/.gemini/config/mcp_config.json` |
 
 Seven tools are exposed: `boost_search`, `boost_list`, `boost_info`,
 `boost_read`, `boost_install`, `boost_doctor` and

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/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.99'
-__version_tuple__ = version_tuple = (1, 2, 99)
+__version__ = version = '1.2.101'
+__version_tuple__ = version_tuple = (1, 2, 101)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/boost_cli/cli.py

@@ -52,20 +52,20 @@ GROUPS = {
 COMMANDS = [
     # Package Management (13)
     ("install",     "pkg", "pkg", "Install a skill from a tap registry"),
-    ("uninstall",   "pkg", "pkg", "Remove an installed skill, rule, workflow, or config"),
+    ("uninstall",   "pkg", "pkg", "Remove an installed skill, rule, or workflow"),
     ("sync",        "pkg", "pkg", "Reconcile installed skills & symlinks against the lock file"),
     ("update",      "pkg", "pkg", "Sync taps or update installed skills"),
-    ("reinstall",   "pkg", "pkg", "Reinstall a skill or all skills (force)"),
+    ("reinstall",   "pkg", "pkg", "Reinstall a skill, rule or workflow (force)"),
     ("bundle",      "pkg", "pkg", "Export/install skill sets via a Boostfile"),
     ("import",      "pkg", "pkg", "Import skills from a GitHub URL or local path"),
-    ("pin",         "pkg", "pkg", "Pin a skill to its current version"),
-    ("unpin",       "pkg", "pkg", "Allow a pinned skill to update again"),
+    ("pin",         "pkg", "pkg", "Pin a skill, rule or workflow to its current version"),
+    ("unpin",       "pkg", "pkg", "Allow a pinned skill, rule or workflow to update again"),
     ("snapshot",    "pkg", "pkg", "Save & restore whole skill environments"),
     ("export",      "pkg", "pkg", "Package skills as shareable zip/tar archives"),
-    ("adapt",       "pkg", "pkg", "Render a skill as another framework's agent source (CrewAI, Agents SDK)"),
+    ("adapt",       "pkg", "pkg", "Render a skill as another framework's agent source (CrewAI, Agents SDK, LangGraph)"),
     ("run",         "pkg", "run", "Adapt a skill, wire tools & run it as a live agent"),
     # Discovery & Search (9)
-    ("search",      "find", "discovery", "Search skills across tap registries (AI-ranked)"),
+    ("search",      "find", "discovery", "Search skills across tap registries (BM25; --smart reranks with Claude)"),
     ("reindex",     "find", "discovery", "Build/refresh the full-content search index"),
     ("discover",    "find", "discovery", "Search GitHub for skill repos you have not tapped yet"),
     ("recommend",   "find", "discovery", "Suggest skills based on your project's tech stack"),
@@ -86,10 +86,10 @@ COMMANDS = [
     ("deps",        "info", "info", "Show dependency & conflict relationships"),
     ("tag",         "info", "info", "Custom labels for organizing skills"),
     # Registry (Taps) (5)
-    ("tap",         "tap", "taps", "Add a GitHub repo as a skill registry"),
+    ("tap",         "tap", "taps", "Add a git URL, GitHub repo, or local directory as a skill registry"),
     ("untap",       "tap", "taps", "Remove a registry tap"),
     ("taps",        "tap", "taps", "List all configured registry taps"),
-    ("outdated",    "tap", "taps", "Show skills with available updates"),
+    ("outdated",    "tap", "taps", "Show skills, rules & workflows with available updates"),
     ("catalog",     "tap", "taps", "Share the tapped catalogue so others skip the clone"),
     # Intelligence (9)
     ("chat",        "ai", "intelligence", "Ask about skills in plain language (RAG-grounded)"),
@@ -100,7 +100,7 @@ COMMANDS = [
     ("evolve",      "ai", "intelligence", "Iteratively improve a skill from feedback"),
     ("context",     "ai", "intelligence", "Branch-aware skill activation"),
     ("focus",       "ai", "intelligence", "Temporarily prioritize skills for a work session"),
-    ("impact",      "ai", "intelligence", "Measure a skill's influence on code quality"),
+    ("impact",      "ai", "intelligence", "Correlate a skill's install date with repo activity"),
     # Quality & Health (15)
     ("doctor",      "chk", "quality", "Check installation health & report issues"),
     ("lint",        "chk", "quality", "Validate SKILL.md frontmatter & quality"),
@@ -109,7 +109,7 @@ COMMANDS = [
     ("drift",       "chk", "quality", "Detect installed skills diverging from source"),
     ("test",        "chk", "quality", "Validate installed skills against quality checks"),
     ("fingerprint", "chk", "quality", "Deterministic hash of the skill environment"),
-    ("quarantine",  "chk", "safety", "Isolate a problematic skill without uninstalling"),
+    ("quarantine",  "chk", "safety", "Isolate a problematic skill, rule or workflow without uninstalling"),
     ("decay",       "chk", "quality", "Flag skills irrelevant to your current stack"),
     ("heal",        "chk", "quality", "Self-diagnose & repair the boost environment"),
     ("conflict",    "chk", "quality", "Detect contradictory rules between skills"),
@@ -124,11 +124,11 @@ COMMANDS = [
     ("compact",     "cfg", "configuration", "Shrink tap clones to the files boost indexes"),
     ("create",      "cfg", "configuration", "Scaffold a new skill from a template"),
     ("policy",      "cfg", "configuration", "Manage & enforce skill governance policies"),
-    ("onboard",     "cfg", "configuration", "Add skill-tracker telemetry to a repo & open a PR"),
+    ("onboard",     "cfg", "configuration", "Add skill-tracker telemetry to a repo (optionally open a PR with --pr)"),
     ("completions", "cfg", "configuration", "Generate shell tab-completion scripts"),
     ("schedule",    "cfg", "configuration", "Manage automatic skill-sync scheduling"),
     ("serve",       "cfg", "configuration", "Browse the catalogue in a browser: search, facets and a tap graph"),
-    ("mcp",         "cfg", "configuration", "Register boost as an MCP server (Claude Code, Gemini CLI)"),
+    ("mcp",         "cfg", "configuration", "Register boost as an MCP server (Claude Code, Gemini CLI, Antigravity CLI)"),
     ("hooks",       "cfg", "hooks", "Manage agent hooks (Claude Code, Gemini CLI) in settings.json"),
     ("bmad",        "cfg", "bmad", "BMAD Method autopilot — `bmad on` routes every task to a persona"),
     ("self-update", "cfg", "configuration", "Update boost itself to the latest version"),

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/boost_cli/commands/configuration.py

@@ -729,7 +729,7 @@ def cmd_onboard(argv) -> int:
     """boost onboard [--repo DIR] [--pr] [--dry-run] [--force]"""
     p = cliparse.parser(
         prog="boost onboard",
-        description="Add skill-tracker telemetry to a repo & open a PR")
+        description="Add skill-tracker telemetry to a repo (optionally open a PR with --pr)")
     p.add_argument("--repo", default=".", help="repository directory (default: .)")
     p.add_argument("--pr", action="store_true",
                    help="commit on a branch and open a PR with `gh`")
@@ -754,7 +754,8 @@ def cmd_onboard(argv) -> int:
     files = [(_TELEMETRY_REL, telemetry), (_WORKFLOW_REL, _WORKFLOW_YML)]
     if repo != paths.store_dir().resolve():
         files.append((".skill-lock.json",
-                      json.dumps(lockfile.read(), indent=2, sort_keys=True) + "\n"))
+                      json.dumps(lockfile.portable(lockfile.read()),
+                                indent=2, sort_keys=True) + "\n"))
 
     if args.dry_run:
         for rel, content in files:
@@ -1852,8 +1853,9 @@ def cmd_mcp(argv) -> int:
                    choices=("register", "unregister"),
                    help="what to do (default: register)")
     p.add_argument("--host", metavar="H", default="auto",
-                   help="agent CLI to (un)register with: %s, or `auto` "
-                        "(default) for every one that is installed"
+                   help="agent CLI to (un)register with: %s, `auto` "
+                        "(default) for every one that is installed, or "
+                        "`all` for every known host regardless of install"
                         % ", ".join(mcphost.hosts()))
     p.add_argument("--stdio", action="store_true",
                    help="run the MCP server on stdin/stdout (used by the agent)")

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/boost_cli/commands/discovery.py

@@ -103,7 +103,7 @@ def cmd_search(argv):
     """Search the tap catalogs, optionally AI-reranked with --smart."""
     p = cliparse.parser(
         prog="boost search",
-        description="Search skills across tap registries (AI-ranked)")
+        description="Search skills across tap registries (BM25; --smart reranks with Claude)")
     p.add_argument("query", nargs="+", help="search terms")
     p.add_argument("--smart", action="store_true",
                    help="rerank the top hits with Claude")
@@ -460,7 +460,7 @@ def cmd_reindex(argv):
     """Build/refresh the full-content (RAG) search index over tapped items."""
     p = cliparse.parser(
         prog="boost reindex",
-        description="Build or refresh the full-content search index")
+        description="Build/refresh the full-content search index")
     p.add_argument("--force", action="store_true",
                    help="reindex every tap, ignoring cached commits")
     p.add_argument("--dense", action="store_true",
@@ -802,28 +802,35 @@ def _fall_back(why: str, hint: str) -> None:
 def _discover_live(args, tokens):
     """Search GitHub itself — the same reach-out the MCP tool makes.
 
-    Returns an exit code, or None to fall through to the cached index.
+    Returns ``(exit_code, fallback_reason)``. ``exit_code`` is ``None`` to fall
+    through to the cached index, in which case ``fallback_reason`` is a short
+    phrase naming *why* — fed straight into the local-index miss footer, which
+    otherwise cannot tell "gh is missing" from "the search failed" apart from
+    "no query was given at all", and used to blame all three on the same
+    ("GitHub could not be reached").
     """
     if not shutil.which("gh"):
-        return _fall_back("GitHub search needs the `gh` CLI",
-                          "install it with `brew install gh && gh auth login` "
-                          "to search GitHub itself")
+        _fall_back("GitHub search needs the `gh` CLI",
+                   "install it with `brew install gh && gh auth login` "
+                   "to search GitHub itself")
+        return None, "the `gh` CLI is not installed"
     hits = github_skill_search(" ".join(tokens), _GH_PAGE)
     if hits is None:
-        return _fall_back("GitHub code search failed", "check `gh auth status`")
+        _fall_back("GitHub code search failed", "check `gh auth status`")
+        return None, "GitHub code search failed"
     rows = _by_repo(hits)[:args.limit]
     if args.as_json:
         # `source` on every row, in both paths, because the fall-through above
         # switches corpus *and* row shape. Without it a script cannot tell
         # "GitHub has no matches" from "GitHub was never searched".
         print(json.dumps([r | {"source": "github"} for r in rows]))
-        return 0
+        return 0, None
     if not rows:
         out.info("no SKILL.md repositories on GitHub match %r"
                  % " ".join(tokens))
         out.info(out.role("try broader terms, or `boost search` for the "
                           "registries already tapped", "muted"))
-        return 0
+        return 0, None
     # The count rides the repo column, which is short: appended to the path it
     # was the first thing a narrow terminal truncated away. out.plain because
     # every field here is a GitHub string — a repo name or path carrying a
@@ -839,7 +846,7 @@ def _discover_live(args, tokens):
                       "GitHub Code Search" % (len(rows), len(hits)), "muted"))
     out.info(out.role("add one with `boost tap <repo>`, then `boost install "
                       "<skill>`", "muted"))
-    return 0
+    return 0, None
 
 
 def cmd_discover(argv):
@@ -859,21 +866,27 @@ def cmd_discover(argv):
     # A query is a question about GitHub, not about whatever `boost index`
     # happened to sample — so ask GitHub. The cached index stays the answer for
     # bare browsing and for --local, where being offline is the point.
+    fallback_reason = None
     if tokens and not args.local:
-        code = _discover_live(args, tokens)
+        code, fallback_reason = _discover_live(args, tokens)
         if code is not None:
             return code
     dpath = _discovery_path()
     if not dpath.exists():
-        if args.as_json:
-            print(json.dumps([]))
-            return 0
-        out.info("the discovery index has not been built yet")
+        # These lines must reach the user under --json too — stdout has to stay
+        # parseable, but "index not built" and "nothing matched" are different
+        # facts and a script deserves to be able to tell them apart, same as
+        # the live fall-back notice below.
+        stream = sys.stderr if args.as_json else None
+        out.info("the discovery index has not been built yet", stream=stream)
         if shutil.which("gh"):
-            out.info("build it with `boost index` (GitHub Code Search)")
+            out.info("build it with `boost index` (GitHub Code Search)",
+                     stream=stream)
         else:
             out.info("install the GitHub CLI first (`brew install gh && "
-                     "gh auth login`), then run `boost index`")
+                     "gh auth login`), then run `boost index`", stream=stream)
+        if args.as_json:
+            print(json.dumps([]))
         return 0
     try:
         data = json.loads(dpath.read_text(encoding="utf-8"))
@@ -881,41 +894,55 @@ def cmd_discover(argv):
         raise BoostError("the discovery index is corrupt",
                         hint="rebuild it with `boost index`") from None
     all_items = data.get("items") or []
-    tokens = [t.lower() for t in args.query if t.strip()]
+    query_tokens = [t.lower() for t in args.query if t.strip()]
     items = [it for it in all_items
              if all(t in ("%s %s %s" % (it.get("repo", ""), it.get("path", ""),
                                         it.get("description", ""))).lower()
-                    for t in tokens)]
-    shown = items[:args.limit]
+                    for t in query_tokens)]
     if args.as_json:
         # Tagged like the live rows above: this is the branch a script reaches
-        # after a silent fall-through, and the two row shapes differ.
+        # after a silent fall-through, and the two row shapes differ. Rows stay
+        # per-file here — a script asked for the raw matches, and repo
+        # collapsing is a table-rendering concern, not a data-shape one.
+        shown = items[:args.limit]
         print(json.dumps([it | {"source": "local-index"} for it in shown]))
         return 0
-    if not shown:
+    # One row per repository, same as the live table: code search (and a
+    # mirrored registry) can return several files from one repo, and a repo is
+    # what `boost tap` acts on.
+    repo_rows = _by_repo(items)[:args.limit]
+    if not repo_rows:
         out.info("no locally indexed skills match %r" % " ".join(args.query))
-        # Say what was actually consulted. The old wording read as a verdict on
-        # GitHub when it was only ever a verdict on this cache. The next line
-        # depends on WHY we are here: told to stay local, or fell through after
-        # GitHub was unreachable. "drop --local" to someone who never typed it
-        # is advice they cannot act on, contradicting the warning just printed.
-        out.info(out.role(
-            ("this searched a local sample of %d entries, not GitHub — drop "
-             "--local to search GitHub itself" % len(all_items))
-            if args.local else
-            ("this searched a local sample of %d entries because GitHub could "
-             "not be reached" % len(all_items)), "muted"))
+        # Say what was actually consulted. The old wording blamed "GitHub could
+        # not be reached" whatever the real reason — including a bare browse
+        # that never contacted GitHub at all. The next line depends on WHY we
+        # are here: told to stay local, a real fall-back with a known cause, or
+        # no query (so no live attempt) at all. "drop --local" to someone who
+        # never typed it is advice they cannot act on.
+        if args.local:
+            note = ("this searched a local sample of %d entries, not GitHub — "
+                     "drop --local to search GitHub itself" % len(all_items))
+        elif fallback_reason:
+            note = ("this searched a local sample of %d entries because %s"
+                     % (len(all_items), fallback_reason))
+        else:
+            note = ("this searched a local sample of %d entries — GitHub was "
+                     "not searched" % len(all_items))
+        out.info(out.role(note, "muted"))
         return 0
-    # out.plain: these rows came from GitHub too, by way of `boost index`.
-    out.table([(out.plain(it.get("repo", "?")), out.plain(it.get("path", "")),
-                out.role(out.plain(it.get("url", "")), "muted")) for it in shown],
+    # out.plain: these rows came from GitHub too, by way of `boost index`. The
+    # "(N)" cell mirrors the live table for the same reason it exists there.
+    out.table([(out.plain(it.get("repo", "?"))
+                + (" (%d)" % it["files"] if it.get("files", 1) > 1 else ""),
+                out.plain(it.get("path", "")),
+                out.role(out.plain(it.get("url", "")), "muted")) for it in repo_rows],
               headers=("repo", "path", "url"))
     # `github_total` is the match count for the query `boost index` was built
     # with, which since that command took a query is not "all of GitHub".
     scope = (" matching %r" % data["query"]) if data.get("query") else ""
-    out.info(out.role("%d of %d indexed skills · GitHub reported ~%d total%s "
-                      "when this index was built"
-                      % (len(shown), len(all_items),
+    out.info(out.role("%d repo(s) across %d of %d indexed skill files · GitHub "
+                      "reported ~%d total%s when this index was built"
+                      % (len(repo_rows), len(items), len(all_items),
                          int(data.get("github_total") or 0), scope), "muted"))
     return 0
 

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/boost_cli/commands/info.py

@@ -23,6 +23,7 @@ from ..core import (
     capabilities,
     catalog,
     config,
+    deps,
     faithfulness,
     frontmatter,
     gitutil,
@@ -31,6 +32,7 @@ from ..core import (
     journal,
     lockfile,
     logs,
+    mcpdecl,
     paths,
     projectlock,
     registry,
@@ -928,6 +930,7 @@ def cmd_log(argv):
     if args.diagnostics:
         return _show_diagnostics(args.limit)
     if args.name:
+        _, bare = catalog.split_name(args.name)
         found = lockfile.find_any(args.name)
         if found:
             # A skill records its source dir; rules/workflows record a source
@@ -948,9 +951,9 @@ def cmd_log(argv):
                             hint="run `boost update %s`" % tap.name)
         lines = gitutil.log_for_path(tap.path, rel, args.limit)
         if not lines:
-            out.info("no commits touch %s in %s" % (args.name, tap.name))
+            out.info("no commits touch %s in %s" % (bare, tap.name))
             return 0
-        out.heading("%s — history in %s" % (args.name, tap.name))
+        out.heading("%s — history in %s" % (bare, tap.name))
         for line in lines:
             out.info(line)
         return 0
@@ -958,6 +961,7 @@ def cmd_log(argv):
     if not events:
         out.info("no activity yet")
         return 0
+    out.heading("activity")
     action_roles = {"install": "success", "uninstall": "danger"}
     w_time = max(len(util.rel_time(e.get("ts", ""))) for e in events)
     w_user = max(len(e.get("user", "?")) for e in events)
@@ -1003,6 +1007,46 @@ def cmd_home(argv):
     return 0
 
 
+def _skill_dir_for_deps(name: str):
+    """Best-effort on-disk skill directory for reading a bundled ``.mcp.json``
+    sidecar — the installed store copy preferred, a materialized tap source
+    otherwise. ``None`` when neither resolves (not a skill, or unknown
+    everywhere) — an MCP declaration is a skill-only concept.
+    """
+    sdir = store.skill_store_dir(name)
+    if sdir.is_dir():
+        return sdir
+    try:
+        cat = catalog.resolve_one(name)
+    except BoostError:
+        return None
+    try:
+        return store.source_dir_for(cat)
+    except BoostError:
+        return None
+
+
+def _mcp_requirement_rows(skill_dir) -> list[dict]:
+    """Declared MCP servers a skill needs -> ``{name, registrable}`` rows.
+
+    ``registrable`` is whether boost has an actual runnable spec for the
+    server (a bundled ``.mcp.json`` command) — a name-only frontmatter
+    declaration never is, since boost will not invent a launch command on an
+    author's behalf (:func:`mcpdecl.registrable`). This is the fact
+    ``requires: mcp <name> (not registered)`` reports: not a live check
+    against any host's actual configuration (boost has no generic reader for
+    that), only whether boost itself could wire the server up.
+    """
+    if skill_dir is None:
+        return []
+    declared = store.declared_mcp_servers(skill_dir)
+    if not declared:
+        return []
+    registrable = {r["name"] for r in mcpdecl.registrable(declared)}
+    return [{"name": r["name"], "registrable": r["name"] in registrable}
+            for r in declared]
+
+
 def cmd_deps(argv):
     ap = cliparse.parser(prog="boost deps",
                                  description="Show dependency & conflict relationships")
@@ -1018,50 +1062,66 @@ def cmd_deps(argv):
     if args.name:
         text, _kind, _lock, _cat = _resolve_text(args.name)
         meta = frontmatter.parse(text)[0]
-        requires = _as_list(meta.get("requires"))
-        conflicts = _as_list(meta.get("conflicts"))
-        problems = (any(r not in have for r in requires)
-                    or any(c in have for c in conflicts))
+        requires = deps.requirement_names(meta)
+        conflicts = deps.conflict_names(meta)
+        req_rows = [deps.requirement_row(
+                        r, have, deps.requirement_names(_skill_meta(r) or {}))
+                    for r in requires]
+        conflict_rows = [deps.conflict_row(c, have) for c in conflicts]
+        _qualifier, bare = catalog.split_name(args.name)
+        mcp_rows = _mcp_requirement_rows(_skill_dir_for_deps(bare))
+        # A transitively unmet requirement used to print a "✗ not installed"
+        # line the exit code never counted — `has_unmet` walks the same
+        # nesting the renderer does, so the two can never disagree again.
+        problems = deps.has_unmet(req_rows) or deps.active_conflicts(conflict_rows)
         if args.json:
             print(json.dumps({
                 "name": args.name,
-                "requires": [{"name": r, "installed": r in have,
-                              "requires": _as_list((_skill_meta(r) or {}).get("requires"))}
-                             for r in requires],
-                "conflicts": [{"name": c, "installed": c in have} for c in conflicts],
+                "requires": req_rows,
+                "mcp": mcp_rows,
+                "conflicts": conflict_rows,
             }, indent=2))
             return 1 if problems else 0
         out.info(out.c(args.name, out.BOLD))
-        if not requires:
+        if not requires and not mcp_rows:
             out.info("  requires: " + out.role("(none)", "muted"))
-        for r in requires:
-            out.info("  requires: %s %s" % (r, _mark(r in have)))
-            for sub in _as_list((_skill_meta(r) or {}).get("requires")):
-                out.info("      ↳ %s %s" % (sub, _mark(sub in have)))
+        for row in req_rows:
+            out.info("  requires: %s %s" % (row["name"], _mark(row["installed"])))
+            for sub in row["requires"]:
+                out.info("      ↳ %s %s" % (sub["name"], _mark(sub["installed"])))
+        for r in mcp_rows:
+            note = "" if r["registrable"] else out.role(" (not registered)", "muted")
+            out.info("  requires: mcp %s%s" % (r["name"], note))
         if not conflicts:
             out.info("  conflicts: " + out.role("(none)", "muted"))
-        for c_name in conflicts:
-            state = (out.role("✗ installed (conflict!)", "danger") if c_name in have
+        for row in conflict_rows:
+            state = (out.role("✗ installed (conflict!)", "danger") if row["installed"]
                      else out.role("not installed", "muted"))
-            out.info("  conflicts: %s %s" % (c_name, state))
+            out.info("  conflicts: %s %s" % (row["name"], state))
+        if problems:
+            missing = deps.unmet_names(req_rows)
+            if missing:
+                out.warn("`boost install %s` to satisfy %d unmet requirement%s"
+                         % (" ".join(missing), len(missing),
+                            "" if len(missing) == 1 else "s"))
         return 1 if problems else 0
 
     unmet: list[dict] = []
-    pairs: list[list] = []   # JSON-dumped, so lists rather than tuples
+    pairs: list[dict] = []
     seen: set = set()
     for name in sorted(inst):
         meta = _skill_meta(name) or {}
         unmet.extend(
-            {"skill": name, "requires": r}
-            for r in _as_list(meta.get("requires"))
+            {"skill": name, "requires": deps.requirement_row(r, have)}
+            for r in deps.requirement_names(meta)
             if r not in have
         )
-        for c_name in _as_list(meta.get("conflicts")):
+        for c_name in deps.conflict_names(meta):
             if c_name in have:
                 key = tuple(sorted((name, c_name)))
                 if key not in seen:
                     seen.add(key)
-                    pairs.append(list(key))
+                    pairs.append({"a": key[0], "b": key[1]})
     if args.json:
         print(json.dumps({"unmet": unmet, "conflicts": pairs}, indent=2))
         return 1 if unmet or pairs else 0
@@ -1071,14 +1131,20 @@ def cmd_deps(argv):
         return 0
     for u in unmet:
         out.info("%s requires %s %s"
-                 % (out.c(u["skill"], out.BOLD), u["requires"], _mark(False)))
-    for a, b in pairs:
-        out.info("%s %s %s" % (out.c(a, out.BOLD),
-                               out.role("conflicts with", "danger"), out.c(b, out.BOLD)))
+                 % (out.c(u["skill"], out.BOLD), u["requires"]["name"],
+                    _mark(u["requires"]["installed"])))
+    for pair in pairs:
+        out.info("%s %s %s" % (out.c(pair["a"], out.BOLD),
+                               out.role("conflicts with", "danger"), out.c(pair["b"], out.BOLD)))
     if not unmet and not pairs:
         out.ok("no unmet requirements or conflicts across %d skill%s"
                % (len(inst), "" if len(inst) == 1 else "s"))
         return 0
+    if unmet:
+        missing = sorted({u["requires"]["name"] for u in unmet})
+        out.warn("`boost install %s` to satisfy %d unmet requirement%s"
+                 % (" ".join(missing), len(missing),
+                    "" if len(missing) == 1 else "s"))
     return 1
 
 

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/boost_cli/commands/intelligence.py

@@ -324,9 +324,10 @@ def cmd_simulate(argv: list[str]) -> int:
                     help="task to simulate (default: a typical coding task)")
     args = ap.parse_args(argv)
 
+    _, bare = catalog.split_name(args.name)
     text, origin = _skill_text(args.name)
     task = args.task or "a typical coding task in this repo"
-    out.heading("simulating %s  %s" % (args.name, out.role("(%s)" % origin, "muted")))
+    out.heading("simulating %s  %s" % (bare, out.role("(%s)" % origin, "muted")))
 
     if ai.available():
         reply = ai.ask(
@@ -344,7 +345,7 @@ def cmd_simulate(argv: list[str]) -> int:
     out.kv("task", task)
     rules = imperative.imperative_rules(body)
     out.info("Without it: default behavior — none of the rules below are enforced.")
-    out.info(out.c("With %s active, Claude would:" % args.name, out.BOLD))
+    out.info(out.c("With %s active, Claude would:" % bare, out.BOLD))
     if rules:
         for rule in rules[:8]:
             out.info("  • " + rule)
@@ -1142,7 +1143,7 @@ def cmd_focus(argv: list[str]) -> int:
 def cmd_impact(argv: list[str]) -> int:
     ap = cliparse.parser(
         prog="boost impact",
-        description="Measure a skill's influence on code quality")
+        description="Correlate a skill's install date with repo activity")
     ap.add_argument("name", nargs="?", metavar="NAME",
                     help="one skill (default: all installed)")
     ap.add_argument("--json", action="store_true")

{boost_skill_cli-1.2.99 → boost_skill_cli-1.2.101}/boost_cli/commands/pkg.py

@@ -535,7 +535,7 @@ def cmd_install(argv: list[str]) -> int:
 def cmd_uninstall(argv: list[str]) -> int:
     ap = cliparse.parser(
         prog="boost uninstall",
-        description="Remove an installed skill, rule, workflow, or config")
+        description="Remove an installed skill, rule, or workflow")
     ap.add_argument("names", nargs="+", metavar="NAME")
     ap.add_argument("--local", dest="scope", action="store_const",
                     const=scopes.SCOPE_PROJECT, default=None,
@@ -1528,7 +1528,7 @@ def _import_root(root: Path, name: str | None, do_all: bool,
 
 def cmd_pin(argv: list[str]) -> int:
     ap = cliparse.parser(prog="boost pin",
-                                 description="Pin a skill to its current version")
+                                 description="Pin a skill, rule or workflow to its current version")
     ap.add_argument("name", metavar="NAME")
     ap.add_argument("--commit", action="store_true",
                     help="also freeze the exact source commit (integrity pin)")
@@ -1546,15 +1546,22 @@ def cmd_pin(argv: list[str]) -> int:
 
 def cmd_unpin(argv: list[str]) -> int:
     ap = cliparse.parser(prog="boost unpin",
-                                 description="Allow a pinned skill to update again")
+                                 description="Allow a pinned skill, rule or workflow to update again")
     ap.add_argument("name", metavar="NAME")
     args = ap.parse_args(argv)
     # Releasing the version pin releases the commit pin with it — a commit pin
-    # only makes sense while the skill is otherwise frozen.
+    # only makes sense while the skill is otherwise frozen. The commit pin is
+    # cleared before `_set_pin` so it takes effect either way, but the dim
+    # trailer prints after — it qualifies `_set_pin`'s own "unpinned" line, so
+    # printing it first would leave the trailer describing a line that has
+    # not appeared yet (mirrors `cmd_pin`'s ok-line-then-trailer order).
     found = lockfile.find_any(args.name)
-    if found and integrity.clear_commit_pin(args.name, found[1], kind=found[0]):
+    cleared_commit_pin = bool(
+        found and integrity.clear_commit_pin(args.name, found[1], kind=found[0]))
+    rc = _set_pin(args.name, False)
+    if cleared_commit_pin:
         out.dim("  released the commit pin too")
-    return _set_pin(args.name, False)
+    return rc
 
 
 def _set_pin(name: str, pinned: bool) -> int: