gaoding-cli 1.0.0-alpha.5

package/dist/src/registry/direct-registry.js

@@ -0,0 +1,234 @@
+const commonRateLimit = { rpm: 30, daily: 1000 };
+const requiredAkskHeaders = ["X-AccessKey", "X-Signature", "X-Timestamp"];
+export const DIRECT_TOOLS = [
+    tool("asset.upload", ["upload", "cdn.upload"], "素材上传（CDN）", "上传本地文件生成可访问 CDN URL；不做 DAM 入库", "asset", [
+        param("file", "file", true, "--file", "本地图片/视频文件"),
+    ]),
+    tool("text.title", ["title"], "智能标题", "根据商品或场景 brief 生成标题", "text", [
+        param("prompt", "string", false, "--prompt", "标题需求"),
+        param("brief", "string", false, "--brief", "同 --prompt"),
+    ]),
+    tool("text.prompt", ["prompt", "prompt-advise", "text.prompt-advise"], "提示词优化", "根据 brief 和可选参考图扩写生图提示词", "text", [
+        param("prompt", "string", true, "--prompt", "原始需求"),
+        param("image", "file", false, "--image", "参考图 URL 或本地文件"),
+        param("require_image", "boolean", false, "--require-image", "要求必须使用真实参考图，缺图时不退化为纯文本提示词"),
+    ]),
+    tool("image.cutout", ["cutout", "image.matting", "matting"], "智能抠图", "用户要去背景、透明底、白底图、批量抠图时使用；默认输出透明 PNG，并保留 mask/source 便于排查", "image", [
+        param("image", "file", true, "--image", "图片 URL 或本地文件"),
+        param("mode", "string", false, "--mode", "auto / portrait / product / graphic"),
+        param("compose_mask", "boolean", false, "--compose-mask", "将后端 mask 与原图合成透明 PNG，默认开启"),
+        param("raw_mask", "boolean", false, "--raw-mask", "仅返回后端 mask，不做合成"),
+    ]),
+    tool("image.generate", ["generate"], "AI 生图", "用户要生成商品主图、海报、场景图、种草图时使用；可传商品图作为参考", "image", [
+        param("prompt", "string", true, "--prompt", "生图提示词"),
+        param("image", "file", false, "--image", "参考图 URL 或本地文件"),
+        param("ratio", "string", false, "--ratio", "比例，如 1:1 / 3:4"),
+        param("model", "string", false, "--model", "模型 code / 名称 / auto"),
+        param("require_image", "boolean", false, "--require-image", "要求必须使用真实参考图，缺图时不退化为文生图"),
+        param("style_code", "string", false, "--style-code", "模型或风格 code"),
+    ], true, 600),
+    tool("image.svg", ["vectorize", "svg"], "转矢量图", "图片转 SVG", "image", [
+        param("image", "file", true, "--image", "图片 URL 或本地文件"),
+        param("mode", "string", false, "--mode", "auto / binary"),
+    ]),
+    tool("image.super-res", ["upscale", "super-res", "image.upscale"], "高清放大", "用户要图片高清化、变清晰、放大、提升分辨率时使用，支持 hd / uhd / uhd-plus", "image", [
+        param("image", "file", true, "--image", "图片 URL 或本地文件"),
+        param("mode", "string", false, "--mode", "hd / uhd / uhd-plus"),
+    ], true, 600),
+    tool("video.generate", ["video", "generate-video", "text-to-video", "image-to-video", "稿定视频", "视频生成", "文生视频", "图生视频", "动画短片"], "AI 视频", "稿定 AI 视频生成能力，支持文生视频、图生视频和动画短片生成", "video", [
+        param("prompt", "string", true, "--prompt", "视频提示词"),
+        param("image", "file", false, "--image", "首帧参考图 URL 或本地文件"),
+        param("duration", "string", false, "--duration", "时长"),
+        param("model", "string", false, "--model", "模型 code / 名称 / auto"),
+        param("require_image", "boolean", false, "--require-image", "要求必须使用真实首帧参考图，缺图时不退化为文生视频"),
+        param("style_code", "string", false, "--style-code", "模型或风格 code"),
+    ], true, 900),
+];
+export const PUBLIC_DIRECT_TOOLS = DIRECT_TOOLS.filter(isPublicToolSpec);
+export const DIRECT_APPS = [
+    {
+        id: "listing-gallery",
+        aliases: [],
+        name: "商品图库素材包",
+        description: "从一张商品图生成可上架的 Listing 图库，包含白底主图、单卖点证明图、材质结构细节图、生活方式图、标题卖点和上线检查说明",
+        category: "ecommerce",
+        internal_apps: [],
+        required_tools: ["image.cutout", "text.prompt", "image.generate", "text.title"],
+        asset_operations: ["asset.upload"],
+        estimated_duration: 1500,
+        input: [
+            param("image", "file", true, "--image", "商品图片 URL 或本地文件"),
+            param("brief", "string", true, "--brief", "商品卖点、类目、目标平台或图库需求"),
+            param("ratio", "string", false, "--ratio", "统一输出比例；未指定时按图位使用 1:1 / 4:5"),
+            param("copy_mode", "string", false, "--copy-mode", "文案模式：auto / render-text / layout-copy / no-text / ask；auto 会按 brief 判断是否需要画内短文案"),
+            param("model", "string", false, "--model", "生图模型 code / 名称 / auto；未指定时按 Web 默认返回顺序选择"),
+        ],
+        output: outputSpec("workflow"),
+        outputs: ["manifest.json", "README.md", "assets/"],
+        examples: [
+            "gd-cli workflows run listing-gallery --image ./sku.png --brief \"夏季防晒衣，轻薄透气，户外通勤；卖点图短文案：轻薄防晒 通勤无负担\" --copy-mode render-text",
+        ],
+        supports_batch: false,
+        consumes_quota: true,
+    },
+    {
+        id: "pdp-a-plus",
+        aliases: [],
+        name: "详情页/A+模块素材包",
+        description: "按购买说服顺序生成详情页/A+模块素材，包含首屏 Hero、痛点解决、结构细节、真实使用、对比规格和模块文案",
+        category: "ecommerce",
+        internal_apps: [],
+        required_tools: ["image.cutout", "text.prompt", "image.generate", "text.title"],
+        asset_operations: ["asset.upload"],
+        estimated_duration: 1800,
+        input: [
+            param("image", "file", true, "--image", "商品图片 URL 或本地文件"),
+            param("brief", "string", true, "--brief", "商品卖点、购买疑虑、功能参数或详情页需求"),
+            param("ratio", "string", false, "--ratio", "统一输出比例；未指定时按模块使用 16:9 / 4:5 / 1:1"),
+            param("copy_mode", "string", false, "--copy-mode", "文案模式：auto / render-text / layout-copy / no-text / ask；auto 会按 brief 判断是否需要画内短文案"),
+            param("model", "string", false, "--model", "生图模型 code / 名称 / auto；未指定时按 Web 默认返回顺序选择"),
+        ],
+        output: outputSpec("workflow"),
+        outputs: ["manifest.json", "README.md", "assets/"],
+        examples: [
+            "gd-cli workflows run pdp-a-plus --image ./air-purifier.png --brief \"桌面空气净化器，静音，滤芯可更换，适合卧室；首屏短文案：静音净化 安心入睡\" --copy-mode render-text",
+        ],
+        supports_batch: false,
+        consumes_quota: true,
+    },
+    {
+        id: "social-seeding-pack",
+        aliases: [],
+        name: "小红书种草图文包",
+        description: "生成更像真实创作者内容的小红书种草图文，包含移动端封面图、真实场景图、标题、正文、标签和首屏检查说明",
+        category: "ecommerce",
+        internal_apps: [],
+        required_tools: ["image.cutout", "text.prompt", "image.generate", "text.title"],
+        asset_operations: ["asset.upload"],
+        estimated_duration: 1200,
+        input: [
+            param("image", "file", true, "--image", "商品图片 URL 或本地文件"),
+            param("brief", "string", true, "--brief", "商品卖点、笔记角度、目标人群或种草需求"),
+            param("ratio", "string", false, "--ratio", "统一输出比例；未指定时封面 3:4、场景图 9:16"),
+            param("copy_mode", "string", false, "--copy-mode", "文案模式：auto / render-text / layout-copy / no-text / ask；auto 会按 brief 判断是否需要画内短文案"),
+            param("model", "string", false, "--model", "生图模型 code / 名称 / auto；未指定时按 Web 默认返回顺序选择"),
+        ],
+        output: outputSpec("workflow"),
+        outputs: ["manifest.json", "README.md", "assets/"],
+        examples: [
+            "gd-cli workflows run social-seeding-pack --image ./serum.png --brief \"屏障修护精华，清爽不黏，适合通勤包分享；封面短文案：通勤包里的清爽修护\" --copy-mode render-text",
+        ],
+        supports_batch: false,
+        consumes_quota: true,
+    },
+    {
+        id: "campaign-kv-pack",
+        aliases: [],
+        name: "Campaign KV 多渠道素材包",
+        description: "生成可延展到官网、活动页、社媒和电商投放的无字 Campaign KV，包含多比例主视觉、标题利益点和渠道裁切建议",
+        category: "ecommerce",
+        internal_apps: [],
+        required_tools: ["image.cutout", "text.prompt", "image.generate", "text.title"],
+        asset_operations: ["asset.upload"],
+        estimated_duration: 1500,
+        input: [
+            param("image", "file", true, "--image", "商品图片 URL 或本地文件"),
+            param("brief", "string", true, "--brief", "Campaign 主题、目标人群、核心卖点和渠道"),
+            param("ratios", "string", false, "--ratios", "输出比例列表，默认 16:9,1:1,4:5"),
+            param("copy_mode", "string", false, "--copy-mode", "文案模式：auto / render-text / layout-copy / no-text / ask；auto 会按 brief 判断是否需要画内短文案"),
+            param("model", "string", false, "--model", "生图模型 code / 名称 / auto；未指定时按 Web 默认返回顺序选择"),
+        ],
+        output: outputSpec("workflow"),
+        outputs: ["manifest.json", "README.md", "assets/"],
+        examples: [
+            "gd-cli workflows run campaign-kv-pack --image ./running-shoes.png --brief \"城市跑鞋新品 Campaign，轻量缓震，面向通勤跑者；主标题：轻跑进城\" --copy-mode render-text",
+        ],
+        supports_batch: false,
+        consumes_quota: true,
+    },
+];
+export const DIRECT_REGISTRY = {
+    version: "direct-20260521",
+    updated_at: "2026-05-21T00:00:00.000Z",
+    tools: DIRECT_TOOLS,
+    apps: DIRECT_APPS,
+};
+export function resolveToolSpec(id) {
+    return DIRECT_TOOLS.find((tool) => tool.name === id || tool.aliases?.includes(id));
+}
+export function resolvePublicToolSpec(id) {
+    return PUBLIC_DIRECT_TOOLS.find((tool) => tool.name === id || tool.aliases?.includes(id));
+}
+export function isPublicToolSpec(tool) {
+    return !tool.tags.includes("internal");
+}
+export function resolveAppSpec(id) {
+    return DIRECT_APPS.find((app) => app.id === id || app.aliases?.includes(id));
+}
+export function appToolDependencies(app) {
+    return uniqueStrings([
+        ...(app.required_tools ?? []),
+        ...(app.asset_operations ?? []).filter((id) => resolvePublicToolSpec(id)),
+    ]);
+}
+export function appsDependingOnTool(toolId) {
+    return DIRECT_APPS.filter((app) => appToolDependencies(app).includes(toolId));
+}
+function uniqueStrings(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+function tool(name, aliases, displayName, description, category, input, async = false, timeout = 120, internal = false) {
+    return {
+        name,
+        aliases,
+        version: "1.0.0",
+        display_name: displayName,
+        description,
+        category,
+        tags: internal ? [category, "direct", "internal"] : [category, "direct"],
+        endpoint: `direct:${name}`,
+        method: "POST",
+        auth_required: true,
+        async,
+        timeout,
+        rate_limit: commonRateLimit,
+        input,
+        output: outputSpec(category),
+        examples: [
+            {
+                description,
+                input: {},
+                output: {},
+            },
+        ],
+        runtime: runtimeForTool(name),
+        required_env: requiredAkskHeaders,
+    };
+}
+function param(name, type, required, cliFlag, description) {
+    return {
+        name,
+        type,
+        required,
+        description,
+        cli_flag: cliFlag,
+    };
+}
+function outputSpec(type) {
+    return {
+        type,
+        properties: {
+            url: { type: "string", description: "输出资源 URL" },
+            text: { type: "string", description: "输出文本" },
+        },
+    };
+}
+function runtimeForTool(name) {
+    if (name === "image.generate" || name === "video.generate")
+        return "tool-intent-dify";
+    if (name === "image.super-res")
+        return "super-resolution";
+    if (name === "image.svg")
+        return "img2svg";
+    return "dify";
+}

package/dist/src/registry/registry-cache.d.ts

@@ -0,0 +1,10 @@
+import type { RegistryResponse } from "./types.js";
+import type { RegistryClient } from "./registry-client.js";
+export declare class RegistryCache {
+    private client;
+    constructor(client: RegistryClient);
+    get(forceRefresh?: boolean): Promise<RegistryResponse>;
+    private readCache;
+    private writeCache;
+    private refreshInBackground;
+}

package/dist/src/registry/registry-cache.js

@@ -0,0 +1,52 @@
+import fs from "node:fs";
+import path from "node:path";
+import { REGISTRY_CACHE_FILE, CACHE_TTL_MS } from "../utils/config.js";
+import { logger } from "../utils/logger.js";
+import { ensureCredentialDir, ensureCredentialFile } from "../utils/credential-permissions.js";
+export class RegistryCache {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async get(forceRefresh = false) {
+        void forceRefresh;
+        const data = await this.client.fetchRegistry();
+        this.writeCache(data);
+        return data;
+    }
+    readCache() {
+        if (!fs.existsSync(REGISTRY_CACHE_FILE))
+            return null;
+        try {
+            ensureCredentialDir(path.dirname(REGISTRY_CACHE_FILE));
+            ensureCredentialFile(REGISTRY_CACHE_FILE);
+            const raw = fs.readFileSync(REGISTRY_CACHE_FILE, "utf-8");
+            const entry = JSON.parse(raw);
+            const age = Date.now() - new Date(entry.fetched_at).getTime();
+            if (age > CACHE_TTL_MS)
+                return null;
+            return entry.data;
+        }
+        catch {
+            return null;
+        }
+    }
+    writeCache(data) {
+        const dir = path.dirname(REGISTRY_CACHE_FILE);
+        ensureCredentialDir(dir);
+        const entry = {
+            fetched_at: new Date().toISOString(),
+            data,
+        };
+        fs.writeFileSync(REGISTRY_CACHE_FILE, JSON.stringify(entry, null, 2), { mode: 0o600 });
+        ensureCredentialFile(REGISTRY_CACHE_FILE);
+    }
+    refreshInBackground() {
+        this.client
+            .fetchRegistry()
+            .then((data) => this.writeCache(data))
+            .catch(() => {
+            logger.debug("Registry 后台刷新失败，继续使用缓存");
+        });
+    }
+}

package/dist/src/registry/registry-client.d.ts

@@ -0,0 +1,28 @@
+import type { HubClient } from "../api/hub-client.js";
+import type { RegistryResponse } from "./types.js";
+export declare class RegistryClient {
+    private client;
+    constructor(client: HubClient);
+    fetchRegistry(): Promise<RegistryResponse>;
+    getDetail(id: string): Promise<import("./types.js").ToolSpec | import("./types.js").AppSpec>;
+    search(query: string, options?: {
+        type?: string;
+        limit?: number;
+    }): Promise<{
+        results: ({
+            id: string;
+            type: string;
+            display_name: string;
+            description: string;
+            category: "asset" | "text" | "image" | "video" | "agent" | "template" | "infrastructure";
+            spec: import("./types.js").ToolSpec;
+        } | {
+            id: string;
+            type: string;
+            display_name: string;
+            description: string;
+            category: string;
+            spec: import("./types.js").AppSpec;
+        })[];
+    }>;
+}

package/dist/src/registry/registry-client.js

@@ -0,0 +1,50 @@
+import { DIRECT_APPS, DIRECT_REGISTRY, PUBLIC_DIRECT_TOOLS, resolveAppSpec, resolveToolSpec, } from "./direct-registry.js";
+export class RegistryClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async fetchRegistry() {
+        void this.client;
+        return DIRECT_REGISTRY;
+    }
+    async getDetail(id) {
+        const tool = resolveToolSpec(id);
+        if (tool)
+            return tool;
+        const app = resolveAppSpec(id);
+        if (app)
+            return app;
+        throw new Error(`未找到能力: ${id}`);
+    }
+    async search(query, options) {
+        const q = query.trim().toLowerCase();
+        const toolResults = PUBLIC_DIRECT_TOOLS.map((spec) => ({
+            id: spec.name,
+            type: "tool",
+            display_name: spec.display_name,
+            description: spec.description,
+            category: spec.category,
+            spec,
+        }));
+        const appResults = DIRECT_APPS.map((spec) => ({
+            id: spec.id,
+            type: "app",
+            display_name: spec.name,
+            description: spec.description,
+            category: spec.category,
+            spec,
+        }));
+        const all = [
+            ...(!options?.type || options.type === "tool" ? toolResults : []),
+            ...(!options?.type || options.type === "app" ? appResults : []),
+        ].filter((item) => {
+            if (!q)
+                return true;
+            return (item.id.toLowerCase().includes(q) ||
+                item.display_name.toLowerCase().includes(q) ||
+                item.description.toLowerCase().includes(q));
+        });
+        return { results: all.slice(0, options?.limit ?? all.length) };
+    }
+}

