draftgo-cli 3.0.49 → 3.0.52

package/src/commands/customService.js

@@ -0,0 +1,81 @@
+'use strict';
+
+const fs = require('fs');
+const log = require('../logger');
+const services = require('../customServices');
+
+function ids(positional) { return positional.map(String).filter(Boolean); }
+const TYPE_ALIASES = new Set(['custom-services', 'custom-service', 'custom_services', 'custom_service', 'services', 'scripts', 'custom_scripts']);
+function isServiceType(value) {
+  return TYPE_ALIASES.has(String(value || '').toLowerCase());
+}
+function serviceIds(positional) {
+  const values = ids(positional);
+  if (isServiceType(values[0])) values.shift();
+  return values;
+}
+function output(flags, value) {
+  if (flags.output === 'json') console.log(JSON.stringify(value, null, 2));
+}
+
+async function checkout(projectDir, positional, flags = {}) {
+  const values = ids(positional);
+  if (!values.length) { log.err('Usage: draftgo checkout custom-services <id...>'); return 1; }
+  const result = await services.checkout(projectDir, values, { force: Boolean(flags.force) });
+  if (flags.output === 'json') output(flags, result);
+  else result.forEach((item) => log.ok(`custom service ${item.resource_id} -> ${item.local_path}`));
+  return 0;
+}
+
+async function commit(projectDir, positional, flags = {}) {
+  const values = ids(positional);
+  if (!values.length) { log.err('Usage: draftgo commit custom-services <id...>'); return 1; }
+  const result = await services.commit(projectDir, values);
+  if (flags.output === 'json') output(flags, result);
+  else result.forEach((item) => log.ok(`custom service ${item.resource_id}: ${item.status}`));
+  return 0;
+}
+
+async function diff(projectDir, positional, flags = {}) {
+  const id = positional[0];
+  if (!id) { log.err('Usage: draftgo diff custom-services <id>'); return 1; }
+  const result = services.diff(projectDir, id);
+  if (flags.output === 'json') output(flags, result);
+  else if (result.changed) process.stdout.write(result.output);
+  else log.dim(`custom service ${id}: no local changes`);
+  return 0;
+}
+
+async function validate(projectDir, positional, flags = {}) {
+  const id = serviceIds(positional)[0];
+  if (!id) { log.err('Usage: draftgo validate custom-services <id>'); return 1; }
+  const result = await services.validate(projectDir, id);
+  if (flags.output === 'json') output(flags, result); else log.ok(`custom service ${id}: ${result.validation_status}`);
+  return result.validation_status === 'passed' ? 0 : 1;
+}
+
+async function test(projectDir, positional, flags = {}) {
+  const id = serviceIds(positional)[0];
+  if (!id) { log.err('Usage: draftgo test custom-services <id> [--input <json-file>]'); return 1; }
+  let input = {};
+  if (flags.input) input = JSON.parse(fs.readFileSync(String(flags.input), 'utf8'));
+  const readJSON = (value) => value ? JSON.parse(fs.readFileSync(String(value), 'utf8')) : undefined;
+  const policy = String(flags['side-effect-policy'] || 'deny').toLowerCase();
+  if (!['deny', 'mock', 'live'].includes(policy)) throw new Error('--side-effect-policy must be deny, mock, or live.');
+  const result = await services.test(projectDir, id, input, { handler: flags.handler, headers: readJSON(flags.headers), user: readJSON(flags.user),
+    testWrite: Boolean(flags['test-write']), sideEffectPolicy: policy });
+  if (flags.output === 'json') output(flags, result);
+  else log[result.status === 'success' ? 'ok' : 'err'](`custom service ${id}: ${result.status}`);
+  return result.status === 'success' ? 0 : 1;
+}
+
+async function publish(projectDir, positional, flags = {}) {
+  const values = serviceIds(positional);
+  if (!values.length) { log.err('Usage: draftgo publish custom-services <id...>'); return 1; }
+  const result = await services.publish(projectDir, values);
+  if (flags.output === 'json') output(flags, result);
+  else values.forEach((id) => log.ok(`custom service ${id}: published`));
+  return 0;
+}
+
+module.exports = { checkout, commit, diff, validate, test, publish, serviceIds, isServiceType };

package/src/commands/diff.js

