draftgo-cli 4.0.24 → 4.0.26

package/src/commands/components.js

@@ -46,7 +46,7 @@ function csv(value) {
 
 function normalizeDefinition(definition = {}) {
   return {
-    html: definition.html || '', css: definition.css || '', js: definition.js || '',
+    html: definition.html || '', css: definition.css || '', js: definition.js || '', assets: definition.assets || [],
     props: definition.props || [], slots: definition.slots || [], css_variables: definition.css_variables || [],
     events: definition.events || [], dependencies: definition.dependencies || [], examples: definition.examples || [],
     usage: definition.usage || '', root_tag: definition.root_tag || '', meta: definition.meta || {},
@@ -66,12 +66,12 @@ function componentDir(projectDir, name) {
 }
 
 function contractFrom(definition = {}) {
-  const { props, slots, css_variables, events, dependencies, examples, usage, root_tag, meta } = normalizeDefinition(definition);
-  return { props, slots, css_variables, events, dependencies, examples, usage, root_tag, meta };
+  const { assets, props, slots, css_variables, events, dependencies, examples, usage, root_tag, meta } = normalizeDefinition(definition);
+  return { assets, props, slots, css_variables, events, dependencies, examples, usage, root_tag, meta };
 }
 
 function localDefinition(directory) {
-  const contract = JSON.parse(fs.readFileSync(path.join(directory, 'contract.json'), 'utf8'));
+  const contract = JSON.parse(fs.readFileSync(path.join(directory, 'component.json'), 'utf8'));
   return normalizeDefinition({
     html: fs.readFileSync(path.join(directory, 'component.html'), 'utf8'),
     css: fs.readFileSync(path.join(directory, 'component.css'), 'utf8'),
@@ -85,12 +85,12 @@ function writeComponentFiles(directory, item) {
   fs.writeFileSync(path.join(directory, 'component.html'), item.draft.html || '', 'utf8');
   fs.writeFileSync(path.join(directory, 'component.css'), item.draft.css || '', 'utf8');
   fs.writeFileSync(path.join(directory, 'component.js'), item.draft.js || '', 'utf8');
-  fs.writeFileSync(path.join(directory, 'contract.json'), `${JSON.stringify(contractFrom(item.draft), null, 2)}\n`, 'utf8');
   const metadata = {
     id: item.id, library_id: item.library_id, library_slug: item.library_slug,
     name: item.name, slug: item.slug, category: item.category || '', description: item.description || '',
     tags: item.tags || [], status: item.status || 'active', published_revision: item.published_revision || 0,
     remote_draft_hash: definitionHash(item.draft), updated_at: item.updated_at,
+    ...contractFrom(item.draft),
   };
   fs.writeFileSync(path.join(directory, 'component.json'), `${JSON.stringify(metadata, null, 2)}\n`, 'utf8');
   fs.writeFileSync(path.join(directory, '.base.json'), `${JSON.stringify(item, null, 2)}\n`, 'utf8');
@@ -231,7 +231,7 @@ async function diff(projectDir, name, flags) {
   const config = loadProjectConfig(projectDir);
   const state = localState(projectDir, name);
   const remote = await findComponent(config, name);
-  const sections = ['html', 'css', 'js', 'props', 'slots', 'css_variables', 'events', 'dependencies', 'examples', 'usage', 'root_tag', 'meta'];
+  const sections = ['html', 'css', 'js', 'assets', 'props', 'slots', 'css_variables', 'events', 'dependencies', 'examples', 'usage', 'root_tag', 'meta'];
   const changed = (left, right) => {
     const normalizedLeft = normalizeDefinition(left);
     const normalizedRight = normalizeDefinition(right);
@@ -364,9 +364,13 @@ async function exportZIP(projectDir, librarySlug, flags) {
   }
   for (const summary of components) {
     const item = await request(config, 'GET', `components/${summary.id}`);
-    const definition = `components/${item.slug}.json`;
+    const directory = `components/${item.slug}`;
+    const definition = `${directory}/component.json`;
     manifest.components.push({ name: item.name, slug: item.slug, category: item.category, description: item.description, tags: item.tags, definition });
-    zip.addFile(definition, Buffer.from(`${JSON.stringify(item.draft, null, 2)}\n`, 'utf8'));
+    zip.addFile(definition, Buffer.from(`${JSON.stringify(contractFrom(item.draft), null, 2)}\n`, 'utf8'));
+    zip.addFile(`${directory}/component.html`, Buffer.from(item.draft.html || '', 'utf8'));
+    zip.addFile(`${directory}/component.css`, Buffer.from(item.draft.css || '', 'utf8'));
+    zip.addFile(`${directory}/component.js`, Buffer.from(item.draft.js || '', 'utf8'));
   }
   zip.addFile('draftgo-components.json', Buffer.from(`${JSON.stringify(manifest, null, 2)}\n`, 'utf8'));
   const destination = path.resolve(projectDir, flags.file || `${library.slug}-components.zip`);

package/src/commands/conflict.js

@@ -15,14 +15,12 @@ function printRecord(record) {
 async function conflict(projectDir, positional, flags = {}) {
   const [action, resourceType, resourceId] = positional;
   if (!['show', 'resolve'].includes(action) || !resourceType || !resourceId) {
-    log.err('Usage: draftgo conflict <show|resolve> <pages|nav|docs|custom-services> <id>');
+    log.err('Usage: draftgo conflict <show|resolve> <pages|nav|docs> <id>');
     return 1;
   }
-  const custom = require('./customService').isServiceType(resourceType);
-  const services = custom ? require('../customServices') : null;
-  const record = custom
-    ? (action === 'show' ? services.showConflict(projectDir, resourceId) : services.resolveConflict(projectDir, resourceId))
-    : (action === 'show' ? showConflict(projectDir, resourceType, resourceId) : await resolveConflict(projectDir, resourceType, resourceId));
+  const record = action === 'show'
+    ? showConflict(projectDir, resourceType, resourceId)
+    : await resolveConflict(projectDir, resourceType, resourceId);
   if (flags.output === 'json') console.log(JSON.stringify(record, null, 2));
   else printRecord(record);
   if (action === 'resolve') log.info('The remote revision is now the base; run check, diff, and commit the merged worktree file.');

package/src/commands/conflicts.js

@@ -2,10 +2,9 @@
 
 const log = require('../logger');
 const { listConflicts } = require('../worktree');
-const { serviceConflicts } = require('../customServices');
 
 function conflicts(projectDir, _positional, flags = {}) {
-  const records = [...listConflicts(projectDir, { all: Boolean(flags.all) }), ...serviceConflicts(projectDir, { all: Boolean(flags.all) })];
+  const records = listConflicts(projectDir, { all: Boolean(flags.all) });
   if (flags.output === 'json') console.log(JSON.stringify(records, null, 2));
   else if (!records.length) log.ok('No unresolved DraftGo conflicts.');
   else for (const record of records) {

package/src/commands/connect.js

@@ -49,16 +49,10 @@ async function connect(projectDir, positional, flags = {}) {
     return 1;
   }
   const timeoutMs = parseTimeout(flags.timeout);
-  if ((flags['scope-type'] === 'space') !== Boolean(flags['space-id'])) {
-    throw new Error('--scope-type space and --space-id must be provided together.');
-  }
-
   log.step('Validating DraftGo API Key and MCP capabilities...');
   try {
     const diagnostic = await testConnection({ ...connection, server, token }, {
       timeoutMs,
-      scopeType: flags['scope-type'],
-      spaceId: flags['space-id'] && Number(flags['space-id']),
     });
     log.ok(`MCP ready (${diagnostic.tools.length} tools; tested ${diagnostic.testedCalls.join(', ')}).`);
   } catch (error) {
@@ -74,8 +68,6 @@ async function connect(projectDir, positional, flags = {}) {
 
   const configFile = writeProjectConfig(projectDir, server, token, {
     mcp_url: connection.mcp_url,
-    scope_type: flags['scope-type'],
-    space_id: flags['space-id'],
   });
   log.ok(`Project configuration written: ${configFile}`);
 

package/src/commands/delete.js

@@ -6,7 +6,8 @@ const log = require('../logger');
 const { confirm } = require('../prompt');
 const { loadProjectConfig } = require('../projectConfig');
 const { TOOL_NAMES, openToolSession, callStructured } = require('../mcp/tools');
-const { cachedDescription, normalizeDescription, storeDescription } = require('../apiContractCache');
+const { cachedDescription } = require('../apiContractCache');
+const { registryRevision, describeOperation } = require('./api');
 const {
   isContractCompatibilityError,
   isHardContractIncompatibility,
@@ -26,10 +27,14 @@ function readParams(projectDir, flags) {
 }
 
 function pathParameterName(description) {
-  const source = description && (description.parameters || description.params
-    || description.operation && description.operation.parameters) || [];
-  const pathParameters = source.filter((parameter) => parameter && parameter.in === 'path');
-  return pathParameters.length === 1 ? pathParameters[0].name : null;
+  const operation = description && (description.operation || description) || {};
+  const properties = operation.input_schema && operation.input_schema.properties || {};
+  const pathProperties = properties.path && properties.path.properties || {};
+  const names = Object.keys(pathProperties);
+  if (names.length === 1) return names[0];
+  const parameters = operation.parameters || operation.params || [];
+  const legacy = parameters.filter((parameter) => parameter && parameter.in === 'path');
+  return legacy.length === 1 ? legacy[0].name : null;
 }
 
 async function deleteResource(projectDir, positional, flags = {}) {
@@ -39,7 +44,7 @@ async function deleteResource(projectDir, positional, flags = {}) {
   }
   const config = loadProjectConfig(projectDir);
   const session = await openToolSession(config, [
-    TOOL_NAMES.apiDescribe, TOOL_NAMES.apiCall,
+    TOOL_NAMES.apiSearch, TOOL_NAMES.apiDescribe, TOOL_NAMES.apiCall,
   ]);
 
   const selectedOperation = flags['operation-id'] ? String(flags['operation-id']) : String(positional[0]);
@@ -47,8 +52,7 @@ async function deleteResource(projectDir, positional, flags = {}) {
 
   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);
+    contract = await describeOperation(projectDir, config, session, selectedOperation);
   }
   if (!contract) throw new Error('DraftGo API description is missing contract revision metadata.');
   const params = readParams(projectDir, flags);
@@ -58,7 +62,7 @@ async function deleteResource(projectDir, positional, flags = {}) {
       log.err('The operation does not expose exactly one path parameter; provide --params JSON explicitly.');
       return 1;
     }
-    params.path_params = { [parameterName]: resourceId };
+    params.path = { [parameterName]: resourceId };
   }
   if (!flags.yes && !flags.y) {
     const approved = await confirm(`Call destructive DraftGo operation ${selectedOperation}?`, { default: false });
@@ -74,8 +78,8 @@ async function deleteResource(projectDir, positional, flags = {}) {
     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);
+    const revision = await registryRevision(session, selectedOperation);
+    contract = await describeOperation(projectDir, config, session, selectedOperation, revision);
     if (!contract) throw new Error('DraftGo API description is missing contract revision metadata.');
     if (!sameOperationContract(previousContract, contract)) {
       throw incompatibleOperationError(selectedOperation, error);

package/src/commands/deploy.js

@@ -2,38 +2,76 @@
 
 const log = require('../logger');
 const check = require('./check');
+const { canonicalResourceType, entryKey } = require('../worktree/types');
+const { commitBatch, diffResource } = require('../worktree');
+const { report, formatSummary, formatStat } = require('../diffReport');
+const { absolutePath } = require('../worktree/manifest');
 
-async function deploy(projectDir, positional, flags = {}) {
-  const delivery = String(flags.delivery || 'deploy').toLowerCase();
-  if (!['local', 'preview', 'deploy'].includes(delivery)) {
-    log.err('--delivery accepts local, preview, or deploy.');
-    return 1;
-  }
+function targetsFrom(positional) {
+  const [type, ...ids] = positional;
+  if (!type || !ids.length) throw new Error('Specify <pages|nav|docs> <id...>.');
+  const resource_type = canonicalResourceType(type);
+  return [...new Set(ids.map(String))].map((resource_id) => ({ resource_type, resource_id }));
+}
 
-  log.step('deploy: validating checked-out content...');
-  const checkCode = await check(projectDir, { strict: flags.strict });
-  if (checkCode !== 0) {
-    log.err('Deploy stopped because local validation failed.');
-    return checkCode;
+function outputResult(value, flags) {
+  if (flags.output === 'json') console.log(JSON.stringify(value, null, 2));
+  else if (value.error) {
+    log.err(value.error.message);
+    for (const message of value.validation?.content_validation?.errors || []) log.err(message);
+    if (value.completed?.length) log.warn('Completed resources already changed remotely; use draftgo check --remote before retrying.');
+  } else if (value.skipped) log.dim(value.skipped);
+  else log.ok(`${value.delivery}: ${value.completed?.length || 0} resource(s) completed.`);
+  return value.error ? 1 : 0;
+}
+
+async function deliverTargets(projectDir, targets, flags = {}, options = {}) {
+  const delivery = flags.delivery || 'deploy';
+  const validation = await check(projectDir, { strict: flags.strict, quiet: true, returnResult: true,
+    resourceKeys: targets?.map((item) => entryKey(item.resource_type, item.resource_id)) });
+  if (validation.code) return { delivery, validation, error: { code: 'VALIDATION_FAILED', message: 'Delivery stopped because local validation failed.' },
+    completed: [], failed: [], not_started: targets || [] };
+  if (delivery === 'local') return { delivery, validation, completed: [], failed: [], not_started: [] };
+  if (delivery === 'preview') {
+    const previews = targets.map((item) => {
+      const result = diffResource(projectDir, item.resource_type, item.resource_id);
+      if (!flags.stat && !flags.summary) return { changed: result.changed, entry: result.entry, diff: result.output };
+      return 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) }]);
+    });
+    return { delivery, validation, previews, completed: [], failed: [], not_started: [] };
   }
-  if (delivery === 'local') {
-    log.ok('Local validation passed; no remote content was changed.');
-    return 0;
+  const statuses = [];
+  try {
+    const completed = await commitBatch(projectDir, targets, { ...options, onStatus: (item) => statuses.push(item) });
+    return { delivery, validation, completed, failed: [], not_started: [] };
+  } catch (error) {
+    const batch = error.details?.batch || error.details;
+    return { delivery, validation, error: { code: error.code || 'COMMIT_FAILED', message: error.message },
+      ...(Array.isArray(batch?.completed) ? batch : {
+        completed: statuses.filter((item) => ['committed', 'unchanged'].includes(item.status)),
+        failed: statuses.filter((item) => item.status === 'failed'),
+        not_started: statuses.length ? statuses.filter((item) => item.status === 'not_started') : targets,
+      }) };
   }
+}
 
-  const [resourceType, ...ids] = positional;
-  if (!resourceType || !ids.length) {
-    log.err('Usage: draftgo deploy <pages|nav|docs> <id...> --delivery preview|deploy');
-    return 1;
-  }
-  if (delivery === 'preview') {
-    for (const id of ids) {
-      const code = require('./diff')(projectDir, [resourceType, id], flags);
-      if (code !== 0) return code;
+async function deploy(projectDir, positional, flags = {}) {
+  try {
+    const delivery = String(flags.delivery || 'deploy').toLowerCase();
+    if (!['local', 'preview', 'deploy'].includes(delivery)) throw new Error('--delivery accepts local, preview, or deploy.');
+    const targets = positional.length || delivery !== 'local' ? targetsFrom(positional) : null;
+    const value = await deliverTargets(projectDir, targets, { ...flags, delivery });
+    if (flags.output !== 'json' && value.previews) {
+      for (const preview of value.previews) process.stdout.write(flags.stat ? formatStat(preview)
+        : flags.summary ? formatSummary(preview) : preview.diff);
+      return 0;
     }
-    return 0;
-  }
-  return require('./commit')(projectDir, [resourceType, ...ids], flags);
+    return outputResult(value, flags);
+  } catch (error) { return outputResult({ error: { code: error.code || 'DEPLOY_FAILED', message: error.message } }, flags); }
 }
 
 module.exports = deploy;
+module.exports.targetsFrom = targetsFrom;
+module.exports.deliverTargets = deliverTargets;
+module.exports.outputResult = outputResult;

package/src/commands/diff.js

@@ -8,12 +8,9 @@ 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|custom-services> <id>');
+    log.err('Usage: draftgo diff <pages|nav|docs> <id>');
     return 1;
   }
-  if (require('./customService').isServiceType(resourceType)) {
-    return require('./customService').diff(projectDir, [resourceId], flags);
-  }
   const result = diffResource(projectDir, resourceType, resourceId);
   const concise = Boolean(flags.stat || flags.summary);
   const value = concise ? report(result.entry, [{

package/src/commands/group.js

@@ -8,8 +8,7 @@ const OPERATIONS = Object.freeze({
   create: 'createUserGroup',
   get: 'getUserGroup',
   update: 'updateUserGroup',
-  replace: 'replaceUserGroup',
-  remove: 'removeUserGroup',
+  remove: 'deleteUserGroup',
   'members.list': 'listUserGroupMembers',
   'members.add': 'addUserGroupMember',
   'members.remove': 'removeUserGroupMember',
@@ -27,7 +26,7 @@ function operationKey(parts) {
 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>]');
+    log.err('Usage: draftgo group list|create|get|update|remove | members list|add|remove [--input <json-file>]');
     return 1;
   }
   return callOperation(projectDir, OPERATIONS[key], flags);

package/src/commands/help.js

@@ -14,19 +14,22 @@ function help() {
   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.
+Tailwind CSS 4, and the DraftGo built-in component library (draftgo/*).
+Provider brands and shared icons are served from the local /assets/providers and
+/assets/icons directories; the Page runtime does not require third-party CDNs.
+System MCP handles live discovery and structured resources; complete page,
+navigation, and document 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.
-  draftgo update [<target>...]     Fully update the global CLI, then atomically
-                                    refresh installed or detected Skills.
+  draftgo update [<target>...]     Fully update the global CLI, then atomically
+                                    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 status                   Show connection health, Registry revision, targets, and Skill version.
 
   draftgo connect [<target>...]    Verify and save server/API Key, then configure
                                     a detected or explicit MCP host. This never
@@ -40,10 +43,8 @@ Usage:
                                     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.
+                                    --force explicitly replaces local changes.
+  draftgo check                    Validate all checked-out content.
                                     --remote also compares remote hash/version.
   draftgo verify [<type> <id...>]   Run the default delivery verification.
                                     Browser options are explicit and optional.
@@ -65,13 +66,6 @@ Usage:
   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> [--source <source>] [--input <file>] [--handler <selector>]
-                                    Run the cloud draft in the DraftGo Runner.
-  draftgo publish custom-services <id...>
-                                    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>
@@ -81,28 +75,25 @@ Usage:
                                     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 add <item>         Add an item awaiting a decision.
+  draftgo work wait <ref>         Mark an item waiting; --note records the reason.
   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 search <query>       Search the live operation registry explicitly.
   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
+  draftgo group <action>            Manage RBAC groups and group members.
+  draftgo api-key status|create|update|delete|rotate
                                     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.
   draftgo deploy [<type> <id...>]  Check, then diff or commit checked-out content.
@@ -117,8 +108,8 @@ Usage:
   draftgo -v | --version           Print CLI version.
   draftgo -h | --help              Show this help.
 
-Resource types:
-  pages | nav/navigations | docs/articles | custom-services
+Resource types:
+  pages | nav/navigations | docs/articles
 
 Important flags:
   --project <dir>          Operate on <dir> instead of the current directory.
@@ -127,8 +118,6 @@ Important flags:
   --mcp-url <url>          (connect) Explicit endpoint; standard /mcp derives the
                            base URL; custom paths also need --server.
   --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.
@@ -139,8 +128,8 @@ Important flags:
   --connect                (init) Continue into DraftGo server connection.
   --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 |
-                           custom-services.
+  --type <type>            (map) pages | nav/navigations | docs/articles;
+                           (capabilities) alias for a Registry module filter.
   --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;
@@ -153,15 +142,7 @@ Important flags:
   --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.
-  --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.
+  --input <file>           (api call/delete) Read a UTF-8 JSON object.
   --delivery <mode>        (deploy) local | preview | deploy.
   --dry-run                Preview supported cleanup or delivery operations.
   --ui <mode>              (verify) always | never; default never.
@@ -196,8 +177,6 @@ Examples:
   draftgo verify pages 42
   draftgo diff pages 42 --stat
   draftgo commit pages 42
-  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

@@ -15,20 +15,28 @@ function showEnvironment() {
 
 async function init(projectDir, positional, flags) {
   log.title('draftgo init');
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY) && !(flags.yes || flags.y);
 
   // 1) Figure out which targets to install.
   let resolved = [];
   let unknown = [];
 
   if (positional.length === 0) {
-    const hits = detectTargets(projectDir);
+    let hits = detectTargets(projectDir);
     if (hits.length === 0) {
       log.warn('未在当前项目检测到任何支持的 AI 工具目录。');
-      log.dim('  使用 `draftgo init all` 或 `draftgo init <target>` 手动指定。');
       log.dim(`  支持列表：${all.map((i) => i.name).join(', ')}`);
-      return 1;
+      if (!interactive) {
+        log.dim('  使用 `draftgo init <target>` 手动指定，例如 `draftgo init codex`。');
+        return 1;
+      }
+      hits = String(await ask('请选择你的 AI 工具，例如 codex')).trim().split(/[\s,]+/);
     }
     ({ resolved, unknown } = resolveTargets(hits));
+    if (unknown.length || !resolved.length) {
+      log.err(`未知 target：${hits.join(', ')}`);
+      return 1;
+    }
     log.info(`自动识别到：${resolved.map((r) => r.displayName).join(', ')}`);
   } else {
     ({ resolved, unknown } = resolveTargets(positional));
@@ -77,7 +85,6 @@ async function init(projectDir, positional, flags) {
   const hasConfig = exists(cfgPath);
   const flagConnect = flags.connect === true;
   const flagSkip = flags['no-setup'] === true;
-  const interactive = process.stdin.isTTY && process.stdout.isTTY;
 
   if (!hasConfig && !flagSkip) {
     // Non-interactive setup can connect immediately with a server and API Key.
@@ -92,7 +99,7 @@ async function init(projectDir, positional, flags) {
       log.plain(`  ${log.c.cyan('[A]')} 连接基座服务`);
       log.dim('      使用已有 DraftGo 服务，接下来输入 BaseURL 和系统访问令牌。');
       log.plain(`  ${log.c.cyan('[B]')} 本地启动基座`);
-      log.dim('      使用 Docker 启动 DraftGo；按需准备共享的 MySQL、Redis 和 Qdrant。');
+      log.dim('      使用 Docker 启动 DraftGo 和独立 Redis；按需准备 MySQL 和 Qdrant。');
       log.plain(`  ${log.c.cyan('[C]')} 稍后自行处理`);
       log.dim('      仅安装 Skill，不写入服务配置，也不创建容器。');
       const choice = (await ask('请选择 [A/B/C]', { default: 'C' })).trim().toUpperCase();
@@ -100,7 +107,7 @@ async function init(projectDir, positional, flags) {
         return await require('./connect')(projectDir, [], flags);
       }
       if (choice === 'B') {
-        return await require('../localRuntime').runWizard(projectDir, { yes: true });
+        return await require('../localRuntime').runWizard(projectDir, { yes: true, interactive: true });
       }
       if (choice !== 'C') {
         log.warn('无效选择，已跳过基座处理。');

package/src/commands/local.js

@@ -57,7 +57,10 @@ function local(projectDir, positional, flags = {}) {
 
   switch (action) {
     case 'setup':
-      return runWizard(projectDir, { yes: !!(flags.yes || flags.y) });
+      return runWizard(projectDir, {
+        yes: !!(flags.yes || flags.y),
+        ...(flags.params ? { params: flags.params } : {}),
+      });
     case 'start':
       return runCompose(projectDir, ['up', '-d']);
     case 'stop':