@dewtech/dare-cli 3.3.0 → 3.5.0

package/templates/stacks/mcp-go/tests/echo_test.go.tpl

@@ -1,37 +1,37 @@
-// Smoke tests — pure tools/prompts, no SDK or transport needed.
-package tests
-
-import (
-	"testing"
-
-	"github.com/stretchr/testify/require"
-
-	"{{moduleName}}/internal/prompts"
-	"{{moduleName}}/internal/server"
-	"{{moduleName}}/internal/tools"
-)
-
-func TestEchoReturnsInput(t *testing.T) {
-	out, err := tools.Echo("hello")
-	require.NoError(t, err)
-	require.Equal(t, "hello", out)
-}
-
-func TestEchoRejectsEmpty(t *testing.T) {
-	_, err := tools.Echo("")
-	require.ErrorIs(t, err, tools.ErrEmpty)
-}
-
-func TestSummarizeIncludesInput(t *testing.T) {
-	out := prompts.Summarize("long text here")
-	require.Contains(t, out, "long text here")
-	require.Contains(t, out, "Summarize")
-}
-
-func TestInventoryListsEcho(t *testing.T) {
-	inv := server.InventoryJSON()
-	toolsList, ok := inv["tools"].([]map[string]any)
-	require.True(t, ok)
-	require.NotEmpty(t, toolsList)
-	require.Equal(t, "echo", toolsList[0]["name"])
-}
+// Smoke tests — pure tools/prompts, no SDK or transport needed.
+package tests
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"{{moduleName}}/internal/prompts"
+	"{{moduleName}}/internal/server"
+	"{{moduleName}}/internal/tools"
+)
+
+func TestEchoReturnsInput(t *testing.T) {
+	out, err := tools.Echo("hello")
+	require.NoError(t, err)
+	require.Equal(t, "hello", out)
+}
+
+func TestEchoRejectsEmpty(t *testing.T) {
+	_, err := tools.Echo("")
+	require.ErrorIs(t, err, tools.ErrEmpty)
+}
+
+func TestSummarizeIncludesInput(t *testing.T) {
+	out := prompts.Summarize("long text here")
+	require.Contains(t, out, "long text here")
+	require.Contains(t, out, "Summarize")
+}
+
+func TestInventoryListsEcho(t *testing.T) {
+	inv := server.InventoryJSON()
+	toolsList, ok := inv["tools"].([]map[string]any)
+	require.True(t, ok)
+	require.NotEmpty(t, toolsList)
+	require.Equal(t, "echo", toolsList[0]["name"])
+}

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

@@ -1,16 +1,16 @@
-# MCP transport — overrides --transport flag if set
-# Valid: stdio | sse | http
-MCP_TRANSPORT=stdio
-
-# HTTP/SSE transport port (ignored on stdio)
-MCP_PORT=3001
-
-# Rate limit (HTTP/SSE only — stdio is single-client local)
-RATE_LIMIT_RPM=120
-
-# Logging
-LOG_LEVEL=info
-
-# LLM provider (optional — for tools that call out)
-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
+
+# Rate limit (HTTP/SSE only — stdio is single-client local)
+RATE_LIMIT_RPM=120
+
+# Logging
+LOG_LEVEL=info
+
+# LLM provider (optional — for tools that call out)
+LLM_PROVIDER=dummy
+# OPENAI_API_KEY=

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

@@ -1,54 +1,54 @@
-name: DARE CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  audit:
-    name: Audit dependencies
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v3
-        with:
-          version: 9
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm audit --audit-level=high
-
-  lint:
-    name: Lint
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v3
-        with:
-          version: 9
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm lint
-
-  test:
-    name: Test
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v3
-        with:
-          version: 9
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm build
-      - run: pnpm test
+name: DARE CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  audit:
+    name: Audit dependencies
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm audit --audit-level=high
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm lint
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+      - run: pnpm test

package/templates/stacks/mcp-node-ts/README.md.hbs

