ga-plugins-cli 0.1.0

package/dist/config-patcher.d.ts

@@ -0,0 +1,53 @@
+import { ClaudeConfig, PluginConfig } from './types.js';
+/**
+ * Returns the absolute path to ~/.claude.json (or %USERPROFILE%\.claude.json on Windows).
+ *
+ * Claude Code reads its global config from this file on all platforms.
+ */
+export declare function getClaudeConfigPath(): string;
+/**
+ * Returns the absolute path to the plugins directory (~/.claude/plugins/).
+ *
+ * On Windows this resolves to %USERPROFILE%\.claude\plugins\.
+ */
+export declare function getPluginsDir(): string;
+/**
+ * Reads and parses ~/.claude.json.
+ *
+ * Returns an empty object `{}` if the file does not exist or is empty.
+ * Throws if the file exists but contains invalid JSON.
+ */
+export declare function readClaudeConfig(): ClaudeConfig;
+/**
+ * Atomically writes `config` to ~/.claude.json.
+ *
+ * Strategy:
+ *   1. Back up the existing file to .claude.json.bak-<timestamp> (if it exists)
+ *   2. Write the new content to .claude.json.tmp-<timestamp>
+ *   3. Rename (atomic on POSIX; best-effort on Windows) to .claude.json
+ *
+ * This ensures a partially-written file never leaves Claude in a broken state.
+ */
+export declare function writeClaudeConfig(config: ClaudeConfig): void;
+/**
+ * Adds a plugin entry to the config's `plugins` array.
+ *
+ * Idempotent: if an entry with the same `id` already exists, it is replaced
+ * with the new entry (path update). No duplicate entries are created.
+ *
+ * Returns the modified config (does NOT write to disk — caller must call writeClaudeConfig).
+ */
+export declare function addPluginEntry(config: ClaudeConfig, entry: PluginConfig): ClaudeConfig;
+/**
+ * Removes a plugin entry from the config's `plugins` array by ID.
+ *
+ * Safe to call even if the entry does not exist — returns config unchanged.
+ *
+ * Returns the modified config (does NOT write to disk — caller must call writeClaudeConfig).
+ */
+export declare function removePluginEntry(config: ClaudeConfig, pluginId: string): ClaudeConfig;
+/**
+ * Returns the path to the versions tracking file inside the plugins directory.
+ */
+export declare function getVersionsFilePath(): string;
+//# sourceMappingURL=config-patcher.d.ts.map

package/dist/config-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-patcher.d.ts","sourceRoot":"","sources":["../src/config-patcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIxD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAiB/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CA0B5D;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAYtF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAOtF;AAID;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/config-patcher.js

