@gong-ym/ai-spec-auto 0.2.3

package/src/hook/hook-config-writer.js

@@ -0,0 +1,125 @@
+const fs = require('fs');
+const path = require('path');
+const { writeJson } = require('../run/run-store');
+
+const HOOK_TYPES = ['pre-task', 'pre-edit', 'post-edit', 'pre-test', 'post-test', 'repair-hook', 'archive-hook'];
+
+const FAILURE_POLICIES = ['block', 'warn', 'ignore', 'escalate'];
+
+function buildDefaultHooks(projectId) {
+  return [
+    {
+      hookId: 'pre-task',
+      hookType: 'pre-task',
+      enabled: true,
+      blocking: true,
+      command: 'ai-spec-auto check .',
+      timeout: 60,
+      retry: 0,
+      failurePolicy: 'block',
+      outputTarget: `~/.ai-spec-auto/projects/${projectId}/runs/{runId}/events.ndjson`,
+    },
+    {
+      hookId: 'pre-edit',
+      hookType: 'pre-edit',
+      enabled: true,
+      blocking: false,
+      command: 'echo "pre-edit: 准备编辑代码"',
+      timeout: 30,
+      retry: 0,
+      failurePolicy: 'warn',
+      outputTarget: `~/.ai-spec-auto/projects/${projectId}/runs/{runId}/events.ndjson`,
+    },
+    {
+      hookId: 'post-edit',
+      hookType: 'post-edit',
+      enabled: true,
+      blocking: false,
+      command: 'echo "post-edit: 编辑完成"',
+      timeout: 30,
+      retry: 0,
+      failurePolicy: 'warn',
+      outputTarget: `~/.ai-spec-auto/projects/${projectId}/runs/{runId}/events.ndjson`,
+    },
+    {
+      hookId: 'pre-test',
+      hookType: 'pre-test',
+      enabled: true,
+      blocking: false,
+      command: 'echo "pre-test: 准备执行测试"',
+      timeout: 30,
+      retry: 0,
+      failurePolicy: 'warn',
+      outputTarget: `~/.ai-spec-auto/projects/${projectId}/runs/{runId}/events.ndjson`,
+    },
+    {
+      hookId: 'post-test',
+      hookType: 'post-test',
+      enabled: true,
+      blocking: true,
+      command: 'ai-spec-auto check .',
+      timeout: 120,
+      retry: 0,
+      failurePolicy: 'block',
+      outputTarget: `~/.ai-spec-auto/projects/${projectId}/runs/{runId}/events.ndjson`,
+    },
+    {
+      hookId: 'repair-hook',
+      hookType: 'repair-hook',
+      enabled: true,
+      blocking: true,
+      command: 'ai-spec-auto check .',
+      timeout: 120,
+      retry: 1,
+      failurePolicy: 'block',
+      outputTarget: `~/.ai-spec-auto/projects/${projectId}/runs/{runId}/events.ndjson`,
+    },
+    {
+      hookId: 'archive-hook',
+      hookType: 'archive-hook',
+      enabled: true,
+      blocking: false,
+      command: 'echo "archive-hook: 准备归档"',
+      timeout: 30,
+      retry: 0,
+      failurePolicy: 'warn',
+      outputTarget: `~/.ai-spec-auto/projects/${projectId}/runs/{runId}/events.ndjson`,
+    },
+  ];
+}
+
+class HookConfigWriter {
+  /**
+   * 生成 .harness/hooks.config.json
+   * @param {string} rootDir
+   * @param {object} context
+   * @param {string} context.projectId
+   * @returns {{ path: string, action: string, data: object }}
+   */
+  write(rootDir, context = {}) {
+    const filePath = path.join(rootDir, '.harness', 'hooks.config.json');
+    const existing = fs.existsSync(filePath) ? JSON.parse(fs.readFileSync(filePath, 'utf8')) : null;
+
+    const doc = {
+      schemaVersion: '1.0.0',
+      projectId: context.projectId || '',
+      maxRepairAttempts: 2,
+      hooks: buildDefaultHooks(context.projectId || ''),
+      generatedAt: new Date().toISOString(),
+    };
+
+    writeJson(filePath, doc);
+    return {
+      path: '.harness/hooks.config.json',
+      fullPath: filePath,
+      action: existing ? 'update' : 'create',
+      data: doc,
+    };
+  }
+}
+
+module.exports = {
+  HookConfigWriter,
+  HOOK_TYPES,
+  FAILURE_POLICIES,
+};

