feat: Commit, Push and Create PR actions

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});

apps/desktop/src/main.ts

@@ -5,14 +5,15 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 
-import { app, BrowserWindow, dialog, ipcMain, Menu } from "electron";
+import { app, BrowserWindow, dialog, ipcMain, Menu, shell } from "electron";
 
 import { fixPath } from "./fixPath";
 
 fixPath();
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const ROOT_DIR = path.resolve(__dirname, "../../..");
 const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.mjs");
 const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");
@@ -159,6 +160,31 @@ function registerIpcHandlers(): void {
  });
  });
  });
+
+ ipcMain.removeHandler(OPEN_EXTERNAL_CHANNEL);
+ ipcMain.handle(OPEN_EXTERNAL_CHANNEL, async (_event, rawUrl: unknown) => {
+ if (typeof rawUrl !== "string" || rawUrl.length === 0) {
+ return false;
+ }
+
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(rawUrl);
+ } catch {
+ return false;
+ }
+
+ if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+ return false;
+ }
+
+ try {
+ await shell.openExternal(parsedUrl.toString());
+ return true;
+ } catch {
+ return false;
+ }
+ });
 }
 
 function createWindow(): BrowserWindow {

apps/desktop/src/preload.ts

@@ -2,11 +2,13 @@ import { contextBridge, ipcRenderer } from "electron";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONTEXT_MENU_CHANNEL = "desktop:context-menu";
+const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
  getWsUrl: () => wsUrl,
  pickFolder: () => ipcRenderer.invoke(PICK_FOLDER_CHANNEL) as Promise<string | null>,
  showContextMenu: (items: { id: string; label: string }[]) =>
  ipcRenderer.invoke(CONTEXT_MENU_CHANNEL, items) as Promise<string | null>,
+ openExternal: (url: string) => ipcRenderer.invoke(OPEN_EXTERNAL_CHANNEL, url) as Promise<boolean>,
 });

apps/server/src/codexTextGenerator.test.ts

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+
+import { describe, expect, it } from "vitest";
+
+import { CodexTextGenerator } from "./codexTextGenerator";
+import type { ProcessRunOptions, ProcessRunResult } from "./processRunner";
+
+type ProcessRunner = (
+ command: string,
+ args: readonly string[],
+ options?: ProcessRunOptions,
+) => Promise<ProcessRunResult>;
+
+function getArgValue(args: readonly string[], flag: string): string {
+ const index = args.indexOf(flag);
+ if (index < 0 || index + 1 >= args.length) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ const value = args[index + 1];
+ if (!value) {
+ throw new Error(`Missing argument value for ${flag}`);
+ }
+ return value;
+}
+
+function okResult(): ProcessRunResult {
+ return {
+ stdout: "",
+ stderr: "",
+ code: 0,
+ signal: null,
+ timedOut: false,
+ };
+}
+
+function commitInput() {
+ return {
+ cwd: process.cwd(),
+ branch: "feat/example",
+ stagedSummary: "M apps/server/src/gitManager.ts",
+ stagedPatch: "diff --git a/file b/file",
+ };
+}
+
+describe("CodexTextGenerator", () => {
+ it("uses gpt-5.3-codex-spark when available with medium reasoning effort", async () => {
+ const models: string[] = [];
+ const configs: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+ configs.push(getArgValue(args, "--config"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ subject: "Add stacked git actions menu behavior",
+ body: "- Keep menu actions visible\n- Improve disabled states",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generateCommitMessage(commitInput());
+
+ expect(result.subject).toBe("Add stacked git actions menu behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ expect(configs).toEqual(['model_reasoning_effort="medium"']);
+ });
+
+ it("uses gpt-5.3-codex-spark for PR content generation", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (command, args) => {
+ expect(command).toBe("codex");
+ models.push(getArgValue(args, "--model"));
+
+ const outputPath = getArgValue(args, "--output-last-message");
+ await fs.writeFile(
+ outputPath,
+ JSON.stringify({
+ title: "Improve Git action modal behavior",
+ body: "## Summary\n- Update PR generation model\n\n## Testing\n- Not run",
+ }),
+ "utf8",
+ );
+ return okResult();
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+ const result = await generator.generatePrContent({
+ cwd: process.cwd(),
+ baseBranch: "main",
+ headBranch: "feat/example",
+ commitSummary: "abc123 Update model",
+ diffSummary: "1 file changed",
+ diffPatch: "diff --git a/file b/file",
+ });
+
+ expect(result.title).toBe("Improve Git action modal behavior");
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+
+ it("propagates generation failures without retrying a second model", async () => {
+ const models: string[] = [];
+
+ const runner: ProcessRunner = async (_command, args) => {
+ models.push(getArgValue(args, "--model"));
+ throw new Error("Request timed out while contacting Codex.");
+ };
+
+ const generator = new CodexTextGenerator({ runProcess: runner });
+
+ await expect(generator.generateCommitMessage(commitInput())).rejects.toThrow(
+ "Request timed out while contacting Codex.",
+ );
+ expect(models).toEqual(["gpt-5.3-codex-spark"]);
+ });
+});