@adep/cli 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -130,8 +130,13 @@ adep init my-app -t function # 仅云函数
130
130
  adep init my-app -t empty # 空模板
131
131
  adep init --list # 从平台 GET /api/v1/templates 列出可用模板
132
132
  adep init --list -s https://platform.example.com
133
+ adep templates publish -t fullstack # 上传平台托管模板包(需登录;模板目录须含 template.json)
133
134
  ```
134
135
 
136
+ 模板来源(CLI-020):`adep init` 优先下载**平台托管模板包**(`GET /api/v1/templates/:code/package`,
137
+ 缓存到 `~/.adep/templates/<code>-<version>.json`);平台无包 / 下载失败 / 离线时自动回退本地内置模板。
138
+ 模板包为 JSON 文件映射,与本地内置模板共用同一套 `{{var}}` 渲染管线。
139
+
135
140
  产物结构(`fullstack` 模板,CLI-014:vite 工程根在项目根目录):
136
141
 
137
142
  ```
@@ -221,12 +226,19 @@ adep dev -p 3000 # 指定端口
221
226
  adep serve # 默认 127.0.0.1:8787(PORT / HOST 环境变量可覆盖)
222
227
  adep serve -p 9000 # 指定端口
223
228
  adep serve --static web # 指定静态托管目录(缺省 public/)
229
+ adep serve --db sqlite # 真实 SQLite 库文件(缺省 .adep/data/project.sqlite)
230
+ adep serve --db sqlite --db-file var/local.sqlite # 指定库文件
224
231
  ```
225
232
 
226
- - 缺省值优先级为「命令行旗标 > 环境变量(`PORT` / `HOST` / `ADEP_SERVE_STATIC_DIR`)> 内置缺省」,容器编排注入的 `PORT` / `HOST` 不会被命令行缺省盖掉。
233
+ - 缺省值优先级为「命令行旗标 > 环境变量(`PORT` / `HOST` / `ADEP_SERVE_STATIC_DIR` / `ADEP_SERVE_DB` / `ADEP_SERVE_DB_FILE`)> 内置缺省」,容器编排注入的 `PORT` / `HOST` 不会被命令行缺省盖掉。
227
234
 
228
235
  - 绑定非回环地址时给出对外暴露警告(它不带生产级加固)。
229
236
 
237
+ - 数据库两档模式(`--db`):
238
+ - `sim`(缺省):内置模拟引擎,库是 JSON 文件 `.adep/sim/db.json`。`--schema` 只支持 DDL 子集,其余语句跳过并告警;
239
+ - `sqlite`:**真实 SQLite 库文件**,驱动按运行时分派(Bun → `bun:sqlite`,Node ≥ 22.5 → `node:sqlite`)。`--schema` 的每条语句都真实执行,**失败即停**(视图 / 唯一索引 / 触发器等 sim 做不到的能力全可用)。运行时两者都没有时拒绝启动并提示回退 `--db sim`。
240
+ - 模式名写错(旗标或环境变量)一律拒绝启动,不静默换库;启动横幅与根路径 `/` 会回显 `db.mode` / `db.file` / `db.driver`。
241
+
230
242
  ### `adep publish`
231
243
 
232
244
  全栈发布顶层命令(CLI-010):函数部署 + 前端构建托管一把梭。
@@ -270,6 +282,8 @@ adep deploy -p my-app # 显式指定目标 slug
270
282
  ```
271
283
 
272
284
  - 本地 `functions/<name>.ts` 对应平台函数 `<name>`(入口文件固定为 `index.ts`)。
285
+ 目录形态 `functions/<name>/index.ts` **等价**:目录内其余文件是该函数的私有文件,随草稿整组上传
286
+ (默认模板生成扁平形态;两种形态不可同名并存 —— 并存时命令非零退出并列出冲突路径)。
273
287
 
274
288
  - **幂等**:内容与已发布版本一致时输出 `no changes`,不产生新版本。
275
289