boost-skill-cli 1.0.20__tar.gz → 1.0.22__tar.gz

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/PKG-INFO

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

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/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.20'
-__version_tuple__ = version_tuple = (1, 0, 20)
+__version__ = version = '1.0.22'
+__version_tuple__ = version_tuple = (1, 0, 22)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/boost_cli/commands/discovery.py

@@ -209,12 +209,16 @@ def cmd_search(argv):
         else:
             out.warn(ai.fallback_note())
     shown = scored[:args.limit]
-    width = max(len(e["name"]) for e, _ in shown)
+    # 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)
+    cols = out.term_width()
     for e, _s in shown:
-        line = out.c(e["name"].ljust(width + 3), out.CYAN) + (e["description"] or "")
-        if e.get("curated"):
-            line += " " + out.c("★ curated", out.YELLOW)
-        out.info(line)
+        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)
+        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(out.c("%d match%s · ranked by %s"
                    % (len(scored), "" if len(scored) == 1 else "es", ranker),
                    out.DIM))
@@ -450,12 +454,15 @@ def cmd_recommend(argv):
             out.info("no recommendations for this stack — try `boost search <keyword>`")
             return 0
         out.info("no stack-specific matches — curated picks instead:")
-    width = max(len(r["entry"]["name"]) for r in shown)
+    width = min(max(len(r["entry"]["name"]) for r in shown), 32)
+    cols = out.term_width()
     for r in shown:
         e = r["entry"]
-        out.info(out.c(e["name"].ljust(width + 3), out.CYAN)
-                 + (e["description"] or "") + "  "
-                 + out.c("because: %s" % ", ".join(sorted(r["because"])), out.DIM))
+        because = "because: %s" % ", ".join(sorted(r["because"]))
+        desc_w = max(cols - 2 - width - 2 - (len(because) + 2), 8)
+        name_cell = out.c(out.truncate(e["name"], width).ljust(width), out.CYAN)
+        out.info(name_cell + "  " + out.truncate(e["description"] or "", desc_w)
+                 + "  " + out.c(because, out.DIM))
     if ai.available():
         picks = _ai_picks(stack, [r["entry"] for r in ranked[:20]])
         if picks:

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/boost_cli/commands/quality.py

@@ -239,6 +239,8 @@ def cmd_doctor(argv):
     ap.parse_args(argv)
     issues = 0
 
+    out.heading("boost doctor")
+
     def bad(msg):
         nonlocal issues
         issues += 1
@@ -341,6 +343,11 @@ def cmd_doctor(argv):
         out.ok("lock file integrity OK · log rotation healthy")
     else:
         out.warn("lock file integrity or log rotation needs attention")
+
+    out.verdict(issues == 0,
+                "healthy" if not issues else
+                "%d issue%s need attention — see the suggestions above"
+                % (issues, _s(issues)))
     return 1 if issues else 0
 
 

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/boost_cli/core/output.py

@@ -10,6 +10,7 @@ Conventions used across all commands:
 from __future__ import annotations
 
 import os
+import shutil
 import sys
 
 RESET = "\033[0m"
@@ -142,7 +143,38 @@ def dim(msg: str) -> None:
 
 
 def heading(msg: str) -> None:
-    print(c("==> ", BLUE, BOLD) + c(msg, BOLD))
+    # Brand the section marker in Aurora cyan (truecolor, 16-color fallback,
+    # plain under NO_COLOR) so every command's headers read as one system.
+    print(aurora("==>", "cyan") + " " + c(msg, BOLD))
+
+
+def verdict(ok: bool, msg: str) -> None:
+    """A dashboard verdict line: a green dot when healthy, amber when not."""
+    dot = aurora("●", "green" if ok else "yellow")
+    print("  " + dot + " " + c(msg, GREEN if ok else YELLOW))
+
+
+def term_width(default: int = 80) -> int:
+    """Best-effort terminal column count; a stable default when detached."""
+    return shutil.get_terminal_size((default, 20)).columns
+
+
+def truncate(text: str, width: int, ellipsis: str = "…") -> str:
+    """Collapse whitespace (including literal \\n / \\t escapes) to single
+    spaces, then clip to at most `width` columns with a trailing ellipsis.
+
+    Keeps list output to one tidy line each — a 2,000-char blob becomes a
+    scannable snippet instead of blowing up the pane.
+    """
+    text = text.replace("\\n", " ").replace("\\t", " ").replace("\\r", " ")
+    text = " ".join(text.split())
+    if width <= 0:
+        return ""
+    if len(text) <= width:
+        return text
+    if width <= len(ellipsis):
+        return ellipsis[:width]
+    return text[:width - len(ellipsis)] + ellipsis
 
 
 def kv(key: str, value: str, width: int = 14) -> None:

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/boost_skill_cli.egg-info/PKG-INFO

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

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/docs/design-roadmap.html

