cgraphx 1.4.3 → 2.0.0

package/dist/installer/index.js

@@ -1,692 +0,0 @@
-"use strict";
-/**
- * CodeGraph Interactive Installer
- *
- * Multi-target: writes MCP server config + instructions for the
- * agents the user picks (Claude Code, Cursor, Codex CLI, opencode,
- * Hermes Agent, Gemini CLI, Antigravity IDE).
- * Defaults to the Claude-only behavior for backwards compatibility
- * when no targets are explicitly chosen and nothing else is detected.
- *
- * Uses @clack/prompts for the interactive UI; `runInstallerWithOptions`
- * is the non-interactive entry point used by the `--target` /
- * `--print-config` CLI flags.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasPermissions = exports.hasMcpConfig = exports.writePermissions = exports.writeMcpConfig = void 0;
-exports.runInstaller = runInstaller;
-exports.runInstallerWithOptions = runInstallerWithOptions;
-exports.uninstallTargets = uninstallTargets;
-exports.runUninstaller = runUninstaller;
-exports.offerWatchFallback = offerWatchFallback;
-const child_process_1 = require("child_process");
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
-const registry_1 = require("./targets/registry");
-// Import the lightweight submodules directly (not the ../sync barrel, which
-// re-exports FileWatcher and would transitively pull in ../extraction — the
-// installer must stay importable even when native modules can't load).
-const watch_policy_1 = require("../sync/watch-policy");
-const git_hooks_1 = require("../sync/git-hooks");
-const directory_1 = require("../directory");
-const telemetry_1 = require("../telemetry");
-const upgrade_1 = require("../upgrade");
-// Backwards-compat: keep these named exports — downstream code may
-// import them. The shim in `config-writer.ts` continues to re-export
-// them too.
-var config_writer_1 = require("./config-writer");
-Object.defineProperty(exports, "writeMcpConfig", { enumerable: true, get: function () { return config_writer_1.writeMcpConfig; } });
-Object.defineProperty(exports, "writePermissions", { enumerable: true, get: function () { return config_writer_1.writePermissions; } });
-Object.defineProperty(exports, "hasMcpConfig", { enumerable: true, get: function () { return config_writer_1.hasMcpConfig; } });
-Object.defineProperty(exports, "hasPermissions", { enumerable: true, get: function () { return config_writer_1.hasPermissions; } });
-// Dynamic import helper — tsc compiles import() to require() in CJS mode,
-// which fails for ESM-only packages. This bypasses the transformation.
-// eslint-disable-next-line @typescript-eslint/no-implied-eval
-const importESM = new Function('specifier', 'return import(specifier)');
-function getVersion() {
-    try {
-        const packageJsonPath = path.join(__dirname, '..', '..', 'package.json');
-        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-        return packageJson.version;
-    }
-    catch {
-        return '0.0.0';
-    }
-}
-/**
- * Interactive entry point — preserves the historical UX (`cgraphx
- * install` with no args goes through the prompts), but now starts
- * the targets multi-select pre-populated with detected agents.
- */
-async function runInstaller() {
-    return runInstallerWithOptions({});
-}
-async function runInstallerWithOptions(opts) {
-    const clack = await importESM('@clack/prompts');
-    clack.intro(`cgraphx v${getVersion()}`);
-    // --yes implies all defaults; explicit flags still win.
-    const useDefaults = opts.yes === true;
-    // Step 1: which agent targets? Asked FIRST so the user knows what
-    // they're committing to before we touch npm or disk. Detection
-    // probes the user-provided location if known, else 'global' as the
-    // most common default — labels are a hint, not load-bearing.
-    const detectionLocation = opts.location ?? 'global';
-    const targets = await resolveTargets(clack, opts, detectionLocation, useDefaults);
-    if (targets.length === 0) {
-        clack.outro('未选择任何 agent —— 无操作。');
-        return;
-    }
-    // Step 2: install the cgraphx npm package on PATH (only when NOT already
-    // there). Skipped silently when the CLI is detected on PATH — running this
-    // for an already-installed user is both noise (a pointless prompt) and
-    // fragile (re-running `npm install -g <pkg>` pulls from the registry, which
-    // fails pre-publish or in air-gapped setups even though the CLI works fine).
-    if (!useDefaults) {
-        const existingPath = detectCodegraphOnPath();
-        if (existingPath) {
-            clack.log.info(`cgraphx CLI 已在 PATH 上(${existingPath})—— 跳过安装步骤。`);
-        }
-        else {
-            const shouldInstallGlobally = await clack.confirm({
-                message: '是否安装 cgraphx CLI 到 PATH?(agent 启动 MCP server 必须用到)',
-                initialValue: true,
-            });
-            if (clack.isCancel(shouldInstallGlobally)) {
-                clack.cancel('安装已取消。');
-                process.exit(0);
-            }
-            if (shouldInstallGlobally) {
-                const s = clack.spinner();
-                s.start('正在安装 cgraphx CLI...');
-                try {
-                    // Capture stderr so the real failure (404 from registry, EACCES,
-                    // network) surfaces instead of being hidden behind a guessed
-                    // "permission denied" message.
-                    const result = (0, child_process_1.execSync)(`npm install -g ${upgrade_1.NPM_PACKAGE}`, {
-                        stdio: ['pipe', 'pipe', 'pipe'],
-                        windowsHide: true,
-                    });
-                    s.stop('cgraphx CLI 已安装到 PATH');
-                    void result; // output suppressed — npm progress bars aren't useful here
-                }
-                catch (err) {
-                    const stderr = extractStderr(err);
-                    s.stop('cgraphx CLI 安装失败');
-                    clack.log.warn(formatInstallHint(stderr));
-                }
-            }
-            else {
-                clack.log.info('已跳过 CLI 安装 —— 没有它 agent 无法启动 MCP server');
-            }
-        }
-    }
-    // Step 3: where the per-agent config files should land.
-    // Default is LOCAL (project-level) — keeps user's global ~/.claude/,
-    // ~/.codex/ etc. untouched unless they explicitly opt in with --location=global
-    // or pick "All projects" in the prompt.
-    let location;
-    if (opts.location) {
-        location = opts.location;
-    }
-    else if (useDefaults) {
-        // --yes path: pick local unless every selected target is global-only
-        // (e.g. Codex has no project-local config slot).
-        const allGlobalOnly = targets.every((t) => !t.supportsLocation('local'));
-        location = allGlobalOnly ? 'global' : 'local';
-    }
-    else {
-        // If every selected target is global-only (e.g. Codex), skip the
-        // prompt and force user-wide — project-local would just produce
-        // skip warnings.
-        const allGlobalOnly = targets.every((t) => !t.supportsLocation('local'));
-        if (allGlobalOnly) {
-            location = 'global';
-            clack.log.info('写入用户级配置(选中的 agent 不支持项目级配置)。');
-        }
-        else {
-            const sel = await clack.select({
-                message: '配置应用到当前项目,还是所有项目?',
-                options: [
-                    { value: 'local', label: '仅当前项目(推荐)', hint: './.claude, ./.cursor 等' },
-                    { value: 'global', label: '⚠️  所有项目(不建议)', hint: '会影响你所有项目;如非必要不要选' },
-                ],
-                initialValue: 'local',
-            });
-            if (clack.isCancel(sel)) {
-                clack.cancel('安装已取消。');
-                process.exit(0);
-            }
-            location = sel;
-        }
-    }
-    // Step 4: auto-allow permissions (only meaningful for Claude;
-    // skipped silently by other targets).
-    let autoAllow;
-    if (opts.autoAllow !== undefined) {
-        autoAllow = opts.autoAllow;
-    }
-    else if (useDefaults) {
-        autoAllow = true;
-    }
-    else if (targets.some((t) => t.id === 'claude')) {
-        const ans = await clack.confirm({
-            message: '自动批准 cgraphx 命令?(跳过 Claude Code 中的权限确认弹窗)',
-            initialValue: true,
-        });
-        if (clack.isCancel(ans)) {
-            clack.cancel('安装已取消。');
-            process.exit(0);
-        }
-        autoAllow = ans;
-    }
-    else {
-        autoAllow = false;
-    }
-    // Step 4½: anonymous usage telemetry — a visible default-on toggle, asked
-    // exactly once. Skipped when an env var (DO_NOT_TRACK / CGRAPHX_TELEMETRY)
-    // already decides, or when a previous run stored a choice — re-runs and
-    // upgrades never re-ask.
-    if (!useDefaults && (0, telemetry_1.getTelemetry)().getStatus().decidedBy === 'default' && !(0, telemetry_1.getTelemetry)().hasStoredChoice()) {
-        const share = await clack.confirm({
-            message: '是否分享匿名使用统计?(不含代码、路径、名称 —— 详见 TELEMETRY.md)',
-            initialValue: true,
-        });
-        if (clack.isCancel(share)) {
-            // Don't kill the install over the telemetry question — leave it
-            // undecided (the documented default + first-run notice applies later).
-            clack.log.info('已跳过 —— 随时用 `cgraphx telemetry on|off` 切换。');
-        }
-        else {
-            (0, telemetry_1.getTelemetry)().setEnabled(share, 'installer');
-            clack.log.info(share
-                ? `感谢!具体收集内容见:${telemetry_1.TELEMETRY_DOCS}`
-                : '已关闭遥测 —— 不会收集或发送任何数据。');
-        }
-    }
-    // Step 4¾: front-load prompt hook (Claude Code only). A UserPromptSubmit hook
-    // that runs `cgraphx prompt-hook` — it injects codegraph_explore context on
-    // structural ("how / where / trace / impact") prompts so the agent reliably
-    // reaches for the graph instead of grepping. Opt-in, default-yes. Only Claude
-    // Code has UserPromptSubmit, so it's offered only when Claude is a target;
-    // other targets ignore the option. `undefined` (no Claude / not asked) leaves
-    // any existing hook untouched.
-    let promptHook;
-    if (targets.some((t) => t.id === 'claude')) {
-        if (useDefaults) {
-            promptHook = true; // --yes → on
-        }
-        else {
-            const ans = await clack.confirm({
-                message: '⚠️  是否启用 cgraphx 前置注入?(非常不建议 —— 仅对不会主动调工具的弱 agent 有用)',
-                initialValue: false,
-            });
-            if (clack.isCancel(ans)) {
-                clack.cancel('安装已取消。');
-                process.exit(0);
-            }
-            promptHook = ans; // false → opt out; install() strips any prior hook
-        }
-    }
-    // Step 5: per-target install loop.
-    const installedIds = [];
-    let sawCreated = false;
-    let sawUpdated = false;
-    for (const target of targets) {
-        if (!target.supportsLocation(location)) {
-            clack.log.warn(`${target.displayName}:已跳过 —— 不支持 --location=${location}。`);
-            continue;
-        }
-        const result = target.install(location, { autoAllow, promptHook });
-        installedIds.push(target.id);
-        for (const file of result.files) {
-            if (file.action === 'created')
-                sawCreated = true;
-            if (file.action === 'updated')
-                sawUpdated = true;
-            const verb = file.action === 'unchanged'
-                ? 'Unchanged'
-                : file.action === 'created' ? 'Created'
-                    : file.action === 'removed' ? 'Removed'
-                        : 'Updated';
-            clack.log.success(`${target.displayName}: ${verb} ${tildify(file.path)}`);
-        }
-        for (const note of result.notes ?? []) {
-            clack.log.info(`${target.displayName}: ${note}`);
-        }
-    }
-    // Telemetry: which agents were configured, where, fresh-vs-upgrade (derived
-    // from the file actions above). Target IDs and the location enum only.
-    if (installedIds.length > 0) {
-        (0, telemetry_1.getTelemetry)().recordLifecycle('install', {
-            targets: installedIds,
-            scope: location,
-            kind: sawCreated ? 'fresh' : sawUpdated ? 'upgrade' : 'reinstall',
-        });
-    }
-    // Step 5½: optional subsystem setup — docs / db / timeline.
-    // Each is independent and runs only if the user keeps it checked.
-    // Skipped silently under --yes if their preconditions aren't met
-    // (e.g. db init needs .cgraphx/ to exist; docs needs docs/knowledge/).
-    const projectRoot = process.cwd();
-    const codegraphExists = fs.existsSync((0, directory_1.getCodeGraphDir)(projectRoot));
-    const docsDir = path.join(projectRoot, 'docs', 'knowledge');
-    const docsHasMd = fs.existsSync(docsDir) &&
-        fs.readdirSync(docsDir).some(f => f.endsWith('.md') || f.endsWith('.mdx'));
-    let chosen;
-    if (useDefaults) {
-        chosen = ['docs', 'db', 'timeline'];
-    }
-    else {
-        const sel = await clack.multiselect({
-            message: '配置可选子系统(回车确认默认全选)',
-            options: [
-                { value: 'docs', label: '文档知识库', hint: docsHasMd ? '扫描 docs/knowledge/' : 'docs/knowledge/ 不存在 — 跳过' },
-                { value: 'db', label: '数据库查询', hint: codegraphExists ? '生成 .cgraphx/db-profiles.json 模板' : '.cgraphx/ 不存在 — 跳过' },
-                { value: 'timeline', label: 'Developer Timeline', hint: '装 Claude Code hooks(项目级)' },
-            ],
-            initialValues: ['docs', 'db', 'timeline'],
-            required: false,
-        });
-        if (clack.isCancel(sel)) {
-            clack.cancel('取消');
-            process.exit(0);
-        }
-        chosen = sel;
-    }
-    if (chosen.includes('docs')) {
-        if (!codegraphExists) {
-            clack.log.info('.cgraphx/ 不存在 — 文档子系统跳过(跑 `cgraphx init` 后再 `cgraphx docs index`)');
-        }
-        else if (docsHasMd) {
-            const s = clack.spinner();
-            s.start('索引文档知识库...');
-            try {
-                const { indexMarkdownKnowledgeBase } = await Promise.resolve().then(() => __importStar(require('../markdown/indexer')));
-                const report = await indexMarkdownKnowledgeBase(projectRoot);
-                s.stop(`文档知识库已建(${report.indexedDocuments} 篇文档,${report.skippedFiles} 篇跳过)`);
-            }
-            catch (err) {
-                s.stop('文档索引失败');
-                clack.log.warn(`docs index 失败:${err instanceof Error ? err.message : String(err)}(可稍后手动跑 \`cgraphx docs index\`)`);
-            }
-        }
-        else {
-            clack.log.info('docs/knowledge/ 不存在或为空 — 文档子系统跳过(后续可创建文档后跑 `cgraphx docs index`)');
-        }
-    }
-    if (chosen.includes('db')) {
-        if (codegraphExists) {
-            try {
-                const { initDbProfiles } = await Promise.resolve().then(() => __importStar(require('../dbquery/init')));
-                const report = initDbProfiles(projectRoot);
-                if (report.action === 'already-exists') {
-                    clack.log.info('db-profiles.json 已存在 — 保留用户配置(如需重置加 --force 跑 `cgraphx db init`)');
-                }
-                else {
-                    clack.log.success(`已生成 ${report.filePath} — 编辑后填实际密码`);
-                }
-            }
-            catch (err) {
-                clack.log.warn(`db init 失败:${err instanceof Error ? err.message : String(err)}`);
-            }
-        }
-        else {
-            clack.log.info('.cgraphx/ 不存在 — 数据库子系统跳过(跑 `cgraphx init` 后再 `cgraphx db init`)');
-        }
-    }
-    if (chosen.includes('timeline')) {
-        try {
-            const { installTimelineHooks } = await Promise.resolve().then(() => __importStar(require('../timeline/installer')));
-            const report = installTimelineHooks(projectRoot);
-            const events = report.writtenHookEvents.length > 0
-                ? report.writtenHookEvents.join('/')
-                : '已存在(幂等)';
-            const git = report.gitHookWritten
-                ? ' + git post-commit'
-                : report.gitHookPath ? '(git hook 已存在)' : '(非 git 仓库,跳过 git hook)';
-            clack.log.success(`Developer Timeline 已装:${events}${git}`);
-        }
-        catch (err) {
-            clack.log.warn(`timeline install 失败:${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    // Step 6: install wires up agents only — it deliberately does NOT index.
-    // Building the per-project graph is the user's explicit `cgraphx init`
-    // (or `index`), so they choose what gets indexed and when, and we never
-    // index a surprise directory (e.g. a shell sitting in $HOME). Same next step
-    // regardless of global/local scope.
-    clack.note(location === 'local'
-        ? 'cgraphx init        # 构建本项目的代码图(一次性;之后自动同步)'
-        : 'cd <你的项目>\ncgraphx init        # 构建项目代码图(一次性;之后自动同步)', '下一步:索引一个项目');
-    // Deliver buffered telemetry while we're already in a long interactive
-    // command — bounded (~1.5s worst case), invisible after a multi-second install.
-    await (0, telemetry_1.getTelemetry)().flushNow();
-    const finalNote = targets.length > 0
-        ? `完成!重启你的 agent${targets.length > 1 ? 's' : ''} 即可使用 cgraphx。`
-        : '完成!';
-    clack.outro(finalNote);
-}
-/**
- * Pure uninstall sweep — no prompts, no I/O beyond the targets' own
- * file edits. Exposed (and unit-tested) separately from the clack UI in
- * `runUninstaller` so the aggregation logic can be asserted directly.
- *
- * Each target's `uninstall()` is already safe to call when nothing was
- * installed (it returns `not-found` actions), so this is safe to run
- * across every target unconditionally.
- */
-function uninstallTargets(targets, location) {
-    return targets.map((target) => {
-        if (!target.supportsLocation(location)) {
-            const only = location === 'local' ? 'global' : 'local';
-            return {
-                id: target.id,
-                displayName: target.displayName,
-                status: 'unsupported',
-                removedPaths: [],
-                notes: [`no ${location} config — this agent is ${only}-only`],
-            };
-        }
-        const result = target.uninstall(location);
-        const removedPaths = result.files
-            .filter((f) => f.action === 'removed')
-            .map((f) => f.path);
-        return {
-            id: target.id,
-            displayName: target.displayName,
-            status: removedPaths.length > 0 ? 'removed' : 'not-configured',
-            removedPaths,
-            notes: result.notes ?? [],
-        };
-    });
-}
-/**
- * Interactive uninstaller — the inverse of `runInstallerWithOptions`.
- * Asks global-vs-local first (unless `--location`/`--yes` is given),
- * then sweeps every agent target (or the `--target` subset) and prints
- * one block per agent so the user sees exactly which providers it hit.
- *
- * Removes only what install wrote (MCP server entry, instructions
- * block, permissions) — never the `.cgraphx/` index, which `codegraph
- * uninit` owns.
- */
-async function runUninstaller(opts) {
-    const clack = await importESM('@clack/prompts');
-    clack.intro(`cgraphx v${getVersion()} —— 卸载`);
-    const useDefaults = opts.yes === true;
-    // Step 1: which location — asked FIRST, the one decision the user
-    // must make. Default is GLOBAL for uninstall — clean every trace of
-    // CodeGraph from the user's home (project-local files are easy for the
-    // user to delete themselves; ~/.claude/ etc. are the dangerous ones
-    // they want CodeGraph to remove for them).
-    let location;
-    if (opts.location) {
-        location = opts.location;
-    }
-    else if (useDefaults) {
-        location = 'global';
-    }
-    else {
-        const sel = await clack.select({
-            message: '从所有项目移除 cgraphx,还是仅当前项目?',
-            options: [
-                { value: 'global', label: '所有项目(全局)', hint: '~/.claude, ~/.cursor, ~/.codex, ~/.config/opencode, ~/.hermes, ~/.gemini, ~/.kiro' },
-                { value: 'local', label: '仅当前项目(本地)', hint: './.claude, ./.cursor, ./opencode.jsonc, ./.gemini, ./.kiro' },
-            ],
-            initialValue: 'global',
-        });
-        if (clack.isCancel(sel)) {
-            clack.cancel('卸载已取消。');
-            process.exit(0);
-        }
-        location = sel;
-    }
-    // Step 2: which agents. Default is every agent, so the user doesn't
-    // have to remember where they installed it — unconfigured agents are
-    // reported as "nothing to remove" and left untouched. An explicit
-    // --target subsets this.
-    let targets;
-    if (opts.target !== undefined) {
-        targets = (0, registry_1.resolveTargetFlag)(opts.target, location);
-    }
-    else {
-        targets = [...registry_1.ALL_TARGETS];
-    }
-    if (targets.length === 0) {
-        clack.outro('未选择任何 agent —— 无操作。');
-        return;
-    }
-    // Step 3: sweep + per-agent feedback.
-    const reports = uninstallTargets(targets, location);
-    const removed = reports.filter((r) => r.status === 'removed');
-    for (const r of reports) {
-        if (r.status === 'removed') {
-            for (const p of r.removedPaths) {
-                clack.log.success(`${r.displayName}:已移除 ${tildify(p)}`);
-            }
-        }
-        else if (r.status === 'not-configured') {
-            clack.log.info(`${r.displayName}:未配置 —— 无需移除`);
-        }
-        else {
-            clack.log.info(`${r.displayName}:已跳过 —— ${r.notes[0] ?? '不支持该位置'}`);
-        }
-    }
-    // Step 4: for local uninstall, the index dir is separate — point at
-    // `uninit` so the user knows it's still there (and how to remove it).
-    if (location === 'local' && fs.existsSync((0, directory_1.getCodeGraphDir)(process.cwd()))) {
-        clack.log.info(`本项目的 ${(0, directory_1.codeGraphDirName)()}/ 索引仍然存在。运行 \`cgraphx uninit\` 删除。`);
-    }
-    // Telemetry churn signal (agent IDs only) — flush now, since after an
-    // uninstall there is usually no "next run" to deliver it.
-    if (removed.length > 0) {
-        (0, telemetry_1.getTelemetry)().recordLifecycle('uninstall', { targets: removed.map((r) => r.id) });
-        await (0, telemetry_1.getTelemetry)().flushNow();
-    }
-    // Step 5: summary.
-    if (removed.length > 0) {
-        const names = removed.map((r) => r.displayName).join(', ');
-        clack.outro(`已从 ${removed.length} 个 agent${removed.length > 1 ? 's' : ''} 移除 cgraphx:${names}。` +
-            `重启 ${removed.length > 1 ? '它们' : '它'} 后生效。`);
-    }
-    else {
-        clack.outro(`cgraphx 未在任何 ${location} agent 中配置 —— 无需移除。`);
-    }
-}
-/**
- * Replace home-directory prefix in a path with `~/` for cleaner log
- * lines. Pure cosmetic.
- */
-function tildify(p) {
-    const home = require('os').homedir();
-    if (p.startsWith(home + path.sep))
-        return '~' + p.substring(home.length);
-    return p;
-}
-/**
- * Detect whether the `cgraphx` command is already resolvable on PATH.
- *
- * Cross-platform: `command -v` works on POSIX, `where` on Windows. Returns
- * the resolved absolute path on success (first line of output, in case
- * Windows `where` lists multiple matches) or null when not found / lookup
- * failed. Never throws.
- */
-function detectCodegraphOnPath() {
-    const cmd = process.platform === 'win32' ? 'where cgraphx' : 'command -v cgraphx || which cgraphx';
-    try {
-        const out = (0, child_process_1.execSync)(cmd, {
-            stdio: ['pipe', 'pipe', 'pipe'],
-            windowsHide: true,
-            encoding: 'utf-8',
-        });
-        const first = out.split(/\r?\n/).find(l => l.trim().length > 0);
-        return first ? first.trim() : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Pull stderr out of an execSync error object for display. execSync wraps the
- * underlying error in an Error with `.stderr` / `.stdout` Buffers when
- * stdio is piped — surface that instead of guessing the cause.
- */
-function extractStderr(err) {
-    if (err && typeof err === 'object') {
-        const e = err;
-        if (e.stderr)
-            return e.stderr.toString().trim();
-        if (e.stdout)
-            return e.stdout.toString().trim();
-        if (e.message)
-            return e.message;
-    }
-    return String(err);
-}
-/**
- * Build a platform-appropriate hint when `npm install -g` fails. `sudo` is
- * meaningless on Windows — the user needs to either rerun PowerShell as
- * Administrator or change npm's prefix to a user-writable directory.
- */
-function formatInstallHint(stderr) {
-    const is404 = /404\s+not\s+found/i.test(stderr) || /cgraphx/i.test(stderr) && /not\s+found/i.test(stderr);
-    if (is404) {
-        return `${upgrade_1.NPM_PACKAGE} is not yet published to npm. Run \`npm publish\` first, or install locally with \`npm install -g ./cgraphx-<version>.tgz\`.`;
-    }
-    if (process.platform === 'win32') {
-        return `Try: open PowerShell as Administrator and run \`npm install -g ${upgrade_1.NPM_PACKAGE}\`. Or change npm prefix to a user-writable directory: \`npm config set prefix "$APPDATA\\npm"\`.`;
-    }
-    return `Try: \`sudo npm install -g ${upgrade_1.NPM_PACKAGE}\`, or change npm prefix to avoid sudo.`;
-}
-async function resolveTargets(clack, opts, location, useDefaults) {
-    // Explicit --target flag wins.
-    if (opts.target !== undefined) {
-        return (0, registry_1.resolveTargetFlag)(opts.target, location);
-    }
-    // --yes implies auto-detect.
-    if (useDefaults) {
-        return (0, registry_1.resolveTargetFlag)('auto', location);
-    }
-    // Interactive multi-select.
-    // cgraphx policy: default to Claude Code ALONE, regardless of how
-    // many other agents happen to be detected on the machine. The user can
-    // opt into more by arrow-keying down and selecting them — but the
-    // "press Enter to confirm" path installs only what 90% of users want.
-    // Detection still runs so the `(detected)` labels are accurate.
-    const detected = (0, registry_1.detectAll)(location);
-    const initial = ['claude'];
-    const choice = await clack.multiselect({
-        message: '要为哪些 agent 配置 cgraphx?',
-        options: registry_1.ALL_TARGETS.map((t) => {
-            const det = detected.find(({ target }) => target.id === t.id).detection;
-            const flag = det.installed ? '(detected)' : '(not found)';
-            const globalOnly = !t.supportsLocation('local') ? ' — global only' : '';
-            return {
-                value: t.id,
-                label: `${t.displayName} ${flag}${globalOnly}`,
-            };
-        }),
-        initialValues: initial,
-        required: false,
-    });
-    if (clack.isCancel(choice)) {
-        clack.cancel('Installation cancelled.');
-        process.exit(0);
-    }
-    return choice
-        .map((id) => (0, registry_1.getTarget)(id))
-        .filter((t) => t !== undefined);
-}
-/**
- * When the live file watcher will be disabled for this project (e.g. WSL2
- * /mnt drives, or CGRAPHX_NO_WATCH), the index would silently go stale.
- * Explain that, and offer to keep it fresh automatically via git hooks
- * (commit / pull / checkout) instead of manual `cgraphx sync`.
- *
- * No-op on environments where the watcher runs normally, so it's safe to
- * call unconditionally after init.
- */
-async function offerWatchFallback(clack, projectPath, opts = {}) {
-    const reason = (0, watch_policy_1.watchDisabledReason)(projectPath);
-    if (!reason)
-        return; // Watcher runs normally — nothing to set up.
-    clack.log.warn(`实时文件监听已禁用 —— ${reason}。`);
-    clack.log.info('在重新同步之前,cgraphx 索引将保持冻结 —— 不会自动感知文件修改。');
-    // No git repo → the commit-hook path doesn't apply; point at manual sync.
-    if (!(0, git_hooks_1.isGitRepo)(projectPath)) {
-        clack.log.info('Run `cgraphx sync` after changing files to refresh the index.');
-        return;
-    }
-    // Already wired up on a previous run — confirm and move on without nagging.
-    if ((0, git_hooks_1.isSyncHookInstalled)(projectPath)) {
-        clack.log.info('Git 同步 hook 已安装 —— 索引会在 commit / pull / checkout 后自动刷新。');
-        return;
-    }
-    let choice;
-    if (opts.yes) {
-        choice = 'hook';
-    }
-    else {
-        const sel = await clack.select({
-            message: 'cgraphx 如何保持索引最新?',
-            options: [
-                { value: 'hook', label: '在 git commit / pull / checkout 时同步', hint: '安装 git hooks(推荐)' },
-                { value: 'manual', label: '我自己跑 `cgraphx sync`', hint: '完全手动' },
-            ],
-            initialValue: 'hook',
-        });
-        if (clack.isCancel(sel)) {
-            clack.log.info('已跳过 —— 修改后跑 `cgraphx sync` 刷新索引。');
-            return;
-        }
-        choice = sel;
-    }
-    if (choice === 'manual') {
-        clack.log.info('Run `cgraphx sync` after changing files to refresh the index.');
-        return;
-    }
-    const result = (0, git_hooks_1.installGitSyncHook)(projectPath);
-    if (result.installed.length > 0) {
-        clack.log.success(`Installed git ${result.installed.join(', ')} hook${result.installed.length > 1 ? 's' : ''} — ` +
-            'the index refreshes in the background after each.');
-        clack.log.info('Run `cgraphx sync` anytime to refresh immediately.');
-    }
-    else {
-        clack.log.warn(`Could not install git hooks${result.skipped ? ` (${result.skipped})` : ''}. ` +
-            'Run `cgraphx sync` after changes instead.');
-    }
-}
-//# sourceMappingURL=index.js.map