draftgo-cli 3.0.1 → 3.0.33

package/src/commands/help.js

@@ -7,57 +7,63 @@ function help() {
   const targets = all.map((i) => `    ${i.name.padEnd(12)} ${i.displayName}`).join('\n');
   console.log(`draftgo v${getPackageVersion()} — DraftGo Next workbench CLI for AI coding agents
 
-DraftGo Next frontend baseline: React + Vite + shadcn/ui + Tailwind.
-Database pages use dg-* as the shadcn HTML runtime protocol.
+DraftGo Next frontend baseline: React + Vite.
+Database pages use standard HTML + Tailwind CSS.
 The CLI is the workbench layer for local runtime, resource sync, checks, and push/pull flows.
 
 Usage:
   draftgo init [<target>...]       Install skill. No target = auto-detect.
                                     Use "all" to install every target.
-  draftgo update [<target>...]     Update skill + entry files. If a newer CLI
-                                    version exists on npm, upgrades the CLI
-                                    automatically then reruns itself.
+  draftgo update [<target>...]     Fully update the global CLI, then atomically
+                                    refresh skill + entry files.
   draftgo uninstall <target|all>   Remove entry files for target(s).
                                     Use explicit "all" to remove every target.
                                     --purge also removes .draftgo/ (runtime data).
   draftgo status                   Show installed targets and skill version.
-  draftgo doctor                   Diagnose environment (python, targets,
-                                    CLI freshness).
   draftgo map                      Print a local DraftGo project resource map
                                     for fast AI orientation.
-  draftgo check                    Check local resource closure: routes,
-                                    entry binding, files, obvious mock risks.
-  draftgo dev                      Run this project's npm dev script.
-  draftgo build                    Run this project's npm build script.
-  draftgo new <type> <slug>        Scaffold a new resource locally (no network).
-                                    Creates template file + index.json entry.
-                                    Types: page | nav | db_meta | script | doc
+  draftgo check                    Check page entry binding, page/navigation
+                                    HTML parsing, and unregistered local files.
+  draftgo verify-ui <url>          Run a deterministic browser smoke check.
+                                    Uses one viewport and screenshots on failure.
+  draftgo api <keyword>            Search DraftGo base APIs and show request/
+                                    response/authentication contracts.
+                                    Custom service routes come from app.Route;
+                                    they are not part of the bundled OpenAPI.
   draftgo delete <type> <id>       Delete resource from server + local index.
                                     Types: pages | nav | db_meta | custom_scripts
-                                           | docs | doc_categories | external_apis
+                                           | docs | doc_categories | aihub
                                     Alias: del, rm. Flags: --yes / -y skip confirm.
   draftgo pull [type] [id...]      Pull DraftGo resources via the bundled
                                     sync script. Defaults to --all.
   draftgo push <type> [id...]      Push DraftGo resources via the bundled
                                     sync script.
-  draftgo local up|down|logs|status
+  draftgo deploy [type] [id...]    Run check, then push explicitly.
+                                    --delivery local|preview|deploy
+  draftgo auto-push [type] [id...] Run check, then push only when
+                                    config.auto_push is true.
+                                    Supports --batch <type> <ids> ... too.
+  draftgo local setup|start|stop|logs|status
                                     Manage .draftgo/docker/docker-compose.yaml
-                                    generated by draftgo local-dev.
+                                    generated by local setup. up/down remain
+                                    compatible aliases for start/stop.
   draftgo list-targets             List supported AI tools.
   draftgo connect                  Bind this project to an existing DraftGo
                                     server. Prompts for BaseURL + access
                                     token (or pass --server / --token).
-  draftgo local-dev                One-click local DraftGo stack via Docker
-                                    (MySQL + Redis + app). Generates
-                                    <project>/.draftgo/docker/docker-compose.yaml
-                                    with random secrets, then guides you to
-                                    finish setup and paste an access token.
+  draftgo local setup              One-click local DraftGo stack via Docker
+                                    (shared MySQL, Redis, Milvus + app). It
+                                    generates an app-only project compose,
+                                    <project>/.draftgo/docker/docker-compose.yaml,
+                                    then guides you to finish setup and paste
+                                    an access token.
+  draftgo local-dev                Compatibility alias for \`draftgo local setup\`.
   draftgo -v | --version           Print CLI version.
   draftgo -h | --help              Show this help.
 
 v3 Workbench:
-  draftgo local up|down|logs       Local stack lifecycle commands.
-  draftgo dev|build|check          Project workflow gates.
+  draftgo local start|stop|logs    Local stack lifecycle commands.
+  draftgo check                    Local resource closure gate.
   draftgo pull|push                First-class resource sync wrappers.
 
 Flags:
@@ -67,15 +73,21 @@ Flags:
   --skip-update-check      Do not contact npm to check for a newer CLI.
   --yes                    Assume "yes" for interactive prompts.
   --connect                (init) Skip the prompt and run \`draftgo connect\`.
-  --local-dev              (init) Skip the prompt and run \`draftgo local-dev\`.
+  --local-dev              (init) Skip the prompt and run \`draftgo local setup\`.
   --no-setup               (init) Don't offer either flow after installing.
   --server <url>           (connect) Provide the DraftGo BaseURL non-interactively.
   --token <sat>            (connect) Provide the access token non-interactively.
   --output <json>          (map/check) Print machine-readable JSON.
   --strict                 (check) Treat warnings as failures.
+  --mobile-check <mode>    (verify-ui) auto | always | never. Default: auto.
+  --screenshot <mode>      (verify-ui) on-failure | always | never.
+  --browser <name>         (verify-ui) chromium | chrome | msedge.
+  --selector <css>         (verify-ui) Require a key element to be visible.
+  --width/--height <px>    (verify-ui) Override the default 390x844 viewport.
+  --delivery <mode>        (deploy) local | preview | deploy.
 
 Environment:
-  DRAFTGO_NO_UPDATE_CHECK=1     Disable the automatic CLI-freshness check.
+  DRAFTGO_NO_UPDATE_CHECK=1     Disable the cached CLI version check.
 
 Targets:
 ${targets}
@@ -85,9 +97,10 @@ Examples:
   draftgo init claudecode      # install for Claude Code only
   draftgo init claudecode kiro # install for both
   draftgo init all             # install for every supported target
-  draftgo update               # upgrade CLI if needed, then refresh skill
+  draftgo update               # fully update CLI and installed skills
   draftgo map                  # inspect pages/nav/db/scripts before development
-  draftgo check --strict       # fail on closure warnings before push
+  draftgo check --strict       # fail on any resource-check warning before push
+  draftgo verify-ui http://localhost:5173 --mobile-check auto
   draftgo uninstall all --purge # full removal incl. runtime data
 `);
 }

