boost-skill-cli 1.0.147__tar.gz → 1.0.149__tar.gz

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/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.147 → boost_skill_cli-1.0.149}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.147
+Version: 1.0.149
 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.147 → boost_skill_cli-1.0.149}/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.147'
-__version_tuple__ = version_tuple = (1, 0, 147)
+__version__ = version = '1.0.149'
+__version_tuple__ = version_tuple = (1, 0, 149)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/boost_cli/commands/pkg.py

@@ -118,7 +118,9 @@ def _warn_secrets(res: store.InstallResult) -> None:
 def _report_result(res: store.InstallResult) -> None:
     """The canonical three-line install report."""
     if res.kind in ("rule", "workflow"):
-        out.ok("materialized → %s" % (" · ".join(res.linked) or "(no enabled agents)"))
+        where = " (this repo)" if res.scope == "project" else ""
+        out.ok("materialized%s → %s"
+               % (where, " · ".join(res.linked) or "(no enabled agents)"))
         out.ok("lock updated (.skill-lock.json)")
         _warn_injection(res)
         _warn_secrets(res)
@@ -166,6 +168,9 @@ def cmd_install(argv: List[str]) -> int:
                     help="reinstall even if already installed or pinned")
     ap.add_argument("--agent", action="append", metavar="A",
                     help="link only into this agent (repeatable)")
+    ap.add_argument("--scope", choices=("user", "project"), default="user",
+                    help="rules/workflows: install into your user config (default) "
+                         "or the current repo (project)")
     ap.add_argument("--dry-run", action="store_true",
                     help="show what would happen without changing anything")
     args = ap.parse_args(argv)
@@ -191,8 +196,10 @@ def cmd_install(argv: List[str]) -> int:
                 seen = (lockfile.get_rule if k == "rule"
                         else lockfile.get_workflow)(e["name"])
                 verb = "reinstall" if seen else "install"
-                out.info("would %s %s %s v%s from %s" % (verb, k, e["name"],
-                                                         e["version"], e["tap"]))
+                where = "into this repo" if args.scope == "project" else "user config"
+                out.info("would %s %s %s v%s from %s (%s)" % (verb, k, e["name"],
+                                                              e["version"], e["tap"],
+                                                              where))
                 out.info("  materialize → %s" % (" · ".join(targets)
                                                  or "(no enabled agents)"))
                 continue
@@ -210,7 +217,7 @@ def cmd_install(argv: List[str]) -> int:
         if multi:
             out.heading("%s v%s (%s)" % (e["name"], e["version"], e["tap"]))
         try:
-            res = store.install(e, force=args.force, only_agents=only)
+            res = store.install(e, force=args.force, only_agents=only, scope=args.scope)
         except BoostError as err:
             if not multi:
                 raise
@@ -414,7 +421,9 @@ def _update_materialized(kind: str, installed: Dict[str, dict], results) -> int:
         if not changed:
             continue
         try:
-            store.install(entry, force=True)
+            # keep the item where it was installed (user vs a specific repo).
+            store.install(entry, force=True,
+                          scope=lk.get("scope", "user"), base=lk.get("base"))
         except BoostError as err:
             out.warn("%s: %s" % (name, err.message))
             continue

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/boost_cli/core/rules.py

@@ -15,7 +15,7 @@ the filesystem writes and the lock record so uninstall can reverse them.
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Tuple
+from typing import Optional, Tuple
 
 # Name-scoped managed-block markers for CLAUDE.md. Stable + per-rule so install
 # is idempotent (a re-install replaces the block) and uninstall strips exactly
@@ -40,17 +40,27 @@ def markers(name: str) -> Tuple[str, str]:
     return BLOCK_START % name, BLOCK_END % name
 
 