package/dist/src/registry/types.d.ts

@@ -0,0 +1,69 @@
+export interface RegistryResponse {
+    version: string;
+    updated_at: string;
+    tools: ToolSpec[];
+    apps: AppSpec[];
+}
+export interface ToolSpec {
+    name: string;
+    aliases?: string[];
+    version: string;
+    display_name: string;
+    description: string;
+    category: "image" | "text" | "video" | "agent" | "infrastructure" | "template" | "asset";
+    tags: string[];
+    endpoint: string;
+    method: "GET" | "POST" | "PUT";
+    auth_required: boolean;
+    async: boolean;
+    timeout: number;
+    rate_limit: {
+        rpm: number;
+        daily: number;
+    };
+    input: ParamSpec[];
+    output: OutputSpec;
+    examples: ExampleSpec[];
+    runtime?: string;
+    required_env?: string[];
+}
+export interface AppSpec {
+    id: string;
+    aliases?: string[];
+    name: string;
+    description: string;
+    category: string;
+    internal_apps: string[];
+    required_tools: string[];
+    asset_operations?: string[];
+    estimated_duration: number;
+    input: ParamSpec[];
+    output: OutputSpec;
+    examples?: string[];
+    outputs?: string[];
+    supports_batch?: boolean;
+    consumes_quota?: boolean;
+}
+/** @deprecated Use AppSpec */
+export type SceneSpec = AppSpec;
+export interface ParamSpec {
+    name: string;
+    type: "string" | "number" | "boolean" | "file" | "object";
+    required: boolean;
+    default?: unknown;
+    enum?: unknown[];
+    description: string;
+    cli_flag: string;
+}
+export interface OutputSpec {
+    type: string;
+    properties: Record<string, {
+        type: string;
+        description: string;
+    }>;
+}
+export interface ExampleSpec {
+    description: string;
+    input: Record<string, unknown>;
+    output: Record<string, unknown>;
+}

