@newbeebox/newbeebox-app-engine-cli 1.0.2 → 1.1.0

package/README.md

@@ -1,8 +1,8 @@
 # nae —— NewBee App Engine CLI
 
-平台命令行客户端。**参数直达、默认人类可读**，加 `-o json` 即出 JSON，便于 CodeAgent 编排调用。
+平台命令行客户端。**参数直达、默认人类可读**，加 `-o json` 即出 JSON，便于脚本/管道里解析。
 
-> 📖 **完整文档（含 Agent 用法范例 / 调试技巧）**：<https://workshop.newbeebox.com/app_engine/documents/nae-cli/>
+> 📖 **完整文档（含用法范例 / 调试技巧）**：<https://workshop.newbeebox.com/app_engine/documents/nae-cli/>
 > markdown 原文：<https://workshop.newbeebox.com/app_engine/documents/nae-cli/md/>
 
 ---
@@ -31,7 +31,7 @@ nae login
 nae login --token nae_xxxxxxxx
 ```
 
-CI / Agent 场景免登录，直接用环境变量（优先级高于本地配置）：
+CI / 脚本场景免登录，直接用环境变量（优先级高于本地配置）：
 
 ```bash
 export NAE_TOKEN=nae_xxxxxxxx
@@ -49,7 +49,7 @@ nae apps
 - **stderr**：只放给人看的提示、进度、错误。
 - **退出码**：`0` 成功；`1` 业务错误；`2` 未登录/密钥失效；`3` 网络不可达。
 
-所以 Agent 可以安全地 `nae apps -o json 2>/dev/null | jq '.[].AppID'`。
+所以脚本里可以安全地 `nae apps -o json 2>/dev/null | jq '.[].AppID'`。
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@newbeebox/newbeebox-app-engine-cli",
-  "version": "1.0.2",
-  "description": "NewBee App Engine 命令行客户端（nae）——参数直达、默认人类可读（加 -o json 出 JSON），便于人用与 CodeAgent 调用平台能力。",
+  "version": "1.1.0",
+  "description": "NewBee App Engine 命令行客户端（nae）——参数直达、默认人类可读（加 -o json 出 JSON），便于在终端使用与脚本/管道里解析。",
   "type": "module",
   "bin": {
     "nae": "src/index.js"
@@ -20,7 +20,6 @@
     "paas",
     "kubernetes",
     "deploy",
-    "codeagent",
     "nae"
   ],
   "homepage": "https://workshop.newbeebox.com/app_engine/documents/nae-cli/",

package/src/config.js

@@ -10,7 +10,7 @@ const CONFIG_DIR = join(homedir(), '.nae')
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json')
 
 // load 读配置；文件不存在/损坏一律回落到默认（不抛错，让首次使用顺畅）。
-// 环境变量优先级最高：NAE_BASE_URL / NAE_TOKEN 覆盖文件值（CI/agent 免登录直跑）。
+// 环境变量优先级最高：NAE_BASE_URL / NAE_TOKEN 覆盖文件值（CI/脚本 免登录直跑）。
 export function load() {
   let cfg = { baseUrl: DEFAULT_BASE_URL, token: '' }
   try {

package/src/index.js

@@ -13,8 +13,8 @@ const program = new Command()
 
 program
   .name('nae')
-  .description('NewBee App Engine CLI —— 默认人类可读，-o json 输出 JSON 供 CodeAgent 调用')
-  .version('1.0.2')
+  .description('NewBee App Engine CLI —— 默认人类可读，-o json 输出 JSON 供脚本解析')
+  .version('1.1.0')
   .option('--base-url <url>', '覆盖平台地址（也可用环境变量 NAE_BASE_URL）')
   .option('--token <token>', '覆盖访问密钥（也可用环境变量 NAE_TOKEN）')
   .option('-o, --output <format>', '输出格式：text（默认，人类可读）| json', 'text')
@@ -176,7 +176,7 @@ program
   .option('--env <json>', '环境变量 JSON，如 \'{"KEY":"val"}\'')
   .option(
     '--config <json>',
-    "模板应用的服务特性参数 JSON。可用字段随模板而定，运行 'nae templates' 看每个模板的 ConfigSchema（key/类型/默认值/可选项）。redis: {\"password\",\"persistence\":\"rdb|aof|none\"}；milvus: {\"root_password\"}"
+    "模板应用的服务特性参数 JSON。可用字段随模板而定，运行 'nae templates' 看每个模板的 ConfigSchema（key/类型/默认值/可选项）。redis: {\"password\",\"persistence\":\"rdb|aof|none\"}；postgres: {\"database\",\"username\",\"password\"}；milvus: {\"root_password\"}"
   )
   .option('--owner <uid>', '管理员代他人创建时的归属用户 ID', (v) => parseInt(v, 10))
   .addHelpText(
@@ -193,6 +193,10 @@ program
   nae create --kind template --app-id myredis --template redis --storage 2Gi \\
     --config '{"password":"s3cret","persistence":"rdb"}'
 
+  # 模板应用 PostgreSQL 14：持久化 + 库名/用户名/密码
+  nae create --kind template --app-id mypg --template postgres --storage 5Gi \\
+    --config '{"database":"appdb","username":"appuser","password":"s3cret"}'
+
   # 模板应用 Milvus
   nae create --kind template --app-id myvec --template milvus --storage 10Gi \\
     --config '{"root_password":"s3cret"}'
@@ -247,6 +251,20 @@ program
   .description('滚动重启应用')
   .action(run(async (id) => emit(await request(cfg(), 'POST', `/apps/${id}/restart`))))
 
+program
+  .command('reset-password <appid>')
+  .description('重置模板应用连接密码（不清数据；当前支持 Redis/PostgreSQL）。留空 --password 则随机生成')
+  .option('--password <pw>', '指定新密码（留空=平台随机生成；可打印 ASCII，1-128 位）')
+  .action(
+    run(async (id, opts) => {
+      emit(
+        await request(cfg(), 'POST', `/apps/${id}/reset-credential`, {
+          body: { password: opts.password ?? '' },
+        })
+      )
+    })
+  )
+
 program
   .command('scale <appid> <replicas>')
   .description('扩缩容到指定副本数')

package/src/output.js

@@ -1,8 +1,8 @@
 // 输出契约：
-//   - 默认输出「人类可读」文本到 stdout；加 `-o json`（或 `-c` 紧凑）才出 JSON，供 Agent 解析。
+//   - 默认输出「人类可读」文本到 stdout；加 `-o json`（或 `-c` 紧凑）才出 JSON，供脚本解析。
 //   - stderr 只放「给人看的」：提示、进度、错误。
 //   - 退出码：成功 0，失败非 0。
-// 人读默认、机读按需——人直接看懂，Agent 用 `nae … -o json 2>/dev/null | jq …`。
+// 人读默认、机读按需——人直接看懂，脚本用 `nae … -o json 2>/dev/null | jq …`。
 
 // data 把结果写到 stdout（JSON）。pretty=false 时输出紧凑单行。
 export function data(value, { pretty = true } = {}) {