draftgo-cli 1.0.4

package/src/commands/connect.js

@@ -0,0 +1,91 @@
+'use strict';
+
+const log = require('../logger');
+const { ask, askPassword } = require('../prompt');
+const { normalizeConnection, normalizeServer, writeProjectConfig } = require('../projectConfig');
+const { testConnection } = require('../mcp/client');
+const { redactText } = require('../mcp/protocol');
+const { parseTimeout } = require('../timeout');
+
+async function promptServer(defaultValue) {
+  while (true) {
+    const raw = await ask('DraftGo server (Base URL)', { default: defaultValue });
+    try {
+      const value = normalizeServer(raw);
+      if (value) return value;
+    } catch (error) {
+      log.dim(`  ${error.message}`);
+    }
+  }
+}
+
+async function promptAPIKey() {
+  while (true) {
+    const value = String(await askPassword('DraftGo user API Key') || '').trim();
+    if (value) return value;
+    log.dim('  A DraftGo API Key is required.');
+  }
+}
+
+async function connect(projectDir, positional, flags = {}) {
+  log.title('draftgo connect');
+  const endpointConnection = flags['mcp-url']
+    ? normalizeConnection(flags['mcp-url'])
+    : null;
+  if (endpointConnection && !endpointConnection.server && !flags.server) {
+    throw new Error('--server is required when --mcp-url does not use the standard /mcp path.');
+  }
+  const connection = {
+    server: flags.server
+      ? normalizeServer(flags.server)
+      : endpointConnection && endpointConnection.server || await promptServer('https://'),
+    mcp_url: endpointConnection && endpointConnection.mcp_url || '',
+  };
+  const server = connection.server;
+  const suppliedAPIKey = flags['api-key'] || flags.token;
+  const token = suppliedAPIKey ? String(suppliedAPIKey).trim() : await promptAPIKey();
+  if (!token) {
+    log.err('A non-empty DraftGo API Key is required.');
+    return 1;
+  }
+  const timeoutMs = parseTimeout(flags.timeout);
+  log.step('Validating DraftGo API Key and MCP capabilities...');
+  try {
+    const diagnostic = await testConnection({ ...connection, server, token }, {
+      timeoutMs,
+    });
+    log.ok(`MCP ready (${diagnostic.tools.length} tools; tested ${diagnostic.testedCalls.join(', ')}).`);
+  } catch (error) {
+    const message = redactText(error && error.message ? error.message : error, [token]);
+    if (!flags['allow-offline']) {
+      log.err(message);
+      log.dim('  The project config was not changed. Run `draftgo mcp test` after checking the server and API Key.');
+      return 1;
+    }
+    log.warn(`MCP validation unavailable: ${message}`);
+    log.warn('Continuing only because --allow-offline was explicitly supplied.');
+  }
+
+  const configFile = writeProjectConfig(projectDir, server, token, {
+    mcp_url: connection.mcp_url,
+  });
+  log.ok(`Project configuration written: ${configFile}`);
+
+  if (!flags['no-mcp-setup']) {
+    try {
+      const setupCode = require('./mcp').setup(projectDir, positional, flags);
+      if (setupCode !== 0) log.dim('  Run `draftgo mcp setup <target>` when the AI host is known.');
+    } catch (error) {
+      log.warn(`MCP host setup was not completed: ${redactText(error.message || error, [token])}`);
+    }
+  }
+
+  log.title('Connected');
+  log.plain(`  server: ${server}`);
+  if (connection.mcp_url) log.plain(`  mcp endpoint: ${connection.mcp_url}`);
+  log.plain(`  config: ${configFile}`);
+  log.dim('  No DraftGo business resources were downloaded. Use MCP discovery or checkout long content explicitly.');
+  return 0;
+}
+
+module.exports = connect;

package/src/commands/delete.js

