@dewtech/dare-cli 3.3.0 → 3.5.0

package/templates/stacks/go-stdlib/llms.txt.tpl

@@ -1,60 +1,60 @@
-# {{projectName}}
-
-DARE-shaped Go API on **net/http stdlib** (no framework). Layered Design.
-
-## Setup
-
-```bash
-cp .env.example .env
-docker compose up -d postgres
-go mod tidy
-sqlc generate
-go run ./cmd/server
-```
-
-## Commands
-
-- `go run ./cmd/server` — dev server (port 8000)
-- `go test ./...` — tests
-- `golangci-lint run` — lint
-- `govulncheck ./...` — vuln scan
-- `sqlc generate` — regenerate type-safe DB code from db/queries/*.sql
-
-## Endpoints
-
-| Method | Path | Auth | Description |
-|---|---|---|---|
-| POST | `/auth/login` | none | Exchange email+password for JWT |
-| GET | `/auth/me` | Bearer | Current user |
-| GET | `/users` | Bearer | List (query: page, limit) |
-| POST | `/users` | Bearer (admin) | Create user |
-| GET | `/ws` | upgrade | WebSocket echo |
-| GET | `/openapi.json` | none | OpenAPI document |
-
-## Layered Design
-
-- `internal/handler/` — HTTP layer (net/http handlers)
-- `internal/service/` — business logic
-- `internal/repository/` — pgx queries (sqlc-compatible)
-- `internal/model/` — domain structs
-- `internal/middleware/` — JWT + rate limit + CORS + chain helper
-- `internal/llm/` — provider abstraction
-- `internal/httpx/` — JSON helpers (encode/decode)
-
-Handlers never call pgx directly.
-
-## Why net/http stdlib?
-
-Go 1.22 added method+pattern routing to `http.ServeMux`:
-`mux.HandleFunc("POST /auth/login", h.Login)`. That covers 80% of what
-Gin / Echo / Chi were used for, with zero deps. Frameworks only buy
-nicer middleware DX and a slightly faster path tree — both replaceable
-with the helpers in `internal/middleware/`.
-
-## Env vars
-
-See `.env.example`. Required: `DATABASE_URL`, `JWT_SECRET`.
-
-## DARE skills
-
-See `.dare/skills.yml`.
+# {{projectName}}
+
+DARE-shaped Go API on **net/http stdlib** (no framework). Layered Design.
+
+## Setup
+
+```bash
+cp .env.example .env
+docker compose up -d postgres
+go mod tidy
+sqlc generate
+go run ./cmd/server
+```
+
+## Commands
+
+- `go run ./cmd/server` — dev server (port 8000)
+- `go test ./...` — tests
+- `golangci-lint run` — lint
+- `govulncheck ./...` — vuln scan
+- `sqlc generate` — regenerate type-safe DB code from db/queries/*.sql
+
+## Endpoints
+
+| Method | Path | Auth | Description |
+|---|---|---|---|
+| POST | `/auth/login` | none | Exchange email+password for JWT |
+| GET | `/auth/me` | Bearer | Current user |
+| GET | `/users` | Bearer | List (query: page, limit) |
+| POST | `/users` | Bearer (admin) | Create user |
+| GET | `/ws` | upgrade | WebSocket echo |
+| GET | `/openapi.json` | none | OpenAPI document |
+
+## Layered Design
+
+- `internal/handler/` — HTTP layer (net/http handlers)
+- `internal/service/` — business logic
+- `internal/repository/` — pgx queries (sqlc-compatible)
+- `internal/model/` — domain structs
+- `internal/middleware/` — JWT + rate limit + CORS + chain helper
+- `internal/llm/` — provider abstraction
+- `internal/httpx/` — JSON helpers (encode/decode)
+
+Handlers never call pgx directly.
+
+## Why net/http stdlib?
+
+Go 1.22 added method+pattern routing to `http.ServeMux`:
+`mux.HandleFunc("POST /auth/login", h.Login)`. That covers 80% of what
+Gin / Echo / Chi were used for, with zero deps. Frameworks only buy
+nicer middleware DX and a slightly faster path tree — both replaceable
+with the helpers in `internal/middleware/`.
+
+## Env vars
+
+See `.env.example`. Required: `DATABASE_URL`, `JWT_SECRET`.
+
+## DARE skills
+
+See `.dare/skills.yml`.

package/templates/stacks/go-stdlib/openapi.json.tpl

@@ -1,46 +1,46 @@
-{
-  "openapi": "3.0.3",
-  "info": {
-    "title": "{{projectName}}",
-    "version": "0.1.0",
-    "description": "DARE-shaped Go API on net/http stdlib."
-  },
-  "paths": {
-    "/auth/login": {
-      "post": {
-        "summary": "Exchange email+password for JWT",
-        "responses": { "200": { "description": "JWT issued" }, "401": { "description": "Invalid credentials" } }
-      }
-    },
-    "/auth/me": {
-      "get": {
-        "summary": "Current user",
-        "security": [{ "bearer": [] }],
-        "responses": { "200": { "description": "User" }, "401": { "description": "Unauthorized" } }
-      }
-    },
-    "/users": {
-      "get": {
-        "summary": "List users",
-        "security": [{ "bearer": [] }],
-        "responses": { "200": { "description": "Page of users" } }
-      },
-      "post": {
-        "summary": "Create user (admin)",
-        "security": [{ "bearer": [] }],
-        "responses": { "201": { "description": "Created" }, "403": { "description": "Forbidden" } }
-      }
-    },
-    "/ws": {
-      "get": {
-        "summary": "WebSocket echo",
-        "responses": { "101": { "description": "Switching Protocols" } }
-      }
-    }
-  },
-  "components": {
-    "securitySchemes": {
-      "bearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" }
-    }
-  }
-}
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "{{projectName}}",
+    "version": "0.1.0",
+    "description": "DARE-shaped Go API on net/http stdlib."
+  },
+  "paths": {
+    "/auth/login": {
+      "post": {
+        "summary": "Exchange email+password for JWT",
+        "responses": { "200": { "description": "JWT issued" }, "401": { "description": "Invalid credentials" } }
+      }
+    },
+    "/auth/me": {
+      "get": {
+        "summary": "Current user",
+        "security": [{ "bearer": [] }],
+        "responses": { "200": { "description": "User" }, "401": { "description": "Unauthorized" } }
+      }
+    },
+    "/users": {
+      "get": {
+        "summary": "List users",
+        "security": [{ "bearer": [] }],
+        "responses": { "200": { "description": "Page of users" } }
+      },
+      "post": {
+        "summary": "Create user (admin)",
+        "security": [{ "bearer": [] }],
+        "responses": { "201": { "description": "Created" }, "403": { "description": "Forbidden" } }
+      }
+    },
+    "/ws": {
+      "get": {
+        "summary": "WebSocket echo",
+        "responses": { "101": { "description": "Switching Protocols" } }
+      }
+    }
+  },
+  "components": {
+    "securitySchemes": {
+      "bearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" }
+    }
+  }
+}

package/templates/stacks/go-stdlib/sqlc.yaml

@@ -1,14 +1,14 @@
-version: "2"
-sql:
-  - engine: "postgresql"
-    queries: "db/queries"
-    schema: "db/migrations"
-    gen:
-      go:
-        package: "sqlcgen"
-        out: "internal/repository/sqlcgen"
-        sql_package: "pgx/v5"
-        emit_json_tags: true
-        emit_prepared_queries: false
-        emit_interface: false
-        emit_exact_table_names: false
+version: "2"
+sql:
+  - engine: "postgresql"
+    queries: "db/queries"
+    schema: "db/migrations"
+    gen:
+      go:
+        package: "sqlcgen"
+        out: "internal/repository/sqlcgen"
+        sql_package: "pgx/v5"
+        emit_json_tags: true
+        emit_prepared_queries: false
+        emit_interface: false
+        emit_exact_table_names: false

package/templates/stacks/go-stdlib/tests/smoke_test.go.tpl

@@ -1,45 +1,45 @@
-// Smoke tests — exercise pure helpers without a DB.
-package tests
-
-import (
-	"net/http"
-	"net/http/httptest"
-	"os"
-	"testing"
-
-	"github.com/stretchr/testify/require"
-
-	"{{moduleName}}/internal/config"
-	"{{moduleName}}/internal/middleware"
-)
-
-func TestConfigFromEnvDefaultsAreSane(t *testing.T) {
-	t.Setenv("DATABASE_URL", "postgres://u:p@localhost:5432/x?sslmode=disable")
-	os.Unsetenv("APP_PORT")
-	cfg, err := config.FromEnv()
-	require.NoError(t, err)
-	require.Equal(t, 8000, cfg.AppPort)
-	require.GreaterOrEqual(t, cfg.RateLimitBurst, cfg.RateLimitPerSec)
-}
-
-func TestRateLimitBlocksAfterBurst(t *testing.T) {
-	mw := middleware.RateLimit(1, 2)
-	h := mw(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
-		w.WriteHeader(http.StatusOK)
-	}))
-
-	// First 2 (burst) should pass.
-	for i := 0; i < 2; i++ {
-		rec := httptest.NewRecorder()
-		req := httptest.NewRequest(http.MethodGet, "/", nil)
-		req.RemoteAddr = "10.0.0.1:1234"
-		h.ServeHTTP(rec, req)
-		require.Equal(t, http.StatusOK, rec.Code)
-	}
-	// 3rd should be 429.
-	rec := httptest.NewRecorder()
-	req := httptest.NewRequest(http.MethodGet, "/", nil)
-	req.RemoteAddr = "10.0.0.1:1234"
-	h.ServeHTTP(rec, req)
-	require.Equal(t, http.StatusTooManyRequests, rec.Code)
-}
+// Smoke tests — exercise pure helpers without a DB.
+package tests
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"{{moduleName}}/internal/config"
+	"{{moduleName}}/internal/middleware"
+)
+
+func TestConfigFromEnvDefaultsAreSane(t *testing.T) {
+	t.Setenv("DATABASE_URL", "postgres://u:p@localhost:5432/x?sslmode=disable")
+	os.Unsetenv("APP_PORT")
+	cfg, err := config.FromEnv()
+	require.NoError(t, err)
+	require.Equal(t, 8000, cfg.AppPort)
+	require.GreaterOrEqual(t, cfg.RateLimitBurst, cfg.RateLimitPerSec)
+}
+
+func TestRateLimitBlocksAfterBurst(t *testing.T) {
+	mw := middleware.RateLimit(1, 2)
+	h := mw(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
+		w.WriteHeader(http.StatusOK)
+	}))
+
+	// First 2 (burst) should pass.
+	for i := 0; i < 2; i++ {
+		rec := httptest.NewRecorder()
+		req := httptest.NewRequest(http.MethodGet, "/", nil)
+		req.RemoteAddr = "10.0.0.1:1234"
+		h.ServeHTTP(rec, req)
+		require.Equal(t, http.StatusOK, rec.Code)
+	}
+	// 3rd should be 429.
+	rec := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/", nil)
+	req.RemoteAddr = "10.0.0.1:1234"
+	h.ServeHTTP(rec, req)
+	require.Equal(t, http.StatusTooManyRequests, rec.Code)
+}

package/templates/stacks/mcp-go/.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-go/.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
-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 bind (ignored on stdio)
+MCP_HOST=0.0.0.0
+MCP_PORT=3001
+
+# Logging
+LOG_LEVEL=info
+
+# LLM provider (optional)
+LLM_PROVIDER=dummy
+# OPENAI_API_KEY=

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

@@ -1,42 +1,42 @@
-name: DARE CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  audit:
-    name: govulncheck
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
-        with:
-          go-version: "1.22"
-      - run: go install golang.org/x/vuln/cmd/govulncheck@latest
-      - run: govulncheck ./...
-
-  lint:
-    name: golangci-lint
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
-        with:
-          go-version: "1.22"
-      - uses: golangci/golangci-lint-action@v6
-        with:
-          version: v1.61
-
-  test:
-    name: go test
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
-        with:
-          go-version: "1.22"
-      - run: go mod download
-      - run: go test ./...
+name: DARE CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  audit:
+    name: govulncheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.22"
+      - run: go install golang.org/x/vuln/cmd/govulncheck@latest
+      - run: govulncheck ./...
+
+  lint:
+    name: golangci-lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.22"
+      - uses: golangci/golangci-lint-action@v6
+        with:
+          version: v1.61
+
+  test:
+    name: go test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.22"
+      - run: go mod download
+      - run: go test ./...

package/templates/stacks/mcp-go/README.md.tpl

@@ -1,50 +1,50 @@
-# {{projectName}}
-
-DARE-shaped MCP server in Go using `mark3labs/mcp-go`.
-Default transport: **{{defaultTransport}}**.
-
-> ⚠️ **Beta.** `mark3labs/mcp-go` is the community Go SDK. Migrate to an
-> official Anthropic Go SDK if/when one ships.
-
-## Setup
-
-```bash
-cp .env.example .env
-go mod tidy
-go run ./cmd/server          # uses {{defaultTransport}} transport by default
-```
-
-## Test with MCP Inspector
-
-```bash
-npx @modelcontextprotocol/inspector go run ./cmd/server
-```
-
-## 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 |
-| `http`            | Streamable HTTP |
-
-## Commands
-
-- `go run ./cmd/server` — start server
-- `go test ./...` — tests
-- `golangci-lint run` — lint
-- `govulncheck ./...` — vuln scan
-
-## DARE Method
-
-See `.dare/skills.yml` and `llms.txt`.
+# {{projectName}}
+
+DARE-shaped MCP server in Go using `mark3labs/mcp-go`.
+Default transport: **{{defaultTransport}}**.
+
+> ⚠️ **Beta.** `mark3labs/mcp-go` is the community Go SDK. Migrate to an
+> official Anthropic Go SDK if/when one ships.
+
+## Setup
+
+```bash
+cp .env.example .env
+go mod tidy
+go run ./cmd/server          # uses {{defaultTransport}} transport by default
+```
+
+## Test with MCP Inspector
+
+```bash
+npx @modelcontextprotocol/inspector go run ./cmd/server
+```
+
+## 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 |
+| `http`            | Streamable HTTP |
+
+## Commands
+
+- `go run ./cmd/server` — start server
+- `go test ./...` — tests
+- `golangci-lint run` — lint
+- `govulncheck ./...` — vuln scan
+
+## DARE Method
+
+See `.dare/skills.yml` and `llms.txt`.