@kaitranntt/ccs 8.2.0 → 8.3.0

package/dist/commands/bar/help-subcommand.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showHelp = void 0;
+const ui_1 = require("../../utils/ui");
+async function showHelp() {
+    await (0, ui_1.initUI)();
+    console.log('');
+    console.log((0, ui_1.header)('CCS Bar (macOS Menu Bar App)'));
+    console.log('');
+    console.log((0, ui_1.subheader)('Usage:'));
+    console.log(`  ${(0, ui_1.color)('ccs bar', 'command')} [command] [options]`);
+    console.log('');
+    const sections = [
+        [
+            'Commands:',
+            [
+                ['launch', 'Start the web-server, write ~/.ccs/bar.json, and open the app (default)'],
+                ['install', 'Download CCS Bar from the ccs-bar-latest GitHub release into ~/Applications'],
+                ['uninstall', 'Remove the app and version pin'],
+                ['version', 'Show CLI and installed app versions'],
+            ],
+        ],
+        [
+            'Options:',
+            [
+                ['--help, -h', 'Show this help message'],
+                ['--version', 'Show CLI and installed app versions'],
+            ],
+        ],
+        [
+            'Install options:',
+            [
+                ['--launch', 'Launch CCS Bar immediately after install without prompting'],
+                ['--no-launch', 'Skip the launch prompt after install'],
+            ],
+        ],
+        [
+            'Examples:',
+            [
+                ['ccs bar', 'Start the web-server and open CCS Bar (default launch)'],
+                ['ccs bar install', 'Download and install CCS Bar, then prompt to launch'],
+                ['ccs bar install --launch', 'Install and launch immediately (no prompt)'],
+                ['ccs bar install --no-launch', 'Install without launching'],
+                ['ccs bar version', 'Show CLI and installed app versions'],
+                ['ccs bar uninstall', 'Remove CCS Bar and its version pin'],
+            ],
+        ],
+    ];
+    for (const [title, rows] of sections) {
+        console.log((0, ui_1.subheader)(title));
+        const width = Math.max(...rows.map(([command]) => command.length));
+        for (const [command, description] of rows) {
+            console.log(`  ${(0, ui_1.color)(command.padEnd(width + 2), 'command')} ${description}`);
+        }
+        console.log('');
+    }
+    console.log((0, ui_1.dim)('  macOS only. The app communicates with the CCS web-server on localhost only.'));
+    console.log((0, ui_1.dim)('  Gatekeeper quarantine is cleared automatically after install. If the app is still blocked,'));
+    console.log((0, ui_1.dim)('  right-click > Open or run `xattr -dr com.apple.quarantine` manually.'));
+    console.log('');
+}
+exports.showHelp = showHelp;
+//# sourceMappingURL=help-subcommand.js.map

package/dist/commands/bar/help-subcommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-subcommand.js","sourceRoot":"","sources":["../../../src/commands/bar/help-subcommand.ts"],"names":[],"mappings":";;;AAAA,uCAAuE;AAEhE,KAAK,UAAU,QAAQ;IAC5B,MAAM,IAAA,WAAM,GAAE,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,IAAA,WAAM,EAAC,8BAA8B,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,IAAA,cAAS,EAAC,QAAQ,CAAC,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAA,UAAK,EAAC,SAAS,EAAE,SAAS,CAAC,sBAAsB,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,QAAQ,GAAmC;QAC/C;YACE,WAAW;YACX;gBACE,CAAC,QAAQ,EAAE,yEAAyE,CAAC;gBACrF,CAAC,SAAS,EAAE,6EAA6E,CAAC;gBAC1F,CAAC,WAAW,EAAE,gCAAgC,CAAC;gBAC/C,CAAC,SAAS,EAAE,qCAAqC,CAAC;aACnD;SACF;QACD;YACE,UAAU;YACV;gBACE,CAAC,YAAY,EAAE,wBAAwB,CAAC;gBACxC,CAAC,WAAW,EAAE,qCAAqC,CAAC;aACrD;SACF;QACD;YACE,kBAAkB;YAClB;gBACE,CAAC,UAAU,EAAE,4DAA4D,CAAC;gBAC1E,CAAC,aAAa,EAAE,sCAAsC,CAAC;aACxD;SACF;QACD;YACE,WAAW;YACX;gBACE,CAAC,SAAS,EAAE,wDAAwD,CAAC;gBACrE,CAAC,iBAAiB,EAAE,qDAAqD,CAAC;gBAC1E,CAAC,0BAA0B,EAAE,4CAA4C,CAAC;gBAC1E,CAAC,6BAA6B,EAAE,2BAA2B,CAAC;gBAC5D,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;gBAC1D,CAAC,mBAAmB,EAAE,oCAAoC,CAAC;aAC5D;SACF;KACF,CAAC;IAEF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,IAAA,cAAS,EAAC,KAAK,CAAC,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAA,UAAK,EAAC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAA,QAAG,EAAC,+EAA+E,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,CACT,IAAA,QAAG,EACD,8FAA8F,CAC/F,CACF,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAA,QAAG,EAAC,wEAAwE,CAAC,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AA/DD,4BA+DC"}