@@ -0,0 +1,133 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClaudeConfigPath = getClaudeConfigPath;
+exports.getPluginsDir = getPluginsDir;
+exports.readClaudeConfig = readClaudeConfig;
+exports.writeClaudeConfig = writeClaudeConfig;
+exports.addPluginEntry = addPluginEntry;
+exports.removePluginEntry = removePluginEntry;
+exports.getVersionsFilePath = getVersionsFilePath;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+// ─── Path resolution (cross-platform) ─────────────────────────────────────────
+/**
+ * Returns the absolute path to ~/.claude.json (or %USERPROFILE%\.claude.json on Windows).
+ *
+ * Claude Code reads its global config from this file on all platforms.
+ */
+function getClaudeConfigPath() {
+    return path_1.default.join(os_1.default.homedir(), '.claude.json');
+}
+/**
+ * Returns the absolute path to the plugins directory (~/.claude/plugins/).
+ *
+ * On Windows this resolves to %USERPROFILE%\.claude\plugins\.
+ */
+function getPluginsDir() {
+    return path_1.default.join(os_1.default.homedir(), '.claude', 'plugins');
+}
+// ─── Config I/O ───────────────────────────────────────────────────────────────
+/**
+ * Reads and parses ~/.claude.json.
+ *
+ * Returns an empty object `{}` if the file does not exist or is empty.
+ * Throws if the file exists but contains invalid JSON.
+ */
+function readClaudeConfig() {
+    const configPath = getClaudeConfigPath();
+    if (!fs_extra_1.default.existsSync(configPath)) {
+        return {};
+    }
+    const raw = fs_extra_1.default.readFileSync(configPath, 'utf-8').trim();
+    if (!raw) {
+        return {};
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${configPath}: ${err.message}`);
+    }
+}
+/**
+ * Atomically writes `config` to ~/.claude.json.
+ *
+ * Strategy:
+ *   1. Back up the existing file to .claude.json.bak-<timestamp> (if it exists)
+ *   2. Write the new content to .claude.json.tmp-<timestamp>
+ *   3. Rename (atomic on POSIX; best-effort on Windows) to .claude.json
+ *
+ * This ensures a partially-written file never leaves Claude in a broken state.
+ */
+function writeClaudeConfig(config) {
+    const configPath = getClaudeConfigPath();
+    const timestamp = Date.now();
+    // Step 1 — back up existing file
+    if (fs_extra_1.default.existsSync(configPath)) {
+        const backupPath = `${configPath}.bak-${timestamp}`;
+        fs_extra_1.default.copyFileSync(configPath, backupPath);
+    }
+    // Step 2 — write to temp file
+    const tmpPath = `${configPath}.tmp-${timestamp}`;
+    const content = JSON.stringify(config, null, 2) + '\n';
+    fs_extra_1.default.writeFileSync(tmpPath, content, 'utf-8');
+    // Step 3 — atomic rename
+    // On Windows, rename over an existing file may fail; remove first if needed.
+    try {
+        fs_extra_1.default.renameSync(tmpPath, configPath);
+    }
+    catch (err) {
+        // Fallback for Windows: remove target then rename
+        if (fs_extra_1.default.existsSync(configPath)) {
+            fs_extra_1.default.unlinkSync(configPath);
+        }
+        fs_extra_1.default.renameSync(tmpPath, configPath);
+    }
+}
+// ─── Plugin entry management ──────────────────────────────────────────────────
+/**
+ * Adds a plugin entry to the config's `plugins` array.
+ *
+ * Idempotent: if an entry with the same `id` already exists, it is replaced
+ * with the new entry (path update). No duplicate entries are created.
+ *
+ * Returns the modified config (does NOT write to disk — caller must call writeClaudeConfig).
+ */
+function addPluginEntry(config, entry) {
+    const plugins = Array.isArray(config.plugins) ? [...config.plugins] : [];
+    const existingIndex = plugins.findIndex((p) => p.id === entry.id);
+    if (existingIndex >= 0) {
+        // Replace existing entry (e.g. path update on reinstall)
+        plugins[existingIndex] = entry;
+    }
+    else {
+        plugins.push(entry);
+    }
+    return { ...config, plugins };
+}
+/**
+ * Removes a plugin entry from the config's `plugins` array by ID.
+ *
+ * Safe to call even if the entry does not exist — returns config unchanged.
+ *
+ * Returns the modified config (does NOT write to disk — caller must call writeClaudeConfig).
+ */
+function removePluginEntry(config, pluginId) {
+    if (!Array.isArray(config.plugins)) {
+        return config;
+    }
+    const plugins = config.plugins.filter((p) => p.id !== pluginId);
+    return { ...config, plugins };
+}
+// ─── Versions file helpers ────────────────────────────────────────────────────
+/**
+ * Returns the path to the versions tracking file inside the plugins directory.
+ */
+function getVersionsFilePath() {
+    return path_1.default.join(getPluginsDir(), '.ga-versions.json');
+}
+//# sourceMappingURL=config-patcher.js.map

package/dist/config-patcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-patcher.js","sourceRoot":"","sources":["../src/config-patcher.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const registry_js_1 = require("./registry.js");
+const installer_js_1 = require("./installer.js");
+const uninstaller_js_1 = require("./uninstaller.js");
+const updater_js_1 = require("./updater.js");
+const config_patcher_js_1 = require("./config-patcher.js");
+// ─── Package metadata ─────────────────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const pkg = require('../package.json');
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Reads the installed versions record, returning defaults if missing.
+ */
+function readInstalledVersions() {
+    const versionsPath = (0, config_patcher_js_1.getVersionsFilePath)();
+    if (!fs_extra_1.default.existsSync(versionsPath)) {
+        return { version: pkg.version, installedAt: new Date().toISOString(), plugins: {} };
+    }
+    try {
+        return fs_extra_1.default.readJSONSync(versionsPath);
+    }
+    catch {
+        return { version: pkg.version, installedAt: new Date().toISOString(), plugins: {} };
+    }
+}
+/**
+ * Returns true if a plugin folder exists in the plugins directory.
+ */
+function isPluginInstalled(pluginId) {
+    return fs_extra_1.default.existsSync(path_1.default.join((0, config_patcher_js_1.getPluginsDir)(), pluginId));
+}
+/**
+ * Validates an array of plugin IDs against the registry.
+ * Prints an error and exits with code 1 if any are unknown.
+ */
+function requireValidPluginIds(ids) {
+    const unknown = ids.filter((id) => !(0, registry_js_1.validatePluginId)(id));
+    if (unknown.length > 0) {
+        console.error(chalk_1.default.red(`Unknown plugin(s): ${unknown.map((id) => `"${id}"`).join(', ')}\n` +
+            `Run ${chalk_1.default.bold('ga-plugins-cli list')} to see available plugins.`));
+        process.exit(1);
+    }
+}
+/**
+ * Wraps an async command handler with error handling + process.exit(1) on failure.
+ */
+function wrapAsync(fn) {
+    return (...args) => {
+        fn(...args).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk_1.default.red(`\nError: ${message}`));
+            process.exit(1);
+        });
+    };
+}
+// ─── CLI definition ───────────────────────────────────────────────────────────
+const program = new commander_1.Command();
+program
+    .name('ga-plugins-cli')
+    .version(pkg.version, '-v, --version', 'Print version and exit')
+    .description(pkg.description)
+    .addHelpText('after', `\nAvailable plugins:\n${registry_js_1.PLUGINS.map((p) => `  ${chalk_1.default.cyan(p.id.padEnd(20))} ${p.description}`).join('\n')}`);
+// ─── install ──────────────────────────────────────────────────────────────────
+program
+    .command('install [plugin...]')
+    .description('Install one or more GA plugins to ~/.claude/plugins/. ' +
+    'If no plugin names are given, installs ALL available plugins.')
+    .option('-n, --dry-run', 'Print actions without making any changes')
+    .action(wrapAsync(async (plugins, options) => {
+    const dryRun = options.dryRun ?? false;
+    let targetIds;
+    if (plugins.length === 0) {
+        targetIds = (0, registry_js_1.getAllPluginIds)();
+        console.log(chalk_1.default.bold(`\nInstalling all ${targetIds.length} GA plugins...\n`));
+    }
+    else {
+        requireValidPluginIds(plugins);
+        targetIds = plugins;
+        console.log(chalk_1.default.bold(`\nInstalling ${targetIds.length} plugin(s): ${targetIds.join(', ')}\n`));
+    }
+    if (dryRun) {
+        console.log(chalk_1.default.yellow('Dry-run mode: no files will be written.\n'));
+    }
+    const spinner = (0, ora_1.default)({
+        text: 'Installing plugins...',
+        isSilent: dryRun, // suppress spinner output in dry-run so lines aren't interleaved
+    }).start();
+    try {
+        await (0, installer_js_1.install)(targetIds, { dryRun });
+        spinner.succeed(chalk_1.default.green(`Done. ${targetIds.length} plugin(s) installed to ~/.claude/plugins/`));
+    }
+    catch (err) {
+        spinner.fail(chalk_1.default.red('Installation failed'));
+        throw err;
+    }
+}));
+// ─── uninstall ────────────────────────────────────────────────────────────────
+program
+    .command('uninstall [plugin...]')
+    .description('Uninstall one or more GA plugins. ' +
+    'If no plugin names are given, uninstalls ALL installed plugins.')
+    .option('-n, --dry-run', 'Print actions without making any changes')
+    .option('-y, --yes', 'Skip confirmation prompt when uninstalling all')
+    .action(wrapAsync(async (plugins, options) => {
+    const dryRun = options.dryRun ?? false;
+    const skipConfirm = options.yes ?? false;
+    if (dryRun) {
+        console.log(chalk_1.default.yellow('\nDry-run mode: no files will be removed.\n'));
+    }
+    if (plugins.length === 0) {
+        // Uninstall all
+        const spinner = (0, ora_1.default)({ text: 'Removing all GA plugins...', isSilent: dryRun }).start();
+        try {
+            await (0, uninstaller_js_1.uninstallAll)({ dryRun, skipConfirm });
+            spinner.succeed(chalk_1.default.green('All GA plugins uninstalled.'));
+        }
+        catch (err) {
+            spinner.fail(chalk_1.default.red('Uninstall failed'));
+            throw err;
+        }
+    }
+    else {
+        requireValidPluginIds(plugins);
+        console.log(chalk_1.default.bold(`\nUninstalling ${plugins.length} plugin(s): ${plugins.join(', ')}\n`));
+        const spinner = (0, ora_1.default)({ text: 'Removing plugins...', isSilent: dryRun }).start();
+        try {
+            await (0, uninstaller_js_1.uninstall)(plugins, { dryRun });
+            spinner.succeed(chalk_1.default.green(`${plugins.length} plugin(s) uninstalled.`));
+        }
+        catch (err) {
+            spinner.fail(chalk_1.default.red('Uninstall failed'));
+            throw err;
+        }
+    }
+}));
+// ─── list ─────────────────────────────────────────────────────────────────────
+program
+    .command('list')
+    .description('Show all available plugins with installed/not-installed status and version')
+    .action(wrapAsync(async () => {
+    const versions = readInstalledVersions();
+    console.log(chalk_1.default.bold(`\nGA Migration Claude Code Plugins (package v${pkg.version})\n`));
+    console.log(chalk_1.default.dim(`${'ID'.padEnd(22)} ${'STATUS'.padEnd(15)} ${'VERSION'.padEnd(12)} DESCRIPTION`));
+    console.log(chalk_1.default.dim('─'.repeat(100)));
+    for (const plugin of registry_js_1.PLUGINS) {
+        const installed = isPluginInstalled(plugin.id);
+        const versionRecord = versions.plugins[plugin.id];
+        const statusStr = installed
+            ? chalk_1.default.green('installed'.padEnd(15))
+            : chalk_1.default.dim('not installed'.padEnd(15));
+        const versionStr = versionRecord
+            ? chalk_1.default.cyan(versionRecord.version.padEnd(12))
+            : chalk_1.default.dim('—'.padEnd(12));
+        const idStr = installed
+            ? chalk_1.default.bold(plugin.id.padEnd(22))
+            : chalk_1.default.dim(plugin.id.padEnd(22));
+        console.log(`${idStr} ${statusStr} ${versionStr} ${plugin.description}`);
+    }
+    const installedCount = registry_js_1.PLUGINS.filter((p) => isPluginInstalled(p.id)).length;
+    console.log(chalk_1.default.dim(`\n${installedCount} of ${registry_js_1.PLUGINS.length} plugins installed.` +
+        `  Install path: ${(0, config_patcher_js_1.getPluginsDir)()}\n`));
+}));
+// ─── update ───────────────────────────────────────────────────────────────────
+program
+    .command('update [plugin...]')
+    .description('Update installed GA plugins to the versions bundled in the current package. ' +
+    'If no plugin names are given, updates ALL installed plugins.')
+    .option('-n, --dry-run', 'Print actions without making any changes')
+    .action(wrapAsync(async (plugins, options) => {
+    const dryRun = options.dryRun ?? false;
+    if (dryRun) {
+        console.log(chalk_1.default.yellow('\nDry-run mode: no files will be written.\n'));
+    }
+    if (plugins.length > 0) {
+        requireValidPluginIds(plugins);
+    }
+    // Show update check summary first
+    const { current, available } = await (0, updater_js_1.checkUpdates)();
+    const outdated = Object.entries(current).filter(([id, ver]) => ver !== 'not installed' &&
+        ver !== available &&
+        (plugins.length === 0 || plugins.includes(id)));
+    const alreadyUpToDate = Object.entries(current).filter(([id, ver]) => ver !== 'not installed' &&
+        ver === available &&
+        (plugins.length === 0 || plugins.includes(id)));
+    if (alreadyUpToDate.length > 0) {
+        console.log(chalk_1.default.dim(`\nAlready up to date (v${available}):`));
+        for (const [id] of alreadyUpToDate) {
+            console.log(chalk_1.default.dim(`  ✓ ${id}`));
+        }
+    }
+    if (outdated.length === 0 && plugins.length === 0) {
+        console.log(chalk_1.default.green(`\nAll installed plugins are already at v${available}.`));
+        return;
+    }
+    const spinner = (0, ora_1.default)({ text: 'Updating plugins...', isSilent: dryRun }).start();
+    try {
+        await (0, updater_js_1.update)(plugins, { dryRun });
+        spinner.succeed(chalk_1.default.green('Update complete.'));
+    }
+    catch (err) {
+        spinner.fail(chalk_1.default.red('Update failed'));
+        throw err;
+    }
+}));
+// ─── Entry ────────────────────────────────────────────────────────────────────
+program.parseAsync(process.argv).catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(chalk_1.default.red(`Fatal: ${message}`));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/installer.d.ts

@@ -0,0 +1,24 @@
+export interface InstallOptions {
+    /** When true, prints what would happen without actually doing it. */
+    dryRun?: boolean;
+}
+/**
+ * Installs the given plugin IDs to ~/.claude/plugins/ and registers them in ~/.claude.json.
+ *
+ * Each plugin:
+ *   1. Gets its bundled source path resolved from the npm package
+ *   2. Is copied to ~/.claude/plugins/<pluginId>/  (overwrites any existing version)
+ *   3. Gets an entry added/updated in ~/.claude.json under the `plugins` array
+ *   4. Gets its version recorded in ~/.claude/plugins/.ga-versions.json
+ *
+ * All actions are printed to stdout. In dry-run mode, no files are written.
+ *
+ * @throws if a bundled plugin source directory cannot be found
+ */
+export declare function install(pluginIds: string[], options?: InstallOptions): Promise<void>;
+/**
+ * Installs ALL known GA plugins.
+ * Convenience wrapper around `install(getAllPluginIds(), options)`.
+ */
+export declare function installAll(options?: InstallOptions): Promise<void>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2CD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E"}

package/dist/installer.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.install = install;
+exports.installAll = installAll;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_patcher_js_1 = require("./config-patcher.js");
+const registry_js_1 = require("./registry.js");
+// ─── Versions file helpers ────────────────────────────────────────────────────
+/** Reads the versions tracking file, returning defaults if missing. */
+function readVersions() {
+    const versionsPath = (0, config_patcher_js_1.getVersionsFilePath)();
+    if (!fs_extra_1.default.existsSync(versionsPath)) {
+        return {
+            version: require('../package.json').version,
+            installedAt: new Date().toISOString(),
+            plugins: {},
+        };
+    }
+    try {
+        return fs_extra_1.default.readJSONSync(versionsPath);
+    }
+    catch {
+        return {
+            version: require('../package.json').version,
+            installedAt: new Date().toISOString(),
+            plugins: {},
+        };
+    }
+}
+/** Writes the versions tracking file to disk. */
+function writeVersions(versions, dryRun) {
+    const versionsPath = (0, config_patcher_js_1.getVersionsFilePath)();
+    if (dryRun) {
+        console.log(chalk_1.default.dim(`  [DRY RUN] Would write versions to ${versionsPath}`));
+        return;
+    }
+    fs_extra_1.default.outputJSONSync(versionsPath, versions, { spaces: 2 });
+}
+// ─── Prefix helper ────────────────────────────────────────────────────────────
+function prefix(dryRun) {
+    return dryRun ? chalk_1.default.yellow('[DRY RUN] ') : '';
+}
+// ─── Core install logic ───────────────────────────────────────────────────────
+/**
+ * Installs the given plugin IDs to ~/.claude/plugins/ and registers them in ~/.claude.json.
+ *
+ * Each plugin:
+ *   1. Gets its bundled source path resolved from the npm package
+ *   2. Is copied to ~/.claude/plugins/<pluginId>/  (overwrites any existing version)
+ *   3. Gets an entry added/updated in ~/.claude.json under the `plugins` array
+ *   4. Gets its version recorded in ~/.claude/plugins/.ga-versions.json
+ *
+ * All actions are printed to stdout. In dry-run mode, no files are written.
+ *
+ * @throws if a bundled plugin source directory cannot be found
+ */
+async function install(pluginIds, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const pluginsDir = (0, config_patcher_js_1.getPluginsDir)();
+    const pkgVersion = require('../package.json').version ?? '0.1.0';
+    const now = new Date().toISOString();
+    // Ensure ~/.claude/plugins/ exists
+    if (!dryRun) {
+        fs_extra_1.default.ensureDirSync(pluginsDir);
+    }
+    else {
+        console.log(chalk_1.default.dim(`  [DRY RUN] Would ensure directory: ${pluginsDir}`));
+    }
+    // Load current state
+    const config = (0, config_patcher_js_1.readClaudeConfig)();
+    const versions = readVersions();
+    let updatedConfig = config;
+    for (const pluginId of pluginIds) {
+        const srcPath = (0, registry_js_1.getBundledPluginPath)(pluginId); // throws if unknown id
+        const destPath = path_1.default.join(pluginsDir, pluginId);
+        // ── Copy plugin folder ──────────────────────────────────────────────────
+        if (!fs_extra_1.default.existsSync(srcPath)) {
+            console.warn(chalk_1.default.yellow(`  Warning: bundled plugin source not found for "${pluginId}" at ${srcPath}. ` +
+                `Skipping copy (the entry will still be registered).`));
+        }
+        else {
+            console.log(`${prefix(dryRun)}${chalk_1.default.cyan('copy')}  ${chalk_1.default.dim(srcPath)}\n` +
+                `       ${chalk_1.default.dim('→')} ${destPath}`);
+            if (!dryRun) {
+                fs_extra_1.default.copySync(srcPath, destPath, { overwrite: true });
+            }
+        }
+        // ── Register in ~/.claude.json ──────────────────────────────────────────
+        console.log(`${prefix(dryRun)}${chalk_1.default.cyan('register')} ${pluginId} in ${chalk_1.default.dim('~/.claude.json')}`);
+        if (!dryRun) {
+            updatedConfig = (0, config_patcher_js_1.addPluginEntry)(updatedConfig, { id: pluginId, path: destPath });
+        }
+        // ── Update versions record ──────────────────────────────────────────────
+        versions.plugins[pluginId] = { version: pkgVersion, installedAt: now };
+        console.log(chalk_1.default.green(`  ✓ ${pluginId} installed (v${pkgVersion})`));
+    }
+    // Write updated config and versions atomically (once, after all plugins)
+    if (!dryRun) {
+        (0, config_patcher_js_1.writeClaudeConfig)(updatedConfig);
+        versions.version = pkgVersion;
+        versions.installedAt = now;
+    }
+    writeVersions(versions, dryRun);
+}
+/**
+ * Installs ALL known GA plugins.
+ * Convenience wrapper around `install(getAllPluginIds(), options)`.
+ */
+async function installAll(options = {}) {
+    return install((0, registry_js_1.getAllPluginIds)(), options);
+}
+//# sourceMappingURL=installer.js.map

package/dist/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}

package/dist/registry.d.ts

@@ -0,0 +1,28 @@
+import { PluginEntry } from './types.js';
+/**
+ * Canonical list of all GA Migration plugins shipped in this package.
+ * The `path` field is relative to the `plugins/` directory bundled with the npm package.
+ */
+export declare const PLUGINS: PluginEntry[];
+/**
+ * Returns the absolute path to a bundled plugin folder inside the installed npm package.
+ *
+ * At runtime `__dirname` points to `<package-root>/dist/` (compiled output).
+ * The bundled plugins live at `<package-root>/plugins/<pluginId>/`.
+ *
+ * @throws {Error} if pluginId is not in the registry
+ */
+export declare function getBundledPluginPath(pluginId: string): string;
+/**
+ * Returns true if `id` is a known plugin ID.
+ */
+export declare function validatePluginId(id: string): boolean;
+/**
+ * Returns the list of all known plugin IDs.
+ */
+export declare function getAllPluginIds(): string[];
+/**
+ * Returns a PluginEntry by ID, or undefined if not found.
+ */
+export declare function getPluginById(id: string): PluginEntry | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,WAAW,EAyChC,CAAC;AAOF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjE"}

package/dist/registry.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLUGINS = void 0;
+exports.getBundledPluginPath = getBundledPluginPath;
+exports.validatePluginId = validatePluginId;
+exports.getAllPluginIds = getAllPluginIds;
+exports.getPluginById = getPluginById;
+const path_1 = __importDefault(require("path"));
+/**
+ * Canonical list of all GA Migration plugins shipped in this package.
+ * The `path` field is relative to the `plugins/` directory bundled with the npm package.
+ */
+exports.PLUGINS = [
+    {
+        id: 'go-standards',
+        name: 'Go Standards',
+        description: 'Enforces Garuda Airlines Go coding standards: naming conventions, error handling, ' +
+            'context propagation, and module structure for the Java→Go migration.',
+        path: 'go-standards',
+    },
+    {
+        id: 'go-scaffolder',
+        name: 'Go Scaffolder',
+        description: 'Scaffolds new Go packages, services, and handlers following the go-ga-lib ' +
+            'project layout conventions (github.com/zokypesch/go-ga-lib).',
+        path: 'go-scaffolder',
+    },
+    {
+        id: 'java2go-porter',
+        name: 'Java→Go Porter',
+        description: 'Translates Java source files to idiomatic Go, eliminating Java anti-patterns ' +
+            '(getters/setters, Exception hierarchies, Abstract* types) during migration.',
+        path: 'java2go-porter',
+    },
+    {
+        id: 'migration-safety',
+        name: 'Migration Safety',
+        description: 'Pre-merge safety checks for the Java→Go migration: API compatibility, ' +
+            'data model drift, SQL schema consistency, and rollback readiness assessment.',
+        path: 'migration-safety',
+    },
+    {
+        id: 'go-reviewer',
+        name: 'Go Reviewer',
+        description: 'Incremental Go code review (new findings only, diff-based) + auto-fix in isolated ' +
+            'git worktree. Integrates external linters (golangci-lint, gopls, semgrep) via MCP shim.',
+        path: 'go-reviewer',
+    },
+];
+/**
+ * Returns the set of known plugin IDs for fast membership checks.
+ */
+const KNOWN_IDS = new Set(exports.PLUGINS.map((p) => p.id));
+/**
+ * Returns the absolute path to a bundled plugin folder inside the installed npm package.
+ *
+ * At runtime `__dirname` points to `<package-root>/dist/` (compiled output).
+ * The bundled plugins live at `<package-root>/plugins/<pluginId>/`.
+ *
+ * @throws {Error} if pluginId is not in the registry
+ */
+function getBundledPluginPath(pluginId) {
+    if (!validatePluginId(pluginId)) {
+        throw new Error(`Unknown plugin ID: "${pluginId}". Run "ga-plugins-cli list" to see available plugins.`);
+    }
+    const entry = exports.PLUGINS.find((p) => p.id === pluginId);
+    // __dirname = .../dist  →  go up one level to package root, then into plugins/
+    return path_1.default.resolve(__dirname, '..', 'plugins', entry.path);
+}
+/**
+ * Returns true if `id` is a known plugin ID.
+ */
+function validatePluginId(id) {
+    return KNOWN_IDS.has(id);
+}
+/**
+ * Returns the list of all known plugin IDs.
+ */
+function getAllPluginIds() {
+    return exports.PLUGINS.map((p) => p.id);
+}
+/**
+ * Returns a PluginEntry by ID, or undefined if not found.
+ */
+function getPluginById(id) {
+    return exports.PLUGINS.find((p) => p.id === id);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":";;;;;;AA+DA,oDAOC;AAKD,4CAEC;AAKD,0CAEC;AAKD,sCAEC;AA3FD,gDAAwB;AAGxB;;;GAGG;AACU,QAAA,OAAO,GAAkB;IACpC;QACE,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,oFAAoF;YACpF,sEAAsE;QACxE,IAAI,EAAE,cAAc;KACrB;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,4EAA4E;YAC5E,8DAA8D;QAChE,IAAI,EAAE,eAAe;KACtB;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,+EAA+E;YAC/E,6EAA6E;QAC/E,IAAI,EAAE,gBAAgB;KACvB;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,wEAAwE;YACxE,8EAA8E;QAChF,IAAI,EAAE,kBAAkB;KACzB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,oFAAoF;YACpF,yFAAyF;QAC3F,IAAI,EAAE,aAAa;KACpB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,eAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEpD;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,wDAAwD,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,KAAK,GAAG,eAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAE,CAAC;IACtD,+EAA+E;IAC/E,OAAO,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,EAAU;IACzC,OAAO,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,eAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,EAAU;IACtC,OAAO,eAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+export interface PluginManifest {
+    name: string;
+    version: string;
+    description: string;
+    plugins: PluginEntry[];
+}
+export interface PluginEntry {
+    id: string;
+    name: string;
+    description: string;
+    path: string;
+}
+export interface InstalledVersions {
+    version: string;
+    installedAt: string;
+    plugins: Record<string, {
+        version: string;
+        installedAt: string;
+    }>;
+}
+export interface ClaudeConfig {
+    plugins?: PluginConfig[];
+    [key: string]: unknown;
+}
+export interface PluginConfig {
+    id: string;
+    path: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/uninstaller.d.ts

@@ -0,0 +1,32 @@
+export interface UninstallOptions {
+    /** When true, prints what would happen without actually doing it. */
+    dryRun?: boolean;
+}
+export interface UninstallAllOptions extends UninstallOptions {
+    /** When true, skips the interactive confirmation prompt. */
+    skipConfirm?: boolean;
+}
+/**
+ * Uninstalls the given plugin IDs from ~/.claude/plugins/ and removes them from ~/.claude.json.
+ *
+ * For each plugin:
+ *   - If the plugin folder exists: removes it
+ *   - If the folder is missing but an entry exists in ~/.claude.json: cleans up the stale entry
+ *     and prints a warning
+ *   - Removes the entry from .ga-versions.json
+ *
+ * In dry-run mode, no files are removed.
+ */
+export declare function uninstall(pluginIds: string[], options?: UninstallOptions): Promise<void>;
+/**
+ * Uninstalls ALL installed GA plugins.
+ *
+ * Discovers installed plugins by:
+ *   1. Checking which known plugin IDs have a folder in ~/.claude/plugins/
+ *   2. Checking which known plugin IDs have an entry in ~/.claude.json
+ * The union of both sets is uninstalled.
+ *
+ * When `skipConfirm` is false (default), prompts for interactive confirmation.
+ */
+export declare function uninstallAll(options?: UninstallAllOptions): Promise<void>;
+//# sourceMappingURL=uninstaller.d.ts.map

package/dist/uninstaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstaller.d.ts","sourceRoot":"","sources":["../src/uninstaller.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAoED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDnF"}

package/dist/uninstaller.js

@@ -0,0 +1,175 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uninstall = uninstall;
+exports.uninstallAll = uninstallAll;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const readline_1 = __importDefault(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_patcher_js_1 = require("./config-patcher.js");
+const registry_js_1 = require("./registry.js");
+// ─── Versions file helpers ────────────────────────────────────────────────────
+function readVersions() {
+    const versionsPath = (0, config_patcher_js_1.getVersionsFilePath)();
+    if (!fs_extra_1.default.existsSync(versionsPath)) {
+        return {
+            version: require('../package.json').version,
+            installedAt: new Date().toISOString(),
+            plugins: {},
+        };
+    }
+    try {
+        return fs_extra_1.default.readJSONSync(versionsPath);
+    }
+    catch {
+        return {
+            version: require('../package.json').version,
+            installedAt: new Date().toISOString(),
+            plugins: {},
+        };
+    }
+}
+function writeVersions(versions, dryRun) {
+    const versionsPath = (0, config_patcher_js_1.getVersionsFilePath)();
+    if (dryRun) {
+        console.log(chalk_1.default.dim(`  [DRY RUN] Would write versions to ${versionsPath}`));
+        return;
+    }
+    fs_extra_1.default.outputJSONSync(versionsPath, versions, { spaces: 2 });
+}
+// ─── Prefix helper ────────────────────────────────────────────────────────────
+function prefix(dryRun) {
+    return dryRun ? chalk_1.default.yellow('[DRY RUN] ') : '';
+}
+// ─── Confirmation prompt ──────────────────────────────────────────────────────
+/**
+ * Prompts the user for confirmation on stdin.
+ * Returns true if user typed "yes" (case-insensitive).
+ */
+function promptConfirm(message) {
+    return new Promise((resolve) => {
+        const rl = readline_1.default.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: false,
+        });
+        process.stdout.write(message);
+        rl.once('line', (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'yes');
+        });
+        rl.once('close', () => {
+            resolve(false);
+        });
+    });
+}
+// ─── Core uninstall logic ─────────────────────────────────────────────────────
+/**
+ * Uninstalls the given plugin IDs from ~/.claude/plugins/ and removes them from ~/.claude.json.
+ *
+ * For each plugin:
+ *   - If the plugin folder exists: removes it
+ *   - If the folder is missing but an entry exists in ~/.claude.json: cleans up the stale entry
+ *     and prints a warning
+ *   - Removes the entry from .ga-versions.json
+ *
+ * In dry-run mode, no files are removed.
+ */
+async function uninstall(pluginIds, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const pluginsDir = (0, config_patcher_js_1.getPluginsDir)();
+    const config = (0, config_patcher_js_1.readClaudeConfig)();
+    const versions = readVersions();
+    let updatedConfig = config;
+    for (const pluginId of pluginIds) {
+        const destPath = path_1.default.join(pluginsDir, pluginId);
+        const folderExists = fs_extra_1.default.existsSync(destPath);
+        if (!folderExists) {
+            // Check if a stale config entry exists
+            const hasEntry = Array.isArray(updatedConfig.plugins) &&
+                updatedConfig.plugins.some((p) => p.id === pluginId);
+            if (hasEntry) {
+                console.warn(chalk_1.default.yellow(`  Warning: plugin folder not found for "${pluginId}" at ${destPath} ` +
+                    `but a config entry exists — cleaning up stale entry.`));
+            }
+            else {
+                console.log(chalk_1.default.dim(`  ${pluginId}: not installed (nothing to remove)`));
+                continue;
+            }
+        }
+        else {
+            // ── Remove plugin folder ──────────────────────────────────────────────
+            console.log(`${prefix(dryRun)}${chalk_1.default.red('remove')} ${destPath}`);
+            if (!dryRun) {
+                fs_extra_1.default.removeSync(destPath);
+            }
+        }
+        // ── Remove from ~/.claude.json ────────────────────────────────────────
+        console.log(`${prefix(dryRun)}${chalk_1.default.red('deregister')} ${pluginId} from ${chalk_1.default.dim('~/.claude.json')}`);
+        if (!dryRun) {
+            updatedConfig = (0, config_patcher_js_1.removePluginEntry)(updatedConfig, pluginId);
+        }
+        // ── Remove from versions record ───────────────────────────────────────
+        delete versions.plugins[pluginId];
+        console.log(chalk_1.default.green(`  ✓ ${pluginId} uninstalled`));
+    }
+    // Write updated config and versions once, after all plugins
+    if (!dryRun) {
+        (0, config_patcher_js_1.writeClaudeConfig)(updatedConfig);
+    }
+    writeVersions(versions, dryRun);
+}
+/**
+ * Uninstalls ALL installed GA plugins.
+ *
+ * Discovers installed plugins by:
+ *   1. Checking which known plugin IDs have a folder in ~/.claude/plugins/
+ *   2. Checking which known plugin IDs have an entry in ~/.claude.json
+ * The union of both sets is uninstalled.
+ *
+ * When `skipConfirm` is false (default), prompts for interactive confirmation.
+ */
+async function uninstallAll(options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const skipConfirm = options.skipConfirm ?? false;
+    // Discover what is actually installed
+    const pluginsDir = (0, config_patcher_js_1.getPluginsDir)();
+    const config = (0, config_patcher_js_1.readClaudeConfig)();
+    const allKnownIds = (0, registry_js_1.getAllPluginIds)();
+    const installedIds = new Set();
+    // Check filesystem
+    for (const id of allKnownIds) {
+        if (fs_extra_1.default.existsSync(path_1.default.join(pluginsDir, id))) {
+            installedIds.add(id);
+        }
+    }
+    // Check config entries (catches stale entries without folders)
+    if (Array.isArray(config.plugins)) {
+        for (const entry of config.plugins) {
+            if ((0, registry_js_1.validatePluginId)(entry.id)) {
+                installedIds.add(entry.id);
+            }
+        }
+    }
+    if (installedIds.size === 0) {
+        console.log(chalk_1.default.dim('No GA plugins are currently installed.'));
+        return;
+    }
+    const idList = [...installedIds];
+    if (!skipConfirm && !dryRun) {
+        console.log(chalk_1.default.yellow(`\nAbout to remove ALL GA plugins (${idList.length}):`));
+        for (const id of idList) {
+            console.log(chalk_1.default.dim(`  - ${id}`));
+        }
+        const confirmed = await promptConfirm(chalk_1.default.yellow("\nType 'yes' to confirm: "));
+        if (!confirmed) {
+            console.log(chalk_1.default.dim('Aborted. No plugins were removed.'));
+            return;
+        }
+    }
+    await uninstall(idList, { dryRun });
+}
+//# sourceMappingURL=uninstaller.js.map

package/dist/uninstaller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstaller.js","sourceRoot":"","sources":["../src/uninstaller.ts"],"names":[],"mappings":"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"}

package/dist/updater.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Compares the versions in .ga-versions.json against the current npm package version.
+ *
+ * Returns:
+ *   - `current`: map of pluginId → installed version string (or "not installed")
+ *   - `available`: the version shipped in the current npm package
+ *
+ * A plugin needs an update when its installed version differs from `available`.
+ */
+export declare function checkUpdates(): Promise<{
+    current: Record<string, string>;
+    available: string;
+}>;
+export interface UpdateOptions {
+    /** When true, prints what would happen without actually doing it. */
+    dryRun?: boolean;
+}
+/**
+ * Updates (re-installs) the given plugin IDs with the versions bundled in the current
+ * npm package. Overwrites existing plugin folders and updates .ga-versions.json.
+ *
+ * If `pluginIds` is empty, updates all currently installed plugins.
+ *
+ * Skips plugins that are not currently installed (warns instead of error).
+ * Skips unknown plugin IDs with a warning.
+ */
+export declare function update(pluginIds: string[], options?: UpdateOptions): Promise<void>;
+//# sourceMappingURL=updater.d.ts.map

package/dist/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AA+BA;;;;;;;;GAQG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAYD;AAID,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/updater.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkUpdates = checkUpdates;
+exports.update = update;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_patcher_js_1 = require("./config-patcher.js");
+const installer_js_1 = require("./installer.js");
+const registry_js_1 = require("./registry.js");
+// ─── Versions file helpers ────────────────────────────────────────────────────
+function readVersions() {
+    const versionsPath = (0, config_patcher_js_1.getVersionsFilePath)();
+    if (!fs_extra_1.default.existsSync(versionsPath)) {
+        return {
+            version: '0.0.0',
+            installedAt: new Date().toISOString(),
+            plugins: {},
+        };
+    }
+    try {
+        return fs_extra_1.default.readJSONSync(versionsPath);
+    }
+    catch {
+        return {
+            version: '0.0.0',
+            installedAt: new Date().toISOString(),
+            plugins: {},
+        };
+    }
+}
+// ─── Update check ─────────────────────────────────────────────────────────────
+/**
+ * Compares the versions in .ga-versions.json against the current npm package version.
+ *
+ * Returns:
+ *   - `current`: map of pluginId → installed version string (or "not installed")
+ *   - `available`: the version shipped in the current npm package
+ *
+ * A plugin needs an update when its installed version differs from `available`.
+ */
+async function checkUpdates() {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const pkgVersion = require('../package.json').version ?? '0.1.0';
+    const versions = readVersions();
+    const allIds = (0, registry_js_1.getAllPluginIds)();
+    const current = {};
+    for (const id of allIds) {
+        current[id] = versions.plugins[id]?.version ?? 'not installed';
+    }
+    return { current, available: pkgVersion };
+}
+// ─── Core update logic ────────────────────────────────────────────────────────
+/**
+ * Updates (re-installs) the given plugin IDs with the versions bundled in the current
+ * npm package. Overwrites existing plugin folders and updates .ga-versions.json.
+ *
+ * If `pluginIds` is empty, updates all currently installed plugins.
+ *
+ * Skips plugins that are not currently installed (warns instead of error).
+ * Skips unknown plugin IDs with a warning.
+ */
+async function update(pluginIds, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const pkgVersion = require('../package.json').version ?? '0.1.0';
+    const versions = readVersions();
+    // Determine which IDs to actually update
+    let targetIds;
+    if (pluginIds.length === 0) {
+        // Update all that are recorded as installed
+        targetIds = Object.keys(versions.plugins).filter((id) => (0, registry_js_1.validatePluginId)(id));
+        if (targetIds.length === 0) {
+            console.log(chalk_1.default.dim('No GA plugins are currently installed. Nothing to update.'));
+            return;
+        }
+    }
+    else {
+        // Validate and filter supplied IDs
+        targetIds = [];
+        for (const id of pluginIds) {
+            if (!(0, registry_js_1.validatePluginId)(id)) {
+                console.warn(chalk_1.default.yellow(`  Warning: unknown plugin "${id}" — skipping.`));
+                continue;
+            }
+            if (!versions.plugins[id]) {
+                console.warn(chalk_1.default.yellow(`  Warning: plugin "${id}" is not installed — run "ga-plugins-cli install ${id}" first.`));
+                continue;
+            }
+            targetIds.push(id);
+        }
+    }
+    if (targetIds.length === 0) {
+        console.log(chalk_1.default.dim('Nothing to update.'));
+        return;
+    }
+    // Show what will change
+    console.log(chalk_1.default.bold(`\nUpdating ${targetIds.length} plugin(s) to v${pkgVersion}:\n`));
+    for (const id of targetIds) {
+        const current = versions.plugins[id]?.version ?? 'unknown';
+        const arrow = current === pkgVersion
+            ? chalk_1.default.dim(`  ${id}: v${current} → v${pkgVersion} (already up to date)`)
+            : `  ${id}: ${chalk_1.default.dim(`v${current}`)} → ${chalk_1.default.green(`v${pkgVersion}`)}`;
+        console.log(arrow);
+    }
+    console.log('');
+    // Re-install (install handles the copy + config patch + versions update)
+    await (0, installer_js_1.install)(targetIds, { dryRun });
+    console.log(chalk_1.default.green(`\nUpdate complete.`));
+}
+//# sourceMappingURL=updater.js.map

package/dist/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.js","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "ga-plugins-cli",
+  "version": "0.1.0",
+  "description": "CLI to install GA Migration Claude Code plugins globally at user level (~/.claude/plugins/)",
+  "bin": {
+    "ga-plugins-cli": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src/**/*.ts"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.1",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/fs-extra": "^11.0.4",
+    "typescript": "^5.6.0"
+  },
+  "files": [
+    "dist/",
+    "plugins/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}