prodkit 0.3.1__tar.gz → 0.4.0__tar.gz

{prodkit-0.3.1 → prodkit-0.4.0}/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-08-14
+
+### Added
+- **`prodkit generate` CLI suite**:
+  - `prodkit generate docker`: hardened, multi-stage non-root Dockerfile and `.dockerignore`.
+  - `prodkit generate compose`: `docker-compose.yml` with healthchecks, environment mapping, and conditional Redis service detection.
+  - `prodkit generate nginx`: production reverse-proxy config with W3C traceparent pass-through, request-ID correlation, and gzip compression.
+  - `prodkit generate github`: `.github/workflows/ci.yml` with matrix testing across Python 3.10-3.13, linting, typechecking, coverage, and `prodkit doctor --strict` CI gate.
+  - `prodkit generate env`: `.env.example` template covering all `ProdKitConfig` parameters and defaults.
+  - `prodkit generate all`: single-command scaffolding for all deployment assets.
+- **Generator Engine** (`prodkit.generators`): decoupled generator classes (`DockerGenerator`, `ComposeGenerator`, `NginxGenerator`, `GitHubGenerator`, `EnvGenerator`) supporting programmatic rendering, `--dry-run` previews, `--force` overwriting, and context-aware templating.
+
 ## [0.3.0] - 2026-08-14
 
 ### Added

