draftgo-cli 4.0.23 → 4.0.25

package/src/commands/help.js

@@ -1,38 +1,39 @@
-'use strict';
-
+'use strict';
+
 const { all } = require('../targets');
-const { HOSTS } = require('../mcp/hosts');
-const { getPackageVersion } = require('../skill');
-
-function help() {
-  const targets = all.map((i) => `    ${i.name.padEnd(12)} ${i.displayName}`).join('\n');
-  const mcpTargets = HOSTS.map((host) => {
-    const status = host.supported === false ? 'unsupported' : host.path;
-    return `    ${host.name.padEnd(12)} ${status}`;
-  }).join('\n');
-
-  console.log(`draftgo v${getPackageVersion()} - DraftGo workbench CLI for AI coding agents
-
+const { HOSTS } = require('../mcp/hosts');
+const { getPackageVersion } = require('../skill');
+
+function help() {
+  const targets = all.map((i) => `    ${i.name.padEnd(12)} ${i.displayName}`).join('\n');
+  const mcpTargets = HOSTS.map((host) => {
+    const status = host.supported === false ? 'unsupported' : host.path;
+    return `    ${host.name.padEnd(12)} ${status}`;
+  }).join('\n');
+
+  console.log(`draftgo v${getPackageVersion()} - DraftGo workbench CLI for AI coding agents
+
 DraftGo shell baseline: React + Vite. Database Pages default to native HTML,
 Tailwind CSS 4, and Basecoat UI; Oat UI remains an optional Web Components layer.
 MCP handles live discovery and structured resources; complete page, navigation,
 document, and custom-service bodies use checkout/commit outside MCP context.
 The installed Skill routes agents to task-specific References and MCP tools.
-
-Usage:
-  draftgo init [<target>...]       Install the DraftGo Skill. No target = detect.
-                                    Use "all" to install every Skill target.
+
+Usage:
+  draftgo init [<target>...]       Install the DraftGo Skill. No target = detect.
+                                    Use "all" to install every Skill target.
   draftgo update [<target>...]     Fully update the global CLI, then atomically
-                                    refresh installed or detected Skills.
-  draftgo uninstall <target|all>   Remove Skill files. --purge also removes
-                                    the entire .draftgo/ runtime directory.
+                                    refresh installed Skills. An explicit target
+                                    may also install that target when missing.
+  draftgo uninstall <target|all>   Remove Skill files. --purge also removes
+                                    the entire .draftgo/ runtime directory.
   draftgo status                   Show connection health, current scope, targets, and Skill version.
-
+
   draftgo connect [<target>...]    Verify and save server/API Key, then configure
-                                    a detected or explicit MCP host. This never
-                                    downloads DraftGo business resources.
-  draftgo mcp setup [<target>...]  Merge project-level stdio MCP configuration.
-  draftgo mcp status [<target>...] Check host configuration and secret safety.
+                                    a detected or explicit MCP host. This never
+                                    downloads DraftGo business resources.
+  draftgo mcp setup [<target>...]  Merge project-level stdio MCP configuration.
+  draftgo mcp status [<target>...] Check host configuration and secret safety.
   draftgo mcp test                 Test project, resource, and API MCP calls.
   draftgo mcp serve                Bridge local stdio to the remote /mcp endpoint.
 
@@ -41,7 +42,7 @@ Usage:
                                     Use --route/--title for exact selection.
   draftgo checkout <type> <id...>  Download a long-form body + verified base,
                                     including custom-service worktrees.
-                                    --force explicitly replaces local changes.
+                                    --force explicitly replaces local changes.
   draftgo check [custom-services <id...>]
                                     Validate all checkouts or selected custom services.
                                     --remote also compares remote hash/version.
@@ -73,20 +74,20 @@ Usage:
                                     Publish current validated drafts; batch errors
                                     report services already completed.
   draftgo reconcile <type> <id...> Repair stale metadata only when local equals remote.
-  draftgo conflicts                List unresolved conflicts; --all includes resolved.
-  draftgo conflict show <type> <id>
-                                    Show preserved base/local/remote paths.
-  draftgo conflict resolve <type> <id>
-                                    Mark a merged worktree file ready against the
-                                    preserved remote base; then check/diff/commit.
+  draftgo conflicts                List unresolved conflicts; --all includes resolved.
+  draftgo conflict show <type> <id>
+                                    Show preserved base/local/remote paths.
+  draftgo conflict resolve <type> <id>
+                                    Mark a merged worktree file ready against the
+                                    preserved remote base; then check/diff/commit.
   draftgo clean [--dry-run|--yes]  Plan or remove all tmp and registered artifacts.
   draftgo work start <item>       Add an active item to .draftgo/worklog.md.
   draftgo work add <item>         Add a pending item.
   draftgo work start-item <ref>   Mark an item active; ref is number or date#number.
   draftgo work complete <ref>     Mark an item complete; --note appends evidence.
   draftgo work show|list          Show the worklog or its structured item list.
-
-  draftgo api <query>              Search the live API contract through MCP.
+
+  draftgo api <query>              Search the live API contract through MCP.
   draftgo api describe <operation_id>
                                     Describe one live API operation through MCP.
   draftgo api call <operation_id> --input <json-file>
@@ -105,24 +106,24 @@ Usage:
                                     Manage db_meta record policies (none|owner|all).
   draftgo delete <operation_id> [id]
                                     Confirm and call a live delete operation.
-  draftgo deploy [<type> <id...>]  Check, then diff or commit checked-out content.
-                                    --delivery local needs no IDs; preview/deploy
-                                    require an explicit type and IDs.
+  draftgo deploy [<type> <id...>]  Check, then diff or commit checked-out content.
+                                    --delivery local needs no IDs; preview/deploy
+                                    require an explicit type and IDs.
   draftgo auto-push [<type> <id...>]
                                     With config.auto_push=true, check and commit
                                     changed checkouts. Any conflict stops the run.
   draftgo local setup|start|stop|logs|status
                                     Manage the project-local Docker stack.
-  draftgo list-targets             List Skill installation targets.
-  draftgo -v | --version           Print CLI version.
-  draftgo -h | --help              Show this help.
-
-Resource types:
+  draftgo list-targets             List Skill installation targets.
+  draftgo -v | --version           Print CLI version.
+  draftgo -h | --help              Show this help.
+
+Resource types:
   pages | nav/navigations | docs/articles | custom-services
-
-Important flags:
-  --project <dir>          Operate on <dir> instead of the current directory.
-  --target <name,...>      Select one or more MCP setup/status targets.
+
+Important flags:
+  --project <dir>          Operate on <dir> instead of the current directory.
+  --target <name,...>      Select one or more MCP setup/status targets.
   --server <url>           (connect) DraftGo base URL.
   --mcp-url <url>          (connect) Explicit endpoint; standard /mcp derives the
                            base URL; custom paths also need --server.
@@ -130,11 +131,11 @@ Important flags:
   --scope-type space --space-id <id>
                            (connect) Save a target space for workspace resources.
   --timeout <ms>           (connect/mcp test) Network timeout.
-  --allow-offline          (connect) Save only after explicitly accepting a
-                           failed MCP validation.
-  --no-mcp-setup           (connect) Do not write host MCP configuration.
-  --force                  (init/checkout) Overwrite Skill or local changes.
-  --purge                  (uninstall) Also remove the .draftgo/ directory.
+  --allow-offline          (connect) Save only after explicitly accepting a
+                           failed MCP validation.
+  --no-mcp-setup           (connect) Do not write host MCP configuration.
+  --force                  (init/checkout) Overwrite Skill or local changes.
+  --purge                  (uninstall) Also remove the .draftgo/ directory.
   --skip-update-check      (update) Refresh Skills without contacting npm.
   --connect                (init) Continue into DraftGo server connection.
   --no-setup               (init) Install the Skill without either setup flow.
@@ -150,8 +151,8 @@ Important flags:
   --stat                   (diff) Print per-file and total change statistics.
   --strict                 Treat check warnings as failures.
   --remote                 (check) Compare checkout hashes/versions with remote.
-  --yes                    Skip supported confirmation prompts.
-  --operation-id <id>      (delete) Select an operation explicitly.
+  --yes                    Skip supported confirmation prompts.
+  --operation-id <id>      (delete) Select an operation explicitly.
   --params <json>          (api call/delete) Pass an API parameter object.
   --input <file>           (api call/delete/custom-service test) Read a UTF-8
                            JSON object.
@@ -176,23 +177,23 @@ Important flags:
                            fallback: DRAFTGO_BROWSER_PATH.
   --selector <css>         (verify) Require a visible element in top or iframe DOM.
   --width/--height <px>    (verify) Override the default 1440x900 desktop viewport.
-
-Security:
+
+Security:
   .draftgo/config.json stores the server and API Key and is gitignored. Host MCP
   files contain only "draftgo mcp serve"; they never contain the API Key.
-
-MCP targets (project config or status):
-${mcpTargets}
-
-Skill targets:
-${targets}
-
-Examples:
-  draftgo init codex
+
+MCP targets (project config or status):
+${mcpTargets}
+
+Skill targets:
+${targets}
+
+Examples:
+  draftgo init codex
   draftgo connect codex --server https://draftgo.example --api-key <key>
   draftgo mcp test
   draftgo map --type pages --route /admin/channel-ops --summary --output json
-  draftgo checkout pages 42
+  draftgo checkout pages 42
   draftgo verify pages 42
   draftgo diff pages 42 --stat
   draftgo commit pages 42
@@ -200,8 +201,8 @@ Examples:
   draftgo test custom-services 12 --handler route:POST:/health --input request.json
   draftgo work start "Build document management and role permissions"
   draftgo work complete 1 --note "Verification and delivery passed"
-  draftgo deploy docs 7 --delivery preview
-`);
-}
-
-module.exports = help;
+  draftgo deploy docs 7 --delivery preview
+`);
+}
+
+module.exports = help;

