boost-skill-cli 1.0.148__tar.gz → 1.0.150__tar.gz

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/Makefile

@@ -10,7 +10,7 @@ PYTEST    := $(VENV)/bin/pytest
 # pinned taps out of the developer's real ~/.boost.
 EVAL_HOME := $(CURDIR)/.eval-home
 
-.PHONY: venv test unit functional smoke coverage mutation lint check demo clean-test eval eval-ai eval-rec eval-stats eval-explain audit dist-check
+.PHONY: venv test unit functional smoke coverage mutation lint check demo clean-test eval eval-ai eval-rec eval-stats eval-explain audit dist-check bdd bench bench-cli
 
 venv:
 	python3 -m venv $(VENV)
@@ -96,6 +96,24 @@ eval-explain:
 	PYTHON=$(PY) BOOST_HOME=$(EVAL_HOME) bash scripts/ensure_eval_corpus.sh
 	BOOST_HOME=$(EVAL_HOME) $(PY) scripts/eval_explain.py --fail-under 0.80
 
+# Opt-in Gherkin/BDD suite (tests/bdd) — additive to tests/functional, not a
+# replacement. Needs the [bdd] extra (`pip install -e '.[bdd]'`); not part of
+# `make check`.
+bdd:
+	$(VENV)/bin/behave tests/bdd/features
+
+# Opt-in micro-benchmarks (tests/perf) for perf-sensitive core paths. Needs
+# the [perf] extra (`pip install -e '.[perf]'`); not part of `make check` — a
+# timing regression is informational, not a merge gate.
+bench:
+	$(PYTEST) tests/perf --benchmark-only -q
+
+# Opt-in wall-clock benchmark of the real `boost` binary via hyperfine. Not
+# part of `make check`; degrades cleanly (prints a skip message, exits 0) when
+# hyperfine isn't installed (`brew install hyperfine`).
+bench-cli:
+	@command -v hyperfine >/dev/null 2>&1 && bash scripts/bench_cli.sh || echo "hyperfine not on PATH — install via 'brew install hyperfine', skipping"
+
 # regenerate generated artifacts from their source (registries + roadmap boards)
 generate:
 	$(PY) scripts/build_registries.py

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.148
+Version: 1.0.150
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE
@@ -708,6 +708,10 @@ 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: 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

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/boost_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.0.148'
-__version_tuple__ = version_tuple = (1, 0, 148)
+__version__ = version = '1.0.150'
+__version_tuple__ = version_tuple = (1, 0, 150)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/boost_cli/commands/discovery.py

@@ -11,12 +11,14 @@ import re
 import shutil
 import subprocess
 import sys
+import threading
 import time
 import urllib.parse
 from pathlib import Path
 
 from .. import cliparse, spin
-from ..core import agents, ai, catalog, dense, embed, gitutil, journal, lockfile, paths, rag, registry, store, util
+from ..core import (agents, ai, catalog, config, dense, embed, gitutil,
+                    journal, lockfile, paths, rag, registry, store, util)
 from ..core import output as out
 from ..core.stackprobe import detect_stack  # re-exported: shared with Quality
 from ..errors import BoostError
@@ -451,6 +453,77 @@ def _browse_plain(entries, why: str):
     return 0
 
 
