chatroom-cli 1.31.1 → 1.32.1

package/dist/infrastructure/local-api/router.js

@@ -0,0 +1,60 @@
+/**
+ * Local API Router
+ *
+ * Minimal route registry and request dispatcher for the local daemon HTTP server.
+ * Routes are registered once at startup; requests are matched by method + path.
+ */
+import { applyCorsHeaders, buildPreflightResponse } from './cors.js';
+// ─── Router ──────────────────────────────────────────────────────────────────
+/**
+ * Simple route registry and dispatcher.
+ * Routes are matched in registration order; first match wins.
+ */
+export class LocalApiRouter {
+    routes = [];
+    /**
+     * Register a route with the router.
+     * Routes are matched by exact method + path comparison.
+     */
+    registerRoute(route) {
+        this.routes.push(route);
+    }
+    /**
+     * Dispatch an incoming request to the matching route handler.
+     *
+     * - OPTIONS requests are handled automatically with a CORS preflight response.
+     * - Unmatched routes return HTTP 404.
+     * - CORS headers are applied to all responses.
+     */
+    async handleRequest(req, ctx) {
+        // Handle CORS preflight
+        if (req.method === 'OPTIONS') {
+            return buildPreflightResponse();
+        }
+        // Find a matching route (strip query string for path matching)
+        const pathname = req.url.split('?')[0] ?? req.url;
+        const route = this.routes.find((r) => r.method === req.method && r.path === pathname);
+        let response;
+        if (route) {
+            try {
+                response = await route.handler(req, ctx);
+            }
+            catch (error) {
+                response = {
+                    status: 500,
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ error: 'Internal server error' }),
+                };
+            }
+        }
+        else {
+            response = {
+                status: 404,
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ error: 'Not found' }),
+            };
+        }
+        return applyCorsHeaders(response);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/infrastructure/local-api/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/infrastructure/local-api/router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGrE,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,OAAO,cAAc;IACR,MAAM,GAAoB,EAAE,CAAC;IAE9C;;;OAGG;IACH,aAAa,CAAC,KAAoB;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,GAAoB,EAAE,GAAkB;QAC1D,wBAAwB;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,sBAAsB,EAAE,CAAC;QAClC,CAAC;QAED,+DAA+D;QAC/D,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CACtD,CAAC;QAEF,IAAI,QAA0B,CAAC;QAE/B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,GAAG;oBACT,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;iBACzD,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG;gBACT,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;aAC7C,CAAC;QACJ,CAAC;QAED,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/infrastructure/local-api/router.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Local API Router — Unit Tests
+ *
+ * Tests route registration, dispatch, OPTIONS handling, 404 responses,
+ * and CORS header injection.
+ */
+export {};
+//# sourceMappingURL=router.test.d.ts.map

package/dist/infrastructure/local-api/router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.test.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/local-api/router.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/infrastructure/local-api/router.test.js