package/src/hub/hub-client.js

@@ -0,0 +1,186 @@
+const fs = require('fs');
+const path = require('path');
+const { URL } = require('url');
+
+function readFileUrl(contentUrl) {
+  const url = new URL(contentUrl);
+  return fs.readFileSync(url, 'utf8');
+}
+
+function joinHubUrl(hubUrl, endpoint) {
+  if (!hubUrl) return endpoint;
+  if (/^https?:\/\//i.test(endpoint)) return endpoint;
+  return `${String(hubUrl).replace(/\/+$/, '')}/${String(endpoint).replace(/^\/+/, '')}`;
+}
+
+class HubClientError extends Error {
+  constructor(code, message, suggestion, details = {}) {
+    super(message);
+    this.name = 'HubClientError';
+    this.code = code;
+    this.suggestion = suggestion || '';
+    this.details = details;
+  }
+}
+
+function assertNoAbsolutePath(value, fieldPath = '') {
+  if (Array.isArray(value)) {
+    value.forEach((item, index) => assertNoAbsolutePath(item, `${fieldPath}[${index}]`));
+    return;
+  }
+  if (!value || typeof value !== 'object') {
+    if (typeof value === 'string' && (path.isAbsolute(value) || /^[A-Za-z]:[\\/]/.test(value))) {
+      throw new HubClientError('PRIVACY_VIOLATION', `Hub payload 不允许包含绝对路径：${fieldPath}`, '请只上传相对路径或结构化摘要。');
+    }
+    return;
+  }
+  for (const [key, child] of Object.entries(value)) {
+    if (['sourceCode', 'fileContent', 'rawPrompt', 'rawResponse'].includes(key)) {
+      throw new HubClientError('PRIVACY_VIOLATION', `Hub payload 不允许包含 ${key}`, '请移除源码、文件正文、rawPrompt 或 rawResponse。');
+    }
+    assertNoAbsolutePath(child, fieldPath ? `${fieldPath}.${key}` : key);
+  }
+}
+
+async function parseHubResponse(response) {
+  let body;
+  try {
+    body = await response.json();
+  } catch (error) {
+    throw new HubClientError('HUB_RESPONSE_INVALID', 'Hub 返回不是合法 JSON', '请检查 Hub API 响应格式。', { error: error.message });
+  }
+  if (!response.ok) {
+    const hubError = body?.error || {};
+    throw new HubClientError(
+      hubError.code || `HTTP_${response.status}`,
+      hubError.message || `Hub 请求失败：HTTP ${response.status}`,
+      hubError.suggestion || '请检查 Hub 服务状态。',
+      { status: response.status },
+    );
+  }
+  if (body && body.success === false) {
+    const hubError = body.error || {};
+    throw new HubClientError(
+      hubError.code || 'HUB_ERROR',
+      hubError.message || 'Hub API 返回失败',
+      hubError.suggestion || '请检查 Hub 返回错误。',
+    );
+  }
+  if (body && Object.prototype.hasOwnProperty.call(body, 'success')) {
+    return body.data;
+  }
+  return body;
+}
+
+async function requestJson(url, options = {}) {
+  try {
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        'content-type': 'application/json',
+        ...(options.headers || {}),
+      },
+    });
+    return await parseHubResponse(response);
+  } catch (error) {
+    if (error instanceof HubClientError) throw error;
+    throw new HubClientError('HUB_NETWORK_ERROR', `Hub 网络请求失败：${error.message}`, '请检查 Hub URL、网络或服务是否启动。');
+  }
+}
+
+class HubClient {
+  constructor(options = {}) {
+    this.hubUrl = options.hubUrl || '';
+  }
+
+  resolveHubUrl(inputHubUrl) {
+    return String(inputHubUrl || this.hubUrl || '').replace(/\/+$/, '');
+  }
+
+  async recommendManifests(input = {}) {
+    const hubUrl = this.resolveHubUrl(input.hubUrl);
+    if (!hubUrl) {
+      throw new HubClientError('HUB_URL_MISSING', '未配置 Hub URL，无法请求 Manifest 推荐', '请传入 --hub-url 或配置 AI_SPEC_HUB_URL。');
+    }
+    const payload = {
+      workspace: input.workspace || {},
+      projectFacts: Array.isArray(input.projectFacts) ? input.projectFacts : [],
+    };
+    assertNoAbsolutePath(payload);
+    return requestJson(joinHubUrl(hubUrl, '/api/hub/manifests/recommend'), {
+      method: 'POST',
+      body: JSON.stringify(payload),
+    });
+  }
+
+  async getManifestExport({ slug, version, hubUrl }) {
+    if (hubUrl && hubUrl.startsWith('file://')) {
+      return JSON.parse(readFileUrl(hubUrl));
+    }
+    const baseUrl = this.resolveHubUrl(hubUrl);
+    if (!baseUrl) {
+      throw new HubClientError('HUB_URL_MISSING', '未配置 Hub URL，无法获取 Manifest Export', '请传入 --hub-url 或配置 policy.hub.url。');
+    }
+    const query = version ? `?version=${encodeURIComponent(version)}` : '';
+    return requestJson(joinHubUrl(baseUrl, `/api/hub/manifests/${encodeURIComponent(slug)}/export${query}`));
+  }
+
+  async getAssetContent({ slug, version, contentUrl, hubUrl }) {
+    if (contentUrl && contentUrl.startsWith('file://')) {
+      return readFileUrl(contentUrl);
+    }
+    const baseUrl = this.resolveHubUrl(hubUrl);
+    if (!baseUrl) {
+      throw new HubClientError('HUB_URL_MISSING', '未配置 Hub URL，无法获取资产内容', '请传入 --hub-url 或配置 policy.hub.url。');
+    }
+    const endpoint = contentUrl || `/api/hub/assets/${encodeURIComponent(slug)}/content?version=${encodeURIComponent(version || '1.0.0')}`;
+    const data = await requestJson(joinHubUrl(baseUrl, endpoint));
+    if (data && typeof data === 'object' && Object.prototype.hasOwnProperty.call(data, 'content')) {
+      return data.content;
+    }
+    return data;
+  }
+
+  async getAgentProfileExport({ slug, version, contentUrl, hubUrl }) {
+    if (contentUrl && contentUrl.startsWith('file://')) {
+      return JSON.parse(readFileUrl(contentUrl));
+    }
+    const baseUrl = this.resolveHubUrl(hubUrl);
+    if (!baseUrl) {
+      throw new HubClientError('HUB_URL_MISSING', '未配置 Hub URL，无法获取 Agent Profile', '请传入 --hub-url 或配置 policy.hub.url。');
+    }
+    const endpoint = contentUrl || `/api/hub/agent-profiles/${encodeURIComponent(slug)}/export?version=${encodeURIComponent(version || '1.0.0')}`;
+    return requestJson(joinHubUrl(baseUrl, endpoint));
+  }
+
+  async createInstallRecord(payload = {}, options = {}) {
+    const hubUrl = this.resolveHubUrl(options.hubUrl || payload.hubUrl);
+    if (!hubUrl) {
+      throw new HubClientError('HUB_URL_MISSING', '未配置 Hub URL，无法上报安装记录', '请传入 --hub-url 或配置 policy.hub.url。');
+    }
+    assertNoAbsolutePath(payload);
+    return requestJson(joinHubUrl(hubUrl, '/api/hub/install-records'), {
+      method: 'POST',
+      body: JSON.stringify(payload),
+    });
+  }
+
+  async sendRuntimeFeedback(payload = {}, options = {}) {
+    const hubUrl = this.resolveHubUrl(options.hubUrl || payload.hubUrl);
+    if (!hubUrl) {
+      throw new HubClientError('HUB_URL_MISSING', '未配置 Hub URL，无法上报运行反馈', '请传入 --hub-url 或配置 policy.hub.url。');
+    }
+    assertNoAbsolutePath(payload);
+    return requestJson(joinHubUrl(hubUrl, '/api/hub/runtime-feedback'), {
+      method: 'POST',
+      body: JSON.stringify(payload),
+    });
+  }
+}
+
+module.exports = {
+  HubClient,
+  HubClientError,
+  assertNoAbsolutePath,
+  joinHubUrl,
+};

