boost-skill-cli 1.0.168__tar.gz → 1.0.170__tar.gz

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/PKG-INFO

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

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/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.168'
-__version_tuple__ = version_tuple = (1, 0, 168)
+__version__ = version = '1.0.170'
+__version_tuple__ = version_tuple = (1, 0, 170)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/boost_cli/core/adapters.py

@@ -84,6 +84,23 @@ def _litellm_model(model: str) -> str:
     return m if "/" in m else "anthropic/" + m
 
 
+def _langchain_model(model: str) -> str:
+    """Normalize a boost model id to a LangChain ``init_chat_model`` string.
+
+    LangGraph's ``create_react_agent`` builds its model via LangChain's
+    ``init_chat_model``, which wants ``provider:model`` (colon) — not LiteLLM's
+    ``provider/model`` (slash). A bare Claude id gets ``anthropic:``; a
+    litellm-style ``anthropic/x`` becomes ``anthropic:x``; a value that already
+    uses the colon form passes through.
+    """
+    m = model.strip()
+    if ":" in m:
+        return m
+    if "/" in m:
+        return m.replace("/", ":", 1)
+    return "anthropic:" + m
+
+
 # --- renderers ------------------------------------------------------------
 
 def render_crewai(name: str, description: str, body: str,
@@ -156,7 +173,44 @@ def render_agents_sdk(name: str, description: str, body: str,
     )
 
 
+def render_langgraph(name: str, description: str, body: str,
+                     model: Optional[str] = None) -> str:
+    """A LangGraph node factory: prebuilt ``create_react_agent`` bound to the
+    skill body as its system prompt.
+
+    Unlike CrewAI / the Agents SDK, a LangGraph agent isn't one constructor —
+    it's a node compiled with a model and dropped into a ``StateGraph``. So we
+    emit a *factory* (``make_<name>``) the caller invokes with a model and any
+    tools, rather than a module-level value. With `model`, the factory's
+    ``model`` argument defaults to the normalized LiteLLM id; without it, the
+    caller must supply one (LangGraph has no default provider to inherit).
+    """
+    var = _ident(name)
+    if model:
+        sig = "model=%s, tools=None" % _py_str(_langchain_model(model))
+    else:
+        sig = "model, tools=None"
+    return (
+        "# Generated by `boost adapt %s --to langgraph`. Do not edit by hand.\n"
+        "from langgraph.prebuilt import create_react_agent\n"
+        "\n"
+        "SYSTEM_PROMPT = %s\n"
+        "\n"
+        "\n"
+        "def make_%s(%s):\n"
+        "    %s\n"
+        "    return create_react_agent(model, tools=tools or [], prompt=SYSTEM_PROMPT)\n"
+    ) % (
+        name,
+        _py_str(_clean(body)),
+        var,
+        sig,
+        _py_str(_clean(description)),
+    )
+
+
 FORMATS.update({
     "crewai": render_crewai,
     "agents-sdk": render_agents_sdk,
+    "langgraph": render_langgraph,
 })

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/boost_skill_cli.egg-info/PKG-INFO

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

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/docs/commands.html

@@ -341,7 +341,7 @@
         </div>
         <div class="args-h">Options</div>
         <div class="args">
-          <div class="arg"><code>--to FRAMEWORK</code><span>target framework: agents-sdk, crewai</span></div>
+          <div class="arg"><code>--to FRAMEWORK</code><span>target framework: agents-sdk, crewai, langgraph</span></div>
           <div class="arg"><code>--model M</code><span>LLM the exported agent runs on (default: boost&#x27;s ai.model; pass &#x27;none&#x27; for the framework&#x27;s own default)</span></div>
           <div class="arg"><code>-o, --out FILE</code><span>write to FILE instead of stdout</span></div>
         </div>

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/docs/roadmap/items/framework-adapter-langgraph.md

@@ -2,7 +2,7 @@
 id: framework-adapter-langgraph
 board: code
 section: dx
-status: planned
+status: shipped
 category: Interop
 complexity: M
 impact: Med

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/docs/roadmap/items/supply-chain-posture-openssf-scorecard.md

@@ -2,15 +2,15 @@
 id: supply-chain-posture-openssf-scorecard
 board: code
 section: health
-status: planned
+status: shipped
 category: Security · Posture
 complexity: S
 impact: Med
 wow: 4
 note: badge-worthy
 order: 3
-owner:
-pr:
+owner: loop/scorecard
+pr: 193
 title: Supply-chain posture — OpenSSF Scorecard
 ---
 The Scorecard GitHub Action audits ~18 supply-chain signals weekly —

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/docs/roadmap.html

@@ -949,7 +949,7 @@ explanations and safety, not better ranking.</p>
       </article>
 
       <article class="cap rcard">
-        <div class="head"><span class="pill planned">Planned</span><span class="cat">Security · Posture</span></div>
+        <div class="head"><span class="pill shipped">Shipped</span><span class="cat">Security · Posture</span></div>
         <h3>Supply-chain posture — OpenSSF Scorecard</h3>
         <p>The Scorecard GitHub Action audits ~18 supply-chain signals weekly —
            branch protection, token permissions, SHA-pinned actions, dangerous
@@ -1460,7 +1460,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">Interop</span></div>
+        <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>
         <div class="meta">

{boost_skill_cli-1.0.168 → boost_skill_cli-1.0.170}/tests/unit/test_adapters.py

@@ -13,8 +13,8 @@ from boost_cli.core import adapters
 
 
 class TestFormats:
-    def test_registry_lists_both_frameworks(self):
-        assert adapters.formats() == ["agents-sdk", "crewai"]
+    def test_registry_lists_all_frameworks(self):
+        assert adapters.formats() == ["agents-sdk", "crewai", "langgraph"]
 
     def test_formats_is_sorted(self):
         assert adapters.formats() == sorted(adapters.formats())
@@ -160,6 +160,82 @@ class TestRenderAgentsSdk:
         )
 
 
+class TestRenderLanggraph:
+    def setup_method(self):
+        self.src = adapters.render_langgraph(
+            "code-reviewer",
+            "Reviews a diff for correctness",
+            "Review the diff.\nRank by severity.",
+        )
+
+    def test_is_valid_python(self):
+        compile(self.src, "<langgraph>", "exec")
+
+    def test_imports_create_react_agent(self):
+        assert "from langgraph.prebuilt import create_react_agent" in self.src
+
+    def test_emits_a_node_factory_named_from_skill(self):
+        assert "def make_code_reviewer(model, tools=None):" in self.src
+
+    def test_body_is_the_system_prompt(self):
+        assert 'SYSTEM_PROMPT = "Review the diff.\\nRank by severity."' in self.src
+
+    def test_factory_binds_prompt_and_tools(self):
+        assert ("return create_react_agent(model, tools=tools or [], "
+                "prompt=SYSTEM_PROMPT)") in self.src
+
+    def test_has_provenance_header(self):
+        assert self.src.startswith(
+            "# Generated by `boost adapt code-reviewer --to langgraph`.")
+
+    def test_exact_output(self):
+        assert self.src == (
+            "# Generated by `boost adapt code-reviewer --to langgraph`."
+            " Do not edit by hand.\n"
+            "from langgraph.prebuilt import create_react_agent\n"
+            "\n"
+            'SYSTEM_PROMPT = "Review the diff.\\nRank by severity."\n'
+            "\n"
+            "\n"
+            "def make_code_reviewer(model, tools=None):\n"
+            '    "Reviews a diff for correctness"\n'
+            "    return create_react_agent(model, tools=tools or [],"
+            " prompt=SYSTEM_PROMPT)\n"
+        )
+
+
+class TestLanggraphWithModel:
+    def setup_method(self):
+        self.src = adapters.render_langgraph(
+            "code-reviewer", "Reviews a diff", "Review it.",
+            "claude-haiku-4-5-20251001")
+
+    def test_is_valid_python(self):
+        compile(self.src, "<lg>", "exec")
+
+    def test_model_defaults_the_factory_arg(self):
+        # LangChain init_chat_model wants provider:model (colon), not litellm's slash.
+        assert ('def make_code_reviewer('
+                'model="anthropic:claude-haiku-4-5-20251001", tools=None):'
+                in self.src)
+
+    def test_exact_output(self):
+        assert self.src == (
+            "# Generated by `boost adapt code-reviewer --to langgraph`."
+            " Do not edit by hand.\n"
+            "from langgraph.prebuilt import create_react_agent\n"
+            "\n"
+            'SYSTEM_PROMPT = "Review it."\n'
+            "\n"
+            "\n"
+            'def make_code_reviewer('
+            'model="anthropic:claude-haiku-4-5-20251001", tools=None):\n'
+            '    "Reviews a diff"\n'
+            "    return create_react_agent(model, tools=tools or [],"
+            " prompt=SYSTEM_PROMPT)\n"
+        )
+
+
 class TestAdversarialBodiesStayValid:
     """A skill body full of quote/escape hazards must still emit valid Python."""
 
@@ -180,6 +256,10 @@ class TestAdversarialBodiesStayValid:
     def test_agents_sdk_compiles(self, body):
         compile(adapters.render_agents_sdk("s", "d", body), "<c>", "exec")
 
+    @pytest.mark.parametrize("body", HAZARDS)
+    def test_langgraph_compiles(self, body):
+        compile(adapters.render_langgraph("s", "d", body), "<c>", "exec")
+
     def test_body_round_trips_through_the_literal(self):
         # Extract the backstory literal and confirm it decodes to the original.
         body = 'weird """ body with "quotes" and \\ slashes\nand lines'
@@ -204,6 +284,23 @@ class TestLitellmModel:
         assert adapters._litellm_model("  claude-x  ") == "anthropic/claude-x"
 
 
+class TestLangchainModel:
+    def test_bare_id_gets_anthropic_colon(self):
+        assert adapters._langchain_model("claude-haiku-4-5-20251001") == \
+            "anthropic:claude-haiku-4-5-20251001"
+
+    def test_litellm_slash_becomes_colon(self):
+        assert adapters._langchain_model("anthropic/claude-sonnet-5") == \
+            "anthropic:claude-sonnet-5"
+        assert adapters._langchain_model("openai/gpt-4o") == "openai:gpt-4o"
+
+    def test_colon_form_passes_through(self):
+        assert adapters._langchain_model("anthropic:claude-x") == "anthropic:claude-x"
+
+    def test_strips_whitespace(self):
+        assert adapters._langchain_model("  claude-x  ") == "anthropic:claude-x"
+
+
 class TestCrewaiWithModel:
     def setup_method(self):
         self.src = adapters.render_crewai(
@@ -286,13 +383,15 @@ class TestModelOmittedIsUnchanged:
         # falsy model ("") must not emit an LLM line
         assert "LLM" not in adapters.render_crewai("x", "d", "b", "")
 
-    @pytest.mark.parametrize("fmt", ["crewai", "agents-sdk"])
+    @pytest.mark.parametrize("fmt", ["crewai", "agents-sdk", "langgraph"])
     def test_render_dispatch_passes_model_through(self, fmt):
         src = adapters.render(fmt, "x", "d", "b", "claude-x")
-        assert "anthropic/claude-x" in src
+        # crewai/agents-sdk emit litellm anthropic/claude-x; langgraph emits the
+        # LangChain anthropic:claude-x — either way the model is wired through.
+        assert "claude-x" in src and "anthropic" in src
         compile(src, "<c>", "exec")
 
-    @pytest.mark.parametrize("fmt", ["crewai", "agents-sdk"])
+    @pytest.mark.parametrize("fmt", ["crewai", "agents-sdk", "langgraph"])
     def test_model_output_still_compiles(self, fmt):
         compile(adapters.render(fmt, "s", "d", 'body """ x', "claude-y"),
                 "<c>", "exec")