package/src/commands/init.js

@@ -12,8 +12,8 @@ const { ask } = require('../prompt');
 function warnIfNoPython() {
   const py = findPython();
   if (!py) {
-    log.warn('Python 未检测到。DraftGo 的 init/sync 脚本需要 Python 3.9+。');
-    log.dim('  请安装 Python 3.9+ 后再运行 /draftgo init 子技能。');
+    log.warn('Python 未检测到。DraftGo 资源同步需要 Python 3.9+。');
+    log.dim('  安装 Python 3.9+ 后运行 `draftgo pull` 获取项目资源。');
   } else {
     log.dim(`  detected ${py.bin} (${py.version})`);
   }
@@ -47,17 +47,32 @@ async function init(projectDir, positional, flags) {
 
   // 2) Render skill body into each target's own directory (no shared
   //    .draftgo/skill/ indirection anymore — each AI tool gets a real copy).
-  log.step('写入各 AI 工具 skill 目录（含 SKILL.md / 子技能 / rules / scripts）');
+  log.step('写入各 AI 工具 skill 目录（含 SKILL.md / 子技能 / references / scripts）');
   ensureRuntime(projectDir);
+  const failures = [];
+  let installedCount = 0;
+  let skippedCount = 0;
   for (const t of resolved) {
     try {
       const r = t.install(projectDir, { force: !!flags.force });
-      log.ok(`${t.displayName.padEnd(16)} → ${r.path}`);
+      if (r.skipped) {
+        skippedCount += 1;
+        log.warn(`${t.displayName.padEnd(16)} 已存在，未覆盖；使用 draftgo update 或 --force 更新。`);
+      } else {
+        installedCount += 1;
+        log.ok(`${t.displayName.padEnd(16)} → ${r.path}`);
+      }
     } catch (e) {
       log.err(`${t.displayName} 安装失败：${e.message}`);
+      failures.push(t.displayName);
     }
   }
-  writeInstalledVersion(projectDir);
+  if (failures.length) {
+    log.err(`安装未完成，失败目标：${failures.join(', ')}`);
+    return 1;
+  }
+  if (installedCount > 0 && skippedCount === 0) writeInstalledVersion(projectDir);
+  if (skippedCount > 0) log.dim('  存在未覆盖目标，未更新全局 skill 版本标记；运行 draftgo update 可统一刷新。');
   log.dim(`  CLI 版本：${getPackageVersion()}`);
 
   // 3) Environment check (advisory).
@@ -86,29 +101,28 @@ async function init(projectDir, positional, flags) {
       return await require('./localDev')(projectDir, [], flags);
     }
     if (interactive) {
-      log.title('未检测到 DraftGo 服务器配置');
-      log.plain('选择一种方式完成绑定：');
-      log.plain(`  ${log.c.cyan('[1]')} 连接已有 DraftGo 服务器  ${log.c.gray('（输入 BaseURL + 系统访问令牌）')}`);
-      log.plain(`  ${log.c.cyan('[2]')} 进入本地开发模式          ${log.c.gray('（没部署基座，用 Docker 一键启动）')}`);
-      log.plain(`  ${log.c.cyan('[3]')} 稍后再说`);
-      const choice = (await ask('请选择 [1/2/3]', { default: '1' })).trim();
-      if (choice === '1') {
+      log.title('选择 DraftGo 基座处理方式');
+      log.plain(`  ${log.c.cyan('[A]')} 连接基座服务`);
+      log.dim('      使用已有 DraftGo 服务，接下来输入 BaseURL 和系统访问令牌。');
+      log.plain(`  ${log.c.cyan('[B]')} 本地启动基座`);
+      log.dim('      使用 Docker 启动 DraftGo；按需准备共享的 MySQL、Redis 和 Milvus。');
+      log.plain(`  ${log.c.cyan('[C]')} 稍后自行处理`);
+      log.dim('      仅安装 Skill，不写入服务配置，也不创建容器。');
+      const choice = (await ask('请选择 [A/B/C]', { default: 'C' })).trim().toUpperCase();
+      if (choice === 'A') {
         return await require('./connect')(projectDir, [], flags);
       }
-      if (choice === '2') {
-        return await require('./localDev')(projectDir, [], flags);
+      if (choice === 'B') {
+        return await require('./localDev')(projectDir, [], { ...flags, yes: true });
       }
-      if (choice !== '3') {
-        log.warn('Invalid choice; skipped server setup. Run `draftgo connect` or `draftgo local-dev` later.');
+      if (choice !== 'C') {
+        log.warn('无效选择，已跳过基座处理。');
       }
     }
   }
 
   log.title('完成');
-  log.plain('下一步：在你的 AI 工具里说「初始化 draftgo 项目」，它会引导你配置服务器和 token。');
-  log.dim('或直接运行：');
-  log.dim('  draftgo connect              # 连接已有 DraftGo 服务器');
-  log.dim('  draftgo local-dev            # 本地一键部署 DraftGo');
+  log.plain(hasConfig ? 'Skill 已安装，项目已连接 DraftGo。' : 'Skill 已安装。');
   return 0;
 }
 

package/src/commands/local.js

@@ -5,6 +5,7 @@ const { spawnSync } = require('child_process');
 const log = require('../logger');
 const { exists } = require('../fsx');
 const { detectDocker } = require('../localdev/detect');
+const { runWizard } = require('../localdev');
 
 function composeFile(projectDir) {
   return path.join(projectDir, '.draftgo', 'docker', 'docker-compose.yaml');
@@ -22,7 +23,7 @@ function runCompose(projectDir, args, stdio = 'inherit') {
   const file = composeFile(projectDir);
   if (!exists(file)) {
     log.err('未找到 .draftgo/docker/docker-compose.yaml。');
-    log.dim('  请先运行 `draftgo local-dev` 生成本地 DraftGo stack。');
+    log.dim('  请先运行 `draftgo local setup` 生成本地 DraftGo stack。');
     return 1;
   }
 
@@ -34,13 +35,17 @@ function runCompose(projectDir, args, stdio = 'inherit') {
   return r.status || 0;
 }
 
-function local(projectDir, positional) {
+function local(projectDir, positional, flags = {}) {
   const action = positional[0] || 'status';
 
   switch (action) {
+    case 'setup':
+      return runWizard(projectDir, { yes: !!(flags.yes || flags.y) });
     case 'up':
+    case 'start':
       return runCompose(projectDir, ['up', '-d']);
     case 'down':
+    case 'stop':
       return runCompose(projectDir, ['down']);
     case 'logs':
       return runCompose(projectDir, ['logs', ...(positional.slice(1).length ? positional.slice(1) : ['-f', 'app'])]);
@@ -49,7 +54,8 @@ function local(projectDir, positional) {
       return runCompose(projectDir, ['ps']);
     default:
       log.err(`未知 local 子命令：${action}`);
-      log.dim('  可用：draftgo local up | down | logs | status');
+      log.dim('  可用：draftgo local setup | start | stop | logs | status');
+      log.dim('  兼容别名：up | down');
       return 1;
   }
 }

package/src/commands/map.js

@@ -40,13 +40,13 @@ function mapCommand(projectDir, flags = {}) {
   });
 
   printList('自定义脚本', map.custom_scripts, (s) => {
-    return `${s.slug || '（无 slug）'}  ${s.mode || 'mode?'}  ${s.name || ''}${s.code_file ? `  ${s.code_file}` : ''}`;
-  });
-
-  printList('外部 API', map.external_apis, (a) => {
-    const route = `${a.method || 'GET'} ${a.path || '/'}`;
-    const tags = a.tags && a.tags.length ? `  #${a.tags.join(',#')}` : '';
-    return `${a.id || 'new'}  ${a.code || '（无 code）'}  ${route}  ${a.name || ''}${a.base_url ? `  ${a.base_url}` : ''}${tags}`;
+    const bindings = [
+      ...(s.routes || []),
+      ...(s.events || []).map((event) => `EVENT ${event}`),
+      ...(s.schedules || []).map((cron) => `CRON ${cron}`),
+    ];
+    const summary = bindings.length ? `  [${bindings.join(' | ')}]` : '';
+    return `${s.slug || '（无 slug）'}  ${s.mode || 'mode?'}  ${s.name || ''}${summary}${s.code_file ? `  ${s.code_file}` : ''}`;
   });
 
   printList('文档', map.docs, (d) => {
@@ -82,6 +82,17 @@ function mapCommand(projectDir, flags = {}) {
   });
   printList('角色', map.roles, (r) => `${r.code || r.id || 'new'}  ${r.name || ''}`);
 
+  console.log('');
+  log.info('页面分区：');
+  const areaRows = [
+    ['home', map.pageGroups.home.length],
+    ['admin', map.pageGroups.admin.length],
+    ['business', map.pageGroups.business.length],
+    ['system', map.pageGroups.system.length],
+    ['unknown', map.pageGroups.unknown.length],
+  ];
+  log.dim('  ' + areaRows.map(([k, v]) => `${k} ${v}`).join('  '));
+
   console.log('');
   log.info('入口引用：');
   const routes = Object.keys(map.routeRefs).sort();

package/src/commands/sync.js

@@ -35,20 +35,27 @@ function sync(projectDir, command, positional, flags = {}) {
 
   if (!exists(path.join(projectDir, '.draftgo', 'config.json'))) {
     log.err('未找到 .draftgo/config.json。');
-    log.dim('  请先运行 `draftgo connect` 或 `/draftgo init`。');
+    log.dim('  请先运行 `draftgo connect`。');
     return 1;
   }
 
   const args = positional.length ? positional : ['--all'];
-  if (command === 'push' && flags.force) {
-    args.push('--force');
+  if (command === 'push' && flags['dry-run']) {
+    args.push('--dry-run');
+  }
+  if (command === 'push' && flags['probe-routes']) {
+    args.push('--probe-routes');
   }
   const r = spawnSync(py.bin, [script, ...args], {
     cwd: projectDir,
     stdio: 'inherit',
     shell: false,
   });
-  return r.status || 0;
+  if (r.error) {
+    log.err(`${command} 启动失败：${r.error.message}`);
+    return 1;
+  }
+  return Number.isInteger(r.status) ? r.status : 1;
 }
 
 module.exports = sync;

package/src/commands/update.js

@@ -7,77 +7,57 @@ const { ensureRuntime, writeInstalledVersion, readInstalledVersion, getPackageVe
 const { fetchLatestVersion, cmpSemver } = require('../updateCheck');
 const { detectTargets } = require('../detect');
 
-// Env flag we set before re-exec to avoid infinite upgrade loops.
 const REENTRY_FLAG = 'DRAFTGO_UPDATE_REENTERED';
 
-function runNpmInstallLatest() {
-  const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  log.step('执行：npm install -g draftgo-cli@latest');
-  const r = spawnSync(npm, ['install', '-g', 'draftgo-cli@latest'], { stdio: 'inherit' });
-  if (r.error) { log.err(`升级失败：${r.error.message}`); return false; }
-  if (r.status !== 0) {
-    log.err(`npm install 返回码 ${r.status}`);
-    log.dim('  常见原因：权限不足（macOS/Linux 用 sudo，或用 nvm 管理 Node）');
-    return false;
-  }
-  return true;
-}
-
-function reExecSameCommand(projectDir) {
-  // Re-run `draftgo update` from the freshly installed global CLI, so the user
-  // gets the newest skill content written into .draftgo/skill in the same call.
-  const cmd = process.platform === 'win32' ? 'draftgo.cmd' : 'draftgo';
-  const args = ['update', '--project', projectDir, '--skip-update-check'];
-  log.step('以新版 CLI 重新执行：draftgo update');
-  const r = spawnSync(cmd, args, {
-    stdio: 'inherit',
-    env: { ...process.env, [REENTRY_FLAG]: '1' },
-  });
-  if (r.error) {
-    log.err(`重新执行失败：${r.error.message}`);
-    log.dim('  请手动在项目目录再跑一次：draftgo update');
-    return 1;
+async function updateCliIfNeeded(projectDir, positional, flags) {
+  if (process.env[REENTRY_FLAG] === '1' || flags['skip-update-check'] || process.env.DRAFTGO_NO_UPDATE_CHECK === '1') {
+    return null;
   }
-  return r.status || 0;
-}
-
-async function maybeAutoUpgrade(projectDir, flags) {
-  if (flags['skip-update-check']) return { upgraded: false };
-  if (process.env[REENTRY_FLAG] === '1') return { upgraded: false };
-  if (process.env.DRAFTGO_NO_UPDATE_CHECK === '1') return { upgraded: false };
-
   const current = getPackageVersion();
-  const latest = await fetchLatestVersion();
+  const latest = await fetchLatestVersion(5000, { force: true });
   if (!latest) {
-    log.dim('  （查询最新版失败，按当前 CLI 继续）');
-    return { upgraded: false };
+    log.warn('无法查询 npm 最新版本；将用当前 CLI 刷新 skill。');
+    return null;
   }
   if (cmpSemver(latest, current) <= 0) {
     log.dim(`  CLI 已是最新（${current}）`);
-    return { upgraded: false };
+    return null;
+  }
+
+  const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+  log.step(`更新 draftgo-cli：${current} → ${latest}`);
+  const install = spawnSync(npm, ['install', '-g', `draftgo-cli@${latest}`], { stdio: 'inherit', shell: false });
+  if (install.error) {
+    log.err(`CLI 更新启动失败：${install.error.message}`);
+    return 1;
+  }
+  if (install.status !== 0) {
+    log.err(`npm install 返回码 ${install.status}`);
+    return Number.isInteger(install.status) ? install.status : 1;
   }
 
-  log.warn(`draftgo-cli 有新版：${current} → ${latest}，自动升级中……`);
-  const ok = runNpmInstallLatest();
-  if (!ok) {
-    log.warn('自动升级失败，回退到当前 CLI 继续执行。');
-    return { upgraded: false };
+  const command = process.platform === 'win32' ? 'draftgo.cmd' : 'draftgo';
+  const rerun = spawnSync(command, ['update', ...positional, '--project', projectDir, '--skip-update-check'], {
+    stdio: 'inherit',
+    shell: false,
+    env: { ...process.env, [REENTRY_FLAG]: '1' },
+  });
+  if (rerun.error) {
+    log.err(`新版 CLI 刷新 skill 失败：${rerun.error.message}`);
+    return 1;
   }
-  log.ok(`CLI 已升级到 ${latest}。`);
-  const code = reExecSameCommand(projectDir);
-  return { upgraded: true, exitCode: code };
+  return Number.isInteger(rerun.status) ? rerun.status : 1;
 }
 
 async function update(projectDir, positional, flags) {
   log.title('draftgo update');
 
+  const reentryCode = await updateCliIfNeeded(projectDir, positional, flags);
+  if (reentryCode !== null) return reentryCode;
+
   const prev = readInstalledVersion(projectDir);
   log.info(`当前已装 skill：${prev || '未安装'}，CLI 版本：${getPackageVersion()}`);
 
-  // Auto-upgrade-and-rerun path.
-  const { upgraded, exitCode } = await maybeAutoUpgrade(projectDir, flags);
-  if (upgraded) return exitCode;
-
   // Determine which entry files to refresh:
   //   - no positional → refresh installed targets plus project-level tool signals
   //   - "all"          → refresh every known target
@@ -111,14 +91,20 @@ async function update(projectDir, positional, flags) {
 
   ensureRuntime(projectDir);
   log.step('用 CLI 内置版本覆盖各 AI 工具 skill 目录');
+  const failures = [];
   for (const t of resolved) {
     try {
       const r = t.install(projectDir, { force: true });
       log.ok(`${t.displayName.padEnd(16)} → ${r.path}`);
     } catch (e) {
       log.err(`${t.displayName} 更新失败：${e.message}`);
+      failures.push(t.displayName);
     }
   }
+  if (failures.length) {
+    log.err(`更新未完成，失败目标：${failures.join(', ')}`);
+    return 1;
+  }
   writeInstalledVersion(projectDir);
 
   log.title('完成');
@@ -126,3 +112,4 @@ async function update(projectDir, positional, flags) {
 }
 
 module.exports = update;
+module.exports.updateCliIfNeeded = updateCliIfNeeded;