@gong-ym/ai-spec-auto 0.2.13 → 0.2.15

package/src/connectors/visual/evidence-report.js

@@ -1,49 +1,49 @@
-const STATUS_MAP = {
-  success: 'success',
-  passed: 'success',
-  pass: 'success',
-  ok: 'success',
-  failure: 'failure',
-  failed: 'failure',
-  fail: 'failure',
-  error: 'failure',
-  blocked: 'blocked',
-  通过: 'success',
-  成功: 'success',
-  失败: 'failure',
-  阻塞: 'blocked',
-  待执行: 'unknown',
-};
-
-function normalizeFinalStatus(value) {
-  return STATUS_MAP[String(value || '').trim()] || 'unknown';
-}
-
-function normalizeChangedFiles(changedFiles = []) {
-  return (Array.isArray(changedFiles) ? changedFiles : []).map((file) => ({
-    path: String(file.path || ''),
-    changeType: file.changeType || file.action || 'modify',
-    summary: file.summary || file.description || '',
-  })).filter((file) => file.path);
-}
-
-function normalizeEvidenceReport(input = {}) {
-  return {
-    ...input,
-    runId: input.runId || '',
-    projectId: input.projectId || '',
-    taskId: input.taskId || '',
-    specId: input.specId || '',
-    changedFiles: normalizeChangedFiles(input.changedFiles),
-    testResults: Array.isArray(input.testResults) ? input.testResults : [],
-    hookResults: Array.isArray(input.hookResults) ? input.hookResults : [],
-    repairResults: Array.isArray(input.repairResults) ? input.repairResults : [],
-    reviewResults: Array.isArray(input.reviewResults) ? input.reviewResults : [],
-    finalStatus: normalizeFinalStatus(input.finalStatus || input.status),
-  };
-}
-
-module.exports = {
-  normalizeEvidenceReport,
-  normalizeFinalStatus,
-};
+const STATUS_MAP = {
+  success: 'success',
+  passed: 'success',
+  pass: 'success',
+  ok: 'success',
+  failure: 'failure',
+  failed: 'failure',
+  fail: 'failure',
+  error: 'failure',
+  blocked: 'blocked',
+  通过: 'success',
+  成功: 'success',
+  失败: 'failure',
+  阻塞: 'blocked',
+  待执行: 'unknown',
+};
+
+function normalizeFinalStatus(value) {
+  return STATUS_MAP[String(value || '').trim()] || 'unknown';
+}
+
+function normalizeChangedFiles(changedFiles = []) {
+  return (Array.isArray(changedFiles) ? changedFiles : []).map((file) => ({
+    path: String(file.path || ''),
+    changeType: file.changeType || file.action || 'modify',
+    summary: file.summary || file.description || '',
+  })).filter((file) => file.path);
+}
+
+function normalizeEvidenceReport(input = {}) {
+  return {
+    ...input,
+    runId: input.runId || '',
+    projectId: input.projectId || '',
+    taskId: input.taskId || '',
+    specId: input.specId || '',
+    changedFiles: normalizeChangedFiles(input.changedFiles),
+    testResults: Array.isArray(input.testResults) ? input.testResults : [],
+    hookResults: Array.isArray(input.hookResults) ? input.hookResults : [],
+    repairResults: Array.isArray(input.repairResults) ? input.repairResults : [],
+    reviewResults: Array.isArray(input.reviewResults) ? input.reviewResults : [],
+    finalStatus: normalizeFinalStatus(input.finalStatus || input.status),
+  };
+}
+
+module.exports = {
+  normalizeEvidenceReport,
+  normalizeFinalStatus,
+};

package/src/connectors/visual/index.js

@@ -1,15 +1,15 @@
-const { normalizeEvidenceReport, normalizeFinalStatus } = require('./evidence-report');
-const { VisualFailureQueue, defaultVisualQueueDir } = require('./queue');
-const { normalizeRunEvent, normalizeSeverity, normalizeStatus } = require('./run-event');
-const { VisualConnector } = require('./visual-connector');
-
-module.exports = {
-  VisualConnector,
-  VisualFailureQueue,
-  defaultVisualQueueDir,
-  normalizeEvidenceReport,
-  normalizeFinalStatus,
-  normalizeRunEvent,
-  normalizeSeverity,
-  normalizeStatus,
-};
+const { normalizeEvidenceReport, normalizeFinalStatus } = require('./evidence-report');
+const { VisualFailureQueue, defaultVisualQueueDir } = require('./queue');
+const { normalizeRunEvent, normalizeSeverity, normalizeStatus } = require('./run-event');
+const { VisualConnector } = require('./visual-connector');
+
+module.exports = {
+  VisualConnector,
+  VisualFailureQueue,
+  defaultVisualQueueDir,
+  normalizeEvidenceReport,
+  normalizeFinalStatus,
+  normalizeRunEvent,
+  normalizeSeverity,
+  normalizeStatus,
+};