@@ -1,49 +1,49 @@
-# {{projectName}}
-
-DARE-shaped MCP (Model Context Protocol) server in TypeScript.
-Default transport: **{{defaultTransport}}**.
-
-## Setup
-
-```bash
-cp .env.example .env
-pnpm install
-pnpm build
-pnpm start                # uses {{defaultTransport}} transport (default)
-```
-
-## Test it with MCP Inspector
-
-```bash
-pnpm inspect              # spawns the server + opens the inspector UI
-```
-
-## Tools
-
-- `echo` — returns its input. The canonical smoke test for an MCP server.
-
-## Prompts
-
-- `summarize` — placeholder prompt template that takes a `{text}` variable.
-
-## Transports
-
-Pick at runtime via `--transport stdio|sse|http` or `MCP_TRANSPORT` env:
-
-| Transport | When to use |
-|---|---|
-| `stdio` (default) | Local CLI agents (Claude Code, Cursor, etc.) |
-| `sse`             | Web clients via Server-Sent Events |
-| `http`            | Streamable HTTP — newest MCP transport |
-
-## Commands
-
-- `pnpm dev` — watch mode via tsx
-- `pnpm build` — TypeScript → `dist/`
-- `pnpm test` — vitest
-- `pnpm lint` — ESLint
-- `pnpm audit` — `pnpm audit --audit-level=high`
-
-## DARE Method
-
-See `.dare/skills.yml` and `llms.txt`.
+# {{projectName}}
+
+DARE-shaped MCP (Model Context Protocol) server in TypeScript.
+Default transport: **{{defaultTransport}}**.
+
+## Setup
+
+```bash
+cp .env.example .env
+pnpm install
+pnpm build
+pnpm start                # uses {{defaultTransport}} transport (default)
+```
+
+## Test it with MCP Inspector
+
+```bash
+pnpm inspect              # spawns the server + opens the inspector UI
+```
+
+## Tools
+
+- `echo` — returns its input. The canonical smoke test for an MCP server.
+
+## Prompts
+
+- `summarize` — placeholder prompt template that takes a `{text}` variable.
+
+## Transports
+
+Pick at runtime via `--transport stdio|sse|http` or `MCP_TRANSPORT` env:
+
+| Transport | When to use |
+|---|---|
+| `stdio` (default) | Local CLI agents (Claude Code, Cursor, etc.) |
+| `sse`             | Web clients via Server-Sent Events |
+| `http`            | Streamable HTTP — newest MCP transport |
+
+## Commands
+
+- `pnpm dev` — watch mode via tsx
+- `pnpm build` — TypeScript → `dist/`
+- `pnpm test` — vitest
+- `pnpm lint` — ESLint
+- `pnpm audit` — `pnpm audit --audit-level=high`
+
+## DARE Method
+
+See `.dare/skills.yml` and `llms.txt`.

package/templates/stacks/mcp-node-ts/gitignore

@@ -1,7 +1,7 @@
-node_modules
-dist
-coverage
-.env
-.env.local
-*.log
-.DS_Store
+node_modules
+dist
+coverage
+.env
+.env.local
+*.log
+.DS_Store

package/templates/stacks/mcp-node-ts/llms.txt.hbs

@@ -1,61 +1,61 @@
-# {{projectName}}
-
-DARE-shaped MCP server (TypeScript). Default transport: **{{defaultTransport}}**.
-
-## Setup
-
-```bash
-cp .env.example .env
-pnpm install
-pnpm build
-pnpm start
-```
-
-## Commands
-
-- `pnpm dev` — tsx watch
-- `pnpm build` — tsc to dist/
-- `pnpm test` — vitest
-- `pnpm lint` — ESLint
-- `pnpm audit` — pnpm audit --audit-level=high
-- `pnpm inspect` — MCP Inspector for the running server
-
-## Tools (registered in src/tools/)
-
-| Name | Input | Output | Description |
-|---|---|---|---|
-| `echo` | `{ text: string }` | `{ text: string }` | Returns input verbatim. Smoke test. |
-
-## Prompts (registered in src/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. 1 client at a time.
-- `sse` — SSE-over-HTTP on `MCP_PORT` (default 3001).
-- `http` — Streamable HTTP on `MCP_PORT` (default 3001). Modern MCP HTTP.
-
-## Architecture
-
-- `src/server.ts` — MCP `Server` instance, tools and prompts registered here.
-- `src/cli.ts` — entrypoint. Resolves transport from CLI flag or env.
-- `src/transports/{stdio,sse,http}.ts` — one factory per transport.
-- `src/tools/`, `src/prompts/` — registries the server reads from.
-
-## Env vars
-
-See `.env.example`. None are required for stdio.
-
-## CLI inventory
-
-`node dist/cli.js --json --list-tools` returns the tool registry as JSON
-(M-03 — Agent eXperience).
-
-## DARE skills
-
-See `.dare/skills.yml`.
+# {{projectName}}
+
+DARE-shaped MCP server (TypeScript). Default transport: **{{defaultTransport}}**.
+
+## Setup
+
+```bash
+cp .env.example .env
+pnpm install
+pnpm build
+pnpm start
+```
+
+## Commands
+
+- `pnpm dev` — tsx watch
+- `pnpm build` — tsc to dist/
+- `pnpm test` — vitest
+- `pnpm lint` — ESLint
+- `pnpm audit` — pnpm audit --audit-level=high
+- `pnpm inspect` — MCP Inspector for the running server
+
+## Tools (registered in src/tools/)
+
+| Name | Input | Output | Description |
+|---|---|---|---|
+| `echo` | `{ text: string }` | `{ text: string }` | Returns input verbatim. Smoke test. |
+
+## Prompts (registered in src/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. 1 client at a time.
+- `sse` — SSE-over-HTTP on `MCP_PORT` (default 3001).
+- `http` — Streamable HTTP on `MCP_PORT` (default 3001). Modern MCP HTTP.
+
+## Architecture
+
+- `src/server.ts` — MCP `Server` instance, tools and prompts registered here.
+- `src/cli.ts` — entrypoint. Resolves transport from CLI flag or env.
+- `src/transports/{stdio,sse,http}.ts` — one factory per transport.
+- `src/tools/`, `src/prompts/` — registries the server reads from.
+
+## Env vars
+
+See `.env.example`. None are required for stdio.
+
+## CLI inventory
+
+`node dist/cli.js --json --list-tools` returns the tool registry as JSON
+(M-03 — Agent eXperience).
+
+## DARE skills
+
+See `.dare/skills.yml`.

