@dewtech/dare-cli 3.3.0 → 3.5.0

package/templates/stacks/mcp-python/src/cli.py.j2

@@ -1,68 +1,68 @@
-"""CLI entrypoint — picks transport from --transport or MCP_TRANSPORT env."""
-from __future__ import annotations
-
-import argparse
-import json
-import os
-import sys
-from typing import Literal
-
-from src.server import mcp
-from src.transports import http as http_transport
-from src.transports import sse as sse_transport
-from src.transports import stdio as stdio_transport
-
-Transport = Literal["stdio", "sse", "http"]
-
-
-def parse_args(argv: list[str]) -> tuple[Transport, bool]:
-    env_default = os.environ.get("MCP_TRANSPORT", "{{ defaultTransport }}")
-    parser = argparse.ArgumentParser(description="DARE-shaped MCP server")
-    parser.add_argument(
-        "--transport",
-        choices=["stdio", "sse", "http"],
-        default=env_default,
-        help="Transport (default: %(default)s)",
-    )
-    parser.add_argument("--json", action="store_true", help="Emit JSON output (use with --list-tools)")
-    parser.add_argument("--list-tools", action="store_true", help="List registered tools as JSON and exit")
-    ns = parser.parse_args(argv)
-    return ns.transport, bool(ns.json and ns.list_tools)
-
-
-def list_tools_json() -> None:
-    # FastMCP keeps an in-memory registry; surface it as a stable JSON shape.
-    tools = [
-        {
-            "name": name,
-            "description": (t.description or "").strip(),
-            # FastMCP's Tool exposes the JSON schema as `parameters`.
-            "inputSchema": t.parameters,
-        }
-        for name, t in mcp._tool_manager._tools.items()  # type: ignore[attr-defined]
-    ]
-    sys.stdout.write(json.dumps({"tools": tools}, indent=2) + "\n")
-
-
-def main(argv: list[str] | None = None) -> None:
-    transport, want_list = parse_args(sys.argv[1:] if argv is None else argv)
-
-    if want_list:
-        list_tools_json()
-        return
-
-    port = int(os.environ.get("MCP_PORT", "3001"))
-    host = os.environ.get("MCP_HOST", "0.0.0.0")
-
-    if transport == "stdio":
-        stdio_transport.run(mcp)
-    elif transport == "sse":
-        sse_transport.run(mcp, host=host, port=port)
-    elif transport == "http":
-        http_transport.run(mcp, host=host, port=port)
-    else:  # pragma: no cover — argparse guarantees one of the above
-        raise SystemExit(f"invalid transport: {transport}")
-
-
-if __name__ == "__main__":
-    main()
+"""CLI entrypoint — picks transport from --transport or MCP_TRANSPORT env."""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from typing import Literal
+
+from src.server import mcp
+from src.transports import http as http_transport
+from src.transports import sse as sse_transport
+from src.transports import stdio as stdio_transport
+
+Transport = Literal["stdio", "sse", "http"]
+
+
+def parse_args(argv: list[str]) -> tuple[Transport, bool]:
+    env_default = os.environ.get("MCP_TRANSPORT", "{{ defaultTransport }}")
+    parser = argparse.ArgumentParser(description="DARE-shaped MCP server")
+    parser.add_argument(
+        "--transport",
+        choices=["stdio", "sse", "http"],
+        default=env_default,
+        help="Transport (default: %(default)s)",
+    )
+    parser.add_argument("--json", action="store_true", help="Emit JSON output (use with --list-tools)")
+    parser.add_argument("--list-tools", action="store_true", help="List registered tools as JSON and exit")
+    ns = parser.parse_args(argv)
+    return ns.transport, bool(ns.json and ns.list_tools)
+
+
+def list_tools_json() -> None:
+    # FastMCP keeps an in-memory registry; surface it as a stable JSON shape.
+    tools = [
+        {
+            "name": name,
+            "description": (t.description or "").strip(),
+            # FastMCP's Tool exposes the JSON schema as `parameters`.
+            "inputSchema": t.parameters,
+        }
+        for name, t in mcp._tool_manager._tools.items()  # type: ignore[attr-defined]
+    ]
+    sys.stdout.write(json.dumps({"tools": tools}, indent=2) + "\n")
+
+
+def main(argv: list[str] | None = None) -> None:
+    transport, want_list = parse_args(sys.argv[1:] if argv is None else argv)
+
+    if want_list:
+        list_tools_json()
+        return
+
+    port = int(os.environ.get("MCP_PORT", "3001"))
+    host = os.environ.get("MCP_HOST", "0.0.0.0")
+
+    if transport == "stdio":
+        stdio_transport.run(mcp)
+    elif transport == "sse":
+        sse_transport.run(mcp, host=host, port=port)
+    elif transport == "http":
+        http_transport.run(mcp, host=host, port=port)
+    else:  # pragma: no cover — argparse guarantees one of the above
+        raise SystemExit(f"invalid transport: {transport}")
+
+
+if __name__ == "__main__":
+    main()

