ai-project-manage-cli 8.0.5 → 8.0.8

package/dist/index.js

@@ -154,6 +154,14 @@ var init_request_config = __esm({
           method: "PUT",
           path: "/cli/webide/test-cases"
         }),
+        webideUpsertSqlExecution: defineEndpoint({
+          method: "PUT",
+          path: "/cli/webide/sql-executions"
+        }),
+        webideFinalizeSqlExecution: defineEndpoint({
+          method: "PUT",
+          path: "/cli/webide/sql-executions/finalize"
+        }),
         projectBaseBranch: defineEndpoint(
           {
             method: "GET",
@@ -1858,7 +1866,7 @@ function buildProgram() {
   ).version(readCliVersion(), "-V, --version", "\u663E\u793A\u7248\u672C\u53F7").helpOption("-h, --help", "\u663E\u793A\u5E2E\u52A9").showHelpAfterError(true);
   program.command("login").description(
     "\u9A8C\u8BC1 API Key \u5E76\u5199\u5165 ~/.config/apm/config.json\uFF08GET /api/v1/cli/me\uFF09"
-  ).option("--api-key <key>", "\u5BA2\u6237\u673A API Key\uFF08cm_ \u5F00\u5934\uFF09").option("--server <url>", "API \u6839\u5730\u5740\uFF0C\u4F8B\u5982 http://127.0.0.1:3000").action(async (opts) => {
+  ).option("--api-key <key>", "\u8FDC\u7A0B\u4E3B\u673A API Key\uFF08cm_ \u5F00\u5934\uFF09").option("--server <url>", "API \u6839\u5730\u5740\uFF0C\u4F8B\u5982 http://127.0.0.1:3000").action(async (opts) => {
     await runLogin(opts);
   });
   program.command("init").description("\u5728\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u6309 WebIDE \u5DE5\u4F5C\u533A\u521D\u59CB\u5316\uFF1A\u5199\u5165\u6307\u5357\u4E0E webide \u89C4\u5219").action(async () => {

package/dist/webide-message-worker.js

@@ -58,6 +58,14 @@ var requestConfig = {
       method: "PUT",
       path: "/cli/webide/test-cases"
     }),
+    webideUpsertSqlExecution: defineEndpoint({
+      method: "PUT",
+      path: "/cli/webide/sql-executions"
+    }),
+    webideFinalizeSqlExecution: defineEndpoint({
+      method: "PUT",
+      path: "/cli/webide/sql-executions/finalize"
+    }),
     projectBaseBranch: defineEndpoint(
       {
         method: "GET",
@@ -1515,6 +1523,286 @@ function createUpsertWebIdeTestCasesTool(options) {
   };
 }
 
+// src/commands/connect/tools/mysql-tools.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3, statSync as statSync3 } from "node:fs";
+import { isAbsolute, relative as relative2, resolve as resolve4 } from "node:path";
+import mysql from "mysql2/promise";
+var MAX_RESULT_ROWS = 100;
+var EXEC_TIMEOUT_MS = 6e4;
+var MAX_SQL_FILE_BYTES = 2 * 1024 * 1024;
+function asString3(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function asNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim()) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return void 0;
+}
+function isResultSetHeader(value) {
+  return typeof value === "object" && value !== null && "affectedRows" in value && !Array.isArray(value);
+}
+function formatOkPacket(packet) {
+  return {
+    kind: "update",
+    affectedRows: packet.affectedRows ?? 0,
+    insertId: packet.insertId ?? 0,
+    changedRows: packet.changedRows,
+    warnings: packet.warningStatus
+  };
+}
+function formatSelectRows(rows) {
+  const truncated = rows.slice(0, MAX_RESULT_ROWS);
+  return {
+    kind: "select",
+    rowCount: rows.length,
+    truncated: rows.length > MAX_RESULT_ROWS,
+    rows: truncated
+  };
+}
+function formatStatementResult(result) {
+  if (Array.isArray(result)) {
+    return formatSelectRows(result);
+  }
+  if (isResultSetHeader(result)) {
+    return formatOkPacket(result);
+  }
+  return { kind: "unknown", value: result };
+}
+function normalizeMultiStatementResults(raw) {
+  if (!Array.isArray(raw)) {
+    return [formatStatementResult(raw)];
+  }
+  if (raw.length === 0) {
+    return [];
+  }
+  const first = raw[0];
+  if (Array.isArray(first)) {
+    return raw.map((item) => {
+      if (Array.isArray(item)) {
+        return formatStatementResult(item[0]);
+      }
+      return formatStatementResult(item);
+    });
+  }
+  if (isResultSetHeader(first)) {
+    return raw.map((item) => formatStatementResult(item));
+  }
+  return [formatStatementResult(raw)];
+}
+function resolveSqlArtifactPath(workdir, absolutePath) {
+  if (!isAbsolute(absolutePath)) {
+    return { ok: false, error: "path \u5FC5\u987B\u662F\u7EDD\u5BF9\u8DEF\u5F84" };
+  }
+  const workdirAbs = resolve4(toFsPath(workdir));
+  const targetAbs = resolve4(toFsPath(absolutePath));
+  const rel = relative2(workdirAbs, targetAbs);
+  if (!rel || rel.startsWith("..") || isAbsolute(rel)) {
+    return { ok: false, error: "path \u5FC5\u987B\u4F4D\u4E8E\u5F53\u524D\u5DE5\u4F5C\u533A\u5185" };
+  }
+  const fsPath = toFsPath(targetAbs);
+  if (!existsSync3(fsPath)) {
+    return { ok: false, error: `\u6587\u4EF6\u4E0D\u5B58\u5728: ${absolutePath}` };
+  }
+  let st;
+  try {
+    st = statSync3(fsPath);
+  } catch {
+    return { ok: false, error: `\u65E0\u6CD5\u8BFB\u53D6\u6587\u4EF6: ${absolutePath}` };
+  }
+  if (!st.isFile()) {
+    return { ok: false, error: "path \u5FC5\u987B\u6307\u5411\u666E\u901A\u6587\u4EF6" };
+  }
+  if (st.size > MAX_SQL_FILE_BYTES) {
+    return {
+      ok: false,
+      error: `SQL \u6587\u4EF6\u8FC7\u5927\uFF08>${MAX_SQL_FILE_BYTES} bytes\uFF09`
+    };
+  }
+  const displayPath = normalizeWorkdirPath(rel) || normalizeWorkdirPath(absolutePath);
+  return { ok: true, absPath: targetAbs, displayPath };
+}
+function readSqlFile(absPath) {
+  return readFileSync3(toFsPath(absPath), "utf8");
+}
+function createMysqlExecuteTool(options) {
+  const { taskId, executionId, workdir, upsertSqlExecution } = options;
+  return {
+    MysqlExecute: {
+      description: "Execute SQL from a workspace artifact file against MySQL. Pass the absolute filesystem path of the SQL file (not the SQL text). The CLI reads the file itself to avoid escaping issues with multi-statement scripts.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          host: { type: "string", description: "MySQL host" },
+          port: { type: "number", description: "MySQL port, default 3306" },
+          user: { type: "string", description: "MySQL username" },
+          password: { type: "string", description: "MySQL password" },
+          database: { type: "string", description: "Database name" },
+          path: {
+            type: "string",
+            description: "Absolute filesystem path to the SQL artifact file under the current workspace (CLI reads the file; do not pass SQL text)"
+          }
+        },
+        required: ["host", "user", "password", "database", "path"]
+      },
+      execute: async (args) => {
+        const host = asString3(args.host);
+        const user = asString3(args.user);
+        const password = asString3(args.password);
+        const database = asString3(args.database);
+        const pathArg = asString3(args.path);
+        const port = asNumber(args.port) ?? 3306;
+        if (!host || !user || !database || !pathArg) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "host / user / database / path \u5747\u4E0D\u80FD\u4E3A\u7A7A"
+              }
+            ],
+            isError: true
+          };
+        }
+        const resolved = resolveSqlArtifactPath(workdir, pathArg);
+        if (!resolved.ok) {
+          try {
+            await upsertSqlExecution({
+              executionId,
+              taskId,
+              status: "FAILED",
+              artifactPath: pathArg,
+              error: resolved.error,
+              host,
+              port,
+              database,
+              dbUser: user
+            });
+          } catch {
+          }
+          return {
+            content: [{ type: "text", text: resolved.error }],
+            isError: true
+          };
+        }
+        let sql;
+        try {
+          sql = readSqlFile(resolved.absPath).trim();
+        } catch (err) {
+          const detail = err instanceof Error ? err.message : String(err);
+          try {
+            await upsertSqlExecution({
+              executionId,
+              taskId,
+              status: "FAILED",
+              artifactPath: resolved.displayPath,
+              error: `\u8BFB\u53D6 SQL \u6587\u4EF6\u5931\u8D25: ${detail}`,
+              host,
+              port,
+              database,
+              dbUser: user
+            });
+          } catch {
+          }
+          return {
+            content: [
+              {
+                type: "text",
+                text: `\u8BFB\u53D6 SQL \u6587\u4EF6\u5931\u8D25: ${detail}`
+              }
+            ],
+            isError: true
+          };
+        }
+        if (!sql) {
+          try {
+            await upsertSqlExecution({
+              executionId,
+              taskId,
+              status: "FAILED",
+              artifactPath: resolved.displayPath,
+              sql: "",
+              error: "SQL \u6587\u4EF6\u4E3A\u7A7A",
+              host,
+              port,
+              database,
+              dbUser: user
+            });
+          } catch {
+          }
+          return {
+            content: [{ type: "text", text: "SQL \u6587\u4EF6\u4E3A\u7A7A" }],
+            isError: true
+          };
+        }
+        let connection;
+        try {
+          connection = await mysql.createConnection({
+            host,
+            port,
+            user,
+            password,
+            database,
+            multipleStatements: true,
+            connectTimeout: 15e3
+          });
+          const [rawResults] = await connection.query({
+            sql,
+            timeout: EXEC_TIMEOUT_MS
+          });
+          const statements = normalizeMultiStatementResults(rawResults);
+          const resultPayload = {
+            ok: true,
+            path: resolved.displayPath,
+            statements,
+            host,
+            port,
+            database,
+            dbUser: user
+          };
+          await upsertSqlExecution({
+            executionId,
+            taskId,
+            status: "SUCCESS",
+            artifactPath: resolved.displayPath,
+            sql,
+            result: resultPayload,
+            host,
+            port,
+            database,
+            dbUser: user
+          });
+          return JSON.stringify(resultPayload, null, 2);
+        } catch (err) {
+          const detail = err instanceof Error ? err.message : String(err);
+          try {
+            await upsertSqlExecution({
+              executionId,
+              taskId,
+              status: "FAILED",
+              artifactPath: resolved.displayPath,
+              sql,
+              error: detail,
+              host: host || void 0,
+              port,
+              database: database || void 0,
+              dbUser: user || void 0
+            });
+          } catch {
+          }
+          return {
+            content: [{ type: "text", text: `MySQL \u6267\u884C\u5931\u8D25: ${detail}` }],
+            isError: true
+          };
+        } finally {
+          await connection?.end().catch(() => void 0);
+        }
+      }
+    }
+  };
+}
+
 // src/commands/connect/tools/index.ts
 var PLAN_MODE_ASK_QUESTION_HINT = `[SDK \u73AF\u5883\u8BF4\u660E]
 AskQuestion \u5DF2\u901A\u8FC7 MCP \u670D\u52A1\u5668 custom-user-tools \u6CE8\u518C\uFF0C\u5DE5\u5177\u540D\u4E3A AskQuestion\u3002
@@ -1553,6 +1841,17 @@ function createCursorCustomTools(cfg, options) {
         })
       );
     }
+    if (options.enableMysqlTools && options.sqlExecutionId && options.workdir) {
+      Object.assign(
+        tools,
+        createMysqlExecuteTool({
+          taskId,
+          executionId: options.sqlExecutionId,
+          workdir: options.workdir,
+          upsertSqlExecution: (args) => cli.webideUpsertSqlExecution(args)
+        })
+      );
+    }
   }
   return tools;
 }
@@ -1671,6 +1970,8 @@ async function runCursorAgent(cfg, ctx, options) {
     enableAskQuestion: options.enableAskQuestion,
     askQuestionExecute: options.askQuestionExecute,
     enableWebIdePlanTools: options.enableWebIdePlanTools,
+    enableMysqlTools: options.enableMysqlTools,
+    sqlExecutionId: options.sqlExecutionId,
     taskId: options.taskId,
     workdir
   });
@@ -1805,17 +2106,17 @@ async function runCursorAgent(cfg, ctx, options) {
 }
 
 // src/commands/connect/webide-agent-registry.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname3, resolve as resolve4 } from "node:path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { dirname as dirname3, resolve as resolve5 } from "node:path";
 function registryPath(workdir, taskId) {
-  return resolve4(workdir, ".apm", "webide", taskId, "cursor-agent.json");
+  return resolve5(workdir, ".apm", "webide", taskId, "cursor-agent.json");
 }
 function readRegistry(path) {
-  if (!existsSync3(path)) {
+  if (!existsSync4(path)) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync3(path, "utf8"));
+    const parsed = JSON.parse(readFileSync4(path, "utf8"));
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
       const raw = parsed;
       const state = {};
@@ -1886,20 +2187,20 @@ function saveWebIdeAgentId(workdir, taskId, agentId) {
 }
 function clearWebIdeAgentId(workdir, taskId) {
   const path = registryPath(workdir, taskId);
-  if (!existsSync3(path)) return;
+  if (!existsSync4(path)) return;
   syncWebIdeTaskState(workdir, taskId, { agentId: "" });
 }
 
 // src/commands/clean-webide-cache.ts
-import { existsSync as existsSync4, rmSync } from "node:fs";
-import { resolve as resolve5 } from "node:path";
+import { existsSync as existsSync5, rmSync } from "node:fs";
+import { resolve as resolve6 } from "node:path";
 import { getDefaultSdkStateRoot } from "@cursor/sdk";
 async function purgeCursorAgentStoreForAgent(workdir, agentId) {
   const trimmedAgentId = agentId.trim();
   const trimmedWorkdir = workdir.trim();
   if (!trimmedAgentId || !trimmedWorkdir) return false;
   const stateRoot = getDefaultSdkStateRoot(trimmedWorkdir);
-  if (!existsSync4(stateRoot)) return false;
+  if (!existsSync5(stateRoot)) return false;
   const { SqliteLocalAgentStore } = await import(
     /* @vite-ignore */
     "@cursor/sdk/sqlite"
@@ -1963,8 +2264,8 @@ async function cleanWebIdeWorkspaceCache(taskId, workdir) {
       `[apm] \u65E0 WebIDE agentId\uFF0C\u8DF3\u8FC7 agent store \u6E05\u7406 taskId=${trimmedTaskId}`
     );
   }
-  const dir = resolve5(trimmedWorkdir, ".apm", "webide", trimmedTaskId);
-  if (existsSync4(dir)) {
+  const dir = resolve6(trimmedWorkdir, ".apm", "webide", trimmedTaskId);
+  if (existsSync5(dir)) {
     rmSync(dir, { recursive: true, force: true });
     console.log(`[apm] \u5DF2\u6E05\u7406 WebIDE \u7F13\u5B58 ${dir}`);
   } else {
@@ -1975,11 +2276,11 @@ async function cleanWebIdeWorkspaceCache(taskId, workdir) {
 // src/commands/connect/webide-ask-question.ts
 import { setTimeout as delay } from "node:timers/promises";
 var POLL_INTERVAL_MS = 2e3;
-function asString3(value) {
+function asString4(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function parseQuestions(args) {
-  const title = asString3(args.title) || void 0;
+  const title = asString4(args.title) || void 0;
   const raw = args.questions;
   if (!Array.isArray(raw) || raw.length === 0) {
     throw new Error("AskQuestion \u7F3A\u5C11 questions");
@@ -1988,16 +2289,16 @@ function parseQuestions(args) {
   for (const item of raw) {
     if (!item || typeof item !== "object" || Array.isArray(item)) continue;
     const row = item;
-    const id = asString3(row.id);
-    const prompt = asString3(row.prompt);
+    const id = asString4(row.id);
+    const prompt = asString4(row.prompt);
     const optionsRaw = row.options;
     if (!id || !prompt || !Array.isArray(optionsRaw)) continue;
     const options = [];
     for (const opt of optionsRaw) {
       if (!opt || typeof opt !== "object" || Array.isArray(opt)) continue;
       const o = opt;
-      const oid = asString3(o.id);
-      const label = asString3(o.label);
+      const oid = asString4(o.id);
+      const label = asString4(o.label);
       if (oid && label) options.push({ id: oid, label });
     }
     if (options.length < 2) {
@@ -2490,14 +2791,14 @@ async function ensureWebIdePullRequests(cfg, taskId, workdir) {
 }
 
 // src/version.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 import { dirname as dirname4, join as join4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function readCliVersion() {
   try {
     const dir = dirname4(fileURLToPath2(import.meta.url));
     const pkgPath = join4(dir, "..", "package.json");
-    const pkg = JSON.parse(readFileSync4(pkgPath, "utf8"));
+    const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -2505,7 +2806,7 @@ function readCliVersion() {
 }
 
 // src/commands/sync-webide-attachments.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
 import { join as join5 } from "path";
 var MANIFEST_FILE = ".sync-manifest.json";
 async function downloadAttachment(cfg, attachmentId) {
@@ -2523,12 +2824,12 @@ async function downloadAttachment(cfg, attachmentId) {
 }
 function loadManifest(dir) {
   const path = join5(dir, MANIFEST_FILE);
-  if (!existsSync5(path)) {
+  if (!existsSync6(path)) {
     return { version: 1, attachments: {} };
   }
   try {
     const parsed = JSON.parse(
-      readFileSync5(path, "utf8")
+      readFileSync6(path, "utf8")
     );
     if (parsed?.version === 1 && parsed.attachments && typeof parsed.attachments === "object") {
       return parsed;
@@ -2546,7 +2847,7 @@ function saveManifest(dir, manifest) {
   );
 }
 function isAttachmentUpToDate(entry, item, dest) {
-  if (!entry || !existsSync5(dest)) return false;
+  if (!entry || !existsSync6(dest)) return false;
   if (entry.name !== item.name) return false;
   const createdAt = item.createdAt ?? "";
   return entry.createdAt === createdAt;
@@ -2593,14 +2894,14 @@ async function syncWebIdeAttachments(cfg, taskId, workdir, attachments) {
 
 // src/utils/project-documents.ts
 import {
-  existsSync as existsSync6,
+  existsSync as existsSync7,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync6,
+  readFileSync as readFileSync7,
   rmSync as rmSync2,
   writeFileSync as writeFileSync5
 } from "fs";
 import { createHash } from "crypto";
-import { dirname as dirname5, join as join6, relative as relative2, sep } from "path";
+import { dirname as dirname5, join as join6, relative as relative3, sep } from "path";
 var MANIFEST_FILE2 = "manifest.json";
 function normalizeProjectIdForPath(projectId) {
   const id = projectId.trim();
@@ -2642,12 +2943,12 @@ function readLocalManifest(apmRoot, projectId) {
     projectDocumentsDir(apmRoot, projectId),
     MANIFEST_FILE2
   );
-  if (!existsSync6(manifestPath3)) {
+  if (!existsSync7(manifestPath3)) {
     return null;
   }
   try {
     return JSON.parse(
-      readFileSync6(manifestPath3, "utf8")
+      readFileSync7(manifestPath3, "utf8")
     );
   } catch {
     return null;
@@ -2655,7 +2956,7 @@ function readLocalManifest(apmRoot, projectId) {
 }
 function listLocalDocumentPaths(apmRoot, projectId) {
   const root = projectDocumentsDir(apmRoot, projectId);
-  if (!existsSync6(root)) {
+  if (!existsSync7(root)) {
     return [];
   }
   const paths = [];
@@ -2669,7 +2970,7 @@ function listLocalDocumentPaths(apmRoot, projectId) {
       if (entry.isFile() && entry.name === MANIFEST_FILE2) {
         continue;
       }
-      const rel = relative2(root, abs).split(sep).join("/");
+      const rel = relative3(root, abs).split(sep).join("/");
       paths.push(rel);
     }
   };
@@ -2790,7 +3091,7 @@ ${diagnostic ?? ""}`);
     const absPath = toFsPath(
       projectDocumentLocalPath(targetApmDir, projectId, path)
     );
