@aion0/forge 0.3.5 → 0.3.7

package/CLAUDE.md

@@ -47,6 +47,21 @@ forge watch <id>         # live stream task output
 - npm package: `@aion0/forge`
 - GitHub: `github.com/aiwatching/forge`
 
+### Help Docs Rule
+When adding or changing a feature, check if `lib/help-docs/` needs updating. Each file covers one module:
+- `00-overview.md` — install, start, data paths
+- `01-settings.md` — all settings fields
+- `02-telegram.md` — bot setup and commands
+- `03-tunnel.md` — remote access
+- `04-tasks.md` — background tasks
+- `05-pipelines.md` — DAG workflows
+- `06-skills.md` — marketplace
+- `07-projects.md` — project management
+- `08-rules.md` — CLAUDE.md templates
+- `09-issue-autofix.md` — GitHub issue scanner
+- `10-troubleshooting.md` — common issues
+If a feature change affects user-facing behavior, update the corresponding help doc in the same commit.
+
 ### Architecture
 - `forge-server.mjs` starts: Next.js + terminal-standalone + telegram-standalone
 - `pnpm dev` / `start.sh dev` starts: Next.js (init.ts spawns terminal + telegram)

package/app/api/help/route.ts

@@ -0,0 +1,78 @@
+import { NextResponse } from 'next/server';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfigDir } from '@/lib/dirs';
+import { loadSettings } from '@/lib/settings';
+import { execSync } from 'node:child_process';
+
+const HELP_DIR = join(getConfigDir(), 'help');
+const SOURCE_HELP_DIR = join(process.cwd(), 'lib', 'help-docs');
+
+/** Ensure help docs are copied to ~/.forge/help/ */
+function ensureHelpDocs() {
+  if (!existsSync(HELP_DIR)) mkdirSync(HELP_DIR, { recursive: true });
+  if (existsSync(SOURCE_HELP_DIR)) {
+    for (const file of readdirSync(SOURCE_HELP_DIR)) {
+      if (!file.endsWith('.md')) continue;
+      const src = join(SOURCE_HELP_DIR, file);
+      const dest = join(HELP_DIR, file);
+      // Always overwrite to keep docs up to date
+      writeFileSync(dest, readFileSync(src));
+    }
+  }
+}
+
+/** Check if any agent CLI is available */
+function detectAgent(): { name: string; path: string } | null {
+  const settings = loadSettings();
+  if (settings.claudePath) {
+    try {
+      execSync(`"${settings.claudePath}" --version`, { timeout: 5000, stdio: 'pipe' });
+      return { name: 'claude', path: settings.claudePath };
+    } catch {}
+  }
+  for (const agent of ['claude', 'codex', 'aider']) {
+    try {
+      const path = execSync(`which ${agent}`, { encoding: 'utf-8', timeout: 3000, stdio: 'pipe' }).trim();
+      if (path) return { name: agent, path };
+    } catch {}
+  }
+  return null;
+}
+
+// GET /api/help
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url);
+  const action = searchParams.get('action') || 'status';
+
+  if (action === 'status') {
+    const agent = detectAgent();
+    ensureHelpDocs();
+    const docs = existsSync(HELP_DIR)
+      ? readdirSync(HELP_DIR).filter(f => f.endsWith('.md')).sort()
+      : [];
+    return NextResponse.json({ agent, docsCount: docs.length, helpDir: HELP_DIR });
+  }
+
+  if (action === 'docs') {
+    ensureHelpDocs();
+    const docs = existsSync(HELP_DIR)
+      ? readdirSync(HELP_DIR).filter(f => f.endsWith('.md')).sort().map(f => ({
+          name: f,
+          title: f.replace(/^\d+-/, '').replace(/\.md$/, '').replace(/-/g, ' '),
+        }))
+      : [];
+    return NextResponse.json({ docs });
+  }
+
+  if (action === 'doc') {
+    const name = searchParams.get('name');
+    if (!name) return NextResponse.json({ error: 'name required' }, { status: 400 });
+    ensureHelpDocs();
+    const file = join(HELP_DIR, name);
+    if (!existsSync(file)) return NextResponse.json({ error: 'Not found' }, { status: 404 });
+    return NextResponse.json({ content: readFileSync(file, 'utf-8') });
+  }
+
+  return NextResponse.json({ error: 'Invalid action' }, { status: 400 });
+}

package/app/api/logs/route.ts