@@ -0,0 +1,142 @@
+/**
+ * Local API Router — Unit Tests
+ *
+ * Tests route registration, dispatch, OPTIONS handling, 404 responses,
+ * and CORS header injection.
+ */
+import { describe, expect, test, vi } from 'vitest';
+import { LocalApiRouter } from './router.js';
+// ─── Test Helpers ─────────────────────────────────────────────────────────────
+function makeCtx() {
+    return {
+        machineId: 'test-machine-id',
+        config: { hostname: 'test-host', os: 'linux' },
+    };
+}
+function makeReq(overrides = {}) {
+    return {
+        method: 'GET',
+        url: '/api/test',
+        headers: {},
+        ...overrides,
+    };
+}
+// ─── Tests ────────────────────────────────────────────────────────────────────
+describe('LocalApiRouter', () => {
+    test('dispatches a matching GET route', async () => {
+        const router = new LocalApiRouter();
+        const handler = vi.fn().mockResolvedValue({
+            status: 200,
+            body: JSON.stringify({ ok: true }),
+        });
+        router.registerRoute({ method: 'GET', path: '/api/test', handler });
+        const res = await router.handleRequest(makeReq(), makeCtx());
+        expect(handler).toHaveBeenCalledOnce();
+        expect(res.status).toBe(200);
+    });
+    test('returns 404 for unmatched paths', async () => {
+        const router = new LocalApiRouter();
+        const res = await router.handleRequest(makeReq({ url: '/api/unknown' }), makeCtx());
+        expect(res.status).toBe(404);
+    });
+    test('returns 404 when method does not match', async () => {
+        const router = new LocalApiRouter();
+        router.registerRoute({
+            method: 'POST',
+            path: '/api/test',
+            handler: async () => ({ status: 200, body: 'ok' }),
+        });
+        const res = await router.handleRequest(makeReq({ method: 'GET', url: '/api/test' }), makeCtx());
+        expect(res.status).toBe(404);
+    });
+    test('returns 204 with CORS headers for OPTIONS preflight', async () => {
+        const router = new LocalApiRouter();
+        const res = await router.handleRequest(makeReq({ method: 'OPTIONS' }), makeCtx());
+        expect(res.status).toBe(204);
+        expect(res.headers?.['Access-Control-Allow-Origin']).toBe('*');
+        expect(res.headers?.['Access-Control-Allow-Methods']).toContain('GET');
+    });
+    test('includes Access-Control-Allow-Private-Network header for Chrome PNA', async () => {
+        const router = new LocalApiRouter();
+        router.registerRoute({
+            method: 'GET',
+            path: '/api/test',
+            handler: async () => ({ status: 200, body: 'ok' }),
+        });
+        // Verify on preflight responses
+        const preflight = await router.handleRequest(makeReq({ method: 'OPTIONS' }), makeCtx());
+        expect(preflight.headers?.['Access-Control-Allow-Private-Network']).toBe('true');
+        // Verify on regular responses
+        const res = await router.handleRequest(makeReq(), makeCtx());
+        expect(res.headers?.['Access-Control-Allow-Private-Network']).toBe('true');
+    });
+    test('applies CORS headers to all responses', async () => {
+        const router = new LocalApiRouter();
+        router.registerRoute({
+            method: 'GET',
+            path: '/api/test',
+            handler: async () => ({ status: 200, body: 'ok' }),
+        });
+        const res = await router.handleRequest(makeReq(), makeCtx());
+        expect(res.headers?.['Access-Control-Allow-Origin']).toBe('*');
+    });
+    test('applies CORS headers even to 404 responses', async () => {
+        const router = new LocalApiRouter();
+        const res = await router.handleRequest(makeReq({ url: '/nope' }), makeCtx());
+        expect(res.headers?.['Access-Control-Allow-Origin']).toBe('*');
+    });
+    test('returns 500 when a handler throws', async () => {
+        const router = new LocalApiRouter();
+        router.registerRoute({
+            method: 'GET',
+            path: '/api/test',
+            handler: async () => {
+                throw new Error('boom');
+            },
+        });
+        const res = await router.handleRequest(makeReq(), makeCtx());
+        expect(res.status).toBe(500);
+    });
+    test('preserves existing response headers while adding CORS headers', async () => {
+        const router = new LocalApiRouter();
+        router.registerRoute({
+            method: 'GET',
+            path: '/api/test',
+            handler: async () => ({
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+                body: '{}',
+            }),
+        });
+        const res = await router.handleRequest(makeReq(), makeCtx());
+        expect(res.headers?.['Content-Type']).toBe('application/json');
+        expect(res.headers?.['Access-Control-Allow-Origin']).toBe('*');
+    });
+    test('first registered route wins when multiple routes match', async () => {
+        const router = new LocalApiRouter();
+        router.registerRoute({
+            method: 'GET',
+            path: '/api/test',
+            handler: async () => ({ status: 200, body: 'first' }),
+        });
+        router.registerRoute({
+            method: 'GET',
+            path: '/api/test',
+            handler: async () => ({ status: 200, body: 'second' }),
+        });
+        const res = await router.handleRequest(makeReq(), makeCtx());
+        expect(res.body).toBe('first');
+    });
+    test('matches route ignoring query parameters', async () => {
+        const router = new LocalApiRouter();
+        router.registerRoute({
+            method: 'GET',
+            path: '/api/test',
+            handler: async () => ({ status: 200, body: 'matched' }),
+        });
+        const res = await router.handleRequest(makeReq({ url: '/api/test?foo=bar&baz=1' }), makeCtx());
+        expect(res.status).toBe(200);
+        expect(res.body).toBe('matched');
+    });
+});
+//# sourceMappingURL=router.test.js.map

