boost-skill-cli 1.0.134__tar.gz → 1.0.135__tar.gz

{boost_skill_cli-1.0.134 → boost_skill_cli-1.0.135}/PKG-INFO

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

{boost_skill_cli-1.0.134 → boost_skill_cli-1.0.135}/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.134'
-__version_tuple__ = version_tuple = (1, 0, 134)
+__version__ = version = '1.0.135'
+__version_tuple__ = version_tuple = (1, 0, 135)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.134 → boost_skill_cli-1.0.135}/boost_skill_cli.egg-info/PKG-INFO

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

{boost_skill_cli-1.0.134 → boost_skill_cli-1.0.135}/boost_skill_cli.egg-info/SOURCES.txt

@@ -206,6 +206,8 @@ docs/roadmap/items/workflow-install-native-materialization.md
 docs/roadmap/items/workflow-linting-actionlint.md
 docs/roadmap/items/workflow-sast-zizmor.md
 docs/roadmap/items/workspace-scope-install.md
+examples/README.md
+examples/adapt-demo.sh
 scripts/build_registries.py
 scripts/build_roadmap.py
 scripts/ensure_eval_corpus.sh

boost_skill_cli-1.0.135/examples/README.md

@@ -0,0 +1,34 @@
+# boost examples
+
+Runnable demos of boost features. Each script is self-contained and sandboxes
+its state under a throwaway `HOME`, so it never touches your real `~/.agents`.
+
+## `adapt-demo.sh` — the value of `boost adapt`
+
+Shows why [`boost adapt`](../docs/adapters.html) exists: **author one skill,
+run it in every framework, with zero drift.**
+
+```bash
+bash examples/adapt-demo.sh
+```
+
+What it does (all offline — **no `OPENAI_API_KEY` needed**):
+
+1. Spins up an isolated sandbox and installs `boost` + `crewai` +
+   `openai-agents` into a fresh venv.
+2. Authors **one** `SKILL.md` and imports it into boost.
+3. **Value 1** — renders it to *both* frameworks and instantiates each:
+   a real `crewai.Agent` and a real `agents.Agent` from the same source, no
+   hand-porting.
+4. **Value 2** — edits the skill **once** and re-adapts; the change appears in
+   **both** generated files (before/after `0 0` → `1 1`). That is the
+   drift-killing payoff: one edit, every runtime current.
+5. Optional: if `OPENAI_API_KEY` is set, actually runs the agent.
+
+Requirements: **Python 3.11–3.13** (CrewAI's `tiktoken` dependency has no 3.14
+wheel yet; boost itself supports 3.9–3.14). Clean up with
+`rm -rf /tmp/boost-adapt-demo`.
+
+> 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_skill_cli-1.0.135/examples/adapt-demo.sh

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+# adapt-demo.sh — prove the VALUE of `boost adapt`.
+#
+# Author ONE skill in boost, get native agents for CrewAI *and* the OpenAI
+# Agents SDK, then edit the skill once and watch the change land in BOTH — the
+# zero-drift payoff the feature exists for.
+#
+# No OPENAI_API_KEY needed: generating + instantiating the agents is fully
+# offline. Only the optional final "run live inference" step wants a key.
+#
+# Everything runs in an ISOLATED sandbox HOME, so your real ~/.agents is never
+# touched. Clean up with:  rm -rf "${DEMO_DIR:-/tmp/boost-adapt-demo}"
+#
+# Usage:  bash examples/adapt-demo.sh
+set -euo pipefail
+
+DEMO="${DEMO_DIR:-/tmp/boost-adapt-demo}"
+SKILL="code-reviewer"
+
+c()   { printf '\n\033[1;36m== %s ==\033[0m\n' "$*"; }   # cyan banner
+dim() { printf '\033[2m%s\033[0m\n' "$*"; }
+ok()  { printf '\033[1;32m%s\033[0m\n' "$*"; }
+
+# CrewAI's tiktoken dep has no cp314 wheel yet, so pin to 3.11-3.13.
+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.12, or 3.13 — CrewAI's tiktoken has no 3.14 wheel."
+  echo "  macOS:  brew install python@3.13"
+  exit 1
+}
+
+# ---- 1. isolated sandbox (HOME is boost's home lever, like tests/smoke.sh) --
+c "1/5  Fresh, isolated sandbox"
+rm -rf "$DEMO"; mkdir -p "$DEMO"
+export HOME="$DEMO/home"; mkdir -p "$HOME"          # boost store → $DEMO/home/.agents
+"$PYBIN" -m venv "$DEMO/.venv"                       # absolute py: independent of HOME
+BOOST="$DEMO/.venv/bin/boost"; PY="$DEMO/.venv/bin/python"
+dim "installing boost + crewai + openai-agents … (crewai is a big tree; ~2-3 min first run)"
+"$DEMO/.venv/bin/pip" -q install -U boost-skill-cli crewai openai-agents
+dim "boost $("$BOOST" --version | awk '{print $2}')  ·  isolated home = $HOME/.agents"
+
+# ---- 2. author ONE skill (the single source of truth) -----------------------
+c "2/5  Author ONE skill"
+mkdir -p "$DEMO/src/$SKILL"
+cat > "$DEMO/src/$SKILL/SKILL.md" <<'MD'
+---
+name: code-reviewer
+description: Reviews a diff for correctness, security, and test coverage
+---
+Review the provided diff. Flag unhandled errors, injection-prone string
+building, and missing tests on new branches. Rank findings by severity and
+cite file:line.
+MD
+"$BOOST" import "$DEMO/src/$SKILL" >/dev/null
+ok "installed '$SKILL' into boost (one SKILL.md — the single source)"
+
+# ---- 3. VALUE (1): author once -> two frameworks (no key) -------------------
+c "3/5  VALUE 1 — one skill → native agents for TWO frameworks (no API key)"
+"$BOOST" adapt "$SKILL" --to crewai     -o "$DEMO/crew_agent.py"
+"$BOOST" adapt "$SKILL" --to agents-sdk -o "$DEMO/sdk_agent.py"
+cd "$DEMO"
+"$PY" - <<'PYEOF'
+import crew_agent, sdk_agent
+from crewai import Agent as CrewAgent
+from agents import Agent as SdkAgent
+crew = next(v for v in vars(crew_agent).values() if isinstance(v, CrewAgent))
+sdk  = next(v for v in vars(sdk_agent).values()  if isinstance(v, SdkAgent))
+print(f"  CrewAI     -> {type(crew).__module__}.{type(crew).__name__}   role={crew.role!r}")
+print(f"  Agents SDK -> {type(sdk).__module__}.{type(sdk).__name__}   name={sdk.name!r}")
+print("  \033[1;32m✓ same SKILL.md, two real framework Agent objects — zero hand-porting\033[0m")
+PYEOF
+
+# ---- 4. VALUE (2): edit once -> both update (zero drift) --------------------
+c "4/5  VALUE 2 — edit the skill ONCE → both frameworks update (zero drift)"
+SKILL_MD="$("$PY" -c "from boost_cli.core import store; print(store.skill_store_dir('$SKILL')/'SKILL.md')")"
+MARKER="Always finish with a ranked shortlist of the top 3 issues."
+printf '\n- %s\n' "$MARKER" >> "$SKILL_MD"
+dim "edited the one source: $SKILL_MD"
+dim "  + \"$MARKER\""
+"$BOOST" adapt "$SKILL" --to crewai     -o "$DEMO/crew_after.py"
+"$BOOST" adapt "$SKILL" --to agents-sdk -o "$DEMO/sdk_after.py"
+bc=$(grep -c "$MARKER" crew_agent.py || true); bs=$(grep -c "$MARKER" sdk_agent.py || true)
+ac=$(grep -c "$MARKER" crew_after.py || true); as=$(grep -c "$MARKER" sdk_after.py || true)
+printf '  %-14s %-10s %-10s\n' ''            'CrewAI'   'AgentsSDK'
+printf '  %-14s %-10s %-10s\n' 'before edit' "$bc"      "$bs"
+printf '  %-14s %-10s %-10s\n' 'after  edit' "$ac"      "$as"
+ok "one edit → both outputs carry it (1 & 1). Hand-porting means keeping N copies in sync forever."
+
+# ---- 5. optional: run live inference (needs a key) --------------------------
+c "5/5  (optional) run the agent — needs an LLM key"
+if [ -n "${OPENAI_API_KEY:-}" ]; then
+  "$PY" - <<'PYEOF'
+from agents import Runner, Agent as SdkAgent
+import sdk_agent
+sdk = next(v for v in vars(sdk_agent).values() if isinstance(v, SdkAgent))
+print("  " + Runner.run_sync(sdk, "Name two things you check in a code review.").final_output.replace("\n", "\n  "))
+PYEOF
+else
+  dim "  OPENAI_API_KEY not set — skipping live run (instantiation above already"
+  dim "  proved the contract without a key). To run for real:"
+  dim "    OPENAI_API_KEY=sk-... bash $0"
+fi
+
+c "done"
+dim "artifacts in $DEMO :  crew_agent.py  sdk_agent.py  crew_after.py  sdk_after.py"
+dim "clean up with:  rm -rf $DEMO"