@@ -278,7 +278,7 @@
       <div class="rcards">
 
         <article class="ritem" data-track="layout" data-impact="high">
-          <div class="ritem-top"><span class="rid">BOOST-D05</span><span class="rstatus next">Next</span></div>
+          <div class="ritem-top"><span class="rid">BOOST-D05</span><span class="rstatus done">Shipped</span></div>
           <h4>Fix <code>search</code>: truncate &amp; width-clamp results</h4>
           <p>Today <code>boost search</code> is the worst screen in the app: a single result can dump a <b>2,000-character description with literal, unrendered <code>\\n\\n</code> escapes</b>, while names are padded to a fixed 30 columns that waste half the row. Clamp each row to the live terminal width, collapse whitespace/escape artifacts, and ellipsize. This one fix turns a wall of noise into a scannable list.</p>
           <div class="rmeta"><span class="m-cat">layout</span><span>Complexity M</span><span class="m-imp high">Impact High</span><span class="m-wow">★★★★★</span></div>
@@ -388,7 +388,7 @@
         </article>
 
         <article class="ritem" data-track="commands" data-impact="med">
-          <div class="ritem-top"><span class="rid">BOOST-D15</span><span class="rstatus proposed">Proposed</span></div>
+          <div class="ritem-top"><span class="rid">BOOST-D15</span><span class="rstatus done">Shipped</span></div>
           <h4><code>doctor</code> as a health dashboard</h4>
           <p><code>doctor</code> is an undifferentiated wall of green checks — no hierarchy, no headline. Reframe it as a panel with a verdict line (<code>● Healthy</code> in green / <code>● Attention</code> in amber), grouped checks, dim sub-detail, and severity color so a problem actually stands out instead of hiding among the ✓s.</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>

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/tests/functional/test_cli_discovery.py

@@ -6,6 +6,7 @@ asserting exact output shapes, exit codes, and on-disk cache effects.
 from __future__ import annotations
 
 import json
+import re
 import sqlite3
 import subprocess
 import types
@@ -104,6 +105,18 @@ class TestSearch:
         r = boost("search", "brainstorming")
         assert "★ curated" in r.out
 
+    def test_result_rows_clamp_to_terminal_width(self, boost, tapped,
+                                                 monkeypatch):
+        # D05: every result stays one line within the terminal width; a long
+        # description is clipped instead of blowing up the pane.
+        monkeypatch.setenv("COLUMNS", "60")
+        r = boost("search", "workflow")
+        ansi = re.compile(r"\x1b\[[0-9;]*m")
+        rows = [ln for ln in r.out.splitlines() if ln and "ranked by" not in ln]
+        assert rows
+        for ln in rows:
+            assert len(ansi.sub("", ln)) <= 60
+
     def test_smart_without_ai_warns_and_stays_heuristic(self, boost, tapped):
         r = boost("search", "testing", "--smart")
         assert "using the heuristic fallback" in r.out

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/tests/functional/test_cli_quality.py

@@ -52,12 +52,14 @@ class TestDoctor:
     def test_healthy_exact_summary_rc0(self, boost, tapped):
         boost("install", "brainstorming", "commit-messages")
         r = boost("doctor")
+        assert "boost doctor" in r.out            # branded dashboard header
         assert "git on PATH" in r.out
         assert "1 tap cloned & cached" in r.out
         assert "lock file parses (v3)" in r.out
         assert "2 skills present in store with agent links" in r.out
         assert "2 skills installed · 1 tap synced · 0 broken links" in r.out
         assert "lock file integrity OK · log rotation healthy" in r.out
+        assert "● healthy" in r.out               # dashboard verdict
 
     def test_broken_symlink_rc1(self, boost, installed):
         ghost = paths.home() / ".claude" / "skills" / "ghost"
@@ -65,6 +67,7 @@ class TestDoctor:
         r = boost("doctor", expect=1)
         assert "1 broken symlink in agent dirs — run `boost heal`" in r.out
         assert "1 skill installed · 1 tap synced · 1 broken link" in r.out
+        assert "need attention" in r.out          # verdict flips on issues
 
     def test_missing_store_rc1(self, boost, installed):
         shutil.rmtree(paths.store_dir() / "brainstorming")

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/tests/unit/test_mutation_hardening.py

@@ -128,9 +128,10 @@ class TestForcedColorOutput:
             "\033[2m  hint: try x\033[0m\n")
 
     def test_heading_exact_ansi(self, capsys):
+        # Aurora cyan marker (truecolor under forced color) + bold title.
         out.heading("Section")
         assert capsys.readouterr().out == (
-            "\033[34m\033[1m==> \033[0m\033[1mSection\033[0m\n")
+            "\033[38;2;34;211;238m==>\033[0m \033[1mSection\033[0m\n")
 
     def test_c_multi_style_order(self):
         assert out.c("x", out.RED, out.BOLD) == "\033[31m\033[1mx\033[0m"

