report-issue-flow (squashed)

Author: frenchie4111

src/main/debug.ts

@@ -1,4 +1,4 @@
-import { appendFileSync, writeFileSync } from 'fs'
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from 'fs'
 import { join } from 'path'
 import { app } from 'electron'
 
@@ -34,3 +34,16 @@ export function log(category: string, message: string, data?: unknown): void {
 export function getLogFilePath(): string {
   return getLogPath()
 }
+
+export function readRecentDebugLog(maxLines = 200): string {
+  const path = getLogPath()
+  if (!existsSync(path)) return ''
+  try {
+    const content = readFileSync(path, 'utf-8')
+    const lines = content.split('\n')
+    const tail = lines.slice(-Math.max(1, maxLines))
+    return tail.join('\n').trim()
+  } catch {
+    return ''
+  }
+}

src/main/index.ts

@@ -45,6 +45,8 @@ import { createNewProject, type GitignorePreset } from './repo-create'
 import { isWorktreeMerged } from '../shared/state/prs'
 import { watchStatusDir } from './hooks'
 import { getAgent, type AgentKind } from './agents'
+import { HARNESS_REPO_OWNER, HARNESS_REPO_NAME } from '../shared/constants'
+import { readRecentDebugLog } from './debug'
 
 function toAgentKind(value: string | undefined): AgentKind {
   return value === 'codex' ? 'codex' : 'claude'
@@ -179,9 +181,9 @@ async function refreshHarnessStarState(): Promise<void> {
     store.dispatch({ type: 'settings/harnessStarredChanged', payload: null })
     return
   }
-  const starred = await isRepoStarred(token, 'frenchie4111', 'harness')
+  const starred = await isRepoStarred(token, HARNESS_REPO_OWNER, HARNESS_REPO_NAME)
   if (starred === false && !config.harnessAutoStarred) {
-    const result = await starRepo(token, 'frenchie4111', 'harness')
+    const result = await starRepo(token, HARNESS_REPO_OWNER, HARNESS_REPO_NAME)
     if (result.ok) {
       config.harnessAutoStarred = true
       saveConfig(config)
@@ -1506,8 +1508,8 @@ function registerIpcHandlers(): void {
     const token = getCachedToken()
     if (!token) return { ok: false, error: 'No GitHub token' }
     const result = starred
-      ? await starRepo(token, 'frenchie4111', 'harness')
-      : await unstarRepo(token, 'frenchie4111', 'harness')
+      ? await starRepo(token, HARNESS_REPO_OWNER, HARNESS_REPO_NAME)
+      : await unstarRepo(token, HARNESS_REPO_OWNER, HARNESS_REPO_NAME)
     if (result.ok) {
       store.dispatch({ type: 'settings/harnessStarredChanged', payload: starred })
     }
@@ -1519,6 +1521,10 @@ function registerIpcHandlers(): void {
     return app.getVersion()
   })
 
+  transport.onRequest('debug:readRecentLog', (maxLines?: number) => {
+    return readRecentDebugLog(maxLines)
+  })
+
   transport.onRequest('updater:checkForUpdates', async () => {
     if (!app.isPackaged) {
       return { ok: false, error: 'Updates are only available in packaged builds' }
@@ -1705,6 +1711,14 @@ function openNewProjectInFocusedWindow(): void {
   transport.sendSignal('menu:newProject')
 }
 
+function openReportIssueInFocusedWindow(): void {
+  transport.sendSignal('app:openReportIssue')
+}
+
+function crashFocusedTabInFocusedWindow(): void {
+  transport.sendSignal('app:debugCrashFocusedTab')
+}
+
 function buildMenu(): void {
   const template: Electron.MenuItemConstructorOptions[] = [
     {
@@ -1784,6 +1798,16 @@ function buildMenu(): void {
         {
           label: 'Keyboard Shortcuts',
           click: openKeyboardShortcutsInFocusedWindow
+        },
+        { type: 'separator' },
+        {
+          label: 'Report an Issue…',
+          click: openReportIssueInFocusedWindow
+        },
+        { type: 'separator' },
+        {
+          label: 'Debug: Crash Focused Tab',
+          click: crashFocusedTabInFocusedWindow
         }
       ]
     }

src/preload/index.ts

@@ -212,6 +212,7 @@ contextBridge.exposeInMainWorld('api', {
 
   // Updater
   getVersion: () => req('updater:getVersion'),
+  readRecentLog: (maxLines?: number) => req('debug:readRecentLog', maxLines),
   checkForUpdates: () => req('updater:checkForUpdates'),
   quitAndInstall: () => req('updater:quitAndInstall'),
 
@@ -245,6 +246,8 @@ contextBridge.exposeInMainWorld('api', {
   onTogglePerfMonitor: (callback: () => void) => transport.onSignal('app:togglePerfMonitor', () => callback()),
   onOpenKeyboardShortcuts: (callback: () => void) => transport.onSignal('app:openKeyboardShortcuts', () => callback()),
   onOpenNewProject: (callback: () => void) => transport.onSignal('menu:newProject', () => callback()),
+  onOpenReportIssue: (callback: () => void) => transport.onSignal('app:openReportIssue', () => callback()),
+  onDebugCrashFocusedTab: (callback: () => void) => transport.onSignal('app:debugCrashFocusedTab', () => callback()),
 
   // Hooks
   acceptHooks: () => req('hooks:accept'),

src/renderer/App.tsx

@@ -28,6 +28,7 @@ import { ReviewScreen } from './components/ReviewScreen'
 import { CommandPalette } from './components/CommandPalette'
 import { HotkeyCheatsheet } from './components/HotkeyCheatsheet'
 import { NewProjectScreen } from './components/NewProjectScreen'
+import { ReportIssueScreen, onOpenReportIssue, type OpenReportIssueDetail } from './components/ReportIssueScreen'
 import iconUrl from '../../resources/icon.png'
 import { PerfMonitorHUD } from './components/PerfMonitorHUD'
 import { focusTerminalById } from './components/XTerminal'
@@ -187,6 +188,8 @@ export default function App(): JSX.Element {
   const [showPerfMonitor, setShowPerfMonitor] = useState(false)
   const [showHotkeyCheatsheet, setShowHotkeyCheatsheet] = useState(false)
   const [showNewProject, setShowNewProject] = useState(false)
+  const [reportIssueState, setReportIssueState] = useState<OpenReportIssueDetail | null>(null)
+  const [crashedTabIds, setCrashedTabIds] = useState<ReadonlySet<string>>(() => new Set())
   // `theme` and `defaultAgent` are both seeded at init, so we track
   // explicit confirmation separately for the onboarding step checkmarks.
   const [themeChosen, setThemeChosen] = useState(false)
@@ -271,6 +274,46 @@ const setQuestStep = useCallback((next: QuestStep) => {
     return cleanup
   }, [])
 
+  // Report Issue — triggered from the Help menu, the sidebar, the
+  // Settings Support section, and the openReportIssueFor() helper (used
+  // by the error boundary). Closes any open overlay (Settings, hotkey
+  // cheatsheet) so the full-screen report takes over the center area.
+  useEffect(() => {
+    const openReport = (detail: OpenReportIssueDetail): void => {
+      setShowSettings(false)
+      setShowHotkeyCheatsheet(false)
+      setReportIssueState(detail)
+    }
+    const cleanupMenu = window.api.onOpenReportIssue(() => openReport({}))
+    const cleanupBus = onOpenReportIssue((detail) => openReport(detail))
+    return () => {
+      cleanupMenu()
+      cleanupBus()
+    }
+  }, [])
+
+  // Debug: Crash Focused Tab (Help menu → for testing the ErrorBoundary).
+  // Finds the active worktree's active pane and flips its active tab into
+  // a throwing render. The boundary catches it inside the tab.
+  useEffect(() => {
+    return window.api.onDebugCrashFocusedTab(() => {
+      const wtPath = activeWorktreeId
+      if (!wtPath) return
+      const tree = panes[wtPath]
+      if (!tree) return
+      const leaves = getLeaves(tree)
+      const paneId = activePaneId[wtPath] ?? leaves[0]?.id
+      const leaf = leaves.find((l) => l.id === paneId) ?? leaves[0]
+      const tabId = leaf?.activeTabId
+      if (!tabId) return
+      setCrashedTabIds((prev) => {
+        const next = new Set(prev)
+        next.add(tabId)
+        return next
+      })
+    })
+  }, [activeWorktreeId, panes, activePaneId])
+
   // Trigger a full PR refresh in main. Used by the sidebar refresh button
   // and after worktree creation/removal.
   const fetchAllPRStatuses = useCallback(() => {
@@ -975,7 +1018,7 @@ const setQuestStep = useCallback((next: QuestStep) => {
           if (!paneTree) return null
           const leaves = getLeaves(paneTree)
           if (leaves.length === 0 || !leaves.some((l) => l.tabs.length > 0)) return null
-          const isVisible = !showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && wt.path === activeWorktreeId && !pendingDeletionByPath[wt.path]
+          const isVisible = !showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && reportIssueState === null && wt.path === activeWorktreeId && !pendingDeletionByPath[wt.path]
           return (
             <div
               key={wt.path}
@@ -992,6 +1035,7 @@ const setQuestStep = useCallback((next: QuestStep) => {
                   statuses={statuses}
                   shellActivity={shellActivity}
                   visible={isVisible}
+                  crashedTabIds={crashedTabIds}
                   nameAgentSessions={nameAgentSessions}
                   onSelectTab={handleSelectTab}
                   onAddTab={handleAddTerminalTab}
@@ -1019,6 +1063,15 @@ const setQuestStep = useCallback((next: QuestStep) => {
             defaultRepoRoot={activeWorktreeId ? worktreeRepoByPath[activeWorktreeId] : undefined}
           />
         )}
+        {reportIssueState !== null && (
+          <ReportIssueScreen
+            onClose={() => setReportIssueState(null)}
+            initialKind={reportIssueState.kind}
+            initialTitle={reportIssueState.title}
+            initialBody={reportIssueState.body}
+            prefilledContext={reportIssueState.context}
+          />
+        )}
         {showActivity && (
           <div className="flex-1 min-w-0 flex">
             <Activity
@@ -1080,12 +1133,12 @@ const setQuestStep = useCallback((next: QuestStep) => {
             </div>
           )
         })()}
-        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && !activeWorktreeId && worktrees.length > 0 && (
+        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && reportIssueState === null && !activeWorktreeId && worktrees.length > 0 && (
           <div className="flex-1 flex items-center justify-center text-dim">
             Select a worktree to begin
           </div>
         )}
-        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && isPendingId(activeWorktreeId) && (() => {
+        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && reportIssueState === null && isPendingId(activeWorktreeId) && (() => {
           const pending = pendingWorktrees.find((p) => p.id === activeWorktreeId)
           if (!pending) return null
           return (
@@ -1097,7 +1150,7 @@ const setQuestStep = useCallback((next: QuestStep) => {
             />
           )
         })()}
-        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && activeWorktreeId && pendingDeletionByPath[activeWorktreeId] && (
+        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && reportIssueState === null && activeWorktreeId && pendingDeletionByPath[activeWorktreeId] && (
           <DeletingWorktreeScreen
             deletion={pendingDeletionByPath[activeWorktreeId]}
             onDismiss={handleDismissPendingDeletion}
@@ -1109,10 +1162,10 @@ const setQuestStep = useCallback((next: QuestStep) => {
           onFinish={() => setQuestStep('done')}
         />
         {/* Right panel — hidden on the new-worktree screen so the form gets the full width */}
-        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && !rightColumnHidden && (
+        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && reportIssueState === null && !rightColumnHidden && (
           <ResizeHandle onDelta={handleRightPanelResize} />
         )}
-        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && !rightColumnHidden && (
+        {!showNewWorktree && !showActivity && !showCleanup && !showCommandCenter && !showReview && reportIssueState === null && !rightColumnHidden && (
           <RightColumn
             width={rightPanelWidth}
             activeWorktreeId={activeWorktreeId}

src/renderer/components/ErrorBoundary.tsx

@@ -1,5 +1,6 @@
 import { Component, type ErrorInfo, type ReactNode } from 'react'
-import { AlertTriangle, RotateCcw, Copy, Check, RefreshCw } from 'lucide-react'
+import { AlertTriangle, RotateCcw, Copy, Check, RefreshCw, MessageSquare } from 'lucide-react'
+import { openReportIssueFor } from './ReportIssueScreen'
 
 interface FallbackRenderProps {
   error: Error
@@ -81,6 +82,12 @@ export class ErrorBoundary extends Component<Props, State> {
     location.reload()
   }
 
+  handleReport = (): void => {
+    const { error, info } = this.state
+    if (!error) return
+    openReportIssueFor(error, { componentStack: info?.componentStack ?? '' })
+  }
+
   toggleExpanded = (): void => {
     this.setState((s) => ({ expanded: !s.expanded }))
   }
@@ -109,6 +116,7 @@ export class ErrorBoundary extends Component<Props, State> {
           </div>
           <div className="px-4 py-3 flex flex-wrap items-center gap-2">
             <button
+              type="button"
               onClick={this.handleReset}
               className="flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium bg-panel border border-border text-fg-bright hover:border-border-strong transition-colors cursor-pointer"
             >
@@ -117,6 +125,7 @@ export class ErrorBoundary extends Component<Props, State> {
             </button>
             {this.props.showReload && (
               <button
+                type="button"
                 onClick={this.handleReload}
                 className="flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium bg-panel border border-border text-fg-bright hover:border-border-strong transition-colors cursor-pointer"
               >
@@ -125,13 +134,23 @@ export class ErrorBoundary extends Component<Props, State> {
               </button>
             )}
             <button
+              type="button"
               onClick={this.handleCopy}
               className="flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium bg-panel border border-border text-fg-bright hover:border-border-strong transition-colors cursor-pointer"
             >
               {copied ? <Check className="w-3.5 h-3.5 text-success" /> : <Copy className="w-3.5 h-3.5" />}
               {copied ? 'Copied' : 'Copy error details'}
             </button>
             <button
+              type="button"
+              onClick={this.handleReport}
+              className="flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium bg-panel border border-border text-fg-bright hover:border-border-strong transition-colors cursor-pointer"
+            >
+              <MessageSquare className="w-3.5 h-3.5" />
+              Report error
+            </button>
+            <button
+              type="button"
               onClick={this.toggleExpanded}
               className="ml-auto text-xs text-dim hover:text-fg transition-colors cursor-pointer"
             >