package/src/connectors/visual/queue.js

@@ -1,41 +1,41 @@
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-function defaultVisualQueueDir(homeDir = os.homedir()) {
-  return path.join(homeDir, '.ai-spec-auto', 'visual-queue');
-}
-
-function sanitizeName(value) {
-  return String(value || 'event').replace(/[^a-zA-Z0-9._-]+/g, '-').slice(0, 80);
-}
-
-class VisualFailureQueue {
-  constructor(options = {}) {
-    this.queueDir = options.queueDir || defaultVisualQueueDir(options.homeDir);
-  }
-
-  enqueue(record = {}) {
-    fs.mkdirSync(this.queueDir, { recursive: true });
-    const now = new Date().toISOString();
-    const type = sanitizeName(record.type || record.payload?.eventType || record.payload?.type);
-    const id = sanitizeName(record.payload?.eventId || record.payload?.runId || Date.now());
-    const filePath = path.join(this.queueDir, `${now.replace(/[:.]/g, '-')}-${type}-${id}.json`);
-    const entry = {
-      schemaVersion: '1.0.0',
-      queuedAt: now,
-      type: record.type || 'run-event',
-      endpoint: record.endpoint || '',
-      reason: record.reason || '',
-      code: record.code || 'VISUAL_REPORT_FAILED',
-      payload: record.payload || {},
-    };
-    fs.writeFileSync(filePath, `${JSON.stringify(entry, null, 2)}\n`, 'utf8');
-    return { filePath, entry };
-  }
-}
-
-module.exports = {
-  VisualFailureQueue,
-  defaultVisualQueueDir,
-};
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+function defaultVisualQueueDir(homeDir = os.homedir()) {
+  return path.join(homeDir, '.ai-spec-auto', 'visual-queue');
+}
+
+function sanitizeName(value) {
+  return String(value || 'event').replace(/[^a-zA-Z0-9._-]+/g, '-').slice(0, 80);
+}
+
+class VisualFailureQueue {
+  constructor(options = {}) {
+    this.queueDir = options.queueDir || defaultVisualQueueDir(options.homeDir);
+  }
+
+  enqueue(record = {}) {
+    fs.mkdirSync(this.queueDir, { recursive: true });
+    const now = new Date().toISOString();
+    const type = sanitizeName(record.type || record.payload?.eventType || record.payload?.type);
+    const id = sanitizeName(record.payload?.eventId || record.payload?.runId || Date.now());
+    const filePath = path.join(this.queueDir, `${now.replace(/[:.]/g, '-')}-${type}-${id}.json`);
+    const entry = {
+      schemaVersion: '1.0.0',
+      queuedAt: now,
+      type: record.type || 'run-event',
+      endpoint: record.endpoint || '',
+      reason: record.reason || '',
+      code: record.code || 'VISUAL_REPORT_FAILED',
+      payload: record.payload || {},
+    };
+    fs.writeFileSync(filePath, `${JSON.stringify(entry, null, 2)}\n`, 'utf8');
+    return { filePath, entry };
+  }
+}
+
+module.exports = {
+  VisualFailureQueue,
+  defaultVisualQueueDir,
+};

package/src/connectors/visual/run-event.js

