@aion0/forge 0.5.37 → 0.5.40

package/RELEASE_NOTES.md

@@ -1,11 +1,12 @@
-# Forge v0.5.37
+# Forge v0.5.40
 
-Released: 2026-04-11
+Released: 2026-04-14
 
-## Changes since v0.5.36
+## Changes since v0.5.38
 
-### Performance
-- perf: prune bus log to prevent unbounded growth
+### Other
+- v0.5.39
+- add option to disable claude modification
 
 
-**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.5.36...v0.5.37
+**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.5.38...v0.5.40

package/components/WebTerminal.tsx

@@ -1446,6 +1446,8 @@ const MemoTerminalPane = memo(function TerminalPane({
     const MAX_CREATE_RETRIES = 2;
     let reconnectAttempts = 0;
     let isNewlyCreated = false;
+    let lastActivityTime = Date.now();
+    let staleCheckTimer = 0;
 
     function connect() {
       if (disposed) return;
@@ -1455,6 +1457,7 @@ const MemoTerminalPane = memo(function TerminalPane({
       socket.onopen = () => {
         if (disposed) { socket.close(); return; }
         if (socket.readyState !== WebSocket.OPEN) return;
+        lastActivityTime = Date.now();
         const cols = term.cols;
         const rows = term.rows;
 
@@ -1477,6 +1480,7 @@ const MemoTerminalPane = memo(function TerminalPane({
 
       ws.onmessage = (event) => {
         if (disposed || !initDone) return;
+        lastActivityTime = Date.now();
         try {
           const msg = JSON.parse(event.data);
           if (msg.type === 'output') {
@@ -1573,6 +1577,36 @@ const MemoTerminalPane = memo(function TerminalPane({
       };
     }
 
+    // Stale detection: WebSocket may appear "open" after Mac sleep but have no traffic.
+    // If no activity for 60s, force-close and reconnect.
+    staleCheckTimer = window.setInterval(() => {
+      if (disposed) return;
+      if (ws?.readyState === WebSocket.OPEN && Date.now() - lastActivityTime > 60000) {
+        console.warn('[ws] terminal stream stalled, forcing reconnect');
+        lastActivityTime = Date.now();
+        try { ws.close(); } catch {}
+      }
+    }, 20000);
+
+    // Detect tab wake from sleep — only triggers when tab was actually hidden.
+    // Conservative: needs > 60s of inactivity to force reconnect.
+    const onVisibilityChange = () => {
+      if (disposed) return;
+      if (document.visibilityState === 'visible' && Date.now() - lastActivityTime > 60000) {
+        console.log('[ws] terminal visible after long idle, forcing reconnect');
+        lastActivityTime = Date.now();
+        try { ws?.close(); } catch {}
+      }
+    };
+    const onOnline = () => {
+      if (disposed) return;
+      console.log('[ws] network online, reconnecting terminal');
+      lastActivityTime = Date.now();
+      try { ws?.close(); } catch {}
+    };
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    window.addEventListener('online', onOnline);
+
     // NOTE: connect() is called inside initTerminal() — do NOT call it here.
     // Calling it both here and in initTerminal() causes duplicate WebSocket
     // connections to the same tmux session, resulting in doubled output.
@@ -1683,6 +1717,9 @@ const MemoTerminalPane = memo(function TerminalPane({
       visObserver.disconnect();
       clearTimeout(resizeTimer);
       clearTimeout(reconnectTimer);
+      if (staleCheckTimer) clearInterval(staleCheckTimer);
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+      window.removeEventListener('online', onOnline);
       window.removeEventListener('terminal-drag-end', onDragEnd);
       resizeObserver.disconnect();
       // Strict Mode cleanup: if disposed within 2s of mount and we created a

package/components/WorkspaceView.tsx

@@ -280,9 +280,83 @@ function useWorkspaceStream(workspaceId: string | null, onEvent?: (event: any) =
   useEffect(() => {
     if (!workspaceId) return;
 
-    const es = new EventSource(`/api/workspace/${workspaceId}/stream`);
+    // Reconnection state — survives sleep/wake and network drops
+    let es: EventSource | null = null;
+    let reconnectTimer: ReturnType<typeof setTimeout> | null = null;
+    let staleCheckTimer: ReturnType<typeof setInterval> | null = null;
+    let reconnectAttempts = 0;
+    let lastEventTime = Date.now();
+    let disposed = false;
+
+    const scheduleReconnect = () => {
+      if (disposed) return;
+      if (reconnectTimer) return;
+      // Exponential backoff: 2s, 4s, 8s, max 30s
+      const delay = Math.min(30000, 2000 * Math.pow(2, reconnectAttempts));
+      reconnectAttempts++;
+      console.log(`[sse] reconnecting in ${delay / 1000}s (attempt ${reconnectAttempts})`);
+      reconnectTimer = setTimeout(() => {
+        reconnectTimer = null;
+        connect();
+      }, delay);
+    };
+
+    const connect = () => {
+      if (disposed) return;
+      try { es?.close(); } catch {}
+      lastEventTime = Date.now();
+      es = new EventSource(`/api/workspace/${workspaceId}/stream`);
+
+      es.onopen = () => {
+        reconnectAttempts = 0;
+        lastEventTime = Date.now();
+      };
+
+      es.onerror = () => {
+        // Browser fires onerror when the connection drops
+        console.warn('[sse] EventSource error — will reconnect');
+        try { es?.close(); } catch {}
+        scheduleReconnect();
+      };
+
+      es.onmessage = (e) => {
+        lastEventTime = Date.now();
+        handleEvent(e);
+      };
+    };
+
+    // Stall detection: if we haven't received any event (including heartbeat ping from server)
+    // for 45s, the connection is stuck (common after Mac sleep). Force reconnect.
+    staleCheckTimer = setInterval(() => {
+      if (disposed) return;
+      if (Date.now() - lastEventTime > 45000) {
+        console.warn('[sse] stream stalled (no events for 45s), forcing reconnect');
+        try { es?.close(); } catch {}
+        lastEventTime = Date.now(); // prevent immediate re-trigger
+        connect();
+      }
+    }, 15000);
+
+    // Detect tab wake from sleep / network recovery — conservative to avoid churn
+    const onVisibilityChange = () => {
+      if (disposed) return;
+      if (document.visibilityState === 'visible' && Date.now() - lastEventTime > 60000) {
+        console.log('[sse] page visible after long idle, reconnecting');
+        try { es?.close(); } catch {}
+        connect();
+      }
+    };
+    const onOnline = () => {
+      if (disposed) return;
+      console.log('[sse] network online, reconnecting');
+      try { es?.close(); } catch {}
+      lastEventTime = Date.now();
+      connect();
+    };
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    window.addEventListener('online', onOnline);
 
-    es.onmessage = (e) => {
+    const handleEvent = (e: MessageEvent) => {
       try {
         const event = JSON.parse(e.data);
 
@@ -408,7 +482,17 @@ function useWorkspaceStream(workspaceId: string | null, onEvent?: (event: any) =
       } catch {}
     };
 
-    return () => es.close();
+    // Start the initial connection
+    connect();
+
+    return () => {
+      disposed = true;
+      if (reconnectTimer) clearTimeout(reconnectTimer);
+      if (staleCheckTimer) clearInterval(staleCheckTimer);
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+      window.removeEventListener('online', onOnline);
+      try { es?.close(); } catch {}
+    };
   }, [workspaceId]);
 
   return { agents, states, logPreview, busLog, setAgents, daemonActive, setDaemonActive };

package/lib/help-docs/01-settings.md

@@ -23,6 +23,7 @@ Settings are stored in `~/.forge/data/settings.yaml`. Configure via the web UI (
 | `telegramAgent` | string | `""` | Agent for Telegram task execution |
 | `docsAgent` | string | `""` | Agent for documentation queries |
 | `skipPermissions` | boolean | `false` | Add `--dangerously-skip-permissions` to claude invocations |
+| `manageClaudeConfig` | boolean | `true` | When `false`, Forge will not modify `~/.claude/` or project `.claude/` files (skills, Stop hook, permissions, profile env/model) |
 | `notificationRetentionDays` | number | `30` | Auto-cleanup notifications older than N days |
 | `skillsRepoUrl` | string | forge-skills URL | GitHub raw URL for skills registry |
 | `displayName` | string | `"Forge"` | Display name shown in header |

package/lib/settings.ts

@@ -47,6 +47,7 @@ export interface Settings {
   pipelineModel: string;
   telegramModel: string;
   skipPermissions: boolean;
+  manageClaudeConfig: boolean;
   notificationRetentionDays: number;
   skillsRepoUrl: string;
   displayName: string;
@@ -74,6 +75,7 @@ const defaults: Settings = {
   pipelineModel: 'default',
   telegramModel: 'sonnet',
   skipPermissions: false,
+  manageClaudeConfig: true,
   notificationRetentionDays: 30,
   skillsRepoUrl: 'https://raw.githubusercontent.com/aiwatching/forge-skills/main',
   displayName: 'Forge',

package/lib/workspace/skill-installer.ts

@@ -7,6 +7,7 @@ import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
+import { loadSettings } from '../settings';
 
 const _filename = typeof __filename !== 'undefined' ? __filename : fileURLToPath(import.meta.url);
 const _dirname = typeof __dirname !== 'undefined' ? __dirname : dirname(_filename);
@@ -23,6 +24,7 @@ export function installForgeSkills(
   agentId: string,
   forgePort = 8403,
 ): { installed: string[] } {
+  if (!loadSettings().manageClaudeConfig) return { installed: [] };
   const skillsDir = join(homedir(), '.claude', 'skills');
   mkdirSync(skillsDir, { recursive: true });
 
@@ -126,6 +128,7 @@ export function applyProfileToProject(
   profile: { env?: Record<string, string>; model?: string },
 ): void {
   if (!profile.env && !profile.model) return;
+  if (!loadSettings().manageClaudeConfig) return;
 
   const settingsFile = join(projectPath, '.claude', 'settings.json');
   try {

package/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aion0/forge",
-  "version": "0.5.37",
+  "version": "0.5.40",
   "description": "Unified AI workflow platform — multi-model task orchestration, persistent sessions, web terminal, remote access",
   "type": "module",
   "scripts": {