package/templates/stacks/mcp-python/src/prompts/summarize.py

@@ -1,10 +1,10 @@
-"""Summarize prompt — returns a templated user message."""
-
-
-def summarize(text: str) -> str:
-    """Returns the user message body for a summarize prompt.
-
-    Args:
-        text: Text to summarize.
-    """
-    return f"Summarize the following text in 1-2 sentences.\n\n{text}"
+"""Summarize prompt — returns a templated user message."""
+
+
+def summarize(text: str) -> str:
+    """Returns the user message body for a summarize prompt.
+
+    Args:
+        text: Text to summarize.
+    """
+    return f"Summarize the following text in 1-2 sentences.\n\n{text}"

package/templates/stacks/mcp-python/src/server.py.j2

@@ -1,28 +1,28 @@
-"""FastMCP server — tools and prompts registered here."""
-from mcp.server.fastmcp import FastMCP
-
-from src.tools.echo import echo as echo_impl
-from src.prompts.summarize import summarize as summarize_impl
-
-
-mcp = FastMCP("{{ projectName }}")
-
-
-@mcp.tool()
-async def echo(text: str) -> str:
-    """Returns its input. Canonical smoke test for an MCP server.
-
-    Args:
-        text: Text to echo back (required, non-empty).
-    """
-    return await echo_impl(text)
-
-
-@mcp.prompt()
-def summarize(text: str) -> str:
-    """Summarize the given text in 1-2 sentences.
-
-    Args:
-        text: Text to summarize.
-    """
-    return summarize_impl(text)
+"""FastMCP server — tools and prompts registered here."""
+from mcp.server.fastmcp import FastMCP
+
+from src.tools.echo import echo as echo_impl
+from src.prompts.summarize import summarize as summarize_impl
+
+
+mcp = FastMCP("{{ projectName }}")
+
+
+@mcp.tool()
+async def echo(text: str) -> str:
+    """Returns its input. Canonical smoke test for an MCP server.
+
+    Args:
+        text: Text to echo back (required, non-empty).
+    """
+    return await echo_impl(text)
+
+
+@mcp.prompt()
+def summarize(text: str) -> str:
+    """Summarize the given text in 1-2 sentences.
+
+    Args:
+        text: Text to summarize.
+    """
+    return summarize_impl(text)

package/templates/stacks/mcp-python/src/tools/echo.py

@@ -1,12 +1,12 @@
-"""Echo tool implementation — testable as a plain function."""
-
-
-async def echo(text: str) -> str:
-    """Returns its input verbatim.
-
-    Raises:
-        ValueError: when text is empty or None.
-    """
-    if not isinstance(text, str) or not text:
-        raise ValueError("text must be a non-empty string")
-    return text
+"""Echo tool implementation — testable as a plain function."""
+
+
+async def echo(text: str) -> str:
+    """Returns its input verbatim.
+
+    Raises:
+        ValueError: when text is empty or None.
+    """
+    if not isinstance(text, str) or not text:
+        raise ValueError("text must be a non-empty string")
+    return text