package/src/commands/listTargets.js

@@ -1,13 +1,13 @@
-'use strict';
-
+'use strict';
+
 const { all } = require('../targets');
-
-function listTargets() {
-  console.log('draftgo 支持的 AI 工具（target）:');
-  for (const t of all) {
-    console.log(`  ${t.name.padEnd(12)} ${t.displayName}`);
-  }
-  return 0;
-}
-
-module.exports = listTargets;
+
+function listTargets() {
+  console.log('draftgo 支持的 AI 工具（target）:');
+  for (const t of all) {
+    console.log(`  ${t.name.padEnd(12)} ${t.displayName}`);
+  }
+  return 0;
+}
+
+module.exports = listTargets;

package/src/commands/status.js

@@ -1,5 +1,5 @@
-'use strict';
-
+'use strict';
+
 const log = require('../logger');
 const { all } = require('../targets');
 const { readInstalledVersion, getPackageVersion } = require('../skill');

package/src/commands/uninstall.js

@@ -1,52 +1,52 @@
-'use strict';
-
-const log = require('../logger');
+'use strict';
+
+const log = require('../logger');
 const { all, resolveTargets } = require('../targets');
-const { removePath } = require('../fsx');
-const { dgDir } = require('../paths');
-
-async function uninstall(projectDir, positional, flags) {
-  log.title('draftgo uninstall');
-
-  let resolved = [];
-  let unknown = [];
-  if (positional.length === 0) {
-    log.err('Please specify a target, or use `draftgo uninstall all` to remove every target.');
-    log.dim(`  Supported targets: ${all.map((i) => i.name).join(', ')}`);
-    return 1;
-  }
-  if (positional.includes('all')) {
-    resolved = all.slice();
-  } else {
-    ({ resolved, unknown } = resolveTargets(positional));
-    if (unknown.length) {
-      log.err(`未知 target：${unknown.join(', ')}`);
-      return 1;
-    }
-  }
-
-  log.step('移除入口文件');
-  for (const t of resolved) {
-    try {
-      const removed = t.uninstall(projectDir);
-      if (removed) log.ok(`${t.displayName} 入口已移除`);
-      else log.dim(`${t.displayName} 入口不存在，跳过`);
-    } catch (e) {
-      log.err(`${t.displayName} 卸载失败：${e.message}`);
-    }
-  }
-
-  // Each AI-tool skill directory is self-contained, so per-target uninstall
-  // already wiped its content above. Only --purge nukes runtime data under
+const { removePath } = require('../fsx');
+const { dgDir } = require('../paths');
+
+async function uninstall(projectDir, positional, flags) {
+  log.title('draftgo uninstall');
+
+  let resolved = [];
+  let unknown = [];
+  if (positional.length === 0) {
+    log.err('Please specify a target, or use `draftgo uninstall all` to remove every target.');
+    log.dim(`  Supported targets: ${all.map((i) => i.name).join(', ')}`);
+    return 1;
+  }
+  if (positional.includes('all')) {
+    resolved = all.slice();
+  } else {
+    ({ resolved, unknown } = resolveTargets(positional));
+    if (unknown.length) {
+      log.err(`未知 target：${unknown.join(', ')}`);
+      return 1;
+    }
+  }
+
+  log.step('移除入口文件');
+  for (const t of resolved) {
+    try {
+      const removed = t.uninstall(projectDir);
+      if (removed) log.ok(`${t.displayName} 入口已移除`);
+      else log.dim(`${t.displayName} 入口不存在，跳过`);
+    } catch (e) {
+      log.err(`${t.displayName} 卸载失败：${e.message}`);
+    }
+  }
+
+  // Each AI-tool skill directory is self-contained, so per-target uninstall
+  // already wiped its content above. Only --purge nukes runtime data under
   // .draftgo/ (config/worklog/lessons/cache etc.).
   if (flags.purge) {
     if (removePath(dgDir(projectDir))) {
       log.warn('已使用 --purge：.draftgo/（含 config/worklog/lessons 等运行时数据）已删除。');
     }
   }
-
-  log.title('完成');
-  return 0;
-}
-
-module.exports = uninstall;
+
+  log.title('完成');
+  return 0;
+}
+
+module.exports = uninstall;

