draftgo-cli 3.0.35 → 3.0.39

package/src/commands/help.js

@@ -1,107 +1,131 @@
 'use strict';
 
 const { all } = require('../installers');
+const { HOSTS } = require('../mcp/hosts');
 const { getPackageVersion } = require('../skill');
 
 function help() {
   const targets = all.map((i) => `    ${i.name.padEnd(12)} ${i.displayName}`).join('\n');
-  console.log(`draftgo v${getPackageVersion()} — DraftGo Next workbench CLI for AI coding agents
+  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 Next frontend baseline: React + Vite.
 Database pages use standard HTML + Tailwind CSS.
-The CLI is the workbench layer for local runtime, resource sync, checks, and push/pull flows.
+MCP handles live discovery and structured resources; complete page, navigation,
+and document bodies use checkout/commit outside MCP context.
 
 Usage:
-  draftgo init [<target>...]       Install skill. No target = auto-detect.
-                                    Use "all" to install every target.
+  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 skill + entry files.
-  draftgo uninstall <target|all>   Remove entry files for target(s).
-                                    Use explicit "all" to remove every target.
-                                    --purge also removes .draftgo/ (runtime data).
-  draftgo status                   Show installed targets and skill version.
-  draftgo map                      Print a local DraftGo project resource map
-                                    for fast AI orientation.
-  draftgo check                    Check page entry binding, page/navigation
-                                    HTML parsing, and unregistered local files.
+                                    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 connect [<target>...]    Verify and save server/SAT, 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 initialize, tools/list, and tools/call.
+  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.
+                                    --force explicitly replaces local changes.
+  draftgo check                    Validate checked-out worktree/base files only.
+  draftgo diff <type> <id>         Show checkout base versus local body.
+  draftgo commit <type> <id...>    Validate and upload complete checked-out bodies.
+  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 verify-ui <url>          Run a deterministic browser smoke check.
-                                    Uses one viewport and screenshots on failure.
-  draftgo api <keyword>            Search DraftGo base APIs and show request/
-                                    response/authentication contracts.
-                                    Custom service routes come from app.Route;
-                                    they are not part of the bundled OpenAPI.
-  draftgo delete <type> <id>       Delete resource from server + local index.
-                                    Types: pages | nav | db_meta | custom_scripts
-                                           | docs | doc_categories | aihub
-                                    Alias: del, rm. Flags: --yes / -y skip confirm.
-  draftgo pull [type] [id...]      Pull DraftGo resources via the bundled
-                                    sync script. Defaults to --all.
-  draftgo push <type> [id...]      Push DraftGo resources via the bundled
-                                    sync script.
-  draftgo deploy [type] [id...]    Run check, then push explicitly.
-                                    --delivery local|preview|deploy
-  draftgo auto-push [type] [id...] Run check, then push only when
-                                    config.auto_push is true.
-                                    Supports --batch <type> <ids> ... too.
+
+  draftgo api <query>              Search the live API contract through MCP.
+  draftgo api describe <operation_id>
+                                    Describe one live API operation through MCP.
+  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 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 .draftgo/docker/docker-compose.yaml
-                                    generated by local setup. up/down remain
-                                    compatible aliases for start/stop.
-  draftgo list-targets             List supported AI tools.
-  draftgo connect                  Bind this project to an existing DraftGo
-                                    server. Prompts for BaseURL + access
-                                    token (or pass --server / --token).
-  draftgo local setup              One-click local DraftGo stack via Docker
-                                    (shared MySQL, Redis, Milvus + app). It
-                                    generates an app-only project compose,
-                                    <project>/.draftgo/docker/docker-compose.yaml,
-                                    then guides you to finish setup and paste
-                                    an access token.
+                                    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\`.
+  draftgo list-targets             List Skill installation targets.
   draftgo -v | --version           Print CLI version.
   draftgo -h | --help              Show this help.
 
-v3 Workbench:
-  draftgo local start|stop|logs    Local stack lifecycle commands.
-  draftgo check                    Local resource closure gate.
-  draftgo pull|push                First-class resource sync wrappers.
+Resource types:
+  pages | nav/navigations | docs/articles
 
-Flags:
+Important flags:
   --project <dir>          Operate on <dir> instead of the current directory.
-  --force                  Overwrite existing skill body during install/update.
-  --purge                  (uninstall) Also remove the entire .draftgo/ directory.
-  --skip-update-check      Do not contact npm to check for a newer CLI.
-  --yes                    Assume "yes" for interactive prompts.
-  --connect                (init) Skip the prompt and run \`draftgo connect\`.
-  --local-dev              (init) Skip the prompt and run \`draftgo local setup\`.
-  --no-setup               (init) Don't offer either flow after installing.
-  --server <url>           (connect) Provide the DraftGo BaseURL non-interactively.
-  --token <sat>            (connect) Provide the access token non-interactively.
-  --output <json>          (map/check) Print machine-readable JSON.
-  --strict                 (check) Treat warnings as failures.
-  --mobile-check <mode>    (verify-ui) auto | always | never. Default: auto.
+  --target <name,...>      Select one or more MCP setup/status targets.
+  --server <url>           (connect) DraftGo base URL.
+  --token <sat>            (connect) SAT 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) 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.
+  --strict                 Treat check warnings as failures.
+  --yes                    Skip supported confirmation prompts.
+  --operation-id <id>      (delete) Select an operation explicitly.
+  --params <json>          (delete) Pass an API parameter object.
+  --input <file>           (delete) Read the parameter object from JSON.
+  --delivery <mode>        (deploy) local | preview | deploy.
+  --dry-run                (push) Show diffs without committing.
+  --mobile-check <mode>    (verify-ui) auto | always | never.
   --screenshot <mode>      (verify-ui) on-failure | always | never.
   --browser <name>         (verify-ui) chromium | chrome | msedge.
-  --selector <css>         (verify-ui) Require a key element to be visible.
+  --selector <css>         (verify-ui) Require a visible key element.
   --width/--height <px>    (verify-ui) Override the default 390x844 viewport.
-  --delivery <mode>        (deploy) local | preview | deploy.
 
-Environment:
-  DRAFTGO_NO_UPDATE_CHECK=1     Disable the cached CLI version check.
+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.
+
+MCP targets (project config or status):
+${mcpTargets}
 
-Targets:
+Skill targets:
 ${targets}
 
 Examples:
-  draftgo init                 # auto-detect AI tools in this project
-  draftgo init claudecode      # install for Claude Code only
-  draftgo init claudecode kiro # install for both
-  draftgo init all             # install for every supported target
-  draftgo update               # fully update CLI and installed skills
-  draftgo map                  # inspect pages/nav/db/scripts before development
-  draftgo check --strict       # fail on any resource-check warning before push
-  draftgo verify-ui http://localhost:5173 --mobile-check auto
-  draftgo uninstall all --purge # full removal incl. runtime data
+  draftgo init codex
+  draftgo connect codex --server https://draftgo.example --token <sat>
+  draftgo mcp test
+  draftgo map --output json
+  draftgo checkout pages 42
+  draftgo check --strict
+  draftgo diff pages 42
+  draftgo commit pages 42
+  draftgo deploy docs 7 --delivery preview
 `);
 }
 