@@ -0,0 +1,100 @@
+import { NextResponse } from 'next/server';
+import { existsSync, statSync, openSync, readSync, closeSync, writeFileSync, renameSync } from 'node:fs';
+import { join } from 'node:path';
+import { getDataDir } from '@/lib/dirs';
+import { execSync } from 'node:child_process';
+
+const LOG_FILE = join(getDataDir(), 'forge.log');
+const MAX_LOG_SIZE = 5 * 1024 * 1024; // 5MB — auto-rotate above this
+
+/** Read last N bytes from file (efficient tail) */
+function tailFile(filePath: string, maxBytes: number): string {
+  const stat = statSync(filePath);
+  const size = stat.size;
+  const readSize = Math.min(size, maxBytes);
+  const buf = Buffer.alloc(readSize);
+  const fd = openSync(filePath, 'r');
+  readSync(fd, buf, 0, readSize, size - readSize);
+  closeSync(fd);
+  // Skip partial first line
+  const str = buf.toString('utf-8');
+  const firstNewline = str.indexOf('\n');
+  return firstNewline > 0 ? str.slice(firstNewline + 1) : str;
+}
+
+/** Rotate log if too large: forge.log → forge.log.old, start fresh */
+function rotateIfNeeded() {
+  if (!existsSync(LOG_FILE)) return;
+  const stat = statSync(LOG_FILE);
+  if (stat.size > MAX_LOG_SIZE) {
+    const oldFile = LOG_FILE + '.old';
+    try { renameSync(LOG_FILE, oldFile); } catch {}
+    writeFileSync(LOG_FILE, `[forge] Log rotated at ${new Date().toISOString()} (previous: ${(stat.size / 1024 / 1024).toFixed(1)}MB)\n`, 'utf-8');
+  }
+}
+
+// GET /api/logs?lines=200&search=keyword
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url);
+  const lines = Math.min(parseInt(searchParams.get('lines') || '200'), 1000);
+  const search = searchParams.get('search') || '';
+
+  rotateIfNeeded();
+
+  if (!existsSync(LOG_FILE)) {
+    return NextResponse.json({ lines: [], total: 0, size: 0 });
+  }
+
+  try {
+    const stat = statSync(LOG_FILE);
+    // Read last 512KB max (enough for ~5000 lines)
+    const raw = tailFile(LOG_FILE, 512 * 1024);
+    let allLines = raw.split('\n').filter(Boolean);
+
+    if (search) {
+      allLines = allLines.filter(l => l.toLowerCase().includes(search.toLowerCase()));
+    }
+
+    const result = allLines.slice(-lines);
+
+    return NextResponse.json({
+      lines: result,
+      total: allLines.length,
+      size: stat.size,
+      file: LOG_FILE,
+    });
+  } catch (e: any) {
+    return NextResponse.json({ error: e.message }, { status: 500 });
+  }
+}
+
+// POST /api/logs — actions
+export async function POST(req: Request) {
+  const body = await req.json();
+
+  if (body.action === 'clear') {
+    try {
+      writeFileSync(LOG_FILE, `[forge] Log cleared at ${new Date().toISOString()}\n`, 'utf-8');
+      return NextResponse.json({ ok: true });
+    } catch (e: any) {
+      return NextResponse.json({ error: e.message }, { status: 500 });
+    }
+  }
+
+  if (body.action === 'processes') {
+    try {
+      const out = execSync("ps aux | grep -E 'next-server|telegram-standalone|terminal-standalone|cloudflared' | grep -v grep", {
+        encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+      }).trim();
+      const processes = out.split('\n').filter(Boolean).map(line => {
+        const parts = line.trim().split(/\s+/);
+        return { pid: parts[1], cpu: parts[2], mem: parts[3], cmd: parts.slice(10).join(' ').slice(0, 80) };
+      });
+      return NextResponse.json({ processes });
+    } catch {
+      return NextResponse.json({ processes: [] });
+    }
+  }
+
+  return NextResponse.json({ error: 'Invalid action' }, { status: 400 });
+}

package/app/api/settings/route.ts

