release 0.9.10: check.sh's pyflakes hint named a command that fails on this host

The skip line said `pip install pyflakes`. On a PEP 668 distro (Arch, Debian
12+, Fedora) that is refused outright, and PEP 668's own error message then
steers the reader to pipx -- which cannot satisfy this check at all: it runs
`python3 -m pyflakes`, so pyflakes must be importable by the SYSTEM python3,
and a venv or pipx install leaves the check skipping forever.

The hint now states that constraint and gives both routes that work:

pip install --user --break-system-packages pyflakes # ~/.local, per python version
<package manager> python-pyflakes # e.g. pacman -S python-pyflakes

Also: the card's scripts/check.sh row listed the lint steps incompletely --
naming pyflakes or shellcheck but not both -- and never said either is skipped
when absent, with the tail reporting the skip count rather than a green
all-passed.

With pyflakes present this repo now reports "all 8 checks passed" with nothing
skipped, and pyflakes finds no issues in any tracked python file. The [~] path
was still exercised for this release by hiding the user site directory
(PYTHONNOUSERSITE=1), so the new text is what an affected reader actually sees.

Text-only release; blob untouched.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

CHANGELOG.md

@@ -8,6 +8,33 @@ track the **tooling and documentation**, not the underlying base model.
 
 ## [Unreleased]
 
+## [0.9.10] — 2026-09-19
+
+### Fixed
+
+- **`check.sh`'s pyflakes hint named a command that fails on the maintainer's own host.**
+  It said `pip install pyflakes`, which a PEP 668 distro (Arch, Debian 12+, Fedora) refuses
+  outright — and PEP 668's own error message then steers you to `pipx`, which **cannot**
+  satisfy this check: it runs `python3 -m pyflakes`, so pyflakes has to be importable by
+  the *system* interpreter, and a venv or pipx install leaves the check skipping forever.
+  The hint now says that, and gives both working routes: a `--user
+  --break-system-packages` install, or the distro package.
+- The card's `scripts/check.sh` row listed the lint steps incompletely (it named
+  `pyflakes` or `shellcheck` but not both) and did not mention that either one is skipped
+  when absent, with the tail reporting the count rather than a green all-passed.
+
+### Notes
+
+- With pyflakes present this repo now reports **all 8 checks passed** with nothing
+  skipped, and pyflakes finds no issues in any tracked python file. The `[~]` skip path was
+  still exercised for this release by hiding the user site directory
+  (`PYTHONNOUSERSITE=1`), so the new hint is the text an affected reader actually sees.
+- One gotcha the hint's `--user` route carries, worth knowing before you pick it: it
+  installs under `~/.local/lib/python3.X/site-packages`, which is scoped to that python
+  version. A distro upgrade to a new python minor silently returns this check to "skipped".
+  The distro package does not have that problem.
+- Text-only release; blob untouched, sha unchanged.
+
 ## [0.9.9] — 2026-09-19
 
 Second tier of the adversarial audit whose top tier shipped in 0.9.8. No template change,

CITATION.cff

@@ -1,5 +1,5 @@
 cff-version: 1.2.0
-version: 0.9.9
+version: 0.9.10
 date-released: "2026-09-19"
 title: "Janus-35B: A Sparse Distillation Wrapper for llmfan46's Qwen 3.6 35B-A3B Uncensored Heretic"
 message: "If you use this model card or its accompanying files, please cite as below."

README.md