package/src/commands/init.js

@@ -5,18 +5,12 @@ const log = require('../logger');
 const { detectTargets } = require('../detect');
 const { resolveTargets, all } = require('../installers');
 const { ensureRuntime, writeInstalledVersion, getPackageVersion } = require('../skill');
-const { findPython } = require('../python');
 const { exists } = require('../fsx');
 const { ask } = require('../prompt');
 
-function warnIfNoPython() {
-  const py = findPython();
-  if (!py) {
-    log.warn('Python 未检测到。DraftGo 资源同步需要 Python 3.9+。');
-    log.dim('  安装 Python 3.9+ 后运行 `draftgo pull` 获取项目资源。');
-  } else {
-    log.dim(`  detected ${py.bin} (${py.version})`);
-  }
+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) {
@@ -77,7 +71,7 @@ async function init(projectDir, positional, flags) {
 
   // 3) Environment check (advisory).
   log.step('环境检查');
-  warnIfNoPython();
+  showEnvironment();
 
   // 4) Optional server binding flow.
   const cfgPath = path.join(projectDir, '.draftgo', 'config.json');

package/src/commands/local.js

@@ -27,12 +27,29 @@ function runCompose(projectDir, args, stdio = 'inherit') {
     return 1;
   }
 
-  const r = spawnSync(docker.composeCmd, [...docker.composeArgs, '-f', file, ...args], {
-    cwd: path.dirname(file),
-    stdio,
-    shell: false,
-  });
-  return r.status || 0;
+  let result;
+  try {
+    result = spawnSync(docker.composeCmd, [...docker.composeArgs, '-f', file, ...args], {
+      cwd: path.dirname(file),
+      stdio,
+      shell: false,
+    });
+  } catch (error) {
+    log.err(`Failed to start Docker Compose: ${error.message}`);
+    return 1;
+  }
+
+  if (result.error) {
+    log.err(`Failed to start Docker Compose: ${result.error.message}`);
+    return 1;
+  }
+  if (!Number.isInteger(result.status)) {
+    log.err(result.signal
+      ? `Docker Compose terminated by signal ${result.signal}.`
+      : 'Docker Compose did not report an exit status.');
+    return 1;
+  }
+  return result.status;
 }
 
 function local(projectDir, positional, flags = {}) {

package/src/commands/map.js

@@ -1,105 +1,105 @@
 'use strict';
 
+const fs = require('fs');
+const path = require('path');
 const log = require('../logger');
-const { buildProjectMap } = require('../projectMap');
+const { loadProjectConfig } = require('../projectConfig');
+const { loadManifest, absolutePath } = require('../worktree/manifest');
+const { hashFile } = require('../worktree/streams');
+const { TOOL_NAMES, openToolSession, callStructured } = require('../mcp/tools');
+
+function itemsFrom(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.resources)) return value.resources;
+  if (value.data) return itemsFrom(value.data);
+  return [];
+}
+
+function nextCursor(value) {
+  return value && (value.next_cursor || value.nextCursor || value.cursor && value.has_more && value.cursor);
+}
+
+async function listRemoteResources(session, flags) {
+  const resources = [];
+  const seen = new Set();
+  let cursor = null;
+  for (let page = 0; page < 100; page += 1) {
+    const args = {};
+    if (cursor) args.cursor = cursor;
+    if (flags.type) args.resource_type = String(flags.type);
+    const payload = await callStructured(session, TOOL_NAMES.resourceList, args);
+    resources.push(...itemsFrom(payload));
+    cursor = nextCursor(payload);
+    if (!cursor) break;
+    if (seen.has(cursor)) throw new Error('DraftGo resource_list repeated a cursor.');
+    seen.add(cursor);
+  }
+  if (cursor) throw new Error('DraftGo resource_list exceeded 100 pages.');
+  return resources;
+}
 
