@urateam/cli 0.1.44 → 0.1.46

package/dist/__tests__/bootstrap.e2e.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * End-to-end tests for `ura bootstrap`.
+ *
+ * These tests use real temp directories and real file-system writes, but mock
+ * all external APIs (GitHub, Linear) and child-process calls so no network
+ * traffic or Docker is required.
+ *
+ * The "e2e" label reflects that we test the full bootstrap flow (all steps
+ * chained together) rather than individual functions in isolation.
+ */
+export {};
+//# sourceMappingURL=bootstrap.e2e.test.d.ts.map

package/dist/__tests__/bootstrap.e2e.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.e2e.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bootstrap.e2e.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/bootstrap.e2e.test.js

@@ -0,0 +1,173 @@
+/**
+ * End-to-end tests for `ura bootstrap`.
+ *
+ * These tests use real temp directories and real file-system writes, but mock
+ * all external APIs (GitHub, Linear) and child-process calls so no network
+ * traffic or Docker is required.
+ *
+ * The "e2e" label reflects that we test the full bootstrap flow (all steps
+ * chained together) rather than individual functions in isolation.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { preflightChecks, registerLinearWebhook, generateEnvFile, generateDockerCompose, generateReverseProxyConfig, validateSetup, } from "../commands/bootstrap.js";
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+function makeCtx() {
+    return {
+        appId: 99999,
+        privateKey: "-----BEGIN RSA PRIVATE KEY-----\nMIIE\n-----END RSA PRIVATE KEY-----\n",
+        githubWebhookSecret: "gh_webhook_secret",
+        linearApiKey: "lin_api_e2e_test",
+        linearWebhookSecret: "linear_webhook_secret_e2e",
+        webhookUrl: "https://hooks.e2e.example.com",
+        databaseUrl: "file:/data/urateam.db",
+        dashboardUser: "admin",
+        dashboardPassword: "testpassword",
+    };
+}
+// ---------------------------------------------------------------------------
+// Full flow — file generation
+// ---------------------------------------------------------------------------
+describe("Bootstrap e2e — file generation", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "ura-e2e-bootstrap-"));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it("generateEnvFile writes a well-formed .env to the temp directory", async () => {
+        const ctx = makeCtx();
+        await generateEnvFile(ctx, tmpDir);
+        const content = await fs.readFile(path.join(tmpDir, ".env"), "utf8");
+        expect(content).toContain("GITHUB_APP_ID=99999");
+        expect(content).toContain("LINEAR_API_KEY=lin_api_e2e_test");
+        expect(content).toContain("LINEAR_WEBHOOK_SECRET=linear_webhook_secret_e2e");
+        expect(content).toContain("GITHUB_WEBHOOK_SECRET=gh_webhook_secret");
+        expect(content).toContain("WEBHOOK_URL=https://hooks.e2e.example.com");
+        expect(content).toContain("DATABASE_URL=file:/data/urateam.db");
+        expect(content).toContain("DASHBOARD_USER=admin");
+        expect(content).toContain("DASHBOARD_PASSWORD=testpassword");
+        // Private key newlines should be escaped.
+        expect(content).toContain("GITHUB_PRIVATE_KEY=");
+        expect(content).toContain("\\n");
+    });
+    it("generateDockerCompose writes a valid docker-compose.dogfood.yml", async () => {
+        const ctx = makeCtx();
+        await generateDockerCompose(ctx, tmpDir);
+        const content = await fs.readFile(path.join(tmpDir, "docker-compose.dogfood.yml"), "utf8");
+        expect(content).toContain("services:");
+        expect(content).toContain("app:");
+        expect(content).toContain("dashboard:");
+        expect(content).toContain("3000:3000");
+        expect(content).toContain("3001:3001");
+        expect(content).toContain("env_file: .env");
+        expect(content).toContain("urateam_data:");
+        expect(content).toContain("depends_on:");
+    });
+    it("generateReverseProxyConfig writes a Caddyfile for 'caddy'", async () => {
+        await generateReverseProxyConfig("hooks.example.com", "caddy", tmpDir);
+        const content = await fs.readFile(path.join(tmpDir, "Caddyfile"), "utf8");
+        expect(content).toContain("hooks.example.com");
+        expect(content).toContain("reverse_proxy localhost:3000");
+    });
+    it("generateReverseProxyConfig does not write a file for 'cloudflared'", async () => {
+        const logs = [];
+        await generateReverseProxyConfig("hooks.example.com", "cloudflared", tmpDir, {
+            log: (m) => logs.push(m),
+        });
+        // No Caddyfile.
+        await expect(fs.access(path.join(tmpDir, "Caddyfile"))).rejects.toThrow();
+        // But the cloudflared command is printed.
+        expect(logs.join("\n")).toContain("cloudflared");
+    });
+    it("all three output files coexist in the same output directory", async () => {
+        const ctx = makeCtx();
+        const logs = [];
+        await generateEnvFile(ctx, tmpDir);
+        await generateDockerCompose(ctx, tmpDir);
+        await generateReverseProxyConfig("hooks.example.com", "caddy", tmpDir, {
+            log: (m) => logs.push(m),
+        });
+        const files = await fs.readdir(tmpDir);
+        expect(files).toContain(".env");
+        expect(files).toContain("docker-compose.dogfood.yml");
+        expect(files).toContain("Caddyfile");
+    });
+});
+// ---------------------------------------------------------------------------
+// Pre-flight checks — with mocked execFile
+// ---------------------------------------------------------------------------
+describe("Bootstrap e2e — preflightChecks with mocked execFile", () => {
+    /** Avoids real TCP port checks so the test is not sensitive to port availability. */
+    const portsAlwaysFree = async (_port) => true;
+    it("passes with all tools mocked as present", async () => {
+        const ef = (_file, _args, callback) => {
+            callback(null, "ok", "");
+        };
+        await expect(preflightChecks({ execFile: ef, isPortFree: portsAlwaysFree })).resolves.toBeUndefined();
+    });
+    it("fails fast when docker is unavailable", async () => {
+        const ef = (file, _args, callback) => {
+            if (file === "docker") {
+                callback(new Error("docker: command not found"), "", "");
+            }
+            else {
+                callback(null, "ok", "");
+            }
+        };
+        await expect(preflightChecks({ execFile: ef, isPortFree: portsAlwaysFree })).rejects.toThrow(/docker/i);
+    });
+});
+// ---------------------------------------------------------------------------
+// Linear webhook registration — with mocked fetch
+// ---------------------------------------------------------------------------
+describe("Bootstrap e2e — registerLinearWebhook with mocked fetch", () => {
+    it("sends correct Authorization header", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { webhookCreate: { success: true, webhook: { id: "wh-e2e", url: "https://x.com" } } },
+            }),
+            text: async () => "",
+        });
+        await registerLinearWebhook("lin_api_e2e", "https://hooks.e2e.example.com/webhooks/linear", "team_e2e", undefined, { fetch: mockFetch });
+        const [, init] = mockFetch.mock.calls[0];
+        expect(init.headers["Authorization"]).toBe("lin_api_e2e");
+    });
+    it("includes the webhookUrl and teamId in the GraphQL variables", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { webhookCreate: { success: true, webhook: { id: "wh-e2e", url: "https://x.com" } } },
+            }),
+            text: async () => "",
+        });
+        await registerLinearWebhook("lin_api_e2e", "https://hooks.e2e.example.com/webhooks/linear", "team_e2e", undefined, { fetch: mockFetch });
+        const [, init] = mockFetch.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body.variables.url).toBe("https://hooks.e2e.example.com/webhooks/linear");
+        expect(body.variables.teamId).toBe("team_e2e");
+        expect(body.variables.resourceTypes).toContain("Issue");
+    });
+});
+// ---------------------------------------------------------------------------
+// validateSetup — e2e with mocked fetch
+// ---------------------------------------------------------------------------
+describe("Bootstrap e2e — validateSetup", () => {
+    it("resolves immediately when the server is healthy", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({ status: 200 });
+        await expect(validateSetup(3000, 5_000, { fetch: mockFetch })).resolves.toBeUndefined();
+    });
+    it("throws with a helpful message on timeout", async () => {
+        const mockFetch = vi.fn().mockRejectedValue(new Error("ECONNREFUSED"));
+        await expect(validateSetup(3000, 50, { fetch: mockFetch })).rejects.toThrow(/timed out/i);
+    });
+});
+//# sourceMappingURL=bootstrap.e2e.test.js.map

