@dokebi/cli 0.2.5 → 0.4.1

package/catalog.json

@@ -0,0 +1,2203 @@
+{
+  "$comment": "Generated by scripts/catalog/build.ts from package.json dokebiCatalog fields and packages/cli/catalog-src (D-0065). Do not edit; run node scripts/catalog/build.ts.",
+  "schemaVersion": 1,
+  "cli": "0.4.1",
+  "core": {
+    "package": "@dokebi/core",
+    "version": "0.4.0"
+  },
+  "capabilities": {
+    "admin.ui": {
+      "summary": "generated admin screens (CRUD generator)",
+      "en": "admin dashboard crud backoffice"
+    },
+    "auth": {
+      "summary": "login",
+      "users and permissions (authentication and authorization)": null,
+      "en": "auth authentication authorization login user password oauth jwt signup"
+    },
+    "cache.local": {
+      "summary": "in-process memory cache (LRU)",
+      "en": "cache memory lru"
+    },
+    "cache.redis": {
+      "summary": "shared Redis cache driver",
+      "en": "cache redis shared"
+    },
+    "cli.project": {
+      "summary": "commands to create a project",
+      "install plugins and verify it": null,
+      "en": "command line scaffold install verify"
+    },
+    "config.yaml": {
+      "summary": "read and validate dokebi.yaml (a required part of the core)",
+      "en": "yaml configuration"
+    },
+    "core.runtime": {
+      "summary": "application lifecycle",
+      "plugin registration": null,
+      "logger and shared libraries": null,
+      "en": "application lifecycle plugin registry logger"
+    },
+    "csrf": {
+      "summary": "issue and check CSRF tokens",
+      "en": "csrf xsrf token"
+    },
+    "db.connection": {
+      "summary": "named database connections (pools) with readiness checks and shutdown",
+      "en": "database connection pool"
+    },
+    "db.mariadb": {
+      "summary": "MariaDB connection (mariadb driver)",
+      "en": "mariadb sql database"
+    },
+    "db.migrate": {
+      "summary": "migrations (table and index changes) with history and a lock",
+      "en": "migration schema ddl"
+    },
+    "db.mongodb": {
+      "summary": "MongoDB connection (mongodb driver)",
+      "en": "mongodb mongo nosql document database"
+    },
+    "db.mysql": {
+      "summary": "MySQL connection (mysql2 driver)",
+      "en": "mysql mysql2 sql database"
+    },
+    "db.postgres": {
+      "summary": "PostgreSQL connection (pg driver)",
+      "en": "postgres postgresql pg sql database"
+    },
+    "db.seed": {
+      "summary": "run seed data",
+      "en": "seed fixtures"
+    },
+    "db.sqlite": {
+      "summary": "SQLite file database",
+      "en": "sqlite sqlite3 file database"
+    },
+    "events.bus": {
+      "summary": "event bus (in process or over NATS)",
+      "en": "event bus pubsub publish subscribe"
+    },
+    "health.checks": {
+      "summary": "live",
+      "ready and draining state with readiness checks": null,
+      "en": "health readiness liveness"
+    },
+    "i18n": {
+      "summary": "multiple languages (translated strings)",
+      "en": "i18n translation locale"
+    },
+    "job.durable": {
+      "summary": "at-least-once job queue (JetStream",
+      "retries": null,
+      "DLQ)": null,
+      "en": "job queue background task retry dlq"
+    },
+    "lock.local": {
+      "summary": "lock within one process",
+      "en": "lock mutex"
+    },
+    "lock.redis": {
+      "summary": "Redis lease lock (fencing tokens)",
+      "en": "distributed lock redis lease"
+    },
+    "mail": {
+      "summary": "send mail (SMTP)",
+      "en": "mail email smtp"
+    },
+    "markdown": {
+      "summary": "convert Markdown to HTML",
+      "en": "markdown md html"
+    },
+    "messaging.nats": {
+      "summary": "named NATS connections and JetStream publishing",
+      "en": "nats jetstream messaging"
+    },
+    "orm": {
+      "summary": "ORM",
+      "query builder and model mapping": null,
+      "en": "orm query builder model"
+    },
+    "process.cluster": {
+      "summary": "run several node:cluster workers",
+      "watch them and replace them one by one": null,
+      "en": "cluster multi process workers"
+    },
+    "rate-limit": {
+      "summary": "limit the number of requests",
+      "en": "rate limit throttle"
+    },
+    "realtime.hub": {
+      "summary": "hub of WebSocket clients",
+      "rooms and broadcast": null,
+      "en": "websocket hub rooms broadcast"
+    },
+    "realtime.sse": {
+      "summary": "server-sent events (SSE) streams and a browser client",
+      "en": "sse server sent events eventsource"
+    },
+    "realtime.websocket": {
+      "summary": "WebSocket routes",
+      "rooms and broadcast (across servers and workers)": null,
+      "en": "websocket socket realtime chat"
+    },
+    "redis.connection": {
+      "summary": "named Redis connections",
+      "en": "redis"
+    },
+    "redis.coordination": {
+      "summary": "Redis leader election and incremental state",
+      "en": "redis leader election coordination"
+    },
+    "rss": {
+      "summary": "RSS and Atom feeds",
+      "en": "rss atom feed"
+    },
+    "schedule.cron": {
+      "summary": "cron and fixed-interval schedules (submitted to the job queue)",
+      "en": "schedule cron interval timer"
+    },
+    "search": {
+      "summary": "full-text search",
+      "en": "search full text index"
+    },
+    "security.seal": {
+      "summary": "sealing of transport bodies (obfuscation",
+      "replay protection) and a browser client": null,
+      "en": "seal obfuscation replay encryption"
+    },
+    "upload": {
+      "summary": "receive and store file uploads (multipart)",
+      "en": "upload multipart file storage"
+    },
+    "view.ejs": {
+      "summary": "EJS server-rendered views (no build)",
+      "en": "ejs server side templates html"
+    },
+    "view.inertia-react": {
+      "summary": "Inertia + React views",
+      "en": "inertia react"
+    },
+    "view.inertia-vue": {
+      "summary": "Inertia + Vue 3 views (Vite build)",
+      "en": "inertia vue spa vite"
+    },
+    "view.inertia-vue-ssr": {
+      "summary": "Inertia + Vue 3 + server-side rendering (SSR)",
+      "en": "inertia vue ssr server side rendering"
+    },
+    "web.apps": {
+      "summary": "several apps by domain (src/apps)",
+      "en": "multi app domains virtual host"
+    },
+    "web.controller": {
+      "summary": "controller registry per app",
+      "en": "controller mvc"
+    },
+    "web.http": {
+      "summary": "HTTP server (Fastify) with 503 before ready",
+      "drain and health paths": null,
+      "en": "http server fastify web"
+    },
+    "web.modules": {
+      "summary": "feature modules (src/shared/modules)",
+      "en": "feature module"
+    },
+    "web.routing": {
+      "summary": "routes grouped under a prefix (mount)",
+      "en": "router routes prefix"
+    },
+    "web.session": {
+      "summary": "server-side sessions (signed cookie",
+      "memory or redis store": null,
+      "flash)": null,
+      "en": "session cookie flash"
+    },
+    "worker.thread": {
+      "summary": "worker thread pool for CPU work",
+      "en": "worker thread cpu pool"
+    }
+  },
+  "packages": [
+    {
+      "id": "dokebi-app",
+      "package": "@dokebi/app",
+      "version": "0.4.1",
+      "kind": "plugin",
+      "summary": "Several apps chosen by request domain (src/apps/<app>) with a template each; installs web, controller and template-ejs with it",
+      "description": "Multiple apps per project for Dokebi: pick the app and template by request domain, with EJS and Inertia skeletons.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "apps",
+        "domains",
+        "mvc"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "web.apps"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No login, permissions or admin screens",
+        "No React skeleton (EJS and Inertia Vue only)"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [
+        {
+          "id": "dokebi-web",
+          "range": "^0.4.1",
+          "package": "@dokebi/web",
+          "automatic": true
+        },
+        {
+          "id": "dokebi-controller",
+          "range": "^0.4.0",
+          "package": "@dokebi/controller",
+          "automatic": true
+        },
+        {
+          "id": "dokebi-template-ejs",
+          "range": "^0.4.0",
+          "package": "@dokebi/template-ejs",
+          "automatic": true
+        }
+      ],
+      "optional": [
+        {
+          "id": "dokebi-seal",
+          "range": "^0.4.0"
+        },
+        {
+          "id": "dokebi-session",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "apps",
+        "domains",
+        "unknownDomain"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/app"
+    },
+    {
+      "id": "dokebi-cache",
+      "package": "@dokebi/cache",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Named cache backends (local LRU by default; redis through the @dokebi/cache-redis driver)",
+      "description": "Named cache backends for Dokebi: in-process LRU or a shared Redis driver.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "cache",
+        "lru",
+        "redis"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "cache.local"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No values that are not JSON",
+        "The Redis driver is installed separately (@dokebi/cache-redis)"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-redis",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "backends"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/cache"
+    },
+    {
+      "id": null,
+      "package": "@dokebi/cache-redis",
+      "version": "0.4.0",
+      "kind": "driver",
+      "summary": "Redis driver of @dokebi/cache (not a plugin: install it with npm install)",
+      "description": "Redis driver for @dokebi/cache (not a plugin; install with npm).",
+      "keywords": [
+        "dokebi",
+        "dokebi-driver",
+        "cache",
+        "redis"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "cache.redis"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Not installed with dokebi add"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [],
+      "driverOf": "dokebi-cache",
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npm install @dokebi/cache-redis"
+    },
+    {
+      "id": null,
+      "package": "@dokebi/cli",
+      "version": "0.4.1",
+      "kind": "cli",
+      "summary": "Commands to create a project, browse the plugin catalog, run recipes, install plugins and verify (dokebi)",
+      "description": "Project scaffolding, plugin catalog, recipes, install and verification CLI for Dokebi.",
+      "keywords": [
+        "dokebi",
+        "cli",
+        "scaffold",
+        "plugins",
+        "catalog"
+      ],
+      "maturity": "preview",
+      "core": null,
+      "provides": [
+        "cli.project"
+      ],
+      "variants": [],
+      "doesNot": [
+        "It is not the npm package named dokebi (never npx -y dokebi)",
+        "It does not write app code for you"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": null
+      },
+      "install": "npx -y @dokebi/cli init <folder>"
+    },
+    {
+      "id": null,
+      "package": "@dokebi/cluster",
+      "version": "0.4.0",
+      "kind": "library",
+      "summary": "Runner that starts several app workers from a node:cluster parent process, watches them and replaces them one by one",
+      "description": "node:cluster runner for Dokebi: starts, watches and rolls independent application workers.",
+      "keywords": [
+        "dokebi",
+        "cluster",
+        "workers",
+        "process",
+        "rolling-restart"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "process.cluster"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Not a plugin you app.register",
+        "Not a CPU thread pool (@dokebi/worker)"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npm install @dokebi/cluster"
+    },
+    {
+      "id": "dokebi-config",
+      "package": "@dokebi/config",
+      "version": "0.4.0",
+      "kind": "required",
+      "summary": "Required part of the core that reads and validates dokebi.yaml into read-only settings per app (installed automatically)",
+      "description": "Validated immutable YAML configuration for Dokebi applications.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "config",
+        "yaml"
+      ],
+      "maturity": "preview",
+      "core": null,
+      "provides": [
+        "config.yaml"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Not installed or removed by hand",
+        "No environment variable substitution"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": null
+      },
+      "install": "automatic (dokebi init)"
+    },
+    {
+      "id": "dokebi-controller",
+      "package": "@dokebi/controller",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Registry that creates each controller object once per app and hands it out with its type",
+      "description": "Per-app controller registry for Dokebi: build controllers once and read them with their types.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "controller",
+        "mvc"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "web.controller"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No decorator or reflection DI",
+        "No HTTP routing"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/controller"
+    },
+    {
+      "id": null,
+      "package": "@dokebi/core",
+      "version": "0.4.0",
+      "kind": "core",
+      "summary": "Application core: settings loading, plugin registration, lifecycle, logger and shared libraries (required)",
+      "description": "Minimal composable Node.js application and plugin lifecycle framework.",
+      "keywords": [
+        "dokebi",
+        "framework",
+        "lifecycle",
+        "plugins",
+        "nodejs"
+      ],
+      "maturity": "preview",
+      "core": null,
+      "provides": [
+        "core.runtime"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No web, database, Redis or similar features (all are optional plugins)",
+        "No AI-only runtime"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": null
+      },
+      "install": "automatic (dokebi init)"
+    },
+    {
+      "id": "dokebi-db",
+      "package": "@dokebi/db",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Named database connections (pools) with readiness checks and shutdown; you use the driver API as it is",
+      "description": "Named database connections for Dokebi: create, readiness check and close pools of pg, mysql2, mariadb or mongodb.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "database",
+        "postgres",
+        "mysql",
+        "mariadb",
+        "mongodb"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "db.connection",
+        "db.mariadb",
+        "db.mongodb",
+        "db.mysql",
+        "db.postgres"
+      ],
+      "variants": [
+        {
+          "name": "postgres",
+          "capability": "db.postgres",
+          "adapter": "pg",
+          "driver": {
+            "package": "pg",
+            "version": "8.23.1"
+          },
+          "types": {
+            "package": "@types/pg",
+            "version": "8.23.1"
+          },
+          "migrate": true,
+          "devInfra": {
+            "docker": {
+              "image": "postgres:16.15-alpine",
+              "port": 5432,
+              "env": {
+                "POSTGRES_USER": "dokebi",
+                "POSTGRES_PASSWORD": "${DOKEBI_DB_PASSWORD}",
+                "POSTGRES_DB": "dokebi"
+              },
+              "healthcheck": [
+                "CMD",
+                "pg_isready",
+                "-U",
+                "dokebi",
+                "-d",
+                "dokebi"
+              ],
+              "url": "postgres://dokebi:{password}@127.0.0.1:{port}/dokebi"
+            }
+          }
+        },
+        {
+          "name": "mysql",
+          "capability": "db.mysql",
+          "adapter": "mysql2",
+          "driver": {
+            "package": "mysql2",
+            "version": "3.24.5"
+          },
+          "migrate": true,
+          "devInfra": {
+            "docker": {
+              "image": "mysql:8",
+              "port": 3306,
+              "env": {
+                "MYSQL_ROOT_PASSWORD": "${DOKEBI_DB_PASSWORD}",
+                "MYSQL_USER": "dokebi",
+                "MYSQL_PASSWORD": "${DOKEBI_DB_PASSWORD}",
+                "MYSQL_DATABASE": "dokebi"
+              },
+              "healthcheck": [
+                "CMD",
+                "mysqladmin",
+                "ping",
+                "-h",
+                "127.0.0.1",
+                "-udokebi",
+                "-p${DOKEBI_DB_PASSWORD}"
+              ],
+              "url": "mysql://dokebi:{password}@127.0.0.1:{port}/dokebi"
+            }
+          }
+        },
+        {
+          "name": "mariadb",
+          "capability": "db.mariadb",
+          "adapter": "mariadb",
+          "driver": {
+            "package": "mariadb",
+            "version": "3.5.4"
+          },
+          "migrate": true,
+          "devInfra": {
+            "docker": {
+              "image": "mariadb:11",
+              "port": 3306,
+              "env": {
+                "MARIADB_ROOT_PASSWORD": "${DOKEBI_DB_PASSWORD}",
+                "MARIADB_USER": "dokebi",
+                "MARIADB_PASSWORD": "${DOKEBI_DB_PASSWORD}",
+                "MARIADB_DATABASE": "dokebi"
+              },
+              "healthcheck": [
+                "CMD",
+                "healthcheck.sh",
+                "--connect",
+                "--innodb_initialized"
+              ],
+              "url": "mariadb://dokebi:{password}@127.0.0.1:{port}/dokebi"
+            }
+          }
+        },
+        {
+          "name": "mongodb",
+          "capability": "db.mongodb",
+          "adapter": "mongodb",
+          "driver": {
+            "package": "mongodb",
+            "version": "7.7.0"
+          },
+          "migrate": true,
+          "devInfra": {
+            "docker": {
+              "image": "mongo:7",
+              "port": 27017,
+              "env": {
+                "MONGO_INITDB_ROOT_USERNAME": "dokebi",
+                "MONGO_INITDB_ROOT_PASSWORD": "${DOKEBI_DB_PASSWORD}"
+              },
+              "healthcheck": [
+                "CMD",
+                "mongosh",
+                "--quiet",
+                "--eval",
+                "db.adminCommand('ping')"
+              ],
+              "url": "mongodb://dokebi:{password}@127.0.0.1:{port}/dokebi?authSource=admin"
+            }
+          }
+        }
+      ],
+      "doesNot": [
+        "No ORM, query builder or query API",
+        "No bundled driver (add --adapter installs it)",
+        "No table changes or seeds (@dokebi/migrate)",
+        "No SQLite adapter"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-health",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "connections"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/db"
+    },
+    {
+      "id": "dokebi-event-bus",
+      "package": "@dokebi/event-bus",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Named event buses (local or NATS, at most once)",
+      "description": "Named event buses for Dokebi: in-process dispatch or NATS Core delivery between processes.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "events",
+        "pubsub",
+        "nats"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "events.bus"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No persistence, retries or exactly-once delivery (@dokebi/job)"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-nats",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "buses"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/event-bus"
+    },
+    {
+      "id": "dokebi-health",
+      "package": "@dokebi/health",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Collects the live, ready and draining state of the app and the readiness checks of plugins (web serves the HTTP paths)",
+      "description": "Liveness, readiness and draining state with plugin readiness checks for Dokebi.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "health",
+        "readiness",
+        "liveness"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "health.checks"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No periodic probes or automatic restarts",
+        "No aggregation across the cluster"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [
+        "maxChecks"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/health"
+    },
+    {
+      "id": "dokebi-job",
+      "package": "@dokebi/job",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "NATS JetStream job queue (at least once, retries, DLQ)",
+      "description": "Bounded durable jobs over the Dokebi NATS provider: retries, delayed redelivery and a dead-letter stream.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "jobs",
+        "queue",
+        "nats",
+        "jetstream"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "job.durable"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No exactly-once delivery (handlers must be idempotent)",
+        "No database"
+      ],
+      "recipes": [],
+      "requires": [
+        {
+          "id": "dokebi-nats",
+          "range": "^0.4.0"
+        }
+      ],
+      "optional": [
+        {
+          "id": "dokebi-health",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "queues"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/job"
+    },
+    {
+      "id": "dokebi-lock",
+      "package": "@dokebi/lock",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Named locks (local by default; redis leases through the @dokebi/lock-redis driver) with fencing tokens",
+      "description": "Named lock backends for Dokebi with fencing tokens: in-process or Redis leases.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "lock",
+        "mutex",
+        "redis"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "lock.local"
+      ],
+      "variants": [],
+      "doesNot": [
+        "The Redis driver is installed separately (@dokebi/lock-redis)"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-redis",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "backends"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/lock"
+    },
+    {
+      "id": null,
+      "package": "@dokebi/lock-redis",
+      "version": "0.4.0",
+      "kind": "driver",
+      "summary": "Redis lease driver of @dokebi/lock (not a plugin: install it with npm install)",
+      "description": "Redis lease driver for @dokebi/lock (not a plugin; install with npm).",
+      "keywords": [
+        "dokebi",
+        "dokebi-driver",
+        "lock",
+        "redis"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "lock.redis"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Not installed with dokebi add",
+        "No Redlock (several Redis servers)"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [],
+      "driverOf": "dokebi-lock",
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npm install @dokebi/lock-redis"
+    },
+    {
+      "id": "dokebi-migrate",
+      "package": "@dokebi/migrate",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Migration and seed runner for dokebi-db connections (dokebi-migrate up in the deploy step)",
+      "description": "Migrations and seeds for dokebi-db connections: history and lock for PostgreSQL, MySQL, MariaDB and MongoDB, run from the deployment.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "database",
+        "migrations",
+        "seeds"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "db.migrate",
+        "db.seed"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No DDL when the app starts",
+        "No tables generated from ORM models"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [
+        {
+          "id": "dokebi-db",
+          "range": "^0.4.0",
+          "package": "@dokebi/db",
+          "automatic": true
+        }
+      ],
+      "optional": [],
+      "optionKeys": [
+        "connections",
+        "directory",
+        "lockTimeoutMs",
+        "lockTtlMs",
+        "onPending"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/migrate"
+    },
+    {
+      "id": "dokebi-module",
+      "package": "@dokebi/module",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Modules that hold one feature each (src/shared/modules/<module>); an app attaches them under a prefix",
+      "description": "Feature modules for Dokebi apps: controllers, models, views and routes in one folder mounted under a prefix.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "modules",
+        "mvc"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "web.modules"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Does not attach modules to apps by itself (modules in app.ts)"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/module"
+    },
+    {
+      "id": "dokebi-nats",
+      "package": "@dokebi/nats",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Named NATS connections (Core and JetStream publishing, durable consumers)",
+      "description": "Named NATS connections and bounded JetStream publication for Dokebi.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "nats",
+        "jetstream",
+        "messaging"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "messaging.nats"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No raw SDK client and no stream management rights"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-health",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "connections"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/nats"
+    },
+    {
+      "id": "dokebi-redis",
+      "package": "@dokebi/redis",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Named standalone Redis connections and leader election (coordination)",
+      "description": "Named, lifecycle-owned Redis connections for Dokebi with leader election and coordination.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "redis",
+        "coordination"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "redis.connection",
+        "redis.coordination"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No Cluster or Sentinel",
+        "No raw client, pipeline or transaction"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-health",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "connections"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/redis"
+    },
+    {
+      "id": "dokebi-router",
+      "package": "@dokebi/router",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Adds routes in a prefix scope on top of dokebi-web (mount)",
+      "description": "Prefix-mounted Fastify route scopes for @dokebi/web.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "router",
+        "routes"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "web.routing"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Does not require controllers, views or a database"
+      ],
+      "recipes": [],
+      "requires": [
+        {
+          "id": "dokebi-web",
+          "range": "^0.4.0"
+        }
+      ],
+      "optional": [],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/router"
+    },
+    {
+      "id": "dokebi-scheduler",
+      "package": "@dokebi/scheduler",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Submits fixed-interval and cron schedules as @dokebi/job jobs (one leader through Redis)",
+      "description": "Interval and cron schedules (with time zones) for Dokebi that submit jobs, with one leader over Redis.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "scheduler",
+        "cron",
+        "jobs"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "schedule.cron"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Does not run jobs itself (job runs them)"
+      ],
+      "recipes": [],
+      "requires": [
+        {
+          "id": "dokebi-job",
+          "range": "^0.4.0"
+        }
+      ],
+      "optional": [
+        {
+          "id": "dokebi-redis",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "allowInCluster",
+        "coordination",
+        "schedules",
+        "shutdownTimeoutMs"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/scheduler"
+    },
+    {
+      "id": "dokebi-seal",
+      "package": "@dokebi/seal",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Seals WebSocket frames and HTTP bodies (obfuscation, replay protection) with a browser client (WASM)",
+      "description": "Payload sealing (obfuscation, replay defence, in-transit encryption) for seal hosts: @dokebi/websocket frames and @dokebi/web HTTP bodies, with browser socket, fetch and Inertia clients and their WASM loader",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "seal",
+        "websocket",
+        "obfuscation"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "security.seal"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Not a replacement for confidentiality (TLS)",
+        "Not authentication, CSRF protection or a rate limit"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-web",
+          "range": "^0.4.0"
+        },
+        {
+          "id": "dokebi-websocket-hub",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/seal"
+    },
+    {
+      "id": "dokebi-session",
+      "package": "@dokebi/session",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Server-side sessions for @dokebi/web (signed cookie, memory or redis store, flash)",
+      "description": "Server-side sessions for @dokebi/web: signed cookie, memory or Redis store, flash.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "session",
+        "cookie"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "web.session"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Not user accounts or sign-in (there is no auth)",
+        "Does not issue CSRF tokens"
+      ],
+      "recipes": [
+        "blog"
+      ],
+      "requires": [
+        {
+          "id": "dokebi-web",
+          "range": "^0.4.0"
+        }
+      ],
+      "optional": [
+        {
+          "id": "dokebi-redis",
+          "range": "^0.4.0"
+        },
+        {
+          "id": "dokebi-health",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "absoluteMs",
+        "cookie",
+        "exclude",
+        "maxBytes",
+        "refreshBelow",
+        "rolling",
+        "secrets",
+        "secretsEnv",
+        "store",
+        "ttlMs"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/session"
+    },
+    {
+      "id": "dokebi-sse",
+      "package": "@dokebi/sse",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Server-sent events (SSE) streams and rooms, delivery across workers, and a browser client",
+      "description": "Server-sent events for @dokebi/web: authenticated streams, rooms, cross-worker fan-out over @dokebi/event-bus, and a browser client",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "sse",
+        "realtime"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "realtime.sse"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No ACK, redelivery or retention (at most once)"
+      ],
+      "recipes": [],
+      "requires": [
+        {
+          "id": "dokebi-web",
+          "range": "^0.4.0"
+        }
+      ],
+      "optional": [
+        {
+          "id": "dokebi-event-bus",
+          "range": "^0.4.0"
+        },
+        {
+          "id": "dokebi-health",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "allowInCluster",
+        "busEvent",
+        "eventBus",
+        "heartbeatMs",
+        "maxBufferedBytes",
+        "maxConnections",
+        "maxEventBytes",
+        "maxRooms",
+        "retryMs",
+        "shutdownTimeoutMs"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/sse"
+    },
+    {
+      "id": "dokebi-template-ejs",
+      "package": "@dokebi/template-ejs",
+      "version": "0.4.1",
+      "kind": "plugin",
+      "summary": "Compiles EJS templates at startup and renders them by name (layouts, partials, a scope per app)",
+      "description": "Precompiled EJS templates for Dokebi apps: layouts, partials and per-app scopes.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "views",
+        "ejs",
+        "templates"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "view.ejs"
+      ],
+      "variants": [
+        {
+          "name": "ejs",
+          "capability": "view.ejs"
+        }
+      ],
+      "doesNot": [
+        "No client-side page updates (SPA)"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [
+        "defaultLayout",
+        "extension",
+        "maxTemplateBytes",
+        "maxTemplates"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/template-ejs"
+    },
+    {
+      "id": "dokebi-template-inertia",
+      "package": "@dokebi/template-inertia",
+      "version": "0.4.1",
+      "kind": "plugin",
+      "summary": "Inertia (v3) server adapter: Vue 3 views, Vite build files and optional server-side rendering (SSR)",
+      "description": "Inertia v3 server adapter for Dokebi: page JSON, Vite manifest assets and optional server-side rendering.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "views",
+        "inertia",
+        "vue",
+        "ssr"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "view.inertia-vue",
+        "view.inertia-vue-ssr"
+      ],
+      "variants": [
+        {
+          "name": "vue",
+          "capability": "view.inertia-vue",
+          "alsoInstalls": [
+            "vite",
+            "vue",
+            "@inertiajs/vue3",
+            "@vitejs/plugin-vue"
+          ],
+          "needs": [
+            "vite-build"
+          ]
+        },
+        {
+          "name": "vue-ssr",
+          "capability": "view.inertia-vue-ssr",
+          "alsoInstalls": [
+            "vite",
+            "vue",
+            "@inertiajs/vue3",
+            "@vitejs/plugin-vue"
+          ],
+          "needs": [
+            "vite-build"
+          ]
+        }
+      ],
+      "doesNot": [
+        "No React skeleton",
+        "Vue and Vite are not server dependencies (they are dev dependencies of the app)"
+      ],
+      "recipes": [
+        "blog"
+      ],
+      "requires": [
+        {
+          "id": "dokebi-web",
+          "range": "^0.4.1"
+        }
+      ],
+      "optional": [
+        {
+          "id": "dokebi-session",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "encryptHistory",
+        "errorPage",
+        "rootId",
+        "scripts",
+        "ssr",
+        "styles",
+        "title",
+        "version",
+        "vite"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/template-inertia"
+    },
+    {
+      "id": "dokebi-web",
+      "package": "@dokebi/web",
+      "version": "0.4.1",
+      "kind": "plugin",
+      "summary": "Fastify 5 HTTP server (503 before ready, health paths, drain, zero-downtime cluster replacement)",
+      "description": "Fastify 5 HTTP server owned by a Dokebi app: 503 before ready, health routes, drain and cluster handover.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "http",
+        "fastify"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "web.http"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No built-in authentication, rate limit, CORS or security headers",
+        "No file upload (multipart)"
+      ],
+      "recipes": [
+        "api",
+        "blog"
+      ],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-health",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "developmentErrors",
+        "formBody",
+        "formMaxFields",
+        "healthRoutes",
+        "host",
+        "maxBodyBytes",
+        "port",
+        "requestTimeoutMs",
+        "sealDriftMs",
+        "sealExclude",
+        "trustProxy"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/web"
+    },
+    {
+      "id": "dokebi-websocket",
+      "package": "@dokebi/websocket",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "WebSocket routes, rooms and broadcast on top of dokebi-web (at most once)",
+      "description": "WebSocket routes on @dokebi/web with rooms and broadcast across servers through @dokebi/websocket-hub.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "web",
+        "websocket",
+        "realtime"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "realtime.websocket"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No delivery ACK or redelivery"
+      ],
+      "recipes": [],
+      "requires": [
+        {
+          "id": "dokebi-websocket-hub",
+          "range": "^0.4.0"
+        },
+        {
+          "id": "dokebi-web",
+          "range": "^0.4.0"
+        }
+      ],
+      "optional": [
+        {
+          "id": "dokebi-seal",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "heartbeatMs",
+        "hubWaitMs",
+        "idleTimeoutMs",
+        "maxBufferedBytes",
+        "maxConnections",
+        "maxPayloadBytes",
+        "maxPending",
+        "sealDriftMs",
+        "shutdownTimeoutMs"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/websocket"
+    },
+    {
+      "id": "dokebi-websocket-hub",
+      "package": "@dokebi/websocket-hub",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Hub of WebSocket clients, rooms, broadcast and kick (usually used through @dokebi/websocket)",
+      "description": "WebSocket hub for Dokebi: connection roster, rooms, broadcast and kick across workers and servers.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "websocket",
+        "hub",
+        "realtime"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "realtime.hub"
+      ],
+      "variants": [],
+      "doesNot": [
+        "No delivery ACK or redelivery"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [
+        {
+          "id": "dokebi-redis",
+          "range": "^0.4.0"
+        },
+        {
+          "id": "dokebi-nats",
+          "range": "^0.4.0"
+        }
+      ],
+      "optionKeys": [
+        "advertiseHost",
+        "allowInCluster",
+        "host",
+        "leaseMs",
+        "maxConnections",
+        "maxFrameBytes",
+        "maxOwners",
+        "maxPayloadBytes",
+        "maxPending",
+        "maxPendingBytes",
+        "maxTotalConnections",
+        "mode",
+        "namespace",
+        "natsConnection",
+        "ownerTtlMs",
+        "pollIntervalMs",
+        "port",
+        "redisConnection",
+        "secret",
+        "serverId",
+        "startupTimeoutMs"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": "README.md"
+      },
+      "install": "npx dokebi add @dokebi/websocket-hub"
+    },
+    {
+      "id": "dokebi-worker",
+      "package": "@dokebi/worker",
+      "version": "0.4.0",
+      "kind": "plugin",
+      "summary": "Runs CPU-heavy functions in a worker thread pool",
+      "description": "Worker thread pool for CPU-heavy functions in a Dokebi app.",
+      "keywords": [
+        "dokebi",
+        "dokebi-plugin",
+        "worker-threads",
+        "cpu",
+        "pool"
+      ],
+      "maturity": "preview",
+      "core": "^0.4.0",
+      "provides": [
+        "worker.thread"
+      ],
+      "variants": [],
+      "doesNot": [
+        "Not several processes (cluster)",
+        "Not a distributed job queue (@dokebi/job)"
+      ],
+      "recipes": [],
+      "requires": [],
+      "optional": [],
+      "optionKeys": [
+        "executionTimeoutMs",
+        "maxPending",
+        "maxThreadCrashes",
+        "module",
+        "size",
+        "startupTimeoutMs",
+        "threadCrashWindowMs"
+      ],
+      "docs": {
+        "ai": "AI.md",
+        "readme": null
+      },
+      "install": "npx dokebi add @dokebi/worker"
+    }
+  ],
+  "recipes": [
+    {
+      "name": "api",
+      "summary": "JSON API server (one app, one JSON module and a database of your choice)",
+      "match": [
+        "api",
+        "rest",
+        "json",
+        "backend"
+      ],
+      "capabilities": [
+        "web.apps",
+        "web.modules"
+      ],
+      "questions": [
+        "db",
+        "devInfra"
+      ],
+      "fixed": {
+        "view": "ejs",
+        "admin": "none"
+      },
+      "module": {
+        "name": "items",
+        "views": false,
+        "why": "A feature module that answers JSON: write the API in its routes.ts and controllers"
+      },
+      "web": {
+        "port": 3000,
+        "domain": "localhost"
+      },
+      "then": [
+        "Attach the module to the app: modules: { \"/api/items\": items } in src/apps/main/app.ts"
+      ]
+    },
+    {
+      "name": "blog",
+      "summary": "A blog web app with a post list and post pages (choose the views, database, development database and admin area)",
+      "match": [
+        "blog",
+        "board",
+        "posts",
+        "articles",
+        "cms"
+      ],
+      "capabilities": [
+        "web.apps",
+        "web.modules"
+      ],
+      "questions": [
+        "view",
+        "db",
+        "devInfra",
+        "admin"
+      ],
+      "module": {
+        "name": "posts",
+        "why": "The module for the posts feature: write its controllers, models and routes here"
+      },
+      "web": {
+        "port": 3000,
+        "domain": "localhost",
+        "forms": true
+      },
+      "then": [
+        "Attach the module to the app: modules: { \"/posts\": posts } in src/apps/main/app.ts (posts = the default export of src/shared/modules/posts/module.ts)",
+        "Write the post list (GET /posts) and the post page (GET /posts/:id) in the routes.ts and controllers of the module",
+        "The write form (GET /posts/new → POST /posts) reads request.body (with EJS the recipe turned on dokebi-web.formBody). With --admin none it is a public form (no login); with app-code it belongs to the admin app. Either way it needs a CSRF token check in app code (csrf is absent). A refused post throws validationError({ title: \"Required\" }) from @dokebi/web (D-0074): an EJS form shows data.errors.title and data.old.title (with @dokebi/session the refused post goes back to the form, 303; without it views/default/errors/422.ejs or errors/error.ejs shows the fields), an Inertia form gets them in form.errors (submit with only). Edit the shared layout src/shared/views/layouts/main.ejs where it is"
+      ]
+    }
+  ],
+  "choices": [
+    {
+      "id": "admin",
+      "flag": "--admin",
+      "from": "fixed",
+      "question": "Do you need an admin area (a login that protects writing and managing posts)?",
+      "default": "none",
+      "defaultReason": "There is no auth plugin, so the app would have to write the login itself. When the request does not mention an admin area, none is made; a public write form is still possible (it needs no login)",
+      "options": [
+        {
+          "value": "none",
+          "label": "None (no login and no admin area; a public write form is still possible)",
+          "capability": null,
+          "available": true,
+          "absent": false,
+          "plugins": [],
+          "alsoInstalls": [],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "The simplest choice with the smallest attack surface",
+            "Posts can still be written in the browser with a public write form (with EJS the recipe turns on dokebi-web.formBody for it)"
+          ],
+          "cons": [
+            "Without a login anyone who can open the site can use the write form",
+            "The write form has no CSRF protection until the app adds a token check (csrf is absent)"
+          ]
+        },
+        {
+          "value": "app-code",
+          "label": "An admin app written in app code",
+          "capability": null,
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/session"
+          ],
+          "alsoInstalls": [],
+          "needs": [],
+          "absentFeatures": [
+            "auth",
+            "admin.ui"
+          ],
+          "pros": [
+            "One app on its own domain (such as admin.localhost) with sessions is set up"
+          ],
+          "cons": [
+            "Login, password hashing, permission checks and CSRF must be written in app code (there is no plugin)"
+          ]
+        }
+      ]
+    },
+    {
+      "id": "db",
+      "flag": "--db",
+      "from": "variants",
+      "capabilityPrefix": "db.",
+      "question": "Which database should the app use?",
+      "default": "postgres",
+      "defaultReason": "The most widely used default for relational SQL, and it handles migrations, transactions and full-text search well",
+      "options": [
+        {
+          "value": "postgres",
+          "label": "PostgreSQL",
+          "capability": "db.postgres",
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/db"
+          ],
+          "alsoInstalls": [
+            "pg"
+          ],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "A general-purpose database with standard SQL, transactions, JSON columns and full-text search",
+            "Many hosting choices (managed databases) for production"
+          ],
+          "cons": [
+            "Needs its own server (one line with docker for development)"
+          ]
+        },
+        {
+          "value": "mysql",
+          "label": "MySQL",
+          "capability": "db.mysql",
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/db"
+          ],
+          "alsoInstalls": [
+            "mysql2"
+          ],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "Common on web hosting, with plenty of material"
+          ],
+          "cons": [
+            "Check its lenient defaults (character set, SQL mode)",
+            "Needs its own server"
+          ]
+        },
+        {
+          "value": "mariadb",
+          "label": "MariaDB",
+          "capability": "db.mariadb",
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/db"
+          ],
+          "alsoInstalls": [
+            "mariadb"
+          ],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "Open source and MySQL compatible, a default package of Linux distributions"
+          ],
+          "cons": [
+            "Some features differ subtly from MySQL",
+            "Needs its own server"
+          ]
+        },
+        {
+          "value": "mongodb",
+          "label": "MongoDB",
+          "capability": "db.mongodb",
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/db"
+          ],
+          "alsoInstalls": [
+            "mongodb"
+          ],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "Stores documents (JSON) without a schema, handy for data whose shape changes often, such as posts"
+          ],
+          "cons": [
+            "Relations, joins and transactions are less convenient than in a SQL database",
+            "Needs its own server"
+          ]
+        },
+        {
+          "value": "sqlite",
+          "label": "SQLite",
+          "capability": "db.sqlite",
+          "available": false,
+          "absent": true,
+          "why": "There is no SQLite adapter or driver template. Choose postgres, mysql, mariadb or mongodb (docker starts one for development right away)",
+          "plugins": [],
+          "alsoInstalls": [],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [],
+          "cons": []
+        },
+        {
+          "value": "none",
+          "label": "No database",
+          "kind": "none",
+          "capability": null,
+          "available": true,
+          "absent": false,
+          "plugins": [],
+          "alsoInstalls": [],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "The simplest to install and run"
+          ],
+          "cons": [
+            "Posts are not stored (the app handles memory or files itself)"
+          ]
+        }
+      ]
+    },
+    {
+      "id": "devInfra",
+      "flag": "--dev-infra",
+      "from": "fixed",
+      "when": {
+        "db": "!none"
+      },
+      "question": "How should the development database server be provided?",
+      "default": "docker",
+      "defaultReason": "One compose.yaml starts and removes a database of the same version without installing anything",
+      "options": [
+        {
+          "value": "docker",
+          "label": "Start it with Docker (compose.yaml)",
+          "capability": null,
+          "available": true,
+          "absent": false,
+          "plugins": [],
+          "alsoInstalls": [],
+          "needs": [
+            "docker"
+          ],
+          "absentFeatures": [],
+          "pros": [
+            "dokebi dev-infra writes compose.yaml, .env (the password) and the connection URL in dokebi.yaml",
+            "A separate database per project, easy to remove"
+          ],
+          "cons": [
+            "Docker must be installed and running",
+            "When the port is taken, choose another one with --db-port (it is never changed behind your back)"
+          ]
+        },
+        {
+          "value": "url",
+          "label": "Connect to a database server you already have",
+          "capability": null,
+          "available": true,
+          "absent": false,
+          "plugins": [],
+          "alsoInstalls": [],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "No Docker needed"
+          ],
+          "cons": [
+            "You write the connection URL (with its password) into dokebi.yaml yourself (never pass it with --set)"
+          ]
+        }
+      ]
+    },
+    {
+      "id": "view",
+      "flag": "--view",
+      "from": "variants",
+      "capabilityPrefix": "view.",
+      "question": "What should the views (screens) be built with?",
+      "default": "ejs",
+      "defaultReason": "No build step and it runs right away on one server. Enough for blog screens such as the post list and a post page",
+      "options": [
+        {
+          "value": "ejs",
+          "label": "EJS server rendering",
+          "capability": "view.ejs",
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/template-ejs"
+          ],
+          "alsoInstalls": [],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [
+            "Runs right away without a build (Vite)",
+            "The server sends finished HTML, good for search engines and slow devices",
+            "Few files, easy to learn first"
+          ],
+          "cons": [
+            "Every page change loads the whole page again",
+            "Rich interaction on a page needs hand-written JavaScript"
+          ]
+        },
+        {
+          "value": "inertia-vue",
+          "label": "Inertia + Vue 3",
+          "capability": "view.inertia-vue",
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/template-inertia"
+          ],
+          "alsoInstalls": [
+            "vite",
+            "vue",
+            "@inertiajs/vue3",
+            "@vitejs/plugin-vue"
+          ],
+          "needs": [
+            "vite-build"
+          ],
+          "absentFeatures": [],
+          "pros": [
+            "Fast page changes that feel like a SPA, with screens split into components",
+            "Server routes and controllers stay as they are (no separate API)"
+          ],
+          "cons": [
+            "Needs npm run build (Vite) and installs vue and vite",
+            "The browser draws the first screen after running JavaScript (worse for search engines)"
+          ]
+        },
+        {
+          "value": "inertia-vue-ssr",
+          "label": "Inertia + Vue 3 + server rendering",
+          "capability": "view.inertia-vue-ssr",
+          "available": true,
+          "absent": false,
+          "plugins": [
+            "@dokebi/template-inertia"
+          ],
+          "alsoInstalls": [
+            "vite",
+            "vue",
+            "@inertiajs/vue3",
+            "@vitejs/plugin-vue"
+          ],
+          "needs": [
+            "vite-build"
+          ],
+          "absentFeatures": [],
+          "pros": [
+            "The strengths of Inertia, and the server draws the first HTML, so search engines and the first paint are fast"
+          ],
+          "cons": [
+            "Two builds (browser and server) and the most configuration",
+            "Uses more server memory and CPU"
+          ]
+        },
+        {
+          "value": "inertia-react",
+          "label": "Inertia + React",
+          "capability": "view.inertia-react",
+          "available": false,
+          "absent": true,
+          "why": "There is no Inertia React skeleton (Vue 3 only). Choose inertia-vue or use EJS. If React is a must, tell the user and set it up by hand",
+          "plugins": [],
+          "alsoInstalls": [],
+          "needs": [],
+          "absentFeatures": [],
+          "pros": [],
+          "cons": []
+        }
+      ]
+    }
+  ],
+  "absent": [
+    {
+      "capability": "admin.ui",
+      "summary": "There are no generated admin screens (CRUD generator)",
+      "instead": "Create one more app with dokebi app add admin --domain admin.localhost and write its screens in app code (there is no auth either, so the app writes the login)",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "auth",
+      "summary": "There is no login, sign-up or permission plugin",
+      "instead": "Write it in app code. Keep the login state in @dokebi/session and hash passwords with scrypt from node:crypto. Install an outside auth library only with the permission of the user",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "csrf",
+      "summary": "There is no CSRF token plugin",
+      "instead": "The app keeps a random token in the session and compares it with a hidden form field or a header (the @dokebi/session AI.md says what sameSite does and does not block)",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "db.sqlite",
+      "summary": "There is no SQLite adapter or driver template",
+      "instead": "Choose postgres, mysql, mariadb or mongodb (docker starts one for development right away)",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "i18n",
+      "summary": "There is no i18n plugin",
+      "instead": "Keep an object of strings per language in app code",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "mail",
+      "summary": "There is no mail plugin",
+      "instead": "With the permission of the user, use an SMTP library in app code. Mail that must be sent goes through an @dokebi/job job",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "markdown",
+      "summary": "There is no Markdown converter",
+      "instead": "Store and show post bodies as plain text (EJS escapes with <%= %>), or use a Markdown library with the permission of the user",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "orm",
+      "summary": "There is no ORM or query builder (use the driver API as it is)",
+      "instead": "Query with the pg, mysql2, mariadb or mongodb API that connection(main) of @dokebi/db returns (main is the connection definition in src/infra/db/connections.ts)",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "rate-limit",
+      "summary": "There is no rate limit plugin",
+      "instead": "Limit requests in the front proxy (nginx or similar), or register a Fastify plugin with the permission of the user",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "rss",
+      "summary": "There is no RSS or Atom feed generator",
+      "instead": "Build the XML string in a controller and answer with application/rss+xml",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "search",
+      "summary": "There is no full-text search plugin",
+      "instead": "Use LIKE or the full-text search of the database (such as postgres tsvector) in app code",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "upload",
+      "summary": "There is no file upload (multipart) plugin",
+      "instead": "With the permission of the user the app registers a Fastify multipart plugin, or it starts without uploads",
+      "verify": [
+        "no-provider"
+      ]
+    },
+    {
+      "capability": "view.inertia-react",
+      "summary": "There is no Inertia React skeleton (Vue 3 only)",
+      "instead": "Choose inertia-vue or use EJS. If React is a must, tell the user and set it up by hand",
+      "verify": [
+        "no-provider",
+        "no-flag:app add --react"
+      ]
+    }
+  ]
+}