-function printList(title, rows, render) {
-  console.log('');
-  log.info(`${title}：${rows.length}`);
-  if (rows.length === 0) {
-    log.dim('  （无）');
-    return;
+async function localCheckouts(projectDir) {
+  const manifest = loadManifest(projectDir);
+  const entries = [];
+  for (const entry of Object.values(manifest.entries)) {
+    const local = absolutePath(projectDir, entry.local_path);
+    let currentHash = null;
+    if (fs.existsSync(local)) currentHash = (await hashFile(local)).hash;
+    entries.push({
+      ...entry,
+      exists: currentHash !== null,
+      current_hash: currentHash,
+      changed: currentHash !== null && currentHash !== entry.base_hash,
+    });
   }
-  for (const row of rows) log.dim(`  • ${render(row)}`);
+  return entries;
 }
 
-function mapCommand(projectDir, flags = {}) {
-  const map = buildProjectMap(projectDir);
+function legacyCaches(projectDir) {
+  return ['pages', 'navigations', 'docs', 'db_meta', 'custom_scripts', 'aihub', 'roles', 'users', 'system_config']
+    .filter((name) => fs.existsSync(path.join(projectDir, '.draftgo', name, 'index.json')));
+}
+
+async function mapCommand(projectDir, flags = {}) {
+  const config = loadProjectConfig(projectDir);
+  const session = await openToolSession(config, [TOOL_NAMES.projectOverview, TOOL_NAMES.resourceList]);
+  const [overview, resources, checkouts] = await Promise.all([
+    callStructured(session, TOOL_NAMES.projectOverview, {}),
+    listRemoteResources(session, flags),
+    localCheckouts(projectDir),
+  ]);
+  const result = {
+    server: config.server,
+    overview,
+    resources,
+    checkouts,
+    legacy_cache: { ignored: true, detected: legacyCaches(projectDir) },
+  };
 
   if (flags.output === 'json') {
-    console.log(JSON.stringify(map, null, 2));
+    console.log(JSON.stringify(result, null, 2));
     return 0;
   }
-
   log.title('draftgo map');
-  log.info(`项目目录：${projectDir}`);
-
-  printList('页面', map.pages, (p) => {
-    const id = p.id == null ? 'new' : p.id;
-    return `${String(id).padEnd(4)} ${p.route || '（无 route）'}  ${p.title || '未命名'}${p.html_file ? `  ${p.html_file}` : ''}`;
-  });
-
-  printList('导航', map.navigations, (n) => {
-    const id = n.id == null ? 'new' : n.id;
-    return `${String(id).padEnd(4)} ${n.code || 'default'}  ${n.name || '未命名'}${n.html_file ? `  ${n.html_file}` : ''}`;
-  });
-
-  printList('动态 DB', map.db_meta, (m) => {
-    const fields = m.fields.length ? ` (${m.fields.slice(0, 8).join(', ')}${m.fields.length > 8 ? ', ...' : ''})` : '';
-    return `${m.type || '（无 type）'}  ${m.label || ''}${fields}`;
-  });
-
-  printList('自定义脚本', map.custom_scripts, (s) => {
-    const bindings = [
-      ...(s.routes || []),
-      ...(s.events || []).map((event) => `EVENT ${event}`),
-      ...(s.schedules || []).map((cron) => `CRON ${cron}`),
-    ];
-    const summary = bindings.length ? `  [${bindings.join(' | ')}]` : '';
-    return `${s.slug || '（无 slug）'}  ${s.mode || 'mode?'}  ${s.name || ''}${summary}${s.code_file ? `  ${s.code_file}` : ''}`;
-  });
-
-  printList('文档', map.docs, (d) => {
-    return `${d.id || 'new'}  ${d.slug || '（无 slug）'}  ${d.title || '未命名'}${d.content_file ? `  ${d.content_file}` : ''}`;
-  });
-
-  printList('文档分类', map.doc_categories, (c) => {
-    const parent = c.parent_id == null ? 'root' : `parent:${c.parent_id}`;
-    return `${c.id || 'new'}  ${c.slug || '（无 slug）'}  ${c.name || '未命名'}  ${parent}`;
-  });
-
-  printList('系统配置', map.system_config, (c) => {
-    const sensitive = c.is_sensitive ? ' sensitive' : '';
-    return `${c.config_key || '（无 key）'}  ${c.category || 'default'}  ${c.value_type || 'value'}${sensitive}`;
-  });
-
-  printList('AIHub', map.aihub, (a) => {
-    const extra = [];
-    if (a.type === 'agent') {
-      if (a.mode) extra.push(a.mode);
-      if (a.output_format && a.output_format.mode === 'json') extra.push(`json:${a.output_format.json_strategy || 'auto'}`);
-      if (a.model_selection && a.model_selection.user_selectable) extra.push('user-model');
-      if (a.tools && a.tools.sources.length) extra.push(`tools:${a.tools.sources.length}`);
-    } else if (a.type === 'model') {
-      extra.push(`models:${a.models_count || 0}`);
-      if (a.supports_response_format === true) extra.push('response_format');
-      if (a.supports_json_schema === true) extra.push('json_schema');
-    } else if (a.type === 'mcp') {
-      extra.push(a.transport || 'transport?');
-      extra.push(`tools:${a.tools_count || 0}`);
-    }
-    return `${a.id || 'new'}  ${a.type || ''}  ${a.name || ''}${extra.length ? `  [${extra.join(', ')}]` : ''}`;
-  });
-  printList('角色', map.roles, (r) => `${r.code || r.id || 'new'}  ${r.name || ''}`);
-
-  console.log('');
-  log.info('页面分区：');
-  const areaRows = [
-    ['home', map.pageGroups.home.length],
-    ['admin', map.pageGroups.admin.length],
-    ['business', map.pageGroups.business.length],
-    ['system', map.pageGroups.system.length],
-    ['unknown', map.pageGroups.unknown.length],
-  ];
-  log.dim('  ' + areaRows.map(([k, v]) => `${k} ${v}`).join('  '));
-
-  console.log('');
-  log.info('入口引用：');
-  const routes = Object.keys(map.routeRefs).sort();
-  if (routes.length === 0) log.dim('  （未发现 data-page-route / href 引用）');
-  else routes.forEach((route) => log.dim(`  • ${route} ← ${map.routeRefs[route].join(', ')}`));
-
+  log.info(`Remote resources: ${resources.length}`);
+  const counts = new Map();
+  for (const resource of resources) {
+    const type = resource.resource_type || resource.type || 'unknown';
+    counts.set(type, (counts.get(type) || 0) + 1);
+  }
+  for (const [type, count] of [...counts.entries()].sort()) log.plain(`  ${type}: ${count}`);
+  log.info(`Local checkouts: ${checkouts.length}`);
+  for (const entry of checkouts) {
+    const state = !entry.exists ? 'missing' : entry.changed ? 'modified' : 'clean';
+    log.plain(`  ${entry.resource_type} ${entry.resource_id}: ${state} (${entry.local_path})`);
+  }
+  if (result.legacy_cache.detected.length) {
+    log.warn(`Ignored legacy cache indexes: ${result.legacy_cache.detected.join(', ')}`);
+  }
   return 0;
 }
 
 module.exports = mapCommand;
+module.exports.itemsFrom = itemsFrom;

package/src/commands/mcp.js

@@ -0,0 +1,126 @@
+'use strict';
+
+const log = require('../logger');
+const { loadProjectConfig } = require('../projectConfig');
+const { testConnection } = require('../mcp/client');
+const { redactText } = require('../mcp/protocol');
+const {
+  HOSTS,
+  detectHostTargets,
+  setupHosts,
+  statusHosts,
+} = require('../mcp/hosts');
+const { serveStdio } = require('../mcp/stdio');
+
+function targetArgs(positional, flags) {
+  const values = positional.slice();
+  if (flags.target) values.push(...String(flags.target).split(','));
+  return values.map((value) => String(value).trim()).filter(Boolean);
+}
+
+function printUsage() {
+  log.plain('Usage:');
+  log.plain('  draftgo mcp setup [target...]');
+  log.plain('  draftgo mcp status [target...]');
+  log.plain('  draftgo mcp test');
+  log.plain('  draftgo mcp serve');
+  log.dim(`  targets: ${HOSTS.map((host) => host.name).join(', ')}`);
+}
+
+function setup(projectDir, positional = [], flags = {}) {
+  const targets = targetArgs(positional, flags);
+  const detected = targets.length ? null : detectHostTargets(projectDir);
+  if (!targets.length && detected.length === 0) {
+    log.err('No supported AI host was detected in this project.');
+    log.dim('  Run `draftgo mcp setup <target>` to select one explicitly.');
+    return 1;
+  }
+
+  const results = setupHosts(projectDir, targets.length ? targets : detected.map((host) => host.name));
+  let configured = 0;
+  let unsupported = 0;
+  for (const result of results) {
+    if (!result.supported) {
+      unsupported += 1;
+      log.warn(`${result.host.displayName}: ${result.reason}`);
+      continue;
+    }
+    configured += 1;
+    if (result.changed) log.ok(`${result.host.displayName}: ${result.host.path}`);
+    else log.info(`${result.host.displayName}: already configured`);
+  }
+  if (!configured && unsupported) return 1;
+  if (!configured) {
+    log.err('No MCP host configuration was written.');
+    return 1;
+  }
+  return 0;
+}
+
+function status(projectDir, positional = [], flags = {}) {
+  const targets = targetArgs(positional, flags);
+  const results = statusHosts(projectDir, targets);
+  log.title('draftgo mcp status');
+  let exitCode = 0;
+  try {
+    const config = loadProjectConfig(projectDir);
+    log.plain(`  project      configured (${config.server}; SAT present)`);
+  } catch (error) {
+    log.plain(`  project      not ready (${error.message})`);
+    exitCode = 1;
+  }
+  for (const result of results) {
+    if (!result.supported) {
+      log.plain(`  - ${result.host.name.padEnd(12)} unsupported`);
+    } else if (result.configured && result.secure) {
+      log.plain(`  OK ${result.host.name.padEnd(12)} ${result.host.path}`);
+    } else if (result.error) {
+      log.plain(`  x  ${result.host.name.padEnd(12)} invalid config`);
+      exitCode = 1;
+    } else {
+      log.plain(`  -  ${result.host.name.padEnd(12)} not configured`);
+    }
+  }
+  return exitCode;
+}
+
+async function test(projectDir, _positional = [], flags = {}) {
+  let config;
+  try {
+    config = loadProjectConfig(projectDir);
+    const result = await testConnection(config, {
+      timeoutMs: flags.timeout ? Number(flags.timeout) : undefined,
+    });
+    log.ok('DraftGo MCP initialize succeeded.');
+    log.ok(`tools/list returned ${result.tools.length} tools.`);
+    log.ok(`tools/call succeeded: ${result.testedTool}`);
+    log.dim(`  protocol: ${result.protocolVersion}`);
+    return 0;
+  } catch (error) {
+    const token = config && String(config.token || config.sat || '');
+    log.err(redactText(error && error.message ? error.message : error, [token]));
+    return 1;
+  }
+}
+
+async function serve(projectDir, _positional = [], _flags = {}) {
+  return serveStdio(projectDir);
+}
+
+async function mcp(projectDir, positional = [], flags = {}) {
+  const [action, ...rest] = positional;
+  if (action === 'setup') return setup(projectDir, rest, flags);
+  if (action === 'status') return status(projectDir, rest, flags);
+  if (action === 'test') return test(projectDir, rest, flags);
+  if (action === 'serve') return serve(projectDir, rest, flags);
+  printUsage();
+  return 1;
+}
+
+mcp.setup = setup;
+mcp.status = status;
+mcp.test = test;
+mcp.serve = serve;
+mcp.printUsage = printUsage;
+
+module.exports = mcp;