package/dist/infrastructure/local-api/router.test.js.map

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

package/dist/infrastructure/local-api/routes/identity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Local API — Identity Route
+ *
+ * GET /api/identity
+ *
+ * Returns machine identity information so the webapp can detect whether it is
+ * running on the same machine as the daemon.  The response includes:
+ *   - machineId  — stable UUID unique to this machine + Convex endpoint
+ *   - hostname   — machine hostname
+ *   - os         — operating system (darwin | linux | win32 | …)
+ *   - version    — CLI version from package.json
+ */
+import type { LocalApiRoute } from '../types.js';
+/**
+ * JSON body returned by GET /api/identity.
+ */
+export interface IdentityResponse {
+    machineId: string;
+    hostname: string;
+    os: string;
+    version: string;
+}
+/**
+ * Route registration entry for GET /api/identity.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export declare const identityRoute: LocalApiRoute;
+//# sourceMappingURL=identity.d.ts.map

package/dist/infrastructure/local-api/routes/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAqC,aAAa,EAAiB,MAAM,aAAa,CAAC;AAInG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AA4BD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAI3B,CAAC"}

package/dist/infrastructure/local-api/routes/identity.js

@@ -0,0 +1,42 @@
+/**
+ * Local API — Identity Route
+ *
+ * GET /api/identity
+ *
+ * Returns machine identity information so the webapp can detect whether it is
+ * running on the same machine as the daemon.  The response includes:
+ *   - machineId  — stable UUID unique to this machine + Convex endpoint
+ *   - hostname   — machine hostname
+ *   - os         — operating system (darwin | linux | win32 | …)
+ *   - version    — CLI version from package.json
+ */
+import { getVersion } from '../../../version.js';
+// ─── Handler ─────────────────────────────────────────────────────────────────
+/**
+ * Handle GET /api/identity.
+ * Reads machine info from the daemon context and returns it as JSON.
+ */
+async function handleIdentity(_req, ctx) {
+    const identity = {
+        machineId: ctx.machineId,
+        hostname: ctx.config?.hostname ?? 'unknown',
+        os: ctx.config?.os ?? 'unknown',
+        version: getVersion(),
+    };
+    return {
+        status: 200,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(identity),
+    };
+}
+// ─── Route Definition ─────────────────────────────────────────────────────────
+/**
+ * Route registration entry for GET /api/identity.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export const identityRoute = {
+    method: 'GET',
+    path: '/api/identity',
+    handler: handleIdentity,
+};
+//# sourceMappingURL=identity.js.map

package/dist/infrastructure/local-api/routes/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAejD,gFAAgF;AAEhF;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC3B,IAAqB,EACrB,GAAkB;IAElB,MAAM,QAAQ,GAAqB;QACjC,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS;QAC3C,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,SAAS;QAC/B,OAAO,EAAE,UAAU,EAAE;KACtB,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,cAAc;CACxB,CAAC"}

package/dist/infrastructure/local-api/routes/open-finder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Local API — Open Finder Route
+ *
+ * POST /api/open-finder
+ *
+ * Opens a workspace directory in the OS file explorer:
+ *   - macOS:   `open <workingDir>`
+ *   - Linux:   `xdg-open <workingDir>`
+ *   - Windows: `explorer <workingDir>`
+ *
+ * The command is fire-and-forget — the route returns as soon as the process is
+ * spawned, without waiting for the file explorer to close.
+ *
+ * Request body (JSON): `{ workingDir: string }`
+ * Response (JSON):
+ *   - `{ success: true }` — command dispatched successfully
+ *   - `{ success: false, error: string }` — validation failure or path error
+ */
+import type { LocalApiRoute } from '../types.js';
+/**
+ * Route registration entry for POST /api/open-finder.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export declare const openFinderRoute: LocalApiRoute;
+//# sourceMappingURL=open-finder.d.ts.map

package/dist/infrastructure/local-api/routes/open-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-finder.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/open-finder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAqC,aAAa,EAAE,MAAM,aAAa,CAAC;AA2CpF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,aAI7B,CAAC"}

package/dist/infrastructure/local-api/routes/open-finder.js

@@ -0,0 +1,58 @@
+/**
+ * Local API — Open Finder Route
+ *
+ * POST /api/open-finder
+ *
+ * Opens a workspace directory in the OS file explorer:
+ *   - macOS:   `open <workingDir>`
+ *   - Linux:   `xdg-open <workingDir>`
+ *   - Windows: `explorer <workingDir>`
+ *
+ * The command is fire-and-forget — the route returns as soon as the process is
+ * spawned, without waiting for the file explorer to close.
+ *
+ * Request body (JSON): `{ workingDir: string }`
+ * Response (JSON):
+ *   - `{ success: true }` — command dispatched successfully
+ *   - `{ success: false, error: string }` — validation failure or path error
+ */
+import { parseWorkingDir, escapeShellArg, execFireAndForget, jsonResponse, } from './shared-utils.js';
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Resolve the platform-specific command used to open a folder in the file explorer.
+ */
+function resolveOpenCommand(platform) {
+    switch (platform) {
+        case 'darwin':
+            return 'open';
+        case 'win32':
+            return 'explorer';
+        default:
+            // Linux and other Unix-like systems
+            return 'xdg-open';
+    }
+}
+// ─── Handler ─────────────────────────────────────────────────────────────────
+/**
+ * Handle POST /api/open-finder.
+ */
+async function handleOpenFinder(req) {
+    const parsed = await parseWorkingDir(req);
+    if (!parsed.ok)
+        return parsed.response;
+    // Fire-and-forget: spawn the file explorer
+    const cmd = resolveOpenCommand(process.platform);
+    execFireAndForget(`${cmd} ${escapeShellArg(parsed.workingDir)}`, 'open-finder');
+    return jsonResponse(200, { success: true });
+}
+// ─── Route Definition ─────────────────────────────────────────────────────────
+/**
+ * Route registration entry for POST /api/open-finder.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export const openFinderRoute = {
+    method: 'POST',
+    path: '/api/open-finder',
+    handler: (req) => handleOpenFinder(req),
+};
+//# sourceMappingURL=open-finder.js.map

package/dist/infrastructure/local-api/routes/open-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-finder.js","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/open-finder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAEhF;;GAEG;AACH,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,UAAU,CAAC;QACpB;YACE,oCAAoC;YACpC,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,GAAoB;IAClD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAEvC,2CAA2C;IAC3C,MAAM,GAAG,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,iBAAiB,CAAC,GAAG,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAEhF,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC;CACxC,CAAC"}

package/dist/infrastructure/local-api/routes/open-github-desktop.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Local API — Open GitHub Desktop Route
+ *
+ * POST /api/open-github-desktop
+ *
+ * Opens a workspace directory in GitHub Desktop using the `github` CLI tool
+ * that GitHub Desktop installs. Checks for CLI availability first.
+ *
+ * Request body (JSON): `{ workingDir: string }`
+ * Response (JSON):
+ *   - `{ success: true }` — command dispatched successfully
+ *   - `{ success: false, error: "GitHub Desktop CLI not found" }` — CLI not installed
+ *   - `{ success: false, error: string }` — validation failure or path error
+ */
+import type { LocalApiRoute } from '../types.js';
+/**
+ * Route registration entry for POST /api/open-github-desktop.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export declare const openGitHubDesktopRoute: LocalApiRoute;
+//# sourceMappingURL=open-github-desktop.d.ts.map

package/dist/infrastructure/local-api/routes/open-github-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-github-desktop.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/open-github-desktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAqC,aAAa,EAAE,MAAM,aAAa,CAAC;AAgCpF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC"}

package/dist/infrastructure/local-api/routes/open-github-desktop.js

@@ -0,0 +1,43 @@
+/**
+ * Local API — Open GitHub Desktop Route
+ *
+ * POST /api/open-github-desktop
+ *
+ * Opens a workspace directory in GitHub Desktop using the `github` CLI tool
+ * that GitHub Desktop installs. Checks for CLI availability first.
+ *
+ * Request body (JSON): `{ workingDir: string }`
+ * Response (JSON):
+ *   - `{ success: true }` — command dispatched successfully
+ *   - `{ success: false, error: "GitHub Desktop CLI not found" }` — CLI not installed
+ *   - `{ success: false, error: string }` — validation failure or path error
+ */
+import { parseWorkingDir, escapeShellArg, isCliAvailable, execFireAndForget, jsonResponse, } from './shared-utils.js';
+// ─── Handler ─────────────────────────────────────────────────────────────────
+/**
+ * Handle POST /api/open-github-desktop.
+ */
+async function handleOpenGitHubDesktop(req) {
+    const parsed = await parseWorkingDir(req);
+    if (!parsed.ok)
+        return parsed.response;
+    // Check if `github` CLI is available
+    const available = await isCliAvailable('github');
+    if (!available) {
+        return jsonResponse(200, { success: false, error: 'GitHub Desktop CLI not found' });
+    }
+    // Fire-and-forget: open GitHub Desktop
+    execFireAndForget(`github ${escapeShellArg(parsed.workingDir)}`, 'open-github-desktop');
+    return jsonResponse(200, { success: true });
+}
+// ─── Route Definition ─────────────────────────────────────────────────────────
+/**
+ * Route registration entry for POST /api/open-github-desktop.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export const openGitHubDesktopRoute = {
+    method: 'POST',
+    path: '/api/open-github-desktop',
+    handler: (req) => handleOpenGitHubDesktop(req),
+};
+//# sourceMappingURL=open-github-desktop.js.map

package/dist/infrastructure/local-api/routes/open-github-desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-github-desktop.js","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/open-github-desktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAEhF;;GAEG;AACH,KAAK,UAAU,uBAAuB,CAAC,GAAoB;IACzD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAEvC,qCAAqC;IACrC,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,uCAAuC;IACvC,iBAAiB,CAAC,UAAU,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC;IAExF,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,0BAA0B;IAChC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC;CAC/C,CAAC"}

package/dist/infrastructure/local-api/routes/open-vscode.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Local API — Open VS Code Route
+ *
+ * POST /api/open-vscode
+ *
+ * Opens a workspace directory in Visual Studio Code using the `code` CLI tool.
+ * Checks for CLI availability first.
+ *
+ * Install the `code` CLI via: VS Code → Cmd+Shift+P → "Shell Command: Install code in PATH"
+ *
+ * Request body (JSON): `{ workingDir: string }`
+ * Response (JSON):
+ *   - `{ success: true }` — command dispatched successfully
+ *   - `{ success: false, error: "VS Code CLI (code) not found. Install via: ..." }` — CLI not installed
+ *   - `{ success: false, error: string }` — validation failure or path error
+ */
+import type { LocalApiRoute } from '../types.js';
+/**
+ * Route registration entry for POST /api/open-vscode.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export declare const openVSCodeRoute: LocalApiRoute;
+//# sourceMappingURL=open-vscode.d.ts.map

package/dist/infrastructure/local-api/routes/open-vscode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-vscode.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/open-vscode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAqC,aAAa,EAAE,MAAM,aAAa,CAAC;AAyCpF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,aAI7B,CAAC"}

package/dist/infrastructure/local-api/routes/open-vscode.js

@@ -0,0 +1,51 @@
+/**
+ * Local API — Open VS Code Route
+ *
+ * POST /api/open-vscode
+ *
+ * Opens a workspace directory in Visual Studio Code using the `code` CLI tool.
+ * Checks for CLI availability first.
+ *
+ * Install the `code` CLI via: VS Code → Cmd+Shift+P → "Shell Command: Install code in PATH"
+ *
+ * Request body (JSON): `{ workingDir: string }`
+ * Response (JSON):
+ *   - `{ success: true }` — command dispatched successfully
+ *   - `{ success: false, error: "VS Code CLI (code) not found. Install via: ..." }` — CLI not installed
+ *   - `{ success: false, error: string }` — validation failure or path error
+ */
+import { parseWorkingDir, escapeShellArg, isCliAvailable, execFireAndForget, jsonResponse, } from './shared-utils.js';
+// ─── Constants ────────────────────────────────────────────────────────────────
+/**
+ * Error message returned when the `code` CLI is not found on PATH.
+ * Includes install instructions for discoverability.
+ */
+const CODE_CLI_NOT_FOUND = "VS Code CLI (code) not found. Install via: VS Code → Cmd+Shift+P → 'Shell Command: Install code in PATH'";
+// ─── Handler ─────────────────────────────────────────────────────────────────
+/**
+ * Handle POST /api/open-vscode.
+ */
+async function handleOpenVSCode(req) {
+    const parsed = await parseWorkingDir(req);
+    if (!parsed.ok)
+        return parsed.response;
+    // Check if `code` CLI is available
+    const available = await isCliAvailable('code');
+    if (!available) {
+        return jsonResponse(200, { success: false, error: CODE_CLI_NOT_FOUND });
+    }
+    // Fire-and-forget: open VS Code
+    execFireAndForget(`code ${escapeShellArg(parsed.workingDir)}`, 'open-vscode');
+    return jsonResponse(200, { success: true });
+}
+// ─── Route Definition ─────────────────────────────────────────────────────────
+/**
+ * Route registration entry for POST /api/open-vscode.
+ * Import and pass to {@link LocalApiRouter.registerRoute} at server startup.
+ */
+export const openVSCodeRoute = {
+    method: 'POST',
+    path: '/api/open-vscode',
+    handler: (req) => handleOpenVSCode(req),
+};
+//# sourceMappingURL=open-vscode.js.map

