boost-skill-cli 1.0.24__tar.gz → 1.0.26__tar.gz

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/PKG-INFO

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

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/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.24'
-__version_tuple__ = version_tuple = (1, 0, 24)
+__version__ = version = '1.0.26'
+__version_tuple__ = version_tuple = (1, 0, 26)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/boost_cli/commands/discovery.py

@@ -212,13 +212,19 @@ def cmd_search(argv):
     # Cap the name column so one long name can't pad every row, and clip each
     # description to the remaining terminal width so results stay one line each.
     name_w = min(max(len(e["name"]) for e, _ in shown), 32)
+    top = max((s for _e, s in shown), default=0) or 1
     cols = out.term_width()
-    for e, _s in shown:
+    for e, sc in shown:
+        # A relevance meter makes the ranking visible; tint it by magnitude.
+        frac = sc / top
+        hue = "cyan" if frac >= 0.66 else "violet" if frac >= 0.33 else "pink"
+        bar = out.aurora(out.meter(frac), hue)
         tag = "  " + out.c("★ curated", out.YELLOW) if e.get("curated") else ""
         tag_w = len("  ★ curated") if e.get("curated") else 0
-        desc_w = max(cols - 2 - name_w - 2 - tag_w, 8)
+        desc_w = max(cols - 2 - 5 - name_w - 2 - tag_w, 8)  # 5 = meter + space
         name_cell = out.c(out.truncate(e["name"], name_w).ljust(name_w), out.CYAN)
-        out.info(name_cell + "  " + out.truncate(e["description"] or "", desc_w) + tag)
+        out.info(bar + " " + name_cell + "  "
+                 + out.truncate(e["description"] or "", desc_w) + tag)
     out.info(out.c("%d match%s · ranked by %s"
                    % (len(scored), "" if len(scored) == 1 else "es", ranker),
                    out.DIM))
@@ -602,7 +608,9 @@ def cmd_trending(argv):
         if not curated:
             out.info("no curated skills available — add taps with `boost tap --defaults`")
             return 0
