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

{boost_skill_cli-1.0.159 → 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:

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

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

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

{boost_skill_cli-1.0.159 → 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.159
+Version: 1.0.161
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE

{boost_skill_cli-1.0.159 → 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.159 → 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.159 → boost_skill_cli-1.0.161}/docs/roadmap.html

@@ -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")