feat: make terminals persistent and serializable (#156)

Author: jonathanlab

apps/array/package.json

@@ -21,7 +21,8 @@
     "typecheck": "tsc -p tsconfig.node.json --noEmit && tsc -p tsconfig.web.json --noEmit",
     "generate-client": "tsx scripts/update-openapi-client.ts",
     "knip": "knip",
-    "test": "vitest run"
+    "test": "vitest run",
+    "postinstall": "cd ../.. && npx @electron/rebuild -f -m node_modules/node-pty || true"
   },
   "keywords": [
     "posthog",
@@ -39,6 +40,7 @@
     "@electron-forge/plugin-vite": "^7.10.2",
     "@electron-forge/publisher-github": "^7.10.2",
     "@electron-forge/shared-types": "^7.10.2",
+    "@electron/rebuild": "^4.0.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
@@ -87,6 +89,7 @@
     "@tiptap/starter-kit": "^3.11.0",
     "@tiptap/suggestion": "^3.11.0",
     "@xterm/addon-fit": "^0.10.0",
+    "@xterm/addon-serialize": "^0.13.0",
     "@xterm/addon-web-links": "^0.11.0",
     "@xterm/xterm": "^5.5.0",
     "ai": "^5.0.75",

apps/array/src/main/preload.ts

@@ -240,6 +240,8 @@ contextBridge.exposeInMainWorld("electronAPI", {
     ipcRenderer.invoke("shell:write", sessionId, data),
   shellResize: (sessionId: string, cols: number, rows: number): Promise<void> =>
     ipcRenderer.invoke("shell:resize", sessionId, cols, rows),
+  shellCheck: (sessionId: string): Promise<boolean> =>
+    ipcRenderer.invoke("shell:check", sessionId),
   shellDestroy: (sessionId: string): Promise<void> =>
     ipcRenderer.invoke("shell:destroy", sessionId),
   onShellData: (

apps/array/src/main/services/shell.ts

@@ -30,11 +30,9 @@ export function registerShellIpc(): void {
       cwd?: string,
     ): Promise<void> => {
       try {
-        // Clean up existing session if any
         const existing = sessions.get(sessionId);
         if (existing) {
-          existing.pty.kill();
-          sessions.delete(sessionId);
+          return;
         }
 
         const shell = getDefaultShell();
@@ -67,6 +65,11 @@ export function registerShellIpc(): void {
           env.LC_MONETARY = locale;
         }
 
+        env.TERM_PROGRAM = "Array";
+        env.TERM_PROGRAM_VERSION = "0.4.0";
+        env.COLORTERM = "truecolor";
+        env.FORCE_COLOR = "3"; // truecolor
+
         // Spawn as login shell to properly load PATH and environment
         const shellArgs = ["-l"];
 
@@ -139,6 +142,14 @@ export function registerShellIpc(): void {
     },
   );
 
+  // Check if shell session exists
+  ipcMain.handle(
+    "shell:check",
+    async (_event: IpcMainInvokeEvent, sessionId: string): Promise<boolean> => {
+      return sessions.has(sessionId);
+    },
+  );
+
   // Destroy shell session
   ipcMain.handle(
     "shell:destroy",

apps/array/src/renderer/features/task-detail/components/TaskShellPanel.tsx

@@ -13,7 +13,7 @@ export function TaskShellPanel({ taskId, task }: TaskShellPanelProps) {
 
   return (
     <Box height="100%">
-      <ShellTerminal cwd={taskData.repoPath || undefined} />
+      <ShellTerminal cwd={taskData.repoPath || undefined} stateKey={taskId} />
     </Box>
   );
 }