boost-skill-cli 1.0.141__tar.gz → 1.0.143__tar.gz

{boost_skill_cli-1.0.141 → boost_skill_cli-1.0.143}/PKG-INFO

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

{boost_skill_cli-1.0.141 → boost_skill_cli-1.0.143}/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.141'
-__version_tuple__ = version_tuple = (1, 0, 141)
+__version__ = version = '1.0.143'
+__version_tuple__ = version_tuple = (1, 0, 143)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.141 → boost_skill_cli-1.0.143}/boost_skill_cli.egg-info/PKG-INFO

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

{boost_skill_cli-1.0.141 → boost_skill_cli-1.0.143}/boost_skill_cli.egg-info/SOURCES.txt

@@ -110,6 +110,7 @@ docs/roadmap/items/accessibility-audit-pa11y-ci-axe-core.md
 docs/roadmap/items/atomic-corruption-safe-lock-file-writes.md
 docs/roadmap/items/atomic-skill-install-temp-dir-swap.md
 docs/roadmap/items/autonomous-ship-workflow-and-isolated-worktree.md
+docs/roadmap/items/boost-run-live-agents.md
 docs/roadmap/items/bring-commands-under-mutation-testing.md
 docs/roadmap/items/broken-link-and-anchor-checking-lychee.md
 docs/roadmap/items/browse-crashes-selecting-a-rule-or-workflow.md
@@ -211,6 +212,7 @@ docs/roadmap/items/workflow-sast-zizmor.md
 docs/roadmap/items/workspace-scope-install.md
 examples/README.md
 examples/adapt-demo.sh
+examples/boost-run-prototype.sh
 scripts/build_registries.py
 scripts/build_roadmap.py
 scripts/ensure_eval_corpus.sh

boost_skill_cli-1.0.143/docs/roadmap/items/boost-run-live-agents.md

@@ -0,0 +1,16 @@
+---
+id: boost-run-live-agents
+board: code
+section: dx
+status: planned
+category: Interop
+complexity: L
+impact: High
+wow: 5
+note: 
+order: 43
+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).

{boost_skill_cli-1.0.141 → boost_skill_cli-1.0.143}/docs/roadmap.html

@@ -118,7 +118,7 @@
       <div class="stat"><b>16</b><span>Shipped</span></div>
       <div class="stat"><b>1</b><span>Next up</span></div>
       <div class="stat"><b>4</b><span>Planned</span></div>
-      <div class="stat"><b>103</b><span>Loop finds</span></div>
+      <div class="stat"><b>104</b><span>Loop finds</span></div>
       <!-- /ROADMAP:stats -->
     </div>
   </section>
@@ -1416,6 +1416,17 @@ explanations and safety, not better ranking.</p>
           <span class="m">Wow <b class="wow">★★★★</b></span>
         </div>
       </article>
+
+      <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>
+        <div class="meta">
+          <span class="m">Complexity <b>L</b></span>
+          <span class="m hi">Impact <b>High</b></span>
+          <span class="m">Wow <b class="wow">★★★★★</b></span>
+        </div>
+      </article>
       <!-- /ROADMAP:cards -->
 
     </div>

{boost_skill_cli-1.0.141 → boost_skill_cli-1.0.143}/examples/README.md

@@ -35,3 +35,23 @@ wheel yet; boost itself supports 3.9–3.14). Clean up with
 > The same import path is exercised in CI by
 > [`.github/workflows/adapter-conformance.yml`](../.github/workflows/adapter-conformance.yml),
 > which installs each real framework and asserts the emitted file instantiates.
