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

{boost_skill_cli-1.0.183 → boost_skill_cli-1.0.185}/Makefile

@@ -56,6 +56,7 @@ lint:
 	$(PY) scripts/build_roadmap.py --check
 	$(PY) scripts/build_command_reference.py --check
 	$(PY) scripts/import_budget.py
+	$(PY) scripts/perf_gate.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.183 → boost_skill_cli-1.0.185}/PKG-INFO

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

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

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

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

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

@@ -239,6 +239,7 @@ scripts/eval_retrieval.py
 scripts/eval_stats_summary.py
 scripts/import_budget.py
 scripts/mutation_gate.py
+scripts/perf_gate.py
 style/README.md
 style/boost.css
 style/boost.js
@@ -309,6 +310,7 @@ tests/unit/test_mutation_hardening.py
 tests/unit/test_nethttp.py
 tests/unit/test_output.py
 tests/unit/test_paths.py
+tests/unit/test_perf_gate.py
 tests/unit/test_pkg_confusions.py
 tests/unit/test_pkg_injection.py
 tests/unit/test_pkg_secrets.py

{boost_skill_cli-1.0.183 → boost_skill_cli-1.0.185}/docs/index.html

@@ -4,35 +4,12 @@
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>boost — Homebrew for AI coding skills</title>
+<!-- Canonical Aurora tokens + primitives (single source of truth). The
+     inline block below carries ONLY page-specific layout, and wins ties
+     by coming later in the cascade. -->
+<link rel="stylesheet" href="../style/boost.css">
 <style>
