draftgo-cli 3.0.51 → 3.0.53

package/src/commands/context.js

@@ -1,27 +0,0 @@
-'use strict';
-
-const log = require('../logger');
-const { collectContext, compactContext, TASK_PROFILES } = require('../context');
-const { parseTimeout } = require('../timeout');
-
-function printUsage() {
-  log.err('Usage: draftgo context --task <task> --output json');
-  log.dim(`  tasks: ${Object.keys(TASK_PROFILES).join(', ')}`);
-}
-
-async function contextCommand(projectDir, positional = [], flags = {}) {
-  if (positional.length || !flags.task || (flags.output && flags.output !== 'json')) {
-    printUsage();
-    return 1;
-  }
-  const result = await collectContext(projectDir, flags.task, {
-    timeoutMs: parseTimeout(flags.timeout),
-  });
-  console.log(JSON.stringify(flags.compact ? compactContext(result) : result, null, 2));
-  return 0;
-}
-
-contextCommand.printUsage = printUsage;
-contextCommand.parseTimeout = parseTimeout;
-
-module.exports = contextCommand;

package/src/context/index.js

@@ -1,662 +0,0 @@
-'use strict';
-
-const crypto = require('crypto');
-const fs = require('fs');
-const path = require('path');
-const pkg = require('../../package.json');
-const { RESOURCES_DIR } = require('../paths');
-const { loadProjectConfig } = require('../projectConfig');
-const { TOOL_NAMES, openToolSession } = require('../mcp/tools');
-const { readInstalledVersion } = require('../skill');
-
-const SKILL_ROOT = path.join(RESOURCES_DIR, 'skill');
-const MAX_STRUCTURED_TEXT_BYTES = 1024 * 1024;
-const LONG_CONTENT_RESOURCE_TYPES = Object.freeze([
-  'pages',
-  'navigations',
-  'docs/articles',
-  'custom_services',
-]);
-const DB_META_LIST_PATH = '/api/db-meta';
-const DB_META_PAGE_SIZE = 100;
-
-const TASK_PROFILES = Object.freeze({
-  frontend: {
-    apiQueries: [
-      { resource_type: 'pages' },
-      { resource_type: 'navigations' },
-      { resource_type: 'db' },
-    ],
-    references: [
-      {
-        file: 'references/architecture.md',
-        headings: ['核心概念（30 秒）', 'App 对象是什么（1 分钟）', '技术栈（30 秒）'],
-      },
-      {
-        file: 'references/modules.md',
-        headings: ['可开发模块（开发者负责实现）', '平台内置模块（开箱即用，不需实现）'],
-      },
-      {
-        file: 'references/frontend.md',
-        headings: [
-          '页面开发强制规则',
-          '页面实践经验',
-          '必须 / 禁止',
-          '前端底座与组件库清单',
-          '本地静态资源清单',
-          'GSAP 动效规范',
-          '颜色 Token（强制）',
-          '导航栏开发',
-          '退出登录',
-          '加载体验',
-          '选择器与表单体验',
-        ],
-      },
-      {
-        file: 'references/runtime.md',
-        headings: [
-          'iframe 注入机制',
-          'App 对象来源',
-          'URL 参数读取（标准三阶回落）',
-          '全局事件',
-          '前端全局层',
-        ],
-      },
-      {
-        file: 'references/app-api.md',
-        headings: ['请求', '反馈', '路由', '状态', '主题', '其他'],
-      },
-      { file: 'references/mcp.md', headings: ['API 发现与调用'] },
-      {
-        file: 'references/checkout.md',
-        headings: ['适用范围', '命令', 'Commit 流程', '409 / 412 冲突'],
-      },
-    ],
-  },
-  data: {
-    apiQueries: [{ resource_type: 'db' }],
-    references: [
-      {
-        file: 'references/modules.md',
-        headings: ['可开发模块（开发者负责实现）', '模块选型决策'],
-      },
-      {
-        file: 'references/data.md',
-        headings: [
-          'DB Meta 结构',
-          '关联关系（ref）',
-          'CRUD 操作范式',
-          'filters 操作符',
-          'db_meta 实时契约',
-          '通用筛选参数（非动态 DB）',
-        ],
-      },
-      { file: 'references/mcp.md', headings: ['API 发现与调用', '协议与安全'] },
-    ],
-  },
-  'custom-service': {
-    apiQueries: [{ resource_type: 'custom_scripts' }],
-    references: [
-      {
-        file: 'references/modules.md',
-        headings: ['可开发模块（开发者负责实现）', '模块选型决策', '自定义服务边界'],
-      },
-      {
-        file: 'references/custom-services.md',
-        headings: [
-          '最小服务',
-          '资源读写',
-          '触发器',
-          '平台 SDK',
-          '权限与运行限制',
-          '实时 API',
-          '验收清单',
-        ],
-      },
-      {
-        file: 'references/data.md',
-        headings: ['自定义服务内的 draftgo.DB.Query', 'filters 操作符'],
-      },
-      { file: 'references/mcp.md', headings: ['API 发现与调用', '协议与安全'] },
-    ],
-  },
-  aihub: {
-    apiQueries: [
-      { resource_type: 'aihub' },
-      { resource_type: 'agents' },
-    ],
-    references: [
-      {
-        file: 'references/aihub.md',
-        headings: ['条目骨架', '`data.spec` 字段地图', '观测'],
-      },
-      {
-        file: 'references/chat-sdk.md',
-        headings: [
-          '最小接入',
-          '协议',
-          '配置与布局',
-          'JavaScript API 与事件',
-          '历史与会话',
-          '鉴权与安全',
-        ],
-      },
-      { file: 'references/mcp.md', headings: ['API 发现与调用', '协议与安全'] },
-    ],
-  },
-  content: {
-    apiQueries: [
-      { resource_type: 'pages' },
-      { resource_type: 'navigations' },
-      { resource_type: 'docs/articles' },
-    ],
-    references: [
-      { file: 'references/architecture.md', headings: ['核心概念（30 秒）'] },
-      { file: 'references/modules.md', headings: ['可开发模块（开发者负责实现）'] },
-      {
-        file: 'references/checkout.md',
-        headings: ['适用范围', '命令', 'Checkout 流程', 'Commit 流程', '409 / 412 冲突'],
-      },
-    ],
-  },
-  project: {
-    apiQueries: [
-      { resource_type: 'pages' },
-      { resource_type: 'navigations' },
-      { resource_type: 'docs/articles' },
-      { resource_type: 'db' },
-    ],
-    references: [
-      {
-        file: 'references/architecture.md',
-        headings: ['核心概念（30 秒）', '为什么这样设计（1 分钟）', '技术栈（30 秒）'],
-      },
-      {
-        file: 'references/modules.md',
-        headings: [
-          '可开发模块（开发者负责实现）',
-          '平台内置模块（开箱即用，不需实现）',
-          '模块选型决策',
-          '自定义服务边界',
-        ],
-      },
-      { file: 'references/mcp.md', headings: ['边界', 'API 发现与调用', '协议与安全'] },
-      { file: 'references/checkout.md', headings: ['适用范围'] },
-    ],
-  },
-});
-
-const TASK_ALIASES = Object.freeze({
-  backend: 'custom-service',
-  service: 'custom-service',
-  ui: 'frontend',
-});
-
-function normalizeTask(value) {
-  const requested = String(value || '').trim().toLowerCase();
-  const task = Object.prototype.hasOwnProperty.call(TASK_ALIASES, requested)
-    ? TASK_ALIASES[requested]
-    : requested;
-  if (!Object.prototype.hasOwnProperty.call(TASK_PROFILES, task)) {
-    const supported = Object.keys(TASK_PROFILES).join(', ');
-    throw new Error(`Unsupported context task: ${requested || '(empty)'}. Supported tasks: ${supported}.`);
-  }
-  return task;
-}
-
-function lineNumberAt(source, offset) {
-  let line = 1;
-  for (let index = 0; index < offset; index += 1) {
-    if (source.charCodeAt(index) === 10) line += 1;
-  }
-  return line;
-}
-
-function sectionEndLine(content, startLine) {
-  let newlines = 0;
-  for (let index = 0; index < content.length; index += 1) {
-    if (content.charCodeAt(index) === 10) newlines += 1;
-  }
-  return startLine + newlines - (content.endsWith('\n') ? 1 : 0);
-}
-
-function extractSections(source, requestedHeadings, sourcePath) {
-  const matches = [...source.matchAll(/^## ([^\r\n]+)\r?$/gm)];
-  const wanted = requestedHeadings ? new Set(requestedHeadings) : null;
-  const sections = [];
-
-  if (matches.length && matches[0].index > 0) {
-    const content = source.slice(0, matches[0].index);
-    const title = content.match(/^# ([^\r\n]+)\r?$/m);
-    sections.push({
-      source: {
-        kind: 'bundled_reference',
-        path: sourcePath,
-        heading: title ? title[1] : '(preamble)',
-        line_start: 1,
-        line_end: sectionEndLine(content, 1),
-        sha256: crypto.createHash('sha256').update(content, 'utf8').digest('hex'),
-      },
-      content,
-    });
-  }
-
-  for (let index = 0; index < matches.length; index += 1) {
-    const match = matches[index];
-    const heading = match[1];
-    if (wanted && !wanted.has(heading)) continue;
-    const start = match.index;
-    const end = index + 1 < matches.length ? matches[index + 1].index : source.length;
-    const content = source.slice(start, end);
-    const startLine = lineNumberAt(source, start);
-    sections.push({
-      source: {
-        kind: 'bundled_reference',
-        path: sourcePath,
-        heading,
-        line_start: startLine,
-        line_end: sectionEndLine(content, startLine),
-        sha256: crypto.createHash('sha256').update(content, 'utf8').digest('hex'),
-      },
-      content,
-    });
-  }
-
-  if (wanted) {
-    const found = new Set(matches.map((match) => match[1]));
-    const missing = requestedHeadings.filter((heading) => !found.has(heading));
-    if (missing.length) {
-      throw new Error(`${sourcePath} is missing required sections: ${missing.join(', ')}.`);
-    }
-  }
-  if (!sections.length) throw new Error(`${sourcePath} contains no selectable reference sections.`);
-  return sections;
-}
-
-function readTaskReferences(taskValue, options = {}) {
-  const task = normalizeTask(taskValue);
-  const skillRoot = options.skillRoot || SKILL_ROOT;
-  return TASK_PROFILES[task].references.flatMap((entry) => {
-    const absolute = path.join(skillRoot, entry.file);
-    const source = fs.readFileSync(absolute, 'utf8');
-    const sourcePath = path.posix.join('resources/skill', entry.file.replace(/\\/g, '/'));
-    return extractSections(source, entry.headings, sourcePath);
-  });
-}
-
-function rawQuery(session, expectedName, args, server, options = {}) {
-  const tool = session.names[expectedName] || expectedName;
-  return session.client.toolsCall(tool, args, options).then((result) => ({
-    source: {
-      kind: 'mcp_tool',
-      server,
-      tool,
-      canonical_tool: expectedName,
-      arguments: args,
-      fetched_at: new Date().toISOString(),
-    },
-    result,
-  }));
-}
-
-function structuredValueFromRaw(result) {
-  let value = result;
-  if (value && value.result) value = value.result;
-  if (value && value.structuredContent) value = value.structuredContent;
-  else if (value && value.structured_content) value = value.structured_content;
-  else if (value && Array.isArray(value.content)) {
-    const text = value.content.find((part) =>
-      part && part.type === 'text' && typeof part.text === 'string');
-    if (text) {
-      if (Buffer.byteLength(text.text, 'utf8') > MAX_STRUCTURED_TEXT_BYTES) {
-        throw new Error('DraftGo MCP pagination result exceeded the structured JSON limit.');
-      }
-      try {
-        value = JSON.parse(text.text);
-      } catch {
-        throw new Error('DraftGo MCP pagination result did not contain structured JSON.');
-      }
-    }
-  }
-  if (value && value.data) value = value.data;
-  if (value && Object.prototype.hasOwnProperty.call(value, 'value')) value = value.value;
-  return value;
-}
-
-function nextCursorFromRaw(result) {
-  const value = structuredValueFromRaw(result);
-  if (!value || typeof value !== 'object') return null;
-  const hasMore = value.has_more === true || value.hasMore === true;
-  let cursor = null;
-  let hasCursor = false;
-  if (Object.prototype.hasOwnProperty.call(value, 'next_cursor')) {
-    cursor = value.next_cursor;
-    hasCursor = true;
-  } else if (Object.prototype.hasOwnProperty.call(value, 'nextCursor')) {
-    cursor = value.nextCursor;
-    hasCursor = true;
-  } else if (hasMore && Object.prototype.hasOwnProperty.call(value, 'cursor')) {
-    cursor = value.cursor;
-    hasCursor = true;
-  }
-  if (hasMore && (!hasCursor || cursor == null || cursor === '')) {
-    throw new Error('DraftGo MCP pagination reported more results without a cursor.');
-  }
-  return hasCursor ? cursor : null;
-}
-
-async function collectLongContentResources(session, server, options = {}) {
-  const sequences = await Promise.all(LONG_CONTENT_RESOURCE_TYPES.map((resourceType) =>
-    rawPagedQuery(
-      session,
-      TOOL_NAMES.resourceList,
-      { resource_type: resourceType, limit: 100 },
-      server,
-      options,
-    )));
-  return {
-    source: {
-      kind: 'mcp_tool_batch',
-      server,
-      canonical_tool: TOOL_NAMES.resourceList,
-      arguments: LONG_CONTENT_RESOURCE_TYPES.map((resourceType) => ({
-        resource_type: resourceType,
-        limit: 100,
-      })),
-    },
-    pages: sequences.flatMap((sequence) => sequence.pages),
-  };
-}
-
-async function collectTaskAPIs(session, queries, server, options = {}) {
-  const argumentsList = queries.map((query) => ({ ...query, limit: 100 }));
-  const sequences = await Promise.all(argumentsList.map((args) =>
-    rawPagedQuery(session, TOOL_NAMES.apiSearch, args, server, options)));
-  return {
-    source: {
-      kind: 'mcp_tool_batch',
-      server,
-      canonical_tool: TOOL_NAMES.apiSearch,
-      arguments: argumentsList,
-    },
-    pages: sequences.flatMap((sequence) => sequence.pages),
-  };
-}
-
-function itemsFromRawSequence(sequence) {
-  if (!sequence || !Array.isArray(sequence.pages)) return [];
-  return sequence.pages.flatMap((page) => {
-    const value = structuredValueFromRaw(page);
-    if (Array.isArray(value)) return value;
-    if (value && Array.isArray(value.items)) return value.items;
-    if (value && Array.isArray(value.operations)) return value.operations;
-    return [];
-  });
-}
-
-function selectDBMetaListOperation(sequence) {
-  return itemsFromRawSequence(sequence).find((operation) => {
-    if (!operation || typeof operation !== 'object') return false;
-    const method = String(operation.method || '').trim().toUpperCase();
-    const resourceType = String(operation.resource_type || '').trim().toLowerCase();
-    const operationPath = String(operation.path || operation.path_template || '').trim();
-    return method === 'GET'
-      && resourceType === 'db_meta'
-      && operationPath === DB_META_LIST_PATH
-      && operation.destructive !== true;
-  }) || null;
-}
-
-function optionalPageInteger(value, field, minimum) {
-  if (value == null) return null;
-  if (!Number.isSafeInteger(value) || value < minimum) {
-    throw new Error(`DraftGo db_meta API returned invalid ${field}.`);
-  }
-  return value;
-}
-
-function dbMetaPageInfo(response) {
-  let value = structuredValueFromRaw(response);
-  if (value && value.response) value = value.response;
-  if (value && value.data) value = value.data;
-  if (!value || typeof value !== 'object' || !Array.isArray(value.items)) return null;
-  return {
-    items: value.items,
-    total: optionalPageInteger(value.total, 'total', 0),
-    page: optionalPageInteger(value.page, 'page', 1),
-    pageSize: optionalPageInteger(value.page_size, 'page_size', 1),
-  };
-}
-
-async function rawPagedQuery(session, expectedName, baseArgs, server, options = {}) {
-  const pages = [];
-  const seen = new Set();
-  const maxPages = options.maxPages == null ? 100 : Number(options.maxPages);
-  if (!Number.isSafeInteger(maxPages) || maxPages < 1) {
-    throw new TypeError('maxPages must be a positive integer.');
-  }
-  let cursor = null;
-
-  for (let page = 0; page < maxPages; page += 1) {
-    const args = cursor == null ? { ...baseArgs } : { ...baseArgs, cursor };
-    const response = await rawQuery(session, expectedName, args, server, options);
-    pages.push(response);
-    const next = nextCursorFromRaw(response.result);
-    if (next == null || next === '') {
-      return {
-        source: {
-          kind: 'mcp_tool_sequence',
-          server,
-          canonical_tool: expectedName,
-          arguments: baseArgs,
-        },
-        pages,
-      };
-    }
-    const key = String(next);
-    if (seen.has(key)) throw new Error(expectedName + ' repeated a cursor.');
-    seen.add(key);
-    cursor = next;
-  }
-  throw new Error(expectedName + ' exceeded ' + maxPages + ' pages.');
-}
-
-async function collectDBMetaResources(session, operationID, server, options = {}) {
-  const pages = [];
-  let fetchedItems = 0;
-  let reportedTotal = null;
-  const maxPages = options.maxPages == null ? 100 : Number(options.maxPages);
-  if (!Number.isSafeInteger(maxPages) || maxPages < 1) {
-    throw new TypeError('maxPages must be a positive integer.');
-  }
-  for (let page = 1; page <= maxPages; page += 1) {
-    const args = {
-      operation_id: operationID,
-      query: { page, page_size: DB_META_PAGE_SIZE },
-    };
-    const response = await rawQuery(session, TOOL_NAMES.apiCall, args, server, options);
-    pages.push(response);
-    const info = dbMetaPageInfo(response);
-    if (!info) {
-      return {
-        source: {
-          kind: 'mcp_tool_sequence',
-          server,
-          canonical_tool: TOOL_NAMES.apiCall,
-          operation_id: operationID,
-        },
-        pages,
-        pagination: { complete: false, reason: 'response_shape_unavailable' },
-      };
-    }
-    const responsePage = info.page || page;
-    const responsePageSize = info.pageSize || DB_META_PAGE_SIZE;
-    if (responsePage !== page) {
-      throw new Error(`DraftGo db_meta API returned page ${responsePage} while page ${page} was requested.`);
-    }
-    fetchedItems += info.items.length;
-    if (info.total != null) {
-      if (reportedTotal != null && info.total !== reportedTotal) {
-        throw new Error(`DraftGo db_meta API changed total from ${reportedTotal} to ${info.total} during pagination.`);
-      }
-      reportedTotal = info.total;
-    }
-    if (reportedTotal != null) {
-      if (fetchedItems >= reportedTotal) {
-        return {
-          source: {
-            kind: 'mcp_tool_sequence',
-            server,
-            canonical_tool: TOOL_NAMES.apiCall,
-            operation_id: operationID,
-          },
-          pages,
-          pagination: { complete: true, total: reportedTotal },
-        };
-      }
-      if (!info.items.length) {
-        throw new Error('DraftGo db_meta API ended before the reported total was reached.');
-      }
-    } else if (info.items.length < responsePageSize) {
-      return {
-        source: {
-          kind: 'mcp_tool_sequence',
-          server,
-          canonical_tool: TOOL_NAMES.apiCall,
-          operation_id: operationID,
-        },
-        pages,
-        pagination: { complete: true, total: null },
-      };
-    }
-  }
-  throw new Error(`DraftGo db_meta API exceeded ${maxPages} pages.`);
-}
-
-async function collectDataStructures(session, server, options = {}) {
-  const api = await rawPagedQuery(
-    session,
-    TOOL_NAMES.apiSearch,
-    { resource_type: 'db_meta', limit: 100 },
-    server,
-    options,
-  );
-  const operation = selectDBMetaListOperation(api);
-  if (!operation || !operation.operation_id) {
-    throw new Error('DraftGo MCP does not expose a read-only GET /api/db-meta operation.');
-  }
-  const operationID = String(operation.operation_id);
-  const [contract, resources] = await Promise.all([
-    rawQuery(
-      session,
-      TOOL_NAMES.apiDescribe,
-      { operation_id: operationID },
-      server,
-      options,
-    ),
-    collectDBMetaResources(session, operationID, server, options),
-  ]);
-  return { api, contract, resources };
-}
-
-async function collectContext(projectDir, taskValue, options = {}) {
-  const task = normalizeTask(taskValue);
-  const profile = TASK_PROFILES[task];
-  const references = readTaskReferences(task, options);
-  const installedSkillVersion = readInstalledSkillVersion(projectDir);
-  const config = options.config || loadProjectConfig(projectDir);
-  const expected = [
-    TOOL_NAMES.projectOverview,
-    TOOL_NAMES.resourceList,
-    TOOL_NAMES.apiSearch,
-    TOOL_NAMES.apiDescribe,
-    TOOL_NAMES.apiCall,
-  ];
-  const openSession = options.openToolSession || openToolSession;
-  const session = options.session || await openSession(config, expected, options);
-  const controller = new AbortController();
-  const externalSignal = options.signal;
-  const forwardAbort = () => controller.abort(externalSignal.reason);
-  if (externalSignal) {
-    if (externalSignal.aborted) forwardAbort();
-    else externalSignal.addEventListener('abort', forwardAbort, { once: true });
-  }
-
-  let project;
-  let resources;
-  let api;
-  let dataStructures;
-  try {
-    const queryOptions = { ...options, signal: controller.signal };
-    [project, resources, api, dataStructures] = await Promise.all([
-      rawQuery(session, TOOL_NAMES.projectOverview, {}, config.server, queryOptions),
-      collectLongContentResources(session, config.server, queryOptions),
-      collectTaskAPIs(session, profile.apiQueries, config.server, queryOptions),
-      collectDataStructures(session, config.server, queryOptions),
-    ]);
-  } catch (error) {
-    if (!controller.signal.aborted) controller.abort(error);
-    throw error;
-  } finally {
-    if (externalSignal) externalSignal.removeEventListener('abort', forwardAbort);
-  }
-
-  return {
-    schema_version: '2.0',
-    task,
-    bundled_references: {
-      source: 'draftgo-cli',
-      version: pkg.version,
-      installed_skill_version: installedSkillVersion,
-      synchronized: installedSkillVersion == null ? null : installedSkillVersion === pkg.version,
-      sections: references.map((entry) => ({
-        ...entry,
-        source: { ...entry.source, source: 'cli_bundle', version: pkg.version },
-      })),
-    },
-    live_project: project,
-    live_resources: resources,
-    live_apis: api,
-    live_db_meta: dataStructures,
-    live_session: {
-      server: config.server,
-      protocol_version: session.client.protocolVersion,
-      fetched_at: new Date().toISOString(),
-    },
-  };
-}
-
-function compactContext(value) {
-  if (Array.isArray(value)) return value.map(compactContext);
-  if (!value || typeof value !== 'object') return value;
-  if (value.source && Object.prototype.hasOwnProperty.call(value, 'result')) {
-    return { source: compactContext(value.source), value: structuredValueFromRaw(value.result) };
-  }
-  const result = {};
-  for (const [key, child] of Object.entries(value)) result[key] = compactContext(child);
-  return result;
-}
-
-function readInstalledSkillVersion(projectDir) {
-  return readInstalledVersion(projectDir);
-}
-
-module.exports = {
-  TASK_PROFILES,
-  normalizeTask,
-  extractSections,
-  readTaskReferences,
-  structuredValueFromRaw,
-  nextCursorFromRaw,
-  rawPagedQuery,
-  collectLongContentResources,
-  collectTaskAPIs,
-  itemsFromRawSequence,
-  selectDBMetaListOperation,
-  dbMetaPageInfo,
-  collectDBMetaResources,
-  collectDataStructures,
-  readInstalledSkillVersion,
-  collectContext,
-  compactContext,
-};