package/src/commands/update.js

@@ -2,10 +2,9 @@
 
 const { spawnSync } = require('child_process');
 const log = require('../logger');
-const { all, byName, resolveTargets } = require('../targets');
+const { all, resolveTargets } = require('../targets');
 const { ensureRuntime, writeInstalledVersion, readInstalledVersion, getPackageVersion } = require('../skill');
 const { fetchLatestVersion, cmpSemver } = require('../updateCheck');
-const { detectTargets } = require('../detect');
 const { readInstallMarker, installRelease } = require('../releaseInstall');
 
 const REENTRY_FLAG = 'DRAFTGO_UPDATE_REENTERED';
@@ -16,6 +15,10 @@ function installedTargetsNotRefreshed(projectDir, refreshedTargets) {
     !refreshed.has(target.name) && target.status(projectDir).installed);
 }
 
+function targetInstalled(projectDir, target) {
+  return typeof target.status === 'function' && target.status(projectDir).installed === true;
+}
+
 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;
@@ -66,7 +69,7 @@ async function updateCliIfNeeded(projectDir, positional, flags) {
   }
   return Number.isInteger(rerun.status) ? rerun.status : 1;
 }
-
+
 async function update(projectDir, positional, flags) {
   log.title('draftgo update');
 
@@ -75,45 +78,36 @@ async function update(projectDir, positional, flags) {
 
   const prev = readInstalledVersion(projectDir);
   log.info(`当前已装 skill：${prev || '未安装'}，CLI 版本：${getPackageVersion()}`);
-
-  // Determine which entry files to refresh:
-  //   - no positional → refresh installed targets plus project-level tool signals
-  //   - "all"          → refresh every known target
-  //   - names          → refresh the specified targets
-  let resolved = [];
+
+  // Implicit update only refreshes existing Skills. An explicit target is a
+  // deliberate request and may install that target when it is missing.
+  let resolved = [];
   let unknown = [];
 
-  if (positional.length === 0) {
-    const byTarget = new Map();
-    for (const t of all) {
-      if (t.status(projectDir).installed) byTarget.set(t.name, t);
-    }
-    for (const name of detectTargets(projectDir)) {
-      if (byName[name]) byTarget.set(name, byName[name]);
-    }
-    resolved = Array.from(byTarget.values());
+  if (positional.length === 0 || positional.includes('all')) {
+    resolved = all.filter((target) => targetInstalled(projectDir, target));
     if (resolved.length === 0) {
-      log.warn('未检测到任何已安装或可识别的 AI 工具目标，无可刷新内容。');
-      log.dim('  使用 `draftgo update all` 或 `draftgo update <target>` 强制刷新。');
+      log.warn('未检测到已安装的 DraftGo Skill，无可刷新内容。');
+      log.dim('  需要新增 AI 工具时，请使用 `draftgo init <target>`。');
       return 0;
     } else {
       log.info(`刷新目标：${resolved.map((r) => r.displayName).join(', ')}`);
     }
   } else {
-    ({ resolved, unknown } = resolveTargets(positional));
+    ({ resolved, unknown } = resolveTargets(positional));
     if (unknown.length) {
       log.err(`未知 target：${unknown.join(', ')}`);
       return 1;
     }
   }
-
+
   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}`);
+    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);
@@ -132,11 +126,11 @@ async function update(projectDir, positional, flags) {
   } else {
     writeInstalledVersion(projectDir);
   }
-
-  log.title('完成');
-  return 0;
-}
-
+
+  log.title('完成');
+  return 0;
+}
+
 module.exports = update;
 module.exports.updateCliIfNeeded = updateCliIfNeeded;
 module.exports.installedTargetsNotRefreshed = installedTargetsNotRefreshed;

package/src/customServices.js

@@ -316,7 +316,8 @@ async function commit(projectDir, ids, options = {}) {
     if (entry.server !== config.server) throw new WorktreeError('CHECKOUT_SERVER_MISMATCH', 'Checkout belongs to a different DraftGo server.');
     syncManagedDevelopmentFiles(entry.local_dir);
     const state = localState(entry); if (!state.base_valid) throw new WorktreeError('BASE_HASH_MISMATCH', `Custom service ${id} base does not match its manifest.`);
-    if (!state.modified) return { id, entry, state, unchanged: true };
+    const createDraft = Boolean(options.ensureDraft) && entry.checkout_source === 'live';
+    if (!state.modified && !createDraft) return { id, entry, state, unchanged: true };
     const current = await metadata(config, id, options);
     if (current.content_hash !== entry.base_hash || String(current.base_revision) !== String(entry.base_revision)) {
       const remoteArchive = await download(config, current, options); const conflict = await writeConflict(projectDir, entry, current, remoteArchive);
@@ -406,7 +407,7 @@ function validationStale(error) {
     && error.details && error.details.reason === 'validation_stale';
 }
 async function validate(projectDir, id, options = {}) {
-  const config = options.config || loadProjectConfig(projectDir); await commit(projectDir, [id], { ...options, config });
+  const config = options.config || loadProjectConfig(projectDir); await commit(projectDir, [id], { ...options, config, ensureDraft: true });
   const manifest = loadManifest(projectDir); const result = await validateCommitted(projectDir, id, config, manifest, options);
   if (!result.cached) saveManifest(projectDir, manifest);
   return result;
@@ -427,7 +428,7 @@ async function test(projectDir, id, input = {}, options = {}) {
   let entry;
   let revision;
   if (source === 'draft') {
-    await commit(projectDir, [id], { ...options, config });
+    await commit(projectDir, [id], { ...options, config, ensureDraft: true });
     manifest = loadManifest(projectDir);
     const validation = await validateCommitted(projectDir, id, config, manifest, options);
     entry = manifest.entries[entryKey(id)];
@@ -447,7 +448,7 @@ async function test(projectDir, id, input = {}, options = {}) {
 }
 async function publish(projectDir, ids, options = {}) {
   const config = options.config || loadProjectConfig(projectDir); const targets = uniqueIDs(ids);
-  await commit(projectDir, targets, { ...options, config });
+  await commit(projectDir, targets, { ...options, config, ensureDraft: true });
   const manifest = loadManifest(projectDir);
   const validations = await Promise.all(targets.map((id) => validateCommitted(projectDir, id, config, manifest, options)));
   if (validations.some((result) => !result.cached)) saveManifest(projectDir, manifest);

package/src/detect.js

@@ -1,5 +1,5 @@
-'use strict';
-
+'use strict';
+
 const path = require('path');
 const { exists } = require('./fsx');
 const { platforms } = require('./platforms');
@@ -9,15 +9,15 @@ const { platforms } = require('./platforms');
 const SIGNALS = Object.fromEntries(
   platforms.map((p) => [p.name, p.signals || []])
 );
-
-function detectTargets(projectDir) {
-  const hits = [];
-  for (const [name, signals] of Object.entries(SIGNALS)) {
-    if (signals.some((s) => exists(path.join(projectDir, s)))) {
-      hits.push(name);
-    }
-  }
-  return hits;
-}
-
-module.exports = { SIGNALS, detectTargets };
+
+function detectTargets(projectDir) {
+  const hits = [];
+  for (const [name, signals] of Object.entries(SIGNALS)) {
+    if (signals.some((s) => exists(path.join(projectDir, s)))) {
+      hits.push(name);
+    }
+  }
+  return hits;
+}
+
+module.exports = { SIGNALS, detectTargets };