package/templates/stacks/mcp-python/src/transports/http.py

@@ -1,12 +1,12 @@
-"""Streamable HTTP transport — modern MCP HTTP wire format.
-
-Each client gets its own session keyed by the Mcp-Session-Id header,
-generated on initialize. FastMCP wraps the uvicorn + Starlette plumbing.
-"""
-from mcp.server.fastmcp import FastMCP
-
-
-def run(mcp: FastMCP, host: str = "0.0.0.0", port: int = 3001) -> None:
-    mcp.settings.host = host
-    mcp.settings.port = port
-    mcp.run(transport="streamable-http")
+"""Streamable HTTP transport — modern MCP HTTP wire format.
+
+Each client gets its own session keyed by the Mcp-Session-Id header,
+generated on initialize. FastMCP wraps the uvicorn + Starlette plumbing.
+"""
+from mcp.server.fastmcp import FastMCP
+
+
+def run(mcp: FastMCP, host: str = "0.0.0.0", port: int = 3001) -> None:
+    mcp.settings.host = host
+    mcp.settings.port = port
+    mcp.run(transport="streamable-http")

package/templates/stacks/mcp-python/src/transports/sse.py

@@ -1,13 +1,13 @@
-"""SSE-over-HTTP transport — legacy MCP HTTP wire format.
-
-FastMCP launches a uvicorn server under the hood and exposes the SSE
-endpoints. For new deployments prefer the streamable HTTP transport
-(transports/http.py).
-"""
-from mcp.server.fastmcp import FastMCP
-
-
-def run(mcp: FastMCP, host: str = "0.0.0.0", port: int = 3001) -> None:
-    mcp.settings.host = host
-    mcp.settings.port = port
-    mcp.run(transport="sse")
+"""SSE-over-HTTP transport — legacy MCP HTTP wire format.
+
+FastMCP launches a uvicorn server under the hood and exposes the SSE
+endpoints. For new deployments prefer the streamable HTTP transport
+(transports/http.py).
+"""
+from mcp.server.fastmcp import FastMCP
+
+
+def run(mcp: FastMCP, host: str = "0.0.0.0", port: int = 3001) -> None:
+    mcp.settings.host = host
+    mcp.settings.port = port
+    mcp.run(transport="sse")

package/templates/stacks/mcp-python/src/transports/stdio.py

@@ -1,6 +1,6 @@
-"""stdio transport — the default for local agents."""
-from mcp.server.fastmcp import FastMCP
-
-
-def run(mcp: FastMCP) -> None:
-    mcp.run(transport="stdio")
+"""stdio transport — the default for local agents."""
+from mcp.server.fastmcp import FastMCP
+
+
+def run(mcp: FastMCP) -> None:
+    mcp.run(transport="stdio")

package/templates/stacks/mcp-python/tests/test_echo.py

@@ -1,28 +1,28 @@
-"""Smoke tests for echo tool and summarize prompt."""
-import pytest
-
-from src.prompts.summarize import summarize
-from src.tools.echo import echo
-
-
-@pytest.mark.asyncio
-async def test_echo_returns_input():
-    assert await echo("hello") == "hello"
-
-
-@pytest.mark.asyncio
-async def test_echo_rejects_empty():
-    with pytest.raises(ValueError):
-        await echo("")
-
-
-@pytest.mark.asyncio
-async def test_echo_rejects_non_string():
-    with pytest.raises(ValueError):
-        await echo(None)  # type: ignore[arg-type]
-
-
-def test_summarize_includes_input_text():
-    out = summarize("long text here")
-    assert "long text here" in out
-    assert "Summarize" in out
+"""Smoke tests for echo tool and summarize prompt."""
+import pytest
+
+from src.prompts.summarize import summarize
+from src.tools.echo import echo
+
+
+@pytest.mark.asyncio
+async def test_echo_returns_input():
+    assert await echo("hello") == "hello"
+
+
+@pytest.mark.asyncio
+async def test_echo_rejects_empty():
+    with pytest.raises(ValueError):
+        await echo("")
+
+
+@pytest.mark.asyncio
+async def test_echo_rejects_non_string():
+    with pytest.raises(ValueError):
+        await echo(None)  # type: ignore[arg-type]
+
+
+def test_summarize_includes_input_text():
+    out = summarize("long text here")
+    assert "long text here" in out
+    assert "Summarize" in out

