@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/stacks/mcp-node-ts/tests/echo.test.ts

@@ -1,50 +1,50 @@
-import { describe, it, expect } from 'vitest';
-import { runEcho, echoTool } from '../src/tools/echo.js';
-import { TOOLS, callTool } from '../src/tools/index.js';
-import { PROMPTS, getPrompt } from '../src/prompts/index.js';
-
-describe('echo tool', () => {
-  it('is registered in TOOLS', () => {
-    expect(TOOLS).toContain(echoTool);
-  });
-
-  it('returns its input verbatim', async () => {
-    const out = await runEcho({ text: 'hello' });
-    expect(out).toBe('hello');
-  });
-
-  it('rejects empty text', async () => {
-    await expect(runEcho({ text: '' })).rejects.toThrow();
-  });
-
-  it('rejects missing text', async () => {
-    await expect(runEcho({})).rejects.toThrow();
-  });
-
-  it('callTool routes to echo', async () => {
-    const res = await callTool('echo', { text: 'hi' });
-    expect(res.content[0].text).toBe('hi');
-    expect(res.isError).toBeFalsy();
-  });
-
-  it('callTool returns isError for unknown tool', async () => {
-    const res = await callTool('unknown', {});
-    expect(res.isError).toBe(true);
-  });
-});
-
-describe('summarize prompt', () => {
-  it('is registered in PROMPTS', () => {
-    expect(PROMPTS.some((p) => p.name === 'summarize')).toBe(true);
-  });
-
-  it('returns a user message with the input text', async () => {
-    const res = await getPrompt('summarize', { text: 'long text here' });
-    expect(res.messages[0].role).toBe('user');
-    expect(res.messages[0].content.text).toContain('long text here');
-  });
-
-  it('throws on unknown prompt', async () => {
-    await expect(getPrompt('unknown', {})).rejects.toThrow();
-  });
-});
+import { describe, it, expect } from 'vitest';
+import { runEcho, echoTool } from '../src/tools/echo.js';
+import { TOOLS, callTool } from '../src/tools/index.js';
+import { PROMPTS, getPrompt } from '../src/prompts/index.js';
+
+describe('echo tool', () => {
+  it('is registered in TOOLS', () => {
+    expect(TOOLS).toContain(echoTool);
+  });
+
+  it('returns its input verbatim', async () => {
+    const out = await runEcho({ text: 'hello' });
+    expect(out).toBe('hello');
+  });
+
+  it('rejects empty text', async () => {
+    await expect(runEcho({ text: '' })).rejects.toThrow();
+  });
+
+  it('rejects missing text', async () => {
+    await expect(runEcho({})).rejects.toThrow();
+  });
+
+  it('callTool routes to echo', async () => {
+    const res = await callTool('echo', { text: 'hi' });
+    expect(res.content[0].text).toBe('hi');
+    expect(res.isError).toBeFalsy();
+  });
+
+  it('callTool returns isError for unknown tool', async () => {
+    const res = await callTool('unknown', {});
+    expect(res.isError).toBe(true);
+  });
+});
+
+describe('summarize prompt', () => {
+  it('is registered in PROMPTS', () => {
+    expect(PROMPTS.some((p) => p.name === 'summarize')).toBe(true);
+  });
+
+  it('returns a user message with the input text', async () => {
+    const res = await getPrompt('summarize', { text: 'long text here' });
+    expect(res.messages[0].role).toBe('user');
+    expect(res.messages[0].content.text).toContain('long text here');
+  });
+
+  it('throws on unknown prompt', async () => {
+    await expect(getPrompt('unknown', {})).rejects.toThrow();
+  });
+});

package/templates/stacks/mcp-node-ts/tsconfig.json

@@ -1,17 +1,17 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "tests"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

package/templates/stacks/mcp-python/.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-python/.env.example

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

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

@@ -1,42 +1,42 @@
-name: DARE CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  audit:
-    name: pip-audit
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-      - run: pip install pip-audit
-      - run: pip install -e ".[dev]"
-      - run: pip-audit --strict
-
-  lint:
-    name: ruff
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-      - run: pip install ruff
-      - run: ruff check .
-
-  test:
-    name: pytest
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-      - run: pip install -e ".[dev]"
-      - run: pytest
+name: DARE CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  audit:
+    name: pip-audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install pip-audit
+      - run: pip install -e ".[dev]"
+      - run: pip-audit --strict
+
+  lint:
+    name: ruff
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install ruff
+      - run: ruff check .
+
+  test:
+    name: pytest
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install -e ".[dev]"
+      - run: pytest

package/templates/stacks/mcp-python/README.md.j2

