@adep/cli 0.4.11 → 0.5.0

package/README.md

@@ -286,8 +286,14 @@ adep publish --only functions         # 只发布云函数
 adep publish --only frontend          # 只发布前端（vite 工程平台侧构建；纯静态站直通托管通道）
 adep publish --only frontend --env dev   # 前端发到**开发站点**（site-dev/ + dev- 子域 + 独立版本序列）
 adep publish -p my-app                # 显式指定目标 slug
+adep publish --allow-drift            # 确认可容忍 schema 漂移时显式放行（不推荐：上线即 500）
 ```
 
+- **发布前 schema 漂移检查**：本地 `database/schema.sql` 与线上目录存在缺表 / 缺列 / 类型不一致
+  时以 `SCHEMA_DRIFT_DETECTED` 阻断（不发注定 `no such column` 的函数）；先 `adep db doctor`
+  看漂移、`adep db migrate --plan` 复核后去掉 `--plan` 执行。库未启动 / 项目无 schema 文件时
+  打印跳过原因（不静默）。
+
 - **函数部分**：扫描本地 `functions/` 计算内容哈希 → 调平台 `/api/v1/deploy/diff` 拿差异清单 →
   仅上传变更函数 → 发布 → 输出访问域名（与 `adep deploy` 同一管线）。
 
@@ -445,6 +451,16 @@ adep db tables --table users
 adep db exec --sql "SELECT * FROM users"
 adep db exec --sql "DELETE FROM users WHERE id = 1" --confirm-table users
 
+# 批量 SQL（单事务，任一条失败整体回滚）
+adep db exec --file seed.sql
+
+# 迁移：先看漂移计划（+table / +column / !type），再执行增量 DDL
+adep db migrate schema.sql --plan
+adep db migrate schema.sql
+
+# 全库漂移报告（本地 schema 与线上目录逐表逐列对比）
+adep db doctor
+
 # 快照（付费档位）：列出 / 创建 / 还原
 adep db snapshot list
 adep db snapshot create
@@ -456,6 +472,8 @@ adep db rollback --to 2026-01-01T00:00:00.000Z
 
 `db exec` 人读模式下返回对齐文本表（结果行截断时会提示），`--json` 输出结构化结果。
 
+`db migrate` 先做 plan/diff 再增量执行（缺表建表 + `ADD COLUMN`，幂等，记录在 `_adep_migrations` 版本表）——`CREATE TABLE IF NOT EXISTS` 在表已存在时不再静默空操作；`PRIMARY KEY` / 无默认值的 `NOT NULL` 新列与破坏性变更（`DROP` / 改类型 / `RENAME`）拒绝自动执行（`DB_SCHEMA_DESTRUCTIVE`）。
+
 - **环境（`--env`）**：`exec` / `migrate` / `tables` 按全局 `--env dev|prod` 选库，优先级
   `--env` > `ADEP_ENV` > `adep.config.ts` 的 `db_environment` > `prod`；每条命令都打印生效环境**及来源**。
   服务端一直支持 `?environment=`，CLI 之前不传 ⇒ `exec` 恒打生产库，开发者在 dev 建的表用 CLI 一查