package/dist/infrastructure/local-api/routes/open-vscode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-vscode.js","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/open-vscode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,kBAAkB,GACtB,0GAA0G,CAAC;AAE7G,gFAAgF;AAEhF;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,GAAoB;IAClD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAEvC,mCAAmC;IACnC,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,gCAAgC;IAChC,iBAAiB,CAAC,QAAQ,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAE9E,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC;CACxC,CAAC"}

package/dist/infrastructure/local-api/routes/shared-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Shared Route Utilities
+ *
+ * Common helpers used by local API route handlers that accept a
+ * `{ workingDir: string }` JSON body, validate the path, and shell out.
+ *
+ * Extracted from open-finder, open-vscode, and open-github-desktop routes
+ * to eliminate duplication.
+ */
+import type { LocalApiRequest, LocalApiResponse } from '../types.js';
+/** Discriminated result from {@link parseWorkingDir}. */
+export type ParseResult = {
+    ok: true;
+    workingDir: string;
+} | {
+    ok: false;
+    response: LocalApiResponse;
+};
+/**
+ * Build a JSON {@link LocalApiResponse}.
+ */
+export declare function jsonResponse(status: number, body: Record<string, unknown>): LocalApiResponse;
+/**
+ * Parse the request body as JSON, extract and validate `workingDir`,
+ * and verify the directory exists on disk.
+ *
+ * Returns either the validated `workingDir` string or a ready-to-send
+ * error response — callers can return it directly.
+ */
+export declare function parseWorkingDir(req: LocalApiRequest): Promise<ParseResult>;
+/**
+ * Escape a filesystem path for safe use as a shell argument.
+ * Wraps the path in double quotes and escapes any embedded double quotes.
+ */
+export declare function escapeShellArg(arg: string): string;
+/**
+ * Resolve the platform-specific command used to locate an executable.
+ * - POSIX: `which <name>`
+ * - Windows: `where <name>`
+ */
+export declare function resolveWhichCommand(name: string): string;
+/**
+ * Check whether a CLI command is available on PATH.
+ * Resolves to `true` if found, `false` otherwise.
+ */
+export declare function isCliAvailable(cliName: string): Promise<boolean>;
+/**
+ * Fire-and-forget: execute a shell command and log errors without propagating.
+ */
+export declare function execFireAndForget(command: string, logTag: string): void;
+//# sourceMappingURL=shared-utils.d.ts.map

package/dist/infrastructure/local-api/routes/shared-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-utils.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/local-api/routes/shared-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIrE,yDAAyD;AACzD,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAI9C;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAM5F;AAID;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CA6BhF;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMvE"}