package/dist/src/registry/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/tty/auth-presenter.d.ts

@@ -0,0 +1,3 @@
+export declare function printAuthQrAndLink(uri: string): Promise<void>;
+export declare function emitAuthEvent(event: Record<string, unknown>): void;
+export declare function formatRemainingSeconds(expiresAtMs: number): string;

package/dist/src/tty/auth-presenter.js

@@ -0,0 +1,21 @@
+import chalk from "chalk";
+import qrcode from "qrcode";
+import { getIO } from "../io.js";
+export async function printAuthQrAndLink(uri) {
+    console.log(chalk.bold("请扫码或打开链接完成授权："));
+    console.log(`${chalk.cyan(uri)}`);
+    if (getIO().stdoutIsTTY) {
+        const qr = await qrcode.toString(uri, { type: "terminal", small: true });
+        console.log("");
+        console.log(qr);
+    }
+}
+export function emitAuthEvent(event) {
+    if (getIO().stdoutIsTTY)
+        return;
+    console.log(JSON.stringify(event));
+}
+export function formatRemainingSeconds(expiresAtMs) {
+    const left = Math.max(0, Math.ceil((expiresAtMs - Date.now()) / 1000));
+    return `${left}s`;
+}

package/dist/src/update/install-source.d.ts

@@ -0,0 +1,19 @@
+export type PackageManager = "npm" | "pnpm" | "yarn" | "brew";
+export type InstallSourceKind = "global" | "linked" | "local" | "npx";
+export interface InstallSource {
+    manager: PackageManager;
+    kind: InstallSourceKind;
+    binPath: string;
+    realBinPath: string;
+    packageRoot?: string;
+    reason?: string;
+}
+export interface UpdateCommand {
+    command: string;
+    args: string[];
+    display: string;
+}
+export declare function detectInstallSource(managerOverride?: string): InstallSource;
+export declare function classifyInstallSource(binPath: string, packageRoot: string | undefined, cwd: string): InstallSourceKind;
+export declare function buildUpdateCommand(version: string, source: Pick<InstallSource, "manager">): UpdateCommand;
+export declare function findPackageRoot(startFile: string): string | undefined;