package/templates/stacks/mcp-node-ts/openapi.json.hbs

@@ -1,39 +1,39 @@
-{
-  "openapi": "3.1.0",
-  "info": {
-    "title": "{{projectName}}",
-    "version": "0.1.0",
-    "description": "MCP server JSON-RPC surface. MCP itself is not a REST API; this document describes the HTTP/SSE transport envelope. Stdio transport is out of band."
-  },
-  "paths": {
-    "/mcp/v1/sse": {
-      "get": {
-        "summary": "MCP SSE transport — long-lived event stream",
-        "responses": {
-          "200": { "description": "text/event-stream with MCP JSON-RPC frames" }
-        }
-      }
-    },
-    "/mcp/v1/messages": {
-      "post": {
-        "summary": "MCP JSON-RPC message (HTTP transport)",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": { "type": "object", "description": "JSON-RPC 2.0 request" }
-            }
-          }
-        },
-        "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 itself is not a REST API; this document describes the HTTP/SSE transport envelope. Stdio transport is out of band."
+  },
+  "paths": {
+    "/mcp/v1/sse": {
+      "get": {
+        "summary": "MCP SSE transport — long-lived event stream",
+        "responses": {
+          "200": { "description": "text/event-stream with MCP JSON-RPC frames" }
+        }
+      }
+    },
+    "/mcp/v1/messages": {
+      "post": {
+        "summary": "MCP JSON-RPC message (HTTP transport)",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": { "type": "object", "description": "JSON-RPC 2.0 request" }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "JSON-RPC 2.0 response",
+            "content": {
+              "application/json": { "schema": { "type": "object" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -1,35 +1,35 @@
-{
-  "name": "{{projectName}}",
-  "version": "0.1.0",
-  "private": true,
-  "description": "DARE-shaped MCP server (Node.js / TypeScript)",
-  "type": "module",
-  "bin": {
-    "{{projectName}}": "dist/cli.js"
-  },
-  "main": "dist/server.js",
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/cli.js",
-    "dev": "tsx watch src/cli.ts",
-    "test": "vitest run",
-    "lint": "eslint src --ext .ts",
-    "audit": "pnpm audit --audit-level=high",
-    "inspect": "npx @modelcontextprotocol/inspector node dist/cli.js"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "express": "^4.21.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.0",
-    "@types/node": "^20.11.0",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.57.0",
-    "tsx": "^4.16.0",
-    "typescript": "^5.4.5",
-    "vitest": "^1.6.0"
-  }
-}
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "description": "DARE-shaped MCP server (Node.js / TypeScript)",
+  "type": "module",
+  "bin": {
+    "{{projectName}}": "dist/cli.js"
+  },
+  "main": "dist/server.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "dev": "tsx watch src/cli.ts",
+    "test": "vitest run",
+    "lint": "eslint src --ext .ts",
+    "audit": "pnpm audit --audit-level=high",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/cli.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "express": "^4.21.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.0",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  }
+}