cgraphx 1.1.0

package/dist/installer/index.js

@@ -0,0 +1,692 @@
+"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