draftgo-cli 4.0.24 → 4.0.26

package/src/commands/map.js

@@ -7,15 +7,18 @@ const { TOOL_NAMES, openToolSession, callStructured } = require('../mcp/tools');
 const { allWithAbort } = require('../mcp/parallel');
 const { inspectRemoteCheckouts } = require('../worktree/status');
 const { loadManifest } = require('../worktree/manifest');
-const customServices = require('../customServices');
 
 const REMOTE_RESOURCE_TYPES = Object.freeze({
   pages: 'pages',
   navigations: 'navigations',
   docs: 'docs/articles',
-  custom_services: 'custom_services',
 });
 const DEFAULT_REMOTE_RESOURCE_TYPES = Object.freeze(Object.values(REMOTE_RESOURCE_TYPES));
+const LIST_OPERATIONS = Object.freeze({
+  pages: 'listPage',
+  navigations: 'listNavigation',
+  'docs/articles': 'listDocAdminArticle',
+});
 
 function itemsFrom(value) {
   if (Array.isArray(value)) return value;
@@ -46,8 +49,79 @@ function reportedTotal(value) {
   return Number.isInteger(total) && total >= 0 ? total : null;
 }
 
+function registryCursor(operationID, page) {
+  return Buffer.from(JSON.stringify({ operation_id: operationID, page }), 'utf8').toString('base64url');
+}
+
+function registryPageFromCursor(cursor, operationID) {
+  if (cursor == null || cursor === '') return 1;
+  try {
+    const value = JSON.parse(Buffer.from(String(cursor), 'base64url').toString('utf8'));
+    if (value && value.operation_id === operationID && Number.isSafeInteger(value.page) && value.page > 1) {
+      return value.page;
+    }
+  } catch { /* Report one stable CLI error below. */ }
+  throw new Error(`Map --cursor is not valid for Registry operation ${operationID}.`);
+}
+
+function queryProperties(operation) {
+  const schema = operation && operation.input_schema;
+  const query = schema && schema.properties && schema.properties.query;
+  return query && query.properties && typeof query.properties === 'object' ? query.properties : {};
+}
+
+function registryQuery(operation, operationID, flags) {
+  const properties = queryProperties(operation);
+  const query = {};
+  const limit = positiveLimit(flags.limit);
+  const cursor = flags.cursor == null ? '' : String(flags.cursor);
+  if (Object.prototype.hasOwnProperty.call(properties, 'cursor')) {
+    if (cursor) query.cursor = cursor;
+    if (Object.prototype.hasOwnProperty.call(properties, 'limit')) query.limit = limit;
+  } else if (Object.prototype.hasOwnProperty.call(properties, 'page')
+      && Object.prototype.hasOwnProperty.call(properties, 'page_size')) {
+    query.page = registryPageFromCursor(cursor, operationID);
+    query.page_size = limit;
+  } else if (cursor) {
+    throw new Error(`${operationID} does not expose a paginated Registry contract.`);
+  }
+
+  const search = flags.route != null ? normalizeRoute(flags.route)
+    : flags.title != null ? String(flags.title) : '';
+  if (search) {
+    const key = flags.route != null && Object.prototype.hasOwnProperty.call(properties, 'route')
+      ? 'route'
+      : ['search', 'q', 'query'].find((candidate) => Object.prototype.hasOwnProperty.call(properties, candidate));
+    if (key) query[key] = search;
+  }
+  return query;
+}
+
+function registryPagination(payload, operationID, query, returned) {
+  const serverCursor = nextCursor(payload);
+  if (serverCursor != null && serverCursor !== '') {
+    return {
+      next_cursor: String(serverCursor),
+      has_more: true,
+      total: reportedTotal(payload),
+    };
+  }
+  if (claimsMorePages(payload)) {
+    throw new Error(`${operationID} reported more pages without a cursor.`);
+  }
+  const total = reportedTotal(payload);
+  const page = Number(query.page);
+  const pageSize = Number(query.page_size);
+  const hasMore = Number.isSafeInteger(page) && Number.isSafeInteger(pageSize)
+    && (total != null ? page * pageSize < total : returned === pageSize);
+  return {
+    next_cursor: hasMore ? registryCursor(operationID, page + 1) : null,
+    has_more: hasMore,
+    total,
+  };
+}
+
 function normalizeMapResourceType(value) {
-  if (require('./customService').isServiceType(value)) return 'custom_services';
   return REMOTE_RESOURCE_TYPES[canonicalResourceType(value)];
 }
 
@@ -84,7 +158,6 @@ function resourceMatches(resource, flags = {}) {
 
 function resourceKey(resource) {
   const type = resourceType(resource);
-  if (type === 'custom_services') return `custom_services:${resource.resource_id}`;
   return `${canonicalResourceType(type)}:${resource.resource_id}`;
 }
 
@@ -130,6 +203,41 @@ async function listMapResources(session, resourceTypes, flags, options = {}) {
   };
 }
 
+async function listRegistryResources(projectDir, config, session, resourceTypes, flags = {}) {
+  const { registryRevision, descriptionForRevision } = require('./api');
+  if (flags.cursor != null && flags.cursor !== '' && resourceTypes.length !== 1) {
+    throw new Error('Map --cursor requires exactly one --type.');
+  }
+  const groups = await allWithAbort(resourceTypes.map((type) => async (options) => {
+    const operationID = LIST_OPERATIONS[type];
+    const revision = await registryRevision(session, operationID);
+    const description = await descriptionForRevision(projectDir, config, session, operationID, revision);
+    const operation = description.operation || {};
+    const query = registryQuery(operation, operationID, flags);
+    const invoke = {
+      operation_id: operationID,
+      registry_revision: revision,
+    };
+    if (Object.keys(query).length) invoke.query = query;
+    const payload = await callStructured(session, TOOL_NAMES.apiCall, invoke, options);
+    const response = payload && payload.response !== undefined ? payload.response
+      : payload && payload.data !== undefined ? payload.data : payload;
+    const responseItems = itemsFrom(response);
+    const resources = responseItems
+      .map((item) => ({ ...item, resource_type: type, resource_id: String(item.resource_id ?? item.id) }))
+      .filter((item) => item.resource_id && item.resource_id !== 'undefined')
+      .filter((item) => resourceMatches(item, flags));
+    return {
+      resources,
+      pagination: registryPagination(response, operationID, query, responseItems.length),
+    };
+  }));
+  return {
+    resources: groups.flatMap((group) => group.resources),
+    pagination: Object.fromEntries(groups.map((group, index) => [resourceTypes[index], group.pagination])),
+  };
+}
+
 async function listRemoteResourceType(session, resourceType, options = {}) {
   const resources = [];
   const seen = new Set();
@@ -161,43 +269,40 @@ async function listRemoteResources(session, resourceTypes = DEFAULT_REMOTE_RESOU
   return groups.flat();
 }
 
-function checkoutChanged(entry) {
-  if (entry.resource_type === 'custom_services') {
-    return ['local_modified', 'diverged', 'committed_unrecorded'].includes(entry.state);
-  }
-  return entry.local_hash !== null && entry.local_hash !== entry.base_hash;
-}
+function checkoutChanged(entry) { return entry.local_hash !== null && entry.local_hash !== entry.base_hash; }
 
 async function mapCommand(projectDir, flags = {}) {
   const resourceTypes = requestedResourceTypes(flags);
   const config = loadProjectConfig(projectDir);
   const searching = flags.route != null || flags.title != null;
-  const session = await openToolSession(config, [searching ? TOOL_NAMES.resourceSearch : TOOL_NAMES.resourceList]);
-  const remote = await listMapResources(session, resourceTypes, flags);
+  let session;
+  let remote;
+  try {
+    session = await openToolSession(config, [searching ? TOOL_NAMES.resourceSearch : TOOL_NAMES.resourceList]);
+    remote = await listMapResources(session, resourceTypes, flags);
+  } catch (error) {
+    if (!error || error.code !== 'MCP_TOOL_UNAVAILABLE') throw error;
+    session = await openToolSession(config, [TOOL_NAMES.apiSearch, TOOL_NAMES.apiDescribe, TOOL_NAMES.apiCall]);
+    remote = await listRegistryResources(projectDir, config, session, resourceTypes, flags);
+  }
   const manifestEntries = Object.values(loadManifest(projectDir).entries);
   const selected = new Set(remote.resources.map(resourceKey));
   // A filtered map is a focused inspection, so do not make unrelated local
   // worktree state dominate its output. The unfiltered command retains the
   // established full-worktree status behavior.
   const statusEntries = searching
-    ? manifestEntries.filter((entry) => entry.resource_type === 'custom_services'
-      ? selected.has(`custom_services:${entry.resource_id}`)
-      : selected.has(`${canonicalResourceType(entry.resource_type)}:${entry.resource_id}`))
+    ? manifestEntries.filter((entry) => selected.has(`${canonicalResourceType(entry.resource_type)}:${entry.resource_id}`))
     : manifestEntries;
-  const contentEntries = statusEntries.filter((entry) => entry.resource_type !== 'custom_services');
-  const serviceIds = statusEntries
-    .filter((entry) => entry.resource_type === 'custom_services')
-    .map((entry) => entry.resource_id);
   const checkouts = (await allWithAbort([
     async (options) => {
-      const [contentStatus, serviceStatus] = await Promise.all([inspectRemoteCheckouts(projectDir, {
+      const contentStatus = await inspectRemoteCheckouts(projectDir, {
         config,
         client: session.client,
         tools: session.tools,
         signal: options.signal,
-        entries: contentEntries,
-      }), customServices.inspectRemote(projectDir, { config, signal: options.signal, ids: serviceIds })]);
-      return [...contentStatus, ...serviceStatus].map((entry) => ({
+        entries: statusEntries,
+      });
+      return contentStatus.map((entry) => ({
         ...entry,
         exists: entry.local_hash !== null,
         current_hash: entry.local_hash,
@@ -248,6 +353,11 @@ async function mapCommand(projectDir, flags = {}) {
   log.title('draftgo map');
   log.info(`Remote resources returned: ${resources.length}`);
   for (const [type, count] of [...counts.entries()].sort()) log.plain(`  ${type}: ${count}`);
+  if (!flags.summary) {
+    for (const resource of resources) {
+      log.plain(`  ${resourceType(resource)} ${resource.resource_id}: ${resource.title || '-'} route=${resource.route || '-'} code=${resource.code || '-'} slug=${resource.slug || '-'}`);
+    }
+  }
   log.info(`Local checkouts: ${checkouts.length}`);
   if (flags.summary) {
     for (const [state, count] of [...checkoutStates.entries()].sort()) log.plain(`  ${state}: ${count}`);
@@ -273,8 +383,13 @@ module.exports.requestedResourceTypes = requestedResourceTypes;
 module.exports.listRemoteResources = listRemoteResources;
 module.exports.listRemoteResourcePage = listRemoteResourcePage;
 module.exports.listMapResources = listMapResources;
+module.exports.listRegistryResources = listRegistryResources;
 module.exports.normalizeRoute = normalizeRoute;
 module.exports.resourceMatches = resourceMatches;
 module.exports.positiveLimit = positiveLimit;
 module.exports.reportedTotal = reportedTotal;
+module.exports.registryCursor = registryCursor;
+module.exports.registryPageFromCursor = registryPageFromCursor;
+module.exports.registryQuery = registryQuery;
+module.exports.registryPagination = registryPagination;
 module.exports.checkoutChanged = checkoutChanged;

package/src/commands/reconcile.js

@@ -6,23 +6,9 @@ const { reconcileResources } = require('../worktree');
 async function reconcile(projectDir, positional, flags = {}) {
   const [resourceType, ...ids] = positional;
   if (!resourceType || !ids.length) {
-    log.err('Usage: draftgo reconcile <pages|nav|docs|custom-services> <id...>');
+    log.err('Usage: draftgo reconcile <pages|nav|docs> <id...>');
     return 1;
   }
-  if (require('./customService').isServiceType(resourceType)) {
-    const services = require('../customServices');
-    const states = await services.inspectRemote(projectDir);
-    const results = [];
-    for (const id of ids) {
-      const state = states.find((entry) => String(entry.resource_id) === String(id));
-      if (!state || state.state !== 'committed_unrecorded') throw new Error(`custom_services ${id} cannot be reconciled from state ${state?.state || 'missing'}.`);
-      await services.checkout(projectDir, [id], { force: true });
-      results.push({ resource_type: 'custom_services', resource_id: String(id), base_revision: state.remote_revision });
-    }
-    if (flags.output === 'json') console.log(JSON.stringify(results, null, 2));
-    else results.forEach((result) => log.ok(`Reconciled custom_services ${result.resource_id} -> ${result.base_revision}`));
-    return 0;
-  }
   const results = await reconcileResources(projectDir, resourceType, ids);
   if (flags.output === 'json') console.log(JSON.stringify(results, null, 2));
   else for (const result of results) {

package/src/commands/role.js

@@ -3,9 +3,8 @@
 const log = require('../logger');
 const { callOperation } = require('./api');
 
-// Role is a permission template. Use `draftgo grant` to bind it to a subject.
 const OPERATIONS = Object.freeze({
-  permissions: 'listPermissionCatalog',
+  permissions: 'listPermissions',
   list: 'listRoles',
   create: 'createRole',
   get: 'getRole',

package/src/commands/status.js

@@ -5,30 +5,19 @@ const { all } = require('../targets');
 const { readInstalledVersion, getPackageVersion } = require('../skill');
 const { loadProjectConfig } = require('../projectConfig');
 const { TOOL_NAMES, openToolSession, callStructured } = require('../mcp/tools');
-const { normalizeDescription } = require('../apiContractCache');
 const { parseTimeout } = require('../timeout');
 
-const API_KEY_STATUS_OPERATION = 'getCurrentUserAPIKey';
-
 function asObject(value) {
   return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
 }
 
-function scopeFrom(value) {
+function findField(value, keys) {
   let candidates = [asObject(value)];
   for (let depth = 0; depth < 4; depth += 1) {
     const next = [];
     for (const candidate of candidates) {
-      const type = String(candidate.scope_type || candidate.type || '').trim().toLowerCase();
-      if (type === 'platform') return { scope_type: 'platform', workspace_id: null, space_id: null };
-      if (type === 'space') {
-        return {
-          scope_type: 'space',
-          workspace_id: candidate.workspace_id ?? null,
-          space_id: candidate.space_id ?? null,
-        };
-      }
-      for (const key of ['context', 'scope', 'principal', 'credential', 'authentication', 'response', 'data', 'value']) {
+      for (const key of keys) if (candidate[key] != null) return candidate[key];
+      for (const key of ['operation_registry', 'registry', 'response', 'data', 'value']) {
         const nested = asObject(candidate[key]);
         if (Object.keys(nested).length) next.push(nested);
       }
@@ -48,30 +37,15 @@ async function connectionDiagnostic(projectDir, options = {}) {
 
   const diagnostic = { health: 'unhealthy', connected: false, server: config.server };
   try {
-    const session = await openToolSession(config, [
-      TOOL_NAMES.projectOverview, TOOL_NAMES.apiDescribe, TOOL_NAMES.apiCall,
-    ], { timeoutMs: options.timeoutMs });
-    const overview = await callStructured(session, TOOL_NAMES.projectOverview, {}, { timeoutMs: options.timeoutMs });
-    const project = asObject(asObject(overview).project);
+    const session = await openToolSession(config, [TOOL_NAMES.apiSearch], { timeoutMs: options.timeoutMs });
+    const catalog = await callStructured(session, TOOL_NAMES.apiSearch, {
+      query: 'system', limit: 1,
+    }, { timeoutMs: options.timeoutMs });
     diagnostic.connected = true;
-    diagnostic.server_version = project.version || null;
+    diagnostic.server_version = asObject(session.initialized.serverInfo).version || null;
     diagnostic.protocol_version = session.client.protocolVersion || null;
-    diagnostic.registry_revision = asObject(asObject(overview).operation_registry).registry_revision || null;
-
-    let scope = scopeFrom(overview);
-    if (!scope) {
-      const described = normalizeDescription(await callStructured(
-        session, TOOL_NAMES.apiDescribe, { operation_id: API_KEY_STATUS_OPERATION }, { timeoutMs: options.timeoutMs },
-      ));
-      if (!described) throw new Error('DraftGo API Key status contract is missing revision metadata.');
-      const result = await callStructured(session, TOOL_NAMES.apiCall, {
-        operation_id: API_KEY_STATUS_OPERATION,
-        registry_revision: described.registry_revision,
-      }, { timeoutMs: options.timeoutMs });
-      scope = scopeFrom(asObject(result).response || result);
-    }
-    if (!scope) throw new Error('DraftGo server did not report the current API Key scope.');
-    Object.assign(diagnostic, scope, { health: 'healthy' });
+    diagnostic.registry_revision = findField(catalog, ['registry_revision']) || null;
+    diagnostic.health = 'healthy';
     return diagnostic;
   } catch (error) {
     diagnostic.error = error && error.message || String(error);
@@ -104,9 +78,7 @@ async function status(projectDir, _positional = [], flags = {}) {
   log.info(`服务端：${connection.server || '（未连接）'}`);
   if (connection.health === 'healthy') {
     log.ok(`连接健康：healthy${connection.server_version ? `（server ${connection.server_version}）` : ''}`);
-    const ids = connection.scope_type === 'space'
-      ? `，workspace_id=${connection.workspace_id ?? '-'}，space_id=${connection.space_id ?? '-'}` : '';
-    log.info(`当前上下文：${connection.scope_type}${ids}`);
+    log.info(`Registry revision：${connection.registry_revision || '-'}`);
   } else {
     log.warn(`连接健康：${connection.health}`);
     if (connection.error) log.dim(`  ${connection.error}`);
@@ -122,5 +94,5 @@ async function status(projectDir, _positional = [], flags = {}) {
 }
 
 module.exports = status;
-module.exports.scopeFrom = scopeFrom;
+module.exports.findField = findField;
 module.exports.connectionDiagnostic = connectionDiagnostic;

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;
@@ -76,36 +79,27 @@ 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
+  // 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());
+  let unknown = [];
+
+  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));
-    if (unknown.length) {
-      log.err(`未知 target：${unknown.join(', ')}`);
-      return 1;
-    }
-  }
+    if (unknown.length) {
+      log.err(`未知 target：${unknown.join(', ')}`);
+      return 1;
+    }
+  }
 
   ensureRuntime(projectDir);
   log.step('用 CLI 内置版本覆盖各 AI 工具 skill 目录');

package/src/commands/verify.js

@@ -128,18 +128,23 @@ async function verifyPageComponents(projectDir, selected) {
 async function verify(projectDir, positional = [], flags = {}) {
   let selected;
   let remoteMode;
+  let visual;
+  const url = String(flags.url || '').trim();
   try {
     selected = resources(positional);
     remoteMode = flags.remote ? 'always' : 'never';
+    visual = visualRequest(flags, url);
+    if (flags.output === 'json' && visual.run) throw new Error('Visual verification does not support --output json; run the explicit visual check separately.');
   } catch (error) {
     log.err(error.message);
     return 1;
   }
 
-  log.title('draftgo verify');
-  try { await verifyPageComponents(projectDir, selected); }
+  if (flags.output !== 'json') log.title('draftgo verify');
+  try { if (flags.remote) await verifyPageComponents(projectDir, selected); }
   catch (error) { log.err(error.message); return 1; }
   const checkCode = await check(projectDir, [], {
+    output: flags.output,
     strict: flags.strict,
     remote: remoteMode === 'always',
     resourceKeys: selected.length
@@ -148,13 +153,9 @@ async function verify(projectDir, positional = [], flags = {}) {
   });
   if (checkCode !== 0) return checkCode;
 
-  const url = String(flags.url || '').trim();
-  let visual;
-  try { visual = visualRequest(flags, url); }
-  catch (error) { log.err(error.message); return 1; }
   if (!visual.run) {
     if (url) log.warn('--url was provided without --screenshot always or --ui always; visual verification was skipped.');
-    log.ok('Unified verification passed (UI skipped).');
+    if (flags.output !== 'json') log.ok('Local verification passed; browser and business interactions were not tested.');
     return 0;
   }
   let targets;

package/src/commands/worklog.js

@@ -13,7 +13,7 @@ const {
 } = require('../worklog');
 
 function printUsage() {
-  log.err('Usage: draftgo work start|add|start-item|complete|show|list <value>');
+  log.err('Usage: draftgo work start|add|start-item|wait|complete|show|list <value>');
 }
 
 function output(flags, value) {
@@ -27,7 +27,12 @@ function latestReference(blocks) {
 
 function resultFor(blocks, reference) {
   const resolved = resolveReference(blocks, reference);
-  return { date: resolved.block.date, ...resolved.entry };
+  return { date: resolved.block.date, ...resolved.entry, status: visibleStatus(resolved.entry.status) };
+}
+
+function visibleStatus(status) { return status === 'pending' ? 'waiting' : status; }
+function visibleBlocks(blocks) {
+  return blocks.map(block => ({ ...block, entries: block.entries.map(entry => ({ ...entry, status: visibleStatus(entry.status) })) }));
 }
 
 function add(projectDir, positional, flags, status) {
@@ -61,14 +66,14 @@ function change(projectDir, positional, flags, status) {
 }
 
 function show(projectDir, flags) {
-  const blocks = readWorklog(projectDir);
+  const blocks = visibleBlocks(readWorklog(projectDir));
   output(flags, { path: worklogPath(projectDir), blocks });
   if (flags.output !== 'json') console.log(renderWorklog(blocks) || 'Worklog is empty.');
   return 0;
 }
 
 function list(projectDir, flags) {
-  const blocks = readWorklog(projectDir);
+  const blocks = visibleBlocks(readWorklog(projectDir));
   const items = blocks.flatMap((block) => block.entries.map((entry) => ({ date: block.date, ...entry })));
   output(flags, { path: worklogPath(projectDir), items });
   if (flags.output !== 'json') items.forEach((item) => log.info(`${item.date}#${item.number} [${item.status}] ${item.title}`));
@@ -78,7 +83,8 @@ function list(projectDir, flags) {
 async function worklog(projectDir, positional = [], flags = {}) {
   const operation = positional[0] || 'show';
   if (operation === 'start') return add(projectDir, positional.slice(1), flags, 'active');
-  if (operation === 'add') return add(projectDir, positional.slice(1), flags, 'pending');
+  if (operation === 'add') return add(projectDir, positional.slice(1), flags, 'waiting');
+  if (operation === 'wait') return change(projectDir, positional.slice(1), flags, 'waiting');
   if (operation === 'start-item' || operation === 'start_item') return change(projectDir, positional.slice(1), flags, 'active');
   if (operation === 'complete' || operation === 'done') return change(projectDir, positional.slice(1), flags, 'completed');
   if (operation === 'show') return show(projectDir, flags);

package/src/contractCompatibility.js

@@ -21,7 +21,8 @@ function isHardContractIncompatibility(error) {
 
 function isDangerousOperation(contract) {
   const operation = contract && contract.operation || contract || {};
-  return operation.destructive === true || String(operation.risk || '').toLowerCase() === 'high';
+  const risk = String(operation.risk || '').toLowerCase();
+  return operation.destructive === true || risk === 'high' || risk === 'critical';
 }
 
 function canonicalValue(value) {
@@ -36,9 +37,15 @@ function sameOperationContract(left, right) {
   return JSON.stringify(canonicalValue(leftOperation)) === JSON.stringify(canonicalValue(rightOperation));
 }
 
+function canRetryAfterContractChange(left, right) {
+  const operation = right && right.operation || right || {};
+  const method = String(operation.method || '').toUpperCase();
+  return method === 'GET' || method === 'HEAD' || sameOperationContract(left, right);
+}
+
 function incompatibleOperationError(operationId, error) {
   const wrapped = new Error(
-    `DraftGo CLI and server contracts are incompatible for dangerous operation ${operationId}; `
+    `DraftGo CLI and server contracts are incompatible for operation ${operationId}; `
     + 'the call was blocked before retry. Upgrade DraftGo CLI, then describe and confirm the operation again.',
   );
   wrapped.code = 'CLI_CONTRACT_INCOMPATIBLE';
@@ -53,5 +60,6 @@ module.exports = {
   isHardContractIncompatibility,
   isDangerousOperation,
   sameOperationContract,
+  canRetryAfterContractChange,
   incompatibleOperationError,
 };