@@ -1,81 +1,81 @@
-const crypto = require('crypto');
-
-const STATUS_MAP = {
-  success: 'success',
-  passed: 'success',
-  pass: 'success',
-  ok: 'success',
-  running: 'running',
-  pending: 'running',
-  skipped: 'skipped',
-  skip: 'skipped',
-  blocked: 'blocked',
-  failure: 'failure',
-  failed: 'failure',
-  fail: 'failure',
-  error: 'failure',
-  通过: 'success',
-  成功: 'success',
-  失败: 'failure',
-  阻塞: 'blocked',
-  待执行: 'unknown',
-};
-
-const SEVERITY_MAP = {
-  info: 'info',
-  warn: 'warn',
-  warning: 'warn',
-  error: 'error',
-  failed: 'error',
-  blocking: 'blocking',
-  blocked: 'blocking',
-};
-
-function hash(value, length = 12) {
-  return crypto.createHash('sha256').update(String(value || '')).digest('hex').slice(0, length);
-}
-
-function normalizeStatus(value) {
-  return STATUS_MAP[String(value || '').trim()] || 'unknown';
-}
-
-function normalizeSeverity(value) {
-  return SEVERITY_MAP[String(value || '').trim()] || 'info';
-}
-
-function normalizeRunEvent(input = {}) {
-  const timestamp = input.timestamp || input.occurredAt || input.createdAt || new Date().toISOString();
-  const eventType = input.eventType || input.type || 'runtime.event';
-  const status = normalizeStatus(input.status || input.state);
-  const severity = normalizeSeverity(input.severity || input.level || (status === 'failure' ? 'error' : status));
-  const metadata = {
-    ...(input.metadata && typeof input.metadata === 'object' ? input.metadata : {}),
-    ...(input.payload && typeof input.payload === 'object' ? input.payload : {}),
-  };
-  const eventId = input.eventId || `evt_${hash(`${input.runId || 'run'}:${eventType}:${timestamp}`)}`;
-
-  return {
-    ...input,
-    eventId,
-    runId: input.runId || '',
-    projectId: input.projectId || '',
-    eventType,
-    stage: input.stage || input.state || 'unknown',
-    status,
-    severity,
-    message: input.message || input.summary || '',
-    timestamp,
-    metadata,
-
-    // 兼容旧版 Visual Collector。
-    type: input.type || eventType,
-    level: input.level || severity,
-    occurredAt: input.occurredAt || timestamp,
-  };
-}
-
-module.exports = {
-  normalizeRunEvent,
-  normalizeSeverity,
-  normalizeStatus,
-};
+const crypto = require('crypto');
+
+const STATUS_MAP = {
+  success: 'success',
+  passed: 'success',
+  pass: 'success',
+  ok: 'success',
+  running: 'running',
+  pending: 'running',
+  skipped: 'skipped',
+  skip: 'skipped',
+  blocked: 'blocked',
+  failure: 'failure',
+  failed: 'failure',
+  fail: 'failure',
+  error: 'failure',
+  通过: 'success',
+  成功: 'success',
+  失败: 'failure',
+  阻塞: 'blocked',
+  待执行: 'unknown',
+};
+
+const SEVERITY_MAP = {
+  info: 'info',
+  warn: 'warn',
+  warning: 'warn',
+  error: 'error',
+  failed: 'error',
+  blocking: 'blocking',
+  blocked: 'blocking',
+};
+
+function hash(value, length = 12) {
+  return crypto.createHash('sha256').update(String(value || '')).digest('hex').slice(0, length);
+}
+
+function normalizeStatus(value) {
+  return STATUS_MAP[String(value || '').trim()] || 'unknown';
+}
+
+function normalizeSeverity(value) {
+  return SEVERITY_MAP[String(value || '').trim()] || 'info';
+}
+
+function normalizeRunEvent(input = {}) {
+  const timestamp = input.timestamp || input.occurredAt || input.createdAt || new Date().toISOString();
+  const eventType = input.eventType || input.type || 'runtime.event';
+  const status = normalizeStatus(input.status || input.state);
+  const severity = normalizeSeverity(input.severity || input.level || (status === 'failure' ? 'error' : status));
+  const metadata = {
+    ...(input.metadata && typeof input.metadata === 'object' ? input.metadata : {}),
+    ...(input.payload && typeof input.payload === 'object' ? input.payload : {}),
+  };
+  const eventId = input.eventId || `evt_${hash(`${input.runId || 'run'}:${eventType}:${timestamp}`)}`;
+
+  return {
+    ...input,
+    eventId,
+    runId: input.runId || '',
+    projectId: input.projectId || '',
+    eventType,
+    stage: input.stage || input.state || 'unknown',
+    status,
+    severity,
+    message: input.message || input.summary || '',
+    timestamp,
+    metadata,
+
+    // 兼容旧版 Visual Collector。
+    type: input.type || eventType,
+    level: input.level || severity,
+    occurredAt: input.occurredAt || timestamp,
+  };
+}
+
+module.exports = {
+  normalizeRunEvent,
+  normalizeSeverity,
+  normalizeStatus,
+};

package/src/connectors/visual/visual-connector.js

