connectbase-client 0.13.0 → 0.15.0

package/dist/cli.js

@@ -24,12 +24,90 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/cli.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
+var fs2 = __toESM(require("fs"));
+var path2 = __toESM(require("path"));
 var crypto = __toESM(require("crypto"));
 var https = __toESM(require("https"));
 var http = __toESM(require("http"));
 var readline = __toESM(require("readline"));
+
+// src/tunnel-utils.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var os = __toESM(require("os"));
+function getTunnelLockDir() {
+  const platform2 = os.platform();
+  if (platform2 === "darwin") {
+    return path.join(os.homedir(), "Library", "Application Support", "connectbase", "tunnel-locks");
+  } else if (platform2 === "win32") {
+    return path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local"), "connectbase", "tunnel-locks");
+  }
+  const stateHome = process.env.XDG_STATE_HOME || path.join(os.homedir(), ".local", "state");
+  return path.join(stateHome, "connectbase", "tunnel-locks");
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return e.code === "EPERM";
+  }
+}
+function acquireTunnelLock(appID, port, force, version) {
+  const lockDir = getTunnelLockDir();
+  fs.mkdirSync(lockDir, { recursive: true });
+  const lockPath = path.join(lockDir, `${appID}-${port}.lock`);
+  const lockData = {
+    pid: process.pid,
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    appID,
+    port,
+    host: os.hostname(),
+    version
+  };
+  if (!force) {
+    try {
+      const fd = fs.openSync(lockPath, "wx");
+      fs.writeSync(fd, JSON.stringify(lockData, null, 2));
+      fs.closeSync(fd);
+      return lockPath;
+    } catch (e) {
+      if (e.code !== "EEXIST") {
+        return null;
+      }
+    }
+    try {
+      const existing = JSON.parse(fs.readFileSync(lockPath, "utf-8"));
+      if (isProcessAlive(existing.pid)) {
+        return `LOCKED:${existing.pid}:${existing.startedAt}:${existing.host}`;
+      }
+    } catch {
+    }
+  }
+  fs.writeFileSync(lockPath, JSON.stringify(lockData, null, 2));
+  return lockPath;
+}
+function releaseTunnelLock(lockPath) {
+  try {
+    fs.unlinkSync(lockPath);
+  } catch {
+  }
+}
+function handleTunnelError(msg, appId, localPort) {
+  if (msg.code === "replaced") {
+    return {
+      action: "exit",
+      message: `\u26A0  \uB2E4\uB978 \uC138\uC158\uC774 \uAC19\uC740 \uC571+\uD3EC\uD2B8(${appId}:${localPort})\uB85C \uC5F0\uACB0\uB418\uC5B4 \uC774 \uC138\uC158\uC774 \uC885\uB8CC\uB429\uB2C8\uB2E4. \uB3D9\uC77C \uBA38\uC2E0\uC5D0\uC11C \uB450 \uBC88 \uC2E4\uD589\uD558\uC9C0 \uB9C8\uC138\uC694.`,
+      exitCode: 1
+    };
+  }
+  return {
+    action: "warn",
+    message: `\uD130\uB110 \uC5D0\uB7EC: ${msg.error || msg.message || "\uC54C \uC218 \uC5C6\uB294 \uC5D0\uB7EC"}`
+  };
+}
+
+// src/cli.ts
 var VERSION = "0.10.6";
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
@@ -118,10 +196,10 @@ function loadConfig() {
     storageId: process.env.CONNECTBASE_STORAGE_ID,
     baseUrl: process.env.CONNECTBASE_BASE_URL || DEFAULT_BASE_URL
   };