package/src/hub/hub-config.js

@@ -0,0 +1,39 @@
+const { readProjectState } = require('../project/project-files');
+
+function normalizeHubUrl(value) {
+  const text = String(value || '').trim();
+  if (!text) return '';
+  return text.replace(/\/+$/, '');
+}
+
+function resolveHubConfig(rootDir, options = {}) {
+  const state = rootDir ? readProjectState(rootDir) : {};
+  const policyHub = state.policy?.hub || {};
+  const source = options.hubUrl ? 'cli' : policyHub.url ? 'policy' : process.env.AI_SPEC_HUB_URL ? 'env' : 'empty';
+  const hubUrl = normalizeHubUrl(
+    options.hubUrl ||
+      policyHub.url ||
+      process.env.AI_SPEC_HUB_URL ||
+      '',
+  );
+  const enabled = options.hubEnabled !== undefined
+    ? Boolean(options.hubEnabled)
+    : source === 'cli' || source === 'env'
+      ? Boolean(hubUrl)
+      : source === 'policy'
+        ? policyHub.enabled !== false
+        : false;
+  return {
+    enabled,
+    url: hubUrl,
+    fallbackToLocal: options.fallbackToLocal !== undefined
+      ? Boolean(options.fallbackToLocal)
+      : policyHub.fallbackToLocal !== false,
+    source,
+  };
+}
+
+module.exports = {
+  normalizeHubUrl,
+  resolveHubConfig,
+};

