boost-skill-cli 1.0.185__tar.gz → 1.0.186__tar.gz

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/.gitignore

@@ -230,3 +230,6 @@ mutants/
 
 # sandboxed boost home for the Tier 1 eval corpus (`make eval` taps here)
 .eval-home/
+tests/visual/node_modules/
+tests/visual/out/
+tests/visual/package-lock.json

boost_skill_cli-1.0.186/.lycheeignore

@@ -0,0 +1,11 @@
+# Links lychee should not fetch.
+#
+# The docs are the GitHub Pages site rooted at docs/, so every asset and
+# cross-page link is checked as a real file path — nothing is excluded for
+# convenience. These two entries are unavoidable:
+
+# Local dev server referenced in `boost serve` documentation examples.
+^https?://(localhost|127\.0\.0\.1)(:\d+)?
+
+# Example/placeholder hosts in configuration snippets (not real endpoints).
+^https?://(example\.(com|org)|your-org)

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/Makefile

@@ -57,6 +57,7 @@ lint:
 	$(PY) scripts/build_command_reference.py --check
 	$(PY) scripts/import_budget.py
 	$(PY) scripts/perf_gate.py
+	$(PY) scripts/check_anchors.py
 
 # Supply-chain CVE gate: fail on a known OSV/PyPI advisory in the project's
 # dependency closure. Mirrors the pip-audit CI workflow; run before releasing.

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.185
+Version: 1.0.186
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE
@@ -840,7 +840,8 @@ boost bundle dump > Boostfile     # everyone else runs: boost bundle install
 ## 75 commands, organized into 8 groups
 
 `boost --help` prints the full grouped command list; for a visual tour see
-[`docs/overview.html`](docs/overview.html).
+[`docs/index.html`](docs/index.html), and for every flag of every command see
+[`docs/commands.html`](docs/commands.html).
 
 | Group | Commands |
 |---|---|

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/README.md

@@ -124,7 +124,8 @@ boost bundle dump > Boostfile     # everyone else runs: boost bundle install
 ## 75 commands, organized into 8 groups
 
 `boost --help` prints the full grouped command list; for a visual tour see
-[`docs/overview.html`](docs/overview.html).
+[`docs/index.html`](docs/index.html), and for every flag of every command see
+[`docs/commands.html`](docs/commands.html).
 
 | Group | Commands |
 |---|---|

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/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.185'
-__version_tuple__ = version_tuple = (1, 0, 185)
+__version__ = version = '1.0.186'
+__version_tuple__ = version_tuple = (1, 0, 186)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/boost_skill_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.185
+Version: 1.0.186
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE
@@ -840,7 +840,8 @@ boost bundle dump > Boostfile     # everyone else runs: boost bundle install
 ## 75 commands, organized into 8 groups
 
 `boost --help` prints the full grouped command list; for a visual tour see
-[`docs/overview.html`](docs/overview.html).
+[`docs/index.html`](docs/index.html), and for every flag of every command see
+[`docs/commands.html`](docs/commands.html).
 
 | Group | Commands |
 |---|---|

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/boost_skill_cli.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@
 .gitignore
 .gitleaks.toml
 .htmlvalidate.json
+.lycheeignore
 .markdownlint-cli2.jsonc
 .pre-commit-config.yaml
 .stylelintrc.json
@@ -232,6 +233,7 @@ scripts/bench_cli.sh
 scripts/build_command_reference.py
 scripts/build_registries.py
 scripts/build_roadmap.py
+scripts/check_anchors.py
 scripts/ensure_eval_corpus.sh
 scripts/eval_explain.py
 scripts/eval_recommend.py
@@ -286,6 +288,7 @@ tests/unit/test_adapters.py
 tests/unit/test_agents.py
 tests/unit/test_ai.py
 tests/unit/test_catalog.py
+tests/unit/test_check_anchors.py
 tests/unit/test_claude_settings.py
 tests/unit/test_cliparse.py
 tests/unit/test_command_reference_fresh.py
@@ -331,4 +334,6 @@ tests/unit/test_typosquat.py
 tests/unit/test_updatediff.py
 tests/unit/test_util.py
 tests/unit/test_version.py
-tests/unit/test_workflows.py
+tests/unit/test_workflows.py
+tests/visual/package.json
+tests/visual/visual_check.mjs

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/adapters.html

@@ -38,6 +38,8 @@
   table.map td.sdk  code  { color: var(--green); }
   .two { display: grid; grid-template-columns: 1fr 1fr; gap: 22px; margin-top: 30px; }
   @media (max-width: 760px) { .two { grid-template-columns: 1fr; } }
