boost-skill-cli 1.0.38__tar.gz → 1.0.40__tar.gz

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/PKG-INFO

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

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/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.38'
-__version_tuple__ = version_tuple = (1, 0, 38)
+__version__ = version = '1.0.40'
+__version_tuple__ = version_tuple = (1, 0, 40)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/boost_cli/commands/discovery.py

@@ -15,7 +15,7 @@ import sys
 import time
 from pathlib import Path
 
-from .. import cliparse
+from .. import cliparse, spin
 from ..core import agents, ai, catalog, dense, embed, gitutil, journal, lockfile, paths, rag, registry, store, util
 from ..core import output as out
 from ..errors import BoostError
@@ -204,7 +204,8 @@ def cmd_search(argv):
     ranker = "full-content BM25" if use_rag else "heuristic relevance"
     if args.smart:
         if ai.available():
-            reranked = _ai_rank(query, scored)
+            with spin.Spinner("ranking %d matches with Claude" % len(scored)):
+                reranked = _ai_rank(query, scored)
             if reranked:
                 scored, ranker = reranked, "Claude Haiku relevance"
         else:

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/boost_cli/commands/info.py

@@ -123,9 +123,13 @@ def cmd_list(argv):
     rows = []
     for name in sorted(skills):
         e = skills[name]
-        flags = (["pinned"] if e.get("pinned") else []) + \
-                (["quarantined"] if e.get("quarantined") else []) + \
-                ["#" + t for t in e.get("tags") or []]
+        # Aurora-tinted flags — now that table() aligns by visible width,
+        # colored cells stay in their column: pinned amber, quarantined pink,
+        # tags dim.
+        flags = ([out.aurora("pinned", "yellow")] if e.get("pinned") else []) + \
+                ([out.aurora("quarantined", "pink")] if e.get("quarantined")
+                 else []) + \
+                [out.c("#" + t, out.DIM) for t in e.get("tags") or []]
         rows.append((name, e.get("version", "?"), e.get("tap", "?"),
                      "·".join(a.split("-")[0] for a in e.get("agents") or []),
                      " ".join(flags)))

boost_skill_cli-1.0.40/boost_cli/spin.py

@@ -0,0 +1,56 @@
+"""A braille spinner for indeterminate waits (network calls, AI reranking…).
+
+Deliberately silent — no thread, no output — whenever the stream isn't an
+interactive TTY or color is off, so piped output, CI logs and captured test
+output stay clean. Usage:
+
+    with spin.Spinner("ranking with Claude"):
+        result = slow_network_call()
+"""
+from __future__ import annotations
+
+import itertools
+import sys
+import threading
+from typing import Optional
+
+from .core import output as out
+
+_FRAMES = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+_INTERVAL = 0.08
+
+
+class Spinner:
+    def __init__(self, label: str = "", stream=None):
+        self.label = label
+        self.stream = stream if stream is not None else sys.stderr
+        self._stop = threading.Event()
+        self._thread: Optional[threading.Thread] = None
+
+    def active(self) -> bool:
+        """Animate only on an interactive, color-capable TTY."""
+        s = self.stream
+        return (out.color_level(s) > 0
+                and hasattr(s, "isatty") and s.isatty())
+
+    def __enter__(self) -> "Spinner":
+        if self.active():
+            self._thread = threading.Thread(target=self._spin, daemon=True)
+            self._thread.start()
+        return self
+
+    def _spin(self) -> None:
+        for frame in itertools.cycle(_FRAMES):
+            if self._stop.is_set():
+                break
+            self.stream.write("\r" + out.aurora(frame, "cyan") + " " + self.label)
+            self.stream.flush()
+            self._stop.wait(_INTERVAL)
+
+    def __exit__(self, *exc) -> None:
+        self._stop.set()
+        if self._thread is not None:
+            self._thread.join(timeout=1)
+        if self.active():
+            self.stream.write("\r" + " " * (out.visible_len(self.label) + 2) + "\r")
+            self.stream.flush()

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/boost_skill_cli.egg-info/PKG-INFO

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

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/boost_skill_cli.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ boost_cli/_version.py
 boost_cli/cli.py
 boost_cli/cliparse.py
 boost_cli/errors.py
+boost_cli/spin.py
 boost_cli/commands/__init__.py
 boost_cli/commands/bmad.py
 boost_cli/commands/configuration.py
@@ -101,6 +102,7 @@ tests/unit/test_paths.py
 tests/unit/test_policy.py
 tests/unit/test_rag.py
 tests/unit/test_registry.py
+tests/unit/test_spin.py
 tests/unit/test_store.py
 tests/unit/test_util.py
 tests/unit/test_version.py

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/docs/design-roadmap.html

@@ -349,7 +349,7 @@
       <div class="rcards">
 
         <article class="ritem" data-track="motion" data-impact="high">