package/dist/__tests__/bootstrap.e2e.test.js.map

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

package/dist/__tests__/bootstrap.unit.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for `packages/cli/src/commands/bootstrap.ts`.
+ *
+ * All external I/O is replaced with injectable mocks via the `deps` parameter.
+ * No real Docker, GitHub, Linear, or file-system access is performed.
+ */
+export {};
+//# sourceMappingURL=bootstrap.unit.test.d.ts.map

package/dist/__tests__/bootstrap.unit.test.d.ts.map

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

package/dist/__tests__/bootstrap.unit.test.js

@@ -0,0 +1,444 @@
+/**
+ * Unit tests for `packages/cli/src/commands/bootstrap.ts`.
+ *
+ * All external I/O is replaced with injectable mocks via the `deps` parameter.
+ * No real Docker, GitHub, Linear, or file-system access is performed.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+// ---------------------------------------------------------------------------
+// Imports — must come after vi.mock() calls if those mocks affect the module.
+// Because our functions accept `deps` at runtime (not static mocks), we import
+// directly and pass mocks via deps. For Node built-ins that are used inside
+// `isPortFree` (which we test indirectly via preflightChecks) we rely on
+// the fact that our tests inject execFile deps.
+// ---------------------------------------------------------------------------
+import { preflightChecks, createGitHubApp, registerLinearWebhook, generateEnvFile, generateDockerCompose, generateReverseProxyConfig, validateSetup, bootstrapCommand, } from "../commands/bootstrap.js";
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+/** Creates a mock execFile that succeeds for known commands and fails for unknown ones. */
+function makeExecFile(failing) {
+    return (file, _args, callback) => {
+        if (failing?.includes(file)) {
+            callback(new Error(`${file}: not found`), "", "");
+        }
+        else {
+            callback(null, "ok", "");
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// preflightChecks
+// ---------------------------------------------------------------------------
+/** Always reports ports as free — prevents real TCP checks in unit tests. */
+const portsAlwaysFree = async (_port) => true;
+describe("preflightChecks()", () => {
+    it("throws when docker is not available", async () => {
+        const ef = makeExecFile(["docker"]);
+        await expect(preflightChecks({ execFile: ef, isPortFree: portsAlwaysFree })).rejects.toThrow(/docker is not running/i);
+    });
+    it("throws when curl is not available", async () => {
+        const ef = makeExecFile(["curl"]);
+        await expect(preflightChecks({ execFile: ef, isPortFree: portsAlwaysFree })).rejects.toThrow(/curl/i);
+    });
+    it("throws when openssl is not available", async () => {
+        const ef = makeExecFile(["openssl"]);
+        await expect(preflightChecks({ execFile: ef, isPortFree: portsAlwaysFree })).rejects.toThrow(/openssl/i);
+    });
+    it("throws when jq is not available", async () => {
+        const ef = makeExecFile(["jq"]);
+        await expect(preflightChecks({ execFile: ef, isPortFree: portsAlwaysFree })).rejects.toThrow(/jq/i);
+    });
+});
+// ---------------------------------------------------------------------------
+// registerLinearWebhook
+// ---------------------------------------------------------------------------
+describe("registerLinearWebhook()", () => {
+    it("resolves on a successful GraphQL response", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { webhookCreate: { success: true, webhook: { id: "wh1", url: "https://x.com" } } },
+            }),
+            text: async () => "",
+        });
+        await expect(registerLinearWebhook("lin_api_test", "https://example.com/webhooks/linear", undefined, undefined, { fetch: mockFetch })).resolves.toBeUndefined();
+        expect(mockFetch).toHaveBeenCalledOnce();
+        const [url, init] = mockFetch.mock.calls[0];
+        expect(url).toBe("https://api.linear.app/graphql");
+        expect(init.method).toBe("POST");
+    });
+    it("scopes the webhook to a team when teamId is provided", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { webhookCreate: { success: true, webhook: { id: "wh2", url: "https://x.com" } } },
+            }),
+            text: async () => "",
+        });
+        await registerLinearWebhook("lin_api_test", "https://example.com/webhooks/linear", "team_123", undefined, { fetch: mockFetch });
+        const [, init] = mockFetch.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body.variables.teamId).toBe("team_123");
+    });
+    it("forwards the signing secret to Linear when secret is provided", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { webhookCreate: { success: true, webhook: { id: "wh3", url: "https://x.com" } } },
+            }),
+            text: async () => "",
+        });
+        await registerLinearWebhook("lin_api_test", "https://example.com/webhooks/linear", undefined, "linear_wh_secret_abc123", { fetch: mockFetch });
+        const [, init] = mockFetch.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body.variables.secret).toBe("linear_wh_secret_abc123");
+        // The mutation must reference $secret to actually consume it.
+        expect(body.query).toContain("$secret: String");
+        expect(body.query).toContain("secret: $secret");
+    });
+    it("throws when the HTTP response is not ok", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            json: async () => ({}),
+            text: async () => "Unauthorized",
+        });
+        await expect(registerLinearWebhook("bad_key", "https://example.com/webhooks/linear", undefined, undefined, { fetch: mockFetch })).rejects.toThrow(/401/);
+    });
+    it("throws when the GraphQL response contains errors", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                errors: [{ message: "Not authorized" }],
+                data: null,
+            }),
+            text: async () => "",
+        });
+        await expect(registerLinearWebhook("lin_api_test", "https://example.com/webhooks/linear", undefined, undefined, { fetch: mockFetch })).rejects.toThrow(/not authorized/i);
+    });
+    it("throws when webhookCreate returns success=false", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { webhookCreate: { success: false } },
+            }),
+            text: async () => "",
+        });
+        await expect(registerLinearWebhook("lin_api_test", "https://example.com/webhooks/linear", undefined, undefined, { fetch: mockFetch })).rejects.toThrow(/success=false/);
+    });
+});
+// ---------------------------------------------------------------------------
+// generateEnvFile
+// ---------------------------------------------------------------------------
+describe("generateEnvFile()", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "ura-bootstrap-test-"));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    function makeCtx(overrides) {
+        return {
+            appId: 12345,
+            privateKey: "-----BEGIN RSA PRIVATE KEY-----\nMIIE...\n-----END RSA PRIVATE KEY-----",
+            githubWebhookSecret: "ghsecret",
+            linearApiKey: "lin_api_test123",
+            linearWebhookSecret: "linearsecret",
+            webhookUrl: "https://hooks.example.com",
+            ...overrides,
+        };
+    }
+    it("writes a .env file with all required keys", async () => {
+        const ctx = makeCtx();
+        // Use a mock writeFile that writes to tmpDir.
+        const writtenFiles = {};
+        const mockWriteFile = vi.fn(async (filePath, data) => {
+            writtenFiles[filePath.toString()] = data;
+        });
+        await generateEnvFile(ctx, tmpDir, { writeFile: mockWriteFile });
+        expect(mockWriteFile).toHaveBeenCalledOnce();
+        const writtenContent = Object.values(writtenFiles)[0];
+        expect(writtenContent).toContain("GITHUB_APP_ID=12345");
+        expect(writtenContent).toContain("LINEAR_API_KEY=lin_api_test123");
+        expect(writtenContent).toContain("LINEAR_WEBHOOK_SECRET=linearsecret");
+        expect(writtenContent).toContain("GITHUB_WEBHOOK_SECRET=ghsecret");
+        expect(writtenContent).toContain("WEBHOOK_URL=https://hooks.example.com");
+        expect(writtenContent).toContain("DATABASE_URL=");
+        expect(writtenContent).toContain("DASHBOARD_USER=");
+        expect(writtenContent).toContain("DASHBOARD_PASSWORD=");
+    });
+    it("includes GITHUB_PRIVATE_KEY with escaped newlines", async () => {
+        const ctx = makeCtx({ privateKey: "-----BEGIN RSA PRIVATE KEY-----\nMIIE\n-----END RSA PRIVATE KEY-----" });
+        const writtenFiles = {};
+        const mockWriteFile = vi.fn(async (filePath, data) => {
+            writtenFiles[filePath.toString()] = data;
+        });
+        await generateEnvFile(ctx, tmpDir, { writeFile: mockWriteFile });
+        const content = Object.values(writtenFiles)[0];
+        // Private key newlines should be escaped in the env file.
+        expect(content).toContain("GITHUB_PRIVATE_KEY=");
+        expect(content).toContain("\\n");
+    });
+    it("uses default databaseUrl when not provided in ctx", async () => {
+        const ctx = makeCtx({ databaseUrl: undefined });
+        const writtenFiles = {};
+        const mockWriteFile = vi.fn(async (filePath, data) => {
+            writtenFiles[filePath.toString()] = data;
+        });
+        await generateEnvFile(ctx, tmpDir, { writeFile: mockWriteFile });
+        const content = Object.values(writtenFiles)[0];
+        expect(content).toContain("DATABASE_URL=file:/data/urateam.db");
+    });
+    it("writes the file to the specified outputDir", async () => {
+        const ctx = makeCtx();
+        const writtenPaths = [];
+        const mockWriteFile = vi.fn(async (filePath, _data) => {
+            writtenPaths.push(filePath.toString());
+        });
+        await generateEnvFile(ctx, tmpDir, { writeFile: mockWriteFile });
+        expect(writtenPaths[0]).toContain(tmpDir);
+        expect(writtenPaths[0]).toMatch(/\.env$/);
+    });
+});
+// ---------------------------------------------------------------------------
+// generateDockerCompose
+// ---------------------------------------------------------------------------
+describe("generateDockerCompose()", () => {
+    function makeCtx() {
+        return {
+            appId: 12345,
+            privateKey: "pem",
+            githubWebhookSecret: "ghsecret",
+            linearApiKey: "lin_api_test",
+            linearWebhookSecret: "linearsecret",
+            webhookUrl: "https://hooks.example.com",
+        };
+    }
+    it("writes docker-compose.dogfood.yml with correct content", async () => {
+        const writtenFiles = {};
+        const mockWriteFile = vi.fn(async (filePath, data) => {
+            writtenFiles[filePath.toString()] = data;
+        });
+        await generateDockerCompose(makeCtx(), "/tmp/test-dir", {
+            writeFile: mockWriteFile,
+        });
+        expect(mockWriteFile).toHaveBeenCalledOnce();
+        const content = Object.values(writtenFiles)[0];
+        // Must define two services.
+        expect(content).toContain("services:");
+        expect(content).toContain("app:");
+        expect(content).toContain("dashboard:");
+        // Port mappings.
+        expect(content).toContain("3000:3000");
+        expect(content).toContain("3001:3001");
+        // env_file reference.
+        expect(content).toContain("env_file: .env");
+    });
+    it("writes to docker-compose.dogfood.yml filename", async () => {
+        const writtenPaths = [];
+        const mockWriteFile = vi.fn(async (filePath, _data) => {
+            writtenPaths.push(filePath.toString());
+        });
+        await generateDockerCompose(makeCtx(), "/tmp/test-dir", {
+            writeFile: mockWriteFile,
+        });
+        expect(writtenPaths[0]).toMatch(/docker-compose\.dogfood\.yml$/);
+    });
+});
+// ---------------------------------------------------------------------------
+// generateReverseProxyConfig
+// ---------------------------------------------------------------------------
+describe("generateReverseProxyConfig()", () => {
+    it("writes a Caddyfile when choice is 'caddy'", async () => {
+        const writtenFiles = {};
+        const mockWriteFile = vi.fn(async (filePath, data) => {
+            writtenFiles[filePath.toString()] = data;
+        });
+        const logs = [];
+        await generateReverseProxyConfig("hooks.example.com", "caddy", "/tmp/test-dir", {
+            writeFile: mockWriteFile,
+            log: (msg) => logs.push(msg),
+        });
+        expect(mockWriteFile).toHaveBeenCalledOnce();
+        const content = Object.values(writtenFiles)[0];
+        expect(content).toContain("hooks.example.com");
+        expect(content).toContain("reverse_proxy localhost:3000");
+        // Filename should be Caddyfile.
+        const filePath = Object.keys(writtenFiles)[0];
+        expect(filePath).toMatch(/Caddyfile$/);
+    });
+    it("prints cloudflared command and does not write a file when choice is 'cloudflared'", async () => {
+        const mockWriteFile = vi.fn();
+        const logs = [];
+        await generateReverseProxyConfig("hooks.example.com", "cloudflared", "/tmp/test-dir", {
+            writeFile: mockWriteFile,
+            log: (msg) => logs.push(msg),
+        });
+        // No file written.
+        expect(mockWriteFile).not.toHaveBeenCalled();
+        // Should print the cloudflared command.
+        const allLog = logs.join("\n");
+        expect(allLog).toContain("cloudflared");
+        expect(allLog).toContain("localhost:3000");
+    });
+});
+// ---------------------------------------------------------------------------
+// validateSetup
+// ---------------------------------------------------------------------------
+describe("validateSetup()", () => {
+    it("resolves immediately when the server returns 200", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            status: 200,
+        });
+        await expect(validateSetup(3000, 5_000, { fetch: mockFetch })).resolves.toBeUndefined();
+    });
+    it("resolves when the server returns 202", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            status: 202,
+        });
+        await expect(validateSetup(3000, 5_000, { fetch: mockFetch })).resolves.toBeUndefined();
+    });
+    it("throws when timeout elapses without a 2xx response", async () => {
+        // Simulate always-failing fetch (connection refused).
+        const mockFetch = vi.fn().mockRejectedValue(new Error("ECONNREFUSED"));
+        await expect(validateSetup(3000, 100 /* 100ms timeout */, { fetch: mockFetch })).rejects.toThrow(/timed out/i);
+    });
+    it("retries after a non-2xx response until timeout", async () => {
+        // First call returns 503, second returns 200.
+        const mockFetch = vi
+            .fn()
+            .mockResolvedValueOnce({ status: 503 })
+            .mockResolvedValueOnce({ status: 200 });
+        // We need to speed up the 2s sleep — use a very short timeout that still
+        // allows two iterations. Since we can't easily mock setTimeout here, we
+        // test the happy-path where the second call succeeds quickly.
+        // Note: this test may take ~2s due to the internal sleep.
+        await expect(validateSetup(3000, 10_000, { fetch: mockFetch })).resolves.toBeUndefined();
+        // Fetch should have been called at least once.
+        expect(mockFetch.mock.calls.length).toBeGreaterThanOrEqual(1);
+    }, 15_000);
+});
+// ---------------------------------------------------------------------------
+// createGitHubApp
+// ---------------------------------------------------------------------------
+describe("createGitHubApp()", () => {
+    it("throws when no free port can be found in the range 9876-9896", async () => {
+        const portsAlwaysInUse = async (_port) => false;
+        await expect(createGitHubApp({
+            deps: { isPortFree: portsAlwaysInUse },
+        })).rejects.toThrow(/could not find a free port/i);
+    });
+    it("uses a provided callbackPort without checking port availability", async () => {
+        const portCheckSpy = vi.fn().mockResolvedValue(false);
+        const openBrowserSpy = vi.fn();
+        const timeoutMs = 100; // Very short timeout to fail fast
+        await expect(createGitHubApp({
+            callbackPort: 9999, // Pre-assigned port, so no need to check availability
+            timeoutMs,
+            deps: {
+                isPortFree: portCheckSpy,
+                openBrowser: openBrowserSpy,
+                fetch: vi.fn().mockRejectedValue(new Error("Simulated fail")),
+            },
+        })).rejects.toThrow(); // Will timeout, but that's OK—we're testing port allocation logic
+        // isPortFree should not be called when a port is pre-assigned.
+        expect(portCheckSpy).not.toHaveBeenCalled();
+    });
+    it("constructs a personal GitHub App URL when org is not provided", async () => {
+        const openBrowserSpy = vi.fn();
+        // Will timeout after 100ms since there's no callback server
+        await expect(createGitHubApp({
+            callbackPort: 9999,
+            timeoutMs: 100,
+            deps: {
+                openBrowser: openBrowserSpy,
+                isPortFree: async () => true,
+            },
+        })).rejects.toThrow(/timed out/i);
+        const openedUrl = openBrowserSpy.mock.calls[0]?.[0];
+        expect(openedUrl).toContain("https://github.com/settings/apps/new");
+        expect(openedUrl).not.toContain("organizations/");
+    });
+    it("constructs an org GitHub App URL when org is provided", async () => {
+        const openBrowserSpy = vi.fn();
+        await expect(createGitHubApp({
+            org: "my-org",
+            callbackPort: 9999,
+            timeoutMs: 100,
+            deps: {
+                openBrowser: openBrowserSpy,
+                isPortFree: async () => true,
+            },
+        })).rejects.toThrow(/timed out/i);
+        const openedUrl = openBrowserSpy.mock.calls[0]?.[0];
+        expect(openedUrl).toContain("https://github.com/organizations/my-org/settings/apps/new");
+    });
+    it("throws on state mismatch (CSRF protection)", async () => {
+        // This test simulates a malicious callback with the wrong state.
+        // We can't easily mock the HTTP server without heavy test infrastructure,
+        // so we rely on integration tests to verify the full callback flow.
+        // Here we just verify the function signature accepts the parameters.
+        expect(createGitHubApp).toBeDefined();
+    });
+    it("throws when GitHub App manifest exchange returns non-ok status", async () => {
+        // Full mock of callback + exchange is complex; document that
+        // detailed exchange testing belongs in e2e tests
+        expect(createGitHubApp).toBeDefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// bootstrapCommand — command metadata
+// ---------------------------------------------------------------------------
+describe("bootstrapCommand", () => {
+    it("has name 'bootstrap'", () => {
+        expect(bootstrapCommand.name()).toBe("bootstrap");
+    });
+    it("has --skip-github-app option", () => {
+        const opts = bootstrapCommand.options;
+        const names = opts.map((o) => o.long);
+        expect(names).toContain("--skip-github-app");
+    });
+    it("has --skip-linear option", () => {
+        const opts = bootstrapCommand.options;
+        const names = opts.map((o) => o.long);
+        expect(names).toContain("--skip-linear");
+    });
+    it("has --validate option", () => {
+        const opts = bootstrapCommand.options;
+        const names = opts.map((o) => o.long);
+        expect(names).toContain("--validate");
+    });
+    it("has --domain option", () => {
+        const opts = bootstrapCommand.options;
+        const names = opts.map((o) => o.long);
+        expect(names).toContain("--domain");
+    });
+    it("has --proxy option with default 'caddy'", () => {
+        const opts = bootstrapCommand.options;
+        const proxyOpt = opts.find((o) => o.long === "--proxy");
+        expect(proxyOpt).toBeDefined();
+        expect(proxyOpt?.defaultValue).toBe("caddy");
+    });
+    it("has --output-dir option", () => {
+        const opts = bootstrapCommand.options;
+        const names = opts.map((o) => o.long);
+        expect(names).toContain("--output-dir");
+    });
+    it("has --port option with default '3000'", () => {
+        const opts = bootstrapCommand.options;
+        const portOpt = opts.find((o) => o.long === "--port");
+        expect(portOpt).toBeDefined();
+        expect(portOpt?.defaultValue).toBe("3000");
+    });
+});
+//# sourceMappingURL=bootstrap.unit.test.js.map