@leeguoo/yapi-mcp 0.3.26 → 0.4.0

package/dist/yapi-cli.js

@@ -4,2120 +4,107 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const crypto_1 = __importDefault(require("crypto"));
-const child_process_1 = require("child_process");
-const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
-const readline_1 = __importDefault(require("readline"));
-const markdown_1 = require("./docs/markdown");
-const install_1 = require("./skill/install");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const utils_1 = require("./cli/utils");
+const http_1 = require("./cli/http");
 const metadata_1 = require("./skill/metadata");
-const auth_1 = require("./services/yapi/auth");
-const authCache_1 = require("./services/yapi/authCache");
-class HttpStatusError extends Error {
-    status;
-    statusText;
-    body;
-    endpoint;
-    constructor(endpoint, status, statusText, body) {
-        super(`request failed: ${status} ${statusText} ${body}`);
-        this.name = "HttpStatusError";
-        this.status = status;
-        this.statusText = statusText;
-        this.body = body;
-        this.endpoint = endpoint;
-    }
-}
-function parseKeyValue(raw) {
-    if (!raw || !raw.includes("="))
-        throw new Error("expected key=value");
-    const idx = raw.indexOf("=");
-    return [raw.slice(0, idx), raw.slice(idx + 1)];
-}
-function parseQueryArg(raw) {
-    const trimmed = String(raw || "").trim().replace(/^\?/, "");
-    if (!trimmed)
-        throw new Error("expected key=value");
-    if (!trimmed.includes("&"))
-        return [parseKeyValue(trimmed)];
-    const items = Array.from(new URLSearchParams(trimmed).entries()).filter(([key]) => Boolean(key));
-    if (items.length)
-        return items;
-    return [parseKeyValue(trimmed)];
-}
-function parseHeader(raw) {
-    if (!raw || !raw.includes(":"))
-        throw new Error("expected Header:Value");
-    const idx = raw.indexOf(":");
-    return [raw.slice(0, idx).trim(), raw.slice(idx + 1).trim()];
-}
-function parseJsonMaybe(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}
-function formatBytes(bytes) {
-    if (!Number.isFinite(bytes) || bytes <= 0)
-        return "0 B";
-    const units = ["B", "KiB", "MiB", "GiB"];
-    let value = bytes;
-    let index = 0;
-    while (value >= 1024 && index < units.length - 1) {
-        value /= 1024;
-        index += 1;
-    }
-    return `${value >= 10 || index === 0 ? value.toFixed(0) : value.toFixed(2)} ${units[index]}`;
-}
-function parseByteSize(raw) {
-    const text = String(raw || "");
-    const bytesMatch = text.match(/(\d+)\s*bytes?/i);
-    if (bytesMatch)
-        return Number(bytesMatch[1]);
-    const unitMatch = text.match(/(\d+(?:\.\d+)?)\s*(kib|kb|mib|mb|gib|gb)\b/i);
-    if (!unitMatch)
-        return null;
-    const value = Number(unitMatch[1]);
-    if (!Number.isFinite(value))
-        return null;
-    const unit = unitMatch[2].toLowerCase();
-    const factors = {
-        kb: 1000,
-        kib: 1024,
-        mb: 1000 * 1000,
-        mib: 1024 * 1024,
-        gb: 1000 * 1000 * 1000,
-        gib: 1024 * 1024 * 1024,
-    };
-    return Math.round(value * (factors[unit] || 1));
-}
-function parsePayloadLimit(text) {
-    const match = String(text || "").match(/(?:limit|max(?:imum)?(?:\s+body)?(?:\s+size)?)[^0-9]{0,12}(\d+(?:\.\d+)?\s*(?:bytes?|kib|kb|mib|mb|gib|gb))/i);
-    if (match)
-        return parseByteSize(match[1]);
-    return parseByteSize(text);
-}
-function findGitRoot(startDir) {
-    let current = path_1.default.resolve(startDir);
-    while (true) {
-        const candidate = path_1.default.join(current, ".git");
-        if (fs_1.default.existsSync(candidate))
-            return current;
-        const parent = path_1.default.dirname(current);
-        if (parent === current)
-            return null;
-        current = parent;
-    }
-}
-function getPayloadMessage(payload) {
-    if (!payload || typeof payload !== "object")
-        return "";
-    const record = payload;
-    const message = record.errmsg ?? record.message ?? record.msg;
-    return typeof message === "string" ? message : "";
-}
-function getPayloadErrcode(payload) {
-    if (!payload || typeof payload !== "object")
-        return null;
-    const record = payload;
-    const code = Number(record.errcode ?? record.code ?? record.errCode);
-    return Number.isFinite(code) ? code : null;
-}
-function looksLikeAuthError(status, payload) {
-    if (status === 401 || status === 403)
-        return true;
-    const code = getPayloadErrcode(payload);
-    if (code !== null && [40011, 40012, 40013, 401, 403].includes(code))
-        return true;
-    const message = getPayloadMessage(payload);
-    if (!message)
-        return false;
-    return /登录|login|权限|unauthori|forbidden|not\s*login|no\s*permission/i.test(message);
-}
-function joinUrl(baseUrl, endpoint) {
-    if (!baseUrl)
-        return endpoint;
-    if (baseUrl.endsWith("/") && endpoint.startsWith("/"))
-        return baseUrl.slice(0, -1) + endpoint;
-    if (!baseUrl.endsWith("/") && !endpoint.startsWith("/"))
-        return baseUrl + "/" + endpoint;
-    return baseUrl + endpoint;
-}
-function globalConfigPath() {
-    const yapiHome = process.env.YAPI_HOME || path_1.default.join(os_1.default.homedir(), ".yapi");
-    return path_1.default.join(yapiHome, "config.toml");
-}
-function parseSimpleToml(text) {
-    const data = {};
-    const lines = String(text || "").split(/\r?\n/);
-    for (const rawLine of lines) {
-        const line = rawLine.split("#", 1)[0].split(";", 1)[0].trim();
-        if (!line || line.startsWith("["))
-            continue;
-        const idx = line.indexOf("=");
-        if (idx === -1)
-            continue;
-        const key = line.slice(0, idx).trim();
-        let value = line.slice(idx + 1).trim();
-        if (!key)
-            continue;
-        if ((value.startsWith('"') && value.endsWith('"')) ||
-            (value.startsWith("'") && value.endsWith("'"))) {
-            value = value.slice(1, -1);
-        }
-        data[key] = value;
-    }
-    return data;
-}
-function resolveToken(tokenValue, projectId) {
-    if (!tokenValue)
-        return "";
-    if (tokenValue.includes(",") || tokenValue.includes(":")) {
-        let defaultToken = "";
-        const mapping = {};
-        tokenValue.split(",").forEach((rawPair) => {
-            const pair = rawPair.trim();
-            if (!pair)
-                return;
-            const idx = pair.indexOf(":");
-            if (idx === -1) {
-                defaultToken = pair;
-                return;
-            }
-            const pid = pair.slice(0, idx).trim();
-            const token = pair.slice(idx + 1).trim();
-            if (pid && token)
-                mapping[pid] = token;
-        });
-        if (projectId && mapping[projectId])
-            return mapping[projectId];
-        if (defaultToken)
-            return defaultToken;
-        const keys = Object.keys(mapping);
-        if (keys.length)
-            return mapping[keys[0]];
-    }
-    return tokenValue;
-}
-function resolveLocalBin(binName) {
-    const baseName = process.platform === "win32" ? `${binName}.cmd` : binName;
-    const localBin = path_1.default.resolve(__dirname, "..", "node_modules", ".bin", baseName);
-    if (fs_1.default.existsSync(localBin))
-        return localBin;
-    return binName;
-}
-function parseJsonLoose(text) {
-    const raw = String(text || "").trim();
-    if (!raw)
-        return null;
-    const direct = parseJsonMaybe(raw);
-    if (direct !== null)
-        return direct;
-    const lines = raw
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean);
-    for (let i = lines.length - 1; i >= 0; i -= 1) {
-        const parsed = parseJsonMaybe(lines[i]);
-        if (parsed !== null)
-            return parsed;
-    }
-    const firstBrace = raw.indexOf("{");
-    const firstBracket = raw.indexOf("[");
-    const starts = [firstBrace, firstBracket].filter((n) => n >= 0);
-    if (!starts.length)
-        return null;
-    const start = Math.min(...starts);
-    const lastBrace = raw.lastIndexOf("}");
-    const lastBracket = raw.lastIndexOf("]");
-    const end = Math.max(lastBrace, lastBracket);
-    if (end <= start)
-        return null;
-    const sliced = raw.slice(start, end + 1);
-    return parseJsonMaybe(sliced);
-}
-function extractCookiesFromPayload(payload) {
-    const queue = [payload];
-    const visited = new Set();
-    while (queue.length) {
-        const current = queue.shift();
-        if (current === null || current === undefined)
-            continue;
-        if (visited.has(current))
-            continue;
-        visited.add(current);
-        if (Array.isArray(current)) {
-            if (current.every((item) => item && typeof item === "object")) {
-                return current;
-            }
-            continue;
-        }
-        if (typeof current !== "object")
-            continue;
-        const obj = current;
-        if (Array.isArray(obj.cookies))
-            return obj.cookies;
-        if (Array.isArray(obj.data))
-            return obj.data;
-        if (obj.data && typeof obj.data === "object")
-            queue.push(obj.data);
-        if (obj.result && typeof obj.result === "object")
-            queue.push(obj.result);
-        if (obj.payload && typeof obj.payload === "object")
-            queue.push(obj.payload);
-    }
-    return [];
-}
-function normalizeCookieExpiresMs(raw) {
-    const n = Number(raw);
-    if (!Number.isFinite(n) || n <= 0)
-        return undefined;
-    return n > 1_000_000_000_000 ? n : n * 1000;
-}
-function runAgentBrowser(args, options = {}) {
-    const bins = [
-        resolveLocalBin("agent-browser-stealth"),
-        resolveLocalBin("agent-browser"),
-        "agent-browser-stealth",
-        "agent-browser",
-    ];
-    const uniq = Array.from(new Set(bins));
-    let lastError = null;
-    for (const bin of uniq) {
-        try {
-            if (options.captureOutput) {
-                const output = (0, child_process_1.execFileSync)(bin, args, {
-                    encoding: "utf8",
-                    stdio: ["pipe", "pipe", "pipe"],
-                });
-                return String(output || "");
-            }
-            (0, child_process_1.execFileSync)(bin, args, { stdio: "inherit" });
-            return "";
-        }
-        catch (error) {
-            const code = error.code;
-            if (code === "ENOENT") {
-                lastError = error;
-                continue;
-            }
-            if (options.ignoreError)
-                return "";
-            throw error;
-        }
-    }
-    if (lastError?.code === "ENOENT") {
-        throw new Error("未找到 agent-browser-stealth。请先执行: pnpm -C packages/yapi-mcp add agent-browser-stealth && pnpm -C packages/yapi-mcp exec agent-browser-stealth install");
-    }
-    throw new Error("启动 agent-browser-stealth 失败");
-}
-async function loginByBrowserAndReadCookie(baseUrl, loginUrlOption) {
-    const normalizedBase = String(baseUrl || "").replace(/\/+$/, "");
-    const defaultLoginUrl = normalizedBase;
-    let loginUrl = String(loginUrlOption || "").trim();
-    if (!loginUrl) {
-        const answer = await promptText(`YApi page URL [${defaultLoginUrl}]: `);
-        loginUrl = answer.trim() || defaultLoginUrl;
-    }
-    try {
-        const parsed = new URL(loginUrl);
-        loginUrl = parsed.toString();
-    }
-    catch {
-        throw new Error(`invalid login url: ${loginUrl}`);
-    }
-    const sessionName = `yapi-login-${Date.now()}-${crypto_1.default.randomBytes(4).toString("hex")}`;
-    console.log(`opening browser for login: ${loginUrl}`);
-    console.log(`browser session name: ${sessionName}`);
-    runAgentBrowser(["open", loginUrl, "--headed", "--session-name", sessionName]);
-    await promptText("请在浏览器完成登录，然后按回车继续...");
-    let cookies = [];
-    try {
-        const output = runAgentBrowser(["cookies", "--json", "--session-name", sessionName], {
-            captureOutput: true,
-        });
-        const payload = parseJsonLoose(output);
-        cookies = extractCookiesFromPayload(payload);
-    }
-    finally {
-        runAgentBrowser(["close", "--session-name", sessionName], { ignoreError: true });
-    }
-    if (!cookies.length) {
-        throw new Error(`未读取到浏览器 cookie。请确认登录完成后再回车；如果仍失败，请先自检:\nagent-browser-stealth cookies --json --session-name ${sessionName}`);
-    }
-    const tokenCookie = cookies.find((item) => String(item?.name || "") === "_yapi_token");
-    const uidCookie = cookies.find((item) => String(item?.name || "") === "_yapi_uid");
-    const yapiToken = String(tokenCookie?.value || "").trim();
-    if (!yapiToken) {
-        throw new Error("未找到 _yapi_token，请确认登录站点是目标 YApi 域名");
-    }
-    const yapiUid = String(uidCookie?.value || "").trim() || undefined;
-    const expiresAt = normalizeCookieExpiresMs(tokenCookie?.expiresAt) ?? normalizeCookieExpiresMs(tokenCookie?.expires);
-    return { yapiToken, yapiUid, expiresAt };
-}
-async function fetchWithTimeout(url, options, timeoutMs) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        return await fetch(url, { ...options, signal: controller.signal });
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-function buildUrl(baseUrl, endpoint, queryItems, token, tokenParam) {
-    const url = baseUrl ? joinUrl(baseUrl, endpoint) : endpoint;
-    const parsed = new URL(url);
-    for (const [key, value] of queryItems) {
-        if (key)
-            parsed.searchParams.append(key, value ?? "");
-    }
-    if (token && !parsed.searchParams.has(tokenParam)) {
-        parsed.searchParams.append(tokenParam, token);
-    }
-    return parsed.toString();
-}
-function parseArgs(argv) {
-    const options = {
-        query: [],
-        header: [],
-        method: "GET",
-        tokenParam: "token",
-        timeout: 30000,
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (!arg)
-            continue;
-        if (arg === "-h" || arg === "--help") {
-            options.help = true;
-            continue;
-        }
-        if (arg === "-V" || arg === "--version") {
-            options.version = true;
-            continue;
-        }
-        if (arg === "--no-update" || arg === "--no-update-check") {
-            options.noUpdate = true;
-            continue;
-        }
-        if (arg === "--config") {
-            options.config = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--config=")) {
-            options.config = arg.slice(9);
-            continue;
-        }
-        if (arg === "--base-url") {
-            options.baseUrl = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--base-url=")) {
-            options.baseUrl = arg.slice(11);
-            continue;
-        }
-        if (arg === "--login-url") {
-            options.loginUrl = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--login-url=")) {
-            options.loginUrl = arg.slice(12);
-            continue;
-        }
-        if (arg === "--token") {
-            options.token = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--token=")) {
-            options.token = arg.slice(8);
-            continue;
-        }
-        if (arg === "--project-id") {
-            options.projectId = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--project-id=")) {
-            options.projectId = arg.slice(13);
-            continue;
-        }
-        if (arg === "--auth-mode") {
-            options.authMode = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--auth-mode=")) {
-            options.authMode = arg.slice(12);
-            continue;
-        }
-        if (arg === "--browser") {
-            options.browser = true;
-            continue;
-        }
-        if (arg === "--email") {
-            options.email = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--email=")) {
-            options.email = arg.slice(8);
-            continue;
-        }
-        if (arg === "--password") {
-            options.password = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--password=")) {
-            options.password = arg.slice(11);
-            continue;
-        }
-        if (arg === "--cookie") {
-            options.cookie = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--cookie=")) {
-            options.cookie = arg.slice(9);
-            continue;
-        }
-        if (arg === "--token-param") {
-            options.tokenParam = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--token-param=")) {
-            options.tokenParam = arg.slice(14);
-            continue;
-        }
-        if (arg === "--method") {
-            options.method = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--method=")) {
-            options.method = arg.slice(9);
-            continue;
-        }
-        if (arg === "--path") {
-            options.path = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--path=")) {
-            options.path = arg.slice(7);
-            continue;
-        }
-        if (arg === "--url") {
-            options.url = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--url=")) {
-            options.url = arg.slice(6);
-            continue;
-        }
-        if (arg === "--query") {
-            options.query?.push(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--query=")) {
-            options.query?.push(arg.slice(8));
-            continue;
-        }
-        if (arg === "--q" || arg === "-q") {
-            options.q = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--q=")) {
-            options.q = arg.slice(4);
-            continue;
-        }
-        if (arg === "--header") {
-            options.header?.push(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--header=")) {
-            options.header?.push(arg.slice(9));
-            continue;
-        }
-        if (arg === "--data") {
-            options.data = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--data=")) {
-            options.data = arg.slice(7);
-            continue;
-        }
-        if (arg === "--data-file") {
-            options.dataFile = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--data-file=")) {
-            options.dataFile = arg.slice(12);
-            continue;
-        }
-        if (arg === "--timeout") {
-            options.timeout = Number(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--timeout=")) {
-            options.timeout = Number(arg.slice(10));
-            continue;
-        }
-        if (arg === "--name") {
-            options.name = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--name=")) {
-            options.name = arg.slice(7);
-            continue;
-        }
-        if (arg === "--desc") {
-            options.desc = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--desc=")) {
-            options.desc = arg.slice(7);
-            continue;
-        }
-        if (arg === "--cat-id" || arg === "--catid") {
-            options.catId = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--cat-id=")) {
-            options.catId = arg.slice(9);
-            continue;
-        }
-        if (arg.startsWith("--catid=")) {
-            options.catId = arg.slice(8);
-            continue;
-        }
-        if (arg === "--id") {
-            options.id = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--id=")) {
-            options.id = arg.slice(5);
-            continue;
-        }
-        if (arg === "--group-id") {
-            options.groupId = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--group-id=")) {
-            options.groupId = arg.slice(11);
-            continue;
-        }
-        if (arg === "--type") {
-            options.type = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--type=")) {
-            options.type = arg.slice(7);
-            continue;
-        }
-        if (arg === "--type-id") {
-            options.typeId = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--type-id=")) {
-            options.typeId = arg.slice(10);
-            continue;
-        }
-        if (arg === "--page") {
-            options.page = Number(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--page=")) {
-            options.page = Number(arg.slice(7));
-            continue;
-        }
-        if (arg === "--limit") {
-            const raw = String(argv[++i] ?? "").trim();
-            options.limit = raw.toLowerCase() === "all" ? "all" : Number(raw);
-            continue;
-        }
-        if (arg.startsWith("--limit=")) {
-            const raw = String(arg.slice(8)).trim();
-            options.limit = raw.toLowerCase() === "all" ? "all" : Number(raw);
-            continue;
-        }
-        if (arg === "--no-pretty") {
-            options.noPretty = true;
-            continue;
-        }
-    }
-    return options;
-}
-function parseDocsSyncArgs(argv) {
-    const options = {
-        dirs: [],
-        bindings: [],
-        tokenParam: "token",
-        timeout: 30000,
-        mermaidLook: "handDrawn",
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (!arg)
-            continue;
-        if (arg === "-h" || arg === "--help") {
-            options.help = true;
-            continue;
-        }
-        if (arg === "--config") {
-            options.config = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--config=")) {
-            options.config = arg.slice(9);
-            continue;
-        }
-        if (arg === "--base-url") {
-            options.baseUrl = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--base-url=")) {
-            options.baseUrl = arg.slice(11);
-            continue;
-        }
-        if (arg === "--token") {
-            options.token = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--token=")) {
-            options.token = arg.slice(8);
-            continue;
-        }
-        if (arg === "--project-id") {
-            options.projectId = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--project-id=")) {
-            options.projectId = arg.slice(13);
-            continue;
-        }
-        if (arg === "--auth-mode") {
-            options.authMode = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--auth-mode=")) {
-            options.authMode = arg.slice(12);
-            continue;
-        }
-        if (arg === "--email") {
-            options.email = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--email=")) {
-            options.email = arg.slice(8);
-            continue;
-        }
-        if (arg === "--password") {
-            options.password = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--password=")) {
-            options.password = arg.slice(11);
-            continue;
-        }
-        if (arg === "--cookie") {
-            options.cookie = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--cookie=")) {
-            options.cookie = arg.slice(9);
-            continue;
-        }
-        if (arg === "--token-param") {
-            options.tokenParam = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--token-param=")) {
-            options.tokenParam = arg.slice(14);
-            continue;
-        }
-        if (arg === "--timeout") {
-            options.timeout = Number(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--timeout=")) {
-            options.timeout = Number(arg.slice(10));
-            continue;
-        }
-        if (arg === "--dir") {
-            options.dirs.push(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--dir=")) {
-            options.dirs.push(arg.slice(6));
-            continue;
-        }
-        if (arg === "--binding") {
-            options.bindings.push(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--binding=")) {
-            options.bindings.push(arg.slice(10));
-            continue;
-        }
-        if (arg === "--dry-run") {
-            options.dryRun = true;
-            continue;
-        }
-        if (arg === "--no-mermaid") {
-            options.noMermaid = true;
-            continue;
-        }
-        if (arg === "--mermaid-hand-drawn") {
-            options.mermaidLook = "handDrawn";
-            continue;
-        }
-        if (arg === "--mermaid-classic") {
-            options.mermaidLook = "classic";
-            options.mermaidHandDrawnSeed = undefined;
-            continue;
-        }
-        if (arg === "--mermaid-hand-drawn-seed") {
-            const seed = Number(argv[++i]);
-            if (Number.isFinite(seed)) {
-                options.mermaidHandDrawnSeed = seed;
-            }
-            if (!options.mermaidLook)
-                options.mermaidLook = "handDrawn";
-            continue;
-        }
-        if (arg.startsWith("--mermaid-hand-drawn-seed=")) {
-            const seed = Number(arg.slice(27));
-            if (Number.isFinite(seed)) {
-                options.mermaidHandDrawnSeed = seed;
-            }
-            if (!options.mermaidLook)
-                options.mermaidLook = "handDrawn";
-            continue;
-        }
-        if (arg === "--force") {
-            options.force = true;
-            continue;
-        }
-        if (arg.startsWith("-"))
-            continue;
-        options.dirs.push(arg);
-    }
-    return options;
-}
-function parseDocsSyncBindArgs(argv) {
-    const options = {
-        sourceFiles: [],
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (!arg)
-            continue;
-        if (arg === "-h" || arg === "--help") {
-            options.help = true;
-            continue;
-        }
-        if (arg === "--name" || arg === "--binding") {
-            options.name = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--name=")) {
-            options.name = arg.slice(7);
-            continue;
-        }
-        if (arg.startsWith("--binding=")) {
-            options.name = arg.slice(10);
-            continue;
-        }
-        if (arg === "--dir") {
-            options.dir = argv[++i];
-            continue;
-        }
-        if (arg.startsWith("--dir=")) {
-            options.dir = arg.slice(6);
-            continue;
-        }
-        if (arg === "--project-id") {
-            options.projectId = Number(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--project-id=")) {
-            options.projectId = Number(arg.slice(13));
-            continue;
-        }
-        if (arg === "--catid" || arg === "--cat-id") {
-            options.catId = Number(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--catid=")) {
-            options.catId = Number(arg.slice(8));
-            continue;
-        }
-        if (arg.startsWith("--cat-id=")) {
-            options.catId = Number(arg.slice(9));
-            continue;
-        }
-        if (arg === "--template-id") {
-            options.templateId = Number(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--template-id=")) {
-            options.templateId = Number(arg.slice(14));
-            continue;
-        }
-        if (arg === "--source-file") {
-            options.sourceFiles?.push(argv[++i]);
-            continue;
-        }
-        if (arg.startsWith("--source-file=")) {
-            options.sourceFiles?.push(arg.slice(14));
-            continue;
-        }
-        if (arg === "--clear-source-files") {
-            options.clearSourceFiles = true;
-            continue;
-        }
-    }
-    return options;
-}
-function usage() {
-    return [
-        "Usage:",
-        "  yapi --path /api/interface/get --query id=123",
-        "  yapi group [options]",
-        "  yapi project [options]",
-        "  yapi interface [options]",
-        "  yapi log [options]",
-        "  yapi docs-sync [options] [dir...]",
-        "  yapi docs-sync bind <action> [options]",
-        "  yapi login [options]",
-        "  yapi logout [options]",
-        "  yapi whoami [options]",
-        "  yapi search [options]",
-        "  yapi install-skill [options]",
-        "  yapi self-update",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project (filters search results)",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --q <keyword>          search keyword (for yapi search)",
-        "  --path <path>          API path (e.g., /api/interface/get)",
-        "  --url <url>            full URL (overrides base-url/path)",
-        "  --query key=value      query param (repeatable)",
-        "  --header Header:Value  request header (repeatable)",
-        "  --method <method>      HTTP method",
-        "  --data <payload>       request body (JSON or text)",
-        "  --data-file <file>     request body file",
-        "  --timeout <ms>         request timeout in ms",
-        "  --id <id>              resource id (for group/project/interface)",
-        "  --name <name>          category name (for interface cat)",
-        "  --desc <desc>          category description (for interface cat)",
-        "  --cat-id <id>          category id (for interface cat)",
-        "  --group-id <id>        group id (for project list)",
-        "  --type <type>          log type (for log list)",
-        "  --type-id <id>         log type id (for log list)",
-        "  --page <n>             page number (for list)",
-        "  --limit <n|all>        page size (for list)",
-        "  --no-update            disable update check",
-        "  --no-pretty            print raw response",
-        "Docs-sync options:",
-        "  --dir <path>           docs directory (repeatable; default: docs/release-notes)",
-        "  --binding <name>       use binding from .yapi/docs-sync.json (repeatable)",
-        "  --dry-run              compute but do not update YApi or mapping files",
-        "  --no-mermaid           do not render mermaid code blocks",
-        "  --mermaid-hand-drawn   force mermaid hand-drawn look (default)",
-        "  --mermaid-classic      render mermaid with classic look",
-        "  --mermaid-hand-drawn-seed <n>  hand-drawn seed (implies hand-drawn look)",
-        "  --force                sync all files even if unchanged",
-        "Docs-sync bind actions:",
-        "  list, get, add, update, remove",
-        "  -V, --version          print version",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function selfUpdateUsage() {
-    return ["Usage:", "  yapi self-update", "", "Install the latest @leeguoo/yapi-mcp globally with npm."].join("\n");
-}
-function docsSyncUsage() {
-    return [
-        "Usage:",
-        "  yapi docs-sync [options] [dir...]",
-        "  yapi docs-sync bind <action> [options]",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --token-param <name>   token query param name (default: token)",
-        "  --timeout <ms>         request timeout in ms",
-        "  --dir <path>           docs directory (repeatable; default: docs/release-notes)",
-        "  --binding <name>       use binding from .yapi/docs-sync.json (repeatable)",
-        "  --dry-run              compute but do not update YApi or mapping files",
-        "  --no-mermaid           do not render mermaid code blocks",
-        "  --mermaid-hand-drawn   force mermaid hand-drawn look (default)",
-        "  --mermaid-classic      render mermaid with classic look",
-        "  --mermaid-hand-drawn-seed <n>  hand-drawn seed (implies hand-drawn look)",
-        "  --force                sync all files even if unchanged",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function docsSyncBindUsage() {
-    return [
-        "Usage:",
-        "  yapi docs-sync bind list",
-        "  yapi docs-sync bind get --name <binding>",
-        "  yapi docs-sync bind add --name <binding> --dir <path> --project-id <id> --catid <id> [options]",
-        "  yapi docs-sync bind update --name <binding> [options]",
-        "  yapi docs-sync bind remove --name <binding>",
-        "Options:",
-        "  --name <binding>       binding name (alias: --binding)",
-        "  --dir <path>           docs directory path",
-        "  --project-id <id>      YApi project id",
-        "  --catid <id>           YApi category id",
-        "  --template-id <id>     template interface id",
-        "  --source-file <path>   sync specific file(s) (repeatable)",
-        "  --clear-source-files   clear source_files list",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function loginUsage() {
-    return [
-        "Usage:",
-        "  yapi login [options]",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --login-url <url>      page URL for browser login (default: <base-url>)",
-        "  --browser              force browser login and cookie sync",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --timeout <ms>         request timeout in ms",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function logoutUsage() {
-    return [
-        "Usage:",
-        "  yapi logout [options]",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function whoamiUsage() {
-    return [
-        "Usage:",
-        "  yapi whoami [options]",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --token-param <name>   token query param name (default: token)",
-        "  --timeout <ms>         request timeout in ms",
-        "  --no-pretty            print raw response",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function searchUsage() {
-    return [
-        "Usage:",
-        "  yapi search --q <keyword>",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --token-param <name>   token query param name (default: token)",
-        "  --q <keyword>          search keyword",
-        "  --timeout <ms>         request timeout in ms",
-        "  --no-pretty            print raw response",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function groupUsage() {
-    return [
-        "Usage:",
-        "  yapi group list",
-        "  yapi group get --id <group_id>",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --token-param <name>   token query param name (default: token)",
-        "  --timeout <ms>         request timeout in ms",
-        "  --id <id>              group id (for get)",
-        "  --no-pretty            print raw response",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function projectUsage() {
-    return [
-        "Usage:",
-        "  yapi project list --group-id <group_id> [--page <n>] [--limit <n>]",
-        "  yapi project get --id <project_id>",
-        "  yapi project token --project-id <project_id>",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --token-param <name>   token query param name (default: token)",
-        "  --timeout <ms>         request timeout in ms",
-        "  --group-id <id>        group id (for list)",
-        "  --id <id>              project id (for get)",
-        "  --page <n>             page number (default: 1)",
-        "  --limit <n>            page size (default: 10)",
-        "  --no-pretty            print raw response",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function interfaceUsage() {
-    return [
-        "Usage:",
-        "  yapi interface list --project-id <project_id> [--page <n>] [--limit <n>]",
-        "  yapi interface list-menu --project-id <project_id>",
-        "  yapi interface get --id <api_id>",
-        "  yapi interface cat add --project-id <project_id> --name <name> [--desc <desc>]",
-        "  yapi interface cat update --cat-id <cat_id> --name <name> [--desc <desc>]",
-        "  yapi interface cat delete --cat-id <cat_id>",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --token-param <name>   token query param name (default: token)",
-        "  --timeout <ms>         request timeout in ms",
-        "  --id <id>              interface id (for get)",
-        "  --cat-id <id>          category id (for cat update/delete)",
-        "  --name <name>          category name (for cat add/update)",
-        "  --desc <desc>          category description (for cat add/update)",
-        "  --page <n>             page number (default: 1)",
-        "  --limit <n|all>        page size (default: 20)",
-        "  --no-pretty            print raw response",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function logUsage() {
-    return [
-        "Usage:",
-        "  yapi log list --type <type> --type-id <id> [--page <n>] [--limit <n>]",
-        "Options:",
-        "  --config <path>        config file path (default: ~/.yapi/config.toml)",
-        "  --base-url <url>       YApi base URL",
-        "  --token <token>        project token (supports projectId:token)",
-        "  --project-id <id>      select token for project",
-        "  --auth-mode <mode>     token or global",
-        "  --email <email>        login email for global mode",
-        "  --password <pwd>       login password for global mode",
-        "  --cookie <cookie>      cookie for global mode",
-        "  --token-param <name>   token query param name (default: token)",
-        "  --timeout <ms>         request timeout in ms",
-        "  --type <type>          log type (e.g., group/project)",
-        "  --type-id <id>         log type id",
-        "  --page <n>             page number (default: 1)",
-        "  --limit <n>            page size (default: 10)",
-        "  --no-pretty            print raw response",
-        "  -h, --help             show help",
-    ].join("\n");
-}
-function escapeTomlValue(value) {
-    return String(value || "")
-        .replace(/\\/g, "\\\\")
-        .replace(/"/g, '\\"');
-}
-function formatToml(config) {
-    const orderedKeys = ["base_url", "auth_mode", "email", "password", "token", "project_id"];
-    const lines = ["# YApi CLI config"];
-    for (const key of orderedKeys) {
-        const value = config[key] || "";
-        lines.push(`${key} = "${escapeTomlValue(value)}"`);
-    }
-    return `${lines.join("\n")}\n`;
-}
-function writeConfig(filePath, config) {
-    fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
-    fs_1.default.writeFileSync(filePath, formatToml(config), "utf8");
-}
-function promptText(question) {
-    const rl = readline_1.default.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-        terminal: true,
-    });
-    return new Promise((resolve) => {
-        rl.question(question, (answer) => {
-            rl.close();
-            resolve(answer);
-        });
-    });
-}
-function promptHidden(question) {
-    const rl = readline_1.default.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-        terminal: true,
-    });
-    const output = rl.output || process.stdout;
-    const originalWrite = rl
-        ._writeToOutput;
-    if (question) {
-        output.write(question);
-    }
-    rl.stdoutMuted = true;
-    rl._writeToOutput =
-        function writeToOutput(value) {
-            if (rl.stdoutMuted)
-                return;
-            if (typeof originalWrite === "function") {
-                originalWrite.call(this, value);
-            }
-            else {
-                output.write(value);
-            }
-        };
-    return new Promise((resolve) => {
-        rl.question("", (answer) => {
-            rl.stdoutMuted = false;
-            if (question) {
-                output.write("\n");
-            }
-            rl.close();
-            resolve(answer);
-        });
-    });
-}
-async function promptRequired(question, hidden) {
-    while (true) {
-        const answer = hidden ? await promptHidden(question) : await promptText(question);
-        const trimmed = String(answer || "").trim();
-        if (trimmed)
-            return trimmed;
-    }
-}
-async function initConfigIfMissing(options) {
-    const hasBaseUrl = Boolean(options.baseUrl);
-    const hasEmail = Boolean(options.email);
-    const hasPassword = Boolean(options.password);
-    if (!hasBaseUrl || !hasEmail || !hasPassword) {
-        if (!process.stdin.isTTY || !process.stdout.isTTY)
-            return null;
-    }
-    const baseUrl = hasBaseUrl ? options.baseUrl : await promptRequired("YApi base URL: ", false);
-    const email = hasEmail ? options.email : await promptRequired("YApi email: ", false);
-    const password = hasPassword ? options.password : await promptRequired("YApi password: ", true);
-    const config = {
-        base_url: baseUrl || "",
-        auth_mode: "global",
-        email: email || "",
-        password: password || "",
-        token: options.token || "",
-        project_id: options.projectId || "",
-    };
-    const configPath = globalConfigPath();
-    writeConfig(configPath, config);
-    return { configPath, config };
-}
-function readVersion() {
-    try {
-        const pkgPath = path_1.default.resolve(__dirname, "../package.json");
-        const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, "utf8"));
-        return pkg.version || "unknown";
-    }
-    catch {
-        return "unknown";
-    }
-}
-async function runSimpleRequest(rawArgs, usageFn, endpoint, requireBaseUrl, buildQueryItems, transform) {
-    const options = parseArgs(rawArgs);
-    if (options.help) {
-        console.log(usageFn());
-        return 0;
-    }
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    const configPath = options.config || globalConfigPath();
-    const config = fs_1.default.existsSync(configPath)
-        ? parseSimpleToml(fs_1.default.readFileSync(configPath, "utf8"))
-        : {};
-    const baseUrl = options.baseUrl || config.base_url || "";
-    if (requireBaseUrl && !baseUrl) {
-        console.error("missing --base-url or config base_url");
-        return 2;
-    }
-    const projectId = options.projectId || config.project_id || "";
-    const rawToken = options.token || config.token || "";
-    const token = resolveToken(rawToken, projectId);
-    let authMode = (options.authMode || config.auth_mode || "").trim().toLowerCase();
-    if (!authMode) {
-        authMode = token
-            ? "token"
-            : options.email || options.password || config.email || config.password
-                ? "global"
-                : "token";
-    }
-    if (authMode !== "token" && authMode !== "global") {
-        console.error("invalid --auth-mode (use token or global)");
-        return 2;
-    }
-    const headers = {};
-    if (options.cookie) {
-        headers.Cookie = options.cookie;
-    }
-    const email = options.email || config.email || "";
-    const password = options.password || config.password || "";
-    const authService = authMode === "global"
-        ? new auth_1.YApiAuthService(baseUrl, email || "", password || "", "warn", {
-            timeoutMs: options.timeout || 30000,
-        })
-        : null;
-    const canRelogin = authMode === "global" &&
-        Boolean(authService) &&
-        Boolean(email) &&
-        Boolean(password) &&
-        !options.cookie;
-    if (!headers.Cookie && authMode === "global") {
-        const cachedCookie = authService?.getCachedCookieHeader();
-        if (cachedCookie) {
-            headers.Cookie = cachedCookie;
-        }
-        else if (email && password && authService) {
-            try {
-                headers.Cookie = await authService.getCookieHeaderWithLogin();
-            }
-            catch (error) {
-                console.error(error instanceof Error ? error.message : String(error));
-                return 2;
-            }
-        }
-        else {
-            console.error("missing email/password for global auth");
-            return 2;
-        }
-    }
-    let queryItems = [];
-    let method = "GET";
-    let data = undefined;
-    if (buildQueryItems) {
-        const result = buildQueryItems(options);
-        if (!result.ok)
-            return 2;
-        queryItems = result.queryItems || [];
-        if (result.method) {
-            method = result.method;
-        }
-        if (result.data !== undefined) {
-            data = result.data;
-        }
-    }
-    const url = buildUrl(baseUrl, endpoint, queryItems, authMode === "token" ? token : "", options.tokenParam || "token");
-    const sendOnce = async () => {
-        let body;
-        const requestHeaders = { ...headers };
-        if (data !== undefined) {
-            body = JSON.stringify(data);
-            requestHeaders["Content-Type"] = "application/json;charset=UTF-8";
-        }
-        const response = await fetchWithTimeout(url, {
-            method,
-            headers: requestHeaders,
-            body,
-        }, options.timeout || 30000);
-        const text = await response.text();
-        return { response, text, json: parseJsonMaybe(text) };
-    };
-    let result;
-    try {
-        result = await sendOnce();
-    }
-    catch (error) {
-        console.error("request failed: " + (error instanceof Error ? error.message : String(error)));
-        return 2;
-    }
-    if (canRelogin && looksLikeAuthError(result.response.status, result.json)) {
-        try {
-            headers.Cookie = await authService.getCookieHeaderWithLogin({ forceLogin: true });
-            result = await sendOnce();
-        }
-        catch (error) {
-            console.error(error instanceof Error ? error.message : String(error));
-            return 2;
-        }
-    }
-    const { text } = result;
-    if (options.noPretty) {
-        console.log(text);
-        return 0;
-    }
-    try {
-        const payload = result.json ?? JSON.parse(text);
-        const nextPayload = transform ? transform(payload, options) : payload;
-        console.log(JSON.stringify(nextPayload ?? payload, null, 2));
-    }
-    catch {
-        console.log(text);
-    }
-    return 0;
-}
-async function runLogin(rawArgs) {
-    const options = parseArgs(rawArgs);
-    if (options.help) {
-        console.log(loginUsage());
-        return 0;
-    }
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    const configPath = options.config || globalConfigPath();
-    const config = fs_1.default.existsSync(configPath)
-        ? parseSimpleToml(fs_1.default.readFileSync(configPath, "utf8"))
-        : {};
-    let baseUrl = options.baseUrl || config.base_url || "";
-    let email = options.email || config.email || "";
-    let password = options.password || config.password || "";
-    const projectId = options.projectId || config.project_id || "";
-    const token = options.token || config.token || "";
-    let updated = false;
-    if (!baseUrl) {
-        if (!process.stdin.isTTY || !process.stdout.isTTY) {
-            console.error("missing --base-url or config base_url");
-            return 2;
-        }
-        baseUrl = await promptRequired("YApi base URL: ", false);
-        updated = true;
-    }
-    const useBrowserLogin = Boolean(options.browser) || !email || !password;
-    if (useBrowserLogin) {
-        if (!process.stdin.isTTY || !process.stdout.isTTY) {
-            console.error("browser login requires interactive terminal");
-            return 2;
-        }
-        try {
-            const session = await loginByBrowserAndReadCookie(baseUrl, options.loginUrl);
-            const cache = new authCache_1.YApiAuthCache(baseUrl, "warn");
-            cache.saveSession({
-                yapiToken: session.yapiToken,
-                yapiUid: session.yapiUid,
-                expiresAt: session.expiresAt,
-                updatedAt: Date.now(),
-            });
-        }
-        catch (error) {
-            console.error(error instanceof Error ? error.message : String(error));
-            return 2;
-        }
-        const shouldWriteConfig = updated || !fs_1.default.existsSync(configPath) || config.auth_mode !== "global";
-        if (shouldWriteConfig) {
-            const mergedConfig = {
-                base_url: baseUrl,
-                auth_mode: "global",
-                email,
-                password,
-                token,
-                project_id: projectId,
-            };
-            writeConfig(configPath, mergedConfig);
-        }
-        console.log("login success (cookie synced from browser to ~/.yapi-mcp/auth-*.json)");
-        return 0;
-    }
-    try {
-        const authService = new auth_1.YApiAuthService(baseUrl, email, password, "warn", {
-            timeoutMs: options.timeout || 30000,
-        });
-        await authService.getCookieHeaderWithLogin({ forceLogin: true });
-    }
-    catch (error) {
-        console.error(error instanceof Error ? error.message : String(error));
-        return 2;
-    }
-    const shouldWriteConfig = updated || !fs_1.default.existsSync(configPath) || config.auth_mode !== "global";
-    if (shouldWriteConfig) {
-        const mergedConfig = {
-            base_url: baseUrl,
-            auth_mode: "global",
-            email,
-            password,
-            token,
-            project_id: projectId,
-        };
-        writeConfig(configPath, mergedConfig);
-    }
-    console.log("login success (cookie cached in ~/.yapi-mcp/auth-*.json)");
-    return 0;
-}
-async function runLogout(rawArgs) {
-    const options = parseArgs(rawArgs);
-    if (options.help) {
-        console.log(logoutUsage());
-        return 0;
-    }
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    const configPath = options.config || globalConfigPath();
-    const config = fs_1.default.existsSync(configPath)
-        ? parseSimpleToml(fs_1.default.readFileSync(configPath, "utf8"))
-        : {};
-    const baseUrl = options.baseUrl || config.base_url || "";
-    if (!baseUrl) {
-        console.error("missing --base-url or config base_url");
-        return 2;
-    }
-    const cache = new authCache_1.YApiAuthCache(baseUrl, "warn");
-    cache.clearSession();
-    console.log("logout success (session cleared from ~/.yapi-mcp/auth-*.json)");
-    return 0;
-}
-async function runWhoami(rawArgs) {
-    return await runSimpleRequest(rawArgs, whoamiUsage, "/api/user/status", true);
-}
-async function runSearch(rawArgs) {
-    return await runSimpleRequest(rawArgs, searchUsage, "/api/project/search", true, (options) => {
-        const keyword = String(options.q || "").trim();
-        if (!keyword) {
-            console.error("missing --q for search");
-            return { ok: false };
-        }
-        return { ok: true, queryItems: [["q", keyword]] };
-    }, (payload, options) => {
-        const filterProjectId = String(options.projectId || "").trim();
-        if (!filterProjectId)
-            return payload;
-        if (!payload || typeof payload !== "object")
-            return payload;
-        const record = payload;
-        const data = record.data;
-        if (!data || typeof data !== "object")
-            return payload;
-        const nextData = { ...data };
-        if (Array.isArray(data.interface)) {
-            nextData.interface = data.interface.filter((item) => {
-                const projectId = item?.projectId ?? item?.project_id ?? item?.projectID ?? "";
-                return String(projectId) === filterProjectId;
-            });
-        }
-        if (Array.isArray(data.project)) {
-            nextData.project = data.project.filter((item) => {
-                const projectId = item?._id ?? item?.id ?? item?.project_id ?? item?.projectId ?? "";
-                return String(projectId) === filterProjectId;
-            });
-        }
-        return { ...record, data: nextData };
-    });
-}
-async function runGroup(rawArgs) {
-    const action = (rawArgs[0] || "list").toLowerCase();
-    const options = parseArgs(rawArgs.slice(1));
-    if (options.help) {
-        console.log(groupUsage());
-        return 0;
-    }
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    if (action === "list") {
-        return await runSimpleRequest(rawArgs.slice(1), groupUsage, "/api/group/list", true);
-    }
-    if (action === "get") {
-        return await runSimpleRequest(rawArgs.slice(1), groupUsage, "/api/group/get", true, (opts) => {
-            const id = String(opts.id || "").trim();
-            if (!id) {
-                console.error("missing --id for group get");
-                return { ok: false };
-            }
-            return { ok: true, queryItems: [["id", id]] };
-        });
-    }
-    console.error(`unknown group action: ${action}`);
-    console.error(groupUsage());
-    return 2;
-}
-async function runProject(rawArgs) {
-    const action = (rawArgs[0] || "list").toLowerCase();
-    const options = parseArgs(rawArgs.slice(1));
-    if (options.help) {
-        console.log(projectUsage());
-        return 0;
-    }
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    if (action === "list") {
-        return await runSimpleRequest(rawArgs.slice(1), projectUsage, "/api/project/list", true, (opts) => {
-            const groupId = String(opts.groupId || "").trim();
-            if (!groupId) {
-                console.error("missing --group-id for project list");
-                return { ok: false };
-            }
-            const page = Number.isFinite(opts.page ?? NaN) ? String(opts.page) : "1";
-            const limit = resolveLimit(opts.limit, "10");
-            return {
-                ok: true,
-                queryItems: [
-                    ["group_id", groupId],
-                    ["page", page],
-                    ["limit", limit],
-                ],
-            };
-        });
-    }
-    if (action === "get") {
-        return await runSimpleRequest(rawArgs.slice(1), projectUsage, "/api/project/get", true, (opts) => {
-            const id = String(opts.id || "").trim();
-            if (!id) {
-                console.error("missing --id for project get");
-                return { ok: false };
-            }
-            return { ok: true, queryItems: [["id", id]] };
-        });
-    }
-    if (action === "token") {
-        return await runSimpleRequest(rawArgs.slice(1), projectUsage, "/api/project/token", true, (opts) => {
-            const projectId = String(opts.projectId || opts.id || "").trim();
-            if (!projectId) {
-                console.error("missing --project-id for project token");
-                return { ok: false };
-            }
-            return { ok: true, queryItems: [["project_id", projectId]] };
-        });
-    }
-    console.error(`unknown project action: ${action}`);
-    console.error(projectUsage());
-    return 2;
-}
-async function runInterface(rawArgs) {
-    const action = (rawArgs[0] || "").toLowerCase();
-    const options = parseArgs(rawArgs.slice(1));
-    if (options.help) {
-        console.log(interfaceUsage());
-        return 0;
-    }
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    if (action === "list") {
-        return await runSimpleRequest(rawArgs.slice(1), interfaceUsage, "/api/interface/list", true, (opts) => {
-            const projectId = String(opts.projectId || "").trim();
-            if (!projectId) {
-                console.error("missing --project-id for interface list");
-                return { ok: false };
-            }
-            const page = Number.isFinite(opts.page ?? NaN) ? String(opts.page) : "1";
-            const limit = resolveLimit(opts.limit, "20");
-            return {
-                ok: true,
-                queryItems: [
-                    ["project_id", projectId],
-                    ["page", page],
-                    ["limit", limit],
-                ],
-            };
-        });
-    }
-    if (action === "list-menu" || action === "menu" || action === "list_menu") {
-        return await runSimpleRequest(rawArgs.slice(1), interfaceUsage, "/api/interface/list_menu", true, (opts) => {
-            const projectId = String(opts.projectId || "").trim();
-            if (!projectId) {
-                console.error("missing --project-id for interface list-menu");
-                return { ok: false };
-            }
-            return { ok: true, queryItems: [["project_id", projectId]] };
-        });
-    }
-    if (action === "get") {
-        return await runSimpleRequest(rawArgs.slice(1), interfaceUsage, "/api/interface/get", true, (opts) => {
-            const id = String(opts.id || "").trim();
-            if (!id) {
-                console.error("missing --id for interface get");
-                return { ok: false };
-            }
-            return { ok: true, queryItems: [["id", id]] };
-        });
-    }
-    if (action === "cat" || action === "category") {
-        const subAction = (rawArgs[1] || "").toLowerCase();
-        const subArgs = rawArgs.slice(2);
-        if (subAction === "add") {
-            return await runSimpleRequest(subArgs, interfaceUsage, "/api/interface/add_cat", true, (opts) => {
-                const projectId = String(opts.projectId || "").trim();
-                const name = String(opts.name || "").trim();
-                if (!projectId || !name) {
-                    console.error("missing --project-id/--name for interface cat add");
-                    return { ok: false };
-                }
-                const payload = {
-                    project_id: projectId,
-                    name,
-                };
-                if (opts.desc !== undefined) {
-                    payload.desc = opts.desc;
-                }
-                return { ok: true, method: "POST", data: payload };
-            });
-        }
-        if (subAction === "update" || subAction === "up") {
-            return await runSimpleRequest(subArgs, interfaceUsage, "/api/interface/up_cat", true, (opts) => {
-                const catId = String(opts.catId || "").trim();
-                const name = String(opts.name || "").trim();
-                if (!catId || !name) {
-                    console.error("missing --cat-id/--name for interface cat update");
-                    return { ok: false };
-                }
-                const payload = {
-                    catid: catId,
-                    name,
-                };
-                if (opts.desc !== undefined) {
-                    payload.desc = opts.desc;
-                }
-                return { ok: true, method: "POST", data: payload };
-            });
-        }
-        if (subAction === "delete" || subAction === "del" || subAction === "remove") {
-            return await runSimpleRequest(subArgs, interfaceUsage, "/api/interface/del_cat", true, (opts) => {
-                const catId = String(opts.catId || "").trim();
-                if (!catId) {
-                    console.error("missing --cat-id for interface cat delete");
-                    return { ok: false };
-                }
-                return { ok: true, method: "POST", data: { catid: catId } };
-            });
-        }
-        console.error(`unknown interface cat action: ${subAction || "(missing)"}`);
-        console.error(interfaceUsage());
-        return 2;
-    }
-    console.error(`unknown interface action: ${action || "(missing)"}`);
-    console.error(interfaceUsage());
-    return 2;
-}
-async function runLog(rawArgs) {
-    const action = (rawArgs[0] || "list").toLowerCase();
-    const options = parseArgs(rawArgs.slice(1));
-    if (options.help) {
-        console.log(logUsage());
-        return 0;
-    }
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    if (action === "list") {
-        return await runSimpleRequest(rawArgs.slice(1), logUsage, "/api/log/list", true, (opts) => {
-            const type = String(opts.type || "").trim();
-            const typeId = String(opts.typeId || "").trim();
-            if (!type || !typeId) {
-                console.error("missing --type/--type-id for log list");
-                return { ok: false };
-            }
-            const page = Number.isFinite(opts.page ?? NaN) ? String(opts.page) : "1";
-            const limit = resolveLimit(opts.limit, "10");
-            return {
-                ok: true,
-                queryItems: [
-                    ["type", type],
-                    ["typeid", typeId],
-                    ["page", page],
-                    ["limit", limit],
-                ],
-            };
-        });
-    }
-    console.error(`unknown log action: ${action}`);
-    console.error(logUsage());
-    return 2;
-}
-function findDocsSyncHome(startDir) {
-    let current = path_1.default.resolve(startDir);
-    while (true) {
-        const candidate = path_1.default.join(current, ".yapi");
-        if (fs_1.default.existsSync(candidate) && fs_1.default.statSync(candidate).isDirectory()) {
-            return candidate;
-        }
-        const parent = path_1.default.dirname(current);
-        if (parent === current)
-            return null;
-        current = parent;
-    }
-}
-function resolveDocsSyncHome(startDir, ensure) {
-    const found = findDocsSyncHome(startDir);
-    if (found)
-        return found;
-    if (!ensure)
-        return null;
-    const home = path_1.default.join(path_1.default.resolve(startDir), ".yapi");
-    fs_1.default.mkdirSync(home, { recursive: true });
-    ensureDocsSyncReadme(home);
-    return home;
-}
-function globalYapiHomeDir() {
-    return path_1.default.resolve(process.env.YAPI_HOME || path_1.default.join(os_1.default.homedir(), ".yapi"));
-}
-function normalizeComparablePath(targetPath) {
-    try {
-        return fs_1.default.realpathSync.native(targetPath);
-    }
-    catch {
-        return path_1.default.resolve(targetPath);
-    }
-}
-function isGlobalDocsSyncHome(homeDir) {
-    return normalizeComparablePath(homeDir) === normalizeComparablePath(globalYapiHomeDir());
-}
-function docsSyncConfigPath(homeDir) {
-    return path_1.default.join(homeDir, "docs-sync.json");
-}
-function docsSyncLinksPath(homeDir) {
-    return path_1.default.join(homeDir, "docs-sync.links.json");
-}
-function docsSyncProjectsPath(homeDir) {
-    return path_1.default.join(homeDir, "docs-sync.projects.json");
-}
-function docsSyncDeploymentsPath(homeDir) {
-    return path_1.default.join(homeDir, "docs-sync.deployments.json");
-}
-const DOCS_SYNC_README = [
-    "# YApi Docs Sync",
-    "",
-    "This folder is generated by the yapi docs-sync tool.",
-    "Extra caches are written when running docs-sync with bindings.",
-    "",
-    "Project: https://github.com/leeguooooo/cross-request-master",
-    "",
-    "Files:",
-    "- docs-sync.json: bindings and file-to-doc ID mapping.",
-    "- docs-sync.links.json: local docs to YApi doc URLs.",
-    "- docs-sync.projects.json: cached project metadata/envs.",
-    "- docs-sync.deployments.json: local docs to deployed URLs.",
-].join("\n");
-function ensureDocsSyncReadme(homeDir) {
-    const readmePath = path_1.default.join(homeDir, "README.md");
-    if (fs_1.default.existsSync(readmePath))
-        return;
-    fs_1.default.writeFileSync(readmePath, `${DOCS_SYNC_README}\n`, "utf8");
-}
-function loadDocsSyncConfig(homeDir) {
-    const configPath = docsSyncConfigPath(homeDir);
-    if (!fs_1.default.existsSync(configPath)) {
-        return { version: 1, bindings: {} };
-    }
-    const raw = fs_1.default.readFileSync(configPath, "utf8");
-    const parsed = JSON.parse(raw);
-    const bindings = parsed.bindings && typeof parsed.bindings === "object" ? parsed.bindings : {};
-    return {
-        version: typeof parsed.version === "number" ? parsed.version : 1,
-        bindings: bindings,
-    };
-}
-function saveDocsSyncConfig(homeDir, config) {
-    const configPath = docsSyncConfigPath(homeDir);
-    fs_1.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
-}
-function loadDocsSyncLinks(homeDir) {
-    const configPath = docsSyncLinksPath(homeDir);
-    if (!fs_1.default.existsSync(configPath)) {
-        return { version: 1, bindings: {} };
-    }
-    const raw = fs_1.default.readFileSync(configPath, "utf8");
-    const parsed = JSON.parse(raw);
-    const bindings = parsed.bindings && typeof parsed.bindings === "object" ? parsed.bindings : {};
+const login_1 = require("./cli/commands/login");
+const logout_1 = require("./cli/commands/logout");
+const whoami_1 = require("./cli/commands/whoami");
+const search_1 = require("./cli/commands/search");
+const group_1 = require("./cli/commands/group");
+const project_1 = require("./cli/commands/project");
+const interface_1 = require("./cli/commands/interface");
+const log_1 = require("./cli/commands/log");
+const docs_sync_1 = require("./cli/commands/docs-sync");
+const self_update_1 = require("./cli/commands/self-update");
+const install_skill_1 = require("./cli/commands/install-skill");
+const request_1 = require("./cli/commands/request");
+const col_1 = require("./cli/commands/col");
+const export_1 = require("./cli/commands/export");
+const env_1 = require("./cli/commands/env");
+const member_1 = require("./cli/commands/member");
+const follow_1 = require("./cli/commands/follow");
+const user_1 = require("./cli/commands/user");
+function toOptions(argv) {
     return {
-        version: typeof parsed.version === "number" ? parsed.version : 1,
-        bindings: bindings,
+        config: argv.config,
+        baseUrl: (argv.baseUrl || argv["base-url"]),
+        loginUrl: (argv.loginUrl || argv["login-url"]),
+        token: argv.token,
+        projectId: (argv.projectId || argv["project-id"]),
+        authMode: (argv.authMode || argv["auth-mode"]),
+        browser: argv.browser,
+        email: argv.email,
+        password: argv.password,
+        cookie: argv.cookie,
+        tokenParam: (argv.tokenParam || argv["token-param"]),
+        method: argv.method,
+        path: argv.path,
+        url: argv.url,
+        query: argv.query ? (Array.isArray(argv.query) ? argv.query : [argv.query]) : [],
+        header: argv.header ? (Array.isArray(argv.header) ? argv.header : [argv.header]) : [],
+        data: argv.data,
+        dataFile: (argv.dataFile || argv["data-file"]),
+        timeout: argv.timeout,
+        id: argv.id,
+        name: argv.name,
+        desc: argv.desc,
+        catId: (argv.catId || argv["cat-id"] || argv.catid),
+        groupId: (argv.groupId || argv["group-id"]),
+        type: argv.type,
+        typeId: (argv.typeId || argv["type-id"]),
+        page: argv.page,
+        limit: argv.limit,
+        noUpdate: (argv.noUpdate || argv["no-update"]),
+        q: argv.q,
+        noPretty: (argv.noPretty || argv["no-pretty"]),
     };
 }
-function saveDocsSyncLinks(homeDir, config) {
-    const configPath = docsSyncLinksPath(homeDir);
-    fs_1.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
-}
-function loadDocsSyncProjects(homeDir) {
-    const configPath = docsSyncProjectsPath(homeDir);
-    if (!fs_1.default.existsSync(configPath)) {
-        return { version: 1, projects: {} };
-    }
-    const raw = fs_1.default.readFileSync(configPath, "utf8");
-    const parsed = JSON.parse(raw);
-    const projects = parsed.projects && typeof parsed.projects === "object" ? parsed.projects : {};
+function toDocsSyncOptions(argv) {
+    const rawDirs = argv.dir
+        ? (Array.isArray(argv.dir) ? argv.dir : [argv.dir])
+        : [];
+    const positionalDirs = Array.isArray(argv._)
+        ? argv._.map(String).filter((s) => s && s !== "docs-sync")
+        : [];
     return {
-        version: typeof parsed.version === "number" ? parsed.version : 1,
-        projects: projects,
+        config: argv.config,
+        baseUrl: (argv.baseUrl || argv["base-url"]),
+        token: argv.token,
+        projectId: (argv.projectId || argv["project-id"]),
+        authMode: (argv.authMode || argv["auth-mode"]),
+        email: argv.email,
+        password: argv.password,
+        cookie: argv.cookie,
+        tokenParam: (argv.tokenParam || argv["token-param"]),
+        timeout: argv.timeout,
+        dirs: rawDirs.length ? rawDirs : positionalDirs,
+        bindings: argv.binding ? (Array.isArray(argv.binding) ? argv.binding : [argv.binding]) : [],
+        dryRun: (argv.dryRun || argv["dry-run"]),
+        noMermaid: (argv.noMermaid || argv["no-mermaid"]),
+        mermaidLook: argv["mermaid-classic"] ? "classic" : "handDrawn",
+        mermaidHandDrawnSeed: argv["mermaid-hand-drawn-seed"],
+        force: argv.force,
     };
 }
-function saveDocsSyncProjects(homeDir, config) {
-    const configPath = docsSyncProjectsPath(homeDir);
-    fs_1.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
-}
-function loadDocsSyncDeployments(homeDir) {
-    const configPath = docsSyncDeploymentsPath(homeDir);
-    if (!fs_1.default.existsSync(configPath)) {
-        return { version: 1, bindings: {} };
-    }
-    const raw = fs_1.default.readFileSync(configPath, "utf8");
-    const parsed = JSON.parse(raw);
-    const bindings = parsed.bindings && typeof parsed.bindings === "object" ? parsed.bindings : {};
+function toDocsSyncBindArgs(argv) {
     return {
-        version: typeof parsed.version === "number" ? parsed.version : 1,
-        bindings: bindings,
+        name: (argv.name || argv.binding),
+        dir: argv.dir,
+        projectId: argv["project-id"] !== undefined ? Number(argv["project-id"]) : undefined,
+        catId: argv.catid !== undefined ? Number(argv.catid) : (argv["cat-id"] !== undefined ? Number(argv["cat-id"]) : undefined),
+        templateId: argv["template-id"] !== undefined ? Number(argv["template-id"]) : undefined,
+        sourceFiles: argv["source-file"] ? (Array.isArray(argv["source-file"]) ? argv["source-file"] : [argv["source-file"]]) : [],
+        clearSourceFiles: argv["clear-source-files"],
     };
 }
-function saveDocsSyncDeployments(homeDir, config) {
-    const configPath = docsSyncDeploymentsPath(homeDir);
-    fs_1.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
-}
-function resolveBindingDir(rootDir, bindingDir) {
-    if (!bindingDir)
-        return rootDir;
-    return path_1.default.isAbsolute(bindingDir) ? bindingDir : path_1.default.resolve(rootDir, bindingDir);
-}
-function normalizeBindingDir(rootDir, bindingDir) {
-    const resolved = resolveBindingDir(rootDir, bindingDir);
-    const relative = path_1.default.relative(rootDir, resolved);
-    if (!relative || relative === ".")
-        return ".";
-    if (relative.startsWith("..") || path_1.default.isAbsolute(relative))
-        return resolved;
-    return relative;
-}
-function getBindingBaseDir(homeDir, rootDir, cwd) {
-    if (!isGlobalDocsSyncHome(homeDir)) {
-        return { baseDir: rootDir, gitRoot: findGitRoot(cwd), usedGitRoot: false };
-    }
-    const gitRoot = findGitRoot(cwd);
-    if (gitRoot) {
-        return { baseDir: gitRoot, gitRoot, usedGitRoot: true };
-    }
-    return { baseDir: path_1.default.resolve(cwd), gitRoot: null, usedGitRoot: false };
-}
-function normalizeBindingDirForContext(homeDir, rootDir, cwd, bindingDir) {
-    const context = getBindingBaseDir(homeDir, rootDir, cwd);
-    const resolved = path_1.default.isAbsolute(bindingDir)
-        ? bindingDir
-        : path_1.default.resolve(context.baseDir, bindingDir);
-    const relative = path_1.default.relative(rootDir, resolved);
-    if (!relative || relative === ".")
-        return ".";
-    if (relative.startsWith("..") || path_1.default.isAbsolute(relative))
-        return resolved;
-    return relative;
-}
-function resolveBindingDirForContext(homeDir, rootDir, cwd, bindingDir) {
-    if (!bindingDir)
-        return rootDir;
-    if (path_1.default.isAbsolute(bindingDir))
-        return bindingDir;
-    const direct = path_1.default.resolve(rootDir, bindingDir);
-    if (!isGlobalDocsSyncHome(homeDir))
-        return direct;
-    if (fs_1.default.existsSync(direct))
-        return direct;
-    const { baseDir } = getBindingBaseDir(homeDir, rootDir, cwd);
-    const contextual = path_1.default.resolve(baseDir, bindingDir);
-    if (fs_1.default.existsSync(contextual))
-        return contextual;
-    return direct;
-}
-function suggestDocsSyncDir(startDir) {
-    const candidates = ["docs", "doc", "documentation", "release-notes"];
-    for (const candidate of candidates) {
-        const candidatePath = path_1.default.resolve(startDir, candidate);
-        if (fs_1.default.existsSync(candidatePath) && fs_1.default.statSync(candidatePath).isDirectory()) {
-            const relative = path_1.default.relative(startDir, candidatePath);
-            return relative && relative !== "." ? relative : candidate;
-        }
-    }
-    return null;
-}
-function loadMapping(dirPath) {
-    const mappingPath = path_1.default.join(dirPath, ".yapi.json");
-    if (!fs_1.default.existsSync(mappingPath)) {
-        return { mapping: {}, mappingPath };
-    }
-    const raw = fs_1.default.readFileSync(mappingPath, "utf8");
-    const mapping = JSON.parse(raw);
-    return { mapping, mappingPath };
-}
-function saveMapping(mapping, mappingPath) {
-    fs_1.default.writeFileSync(mappingPath, `${JSON.stringify(mapping, null, 2)}\n`, "utf8");
-}
-function buildDocsSyncHash(markdown, options) {
-    const hash = crypto_1.default.createHash("sha1");
-    hash.update(options.noMermaid ? "no-mermaid\n" : "mermaid\n");
-    if (!options.noMermaid) {
-        if (options.mermaidLook) {
-            hash.update(`mermaid-look:${options.mermaidLook}\n`);
-        }
-        if (Number.isFinite(options.mermaidHandDrawnSeed ?? NaN)) {
-            hash.update(`mermaid-seed:${options.mermaidHandDrawnSeed}\n`);
-        }
-    }
-    hash.update(markdown);
-    return hash.digest("hex");
-}
-function resolveSourceFiles(dirPath, mapping) {
-    const sources = Array.isArray(mapping.source_files) ? mapping.source_files : [];
-    if (!sources.length) {
-        return fs_1.default
-            .readdirSync(dirPath)
-            .filter((name) => name.endsWith(".md") && name !== "README.md")
-            .map((name) => path_1.default.join(dirPath, name))
-            .sort((a, b) => a.localeCompare(b));
-    }
-    return sources.map((source) => {
-        const resolved = path_1.default.isAbsolute(source) ? source : path_1.default.resolve(dirPath, source);
-        if (!fs_1.default.existsSync(resolved) || !fs_1.default.statSync(resolved).isFile()) {
-            throw new Error(`source file not found: ${resolved}`);
-        }
-        return resolved;
-    });
-}
-function normalizeUiBaseUrl(baseUrl) {
-    const trimmed = String(baseUrl || "")
-        .trim()
-        .replace(/\/+$/, "");
-    if (!trimmed)
-        return "";
-    return trimmed.endsWith("/api") ? trimmed.slice(0, -4) : trimmed;
-}
-function buildInterfaceWebUrl(baseUrl, projectId, apiId) {
-    const base = normalizeUiBaseUrl(baseUrl);
-    const pid = encodeURIComponent(String(projectId ?? ""));
-    const aid = encodeURIComponent(String(apiId ?? ""));
-    if (!base || !pid || !aid)
-        return "";
-    return `${base}/project/${pid}/interface/api/${aid}`;
-}
-function normalizePathSegment(value) {
-    const trimmed = String(value || "").trim();
-    if (!trimmed || trimmed === "/")
-        return "";
-    const noTrailing = trimmed.replace(/\/+$/, "");
-    return noTrailing.startsWith("/") ? noTrailing : `/${noTrailing}`;
-}
-function buildEnvUrl(domain, basepath, apiPath) {
-    const base = String(domain || "")
-        .trim()
-        .replace(/\/+$/, "");
-    if (!base)
-        return "";
-    const normalizedBasepath = normalizePathSegment(basepath);
-    const normalizedPath = normalizePathSegment(apiPath);
-    return `${base}${normalizedBasepath}${normalizedPath}`;
-}
-function normalizeProjectEnvs(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    const result = [];
-    raw.forEach((item) => {
-        const name = item && typeof item === "object" && "name" in item
-            ? String(item.name || "").trim()
-            : "";
-        const domain = item && typeof item === "object" && "domain" in item
-            ? String(item.domain || "").trim()
-            : "";
-        if (!domain)
-            return;
-        result.push({ name: name || domain, domain });
-    });
-    return result;
-}
-function resolveLimit(value, fallback) {
-    if (typeof value === "string") {
-        const trimmed = value.trim();
-        if (trimmed)
-            return trimmed;
-    }
-    if (Number.isFinite(value ?? NaN)) {
-        return String(value);
-    }
-    return fallback;
-}
-const UPDATE_CHECK_TTL_MS = 12 * 60 * 60 * 1000;
-function updateCachePath() {
-    const yapiHome = process.env.YAPI_HOME || path_1.default.join(os_1.default.homedir(), ".yapi");
-    return path_1.default.join(yapiHome, "update.json");
-}
-function readUpdateCache() {
-    try {
-        const cachePath = updateCachePath();
-        if (!fs_1.default.existsSync(cachePath))
-            return {};
-        const raw = fs_1.default.readFileSync(cachePath, "utf8");
-        const parsed = JSON.parse(raw);
-        return parsed && typeof parsed === "object" ? parsed : {};
-    }
-    catch {
-        return {};
-    }
-}
-function writeUpdateCache(cache) {
-    try {
-        const cachePath = updateCachePath();
-        fs_1.default.mkdirSync(path_1.default.dirname(cachePath), { recursive: true });
-        fs_1.default.writeFileSync(cachePath, `${JSON.stringify(cache, null, 2)}\n`, "utf8");
-    }
-    catch {
-    }
-}
-function compareSemver(a, b) {
-    const toParts = (value) => String(value || "")
-        .trim()
-        .split(".")
-        .map((part) => Number(part.replace(/\D/g, "")) || 0);
-    const aParts = toParts(a);
-    const bParts = toParts(b);
-    const len = Math.max(aParts.length, bParts.length);
-    for (let i = 0; i < len; i += 1) {
-        const diff = (aParts[i] || 0) - (bParts[i] || 0);
-        if (diff !== 0)
-            return diff;
-    }
-    return 0;
-}
-function isNewerVersion(latest, current) {
-    return compareSemver(latest, current) > 0;
-}
 async function fetchLatestVersion(timeoutMs) {
     try {
         const encoded = encodeURIComponent("@leeguoo/yapi-mcp");
         const url = `https://registry.npmjs.org/${encoded}/latest`;
-        const response = await fetchWithTimeout(url, { method: "GET" }, timeoutMs);
+        const response = await (0, http_1.fetchWithTimeout)(url, { method: "GET" }, timeoutMs);
         if (!response.ok)
             return null;
         const payload = (await response.json());
@@ -2134,13 +121,13 @@ async function checkForUpdates(options) {
         return;
     if (process.env.CI === "1")
         return;
-    const currentVersion = readVersion();
+    const currentVersion = (0, utils_1.readVersion)();
     if (!currentVersion || currentVersion === "unknown")
         return;
-    const cache = readUpdateCache();
+    const cache = (0, utils_1.readUpdateCache)();
     const now = Date.now();
     let latest = cache.latest;
-    const shouldCheck = !cache.lastChecked || now - cache.lastChecked > UPDATE_CHECK_TTL_MS || !latest;
+    const shouldCheck = !cache.lastChecked || now - cache.lastChecked > utils_1.UPDATE_CHECK_TTL_MS || !latest;
     if (shouldCheck) {
         const fetched = await fetchLatestVersion(2000);
         if (fetched) {
@@ -2149,23 +136,23 @@ async function checkForUpdates(options) {
         }
         cache.lastChecked = now;
     }
-    if (!latest || !isNewerVersion(latest, currentVersion)) {
-        writeUpdateCache(cache);
+    if (!latest || !(0, utils_1.isNewerVersion)(latest, currentVersion)) {
+        (0, utils_1.writeUpdateCache)(cache);
         return;
     }
-    const shouldNotify = cache.lastNotified !== latest || !cache.lastNotifiedAt || now - cache.lastNotifiedAt > UPDATE_CHECK_TTL_MS;
+    const shouldNotify = cache.lastNotified !== latest || !cache.lastNotifiedAt || now - cache.lastNotifiedAt > utils_1.UPDATE_CHECK_TTL_MS;
     if (shouldNotify) {
         console.warn(`update available: ${currentVersion} -> ${latest}. Run: npm install -g @leeguoo/yapi-mcp@latest`);
         console.warn("or: pnpm add -g @leeguoo/yapi-mcp@latest");
         cache.lastNotified = latest;
         cache.lastNotifiedAt = now;
     }
-    writeUpdateCache(cache);
+    (0, utils_1.writeUpdateCache)(cache);
 }
 function warnIfInstalledSkillsOutdated(options) {
     if (options.skip)
         return;
-    const currentVersion = readVersion();
+    const currentVersion = (0, utils_1.readVersion)();
     if (!currentVersion || currentVersion === "unknown")
         return;
     const outdated = (0, metadata_1.findOutdatedSkillInstalls)(currentVersion);
@@ -2176,1043 +163,363 @@ function warnIfInstalledSkillsOutdated(options) {
         .join(", ");
     console.warn(`skill update available: installed ${summary}, current ${currentVersion}. Run: yapi install-skill --force`);
 }
-function runSelfUpdate(rawArgs) {
-    if (rawArgs.includes("-h") || rawArgs.includes("--help")) {
-        console.log(selfUpdateUsage());
-        return 0;
-    }
-    try {
-        (0, child_process_1.execFileSync)(resolveLocalBin("npm"), ["install", "-g", "@leeguoo/yapi-mcp@latest"], {
-            stdio: "inherit",
-        });
-        console.log("Updated yapi CLI to latest.");
-        return 0;
-    }
-    catch (error) {
-        console.error(error instanceof Error ? error.message : String(error));
-        return 2;
-    }
-}
-async function fetchProjectInfo(projectId, baseUrl, request) {
-    if (!projectId)
-        return null;
-    const resp = await request("/api/project/get", "GET", { id: projectId });
-    if (resp?.errcode !== 0) {
-        throw new Error(`project get failed: ${resp?.errmsg || "unknown error"}`);
-    }
-    const data = resp?.data || {};
-    const name = typeof data.name === "string" ? data.name : "";
-    const basepath = typeof data.basepath === "string" ? data.basepath : "";
-    const envs = normalizeProjectEnvs(data.env || data.envs);
-    return {
-        project_id: Number(projectId),
-        name,
-        basepath,
-        envs,
-        base_url: baseUrl,
-    };
-}
-async function listExistingInterfaces(catId, request) {
-    const resp = await request("/api/interface/list_cat", "GET", {
-        catid: catId,
-        page: 1,
-        limit: 10000,
-    });
-    if (resp?.errcode !== 0) {
-        throw new Error(`list_cat failed: ${resp?.errmsg || "unknown error"}`);
-    }
-    const items = resp?.data?.list || [];
-    const byPath = {};
-    const byTitle = {};
-    const byId = {};
-    for (const item of items) {
-        const apiPath = item?.path;
-        const title = item?.title;
-        const itemId = item?._id;
-        if (apiPath && itemId)
-            byPath[apiPath] = Number(itemId);
-        if (title && itemId)
-            byTitle[title] = Number(itemId);
-        if (itemId) {
-            byId[String(itemId)] = { path: apiPath || "", title: title || "" };
-        }
-    }
-    return { byPath, byTitle, byId };
-}
-function buildAddPayload(template, title, apiPath, catId, projectId) {
-    return {
-        title,
-        path: apiPath,
-        method: template.method || "GET",
-        catid: catId,
-        project_id: projectId,
-        status: template.status || "undone",
-        type: template.type || "static",
-        api_opened: template.api_opened || false,
-        req_query: template.req_query || [],
-        req_headers: template.req_headers || [],
-        req_params: template.req_params || [],
-        req_body_type: template.req_body_type || "json",
-        req_body_form: template.req_body_form || [],
-        req_body_is_json_schema: template.req_body_is_json_schema ?? true,
-        res_body_type: template.res_body_type || "json",
-        res_body: template.res_body || '{"type":"object","title":"title","properties":{}}',
-        res_body_is_json_schema: template.res_body_is_json_schema ?? true,
-        tag: template.tag || [],
-    };
-}
-function buildUpdatePayload(docId, title, markdown, html) {
-    const payload = { id: docId, markdown, desc: html };
-    if (title) {
-        payload.title = title;
-    }
-    return payload;
-}
-function pickLargestMermaid(metrics) {
-    return metrics
-        .filter((item) => item.renderer === "mermaid")
-        .sort((a, b) => b.renderedBytes - a.renderedBytes)[0];
-}
-function buildDocsSyncPreviewLine(item) {
-    const parts = [
-        `file=${item.fileName}`,
-        `action=${item.action}`,
-        `markdown=${formatBytes(item.markdownBytes)}`,
-        `html=${formatBytes(item.htmlBytes)}`,
-        `payload=${formatBytes(item.payloadBytes)}`,
-        `path=${item.apiPath}`,
-    ];
-    if (item.docId) {
-        parts.push(`doc_id=${item.docId}`);
-    }
-    if (item.largestMermaid) {
-        parts.push(`largest_mermaid=#${item.largestMermaid.index}`, `largest_mermaid_svg=${formatBytes(item.largestMermaid.renderedBytes)}`);
-    }
-    return `preview ${parts.join(" ")}`;
-}
-function buildDocsSyncPayloadTooLargeMessage(fileName, preview, error) {
-    const lines = [
-        `413 Payload Too Large while syncing ${fileName}`,
-        `- request payload: ${formatBytes(preview.payloadBytes)}`,
-        `- markdown size: ${formatBytes(preview.markdownBytes)}`,
-        `- rendered html size: ${formatBytes(preview.htmlBytes)}`,
-    ];
-    const limitBytes = parsePayloadLimit(error.body || error.message);
-    if (limitBytes) {
-        lines.push(`- server limit: ${formatBytes(limitBytes)}`);
-    }
-    else {
-        lines.push("- server limit: unknown (response did not expose an exact value)");
-    }
-    if (preview.largestMermaid) {
-        lines.push(`- largest Mermaid block: #${preview.largestMermaid.index} -> ${formatBytes(preview.largestMermaid.renderedBytes)}`);
-    }
-    else {
-        lines.push("- largest Mermaid block: none");
-    }
-    lines.push("- suggestion: run `yapi docs-sync --dry-run ...` to preview all files before upload");
-    lines.push("- suggestion: split oversized Mermaid diagrams or move them into separate docs");
-    return lines.join("\n");
-}
-async function addInterface(title, apiPath, mapping, request) {
-    const projectId = Number(mapping.project_id || 0);
-    const catId = Number(mapping.catid || 0);
-    if (!projectId || !catId) {
-        throw new Error("project_id and catid are required to create new docs");
-    }
-    let template = {};
-    if (mapping.template_id) {
-        const resp = await request("/api/interface/get", "GET", { id: mapping.template_id });
-        if (resp?.errcode !== 0) {
-            throw new Error(`interface get failed: ${resp?.errmsg || "unknown error"}`);
-        }
-        template = resp?.data || {};
-    }
-    const payload = buildAddPayload(template, title, apiPath, catId, projectId);
-    const resp = await request("/api/interface/add", "POST", {}, payload);
-    if (resp?.errcode !== 0) {
-        throw new Error(`interface add failed: ${resp?.errmsg || "unknown error"}`);
-    }
-    const newId = resp?.data?._id;
-    if (!newId) {
-        throw new Error("interface add succeeded but missing id");
-    }
-    return Number(newId);
-}
-async function updateInterface(docId, title, markdown, html, request) {
-    const payload = buildUpdatePayload(docId, title, markdown, html);
-    const resp = await request("/api/interface/up", "POST", {}, payload);
-    if (resp?.errcode !== 0) {
-        throw new Error(`interface up failed: ${resp?.errmsg || "unknown error"}`);
-    }
-}
-async function syncDocsDir(dirPath, mapping, options, request) {
-    if (!mapping.files || typeof mapping.files !== "object") {
-        mapping.files = {};
-    }
-    if (!mapping.file_hashes || typeof mapping.file_hashes !== "object") {
-        mapping.file_hashes = {};
-    }
-    const envProjectId = process.env.YAPI_PROJECT_ID;
-    const envCatId = process.env.YAPI_CATID;
-    const envTemplateId = process.env.YAPI_TEMPLATE_ID;
-    if (!mapping.project_id && envProjectId)
-        mapping.project_id = Number(envProjectId);
-    if (!mapping.catid && envCatId)
-        mapping.catid = Number(envCatId);
-    if (!mapping.template_id && envTemplateId)
-        mapping.template_id = Number(envTemplateId);
-    const hasTarget = Boolean(mapping.project_id && mapping.catid);
-    if (!hasTarget && !options.dryRun) {
-        throw new Error("缺少 project_id/catid。请先绑定或配置：yapi docs-sync bind add --name <binding> --dir <path> --project-id <id> --catid <id>，或在目录下添加 .yapi.json，或设置环境变量 YAPI_PROJECT_ID/YAPI_CATID。");
-    }
-    const { byPath, byTitle, byId } = hasTarget
-        ? await listExistingInterfaces(Number(mapping.catid), request)
-        : { byPath: {}, byTitle: {}, byId: {} };
-    let updated = 0;
-    let created = 0;
-    let skipped = 0;
-    let previewOnly = 0;
-    const fileInfos = {};
-    const previews = [];
-    const files = resolveSourceFiles(dirPath, mapping);
-    for (const mdPath of files) {
-        const stem = path_1.default.parse(mdPath).name;
-        const relName = path_1.default.basename(mdPath);
-        const apiPath = `/${stem}`;
-        const markdown = fs_1.default.readFileSync(mdPath, "utf8");
-        const desiredTitle = (0, markdown_1.extractFirstMarkdownH1Title)(markdown).trim() || stem;
-        let docId = mapping.files[relName];
-        if (!docId) {
-            docId = byPath[apiPath] || byTitle[desiredTitle] || byTitle[stem];
-            if (docId)
-                mapping.files[relName] = docId;
-        }
-        let action = docId ? "update" : hasTarget ? "create" : "preview-only";
-        if (!docId && hasTarget) {
-            created += 1;
-            if (!options.dryRun) {
-                docId = await addInterface(desiredTitle, apiPath, mapping, request);
-                mapping.files[relName] = docId;
-            }
-        }
-        if (!docId && !hasTarget) {
-            previewOnly += 1;
-        }
-        if (docId) {
-            const resolvedPath = byId[String(docId)]?.path || apiPath;
-            fileInfos[relName] = { docId: Number(docId), apiPath: resolvedPath };
-        }
-        const contentHash = buildDocsSyncHash(markdown, options);
-        const previousHash = mapping.file_hashes[relName];
-        const currentTitle = docId ? byId[String(docId)]?.title : "";
-        const titleToUpdate = !docId
-            ? undefined
-            : !currentTitle || currentTitle !== desiredTitle
-                ? desiredTitle
-                : undefined;
-        const shouldSyncTitle = Boolean(titleToUpdate);
-        const shouldSkipUnchanged = !options.force &&
-            docId &&
-            previousHash &&
-            previousHash === contentHash &&
-            !shouldSyncTitle;
-        if (shouldSkipUnchanged && !options.dryRun) {
-            skipped += 1;
-            continue;
-        }
-        const logPrefix = `[docs-sync:${relName}]`;
-        let mermaidFailed = false;
-        let diagramFailed = false;
-        const diagramMetrics = [];
-        const html = (0, markdown_1.renderMarkdownToHtml)(markdown, {
-            noMermaid: options.noMermaid,
-            logMermaid: true,
-            mermaidLook: options.mermaidLook,
-            mermaidHandDrawnSeed: options.mermaidHandDrawnSeed,
-            logger: (message) => console.log(`${logPrefix} ${message}`),
-            onDiagramRendered: (metric) => {
-                diagramMetrics.push(metric);
-            },
-            onMermaidError: () => {
-                mermaidFailed = true;
-            },
-            onDiagramError: () => {
-                diagramFailed = true;
-            },
-        });
-        if (shouldSkipUnchanged) {
-            action = "skip";
-            skipped += 1;
-        }
-        const payloadObject = docId && action !== "create"
-            ? buildUpdatePayload(docId, titleToUpdate, markdown, html)
-            : buildAddPayload({}, desiredTitle, apiPath, Number(mapping.catid || 0), Number(mapping.project_id || 0));
-        const preview = {
-            fileName: relName,
-            action,
-            markdownBytes: Buffer.byteLength(markdown, "utf8"),
-            htmlBytes: Buffer.byteLength(html, "utf8"),
-            payloadBytes: Buffer.byteLength(JSON.stringify(payloadObject), "utf8"),
-            apiPath: docId ? fileInfos[relName]?.apiPath || apiPath : apiPath,
-            docId: docId ? Number(docId) : undefined,
-            largestMermaid: pickLargestMermaid(diagramMetrics),
-        };
-        previews.push(preview);
-        if (!options.dryRun && docId && action !== "skip") {
-            try {
-                await updateInterface(docId, titleToUpdate, markdown, html, request);
-            }
-            catch (error) {
-                if (error instanceof HttpStatusError && error.status === 413) {
-                    throw new Error(buildDocsSyncPayloadTooLargeMessage(relName, preview, error));
-                }
-                throw error;
-            }
-        }
-        if (docId && !mermaidFailed && !diagramFailed) {
-            mapping.file_hashes[relName] = contentHash;
-        }
-        if (action !== "skip") {
-            updated += 1;
-        }
-    }
-    return { updated, created, skipped, previewOnly, files: fileInfos, previews };
-}
-function buildEnvUrls(projectInfo, apiPath) {
-    const urls = {};
-    if (!projectInfo || !projectInfo.envs || !projectInfo.envs.length)
-        return urls;
-    const basepath = projectInfo.basepath || "";
-    projectInfo.envs.forEach((env, index) => {
-        const rawKey = env.name || env.domain || `env${index + 1}`;
-        const url = buildEnvUrl(env.domain, basepath, apiPath);
-        if (!url)
-            return;
-        let key = rawKey;
-        let suffix = 1;
-        while (urls[key]) {
-            suffix += 1;
-            key = `${rawKey}-${suffix}`;
-        }
-        urls[key] = url;
-    });
-    return urls;
-}
-async function updateDocsSyncCaches(homeDir, baseUrl, bindingResults, request) {
-    const linksConfig = loadDocsSyncLinks(homeDir);
-    const projectsConfig = loadDocsSyncProjects(homeDir);
-    const deploymentsConfig = loadDocsSyncDeployments(homeDir);
-    const projectCache = new Map();
-    const resolveProjectInfo = async (projectId) => {
-        if (!projectId)
-            return null;
-        if (projectCache.has(projectId))
-            return projectCache.get(projectId) || null;
-        const existing = projectsConfig.projects[String(projectId)] || null;
-        try {
-            const fresh = await fetchProjectInfo(projectId, baseUrl, request);
-            if (fresh) {
-                projectsConfig.projects[String(projectId)] = fresh;
-                projectCache.set(projectId, fresh);
-                return fresh;
-            }
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.warn(`project get failed (project_id=${projectId}): ${message}`);
-        }
-        projectCache.set(projectId, existing);
-        return existing;
-    };
-    for (const [name, result] of Object.entries(bindingResults)) {
-        const binding = result.binding;
-        const projectId = Number(binding.project_id || 0);
-        const linkFiles = {};
-        const deploymentFiles = {};
-        const projectInfo = await resolveProjectInfo(projectId);
-        for (const [fileName, fileInfo] of Object.entries(result.files)) {
-            const docUrl = projectId ? buildInterfaceWebUrl(baseUrl, projectId, fileInfo.docId) : "";
-            linkFiles[fileName] = {
-                doc_id: fileInfo.docId,
-                api_path: fileInfo.apiPath,
-                url: docUrl,
-            };
-            deploymentFiles[fileName] = {
-                api_path: fileInfo.apiPath,
-                env_urls: buildEnvUrls(projectInfo, fileInfo.apiPath),
-            };
-        }
-        linksConfig.bindings[name] = {
-            dir: binding.dir,
-            project_id: projectId || undefined,
-            catid: binding.catid,
-            files: linkFiles,
-        };
-        deploymentsConfig.bindings[name] = {
-            dir: binding.dir,
-            project_id: projectId || undefined,
-            files: deploymentFiles,
-        };
-    }
-    saveDocsSyncLinks(homeDir, linksConfig);
-    saveDocsSyncProjects(homeDir, projectsConfig);
-    saveDocsSyncDeployments(homeDir, deploymentsConfig);
-}
-async function runDocsSyncBindings(rawArgs) {
-    const action = (rawArgs[0] || "list").toLowerCase();
-    const args = rawArgs[0] ? rawArgs.slice(1) : rawArgs;
-    const options = parseDocsSyncBindArgs(args);
-    if (options.help) {
-        console.log(docsSyncBindUsage());
-        return 0;
-    }
-    const writeActions = new Set(["add", "update", "remove", "rm", "delete", "del"]);
-    const readActions = new Set(["list", "get"]);
-    if (!writeActions.has(action) && !readActions.has(action)) {
-        console.error(`unknown docs-sync bind action: ${action}`);
-        console.error(docsSyncBindUsage());
-        return 2;
-    }
-    const homeDir = resolveDocsSyncHome(process.cwd(), writeActions.has(action));
-    if (!homeDir) {
-        if (action === "list") {
-            console.log("no docs-sync bindings (missing .yapi/docs-sync.json)");
-            return 0;
-        }
-        console.error("missing .yapi/docs-sync.json (run in project root or create one with docs-sync bind add)");
-        return 2;
-    }
-    const rootDir = path_1.default.dirname(homeDir);
-    const config = loadDocsSyncConfig(homeDir);
-    if (action === "list") {
-        const entries = Object.entries(config.bindings).sort(([a], [b]) => a.localeCompare(b));
-        if (!entries.length) {
-            console.log("no docs-sync bindings");
-            return 0;
-        }
-        for (const [name, binding] of entries) {
-            const filesCount = binding.files ? Object.keys(binding.files).length : 0;
-            console.log(`${name} dir=${binding.dir} project_id=${binding.project_id ?? ""} catid=${binding.catid ?? ""}` +
-                (binding.template_id ? ` template_id=${binding.template_id}` : "") +
-                ` files=${filesCount}`);
-        }
-        return 0;
-    }
-    if (!options.name) {
-        console.error("missing --name for docs-sync bind action");
-        console.error(docsSyncBindUsage());
-        return 2;
-    }
-    if (action === "get") {
-        const binding = config.bindings[options.name];
-        if (!binding) {
-            console.error(`binding not found: ${options.name}`);
-            return 2;
-        }
-        console.log(JSON.stringify(binding, null, 2));
-        return 0;
-    }
-    if (action === "remove" || action === "rm" || action === "delete" || action === "del") {
-        if (!config.bindings[options.name]) {
-            console.error(`binding not found: ${options.name}`);
-            return 2;
-        }
-        delete config.bindings[options.name];
-        saveDocsSyncConfig(homeDir, config);
-        console.log(`binding removed: ${options.name}`);
-        return 0;
-    }
-    const hasExisting = Boolean(config.bindings[options.name]);
-    if (action === "add" && hasExisting) {
-        console.error(`binding already exists: ${options.name}`);
-        return 2;
-    }
-    if (action === "update" && !hasExisting) {
-        console.error(`binding not found: ${options.name}`);
-        return 2;
-    }
-    if (action === "add") {
-        if (!options.dir ||
-            !Number.isFinite(options.projectId ?? NaN) ||
-            !Number.isFinite(options.catId ?? NaN)) {
-            console.error("add requires --dir, --project-id, and --catid");
-            console.error(docsSyncBindUsage());
-            return 2;
-        }
-    }
-    const existing = config.bindings[options.name] || {};
-    const next = {
-        dir: existing.dir || "",
-        project_id: existing.project_id,
-        catid: existing.catid,
-        template_id: existing.template_id,
-        source_files: existing.source_files ? [...existing.source_files] : undefined,
-        files: existing.files ? { ...existing.files } : {},
-        file_hashes: existing.file_hashes ? { ...existing.file_hashes } : {},
-    };
-    if (options.dir) {
-        next.dir = normalizeBindingDirForContext(homeDir, rootDir, process.cwd(), options.dir);
-    }
-    if (options.projectId !== undefined && Number.isFinite(options.projectId)) {
-        next.project_id = Number(options.projectId);
-    }
-    if (options.catId !== undefined && Number.isFinite(options.catId)) {
-        next.catid = Number(options.catId);
-    }
-    if (options.templateId !== undefined && Number.isFinite(options.templateId)) {
-        next.template_id = Number(options.templateId);
-    }
-    if (options.clearSourceFiles) {
-        next.source_files = [];
-    }
-    else if (options.sourceFiles && options.sourceFiles.length) {
-        next.source_files = options.sourceFiles;
-    }
-    if (!next.dir || !next.project_id || !next.catid) {
-        console.error("binding requires dir/project_id/catid");
-        return 2;
-    }
-    config.bindings[options.name] = next;
-    saveDocsSyncConfig(homeDir, config);
-    const resolvedDir = resolveBindingDirForContext(homeDir, rootDir, process.cwd(), next.dir);
-    console.log(`${action === "add" ? "binding added" : "binding updated"}: ${options.name}`);
-    console.log(`stored_dir=${next.dir}`);
-    console.log(`resolved_dir=${resolvedDir}`);
-    const gitRoot = findGitRoot(process.cwd());
-    if (gitRoot) {
-        console.log(`git_root=${gitRoot}`);
-    }
-    else if (isGlobalDocsSyncHome(homeDir)) {
-        console.warn("warning: no git root detected, relative --dir was resolved from current working directory");
-    }
-    return 0;
-}
-async function runDocsSync(rawArgs) {
-    const firstArg = rawArgs[0];
-    if (firstArg === "bind" || firstArg === "bindings") {
-        return await runDocsSyncBindings(rawArgs.slice(1));
-    }
-    const options = parseDocsSyncArgs(rawArgs);
-    if (options.help) {
-        console.log(docsSyncUsage());
-        return 0;
-    }
-    try {
-        if (!(0, markdown_1.isPandocAvailable)()) {
-            console.warn("pandoc not found, fallback to markdown-it renderer.");
-            console.warn("Install pandoc (macOS): brew install pandoc");
-            console.warn("More info: https://pandoc.org/installing.html");
-        }
-        if (!options.noMermaid && !(0, markdown_1.isMmdcAvailable)()) {
-            console.warn("mmdc not found, Mermaid blocks will stay as code.");
-            console.warn("Install mermaid-cli: npm i -g @mermaid-js/mermaid-cli");
-        }
-        if (!(0, markdown_1.isPlantUmlAvailable)()) {
-            console.warn("plantuml not found, PlantUML blocks will be removed from HTML.");
-            console.warn("Install PlantUML (macOS): brew install plantuml");
-        }
-        if (!(0, markdown_1.isGraphvizAvailable)()) {
-            console.warn("graphviz (dot) not found, Graphviz blocks will be removed from HTML.");
-            console.warn("Install Graphviz (macOS): brew install graphviz");
-        }
-        if (!(0, markdown_1.isD2Available)()) {
-            console.warn("d2 not found, D2 blocks will be removed from HTML.");
-            console.warn("Install D2 (macOS): brew install d2");
-        }
-        if (options.bindings.length && options.dirs.length) {
-            console.error("use --binding or --dir, not both");
-            return 2;
-        }
-        const docsSyncHome = resolveDocsSyncHome(process.cwd(), false);
-        const docsSyncConfig = docsSyncHome ? loadDocsSyncConfig(docsSyncHome) : null;
-        let bindingNames = options.bindings;
-        let useBindings = bindingNames.length > 0;
-        if (!useBindings &&
-            !options.dirs.length &&
-            docsSyncConfig &&
-            Object.keys(docsSyncConfig.bindings).length) {
-            useBindings = true;
-            bindingNames = Object.keys(docsSyncConfig.bindings);
-        }
-        if (useBindings && (!docsSyncHome || !docsSyncConfig)) {
-            console.error("missing .yapi/docs-sync.json (run docs-sync bind add or use --dir)");
-            return 2;
-        }
-        if (useBindings && !bindingNames.length) {
-            console.error("no docs-sync bindings found (run docs-sync bind add or use --dir)");
-            return 2;
-        }
-        const usingDefaultDir = !useBindings && !options.dirs.length;
-        const dirs = useBindings ? [] : options.dirs.length ? options.dirs : ["docs/release-notes"];
-        if (!useBindings) {
-            const missingDirs = dirs.filter((dir) => {
-                const dirPath = path_1.default.resolve(dir);
-                return !fs_1.default.existsSync(dirPath) || !fs_1.default.statSync(dirPath).isDirectory();
-            });
-            if (missingDirs.length) {
-                const firstMissing = path_1.default.resolve(missingDirs[0]);
-                console.error(`dir not found: ${firstMissing}`);
-                if (usingDefaultDir) {
-                    const suggestion = suggestDocsSyncDir(process.cwd());
-                    if (suggestion) {
-                        console.error(`hint: pass --dir ${suggestion}`);
-                    }
-                    console.error("hint: or bind a directory with yapi docs-sync bind add");
-                }
-                else {
-                    console.error("hint: pass --dir <existing_dir> or bind a directory");
-                }
-                return 2;
-            }
-        }
-        let config = {};
-        let configPath = options.config || "";
-        if (options.config) {
-            if (fs_1.default.existsSync(configPath)) {
-                config = parseSimpleToml(fs_1.default.readFileSync(configPath, "utf8"));
-            }
-            else {
-                const init = await initConfigIfMissing(options);
-                if (init) {
-                    config = init.config;
-                    configPath = init.configPath;
-                }
-                else {
-                    console.error(`missing config file: ${configPath}`);
-                    return 2;
-                }
-            }
-        }
-        else {
-            const globalPath = globalConfigPath();
-            if (fs_1.default.existsSync(globalPath)) {
-                configPath = globalPath;
-                config = parseSimpleToml(fs_1.default.readFileSync(globalPath, "utf8"));
-            }
-            else {
-                const init = await initConfigIfMissing(options);
-                if (init) {
-                    config = init.config;
-                    configPath = init.configPath;
-                }
-                else {
-                    console.error("missing config: create ~/.yapi/config.toml or pass --config");
-                    return 2;
-                }
-            }
-        }
-        const baseUrl = options.baseUrl || config.base_url || "";
-        if (!baseUrl) {
-            console.error("missing --base-url or config base_url");
-            return 2;
-        }
-        const projectId = options.projectId || config.project_id || "";
-        const rawToken = options.token || config.token || "";
-        const token = resolveToken(rawToken, projectId);
-        let authMode = (options.authMode || config.auth_mode || "").trim().toLowerCase();
-        if (!authMode) {
-            authMode = token
-                ? "token"
-                : options.email || options.password || config.email || config.password
-                    ? "global"
-                    : "token";
-        }
-        if (authMode !== "token" && authMode !== "global") {
-            console.error("invalid --auth-mode (use token or global)");
-            return 2;
-        }
-        const headers = {};
-        const email = options.email || config.email || "";
-        const password = options.password || config.password || "";
-        const authService = authMode === "global"
-            ? new auth_1.YApiAuthService(baseUrl, email || "", password || "", "warn", {
-                timeoutMs: options.timeout || 30000,
-            })
-            : null;
-        const canRelogin = authMode === "global" &&
-            Boolean(authService) &&
-            Boolean(email) &&
-            Boolean(password) &&
-            !options.cookie;
-        if (options.cookie) {
-            headers.Cookie = options.cookie;
-        }
-        else if (authMode === "global") {
-            const cachedCookie = authService?.getCachedCookieHeader();
-            if (cachedCookie) {
-                headers.Cookie = cachedCookie;
-            }
-            else if (email && password && authService) {
-                try {
-                    headers.Cookie = await authService.getCookieHeaderWithLogin();
-                }
-                catch (error) {
-                    console.error(error instanceof Error ? error.message : String(error));
-                    return 2;
-                }
-            }
-            else {
-                console.error("missing email/password for global auth");
-                return 2;
-            }
-        }
-        const request = async (endpoint, method, query = {}, data) => {
-            const queryItems = [];
-            for (const [key, value] of Object.entries(query)) {
-                if (value !== undefined && value !== null) {
-                    queryItems.push([key, String(value)]);
-                }
-            }
-            const url = buildUrl(baseUrl, endpoint, queryItems, authMode === "token" ? token : "", options.tokenParam || "token");
-            let body;
-            if (data !== undefined) {
-                body = JSON.stringify(data);
-            }
-            const sendOnce = async () => {
-                const requestHeaders = { ...headers };
-                if (body !== undefined) {
-                    requestHeaders["Content-Type"] = "application/json;charset=UTF-8";
-                }
-                const response = await fetchWithTimeout(url, {
-                    method,
-                    headers: requestHeaders,
-                    body,
-                }, options.timeout || 30000);
-                const text = await response.text();
-                return { response, text, json: parseJsonMaybe(text) };
-            };
-            let result = await sendOnce();
-            if (canRelogin && looksLikeAuthError(result.response.status, result.json)) {
-                try {
-                    headers.Cookie = await authService.getCookieHeaderWithLogin({ forceLogin: true });
-                }
-                catch (error) {
-                    throw new Error(error instanceof Error ? error.message : String(error));
-                }
-                result = await sendOnce();
-            }
-            if (!result.response.ok) {
-                throw new HttpStatusError(endpoint, result.response.status, result.response.statusText, result.text);
-            }
-            if (!result.json) {
-                throw new Error(`invalid JSON response from ${endpoint}`);
-            }
-            return result.json;
-        };
-        if (useBindings) {
-            const rootDir = path_1.default.dirname(docsSyncHome);
-            const configForBindings = docsSyncConfig;
-            const dirToBindings = new Map();
-            for (const name of bindingNames) {
-                const binding = configForBindings.bindings[name];
-                if (!binding) {
-                    throw new Error(`binding not found: ${name}`);
-                }
-                const dirPath = resolveBindingDirForContext(docsSyncHome, rootDir, process.cwd(), binding.dir);
-                const existing = dirToBindings.get(dirPath) || [];
-                existing.push(name);
-                dirToBindings.set(dirPath, existing);
-            }
-            const duplicates = Array.from(dirToBindings.entries()).filter(([, names]) => names.length > 1);
-            if (duplicates.length) {
-                const lines = [];
-                lines.push("invalid docs-sync bindings: multiple bindings share the same dir");
-                duplicates.forEach(([dirPath, names]) => {
-                    lines.push(`- dir=${dirPath} bindings=${names.join(", ")}`);
-                });
-                lines.push("");
-                lines.push("Fix: split docs into separate directories (recommended).");
-                lines.push("Example:");
-                lines.push("  yapi docs-sync bind update --name <bindingA> --dir docs/yapi-sync/<bindingA>");
-                lines.push("  yapi docs-sync bind update --name <bindingB> --dir docs/yapi-sync/<bindingB>");
-                throw new Error(lines.join("\n"));
-            }
-            const bindingResults = {};
-            for (const name of bindingNames) {
-                const binding = configForBindings.bindings[name];
-                if (!binding) {
-                    throw new Error(`binding not found: ${name}`);
-                }
-                const dirPath = resolveBindingDirForContext(docsSyncHome, rootDir, process.cwd(), binding.dir);
-                if (!fs_1.default.existsSync(dirPath) || !fs_1.default.statSync(dirPath).isDirectory()) {
-                    throw new Error(`dir not found for binding ${name}: ${dirPath}`);
-                }
-                const result = await syncDocsDir(dirPath, binding, options, request);
-                if (options.dryRun) {
-                    console.log(`dry-run preview binding=${name}`);
-                    result.previews.forEach((item) => console.log(buildDocsSyncPreviewLine(item)));
-                }
-                console.log(`synced=${result.updated} created=${result.created} skipped=${result.skipped} preview_only=${result.previewOnly} binding=${name} dir=${dirPath}`);
-                bindingResults[name] = { binding, files: result.files };
-            }
-            if (!options.dryRun) {
-                saveDocsSyncConfig(docsSyncHome, configForBindings);
-                await updateDocsSyncCaches(docsSyncHome, baseUrl, bindingResults, request);
-            }
-        }
-        else {
-            for (const dir of dirs) {
-                const dirPath = path_1.default.resolve(dir);
-                if (!fs_1.default.existsSync(dirPath) || !fs_1.default.statSync(dirPath).isDirectory()) {
-                    throw new Error(`dir not found: ${dirPath}`);
-                }
-                const { mapping, mappingPath } = loadMapping(dirPath);
-                const result = await syncDocsDir(dirPath, mapping, options, request);
-                if (options.dryRun) {
-                    console.log(`dry-run preview dir=${dirPath}`);
-                    result.previews.forEach((item) => console.log(buildDocsSyncPreviewLine(item)));
-                }
-                if (!options.dryRun) {
-                    saveMapping(mapping, mappingPath);
-                }
-                console.log(`synced=${result.updated} created=${result.created} skipped=${result.skipped} preview_only=${result.previewOnly} dir=${dirPath}`);
-            }
-        }
-        return 0;
-    }
-    catch (error) {
-        console.error(error instanceof Error ? error.message : String(error));
-        return 2;
-    }
-}
 async function main() {
-    const rawArgs = process.argv.slice(2);
-    const parsedForUpdate = parseArgs(rawArgs);
+    const rawArgs = (0, helpers_1.hideBin)(process.argv);
+    const hasHelp = rawArgs.includes("-h") || rawArgs.includes("--help");
+    const hasVersion = rawArgs.includes("-V") || rawArgs.includes("--version");
+    const hasNoUpdate = rawArgs.includes("--no-update") || rawArgs.includes("--no-update-check");
     const subcommand = rawArgs[0] || "";
-    const skipUpdateCheck = parsedForUpdate.version ||
-        parsedForUpdate.help ||
-        parsedForUpdate.noUpdate ||
-        rawArgs.includes("-h") ||
-        rawArgs.includes("--help");
-    await checkForUpdates({ noUpdate: parsedForUpdate.noUpdate, skip: skipUpdateCheck });
+    const skipUpdateCheck = hasVersion || hasHelp || hasNoUpdate;
+    await checkForUpdates({ noUpdate: hasNoUpdate, skip: skipUpdateCheck });
     const skipSkillWarning = skipUpdateCheck ||
         subcommand === "install-skill" ||
         subcommand === "self-update" ||
         process.env.YAPI_NO_SKILL_UPDATE_CHECK === "1";
     warnIfInstalledSkillsOutdated({ skip: skipSkillWarning });
-    if (subcommand === "self-update") {
-        return runSelfUpdate(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "install-skill") {
-        await (0, install_1.runInstallSkill)(rawArgs.slice(1));
-        return 0;
-    }
-    if (rawArgs[0] === "login") {
-        return await runLogin(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "logout") {
-        return await runLogout(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "whoami") {
-        return await runWhoami(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "search") {
-        return await runSearch(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "group") {
-        return await runGroup(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "project") {
-        return await runProject(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "interface") {
-        return await runInterface(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "log") {
-        return await runLog(rawArgs.slice(1));
-    }
-    if (rawArgs[0] === "docs-sync") {
-        return await runDocsSync(rawArgs.slice(1));
-    }
-    const options = parseArgs(rawArgs);
-    if (options.version) {
-        console.log(readVersion());
-        return 0;
-    }
-    if (options.help) {
-        console.log(usage());
-        return 0;
-    }
-    if (options.url && options.path) {
-        console.error("use --url or --path, not both");
-        return 2;
-    }
-    if (!options.url && !options.path) {
-        console.error("missing --path or --url");
-        console.error(usage());
-        return 2;
-    }
-    let config = {};
-    let configPath = options.config || "";
-    if (options.config) {
-        if (fs_1.default.existsSync(configPath)) {
-            config = parseSimpleToml(fs_1.default.readFileSync(configPath, "utf8"));
-        }
-        else {
-            const init = await initConfigIfMissing(options);
-            if (init) {
-                config = init.config;
-                configPath = init.configPath;
-            }
-            else {
-                console.error(`missing config file: ${configPath}`);
-                return 2;
-            }
-        }
-    }
-    else {
-        const globalPath = globalConfigPath();
-        if (fs_1.default.existsSync(globalPath)) {
-            configPath = globalPath;
-            config = parseSimpleToml(fs_1.default.readFileSync(globalPath, "utf8"));
+    let commandHandled = false;
+    const parser = (0, yargs_1.default)(rawArgs)
+        .scriptName("yapi")
+        .version((0, utils_1.readVersion)())
+        .alias("V", "version")
+        .help("help")
+        .alias("h", "help")
+        .strict(false)
+        .command("login", "Login to YApi", (y) => y
+        .option("config", { type: "string", describe: "config file path" })
+        .option("base-url", { type: "string", describe: "YApi base URL" })
+        .option("login-url", { type: "string", describe: "page URL for browser login" })
+        .option("browser", { type: "boolean", describe: "force browser login" })
+        .option("email", { type: "string", describe: "login email" })
+        .option("password", { type: "string", describe: "login password" })
+        .option("timeout", { type: "number", describe: "request timeout in ms", default: 30000 })
+        .option("token", { type: "string", describe: "project token" })
+        .option("project-id", { type: "string", describe: "project id" }), async (argv) => {
+        commandHandled = true;
+        process.exitCode = await (0, login_1.runLogin)(toOptions(argv));
+    })
+        .command("logout", "Logout from YApi", (y) => y
+        .option("config", { type: "string", describe: "config file path" })
+        .option("base-url", { type: "string", describe: "YApi base URL" }), async (argv) => {
+        commandHandled = true;
+        process.exitCode = await (0, logout_1.runLogout)(toOptions(argv));
+    })
+        .command("whoami", "Show current user status", (y) => y
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        process.exitCode = await (0, whoami_1.runWhoami)(toOptions(argv));
+    })
+        .command("search", "Search YApi projects and interfaces", (y) => y
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("q", { type: "string", describe: "search keyword" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        process.exitCode = await (0, search_1.runSearch)(toOptions(argv));
+    })
+        .command("group [action]", "Group operations (list, get)", (y) => y
+        .positional("action", { type: "string", default: "list" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("id", { type: "string", describe: "group id" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        const action = String(argv.action || "list").toLowerCase();
+        process.exitCode = await (0, group_1.runGroup)(action, toOptions(argv));
+    })
+        .command("project [action]", "Project operations (list, get, token)", (y) => y
+        .positional("action", { type: "string", default: "list" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("group-id", { type: "string", describe: "group id for list" })
+        .option("id", { type: "string", describe: "project id for get" })
+        .option("page", { type: "number" })
+        .option("limit", { type: "string" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        const action = String(argv.action || "list").toLowerCase();
+        process.exitCode = await (0, project_1.runProject)(action, toOptions(argv));
+    })
+        .command("interface [action] [subaction]", "Interface operations (list, list-menu, get, cat add/update/delete)", (y) => y
+        .positional("action", { type: "string", default: "" })
+        .positional("subaction", { type: "string", default: "" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("id", { type: "string" })
+        .option("cat-id", { type: "string" })
+        .option("catid", { type: "string" })
+        .option("name", { type: "string" })
+        .option("desc", { type: "string" })
+        .option("page", { type: "number" })
+        .option("limit", { type: "string" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        const action = String(argv.action || "").toLowerCase();
+        const subAction = String(argv.subaction || "").toLowerCase();
+        const opts = toOptions(argv);
+        process.exitCode = await (0, interface_1.runInterface)(action, subAction, opts, opts);
+    })
+        .command("col [action]", "Test collection operations (list, cases, run)", (y) => y
+        .positional("action", { type: "string", default: "list" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("id", { type: "string", describe: "collection id" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        const action = String(argv.action || "list").toLowerCase();
+        process.exitCode = await (0, col_1.runCol)(action, toOptions(argv));
+    })
+        .command("export", "Export project data (json/swagger/html)", (y) => y
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string", describe: "project id (required)" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("type", { type: "string", describe: "export format: json, swagger, html", default: "json" })
+        .option("q", { type: "string", describe: "status filter: all, done, undone", default: "all" })
+        .option("name", { type: "string", describe: "output file path" })
+        .option("id", { type: "string", describe: "project id (alias)" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        process.exitCode = await (0, export_1.runExport)(toOptions(argv));
+    })
+        .command("env", "Show project environments", (y) => y
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string", describe: "project id (required)" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("id", { type: "string", describe: "project id (alias)" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        process.exitCode = await (0, env_1.runEnv)(toOptions(argv));
+    })
+        .command("member [action]", "Member management (list, group)", (y) => y
+        .positional("action", { type: "string", default: "list" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string", describe: "project id" })
+        .option("group-id", { type: "string", describe: "group id" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("id", { type: "string", describe: "resource id" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        const action = String(argv.action || "list").toLowerCase();
+        process.exitCode = await (0, member_1.runMember)(action, toOptions(argv));
+    })
+        .command("follow", "List followed projects", (y) => y
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        process.exitCode = await (0, follow_1.runFollow)(toOptions(argv));
+    })
+        .command("user [action]", "User operations (list, search)", (y) => y
+        .positional("action", { type: "string", default: "list" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("q", { type: "string", describe: "search keyword" })
+        .option("name", { type: "string", describe: "search keyword (alias)" })
+        .option("page", { type: "number" })
+        .option("limit", { type: "string" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        const action = String(argv.action || "list").toLowerCase();
+        process.exitCode = await (0, user_1.runUser)(action, toOptions(argv));
+    })
+        .command("log [action]", "Log operations (list)", (y) => y
+        .positional("action", { type: "string", default: "list" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("type", { type: "string", describe: "log type" })
+        .option("type-id", { type: "string", describe: "log type id" })
+        .option("page", { type: "number" })
+        .option("limit", { type: "string" })
+        .option("no-pretty", { type: "boolean" }), async (argv) => {
+        commandHandled = true;
+        const action = String(argv.action || "list").toLowerCase();
+        process.exitCode = await (0, log_1.runLog)(action, toOptions(argv));
+    })
+        .command("docs-sync [subcmd] [bindaction]", "Sync markdown docs to YApi", (y) => y
+        .positional("subcmd", { type: "string", default: "" })
+        .positional("bindaction", { type: "string", default: "" })
+        .option("config", { type: "string" })
+        .option("base-url", { type: "string" })
+        .option("token", { type: "string" })
+        .option("project-id", { type: "string" })
+        .option("auth-mode", { type: "string" })
+        .option("email", { type: "string" })
+        .option("password", { type: "string" })
+        .option("cookie", { type: "string" })
+        .option("token-param", { type: "string", default: "token" })
+        .option("timeout", { type: "number", default: 30000 })
+        .option("dir", { type: "string", array: true, describe: "docs directory (repeatable)" })
+        .option("binding", { type: "string", array: true, describe: "binding name (repeatable)" })
+        .option("dry-run", { type: "boolean", describe: "compute but do not update" })
+        .option("no-mermaid", { type: "boolean", describe: "do not render mermaid" })
+        .option("mermaid-hand-drawn", { type: "boolean", describe: "force hand-drawn look" })
+        .option("mermaid-classic", { type: "boolean", describe: "render with classic look" })
+        .option("mermaid-hand-drawn-seed", { type: "number", describe: "hand-drawn seed" })
+        .option("force", { type: "boolean", describe: "sync all files even if unchanged" })
+        .option("name", { type: "string", describe: "binding name (for bind actions)" })
+        .option("catid", { type: "string", describe: "YApi category id" })
+        .option("cat-id", { type: "string", describe: "YApi category id" })
+        .option("template-id", { type: "number", describe: "template interface id" })
+        .option("source-file", { type: "string", array: true, describe: "sync specific file(s)" })
+        .option("clear-source-files", { type: "boolean", describe: "clear source_files list" }), async (argv) => {
+        commandHandled = true;
+        const subcmd = String(argv.subcmd || "").toLowerCase();
+        if (subcmd === "bind" || subcmd === "bindings") {
+            const bindAction = String(argv.bindaction || "list").toLowerCase();
+            process.exitCode = await (0, docs_sync_1.runDocsSyncBindings)(bindAction, toDocsSyncBindArgs(argv));
         }
         else {
-            const init = await initConfigIfMissing(options);
-            if (init) {
-                config = init.config;
-                configPath = init.configPath;
-            }
-            else {
-                console.error("missing config: create ~/.yapi/config.toml or pass --config");
-                return 2;
-            }
-        }
-    }
-    const authBaseUrl = options.baseUrl || config.base_url || "";
-    const baseUrl = options.url ? null : authBaseUrl;
-    const endpoint = options.url || options.path || "";
-    if (!options.url && !baseUrl) {
-        console.error("missing --base-url or config base_url");
-        return 2;
-    }
-    const projectId = options.projectId || config.project_id || "";
-    const rawToken = options.token || config.token || "";
-    const token = resolveToken(rawToken, projectId);
-    let authMode = (options.authMode || config.auth_mode || "").trim().toLowerCase();
-    if (!authMode) {
-        authMode = token
-            ? "token"
-            : options.email || options.password || config.email || config.password
-                ? "global"
-                : "token";
-    }
-    if (authMode !== "token" && authMode !== "global") {
-        console.error("invalid --auth-mode (use token or global)");
-        return 2;
-    }
-    if (authMode === "global" && !authBaseUrl) {
-        console.error("missing --base-url or config base_url for global auth");
-        return 2;
-    }
-    const headers = {};
-    for (const header of options.header || []) {
-        const [key, value] = parseHeader(header);
-        headers[key] = value;
-    }
-    const email = options.email || config.email || "";
-    const password = options.password || config.password || "";
-    const authService = authMode === "global"
-        ? new auth_1.YApiAuthService(authBaseUrl, email || "", password || "", "warn", {
-            timeoutMs: options.timeout || 30000,
-        })
-        : null;
-    const canRelogin = authMode === "global" &&
-        Boolean(authService) &&
-        Boolean(email) &&
-        Boolean(password) &&
-        !options.cookie;
-    if (options.cookie) {
-        headers.Cookie = options.cookie;
-    }
-    else if (authMode === "global") {
-        const cachedCookie = authService?.getCachedCookieHeader();
-        if (cachedCookie) {
-            headers.Cookie = cachedCookie;
-        }
-        else if (email && password && authService) {
-            try {
-                headers.Cookie = await authService.getCookieHeaderWithLogin();
-            }
-            catch (error) {
-                console.error(error instanceof Error ? error.message : String(error));
-                return 2;
-            }
-        }
-        else {
-            console.error("missing email/password for global auth");
-            return 2;
-        }
-    }
-    const queryItems = [];
-    for (const query of options.query || []) {
-        queryItems.push(...parseQueryArg(query));
-    }
-    const url = buildUrl(baseUrl, endpoint, queryItems, authMode === "token" ? token : "", options.tokenParam || "token");
-    let dataRaw = null;
-    if (options.dataFile) {
-        dataRaw = fs_1.default.readFileSync(options.dataFile, "utf8");
-    }
-    else if (options.data !== undefined) {
-        dataRaw = options.data;
-    }
-    let body;
-    const method = (options.method || "GET").toUpperCase();
-    if (dataRaw !== null && method !== "GET" && method !== "HEAD") {
-        try {
-            const parsed = JSON.parse(dataRaw);
-            body = JSON.stringify(parsed);
-            if (!headers["Content-Type"])
-                headers["Content-Type"] = "application/json";
-        }
-        catch {
-            body = String(dataRaw);
-            if (!headers["Content-Type"])
-                headers["Content-Type"] = "text/plain";
-        }
-    }
-    const sendOnce = async () => {
-        const response = await fetchWithTimeout(url, {
-            method,
-            headers,
-            body,
-        }, options.timeout || 30000);
-        const text = await response.text();
-        return { response, text, json: parseJsonMaybe(text) };
-    };
-    let result;
-    try {
-        result = await sendOnce();
-    }
-    catch (error) {
-        console.error("request failed: " + (error instanceof Error ? error.message : String(error)));
-        return 2;
-    }
-    if (canRelogin && looksLikeAuthError(result.response.status, result.json)) {
-        try {
-            headers.Cookie = await authService.getCookieHeaderWithLogin({ forceLogin: true });
-            result = await sendOnce();
-        }
-        catch (error) {
-            console.error(error instanceof Error ? error.message : String(error));
-            return 2;
-        }
-    }
-    const { text } = result;
-    if (options.noPretty) {
-        console.log(text);
-        return 0;
-    }
-    try {
-        const payload = result.json ?? JSON.parse(text);
-        console.log(JSON.stringify(payload, null, 2));
-    }
-    catch {
-        console.log(text);
-    }
+            process.exitCode = await (0, docs_sync_1.runDocsSync)(toDocsSyncOptions(argv));
+        }
+    })
+        .command("install-skill", "Install a skill", (y) => y, async () => {
+        commandHandled = true;
+        const idx = process.argv.indexOf("install-skill");
+        const remaining = idx >= 0 ? process.argv.slice(idx + 1) : [];
+        process.exitCode = await (0, install_skill_1.runInstallSkillCommand)(remaining);
+    })
+        .command("self-update", "Update yapi CLI to latest version", (y) => y, () => {
+        commandHandled = true;
+        process.exitCode = (0, self_update_1.runSelfUpdate)();
+    })
+        .option("path", { type: "string", describe: "API path (e.g., /api/interface/get)" })
+        .option("url", { type: "string", describe: "full URL (overrides base-url/path)" })
+        .option("method", { type: "string", describe: "HTTP method", default: "GET" })
+        .option("query", { type: "string", array: true, describe: "query param key=value (repeatable)" })
+        .option("header", { type: "string", array: true, describe: "request header Header:Value (repeatable)" })
+        .option("data", { type: "string", describe: "request body (JSON or text)" })
+        .option("data-file", { type: "string", describe: "request body file" })
+        .option("config", { type: "string", describe: "config file path (default: ~/.yapi/config.toml)" })
+        .option("base-url", { type: "string", describe: "YApi base URL" })
+        .option("token", { type: "string", describe: "project token (supports projectId:token)" })
+        .option("project-id", { type: "string", describe: "select token for project" })
+        .option("auth-mode", { type: "string", describe: "token or global" })
+        .option("email", { type: "string", describe: "login email for global mode" })
+        .option("password", { type: "string", describe: "login password for global mode" })
+        .option("cookie", { type: "string", describe: "cookie for global mode" })
+        .option("token-param", { type: "string", describe: "token query param name", default: "token" })
+        .option("timeout", { type: "number", describe: "request timeout in ms", default: 30000 })
+        .option("no-update", { type: "boolean", describe: "disable update check", default: false })
+        .option("no-pretty", { type: "boolean", describe: "print raw response", default: false })
+        .option("id", { type: "string", describe: "resource id" })
+        .option("name", { type: "string", describe: "category name" })
+        .option("desc", { type: "string", describe: "category description" })
+        .option("cat-id", { type: "string", describe: "category id" })
+        .option("catid", { type: "string", describe: "category id" })
+        .option("group-id", { type: "string", describe: "group id" })
+        .option("type", { type: "string", describe: "log type" })
+        .option("type-id", { type: "string", describe: "log type id" })
+        .option("page", { type: "number", describe: "page number" })
+        .option("limit", { type: "string", describe: "page size (number or 'all')" })
+        .option("q", { type: "string", describe: "search keyword" })
+        .option("login-url", { type: "string", describe: "page URL for browser login" })
+        .option("browser", { type: "boolean", describe: "force browser login" });
+    const argv = await parser.parse();
+    if (commandHandled) {
+        return process.exitCode ?? 0;
+    }
+    const opts = toOptions(argv);
+    if (opts.path || opts.url) {
+        return await (0, request_1.runRequest)(opts);
+    }
+    parser.showHelp();
     return 0;
 }
 main().then((code) => {
-    process.exitCode = code;
+    if (process.exitCode === undefined || process.exitCode === null) {
+        process.exitCode = code;
+    }
 });
 //# sourceMappingURL=yapi-cli.js.map