@@ -9,6 +9,9 @@ function diff(projectDir, positional, flags = {}) {
     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);
   if (flags.output === 'json') {
     console.log(JSON.stringify({ changed: result.changed, entry: result.entry, diff: result.output }, null, 2));

package/src/commands/help.js

@@ -16,7 +16,7 @@ function help() {
 DraftGo Next frontend baseline: React + Vite.
 Database pages may use native web technologies or bundled component libraries.
 MCP handles live discovery and structured resources; complete page, navigation,
-and document bodies use checkout/commit outside MCP context.
+document, and custom-service bodies use checkout/commit outside MCP context.
 The context command combines exact local Reference sections with live MCP data;
 it is a CLI orchestration command, not an MCP tool.
 
@@ -44,10 +44,20 @@ Usage:
                                     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 check [custom-services <id...>]
+                                    Validate all checkouts or selected custom services.
                                     --remote also compares remote hash/version.
+  draftgo verify [<type> <id...>]   Run unified static verification; --remote adds
+                                    remote comparison and --url enables UI checks.
   draftgo diff <type> <id>         Show checkout base versus local body.
   draftgo commit <type> <id...>    Validate and upload complete checked-out bodies.
+  draftgo refresh <type> <id...>   Safely refresh a clean checkout from the cloud.
+  draftgo validate custom-services <id>
+                                    Build and inspect the current cloud draft.
+  draftgo test custom-services <id> [--handler <selector>]
+                                    Run the cloud draft in the DraftGo Runner.
+  draftgo publish custom-services <id...>
+                                    Publish validated drafts atomically.
   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>
@@ -55,7 +65,12 @@ Usage:
   draftgo conflict resolve <type> <id>
                                     Mark a merged worktree file ready against the
                                     preserved remote base; then check/diff/commit.
-  draftgo verify-ui <url>          Run a deterministic browser smoke check.
+  draftgo verify-ui <url>          Deprecated alias for verify --url <url> --ui always.
+  draftgo clean [--dry-run|--yes]  Plan or remove all tmp and registered artifacts.
+  draftgo task <operation> [...]   Track sustained work in one authoritative Task.md.
+                                    Operations: create, list, show, add, claim,
+                                    start, complete, block, reopen, accept, finish,
+                                    and explicit legacy migrate.
 
   draftgo api <query>              Search the live API contract through MCP.
   draftgo api describe <operation_id>
@@ -86,7 +101,7 @@ Usage:
   draftgo -h | --help              Show this help.
 
 Resource types:
-  pages | nav/navigations | docs/articles
+  pages | nav/navigations | docs/articles | custom-services
 
 Important flags:
   --project <dir>          Operate on <dir> instead of the current directory.
@@ -115,18 +130,28 @@ Important flags:
   --operation-id <id>      (delete) Select an operation explicitly.
   --params <json>          (api call/delete) Pass an API parameter object.
   --input <file>           (api call/delete) Read a UTF-8 JSON parameter object.
+  --handler <selector>     (custom-service test) route:METHOD:/path, event:name,
+                           scheduled:name, or a handler name.
+  --headers/--user <file>  (custom-service test) Read JSON test identity data.
+  --test-write             (custom-service test) Permit declared write testing.
+  --side-effect-policy <mode>
+                           (custom-service test) deny | mock | live; default deny.
   --delivery <mode>        (deploy) local | preview | deploy.
   --dry-run                (push) Show diffs without committing.
-  --mobile-check <mode>    (verify-ui) auto | always | never.
-  --token <mode>           (verify-ui) auto | never; auto appends the configured
+  --ui <mode>              (verify) auto | always | never; auto runs with --url.
+  --remote                 (check/verify) Compare checkout hashes with remote.
+  --viewport <mode>        (verify) mobile | desktop | both.
+  --frame <mode>           (verify) auto | top | all | <iframe-selector>.
+  --mobile-check <mode>    (verify-ui compatibility) auto | always | never.
+  --token <mode>           (verify) auto | never; auto appends the configured
                            SAT to same-origin URLs as the token query parameter.
-  --screenshot <mode>      (verify-ui) on-failure | always | never.
-  --browser <name>         (verify-ui) chromium | chrome | msedge.
-  --browser-path <file>    (verify-ui) Explicit browser executable; environment
+  --screenshot <mode>      (verify) on-failure | always | never; default never.
+  --browser <name>         (verify) chromium | chrome | msedge.
+  --browser-path <file>    (verify) Explicit browser executable; environment
                            fallback: DRAFTGO_BROWSER_PATH.
-  --resource <type:id>     (verify-ui) Compare local and remote content first.
-  --selector <css>         (verify-ui) Require a visible key element.
-  --width/--height <px>    (verify-ui) Override the default 390x844 viewport.
+  --resource <type:id>     (verify compatibility) Assert one remote UI resource.
+  --selector <css>         (verify) Require a visible element in top or iframe DOM.
+  --width/--height <px>    (verify) Override the default 390x844 viewport.
 
 Security:
   .draftgo/config.json stores the server and SAT and is gitignored. Host MCP
@@ -146,9 +171,13 @@ Examples:
   draftgo map --output json
   draftgo checkout pages 42
   draftgo check --strict
+  draftgo verify pages 42 --remote --url http://localhost:5173/example
   draftgo diff pages 42
   draftgo commit pages 42
   draftgo changelog add "Complete document management and role permissions"
+  draftgo task create "Personal growth" --original "Build a Notion-like system" \
+    --clarified "Build goals, habits, notes, and reviews" \
+    --expected-effect "Users manage personal growth in one workspace"
   draftgo deploy docs 7 --delivery preview
 `);
 }

package/src/commands/init.js

@@ -4,7 +4,7 @@ const path = require('path');
 const log = require('../logger');
 const { detectTargets } = require('../detect');
 const { resolveTargets, all } = require('../installers');
-const { ensureRuntime, writeInstalledVersion, getPackageVersion } = require('../skill');
+const { ensureRuntime, getPackageVersion } = require('../skill');
 const { exists } = require('../fsx');
 const { ask } = require('../prompt');
 
@@ -65,8 +65,7 @@ async function init(projectDir, positional, flags) {
     log.err(`安装未完成，失败目标：${failures.join(', ')}`);
     return 1;
   }
-  if (installedCount > 0 && skippedCount === 0) writeInstalledVersion(projectDir);
-  if (skippedCount > 0) log.dim('  存在未覆盖目标，未更新全局 skill 版本标记；运行 draftgo update 可统一刷新。');
+  if (skippedCount > 0) log.dim('  存在未覆盖目标；运行 draftgo update 可统一刷新。');
   log.dim(`  CLI 版本：${getPackageVersion()}`);
 
   // 3) Environment check (advisory).

package/src/commands/map.js

@@ -8,11 +8,13 @@ const { canonicalResourceType } = require('../worktree/types');
 const { TOOL_NAMES, openToolSession, callStructured } = require('../mcp/tools');
 const { allWithAbort } = require('../mcp/parallel');
 const { inspectRemoteCheckouts } = require('../worktree/status');
+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));
 
@@ -41,6 +43,7 @@ function claimsMorePages(value) {
 }
 
 function normalizeMapResourceType(value) {
+  if (require('./customService').isServiceType(value)) return 'custom_services';
   return REMOTE_RESOURCE_TYPES[canonicalResourceType(value)];
 }
 
@@ -86,6 +89,13 @@ function legacyCaches(projectDir) {
     .filter((name) => fs.existsSync(path.join(projectDir, '.draftgo', name, 'index.json')));
 }
 
+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;
+}
+
 async function mapCommand(projectDir, flags = {}) {
   const resourceTypes = requestedResourceTypes(flags);
   const config = loadProjectConfig(projectDir);
@@ -96,17 +106,17 @@ async function mapCommand(projectDir, flags = {}) {
       (options) => listRemoteResources(session, resourceTypes, options),
     ], options),
     async (options) => {
-      const remoteStatus = await inspectRemoteCheckouts(projectDir, {
+      const [contentStatus, serviceStatus] = await Promise.all([inspectRemoteCheckouts(projectDir, {
         config,
         client: session.client,
         tools: session.tools,
         signal: options.signal,
-      });
-      return remoteStatus.map((entry) => ({
+      }), customServices.inspectRemote(projectDir, { config, signal: options.signal })]);
+      return [...contentStatus, ...serviceStatus].map((entry) => ({
         ...entry,
         exists: entry.local_hash !== null,
         current_hash: entry.local_hash,
-        changed: entry.local_hash !== null && entry.local_hash !== entry.base_hash,
+        changed: checkoutChanged(entry),
       }));
     },
   ]);
@@ -150,3 +160,4 @@ module.exports.itemsFrom = itemsFrom;
 module.exports.normalizeMapResourceType = normalizeMapResourceType;
 module.exports.requestedResourceTypes = requestedResourceTypes;
 module.exports.listRemoteResources = listRemoteResources;
+module.exports.checkoutChanged = checkoutChanged;

package/src/commands/reconcile.js

@@ -9,6 +9,20 @@ async function reconcile(projectDir, positional, flags = {}) {
     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) {