@@ -1,49 +1,49 @@
-# {{ projectName }}
-
-DARE-shaped MCP server in Python 3.11+ using the FastMCP API.
-Default transport: **{{ defaultTransport }}**.
-
-## Setup
-
-```bash
-cp .env.example .env
-python -m venv .venv
-source .venv/bin/activate    # or .venv\Scripts\activate on Windows
-pip install -e ".[dev]"
-python -m src.cli            # uses {{ defaultTransport }} transport by default
-```
-
-## Test with MCP Inspector
-
-```bash
-npx @modelcontextprotocol/inspector python -m src.cli
-```
-
-## Tools
-
-- `echo` — returns its input. Canonical smoke test.
-
-## Prompts
-
-- `summarize` — placeholder prompt template that takes a `text` argument.
-
-## Transports
-
-Pick at runtime via `--transport stdio|sse|http` or `MCP_TRANSPORT` env:
-
-| Transport | When to use |
-|---|---|
-| `stdio` (default) | Local CLI agents |
-| `sse`             | Web clients via Server-Sent Events |
-| `http`            | Streamable HTTP — newest MCP transport |
-
-## Commands
-
-- `python -m src.cli` — start server
-- `pytest` — run tests
-- `ruff check .` — lint
-- `pip-audit` — dependency audit
-
-## DARE Method
-
-See `.dare/skills.yml` and `llms.txt`.
+# {{ projectName }}
+
+DARE-shaped MCP server in Python 3.11+ using the FastMCP API.
+Default transport: **{{ defaultTransport }}**.
+
+## Setup
+
+```bash
+cp .env.example .env
+python -m venv .venv
+source .venv/bin/activate    # or .venv\Scripts\activate on Windows
+pip install -e ".[dev]"
+python -m src.cli            # uses {{ defaultTransport }} transport by default
+```
+
+## Test with MCP Inspector
+
+```bash
+npx @modelcontextprotocol/inspector python -m src.cli
+```
+
+## Tools
+
+- `echo` — returns its input. Canonical smoke test.
+
+## Prompts
+
+- `summarize` — placeholder prompt template that takes a `text` argument.
+
+## Transports
+
+Pick at runtime via `--transport stdio|sse|http` or `MCP_TRANSPORT` env:
+
+| Transport | When to use |
+|---|---|
+| `stdio` (default) | Local CLI agents |
+| `sse`             | Web clients via Server-Sent Events |
+| `http`            | Streamable HTTP — newest MCP transport |
+
+## Commands
+
+- `python -m src.cli` — start server
+- `pytest` — run tests
+- `ruff check .` — lint
+- `pip-audit` — dependency audit
+
+## DARE Method
+
+See `.dare/skills.yml` and `llms.txt`.

package/templates/stacks/mcp-python/gitignore

@@ -1,12 +1,12 @@
-__pycache__/
-*.py[cod]
-*$py.class
-.venv/
-.env
-.env.local
-.pytest_cache/
-.ruff_cache/
-.coverage
-dist/
-*.egg-info/
-.DS_Store
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+.env
+.env.local
+.pytest_cache/
+.ruff_cache/
+.coverage
+dist/
+*.egg-info/
+.DS_Store

package/templates/stacks/mcp-python/llms.txt.j2

