@sylphx/flow 3.9.1 → 3.11.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @sylphx/flow
 
+## 3.11.0 (2026-02-03)
+
+### ✨ Features
+
+- **builder:** add build-time migration verification with push --dry-run ([3a6b609](https://github.com/SylphxAI/flow/commit/3a6b609e8554ebd1be917f683a7f6be1626de2e9))
+
+### 🔧 Chores
+
+- trigger release ([919ccd0](https://github.com/SylphxAI/flow/commit/919ccd0833b0122627732095efe24c85c5a2ff27))
+
+## 3.10.0 (2026-02-03)
+
+### ✨ Features
+
+- **builder:** improve BUILDER prompt - CLAUDE.md limits, error handling, migrations ([f484831](https://github.com/SylphxAI/flow/commit/f484831b30b558330539fac8a9a5e0169217b12a))
+
+### 🐛 Bug Fixes
+
+- **builder:** CLAUDE.md - add back what to write ([d6f2f77](https://github.com/SylphxAI/flow/commit/d6f2f7772727f9226ae81728922823aa96d3ea95))
+
+### ♻️ Refactoring
+
+- **builder:** CLAUDE.md - methodology over limitation ([b1ea52d](https://github.com/SylphxAI/flow/commit/b1ea52d83c7a77136708be42726ddb2f6ac8d496))
+
 ## 3.9.1 (2026-02-02)
 
 Simplify BUILDER system prompt guidelines:

package/assets/agents/builder.md

@@ -108,13 +108,11 @@ Vercel CLI, Neon CLI, Modal CLI, GitHub CLI — use directly, install if missing
 
 **Todos.** Track what needs to be done next. This is your memory of what to do.
 
-**CLAUDE.md** — Your persistent memory file. Write to it when you discover:
-- Project-specific commands (build, test, deploy, lint)
-- Environment setup (env vars, prerequisites, dependencies)
-- Architecture decisions and their reasoning
-- Common patterns and conventions used in this codebase
-- Gotchas, workarounds, or non-obvious behaviors
-- Frequently referenced paths, configs, or resources
+**CLAUDE.md** — Your persistent memory file.
+
+What: commands, env setup, architecture decisions, patterns, gotchas.
+
+How: Read first. Summarize, don't append. Remove resolved. Consolidate duplicates.
 
 **Recovery:**
 - Lost context? → Check `git log` for history
@@ -144,22 +142,25 @@ Vercel CLI, Neon CLI, Modal CLI, GitHub CLI — use directly, install if missing
 * Recoverability — systems must be swiftly restorable without data loss
 * If automation exists for a task, manual execution is prohibited
 
+## Error Handling
+
+**Fail loud.** If something unexpected happens, throw — don't log and continue.
+
+Assume no one reads logs. If it's worth logging, it's worth throwing.
+
 ## Database Migrations (Drizzle)
 
-**Workflow:** Generate locally, migrate automatically.
+**Source of truth = migration SQL, not schema.**
+
+Write migration SQL directly. Update `_journal.json`. Skip `drizzle-kit generate` — it's not AI-friendly.
+
+**Build-time verification:**
 
-1. Modify `schema.ts`
-2. Run `drizzle-kit generate` (manual, local)
-3. Review generated SQL migration file
-4. Commit migration files to git
-5. Deploy → `drizzle-kit migrate` runs in Vercel build step
+```bash
+drizzle-kit migrate && drizzle-kit push --dry-run
+```
 
-**Principles:**
-- Generate = manual (may prompt for decisions like rename vs drop+add)
-- Migrate = automatic (in build step, before app starts)
-- Migration files = committed to git (version controlled, reviewable)
-- Backward compatible migrations only (old code must work with new schema during deploy)
-- Preview deployments use Neon branching (isolated DB per PR)
+After `migrate`, run `push --dry-run` to verify DB matches schema.ts. If there's any diff, migration is incomplete — fail the build.
 
 ## Architecture Principles
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "3.9.1",
+	"version": "3.11.0",
 	"description": "One CLI to rule them all. Unified orchestration layer for AI coding assistants. Auto-detection, auto-installation, auto-upgrade.",
 	"type": "module",
 	"bin": {