+def _tap_categories() -> dict:
+    """tap name ('owner/repo') -> curated category, from the bundled registry
+    catalog (data/registries.json) — the only place "category" lives; catalog
+    entries themselves carry no category, only their tap does."""
+    return {e["name"]: e["category"] for e in config.load_registry_catalog()
+            if e.get("category")}
+
+
+_KIND_BADGE_KEYS = {"skill": "badge_skill", "rule": "badge_rule",
+                    "workflow": "badge_workflow"}
+
+
+def _kind_theme_key(kind: str) -> str:
+    return _KIND_BADGE_KEYS.get(kind, "badge_skill")
+
+
+def _row_badges(e: dict, categories: dict):
+    """Ordered (text, theme-key) badges for a browse row: kind, version, tap,
+    and — when the tap is one of the curated registries — its category.
+    Most-important-first, so a narrow terminal drops from the tail without
+    losing the essentials (kind and version survive; category goes first)."""
+    badges = [("[%s]" % e.get("kind", "skill"),
+               _kind_theme_key(e.get("kind", "skill"))),
+              ("v" + e["version"], "version"),
+              ("[%s]" % e["tap"], "tap")]
+    category = categories.get(e["tap"])
+    if category:
+        badges.append(("[%s]" % category, "badge_category"))
+    return badges
+
+
+def _desc_key(e: dict):
+    return (e.get("tap", ""), e["name"])
+
+
+def _entry_source_path(e: dict):
+    """On-disk path of the file backing a catalog entry, or None when its tap
+    isn't cloned/known — used to fall back to a `boost explain`-style summary
+    for entries whose frontmatter has no description."""
+    try:
+        tap = registry.get(e["tap"])
+    except BoostError:
+        return None
+    path = tap.path / e.get("skill_md", "")
+    return path if path.is_file() else None
+
+
+def _lazy_description(e: dict) -> str:
+    """A one-line fallback description for an entry with no frontmatter
+    description — the `boost explain` idea, sized for a picker row. Meant to
+    run off the UI thread since it may shell out to `claude`/the Anthropic API."""
+    path = _entry_source_path(e)
+    text = ""
+    if path is not None:
+        try:
+            text = path.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            text = ""
+    if text and ai.available():
+        reply = ai.ask(
+            "In ONE short plain sentence (max 18 words, no markdown), describe "
+            "what this %s named %r does, based on its file:\n\n%s"
+            % (e.get("kind", "skill"), e["name"], text[:4000]),
+            system="You summarize AI coding skills, rules, and workflows in "
+                   "one plain sentence for a picker UI.",
+            max_tokens=60)
+        if reply:
+            return reply.strip().splitlines()[0][:200]
+    return "no description available"
+
+
 # --- Aurora palette for the curses browser -----------------------------------
 # The full-screen browser paints itself in the same Aurora tokens as the rest
 # of the CLI. curses can't reuse the ANSI escapes from core.output, so these
@@ -561,7 +634,10 @@ def _aurora_theme(curses):
          "scroll": curses.A_DIM, "detail_name": curses.A_BOLD,
          "detail_meta": curses.A_DIM, "detail_tag": curses.A_NORMAL,
          "dot_r": curses.A_NORMAL, "dot_y": curses.A_NORMAL,
-         "dot_g": curses.A_NORMAL}
+         "dot_g": curses.A_NORMAL, "check": curses.A_BOLD,
+         "badge_skill": curses.A_NORMAL, "badge_rule": curses.A_NORMAL,
+         "badge_workflow": curses.A_NORMAL, "badge_category": curses.A_NORMAL,
+         "desc": curses.A_DIM}
     if not hasattr(curses, "start_color"):
         return t
     try:
@@ -581,19 +657,49 @@ def _aurora_theme(curses):
               "tap": P("violet"), "rule": [P("cyan"), P("violet"), P("pink")],
               "scroll": P("cyan"), "detail_name": P("cyan", True),
               "detail_tag": P("pink"), "dot_r": P("red"), "dot_y": P("yellow"),
-              "dot_g": P("green")})
+              "dot_g": P("green"), "check": P("green", True),
+              "badge_skill": P("cyan"), "badge_rule": P("violet"),
+              "badge_workflow": P("pink"), "badge_category": P("yellow")})
     return t
 
 
+_NAME_X = 4  # column the name (and everything under it) starts at
+
+
 def _browse_tui(curses, entries):
-    """Run the curses UI. Returns the entry picked for install, or None."""
-    state = {"pick": None}
+    """Run the curses UI. Returns the list of entries picked for install
+    (one or more, via multi-select), or None if the user quit without picking.
+    """
+    state = {"picks": None}
+    categories = _tap_categories()
+    desc_cache: dict = {}
+    loading: set = set()
+
+    def describe(e):
+        """Description text for a row, kicking off a background lazy-load
+        (the `boost explain` fallback) the first time an entry with no
+        frontmatter description is shown — never blocks the draw loop."""
+        if e.get("description"):
+            return e["description"]
+        key = _desc_key(e)
+        if key in desc_cache:
+            return desc_cache[key]
+        if key not in loading:
+            loading.add(key)
+
+            def worker(entry=e, cache_key=key):
+                desc_cache[cache_key] = _lazy_description(entry)
+                loading.discard(cache_key)
+
+            threading.Thread(target=worker, daemon=True).start()
+        return "loading description…"
 
     def ui(scr):
         try:
             curses.curs_set(0)
         except curses.error:
             pass
+        scr.timeout(80)  # short poll so a finished lazy-load redraws promptly
         th = _aurora_theme(curses)
 
         def put(y, x, s, attr=0):  # clip-safe cell writer