+  /* narrow screens: the mapping table scrolls inside itself (visual_check) */
+  @media (max-width: 760px) { table.map { display: block; overflow-x: auto; } }
   .panel { border: 1px solid var(--line); border-radius: 14px; padding: 22px 22px 8px;
            background: var(--panel); }
   .panel h3 { font-size: 16px; margin: 0 0 4px; }

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/eval.html

@@ -98,6 +98,9 @@
   footer p { color: var(--text-3); font-size: 13px; }
   footer a { color: var(--sky); text-decoration: none; }
 
+  /* narrow screens: the contract table scrolls inside itself instead of
+     widening the document (caught by tests/visual/visual_check.mjs) */
+  @media (max-width: 760px) { table.contract { display: block; overflow-x: auto; } }
   @media (max-width: 820px) {
     .cheat { grid-template-columns: 1fr; }
     .cheat .col-head.tech { margin-top: 8px; }

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/mcp-hub.html

@@ -86,6 +86,11 @@
   footer p { color: var(--text-3); font-size: 13px; }
   footer a { color: var(--sky); text-decoration: none; }
 
+  /* grid items default to min-width:auto, so one unbreakable code string
+     can push the single-column cheat grid past the viewport (visual_check) */
+  .cheat > * { min-width: 0; }
+  .sec-title code { overflow-wrap: anywhere; }  /* boost_discover_github in an h2 */
+  details.card .body code { overflow-wrap: anywhere; }
   @media (max-width: 820px) {
     .cheat, .split { grid-template-columns: 1fr; }
     .cheat .col-head.tech { margin-top: 8px; }

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/boost-run-live-agents.md

@@ -13,4 +13,4 @@ owner:
 pr: 
 title: <code>boost run</code> — search → adapt → a live agent doing the task, in one command
 ---
-The allure ceiling on <code>boost adapt</code> (#146, #163): it stops at <b>source you assemble</b>, and the adapted agent has a brain (prompt) but no <b>hands</b> (tools). Close both. <code>boost run &lt;skill&gt; [target]</code> = adapt → wire a default toolset (file read, ripgrep/shell, web) → execute on boost's model and stream the result. Opt-in like the conformance path (installs the framework + needs a key, so the zero-dep default holds). Two prerequisites ship with it: (1) <b>tool-wiring</b> — emit/attach the tools a skill needs (or declares) so the agent can act, not roleplay; (2) reuse the <a href="../adapters.html">adapt</a> renderer for the agent def. Pairs with <code>[[framework-adapter-multi-agent]]</code> so a skill like <code>rust-review</code> runs as a real crew. This is the screenshot: "one command → an expert agent audits your repo, on Claude, that you never wrote." <b>Working preview:</b> <code>examples/boost-run-prototype.sh</code> already does this by hand (adapt → wire a read_file tool → <code>Runner.run</code> on a file with planted bugs).
+The allure ceiling on <code>boost adapt</code> (#146, #163): it stops at <b>source you assemble</b>, and the adapted agent has a brain (prompt) but no <b>hands</b> (tools). Close both. <code>boost run &lt;skill&gt; [target]</code> = adapt → wire a default toolset (file read, ripgrep/shell, web) → execute on boost's model and stream the result. Opt-in like the conformance path (installs the framework + needs a key, so the zero-dep default holds). Two prerequisites ship with it: (1) <b>tool-wiring</b> — emit/attach the tools a skill needs (or declares) so the agent can act, not roleplay; (2) reuse the <a href="adapters.html">adapt</a> renderer for the agent def. Pairs with <code>[[framework-adapter-multi-agent]]</code> so a skill like <code>rust-review</code> runs as a real crew. This is the screenshot: "one command → an expert agent audits your repo, on Claude, that you never wrote." <b>Working preview:</b> <code>examples/boost-run-prototype.sh</code> already does this by hand (adapt → wire a read_file tool → <code>Runner.run</code> on a file with planted bugs).

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/broken-link-and-anchor-checking-lychee.md

@@ -2,19 +2,24 @@
 id: broken-link-and-anchor-checking-lychee
 board: code
 section: docsite
-status: planned
+status: shipped
 category: Quality · Docs
 complexity: S
 impact: Med
 wow: 3
-note: URLs + anchors
+note: 8 dead links found
 order: 5
-owner:
-pr:
+owner: loop/lychee
+pr: 210
 title: Broken-link &amp; anchor checking — <code>lychee</code>
 ---
 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.
+           the landing page is the first broken promise a visitor sees. Red on
+           its first run: eight were already broken — four <code>../adapters.html</code>
+           at the wrong depth, two dangling anchors, one link to an item file as
+           though it were a page, and a README pointing at
+           <code>docs/overview.html</code>, renamed to <code>index.html</code>
+           and never updated.

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/framework-adapter-langgraph.md

@@ -13,4 +13,4 @@ owner:
 pr: 
 title: <code>boost adapt --to langgraph</code> — third framework renderer
 ---
-Extend <code>boost adapt</code> (shipped in #146) with a LangGraph target. Unlike CrewAI / Agents-SDK, a LangGraph agent isn't one <code>Agent(...)</code> constructor — the skill body is the system prompt of a node bound into a <code>StateGraph</code>. Add a <code>render_langgraph</code> to <code>core/adapters.py</code> emitting a node factory (prebuilt <code>create_react_agent</code>, or a prompt-carrying node) + its <code>FORMATS</code> row, with byte-exact golden + <code>compile()</code> tests. Then add a <code>langgraph</code> leg to <code>.github/workflows/adapter-conformance.yml</code> (pip install langgraph, import the emitted file). Follows the pattern in <a href="../adapters.html">adapters.html</a>: one <code>render_*</code> fn + registry row + golden test + one matrix line.
+Extend <code>boost adapt</code> (shipped in #146) with a LangGraph target. Unlike CrewAI / Agents-SDK, a LangGraph agent isn't one <code>Agent(...)</code> constructor — the skill body is the system prompt of a node bound into a <code>StateGraph</code>. Add a <code>render_langgraph</code> to <code>core/adapters.py</code> emitting a node factory (prebuilt <code>create_react_agent</code>, or a prompt-carrying node) + its <code>FORMATS</code> row, with byte-exact golden + <code>compile()</code> tests. Then add a <code>langgraph</code> leg to <code>.github/workflows/adapter-conformance.yml</code> (pip install langgraph, import the emitted file). Follows the pattern in <a href="adapters.html">adapters.html</a>: one <code>render_*</code> fn + registry row + golden test + one matrix line.

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/framework-adapter-multi-agent.md

@@ -13,4 +13,4 @@ owner:
 pr: 
 title: <code>boost adapt</code> — multi-agent skills → crews/graphs, not one Agent
 ---
-Today <code>boost adapt</code> (#146, #163) projects a skill into a <b>single</b> framework Agent carrying its instructions/role/model — but a skill can declare tools and a whole subagent graph (e.g. <code>rust-review</code> = worker + dedup-judge + fp-judge). Adapt the richer structure: emit a CrewAI <code>Crew</code> (agents + tasks) or a LangGraph <code>StateGraph</code> when a skill's frontmatter/plugin dir declares subagents, and surface declared tools as stubs. Scope: detect subagent/tool declarations in <code>SKILL.md</code>/<code>plugins/*/agents/*.md</code>; add a crew/graph renderer path in <code>core/adapters.py</code> (single-Agent stays the default for flat skills); golden + <code>compile()</code> tests + a conformance leg. Turns "one skill → one agent" into "one skill → a runnable multi-agent workflow." See <a href="../adapters.html">adapters.html</a>.
+Today <code>boost adapt</code> (#146, #163) projects a skill into a <b>single</b> framework Agent carrying its instructions/role/model — but a skill can declare tools and a whole subagent graph (e.g. <code>rust-review</code> = worker + dedup-judge + fp-judge). Adapt the richer structure: emit a CrewAI <code>Crew</code> (agents + tasks) or a LangGraph <code>StateGraph</code> when a skill's frontmatter/plugin dir declares subagents, and surface declared tools as stubs. Scope: detect subagent/tool declarations in <code>SKILL.md</code>/<code>plugins/*/agents/*.md</code>; add a crew/graph renderer path in <code>core/adapters.py</code> (single-Agent stays the default for flat skills); golden + <code>compile()</code> tests + a conformance leg. Turns "one skill → one agent" into "one skill → a runnable multi-agent workflow." See <a href="adapters.html">adapters.html</a>.

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/framework-adapters-boost-adapt.md

@@ -13,4 +13,4 @@ owner: loop/framework-adapters
 pr: 146
 title: <code>boost adapt</code> — render a skill as another framework's agent source
 ---
-boost only installs skills as files for editor agents (Claude Code, Cursor, Windsurf); CrewAI / OpenAI-Agents-SDK apps can't consume them — an agent there is a value built in source. <code>boost adapt &lt;skill&gt; --to crewai|agents-sdk</code> renders one <code>SKILL.md</code> into each framework's native <code>Agent(...)</code> as a deterministic, zero-dependency string transform (<code>core/adapters.py</code>). Strings emit via <code>json.dumps</code> so any body (quotes, <code>"""</code>, unicode) stays valid Python; 97.6% mutation kill. Docs: <a href="../adapters.html">adapters.html</a>.
+boost only installs skills as files for editor agents (Claude Code, Cursor, Windsurf); CrewAI / OpenAI-Agents-SDK apps can't consume them — an agent there is a value built in source. <code>boost adapt &lt;skill&gt; --to crewai|agents-sdk</code> renders one <code>SKILL.md</code> into each framework's native <code>Agent(...)</code> as a deterministic, zero-dependency string transform (<code>core/adapters.py</code>). Strings emit via <code>json.dumps</code> so any body (quotes, <code>"""</code>, unicode) stays valid Python; 97.6% mutation kill. Docs: <a href="adapters.html">adapters.html</a>.

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/mcp-startup-self-harden-fork-safety.md

@@ -13,7 +13,7 @@ owner: loop/mcp-startup-fork-safety
 pr: 162
 title: Self-harden every boost process against the macOS fork-safety abort
 ---
-The launch-env fix (<a href="#mcp-launch-objc-fork-safety">#119</a>) only
+The launch-env fix (<a href="https://github.com/jonnyeclectic/boost/pull/119">#119</a>) only
            protects hosts that register boost <em>through boost</em>, which
            injects <code>no_proxy=*</code>. A host that <code>fork()</code>s into
            <code>boost mcp --stdio</code> from a stale or hand-written config —
@@ -26,4 +26,4 @@ The launch-env fix (<a href="#mcp-launch-objc-fork-safety">#119</a>) only
            <code>getproxies()</code> short-circuits on
            <code>getproxies_environment()</code> and never consults
            SystemConfiguration. Belt-and-suspenders atop the
-           <code>nethttp</code> opener (<a href="#fork-safe-network-proxy-handler">#115</a>).
+           <code>nethttp</code> opener (<a href="https://github.com/jonnyeclectic/boost/pull/115">#115</a>).

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/surface-every-docs-page-from-the-guide.md

@@ -13,7 +13,7 @@ owner: loop/docs-discoverable
 pr: 128
 title: Surface every <code>docs/*.html</code> page from the main page
 ---
-<a href="make-the-roadmaps-discoverable.html">Making the roadmaps discoverable</a>
+<a href="roadmap.html">Making the roadmaps discoverable</a>
            put both boards in the Visual Guide nav, but the same gap remains for
            the rest of <code>docs/*.html</code>: <code>mcp-hub.html</code> is
            reachable only if you already know the URL — nothing on

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap/items/visual-regression-pass-on-the-guide.md

@@ -2,15 +2,15 @@
 id: visual-regression-pass-on-the-guide
 board: code
 section: planned
-status: planned
+status: shipped
 category: Design · QA
 complexity: M
 impact: Med
 wow: 3
 note: 
 order: 3
-owner:
-pr:
+owner: loop/visual
+pr: 209
 title: Visual regression pass on the guide
 ---
 Drive <code>docs/index.html</code> in a real browser across breakpoints

{boost_skill_cli-1.0.185 → boost_skill_cli-1.0.186}/docs/roadmap.html

@@ -487,7 +487,7 @@ message, so routing it through the helper would change user-facing errors.</p>
       </article>
 
       <article class="cap rcard">
-        <div class="head"><span class="pill planned">Planned</span><span class="cat">Design · QA</span></div>
+        <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Design · QA</span></div>
         <h3>Visual regression pass on the guide</h3>
         <p>Drive <code>docs/index.html</code> in a real browser across breakpoints
            to confirm the glass cards, aurora, and terminal windows render
@@ -1451,7 +1451,7 @@ improvement is real (or isn't)."</p>
       <article class="cap rcard">
         <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Interop</span></div>
         <h3><code>boost adapt</code> — render a skill as another framework's agent source</h3>
-        <p>boost only installs skills as files for editor agents (Claude Code, Cursor, Windsurf); CrewAI / OpenAI-Agents-SDK apps can't consume them — an agent there is a value built in source. <code>boost adapt &lt;skill&gt; --to crewai|agents-sdk</code> renders one <code>SKILL.md</code> into each framework's native <code>Agent(...)</code> as a deterministic, zero-dependency string transform (<code>core/adapters.py</code>). Strings emit via <code>json.dumps</code> so any body (quotes, <code>"""</code>, unicode) stays valid Python; 97.6% mutation kill. Docs: <a href="../adapters.html">adapters.html</a>.</p>
+        <p>boost only installs skills as files for editor agents (Claude Code, Cursor, Windsurf); CrewAI / OpenAI-Agents-SDK apps can't consume them — an agent there is a value built in source. <code>boost adapt &lt;skill&gt; --to crewai|agents-sdk</code> renders one <code>SKILL.md</code> into each framework's native <code>Agent(...)</code> as a deterministic, zero-dependency string transform (<code>core/adapters.py</code>). Strings emit via <code>json.dumps</code> so any body (quotes, <code>"""</code>, unicode) stays valid Python; 97.6% mutation kill. Docs: <a href="adapters.html">adapters.html</a>.</p>
         <div class="meta">
           <span class="m">Complexity <b>M</b></span>
           <span class="m">Impact <b>Med-High</b></span>
@@ -1462,7 +1462,7 @@ improvement is real (or isn't)."</p>
       <article class="cap rcard">
         <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Interop</span></div>
         <h3><code>boost adapt --to langgraph</code> — third framework renderer</h3>
-        <p>Extend <code>boost adapt</code> (shipped in #146) with a LangGraph target. Unlike CrewAI / Agents-SDK, a LangGraph agent isn't one <code>Agent(...)</code> constructor — the skill body is the system prompt of a node bound into a <code>StateGraph</code>. Add a <code>render_langgraph</code> to <code>core/adapters.py</code> emitting a node factory (prebuilt <code>create_react_agent</code>, or a prompt-carrying node) + its <code>FORMATS</code> row, with byte-exact golden + <code>compile()</code> tests. Then add a <code>langgraph</code> leg to <code>.github/workflows/adapter-conformance.yml</code> (pip install langgraph, import the emitted file). Follows the pattern in <a href="../adapters.html">adapters.html</a>: one <code>render_*</code> fn + registry row + golden test + one matrix line.</p>
+        <p>Extend <code>boost adapt</code> (shipped in #146) with a LangGraph target. Unlike CrewAI / Agents-SDK, a LangGraph agent isn't one <code>Agent(...)</code> constructor — the skill body is the system prompt of a node bound into a <code>StateGraph</code>. Add a <code>render_langgraph</code> to <code>core/adapters.py</code> emitting a node factory (prebuilt <code>create_react_agent</code>, or a prompt-carrying node) + its <code>FORMATS</code> row, with byte-exact golden + <code>compile()</code> tests. Then add a <code>langgraph</code> leg to <code>.github/workflows/adapter-conformance.yml</code> (pip install langgraph, import the emitted file). Follows the pattern in <a href="adapters.html">adapters.html</a>: one <code>render_*</code> fn + registry row + golden test + one matrix line.</p>
         <div class="meta">
           <span class="m">Complexity <b>M</b></span>
           <span class="m">Impact <b>Med</b></span>
@@ -1473,7 +1473,7 @@ improvement is real (or isn't)."</p>
       <article class="cap rcard">
         <div class="head"><span class="pill planned">Planned</span><span class="cat">Interop</span></div>
         <h3><code>boost adapt</code> — multi-agent skills → crews/graphs, not one Agent</h3>
-        <p>Today <code>boost adapt</code> (#146, #163) projects a skill into a <b>single</b> framework Agent carrying its instructions/role/model — but a skill can declare tools and a whole subagent graph (e.g. <code>rust-review</code> = worker + dedup-judge + fp-judge). Adapt the richer structure: emit a CrewAI <code>Crew</code> (agents + tasks) or a LangGraph <code>StateGraph</code> when a skill's frontmatter/plugin dir declares subagents, and surface declared tools as stubs. Scope: detect subagent/tool declarations in <code>SKILL.md</code>/<code>plugins/*/agents/*.md</code>; add a crew/graph renderer path in <code>core/adapters.py</code> (single-Agent stays the default for flat skills); golden + <code>compile()</code> tests + a conformance leg. Turns "one skill → one agent" into "one skill → a runnable multi-agent workflow." See <a href="../adapters.html">adapters.html</a>.</p>
+        <p>Today <code>boost adapt</code> (#146, #163) projects a skill into a <b>single</b> framework Agent carrying its instructions/role/model — but a skill can declare tools and a whole subagent graph (e.g. <code>rust-review</code> = worker + dedup-judge + fp-judge). Adapt the richer structure: emit a CrewAI <code>Crew</code> (agents + tasks) or a LangGraph <code>StateGraph</code> when a skill's frontmatter/plugin dir declares subagents, and surface declared tools as stubs. Scope: detect subagent/tool declarations in <code>SKILL.md</code>/<code>plugins/*/agents/*.md</code>; add a crew/graph renderer path in <code>core/adapters.py</code> (single-Agent stays the default for flat skills); golden + <code>compile()</code> tests + a conformance leg. Turns "one skill → one agent" into "one skill → a runnable multi-agent workflow." See <a href="adapters.html">adapters.html</a>.</p>
         <div class="meta">
           <span class="m">Complexity <b>L</b></span>
           <span class="m">Impact <b>Med</b></span>
@@ -1484,7 +1484,7 @@ improvement is real (or isn't)."</p>
       <article class="cap rcard">
         <div class="head"><span class="pill planned">Planned</span><span class="cat">Interop</span></div>
         <h3><code>boost run</code> — search → adapt → a live agent doing the task, in one command</h3>
-        <p>The allure ceiling on <code>boost adapt</code> (#146, #163): it stops at <b>source you assemble</b>, and the adapted agent has a brain (prompt) but no <b>hands</b> (tools). Close both. <code>boost run &lt;skill&gt; [target]</code> = adapt → wire a default toolset (file read, ripgrep/shell, web) → execute on boost's model and stream the result. Opt-in like the conformance path (installs the framework + needs a key, so the zero-dep default holds). Two prerequisites ship with it: (1) <b>tool-wiring</b> — emit/attach the tools a skill needs (or declares) so the agent can act, not roleplay; (2) reuse the <a href="../adapters.html">adapt</a> renderer for the agent def. Pairs with <code>[[framework-adapter-multi-agent]]</code> so a skill like <code>rust-review</code> runs as a real crew. This is the screenshot: "one command → an expert agent audits your repo, on Claude, that you never wrote." <b>Working preview:</b> <code>examples/boost-run-prototype.sh</code> already does this by hand (adapt → wire a read_file tool → <code>Runner.run</code> on a file with planted bugs).</p>
+        <p>The allure ceiling on <code>boost adapt</code> (#146, #163): it stops at <b>source you assemble</b>, and the adapted agent has a brain (prompt) but no <b>hands</b> (tools). Close both. <code>boost run &lt;skill&gt; [target]</code> = adapt → wire a default toolset (file read, ripgrep/shell, web) → execute on boost's model and stream the result. Opt-in like the conformance path (installs the framework + needs a key, so the zero-dep default holds). Two prerequisites ship with it: (1) <b>tool-wiring</b> — emit/attach the tools a skill needs (or declares) so the agent can act, not roleplay; (2) reuse the <a href="adapters.html">adapt</a> renderer for the agent def. Pairs with <code>[[framework-adapter-multi-agent]]</code> so a skill like <code>rust-review</code> runs as a real crew. This is the screenshot: "one command → an expert agent audits your repo, on Claude, that you never wrote." <b>Working preview:</b> <code>examples/boost-run-prototype.sh</code> already does this by hand (adapt → wire a read_file tool → <code>Runner.run</code> on a file with planted bugs).</p>
         <div class="meta">
           <span class="m">Complexity <b>L</b></span>
           <span class="m hi">Impact <b>High</b></span>
@@ -1573,18 +1573,23 @@ and the work stays visible.</p>
       </article>
 
       <article class="cap rcard">
-        <div class="head"><span class="pill planned">Planned</span><span class="cat">Quality · Docs</span></div>
+        <div class="head"><span class="pill shipped">Shipped</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>
+           the landing page is the first broken promise a visitor sees. Red on
+           its first run: eight were already broken — four <code>../adapters.html</code>
+           at the wrong depth, two dangling anchors, one link to an item file as
+           though it were a page, and a README pointing at
+           <code>docs/overview.html</code>, renamed to <code>index.html</code>
+           and never updated.</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>
+          <span class="m">8 dead links found</span>
         </div>
       </article>
 
@@ -1675,7 +1680,7 @@ and the work stays visible.</p>
       <article class="cap rcard">
         <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Docs · Discoverability</span></div>
         <h3>Surface every <code>docs/*.html</code> page from the main page</h3>
-        <p><a href="make-the-roadmaps-discoverable.html">Making the roadmaps discoverable</a>
+        <p><a href="roadmap.html">Making the roadmaps discoverable</a>
            put both boards in the Visual Guide nav, but the same gap remains for
            the rest of <code>docs/*.html</code>: <code>mcp-hub.html</code> is
            reachable only if you already know the URL — nothing on
@@ -1874,7 +1879,7 @@ and the work stays visible.</p>
       <article class="cap rcard">
         <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Compatibility · macOS</span></div>
         <h3>Self-harden every boost process against the macOS fork-safety abort</h3>
-        <p>The launch-env fix (<a href="#mcp-launch-objc-fork-safety">#119</a>) only
+        <p>The launch-env fix (<a href="https://github.com/jonnyeclectic/boost/pull/119">#119</a>) only
            protects hosts that register boost <em>through boost</em>, which
            injects <code>no_proxy=*</code>. A host that <code>fork()</code>s into
            <code>boost mcp --stdio</code> from a stale or hand-written config —
@@ -1887,7 +1892,7 @@ and the work stays visible.</p>
            <code>getproxies()</code> short-circuits on
            <code>getproxies_environment()</code> and never consults
            SystemConfiguration. Belt-and-suspenders atop the
-           <code>nethttp</code> opener (<a href="#fork-safe-network-proxy-handler">#115</a>).</p>
+           <code>nethttp</code> opener (<a href="https://github.com/jonnyeclectic/boost/pull/115">#115</a>).</p>
         <div class="meta">
           <span class="m">Complexity <b>S</b></span>
           <span class="m">Impact <b>Med</b></span>

boost_skill_cli-1.0.186/scripts/check_anchors.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""Verify every local link and #fragment in the docs site resolves.
+
+lychee (the links workflow) checks external URLs and that local files exist,
+but it does not resolve fragments into local HTML — and that is exactly where
+a dangling anchor hides, because the roadmap boards are GENERATED from card
+copy in docs/roadmap/items/*.md. A bad href there is invisible until the page
+renders.
+
+Checks, treating docs/ as the Pages root (docs/index.html is the site root, so
+`../style/boost.css` correctly resolves to the repo-root stylesheet):
+  * in-page `#frag`      -> an element with that id/name exists on the page
+  * `other.html#frag`    -> the target file exists AND carries that anchor
+  * `path/to/asset.css`  -> the file exists on disk
+
+Usage:  python3 scripts/check_anchors.py [--docs docs]
+"""
+from __future__ import annotations
+
+import argparse
+import sys
+from html.parser import HTMLParser
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+SKIP_PREFIXES = ("http://", "https://", "mailto:", "data:", "javascript:", "tel:")
+
+
+class _Page(HTMLParser):
+    """Collect anchor ids and every href/src on one page."""
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.ids: set = set()
+        self.refs: list = []
+
+    def handle_starttag(self, tag, attrs) -> None:
+        d = dict(attrs)
+        for key in ("id", "name"):
+            if d.get(key):
+                self.ids.add(d[key])
+        for key in ("href", "src"):
+            if d.get(key):
+                self.refs.append(d[key])
+
+
+def _parse(path: Path) -> _Page:
+    page = _Page()
+    page.feed(path.read_text(encoding="utf-8"))
+    return page
+
+
+def check(docs_dir: Path) -> list:
+    """Return a list of human-readable problems (empty when everything resolves)."""
+    problems: list = []
+    cache: dict = {}
+    for page_path in sorted(docs_dir.glob("*.html")):
+        page = _parse(page_path)
+        for raw in page.refs:
+            ref = raw.strip()
+            if not ref or ref.startswith(SKIP_PREFIXES):
+                continue
+            if ref.startswith("#"):
+                frag = ref[1:]
+                if frag and frag not in page.ids:
+                    problems.append("%s: dangling in-page anchor %s"
+                                    % (page_path.name, ref))
+                continue
+            rel, _, frag = ref.partition("#")
+            if not rel:
+                continue
+            target = (page_path.parent / rel).resolve()
+            if not target.exists():
+                problems.append("%s: missing local target %s" % (page_path.name, ref))
+                continue
+            if frag and target.suffix == ".html":
+                if target not in cache:
+                    cache[target] = _parse(target)
+                if frag not in cache[target].ids:
+                    problems.append("%s: %s -> no anchor #%s in %s"
+                                    % (page_path.name, ref, frag, target.name))
+    return problems
+
+
+def main(argv=None) -> int:
+    ap = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    ap.add_argument("--docs", default=str(ROOT / "docs"))
+    args = ap.parse_args(argv)
+
+    docs_dir = Path(args.docs)
+    problems = check(docs_dir)
+    pages = len(list(docs_dir.glob("*.html")))
+    if problems:
+        for p in problems:
+            print("  " + p, file=sys.stderr)
+        print("check-anchors: FAILED — %d broken reference(s) across %d pages"
+              % (len(problems), pages), file=sys.stderr)
+        print("hint: the roadmap boards are GENERATED — fix the link in the "
+              "matching docs/roadmap/items/*.md, then rerun "
+              "scripts/build_roadmap.py", file=sys.stderr)
+        return 1
+    print("check-anchors: OK — every local link and anchor resolves across "
+          "%d pages" % pages)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

boost_skill_cli-1.0.186/tests/unit/test_check_anchors.py

@@ -0,0 +1,79 @@
+"""Unit tests for scripts/check_anchors.py — the local link/anchor checker."""
+from __future__ import annotations
+
+import importlib.util
+from pathlib import Path
+
+import pytest
+
+_SCRIPT = Path(__file__).resolve().parents[2] / "scripts" / "check_anchors.py"
+_DOCS = Path(__file__).resolve().parents[2] / "docs"
+
+_skip = pytest.mark.skipif(not _SCRIPT.exists(), reason="script not reachable")
+
+
+def _mod():
+    spec = importlib.util.spec_from_file_location("check_anchors", _SCRIPT)
+    assert spec and spec.loader
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+@_skip
+def test_real_docs_have_no_broken_links():
+    """The in-suite twin of the CI anchor pass."""
+    problems = _mod().check(_DOCS)
+    assert problems == [], "broken links in docs/: %s" % problems
+
+
+@_skip
+def test_dangling_in_page_anchor_is_caught(tmp_path):
+    (tmp_path / "a.html").write_text(
+        '<a href="#nope">x</a><h2 id="yes">y</h2>', encoding="utf-8")
+    problems = _mod().check(tmp_path)
+    assert len(problems) == 1 and "#nope" in problems[0]
+
+
+@_skip
+def test_valid_in_page_anchor_passes(tmp_path):
+    (tmp_path / "a.html").write_text(
+        '<a href="#yes">x</a><h2 id="yes">y</h2>', encoding="utf-8")
+    assert _mod().check(tmp_path) == []
+
+
+@_skip
+def test_missing_local_target_is_caught(tmp_path):
+    (tmp_path / "a.html").write_text('<link href="../style/gone.css">', encoding="utf-8")
+    problems = _mod().check(tmp_path)
+    assert len(problems) == 1 and "missing local target" in problems[0]
+
+
+@_skip
+def test_cross_page_anchor_checked_against_the_target(tmp_path):
+    (tmp_path / "a.html").write_text('<a href="b.html#deep">x</a>', encoding="utf-8")
+    (tmp_path / "b.html").write_text('<h2 id="other">y</h2>', encoding="utf-8")
+    problems = _mod().check(tmp_path)
+    assert len(problems) == 1 and "no anchor #deep" in problems[0]
+
+    (tmp_path / "b.html").write_text('<h2 id="deep">y</h2>', encoding="utf-8")
+    assert _mod().check(tmp_path) == []
+
+
+@_skip
+def test_external_and_scheme_links_are_skipped(tmp_path):
+    (tmp_path / "a.html").write_text(
+        '<a href="https://example.com/nope#frag">x</a>'
+        '<a href="mailto:a@b.c">y</a><img src="data:image/svg+xml,x">',
+        encoding="utf-8")
+    assert _mod().check(tmp_path) == []
+
+
+@_skip
+def test_main_reports_and_exits_nonzero_on_break(tmp_path, capsys):
+    (tmp_path / "a.html").write_text('<a href="#nope">x</a>', encoding="utf-8")
+    rc = _mod().main(["--docs", str(tmp_path)])
+    assert rc == 1
+    err = capsys.readouterr().err
+    assert "check-anchors: FAILED" in err
+    assert "build_roadmap.py" in err          # the actionable hint

boost_skill_cli-1.0.186/tests/visual/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "boost-visual-check",
+  "private": true,
+  "description": "Headless-Chrome render sweep for the docs pages (see visual_check.mjs)",
+  "type": "module",
+  "dependencies": { "puppeteer-core": "24.23.0" }
+}