@@ -1,77 +1,77 @@
-const { VisualClient } = require('../../visual/visual-client');
-const { normalizeEvidenceReport } = require('./evidence-report');
-const { normalizeRunEvent } = require('./run-event');
-const { VisualFailureQueue } = require('./queue');
-
-function skipped(message, code) {
-  return { ok: false, skipped: true, warning: message, code };
-}
-
-class VisualConnector {
-  constructor(options = {}) {
-    this.client = options.client || options.visualClient || new VisualClient(options);
-    this.queue = options.queue || new VisualFailureQueue(options);
-  }
-
-  async reportRunEvent(payload = {}, options = {}) {
-    return this.report('run-event', normalizeRunEvent(payload), options);
-  }
-
-  async reportEvidenceReport(payload = {}, options = {}) {
-    return this.report('evidence-report', normalizeEvidenceReport(payload), {
-      endpoint: '/api/collector/evidence-report',
-      ...options,
-    });
-  }
-
-  async report(type, payload = {}, options = {}) {
-    if (options.enabled === false) {
-      return skipped('Visual 上报开关已关闭，已跳过。', 'VISUAL_DISABLED');
-    }
-    const visualUrl = options.visualUrl || payload.visualUrl || '';
-    if (!visualUrl) {
-      return skipped('未配置 Visual URL，已跳过运行态上报。', 'VISUAL_URL_MISSING');
-    }
-    const endpoint = options.endpoint || '/api/collector/run-event';
-    let safePayload = payload;
-    try {
-      if (this.client.privacyFilter && typeof this.client.privacyFilter.filter === 'function') {
-        safePayload = this.client.privacyFilter.filter(payload);
-      }
-    } catch (error) {
-      return {
-        ok: false,
-        skipped: true,
-        queued: false,
-        warning: `Visual 上报因隐私策略被拦截：${error.message}`,
-        code: error.code || 'PRIVACY_POLICY_VIOLATED',
-      };
-    }
-    try {
-      const data = type === 'run-event'
-        ? await this.client.sendRunEvent(safePayload, { visualUrl })
-        : await this.client.post(endpoint, safePayload, { visualUrl });
-      return { ok: true, skipped: false, data, warning: null };
-    } catch (error) {
-      const queued = this.queue.enqueue({
-        type,
-        endpoint,
-        payload: safePayload,
-        reason: error.message,
-        code: error.code || 'VISUAL_REPORT_FAILED',
-      });
-      return {
-        ok: false,
-        skipped: true,
-        queued: true,
-        queueFile: queued.filePath,
-        warning: `Visual 上报失败，已写入失败队列：${error.message}`,
-        code: error.code || 'VISUAL_REPORT_FAILED',
-      };
-    }
-  }
-}
-
-module.exports = {
-  VisualConnector,
-};
+const { VisualClient } = require('../../visual/visual-client');
+const { normalizeEvidenceReport } = require('./evidence-report');
+const { normalizeRunEvent } = require('./run-event');
+const { VisualFailureQueue } = require('./queue');
+
+function skipped(message, code) {
+  return { ok: false, skipped: true, warning: message, code };
+}
+
+class VisualConnector {
+  constructor(options = {}) {
+    this.client = options.client || options.visualClient || new VisualClient(options);
+    this.queue = options.queue || new VisualFailureQueue(options);
+  }
+
+  async reportRunEvent(payload = {}, options = {}) {
+    return this.report('run-event', normalizeRunEvent(payload), options);
+  }
+
+  async reportEvidenceReport(payload = {}, options = {}) {
+    return this.report('evidence-report', normalizeEvidenceReport(payload), {
+      endpoint: '/api/collector/evidence-report',
+      ...options,
+    });
+  }
+
+  async report(type, payload = {}, options = {}) {
+    if (options.enabled === false) {
+      return skipped('Visual 上报开关已关闭，已跳过。', 'VISUAL_DISABLED');
+    }
+    const visualUrl = options.visualUrl || payload.visualUrl || '';
+    if (!visualUrl) {
+      return skipped('未配置 Visual URL，已跳过运行态上报。', 'VISUAL_URL_MISSING');
+    }
+    const endpoint = options.endpoint || '/api/collector/run-event';
+    let safePayload = payload;
+    try {
+      if (this.client.privacyFilter && typeof this.client.privacyFilter.filter === 'function') {
+        safePayload = this.client.privacyFilter.filter(payload);
+      }
+    } catch (error) {
+      return {
+        ok: false,
+        skipped: true,
+        queued: false,
+        warning: `Visual 上报因隐私策略被拦截：${error.message}`,
+        code: error.code || 'PRIVACY_POLICY_VIOLATED',
+      };
+    }
+    try {
+      const data = type === 'run-event'
+        ? await this.client.sendRunEvent(safePayload, { visualUrl })
+        : await this.client.post(endpoint, safePayload, { visualUrl });
+      return { ok: true, skipped: false, data, warning: null };
+    } catch (error) {
+      const queued = this.queue.enqueue({
+        type,
+        endpoint,
+        payload: safePayload,
+        reason: error.message,
+        code: error.code || 'VISUAL_REPORT_FAILED',
+      });
+      return {
+        ok: false,
+        skipped: true,
+        queued: true,
+        queueFile: queued.filePath,
+        warning: `Visual 上报失败，已写入失败队列：${error.message}`,
+        code: error.code || 'VISUAL_REPORT_FAILED',
+      };
+    }
+  }
+}
+
+module.exports = {
+  VisualConnector,
+};

