draftgo-cli 2.0.3 → 2.0.5

package/src/commands/check.js

@@ -0,0 +1,53 @@
+'use strict';
+
+const log = require('../logger');
+const { analyzeProject } = require('../projectMap');
+
+function check(projectDir, flags = {}) {
+  const result = analyzeProject(projectDir);
+
+  if (flags.output === 'json') {
+    console.log(JSON.stringify(result, null, 2));
+    return result.errors.length || (flags.strict && result.warnings.length) ? 1 : 0;
+  }
+
+  log.title('draftgo check');
+  log.info(`项目目录：${projectDir}`);
+
+  console.log('');
+  log.info(`资源概览：pages=${result.map.pages.length}, nav=${result.map.navigations.length}, db=${result.map.db_meta.length}, scripts=${result.map.custom_scripts.length}, aihub=${result.map.aihub.length}`);
+
+  if (result.errors.length) {
+    console.log('');
+    console.log(`${log.c.red('x')} 错误：`);
+    result.errors.forEach((msg) => console.log(`  - ${msg}`));
+  }
+
+  if (result.warnings.length) {
+    console.log('');
+    console.log(`${log.c.yellow('!')} 提醒：`);
+    result.warnings.forEach((msg) => console.log(`  - ${msg}`));
+  }
+
+  if (!result.errors.length && !result.warnings.length) {
+    console.log('');
+    log.ok('未发现明显闭环问题。');
+  }
+
+  if (result.errors.length) {
+    console.log('');
+    console.log(`${log.c.red('x')} 检查未通过：请先修复错误。`);
+    return 1;
+  }
+  if (flags.strict && result.warnings.length) {
+    console.log('');
+    console.log(`${log.c.red('x')} strict 模式：存在提醒项，检查未通过。`);
+    return 1;
+  }
+
+  console.log('');
+  log.ok(result.warnings.length ? '检查完成：存在提醒项，建议开发代理处理后再 push。' : '检查通过。');
+  return 0;
+}
+
+module.exports = check;

package/src/commands/help.js

@@ -5,7 +5,11 @@ const { getPackageVersion } = require('../skill');
 
 function help() {
   const targets = all.map((i) => `    ${i.name.padEnd(12)} ${i.displayName}`).join('\n');
-  console.log(`draftgo v${getPackageVersion()} — manage the DraftGo skill across AI coding agents
+  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.
+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.
@@ -19,6 +23,19 @@ Usage:
   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 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
+                                    Manage .draftgo/docker/docker-compose.yaml
+                                    generated by draftgo local-dev.
   draftgo list-targets             List supported AI tools.
   draftgo connect                  Bind this project to an existing DraftGo
                                     server. Prompts for BaseURL + access
@@ -31,6 +48,11 @@ Usage:
   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 pull|push                First-class resource sync wrappers.
+
 Flags:
   --project <dir>          Operate on <dir> instead of the current directory.
   --force                  Overwrite existing skill body during install/update.
@@ -42,6 +64,8 @@ Flags:
   --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.
 
 Environment:
   DRAFTGO_NO_UPDATE_CHECK=1     Disable the automatic CLI-freshness check.
@@ -55,6 +79,8 @@ Examples:
   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 map                  # inspect pages/nav/db/scripts before development
+  draftgo check --strict       # fail on closure warnings before push
   draftgo uninstall all --purge # full removal incl. runtime data
 `);
 }

package/src/commands/local.js