package/templates/stacks/mcp-rust/.dare/skills.yml

@@ -1,8 +1,8 @@
-version: 1
-skills:
-  - id: skill-mcp-server
-    source: skill-mcp-server
-    description: MCP server patterns (tools, prompts, transports)
-  - id: dare-ax
-    source: dare-ax
-    description: Agent eXperience invariants (llms.txt, OpenAPI, --json --list-tools, rate limit)
+version: 1
+skills:
+  - id: skill-mcp-server
+    source: skill-mcp-server
+    description: MCP server patterns (tools, prompts, transports)
+  - id: dare-ax
+    source: dare-ax
+    description: Agent eXperience invariants (llms.txt, OpenAPI, --json --list-tools, rate limit)

package/templates/stacks/mcp-rust/.env.example

@@ -1,14 +1,14 @@
-# MCP transport — overrides --transport flag if set
-# Valid: stdio | sse | http
-MCP_TRANSPORT=stdio
-
-# HTTP/SSE transport bind (ignored on stdio)
-MCP_HOST=0.0.0.0
-MCP_PORT=3001
-
-# Logging
-RUST_LOG=info
-
-# LLM provider (optional)
-LLM_PROVIDER=dummy
-# OPENAI_API_KEY=
+# MCP transport — overrides --transport flag if set
+# Valid: stdio | sse | http
+MCP_TRANSPORT=stdio
+
+# HTTP/SSE transport bind (ignored on stdio)
+MCP_HOST=0.0.0.0
+MCP_PORT=3001
+
+# Logging
+RUST_LOG=info
+
+# LLM provider (optional)
+LLM_PROVIDER=dummy
+# OPENAI_API_KEY=

package/templates/stacks/mcp-rust/.github/workflows/dare-ci.yml

@@ -1,38 +1,38 @@
-name: DARE CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  audit:
-    name: cargo audit
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo install cargo-audit --locked
-      - run: cargo audit --deny warnings
-
-  lint:
-    name: clippy
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          components: clippy
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo clippy --all-targets -- -D warnings
-
-  test:
-    name: cargo test
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo test
+name: DARE CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  audit:
+    name: cargo audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo install cargo-audit --locked
+      - run: cargo audit --deny warnings
+
+  lint:
+    name: clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo clippy --all-targets -- -D warnings
+
+  test:
+    name: cargo test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo test

package/templates/stacks/mcp-rust/Cargo.toml.tera