package/src/context/context-budget.js

@@ -1,59 +1,59 @@
-const { createIssue, normalizeTokenBudget } = require('./types');
-
-class ContextBudget {
-  constructor(tokenBudget = {}) {
-    this.tokenBudget = normalizeTokenBudget(tokenBudget);
-  }
-
-  estimateTextTokens(text) {
-    if (!text) return 0;
-    return Math.ceil(String(text).length / 4);
-  }
-
-  evaluate(loadedAssets = [], tokenBudget = this.tokenBudget) {
-    const normalizedBudget = normalizeTokenBudget(tokenBudget);
-    const warnings = [];
-    const errors = [];
-    let inputTokens = 0;
-
-    for (const asset of loadedAssets) {
-      const tokenEstimate = Number.isFinite(asset.tokenEstimate)
-        ? asset.tokenEstimate
-        : this.estimateTextTokens(asset.content || '');
-      asset.tokenEstimate = tokenEstimate;
-      inputTokens += tokenEstimate;
-    }
-
-    if (inputTokens > normalizedBudget.warningThreshold) {
-      warnings.push(createIssue(
-        'warning',
-        'CONTEXT_TOKEN_WARNING_THRESHOLD_EXCEEDED',
-        `Context token 估算 ${inputTokens} 已超过 warningThreshold ${normalizedBudget.warningThreshold}`,
-        '请减少阶段资产数量或下调加载规则',
-      ));
-    }
-
-    if (inputTokens > normalizedBudget.maxInputTokens) {
-      errors.push(createIssue(
-        'error',
-        'CONTEXT_TOKEN_BUDGET_EXCEEDED',
-        `Context token 估算 ${inputTokens} 已超过 maxInputTokens ${normalizedBudget.maxInputTokens}`,
-        '请减少加载资产或提高预算上限',
-      ));
-    }
-
-    return {
-      tokenEstimate: {
-        inputTokens,
-        maxInputTokens: normalizedBudget.maxInputTokens,
-        warning: inputTokens > normalizedBudget.warningThreshold,
-      },
-      warnings,
-      errors,
-    };
-  }
-}
-
-module.exports = {
-  ContextBudget,
-};
+const { createIssue, normalizeTokenBudget } = require('./types');
+
+class ContextBudget {
+  constructor(tokenBudget = {}) {
+    this.tokenBudget = normalizeTokenBudget(tokenBudget);
+  }
+
+  estimateTextTokens(text) {
+    if (!text) return 0;
+    return Math.ceil(String(text).length / 4);
+  }
+
+  evaluate(loadedAssets = [], tokenBudget = this.tokenBudget) {
+    const normalizedBudget = normalizeTokenBudget(tokenBudget);
+    const warnings = [];
+    const errors = [];
+    let inputTokens = 0;
+
+    for (const asset of loadedAssets) {
+      const tokenEstimate = Number.isFinite(asset.tokenEstimate)
+        ? asset.tokenEstimate
+        : this.estimateTextTokens(asset.content || '');
+      asset.tokenEstimate = tokenEstimate;
+      inputTokens += tokenEstimate;
+    }
+
+    if (inputTokens > normalizedBudget.warningThreshold) {
+      warnings.push(createIssue(
+        'warning',
+        'CONTEXT_TOKEN_WARNING_THRESHOLD_EXCEEDED',
+        `Context token 估算 ${inputTokens} 已超过 warningThreshold ${normalizedBudget.warningThreshold}`,
+        '请减少阶段资产数量或下调加载规则',
+      ));
+    }
+
+    if (inputTokens > normalizedBudget.maxInputTokens) {
+      errors.push(createIssue(
+        'error',
+        'CONTEXT_TOKEN_BUDGET_EXCEEDED',
+        `Context token 估算 ${inputTokens} 已超过 maxInputTokens ${normalizedBudget.maxInputTokens}`,
+        '请减少加载资产或提高预算上限',
+      ));
+    }
+
+    return {
+      tokenEstimate: {
+        inputTokens,
+        maxInputTokens: normalizedBudget.maxInputTokens,
+        warning: inputTokens > normalizedBudget.warningThreshold,
+      },
+      warnings,
+      errors,
+    };
+  }
+}
+
+module.exports = {
+  ContextBudget,
+};