boost-skill-cli 1.0.158__tar.gz → 1.0.161__tar.gz

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/CONTRIBUTING.md

@@ -13,6 +13,22 @@ make venv          # pytest, coverage, mutmut, ruff, mypy — runtime stays stdl
 Every test runs against a throwaway `$HOME`, so nothing touches your real
 agent configs.
 
+### Reproduce the whole gate — `nox`
+
+[`noxfile.py`](noxfile.py) runs the exact gate the CI jobs run, in isolated
+venvs, across the supported interpreters:
+
+```bash
+pipx install nox        # or: pip install nox
+nox                     # lint + tests on every installed interpreter
+nox -s lint             # one session
+nox -s "tests-3.12"     # tests on a single interpreter
+nox -s smoke -s mutation
+```
+
+Each session installs the same tools and runs the same commands as `make` and
+CI, so "green on my machine" and "green in CI" mean the same thing.
+
 ### Pre-commit hooks (recommended)
 
 Catch the `make lint` findings *before* they reach CI:
@@ -33,6 +49,7 @@ auto-fixes straight back onto the branch.
 | Command | Gate |
 |---|---|
 | `make test` | unit + functional suites, **≥80% line coverage** |
+| `make patch-coverage` | changed-line coverage vs `main`, **≥80% of the diff** (PRs) |
 | `bash tests/smoke.sh` | 152 end-to-end checks through the real `./boost` shim |
 | `make mutation` | mutmut over `boost_cli/core`, **≥80% mutants killed** |
 | `ruff check boost_cli tests` | lint, zero findings |

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/Makefile

@@ -10,11 +10,11 @@ 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 bdd bench bench-cli
+.PHONY: venv test unit functional smoke coverage patch-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)
-	$(VENV)/bin/pip -q install pytest pytest-cov coverage mutmut ruff mypy codespell hypothesis import-linter
+	$(VENV)/bin/pip -q install pytest pytest-cov coverage mutmut ruff mypy codespell hypothesis import-linter diff-cover
 
 unit:
 	$(PYTEST) tests/unit -q
@@ -28,6 +28,12 @@ test:
 
 coverage: test
 
+# patch-coverage: gate coverage on the lines THIS branch changed vs main — the
+# same check CI runs on every PR. Needs a diff base, so run it on a branch.
+patch-coverage:
+	$(PYTEST) tests/unit tests/functional --cov=boost_cli --cov-report=xml --cov-fail-under=0 -q
+	$(VENV)/bin/diff-cover coverage.xml --compare-branch=origin/main --fail-under=80
+
 # shell-level functional suite: drives the real shim end-to-end in a sandbox
 smoke:
 	bash tests/smoke.sh

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.158
+Version: 1.0.161
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/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.158'
-__version_tuple__ = version_tuple = (1, 0, 158)
+__version__ = version = '1.0.161'
+__version_tuple__ = version_tuple = (1, 0, 161)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/boost_skill_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.158
+Version: 1.0.161
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/boost_skill_cli.egg-info/SOURCES.txt

@@ -11,6 +11,7 @@ README.md
 SECURITY.md
 boost
 index.html
+noxfile.py
 pyproject.toml
 setup.cfg
 boost_cli/__init__.py

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/docs/roadmap/items/one-command-every-env-nox.md

@@ -2,15 +2,15 @@
 id: one-command-every-env-nox
 board: code
 section: compat
-status: planned
+status: shipped
 category: Testing · Infra
 complexity: S
 impact: Med
 wow: 2
 note: local == CI
 order: 8
-owner:
-pr:
+owner: loop/nox
+pr: 184
 title: One command, every env — <code>nox</code>
 ---
 A <code>noxfile.py</code> makes the full lint / test / smoke / mutation

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/docs/roadmap/items/patch-coverage-gate-diff-cover.md

@@ -2,15 +2,15 @@
 id: patch-coverage-gate-diff-cover
 board: code
 section: pipeline
-status: planned
+status: shipped
 category: Testing · Gap
 complexity: S
 impact: Med
 wow: 2
 note: self-hosted
 order: 8
-owner:
-pr:
+owner: loop/patchcov
+pr: 183
 title: Patch-coverage gate — <code>diff-cover</code>
 ---
 Enforce coverage on the <em>changed lines</em> of each PR — no external