@@ -0,0 +1,57 @@
+'use strict';
+
+const path = require('path');
+const { spawnSync } = require('child_process');
+const log = require('../logger');
+const { exists } = require('../fsx');
+const { detectDocker } = require('../localdev/detect');
+
+function composeFile(projectDir) {
+  return path.join(projectDir, '.draftgo', 'docker', 'docker-compose.yaml');
+}
+
+function runCompose(projectDir, args, stdio = 'inherit') {
+  const docker = detectDocker();
+  if (!docker.ok) {
+    log.err(docker.reason === 'compose-missing'
+      ? '检测到 Docker，但缺少 compose 插件。'
+      : '未检测到可用 Docker。');
+    return 1;
+  }
+
+  const file = composeFile(projectDir);
+  if (!exists(file)) {
+    log.err('未找到 .draftgo/docker/docker-compose.yaml。');
+    log.dim('  请先运行 `draftgo local-dev` 生成本地 DraftGo stack。');
+    return 1;
+  }
+
+  const r = spawnSync(docker.composeCmd, [...docker.composeArgs, '-f', file, ...args], {
+    cwd: path.dirname(file),
+    stdio,
+    shell: false,
+  });
+  return r.status || 0;
+}
+
+function local(projectDir, positional) {
+  const action = positional[0] || 'status';
+
+  switch (action) {
+    case 'up':
+      return runCompose(projectDir, ['up', '-d']);
+    case 'down':
+      return runCompose(projectDir, ['down']);
+    case 'logs':
+      return runCompose(projectDir, ['logs', ...(positional.slice(1).length ? positional.slice(1) : ['-f', 'app'])]);
+    case 'status':
+    case 'ps':
+      return runCompose(projectDir, ['ps']);
+    default:
+      log.err(`未知 local 子命令：${action}`);
+      log.dim('  可用：draftgo local up | down | logs | status');
+      return 1;
+  }
+}
+
+module.exports = local;

package/src/commands/map.js

@@ -0,0 +1,58 @@
+'use strict';
+
+const log = require('../logger');
+const { buildProjectMap } = require('../projectMap');
+
+function printList(title, rows, render) {
+  console.log('');
+  log.info(`${title}：${rows.length}`);
+  if (rows.length === 0) {
+    log.dim('  （无）');
+    return;
+  }
+  for (const row of rows) log.dim(`  • ${render(row)}`);
+}
+
+function mapCommand(projectDir, flags = {}) {
+  const map = buildProjectMap(projectDir);
+
+  if (flags.output === 'json') {
+    console.log(JSON.stringify(map, null, 2));
+    return 0;
+  }
+
+  log.title('draftgo map');
+  log.info(`项目目录：${projectDir}`);
+
+  printList('页面', map.pages, (p) => {
+    const id = p.id == null ? 'new' : p.id;
+    return `${String(id).padEnd(4)} ${p.route || '（无 route）'}  ${p.title || '未命名'}${p.html_file ? `  ${p.html_file}` : ''}`;
+  });
+
+  printList('导航', map.navigations, (n) => {
+    const id = n.id == null ? 'new' : n.id;
+    return `${String(id).padEnd(4)} ${n.code || 'default'}  ${n.name || '未命名'}${n.html_file ? `  ${n.html_file}` : ''}`;
+  });
+
+  printList('动态 DB', map.db_meta, (m) => {
+    const fields = m.fields.length ? ` (${m.fields.slice(0, 8).join(', ')}${m.fields.length > 8 ? ', ...' : ''})` : '';
+    return `${m.type || '（无 type）'}  ${m.label || ''}${fields}`;
+  });
+
+  printList('自定义脚本', map.custom_scripts, (s) => {
+    return `${s.slug || '（无 slug）'}  ${s.mode || 'mode?'}  ${s.name || ''}${s.code_file ? `  ${s.code_file}` : ''}`;
+  });
+
+  printList('AIHub', map.aihub, (a) => `${a.id || 'new'}  ${a.type || ''}  ${a.name || ''}`);
+  printList('角色', map.roles, (r) => `${r.code || r.id || 'new'}  ${r.name || ''}`);
+
+  console.log('');
+  log.info('入口引用：');
+  const routes = Object.keys(map.routeRefs).sort();
+  if (routes.length === 0) log.dim('  （未发现 data-page-route / href 引用）');
+  else routes.forEach((route) => log.dim(`  • ${route} ← ${map.routeRefs[route].join(', ')}`));
+
+  return 0;
+}
+
+module.exports = mapCommand;

package/src/commands/projectScript.js

@@ -0,0 +1,37 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const log = require('../logger');
+
+function projectScript(projectDir, scriptName) {
+  const pkgPath = path.join(projectDir, 'package.json');
+  if (!fs.existsSync(pkgPath)) {
+    log.err(`当前项目没有 package.json，无法运行 draftgo ${scriptName}。`);
+    return 1;
+  }
+
+  let pkg;
+  try {
+    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  } catch (err) {
+    log.err(`package.json 解析失败：${err.message}`);
+    return 1;
+  }
+
+  if (!pkg.scripts || !pkg.scripts[scriptName]) {
+    log.err(`package.json 中没有 scripts.${scriptName}。`);
+    return 1;
+  }
+
+  const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+  const r = spawnSync(npmCmd, ['run', scriptName], {
+    cwd: projectDir,
+    stdio: 'inherit',
+    shell: false,
+  });
+  return r.status || 0;
+}
+
+module.exports = projectScript;