-  const rcPath = path.join(process.cwd(), ".connectbaserc");
-  if (fs.existsSync(rcPath)) {
+  const rcPath = path2.join(process.cwd(), ".connectbaserc");
+  if (fs2.existsSync(rcPath)) {
     try {
-      const rcContent = JSON.parse(fs.readFileSync(rcPath, "utf-8"));
+      const rcContent = JSON.parse(fs2.readFileSync(rcPath, "utf-8"));
       if (rcContent.publicKey) config.publicKey = rcContent.publicKey;
       if (rcContent.secretKey) config.secretKey = rcContent.secretKey;
       if (rcContent.storageId) config.storageId = rcContent.storageId;
@@ -135,16 +213,16 @@ function loadConfig() {
 }
 function collectFiles(dir, baseDir = dir) {
   const files = [];
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const entries = fs2.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    const relativePath = path.relative(baseDir, fullPath);
+    const fullPath = path2.join(dir, entry.name);
+    const relativePath = path2.relative(baseDir, fullPath);
     if (entry.isDirectory()) {
       if (!entry.name.startsWith(".")) {
         files.push(...collectFiles(fullPath, baseDir));
       }
     } else if (entry.isFile()) {
-      const ext = path.extname(entry.name).toLowerCase();
+      const ext = path2.extname(entry.name).toLowerCase();
       if (!ALLOWED_EXTENSIONS.has(ext)) {
         continue;
       }
@@ -154,9 +232,9 @@ function collectFiles(dir, baseDir = dir) {
       const isBinary = BINARY_EXTENSIONS.has(ext);
       let content;
       if (isBinary) {
-        content = fs.readFileSync(fullPath).toString("base64");
+        content = fs2.readFileSync(fullPath).toString("base64");
       } else {
-        content = fs.readFileSync(fullPath, "utf-8");
+        content = fs2.readFileSync(fullPath, "utf-8");
       }
       files.push({
         path: relativePath.replace(/\\/g, "/"),
@@ -212,15 +290,15 @@ async function makeRequest(url, method, headers, body) {
   });
 }
 async function deploy(directory, config, isDev = false) {
-  const dir = path.resolve(directory);
-  if (!fs.existsSync(dir)) {
+  const dir = path2.resolve(directory);
+  if (!fs2.existsSync(dir)) {
     error(`\uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${dir}`);
     process.exit(1);
   }
-  const pkgPath = path.join(process.cwd(), "package.json");
-  if (fs.existsSync(pkgPath)) {
+  const pkgPath = path2.join(process.cwd(), "package.json");
+  if (fs2.existsSync(pkgPath)) {
     try {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
       if (pkg.scripts?.build) {
         warn(`\uBC30\uD3EC \uC804 \uBE4C\uB4DC\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694: ${colors.cyan}npm run build && npx connectbase-client deploy${colors.reset}`);
         warn(`\uB610\uB294 package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uB4F1\uB85D\uD558\uC138\uC694: ${colors.cyan}npx connectbase-client init${colors.reset}`);
@@ -228,12 +306,12 @@ async function deploy(directory, config, isDev = false) {
     } catch {
     }
   }
-  if (!fs.statSync(dir).isDirectory()) {
+  if (!fs2.statSync(dir).isDirectory()) {
     error(`${dir}\uB294 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC544\uB2D9\uB2C8\uB2E4`);
     process.exit(1);
   }
-  const indexPath = path.join(dir, "index.html");
-  if (!fs.existsSync(indexPath)) {
+  const indexPath = path2.join(dir, "index.html");
+  if (!fs2.existsSync(indexPath)) {
     error("index.html \uD30C\uC77C\uC774 \uD544\uC694\uD569\uB2C8\uB2E4");
     process.exit(1);
   }
@@ -355,11 +433,11 @@ function getProjectRoot() {
 var CONSOLE_URL = DEFAULT_BASE_URL.replace("api.", "");
 function openBrowser(url) {
   const { exec } = require("child_process");
-  const platform = process.platform;
+  const platform2 = process.platform;
   let command;
-  if (platform === "darwin") {
+  if (platform2 === "darwin") {
     command = `open "${url}"`;
-  } else if (platform === "win32") {
+  } else if (platform2 === "win32") {
     command = `start "" "${url}"`;
   } else {
     command = `xdg-open "${url}"`;
@@ -449,8 +527,8 @@ ${colors.cyan}Connect Base \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654${colors.r
     info(`MCP/\uBB38\uC11C\uB294 \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC5D0, \uBC30\uD3EC \uC124\uC815\uC740 \uD604\uC7AC \uB514\uB809\uD1A0\uB9AC\uC5D0 \uC0DD\uC131\uB429\uB2C8\uB2E4
 `);
   }
-  const rcPath = path.join(cwd, ".connectbaserc");
-  if (fs.existsSync(rcPath)) {
+  const rcPath = path2.join(cwd, ".connectbaserc");
+  if (fs2.existsSync(rcPath)) {
     const overwrite = await prompt(`${colors.yellow}\u26A0${colors.reset} .connectbaserc\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uC2DC\uACA0\uC2B5\uB2C8\uAE4C? (y/N): `);
     if (overwrite.toLowerCase() !== "y") {
       info("\uCD08\uAE30\uD654\uAC00 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4");
@@ -539,7 +617,7 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `);
       }
     }
     if (!appId) {
-      const projectName = path.basename(cwd);
+      const projectName = path2.basename(cwd);
       const appName = await prompt(`${colors.blue}?${colors.reset} \uC571 \uC774\uB984 (${projectName}): `) || projectName;
       info("\uC571 \uC0DD\uC131 \uC911...");
       const createRes = await makeRequest(
@@ -607,7 +685,7 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `);
         }
       }
       if (!storageId) {
-        const projectName = path.basename(cwd);
+        const projectName = path2.basename(cwd);
         const name = await prompt(`${colors.blue}?${colors.reset} \uC2A4\uD1A0\uB9AC\uC9C0 \uC774\uB984 (${projectName}): `) || projectName;
         info("\uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0 \uC0DD\uC131 \uC911...");
         const createRes = await makeRequest(
@@ -647,7 +725,7 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `);
   if (secretKey) {
     config.secretKey = secretKey;
   }
-  fs.writeFileSync(rcPath, JSON.stringify(config, null, 2) + "\n");
+  fs2.writeFileSync(rcPath, JSON.stringify(config, null, 2) + "\n");
   success(".connectbaserc \uC0DD\uC131 \uC644\uB8CC");
   addToGitignore(".connectbaserc");
   addDeployScript(deployDir);
@@ -662,21 +740,21 @@ ${colors.dim}Claude Code\uC5D0\uC11C MCP\uAC00 \uC790\uB3D9 \uC5F0\uACB0\uB429\u
 `);
 }
 function detectBuildDir() {
-  if (fs.existsSync(path.join(process.cwd(), "dist"))) return "./dist";
-  if (fs.existsSync(path.join(process.cwd(), "build"))) return "./build";
-  if (fs.existsSync(path.join(process.cwd(), "out"))) return "./out";
-  if (fs.existsSync(path.join(process.cwd(), ".next"))) return "./out";
-  if (fs.existsSync(path.join(process.cwd(), "vite.config.ts")) || fs.existsSync(path.join(process.cwd(), "vite.config.js"))) return "./dist";
-  if (fs.existsSync(path.join(process.cwd(), "next.config.js")) || fs.existsSync(path.join(process.cwd(), "next.config.mjs"))) return "./out";
+  if (fs2.existsSync(path2.join(process.cwd(), "dist"))) return "./dist";
+  if (fs2.existsSync(path2.join(process.cwd(), "build"))) return "./build";
+  if (fs2.existsSync(path2.join(process.cwd(), "out"))) return "./out";
+  if (fs2.existsSync(path2.join(process.cwd(), ".next"))) return "./out";
+  if (fs2.existsSync(path2.join(process.cwd(), "vite.config.ts")) || fs2.existsSync(path2.join(process.cwd(), "vite.config.js"))) return "./dist";
+  if (fs2.existsSync(path2.join(process.cwd(), "next.config.js")) || fs2.existsSync(path2.join(process.cwd(), "next.config.mjs"))) return "./out";
   return "./dist";
 }
 function addToGitignore(entry, basePath) {
   const dir = basePath || process.cwd();
-  const gitignorePath = path.join(dir, ".gitignore");
-  if (fs.existsSync(gitignorePath)) {
-    const content = fs.readFileSync(gitignorePath, "utf-8");
+  const gitignorePath = path2.join(dir, ".gitignore");
+  if (fs2.existsSync(gitignorePath)) {
+    const content = fs2.readFileSync(gitignorePath, "utf-8");
     if (!content.includes(entry)) {
-      fs.appendFileSync(gitignorePath, `
+      fs2.appendFileSync(gitignorePath, `
 # Connect Base
 ${entry}
 `);
@@ -685,20 +763,20 @@ ${entry}
       info(`.gitignore\uC5D0 \uC774\uBBF8 ${entry}\uAC00 \uD3EC\uD568\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4`);
     }
   } else {
-    fs.writeFileSync(gitignorePath, `# Connect Base
+    fs2.writeFileSync(gitignorePath, `# Connect Base
 ${entry}
 `);
     success(".gitignore \uC0DD\uC131 \uC644\uB8CC");
   }
 }
 function addDeployScript(deployDir) {
-  const pkgPath = path.join(process.cwd(), "package.json");
-  if (!fs.existsSync(pkgPath)) {
+  const pkgPath = path2.join(process.cwd(), "package.json");
+  if (!fs2.existsSync(pkgPath)) {
     warn("package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC5B4 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uCD94\uAC00\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4");
     return;
   }
   try {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
     if (!pkg.scripts) pkg.scripts = {};
     if (pkg.scripts.deploy) {
       info(`package.json\uC5D0 \uC774\uBBF8 deploy \uC2A4\uD06C\uB9BD\uD2B8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: "${pkg.scripts.deploy}"`);
@@ -706,7 +784,7 @@ function addDeployScript(deployDir) {
     }
     const deployCmd = `connectbase-client deploy ${deployDir}`;
     pkg.scripts.deploy = pkg.scripts.build ? `${pkg.scripts.build} && ${deployCmd}` : deployCmd;
-    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    fs2.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
     success(`package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8 \uCD94\uAC00 \uC644\uB8CC`);
   } catch {
     warn("package.json \uC218\uC815\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4");
@@ -723,32 +801,32 @@ function getGitRoot() {
 function detectMonorepo(gitRoot) {
   const cwd = process.cwd();
   const result = { type: "none", root: gitRoot, isSubPackage: false };
-  if (fs.existsSync(path.join(gitRoot, "pnpm-workspace.yaml"))) {
+  if (fs2.existsSync(path2.join(gitRoot, "pnpm-workspace.yaml"))) {
     result.type = "pnpm";
-  } else if (fs.existsSync(path.join(gitRoot, "turbo.json"))) {
+  } else if (fs2.existsSync(path2.join(gitRoot, "turbo.json"))) {
     result.type = "turborepo";
-  } else if (fs.existsSync(path.join(gitRoot, "nx.json"))) {
+  } else if (fs2.existsSync(path2.join(gitRoot, "nx.json"))) {
     result.type = "nx";
-  } else if (fs.existsSync(path.join(gitRoot, "lerna.json"))) {
+  } else if (fs2.existsSync(path2.join(gitRoot, "lerna.json"))) {
     result.type = "lerna";
   } else {
-    const rootPkgPath = path.join(gitRoot, "package.json");
-    if (fs.existsSync(rootPkgPath)) {
+    const rootPkgPath = path2.join(gitRoot, "package.json");
+    if (fs2.existsSync(rootPkgPath)) {
       try {
-        const pkg = JSON.parse(fs.readFileSync(rootPkgPath, "utf-8"));
+        const pkg = JSON.parse(fs2.readFileSync(rootPkgPath, "utf-8"));
         if (pkg.workspaces) {
-          result.type = fs.existsSync(path.join(gitRoot, "yarn.lock")) ? "yarn" : "npm";
+          result.type = fs2.existsSync(path2.join(gitRoot, "yarn.lock")) ? "yarn" : "npm";
         }
       } catch {
       }
     }
   }
   if (result.type !== "none" && cwd !== gitRoot) {
-    const cwdPkgPath = path.join(cwd, "package.json");
-    if (fs.existsSync(cwdPkgPath)) {
+    const cwdPkgPath = path2.join(cwd, "package.json");
+    if (fs2.existsSync(cwdPkgPath)) {
       result.isSubPackage = true;
       try {
-        const pkg = JSON.parse(fs.readFileSync(cwdPkgPath, "utf-8"));
+        const pkg = JSON.parse(fs2.readFileSync(cwdPkgPath, "utf-8"));
         result.subPackageName = pkg.name;
       } catch {
       }
@@ -765,13 +843,13 @@ async function downloadDocs(publicKey, templates, baseDir) {
   if (monorepo.type !== "none") {
     info(`\uBAA8\uB178\uB808\uD3EC \uAC10\uC9C0: ${monorepo.type} (\uB8E8\uD2B8: ${gitRoot})`);
     if (monorepo.isSubPackage) {
-      info(`\uD604\uC7AC \uC11C\uBE0C \uD328\uD0A4\uC9C0: ${monorepo.subPackageName || path.basename(process.cwd())}`);
+      info(`\uD604\uC7AC \uC11C\uBE0C \uD328\uD0A4\uC9C0: ${monorepo.subPackageName || path2.basename(process.cwd())}`);
     }
   }
-  const docsDir = path.join(gitRoot, ".claude", "docs");
-  const rootClaudeMd = path.join(gitRoot, "CLAUDE.md");
-  if (!fs.existsSync(docsDir)) {
-    fs.mkdirSync(docsDir, { recursive: true });
+  const docsDir = path2.join(gitRoot, ".claude", "docs");
+  const rootClaudeMd = path2.join(gitRoot, "CLAUDE.md");
+  if (!fs2.existsSync(docsDir)) {
+    fs2.mkdirSync(docsDir, { recursive: true });
   }
   if (!templates) {
     templates = ["rules"];
@@ -790,13 +868,13 @@ async function downloadDocs(publicKey, templates, baseDir) {
     const data = typeof res.data === "string" ? JSON.parse(res.data) : res.data;
     const sections = data.sections || [];
     for (const section of sections) {
-      const filePath = path.join(docsDir, section.filename);
-      fs.writeFileSync(filePath, section.content);
+      const filePath = path2.join(docsDir, section.filename);
+      fs2.writeFileSync(filePath, section.content);
     }
     success(`${gitRoot}/.claude/docs/ \uC5D0 ${sections.length}\uAC1C \uBB38\uC11C \uC800\uC7A5 \uC644\uB8CC`);
     updateRootClaudeMd(rootClaudeMd);
     if (monorepo.isSubPackage) {
-      const subClaudeMd = path.join(process.cwd(), "CLAUDE.md");
+      const subClaudeMd = path2.join(process.cwd(), "CLAUDE.md");
       createSubPackageClaudeMd(subClaudeMd, gitRoot);
     }
     log(`${colors.dim}\u203B SDK \uBB38\uC11C\uB294 MCP search_sdk_docs\uB85C \uAC80\uC0C9\uD558\uC138\uC694${colors.reset}`);
@@ -808,10 +886,10 @@ async function downloadDocs(publicKey, templates, baseDir) {
 
 \uC0C1\uC138 \uAD6C\uD604\uBC95\uC740 MCP \`search_sdk_docs\` \uB3C4\uAD6C\uB85C \uAC80\uC0C9\uD558\uC138\uC694.
 `;
-    fs.writeFileSync(path.join(docsDir, "project-rules.md"), fallbackContent);
+    fs2.writeFileSync(path2.join(docsDir, "project-rules.md"), fallbackContent);
     updateRootClaudeMd(rootClaudeMd);
     if (monorepo.isSubPackage) {
-      const subClaudeMd = path.join(process.cwd(), "CLAUDE.md");
+      const subClaudeMd = path2.join(process.cwd(), "CLAUDE.md");
       createSubPackageClaudeMd(subClaudeMd, gitRoot);
     }
     success(`.claude/docs/ \uC0DD\uC131 \uC644\uB8CC (\uAE30\uBCF8)`);
@@ -831,8 +909,8 @@ function updateRootClaudeMd(claudeMdPath) {
 2. \`search_sdk_docs("\uD0A4\uC6CC\uB4DC")\`\uB85C \uAD6C\uD604 \uBC29\uBC95\uC744 \uAC80\uC0C9\uD558\uC138\uC694
 3. \uAC80\uC0C9 \uACB0\uACFC\uC758 \uCF54\uB4DC \uD328\uD134\uC744 \uB530\uB77C \uAD6C\uD604\uD558\uC138\uC694
 ${endMarker}`;
-  if (fs.existsSync(claudeMdPath)) {
-    let content = fs.readFileSync(claudeMdPath, "utf-8");
+  if (fs2.existsSync(claudeMdPath)) {
+    let content = fs2.readFileSync(claudeMdPath, "utf-8");
     const startIdx = content.indexOf(startMarker);
     const endIdx = content.indexOf(endMarker);
     if (startIdx !== -1 && endIdx !== -1) {
@@ -840,10 +918,10 @@ ${endMarker}`;
     } else {
       content = sdkBlock + "\n\n" + content.trimStart();
     }
-    fs.writeFileSync(claudeMdPath, content);
+    fs2.writeFileSync(claudeMdPath, content);
     info("CLAUDE.md\uC5D0 ConnectBase \uCC38\uC870 \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC");
   } else {
-    fs.writeFileSync(claudeMdPath, `# \uD504\uB85C\uC81D\uD2B8
+    fs2.writeFileSync(claudeMdPath, `# \uD504\uB85C\uC81D\uD2B8
 
 ${sdkBlock}
 `);
@@ -853,7 +931,7 @@ ${sdkBlock}
 function createSubPackageClaudeMd(subClaudeMdPath, gitRoot) {
   const startMarker = "<!-- CONNECTBASE_SUB_START -->";
   const endMarker = "<!-- CONNECTBASE_SUB_END -->";
-  const relPath = path.relative(path.dirname(subClaudeMdPath), gitRoot);
+  const relPath = path2.relative(path2.dirname(subClaudeMdPath), gitRoot);
   const subBlock = `${startMarker}
 ## ConnectBase SDK
 
@@ -865,8 +943,8 @@ function createSubPackageClaudeMd(subClaudeMdPath, gitRoot) {
 2. \`search_sdk_docs("\uD0A4\uC6CC\uB4DC")\`\uB85C SDK \uAD6C\uD604 \uBC29\uBC95\uC744 \uAC80\uC0C9\uD558\uC138\uC694
 3. \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC758 \`${relPath}/CLAUDE.md\`\uB3C4 \uCC38\uACE0\uD558\uC138\uC694
 ${endMarker}`;
-  if (fs.existsSync(subClaudeMdPath)) {
-    let content = fs.readFileSync(subClaudeMdPath, "utf-8");
+  if (fs2.existsSync(subClaudeMdPath)) {
+    let content = fs2.readFileSync(subClaudeMdPath, "utf-8");
     const startIdx = content.indexOf(startMarker);
     const endIdx = content.indexOf(endMarker);
     if (startIdx !== -1 && endIdx !== -1) {
@@ -876,9 +954,9 @@ ${endMarker}`;
     } else {
       return;
     }
-    fs.writeFileSync(subClaudeMdPath, content);
+    fs2.writeFileSync(subClaudeMdPath, content);
   } else {
-    fs.writeFileSync(subClaudeMdPath, `# ${path.basename(path.dirname(subClaudeMdPath))}
+    fs2.writeFileSync(subClaudeMdPath, `# ${path2.basename(path2.dirname(subClaudeMdPath))}
 
 ${subBlock}
 `);
@@ -895,7 +973,7 @@ async function setupMcp(secretKey) {
       info(`MCP \uC124\uC815\uC740 \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8(${root})\uC5D0 \uC0DD\uC131\uB429\uB2C8\uB2E4`);
     }
   }
-  const mcpConfigPath = path.join(root, ".mcp.json");
+  const mcpConfigPath = path2.join(root, ".mcp.json");
   if (!secretKey) {
     log(`
 ${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${colors.reset}`);
@@ -906,16 +984,16 @@ ${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${co
     if (authChoice === "2") {
       try {
         secretKey = await browserAuthFlow();
-        const skRcPath = path.join(process.cwd(), ".connectbaserc");
+        const skRcPath = path2.join(process.cwd(), ".connectbaserc");
         let rcData = {};
-        if (fs.existsSync(skRcPath)) {
+        if (fs2.existsSync(skRcPath)) {
           try {
-            rcData = JSON.parse(fs.readFileSync(skRcPath, "utf-8"));
+            rcData = JSON.parse(fs2.readFileSync(skRcPath, "utf-8"));
           } catch {
           }
         }
         rcData.secretKey = secretKey;
-        fs.writeFileSync(skRcPath, JSON.stringify(rcData, null, 2) + "\n");
+        fs2.writeFileSync(skRcPath, JSON.stringify(rcData, null, 2) + "\n");
         addToGitignore(".connectbaserc", root);
         success("Secret Key \uBC1C\uAE09 \uBC0F \uC800\uC7A5 \uC644\uB8CC");
       } catch (err) {
@@ -934,21 +1012,21 @@ ${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${co
     }
   };
   let mcpConfig = { mcpServers: {} };
-  if (fs.existsSync(mcpConfigPath)) {
+  if (fs2.existsSync(mcpConfigPath)) {
     try {
-      mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, "utf-8"));
+      mcpConfig = JSON.parse(fs2.readFileSync(mcpConfigPath, "utf-8"));
       if (!mcpConfig.mcpServers || typeof mcpConfig.mcpServers !== "object") {
         mcpConfig.mcpServers = {};
       }
     } catch {
       const backupPath = mcpConfigPath + ".backup";
-      fs.copyFileSync(mcpConfigPath, backupPath);
+      fs2.copyFileSync(mcpConfigPath, backupPath);
       warn(`.mcp.json \uD30C\uC2F1 \uC2E4\uD328, \uBC31\uC5C5 \uC0DD\uC131: ${backupPath}`);
       mcpConfig = { mcpServers: {} };
     }
   }
   mcpConfig.mcpServers["connect-base"] = mcpEntry;
-  fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+  fs2.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + "\n");
   success(`${mcpConfigPath} \uC0DD\uC131 \uC644\uB8CC`);
   addToGitignore(".mcp.json", root);
   if (secretKey && secretKey !== "YOUR_SECRET_KEY_HERE") {
@@ -1124,7 +1202,7 @@ ${colors.blue}?${colors.reset} \uC571 \uC120\uD0DD (\uBC88\uD638): `);
     success(`\uC120\uD0DD\uB428: ${apps[num - 1].name}`);
     return apps[num - 1].id;
   }
-  const projectName = path.basename(process.cwd());
+  const projectName = path2.basename(process.cwd());
   const appName = await prompt(`${colors.blue}?${colors.reset} \uC571 \uC774\uB984 (${projectName}): `) || projectName;
   info("\uC571 \uC0DD\uC131 \uC911...");
   const createRes = await makeRequest(
@@ -1146,22 +1224,32 @@ ${colors.blue}?${colors.reset} \uC571 \uC120\uD0DD (\uBC88\uD638): `);
   success(`\uC571 \uC0DD\uC131 \uC644\uB8CC: ${createData.app_name}`);
   return createData.app_id;
 }
+function acquireTunnelLock2(appID, port, force) {
+  const result = acquireTunnelLock(appID, port, force, VERSION);
+  if (result && result.startsWith("LOCKED:")) {
+    const [, pid, startedAt, host] = result.split(":");
+    error(`\uC774\uBBF8 \uC2E4\uD589 \uC911\uC778 \uD130\uB110\uC774 \uC788\uC2B5\uB2C8\uB2E4: PID ${pid}, \uC2DC\uC791 ${startedAt}, \uD638\uC2A4\uD2B8 ${host}`);
+    info("\uC911\uBCF5 \uC2E4\uD589\uC744 \uBB34\uC2DC\uD558\uB824\uBA74 --force \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694");
+    process.exit(2);
+  }
+  return result;
+}
 async function startTunnel(port, config, tunnelOpts) {
   let tunnelKey = config.secretKey || (config.publicKey?.startsWith("cb_sk_") ? config.publicKey : "");
   if (!tunnelKey) {
     info("Secret Key\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBE0C\uB77C\uC6B0\uC800 \uB85C\uADF8\uC778\uC73C\uB85C \uBC1C\uAE09\uD569\uB2C8\uB2E4...");
     try {
       const sk = await browserAuthFlow();
-      const rcPath2 = path.join(process.cwd(), ".connectbaserc");
+      const rcPath2 = path2.join(process.cwd(), ".connectbaserc");
       let rcData = {};
-      if (fs.existsSync(rcPath2)) {
+      if (fs2.existsSync(rcPath2)) {
         try {
-          rcData = JSON.parse(fs.readFileSync(rcPath2, "utf-8"));
+          rcData = JSON.parse(fs2.readFileSync(rcPath2, "utf-8"));
         } catch {
         }
       }
       rcData.secretKey = sk;
-      fs.writeFileSync(rcPath2, JSON.stringify(rcData, null, 2) + "\n");
+      fs2.writeFileSync(rcPath2, JSON.stringify(rcData, null, 2) + "\n");
       addToGitignore(".connectbaserc");
       success("Secret Key \uBC1C\uAE09 \uBC0F \uC800\uC7A5 \uC644\uB8CC");
       tunnelKey = sk;
@@ -1174,11 +1262,11 @@ async function startTunnel(port, config, tunnelOpts) {
   } else {
     config.secretKey = tunnelKey;
   }
-  const rcPath = path.join(process.cwd(), ".connectbaserc");
+  const rcPath = path2.join(process.cwd(), ".connectbaserc");
   let savedAppId = tunnelOpts?.appId || "";
   if (!savedAppId) {
     try {
-      const rc = JSON.parse(fs.readFileSync(rcPath, "utf-8"));
+      const rc = JSON.parse(fs2.readFileSync(rcPath, "utf-8"));
       if (rc.tunnelAppId) savedAppId = rc.tunnelAppId;
     } catch {
     }
@@ -1186,18 +1274,19 @@ async function startTunnel(port, config, tunnelOpts) {
   const appId = await resolveAppForTunnel(tunnelKey, config.baseUrl, savedAppId);
   try {
     let rcData = {};
-    if (fs.existsSync(rcPath)) {
+    if (fs2.existsSync(rcPath)) {
       try {
-        rcData = JSON.parse(fs.readFileSync(rcPath, "utf-8"));
+        rcData = JSON.parse(fs2.readFileSync(rcPath, "utf-8"));
       } catch {
       }
     }
     if (rcData.tunnelAppId !== appId) {
       rcData.tunnelAppId = appId;
-      fs.writeFileSync(rcPath, JSON.stringify(rcData, null, 2) + "\n");
+      fs2.writeFileSync(rcPath, JSON.stringify(rcData, null, 2) + "\n");
     }
   } catch {
   }
+  const lockPath = acquireTunnelLock2(appId, port, tunnelOpts?.force ?? false);
   const tunnelServerUrl = getTunnelServerUrl(config.baseUrl);
   const parsedUrl = new URL(tunnelServerUrl);
   const isHttps = parsedUrl.protocol === "https:";
@@ -1212,8 +1301,17 @@ async function startTunnel(port, config, tunnelOpts) {
   const maxReconnectAttempts = 10;
   let shouldReconnect = true;
   let socket = null;
+  let lockReleased = false;
+  const releaseLock = () => {
+    if (lockPath && !lockReleased) {
+      lockReleased = true;
+      releaseTunnelLock(lockPath);
+    }
+  };
+  process.on("exit", releaseLock);
   const cleanup = () => {
     shouldReconnect = false;
+    releaseLock();
     if (socket) {
       try {
         socket.write(createWsCloseFrame(1e3));
@@ -1343,9 +1441,15 @@ ${colors.dim}Ctrl+C\uB85C \uC885\uB8CC${colors.reset}
       case "http_request":
         forwardRequest(msg, sock, localPort);
         break;
-      case "tunnel_error":
-        error(`\uD130\uB110 \uC5D0\uB7EC: ${msg.message}`);
+      case "tunnel_error": {
+        const result = handleTunnelError(msg, appId, localPort);
+        error(result.message);
+        if (result.action === "exit") {
+          shouldReconnect = false;
+          setTimeout(() => process.exit(result.exitCode ?? 1), 500);
+        }
         break;
+      }
       case "ping":
         sock.write(createWsTextFrame(JSON.stringify({ type: "pong" })));
         break;
@@ -1497,6 +1601,7 @@ ${colors.yellow}\uC635\uC158:${colors.reset}
   -u, --base-url <url>  \uC11C\uBC84 URL (\uAE30\uBCF8: ${DEFAULT_BASE_URL})
   -t, --timeout <sec>   \uD130\uB110 \uC694\uCCAD \uD0C0\uC784\uC544\uC6C3 (\uCD08, tunnel \uC804\uC6A9)
   --max-body <MB>       \uD130\uB110 \uCD5C\uB300 \uBC14\uB514 \uD06C\uAE30 (MB, tunnel \uC804\uC6A9)
+  --force               \uD130\uB110 lockfile \uBB34\uC2DC (\uC911\uBCF5 \uC2E4\uD589 \uAC15\uC81C, tunnel \uC804\uC6A9)
   -d, --dev             Dev \uD658\uACBD\uC5D0 \uBC30\uD3EC (deploy \uC804\uC6A9)
   (docs, mcp\uB294 \uBAA8\uB178\uB808\uD3EC\uB97C \uC790\uB3D9 \uAC10\uC9C0\uD558\uC5EC \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC5D0 \uC0DD\uC131)
   -h, --help            \uB3C4\uC6C0\uB9D0 \uD45C\uC2DC
@@ -1562,6 +1667,8 @@ function parseArgs(args) {
       result.options.maxBody = args[++i];
     } else if (arg === "-a" || arg === "--app") {
       result.options.appId = args[++i];
+    } else if (arg === "--force") {
+      result.options.force = "true";
     } else if (arg === "-d" || arg === "--dev") {
       result.options.dev = "true";
     } else if (arg === "-h" || arg === "--help") {
@@ -1645,6 +1752,9 @@ async function main() {
     if (parsed.options.appId) {
       tunnelOpts.appId = parsed.options.appId;
     }
+    if (parsed.options.force === "true") {
+      tunnelOpts.force = true;
+    }
     await startTunnel(port, config, tunnelOpts);
   } else {
     error(`\uC54C \uC218 \uC5C6\uB294 \uBA85\uB839\uC5B4: ${parsed.command}`);