{boost_skill_cli-1.0.158 → boost_skill_cli-1.0.161}/docs/roadmap.html

@@ -1279,7 +1279,7 @@ improvement is real (or isn't)."</p>
       </article>
 
       <article class="cap rcard">
-        <div class="head"><span class="pill planned">Planned</span><span class="cat">Testing · Gap</span></div>
+        <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Testing · Gap</span></div>
         <h3>Patch-coverage gate — <code>diff-cover</code></h3>
         <p>Enforce coverage on the <em>changed lines</em> of each PR — no external
            service needed, it reads the same <code>coverage.xml</code> the suite
@@ -1834,7 +1834,7 @@ and the work stays visible.</p>
       </article>
 
       <article class="cap rcard">
-        <div class="head"><span class="pill planned">Planned</span><span class="cat">Testing · Infra</span></div>
+        <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Testing · Infra</span></div>
         <h3>One command, every env — <code>nox</code></h3>
         <p>A <code>noxfile.py</code> makes the full lint / test / smoke / mutation
            gate reproducible across 3.9&nbsp;→&nbsp;3.14 in isolated environments,

boost_skill_cli-1.0.161/noxfile.py

@@ -0,0 +1,69 @@
+"""One command, every env: run boost's quality gate in isolated venvs.
+
+`nox` runs the default gate (lint + tests); `nox -s <session>` runs one; and
+the multi-version `tests` session fans out across the supported interpreters:
+
+    nox                     # lint + tests across every installed interpreter
+    nox -s lint             # ruff / mypy / import-linter / codespell + drift checks
+    nox -s tests            # unit + functional on 3.9, 3.12, 3.14 (skips absent ones)
+    nox -s "tests-3.12"     # just one interpreter
+    nox -s smoke -s mutation
+
+Each session installs the SAME tools and runs the SAME commands as `make` and
+the CI jobs, so "green on my machine" and "green in CI" finally mean the same
+thing — a contributor can reproduce the exact gate before pushing. nox itself
+is the only thing to install first: `pipx install nox` (or `pip install nox`).
+"""
+
+import nox
+
+# Match the CI matrix and the >=3.9 floor in pyproject.toml.
+PYTHONS = ["3.9", "3.12", "3.14"]
+
+# `nox` with no -s runs these; the rest are opt-in.
+nox.options.sessions = ["lint", "tests"]
+# Reuse venvs between runs for speed; a contributor rarely wants a cold rebuild.
+nox.options.reuse_existing_virtualenvs = True
+# Local machines rarely have all of 3.9/3.12/3.14 — skip the missing ones
+# instead of erroring, so `nox` is useful with a single interpreter too.
+nox.options.error_on_missing_interpreters = False
+
+
+@nox.session
+def lint(session: nox.Session) -> None:
+    """ruff + mypy + import-linter + codespell + the generated-file drift checks."""
+    session.install("ruff", "mypy", "codespell", "import-linter")
+    session.install("-e", ".")
+    session.run("ruff", "check", "boost_cli", "tests")
+    session.run("mypy")
+    session.run("lint-imports")
+    session.run("codespell", "boost_cli", "docs", "README.md")
+    session.run("python", "scripts/build_registries.py", "--check")
+    session.run("python", "scripts/build_roadmap.py", "--check")
+    session.run("python", "scripts/import_budget.py")
+
+
+@nox.session(python=PYTHONS)
+def tests(session: nox.Session) -> None:
+    """Unit + functional suites with the 80% line-coverage gate."""
+    session.install("pytest", "pytest-cov", "coverage", "hypothesis")
+    session.install("-e", ".")
+    session.run(
+        "pytest", "tests/unit", "tests/functional",
+        "--cov=boost_cli", "--cov-report=term-missing", "-q",
+    )
+
+
+@nox.session
+def smoke(session: nox.Session) -> None:
+    """The shell-level smoke suite through the real ./boost shim."""
+    session.install("-e", ".")
+    session.run("bash", "tests/smoke.sh", external=True)
+
+
+@nox.session
+def mutation(session: nox.Session) -> None:
+    """Mutation testing over boost_cli/core with the 80% kill gate."""
+    session.install("mutmut", "pytest", "pytest-cov", "coverage", "hypothesis")
+    session.install("-e", ".")
+    session.run("python", "scripts/mutation_gate.py", "--run", "--min", "80")