package/src/commands/sync.js

@@ -0,0 +1,51 @@
+'use strict';
+
+const path = require('path');
+const { spawnSync } = require('child_process');
+const log = require('../logger');
+const { exists } = require('../fsx');
+const { findPython } = require('../python');
+const { platforms } = require('../platforms');
+
+function findSyncScript(projectDir, command) {
+  const scriptName = command === 'pull' ? 'draftgo_pull.py' : 'draftgo_push.py';
+
+  for (const platform of platforms) {
+    const candidate = path.join(projectDir, platform.assetDir, 'scripts', scriptName);
+    if (exists(candidate)) return candidate;
+  }
+
+  const bundled = path.resolve(__dirname, '..', '..', 'resources', 'skill', 'scripts', scriptName);
+  return exists(bundled) ? bundled : null;
+}
+
+function sync(projectDir, command, positional) {
+  const py = findPython();
+  if (!py) {
+    log.err('未检测到 Python，无法运行 DraftGo 同步脚本。');
+    return 1;
+  }
+
+  const script = findSyncScript(projectDir, command);
+  if (!script) {
+    log.err(`未找到 ${command} 同步脚本。`);
+    log.dim('  请先运行 `draftgo init` 安装 DraftGo skill，或重新安装 CLI。');
+    return 1;
+  }
+
+  if (!exists(path.join(projectDir, '.draftgo', 'config.json'))) {
+    log.err('未找到 .draftgo/config.json。');
+    log.dim('  请先运行 `draftgo connect` 或 `/draftgo init`。');
+    return 1;
+  }
+
+  const args = positional.length ? positional : ['--all'];
+  const r = spawnSync(py.bin, [script, ...args], {
+    cwd: projectDir,
+    stdio: 'inherit',
+    shell: false,
+  });
+  return r.status || 0;
+}
+
+module.exports = sync;

package/src/index.js

