draftgo-cli 3.0.56 → 4.0.22

package/src/commands/customService.js

@@ -1,18 +1,18 @@
 'use strict';
 
 const fs = require('fs');
+const path = require('path');
 const log = require('../logger');
 const services = require('../customServices');
+const { report, formatSummary, formatStat } = require('../diffReport');
 
 function ids(positional) { return positional.map(String).filter(Boolean); }
-const TYPE_ALIASES = new Set(['custom-services', 'custom-service', 'custom_services', 'custom_service', 'services', 'scripts', 'custom_scripts']);
 function isServiceType(value) {
-  return TYPE_ALIASES.has(String(value || '').toLowerCase());
+  return String(value || '').toLowerCase() === 'custom-services';
 }
 function serviceIds(positional) {
   const values = ids(positional);
-  if (isServiceType(values[0])) values.shift();
-  return values;
+  return isServiceType(values[0]) ? values.slice(1) : [];
 }
 function output(flags, value) {
   if (flags.output === 'json') console.log(JSON.stringify(value, null, 2));
@@ -30,9 +30,10 @@ async function checkout(projectDir, positional, flags = {}) {
 async function commit(projectDir, positional, flags = {}) {
   const values = ids(positional);
   if (!values.length) { log.err('Usage: draftgo commit custom-services <id...>'); return 1; }
-  const result = await services.commit(projectDir, values);
+  // The user-facing custom-service commit is a complete delivery operation.
+  const result = await services.publish(projectDir, values);
   if (flags.output === 'json') output(flags, result);
-  else result.forEach((item) => log.ok(`custom service ${item.resource_id}: ${item.status}`));
+  else result.forEach((item) => log.ok(`custom service ${item.id || item.resource_id}: published (commit + validate + publish)`));
   return 0;
 }
 
@@ -40,7 +41,18 @@ async function diff(projectDir, positional, flags = {}) {
   const id = positional[0];
   if (!id) { log.err('Usage: draftgo diff custom-services <id>'); return 1; }
   const result = services.diff(projectDir, id);
-  if (flags.output === 'json') output(flags, result);
+  const concise = Boolean(flags.stat || flags.summary);
+  const value = concise ? report(result.entry, result.file_outputs.map((file) => ({
+    path: file.filename,
+    changed: file.changed,
+    output: file.output,
+    base_path: path.join(result.entry.base_dir, file.filename),
+    local_path: path.join(result.entry.local_dir, file.filename),
+  }))) : null;
+  if (flags.output === 'json' && concise) output(flags, value);
+  else if (flags.output === 'json') output(flags, result);
+  else if (flags.stat) process.stdout.write(formatStat(value));
+  else if (flags.summary) process.stdout.write(formatSummary(value));
   else if (result.changed) process.stdout.write(result.output);
   else log.dim(`custom service ${id}: no local changes`);
   return 0;
@@ -62,8 +74,10 @@ async function test(projectDir, positional, flags = {}) {
   const readJSON = (value) => value ? JSON.parse(fs.readFileSync(String(value), 'utf8')) : undefined;
   const policy = String(flags['side-effect-policy'] || 'deny').toLowerCase();
   if (!['deny', 'mock', 'live'].includes(policy)) throw new Error('--side-effect-policy must be deny, mock, or live.');
+  const source = String(flags.source || 'draft').toLowerCase();
+  if (!['auto', 'draft', 'published'].includes(source)) throw new Error('--source must be auto, draft, or published.');
   const result = await services.test(projectDir, id, input, { handler: flags.handler, headers: readJSON(flags.headers), user: readJSON(flags.user),
-    testWrite: Boolean(flags['test-write']), sideEffectPolicy: policy });
+    testWrite: Boolean(flags['test-write']), sideEffectPolicy: policy, source });
   if (flags.output === 'json') output(flags, result);
   else log[result.status === 'success' ? 'ok' : 'err'](`custom service ${id}: ${result.status}`);
   return result.status === 'success' ? 0 : 1;

package/src/commands/dataRange.js

@@ -0,0 +1,33 @@
+'use strict';
+
+const log = require('../logger');
+const { callOperation } = require('./api');
+
+// DataRange is represented by db_meta record policies; it is not a second
+// authorization scope or a free-form client-side filter.
+const OPERATIONS = Object.freeze({
+  list: 'list_meta_api_db_meta_get',
+  create: 'create_meta_api_db_meta_post',
+  get: 'get_meta_api_db_meta__type__get',
+  update: 'update_meta_api_db_meta__id__put',
+  batch: 'update_meta_batch_api_db_meta_batch_patch',
+  delete: 'delete_meta_api_db_meta__id__delete',
+});
+
+function operationKey(value) {
+  const action = String(value || 'list').trim().toLowerCase();
+  return OPERATIONS[action] ? action : '';
+}
+
+async function dataRangeCommand(projectDir, positional, flags = {}) {
+  const action = operationKey(positional[0]);
+  if (!action) {
+    log.err('Usage: draftgo data-range list|create|get|update|batch|delete --input <json-file>');
+    return 1;
+  }
+  return callOperation(projectDir, OPERATIONS[action], flags);
+}
+
+module.exports = dataRangeCommand;
+module.exports.OPERATIONS = OPERATIONS;
+module.exports.operationKey = operationKey;

package/src/commands/delete.js

@@ -6,23 +6,13 @@ const log = require('../logger');
 const { confirm } = require('../prompt');
 const { loadProjectConfig } = require('../projectConfig');
 const { TOOL_NAMES, openToolSession, callStructured } = require('../mcp/tools');
-
-const LEGACY_TYPES = new Set([
-  'page', 'pages', 'nav', 'navigation', 'navigations', 'doc', 'docs', 'article',
-  'db_meta', 'custom_scripts', 'doc_categories', 'aihub', 'roles', 'users', 'system_config',
-]);
-
-function resultItems(value) {
-  if (Array.isArray(value)) return value;
-  if (!value || typeof value !== 'object') return [];
-  if (Array.isArray(value.items)) return value.items;
-  if (Array.isArray(value.operations)) return value.operations;
-  return value.data ? resultItems(value.data) : [];
-}
-
-function operationId(value) {
-  return value && (value.operation_id || value.operationId || value.id);
-}
+const { cachedDescription, normalizeDescription, storeDescription } = require('../apiContractCache');
+const {
+  isContractCompatibilityError,
+  isHardContractIncompatibility,
+  sameOperationContract,
+  incompatibleOperationError,
+} = require('../contractCompatibility');
 
 function readParams(projectDir, flags) {
   const raw = flags.params ? String(flags.params)
@@ -45,40 +35,25 @@ function pathParameterName(description) {
 async function deleteResource(projectDir, positional, flags = {}) {
   if (!positional.length && !flags['operation-id']) {
     log.err('Usage: draftgo delete <operation_id> [id] [--params JSON]');
-    log.dim('  Legacy form is supported when discovery is unambiguous: draftgo delete <type> <id>.');
     return 1;
   }
   const config = loadProjectConfig(projectDir);
   const session = await openToolSession(config, [
-    TOOL_NAMES.apiSearch, TOOL_NAMES.apiDescribe, TOOL_NAMES.apiCall,
+    TOOL_NAMES.apiDescribe, TOOL_NAMES.apiCall,
   ]);
 
-  const first = String(positional[0] || '');
-  const legacy = LEGACY_TYPES.has(first.toLowerCase()) && !flags['operation-id'];
-  let selectedOperation = flags['operation-id'] ? String(flags['operation-id']) : (legacy ? null : first);
-  const resourceId = legacy ? positional[1] : positional[1];
-  if (legacy) {
-    if (!resourceId) {
-      log.err('Legacy delete form requires a resource id.');
-      return 1;
-    }
-    const search = await callStructured(session, TOOL_NAMES.apiSearch, { query: `delete ${first}` });
-    const candidates = resultItems(search).filter((item) => operationId(item)
-      && (!item.method || String(item.method).toUpperCase() === 'DELETE'));
-    if (candidates.length !== 1) {
-      log.err(`Delete operation discovery was ambiguous (${candidates.length} matches).`);
-      log.dim(`  Run \`draftgo api delete ${first}\`, then pass --operation-id explicitly.`);
-      return 1;
-    }
-    selectedOperation = operationId(candidates[0]);
-  }
+  const selectedOperation = flags['operation-id'] ? String(flags['operation-id']) : String(positional[0]);
+  const resourceId = positional[1];
 
-  const description = await callStructured(session, TOOL_NAMES.apiDescribe, {
-    operation_id: selectedOperation,
-  });
+  let contract = cachedDescription(projectDir, config.server, selectedOperation);
+  if (!contract) {
+    const described = await callStructured(session, TOOL_NAMES.apiDescribe, { operation_id: selectedOperation });
+    contract = storeDescription(projectDir, config.server, described) || normalizeDescription(described);
+  }
+  if (!contract) throw new Error('DraftGo API description is missing contract revision metadata.');
   const params = readParams(projectDir, flags);
   if (resourceId && Object.keys(params).length === 0) {
-    const parameterName = pathParameterName(description);
+    const parameterName = pathParameterName(contract.operation);
     if (!parameterName) {
       log.err('The operation does not expose exactly one path parameter; provide --params JSON explicitly.');
       return 1;
@@ -89,11 +64,24 @@ async function deleteResource(projectDir, positional, flags = {}) {
     const approved = await confirm(`Call destructive DraftGo operation ${selectedOperation}?`, { default: false });
     if (!approved) return 0;
   }
-  const result = await callStructured(session, TOOL_NAMES.apiCall, {
-    ...params,
-    operation_id: selectedOperation,
-    confirm: true,
+  const invoke = () => callStructured(session, TOOL_NAMES.apiCall, {
+    ...params, operation_id: selectedOperation, registry_revision: contract.registry_revision, confirm: true,
   });
+  let result;
+  try {
+    result = await invoke();
+  } catch (error) {
+    if (!isContractCompatibilityError(error)) throw error;
+    if (isHardContractIncompatibility(error)) throw incompatibleOperationError(selectedOperation, error);
+    const previousContract = contract;
+    const described = await callStructured(session, TOOL_NAMES.apiDescribe, { operation_id: selectedOperation });
+    contract = storeDescription(projectDir, config.server, described) || normalizeDescription(described);
+    if (!contract) throw new Error('DraftGo API description is missing contract revision metadata.');
+    if (!sameOperationContract(previousContract, contract)) {
+      throw incompatibleOperationError(selectedOperation, error);
+    }
+    result = await invoke();
+  }
   if (flags.output === 'json') console.log(JSON.stringify(result, null, 2));
   else log.ok(`DraftGo operation completed: ${selectedOperation}`);
   return 0;

package/src/commands/deploy.js

@@ -23,7 +23,7 @@ async function deploy(projectDir, positional, flags = {}) {
 
   const [resourceType, ...ids] = positional;
   if (!resourceType || !ids.length) {
-    log.err('Deploy no longer commits every legacy index. Specify <pages|nav|docs> <id...>.');
+    log.err('Usage: draftgo deploy <pages|nav|docs> <id...> --delivery preview|deploy');
     return 1;
   }
   if (delivery === 'preview') {

package/src/commands/diff.js

@@ -2,19 +2,35 @@
 
 const log = require('../logger');
 const { diffResource } = require('../worktree');
+const { report, formatSummary, formatStat } = require('../diffReport');
+const { absolutePath } = require('../worktree/manifest');
 
 function diff(projectDir, positional, flags = {}) {
   const [resourceType, resourceId] = positional;
   if (!resourceType || !resourceId) {
-    log.err('Usage: draftgo diff <pages|nav|docs> <id>');
+    log.err('Usage: draftgo diff <pages|nav|docs|custom-services> <id>');
     return 1;
   }
   if (require('./customService').isServiceType(resourceType)) {
     return require('./customService').diff(projectDir, [resourceId], flags);
   }
   const result = diffResource(projectDir, resourceType, resourceId);
-  if (flags.output === 'json') {
+  const concise = Boolean(flags.stat || flags.summary);
+  const value = concise ? report(result.entry, [{
+    path: result.entry.local_path,
+    changed: result.changed,
+    output: result.output,
+    base_path: absolutePath(projectDir, result.entry.base_path),
+    local_path: absolutePath(projectDir, result.entry.local_path),
+  }]) : null;
+  if (flags.output === 'json' && concise) {
+    console.log(JSON.stringify(value, null, 2));
+  } else if (flags.output === 'json') {
     console.log(JSON.stringify({ changed: result.changed, entry: result.entry, diff: result.output }, null, 2));
+  } else if (flags.stat) {
+    process.stdout.write(formatStat(value));
+  } else if (flags.summary) {
+    process.stdout.write(formatSummary(value));
   } else if (result.changed) {
     process.stdout.write(result.output);
   } else {

package/src/commands/grant.js

@@ -0,0 +1,29 @@
+'use strict';
+
+const log = require('../logger');
+const { callOperation } = require('./api');
+
+const OPERATIONS = Object.freeze({
+  list: 'listAccessGrants',
+  create: 'createAccessGrant',
+  get: 'getAccessGrant',
+  revoke: 'revokeAccessGrant',
+});
+
+function operationKey(value) {
+  const action = String(value || 'list').trim().toLowerCase();
+  return OPERATIONS[action] ? action : '';
+}
+
+async function grantCommand(projectDir, positional, flags = {}) {
+  const action = operationKey(positional[0]);
+  if (!action) {
+    log.err('Usage: draftgo grant list|create|get|revoke [--input <json-file>]');
+    return 1;
+  }
+  return callOperation(projectDir, OPERATIONS[action], flags);
+}
+
+module.exports = grantCommand;
+module.exports.OPERATIONS = OPERATIONS;
+module.exports.operationKey = operationKey;

package/src/commands/group.js

@@ -0,0 +1,38 @@
+'use strict';
+
+const log = require('../logger');
+const { callOperation } = require('./api');
+
+const OPERATIONS = Object.freeze({
+  list: 'listUserGroups',
+  create: 'createUserGroup',
+  get: 'getUserGroup',
+  update: 'updateUserGroup',
+  replace: 'replaceUserGroup',
+  remove: 'removeUserGroup',
+  'members.list': 'listUserGroupMembers',
+  'members.add': 'addUserGroupMember',
+  'members.remove': 'removeUserGroupMember',
+});
+
+function operationKey(parts) {
+  const values = parts.map((part) => String(part || '').trim().toLowerCase()).filter(Boolean);
+  if (values.length === 1) return values[0] === 'delete' ? 'remove' : values[0];
+  if (values.length === 2 && ['member', 'members'].includes(values[0])) {
+    return `members.${values[1] === 'delete' ? 'remove' : values[1]}`;
+  }
+  return '';
+}
+
+async function groupCommand(projectDir, positional, flags = {}) {
+  const key = operationKey(positional);
+  if (!OPERATIONS[key]) {
+    log.err('Usage: draftgo group list|create|get|update|replace|remove | members list|add|remove [--input <json-file>]');
+    return 1;
+  }
+  return callOperation(projectDir, OPERATIONS[key], flags);
+}
+
+module.exports = groupCommand;
+module.exports.OPERATIONS = OPERATIONS;
+module.exports.operationKey = operationKey;

package/src/commands/help.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { all } = require('../installers');
+const { all } = require('../targets');
 const { HOSTS } = require('../mcp/hosts');
 const { getPackageVersion } = require('../skill');
 
@@ -13,8 +13,8 @@ function help() {
 
   console.log(`draftgo v${getPackageVersion()} - DraftGo workbench CLI for AI coding agents
 
-DraftGo Next frontend baseline: React + Vite.
-Database pages may use native web technologies or bundled component libraries.
+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.
@@ -26,9 +26,9 @@ Usage:
                                     refresh installed or detected Skills.
   draftgo uninstall <target|all>   Remove Skill files. --purge also removes
                                     the entire .draftgo/ runtime directory.
-  draftgo status                   Show installed targets and Skill version.
+  draftgo status                   Show connection health, current scope, targets, and Skill version.
 
-  draftgo connect [<target>...]    Verify and save server/SAT, then configure
+  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.
@@ -36,24 +36,42 @@ Usage:
   draftgo mcp test                 Test project, resource, and API MCP calls.
   draftgo mcp serve                Bridge local stdio to the remote /mcp endpoint.
 
-  draftgo map                      Read remote overview/resources through MCP and
-                                    overlay local checkout state.
-  draftgo checkout <type> <id...>  Download pages/nav/docs body + verified base.
+  draftgo map [--type <type>]      Locate bounded remote resource metadata and
+                                    overlay matching local checkout state.
+                                    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.
   draftgo check [custom-services <id...>]
                                     Validate all checkouts or selected custom services.
                                     --remote also compares remote hash/version.
-  draftgo verify [<type> <id...>]   Run unified static verification; --remote adds
-                                    remote comparison and --url enables UI checks.
-  draftgo diff <type> <id>         Show checkout base versus local body.
-  draftgo commit <type> <id...>    Validate and upload complete checked-out bodies.
+  draftgo verify [<type> <id...>]   Run the default delivery verification.
+                                    Browser options are explicit and optional.
+  draftgo diff <type> <id>         Show checkout base versus local body/files.
+                                    --stat/--summary omit the full patch.
+  draftgo commit <type> <id...>    Validate and upload complete checked-out bodies/files.
+  draftgo components search <query>  Search the live component catalog.
+  draftgo components show <library/component>
+                                    Show HTML, props, slots, CSS variables and revision.
+  draftgo components expand --page <id> --instance <data-dg-instance>
+                                    Expand one component in a checked-out Page worktree.
+  draftgo components libraries list|show|create|update|delete
+                                    Manage component libraries.
+  draftgo components list|create|copy|delete
+                                    Manage component catalog entries.
+  draftgo components checkout|diff|verify|commit|publish <library/component>
+                                    Develop a component draft locally, then publish explicitly.
+  draftgo components import <zip> [--dry-run]
+  draftgo components export <library> [--file <zip>]
+                                    Transfer standard DraftGo component archives.
   draftgo refresh <type> <id...>   Safely refresh a clean checkout from the cloud.
   draftgo validate custom-services <id>
                                     Build and inspect the current cloud draft.
-  draftgo test custom-services <id> [--handler <selector>]
+  draftgo test custom-services <id> [--source <source>] [--input <file>] [--handler <selector>]
                                     Run the cloud draft in the DraftGo Runner.
   draftgo publish custom-services <id...>
-                                    Publish validated drafts atomically.
+                                    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>
@@ -61,37 +79,40 @@ Usage:
   draftgo conflict resolve <type> <id>
                                     Mark a merged worktree file ready against the
                                     preserved remote base; then check/diff/commit.
-  draftgo verify-ui <url>          Deprecated alias for verify --url <url> --ui always.
   draftgo clean [--dry-run|--yes]  Plan or remove all tmp and registered artifacts.
-  draftgo task <operation> [...]   Track sustained work in one authoritative Task.md.
-                                    Operations: create, list, show, add, claim,
-                                    start, complete, block, reopen, accept, finish,
-                                    and explicit legacy migrate.
+  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 describe <operation_id>
                                     Describe one live API operation through MCP.
   draftgo api call <operation_id> --input <json-file>
                                     Call one described operation with UTF-8 JSON.
+  draftgo capabilities list|search|show|audit
+                                    Discover and audit the current server's live operation catalog.
+  draftgo space <action>            Manage spaces and workspace members.
+  draftgo group <action>            Manage workspace groups and group members.
+  draftgo grant list|create|get|revoke
+                                    Manage platform/space AccessGrants.
+  draftgo api-key status|create|update|delete|rotate|reset|enable|disable
+                                    Manage the current user's API key through MCP.
+  draftgo role permissions|list|create|get|update|delete
+                                    Manage structured permission templates.
+  draftgo data-range list|create|get|update|batch|delete
+                                    Manage db_meta record policies (none|owner|all).
   draftgo delete <operation_id> [id]
                                     Confirm and call a live delete operation.
-                                    Legacy <type> <id> works only when unambiguous.
   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 changelog add <result>   Append one completed result after the task has
-                                    passed unified verification and delivery.
-  draftgo pull                     Migration notice only; always downloads nothing.
-  draftgo push <type> <id...>      Deprecated alias to commit for pages/nav/docs.
-                                    Push-all and structured-resource push are removed.
-
   draftgo local setup|start|stop|logs|status
-                                    Manage the existing local Docker stack. up/down
-                                    remain aliases for start/stop; status also has ps.
-  draftgo local-dev                Compatibility alias for \`draftgo local setup\`.
+                                    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.
@@ -105,7 +126,9 @@ Important flags:
   --server <url>           (connect) DraftGo base URL.
   --mcp-url <url>          (connect) Explicit endpoint; standard /mcp derives the
                            base URL; custom paths also need --server.
-  --token <sat>            (connect) SAT for non-interactive use.
+  --api-key <key>          (connect) DraftGo user API Key for non-interactive use.
+  --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.
@@ -114,42 +137,49 @@ Important flags:
   --purge                  (uninstall) Also remove the .draftgo/ directory.
   --skip-update-check      (update) Refresh Skills without contacting npm.
   --connect                (init) Continue into DraftGo server connection.
-  --local-dev              (init) Continue into local Docker setup.
   --no-setup               (init) Install the Skill without either setup flow.
   --output json            Print machine-readable output where supported.
-  --type <type>            (map) pages | nav/navigations | docs/articles.
+  --type <type>            (map) pages | nav/navigations | docs/articles |
+                           custom-services.
+  --route <path>           (map) Select resources with this exact route.
+  --title <title>          (map) Select resources with this exact title.
+  --limit <1-100>          (map) Maximum resources returned per type/page;
+                           defaults to 20.
+  --cursor <cursor>        (map) Continue one typed map result page.
+  --summary                (map/diff) Print bounded resource or change summary.
+  --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.
   --params <json>          (api call/delete) Pass an API parameter object.
-  --input <file>           (api call/delete) Read a UTF-8 JSON parameter object.
+  --input <file>           (api call/delete/custom-service test) Read a UTF-8
+                           JSON object.
   --handler <selector>     (custom-service test) route:METHOD:/path, event:name,
                            scheduled:name, or a handler name.
+  --source <source>        (custom-service test) draft (default), auto, or published.
   --headers/--user <file>  (custom-service test) Read JSON test identity data.
   --test-write             (custom-service test) Permit declared write testing.
   --side-effect-policy <mode>
                            (custom-service test) deny | mock | live; default deny.
   --delivery <mode>        (deploy) local | preview | deploy.
-  --dry-run                (push) Show diffs without committing.
-  --ui <mode>              (verify) auto | always | never; auto runs with --url.
+  --dry-run                Preview supported cleanup or delivery operations.
+  --ui <mode>              (verify) always | never; default never.
   --remote                 (check/verify) Compare checkout hashes with remote.
   --viewport <mode>        (verify) mobile | desktop | both.
   --frame <mode>           (verify) auto | top | all | <iframe-selector>.
-  --mobile-check <mode>    (verify-ui compatibility) auto | always | never.
   --token <mode>           (verify) auto | never; auto appends the configured
-                           SAT to same-origin URLs as the token query parameter.
-  --screenshot <mode>      (verify) on-failure | always | never; default never.
+                           API Key to same-origin URLs as the token query parameter.
+  --screenshot <mode>      (verify) always | never; always alone captures a screenshot.
   --browser <name>         (verify) chromium | chrome | msedge.
   --browser-path <file>    (verify) Explicit browser executable; environment
                            fallback: DRAFTGO_BROWSER_PATH.
-  --resource <type:id>     (verify compatibility) Assert one remote UI resource.
   --selector <css>         (verify) Require a visible element in top or iframe DOM.
-  --width/--height <px>    (verify) Override the default 390x844 viewport.
+  --width/--height <px>    (verify) Override the default 1440x900 desktop viewport.
 
 Security:
-  .draftgo/config.json stores the server and SAT and is gitignored. Host MCP
-  files contain only "draftgo mcp serve"; they never contain the SAT.
+  .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}
@@ -159,18 +189,17 @@ ${targets}
 
 Examples:
   draftgo init codex
-  draftgo connect codex --server https://draftgo.example --token <sat>
+  draftgo connect codex --server https://draftgo.example --api-key <key>
   draftgo mcp test
-  draftgo map --output json
+  draftgo map --type pages --route /admin/channel-ops --summary --output json
   draftgo checkout pages 42
-  draftgo check --strict
-  draftgo verify pages 42 --remote --url http://localhost:5173/example
-  draftgo diff pages 42
+  draftgo verify pages 42
+  draftgo diff pages 42 --stat
   draftgo commit pages 42
-  draftgo changelog add "Complete document management and role permissions"
-  draftgo task create "Personal growth" --original "Build a Notion-like system" \
-    --clarified "Build goals, habits, notes, and reviews" \
-    --expected-effect "Users manage personal growth in one workspace"
+  draftgo checkout custom-services 12
+  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
 `);
 }

package/src/commands/init.js

@@ -3,7 +3,7 @@
 const path = require('path');
 const log = require('../logger');
 const { detectTargets } = require('../detect');
-const { resolveTargets, all } = require('../installers');
+const { resolveTargets, all } = require('../targets');
 const { ensureRuntime, getPackageVersion } = require('../skill');
 const { exists } = require('../fsx');
 const { ask } = require('../prompt');
@@ -76,29 +76,23 @@ async function init(projectDir, positional, flags) {
   const cfgPath = path.join(projectDir, '.draftgo', 'config.json');
   const hasConfig = exists(cfgPath);
   const flagConnect = flags.connect === true;
-  const flagLocalDev = flags['local-dev'] === true;
-  const flagSkip = flags['no-local-dev'] === true
-    || flags['skip-local-dev'] === true
-    || flags['no-setup'] === true;
+  const flagSkip = flags['no-setup'] === true;
   const interactive = process.stdin.isTTY && process.stdout.isTTY;
 
   if (!hasConfig && !flagSkip) {
-    // 非交互场景下，如果同时给了 --server 和 --token，直接走 connect，不再阻塞在 TTY 提示上。
-    if (flags.server && flags.token && !flagConnect && !flagLocalDev) {
+    // Non-interactive setup can connect immediately with a server and API Key.
+    if (flags.server && (flags['api-key'] || flags.token) && !flagConnect) {
       return await require('./connect')(projectDir, [], flags);
     }
     if (flagConnect) {
       return await require('./connect')(projectDir, [], flags);
     }
-    if (flagLocalDev) {
-      return await require('./localDev')(projectDir, [], flags);
-    }
     if (interactive) {
       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.dim('      使用 Docker 启动 DraftGo；按需准备共享的 MySQL、Redis 和 Qdrant。');
       log.plain(`  ${log.c.cyan('[C]')} 稍后自行处理`);
       log.dim('      仅安装 Skill，不写入服务配置，也不创建容器。');
       const choice = (await ask('请选择 [A/B/C]', { default: 'C' })).trim().toUpperCase();
@@ -106,7 +100,7 @@ async function init(projectDir, positional, flags) {
         return await require('./connect')(projectDir, [], flags);
       }
       if (choice === 'B') {
-        return await require('./localDev')(projectDir, [], { ...flags, yes: true });
+        return await require('../localRuntime').runWizard(projectDir, { yes: true });
       }
       if (choice !== 'C') {
         log.warn('无效选择，已跳过基座处理。');

package/src/commands/listTargets.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { all } = require('../installers');
+const { all } = require('../targets');
 
 function listTargets() {
   console.log('draftgo 支持的 AI 工具（target）:');