-    if (existsSync6(absPath)) {
+    if (existsSync7(absPath)) {
       rmSync2(absPath, { force: true });
       deleted += 1;
     }
@@ -2839,7 +3140,7 @@ async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot, options) {
     const absPath = toFsPath(
       projectDocumentLocalPath(targetApmDir, projectId, path)
     );
-    const content = readFileSync6(absPath, "utf8");
+    const content = readFileSync7(absPath, "utf8");
     const contentHash = hashLocalFileContent(content);
     if (remoteHashByPath.get(path) === contentHash) {
       continue;
@@ -2860,7 +3161,7 @@ async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot, options) {
 }
 
 // src/commands/connect/cli-version-sync.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
 import { join as join7 } from "path";
 var CLI_VERSION_FILE = ".cli-version.json";
 function manifestPath2(apmDir) {
@@ -2868,12 +3169,12 @@ function manifestPath2(apmDir) {
 }
 function loadManifest2(apmDir) {
   const path = toFsPath(manifestPath2(apmDir));
-  if (!existsSync7(path)) {
+  if (!existsSync8(path)) {
     return null;
   }
   try {
     const parsed = JSON.parse(
-      readFileSync7(path, "utf8")
+      readFileSync8(path, "utf8")
     );
     if (parsed?.version === 1 && typeof parsed.cliVersion === "string" && parsed.cliVersion.trim()) {
       return parsed;
@@ -2909,6 +3210,24 @@ function markSkillsSyncedForCliVersion(workdir, cliVersion) {
   syncedInSession.set(workdir, cliVersion);
 }
 
+// src/commands/connect/parse-webide-prompt-payload.ts
+function parseWebIdePromptPayload(content) {
+  const marker = "\n\npayload=";
+  const index = content.lastIndexOf(marker);
+  if (index < 0) return null;
+  const jsonText = content.slice(index + marker.length).trim();
+  if (!jsonText) return null;
+  try {
+    const parsed = JSON.parse(jsonText);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
+
 // src/commands/connect/handle-webide-message.ts
 var WEBIDE_CODE_CHANGE_ACTIONS = /* @__PURE__ */ new Set([
   "skip-plan",
@@ -2921,6 +3240,12 @@ var WEBIDE_CODE_CHANGE_ACTIONS = /* @__PURE__ */ new Set([
 function shouldCommitAfterWebIdeMessage(action) {
   return WEBIDE_CODE_CHANGE_ACTIONS.has(action);
 }
+function isStartLocalServicesAction(action) {
+  return action === "enter-manual-test" || action === "skip-test";
+}
+function isExecuteSqlAction(action) {
+  return action === "execute-sql";
+}
 function syncLocalTaskStatus(workdir, taskId, msg, status) {
   syncWebIdeTaskState(workdir, taskId, {
     messageId: msg.messageId,
@@ -3129,7 +3454,11 @@ async function handleWebIdeInboundMessage(cfg, msg, signal) {
       "running"
     );
     await syncPrepLog();
-    const savedAgentId = loadWebIdeAgentId(workdir, taskId);
+    const startLocalServices = isStartLocalServicesAction(msg.action);
+    const executeSql = isExecuteSqlAction(msg.action);
+    const savedAgentId = startLocalServices ? void 0 : loadWebIdeAgentId(workdir, taskId);
+    const promptPayload = executeSql ? parseWebIdePromptPayload(msg.content) : null;
+    const sqlExecutionId = executeSql && typeof promptPayload?.executionId === "string" ? promptPayload.executionId.trim() : void 0;
     const outcome = await runCursorAgent(
       cfg,
       {
@@ -3146,17 +3475,23 @@ async function handleWebIdeInboundMessage(cfg, msg, signal) {
         forceSend: true,
         eventSession,
         appendMessageContent: (content) => appendContent(cfg, messageId, content),
-        askQuestionExecute: createWebIdeAskQuestionExecute({
+        askQuestionExecute: startLocalServices ? void 0 : createWebIdeAskQuestionExecute({
           cfg,
           taskId,
           signal
         }),
-        enableWebIdePlanTools: true,
+        enableAskQuestion: !startLocalServices && !executeSql,
+        enableWebIdePlanTools: !startLocalServices && !executeSql,
+        enablePtySessionMcp: startLocalServices,
+        enableMysqlTools: executeSql,
+        sqlExecutionId,
         enableSandbox: false,
-        onInvalidatePersistedAgentId: () => clearWebIdeAgentId(workdir, taskId),
+        onInvalidatePersistedAgentId: startLocalServices ? void 0 : () => clearWebIdeAgentId(workdir, taskId),
         taskId,
         createRemoteLogSync: (agentId) => {
-          saveWebIdeAgentId(workdir, taskId, agentId);
+          if (!startLocalServices) {
+            saveWebIdeAgentId(workdir, taskId, agentId);
+          }
           logSyncRef.current = createThrottledWebIdeMessageLogSync(
             cfg,
             { taskId, messageId, agentId },
@@ -3170,7 +3505,9 @@ async function handleWebIdeInboundMessage(cfg, msg, signal) {
           return logSyncRef.current;
         },
         onRunStarted: async ({ agentId, runId }) => {
-          saveWebIdeAgentId(workdir, taskId, agentId);
+          if (!startLocalServices) {
+            saveWebIdeAgentId(workdir, taskId, agentId);
+          }
           eventSession.addCliStep(
             "\u542F\u52A8 Cursor Agent",
             `agentId=${agentId} runId=${runId}`,
@@ -3182,7 +3519,9 @@ async function handleWebIdeInboundMessage(cfg, msg, signal) {
         }
       }
     );
-    saveWebIdeAgentId(workdir, taskId, outcome.agentId);
+    if (!startLocalServices) {
+      saveWebIdeAgentId(workdir, taskId, outcome.agentId);
+    }
     const tokenUsage = outcome.usage != null ? {
       modelId: outcome.modelId ?? (msg.model?.trim() || void 0),
       inputTokens: outcome.usage.inputTokens,
@@ -3202,6 +3541,20 @@ async function handleWebIdeInboundMessage(cfg, msg, signal) {
         detail,
         tokenUsage
       );
+      if (executeSql && sqlExecutionId) {
+        try {
+          await api.cli.webideFinalizeSqlExecution({
+            executionId: sqlExecutionId,
+            status: "FAILED",
+            error: detail
+          });
+        } catch (finalizeErr) {
+          console.warn(
+            "[apm] finalize sql execution failed:",
+            finalizeErr instanceof Error ? finalizeErr.message : finalizeErr
+          );
+        }
+      }
       await setError(cfg, messageId, detail);
       syncLocalTaskStatus(workdir, taskId, msg, "FAILED");
       return;
@@ -3213,6 +3566,20 @@ async function handleWebIdeInboundMessage(cfg, msg, signal) {
         "\u5DF2\u53D6\u6D88",
         tokenUsage
       );
+      if (executeSql && sqlExecutionId) {
+        try {
+          await api.cli.webideFinalizeSqlExecution({
+            executionId: sqlExecutionId,
+            status: "CANCELLED",
+            error: "\u5DF2\u53D6\u6D88"
+          });
+        } catch (finalizeErr) {
+          console.warn(
+            "[apm] finalize sql execution cancelled:",
+            finalizeErr instanceof Error ? finalizeErr.message : finalizeErr
+          );
+        }
+      }
       await updateStatus(cfg, messageId, "CANCELLED");
       syncLocalTaskStatus(workdir, taskId, msg, "CANCELLED");
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "8.0.5",
+  "version": "8.0.8",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,
@@ -18,10 +18,10 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@types/ws": "~8.5.14",
     "@types/node": "^22.0.0",
-    "typescript": "~5.6.0",
+    "@types/ws": "~8.5.14",
     "esbuild": "~0.28.0",
+    "typescript": "~5.6.0",
     "vitest": "~4.1.5"
   },
   "engines": {
@@ -32,9 +32,10 @@
     "@connectrpc/connect": "~1.7.0",
     "@connectrpc/connect-node": "~1.7.0",
     "@cursor/sdk": "^1.0.22",
-    "ws": "~8.18.0",
-    "listpage-http": "~0.0.318",
     "commander": "~14.0.3",
-    "minio": "~8.0.7"
+    "listpage-http": "~0.0.318",
+    "minio": "~8.0.7",
+    "mysql2": "~3.14.5",
+    "ws": "~8.18.0"
   }
 }

package/template/AGENTS.webide.md

@@ -14,6 +14,7 @@
 - `webide_reply.md`：输出通道（每轮必守）
 - `webide_git_commit.md`：开发 / 修码时的 Git 提交与 push
 - `webide_sql_change.md`：有表结构或 SQL 变更时，须在 `AppendMessage` 中醒目提示
+- `webide_sql_execute.md`：execute-sql 轮次连库执行 SQL 时 Read
 - `webide_terminal.md`：长驻进程禁止用 Shell；本地服务由顶栏「启动项目」触发，开发任务不要自行起服务
 - `webide_testcase.md`：生成测试用例并调用 `UpsertWebIdeTestCases`
 - `webide_merge.md`：验收通过后调用 `MergeWebIdePullRequests`

package/template/rules/webide_sql_change.md

@@ -15,9 +15,11 @@
 在回复中增加小节（标题可用「数据表 / SQL 变更」），至少包含：
 
 1. **涉及表**：表名列表与变更类型（如新增列、建表）
-2. **SQL 产物路径**：仓库内相关文件路径（若有）
-3. **待执行 SQL**：完整、可复制执行的语句，放在 ` ```sql ` 代码块中，按执行顺序列出；禁止用 `...` 省略表名/字段名
-4. **执行提醒**：明确告知用户需在对应环境数据库执行（若本轮未自动执行）
+2. **SQL 产物路径**：仓库内相关文件路径（**必填**；完整、可 Read；多仓写明仓库）
+3. **待执行 SQL**：完整、可复制的语句预览，放在 ` ```sql ` 代码块中，按执行顺序列出；禁止用 `...` 省略表名/字段名（预览仅供人看，执行时以产物文件为准）
+4. **执行提醒**：请在目标环境数据库执行；可点 SQL 块上的「执行」由助手连库执行
+
+**禁止**写 Flyway、「若启动已自动迁移可跳过」或同类表述。
 
 多仓时注明 SQL 属于哪个仓库（如后端仓）。
 

package/template/rules/webide_sql_execute.md

@@ -0,0 +1,29 @@
+## WebIDE 执行 SQL（execute-sql 轮次）
+
+适用场景：用户在手工测试阶段点击消息里 SQL 块的「执行」。
+
+### 本轮目标
+
+1. 根据你**此前开发轮次**在 AppendMessage 里写明的 **SQL 产物路径**，定位工作区内的文件（可用 Read / Glob 确认）。
+2. 从 deploy 文档、`application.yml` / `.env` 等推断 MySQL 连接信息（**禁止瞎猜密码**）。
+3. 调用 **MysqlExecute**，传入连接参数，以及产物文件的 **绝对路径**（`path`）。**不要**把 SQL 全文作为工具参数。
+4. 用 **AppendMessage** 汇总执行结果（成功/失败、影响行、必要时的校验说明）。
+
+### MysqlExecute 参数
+
+- `host` / `port` / `user` / `password` / `database`
+- `path`：SQL 产物在磁盘上的 **绝对路径**（须在当前工作区内）。CLI 自行读文件并执行多语句脚本。
+
+### 硬性约束
+
+- **禁止**把 SQL 正文塞进工具参数；由 CLI 读 `path` 指向的文件。
+- **禁止**使用对话里 SQL 预览正文代替文件内容。
+- **禁止**改代码、Git 提交、启动 dev 服务。
+- 密码不得写入 AppendMessage。
+- 找不到产物文件或路径在工作区外 → AppendMessage 说明原因并以错误结束。
+
+### 连接信息来源
+
+1. Read `.apm/project/<项目ID>/` 下文件名或路径包含 `deploy` 的文档。
+2. 若无，Glob 工作区内 `application*.yml` / `.env*` 等配置文件。
+3. 仍无法确定 → 不要猜测，AppendMessage 说明缺少连接配置。

package/template/rules/webide_terminal.md

@@ -4,7 +4,7 @@
 
 会话与 WebIDE「终端」面板共用同一套 `pty-session-mcp serve`。工具名：`create` / `write` / `read` / `resize` / `kill` / `list`。
 
-本地服务由用户在顶栏「启动项目」触发（独立 Agent），**开发/修码任务不要自行起或重启长驻进程**。
+本地服务由用户在顶栏「启动项目」触发，或在进入手工测试时由启动指令触发（独立 Agent）。**开发/修码任务不要自行起或重启长驻进程**。
 
 ## 工具
 
@@ -26,19 +26,20 @@
 3. 按文档中的 cwd / command / 服务划分创建会话。
 4. 文档不存在或未写明启动方式 → 结束任务，**禁止猜测命令**。
 
-## 时机（顶栏启动 / 重启）
+## 时机（顶栏启动 / 重启 / 进入手工测试）
 
 固定顺序：
 
 1. **`list`**
-2. 启动：无对应 `name` 的活会话 → 按部署文档 `create` + `write`；已有同名活会话则结束，不重起
-3. 重启：先 `kill` 目标 `name`，再按部署文档 `create` + `write`（不要杀掉其它端）
-4. `read` 等待就绪日志 / 端口即可
+2. 顶栏启动：无对应 `name` 的活会话 → 按部署文档 `create` + `write`；已有同名活会话则结束，不重起
+3. 顶栏重启：先 `kill` 目标 `name`，再按部署文档 `create` + `write`（不要杀掉其它端）
+4. 进入手工测试：文档写明的每一端，无对应 `name` 则启动；**已有同名活会话则重启**（只 kill 该 name，再 `create` + `write`）
+5. `read` 等待就绪日志 / 端口即可
 
-用户在「终端」面板看日志，在「浏览器」面板看客户机外网地址。
+用户在「终端」面板看日志，在「浏览器」面板看远程主机外网地址。
 
 ## 规范
 
 1. 禁止用 Shell / 后台进程方式起 `dev` / `serve` 等长驻命令。
-2. 观察日志请用户看 WebIDE「终端」面板；页面请用户看「浏览器」面板（客户机外网地址）。
+2. 观察日志请用户看 WebIDE「终端」面板；页面请用户看「浏览器」面板（远程主机外网地址）。
 3. 不再需要时可 kill；不要留下孤儿进程。