@@ -140,7 +140,7 @@ OLLAMA_KV_CACHE_TYPE=q8_0 OLLAMA_FLASH_ATTENTION=1 ollama serve
 | `template`, `system`, `params` | Used by HF's Ollama bridge when users `ollama run hf.co/FoolDev/Janus-35B-HERETIC` directly. The bridge does **not** read `Modelfile` (see [HF Ollama docs](https://huggingface.co/docs/hub/en/ollama)); it ingests these three root-level files instead. Kept in sync with the `Modelfile`'s `TEMPLATE` / `SYSTEM` / `PARAMETER` directives. |
 | `scripts/build.sh` | Pulls a GGUF from `llmfan46/Qwen3.6-35B-A3B-uncensored-heretic-GGUF` (default Q4_K_M), runs it through `strip_mtp.py` (a no-op for these quants, kept as a guard), then runs `ollama create janus`. Quants published there: BF16, Q3_K_L, Q3_K_M, Q4_K_M, Q4_K_S, Q5_K_M, Q5_K_S, Q6_K, Q8_0. The bundled Q4_K_M *is* that repo's Q4_K_M; use this to build the others locally. |
 | `scripts/check_bridge_sync.py` | Run before pushing a `Modelfile` / `template` / `system` / `params` edit to verify the four configurations remain in sync. Exits 0 if in sync, 1 with a per-key diff if not. |
-| `scripts/check.sh` | Local lint: `bash -n`, `shellcheck`, `py_compile`, footgun-grep, `Modelfile`-vs-bridge-files sync and the Go `template` guard (`make check`) |
+| `scripts/check.sh` | Local lint: `bash -n`, `shellcheck`, `pyflakes`, `py_compile`, footgun-grep, `Modelfile`-vs-bridge-files sync and the Go `template` guard (`make check`). `shellcheck` and `pyflakes` are skipped with a `[~]` line if absent, and the tail reports how many were skipped rather than a green all-passed. |
 | `scripts/check_go_template.py` | Guards the Go `template`: Ollama's thinking detection, the condition that replays earlier turns' reasoning, the tool round trip, JSON tool signatures, and the reasoning-effort mapping — the xhigh and low arms and the medium/unset default (check 8 in `check.sh`) |
 | `scripts/live_check.sh` | Live end-to-end checks in an isolated, CPU-only Ollama (own port and model store; it refuses to run if Ollama reports a GPU): template selection, one tool call, string-argument replay, an earlier turn's reasoning replayed and a live tool chain's kept, every `reasoning_effort` value and the effort lines — 17 checks (`make live-check`) |
 | `scripts/verify_arch.py` | Cross-checks the README Architecture bullets (layer count, hidden size, expert counts and widths, native context, vocab) plus the underlying forward-pass structure (Gated Attention + Gated DeltaNet dims, partial RoPE, full-attention interval) against the bundled GGUF's `qwen35moe` metadata. Run on demand (`python3 scripts/verify_arch.py`; needs `pip install gguf`); reads the 21 GB GGUF (LFS smudge required — on an un-smudged pointer it now says so and exits 2) and exits non-zero on any mismatch. `block_count` is checked against **40**, this model's natural depth — the MTP-Preserved variant this repo does not ship reports 41. |

scripts/check.sh

@@ -97,7 +97,17 @@ if (( ${#PY_FILES[@]} )); then
             fi
         done
     else
-        yellow "[~] pyflakes not installed (skip). Install with: pip install pyflakes"
+        # The hint matters more than it looks: this check runs `python3 -m pyflakes`,
+        # so pyflakes has to be importable by the SYSTEM python3. A venv or a pipx
+        # install - which is exactly what PEP 668's own error message suggests -
+        # leaves this check skipping forever. And on a PEP 668 distro (Arch,
+        # Debian 12+, Fedora) the plain pip command below is refused outright.
+        yellow "[~] pyflakes not installed (skip). This check runs 'python3 -m pyflakes',"
+        yellow "    so it must be importable by the SYSTEM python3 - a venv or pipx install"
+        yellow "    does not satisfy it. Install with:  pip install pyflakes"
+        yellow "    PEP 668 distro (Arch, Debian 12+, Fedora), either:"
+        yellow "      pip install --user --break-system-packages pyflakes   # ~/.local, per python version"
+        yellow "      <your package manager> python-pyflakes                # e.g. pacman -S python-pyflakes"
         SKIPPED=$((SKIPPED + 1))
     fi
 fi