@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/stacks/python-fastapi/.dare/skills.yml

@@ -1,11 +1,11 @@
-version: 1
-skills:
-  - id: skill-fastapi-api
-    source: skill-fastapi-api
-    description: FastAPI Layered Design + Pydantic v2 + SQLAlchemy 2.0 + Alembic
-  - id: dare-ax
-    source: dare-ax
-    description: Agent eXperience invariants (llms.txt, OpenAPI, --json, rate limit)
-  - id: dare-layered-design
-    source: dare-layered-design
-    description: Router → Service → Repository → Model 4-layer architecture
+version: 1
+skills:
+  - id: skill-fastapi-api
+    source: skill-fastapi-api
+    description: FastAPI Layered Design + Pydantic v2 + SQLAlchemy 2.0 + Alembic
+  - id: dare-ax
+    source: dare-ax
+    description: Agent eXperience invariants (llms.txt, OpenAPI, --json, rate limit)
+  - id: dare-layered-design
+    source: dare-layered-design
+    description: Router → Service → Repository → Model 4-layer architecture

package/templates/stacks/python-fastapi/.env.example

@@ -1,21 +1,21 @@
-# Application
-APP_PORT=8000
-LOG_LEVEL=info
-
-# Database
-DATABASE_URL=postgresql+psycopg://user:pass@localhost:5432/myapi
-
-# JWT auth
-JWT_SECRET=replace-me-in-prod
-JWT_ALGORITHM=HS256
-JWT_EXPIRES_MIN=15
-
-# Password hashing
-BCRYPT_ROUNDS=12
-
-# Rate limit
-RATE_LIMIT_PER_MIN=60
-
-# LLM provider (optional)
-# LLM_PROVIDER=dummy
-# OPENAI_API_KEY=
+# Application
+APP_PORT=8000
+LOG_LEVEL=info
+
+# Database
+DATABASE_URL=postgresql+psycopg://user:pass@localhost:5432/myapi
+
+# JWT auth
+JWT_SECRET=replace-me-in-prod
+JWT_ALGORITHM=HS256
+JWT_EXPIRES_MIN=15
+
+# Password hashing
+BCRYPT_ROUNDS=12
+
+# Rate limit
+RATE_LIMIT_PER_MIN=60
+
+# LLM provider (optional)
+# LLM_PROVIDER=dummy
+# OPENAI_API_KEY=

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

@@ -1,43 +1,43 @@
-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: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-      - run: pip install pip-audit
-      - run: pip-audit --strict --requirement <(pip install -e ".[dev]" --dry-run --quiet --report -)
-        shell: bash
-        continue-on-error: false
-
-  lint:
-    name: Lint
-    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: Test
-    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: Audit dependencies
+    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-audit --strict --requirement <(pip install -e ".[dev]" --dry-run --quiet --report -)
+        shell: bash
+        continue-on-error: false
+
+  lint:
+    name: Lint
+    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: Test
+    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/python-fastapi/README.md.j2

@@ -1,35 +1,35 @@
-# {{ projectName }}
-
-DARE-shaped FastAPI API. Layered Design (Router → Service → Repository → Model).
-
-## Setup
-
-```bash
-cp .env.example .env
-docker compose up -d postgres
-python -m venv .venv
-source .venv/bin/activate    # or .venv\Scripts\activate on Windows
-pip install -e ".[dev]"
-alembic upgrade head
-uvicorn app.main:app --reload
-```
-
-## Endpoints
-
-- `POST /auth/login` — exchange email/password for JWT
-- `GET /auth/me` — current user (Bearer JWT)
-- `GET /users` — list users (paginated)
-- `POST /users` — create user (admin only)
-- `GET /openapi.json` — OpenAPI 3.1 surface
-- `GET /docs` — Swagger UI
-
-## Commands
-
-- `uvicorn app.main:app --reload` — dev server (port 8000)
-- `pytest` — run tests
-- `ruff check .` — lint
-- `pip-audit` — dependency audit
-
-## DARE Method
-
-See `.dare/skills.yml` for installed skills, `llms.txt` for agent context.
+# {{ projectName }}
+
+DARE-shaped FastAPI API. Layered Design (Router → Service → Repository → Model).
+
+## Setup
+
+```bash
+cp .env.example .env
+docker compose up -d postgres
+python -m venv .venv
+source .venv/bin/activate    # or .venv\Scripts\activate on Windows
+pip install -e ".[dev]"
+alembic upgrade head
+uvicorn app.main:app --reload
+```
+
+## Endpoints
+
+- `POST /auth/login` — exchange email/password for JWT
+- `GET /auth/me` — current user (Bearer JWT)
+- `GET /users` — list users (paginated)
+- `POST /users` — create user (admin only)
+- `GET /openapi.json` — OpenAPI 3.1 surface
+- `GET /docs` — Swagger UI
+
+## Commands
+
+- `uvicorn app.main:app --reload` — dev server (port 8000)
+- `pytest` — run tests
+- `ruff check .` — lint
+- `pip-audit` — dependency audit
+
+## DARE Method
+
+See `.dare/skills.yml` for installed skills, `llms.txt` for agent context.