{boost_skill_cli-1.0.20 → boost_skill_cli-1.0.22}/tests/unit/test_output.py

@@ -1,6 +1,7 @@
 """Unit tests: boost_cli/core/output.py — colors, symbols, tables, confirm."""
 from __future__ import annotations
 
+import os
 import sys
 
 import pytest
@@ -197,6 +198,86 @@ class TestGradient:
             "\033[0m")
 
 
+class TestHeadingAndVerdictColor:
+    def _force_truecolor(self, monkeypatch):
+        monkeypatch.setenv("COLORTERM", "truecolor")
+        monkeypatch.setenv("CLICOLOR_FORCE", "1")
+
+    def test_heading_marker_is_cyan_truecolor(self, monkeypatch, capsys):
+        self._force_truecolor(monkeypatch)
+        output.heading("Section")
+        out = capsys.readouterr().out
+        assert out.startswith("\033[38;2;34;211;238m==>\033[0m ")
+        assert "Section" in out
+
+    def test_verdict_ok_green_dot_and_green_text(self, monkeypatch, capsys):
+        self._force_truecolor(monkeypatch)
+        output.verdict(True, "healthy")
+        # aurora green dot (#4ade80) + green message text
+        assert capsys.readouterr().out == (
+            "  \033[38;2;74;222;128m●\033[0m \033[32mhealthy\033[0m\n")
+
+    def test_verdict_bad_yellow_dot_and_yellow_text(self, monkeypatch, capsys):
+        self._force_truecolor(monkeypatch)
+        output.verdict(False, "1 issue")
+        # aurora yellow dot (#facc15) + yellow message text
+        assert capsys.readouterr().out == (
+            "  \033[38;2;250;204;21m●\033[0m \033[33m1 issue\033[0m\n")
+
+
+class TestTermWidth:
+    def test_honors_columns_env(self, monkeypatch):
+        monkeypatch.setenv("COLUMNS", "123")
+        assert output.term_width() == 123
+
+    def test_detected_columns(self, monkeypatch):
+        monkeypatch.setattr(output.shutil, "get_terminal_size",
+                            lambda fb: os.terminal_size((93, 24)))
+        assert output.term_width() == 93
+
+    def test_default_80_when_undetectable(self, monkeypatch):
+        monkeypatch.delenv("COLUMNS", raising=False)
+        monkeypatch.setattr(output.shutil, "get_terminal_size",
+                            lambda fb: os.terminal_size(fb))
+        assert output.term_width() == 80
+
+    def test_custom_default_when_undetectable(self, monkeypatch):
+        monkeypatch.delenv("COLUMNS", raising=False)
+        monkeypatch.setattr(output.shutil, "get_terminal_size",
+                            lambda fb: os.terminal_size(fb))
+        assert output.term_width(77) == 77
+
+
+class TestTruncate:
+    def test_short_text_unchanged(self):
+        assert output.truncate("hello", 80) == "hello"
+
+    def test_exact_width_not_clipped(self):
+        assert output.truncate("abcd", 4) == "abcd"
+
+    def test_clips_with_ellipsis(self):
+        assert output.truncate("abcdef", 4) == "abc…"
+
+    def test_collapses_real_whitespace(self):
+        assert output.truncate("a\n\n  b\tc", 80) == "a b c"
+
+    def test_collapses_literal_escape_sequences(self):
+        # descriptions in the wild carry literal backslash-n blobs
+        assert output.truncate("a\\n\\nb", 80) == "a b"
+
+    def test_collapses_literal_tab_escape(self):
+        assert output.truncate("a\\tb", 80) == "a b"
+
+    def test_collapses_literal_cr_escape(self):
+        assert output.truncate("a\\rb", 80) == "a b"
+
+    def test_zero_width_is_empty(self):
+        assert output.truncate("abc", 0) == ""
+
+    def test_width_at_or_below_ellipsis_returns_ellipsis(self):
+        assert output.truncate("abcdef", 1) == "…"
+
+
 class TestHelpers:
     @pytest.fixture(autouse=True)
     def plain(self, monkeypatch):
@@ -236,6 +317,14 @@ class TestHelpers:
         output.heading("Section")
         assert capsys.readouterr().out == "==> Section\n"
 
+    def test_verdict_healthy_plain(self, capsys):
+        output.verdict(True, "healthy")
+        assert capsys.readouterr().out == "  ● healthy\n"
+
+    def test_verdict_attention_plain(self, capsys):
+        output.verdict(False, "2 issues need attention")
+        assert capsys.readouterr().out == "  ● 2 issues need attention\n"
+
     def test_kv_default_width(self, capsys):
         output.kv("key", "value")
         assert capsys.readouterr().out == "  key           value\n"