package/dist/src/update/install-source.js

@@ -0,0 +1,139 @@
+import fs from "node:fs";
+import path from "node:path";
+import { CLI_PACKAGE_NAME } from "../utils/config.js";
+export function detectInstallSource(managerOverride) {
+    const binPath = process.argv[1] ?? "";
+    const realBinPath = safeRealpath(binPath) ?? binPath;
+    const packageRoot = findPackageRoot(realBinPath);
+    const manager = normalizeManager(managerOverride) ?? inferPackageManager(realBinPath);
+    const kind = process.env.GD_CLI_DEV === "1"
+        ? "linked"
+        : classifyInstallSource(binPath, packageRoot, process.cwd());
+    return {
+        manager,
+        kind,
+        binPath,
+        realBinPath,
+        packageRoot,
+        reason: blockedReason(kind),
+    };
+}
+export function classifyInstallSource(binPath, packageRoot, cwd) {
+    const normalizedBin = normalizePath(binPath);
+    const normalizedRoot = packageRoot ? normalizePath(packageRoot) : "";
+    if (normalizedRoot && !normalizedRoot.includes("/node_modules/")) {
+        return "linked";
+    }
+    if (normalizedBin.includes("/.npm/_npx/")
+        || normalizedRoot.includes("/.npm/_npx/")) {
+        return "npx";
+    }
+    const localNodeModules = `${normalizePath(path.resolve(cwd, "node_modules"))}/`;
+    if (normalizedBin.includes("/node_modules/.bin/")
+        || normalizedRoot.startsWith(localNodeModules)) {
+        return "local";
+    }
+    return "global";
+}
+export function buildUpdateCommand(version, source) {
+    const spec = `${CLI_PACKAGE_NAME}@${version}`;
+    if (source.manager === "pnpm") {
+        return {
+            command: "pnpm",
+            args: ["add", "-g", spec],
+            display: `pnpm add -g ${spec}`,
+        };
+    }
+    if (source.manager === "yarn") {
+        return {
+            command: "yarn",
+            args: ["global", "add", spec],
+            display: `yarn global add ${spec}`,
+        };
+    }
+    if (source.manager === "brew") {
+        return {
+            command: "brew",
+            args: ["upgrade", "gaoding-cli"],
+            display: "brew upgrade gaoding-cli",
+        };
+    }
+    return {
+        command: "npm",
+        args: ["install", "-g", spec],
+        display: `npm install -g ${spec}`,
+    };
+}
+function inferPackageManager(realBinPath) {
+    const forced = normalizeManager(process.env.GD_CLI_UPDATE_MANAGER);
+    if (forced)
+        return forced;
+    const userAgent = process.env.npm_config_user_agent ?? "";
+    if (userAgent.startsWith("pnpm/"))
+        return "pnpm";
+    if (userAgent.startsWith("yarn/"))
+        return "yarn";
+    if (userAgent.startsWith("npm/"))
+        return "npm";
+    const npmExecPath = process.env.npm_execpath ?? "";
+    if (npmExecPath.includes("pnpm"))
+        return "pnpm";
+    if (npmExecPath.includes("yarn"))
+        return "yarn";
+    if (realBinPath.includes(`${path.sep}.pnpm${path.sep}`))
+        return "pnpm";
+    if (realBinPath.includes(`${path.sep}.config${path.sep}yarn${path.sep}`))
+        return "yarn";
+    if (realBinPath.includes(`${path.sep}homebrew${path.sep}`) || realBinPath.includes(`${path.sep}Cellar${path.sep}`)) {
+        return "brew";
+    }
+    return "npm";
+}
+function normalizeManager(value) {
+    if (!value)
+        return null;
+    if (value === "npm" || value === "pnpm" || value === "yarn" || value === "brew") {
+        return value;
+    }
+    return null;
+}
+export function findPackageRoot(startFile) {
+    let dir = fs.existsSync(startFile) && fs.statSync(startFile).isDirectory()
+        ? startFile
+        : path.dirname(startFile);
+    while (dir && dir !== path.dirname(dir)) {
+        const pkg = path.join(dir, "package.json");
+        if (fs.existsSync(pkg)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(pkg, "utf8"));
+                if (parsed.name === CLI_PACKAGE_NAME)
+                    return dir;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        dir = path.dirname(dir);
+    }
+    return undefined;
+}
+function safeRealpath(file) {
+    try {
+        return fs.realpathSync(file);
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizePath(value) {
+    return value.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+function blockedReason(kind) {
+    if (kind === "linked")
+        return "当前 gd-cli 是 npm link 或本地开发 checkout";
+    if (kind === "local")
+        return "当前 gd-cli 安装在项目 node_modules 中";
+    if (kind === "npx")
+        return "当前 gd-cli 由 npx 临时运行";
+    return undefined;
+}

package/dist/src/update/notifier.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function maybeNotifyUpdate(command: Command): Promise<void>;