-  :root {
-    /* ---- Aurora reskin: neon-tech living glass (matches style/ + portfolio) ---- */
-    --bg: #07080f;
-    --panel: rgba(255,255,255,.035);
-    --panel-solid: #0f1120;
-    --line: rgba(255,255,255,.09);
-    --line-soft: rgba(255,255,255,.05);
-    --line-hi: rgba(255,255,255,.22);
-    --text: #e9ebf5;
-    --text-2: #9298b0;
-    --text-3: #676d86;
-    --amber: #22d3ee;   /* primary accent → cyan */
-    --orange: #38bdf8;  /* cyan-blue */
-    --pink: #f472d0;
-    --violet: #a855f7;
-    --blue: #38bdf8;
-    --sky: #7dd3fc;
-    --green: #4ade80;
-    --yellow: #facc15;
-    --term-bg: #0d1024;
-    --term-bar: #171a33;
-    --cyan: #22d3ee;
-    --grad: linear-gradient(96deg, #22d3ee 0%, #a855f7 52%, #f472d0 100%);
-    --mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, monospace;
-    --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-  }
   * { box-sizing: border-box; margin: 0; padding: 0; }
-  html { scroll-behavior: smooth; scroll-padding-top: 84px; }
   @media (prefers-reduced-motion: reduce) {
     html { scroll-behavior: auto; }
     .reveal { transition: none !important; transform: none !important; opacity: 1 !important; }
@@ -74,9 +51,7 @@
     50%     { transform: translate3d(2.5vmax,-2vmax,0) scale(1.08); }
   }
   .wrap { max-width: 1120px; margin: 0 auto; padding: 0 24px; position: relative; z-index: 1; }
-  a { color: inherit; }
-  code { font-family: var(--mono); }
-  :focus-visible { outline: 2px solid var(--amber); outline-offset: 2px; border-radius: 4px; }
+  :focus-visible { outline: 2px solid var(--cyan); outline-offset: 2px; border-radius: 4px; }
 
   /* ---------- nav ---------- */
   header {
@@ -86,40 +61,26 @@
     -webkit-backdrop-filter: blur(12px);
     border-bottom: 1px solid var(--line-soft);
   }
-  .nav { display: flex; align-items: center; gap: 24px; height: 64px; }
+  header .nav { display: flex; align-items: center; gap: 24px; height: 64px; }
   .logo { display: flex; align-items: baseline; gap: 10px; text-decoration: none; }
-  .logo b { font-family: var(--mono); font-size: 20px; font-weight: 700; color: var(--amber); letter-spacing: -.02em; }
+  .logo b { font-family: var(--mono); font-size: 20px; font-weight: 700; color: var(--cyan); letter-spacing: -.02em; }
   .logo span { font-size: 10.5px; letter-spacing: .24em; color: var(--text-2); text-transform: uppercase; }
-  .nav ul {
+  header .nav ul {
     display: flex; gap: 4px; list-style: none; margin-left: auto;
     overflow-x: auto; scrollbar-width: none;
   }
-  .nav ul::-webkit-scrollbar { display: none; }
-  .nav ul a {
+  header .nav ul::-webkit-scrollbar { display: none; }
+  header .nav ul a {
     display: block; padding: 8px 12px; border-radius: 8px;
     font-size: 14px; color: var(--text-2); text-decoration: none; white-space: nowrap;
   }
-  .nav ul a:hover { color: var(--text); background: var(--panel); }
-  .nav ul a.cta { color: var(--text); font-weight: 600; }
+  header .nav ul a:hover { color: var(--text); background: var(--panel); }
+  header .nav ul a.cta { color: var(--text); font-weight: 600; }
 
   /* ---------- shared section chrome ---------- */
   section { padding: 110px 0 20px; }
-  .eyebrow {
-    font-family: var(--mono); font-size: 12px; font-weight: 700;
-    letter-spacing: .24em; text-transform: uppercase;
-    background: var(--grad); -webkit-background-clip: text; background-clip: text; color: transparent;
-    display: block; text-align: center; margin-bottom: 18px;
-  }
-  .sec-title {
-    font-size: clamp(30px, 4.5vw, 50px); font-weight: 800; letter-spacing: -.025em;
-    line-height: 1.1; text-align: center; text-wrap: balance;
-  }
-  .sec-sub {
-    max-width: 640px; margin: 18px auto 0; text-align: center;
-    color: var(--text-2); font-size: 17.5px; text-wrap: balance;
-  }
   .sec-sub code {
-    color: var(--amber); background: rgba(34,211,238,.09);
+    color: var(--cyan); background: rgba(34,211,238,.09);
     padding: 1px 7px; border-radius: 6px; font-size: .88em;
   }
   .reveal { opacity: 0; transform: translateY(16px); transition: opacity .6s ease, transform .6s ease; }
@@ -149,14 +110,12 @@
     padding: 14px 26px; border-radius: 12px; border: 1px solid transparent;
     transition: transform .15s ease, box-shadow .15s ease;
   }
-  .btn:hover { transform: translateY(-1px); }
   .btn-grad {
     color: #05141a;
-    background: linear-gradient(92deg, var(--orange), var(--pink));
+    background: linear-gradient(92deg, var(--blue), var(--pink));
     box-shadow: 0 8px 30px rgba(236,72,153,.28);
   }
   .btn-grad:hover { box-shadow: 0 10px 36px rgba(236,72,153,.4); }
-  .btn-ghost { color: var(--text); border-color: var(--line); background: var(--panel); }
   .btn-ghost:hover { border-color: rgba(255,255,255,.2); }
   .stats { display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px; margin-top: 72px; }
   .stat {
@@ -168,22 +127,13 @@
     transition: border-color .2s ease;
   }
   .stat:hover { border-color: var(--line-hi); }
-  .stat b {
-    display: block; font-size: clamp(28px, 3.4vw, 42px); font-weight: 800; letter-spacing: -.02em;
-    background: var(--grad); -webkit-background-clip: text; background-clip: text; color: transparent;
-    font-variant-numeric: tabular-nums;
-  }
-  .stat span {
-    display: block; margin-top: 8px; font-size: 11px; font-weight: 650;
-    letter-spacing: .16em; text-transform: uppercase; color: var(--text-2);
-  }
 
   /* ---------- concept ---------- */
   .concept-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 56px; align-items: center; margin-top: 64px; }
   .concept-copy p { color: var(--text-2); margin-bottom: 22px; font-size: 17.5px; }
   .concept-copy p b { color: var(--text); font-weight: 650; }
   .concept-copy .chip-code {
-    font-family: var(--mono); font-size: .86em; color: var(--amber);
+    font-family: var(--mono); font-size: .86em; color: var(--cyan);
     background: rgba(34,211,238,.09); padding: 1px 7px; border-radius: 6px;
   }
   .analogy { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 8px; }
@@ -192,7 +142,7 @@
     font-size: 13.5px; color: var(--text-2);
     border: 1px solid var(--line); border-radius: 999px; padding: 8px 16px; background: var(--panel);
   }