package/dist/commands/bar/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `ccs bar` command dispatcher
+ *
+ * Mirrors the pattern in src/commands/docker/index.ts.
+ * Subcommands: launch (default), install, uninstall, version / --version, help / --help / -h.
+ */
+export declare function handleBarCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/bar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/bar/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDpE"}

package/dist/commands/bar/index.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * `ccs bar` command dispatcher
+ *
+ * Mirrors the pattern in src/commands/docker/index.ts.
+ * Subcommands: launch (default), install, uninstall, version / --version, help / --help / -h.
+ */
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBarCommand = void 0;
+const arg_extractor_1 = require("../arg-extractor");
+async function handleBarCommand(args) {
+    const subcommand = args[0];
+    // --help / -h anywhere in args (e.g. `ccs bar install --help`) → show help.
+    // Mirrors docker/index.ts: hasAnyFlag(normalizedArgs, ['--help', '-h']).
+    // Also dispatch bare `help` subcommand for symmetry.
+    if ((0, arg_extractor_1.hasAnyFlag)(args, ['--help', '-h']) || subcommand === 'help') {
+        const { showHelp } = await Promise.resolve().then(() => __importStar(require('./help-subcommand')));
+        await showHelp();
+        return;
+    }
+    // --version / version are aliases for the version subcommand
+    if (subcommand === '--version' || subcommand === 'version') {
+        const { handleBarVersion } = await Promise.resolve().then(() => __importStar(require('./version-subcommand')));
+        await handleBarVersion();
+        return;
+    }
+    const commandHandlers = {
+        launch: async (subArgs) => {
+            const { handleBarLaunch } = await Promise.resolve().then(() => __importStar(require('./launch-subcommand')));
+            await handleBarLaunch(subArgs);
+        },
+        install: async (subArgs) => {
+            const { handleBarInstall } = await Promise.resolve().then(() => __importStar(require('./install-subcommand')));
+            await handleBarInstall(subArgs);
+        },
+        uninstall: async (subArgs) => {
+            const { handleBarUninstall } = await Promise.resolve().then(() => __importStar(require('./uninstall-subcommand')));
+            await handleBarUninstall(subArgs);
+        },
+    };
+    // Bare `ccs bar` → launch
+    if (!subcommand || subcommand === 'launch') {
+        await commandHandlers.launch(subcommand ? args.slice(1) : []);
+        return;
+    }
+    const handler = commandHandlers[subcommand];
+    if (!handler) {
+        console.error(`[X] Unknown bar subcommand: ${subcommand}`);
+        console.error('[i] Usage: ccs bar [launch|install|uninstall|version|--help]');
+        return;
+    }
+    await handler(args.slice(1));
+}
+exports.handleBarCommand = handleBarCommand;
+//# sourceMappingURL=index.js.map

package/dist/commands/bar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/bar/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,oDAA8C;AAEvC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3B,4EAA4E;IAC5E,yEAAyE;IACzE,qDAAqD;IACrD,IAAI,IAAA,0BAAU,EAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;QACvD,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,6DAA6D;IAC7D,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,sBAAsB,GAAC,CAAC;QAClE,MAAM,gBAAgB,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,eAAe,GAAyD;QAC5E,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,EAAE,eAAe,EAAE,GAAG,wDAAa,qBAAqB,GAAC,CAAC;YAChE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,sBAAsB,GAAC,CAAC;YAClE,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3B,MAAM,EAAE,kBAAkB,EAAE,GAAG,wDAAa,wBAAwB,GAAC,CAAC;YACtE,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;IAEF,0BAA0B;IAC1B,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO;IACT,CAAC;IAED,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAhDD,4CAgDC"}

package/dist/commands/bar/install-subcommand.d.ts