-          <div class="ritem-top"><span class="rid">BOOST-D10</span><span class="rstatus next">Next</span></div>
+          <div class="ritem-top"><span class="rid">BOOST-D10</span><span class="rstatus done">Shipped</span></div>
           <h4>Braille spinner for network waits</h4>
           <p>Network-bound commands — <code>search</code> (AI rank), <code>tap</code> clone, <code>discover</code>, <code>index</code> — currently freeze silently while they work. Add a lightweight braille-dot spinner (<code>⠋⠙⠹⠸…</code>) tinted with the Aurora accent, auto-suppressed on non-TTY and under <code>NO_COLOR</code>. The single biggest "feels fast" upgrade.</p>
           <div class="rmeta"><span class="m-cat">motion</span><span>Complexity S</span><span class="m-imp high">Impact High</span><span class="m-wow">★★★★☆</span></div>

{boost_skill_cli-1.0.38 → boost_skill_cli-1.0.40}/docs/roadmap.html

@@ -116,7 +116,7 @@
       <div class="stat"><b>4</b><span>Shipped</span></div>
       <div class="stat"><b>3</b><span>Next up</span></div>
       <div class="stat"><b>4</b><span>Planned</span></div>
-      <div class="stat"><b>24</b><span>Loop finds</span></div>
+      <div class="stat"><b>32</b><span>Loop finds</span></div>
     </div>
   </section>
 
@@ -732,6 +732,146 @@
     </div>
   </section>
 