package/src/hub/project-facts.js

@@ -0,0 +1,31 @@
+function toProjectFacts(scanResult) {
+  return (scanResult.packages || []).map((pkg) => ({
+    packageId: pkg.packageId,
+    path: pkg.path,
+    projectKind: pkg.projectKind,
+    primary: pkg.primary ? {
+      domain: (pkg.primary.tags || []).includes('backend') ? 'backend' : (pkg.primary.tags || []).includes('frontend') ? 'frontend' : 'unknown',
+      language: pkg.primary.language || [],
+      frameworks: [pkg.primary.framework].filter(Boolean),
+      confidence: pkg.primary.confidence || 0,
+      manifestSlug: pkg.primary.manifestSlug || '',
+      tags: pkg.primary.tags || [],
+    } : null,
+    candidates: pkg.candidates || [],
+  }));
+}
+
+function toHubWorkspace(scanResult) {
+  const workspace = scanResult.workspace || {};
+  return {
+    rootDir: '.',
+    type: workspace.type || 'single-project',
+    packageManager: workspace.packageManager || null,
+    rootDependencies: workspace.rootDependencies || {},
+  };
+}
+
+module.exports = {
+  toProjectFacts,
+  toHubWorkspace,
+};

package/src/hub/runtime-feedback-reporter.js

@@ -0,0 +1,55 @@
+const { HubClient } = require('./hub-client');
+const { resolveHubConfig } = require('./hub-config');
+const { readProjectState } = require('../project/project-files');
+
+class RuntimeFeedbackReporter {
+  constructor(options = {}) {
+    this.hubClient = options.hubClient || new HubClient();
+  }
+
+  async report(rootDir, run, executorResult = {}, options = {}) {
+    const hubConfig = resolveHubConfig(rootDir, options);
+    if (!hubConfig.url || hubConfig.enabled === false) {
+      return {
+        ok: false,
+        skipped: true,
+        warning: '未配置 Hub URL，已跳过 Runtime Feedback 上报',
+      };
+    }
+    const state = readProjectState(rootDir);
+    const payload = {
+      projectId: state.project?.projectId || state.lock?.projectId || '',
+      runId: run.runId || '',
+      manifest: {
+        slug: state.project?.manifest?.slug || state.lock?.manifest?.slug || '',
+        version: state.project?.manifest?.version || state.lock?.manifest?.version || '1.0.0',
+      },
+      assetsUsed: [],
+      executor: executorResult.selection?.executor || run.executor?.type || '',
+      result: {
+        status: executorResult.status || 'unknown',
+        success: executorResult.success === true,
+        durationMs: 0,
+      },
+      issues: (executorResult.riskList || []).map((item) => ({
+        code: item.code || item.level || 'RISK',
+        message: item.message || item.summary || String(item),
+      })),
+    };
+    try {
+      const data = await this.hubClient.sendRuntimeFeedback(payload, { hubUrl: hubConfig.url });
+      return { ok: true, skipped: false, data, warning: null };
+    } catch (error) {
+      return {
+        ok: false,
+        skipped: true,
+        warning: `Runtime Feedback 上报失败，已忽略：${error.message}`,
+        code: error.code || 'RUNTIME_FEEDBACK_FAILED',
+      };
+    }
+  }
+}
+
+module.exports = {
+  RuntimeFeedbackReporter,
+};