ghcrawl 0.3.0 → 0.5.0

package/dist/tui/app.js

@@ -20,7 +20,7 @@ function createScreen(options) {
     });
 }
 const ACTIVITY_LOG_LIMIT = 200;
-const FOOTER_LOG_LINES = 4;
+const FOOTER_LOG_LINES = 3;
 const UPDATE_TASK_ORDER = ['sync', 'embed', 'cluster'];
 export async function startTui(params) {
     const selectedRepository = params.owner && params.repo ? { owner: params.owner, repo: params.repo } : null;
@@ -29,11 +29,15 @@ export async function startTui(params) {
     let focusPane = 'clusters';
     const initialPreference = selectedRepository
         ? getTuiRepositoryPreference(params.service.config, currentRepository.owner, currentRepository.repo)
-        : { sortMode: 'recent', minClusterSize: 10 };
+        : { sortMode: 'recent', minClusterSize: 10, wideLayout: 'columns' };
     let sortMode = initialPreference.sortMode;
     let minSize = initialPreference.minClusterSize;
+    let wideLayout = initialPreference.wideLayout;
+    let showClosed = true;
     let search = '';
     let snapshot = null;
+    let clusterItems = ['Pick a repository with p'];
+    let clusterIndexById = new Map();
     let clusterDetail = null;
     let threadDetail = null;
     let selectedClusterId = null;
@@ -52,6 +56,22 @@ export async function startTui(params) {
         clusterDetailCache.clear();
         threadDetailCache.clear();
     };
+    const rebuildClusterItems = () => {
+        if (!snapshot) {
+            clusterItems = ['Pick a repository with p'];
+            clusterIndexById = new Map();
+            widgets.clusters.setItems(clusterItems);
+            return;
+        }
+        clusterIndexById = new Map();
+        clusterItems = snapshot.clusters.map((cluster, index) => {
+            clusterIndexById.set(cluster.clusterId, index);
+            const updated = formatClusterDateColumn(cluster.latestUpdatedAt);
+            const label = `${String(cluster.totalCount).padStart(3, ' ')}  C${String(cluster.clusterId).padStart(5, ' ')}  ${String(cluster.pullRequestCount).padStart(2, ' ')}P/${String(cluster.issueCount).padStart(2, ' ')}I  ${updated}  ${cluster.displayTitle}`;
+            return cluster.isClosed ? `{gray-fg}${escapeBlessedText(label)}{/gray-fg}` : escapeBlessedText(label);
+        });
+        widgets.clusters.setItems(clusterItems);
+    };
     const pushActivity = (message) => {
         activityLines.push(`${formatActivityTimestamp()} ${message}`);
         if (activityLines.length > ACTIVITY_LOG_LIMIT) {
@@ -67,6 +87,7 @@ export async function startTui(params) {
             owner: currentRepository.owner,
             repo: currentRepository.repo,
             clusterId,
+            clusterRunId: snapshot?.clusterRunId ?? undefined,
         });
         clusterDetailCache.set(clusterId, detail);
         return detail;
@@ -88,6 +109,48 @@ export async function startTui(params) {
     const loadSelectedThreadDetail = (includeNeighbors) => {
         threadDetail = selectedMemberThreadId !== null ? loadThreadDetail(selectedMemberThreadId, includeNeighbors) : null;
     };
+    const jumpToThread = (threadId, clusterId) => {
+        if (clusterId == null) {
+            status = 'Selected thread is not assigned to a cluster';
+            render();
+            return false;
+        }
+        const selectFromSnapshot = () => {
+            const cluster = snapshot?.clusters.find((item) => item.clusterId === clusterId) ?? null;
+            if (!cluster) {
+                return false;
+            }
+            selectedClusterId = cluster.clusterId;
+            try {
+                clusterDetail = loadClusterDetail(cluster.clusterId);
+            }
+            catch (error) {
+                status = `Cluster ${cluster.clusterId} changed; refreshing view`;
+                refreshAll(true);
+                return false;
+            }
+            memberRows = buildMemberRows(clusterDetail, { includeClosedMembers: showClosed });
+            selectedMemberThreadId = threadId;
+            memberIndex = findSelectableIndex(memberRows, selectedMemberThreadId);
+            loadSelectedThreadDetail(false);
+            resetDetailScroll();
+            status = `Cluster ${cluster.clusterId} / #${threadDetail?.thread.number ?? '?'}`;
+            render();
+            return true;
+        };
+        if (selectFromSnapshot()) {
+            return true;
+        }
+        if (minSize !== 0 || search) {
+            minSize = 0;
+            search = '';
+            refreshAll(false);
+            return selectFromSnapshot();
+        }
+        status = `Cluster ${clusterId} is not available in the current view`;
+        render();
+        return false;
+    };
     const refreshAll = (preserveSelection) => {
         const previousClusterId = preserveSelection ? selectedClusterId : null;
         const previousMemberId = preserveSelection ? selectedMemberThreadId : null;
@@ -98,11 +161,30 @@ export async function startTui(params) {
             minSize,
             sort: sortMode,
             search,
+            includeClosedClusters: showClosed,
         });
         selectedClusterId = preserveSelectedId(snapshot.clusters.map((cluster) => cluster.clusterId), previousClusterId);
+        rebuildClusterItems();
         if (selectedClusterId !== null) {
-            clusterDetail = loadClusterDetail(selectedClusterId);
-            memberRows = buildMemberRows(clusterDetail);
+            try {
+                clusterDetail = loadClusterDetail(selectedClusterId);
+            }
+            catch {
+                snapshot = params.service.getTuiSnapshot({
+                    owner: currentRepository.owner,
+                    repo: currentRepository.repo,
+                    minSize,
+                    sort: sortMode,
+                    search,
+                    includeClosedClusters: showClosed,
+                });
+                rebuildClusterItems();
+                selectedClusterId = preserveSelectedId(snapshot.clusters.map((cluster) => cluster.clusterId), null);
+                clusterDetail = selectedClusterId !== null ? loadClusterDetail(selectedClusterId) : null;
+            }
+        }
+        if (selectedClusterId !== null && clusterDetail) {
+            memberRows = buildMemberRows(clusterDetail, { includeClosedMembers: showClosed });
             selectedMemberThreadId = preserveSelectedId(memberRows.filter((row) => row.selectable).map((row) => row.threadId), previousMemberId);
             memberIndex = findSelectableIndex(memberRows, selectedMemberThreadId);
             loadSelectedThreadDetail(false);
@@ -133,7 +215,7 @@ export async function startTui(params) {
     const render = () => {
         const width = widgets.screen.width;
         const height = widgets.screen.height;
-        const layout = computeTuiLayout(width, height);
+        const layout = computeTuiLayout(width, height, wideLayout);
         applyRect(widgets.header, layout.header);
         applyRect(widgets.clusters, layout.clusters);
         applyRect(widgets.members, layout.members);
@@ -149,15 +231,8 @@ export async function startTui(params) {
         const clusterStatus = snapshot?.stats.latestClusterRunId != null
             ? `#${snapshot.stats.latestClusterRunId} ${formatRelativeTime(snapshot.stats.latestClusterRunFinishedAt ?? null)}`
             : 'never';
-        widgets.header.setContent(`{bold}${repoLabel}{/bold}  {cyan-fg}${snapshot?.stats.openPullRequestCount ?? 0} PR{/cyan-fg}  {green-fg}${snapshot?.stats.openIssueCount ?? 0} issues{/green-fg}  GH:${ghStatus}  Emb:${embedStatus}  Cl:${clusterStatus}  sort:${sortMode}  min:${minSize === 0 ? 'all' : `${minSize}+`}  filter:${search || 'none'}`);
-        const clusterItems = snapshot
-            ? snapshot.clusters.map((cluster) => {
-                const updated = cluster.latestUpdatedAt ? cluster.latestUpdatedAt.slice(5, 16).replace('T', ' ') : 'unknown';
-                return `${String(cluster.totalCount).padStart(3, ' ')}  ${String(cluster.pullRequestCount).padStart(2, ' ')}P/${String(cluster.issueCount).padStart(2, ' ')}I  ${updated}  ${cluster.displayTitle}`;
-            })
-            : ['Pick a repository with p'];
-        widgets.clusters.setItems(clusterItems);
-        const clusterIndex = snapshot && selectedClusterId !== null ? Math.max(0, snapshot.clusters.findIndex((cluster) => cluster.clusterId === selectedClusterId)) : 0;
+        widgets.header.setContent(`{bold}${repoLabel}{/bold}  {cyan-fg}${snapshot?.stats.openPullRequestCount ?? 0} PR{/cyan-fg}  {green-fg}${snapshot?.stats.openIssueCount ?? 0} issues{/green-fg}  GH:${ghStatus}  Emb:${embedStatus}  Cl:${clusterStatus}  sort:${sortMode}  min:${minSize === 0 ? 'all' : `${minSize}+`}  layout:${wideLayout === 'columns' ? 'cols' : 'stack'}  closed:${showClosed ? 'shown' : 'hidden'}  filter:${search || 'none'}`);
+        const clusterIndex = snapshot && selectedClusterId !== null ? Math.max(0, clusterIndexById.get(selectedClusterId) ?? -1) : 0;
         widgets.clusters.select(clusterIndex);
         widgets.members.setItems(memberRows.length > 0 ? memberRows.map((row) => row.label) : ['No members']);
         if (memberIndex >= 0) {
@@ -173,7 +248,8 @@ export async function startTui(params) {
         while (footerLines.length < FOOTER_LOG_LINES) {
             footerLines.unshift('');
         }
-        footerLines.push(`${status}  |  jobs:${activeJobs}  |  Tab focus  j/k move-or-scroll  PgUp/PgDn scroll  p repos  g update  s sort  f min  / filter  r refresh  o open  q quit`);
+        footerLines.push(`${status}  |  jobs:${activeJobs}  |  h/? help  g update  p repos  u author  / filter  s sort  f min  l layout  x closed`);
+        footerLines.push(`Tab focus  arrows move-or-scroll  PgUp/PgDn page  r refresh  o open  q quit`);
         widgets.footer.setContent(footerLines.join('\n'));
         widgets.screen.render();
     };
@@ -255,31 +331,54 @@ export async function startTui(params) {
             render();
         }
     };
-    const moveSelection = (delta) => {
+    const moveSelection = (delta, options) => {
         if (!snapshot)
             return;
+        const steps = Math.max(1, options?.steps ?? 1);
+        const wrap = options?.wrap ?? true;
         if (focusPane === 'clusters') {
             if (snapshot.clusters.length === 0)
                 return;
             const currentIndex = Math.max(0, snapshot.clusters.findIndex((cluster) => cluster.clusterId === selectedClusterId));
-            const nextIndex = (currentIndex + delta + snapshot.clusters.length) % snapshot.clusters.length;
+            let nextIndex = currentIndex + delta * steps;
+            if (wrap) {
+                nextIndex = ((nextIndex % snapshot.clusters.length) + snapshot.clusters.length) % snapshot.clusters.length;
+            }
+            else {
+                nextIndex = Math.max(0, Math.min(snapshot.clusters.length - 1, nextIndex));
+            }
             selectedClusterId = snapshot.clusters[nextIndex]?.clusterId ?? null;
             if (selectedClusterId !== null) {
-                clusterDetail = loadClusterDetail(selectedClusterId);
-                memberRows = buildMemberRows(clusterDetail);
+                try {
+                    clusterDetail = loadClusterDetail(selectedClusterId);
+                }
+                catch {
+                    status = 'Cluster data changed; refreshing view';
+                    refreshAll(true);
+                    return;
+                }
+                memberRows = buildMemberRows(clusterDetail, { includeClosedMembers: showClosed });
                 selectedMemberThreadId = preserveSelectedId(memberRows.filter((row) => row.selectable).map((row) => row.threadId), null);
                 memberIndex = findSelectableIndex(memberRows, selectedMemberThreadId);
                 loadSelectedThreadDetail(false);
                 resetDetailScroll();
             }
-            status = `Cluster ${nextIndex + 1}/${snapshot.clusters.length}`;
+            status = selectedClusterId !== null ? `Cluster ${selectedClusterId} (${nextIndex + 1}/${snapshot.clusters.length})` : `Cluster ${nextIndex + 1}/${snapshot.clusters.length}`;
             render();
             return;
         }
         if (focusPane === 'members') {
             if (memberRows.length === 0)
                 return;
-            memberIndex = moveSelectableIndex(memberRows, memberIndex < 0 ? 0 : memberIndex, delta);
+            let nextIndex = memberIndex < 0 ? 0 : memberIndex;
+            for (let index = 0; index < steps; index += 1) {
+                const candidateIndex = moveSelectableIndex(memberRows, nextIndex, delta);
+                if (!wrap && candidateIndex === nextIndex) {
+                    break;
+                }
+                nextIndex = candidateIndex;
+            }
+            memberIndex = nextIndex;
             selectedMemberThreadId = selectedThreadIdFromRow(memberRows, memberIndex);
             loadSelectedThreadDetail(false);
             resetDetailScroll();
@@ -287,6 +386,17 @@ export async function startTui(params) {
             render();
         }
     };
+    const getFocusedListPageSize = () => {
+        const listHeight = focusPane === 'clusters' ? Number(widgets.clusters.height) : Number(widgets.members.height);
+        return Math.max(1, listHeight - 4);
+    };
+    const pageFocusedPane = (delta) => {
+        if (focusPane === 'detail') {
+            scrollDetail(delta * 12);
+            return;
+        }
+        moveSelection(delta, { steps: getFocusedListPageSize(), wrap: false });
+    };
     const promptFilter = () => {
         modalOpen = true;
         const prompt = blessed.prompt({
@@ -325,6 +435,50 @@ export async function startTui(params) {
         status = `Opened ${url}`;
         render();
     };
+    const promptAuthorThreads = () => {
+        if (modalOpen)
+            return;
+        const authorLogin = threadDetail?.thread.authorLogin?.trim() ?? '';
+        if (!authorLogin) {
+            status = 'Selected thread has no author login';
+            render();
+            return;
+        }
+        void (async () => {
+            modalOpen = true;
+            try {
+                const response = params.service.listAuthorThreads({
+                    owner: currentRepository.owner,
+                    repo: currentRepository.repo,
+                    login: authorLogin,
+                });
+                const choice = await promptAuthorThreadChoice(widgets.screen, response.authorLogin, response.threads);
+                if (!choice) {
+                    render();
+                    return;
+                }
+                jumpToThread(choice.threadId, choice.clusterId);
+                updateFocus('members');
+            }
+            finally {
+                modalOpen = false;
+            }
+        })();
+    };
+    const openHelp = () => {
+        if (modalOpen)
+            return;
+        void (async () => {
+            modalOpen = true;
+            try {
+                await promptHelp(widgets.screen);
+                render();
+            }
+            finally {
+                modalOpen = false;
+            }
+        })();
+    };
     const promptUpdatePipeline = () => {
         if (modalOpen || hasActiveJobs()) {
             if (hasActiveJobs()) {
@@ -379,17 +533,49 @@ export async function startTui(params) {
             repo: currentRepository.repo,
             minClusterSize: minSize,
             sortMode,
+            wideLayout,
+        });
+    };
+    const withLoadingOverlay = async (message, task) => {
+        const box = blessed.box({
+            parent: widgets.screen,
+            border: 'line',
+            label: ' Loading ',
+            width: '56%',
+            height: 7,
+            top: 'center',
+            left: 'center',
+            tags: true,
+            content: `${message}\n\nThis can take a few seconds on large repos.`,
+            style: {
+                border: { fg: '#5bc0eb' },
+                fg: 'white',
+                bg: '#101522',
+            },
         });
+        widgets.screen.render();
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        try {
+            return await task();
+        }
+        finally {
+            box.destroy();
+            widgets.screen.render();
+        }
     };
     const switchRepository = (target, overrides) => {
         currentRepository = target;
         const preference = getTuiRepositoryPreference(params.service.config, target.owner, target.repo);
         minSize = overrides?.minClusterSize ?? preference.minClusterSize;
         sortMode = overrides?.sortMode ?? preference.sortMode;
+        wideLayout = preference.wideLayout;
         persistRepositoryPreference();
         clearCaches();
         search = '';
         snapshot = null;
+        clusterItems = ['Pick a repository with p'];
+        clusterIndexById = new Map();
+        widgets.clusters.setItems(clusterItems);
         clusterDetail = null;
         threadDetail = null;
         selectedClusterId = null;
@@ -447,7 +633,9 @@ export async function startTui(params) {
                     return;
                 }
                 if (choice.kind === 'existing') {
-                    switchRepository(choice.target);
+                    await withLoadingOverlay(`Opening ${choice.target.owner}/${choice.target.repo}...`, async () => {
+                        switchRepository(choice.target);
+                    });
                     pushActivity(`[repo] switched to ${choice.target.owner}/${choice.target.repo}`);
                     updateFocus('clusters');
                     return;
@@ -476,7 +664,9 @@ export async function startTui(params) {
                 return false;
             }
             if (choice.kind === 'existing') {
-                switchRepository(choice.target);
+                await withLoadingOverlay(`Opening ${choice.target.owner}/${choice.target.repo}...`, async () => {
+                    switchRepository(choice.target);
+                });
                 pushActivity(`[repo] opened ${choice.target.owner}/${choice.target.repo}`);
                 updateFocus('clusters');
                 return true;
@@ -496,20 +686,25 @@ export async function startTui(params) {
             modalOpen = false;
         }
     };
-    widgets.screen.key(['q', 'C-c'], () => {
+    widgets.screen.key(['q'], () => {
+        if (modalOpen)
+            return;
+        widgets.screen.destroy();
+    });
+    widgets.screen.key(['C-c'], () => {
         widgets.screen.destroy();
     });
-    widgets.screen.key(['tab'], () => {
+    widgets.screen.key(['tab', 'right'], () => {
         if (modalOpen)
             return;
         updateFocus(cycleFocusPane(focusPane, 1));
     });
-    widgets.screen.key(['S-tab'], () => {
+    widgets.screen.key(['S-tab', 'left'], () => {
         if (modalOpen)
             return;
         updateFocus(cycleFocusPane(focusPane, -1));
     });
-    widgets.screen.key(['j', 'down'], () => {
+    widgets.screen.key(['down'], () => {
         if (modalOpen)
             return;
         if (focusPane === 'detail') {
@@ -518,7 +713,7 @@ export async function startTui(params) {
         }
         moveSelection(1);
     });
-    widgets.screen.key(['k', 'up'], () => {
+    widgets.screen.key(['up'], () => {
         if (modalOpen)
             return;
         if (focusPane === 'detail') {
@@ -530,12 +725,12 @@ export async function startTui(params) {
     widgets.screen.key(['pageup'], () => {
         if (modalOpen)
             return;
-        scrollDetail(-12);
+        pageFocusedPane(-1);
     });
     widgets.screen.key(['pagedown'], () => {
         if (modalOpen)
             return;
-        scrollDetail(12);
+        pageFocusedPane(1);
     });
     widgets.screen.key(['home'], () => {
         if (modalOpen)
@@ -582,11 +777,31 @@ export async function startTui(params) {
         status = `Min size: ${minSize === 0 ? 'all' : `${minSize}+`}`;
         refreshAll(false);
     });
+    widgets.screen.key(['l'], () => {
+        if (modalOpen)
+            return;
+        wideLayout = wideLayout === 'columns' ? 'right-stack' : 'columns';
+        persistRepositoryPreference();
+        status = `Layout: ${wideLayout === 'columns' ? 'three columns' : 'wide left + stacked right'}`;
+        render();
+    });
+    widgets.screen.key(['x'], () => {
+        if (modalOpen)
+            return;
+        showClosed = !showClosed;
+        status = showClosed ? 'Showing closed clusters and members' : 'Hiding closed clusters and members';
+        refreshAll(true);
+    });
     widgets.screen.key(['/'], () => {
         if (modalOpen)
             return;
         promptFilter();
     });
+    widgets.screen.key(['h', '?'], () => {
+        if (modalOpen)
+            return;
+        openHelp();
+    });
     widgets.screen.key(['p'], () => browseRepositories());
     widgets.screen.key(['g'], () => {
         if (modalOpen)
@@ -604,6 +819,11 @@ export async function startTui(params) {
             return;
         openSelectedThread();
     });
+    widgets.screen.key(['u'], () => {
+        if (modalOpen)
+            return;
+        promptAuthorThreads();
+    });
     widgets.screen.on('resize', () => render());
     widgets.screen.on('destroy', () => {
         widgets.screen.program.showCursor();
@@ -642,7 +862,7 @@ function createWidgets(owner, repo) {
         parent: screen,
         border: 'line',
         label: ' Clusters ',
-        tags: false,
+        tags: true,
         keys: false,
         style: {
             border: { fg: '#5bc0eb' },
@@ -655,7 +875,7 @@ function createWidgets(owner, repo) {
         parent: screen,
         border: 'line',
         label: ' Members ',
-        tags: false,
+        tags: true,
         keys: false,
         style: {
             border: { fg: '#9bc53d' },
@@ -695,10 +915,19 @@ export function renderDetailPane(threadDetail, clusterDetail, focusPane) {
         return 'No cluster selected.\n\nRun `ghcrawl cluster owner/repo` if you have not clustered this repository yet.';
     }
     if (!threadDetail) {
-        return `{bold}${escapeBlessedText(clusterDetail.displayTitle)}{/bold}\n\nSelect a member to inspect thread details.`;
+        const representativeLabel = clusterDetail.representativeNumber !== null && clusterDetail.representativeKind !== null
+            ? ` (#${clusterDetail.representativeNumber} representative ${clusterDetail.representativeKind === 'pull_request' ? 'pr' : 'issue'})`
+            : '';
+        return `{bold}Cluster ${clusterDetail.clusterId}${escapeBlessedText(representativeLabel)}{/bold}\n${escapeBlessedText(clusterDetail.displayTitle)}\n\nSelect a member to inspect thread details.`;
     }
     const thread = threadDetail.thread;
+    const representativeLabel = clusterDetail.representativeNumber !== null && clusterDetail.representativeKind !== null
+        ? ` (#${clusterDetail.representativeNumber} representative ${clusterDetail.representativeKind === 'pull_request' ? 'pr' : 'issue'})`
+        : '';
     const labels = thread.labels.length > 0 ? escapeBlessedText(thread.labels.join(', ')) : 'none';
+    const closedLabel = thread.isClosed
+        ? `{bold}Closed:{/bold} ${escapeBlessedText(thread.closedAtLocal ?? thread.closedAtGh ?? 'yes')} ${thread.closeReasonLocal ? `(${escapeBlessedText(thread.closeReasonLocal)})` : ''}`.trimEnd()
+        : '{bold}Closed:{/bold} no';
     const summaries = Object.entries(threadDetail.summaries)
         .map(([key, value]) => `{bold}${key}:{/bold}\n${escapeBlessedText(value)}`)
         .join('\n\n');
@@ -710,9 +939,12 @@ export function renderDetailPane(threadDetail, clusterDetail, focusPane) {
             ? 'No neighbors available.'
             : 'Neighbors load when the detail pane is focused.';
     return [
+        `{bold}Cluster ${clusterDetail.clusterId}${escapeBlessedText(representativeLabel)}{/bold}`,
+        '',
         `{bold}${thread.kind} #${thread.number}{/bold}  ${escapeBlessedText(thread.title)}`,
         '',
         `{bold}Author:{/bold} ${escapeBlessedText(thread.authorLogin ?? 'unknown')}`,
+        closedLabel,
         `{bold}Updated:{/bold} ${thread.updatedAtGh ?? 'unknown'}`,
         `{bold}Labels:{/bold} ${labels}`,
         `{bold}URL:{/bold} ${escapeBlessedText(thread.htmlUrl)}`,
@@ -789,6 +1021,123 @@ export function buildUpdatePipelineLabels(stats, selection, now = new Date()) {
         return `${mark} ${title}  ${describeUpdateTask(task, stats, now)}`;
     });
 }
+export function buildHelpContent() {
+    return [
+        '{bold}ghcrawl TUI Help{/bold}',
+        '',
+        '{bold}Navigation{/bold}',
+        'Tab / Shift-Tab  cycle focus across clusters, members, and detail',
+        'Left / Right      cycle focus backward or forward across panes',
+        'Up / Down         move selection, or scroll detail when detail is focused',
+        'Enter             clusters -> members, members -> detail',
+        'PgUp / PgDn       page through the focused pane or this help popup faster',
+        'Home / End        jump to the top or bottom of detail or help',
+        '',
+        '{bold}Views And Filters{/bold}',
+        's                 cycle cluster sort mode',
+        'f                 cycle minimum cluster size filter',
+        'l                 toggle wide layout: columns vs. wide-left stacked-right',
+        'x                 show or hide locally closed clusters and members',
+        '/                 filter clusters by title/member text',
+        'r                 refresh the current local view from SQLite',
+        '',
+        '{bold}Actions{/bold}',
+        'g                 open the staged update pipeline (GitHub, embeddings, clusters)',
+        'p                 open the repository browser / sync a new repository',
+        'u                 show all open threads for the selected author',
+        'o                 open the selected thread URL in your browser',
+        '',
+        '{bold}Help And Exit{/bold}',
+        'h or ?            open this help popup',
+        'q                 quit the TUI (or close this popup)',
+        'Esc               close this popup',
+        '',
+        '{bold}Notes{/bold}',
+        'Clusters show C<clusterId> so the cluster id is easy to copy into CLI or skill flows.',
+        'The footer only shows the short command list. Open help to see the full list.',
+        'This popup scrolls. Use arrows, PgUp/PgDn, Home, and End if it does not fit.',
+    ].join('\n');
+}
+async function promptHelp(screen) {
+    const modalWidth = '86%';
+    const box = blessed.box({
+        parent: screen,
+        border: 'line',
+        label: ' Help ',
+        tags: true,
+        scrollable: true,
+        alwaysScroll: true,
+        keys: true,
+        vi: true,
+        mouse: false,
+        top: 'center',
+        left: 'center',
+        width: modalWidth,
+        height: '80%',
+        padding: {
+            left: 1,
+            right: 1,
+        },
+        scrollbar: {
+            ch: ' ',
+        },
+        style: {
+            border: { fg: '#5bc0eb' },
+            fg: 'white',
+            bg: '#101522',
+            scrollbar: { bg: '#5bc0eb' },
+        },
+        content: buildHelpContent(),
+    });
+    const help = blessed.box({
+        parent: screen,
+        width: modalWidth,
+        height: 1,
+        bottom: 1,
+        left: 'center',
+        tags: false,
+        content: 'Scroll with arrows, PgUp/PgDn, Home, End. Press Esc, q, h, ?, or Enter to close.',
+        style: { fg: 'black', bg: '#5bc0eb' },
+    });
+    box.focus();
+    box.setScroll(0);
+    screen.render();
+    return await new Promise((resolve) => {
+        const finish = () => {
+            screen.off('keypress', handleKeypress);
+            box.destroy();
+            help.destroy();
+            screen.render();
+            resolve();
+        };
+        const handleKeypress = (char, key) => {
+            if (key.name === 'escape' || key.name === 'enter' || key.name === 'q' || key.name === 'h' || char === '?') {
+                finish();
+                return;
+            }
+            if (key.name === 'pageup') {
+                box.scroll(-12);
+                screen.render();
+                return;
+            }
+            if (key.name === 'pagedown') {
+                box.scroll(12);
+                screen.render();
+                return;
+            }
+            if (key.name === 'home') {
+                box.setScroll(0);
+                screen.render();
+                return;
+            }
+            if (key.name === 'end') {
+                box.setScrollPerc(100);
+                screen.render();
+            }
+        };
+        screen.on('keypress', handleKeypress);
+    });
+}
 async function promptUpdatePipelineSelection(screen, stats) {
     const selection = { sync: true, embed: true, cluster: true };
     const modalWidth = '76%';
@@ -818,7 +1167,7 @@ async function promptUpdatePipelineSelection(screen, stats) {
         height: 4,
         style: { fg: 'white', bg: '#101522' },
         content: 'Usually you want all three. Run order is fixed: GitHub sync/reconcile -> embeddings -> clusters.\n' +
-            'Toggle with space, move with j/k or arrows, Enter to start, Esc to cancel.',
+            'Toggle with space, move with arrows, Enter to start, Esc to cancel.',
     });
     box.focus();
     box.select(0);
@@ -842,7 +1191,7 @@ async function promptUpdatePipelineSelection(screen, stats) {
             resolve(value);
         };
         const handleKeypress = (_char, key) => {
-            if (key.name === 'escape') {
+            if (key.name === 'escape' || key.name === 'q') {
                 finish(null);
                 return;
             }
@@ -875,6 +1224,67 @@ export function getRepositoryChoices(service, now = new Date()) {
         { kind: 'new', label: '+ Sync a new repository' },
     ];
 }
+async function promptAuthorThreadChoice(screen, authorLogin, threads) {
+    const choices = threads.map((item) => {
+        const match = item.strongestSameAuthorMatch;
+        const matchLabel = match ? `  sim:${(match.score * 100).toFixed(1)}% -> #${match.number}` : '  sim:none';
+        const clusterLabel = item.thread.clusterId ? `C${item.thread.clusterId}` : 'C-';
+        return {
+            threadId: item.thread.id,
+            clusterId: item.thread.clusterId,
+            label: `#${item.thread.number} ${item.thread.kind === 'pull_request' ? 'pr' : 'issue'} ${clusterLabel}${matchLabel}  ${item.thread.title}`,
+        };
+    });
+    const box = blessed.list({
+        parent: screen,
+        border: 'line',
+        label: ` @${authorLogin} Threads `,
+        keys: true,
+        vi: true,
+        mouse: false,
+        top: 'center',
+        left: 'center',
+        width: '80%',
+        height: '70%',
+        style: {
+            border: { fg: '#fde74c' },
+            item: { fg: 'white' },
+            selected: { bg: '#fde74c', fg: 'black', bold: true },
+        },
+        items: choices.length > 0 ? choices.map((choice) => choice.label) : ['No open threads for this author'],
+    });
+    const help = blessed.box({
+        parent: screen,
+        bottom: 0,
+        left: 0,
+        width: '100%',
+        height: 1,
+        content: 'Enter jumps to the selected thread. Esc cancels.',
+        style: { fg: 'black', bg: '#fde74c' },
+    });
+    box.focus();
+    box.select(0);
+    screen.render();
+    return await new Promise((resolve) => {
+        const teardown = () => {
+            screen.off('keypress', handleKeypress);
+            box.destroy();
+            help.destroy();
+            screen.render();
+        };
+        const finish = (value) => {
+            teardown();
+            resolve(value);
+        };
+        const handleKeypress = (_char, key) => {
+            if (key.name === 'escape' || key.name === 'q') {
+                finish(null);
+            }
+        };
+        screen.on('keypress', handleKeypress);
+        box.on('select', (_item, index) => finish(choices[index] ?? null));
+    });
+}
 async function promptRepositoryChoice(screen, service) {
     const choices = getRepositoryChoices(service);
     const box = blessed.list({
@@ -919,7 +1329,7 @@ async function promptRepositoryChoice(screen, service) {
             resolve(value);
         };
         const handleKeypress = (_char, key) => {
-            if (key.name === 'escape') {
+            if (key.name === 'escape' || key.name === 'q') {
                 finish(null);
                 return;
             }
@@ -989,6 +1399,7 @@ async function runColdStartSetup(service, screen, target, log, footer) {
             repo: target.repo,
             minClusterSize: 1,
             sortMode: 'recent',
+            wideLayout: 'columns',
         });
         log?.log('[setup] initial setup complete');
         return true;
@@ -1014,6 +1425,26 @@ function parseDateOrNull(value) {
     const parsed = Date.parse(value);
     return Number.isNaN(parsed) ? null : parsed;
 }
+export function formatClusterDateColumn(value, locales) {
+    if (!value)
+        return 'unknown';
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime()))
+        return value;
+    const month = String(parsed.getMonth() + 1).padStart(2, '0');
+    const day = String(parsed.getDate()).padStart(2, '0');
+    const hour = String(parsed.getHours()).padStart(2, '0');
+    const minute = String(parsed.getMinutes()).padStart(2, '0');
+    const ordering = new Intl.DateTimeFormat(locales, {
+        month: '2-digit',
+        day: '2-digit',
+    })
+        .formatToParts(parsed)
+        .filter((part) => part.type === 'month' || part.type === 'day')
+        .map((part) => part.type);
+    const date = ordering[0] === 'day' ? `${day}-${month}` : `${month}-${day}`;
+    return `${date} ${hour}:${minute}`;
+}
 function formatAge(diffMs) {
     const safeDiffMs = Math.max(0, diffMs);
     const minuteMs = 60_000;