-  .analogy b { font-family: var(--mono); font-size: 13px; color: var(--amber); font-weight: 700; }
+  .analogy b { font-family: var(--mono); font-size: 13px; color: var(--cyan); font-weight: 700; }
   .analogy .arr { color: var(--text-3); }
 
   /* mac-style window */
@@ -208,30 +158,12 @@
     display: flex; align-items: center; height: 38px; padding: 0 14px;
     background: var(--term-bar); border-bottom: 1px solid rgba(0,0,0,.25);
   }
-  .window .dots { display: flex; gap: 7px; }
-  .window .dots i { width: 12px; height: 12px; border-radius: 50%; }
-  .window .dots i:nth-child(1) { background: #ff5f57; }
-  .window .dots i:nth-child(2) { background: #febc2e; }
-  .window .dots i:nth-child(3) { background: #28c840; }
-  .window .bar-title {
-    flex: 1; text-align: center; font-family: var(--mono); font-size: 12.5px; color: #b8b8d0;
-    margin-right: 47px; /* balance the dots */
-  }
-  .window pre {
-    padding: 22px 24px; overflow-x: auto;
-    font-family: var(--mono); font-size: 13.5px; line-height: 1.75; color: #dcdcf0;
-  }
-  .yk  { color: var(--amber); }        /* yaml key */
+  .yk  { color: var(--cyan); }        /* yaml key */
   .yv  { color: var(--yellow); }       /* yaml value */
   .yd  { color: #8888aa; }             /* delimiter/dim */
-  .mh  { color: #f5a9d8; font-weight: 700; }  /* markdown heading */
-  .cm  { color: #9d9dbd; font-style: italic; } /* comment */
-  .tp  { color: #8888aa; }             /* terminal prompt $ */
-  .tv  { color: #7ee787; font-weight: 700; }  /* the word `boost` */
-  .tc  { color: var(--yellow); font-weight: 700; } /* subcommand */
-  .tok { color: var(--green); }        /* ✓ */
-  .tstar { color: var(--amber); }
-  .tdim { color: #9d9dbd; }
+  .mh  { color: #f5a9d8; font-weight: 700; }  /* markdown heading */ /* comment */
+  .tp  { color: #8888aa; }             /* terminal prompt $ */  /* the word `boost` */ /* subcommand */        /* ✓ */
+  .tstar { color: var(--cyan); }
   .tacc { color: var(--cyan); font-weight: 700; }  /* Aurora accent: meters, names, ==> */
   .tbox { color: var(--green); }        /* framed-card border (panel hue=green) */
 
@@ -253,7 +185,7 @@
     letter-spacing: .2em; text-transform: uppercase; color: var(--text-2);
   }
   .node h4 { font-size: 18px; font-weight: 750; margin-top: 8px; letter-spacing: -.01em; }
-  .node h4 code { font-size: 15.5px; color: var(--amber); }
+  .node h4 code { font-size: 15.5px; color: var(--cyan); }
   .node p { font-size: 13.5px; color: var(--text-2); margin-top: 6px; }
   .node.src   { border-color: rgba(96,165,250,.5);  box-shadow: 0 0 32px rgba(96,165,250,.07); }
   .node.mid   { border-color: rgba(255,255,255,.14); }
@@ -263,7 +195,7 @@
   .node.agent h4 { color: #d9fbe5; }
   .flow-arrow {
     display: flex; flex-direction: column; align-items: center; gap: 4px;
-    padding: 14px 0; color: var(--amber);
+    padding: 14px 0; color: var(--cyan);
   }
   .flow-arrow svg { display: block; }
   .flow-arrow span {
@@ -288,7 +220,7 @@
     transition: color .15s, background .15s, border-color .15s;
   }
   .pill:hover { color: var(--text); border-color: rgba(255,255,255,.2); }
-  .pill.on { background: var(--amber); border-color: var(--amber); color: #201705; }
+  .pill.on { background: var(--cyan); border-color: var(--cyan); color: #201705; }
   .cmd-count { text-align: center; margin: 30px 0 6px; font-size: 14.5px; color: var(--text-2); }
   .group { margin-top: 46px; }
   .group-head { display: flex; align-items: center; gap: 14px; }
@@ -314,16 +246,16 @@
   }
   .cmd::before {
     content: ""; position: absolute; left: 0; top: 0; bottom: 0; width: 3px;
-    background: var(--gc, var(--amber)); opacity: .85; border-radius: 3px 0 0 3px;
+    background: var(--gc, var(--cyan)); opacity: .85; border-radius: 3px 0 0 3px;
   }
   .cmd:hover { border-color: var(--line); }
   .cmd .name { font-family: var(--mono); font-size: 14.5px; }
   .cmd .name .v { color: #85859c; }
-  .cmd .name b { color: var(--amber); font-weight: 700; }
+  .cmd .name b { color: var(--cyan); font-weight: 700; }
   .cmd p { font-size: 13.5px; color: var(--text-2); margin-top: 6px; line-height: 1.5; }
   .cmd mark { background: rgba(34,211,238,.25); color: var(--text); border-radius: 3px; padding: 0 1px; }
   .no-results { text-align: center; color: var(--text-2); padding: 60px 0 30px; display: none; }
-  .no-results code { color: var(--amber); }
+  .no-results code { color: var(--cyan); }
 
   /* ---------- capabilities ---------- */
   .caps { display: grid; grid-template-columns: repeat(3, 1fr); gap: 18px; margin-top: 64px; }
@@ -343,9 +275,6 @@
     background: var(--ic-bg, rgba(255,255,255,.06)); color: var(--ic-fg, var(--text));
     border: 1px solid var(--line-soft);
   }
-  .cap h3 { font-size: 19.5px; font-weight: 750; letter-spacing: -.01em; }
-  .cap p { font-size: 14.5px; color: var(--text-2); margin-top: 10px; }
-  .cap .tags { display: flex; flex-wrap: wrap; gap: 7px; margin-top: 18px; }
   .cap .tags code {
     font-size: 12px; color: #d5d5e2; background: rgba(255,255,255,.06);
     border: 1px solid var(--line-soft); border-radius: 7px; padding: 3px 9px;
@@ -364,13 +293,13 @@
   .reg tbody td { padding: 15px 20px; border-bottom: 1px solid var(--line-soft); font-size: 14.5px; vertical-align: middle; }
   .reg tbody tr:last-child td { border-bottom: none; }
   .reg .tapname {
-    font-family: var(--mono); font-size: 13px; font-weight: 700; color: var(--amber);
+    font-family: var(--mono); font-size: 13px; font-weight: 700; color: var(--cyan);
     background: rgba(34,211,238,.09); border: 1px solid rgba(34,211,238,.25);
     border-radius: 8px; padding: 4px 11px; white-space: nowrap;
   }
   .reg .repo { font-family: var(--mono); font-size: 13px; color: var(--text-2); }
   .reg .cnt {
-    font-family: var(--mono); font-size: 13px; font-weight: 700; color: var(--amber);
+    font-family: var(--mono); font-size: 13px; font-weight: 700; color: var(--cyan);
     border: 1px solid rgba(34,211,238,.35); border-radius: 999px; padding: 4px 12px;
     font-variant-numeric: tabular-nums; white-space: nowrap;
   }
@@ -379,7 +308,7 @@
   .reg tr.dim .tapname { color: var(--text-2); background: var(--panel); border-color: var(--line); }
   .reg tr.dim .cnt { color: var(--text-2); border-color: var(--line); }
   .reg-note { text-align: center; font-size: 13.5px; color: var(--text-3); margin-top: 18px; }
-  .reg-note code { color: var(--amber); font-size: .92em; }
+  .reg-note code { color: var(--cyan); font-size: .92em; }
 
   /* ---------- get started ---------- */
   .install-box { max-width: 760px; margin: 56px auto 0; }
@@ -391,7 +320,7 @@
   .install-box .bar .label::before { content: ""; width: 8px; height: 8px; border-radius: 50%; background: var(--grad); }
   .copy-btn {
     font-family: var(--sans); font-size: 12.5px; font-weight: 700; color: #201705;
-    background: var(--amber); border: none; border-radius: 8px; padding: 6px 14px; cursor: pointer;
+    background: var(--cyan); border: none; border-radius: 8px; padding: 6px 14px; cursor: pointer;
   }
   .copy-btn:hover { filter: brightness(1.08); }
   .mini { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; max-width: 860px; margin: 40px auto 0; }
@@ -400,14 +329,14 @@
     background: var(--panel-solid); border: 1px solid var(--line-soft); border-radius: 12px; padding: 18px 20px;
   }
   .mini a:hover { border-color: var(--line); }
-  .mini .name { font-family: var(--mono); font-size: 14px; font-weight: 700; color: var(--amber); }
+  .mini .name { font-family: var(--mono); font-size: 14px; font-weight: 700; color: var(--cyan); }
   .mini .name .v { color: #85859c; font-weight: 400; }
   .mini p { font-size: 13px; color: var(--text-2); margin-top: 5px; }
 
   /* ---------- footer ---------- */
   footer { margin-top: 130px; border-top: 1px solid var(--line-soft); padding: 44px 0 60px; text-align: center; }
   footer .brand { font-size: 15px; color: var(--text-2); }
-  footer .brand b { font-family: var(--mono); color: var(--amber); }
+  footer .brand b { font-family: var(--mono); color: var(--cyan); }
   footer .meta { margin-top: 10px; font-size: 13.5px; color: var(--text-3); }
   footer .meta code {
     color: var(--text-2); background: var(--panel); border: 1px solid var(--line-soft);
@@ -701,7 +630,7 @@ facilitate structured divergent thinking:
           <div class="ic">⇄</div>
           <h3>Multi-agent &amp; integration</h3>
           <p>Install once, land in Claude Code, Windsurf, and Cursor. Run as a
-            native MCP server, register a <code style="color:var(--amber)">boost://</code> one-click
+            native MCP server, register a <code style="color:var(--cyan)">boost://</code> one-click
             protocol, serve a catalog over HTTP, or auto-sync on a schedule.</p>
           <div class="tags"><code>migrate</code><code>mcp</code><code>protocol</code><code>serve</code><code>schedule</code></div>
         </div>
@@ -775,7 +704,7 @@ facilitate structured divergent thinking:
                 <td><span class="tapname">your-org/skills</span></td>
                 <td class="repo">any repo with SKILL.md files</td>
                 <td><span class="cnt">∞</span></td>
-                <td class="focus">Your team’s registry — <code style="color:var(--amber);font-size:.92em">boost tap your-org/skills</code> (private repos work over ssh)</td>
+                <td class="focus">Your team’s registry — <code style="color:var(--cyan);font-size:.92em">boost tap your-org/skills</code> (private repos work over ssh)</td>
               </tr>
             </tbody>
           </table>

{boost_skill_cli-1.0.183 → boost_skill_cli-1.0.185}/docs/roadmap/items/performance-regression-gate-pytest-benchmark.md

@@ -2,15 +2,15 @@
 id: performance-regression-gate-pytest-benchmark
 board: code
 section: dx
-status: planned
+status: shipped
 category: Testing · Perf
 complexity: M
 impact: Med
 wow: 3
 note: scan & registry
 order: 6
-owner:
-pr:
+owner: loop/perfgate
+pr: 207
 title: Performance-regression gate — <code>pytest-benchmark</code>
 ---
 Benchmark the hot paths — a catalog scan over a large skills tree, a

{boost_skill_cli-1.0.183 → boost_skill_cli-1.0.185}/docs/roadmap/items/reconcile-the-theme-drift.md

@@ -2,15 +2,15 @@
 id: reconcile-the-theme-drift
 board: code
 section: next
-status: next
+status: shipped
 category: Design
 complexity: M
 impact: Med
 wow: 3
 note: 
 order: 3
-owner:
-pr:
+owner: loop/themedrift
+pr: 208
 title: Reconcile the theme drift
 ---
 <code>docs/index.html</code> inlines its own amber/orange palette

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

@@ -432,7 +432,7 @@ message, so routing it through the helper would change user-facing errors.</p>
 
       <!-- ROADMAP:cards section=next -->
       <article class="cap rcard">
-        <div class="head"><span class="pill next">Next</span><span class="cat">Design</span></div>
+        <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Design</span></div>
         <h3>Reconcile the theme drift</h3>
         <p><code>docs/index.html</code> inlines its own amber/orange palette
            instead of the canonical <em>Aurora</em> cyan→violet→pink system in
@@ -1387,7 +1387,7 @@ improvement is real (or isn't)."</p>
       </article>
 
       <article class="cap rcard">
-        <div class="head"><span class="pill planned">Planned</span><span class="cat">Testing · Perf</span></div>
+        <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Testing · Perf</span></div>
         <h3>Performance-regression gate — <code>pytest-benchmark</code></h3>
         <p>Benchmark the hot paths — a catalog scan over a large skills tree, a
            registry load — and fail the build when a change regresses them past a

boost_skill_cli-1.0.185/scripts/perf_gate.py

@@ -0,0 +1,149 @@
+#!/usr/bin/env python3
+"""Performance-regression gate: complexity scaling, not wall-clock baselines.
+
+A saved-baseline benchmark compare flakes on shared CI runners — machine speed
+varies run to run, so absolute thresholds either false-alarm or sandbag. What
+a gate CAN assert robustly is *how cost grows with input size*: time the hot
+paths at two catalog sizes on the SAME machine in the SAME process, and fail
+when the big/small ratio blows past the size ratio times a slack factor. An
+accidental O(n²) (size ratio 8 → time ratio ~64×) is caught decisively; noise
+and slow runners cancel out of the ratio. One generous absolute backstop
+catches only catch-fire regressions.
+
+Paths gated (the ones `boost search`/`tap` lean on):
+  * catalog.scan_dir  — walking + classifying a tap tree
+  * rag.build         — BM25 indexing of the scanned entries
+  * rag.retrieve      — query over the built index
+
+Usage:
+  PYTHONPATH=. python3 scripts/perf_gate.py          # run the gate
+  PYTHONPATH=. python3 scripts/perf_gate.py -v       # per-path timings
+
+Deliberately NOT part of `make check`'s five-gate contract (v1 blast-radius);
+CI runs it in the lint job. The opt-in micro-benchmarks (tests/perf, `make
+bench`) remain the profiling tool; this is the regression tripwire.
+"""
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+import tempfile
+import time
+from pathlib import Path
+
+# Run from a source checkout without an install (same shim as the eval gate).
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+SMALL, BIG = 64, 512          # catalog sizes; 8× input
+SLACK = 3.0                   # fail when time-ratio > size-ratio × SLACK (24×)
+ABS_BACKSTOP_S = 30.0         # any single big-size op slower than this fails
+MIN_SAMPLE_S = 0.05           # repeat an op until a sample is ≥ 50ms (jitter)
+BEST_OF = 3
+
+
+def _mk_catalog(root: Path, n: int) -> None:
+    """Materialize a synthetic tap tree with n skills + n rules + n workflows.
+
+    Content scales with the tree so indexing has real text to chew on, and
+    names are unique per size so nothing is accidentally shared or cached.
+    """
+    lorem = ["retrieval", "augmentation", "index", "tokens", "ranking", "corpus", "recall", "precision", "embedding", "catalog", "skill", "agent", "workflow", "rule"]
+    for i in range(n):
+        d = root / ("skill-%04d" % i)
+        d.mkdir(parents=True)
+        words = " ".join(lorem[(i + j) % len(lorem)] for j in range(60))
+        (d / "SKILL.md").write_text(
+            "---\nname: skill-%04d\ndescription: synthetic skill %d for the "
+            "perf gate\n---\n\n# skill-%04d\n\n%s\n" % (i, i, i, words),
+            encoding="utf-8")
+        (root / "rules" / ("rule-%04d.mdc" % i)).parent.mkdir(exist_ok=True)
+        (root / "rules" / ("rule-%04d.mdc" % i)).write_text(
+            "---\ndescription: synthetic rule %d\n---\nAlways %s.\n"
+            % (i, " ".join(lorem[i % len(lorem)] for _ in range(20))),
+            encoding="utf-8")
+        (root / "commands" / ("wf-%04d.md" % i)).parent.mkdir(exist_ok=True)
+        (root / "commands" / ("wf-%04d.md" % i)).write_text(
+            "# wf-%04d\n\nRun the synthetic workflow %d: %s\n"
+            % (i, i, words[:120]), encoding="utf-8")
+
+
+def _time(fn) -> float:
+    """Best-of-BEST_OF timing; each sample loops fn until ≥ MIN_SAMPLE_S."""
+    best = float("inf")
+    for _ in range(BEST_OF):
+        reps = 0
+        t0 = time.perf_counter()
+        while True:
+            fn()
+            reps += 1
+            dt = time.perf_counter() - t0
+            if dt >= MIN_SAMPLE_S:
+                break
+        best = min(best, dt / reps)
+    return best
+
+
+def _measure(size: int, verbose: bool) -> dict:
+    """Time the three hot paths against a fresh synthetic catalog of `size`."""
+    from boost_cli.core import catalog, rag
+
+    with tempfile.TemporaryDirectory(prefix="perfgate-") as tmp:
+        tap = Path(tmp) / "tap"
+        _mk_catalog(tap, size)
+        os.environ["BOOST_HOME"] = str(Path(tmp) / "home")
+        os.environ["HOME"] = tmp
+
+        out = {"scan": _time(lambda: catalog.scan_dir(tap, "perf"))}
+        entries = catalog.scan_dir(tap, "perf")
+        if len(entries) != 3 * size:  # a generator bug would invalidate ratios
+            raise SystemExit("perf-gate: generator drift: %d entries for n=%d"
+                             % (len(entries), size))
+
+        # build is once-per-corpus in real life — time single builds (forced).
+        best = float("inf")
+        for _ in range(BEST_OF):
+            t0 = time.perf_counter()
+            rag.build(entries, force=True)
+            best = min(best, time.perf_counter() - t0)
+        out["build"] = best
+
+        out["retrieve"] = _time(
+            lambda: rag.retrieve("ranking corpus recall skill", k=20))
+        if verbose:
+            for k, v in out.items():
+                print("  n=%-4d %-9s %8.1f ms" % (size, k, v * 1000))
+        return out
+
+
+def main(argv=None) -> int:
+    ap = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    ap.add_argument("-v", "--verbose", action="store_true")
+    args = ap.parse_args(argv)
+
+    small = _measure(SMALL, args.verbose)
+    big = _measure(BIG, args.verbose)
+
+    size_ratio = BIG / SMALL
+    limit = size_ratio * SLACK
+    failed = []
+    for path in ("scan", "build", "retrieve"):
+        ratio = big[path] / small[path] if small[path] > 0 else float("inf")
+        line = "%-9s %7.1fms -> %8.1fms  ratio %5.1fx (limit %.0fx)" % (
+            path, small[path] * 1000, big[path] * 1000, ratio, limit)
+        ok = ratio <= limit and big[path] <= ABS_BACKSTOP_S
+        print(("  PASS " if ok else "  FAIL ") + line)
+        if not ok:
+            failed.append(path)
+
+    if failed:
+        print("perf-gate: FAILED — superlinear scaling (or >%ds backstop) on: %s"
+              % (int(ABS_BACKSTOP_S), ", ".join(failed)), file=sys.stderr)
+        return 1
+    print("perf-gate: OK — all paths scale within %.0fx of linear at %dx input"
+          % (SLACK, int(size_ratio)))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

boost_skill_cli-1.0.185/tests/unit/test_perf_gate.py

@@ -0,0 +1,64 @@
+"""Unit tests for scripts/perf_gate.py — the scaling-ratio decision logic."""
+from __future__ import annotations
+
+import importlib.util
+from pathlib import Path
+
+import pytest
+
+_SCRIPT = Path(__file__).resolve().parents[2] / "scripts" / "perf_gate.py"
+
+_skip = pytest.mark.skipif(not _SCRIPT.exists(), reason="script not reachable")
+
+
+def _mod():
+    spec = importlib.util.spec_from_file_location("perf_gate", _SCRIPT)
+    assert spec and spec.loader
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+@_skip
+def test_linear_scaling_passes(monkeypatch, capsys):
+    pg = _mod()
+    fake = {64: {"scan": .01, "build": .01, "retrieve": .001},
+            512: {"scan": .08, "build": .08, "retrieve": .008}}   # exactly 8x
+    monkeypatch.setattr(pg, "_measure", lambda n, v: fake[n])
+    assert pg.main([]) == 0
+    assert "perf-gate: OK" in capsys.readouterr().out
+
+
+@_skip
+def test_quadratic_scaling_fails(monkeypatch, capsys):
+    pg = _mod()
+    fake = {64: {"scan": .01, "build": .01, "retrieve": .001},
+            512: {"scan": .64, "build": .08, "retrieve": .008}}   # scan at 64x
+    monkeypatch.setattr(pg, "_measure", lambda n, v: fake[n])
+    assert pg.main([]) == 1
+    out = capsys.readouterr()
+    assert "FAIL scan" in out.out
+    assert "superlinear" in out.err
+
+
+@_skip
+def test_absolute_backstop_fails_even_at_linear_ratio(monkeypatch, capsys):
+    pg = _mod()
+    fake = {64: {"scan": 5.0, "build": .01, "retrieve": .001},
+            512: {"scan": 40.0, "build": .08, "retrieve": .008}}  # 8x but 40s
+    monkeypatch.setattr(pg, "_measure", lambda n, v: fake[n])
+    assert pg.main([]) == 1
+    assert "FAIL scan" in capsys.readouterr().out
+
+
+@_skip
+def test_synthetic_catalog_has_expected_entry_count(tmp_path):
+    pg = _mod()
+    pg._mk_catalog(tmp_path, 5)
+    import boost_cli.core.catalog as catalog
+    entries = catalog.scan_dir(tmp_path, "t")
+    kinds = sorted(e.get("kind", "skill") for e in entries)
+    assert len(entries) == 15
+    assert kinds.count("skill") == 5
+    assert kinds.count("rule") == 5
+    assert kinds.count("workflow") == 5