@@ -1,56 +1,56 @@
-# {{ projectName }}
-
-DARE-shaped MCP server (Python 3.11+). Default transport: **{{ defaultTransport }}**.
-
-## Setup
-
-```bash
-cp .env.example .env
-python -m venv .venv
-source .venv/bin/activate
-pip install -e ".[dev]"
-python -m src.cli
-```
-
-## Commands
-
-- `python -m src.cli` — start server (transport via --transport or MCP_TRANSPORT env)
-- `pytest` — pytest suite
-- `ruff check .` — lint
-- `pip-audit` — dependency audit
-- `npx @modelcontextprotocol/inspector python -m src.cli` — MCP Inspector
-
-## Tools (registered in src/server.py via FastMCP)
-
-| Name | Input | Output | Description |
-|---|---|---|---|
-| `echo` | `text: str` | `str` | Returns input verbatim. Smoke test. |
-
-## Prompts
-
-| Name | Args | Description |
-|---|---|---|
-| `summarize` | `text` | Summarize the input text. Placeholder. |
-
-## Transports
-
-Choose with `--transport stdio|sse|http` or `MCP_TRANSPORT`:
-
-- `stdio` (default) — local agents. No port.
-- `sse` — SSE-over-HTTP on `MCP_PORT` (default 3001).
-- `http` — Streamable HTTP on `MCP_PORT` (default 3001).
-
-## Architecture
-
-- `src/server.py` — FastMCP instance, tools and prompts registered with @mcp.tool() / @mcp.prompt().
-- `src/cli.py` — argparse entrypoint, transport dispatch.
-- `src/transports/` — wrappers around mcp.run() calls for the 3 transports.
-- `src/tools/`, `src/prompts/` — module per tool/prompt for organization.
-
-## CLI inventory
-
-`python -m src.cli --json --list-tools` returns the tool registry as JSON (M-03).
-
-## DARE skills
-
-See `.dare/skills.yml`.
+# {{ projectName }}
+
+DARE-shaped MCP server (Python 3.11+). Default transport: **{{ defaultTransport }}**.
+
+## Setup
+
+```bash
+cp .env.example .env
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+python -m src.cli
+```
+
+## Commands
+
+- `python -m src.cli` — start server (transport via --transport or MCP_TRANSPORT env)
+- `pytest` — pytest suite
+- `ruff check .` — lint
+- `pip-audit` — dependency audit
+- `npx @modelcontextprotocol/inspector python -m src.cli` — MCP Inspector
+
+## Tools (registered in src/server.py via FastMCP)
+
+| Name | Input | Output | Description |
+|---|---|---|---|
+| `echo` | `text: str` | `str` | Returns input verbatim. Smoke test. |
+
+## Prompts
+
+| Name | Args | Description |
+|---|---|---|
+| `summarize` | `text` | Summarize the input text. Placeholder. |
+
+## Transports
+
+Choose with `--transport stdio|sse|http` or `MCP_TRANSPORT`:
+
+- `stdio` (default) — local agents. No port.
+- `sse` — SSE-over-HTTP on `MCP_PORT` (default 3001).
+- `http` — Streamable HTTP on `MCP_PORT` (default 3001).
+
+## Architecture
+
+- `src/server.py` — FastMCP instance, tools and prompts registered with @mcp.tool() / @mcp.prompt().
+- `src/cli.py` — argparse entrypoint, transport dispatch.
+- `src/transports/` — wrappers around mcp.run() calls for the 3 transports.
+- `src/tools/`, `src/prompts/` — module per tool/prompt for organization.
+
+## CLI inventory
+
+`python -m src.cli --json --list-tools` returns the tool registry as JSON (M-03).
+
+## DARE skills
+
+See `.dare/skills.yml`.

package/templates/stacks/mcp-python/openapi.json.j2

@@ -1,33 +1,33 @@
-{
-  "openapi": "3.1.0",
-  "info": {
-    "title": "{{ projectName }}",
-    "version": "0.1.0",
-    "description": "MCP server JSON-RPC surface. MCP is not REST; this describes the HTTP/SSE transport envelopes only."
-  },
-  "paths": {
-    "/sse": {
-      "get": {
-        "summary": "SSE event stream",
-        "responses": { "200": { "description": "text/event-stream with MCP JSON-RPC frames" } }
-      }
-    },
-    "/messages": {
-      "post": {
-        "summary": "MCP JSON-RPC message (HTTP / SSE post-back)",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": { "schema": { "type": "object" } }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "JSON-RPC 2.0 response",
-            "content": { "application/json": { "schema": { "type": "object" } } }
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "{{ projectName }}",
+    "version": "0.1.0",
+    "description": "MCP server JSON-RPC surface. MCP is not REST; this describes the HTTP/SSE transport envelopes only."
+  },
+  "paths": {
+    "/sse": {
+      "get": {
+        "summary": "SSE event stream",
+        "responses": { "200": { "description": "text/event-stream with MCP JSON-RPC frames" } }
+      }
+    },
+    "/messages": {
+      "post": {
+        "summary": "MCP JSON-RPC message (HTTP / SSE post-back)",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": { "schema": { "type": "object" } }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "JSON-RPC 2.0 response",
+            "content": { "application/json": { "schema": { "type": "object" } } }
+          }
+        }
+      }
+    }
+  }
+}

package/templates/stacks/mcp-python/pyproject.toml.j2

@@ -1,37 +1,37 @@
-[project]
-name = "{{ projectName }}"
-version = "0.1.0"
-description = "DARE-shaped MCP server (Python)"
-requires-python = ">=3.11"
-dependencies = [
-    "mcp[cli]>=1.0.0,<2.0",
-]
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=8.2,<9.0",
-    "pytest-asyncio>=0.23,<1.0",
-    "ruff>=0.5,<1.0",
-    "pip-audit>=2.7,<3.0",
-]
-
-[project.scripts]
-{{ projectModule }} = "src.cli:main"
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src"]
-
-[tool.ruff]
-line-length = 100
-target-version = "py311"
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "B", "UP"]
-ignore = ["E501"]
-
-[tool.pytest.ini_options]
-asyncio_mode = "auto"
+[project]
+name = "{{ projectName }}"
+version = "0.1.0"
+description = "DARE-shaped MCP server (Python)"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp[cli]>=1.0.0,<2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.2,<9.0",
+    "pytest-asyncio>=0.23,<1.0",
+    "ruff>=0.5,<1.0",
+    "pip-audit>=2.7,<3.0",
+]
+
+[project.scripts]
+{{ projectModule }} = "src.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"