@@ -35,6 +35,18 @@ async function run(argv) {
         return require('./commands/status')(projectDir);
       case 'doctor':
         return await require('./commands/doctor')(projectDir, flags);
+      case 'map':
+        return require('./commands/map')(projectDir, flags);
+      case 'check':
+        return require('./commands/check')(projectDir, flags);
+      case 'dev':
+      case 'build':
+        return require('./commands/projectScript')(projectDir, command, flags);
+      case 'pull':
+      case 'push':
+        return require('./commands/sync')(projectDir, command, positional, flags);
+      case 'local':
+        return require('./commands/local')(projectDir, positional, flags);
       case 'list-targets':
       case 'targets':
         return require('./commands/listTargets')();

package/src/projectMap.js

@@ -0,0 +1,228 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function exists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}
+
+function readTextSafe(p) {
+  try { return fs.readFileSync(p, 'utf8'); } catch { return ''; }
+}
+
+function readJsonSafe(projectDir, rel) {
+  const abs = path.join(projectDir, rel);
+  try {
+    const raw = fs.readFileSync(abs, 'utf8');
+    const parsed = JSON.parse(raw);
+    return { ok: true, path: rel, items: Array.isArray(parsed) ? parsed : [], raw: parsed };
+  } catch (err) {
+    return { ok: false, path: rel, items: [], error: err.message };
+  }
+}
+
+function normalizeRoute(route) {
+  if (!route || typeof route !== 'string') return '';
+  const clean = route.trim();
+  if (!clean) return '';
+  if (/^https?:\/\//i.test(clean) || clean.startsWith('#') || clean.startsWith('mailto:')) return '';
+  return clean.startsWith('/') ? clean : `/${clean}`;
+}
+
+function relToAbs(projectDir, rel) {
+  if (!rel || typeof rel !== 'string') return null;
+  const clean = rel.replace(/\\/g, '/');
+  return path.isAbsolute(clean) ? clean : path.join(projectDir, clean);
+}
+
+function findGeneratedFile(projectDir, dirRel, prefix, exts) {
+  const dir = path.join(projectDir, dirRel);
+  if (!exists(dir)) return null;
+  const files = fs.readdirSync(dir).filter((f) => {
+    if (!f.startsWith(prefix)) return false;
+    return exts.some((ext) => f.endsWith(ext));
+  });
+  return files.length ? path.join(dirRel, files[0]).replace(/\\/g, '/') : null;
+}
+
+function itemFile(projectDir, section, item) {
+  if (!item || typeof item !== 'object') return null;
+  const direct = item.html_file || item.code_file || item.file;
+  if (direct && exists(relToAbs(projectDir, direct))) return direct.replace(/\\/g, '/');
+  const id = item.id == null ? '' : String(item.id);
+  if (!id) return null;
+  if (section === 'pages') return findGeneratedFile(projectDir, '.draftgo/pages', `page_${id}_`, ['.html']);
+  if (section === 'navigations') return findGeneratedFile(projectDir, '.draftgo/navigations', `nav_${id}_`, ['.html']);
+  return null;
+}
+
+function extractRoutes(html) {
+  const routes = new Set();
+  if (!html) return routes;
+  const patterns = [
+    /\bdata-page-route\s*=\s*["']([^"']+)["']/gi,
+    /\bhref\s*=\s*["']([^"']+)["']/gi,
+  ];
+  for (const re of patterns) {
+    let m;
+    while ((m = re.exec(html))) {
+      const route = normalizeRoute(m[1]);
+      if (route) routes.add(route);
+    }
+  }
+  return routes;
+}
+
+function pageKey(page) {
+  if (page && page.id != null) return `page:${page.id}`;
+  return `page:${normalizeRoute(page && page.route) || page && page.title || 'new'}`;
+}
+
+function addRouteRefs(refs, route, source) {
+  const clean = normalizeRoute(route);
+  if (!clean) return;
+  if (!refs.has(clean)) refs.set(clean, new Set());
+  refs.get(clean).add(source);
+}
+
+function summarizePage(projectDir, item) {
+  const file = itemFile(projectDir, 'pages', item);
+  return {
+    id: item.id,
+    title: item.title || '',
+    route: normalizeRoute(item.route),
+    permission: item.permission || null,
+    tag: item.tag || '',
+    html_file: file,
+  };
+}
+
+function summarizeNav(projectDir, item) {
+  const file = itemFile(projectDir, 'navigations', item);
+  return {
+    id: item.id,
+    code: item.code || '',
+    name: item.name || '',
+    status: item.status,
+    html_file: file,
+  };
+}
+
+function buildProjectMap(projectDir) {
+  const indexes = {
+    pages: readJsonSafe(projectDir, '.draftgo/pages/index.json'),
+    navigations: readJsonSafe(projectDir, '.draftgo/navigations/index.json'),
+    db_meta: readJsonSafe(projectDir, '.draftgo/db_meta/index.json'),
+    custom_scripts: readJsonSafe(projectDir, '.draftgo/custom_scripts/index.json'),
+    aihub: readJsonSafe(projectDir, '.draftgo/aihub/index.json'),
+    external_apis: readJsonSafe(projectDir, '.draftgo/external_apis/index.json'),
+    roles: readJsonSafe(projectDir, '.draftgo/roles/index.json'),
+    users: readJsonSafe(projectDir, '.draftgo/users/index.json'),
+  };
+
+  const pages = indexes.pages.items.map((p) => summarizePage(projectDir, p));
+  const navigations = indexes.navigations.items.map((n) => summarizeNav(projectDir, n));
+  const routeRefs = new Map();
+
+  for (const nav of navigations) {
+    const html = nav.html_file ? readTextSafe(relToAbs(projectDir, nav.html_file)) : '';
+    for (const route of extractRoutes(html)) addRouteRefs(routeRefs, route, `nav:${nav.id || nav.code || nav.name}`);
+  }
+
+  for (const page of pages) {
+    const html = page.html_file ? readTextSafe(relToAbs(projectDir, page.html_file)) : '';
+    for (const route of extractRoutes(html)) addRouteRefs(routeRefs, route, pageKey(page));
+  }
+
+  return {
+    projectDir,
+    indexes: Object.fromEntries(Object.entries(indexes).map(([k, v]) => [k, { ok: v.ok, path: v.path, count: v.items.length }])),
+    pages,
+    navigations,
+    db_meta: indexes.db_meta.items.map((m) => ({
+      id: m.id,
+      type: m.type || '',
+      label: m.label || '',
+      fields: m.schema && m.schema.properties ? Object.keys(m.schema.properties) : [],
+    })),
+    custom_scripts: indexes.custom_scripts.items.map((s) => ({
+      id: s.id,
+      name: s.name || '',
+      slug: s.slug || '',
+      mode: s.mode || '',
+      status: s.status,
+      code_file: itemFile(projectDir, 'custom_scripts', s),
+    })),
+    aihub: indexes.aihub.items.map((a) => ({ id: a.id, name: a.name || '', type: a.type || '', status: a.status })),
+    external_apis: indexes.external_apis.items.map((a) => ({ id: a.id, name: a.name || '', status: a.status })),
+    roles: indexes.roles.items.map((r) => ({ id: r.id, code: r.code || '', name: r.name || '', status: r.status })),
+    users_count: indexes.users.items.length,
+    routeRefs: Object.fromEntries([...routeRefs.entries()].map(([route, sources]) => [route, [...sources]])),
+  };
+}
+
+function isProbablySystemPage(page) {
+  const tag = String(page.tag || '');
+  const title = String(page.title || '');
+  const route = normalizeRoute(page.route);
+  return tag.includes('系统') || title.includes('系统') || ['/login', '/setup'].includes(route);
+}
+
+function analyzeProject(projectDir) {
+  const map = buildProjectMap(projectDir);
+  const errors = [];
+  const warnings = [];
+  const routeSeen = new Map();
+
+  if (!exists(path.join(projectDir, '.draftgo'))) {
+    errors.push('未找到 .draftgo/，请先运行 draftgo init 或 draftgo connect。');
+  }
+
+  for (const page of map.pages) {
+    const label = `${page.title || '未命名页面'}${page.id != null ? `#${page.id}` : ''}`;
+    if (!page.route) errors.push(`${label} 缺少 route。`);
+    if (!page.title) warnings.push(`${label} 缺少 title。`);
+    if (!page.html_file) errors.push(`${label} 找不到 html_file 或 page_${page.id}_*.html。`);
+
+    if (page.route) {
+      if (routeSeen.has(page.route)) {
+        errors.push(`route 重复：${page.route}（${routeSeen.get(page.route)} 与 ${label}）。`);
+      } else {
+        routeSeen.set(page.route, label);
+      }
+
+      if (page.route !== '/' && !isProbablySystemPage(page)) {
+        const refs = map.routeRefs[page.route] || [];
+        const own = pageKey(page);
+        const externalRefs = refs.filter((s) => s !== own);
+        if (externalRefs.length === 0) {
+          warnings.push(`${label} (${page.route}) 未在导航、首页或其他页面入口中发现绑定引用。`);
+        }
+      }
+    }
+
+    if (page.html_file) {
+      const html = readTextSafe(relToAbs(projectDir, page.html_file));
+      if (/\b(mockData|demoData|fakeData|sampleData|staticData)\b/i.test(html)) {
+        warnings.push(`${label} 疑似包含 mock/demo/fake/staticData，确认是否为用户明确要求的静态/demo。`);
+      }
+      if (/\b(onclick|addEventListener)\b[\s\S]{0,120}\b(toast|alert)\b/i.test(html) && !/\b(App\.(post|put|delete|get)|fetch\s*\()/i.test(html)) {
+        warnings.push(`${label} 疑似只有反馈提示、缺少真实数据读写或 API 调用。`);
+      }
+    }
+  }
+
+  if (map.pages.length === 0 && exists(path.join(projectDir, '.draftgo'))) {
+    warnings.push('未发现 pages/index.json 页面缓存；开发前建议先拉取页面。');
+  }
+
+  return { map, errors, warnings };
+}
+
+module.exports = {
+  buildProjectMap,
+  analyzeProject,
+  normalizeRoute,
+  extractRoutes,
+};