@dedesfr/prompter 0.8.17 → 0.8.18

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # CHANGELOG
 
+## [0.8.18] - 2026-05-06
+
+### 🔄 Changed
+- **project-orchestrator Skill**: Added self-hosted Convex storage backend guidance for SQLite vs Postgres
+  - Clarifies when to use SQLite for dev or hobby deployments and when to use Postgres for production
+  - Frames Postgres as Convex's storage engine for self-hosted setups, with backup and scaling guidance
+- **Plan Summary Template**: Added a dedicated Convex storage backend row for self-hosted deployments
+  - Captures the SQLite or PostgreSQL choice directly in the generated project summary
+
 ## [0.8.17] - 2026-05-05
 
 ### 🔄 Changed

package/dist/cli/index.js

@@ -16,7 +16,7 @@ const program = new Command();
 program
     .name('prompter')
     .description('Enhance prompts directly in your AI coding workflow')
-    .version('0.8.17');
+    .version('0.8.18');
 program
     .command('init')
     .description('Initialize Prompter in your project')

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dedesfr/prompter",
-    "version": "0.8.17",
+    "version": "0.8.18",
     "description": "Enhance prompts directly in your AI coding workflow",
     "type": "module",
     "main": "dist/index.js",

package/skills/project-orchestrator/SKILL.md

@@ -264,6 +264,11 @@ After the user picks a bundle, ask ONLY the necessary sub-choices:
 - Next.js vs React (Vite)? (Recommend Next.js if SEO matters; Vite if it's a dashboard or real-time app where SSR isn't needed)
 - No database sub-choice needed -- Convex includes a built-in document database with real-time sync.
 - **Convex hosting**: Convex Cloud (managed, easiest) vs Self-Hosted (Docker, full control)? (Recommend Convex Cloud for most projects -- zero infrastructure overhead. Recommend Self-Hosted if the user needs data sovereignty, air-gapped environments, or wants to avoid vendor lock-in.)
+- **Convex storage backend** (Self-Hosted only): SQLite vs Postgres?
+  - **SQLite** — single file on disk, zero config. Fine for dev/hobby projects up to ~1–2 GB data on a single server. Back up by copying the file.
+  - **Postgres** — networked database. Required for production: handles concurrent connections, proper backups (`pg_dump` to S3/R2), point-in-time recovery, and horizontal scaling. Add a `postgres` service to `docker-compose.yml` and pass `DATABASE_URL` to Convex.
+  - **Important framing**: Postgres is Convex's *storage engine*, not your application database. You never write SQL or query Postgres directly — Convex reads/writes its own internal format there. You only touch Postgres for ops: running the container and taking backups.
+  - Recommend Postgres for any self-hosted project with real users. Recommend SQLite only for solo dev environments or throwaway prototypes.
 
 **Bundle 3 sub-choices:**
 - MySQL vs PostgreSQL? (Same guidance as above)
@@ -315,6 +320,9 @@ When the user chooses a Laravel stack (Bundle 3, 4, or 5) with Docker:
 
 When the user chooses React + Convex (Bundle 2) with **self-hosted** deployment:
 
+- **Storage backend**: Include in `docker-compose.yml` based on what the user chose:
+  - **SQLite** (dev/hobby): No extra service needed — Convex stores data in a local SQLite file inside the container. Mount a volume to persist it across restarts.
+  - **Postgres** (production): Add a `postgres` service (e.g., `postgres:16`) and pass `DATABASE_URL` to the Convex container. Postgres is Convex's internal filing cabinet — the user's data lives in `document_json` columns managed by Convex, not in SQL tables they'd recognize. The user never writes SQL; they only run `pg_dump` for backups.
 - **Use Docker Compose** with two Convex services:
   - `convex` — backend image `ghcr.io/get-convex/convex-backend:latest`
   - `convex-dashboard` — dashboard image `ghcr.io/get-convex/convex-dashboard:latest`

package/skills/project-orchestrator/assets/plan-summary-template.md

@@ -72,6 +72,7 @@
 | ORM / DB Layer | [e.g., Drizzle / Convex built-in] | [Why] |
 | Database | [e.g., PostgreSQL / Convex document DB] | [Why] |
 | Convex Hosting | [Cloud / Self-Hosted] | [Why -- only include if using Convex] |
+| Convex Storage Backend | [SQLite / PostgreSQL -- only include if self-hosted Convex] | [Why -- SQLite for dev/hobby; Postgres for production] |
 | Styling | [e.g., Tailwind CSS] | [Why] |
 | Web Server | [e.g., Caddy] | [Why -- include when Docker is used] |
 | Docker | Yes/No | [Why] |

package/src/cli/index.ts

@@ -18,7 +18,7 @@ const program = new Command();
 program
   .name('prompter')
   .description('Enhance prompts directly in your AI coding workflow')
-  .version('0.8.17');
+  .version('0.8.18');
 
 program
   .command('init')