@@ -604,6 +710,7 @@ def _browse_tui(curses, entries):
                     pass
 
         filt, sel, detail = "", 0, False
+        selected: set = set()
         while True:
             q = filt.lower()
             matches = [e for e in entries
@@ -627,35 +734,46 @@ def _browse_tui(curses, entries):
                 put(1, 0, "❯", th["prompt"])
                 put(1, 2, filt, th["query"])
                 put(1, 2 + len(filt), "▏", th["prompt"])
-                count = "%d/%d" % (len(matches), len(entries))
+                sel_txt = "%d selected · " % len(selected) if selected else ""
+                count = "%s%d/%d" % (sel_txt, len(matches), len(entries))
                 put(1, max(2 + len(filt) + 2, _w - 1 - len(count)), count,
                     th["count"])
-                put(2, 0, "↑↓ move  ↵ detail  i install  q quit",
+                put(2, 0, "↑↓ move  space select  ↵ detail  i install  q quit",
                     th["help"])
-                rows = max(1, _h - 3 - pane)
+                # each result is a two-row card: name/badges, then description
+                avail = max(0, _h - 3 - pane)
+                rows = max(1, avail // 2)
                 top = max(0, sel - rows + 1)
                 view = matches[top:top + rows]
                 namew = min(max((len(e["name"]) for e in view), default=4),
-                            max(4, _w - 26))
+                            max(8, _w - _NAME_X - 30))
                 bar = _scrollbar(len(matches), rows, top)
                 for i, e in enumerate(view):
-                    y = 3 + i
+                    y = 3 + i * 2
                     chosen = top + i == sel
+                    checked = _desc_key(e) in selected
                     put(y, 0, "▎" if chosen else " ", th["sel_bar"])
-                    put(y, 1, "★" if e.get("curated") else " ", th["star"])
+                    put(y, 1, "✓" if checked else " ", th["check"])
+                    put(y, 2, "★" if e.get("curated") else " ", th["star"])
                     nm = out.truncate(e["name"], namew)
-                    put(y, 3, nm.ljust(namew),
+                    put(y, _NAME_X, nm.ljust(namew),
                         th["sel_name"] if chosen else th["name"])
                     for pos in _match_positions(q, nm.lower()):
-                        put(y, 3 + pos, nm[pos], th["match"])
-                    vx = 3 + namew + 2
-                    put(y, vx, "v" + e["version"], th["version"])
-                    put(y, vx + len(e["version"]) + 3, e["tap"], th["tap"])
+                        put(y, _NAME_X + pos, nm[pos], th["match"])
+                    bx = _NAME_X + namew + 2
+                    for text, tkey in _row_badges(e, categories):
+                        if bx + len(text) > _w - 2:
+                            break
+                        put(y, bx, text, th[tkey])
+                        bx += len(text) + 1
+                    put(y + 1, _NAME_X, out.truncate(describe(e), _w - 1 - _NAME_X),
+                        th["desc"])
                     if bar:
                         bstart, blen = bar
-                        put(y, _w - 2,
-                            "█" if bstart <= i < bstart + blen else "│",
-                            th["scroll"])
+                        thumb = bstart <= i < bstart + blen
+                        ch = "█" if thumb else "│"
+                        put(y, _w - 2, ch, th["scroll"])
+                        put(y + 1, _w - 2, ch, th["scroll"])
                 if pane and matches:
                     e = matches[sel]
                     y0 = _h - pane
@@ -666,7 +784,7 @@ def _browse_tui(curses, entries):
                                      (e.get("meta", {}).get("tags") or []))
                     put(y0 + 1, 1, "%s  v%s" % (e["name"], e["version"]),
                         th["detail_name"])
-                    put(y0 + 2, 1, out.truncate(e["description"] or "", _w - 3),
+                    put(y0 + 2, 1, out.truncate(describe(e), _w - 3),
                         th["name"])
                     put(y0 + 3, 1, "tap %s   dir %s" % (e["tap"], e["rel_dir"]),
                         th["detail_meta"])
@@ -675,12 +793,21 @@ def _browse_tui(curses, entries):
             except curses.error:
                 pass  # terminal too small mid-draw; retry on next key
             key = scr.getch()
+            if key == -1:                                 # poll tick, no key
+                continue
             if key in (ord("q"), 27):                    # q / ESC
                 return
             if key == ord("i") and matches:
-                state["pick"] = matches[sel]
+                state["picks"] = ([e for e in entries if _desc_key(e) in selected]
+                                  if selected else [matches[sel]])
                 return
-            if key == curses.KEY_UP:
+            if key == ord(" ") and matches:
+                k = _desc_key(matches[sel])
+                if k in selected:
+                    selected.discard(k)
+                else:
+                    selected.add(k)
+            elif key == curses.KEY_UP:
                 sel = max(0, sel - 1)
             elif key == curses.KEY_DOWN:
                 sel = min(sel + 1, max(0, len(matches) - 1))
@@ -688,11 +815,11 @@ def _browse_tui(curses, entries):
                 detail = not detail
             elif key in (curses.KEY_BACKSPACE, 127, 8):
                 filt = filt[:-1]
-            elif 32 <= key <= 126:
+            elif 33 <= key <= 126:                        # printable, not space
                 filt += chr(key)
 
     curses.wrapper(ui)  # wrapper guards drawing with try/finally endwin()
-    return state["pick"]
+    return state["picks"]
 
 
 def cmd_browse(argv):
@@ -712,25 +839,26 @@ def cmd_browse(argv):
     except ImportError:
         return _browse_plain(entries, "curses is unavailable on this Python")
     picked = _browse_tui(curses, entries)
-    if picked is None:
+    if not picked:
         return 0
-    try:
-        res = store.install(picked)
-    except BoostError as e:
-        # browse lists every catalog kind (skills, rules, workflows), but only
-        # skills install; a rule/workflow pick — or an already-installed/pinned
-        # skill — must not exit the interactive TUI with a fatal error.
-        out.warn(e.message)
-        if e.hint:
-            out.info(out.c(e.hint, out.DIM))
-        return 0
-    out.ok("installed %s v%s → %s"
-           % (picked["name"], picked["version"], _tilde(res.dest)))
-    if res.linked:
-        out.info("linked into: "
-                 + ", ".join(agents.display_name(a) for a in res.linked))
-    for conflict in res.conflicts:
-        out.warn("conflict: %s exists and is not a symlink" % _tilde(conflict))
+    for entry in picked:
+        try:
+            res = store.install(entry)
+        except BoostError as e:
+            # browse lists every catalog kind (skills, rules, workflows), but
+            # only skills install; a rule/workflow pick — or an already-
+            # installed/pinned skill — must not abort the rest of the batch.
+            out.warn(e.message)
+            if e.hint:
+                out.info(out.c(e.hint, out.DIM))
+            continue
+        out.ok("installed %s v%s → %s"
+               % (entry["name"], entry["version"], _tilde(res.dest)))
+        if res.linked:
+            out.info("linked into: "
+                     + ", ".join(agents.display_name(a) for a in res.linked))
+        for conflict in res.conflicts:
+            out.warn("conflict: %s exists and is not a symlink" % _tilde(conflict))
     return 0
 
 

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/boost_skill_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.148
+Version: 1.0.150
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE
@@ -708,6 +708,10 @@ 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: 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

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/boost_skill_cli.egg-info/SOURCES.txt

@@ -217,6 +217,7 @@ docs/roadmap/items/workspace-scope-install.md
 examples/README.md
 examples/adapt-demo.sh
 examples/boost-run-prototype.sh
+scripts/bench_cli.sh
 scripts/build_registries.py
 scripts/build_roadmap.py
 scripts/ensure_eval_corpus.sh
@@ -231,6 +232,22 @@ style/demo.html
 tests/conftest.py
 tests/make_fixture.py
 tests/smoke.sh
+tests/bdd/features/adapt.feature
+tests/bdd/features/browse.feature
+tests/bdd/features/count.feature
+tests/bdd/features/discover.feature
+tests/bdd/features/doctor.feature
+tests/bdd/features/environment.py
+tests/bdd/features/explain.feature
+tests/bdd/features/index.feature
+tests/bdd/features/install.feature
+tests/bdd/features/list.feature
+tests/bdd/features/mcp.feature
+tests/bdd/features/search.feature
+tests/bdd/features/steps/cli_steps.py
+tests/bdd/features/steps/discovery_steps.py
+tests/bdd/features/steps/mcp_steps.py
+tests/bdd/features/steps/quality_steps.py
 tests/eval/baseline.json
 tests/eval/explain.jsonl
 tests/eval/golden.jsonl
@@ -249,6 +266,7 @@ tests/functional/test_cli_taps.py
 tests/functional/test_cli_team.py
 tests/functional/test_everyday_loop.py
 tests/functional/test_property_parsers.py
+tests/perf/test_benchmarks.py
 tests/unit/test_adapters.py
 tests/unit/test_agents.py
 tests/unit/test_ai.py

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/boost_skill_cli.egg-info/requires.txt

@@ -1,4 +1,7 @@
 
+[bdd]
+behave>=1.2.6
+
 [eval]
 ranx>=0.3.20
 ragas<0.3,>=0.2
@@ -6,5 +9,8 @@ langchain-core<0.4
 langchain-community<0.4
 langchain-openai<1
 
+[perf]
+pytest-benchmark>=4.0
+
 [rag]
 sqlite-vec>=0.1.6

{boost_skill_cli-1.0.148 → boost_skill_cli-1.0.150}/pyproject.toml

@@ -55,6 +55,16 @@ eval = [
     "langchain-community<0.4",
     "langchain-openai<1",
 ]
+# Opt-in Gherkin/BDD functional suite (tests/bdd) — reusable Given/When/Then
+# scenarios over the same in-process CLI entrypoint tests/functional drives.
+# Additive to, not a replacement for, the pytest functional suite; not part of
+# `make check`. `pip install -e '.[bdd]'`.
+bdd = ["behave>=1.2.6"]
+# Opt-in micro-benchmarks (tests/perf, `make bench`) for perf-sensitive core
+# paths (BM25 indexing/search, catalog scan). Not part of `make check` — a
+# timing regression shouldn't block a merge the way a correctness gate does.
+# `pip install -e '.[perf]'`.
+perf = ["pytest-benchmark>=4.0"]
 
 [project.scripts]
 boost = "boost_cli.cli:main"

boost_skill_cli-1.0.150/scripts/bench_cli.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Wall-clock benchmark of the real `boost` binary via hyperfine — the actual
+# fork+exec CLI, not the in-process pytest-benchmark suite (tests/perf).
+# Opt-in (`make bench-cli`); not part of `make check`. Degrades cleanly if
+# hyperfine isn't installed.
+set -uo pipefail
+
+if ! command -v hyperfine >/dev/null 2>&1; then
+  echo "hyperfine not installed — install via 'brew install hyperfine', skipping"
+  exit 0
+fi
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SB="$(mktemp -d "${TMPDIR:-/tmp}/boost-bench-XXXXXX")"
+trap 'rm -rf "$SB"' EXIT
+export HOME="$SB" BOOST_NO_AI=1 BOOST_ASSUME_YES=1 NO_COLOR=1
+
+FIX="$(python3 "$ROOT/tests/make_fixture.py" "$SB/fixture-tap")"
+"$ROOT/boost" tap "$FIX" >/dev/null
+"$ROOT/boost" install brainstorming >/dev/null
+
+echo "== hyperfine: $(command -v hyperfine) over $ROOT/boost (sandbox: $SB)"
+hyperfine --warmup 3 \
+  "$ROOT/boost --help" \
+  "$ROOT/boost list" \
+  "$ROOT/boost search brainstorming" \
+  "$ROOT/boost count"

boost_skill_cli-1.0.150/tests/bdd/features/adapt.feature

@@ -0,0 +1,46 @@
+Feature: boost adapt
+  Render a skill as another agent framework's native source (CrewAI, Agents SDK).
+
+  Background:
+    Given a fresh boost environment
+    And the fixture tap is added
+
+  Scenario: adapting an installed skill to CrewAI
+    Given the "brainstorming" skill is installed
+    When I run "boost adapt brainstorming --to crewai"
+    Then the exit code should be 0
+    And the output should contain "from crewai import Agent"
+    And the output should contain "brainstorming = Agent("
+
+  Scenario: adapting an installed skill to the Agents SDK
+    Given the "brainstorming" skill is installed
+    When I run "boost adapt brainstorming --to agents-sdk"
+    Then the exit code should be 0
+    And the output should contain "from agents import Agent"
+    And the output should match "name=\"brainstorming\""
+
+  Scenario: adapting a tapped-but-not-installed skill still resolves
+    When I run "boost adapt brainstorming --to crewai"
+    Then the exit code should be 0
+    And the output should contain "brainstorming = Agent("
+
+  Scenario: --model none opts out of pinning an LLM
+    Given the "brainstorming" skill is installed
+    When I run "boost adapt brainstorming --to crewai --model none"
+    Then the exit code should be 0
+    And the output should not contain "llm="
+
+  Scenario: an unknown framework is rejected
+    Given the "brainstorming" skill is installed
+    When I run "boost adapt brainstorming --to langchain"
+    Then the exit code should be 1
+    And the output should contain "unknown framework"
+
+  Scenario: --to is required
+    Given the "brainstorming" skill is installed
+    When I run "boost adapt brainstorming"
+    Then the exit code should be 2
+
+  Scenario: adapting an unknown skill fails
+    When I run "boost adapt does-not-exist --to crewai"
+    Then the exit code should be 1

boost_skill_cli-1.0.150/tests/bdd/features/browse.feature

@@ -0,0 +1,26 @@
+Feature: boost browse
+  Interactive full-screen TUI with fuzzy search. There is no TTY in these
+  scenarios, so `browse` takes its documented non-interactive escape hatch
+  and prints the full catalog instead of launching curses.
+
+  Background:
+    Given a fresh boost environment
+
+  Scenario: no skills available to browse
+    When I run "boost browse"
+    Then the exit code should be 1
+    And the output should contain "no skills available to browse"
+
+  Scenario: without a TTY, prints the full catalog instead of the TUI
+    Given the fixture tap is added
+    When I run "boost browse"
+    Then the exit code should be 0
+    And the output should contain "interactive mode needs a TTY — showing the full catalog"
+    And the output should contain "brainstorming"
+    And the output should contain "commit-messages"
+    And the output should contain "5 skills · install with `boost install <name>`"
+
+  Scenario: --help documents the command without touching the catalog
+    When I run "boost browse --help"
+    Then the exit code should be 0
+    And the output should contain "Interactive full-screen TUI with fuzzy search"

boost_skill_cli-1.0.150/tests/bdd/features/count.feature

@@ -0,0 +1,24 @@
+Feature: boost count
+  A one-line inventory summary: installed / available / taps / discovery index.
+
+  Background:
+    Given a fresh boost environment
+
+  Scenario: an empty environment
+    When I run "boost count"
+    Then the exit code should be 0
+    And the output should contain "installed 0 · available 0 (across 0 taps) · discovery index not built"
+
+  Scenario: one tap with one installed skill
+    Given the "brainstorming" skill is installed
+    When I run "boost count"
+    Then the exit code should be 0
+    And the output should contain "installed 1 · available 5 (across 1 tap) · discovery index not built"
+    And the output should contain "╭─ inventory"
+
+  Scenario: --json is machine readable
+    Given the "brainstorming" skill is installed
+    When I run "boost count --json"
+    Then the exit code should be 0
+    And the output should match "\"installed\": 1"
+    And the output should match "\"taps\": 1"

boost_skill_cli-1.0.150/tests/bdd/features/discover.feature

@@ -0,0 +1,39 @@
+Feature: boost discover
+  Browse and filter the GitHub-wide discovery index built by `boost index`.
+
+  Background:
+    Given a fresh boost environment
+
+  Scenario: without an index and without gh, hints to install gh
+    Given the GitHub CLI is not installed
+    When I run "boost discover"
+    Then the exit code should be 0
+    And the output should contain "the discovery index has not been built yet"
+    And the output should contain "install the GitHub CLI first"
+
+  Scenario: without an index but with gh, hints to run boost index
+    Given the GitHub CLI is installed and code search returns 2 sample skill files
+    When I run "boost discover"
+    Then the exit code should be 0
+    And the output should contain "build it with `boost index` (GitHub Code Search)"
+
+  Scenario: a query filters indexed entries
+    Given the discovery index is seeded with sample items
+    When I run "boost discover acme"
+    Then the exit code should be 0
+    And the output should contain "skills/web/SKILL.md"
+    And the output should not contain "octo/skills"
+    And the output should contain "2 of 3 indexed skills · GitHub reports ~42 total"
+
+  Scenario: a query with no matches reports the index size
+    Given the discovery index is seeded with sample items
+    When I run "boost discover zzz"
+    Then the exit code should be 0
+    And the output should contain "no indexed skills match 'zzz'"
+    And the output should contain "the index holds 3 entries — rebuild with `boost index`"
+
+  Scenario: a corrupt index fails cleanly
+    Given the discovery index is corrupt
+    When I run "boost discover"
+    Then the exit code should be 1
+    And the output should contain "the discovery index is corrupt"