+  <!-- ============ DOCS-SITE & CONTENT QUALITY ============ -->
+  <section class="block reveal" id="docsite">
+    <div class="block-head">
+      <h2>Docs-site &amp; content quality</h2>
+      <span class="count">// planned · free tooling for the Pages site, README &amp; prose</span>
+      <span class="rule"></span>
+    </div>
+    <div class="rgrid">
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Docs · Perf</span></div>
+        <h3>Lighthouse CI on the Pages site</h3>
+        <p><code>treosh/lighthouse-ci-action</code> scores <code>index.html</code>
+           and <code>roadmap.html</code> on performance, accessibility,
+           best-practices and SEO on every deploy, and fails the build against
+           budgets. Turns the marketing surface's quality into a number that can't
+           silently regress as the Aurora theme evolves.</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">4 score budgets</span>
+        </div>
+      </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Quality · A11y</span></div>
+        <h3>Accessibility audit — <code>pa11y-ci</code> / axe-core</h3>
+        <p>Run WCAG checks over the rendered pages: colour contrast, focus order,
+           alt text and ARIA. The Aurora palette leans on muted
+           <code>--text-2/--text-3</code> tokens against dark glass — exactly where
+           contrast ratios slip below AA. Catches the a11y regressions a purely
+           visual review misses.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>M</b></span>
+          <span class="m">Impact <b>Med</b></span>
+          <span class="m">Wow <b class="wow">★★★★</b></span>
+          <span class="m">WCAG AA</span>
+        </div>
+      </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Quality · Docs</span></div>
+        <h3>HTML validation — <code>html-validate</code></h3>
+        <p>The guide and roadmap are hand-authored HTML whose tags are balanced by
+           eye today. A CI <code>html-validate</code> pass catches unclosed
+           elements, duplicate <code>id</code>s and invalid nesting before they
+           ship a subtly broken layout — the automated version of the manual
+           tag-count sanity check.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>S</b></span>
+          <span class="m">Impact <b>Med</b></span>
+          <span class="m">Wow <b class="wow">★★★</b></span>
+          <span class="m">hand-authored HTML</span>
+        </div>
+      </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Quality · Docs</span></div>
+        <h3>Broken-link &amp; anchor checking — <code>lychee</code></h3>
+        <p>Fast, free link checker over the README and <code>docs/*.html</code>:
+           verifies external URLs (GitHub, PyPI), asset paths
+           (<code>../style/boost.css</code>) and in-page anchors
+           (<code>#next</code>, <code>#health</code>) still resolve. A dead link in
+           the landing page is the first broken promise a visitor sees.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>S</b></span>
+          <span class="m">Impact <b>Med</b></span>
+          <span class="m">Wow <b class="wow">★★★</b></span>
+          <span class="m">URLs + anchors</span>
+        </div>
+      </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Quality · Content</span></div>
+        <h3>Prose &amp; terminology linting — <code>vale</code></h3>
+        <p><code>vale</code> enforces a consistent voice across the README and docs
+           with a small boost vocabulary — canonical spelling of <em>skill</em>,
+           <em>tap</em>, <em>registry</em>; no <code>Boost</code>/<code>boost</code>
+           drift; flagged weasel words. Keeps a docs-heavy project reading like one
+           author wrote it.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>S</b></span>
+          <span class="m">Impact <b>Low</b></span>
+          <span class="m">Wow <b class="wow">★★</b></span>
+          <span class="m">house style</span>
+        </div>
+      </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Quality · Docs</span></div>
+        <h3>Markdown consistency — <code>markdownlint-cli2</code></h3>
+        <p>Lint every Markdown surface — README, <code>CLAUDE.md</code>,
+           <code>DEBUGGING.md</code>, <code>rag-architecture.md</code> — for
+           heading order, list style and fenced-code hygiene. Cheap, deterministic,
+           and it keeps the contributor-facing docs as tidy as the code the gates
+           already enforce.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>S</b></span>
+          <span class="m">Impact <b>Low</b></span>
+          <span class="m">Wow <b class="wow">★★</b></span>
+          <span class="m">every .md</span>
+        </div>
+      </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Quality · Style</span></div>
+        <h3>Theme-asset linting — <code>stylelint</code> + <code>eslint</code></h3>
+        <p>The shared <code>style/boost.css</code> and <code>boost.js</code> theme
+           the guide, roadmap and demo together, so a bug there recolours or breaks
+           everything at once. <code>stylelint</code> guards the CSS tokens and
+           <code>eslint</code> the reveal/interaction JS — the one place a small
+           mistake has system-wide blast radius.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>S</b></span>
+          <span class="m">Impact <b>Med</b></span>
+          <span class="m">Wow <b class="wow">★★</b></span>
+          <span class="m">shared blast radius</span>
+        </div>
+      </article>
+
+      <article class="cap rcard">
+        <div class="head"><span class="pill planned">Planned</span><span class="cat">Testing · Docs</span></div>
+        <h3>Post-deploy smoke — headless load check</h3>
+        <p>After each Pages deploy, headless-load the guide and roadmap and assert
+           the essentials: HTTP 200, every asset resolves, and the console is free
+           of errors. Distinct from the planned visual-regression pass — this is a
+           cheap always-on health gate that would have caught the current broken
+           Pages deploy automatically.</p>
+        <div class="meta">
+          <span class="m">Complexity <b>M</b></span>
+          <span class="m">Impact <b>Med</b></span>
+          <span class="m">Wow <b class="wow">★★★</b></span>
+          <span class="m">catches red deploys</span>
+        </div>
+      </article>
+
+    </div>
+  </section>
+
   <footer>
     <p>Maintained by the boost quality loop · themed with
        <a href="../style/boost.css">style/boost.css</a> ·

boost_skill_cli-1.0.40/tests/unit/test_spin.py

@@ -0,0 +1,71 @@
+"""Unit tests: boost_cli/spin.Spinner — the TTY-guarded braille spinner."""
+from __future__ import annotations
+
+import io
+
+import pytest
+
+from boost_cli import spin
+
+
+class FakeStream(io.StringIO):
+    def __init__(self, tty):
+        super().__init__()
+        self._tty = tty
+
+    def isatty(self):
+        return self._tty
+
+
+@pytest.fixture(autouse=True)
+def force_color(monkeypatch):
+    # color on, so `active()` hinges purely on the TTY check
+    monkeypatch.delenv("NO_COLOR", raising=False)
+    monkeypatch.setenv("CLICOLOR_FORCE", "1")
+
+
+def test_silent_on_non_tty():
+    s = FakeStream(tty=False)
+    with spin.Spinner("working", stream=s) as sp:
+        pass
+    assert sp.active() is False
+    assert s.getvalue() == ""            # nothing written, no thread started
+    assert sp._thread is None
+
+
+def test_no_color_is_silent(monkeypatch):
+    monkeypatch.delenv("CLICOLOR_FORCE", raising=False)
+    monkeypatch.setenv("NO_COLOR", "1")
+    s = FakeStream(tty=True)             # a TTY, but color is off
+    with spin.Spinner("working", stream=s):
+        pass
+    assert s.getvalue() == ""
+
+
+def test_active_on_color_tty():
+    assert spin.Spinner("x", stream=FakeStream(tty=True)).active() is True
+
+
+def test_frames_are_braille():
+    assert spin._FRAMES == "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+
+
+def test_context_manager_returns_self():
+    s = FakeStream(tty=False)
+    sp = spin.Spinner("x", stream=s)
+    assert sp.__enter__() is sp
+    assert sp.__exit__(None, None, None) is None   # doesn't suppress exceptions
+
+
+def test_tty_run_writes_and_clears():
+    # exercise the animated path: wait (bounded) for the thread's first frame
+    import time
+    s = FakeStream(tty=True)
+    with spin.Spinner("go", stream=s):
+        for _ in range(50):
+            if s.getvalue():
+                break
+            time.sleep(0.02)
+    out = s.getvalue()
+    assert "\r" in out                   # in-place redraw
+    assert "go" in out                   # the label was shown