@kaitranntt/ccs 8.2.0 → 8.3.0-dev.2

package/dist/commands/bar/bar-paths.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Shared path helpers for the `ccs bar` command family.
+ *
+ * Centralises the paths under ~/.ccs/bar/ so every subcommand stays DRY.
+ * All paths derive from ccsDir (i.e. getCcsDir()) so CCS_HOME isolation
+ * works correctly in tests.
+ */
+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.LAUNCH_JSON_SCHEMA = exports.getBarDir = exports.getBarJsonPath = exports.getServeLogPath = exports.getServerPidPath = exports.getLaunchJsonPath = void 0;
+const path = __importStar(require("path"));
+/** launch.json — consumed by the Swift app to spawn the server without a shell PATH. */
+function getLaunchJsonPath(ccsDir) {
+    return path.join(ccsDir, 'bar', 'launch.json');
+}
+exports.getLaunchJsonPath = getLaunchJsonPath;
+/** server.pid — PID of the live detached server process. */
+function getServerPidPath(ccsDir) {
+    return path.join(ccsDir, 'bar', 'server.pid');
+}
+exports.getServerPidPath = getServerPidPath;
+/** serve.log — stdout/stderr of the detached server process. */
+function getServeLogPath(ccsDir) {
+    return path.join(ccsDir, 'bar', 'serve.log');
+}
+exports.getServeLogPath = getServeLogPath;
+/** bar.json — live discovery file consumed by the Swift app. */
+function getBarJsonPath(ccsDir) {
+    return path.join(ccsDir, 'bar.json');
+}
+exports.getBarJsonPath = getBarJsonPath;
+/** bar/ subdirectory (parent of all bar artefacts). */
+function getBarDir(ccsDir) {
+    return path.join(ccsDir, 'bar');
+}
+exports.getBarDir = getBarDir;
+/** Schema version constant for launch.json. */
+exports.LAUNCH_JSON_SCHEMA = 1;
+//# sourceMappingURL=bar-paths.js.map

package/dist/commands/bar/bar-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar-paths.js","sourceRoot":"","sources":["../../../src/commands/bar/bar-paths.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,2CAA6B;AAE7B,wFAAwF;AACxF,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC;AAFD,8CAEC;AAED,4DAA4D;AAC5D,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAChD,CAAC;AAFD,4CAEC;AAED,gEAAgE;AAChE,SAAgB,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAFD,0CAEC;AAED,gEAAgE;AAChE,SAAgB,cAAc,CAAC,MAAc;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACvC,CAAC;AAFD,wCAEC;AAED,uDAAuD;AACvD,SAAgB,SAAS,CAAC,MAAc;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAFD,8BAEC;AAED,+CAA+C;AAClC,QAAA,kBAAkB,GAAG,CAAC,CAAC"}