package/templates/stacks/python-fastapi/alembic/env.py

@@ -1,46 +1,46 @@
-"""Alembic env — reads DATABASE_URL from settings, uses our Base metadata."""
-from logging.config import fileConfig
-
-from alembic import context
-from sqlalchemy import engine_from_config, pool
-
-from app.core.config import settings
-from app.db.session import Base
-from app.models import User  # noqa: F401  ensure metadata is populated
-
-config = context.config
-config.set_main_option("sqlalchemy.url", settings.database_url)
-
-if config.config_file_name is not None:
-    fileConfig(config.config_file_name)
-
-target_metadata = Base.metadata
-
-
-def run_migrations_offline() -> None:
-    context.configure(
-        url=config.get_main_option("sqlalchemy.url"),
-        target_metadata=target_metadata,
-        literal_binds=True,
-        dialect_opts={"paramstyle": "named"},
-    )
-    with context.begin_transaction():
-        context.run_migrations()
-
-
-def run_migrations_online() -> None:
-    connectable = engine_from_config(
-        config.get_section(config.config_ini_section, {}),
-        prefix="sqlalchemy.",
-        poolclass=pool.NullPool,
-    )
-    with connectable.connect() as connection:
-        context.configure(connection=connection, target_metadata=target_metadata)
-        with context.begin_transaction():
-            context.run_migrations()
-
-
-if context.is_offline_mode():
-    run_migrations_offline()
-else:
-    run_migrations_online()
+"""Alembic env — reads DATABASE_URL from settings, uses our Base metadata."""
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+from app.core.config import settings
+from app.db.session import Base
+from app.models import User  # noqa: F401  ensure metadata is populated
+
+config = context.config
+config.set_main_option("sqlalchemy.url", settings.database_url)
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    context.configure(
+        url=config.get_main_option("sqlalchemy.url"),
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata)
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

package/templates/stacks/python-fastapi/alembic/script.py.mako

@@ -1,26 +1,26 @@
-"""${message}
-
-Revision ID: ${up_revision}
-Revises: ${down_revision | comma,n}
-Create Date: ${create_date}
-
-"""
-from typing import Sequence, Union
-
-from alembic import op
-import sqlalchemy as sa
-${imports if imports else ""}
-
-# revision identifiers, used by Alembic.
-revision: str = ${repr(up_revision)}
-down_revision: Union[str, None] = ${repr(down_revision)}
-branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
-depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
-
-
-def upgrade() -> None:
-    ${upgrades if upgrades else "pass"}
-
-
-def downgrade() -> None:
-    ${downgrades if downgrades else "pass"}
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}

package/templates/stacks/python-fastapi/alembic/versions/0001_create_users.py.j2