@@ -0,0 +1,95 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const log = require('../logger');
+const { confirm } = require('../prompt');
+const { loadProjectConfig } = require('../projectConfig');
+const { TOOL_NAMES, openToolSession, callStructured } = require('../mcp/tools');
+const { cachedDescription } = require('../apiContractCache');
+const { registryRevision, describeOperation } = require('./api');
+const {
+  isContractCompatibilityError,
+  isHardContractIncompatibility,
+  sameOperationContract,
+  incompatibleOperationError,
+} = require('../contractCompatibility');
+
+function readParams(projectDir, flags) {
+  const raw = flags.params ? String(flags.params)
+    : flags.input ? fs.readFileSync(path.resolve(projectDir, String(flags.input)), 'utf8') : '';
+  if (!raw) return {};
+  const parsed = JSON.parse(raw);
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    throw new Error('Delete MCP parameters must be a JSON object.');
+  }
+  return parsed;
+}
+
+function pathParameterName(description) {
+  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 = {}) {
+  if (!positional.length && !flags['operation-id']) {
+    log.err('Usage: draftgo delete <operation_id> [id] [--params JSON]');
+    return 1;
+  }
+  const config = loadProjectConfig(projectDir);
+  const session = await openToolSession(config, [
+    TOOL_NAMES.apiSearch, TOOL_NAMES.apiDescribe, TOOL_NAMES.apiCall,
+  ]);
+
+  const selectedOperation = flags['operation-id'] ? String(flags['operation-id']) : String(positional[0]);
+  const resourceId = positional[1];
+
+  let contract = cachedDescription(projectDir, config.server, selectedOperation);
+  if (!contract) {
+    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);
+  if (resourceId && Object.keys(params).length === 0) {
+    const parameterName = pathParameterName(contract.operation);
+    if (!parameterName) {
+      log.err('The operation does not expose exactly one path parameter; provide --params JSON explicitly.');
+      return 1;
+    }
+    params.path = { [parameterName]: resourceId };
+  }
+  if (!flags.yes && !flags.y) {
+    const approved = await confirm(`Call destructive DraftGo operation ${selectedOperation}?`, { default: false });
+    if (!approved) return 0;
+  }
+  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 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);
+    }
+    result = await invoke();
+  }
+  if (flags.output === 'json') console.log(JSON.stringify(result, null, 2));
+  else log.ok(`DraftGo operation completed: ${selectedOperation}`);
+  return 0;
+}
+
+module.exports = deleteResource;
+module.exports.pathParameterName = pathParameterName;

package/src/commands/deploy.js

@@ -0,0 +1,77 @@
+'use strict';
+
+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');
+
+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 }));
+}
+
+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: [] };
+  }
+  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,
+      }) };
+  }
+}
+
+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 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

@@ -0,0 +1,39 @@
+'use strict';
+
+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>');
+    return 1;
+  }
+  const result = diffResource(projectDir, resourceType, resourceId);
+  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 {
+    log.dim(`${result.entry.resource_type} ${result.entry.resource_id}: no local changes`);
+  }
+  return 0;
+}
+
+module.exports = diff;

package/src/commands/group.js