@@ -1,35 +1,35 @@
-[package]
-name = "{{ crateName }}"
-version = "0.1.0"
-edition = "2021"
-description = "DARE-shaped MCP server (Rust)"
-license = "MIT"
-
-[dependencies]
-# Official Rust MCP SDK. API still stabilizing — pin a rev if upstream breaks.
-rmcp = { version = "0.1", features = ["server", "transport-io"] }
-
-tokio = { version = "1", features = ["full"] }
-serde = { version = "1", features = ["derive"] }
-serde_json = "1"
-
-# HTTP/SSE transports
-axum = { version = "0.7", features = ["macros"] }
-tower-http = { version = "0.6", features = ["cors"] }
-
-# CLI args
-clap = { version = "4", features = ["derive", "env"] }
-
-# Logging
-tracing = "0.1"
-tracing-subscriber = { version = "0.3", features = ["env-filter"] }
-
-anyhow = "1"
-thiserror = "1"
-
-[dev-dependencies]
-tokio-test = "0.4"
-
-[[bin]]
-name = "{{ crateName }}"
-path = "src/main.rs"
+[package]
+name = "{{ crateName }}"
+version = "0.1.0"
+edition = "2021"
+description = "DARE-shaped MCP server (Rust)"
+license = "MIT"
+
+[dependencies]
+# Official Rust MCP SDK. API still stabilizing — pin a rev if upstream breaks.
+rmcp = { version = "0.1", features = ["server", "transport-io"] }
+
+tokio = { version = "1", features = ["full"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+
+# HTTP/SSE transports
+axum = { version = "0.7", features = ["macros"] }
+tower-http = { version = "0.6", features = ["cors"] }
+
+# CLI args
+clap = { version = "4", features = ["derive", "env"] }
+
+# Logging
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+
+anyhow = "1"
+thiserror = "1"
+
+[dev-dependencies]
+tokio-test = "0.4"
+
+[[bin]]
+name = "{{ crateName }}"
+path = "src/main.rs"

package/templates/stacks/mcp-rust/README.md.tera

@@ -1,50 +1,50 @@
-# {{ projectName }}
-
-DARE-shaped MCP server in Rust using the `rmcp` SDK.
-Default transport: **{{ defaultTransport }}**.
-
-> ⚠️ **Beta.** The `rmcp` SDK API is still stabilizing. Pin a specific version
-> or git rev in `Cargo.toml` if an upstream release breaks the build.
-
-## Setup
-
-```bash
-cp .env.example .env
-cargo build
-cargo run                    # uses {{ defaultTransport }} transport by default
-```
-
-## Test with MCP Inspector
-
-```bash
-npx @modelcontextprotocol/inspector cargo run
-```
-
-## Tools
-
-- `echo` — returns its input. Canonical smoke test.
-
-## Prompts
-
-- `summarize` — placeholder prompt template taking a `text` argument.
-
-## Transports
-
-Pick at runtime via `--transport stdio|sse|http` or `MCP_TRANSPORT`:
-
-| Transport | When to use |
-|---|---|
-| `stdio` (default) | Local CLI agents |
-| `sse`             | Web clients via SSE (axum) |
-| `http`            | Streamable HTTP (axum) |
-
-## Commands
-
-- `cargo run` — start server
-- `cargo test` — tests
-- `cargo clippy -- -D warnings` — lint
-- `cargo audit` — dependency audit
-
-## DARE Method
-
-See `.dare/skills.yml` and `llms.txt`.
+# {{ projectName }}
+
+DARE-shaped MCP server in Rust using the `rmcp` SDK.
+Default transport: **{{ defaultTransport }}**.
+
+> ⚠️ **Beta.** The `rmcp` SDK API is still stabilizing. Pin a specific version
+> or git rev in `Cargo.toml` if an upstream release breaks the build.
+
+## Setup
+
+```bash
+cp .env.example .env
+cargo build
+cargo run                    # uses {{ defaultTransport }} transport by default
+```
+
+## Test with MCP Inspector
+
+```bash
+npx @modelcontextprotocol/inspector cargo run
+```
+
+## Tools
+
+- `echo` — returns its input. Canonical smoke test.
+
+## Prompts
+
+- `summarize` — placeholder prompt template taking a `text` argument.
+
+## Transports
+
+Pick at runtime via `--transport stdio|sse|http` or `MCP_TRANSPORT`:
+
+| Transport | When to use |
+|---|---|
+| `stdio` (default) | Local CLI agents |
+| `sse`             | Web clients via SSE (axum) |
+| `http`            | Streamable HTTP (axum) |
+
+## Commands
+
+- `cargo run` — start server
+- `cargo test` — tests
+- `cargo clippy -- -D warnings` — lint
+- `cargo audit` — dependency audit
+
+## DARE Method
+
+See `.dare/skills.yml` and `llms.txt`.