boost-skill-cli 1.2.36__tar.gz → 1.2.37__tar.gz

{boost_skill_cli-1.2.36/boost_skill_cli.egg-info → boost_skill_cli-1.2.37}/PKG-INFO

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

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.2.36'
-__version_tuple__ = version_tuple = (1, 2, 36)
+__version__ = version = '1.2.37'
+__version_tuple__ = version_tuple = (1, 2, 37)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/cli.py

@@ -199,7 +199,12 @@ def print_help() -> None:
         else:
             print(head)
         for n, s in cmds:
-            print("  " + out.c(n.ljust(width + 2), out.CYAN)
+            # accent, not a raw 16-color CYAN: every other command-name
+            # surface (search rows, info badges) resolves through this same
+            # semantic role, which is Aurora truecolor cyan with the correct
+            # 16-color/plain degradation — a raw CYAN here painted a visibly
+            # different cyan on any truecolor terminal.
+            print("  " + out.role(n.ljust(width + 2), "accent")
                   + out.truncate(s, max(0, cols - width - 4)))
     print()
     print(out.c("%d commands · %d groups" % (len(COMMANDS), len(GROUPS)), out.DIM))

boost_skill_cli-1.2.37/boost_cli/cliparse.py

@@ -0,0 +1,66 @@
+# Copyright the boost contributors.
+# SPDX-License-Identifier: GPL-3.0-only
+"""A branded ArgumentParser.
+
+Argparse's default failure output is a raw, unstyled ``usage:`` block with a
+bare ``prog: error: …`` line — nothing like boost's branded top-level dispatch
+(which routes through :func:`output.err` and offers a "did you mean"). This
+subclass routes a parser's own errors through the same Aurora output layer, so
+a wrong invocation looks as designed as a right one.
+
+Adopt it via :func:`parser` in place of ``argparse.ArgumentParser``. Sub-parsers
+created with ``add_subparsers()`` inherit this class automatically, so a single
+top-level swap brands a command's whole tree.
+"""
+from __future__ import annotations
+
+import argparse
+import sys
+
+from .core import output as out
+
+
+class _BoostHelpFormatter(argparse.HelpFormatter):
+    """Wraps help/description text the way :func:`output.wrap` does,
+    keeping a backtick-quoted command atomic instead of splitting it across
+    lines — the same rule every other long line in this CLI follows.
+
+    argparse's own ``HelpFormatter`` wraps with plain ``textwrap``, which
+    knows nothing about a backtick span (``doctor``/``search`` interpolate
+    hints ending in a pasteable ``pip install '...'``-style command; several
+    ``help=`` strings quote a ``boost`` invocation the same way) — so a
+    narrow terminal could split one across two lines, handing the user a
+    command that does not run. Only the two text-filling hooks are
+    overridden; ``_format_usage``'s own line-splitting already treats a
+    metavar as one atomic part and is left alone.
+    """
+
+    def _split_lines(self, text: str, width: int) -> list[str]:
+        text = self._whitespace_matcher.sub(" ", text).strip()
+        return out.wrap(text, width) or [text]
+
+    def _fill_text(self, text: str, width: int, indent: str) -> str:
+        text = self._whitespace_matcher.sub(" ", text).strip()
+        lines = out.wrap(text, max(width - len(indent), 1)) or [text]
+        return "\n".join(indent + ln for ln in lines)
+
+
+class BoostArgumentParser(argparse.ArgumentParser):
+    def __init__(self, *args, **kwargs):
+        # add_subparsers() creates each sub-parser via type(self)(**kwargs)
+        # without forwarding formatter_class, so defaulting it here (rather
+        # than in parser() below) is what brands every subcommand's --help
+        # too, not just the top-level one.
+        kwargs.setdefault("formatter_class", _BoostHelpFormatter)
+        super().__init__(*args, **kwargs)
+
+    def error(self, message: str):
+        """Print a branded error + dimmed usage, then exit 2 (argparse's code)."""
+        out.err(message)
+        sys.stderr.write(out.c(self.format_usage(), out.DIM))
+        self.exit(2)
+
+
+def parser(*args, **kwargs) -> BoostArgumentParser:
+    """Drop-in replacement for ``argparse.ArgumentParser(...)``."""
+    return BoostArgumentParser(*args, **kwargs)

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/commands/bmad.py

@@ -78,7 +78,11 @@ def cmd_bmad(argv) -> int:
     p = cliparse.parser(
         prog="boost bmad",
         description="BMAD Method autopilot: personas, prompt routing, workflows")
-    p.add_argument("action", choices=_ACTIONS, help=" | ".join(_ACTIONS))
+    # metavar="ACTION": the auto-generated {on,off,...,status} metavar (13
+    # entries) is one unbreakable token and overflowed the usage line up to
+    # 100 columns wide. The full list still shows in `help=` below.
+    p.add_argument("action", choices=_ACTIONS, metavar="ACTION",
+                   help=" | ".join(_ACTIONS))
     p.add_argument("value", nargs="?",
                    help="startup: on | off | status · route: the prompt to classify")
     p.add_argument("-s", "--scope", choices=("project", "global"), default=None,

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/commands/discovery.py

@@ -1630,7 +1630,7 @@ def cmd_stats(argv):
         else:
             out.kv("latest", "%s %s" % (latest, out.role("(up to date)", "muted")))
     if upstream:
-        out.kv("upstream", upstream)
+        out.kv("upstream", upstream, wrap=True)
     return 0
 
 

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/commands/info.py

@@ -13,7 +13,6 @@ import re
 import shlex
 import subprocess
 import sys
-import textwrap
 import webbrowser
 from itertools import chain
 from pathlib import Path
@@ -197,9 +196,12 @@ def _mark(installed: bool) -> str:
 
 
 def _print_wrapped(text: str) -> None:
+    """Wrap prose to the *real* pane via out.wrap(), not a hardcoded width —
+    a fixed textwrap width=76 neither shrank for a narrow terminal nor grew
+    for a wide one, and did not know a backtick span must stay whole."""
     paras = [p for p in re.split(r"\n\s*\n", text.strip()) if p.strip()]
     for i, para in enumerate(paras):
-        for line in textwrap.wrap(" ".join(para.split()), width=76):
+        for line in out.wrap(" ".join(para.split()), out.term_width() - 2):
             out.info(line)
         if i < len(paras) - 1:
             print()
@@ -471,10 +473,11 @@ def cmd_info(argv):
     if badges:
         out.info(" ".join(badges))
     if desc:
-        lines = textwrap.wrap(desc, width=62)
-        out.kv("description", lines[0])
-        for ln in lines[1:]:
-            print(" " * 16 + ln)
+        # kv's own wrap=True already folds to the real terminal width and
+        # aligns continuations under the value — the hand-rolled version this
+        # replaced hardcoded width=62 (a hand copy of kv's default 16-column
+        # lead against a fixed 78-column pane) and ignored COLUMNS entirely.
+        out.kv("description", desc, wrap=True)
     if lock:
         inst_v = str(lock.get("version", "?"))
         out.kv("version", inst_v)
@@ -630,9 +633,19 @@ def _render_markdown(body: str) -> None:
             continue
         m = re.match(r"^(\s*)[-*]\s+(.*)$", line)
         if m:
-            print("%s • %s" % (m.group(1), _inline(m.group(2))))
+            prefix = "%s • " % m.group(1)
+            # Wrap the raw markdown first, THEN colorize each wrapped chunk —
+            # coloring before wrapping (the old behavior for the plain-prose
+            # branch below) would either split an inline `code` span or leave
+            # line 1's color code unterminated. A backtick span is one atomic
+            # token either way, via out.wrap().
+            wrapped = out.wrap(m.group(2), out.term_width() - len(prefix)) or [""]
+            for i, chunk in enumerate(wrapped):
+                lead = prefix if i == 0 else " " * len(prefix)
+                print(lead + _inline(chunk))
             continue
-        print(_inline(line))
+        for chunk in out.wrap(line, out.term_width()) or [""]:
+            print(_inline(chunk))
 
 
 def cmd_preview(argv):

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/commands/intelligence.py

@@ -772,8 +772,10 @@ _CONTEXT_DEFAULT = {"enabled": False, "rules": []}
 def cmd_context(argv: list[str]) -> int:
     ap = cliparse.parser(
         prog="boost context", description="Branch-aware skill activation")
-    sub = ap.add_subparsers(dest="action",
-                            metavar="status|enable|disable|map|unmap|apply")
+    # metavar="ACTION": the full "status|enable|disable|map|unmap|apply"
+    # spelling is one unbreakable token that overflowed the usage line at 60
+    # columns. Each subcommand still lists its own help= below.
+    sub = ap.add_subparsers(dest="action", metavar="ACTION")
     sp = sub.add_parser("status", help="show rules, enabled flag & branch")
     sp.add_argument("--json", action="store_true")
     sub.add_parser("enable", help="turn on branch-aware activation (runs apply)")
@@ -873,7 +875,8 @@ def _context_status(state: dict, as_json: bool) -> int:
     out.kv("branch", branch or "(not in a git repository)")
     rules = state.get("rules", [])
     if not rules:
-        out.info("no rules — add one with `boost context map 'feature/*' skill1,skill2`")
+        out.info("no rules — add one with `boost context map 'feature/*' "
+                "skill1,skill2`", wrap=True)
         return 0
     rows = [(r.get("pattern", "?"), ", ".join(r.get("skills", [])),
              "*" if branch and fnmatch.fnmatch(branch, r.get("pattern", "")) else "")

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/commands/team.py

@@ -128,7 +128,7 @@ def cmd_cohort(argv) -> int:
             raise BoostError("no cohort named %s" % args.name,
                             hint="list cohorts with `boost cohort list`")
         if not targets:
-            out.info("no cohorts defined")
+            print(out.empty_state("no cohorts defined"))
             return 0
         applied = skipped = 0
         for cname in targets:
@@ -174,8 +174,11 @@ def cmd_cohort(argv) -> int:
         print(json.dumps(data, indent=2))
         return 0
     if not rows:
-        out.info("no cohorts defined")
-        out.info(out.role("create one: `boost cohort create pilot --skills tdd-workflow --percent 50`", "muted"))
+        print(out.empty_state(
+            "no cohorts defined",
+            hint="create one: `boost cohort create pilot --skills "
+                 "tdd-workflow --percent 50`",
+            wrap=True))
         return 0
     out.table(rows, headers=("COHORT", "SKILLS", "ROLLOUT", "YOU"))
     print()
@@ -518,7 +521,9 @@ def cmd_pulse(argv) -> int:
         print(json.dumps(events, indent=2))
         return 0
     if not events:
-        out.info("no activity yet — events appear as you install and manage skills")
+        print(out.empty_state(
+            "no activity yet — events appear as you install and manage skills",
+            wrap=True))
         return 0
     for e in events:
         action = e.get("action", "?")
@@ -557,7 +562,9 @@ def cmd_replay(argv) -> int:
             print(json.dumps(history, indent=2))
             return 0
         if not history:
-            out.info("no lock history yet — every install/uninstall snapshots the lock file")
+            print(out.empty_state(
+                "no lock history yet — every install/uninstall snapshots "
+                "the lock file", wrap=True))
             return 0
         rows = []
         prev_items = None
@@ -693,8 +700,9 @@ def cmd_who(argv) -> int:
 
     events = journal.events(subject=args.skill) if args.skill else journal.events()
     if not events:
-        out.info("no journal activity yet — expertise builds as people install, "
-                 "edit, and evolve skills")
+        print(out.empty_state(
+            "no journal activity yet — expertise builds as people install, "
+            "edit, and evolve skills", wrap=True))
         return 0
 
     if args.skill:

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_cli/core/output.py

@@ -16,6 +16,7 @@ import os
 import re
 import shutil
 import sys
+import unicodedata
 from collections.abc import Sequence
 from dataclasses import dataclass
 
@@ -336,9 +337,30 @@ def badge(label: str, hue: str = "cyan") -> str:
 _ANSI_RE = re.compile(r"\033\[[0-9;]*m")
 
 
+def _char_width(ch: str) -> int:
+    """Terminal display width of one character: 2 for wide/fullwidth CJK and
+    most emoji, 0 for a combining mark, 1 otherwise.
+
+    A pure-stdlib approximation of wcwidth via ``unicodedata`` — no dependency
+    to earn just for column math, and the two classes it distinguishes
+    (``unicodedata.east_asian_width`` returning "W"/"F") are exactly the ones
+    that render two columns wide in every terminal this CLI targets.
+    """
+    if unicodedata.combining(ch):
+        return 0
+    return 2 if unicodedata.east_asian_width(ch) in ("W", "F") else 1
+
+
 def visible_len(s: str) -> int:
-    """Length of a string ignoring ANSI color escapes — its column width."""
-    return len(_ANSI_RE.sub("", s))
+    """Column width of a string: ANSI escapes cost nothing, a wide character
+    (CJK, most emoji) costs 2, everything else costs 1.
+
+    ``len()`` alone undercounts any string holding a double-width character,
+    which is what silently misaligned a table the moment a cell held an emoji
+    or CJK text — the column budget was measured a codepoint short of what
+    the terminal actually draws.
+    """
+    return sum(_char_width(ch) for ch in _ANSI_RE.sub("", s))
 
 
 _CODE_SPAN_RE = re.compile(r"`[^`]*`")
@@ -457,13 +479,26 @@ _TRAFFIC = ((0xff, 0x5f, 0x57, RED), (0xfe, 0xbc, 0x2e, YELLOW),
             (0x28, 0xc8, 0x40, GREEN))
 
 
-def empty_state(message: str, hint: str | None = None) -> str:
+def empty_state(message: str, hint: str | None = None, wrap: bool = False) -> str:
     """A standardized empty-state: a muted ○ bullet + message, with an optional
     dim → hint on the next line. One affordance so 'nothing here' always reads
-    the same across commands."""
-    out_lines = ["  " + c("○ " + message, DIM)]
+    the same across commands.
+
+    ``wrap`` as in :func:`warn`: opt-in, folding each block to the pane rather
+    than always-on, so a call site with an atomic backtick-quoted command
+    (e.g. cohort's create hint) still gets that command whole rather than
+    split across lines. Both markers ("○ " / "→ ") are two visible columns,
+    matching the module's other 4-column-lead emitters (2-space indent + a
+    2-wide marker), so message and hint wrap to the same budget.
+    """
+    def _block(marker: str, text: str) -> list[str]:
+        body = _wrap_lines(text, 4) if wrap else [text]
+        return (["  " + c(marker + body[0], DIM)]
+                + ["    " + c(ln, DIM) for ln in body[1:]])
+
+    out_lines = _block("○ ", message)
     if hint:
-        out_lines.append("  " + c("→ " + hint, DIM))
+        out_lines += _block("→ ", hint)
     return "\n".join(out_lines)
 
 
@@ -676,8 +711,11 @@ def _clip_visible(s: str, width: int, ellipsis: str = "…") -> str:
             had_escape = True
             i = m.end()
             continue
+        w = _char_width(s[i])
+        if vis + w > keep:
+            break  # a wide character never gets cut in half for the ellipsis
         out_chars.append(s[i])
-        vis += 1
+        vis += w
         i += 1
     result = "".join(out_chars) + ellipsis
     if had_escape and not result.endswith(RESET):

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37/boost_skill_cli.egg-info}/PKG-INFO

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

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/boost_skill_cli.egg-info/SOURCES.txt

@@ -196,6 +196,7 @@ docs/roadmap/items/BOOST-D23.md
 docs/roadmap/items/BOOST-D24.md
 docs/roadmap/items/BOOST-D25.md
 docs/roadmap/items/BOOST-D26.md
+docs/roadmap/items/BOOST-D27.md
 docs/roadmap/items/a11y-sweep-flakes-on-color-contrast.md
 docs/roadmap/items/accessibility-audit-pa11y-ci-axe-core.md
 docs/roadmap/items/actionlint-skips-shellcheck-silently.md

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/docs/commands.html

@@ -156,7 +156,7 @@
       <a class="cmd-link" href="#cmd-infer" data-search="infer generate a skill.md from your codebase patterns  --path dir --name n -o, --output file --install">infer</a>
       <a class="cmd-link" href="#cmd-absorb" data-search="absorb turn recurring chat-history patterns into a skill  --history path --limit n --install">absorb</a>
       <a class="cmd-link" href="#cmd-evolve" data-search="evolve iteratively improve a skill from feedback  --feedback text --apply name">evolve</a>
-      <a class="cmd-link" href="#cmd-context" data-search="context branch-aware skill activation  status|enable|disable|map|unmap|apply">context</a>
+      <a class="cmd-link" href="#cmd-context" data-search="context branch-aware skill activation  action">context</a>
       <a class="cmd-link" href="#cmd-focus" data-search="focus temporarily prioritize skills for a work session  --clear --status --json skill">focus</a>
       <a class="cmd-link" href="#cmd-impact" data-search="impact measure a skill&#x27;s influence on code quality  --json name">impact</a>
     </div>
@@ -191,7 +191,7 @@
       <a class="cmd-link" href="#cmd-serve" data-search="serve browse the catalogue in a browser: search, facets and a tap graph  --port port --host host">serve</a>
       <a class="cmd-link" href="#cmd-mcp" data-search="mcp register boost as an mcp server (claude code, gemini cli) register boost as an mcp server for your agent clis --host h --stdio --seed --no-seed {register,unregister}">mcp</a>
       <a class="cmd-link" href="#cmd-hooks" data-search="hooks manage agent hooks (claude code, gemini cli) in settings.json manage agent hooks (scope- and host-aware) in settings.json --host h -c, --command command -n, --name name -s, --scope {global,project} -m, --matcher matcher --timeout timeout {add,remove,list} event">hooks</a>
-      <a class="cmd-link" href="#cmd-bmad" data-search="bmad bmad method autopilot — `bmad on` routes every task to a persona bmad method autopilot: personas, prompt routing, workflows -s, --scope {project,global} --modules modules -y, --yes --startup --plain {on,off,route,personas,install,init,startup,orient,uninstall,disable,enable,doctor,status} value">bmad</a>
+      <a class="cmd-link" href="#cmd-bmad" data-search="bmad bmad method autopilot — `bmad on` routes every task to a persona bmad method autopilot: personas, prompt routing, workflows -s, --scope {project,global} --modules modules -y, --yes --startup --plain action value">bmad</a>
       <a class="cmd-link" href="#cmd-self-update" data-search="self-update update boost itself to the latest version  --dry-run">self-update</a>
     </div>
     <div class="group" data-group="team">
@@ -766,13 +766,13 @@
           <div class="arg"><code>--apply</code><span>write the revision to the installed skill</span></div>
         </div>
       </section>
-      <section class="cmd" id="cmd-context" data-search="context branch-aware skill activation  status|enable|disable|map|unmap|apply">
+      <section class="cmd" id="cmd-context" data-search="context branch-aware skill activation  action">
         <h3><span class="cname">context</span><span class="gtag">ai</span></h3>
         <p class="summary">Branch-aware skill activation</p>
-        <pre class="syn">boost context status|enable|disable|map|unmap|apply</pre>
+        <pre class="syn">boost context ACTION</pre>
         <div class="args-h">Arguments</div>
         <div class="args">
-          <div class="arg"><code>status|enable|disable|map|unmap|apply</code><span></span></div>
+          <div class="arg"><code>ACTION</code><span></span></div>
         </div>
       </section>
       <section class="cmd" id="cmd-focus" data-search="focus temporarily prioritize skills for a work session  --clear --status --json skill">
@@ -1127,14 +1127,14 @@
           <div class="arg"><code>--timeout TIMEOUT</code><span>hook timeout in seconds (default: 10)</span></div>
         </div>
       </section>
-      <section class="cmd" id="cmd-bmad" data-search="bmad bmad method autopilot — `bmad on` routes every task to a persona bmad method autopilot: personas, prompt routing, workflows -s, --scope {project,global} --modules modules -y, --yes --startup --plain {on,off,route,personas,install,init,startup,orient,uninstall,disable,enable,doctor,status} value">
+      <section class="cmd" id="cmd-bmad" data-search="bmad bmad method autopilot — `bmad on` routes every task to a persona bmad method autopilot: personas, prompt routing, workflows -s, --scope {project,global} --modules modules -y, --yes --startup --plain action value">
         <h3><span class="cname">bmad</span><span class="gtag">cfg</span></h3>
         <p class="summary">BMAD Method autopilot — `bmad on` routes every task to a persona</p>
-        <pre class="syn">boost bmad [--scope {project,global}] [--modules MODULES] [--yes] [--startup] [--plain] {on,off,route,personas,install,init,startup,orient,uninstall,disable,enable,doctor,status} [value]</pre>
+        <pre class="syn">boost bmad [--scope {project,global}] [--modules MODULES] [--yes] [--startup] [--plain] ACTION [value]</pre>
         <p class="desc">BMAD Method autopilot: personas, prompt routing, workflows</p>
         <div class="args-h">Arguments</div>
         <div class="args">
-          <div class="arg"><code>{on,off,route,personas,install,init,startup,orient,uninstall,disable,enable,doctor,status}</code><span>on | off | route | personas | install | init | startup | orient | uninstall | disable | enable | doctor | status</span></div>
+          <div class="arg"><code>ACTION</code><span>on | off | route | personas | install | init | startup | orient | uninstall | disable | enable | doctor | status</span></div>
           <div class="arg"><code>value</code><span>startup: on | off | status · route: the prompt to classify</span></div>
         </div>
         <div class="args-h">Options</div>

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/docs/design-roadmap.html

@@ -227,7 +227,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"><!-- ROADMAP:count shown -->26<!-- /ROADMAP:count --></b> of <b><!-- ROADMAP:count total -->26<!-- /ROADMAP:count --></b> opportunities shown</p>
+    <p class="roadmap-count"><b id="shown"><!-- ROADMAP:count shown -->27<!-- /ROADMAP:count --></b> of <b><!-- ROADMAP:count total -->27<!-- /ROADMAP:count --></b> opportunities shown</p>
   </div>
 
   <div class="wrap" id="board">
@@ -289,7 +289,7 @@
           <h2>Structure &amp; Layout</h2>
           <p>Width-aware output, glass panels, and results that never blow up the pane.</p>
         </div>
-        <span class="n"><!-- ROADMAP:count track=layout -->7 items<!-- /ROADMAP:count --></span>
+        <span class="n"><!-- ROADMAP:count track=layout -->8 items<!-- /ROADMAP:count --></span>
       </div>
       <div class="rcards">
 
@@ -349,6 +349,20 @@
   <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() / _fit_widths / _clip_visible</code></div>
 </article>
+
+<article class="ritem" id="BOOST-D27" data-track="layout" data-impact="med">
+  <div class="ritem-top"><span class="rid">BOOST-D27</span><span class="rstatus proposed">Proposed</span></div>
+  <h3>Finish the wrap-law rollout across the CLI's remaining hand-rolled spots</h3>
+  <p>A narrow-pane audit across all 80 commands fixed the concrete overflow bugs it found — a hardcoded <code>textwrap</code> width in <code>info</code>/<code>preview</code>/<code>explain</code>, two argparse usage lines with no <code>metavar</code>, help text that split a backtick-quoted command across lines, five "nothing here" screens that overflowed unwrapped, and a <code>print_help</code> command column painted in raw 16-color <code>CYAN</code> instead of the Aurora <code>accent</code> role — and added wide-character measurement (<code>unicodedata.east_asian_width</code>) to <code>visible_len()</code>/<code>_clip_visible()</code> so <code>table()</code> stays aligned when a cell holds CJK or an emoji. Three related gaps remain, deliberately left rather than folded into that pass because each is a wider, riskier sweep on its own:
+
+<b>1. <code>dim("  text")</code>'s embedded 2-space indent has no wrap path.</b> 39 call sites (<code>bmad</code>'s hint lines, <code>schedule status</code>, <code>impact</code>'s caveat, …) hand-embed a leading <code>"  "</code> because <code>dim()</code> prints flush-left by contract; passing <code>wrap=True</code> today would silently drop that margin on the first wrapped line (the tokenizer discards leading whitespace). One of the 39 measurably overflows a 60-column pane by a single character (<code>schedule status</code>'s enable hint) — not worth an inconsistent one-off fix. <code>dim()</code> needs a real <code>indent</code>/margin parameter (mirroring <code>kv</code>'s lead-column math) before any of the 39 can safely opt into wrapping.
+
+<b>2. <code>empty_state()</code> adoption is 7 of ~35 "nothing to show" screens.</b> This pass converted cohort/replay/pulse/who's overflowing messages to the standard helper; roughly 28 more (<code>hooks</code>, <code>hallmarks of "no taps configured"</code>, <code>no skills installed</code> across five modules, …) still print via ad hoc <code>out.info("no X")</code>. None of them currently overflow, so converting all 28 in one shot would be a same-behavior refactor risking 28 screens' worth of rendered-text drift for no measured bug — better done a few at a time, verified against real content.
+
+<b>3. Wide-character width stopped at <code>visible_len()</code>/<code>_clip_visible()</code>.</b> <code>truncate()</code> (plain-text clipping before coloring) and <code>search_layout()</code>'s column-budget math still count with <code>len()</code>, not display width — so a skill description containing an emoji would still truncate mid-character or throw off a search row's column budget. Not observed in real catalog data (skill names/taps are near-universal ASCII slugs), and widening it touches layout-budget code, not just measurement, so it stayed out of the audit's contained fix.</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>
+  <div class="rref"><code>core/output.py · dim()/empty_state() call sites; truncate()/search_layout()</code></div>
+</article>
       <!-- /ROADMAP:cards -->
 
       </div>

boost_skill_cli-1.2.37/docs/roadmap/items/BOOST-D27.md

@@ -0,0 +1,22 @@
+---
+id: BOOST-D27
+board: design
+track: layout
+status: proposed
+impact: med
+complexity: M
+wow: 2
+category: layout
+ref: "core/output.py · dim()/empty_state() call sites; truncate()/search_layout()"
+order: 8
+owner: loop/aesthetics
+pr:
+title: Finish the wrap-law rollout across the CLI's remaining hand-rolled spots
+---
+A narrow-pane audit across all 80 commands fixed the concrete overflow bugs it found — a hardcoded <code>textwrap</code> width in <code>info</code>/<code>preview</code>/<code>explain</code>, two argparse usage lines with no <code>metavar</code>, help text that split a backtick-quoted command across lines, five "nothing here" screens that overflowed unwrapped, and a <code>print_help</code> command column painted in raw 16-color <code>CYAN</code> instead of the Aurora <code>accent</code> role — and added wide-character measurement (<code>unicodedata.east_asian_width</code>) to <code>visible_len()</code>/<code>_clip_visible()</code> so <code>table()</code> stays aligned when a cell holds CJK or an emoji. Three related gaps remain, deliberately left rather than folded into that pass because each is a wider, riskier sweep on its own:
+
+<b>1. <code>dim("  text")</code>'s embedded 2-space indent has no wrap path.</b> 39 call sites (<code>bmad</code>'s hint lines, <code>schedule status</code>, <code>impact</code>'s caveat, …) hand-embed a leading <code>"  "</code> because <code>dim()</code> prints flush-left by contract; passing <code>wrap=True</code> today would silently drop that margin on the first wrapped line (the tokenizer discards leading whitespace). One of the 39 measurably overflows a 60-column pane by a single character (<code>schedule status</code>'s enable hint) — not worth an inconsistent one-off fix. <code>dim()</code> needs a real <code>indent</code>/margin parameter (mirroring <code>kv</code>'s lead-column math) before any of the 39 can safely opt into wrapping.
+
+<b>2. <code>empty_state()</code> adoption is 7 of ~35 "nothing to show" screens.</b> This pass converted cohort/replay/pulse/who's overflowing messages to the standard helper; roughly 28 more (<code>hooks</code>, <code>hallmarks of "no taps configured"</code>, <code>no skills installed</code> across five modules, …) still print via ad hoc <code>out.info("no X")</code>. None of them currently overflow, so converting all 28 in one shot would be a same-behavior refactor risking 28 screens' worth of rendered-text drift for no measured bug — better done a few at a time, verified against real content.
+
+<b>3. Wide-character width stopped at <code>visible_len()</code>/<code>_clip_visible()</code>.</b> <code>truncate()</code> (plain-text clipping before coloring) and <code>search_layout()</code>'s column-budget math still count with <code>len()</code>, not display width — so a skill description containing an emoji would still truncate mid-character or throw off a search row's column budget. Not observed in real catalog data (skill names/taps are near-universal ASCII slugs), and widening it touches layout-budget code, not just measurement, so it stayed out of the audit's contained fix.

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/tests/functional/test_cli_bmad.py

@@ -290,6 +290,21 @@ class TestDoctor:
         assert r.rc == 0 and "MISSING" in r.out
 
 
+class TestHelpFitsNarrowPane:
+    """`boost bmad --help`'s action list is 13 choices long — spelled out as
+    argparse's auto {a,b,c,...} metavar it overflowed every width up to 100
+    columns, because that whole bracketed list is one unbreakable token."""
+
+    def test_help_has_no_line_over_60_columns(self, boost, sandbox,
+                                              monkeypatch):
+        monkeypatch.setenv("COLUMNS", "60")
+        r = boost("bmad", "--help")
+        for ln in r.out.split("\n"):
+            assert len(ln) <= 60, ln
+        # the choices themselves must still be discoverable somewhere in help
+        assert "route" in r.out and "personas" in r.out
+
+
 # ------------------------------------------------------------------- autopilot
 
 class TestAutopilotOn:

{boost_skill_cli-1.2.36 → boost_skill_cli-1.2.37}/tests/functional/test_cli_discovery.py

@@ -1365,6 +1365,16 @@ class TestStats:
         assert "1.4.0 (up to date)" in lines["latest"]
         assert "fixture skills" in lines["upstream"]  # fixture commit subject
 
+    def test_upstream_wraps_to_a_narrow_pane(self, boost, installed,
+                                             monkeypatch):
+        # "b2b9486  2026-08-28  Boost Fixture  fixture skills" (50 cols) plus
+        # the 16-column kv lead ran to 66 — over a 60-column pane.
+        monkeypatch.setenv("COLUMNS", "60")
+        r = boost("stats", "brainstorming")
+        for ln in r.out.split("\n"):
+            assert len(ln) <= 60, ln
+        assert "fixture" in r.out and "skills" in r.out
+
     def test_update_available(self, boost, installed):
         p = paths.lockfile_path()
         lock = json.loads(p.read_text(encoding="utf-8"))