@@ -1,37 +1,37 @@
-"""create users table
-
-Revision ID: 0001_create_users
-Revises:
-Create Date: 2026-06-01 00:00:00
-"""
-import sqlalchemy as sa
-from alembic import op
-from sqlalchemy.dialects import postgresql
-
-revision = "0001_create_users"
-down_revision = None
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.create_table(
-        "users",
-        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
-        sa.Column("email", sa.String(length=254), nullable=False),
-        sa.Column("password", sa.String(length=255), nullable=False),
-        sa.Column("role", sa.String(length=16), nullable=False, server_default="USER"),
-        sa.Column(
-            "created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False
-        ),
-        sa.Column(
-            "updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False
-        ),
-        sa.UniqueConstraint("email", name="uq_users_email"),
-    )
-    op.create_index("ix_users_email", "users", ["email"])
-
-
-def downgrade() -> None:
-    op.drop_index("ix_users_email", "users")
-    op.drop_table("users")
+"""create users table
+
+Revision ID: 0001_create_users
+Revises:
+Create Date: 2026-06-01 00:00:00
+"""
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects import postgresql
+
+revision = "0001_create_users"
+down_revision = None
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "users",
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        sa.Column("email", sa.String(length=254), nullable=False),
+        sa.Column("password", sa.String(length=255), nullable=False),
+        sa.Column("role", sa.String(length=16), nullable=False, server_default="USER"),
+        sa.Column(
+            "created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False
+        ),
+        sa.Column(
+            "updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False
+        ),
+        sa.UniqueConstraint("email", name="uq_users_email"),
+    )
+    op.create_index("ix_users_email", "users", ["email"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_users_email", "users")
+    op.drop_table("users")

package/templates/stacks/python-fastapi/alembic.ini.j2

@@ -1,39 +1,39 @@
-[alembic]
-script_location = alembic
-prepend_sys_path = .
-version_path_separator = os
-sqlalchemy.url =
-
-[loggers]
-keys = root,sqlalchemy,alembic
-
-[handlers]
-keys = console
-
-[formatters]
-keys = generic
-
-[logger_root]
-level = WARN
-handlers = console
-qualname =
-
-[logger_sqlalchemy]
-level = WARN
-handlers =
-qualname = sqlalchemy.engine
-
-[logger_alembic]
-level = INFO
-handlers =
-qualname = alembic
-
-[handler_console]
-class = StreamHandler
-args = (sys.stderr,)
-level = NOTSET
-formatter = generic
-
-[formatter_generic]
-format = %(levelname)-5.5s [%(name)s] %(message)s
-datefmt = %H:%M:%S
+[alembic]
+script_location = alembic
+prepend_sys_path = .
+version_path_separator = os
+sqlalchemy.url =
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

package/templates/stacks/python-fastapi/app/core/config.py

@@ -1,24 +1,24 @@
-"""App settings — Pydantic Settings reads from .env / environment."""
-from pydantic_settings import BaseSettings, SettingsConfigDict
-
-
-class Settings(BaseSettings):
-    model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8", extra="ignore")
-
-    app_port: int = 8000
-    log_level: str = "info"
-
-    database_url: str = "postgresql+psycopg://user:pass@localhost:5432/dbname"
-
-    jwt_secret: str = "replace-me-in-prod"
-    jwt_algorithm: str = "HS256"
-    jwt_expires_min: int = 15
-
-    bcrypt_rounds: int = 12
-
-    rate_limit_per_min: int = 60
-
-    cors_origins: list[str] = ["http://localhost:3000"]
-
-
-settings = Settings()
+"""App settings — Pydantic Settings reads from .env / environment."""
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8", extra="ignore")
+
+    app_port: int = 8000
+    log_level: str = "info"
+
+    database_url: str = "postgresql+psycopg://user:pass@localhost:5432/dbname"
+
+    jwt_secret: str = "replace-me-in-prod"
+    jwt_algorithm: str = "HS256"
+    jwt_expires_min: int = 15
+
+    bcrypt_rounds: int = 12
+
+    rate_limit_per_min: int = 60
+
+    cors_origins: list[str] = ["http://localhost:3000"]
+
+
+settings = Settings()

package/templates/stacks/python-fastapi/app/core/security.py

@@ -1,34 +1,34 @@
-"""JWT + password hashing helpers."""
-from datetime import datetime, timedelta, timezone
-from typing import Any
-
-from jose import JWTError, jwt
-from passlib.context import CryptContext
-
-from app.core.config import settings
-
-pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto", bcrypt__rounds=settings.bcrypt_rounds)
-
-
-def hash_password(plain: str) -> str:
-    return pwd_context.hash(plain)
-
-
-def verify_password(plain: str, hashed: str) -> bool:
-    return pwd_context.verify(plain, hashed)
-
-
-def create_access_token(sub: str, claims: dict[str, Any] | None = None) -> tuple[str, int]:
-    expires = datetime.now(timezone.utc) + timedelta(minutes=settings.jwt_expires_min)
-    payload: dict[str, Any] = {"sub": sub, "exp": expires}
-    if claims:
-        payload.update(claims)
-    token = jwt.encode(payload, settings.jwt_secret, algorithm=settings.jwt_algorithm)
-    return token, settings.jwt_expires_min * 60
-
-
-def decode_access_token(token: str) -> dict[str, Any] | None:
-    try:
-        return jwt.decode(token, settings.jwt_secret, algorithms=[settings.jwt_algorithm])
-    except JWTError:
-        return None
+"""JWT + password hashing helpers."""
+from datetime import datetime, timedelta, timezone
+from typing import Any
+
+from jose import JWTError, jwt
+from passlib.context import CryptContext
+
+from app.core.config import settings
+
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto", bcrypt__rounds=settings.bcrypt_rounds)
+
+
+def hash_password(plain: str) -> str:
+    return pwd_context.hash(plain)
+
+
+def verify_password(plain: str, hashed: str) -> bool:
+    return pwd_context.verify(plain, hashed)
+
+
+def create_access_token(sub: str, claims: dict[str, Any] | None = None) -> tuple[str, int]:
+    expires = datetime.now(timezone.utc) + timedelta(minutes=settings.jwt_expires_min)
+    payload: dict[str, Any] = {"sub": sub, "exp": expires}
+    if claims:
+        payload.update(claims)
+    token = jwt.encode(payload, settings.jwt_secret, algorithm=settings.jwt_algorithm)
+    return token, settings.jwt_expires_min * 60
+
+
+def decode_access_token(token: str) -> dict[str, Any] | None:
+    try:
+        return jwt.decode(token, settings.jwt_secret, algorithms=[settings.jwt_algorithm])
+    except JWTError:
+        return None