@@ -0,0 +1,92 @@
+/**
+ * `ccs bar install` — download the CCS Bar app from the floating
+ * `ccs-bar-latest` GitHub release tag and install to ~/Applications.
+ *
+ * Intentionally uses a FLOATING tag (not the exact CLI version) so the
+ * Swift app can be rebuilt and published independently. After extraction,
+ * the real app version is read from the bundle's Contents/Info.plist
+ * (CFBundleShortVersionString) and pinned to ~/.ccs/bar/.version.
+ *
+ * Post-install compat check: single GET {baseUrl}/api/bar/summary.
+ * 200 = server serves the bar API (compatible).
+ * 404 = server too old (actionable warning).
+ * Other / unreachable = soft-warn, never hard-fail install.
+ *
+ * Mirrors the download/version-pin pattern in src/cliproxy/binary-manager.ts.
+ */
+export interface ReleaseAssetResult {
+    downloadUrl: string;
+}
+export interface CompatResult {
+    compatible: boolean;
+    reason: 'ok' | 'no-bar-api' | 'unreachable';
+}
+export interface InstallDeps {
+    /**
+     * Resolve the asset download URL from a GitHub release tag.
+     * Production: calls GitHub API releases/tags/{tag}.
+     * Test: mock that returns a fake URL.
+     */
+    fetchReleaseAsset: (tag: string, asset: string) => Promise<ReleaseAssetResult>;
+    /**
+     * Download the zip archive and extract the .app bundle into dest/.
+     * Production: uses undici to stream + extract (with redirect + status check).
+     */
+    downloadAndExtract: (url: string, dest: string) => Promise<void>;
+    /**
+     * GET {baseUrl}/api/bar/summary — capability handshake.
+     * 200 → compatible; 404 → no-bar-api; else/unreachable → unreachable.
+     * Never hard-fails install.
+     */
+    verifyCompat: (baseUrl: string) => Promise<CompatResult>;
+    /**
+     * Read CFBundleShortVersionString from {appPath}/Contents/Info.plist.
+     * Returns null if the file is absent or unreadable.
+     */
+    readAppBundleVersion: (appPath: string) => string | null;
+    /** Returns path to ~/.ccs (respects CCS_HOME). */
+    getCcsDir: () => string;
+    /** Destination directory for the .app bundle (~/Applications by default). */
+    getAppsDir: () => string;
+    /**
+     * Clear the macOS Gatekeeper quarantine attribute from the installed app.
+     * Run via `/usr/bin/xattr -dr com.apple.quarantine <appPath>` (execFile, not shell-string).
+     * Returns true on success, false if xattr is unavailable or the call fails (non-fatal).
+     * Injectable for tests — avoids touching the real system.
+     */
+    clearQuarantine: (appPath: string) => Promise<boolean>;
+    /**
+     * Invoke handleBarLaunch after a successful install when the user consents.
+     * Injectable so tests can assert invocation without starting a real server.
+     */
+    launchBar: (args: string[]) => Promise<void>;
+    /**
+     * Ask the user whether to launch CCS Bar now (stdin-TTY-only).
+     * Returns true on yes/default, false on no or non-TTY stdin.
+     * Injectable for tests.
+     */
+    promptLaunch: () => Promise<boolean>;
+    /**
+     * Detect whether CCS Bar is already running.
+     * Production: uses /usr/bin/pgrep -x CCSBar (exit 0 = running, exit 1 = not found).
+     * Returns false on any error (treat pgrep failure as not running).
+     * Injectable for tests — avoids touching the real process table.
+     */
+    isBarRunning: () => Promise<boolean>;
+    /**
+     * Remove an existing app bundle before extraction so a malformed archive
+     * cannot silently leave the old version in place.
+     * Production: fs.rmSync(appPath, { recursive: true, force: true }).
+     * Injectable for tests — avoids real filesystem side-effects.
+     * Throws on failure; caller catches and aborts install.
+     */
+    removeExistingApp: (appPath: string) => void;
+}
+/**
+ * Validate that a download URL is https and its hostname is in the allowlist
+ * (exact match or *.githubusercontent.com wildcard).
+ * Throws a descriptive Error if validation fails.
+ */
+export declare function validateDownloadUrl(url: string): void;
+export declare function handleBarInstall(args: string[], deps?: Partial<InstallDeps>): Promise<void>;
+//# sourceMappingURL=install-subcommand.d.ts.map

package/dist/commands/bar/install-subcommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-subcommand.d.ts","sourceRoot":"","sources":["../../../src/commands/bar/install-subcommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoCH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,aAAa,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/E;;;OAGG;IACH,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;;OAIG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD;;;OAGG;IACH,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,kDAAkD;IAClD,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB;;;;;OAKG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;;;OAIG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC;;;;;OAKG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAuBrD;AA0TD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAC9B,OAAO,CAAC,IAAI,CAAC,CAoOf"}