{prodkit-0.3.1 → prodkit-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: prodkit
-Version: 0.3.1
+Version: 0.4.0
 Summary: The production framework for FastAPI. One line. Production ready.
 Project-URL: Homepage, https://github.com/Pushkarpant/PRODKIT
 Project-URL: Documentation, https://github.com/Pushkarpant/PRODKIT#readme
@@ -90,7 +90,7 @@ Production(app)  # 👈 That's it. Production hardened.
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://github.com/Pushkarpant/PRODKIT/blob/main/LICENSE)
 [![Code Style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg?style=for-the-badge)](https://github.com/astral-sh/ruff)
 
-[⚡ Quick Start](#quick-start) · [📦 Installation](#installation) · [✨ What You Get](#what-you-get) · [🩺 CLI Doctor](#cli-doctor) · [🎛️ Configuration](#configuration) · [🔌 Plugins](#plugins) · [🗺️ Roadmap](#roadmap)
+[⚡ Quick Start](#quick-start) · [📦 Installation](#installation) · [✨ What You Get](#what-you-get) · [🩺 CLI Doctor](#cli-doctor) · [🚀 Generators](#generators) · [🎛️ Configuration](#configuration) · [🔌 Plugins](#plugins) · [🗺️ Roadmap](#roadmap)
 
 ---
 
@@ -201,7 +201,7 @@ pip install "prodkit[all]"       # All available plugins and extras
 
 | Extra | Adds | Dependencies |
 |---|---|---|
-| `cli` | `prodkit doctor`, `inspect`, `init` commands | `typer`, `rich` |
+| `cli` | `prodkit doctor`, `generate`, `inspect`, `init` | `typer`, `rich` |
 | `metrics` | Prometheus metrics endpoint (`/metrics`) | `prometheus-client` |
 | `otel` | W3C distributed tracing with OpenTelemetry | `opentelemetry-api`, `opentelemetry-sdk` |
 | `redis` | Multi-worker rate limiting & distributed cache | `redis` / `fakeredis` |
@@ -281,6 +281,46 @@ Enforce production standards in GitHub Actions or GitLab CI:
 prodkit doctor --app main:app --strict --min-score 90
 ```
 
+---
+
+<a id="generators"></a>
+## 🚀 Infrastructure & Deployment Generators (`prodkit generate`)
+
+Scaffold production-grade deployment assets tailored to your application's resolved configuration and active plugins:
+
+```bash
+# Generate all deployment assets at once
+prodkit generate all
+
+# Preview generated assets without writing to disk
+prodkit generate all --dry-run
+```
+
+```text
+                          Generated deployment assets                          
+┌─────────┬──────────────────────────┬────────────────────────────────────────┐
+│ Status  │ File                     │ Description                            │
+├─────────┼──────────────────────────┼────────────────────────────────────────┤
+│ created │ Dockerfile               │ Multi-stage, non-root production image │
+│ created │ .dockerignore            │ Docker build ignore file               │
+│ created │ docker-compose.yml       │ Multi-service Compose definition       │
+│ created │ nginx.conf               │ Hardened Nginx reverse-proxy           │
+│ created │ .github/workflows/ci.yml │ CI quality & testing with doctor gate  │
+│ created │ .env.example             │ Environment configuration template     │
+└─────────┴──────────────────────────┴────────────────────────────────────────┘
+Successfully generated 6 file(s).
+```
+
+### 🧩 Individual Generators
+
+| Command | Generated Artifact | Key Features |
+|---|---|---|
+| `prodkit generate docker` | `Dockerfile`, `.dockerignore` | Multi-stage builder, non-root `appuser:10001`, `HEALTHCHECK`, `uvicorn` workers |
+| `prodkit generate compose` | `docker-compose.yml` | Healthcheck dependencies, auto-detects Redis services and network volumes |
+| `prodkit generate nginx` | `nginx.conf` | Reverse-proxy, W3C `traceparent` propagation, `X-Request-ID`, gzip compression |
+| `prodkit generate github` | `.github/workflows/ci.yml` | Python 3.10–3.13 matrix, `ruff`, `mypy --strict`, `pytest`, `prodkit doctor` gate |
+| `prodkit generate env` | `.env.example` | Dynamic schema documentation with defaults and production notes |
+
 <details>
 <summary><b>🛠️ More CLI Commands (<code>inspect</code>, <code>plugins</code>, <code>init</code>)</b></summary>
 
@@ -408,9 +448,9 @@ Production(app, plugins=[DatabaseHealthPlugin()])
 |---|---|---|
 | **v0.1.0** | ✅ Released | Core kernel, security headers, JSON logs, RFC 9457 error normalization, `/health` |
 | **v0.2.0** | ✅ Released | `prodkit doctor` CLI, readiness score, in-memory rate limiting |
-| **v0.3.0** | ✅ **Current** | **Prometheus metrics, Redis backends, OpenTelemetry tracing, Cache service** |
-| **v0.4.0** | 🚧 Next | `prodkit generate` (Dockerfile, nginx, docker-compose, GitHub Actions CI) |
-| **v0.5.0** | 📅 Planned | Public Plugin SDK & Ecosystem (`prodkit-sentry`, entry-point discovery) |
+| **v0.3.0** | ✅ Released | Prometheus metrics, Redis backends, OpenTelemetry tracing, Cache service |
+| **v0.4.0** | ✅ **Current** | **`prodkit generate` (Dockerfile, nginx, docker-compose, GitHub Actions CI, .env)** |
+| **v0.5.0** | 🚧 Next | Public Plugin SDK & Ecosystem (`prodkit-sentry`, entry-point discovery) |
 | **v1.0.0** | 🎯 Milestone | Frozen Public API, LTS release, Production case studies |
 
 ---

{prodkit-0.3.1 → prodkit-0.4.0}/README.md

@@ -20,7 +20,7 @@ Production(app)  # 👈 That's it. Production hardened.
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://github.com/Pushkarpant/PRODKIT/blob/main/LICENSE)
 [![Code Style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg?style=for-the-badge)](https://github.com/astral-sh/ruff)
 
-[⚡ Quick Start](#quick-start) · [📦 Installation](#installation) · [✨ What You Get](#what-you-get) · [🩺 CLI Doctor](#cli-doctor) · [🎛️ Configuration](#configuration) · [🔌 Plugins](#plugins) · [🗺️ Roadmap](#roadmap)
+[⚡ Quick Start](#quick-start) · [📦 Installation](#installation) · [✨ What You Get](#what-you-get) · [🩺 CLI Doctor](#cli-doctor) · [🚀 Generators](#generators) · [🎛️ Configuration](#configuration) · [🔌 Plugins](#plugins) · [🗺️ Roadmap](#roadmap)
 
 ---
 
@@ -131,7 +131,7 @@ pip install "prodkit[all]"       # All available plugins and extras
 
 | Extra | Adds | Dependencies |
 |---|---|---|
-| `cli` | `prodkit doctor`, `inspect`, `init` commands | `typer`, `rich` |
+| `cli` | `prodkit doctor`, `generate`, `inspect`, `init` | `typer`, `rich` |
 | `metrics` | Prometheus metrics endpoint (`/metrics`) | `prometheus-client` |
 | `otel` | W3C distributed tracing with OpenTelemetry | `opentelemetry-api`, `opentelemetry-sdk` |
 | `redis` | Multi-worker rate limiting & distributed cache | `redis` / `fakeredis` |
@@ -211,6 +211,46 @@ Enforce production standards in GitHub Actions or GitLab CI:
 prodkit doctor --app main:app --strict --min-score 90
 ```
 
+---
+
+<a id="generators"></a>
+## 🚀 Infrastructure & Deployment Generators (`prodkit generate`)
+
+Scaffold production-grade deployment assets tailored to your application's resolved configuration and active plugins:
+
+```bash
+# Generate all deployment assets at once
+prodkit generate all
+
+# Preview generated assets without writing to disk
+prodkit generate all --dry-run
+```
+
+```text
+                          Generated deployment assets                          
+┌─────────┬──────────────────────────┬────────────────────────────────────────┐
+│ Status  │ File                     │ Description                            │
+├─────────┼──────────────────────────┼────────────────────────────────────────┤
+│ created │ Dockerfile               │ Multi-stage, non-root production image │
+│ created │ .dockerignore            │ Docker build ignore file               │
+│ created │ docker-compose.yml       │ Multi-service Compose definition       │
+│ created │ nginx.conf               │ Hardened Nginx reverse-proxy           │
+│ created │ .github/workflows/ci.yml │ CI quality & testing with doctor gate  │
+│ created │ .env.example             │ Environment configuration template     │
+└─────────┴──────────────────────────┴────────────────────────────────────────┘
+Successfully generated 6 file(s).
+```
+
+### 🧩 Individual Generators
+
+| Command | Generated Artifact | Key Features |
+|---|---|---|
+| `prodkit generate docker` | `Dockerfile`, `.dockerignore` | Multi-stage builder, non-root `appuser:10001`, `HEALTHCHECK`, `uvicorn` workers |
+| `prodkit generate compose` | `docker-compose.yml` | Healthcheck dependencies, auto-detects Redis services and network volumes |
+| `prodkit generate nginx` | `nginx.conf` | Reverse-proxy, W3C `traceparent` propagation, `X-Request-ID`, gzip compression |
+| `prodkit generate github` | `.github/workflows/ci.yml` | Python 3.10–3.13 matrix, `ruff`, `mypy --strict`, `pytest`, `prodkit doctor` gate |
+| `prodkit generate env` | `.env.example` | Dynamic schema documentation with defaults and production notes |
+
 <details>
 <summary><b>🛠️ More CLI Commands (<code>inspect</code>, <code>plugins</code>, <code>init</code>)</b></summary>
 
@@ -338,9 +378,9 @@ Production(app, plugins=[DatabaseHealthPlugin()])
 |---|---|---|
 | **v0.1.0** | ✅ Released | Core kernel, security headers, JSON logs, RFC 9457 error normalization, `/health` |
 | **v0.2.0** | ✅ Released | `prodkit doctor` CLI, readiness score, in-memory rate limiting |
-| **v0.3.0** | ✅ **Current** | **Prometheus metrics, Redis backends, OpenTelemetry tracing, Cache service** |
-| **v0.4.0** | 🚧 Next | `prodkit generate` (Dockerfile, nginx, docker-compose, GitHub Actions CI) |
-| **v0.5.0** | 📅 Planned | Public Plugin SDK & Ecosystem (`prodkit-sentry`, entry-point discovery) |
+| **v0.3.0** | ✅ Released | Prometheus metrics, Redis backends, OpenTelemetry tracing, Cache service |
+| **v0.4.0** | ✅ **Current** | **`prodkit generate` (Dockerfile, nginx, docker-compose, GitHub Actions CI, .env)** |
+| **v0.5.0** | 🚧 Next | Public Plugin SDK & Ecosystem (`prodkit-sentry`, entry-point discovery) |
 | **v1.0.0** | 🎯 Milestone | Frozen Public API, LTS release, Production case studies |
 
 ---

{prodkit-0.3.1 → prodkit-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "prodkit"
-version = "0.3.1"
+version = "0.4.0"
 description = "The production framework for FastAPI. One line. Production ready."
 readme = "README.md"
 license = "MIT"

{prodkit-0.3.1 → prodkit-0.4.0}/src/prodkit/__init__.py

@@ -37,7 +37,7 @@ from prodkit.plugins import builtin_plugins
 # root — the kernel itself never imports from prodkit.plugins.
 set_builtin_factory(builtin_plugins)
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"
 
 __all__ = [
     "Audit",

prodkit-0.4.0/src/prodkit/cli/__main__.py

@@ -0,0 +1,6 @@
+"""Executable entrypoint for ``python -m prodkit.cli``."""
+
+from prodkit.cli import run
+
+if __name__ == "__main__":
+    run()

{prodkit-0.3.1 → prodkit-0.4.0}/src/prodkit/cli/app.py

@@ -1,9 +1,10 @@
-"""The typer + rich CLI application: doctor, inspect, plugins, init."""
+"""The typer + rich CLI application: doctor, inspect, plugins, init, generate."""
 
 from __future__ import annotations
 
 import json
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 import typer
 from rich.console import Console
@@ -14,10 +15,25 @@ from prodkit import __version__
 from prodkit.cli.loader import AppLoadError, load_production
 from prodkit.contracts.plugin import Plugin
 from prodkit.core.doctor import DoctorReport, run_doctor
+from prodkit.generators import (
+    ALL_GENERATORS,
+    BaseGenerator,
+    ComposeGenerator,
+    DockerGenerator,
+    EnvGenerator,
+    FileStatus,
+    GeneratedFile,
+    GeneratorContext,
+    GitHubGenerator,
+    NginxGenerator,
+)
+
+if TYPE_CHECKING:
+    from prodkit.core.production import Production
 
 app = typer.Typer(
     name="prodkit",
-    help="Audit and inspect the production-readiness of a FastAPI app.",
+    help="Audit, inspect, and generate production assets for a FastAPI app.",
     no_args_is_help=True,
     add_completion=False,
 )
@@ -73,7 +89,7 @@ def main(
     """ProdKit CLI."""
 
 
-def _load(app_spec: str | None):  # type: ignore[no-untyped-def]
+def _load(app_spec: str | None) -> Production:
     try:
         return load_production(app_spec)
     except AppLoadError as exc:
@@ -81,6 +97,16 @@ def _load(app_spec: str | None):  # type: ignore[no-untyped-def]
         raise typer.Exit(2) from None
 
 
+def _load_optional(app_spec: str | None) -> Production | None:
+    try:
+        return load_production(app_spec)
+    except AppLoadError as exc:
+        if app_spec:
+            err_console.print(f"[red]error:[/] {exc}")
+            raise typer.Exit(2) from None
+        return None
+
+
 # --------------------------------------------------------------------------
 # doctor
 # --------------------------------------------------------------------------
@@ -258,3 +284,145 @@ def init(
         else:
             main_path.write_text(_EXAMPLE_TEMPLATE, encoding="utf-8")
             console.print(f"[green]created[/] {main_path}")
+
+
+# --------------------------------------------------------------------------
+# generate
+# --------------------------------------------------------------------------
+generate_app = typer.Typer(
+    name="generate",
+    help="Generate production deployment assets (Dockerfile, compose, nginx, CI, env).",
+    no_args_is_help=True,
+)
+app.add_typer(generate_app)
+
+
+def _run_generators(
+    generators: list[type[BaseGenerator]],
+    path: Path,
+    app_spec: str | None,
+    force: bool,
+    dry_run: bool,
+    port: int,
+) -> None:
+    prod = _load_optional(app_spec)
+    ctx = GeneratorContext(
+        production=prod,
+        root_dir=path,
+        force=force,
+        dry_run=dry_run,
+        port=port,
+        app_spec=app_spec or "main:app",
+    )
+
+    table = Table(title="Generated deployment assets", expand=False)
+    table.add_column("Status", style="bold")
+    table.add_column("File", style="cyan")
+    table.add_column("Description", style="dim")
+
+    all_results: list[tuple[GeneratedFile, FileStatus]] = []
+    for gen_cls in generators:
+        gen = gen_cls()
+        results = gen.write(ctx)
+        all_results.extend(results)
+
+    status_labels: dict[FileStatus, str] = {
+        "created": "[green]created[/]",
+        "overwritten": "[blue]overwritten[/]",
+        "skipped": "[yellow]skipped[/]",
+        "dry-run": "[dim]dry-run[/]",
+    }
+
+    if path != Path("."):
+        console.print(f"[bold]Destination:[/] {path}")
+
+    for gen_file, status in all_results:
+        target_display = str(gen_file.path)
+        table.add_row(status_labels[status], target_display, gen_file.description)
+
+    console.print(table)
+
+    created_count = sum(1 for _, s in all_results if s in ("created", "overwritten"))
+    skipped_count = sum(1 for _, s in all_results if s == "skipped")
+
+    if dry_run:
+        console.print("[dim]Dry-run mode: no files were written to disk.[/]")
+    elif created_count > 0 and skipped_count == 0:
+        console.print(f"[green]Successfully generated {created_count} file(s).[/]")
+    elif skipped_count > 0:
+        console.print(
+            f"[yellow]{skipped_count} file(s) already exist and were skipped. "
+            "Use --force to overwrite.[/]"
+        )
+
+
+@generate_app.command(name="docker")
+def generate_docker(
+    path: Path = typer.Option(Path("."), "--path", "-p", help="Directory to write files into."),
+    app_spec: str | None = _APP_OPTION,
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing files."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Preview files without writing."),
+    port: int = typer.Option(8000, "--port", help="Application container port."),
+) -> None:
+    """Generate a multi-stage, non-root Dockerfile and .dockerignore."""
+    _run_generators([DockerGenerator], path, app_spec, force, dry_run, port)
+
+
+@generate_app.command(name="compose")
+def generate_compose(
+    path: Path = typer.Option(Path("."), "--path", "-p", help="Directory to write files into."),
+    app_spec: str | None = _APP_OPTION,
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing files."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Preview files without writing."),
+    port: int = typer.Option(8000, "--port", help="Application container port."),
+) -> None:
+    """Generate a docker-compose.yml file with services and healthchecks."""
+    _run_generators([ComposeGenerator], path, app_spec, force, dry_run, port)
+
+
+@generate_app.command(name="nginx")
+def generate_nginx(
+    path: Path = typer.Option(Path("."), "--path", "-p", help="Directory to write files into."),
+    app_spec: str | None = _APP_OPTION,
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing files."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Preview files without writing."),
+    port: int = typer.Option(8000, "--port", help="Target upstream application port."),
+) -> None:
+    """Generate a production-hardened Nginx reverse-proxy configuration."""
+    _run_generators([NginxGenerator], path, app_spec, force, dry_run, port)
+
+
+@generate_app.command(name="github")
+def generate_github(
+    path: Path = typer.Option(Path("."), "--path", "-p", help="Directory to write files into."),
+    app_spec: str | None = _APP_OPTION,
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing files."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Preview files without writing."),
+    port: int = typer.Option(8000, "--port", help="Application port."),
+) -> None:
+    """Generate a GitHub Actions CI workflow (.github/workflows/ci.yml)."""
+    _run_generators([GitHubGenerator], path, app_spec, force, dry_run, port)
+
+
+@generate_app.command(name="env")
+def generate_env(
+    path: Path = typer.Option(Path("."), "--path", "-p", help="Directory to write files into."),
+    app_spec: str | None = _APP_OPTION,
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing files."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Preview files without writing."),
+    port: int = typer.Option(8000, "--port", help="Application port."),
+) -> None:
+    """Generate a documented .env.example with all configuration keys."""
+    _run_generators([EnvGenerator], path, app_spec, force, dry_run, port)
+
+
+@generate_app.command(name="all")
+def generate_all(
+    path: Path = typer.Option(Path("."), "--path", "-p", help="Directory to write files into."),
+    app_spec: str | None = _APP_OPTION,
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing files."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Preview files without writing."),
+    port: int = typer.Option(8000, "--port", help="Application container port."),
+) -> None:
+    """Generate all deployment and infrastructure assets at once."""
+    _run_generators(list(ALL_GENERATORS), path, app_spec, force, dry_run, port)

prodkit-0.4.0/src/prodkit/generators/__init__.py

@@ -0,0 +1,36 @@
+"""Deployment and infrastructure asset generators for ProdKit."""
+
+from __future__ import annotations
+
+from prodkit.generators.base import (
+    BaseGenerator,
+    FileStatus,
+    GeneratedFile,
+    GeneratorContext,
+)
+from prodkit.generators.compose import ComposeGenerator
+from prodkit.generators.docker import DockerGenerator
+from prodkit.generators.env import EnvGenerator
+from prodkit.generators.github import GitHubGenerator
+from prodkit.generators.nginx import NginxGenerator
+
+ALL_GENERATORS: tuple[type[BaseGenerator], ...] = (
+    DockerGenerator,
+    ComposeGenerator,
+    NginxGenerator,
+    GitHubGenerator,
+    EnvGenerator,
+)
+
+__all__ = [
+    "ALL_GENERATORS",
+    "BaseGenerator",
+    "ComposeGenerator",
+    "DockerGenerator",
+    "EnvGenerator",
+    "FileStatus",
+    "GeneratedFile",
+    "GeneratorContext",
+    "GitHubGenerator",
+    "NginxGenerator",
+]

prodkit-0.4.0/src/prodkit/generators/base.py

@@ -0,0 +1,104 @@
+"""Base classes, data models, and protocol for deployment generators."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import TYPE_CHECKING, Literal
+
+if TYPE_CHECKING:
+    from prodkit.core.production import Production
+
+
+FileStatus = Literal["created", "skipped", "overwritten", "dry-run"]
+
+
+@dataclass
+class GeneratedFile:
+    """A generated file artifact with a relative destination path and content."""
+
+    path: Path
+    content: str
+    description: str = ""
+
+
+@dataclass
+class GeneratorContext:
+    """Context passed to generators during template rendering and file writing."""
+
+    production: Production | None = None
+    root_dir: Path = field(default_factory=lambda: Path("."))
+    force: bool = False
+    dry_run: bool = False
+    port: int = 8000
+    app_spec: str = "main:app"
+
+    @property
+    def health_path(self) -> str:
+        if self.production is not None:
+            return self.production.config.health.health_path
+        return "/health"
+
+    @property
+    def live_path(self) -> str:
+        if self.production is not None:
+            return self.production.config.health.live_path
+        return "/live"
+
+    @property
+    def metrics_path(self) -> str:
+        if self.production is not None:
+            return self.production.config.metrics.path
+        return "/metrics"
+
+    @property
+    def metrics_enabled(self) -> bool:
+        if self.production is not None:
+            return self.production.config.metrics.enabled
+        return False
+
+    @property
+    def has_redis(self) -> bool:
+        if self.production is not None:
+            cfg = self.production.config
+            if cfg.rate_limit.enabled and cfg.rate_limit.backend == "redis":
+                return True
+            if cfg.cache.enabled and cfg.cache.backend == "redis":
+                return True
+        return False
+
+
+class BaseGenerator(ABC):
+    """Abstract base class implemented by each deployment asset generator."""
+
+    name: str = "base"
+    description: str = ""
+
+    @abstractmethod
+    def generate(self, ctx: GeneratorContext) -> list[GeneratedFile]:
+        """Render templates and return the list of generated files without writing."""
+        raise NotImplementedError
+
+    def write(self, ctx: GeneratorContext) -> list[tuple[GeneratedFile, FileStatus]]:
+        """Render and optionally write the files to disk based on context options."""
+        generated_files = self.generate(ctx)
+        results: list[tuple[GeneratedFile, FileStatus]] = []
+
+        for gen_file in generated_files:
+            target_path = ctx.root_dir / gen_file.path
+
+            if ctx.dry_run:
+                results.append((gen_file, "dry-run"))
+                continue
+
+            if target_path.exists() and not ctx.force:
+                results.append((gen_file, "skipped"))
+                continue
+
+            status: FileStatus = "overwritten" if target_path.exists() else "created"
+            target_path.parent.mkdir(parents=True, exist_ok=True)
+            target_path.write_text(gen_file.content, encoding="utf-8")
+            results.append((gen_file, status))
+
+        return results

prodkit-0.4.0/src/prodkit/generators/compose.py

@@ -0,0 +1,95 @@
+"""Docker Compose generator: creates production-ready docker-compose.yml."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from prodkit.generators.base import BaseGenerator, GeneratedFile, GeneratorContext
+
+
+class ComposeGenerator(BaseGenerator):
+    """Generates docker-compose.yml with app service and optional Redis dependencies."""
+
+    name = "compose"
+    description = "Generate a production-ready docker-compose.yml"
+
+    def generate(self, ctx: GeneratorContext) -> list[GeneratedFile]:
+        app_env_entries = [
+            "      - PRODKIT_ENVIRONMENT=production",
+            f"      - PORT={ctx.port}",
+        ]
+
+        redis_service = ""
+        volumes_section = ""
+        depends_on_section = ""
+
+        if ctx.has_redis:
+            app_env_entries.extend(
+                [
+                    "      - PRODKIT_RATE_LIMIT__REDIS_URL=redis://redis:6379/0",
+                    "      - PRODKIT_CACHE__REDIS_URL=redis://redis:6379/0",
+                ]
+            )
+            depends_on_section = """\
+    depends_on:
+      redis:
+        condition: service_healthy
+"""
+            redis_service = """\
+  redis:
+    image: redis:7-alpine
+    restart: unless-stopped
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 3s
+      retries: 3
+"""
+            volumes_section = """\
+volumes:
+  redis_data:
+"""
+
+        env_block = "\n".join(app_env_entries)
+
+        compose_content = f"""\
+# ==============================================================================
+# Docker Compose configuration for FastAPI + ProdKit
+# ==============================================================================
+
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    restart: unless-stopped
+    ports:
+      - "${{PORT:-{ctx.port}}}:{ctx.port}"
+    environment:
+{env_block}
+    env_file:
+      - path: .env
+        required: false
+{depends_on_section}    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:{ctx.port}{ctx.health_path}')"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 10s
+
+{redis_service}{volumes_section}
+networks:
+  default:
+    name: prodkit_net
+"""
+        return [
+            GeneratedFile(
+                path=Path("docker-compose.yml"),
+                content=compose_content.strip() + "\n",
+                description="Docker Compose multi-service deployment definition",
+            )
+        ]