@@ -56,6 +56,8 @@ export async function PUT(req: Request) {
   // Remove internal fields
   delete (updated as any)._secretStatus;
 
+  const changed = Object.keys(updated).filter(k => JSON.stringify((updated as any)[k]) !== JSON.stringify((settings as any)[k]) && !['telegramTunnelPassword', 'telegramBotToken'].includes(k));
+  if (changed.length > 0) console.log(`[settings] Updated: ${changed.join(', ')}`);
   saveSettings(updated);
   restartTelegramBot();
   return NextResponse.json({ ok: true });

package/bin/forge-server.mjs

@@ -72,6 +72,15 @@ const LOG_FILE = join(DATA_DIR, 'forge.log');
 
 process.chdir(ROOT);
 
+// ── Add timestamps to all console output ──
+const origLog = console.log;
+const origError = console.error;
+const origWarn = console.warn;
+const ts = () => new Date().toISOString().replace('T', ' ').slice(0, 19);
+console.log = (...args) => origLog(`[${ts()}]`, ...args);
+console.error = (...args) => origError(`[${ts()}]`, ...args);
+console.warn = (...args) => origWarn(`[${ts()}]`, ...args);
+
 // ── Migrate old layout (~/.forge/*) to new (~/.forge/data/*) ──
 if (!getArg('--dir')) {
   const oldSettings = join(homedir(), '.forge', 'settings.yaml');

package/components/Dashboard.tsx

@@ -18,6 +18,8 @@ const CodeViewer = lazy(() => import('./CodeViewer'));
 const ProjectManager = lazy(() => import('./ProjectManager'));
 const PreviewPanel = lazy(() => import('./PreviewPanel'));
 const PipelineView = lazy(() => import('./PipelineView'));
+const HelpDialog = lazy(() => import('./HelpDialog'));
+const LogViewer = lazy(() => import('./LogViewer'));
 const SkillsPanel = lazy(() => import('./SkillsPanel'));
 
 interface UsageSummary {
@@ -41,12 +43,13 @@ interface ProjectInfo {
 }
 
 export default function Dashboard({ user }: { user: any }) {
-  const [viewMode, setViewMode] = useState<'tasks' | 'sessions' | 'terminal' | 'docs' | 'projects' | 'preview' | 'pipelines' | 'skills'>('terminal');
+  const [viewMode, setViewMode] = useState<'tasks' | 'sessions' | 'terminal' | 'docs' | 'projects' | 'preview' | 'pipelines' | 'skills' | 'logs'>('terminal');
   const [tasks, setTasks] = useState<Task[]>([]);
   const [activeTaskId, setActiveTaskId] = useState<string | null>(null);
   const [showNewTask, setShowNewTask] = useState(false);
   const [showSettings, setShowSettings] = useState(false);
   const [showMonitor, setShowMonitor] = useState(false);
+  const [showHelp, setShowHelp] = useState(false);
   const [usage, setUsage] = useState<UsageSummary[]>([]);
   const [providers, setProviders] = useState<ProviderInfo[]>([]);
   const [projects, setProjects] = useState<ProjectInfo[]>([]);
@@ -262,6 +265,15 @@ export default function Dashboard({ user }: { user: any }) {
               + New Task
             </button>
           )}
+          {/* Help */}
+          <button
+            onClick={() => setShowHelp(v => !v)}
+            className={`text-[10px] px-2 py-0.5 border rounded transition-colors ${
+              showHelp
+                ? 'border-[var(--accent)] text-[var(--accent)]'
+                : 'border-[var(--border)] text-[var(--text-secondary)] hover:text-[var(--text-primary)] hover:border-[var(--text-secondary)]'
+            }`}
+          >?</button>
           {/* Preview + Tunnel */}
           <button
             onClick={() => setViewMode('preview')}
@@ -416,6 +428,12 @@ export default function Dashboard({ user }: { user: any }) {
                   >
                     Settings
                   </button>
+                  <button
+                    onClick={() => { setViewMode('logs'); setShowUserMenu(false); }}
+                    className="w-full text-left text-[11px] px-3 py-1.5 text-[var(--text-secondary)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)]"
+                  >
+                    Logs
+                  </button>
                   <div className="border-t border-[var(--border)] my-1" />
                   <button
                     onClick={() => signOut({ callbackUrl: '/login' })}
@@ -562,6 +580,13 @@ export default function Dashboard({ user }: { user: any }) {
           </Suspense>
         )}
 
+        {/* Logs */}
+        {viewMode === 'logs' && (
+          <Suspense fallback={<div className="flex-1 flex items-center justify-center text-[var(--text-secondary)]">Loading...</div>}>
+            <LogViewer />
+          </Suspense>
+        )}
+
         {/* Docs — always mounted to keep terminal session alive */}
         <div className={viewMode === 'docs' ? 'flex-1 min-h-0 flex' : 'hidden'}>
           <Suspense fallback={<div className="flex-1 flex items-center justify-center text-[var(--text-secondary)]">Loading...</div>}>
@@ -597,6 +622,11 @@ export default function Dashboard({ user }: { user: any }) {
       {showSettings && (
         <SettingsModal onClose={() => { setShowSettings(false); fetchData(); refreshDisplayName(); }} />
       )}
+      {showHelp && (
+        <Suspense fallback={null}>
+          <HelpDialog onClose={() => setShowHelp(false)} />
+        </Suspense>
+      )}
     </div>
   );
 }

package/components/HelpDialog.tsx

@@ -0,0 +1,169 @@
+'use client';
+
+import { useState, useEffect, useRef, lazy, Suspense } from 'react';
+
+interface DocItem {
+  name: string;
+  title: string;
+}
+
+const HelpTerminal = lazy(() => import('./HelpTerminal'));
+
+export default function HelpDialog({ onClose }: { onClose: () => void }) {
+  const [docs, setDocs] = useState<DocItem[]>([]);
+  const [agent, setAgent] = useState<{ name: string } | null | undefined>(undefined); // undefined = loading
+  const [viewDoc, setViewDoc] = useState<string | null>(null);
+  const [docContent, setDocContent] = useState('');
+  const [search, setSearch] = useState('');
+  const [tab, setTab] = useState<'docs' | 'chat'>('docs');
+  const [position, setPosition] = useState({ x: Math.max(0, window.innerWidth - 520), y: 50 });
+  const [size, setSize] = useState({ w: 500, h: 560 });
+  const dragRef = useRef<{ startX: number; startY: number; origX: number; origY: number } | null>(null);
+  const resizeRef = useRef<{ startX: number; startY: number; origW: number; origH: number } | null>(null);
+
+  useEffect(() => {
+    fetch('/api/help?action=status').then(r => r.json())
+      .then(data => setAgent(data.agent || null)).catch(() => setAgent(null));
+    fetch('/api/help?action=docs').then(r => r.json())
+      .then(data => setDocs(data.docs || [])).catch(() => {});
+  }, []);
+
+  const loadDoc = async (name: string) => {
+    setViewDoc(name);
+    try {
+      const res = await fetch(`/api/help?action=doc&name=${encodeURIComponent(name)}`);
+      const data = await res.json();
+      setDocContent(data.content || '');
+    } catch { setDocContent('Failed to load'); }
+  };
+
+  // Drag
+  const onDragStart = (e: React.MouseEvent) => {
+    e.preventDefault();
+    dragRef.current = { startX: e.clientX, startY: e.clientY, origX: position.x, origY: position.y };
+    const onMove = (ev: MouseEvent) => {
+      if (!dragRef.current) return;
+      setPosition({
+        x: Math.max(0, dragRef.current.origX + ev.clientX - dragRef.current.startX),
+        y: Math.max(0, dragRef.current.origY + ev.clientY - dragRef.current.startY),
+      });
+    };
+    const onUp = () => { dragRef.current = null; window.removeEventListener('mousemove', onMove); window.removeEventListener('mouseup', onUp); };
+    window.addEventListener('mousemove', onMove);
+    window.addEventListener('mouseup', onUp);
+  };
+
+  // Resize
+  const onResizeStart = (e: React.MouseEvent) => {
+    e.preventDefault();
+    e.stopPropagation();
+    resizeRef.current = { startX: e.clientX, startY: e.clientY, origW: size.w, origH: size.h };
+    const onMove = (ev: MouseEvent) => {
+      if (!resizeRef.current) return;
+      setSize({
+        w: Math.max(350, resizeRef.current.origW + ev.clientX - resizeRef.current.startX),
+        h: Math.max(300, resizeRef.current.origH + ev.clientY - resizeRef.current.startY),
+      });
+    };
+    const onUp = () => { resizeRef.current = null; window.removeEventListener('mousemove', onMove); window.removeEventListener('mouseup', onUp); };
+    window.addEventListener('mousemove', onMove);
+    window.addEventListener('mouseup', onUp);
+  };
+
+  const filtered = search ? docs.filter(d => d.title.toLowerCase().includes(search.toLowerCase())) : docs;
+
+  return (
+    <div
+      className="fixed z-50 bg-[var(--bg-secondary)] border border-[var(--border)] rounded-lg shadow-2xl flex flex-col overflow-hidden"
+      style={{ left: position.x, top: position.y, width: size.w, height: size.h }}
+    >
+      {/* Title bar */}
+      <div
+        className="flex items-center gap-2 px-3 py-2 bg-[var(--bg-tertiary)] border-b border-[var(--border)] cursor-move shrink-0 select-none"
+        onMouseDown={onDragStart}
+      >
+        <span className="text-[11px] font-semibold text-[var(--text-primary)]">Forge Help</span>
+        <div className="ml-auto flex items-center gap-1">
+          <button
+            onClick={() => { setTab('docs'); setViewDoc(null); }}
+            className={`text-[9px] px-2 py-0.5 rounded ${tab === 'docs' ? 'bg-[var(--accent)]/20 text-[var(--accent)]' : 'text-[var(--text-secondary)]'}`}
+          >Docs</button>
+          {agent && (
+            <button
+              onClick={() => setTab('chat')}
+              className={`text-[9px] px-2 py-0.5 rounded ${tab === 'chat' ? 'bg-[var(--accent)]/20 text-[var(--accent)]' : 'text-[var(--text-secondary)]'}`}
+            >AI Chat</button>
+          )}
+          <button onClick={onClose} className="text-[var(--text-secondary)] hover:text-[var(--red)] ml-1 text-sm leading-none">✕</button>
+        </div>
+      </div>
+
+      {tab === 'chat' ? (
+        /* Embedded terminal */
+        <div className="flex-1 min-h-0">
+          <Suspense fallback={<div className="flex-1 flex items-center justify-center text-xs text-[var(--text-secondary)]">Loading terminal...</div>}>
+            <HelpTerminal />
+          </Suspense>
+        </div>
+      ) : viewDoc ? (
+        /* Doc view */
+        <>
+          <div className="px-3 py-1.5 border-b border-[var(--border)] flex items-center gap-2 shrink-0">
+            <button onClick={() => setViewDoc(null)} className="text-[10px] text-[var(--accent)]">← Back</button>
+            <span className="text-[10px] text-[var(--text-primary)] font-semibold truncate">
+              {docs.find(d => d.name === viewDoc)?.title || viewDoc}
+            </span>
+          </div>
+          <div className="flex-1 overflow-y-auto p-3">
+            <pre className="text-[11px] text-[var(--text-primary)] whitespace-pre-wrap break-words font-mono leading-relaxed">
+              {docContent}
+            </pre>
+          </div>
+        </>
+      ) : (
+        /* Doc list */
+        <>
+          <div className="px-3 py-2 border-b border-[var(--border)] shrink-0">
+            <input
+              type="text"
+              value={search}
+              onChange={e => setSearch(e.target.value)}
+              placeholder="Search help topics..."
+              className="w-full px-2 py-1 bg-[var(--bg-tertiary)] border border-[var(--border)] rounded text-[10px] text-[var(--text-primary)] focus:outline-none focus:border-[var(--accent)]"
+              autoFocus
+            />
+          </div>
+          {!agent && agent !== undefined && (
+            <div className="px-3 py-2 bg-[var(--yellow)]/10 border-b border-[var(--border)] shrink-0">
+              <p className="text-[9px] text-[var(--text-secondary)]">
+                Install Claude Code for AI help: <code className="text-[var(--accent)]">npm i -g @anthropic-ai/claude-code</code>
+              </p>
+            </div>
+          )}
+          <div className="flex-1 overflow-y-auto">
+            {filtered.map(doc => (
+              <button
+                key={doc.name}
+                onClick={() => loadDoc(doc.name)}
+                className="w-full text-left px-3 py-2.5 border-b border-[var(--border)]/30 hover:bg-[var(--bg-tertiary)] text-[11px] text-[var(--text-primary)] capitalize"
+              >
+                {doc.title}
+              </button>
+            ))}
+          </div>
+          <div className="px-3 py-2 border-t border-[var(--border)] shrink-0">
+            <a href="https://github.com/aiwatching/forge" target="_blank" rel="noopener noreferrer"
+              className="text-[9px] text-[var(--text-secondary)] hover:text-[var(--accent)]">GitHub →</a>
+          </div>
+        </>
+      )}
+
+      {/* Resize handle */}
+      <div
+        onMouseDown={onResizeStart}
+        className="absolute bottom-0 right-0 w-4 h-4 cursor-se-resize"
+        style={{ background: 'linear-gradient(135deg, transparent 50%, var(--border) 50%)' }}
+      />
+    </div>
+  );
+}

package/components/HelpTerminal.tsx

@@ -0,0 +1,130 @@
+'use client';
+
+import { useEffect, useRef, useState } from 'react';
+import { Terminal } from '@xterm/xterm';
+import { FitAddon } from '@xterm/addon-fit';
+import '@xterm/xterm/css/xterm.css';
+
+const SESSION_NAME = 'mw-forge-help';
+
+function getWsUrl() {
+  if (typeof window === 'undefined') return `ws://localhost:${parseInt(process.env.TERMINAL_PORT || '3001')}`;
+  const wsProtocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+  const wsHost = window.location.hostname;
+  if (wsHost !== 'localhost' && wsHost !== '127.0.0.1') {
+    return `${wsProtocol}//${window.location.host}/terminal-ws`;
+  }
+  const webPort = parseInt(window.location.port) || 3000;
+  return `${wsProtocol}//${wsHost}:${webPort + 1}`;
+}
+
+export default function HelpTerminal() {
+  const containerRef = useRef<HTMLDivElement>(null);
+  const [connected, setConnected] = useState(false);
+
+  useEffect(() => {
+    if (!containerRef.current) return;
+
+    let disposed = false;
+    const cs = getComputedStyle(document.documentElement);
+    const tv = (name: string) => cs.getPropertyValue(name).trim();
+    const term = new Terminal({
+      cursorBlink: true,
+      fontSize: 12,
+      fontFamily: 'Menlo, Monaco, "Courier New", monospace',
+      scrollback: 3000,
+      logger: { trace: () => {}, debug: () => {}, info: () => {}, warn: () => {}, error: () => {} },
+      theme: {
+        background: tv('--term-bg') || '#1a1a2e',
+        foreground: tv('--term-fg') || '#e0e0e0',
+        cursor: tv('--term-cursor') || '#7c5bf0',
+        selectionBackground: (tv('--term-cursor') || '#7c5bf0') + '44',
+      },
+    });
+    const fit = new FitAddon();
+    term.loadAddon(fit);
+    term.open(containerRef.current);
+    try { fit.fit(); } catch {}
+
+    const wsUrl = getWsUrl();
+    let ws: WebSocket | null = null;
+    let reconnectTimer = 0;
+    let isNewSession = false;
+
+    function connect() {
+      if (disposed) return;
+      const socket = new WebSocket(wsUrl);
+      ws = socket;
+
+      socket.onopen = () => {
+        if (disposed) { socket.close(); return; }
+        socket.send(JSON.stringify({ type: 'attach', sessionName: SESSION_NAME, cols: term.cols, rows: term.rows }));
+      };
+
+      socket.onmessage = (event) => {
+        if (disposed) return;
+        try {
+          const msg = JSON.parse(event.data);
+          if (msg.type === 'output') {
+            try { term.write(msg.data); } catch {}
+          } else if (msg.type === 'connected') {
+            setConnected(true);
+            if (isNewSession) {
+              isNewSession = false;
+              setTimeout(() => {
+                if (socket.readyState === WebSocket.OPEN) {
+                  socket.send(JSON.stringify({ type: 'input', data: `cd ~/.forge/help 2>/dev/null && claude\n` }));
+                }
+              }, 300);
+            }
+          } else if (msg.type === 'error') {
+            isNewSession = true;
+            if (socket.readyState === WebSocket.OPEN) {
+              socket.send(JSON.stringify({ type: 'create', cols: term.cols, rows: term.rows, sessionName: SESSION_NAME }));
+            }
+          }
+        } catch {}
+      };
+
+      socket.onclose = () => {
+        if (disposed) return;
+        setConnected(false);
+        reconnectTimer = window.setTimeout(connect, 3000);
+      };
+      socket.onerror = () => {};
+    }
+
+    connect();
+
+    term.onData((data) => {
+      if (ws?.readyState === WebSocket.OPEN) ws.send(JSON.stringify({ type: 'input', data }));
+    });
+
+    const resizeObserver = new ResizeObserver(() => {
+      const el = containerRef.current;
+      if (!el || el.offsetWidth < 50 || el.offsetHeight < 30) return;
+      try {
+        fit.fit();
+        if (term.cols < 2 || term.rows < 2) return;
+        if (ws?.readyState === WebSocket.OPEN) {
+          ws.send(JSON.stringify({ type: 'resize', cols: term.cols, rows: term.rows }));
+        }
+      } catch {}
+    });
+    resizeObserver.observe(containerRef.current);
+
+    return () => {
+      disposed = true;
+      clearTimeout(reconnectTimer);
+      ws?.close();
+      resizeObserver.disconnect();
+      term.dispose();
+    };
+  }, []);
+
+  return (
+    <div className="h-full flex flex-col">
+      <div ref={containerRef} className="flex-1" />
+    </div>
+  );
+}