-def rule_target(agent: str, skills_dir: Path, name: str) -> Tuple[str, Path]:
-    """Where rule ``name`` materializes for ``agent``, given its skills dir.
+def rule_target(agent: str, skills_dir: Path, name: str,
+                base: "Optional[Path]" = None) -> Tuple[str, Path]:
+    """Where rule ``name`` materializes for ``agent``.
 
-    Returns ``(mode, path)``: ``MODE_CLAUDE`` writes/merges the CLAUDE.md at the
-    agent root; ``MODE_FILE`` drops a file into the agent's ``rules/`` dir. The
-    agent root is the parent of its configured skills dir (``~/.cursor/skills``
-    -> ``~/.cursor``), so no extra config is needed.
+    Returns ``(mode, path)``: ``MODE_CLAUDE`` writes/merges a CLAUDE.md;
+    ``MODE_FILE`` drops a file into the agent's ``rules/`` dir.
+
+    ``base`` selects the scope:
+      * ``None`` (user scope) — the agent's user config: the parent of its
+        configured skills dir (``~/.cursor/skills`` -> ``~/.cursor``), and
+        ``~/.claude/CLAUDE.md`` for Claude.
+      * a directory (project scope) — that repo: ``<base>/.cursor/rules/…`` and,
+        since Claude reads per-repo memory from the root, ``<base>/CLAUDE.local.md``
+        (the personal, git-ignored file) for Claude.
     """
-    root = Path(skills_dir).parent
+    dotdir = Path(skills_dir).parent.name          # ".claude" / ".cursor" / …
     if agent in CLAUDE_MD_AGENTS:
-        return MODE_CLAUDE, root / "CLAUDE.md"
+        if base is not None:
+            return MODE_CLAUDE, Path(base) / "CLAUDE.local.md"
+        return MODE_CLAUDE, Path(skills_dir).parent / "CLAUDE.md"
+    root = (Path(base) / dotdir) if base is not None else Path(skills_dir).parent
     ext = RULE_DIR_EXT.get(agent, DEFAULT_RULE_EXT)
     return MODE_FILE, root / "rules" / (name + ext)
 

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/boost_cli/core/store.py

@@ -26,6 +26,7 @@ class InstallResult:
     score: int = 0
     upgraded: bool = False
     kind: str = "skill"
+    scope: str = "user"   # "user" or "project" — where a rule/workflow landed
     # For rules/workflows the installed content is a single file (or a merged
     # CLAUDE.md block), not a SKILL.md tree — carry the raw source so the caller
     # scans exactly what it installed instead of a non-existent SKILL.md.
@@ -117,14 +118,32 @@ def _copy_skill(src: Path, dest: Path) -> None:
         shutil.rmtree(backup, ignore_errors=True)
 
 
+def _resolve_base(scope: str, base) -> Optional[Path]:
+    """Directory a project-scoped install materializes under (the repo), or None
+    for user scope. An explicit ``base`` (e.g. from a lock record on update/sync)
+    wins so a re-materialization lands where the original install did, not in
+    whatever the current working directory happens to be."""
+    if base:
+        return Path(base)
+    return Path.cwd() if scope == "project" else None
+
+
 def install(entry: dict, force: bool = False,
-            only_agents: Optional[List[str]] = None) -> InstallResult:
-    """Install a catalog entry. Raises BoostError on policy block or conflict."""
+            only_agents: Optional[List[str]] = None,
+            scope: str = "user", base=None) -> InstallResult:
+    """Install a catalog entry. Raises BoostError on policy block or conflict.
+
+    ``scope`` is ``"user"`` (default — the agent's user config dirs) or
+    ``"project"`` (the current repo). Skills ignore scope (they always live in
+    the canonical store); rules/workflows honor it.
+    """
     kind = entry.get("kind", "skill")
     if kind == "rule":
-        return _install_rule(entry, force=force, only_agents=only_agents)
+        return _install_rule(entry, force=force, only_agents=only_agents,
+                             scope=scope, base=base)
     if kind == "workflow":
-        return _install_workflow(entry, force=force, only_agents=only_agents)
+        return _install_workflow(entry, force=force, only_agents=only_agents,
+                                 scope=scope, base=base)
     if kind != "skill":
         raise BoostError(
             "%s is a %s, which boost does not know how to install" % (entry["name"], kind),
@@ -172,14 +191,16 @@ def install(entry: dict, force: bool = False,
 
 
 def _install_rule(entry: dict, force: bool = False,
-                  only_agents: Optional[List[str]] = None) -> InstallResult:
+                  only_agents: Optional[List[str]] = None,
+                  scope: str = "user", base=None) -> InstallResult:
     """Materialize a rule into each enabled agent's native format.
 
     Cursor/Windsurf/Cline get a verbatim file drop in their ``rules/`` dir
     (frontmatter preserved — it is native rule metadata); Claude Code has no
     rules folder, so the rule merges into ``CLAUDE.md`` as an idempotent managed
-    block. Every materialization is recorded so ``uninstall`` reverses exactly
-    what was written.
+    block. With ``scope="project"`` these land under the repo (and Claude uses
+    ``CLAUDE.local.md``). Every materialization is recorded so ``uninstall``
+    reverses exactly what was written.
     """
     import hashlib
 
@@ -204,13 +225,14 @@ def _install_rule(entry: dict, force: bool = False,
     meta, body = frontmatter.parse(raw)
     claude_body = rules.render_claude_body(str(meta.get("name") or name), body)
 
+    resolved_base = _resolve_base(scope, base)
     paths.ensure_dirs()
     materializations: List[dict] = []
     linked: List[str] = []
     for agent, skills_dir in agents.enabled_agents().items():
         if only_agents and agent not in only_agents:
             continue
-        mode, path = rules.rule_target(agent, skills_dir, name)
+        mode, path = rules.rule_target(agent, skills_dir, name, base=resolved_base)
         path.parent.mkdir(parents=True, exist_ok=True)
         if mode == rules.MODE_CLAUDE:
             current = path.read_text(encoding="utf-8") if path.exists() else ""
@@ -228,6 +250,8 @@ def _install_rule(entry: dict, force: bool = False,
         "source_file": entry.get("skill_md", ""),
         "commit": gitutil.head_commit(tap.path),
         "sha256": hashlib.sha256(raw.encode("utf-8")).hexdigest(),
+        "scope": scope,
+        "base": str(resolved_base) if resolved_base is not None else None,
         "installed_at": (existing or {}).get("installed_at", now),
         "updated_at": now,
         "materializations": materializations,
@@ -240,6 +264,7 @@ def _install_rule(entry: dict, force: bool = False,
         kind="rule", scan_text=raw)
     res.linked = linked
     res.upgraded = existing is not None
+    res.scope = scope
     return res
 
 
@@ -266,12 +291,14 @@ def _uninstall_rule(name: str, rule: dict) -> dict:
 
 
 def _install_workflow(entry: dict, force: bool = False,
-                      only_agents: Optional[List[str]] = None) -> InstallResult:
+                      only_agents: Optional[List[str]] = None,
+                      scope: str = "user", base=None) -> InstallResult:
     """Materialize a workflow (slash command / subagent) into each enabled agent.
 
     A verbatim Markdown drop into the agent's ``commands/`` or ``agents/`` dir —
-    the slot derived from the source path — with no transformation. Every drop is
-    recorded so ``uninstall`` removes exactly the files it wrote.
+    the slot derived from the source path — with no transformation. With
+    ``scope="project"`` the drop lands under the repo (``<repo>/.claude/…``).
+    Every drop is recorded so ``uninstall`` removes exactly the files it wrote.
     """
     import hashlib
 
@@ -296,13 +323,14 @@ def _install_workflow(entry: dict, force: bool = False,
     raw = src.read_text(encoding="utf-8", errors="replace")
     slot = workflows.detect_slot(source_rel)
 
+    resolved_base = _resolve_base(scope, base)
     paths.ensure_dirs()
     materializations: List[dict] = []
     linked: List[str] = []
     for agent, skills_dir in agents.enabled_agents().items():
         if only_agents and agent not in only_agents:
             continue
-        path = workflows.workflow_target(skills_dir, slot, name)
+        path = workflows.workflow_target(skills_dir, slot, name, base=resolved_base)
         path.parent.mkdir(parents=True, exist_ok=True)
         util.atomic_write_text(path, raw)
         materializations.append({"agent": agent, "slot": slot, "path": str(path)})
@@ -317,6 +345,8 @@ def _install_workflow(entry: dict, force: bool = False,
         "source_file": source_rel,
         "commit": gitutil.head_commit(tap.path),
         "sha256": hashlib.sha256(raw.encode("utf-8")).hexdigest(),
+        "scope": scope,
+        "base": str(resolved_base) if resolved_base is not None else None,
         "installed_at": (existing or {}).get("installed_at", now),
         "updated_at": now,
         "materializations": materializations,
@@ -329,6 +359,7 @@ def _install_workflow(entry: dict, force: bool = False,
         kind="workflow", scan_text=raw)
     res.linked = linked
     res.upgraded = existing is not None
+    res.scope = scope
     return res
 
 
@@ -506,7 +537,10 @@ def sync_apply(plan: Dict[str, list]) -> List[str]:
                 matches = [e for e in catalog.find(name)
                            if e["tap"] == tap_name and e.get("kind", "skill") == kind]
                 if matches:
-                    install(matches[0], force=True)
+                    # preserve the original scope/base so a project rule repairs
+                    # into its repo, not wherever sync happens to run.
+                    install(matches[0], force=True,
+                            scope=entry.get("scope", "user"), base=entry.get("base"))
                     actions.append("re-materialized %s %s from %s"
                                    % (kind, name, tap_name))
                     continue

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/boost_cli/core/workflows.py

@@ -14,6 +14,7 @@ the filesystem writes and the lock record so uninstall can reverse them.
 from __future__ import annotations
 
 from pathlib import Path
+from typing import Optional
 
 SLOT_COMMANDS = "commands"
 SLOT_AGENTS = "agents"
@@ -36,11 +37,16 @@ def detect_slot(source_rel: str) -> str:
     return SLOT_AGENTS if parts & AGENT_DIRS else SLOT_COMMANDS
 
 
-def workflow_target(skills_dir: Path, slot: str, name: str) -> Path:
+def workflow_target(skills_dir: Path, slot: str, name: str,
+                    base: Optional[Path] = None) -> Path:
     """Where workflow ``name`` (in ``slot``) materializes for an agent.
 
-    The agent root is the parent of its configured skills dir
-    (``~/.claude/skills`` -> ``~/.claude``), so the file lands at
-    ``<root>/<slot>/<name>.md`` with no extra config.
+    ``base`` selects the scope:
+      * ``None`` (user scope) — the parent of the agent's configured skills dir
+        (``~/.claude/skills`` -> ``~/.claude/<slot>/<name>.md``).
+      * a directory (project scope) — that repo's per-agent dotdir
+        (``<base>/.claude/<slot>/<name>.md``).
     """
-    return Path(skills_dir).parent / slot / (name + ".md")
+    root = (Path(base) / Path(skills_dir).parent.name) if base is not None \
+        else Path(skills_dir).parent
+    return root / slot / (name + ".md")

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/boost_skill_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.147
+Version: 1.0.149
 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.147 → boost_skill_cli-1.0.149}/boost_skill_cli.egg-info/SOURCES.txt

@@ -141,6 +141,7 @@ docs/roadmap/items/github-pages-deploy-is-broken-every-push.md
 docs/roadmap/items/golden-set-statistical-power.md
 docs/roadmap/items/hash-pinned-reproducible-toolchain-uv-lock.md
 docs/roadmap/items/html-validation-html-validate.md
+docs/roadmap/items/install-scope-user-or-project.md
 docs/roadmap/items/integrity-verification-boost-verify.md
 docs/roadmap/items/invocation-pid-logging-for-crash-correlation.md
 docs/roadmap/items/layering-guard-import-linter.md
@@ -216,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
@@ -230,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
@@ -248,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.147 → boost_skill_cli-1.0.149}/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.149/docs/roadmap/items/install-scope-user-or-project.md

@@ -0,0 +1,27 @@
+---
+id: install-scope-user-or-project
+board: code
+section: internals
+status: shipped
+category: Install engine · UX
+complexity: M
+impact: High
+wow: 3
+note: rules/workflows were user-global only
+order: 27
+owner: loop/install-scope
+pr: 169
+title: <code>boost install --scope user|project</code> for rules/workflows
+---
+Rule and workflow install always materialized into user-global agent config
+           (<code>~/.claude/CLAUDE.md</code>, <code>~/.cursor/rules</code>, …), so a
+           rule meant for one repo leaked into every session. Add
+           <code>--scope project</code>: materialize into the current repo instead —
+           <code>&lt;repo&gt;/.cursor/rules/</code>, <code>&lt;repo&gt;/.claude/commands|agents/</code>,
+           and, since Claude reads per-repo memory from the root and has no rules
+           folder, <code>&lt;repo&gt;/CLAUDE.local.md</code> (the personal, git-ignored
+           file). The chosen scope + base dir are recorded in the lock so
+           <code>update</code>/<code>sync</code> re-materialize back into the same
+           repo rather than wherever they happen to run. Default stays
+           <code>--scope user</code> (unchanged behavior). Uninstall already reverses
+           by recorded path, so it works for either scope.

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/docs/roadmap.html

@@ -118,7 +118,7 @@
       <div class="stat"><b>16</b><span>Shipped</span></div>
       <div class="stat"><b>1</b><span>Next up</span></div>
       <div class="stat"><b>4</b><span>Planned</span></div>
-      <div class="stat"><b>107</b><span>Loop finds</span></div>
+      <div class="stat"><b>108</b><span>Loop finds</span></div>
       <!-- /ROADMAP:stats -->
     </div>
   </section>
@@ -840,6 +840,29 @@ chunks instead cost ~70%.</p>
           <span class="m">close the last skill-only gaps for rules/workflows</span>
         </div>
       </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Install engine · UX</span></div>
+        <h3><code>boost install --scope user|project</code> for rules/workflows</h3>
+        <p>Rule and workflow install always materialized into user-global agent config
+           (<code>~/.claude/CLAUDE.md</code>, <code>~/.cursor/rules</code>, …), so a
+           rule meant for one repo leaked into every session. Add
+           <code>--scope project</code>: materialize into the current repo instead —
+           <code>&lt;repo&gt;/.cursor/rules/</code>, <code>&lt;repo&gt;/.claude/commands|agents/</code>,
+           and, since Claude reads per-repo memory from the root and has no rules
+           folder, <code>&lt;repo&gt;/CLAUDE.local.md</code> (the personal, git-ignored
+           file). The chosen scope + base dir are recorded in the lock so
+           <code>update</code>/<code>sync</code> re-materialize back into the same
+           repo rather than wherever they happen to run. Default stays
+           <code>--scope user</code> (unchanged behavior). Uninstall already reverses
+           by recorded path, so it works for either scope.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>M</b></span>
+          <span class="m hi">Impact <b>High</b></span>
+          <span class="m">Wow <b class="wow">★★★</b></span>
+          <span class="m">rules/workflows were user-global only</span>
+        </div>
+      </article>
       <!-- /ROADMAP:cards -->
 
     </div>

{boost_skill_cli-1.0.147 → boost_skill_cli-1.0.149}/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.149/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.149/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.149/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.149/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"