@@ -0,0 +1,37 @@
+'use strict';
+
+const log = require('../logger');
+const { callOperation } = require('./api');
+
+const OPERATIONS = Object.freeze({
+  list: 'listUserGroups',
+  create: 'createUserGroup',
+  get: 'getUserGroup',
+  update: 'updateUserGroup',
+  remove: 'deleteUserGroup',
+  '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|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

@@ -0,0 +1,190 @@
+'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
+
+DraftGo shell baseline: React + Vite. Database Pages default to native HTML,
+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. Omit the target
+                                    to detect host-owned directories such as
+                                    .cursor or .codex, not shared files like
+                                    AGENTS.md. Use "all" for every Skill target.
+  draftgo update [<target>...]     Refresh already installed Skills. Does not
+                                    upgrade the global CLI. 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, 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
+                                    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.
+
+  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,
+                                    --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.
+  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 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 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 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 [<ref>]        Show all history or one item with notes.
+  draftgo work list                Latest first; --status active|waiting|completed,
+                                  --date YYYY-MM-DD, --limit 1-100 (20), --offset N.
+
+  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 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 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 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:
+  pages | nav/navigations | docs/articles
+
+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.
+  --api-key <key>          (connect) DraftGo user API Key for non-interactive use.
+  --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.
+  --skip-update-check      (update) Compatibility flag; update never upgrades CLI.
+  --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;
+                           (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;
+                           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 object.
+  --delivery <mode>        (deploy) local | preview | deploy.
+  --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>.
+  --token <mode>           (verify) auto | never; auto appends the configured
+                           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.
+  --selector <css>         (verify) Require a visible element in top or iframe DOM.
+  --width/--height <px>    (verify) Override the default 1440x900 desktop viewport.
+
+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
+  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 verify pages 42
+  draftgo diff pages 42 --stat
+  draftgo commit pages 42
+  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;

package/src/commands/init.js

@@ -0,0 +1,126 @@
+'use strict';
+
+const path = require('path');
+const log = require('../logger');
+const { detectTargets } = require('../detect');
+const { resolveTargets, all } = require('../targets');
+const { ensureRuntime, getPackageVersion } = require('../skill');
+const { exists } = require('../fsx');
+const { ask } = require('../prompt');
+
+function showEnvironment() {
+  log.dim(`  Node.js ${process.versions.node}`);
+  log.dim('  DraftGo resources use MCP discovery; long content uses checkout/commit.');
+}
+
+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) {
+    let hits = detectTargets(projectDir);
+    if (hits.length === 0) {
+      log.warn('未在当前项目检测到任何支持的 AI 工具目录。');
+      log.dim(`  支持列表：${all.map((i) => i.name).join(', ')}`);
+      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));
+    if (unknown.length) {
+      log.err(`未知 target：${unknown.join(', ')}`);
+      log.dim(`  支持列表：${all.map((i) => i.name).join(', ')}`);
+      return 1;
+    }
+  }
+
+  // 2) Render skill body into each target's own directory (no shared
+  //    .draftgo/skill/ indirection anymore — each AI tool gets a real copy).
+  log.step('写入各 AI 工具 skill 目录（含 SKILL.md / 子技能 / references）');
+  ensureRuntime(projectDir);
+  const failures = [];
+  let installedCount = 0;
+  let skippedCount = 0;
+  for (const t of resolved) {
+    try {
+      const r = t.install(projectDir, { force: !!flags.force });
+      if (r.skipped) {
+        skippedCount += 1;
+        log.warn(`${t.displayName.padEnd(16)} 已存在，未覆盖；使用 draftgo update 或 --force 更新。`);
+      } else {
+        installedCount += 1;
+        log.ok(`${t.displayName.padEnd(16)} → ${r.path}`);
+      }
+    } catch (e) {
+      log.err(`${t.displayName} 安装失败：${e.message}`);
+      failures.push(t.displayName);
+    }
+  }
+  if (failures.length) {
+    log.err(`安装未完成，失败目标：${failures.join(', ')}`);
+    return 1;
+  }
+  if (skippedCount > 0) log.dim('  存在未覆盖目标；运行 draftgo update 可统一刷新。');
+  const design = require('../projectDesign').ensureProjectDesign(projectDir);
+  log.info(design.created ? '已创建 Design/README.md；业务设计按需建立。' : '已保留现有 Design/README.md。');
+  log.dim('  在 AI 工具中打开当前目录，描述产品需求；Agent 按 Design 和 worklog 开发。');
+  log.dim(`  CLI 版本：${getPackageVersion()}`);
+
+  // 3) Environment check (advisory).
+  log.step('环境检查');
+  showEnvironment();
+
+  // 4) Optional server binding flow.
+  const cfgPath = path.join(projectDir, '.draftgo', 'config.json');
+  const hasConfig = exists(cfgPath);
+  const flagConnect = flags.connect === true;
+  const flagSkip = flags['no-setup'] === true;
+
+  if (!hasConfig && !flagSkip) {
+    // 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 (interactive) {
+      log.title('选择 DraftGo 基座处理方式');
+      log.plain(`  ${log.c.cyan('[A]')} 连接基座服务`);
+      log.dim('      使用已有 DraftGo 服务，接下来输入 BaseURL 和系统访问令牌。');
+      log.plain(`  ${log.c.cyan('[B]')} 本地启动基座`);
+      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();
+      if (choice === 'A') {
+        return await require('./connect')(projectDir, [], flags);
+      }
+      if (choice === 'B') {
+        return await require('../localRuntime').runWizard(projectDir, { yes: true, interactive: true });
+      }
+      if (choice !== 'C') {
+        log.warn('无效选择，已跳过基座处理。');
+      }
+    }
+  }
+
+  log.title('完成');
+  log.plain(hasConfig ? 'Skill 已安装，项目已连接 DraftGo。' : 'Skill 已安装。');
+  return 0;
+}
+
+module.exports = init;

package/src/commands/listTargets.js

@@ -0,0 +1,13 @@
+'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;