gx-code-agent 0.0.0-stage → 0.1.1

package/src/application/scanCommand.js

@@ -0,0 +1,71 @@
+import path from "node:path";
+
+import { McpHttpClient } from "../adapters/platform/mcpClient.js";
+import { readJson, writeJson } from "../store/localStore.js";
+import { scanWorkflow } from "./scanWorkflow.js";
+
+/**
+ * 执行 gx scan，并在配置允许时上报 record_ext_points。
+ *
+ * @param {Record<string, unknown>} args
+ * @param {{ stdout: NodeJS.WriteStream, stderr: NodeJS.WriteStream }} io
+ * @returns {Promise<Record<string, unknown>>}
+ */
+export async function runScan(args, io = { stdout: process.stdout, stderr: process.stderr }) {
+  const dir = path.resolve(String(args.dir || process.cwd()));
+  const sourceDirs = typeof args["source-dir"] === "string"
+    ? args["source-dir"].split(",").map((item) => item.trim()).filter(Boolean)
+    : undefined;
+  const result = scanWorkflow({ dir, sourceDirs, compile: Boolean(args.compile), classpath: typeof args.classpath === "string" ? args.classpath : undefined });
+  const config = readJson(path.join(dir, ".gx", "config.json"), {});
+  const planId = String(args.plan || config.planId || "");
+  const url = String(args.url || config.mcpUrl || "http://127.0.0.1:4013/mcp");
+  const token = String(args.token || process.env.GX_API_TOKEN || "");
+  const explicitReport = Boolean(args.report);
+  const autoReport = !args["no-report"] && Boolean(planId && token);
+  const shouldReport = explicitReport || autoReport;
+
+  if (explicitReport && (!planId || !token)) {
+    throw new Error("gx scan --report 需要 planId（--plan 或 .gx/config.json）与 API Token");
+  }
+  if (!shouldReport) {
+    result.report = {
+      status: "skipped",
+      reason: !planId ? "未配置 planId" : !token ? "缺少 API Token" : "使用 --no-report 跳过"
+    };
+    io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return result;
+  }
+
+  const client = new McpHttpClient({ url, token });
+  try {
+    const report = await client.callTool("record_ext_points", {
+      planId,
+      methods: result.extPoints,
+      replace: true
+    });
+    result.report = { status: "reported", planId, ...report };
+    writeJson(path.join(dir, ".gx", "ext-points.json"), {
+      planId,
+      reportedAt: new Date().toISOString(),
+      extPoints: result.extPoints,
+      unannotatedMethods: result.unannotatedMethods,
+      report
+    });
+    io.stdout.write(`已上报 ${report.accepted?.length ?? 0} 个扩展点，拒绝 ${report.rejected?.length ?? 0} 个\n`);
+    for (const rejected of report.rejected ?? []) {
+      io.stderr.write(`[warn] ${rejected.method?.class}#${rejected.method?.method}: ${rejected.reason}\n`);
+    }
+  } catch (error) {
+    result.report = { status: "failed", reason: error instanceof Error ? error.message : String(error) };
+    if (explicitReport) {
+      throw error;
+    }
+    io.stderr.write(`[warn] record_ext_points 上报失败：${result.report.reason}\n`);
+  } finally {
+    await client.close();
+  }
+
+  io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  return result;
+}