package/dist/commands/bar/bar-server-probe.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CCS Bar — server liveness probe utilities.
+ *
+ * Shared by launch-subcommand.ts and serve-subcommand.ts so neither imports
+ * from the other (which would create a cross-module dependency that breaks
+ * Bun's test module isolation when cache-busting URLs are used).
+ */
+export interface DashboardInfo {
+    port: number;
+    baseUrl: string;
+}
+/**
+ * Read the port recorded in an existing bar.json.
+ * Returns null when the file is absent or malformed.
+ */
+export declare function resolveBarPort(ccsDir: string): number | null;
+/**
+ * Probe candidate ports for a running CCS server.
+ *
+ * Both IPv4 (127.0.0.1) and IPv6 (::1) loopback addresses are probed for each
+ * port. All probes are fired concurrently so worst-case latency is ~1.5 s
+ * (one timeout) rather than N × 1.5 s sequentially. Priority selection is
+ * applied after all results are in: the bar.json port is preferred over the
+ * defaults, and within a port 127.0.0.1 is preferred over [::1].
+ */
+export declare function defaultFindRunningServer(ccsDir: string): Promise<DashboardInfo | null>;
+//# sourceMappingURL=bar-server-probe.d.ts.map

package/dist/commands/bar/bar-server-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar-server-probe.d.ts","sourceRoot":"","sources":["../../../src/commands/bar/bar-server-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAoC5F"}

package/dist/commands/bar/bar-server-probe.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * CCS Bar — server liveness probe utilities.
+ *
+ * Shared by launch-subcommand.ts and serve-subcommand.ts so neither imports
+ * from the other (which would create a cross-module dependency that breaks
+ * Bun's test module isolation when cache-busting URLs are used).
+ */
+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.defaultFindRunningServer = exports.resolveBarPort = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Read the port recorded in an existing bar.json.
+ * Returns null when the file is absent or malformed.
+ */
+function resolveBarPort(ccsDir) {
+    const barJsonPath = path.join(ccsDir, 'bar.json');
+    try {
+        const raw = fs.readFileSync(barJsonPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return typeof parsed.port === 'number' ? parsed.port : null;
+    }
+    catch {
+        return null;
+    }
+}
+exports.resolveBarPort = resolveBarPort;
+/**
+ * Probe candidate ports for a running CCS server.
+ *
+ * Both IPv4 (127.0.0.1) and IPv6 (::1) loopback addresses are probed for each
+ * port. All probes are fired concurrently so worst-case latency is ~1.5 s
+ * (one timeout) rather than N × 1.5 s sequentially. Priority selection is
+ * applied after all results are in: the bar.json port is preferred over the
+ * defaults, and within a port 127.0.0.1 is preferred over [::1].
+ */
+async function defaultFindRunningServer(ccsDir) {
+    const { request } = await Promise.resolve().then(() => __importStar(require('undici')));
+    async function probe(url) {
+        try {
+            const { statusCode, body } = await request(url, {
+                method: 'GET',
+                headersTimeout: 1500,
+                bodyTimeout: 1500,
+            });
+            await body.text();
+            return { ok: statusCode === 200 };
+        }
+        catch {
+            return { ok: false };
+        }
+    }
+    const barJsonPort = resolveBarPort(ccsDir);
+    const base = [3000, 3001, 3002, 8000, 8080];
+    const candidates = barJsonPort !== null ? [barJsonPort, ...base.filter((p) => p !== barJsonPort)] : base;
+    const probeTargets = candidates.flatMap((port) => [
+        { port, baseUrl: `http://127.0.0.1:${port}`, url: `http://127.0.0.1:${port}/api/bar/summary` },
+        { port, baseUrl: `http://[::1]:${port}`, url: `http://[::1]:${port}/api/bar/summary` },
+    ]);
+    const results = await Promise.all(probeTargets.map((t) => probe(t.url)));
+    for (let i = 0; i < probeTargets.length; i++) {
+        if (results[i].ok) {
+            const { port, baseUrl } = probeTargets[i];
+            return { port, baseUrl };
+        }
+    }
+    return null;
+}
+exports.defaultFindRunningServer = defaultFindRunningServer;
+//# sourceMappingURL=bar-server-probe.js.map

package/dist/commands/bar/bar-server-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar-server-probe.js","sourceRoot":"","sources":["../../../src/commands/bar/bar-server-probe.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAO7B;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA8B,CAAC;QAC5D,OAAO,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AATD,wCASC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,wBAAwB,CAAC,MAAc;IAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,wDAAa,QAAQ,GAAC,CAAC;IAE3C,KAAK,UAAU,KAAK,CAAC,GAAW;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;gBAC9C,MAAM,EAAE,KAAK;gBACb,cAAc,EAAE,IAAI;gBACpB,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,EAAE,EAAE,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,UAAU,GACd,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExF,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAChD,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,IAAI,EAAE,EAAE,GAAG,EAAE,oBAAoB,IAAI,kBAAkB,EAAE;QAC9F,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,IAAI,EAAE,EAAE,GAAG,EAAE,gBAAgB,IAAI,kBAAkB,EAAE;KACvF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AApCD,4DAoCC"}

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

@@ -0,0 +1,2 @@
+export declare function showHelp(): Promise<void>;
+//# sourceMappingURL=help-subcommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help-subcommand.d.ts","sourceRoot":"","sources":["../../../src/commands/bar/help-subcommand.ts"],"names":[],"mappings":"AAEA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAuE9C"}

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

@@ -0,0 +1,69 @@
+"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', 'Spawn the server detached, write ~/.ccs/bar.json, open the app (default)'],
+                ['stop', 'Stop the detached CCS Bar server'],
+                ['status', 'Show whether the CCS Bar server is running'],
+                ['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 server detached and open CCS Bar'],
+                ['ccs bar stop', 'Stop the detached CCS Bar server'],
+                ['ccs bar status', 'Show server running state and PID'],
+                ['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)('  `ccs bar launch` spawns the server detached — the terminal is freed immediately.'));
+    console.log((0, ui_1.dim)('  The server persists until stopped with `ccs bar stop` or system reboot.'));
+    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,0EAA0E,CAAC;gBACtF,CAAC,MAAM,EAAE,kCAAkC,CAAC;gBAC5C,CAAC,QAAQ,EAAE,4CAA4C,CAAC;gBACxD,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,4CAA4C,CAAC;gBACzD,CAAC,cAAc,EAAE,kCAAkC,CAAC;gBACpD,CAAC,gBAAgB,EAAE,mCAAmC,CAAC;gBACvD,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,EAAC,oFAAoF,CAAC,CAC1F,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAA,QAAG,EAAC,2EAA2E,CAAC,CAAC,CAAC;IAC9F,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;AAvED,4BAuEC"}

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

@@ -0,0 +1,12 @@
+/**
+ * `ccs bar` command dispatcher
+ *
+ * Mirrors the pattern in src/commands/docker/index.ts.
+ * Subcommands: launch (default), serve, stop, status, install, uninstall,
+ *              version / --version, help / --help / -h.
+ *
+ * `serve` is the long-lived server host (spawned detached by `launch` and by
+ * the Swift app). `stop` and `status` manage the detached server lifecycle.
+ */
+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;;;;;;;;;GASG;AAIH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DpE"}

package/dist/commands/bar/index.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * `ccs bar` command dispatcher
+ *
+ * Mirrors the pattern in src/commands/docker/index.ts.
+ * Subcommands: launch (default), serve, stop, status, install, uninstall,
+ *              version / --version, help / --help / -h.
+ *
+ * `serve` is the long-lived server host (spawned detached by `launch` and by
+ * the Swift app). `stop` and `status` manage the detached server lifecycle.
+ */
+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.
+    // 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);
+        },
+        serve: async (subArgs) => {
+            const { handleBarServe } = await Promise.resolve().then(() => __importStar(require('./serve-subcommand')));
+            await handleBarServe(subArgs);
+        },
+        stop: async (subArgs) => {
+            const { handleBarStop } = await Promise.resolve().then(() => __importStar(require('./stop-subcommand')));
+            await handleBarStop(subArgs);
+        },
+        status: async (subArgs) => {
+            const { handleBarStatus } = await Promise.resolve().then(() => __importStar(require('./status-subcommand')));
+            await handleBarStatus(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|serve|stop|status|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;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,oDAA8C;AAEvC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3B,4EAA4E;IAC5E,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,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACvB,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,oBAAoB,GAAC,CAAC;YAC9D,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtB,MAAM,EAAE,aAAa,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;YAC5D,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,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,gFAAgF,CAAC,CAAC;QAChG,OAAO;IACT,CAAC;IAED,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AA3DD,4CA2DC"}

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

@@ -0,0 +1,100 @@
+/**
+ * `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.
+ */
+import type { LaunchJson } from './bar-paths';
+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;
+    /**
+     * Write launch.json so the Swift app can spawn the server without a shell PATH.
+     * Called after successful install so the descriptor is always fresh.
+     * Injectable for tests — asserts the file is written without real fs side-effects.
+     * Non-fatal when it throws (install already succeeded).
+     */
+    writeLaunchDescriptor: (jsonPath: string, descriptor: LaunchJson) => 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;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA8B9C,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;IAC7C;;;;;OAKG;IACH,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CAC3E;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAuBrD;AA+TD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAC9B,OAAO,CAAC,IAAI,CAAC,CAuPf"}