+
+## `boost-run-prototype.sh` — a preview of `boost run`
+
+A hand-built preview of the planned [`boost run`](../docs/roadmap.html) feature
+(`boost adapt` gives an agent a *brain*, but no *hands*). It shows the
+"one command → a live agent doing the task" wow, built on today's `boost adapt`:
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-... bash examples/boost-run-prototype.sh
+```
+
+1. Authors a `code-reviewer` skill and `boost adapt`s it to the Agents SDK,
+   wired to boost's model (Claude) — **the brain**.
+2. Attaches a `read_file` `@function_tool` — **the hands** the skill needs to act.
+3. `Runner.run`s it against a file with two planted bugs (a `KeyError` and a SQL
+   injection) and prints the agent's actual review.
+
+Everything up to the run is offline; only the final `Runner.run` needs
+`ANTHROPIC_API_KEY`. This is the thinnest slice of what a shipped `boost run`
+would fold into a single command — see the `boost-run-live-agents` roadmap item.

boost_skill_cli-1.0.143/examples/boost-run-prototype.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# boost-run-prototype.sh — the thinnest slice of a future `boost run`.
+#
+# Shows the "one command → a live agent doing the task" wow that turns
+# `boost adapt` from a code generator into an outcome:
+#
+#     search/author a skill  →  boost adapt (the brain)
+#                            →  + a file-read tool (the hands)
+#                            →  Runner.run on boost's model (Claude)
+#                            →  a real review of a real file
+#
+# boost adapt gives the agent DEFINITION; this script adds a tool and executes
+# it — exactly what a shipped `boost run` would fold into one command.
+#
+# Needs ANTHROPIC_API_KEY for the actual run (everything before it is offline).
+# Sandboxed on HOME; clean up with:  rm -rf "${DEMO_DIR:-/tmp/boost-run-demo}"
+#
+# Usage:  ANTHROPIC_API_KEY=sk-ant-... bash boost-run-prototype.sh
+set -euo pipefail
+
+DEMO="${DEMO_DIR:-/tmp/boost-run-demo}"
+SKILL="code-reviewer"
+PYBIN=""
+for v in 3.13 3.12 3.11; do PYBIN="$(command -v "python$v" || true)"; [ -n "$PYBIN" ] && break; done
+[ -n "$PYBIN" ] || { echo "Need python3.11-3.13 (LiteLLM/tiktoken); brew install python@3.13"; exit 1; }
+
+c()  { printf '\n\033[1;36m== %s ==\033[0m\n' "$*"; }
+dim(){ printf '\033[2m%s\033[0m\n' "$*"; }
+ok() { printf '\033[1;32m%s\033[0m\n' "$*"; }
+
+c "1/4  sandbox + install (boost + openai-agents[litellm])"
+rm -rf "$DEMO"; mkdir -p "$DEMO"; export HOME="$DEMO/home"; mkdir -p "$HOME"
+"$PYBIN" -m venv "$DEMO/.venv"
+BOOST="$DEMO/.venv/bin/boost"; PY="$DEMO/.venv/bin/python"
+dim "installing … (~2-3 min first run)"
+"$DEMO/.venv/bin/pip" -q install -U boost-skill-cli "openai-agents[litellm]"
+
+c "2/4  a skill = the agent's brain (author locally; or 'boost search' any catalog skill)"
+mkdir -p "$DEMO/src/$SKILL"
+cat > "$DEMO/src/$SKILL/SKILL.md" <<'MD'
+---
+name: code-reviewer
+description: Reviews a file for correctness, security, and error handling
+---
+You are a precise code reviewer. Use the read_file tool to read the file you are
+asked to review, then list concrete issues as a short bulleted list — each with
+the line and a one-line fix. Focus on real bugs (crashes, unhandled errors,
+injection, missing checks). Be terse.
+MD
+"$BOOST" import "$DEMO/src/$SKILL" >/dev/null
+"$BOOST" adapt "$SKILL" --to agents-sdk -o "$DEMO/agent_def.py"    # wired to boost's model
+ok "adapted '$SKILL' → agent_def.py (on boost's model, Claude)"
+
+# a target file with an obvious bug for the agent to actually find
+cat > "$DEMO/target.py" <<'PY'
+def get_user(users, uid):
+    # BUG: no membership check — KeyError on unknown uid
+    return users[uid]
+
+def run_query(db, name):
+    # BUG: SQL built by string concat — injection
+    return db.execute("SELECT * FROM users WHERE name = '" + name + "'")
+PY
+dim "target file with two planted bugs: $DEMO/target.py"
+
+c "3/4  give the brain HANDS (a read_file tool) — what a shipped 'boost run' would wire"
+cat > "$DEMO/run.py" <<'PY'
+import pathlib, sys
+import agent_def
+from agents import Agent, Runner, function_tool
+
+base = next(v for v in vars(agent_def).values() if isinstance(v, Agent))  # the adapted agent
+
+@function_tool
+def read_file(path: str) -> str:
+    """Read a text file and return its contents."""
+    return pathlib.Path(path).read_text()[:8000]
+
+# boost gave the brain (instructions + model); we add the hands (tools)
+reviewer = Agent(name=base.name, instructions=base.instructions,
+                 model=base.model, tools=[read_file])
+print(f"  wired agent: {reviewer.name}  model={reviewer.model.model}  tools={[t.name for t in reviewer.tools]}")
+
+target = sys.argv[1] if len(sys.argv) > 1 else "target.py"
+result = Runner.run_sync(reviewer, f"Review the file at {target}.")
+print("\n----- review -----\n" + result.final_output)
+PY
+
+c "4/4  RUN it — a live agent reviewing the file, on Claude"
+cd "$DEMO"
+if [ -n "${ANTHROPIC_API_KEY:-}" ]; then
+  "$PY" run.py target.py
+  ok "^ an agent you searched/authored, wired with a tool, found the bugs — on boost's model"
+else
+  # still prove the wiring works with no key
+  "$PY" - <<'PY'
+import agent_def
+from agents import Agent, function_tool
+import pathlib
+base = next(v for v in vars(agent_def).values() if isinstance(v, Agent))
+@function_tool
+def read_file(path: str) -> str: return pathlib.Path(path).read_text()
+reviewer = Agent(name=base.name, instructions=base.instructions, model=base.model, tools=[read_file])
+print(f"  wired agent: {reviewer.name}  model={reviewer.model.model}  tools={[t.name for t in reviewer.tools]}")
+print("  \033[1;32m✓ agent + tool constructed (no key). Set ANTHROPIC_API_KEY to see it review.\033[0m")
+PY
+  dim "  run for real:  ANTHROPIC_API_KEY=sk-ant-... bash $0"
+fi
+
+c "done"
+dim "artifacts in $DEMO :  agent_def.py (from boost adapt)  run.py (the +tools+run wrapper)  target.py"
+dim "clean up:  rm -rf $DEMO"