-        out.table([(e["name"], "v" + e["version"], e["description"])
+        descw = max(out.term_width() - 24, 24)  # reserve name + version columns
+        out.table([(e["name"], "v" + e["version"],
+                    out.truncate(e["description"], descw))
                    for e in sorted(curated, key=lambda e: e["name"])[:args.limit]])
         return 0
     agg = {}
@@ -611,8 +619,9 @@ def cmd_trending(argv):
         rec = agg.setdefault(name, {"count": 0, "last": ev.get("ts", "")})
         rec["count"] += 1
     ranked = sorted(agg.items(), key=lambda kv: (-kv[1]["count"], kv[0]))
+    descw = max(out.term_width() - 44, 24)  # reserve name/installs/last columns
     out.table([(name, str(rec["count"]), util.rel_time(rec["last"]),
-                by_name.get(name, {}).get("description", ""))
+                out.truncate(by_name.get(name, {}).get("description", ""), descw))
                for name, rec in ranked[:args.limit]],
               headers=("name", "installs", "last", "description"))
     out.info(out.c("based on local install activity", out.DIM))

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/boost_cli/core/output.py

@@ -183,6 +183,19 @@ def badge(label: str, hue: str = "cyan") -> str:
     return aurora("[" + label + "]", hue)
 
 
+def meter(fraction: float, width: int = 4) -> str:
+    """A tiny proportional bar for a 0..1 fraction — filled ▰ vs empty ▱.
+
+    Uncolored on purpose so callers can Aurora-tint it by magnitude.
+    """
+    if fraction < 0:
+        fraction = 0.0
+    elif fraction > 1:
+        fraction = 1.0
+    filled = round(fraction * width)
+    return "▰" * filled + "▱" * (width - filled)
+
+
 def kv(key: str, value: str, width: int = 14) -> None:
     print("  " + c(key.ljust(width), DIM) + str(value))
 

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/boost_skill_cli.egg-info/PKG-INFO

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

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/docs/design-roadmap.html

@@ -142,7 +142,7 @@
       <code>NO_COLOR</code> and non-TTY are always respected.
     </p>
     <div class="stats">
-      <div class="stat reveal"><b>22</b><span>Design opportunities</span></div>
+      <div class="stat reveal"><b>25</b><span>Design opportunities</span></div>
       <div class="stat reveal"><b>5</b><span>Design tracks</span></div>
       <div class="stat reveal"><b>0</b><span>New dependencies</span></div>
       <div class="stat reveal"><b>1:1</b><span>Web ↔ CLI parity goal</span></div>
@@ -213,7 +213,7 @@
       <button class="pill" data-filter="impact" data-val="med">Med</button>
       <button class="pill" data-filter="impact" data-val="low">Low</button>
     </div>
-    <p class="roadmap-count"><b id="shown">22</b> of <b>22</b> opportunities shown</p>
+    <p class="roadmap-count"><b id="shown">25</b> of <b>25</b> opportunities shown</p>
   </div>
 
   <div class="wrap" id="board">
@@ -273,7 +273,7 @@
           <h3>Structure &amp; Layout</h3>
           <p>Width-aware output, glass panels, and results that never blow up the pane.</p>
         </div>
-        <span class="n">5 items</span>
+        <span class="n">7 items</span>
       </div>
       <div class="rcards">
 
@@ -294,7 +294,7 @@
         </article>
 
         <article class="ritem" data-track="layout" data-impact="med">
-          <div class="ritem-top"><span class="rid">BOOST-D07</span><span class="rstatus proposed">Proposed</span></div>
+          <div class="ritem-top"><span class="rid">BOOST-D07</span><span class="rstatus done">Shipped</span></div>
           <h4>Relevance visualization in search</h4>
           <p>Results are "ranked by heuristic relevance" but the ranking is invisible — every row looks equal. Render a tiny gradient relevance bar or score glyph per hit and visually separate <b>curated</b> from GitHub-wide matches, so the eye lands on the best result first.</p>
           <div class="rmeta"><span class="m-cat">layout</span><span>Complexity M</span><span class="m-imp med">Impact Med</span><span class="m-wow">★★★★☆</span></div>
@@ -317,6 +317,22 @@
           <div class="rref"><code>commands/info.py · preview/cat</code></div>
         </article>
 
+        <article class="ritem" data-track="layout" data-impact="high">
+          <div class="ritem-top"><span class="rid">BOOST-D23</span><span class="rstatus done">Shipped</span></div>
+          <h4><code>trending</code> had the same overflow as <code>search</code></h4>
+          <p>Grading the un-touched commands surfaced a sibling of D05: <code>boost trending</code> piped raw catalog descriptions straight into <code>table()</code>, so a single 300-char description blew the table across the pane. Fixed by clipping each description through <code>out.truncate()</code> to the width left after the name/installs/last columns — the same helper the search fix introduced.</p>
+          <div class="rmeta"><span class="m-cat">layout</span><span>Complexity S</span><span class="m-imp high">Impact High</span><span class="m-wow">★★★★☆</span></div>
+          <div class="rref"><code>commands/discovery.py · cmd_trending</code></div>
+        </article>
+
+        <article class="ritem" data-track="layout" data-impact="med">
+          <div class="ritem-top"><span class="rid">BOOST-D24</span><span class="rstatus proposed">Proposed</span></div>
+          <h4>Width-aware shared <code>table()</code></h4>
+          <p><code>out.table()</code> backs 28 call sites, and several still overflow: <code>taps</code> pads the NAME column to the widest repo (<code>K-Dense-AI/claude-scientific-skills</code> = 44 cols) and then prints full URLs, so wide catalogs wrap. The durable fix is to make <code>table()</code> itself width-aware — shrink the widest text column to the terminal and right-align numeric columns — instead of truncating per-caller. Higher blast radius (28 callers, many exact-output tests), so it needs a careful, test-first pass.</p>
+          <div class="rmeta"><span class="m-cat">layout</span><span>Complexity L</span><span class="m-imp med">Impact Med</span><span class="m-wow">★★★★☆</span></div>
+          <div class="rref"><code>core/output.py:table() · commands/taps.py</code></div>
+        </article>
+
       </div>
     </section>
 
@@ -375,12 +391,12 @@
           <h3>Command-by-command Polish</h3>
           <p>The screens users actually stare at — front door, doctor, list, info.</p>
         </div>
-        <span class="n">5 items</span>
+        <span class="n">6 items</span>
       </div>
       <div class="rcards">
 
         <article class="ritem" data-track="commands" data-impact="med">
-          <div class="ritem-top"><span class="rid">BOOST-D14</span><span class="rstatus progress">In progress</span></div>
+          <div class="ritem-top"><span class="rid">BOOST-D14</span><span class="rstatus done">Shipped</span></div>
           <h4>Front door: gradient wordmark + section glyphs</h4>
           <p>The <code>boost</code> home screen is the first thing everyone sees. Today the wordmark is plain bold and every group header is the same generic yellow. Paint the <code>boost</code> wordmark with the Aurora gradient and give each command group a colored bullet/glyph keyed to a brand hue — turning a flat list into a branded index.</p>
           <div class="rmeta"><span class="m-cat">commands</span><span>Complexity M</span><span class="m-imp med">Impact Med</span><span class="m-wow">★★★★★</span></div>
@@ -419,6 +435,14 @@
           <div class="rref"><code>commands/info.py:117–119 · core/output.py</code></div>
         </article>
 
+        <article class="ritem" data-track="commands" data-impact="med">
+          <div class="ritem-top"><span class="rid">BOOST-D25</span><span class="rstatus proposed">Proposed</span></div>
+          <h4>Branded usage &amp; error output</h4>
+          <p>Run a subcommand wrong — <code>boost snapshot</code> with no action — and you get raw, unstyled <code>argparse</code>: a multi-line usage dump with a bare <code>error:</code>, nothing like the branded help. Route argparse's usage/error through the Aurora output layer (accent the program name, dim the usage grammar, use the standard <code>Error:</code> affordance) so <em>failure</em> looks as designed as success. Bonus: a "did you mean …" suggestion for unknown commands.</p>
+          <div class="rmeta"><span class="m-cat">ux</span><span>Complexity M</span><span class="m-imp med">Impact Med</span><span class="m-wow">★★★☆☆</span></div>
+          <div class="rref"><code>cli.py · argparse formatter</code></div>
+        </article>
+
       </div>
     </section>
 

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/tests/functional/test_cli_discovery.py

@@ -69,6 +69,14 @@ class TestSearch:
         assert r.out.index("commit-messages") < r.out.index("jira-integration")
         assert "2 matches · ranked by heuristic relevance" in r.out
 
+    def test_results_show_relevance_meter(self, boost, tapped):
+        # D07: the ranking is visible as a per-result meter; the top exact
+        # match earns a full bar.
+        r = boost("search", "commit", "messages")
+        assert "▰" in r.out
+        top = next(l for l in r.out.splitlines() if "commit-messages" in l)
+        assert "▰▰▰▰" in top
+
     def test_limit_caps_rows_but_footer_counts_all(self, boost, tapped):
         r = boost("search", "workflow", "--limit", "1")
         assert "tdd-workflow" in r.out
@@ -563,6 +571,14 @@ class TestTrending:
         assert "jira-integration" in r.out
         assert "brainstorming" not in r.out
 
+    def test_long_description_is_clipped(self, boost, tapped, monkeypatch):
+        # D23: description column must not dump raw — it clips to the width.
+        boost("install", "brainstorming")
+        monkeypatch.setenv("COLUMNS", "40")
+        r = boost("trending")
+        assert "brainstorming" in r.out
+        assert "…" in r.out
+
 
 # ---------------------------------------------------------------- stats
 

{boost_skill_cli-1.0.24 → boost_skill_cli-1.0.26}/tests/unit/test_output.py

@@ -296,6 +296,32 @@ class TestBadge:
             "\033[38;2;74;222;128m[installed]\033[0m")
 
 
+class TestMeter:
+    def test_full(self):
+        assert output.meter(1.0, 4) == "▰▰▰▰"
+
+    def test_empty(self):
+        assert output.meter(0.0, 4) == "▱▱▱▱"
+
+    def test_half(self):
+        assert output.meter(0.5, 4) == "▰▰▱▱"
+
+    def test_default_width_is_four(self):
+        assert output.meter(1.0) == "▰▰▰▰"
+
+    def test_clamps_above_one(self):
+        # 1.5 lands in (1, 2] — must still clamp, not overflow to 6 cells
+        assert output.meter(1.5, 4) == "▰▰▰▰"
+        assert output.meter(2.5, 4) == "▰▰▰▰"
+
+    def test_clamps_below_zero(self):
+        assert output.meter(-3.0, 4) == "▱▱▱▱"
+
+    def test_rounds_to_nearest_cell(self):
+        # 0.6 * 5 = 3.0 -> exactly three filled
+        assert output.meter(0.6, 5) == "▰▰▰▱▱"
+
+
 class TestHelpers:
     @pytest.fixture(autouse=True)
     def plain(self, monkeypatch):