dsh-gitnexus-plus 0.1.4 → 0.1.5

package/lib/client.js

@@ -2444,6 +2444,10 @@ define("sections/maintenance", ["require", "exports", "react", "@deepseek-ai/dsh
         // install or the registry write. Refuse to start it and say why, rather than
         // leaving a button that is known to be wrong on this host.
         const hostCurrent = maintenance.supportsForce === true;
+        // A folder with no `.git` is indexable, but only with `--skip-git`, and GitNexus
+        // disables commit tracking and incremental updates for it. Calling that action an
+        // "incremental refresh" would describe a mode the index cannot have.
+        const skipGit = maintenance.skipGit === true;
         // Normalised rather than trusted. The declared type says `ClientAnalyzeRun | null`,
         // but a React element built without the prop arrives as `undefined` — which is
         // exactly what happened the first time this component was rendered by a caller that
@@ -2599,11 +2603,17 @@ define("sections/maintenance", ["require", "exports", "react", "@deepseek-ai/dsh
             // an index that already existed. Only the label and the "when" line are stateful;
             // the command itself is identical.
             const shown = command.mode === 'init' && indexed
-                ? {
-                    ...command,
-                    label: '增量刷新',
-                    when: '索引落后或有文件改动时使用；未变更文件的解析产物会复用。',
-                }
+                ? skipGit
+                    ? {
+                        ...command,
+                        label: '重新分析',
+                        when: '该目录不是 git 仓库：没有增量刷新，每次都会完整重分析；未变更文件的解析缓存仍会复用。',
+                    }
+                    : {
+                        ...command,
+                        label: '增量刷新',
+                        when: '索引落后或有文件改动时使用；未变更文件的解析产物会复用。',
+                    }
                 : command;
             return (0, primitives_7.h)('div', {
                 key: command.mode,
@@ -2632,9 +2642,17 @@ define("sections/maintenance", ["require", "exports", "react", "@deepseek-ai/dsh
                     ? '运行中'
                     : gateClean
                         ? '无需刷新'
-                        : hostCurrent
-                            ? '执行增量刷新'
-                            : '执行增量刷新（需重启）')
+                        : !indexed
+                            ? hostCurrent
+                                ? '初始化索引'
+                                : '初始化索引（需重启）'
+                            : skipGit
+                                ? hostCurrent
+                                    ? '执行重新分析'
+                                    : '执行重新分析（需重启）'
+                                : hostCurrent
+                                    ? '执行增量刷新'
+                                    : '执行增量刷新（需重启）')
                 : command.mode === 'repair-fts'
                     ? (0, primitives_7.h)(primitives_7.Button, { variant: 'ghost', disabled: running || !hostCurrent, onClick: () => setConfirming('repair-fts') }, running ? '运行中' : '修复搜索索引')
                     : hostCurrent
@@ -2670,12 +2688,21 @@ define("sections/maintenance", ["require", "exports", "react", "@deepseek-ai/dsh
         // and can take minutes, while the incremental path reuses unchanged files.
         (0, primitives_7.h)(primitives.RiskConfirmation, {
             open: confirming !== null,
-            title: repairConfirm ? '修复搜索索引（FTS）？' : fullConfirm ? '执行全量重建？' : '执行增量刷新？',
+            title: repairConfirm
+                ? '修复搜索索引（FTS）？'
+                : fullConfirm
+                    ? '执行全量重建？'
+                    : !indexed
+                        ? '初始化索引？'
+                        : skipGit
+                            ? '重新分析这个目录？'
+                            : '执行增量刷新？',
             description: repairConfirm
                 ? '将执行：\n\n' +
                     (confirmCommand?.shell ?? 'gitnexus analyze --index-only --repair-fts') +
                     '\n\n' +
                     '只重建搜索索引（FTS），不重跑分析、不改图，耗时通常在秒级。' +
+                    (skipGit ? '该目录没有 .git，命令带 --skip-git。' : '') +
                     '只写入 .gitnexus/，不改动源文件。' +
                     '如果 FTS 扩展文件本身缺失（Windows 上常见），修复也会失败 —— 那是上游安装问题，不是索引坏了。' +
                     '命令由 DSH 的 shell 执行器运行，沙箱与其它命令一致 —— 本插件不申请扩权。'
@@ -2686,20 +2713,32 @@ define("sections/maintenance", ["require", "exports", "react", "@deepseek-ai/dsh
                         '这会重建图与 FTS；未变更文件的解析产物仍会复用。' +
                         '但耗时以分钟计，索引很大时更久（上限 10 分钟，可随时取消）。' +
                         '重建期间索引可能短暂不可用。' +
+                        (skipGit ? '该目录没有 .git，命令带 --skip-git；重建后仍没有提交基线与增量刷新。' : '') +
                         '只写入 .gitnexus/，不改动源文件，也不会重写 AGENTS.md / CLAUDE.md。' +
                         '命令由 DSH 的 shell 执行器运行，沙箱与其它命令一致 —— 本插件不申请扩权。'
                     : '将在项目目录下运行：\n\n' +
                         (confirmCommand?.shell ?? 'gitnexus analyze --index-only') +
                         '\n\n' +
                         '只写入 .gitnexus/，不改动任何源文件，也不会重写 AGENTS.md / CLAUDE.md。' +
-                        '耗时取决于改动量：无改动时约 7 秒，改动几个文件时实测可到 3 分钟，' +
-                        '大仓库的初始化或刷新可能更久（上限 10 分钟，可随时取消）。' +
+                        (skipGit
+                            ? '该目录没有 .git，命令带 --skip-git：GitNexus 会直接索引这个目录，' +
+                                '但没有提交基线，也没有增量刷新 —— 每次都会完整重分析，也不会有 Git 活动。'
+                            : '耗时取决于改动量：无改动时约 7 秒，改动几个文件时实测可到 3 分钟，' +
+                                '大仓库的初始化或刷新可能更久（上限 10 分钟，可随时取消）。') +
                         '命令由 DSH 的 shell 执行器运行，沙箱与其它命令一致 —— 本插件不申请扩权。',
             acknowledgeLabel: fullConfirm
                 ? '我了解这会重建图与 FTS、耗时数分钟，并可能让索引短暂不可用'
                 : '我了解这会运行一个进程并写入 .gitnexus/',
             cancelLabel: '取消',
-            confirmLabel: repairConfirm ? '开始修复' : fullConfirm ? '开始重建' : '执行',
+            confirmLabel: repairConfirm
+                ? '开始修复'
+                : fullConfirm
+                    ? '开始重建'
+                    : !indexed
+                        ? '开始初始化'
+                        : skipGit
+                            ? '开始重新分析'
+                            : '执行',
             closeLabel: '关闭',
             // The checkbox is controlled, so it needs state of its own, and it is reset on
             // close: the acknowledgement is per-action rather than remembered.
@@ -2993,10 +3032,57 @@ define("sections/search", ["require", "exports", "primitives"], function (requir
 define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-ui-primitives", "format", "navigation", "primitives", "sections/overview", "sections/activity", "sections/capabilities", "sections/install", "sections/languages", "sections/large-files", "sections/maintenance", "sections/search", "sections/graph"], function (require, exports, React, primitives, format_10, navigation_3, primitives_11, overview_1, activity_1, capabilities_2, install_1, languages_1, large_files_1, maintenance_1, search_1, graph_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
+    exports.chooseProject = chooseProject;
     exports.LoadingBar = LoadingBar;
     exports.CoverageView = CoverageView;
     exports.CoveragePanel = CoveragePanel;
     exports.CoverageTitle = CoverageTitle;
+    /**
+     * Pick the project a workspace opens on.
+     *
+     * An explicit remembered choice wins while it still exists. Otherwise an indexed
+     * project is preferred over an unindexed git repository, and the workspace's own index
+     * wins over a descendant. A workspace with no indexes opens on the workspace itself —
+     * the scan-only state, with the unindexed git projects available in the switcher.
+     */
+    function chooseProject(projects, workspace, remembered) {
+        if (remembered !== null) {
+            const hit = projects.find((project) => project.path === remembered);
+            if (hit !== undefined)
+                return hit.path;
+        }
+        const selfIndex = projects.find((project) => project.direction === 'self' && project.kind === 'index');
+        if (selfIndex !== undefined)
+            return selfIndex.path;
+        const indexed = projects.find((project) => project.kind === 'index');
+        if (indexed !== undefined)
+            return indexed.path;
+        const self = projects.find((project) => project.direction === 'self');
+        if (self !== undefined)
+            return self.path;
+        return projects[0]?.path ?? workspace;
+    }
+    const ACTIVE_PROJECT_KEY = 'dsh-gitnexus-plus:active-project:';
+    function readRememberedProject(workspace) {
+        try {
+            if (typeof localStorage === 'undefined')
+                return null;
+            return localStorage.getItem(`${ACTIVE_PROJECT_KEY}${workspace}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    function rememberProject(workspace, project) {
+        try {
+            if (typeof localStorage === 'undefined')
+                return;
+            localStorage.setItem(`${ACTIVE_PROJECT_KEY}${workspace}`, project);
+        }
+        catch {
+            /* storage may be unavailable in a hardened webview; selection stays in memory */
+        }
+    }
     /**
      * Whether two polled run snapshots say the same thing.
      *
@@ -3055,17 +3141,62 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
             },
         }), (0, primitives_11.h)('div', { style: { ...primitives_11.MUTED, fontSize: '10px' } }, text));
     }
-    function CoverageView({ report, maintenance, projectPath, context, busy, progress, error, readAt, run, runError, delta, deltaError, deltaRoute, onRefresh, onStartRun, onCancelRun, installRun, installError, onInstall, onCancelInstall, search, graph, }) {
+    function CoverageView({ report, maintenance, projectPath, workspacePath, projects, projectsVisited, projectsTruncated, projectsError, onSelectProject, context, busy, progress, error, readAt, run, runError, delta, deltaError, deltaRoute, onRefresh, onStartRun, onCancelRun, installRun, installError, onInstall, onCancelInstall, search, graph, }) {
         // Whether an index exists decides which maintenance command is applicable. When
         // the project could not even be identified there is nothing to claim, so it is
         // false rather than assumed.
         const indexed = report?.repo?.indexed === true;
-        const header = (0, primitives_11.h)(primitives_11.Row, null, report !== null && report.repo?.indexed ? (0, primitives_11.h)(primitives_11.StateDot, { state: (0, format_10.healthState)(report) }) : null, (0, primitives_11.h)('span', { style: { fontWeight: 600 } }, 'GitNexus 索引'), 
-        // The project, not a picker. Shown so the reader can confirm which tree the
-        // numbers describe — a path is the only unambiguous answer to that.
+        // A maintenance payload with no commands is not a section: rendering its title
+        // produced an empty card on failed reads and on hosts that predate the route.
+        const maintenanceSection = maintenance !== null &&
+            maintenance !== undefined &&
+            Array.isArray(maintenance.commands) &&
+            maintenance.commands.length > 0
+            ? maintenance
+            : null;
+        // The workspace and the active project are different facts when the index lives in a
+        // subdirectory. The path position becomes a switcher when there is more than one.
+        const projectChoices = projects ?? [];
+        const indexedProjectCount = projectChoices.filter((project) => project.kind === 'index').length;
+        const gitProjectCount = projectChoices.filter((project) => project.kind === 'git').length;
+        const projectLabel = (project) => {
+            const base = project.relPath === ''
+                ? `${project.name}（本工作区）`
+                : project.relPath === project.name
+                    ? project.name
+                    : `${project.name} — ${project.relPath}`;
+            return project.kind === 'git' ? `${base}（未索引）` : base;
+        };
+        const activeInChoices = projectChoices.some((project) => project.path === projectPath);
+        const showSwitcher = projectChoices.length > 1 &&
+            activeInChoices &&
+            onSelectProject !== undefined &&
+            projectPath !== null;
+        const activeDiffers = projectPath !== null && workspacePath !== null && projectPath !== workspacePath;
+        const header = (0, primitives_11.h)('div', { style: { display: 'flex', flexDirection: 'column', gap: '3px', minWidth: 0 } }, (0, primitives_11.h)(primitives_11.Row, null, report !== null && report.repo?.indexed ? (0, primitives_11.h)(primitives_11.StateDot, { state: (0, format_10.healthState)(report) }) : null, (0, primitives_11.h)('span', { style: { fontWeight: 600 } }, 'GitNexus 索引'), 
+        // The project, not a global picker. A workspace-scoped switcher is the one
+        // selection this panel offers; it changes what the cards describe, nothing else.
         projectPath === null
             ? (0, primitives_11.h)('span', { style: primitives_11.MUTED }, '未解析到工作区')
-            : (0, primitives_11.h)('span', { style: { minWidth: 0, flex: '1 1 auto' } }, (0, primitives_11.h)(primitives_11.PathLabel, { path: projectPath })), (0, primitives_11.h)('span', { style: { flex: 1 } }), 
+            : showSwitcher
+                ? (0, primitives_11.h)('span', { style: { display: 'flex', alignItems: 'center', gap: '2px', minWidth: 0, flex: '1 1 auto' } }, (0, primitives_11.h)('select', {
+                    value: projectPath,
+                    onChange: (event) => onSelectProject?.(event.target.value),
+                    'aria-label': '切换工作区内的 GitNexus 索引',
+                    title: `工作区：${workspacePath ?? ''} · ${projectChoices.length} 个索引`,
+                    style: {
+                        appearance: 'none',
+                        border: 0,
+                        background: 'transparent',
+                        color: 'inherit',
+                        font: 'inherit',
+                        minWidth: 0,
+                        maxWidth: '100%',
+                        padding: 0,
+                        cursor: 'pointer',
+                    },
+                }, projectChoices.map((project) => (0, primitives_11.h)('option', { key: project.path, value: project.path }, projectLabel(project)))), (0, primitives_11.h)('span', { style: { ...primitives_11.MUTED, fontSize: '10px' } }, '▾'))
+                : (0, primitives_11.h)('span', { style: { minWidth: 0, flex: '1 1 auto' } }, (0, primitives_11.h)(primitives_11.PathLabel, { path: projectPath })), (0, primitives_11.h)('span', { style: { flex: 1 } }), 
         // The label states the scope. "刷新" alone next to a staleness warning reads as
         // "rebuild the index", which this control has never done and — by design, since
         // the plugin spawns nothing — cannot do.
@@ -3075,7 +3206,30 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
             disabled: busy,
             title: '重新读取报告（不会重建索引；重建见下方「维护命令」）',
             'aria-label': '重新读取报告',
-        }, (0, primitives_11.h)(primitives_11.IconRefreshOutlineRegular, { size: 14 })));
+        }, (0, primitives_11.h)(primitives_11.IconRefreshOutlineRegular, { size: 14 }))), showSwitcher ||
+            activeDiffers ||
+            projectsTruncated === true ||
+            (projectsError !== null && projectsError !== undefined)
+            ? (0, primitives_11.h)('div', { style: { ...primitives_11.MUTED, fontSize: '11px', minWidth: 0, overflowWrap: 'anywhere' } }, [
+                showSwitcher
+                    ? `工作区：${workspacePath ?? ''} · ${projectChoices.length} 个项目` +
+                        (indexedProjectCount > 0
+                            ? `（${indexedProjectCount} 个已索引）`
+                            : gitProjectCount > 0
+                                ? `（${gitProjectCount} 个 git 项目未索引）`
+                                : '') +
+                        ` · 当前 ${projectPath ?? ''}`
+                    : activeDiffers
+                        ? `工作区：${workspacePath ?? ''} · 当前 ${projectPath ?? ''}`
+                        : null,
+                projectsTruncated === true ? '项目搜索达到上限，可能还有未列出的项目。' : null,
+                projectsError !== null && projectsError !== undefined
+                    ? `项目列表读取失败：${projectsError}`
+                    : null,
+            ]
+                .filter((line) => line !== null)
+                .join(' '))
+            : null);
         // A report already on screen stays readable while a manual refresh runs; the bar
         // rides above it. Before the first report exists, the bar is the whole body.
         // `percent` is null when the host does not stream (old host, or a cached read):
@@ -3097,14 +3251,14 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                 : (0, primitives_11.h)(primitives_11.Section, { wide: true, title: '面板收到的上下文' }, (0, primitives_11.h)('div', { style: { display: 'flex', flexDirection: 'column', gap: '3px' } }, (0, primitives_11.h)('div', null, `存在：${context.present.length > 0 ? context.present.join('、') : '（无）'}`), (0, primitives_11.h)('div', null, `缺失：${context.absent.length > 0 ? context.absent.join('、') : '（无）'}`))));
         }
         if (error !== null) {
-            return (0, primitives_11.h)('div', { style: primitives_11.styles.root }, header, (0, primitives_11.h)(primitives_11.Section, { wide: true, style: { display: 'flex', gap: '8px', alignItems: 'flex-start' } }, (0, primitives_11.h)(primitives_11.StateDot, { state: 'error' }), (0, primitives_11.h)('span', null, error)), maintenance === null || maintenance === undefined
-                ? null
-                : (0, primitives_11.h)(primitives_11.Section, {
+            return (0, primitives_11.h)('div', { style: primitives_11.styles.root }, header, (0, primitives_11.h)(primitives_11.Section, { wide: true, style: { display: 'flex', gap: '8px', alignItems: 'flex-start' } }, (0, primitives_11.h)(primitives_11.StateDot, { state: 'error' }), (0, primitives_11.h)('span', null, error)), maintenanceSection !== null
+                ? (0, primitives_11.h)(primitives_11.Section, {
                     wide: true,
                     title: '维护命令',
                     meta: (0, primitives_11.h)('span', { style: { ...primitives_11.MUTED, fontSize: '12px' } }, '复制后到会话执行（沙箱与提权由 DSH 处理）'),
                     scroll: 320,
-                }, (0, primitives_11.h)(maintenance_1.MaintenanceSection, { maintenance, projectPath, indexed: false, run, runError, delta, deltaError, deltaRoute, onStartRun, onCancelRun })));
+                }, (0, primitives_11.h)(maintenance_1.MaintenanceSection, { maintenance: maintenanceSection, projectPath, indexed: false, run, runError, delta, deltaError, deltaRoute, onStartRun, onCancelRun }))
+                : null);
         }
         if (report === null) {
             return (0, primitives_11.h)('div', { style: primitives_11.styles.root }, header, progressBar);
@@ -3134,22 +3288,32 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                 runError: installError,
                 onInstall,
                 onCancelInstall,
-            }), (0, primitives_11.h)('div', { style: { gridColumn: '1 / -1', display: 'flex', gap: '8px', alignItems: 'flex-start' } }, (0, primitives_11.h)(primitives_11.StateDot, { state: 'idle' }), (0, primitives_11.h)('span', null, '该项目还没有 GitNexus 索引。下面是工作区扫描结果；初始化后可看到图谱、查询能力与 Git 活动对账。')), (0, primitives_11.h)(primitives_11.Section, { wide: true, title: '扫描概览 · 尚未索引' }, (0, primitives_11.h)(primitives_11.MetricGrid, {
+            }), (0, primitives_11.h)('div', { style: { gridColumn: '1 / -1', display: 'flex', gap: '8px', alignItems: 'flex-start' } }, (0, primitives_11.h)(primitives_11.StateDot, { state: 'idle' }), (0, primitives_11.h)('div', { style: { display: 'flex', flexDirection: 'column', gap: '2px', minWidth: 0 } }, (0, primitives_11.h)('span', null, report.repo?.hasGit === false
+                ? '该目录不是 git 仓库，也没有 GitNexus 索引。下面是工作区扫描结果；仍可建立索引（--skip-git），但没有提交基线与增量刷新，也不会有 Git 活动。'
+                : '该项目还没有 GitNexus 索引。下面是工作区扫描结果；初始化后可看到图谱、查询能力与 Git 活动对账。'), Array.isArray(projects)
+                ? (0, primitives_11.h)('span', { style: { ...primitives_11.MUTED, fontSize: '11px' } }, projectsError !== null && projectsError !== undefined
+                    ? `项目列表读取失败：${projectsError}；已按工作区描述。`
+                    : indexedProjectCount === 0 && gitProjectCount > 0
+                        ? `已在 ${projectsVisited ?? 0} 个目录中查找；工作区内有 ${gitProjectCount} 个 git 项目尚未建索引，可在标题栏切换后初始化。`
+                        : indexedProjectCount === 0
+                            ? `已在 ${projectsVisited ?? 0} 个目录中查找，没有找到 GitNexus 索引或 git 仓库。`
+                            : null)
+                : null)), (0, primitives_11.h)(primitives_11.Section, { wide: true, title: '扫描概览 · 尚未索引' }, (0, primitives_11.h)(primitives_11.MetricGrid, {
                 items: [
                     { label: '扫描文件', value: (0, format_10.compactNumber)(totals.scanned) },
                     { label: '选中文件', value: (0, format_10.compactNumber)(totals.selected) },
                     { label: '扫描字节', value: (0, format_10.fileSize)(totals.scannedBytes ?? 0) },
                     { label: '大小上限', value: cap.text, hint: (0, format_10.capSourceLabel)(cap.source) },
                 ],
-            }), (0, primitives_11.h)('div', { style: { ...primitives_11.MUTED, marginTop: '6px' } }, '这里的数字来自工作区，不是索引；索引里有什么，只有建立后才能回答。')), languages !== null && languages.rows.length > 0 ? (0, primitives_11.h)(languages_1.MemoizedLanguageSection, { languages }) : null, maintenance === null || maintenance === undefined
-                ? null
-                : (0, primitives_11.h)(primitives_11.Section, {
+            }), (0, primitives_11.h)('div', { style: { ...primitives_11.MUTED, marginTop: '6px' } }, '这里的数字来自工作区，不是索引；索引里有什么，只有建立后才能回答。')), languages !== null && languages.rows.length > 0 ? (0, primitives_11.h)(languages_1.MemoizedLanguageSection, { languages }) : null, maintenanceSection !== null
+                ? (0, primitives_11.h)(primitives_11.Section, {
                     wide: true,
                     title: '初始化索引',
-                    meta: (0, primitives_11.h)('span', { style: { ...primitives_11.MUTED, fontSize: '11px' } }, maintenance.supportsForce === true
+                    meta: (0, primitives_11.h)('span', { style: { ...primitives_11.MUTED, fontSize: '11px' } }, maintenanceSection.supportsForce === true
                         ? '均可直接执行，也可复制到会话（沙箱与提权由 DSH 处理）'
                         : '重启 DSH 后可执行；当前仅可复制（沙箱与提权由 DSH 处理）'),
-                }, (0, primitives_11.h)(maintenance_1.MaintenanceSection, { maintenance, projectPath, indexed, run, runError, delta, deltaError, deltaRoute, onStartRun, onCancelRun })));
+                }, (0, primitives_11.h)(maintenance_1.MaintenanceSection, { maintenance: maintenanceSection, projectPath, indexed, run, runError, delta, deltaError, deltaRoute, onStartRun, onCancelRun }))
+                : null);
         }
         return (0, primitives_11.h)('div', { style: primitives_11.styles.root }, 
         // The header and the two status lines span everything: they describe the whole
@@ -3333,18 +3497,18 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                 onDaysChange: setActivityDays,
             })), 
         // Wide, and always open: the commands are the action this panel offers.
-        maintenance === null || maintenance === undefined
-            ? null
-            : (0, primitives_11.h)(primitives_11.Section, {
+        maintenanceSection !== null
+            ? (0, primitives_11.h)(primitives_11.Section, {
                 wide: true,
                 title: '维护命令',
-                meta: (0, primitives_11.h)('span', { style: { ...primitives_11.MUTED, fontSize: '12px' } }, `${maintenance.commands?.length ?? 0} 条 · ` +
-                    (maintenance.supportsForce === true
+                meta: (0, primitives_11.h)('span', { style: { ...primitives_11.MUTED, fontSize: '12px' } }, `${maintenanceSection.commands?.length ?? 0} 条 · ` +
+                    (maintenanceSection.supportsForce === true
                         ? '均可直接执行，也可复制到会话'
                         : '重启 DSH 后可执行；当前仅可复制') +
                     '（沙箱与提权由 DSH 处理）'),
                 scroll: 360,
-            }, (0, primitives_11.h)(maintenance_1.MaintenanceSection, { maintenance, projectPath, indexed, run, runError, delta, deltaError, deltaRoute, onStartRun, onCancelRun })));
+            }, (0, primitives_11.h)(maintenance_1.MaintenanceSection, { maintenance: maintenanceSection, projectPath, indexed, run, runError, delta, deltaError, deltaRoute, onStartRun, onCancelRun }))
+            : null);
     }
     /**
      * Stateful wrapper: resolves the current project, loads its coverage.
@@ -3356,11 +3520,36 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
      * @param {{params?: {repo?: string}, sessionId?: string, useWorkspaces?: Function}} props
      */
     function CoveragePanel(props) {
-        const projectPath = (0, navigation_3.useProjectPath)(props);
+        // The path the operator opened. It is the search root for the project list; the
+        // active project may be the workspace itself or one of its descendants.
+        const workspacePath = (0, navigation_3.useProjectPath)(props);
         const sessionId = typeof props.sessionId === 'string' ? props.sessionId : null;
-        const [report, setReport] = React.useState(null);
-        const [maintenance, setMaintenance] = React.useState(null);
-        const [error, setError] = React.useState(null);
+        const [rawReport, setRawReport] = React.useState(null);
+        const [rawMaintenance, setRawMaintenance] = React.useState(null);
+        const [rawError, setRawError] = React.useState(null);
+        /** The project the current report belongs to. */
+        const [reportProject, setReportProject] = React.useState(null);
+        const [projectList, setProjectList] = React.useState(null);
+        /** The workspace `projectList` was resolved for. Guards against a workspace switch. */
+        const [projectListFor, setProjectListFor] = React.useState(null);
+        const [activeProject, setActiveProject] = React.useState(null);
+        const [projectsError, setProjectsError] = React.useState(null);
+        const [resolving, setResolving] = React.useState(false);
+        /**
+         * Bumped after the project list resolves, so the coverage effect waits for it.
+         * Without this, a manual refresh would read coverage for the old active project
+         * while the resolve was still deciding whether that project still exists.
+         */
+        const [loadToken, setLoadToken] = React.useState(0);
+        const projectsReady = projectListFor === workspacePath;
+        const visibleProjects = projectsReady ? projectList?.projects ?? [] : undefined;
+        const projectPath = activeProject ?? workspacePath;
+        const reportVisible = reportProject === projectPath;
+        const report = reportVisible ? rawReport : null;
+        const maintenance = reportVisible ? rawMaintenance : null;
+        const error = reportVisible ? rawError : null;
+        /** The graph is only meaningful for an index; a scan-only project has no projection. */
+        const graphAvailable = report?.repo?.indexed === true;
         const [busy, setBusy] = React.useState(false);
         const [progress, setProgress] = React.useState(null);
         const [reloadToken, setReloadToken] = React.useState(0);
@@ -3388,6 +3577,8 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
         // "not run yet" rather than as a failure.
         const [run, setRun] = React.useState(null);
         const [runError, setRunError] = React.useState(null);
+        /** Which project the run status belongs to; a switch must not show it elsewhere. */
+        const [runProject, setRunProject] = React.useState(null);
         /** The Tier 0 verdict, or null while unknown (no route on this host, or not read yet). */
         const [delta, setDelta] = React.useState(null);
         const [deltaError, setDeltaError] = React.useState(null);
@@ -3398,6 +3589,8 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
          * gate and no explanation. Same lesson as the graph card: absent is a state to name.
          */
         const [deltaRoute, setDeltaRoute] = React.useState('unknown');
+        /** Which project the current gate reading belongs to, so a switch can clear it. */
+        const deltaRepoRef = React.useRef(null);
         /** The bounded graph projection, its scope, and the load state around it. */
         const [graphProjection, setGraphProjection] = React.useState(null);
         const [graphLoading, setGraphLoading] = React.useState(false);
@@ -3412,7 +3605,9 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
         const [graphRoute, setGraphRoute] = React.useState('unknown');
         const [graphScope, setGraphScope] = React.useState(null);
         const [graphReload, setGraphReload] = React.useState(0);
-        const running = run?.state === 'running';
+        /** Which project the current projection belongs to, so a switch can clear it. */
+        const graphRepoRef = React.useRef(null);
+        const running = run?.state === 'running' && runProject === projectPath;
         /**
          * Poll while a run is in flight.
          *
@@ -3433,6 +3628,7 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                     const next = body.run ?? null;
                     // Polls fire every second; only a changed verdict should re-render the report.
                     setRun((previous) => (sameRun(previous, next) ? previous : next));
+                    setRunProject(projectPath);
                     // A finished run changed the index, so the report on screen is now a reading of
                     // the previous one. This is the whole reason the run was started.
                     if (next !== null && next.state !== 'running')
@@ -3454,6 +3650,7 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
             if (projectPath === null)
                 return;
             setRunError(null);
+            setRunProject(projectPath);
             try {
                 // One request, three modes. Sending them as flags rather than a body keeps the
                 // operation visible in the URL the host logs alongside the command it ran.
@@ -3463,6 +3660,7 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                 if (!body?.ok)
                     throw new Error(body?.message ?? `请求失败 (${res.status})`);
                 setRun(body.run ?? null);
+                setRunProject(projectPath);
             }
             catch (cause) {
                 setRunError(String(cause?.message ?? cause));
@@ -3471,6 +3669,7 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
         const cancelRun = React.useCallback(async () => {
             if (projectPath === null)
                 return;
+            setRunProject(projectPath);
             try {
                 const res = await fetch((0, navigation_3.routeUrl)(`/api/gitnexus/analyze?repo=${encodeURIComponent(projectPath)}`), {
                     method: 'DELETE',
@@ -3717,13 +3916,93 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
             void startRun('refresh');
         }, [installRun, projectPath, report, startRun]);
         React.useEffect(() => {
-            if (projectPath === null)
+            if (workspacePath === null)
                 return undefined;
             const controller = new AbortController();
+            setResolving(true);
+            setProjectsError(null);
+            // A workspace switch must not leave the previous project's report on screen. A
+            // refresh of the same workspace keeps it readable while the list is re-read.
+            if (projectListFor !== workspacePath) {
+                setRawReport(null);
+                setRawMaintenance(null);
+                setRawError(null);
+                setReadAt(null);
+                setReportProject(null);
+                setActiveProject(null);
+            }
+            void (async () => {
+                try {
+                    const res = await fetch((0, navigation_3.routeUrl)(`/api/gitnexus/projects?root=${encodeURIComponent(workspacePath)}`), { signal: controller.signal });
+                    const body = (await res.json().catch(() => null));
+                    if (!res.ok || body?.ok !== true || !Array.isArray(body.projects)) {
+                        throw new Error(body?.message ?? `读取项目列表失败 (${res.status})`);
+                    }
+                    if (controller.signal.aborted)
+                        return;
+                    const list = {
+                        root: workspacePath,
+                        projects: body.projects,
+                        visited: typeof body.visited === 'number' ? body.visited : 0,
+                        truncated: body.truncated === true,
+                    };
+                    setProjectList(list);
+                    setProjectListFor(workspacePath);
+                    const remembered = readRememberedProject(workspacePath);
+                    const next = chooseProject(list.projects, workspacePath, remembered);
+                    setActiveProject(next);
+                    if (remembered !== null && next !== remembered && list.truncated !== true) {
+                        // The remembered project disappeared; persist the fallback so the next open
+                        // does not look for it again. A truncated walk never proves it disappeared:
+                        // it may simply not have reached it before the bound, so keep the preference
+                        // and let a later complete resolve restore it.
+                        rememberProject(workspacePath, next);
+                    }
+                    setLoadToken((n) => n + 1);
+                }
+                catch (cause) {
+                    if (controller.signal.aborted)
+                        return;
+                    setProjectsError(String(cause?.message ?? cause));
+                    // First load: fall back to scanning the workspace. A refresh keeps the list
+                    // already on screen; a transient resolve failure should not remove it.
+                    if (projectListFor !== workspacePath) {
+                        setProjectList({ root: workspacePath, projects: [], visited: 0, truncated: false });
+                        setProjectListFor(workspacePath);
+                        setActiveProject(workspacePath);
+                    }
+                    setLoadToken((n) => n + 1);
+                }
+                finally {
+                    if (!controller.signal.aborted)
+                        setResolving(false);
+                }
+            })();
+            return () => controller.abort();
+        }, [workspacePath, reloadToken]);
+        React.useEffect(() => {
+            if (activeProject === null || workspacePath === null)
+                return undefined;
+            // Wait until the resolve has produced the list for this workspace. A manual
+            // refresh bumps loadToken after the resolve, so coverage never reads the old
+            // active project while the list is still being decided.
+            if (projectListFor !== workspacePath || resolving)
+                return undefined;
+            const controller = new AbortController();
+            // A project switch must not leave the previous report, maintenance payload or
+            // read time under the new path. A refresh of the same project keeps them readable
+            // while the new reading is fetched.
+            if (reportProject !== activeProject) {
+                setRawReport(null);
+                setRawMaintenance(null);
+                setRawError(null);
+                setReadAt(null);
+            }
             setBusy(true);
-            setError(null);
+            setRawError(null);
+            setReportProject(activeProject);
             setProgress({ percent: 0, label: '连接索引服务…' });
-            const query = `/api/gitnexus/coverage?repo=${encodeURIComponent(projectPath)}` +
+            const query = `/api/gitnexus/coverage?repo=${encodeURIComponent(activeProject)}` +
                 (wantsFresh ? '&refresh=1' : '') +
                 '&stream=1';
             const load = async () => {
@@ -3781,8 +4060,8 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                             throw new Error('读取中断：没有收到完整报告。');
                         if (controller.signal.aborted)
                             return;
-                        setReport(payload.report);
-                        setMaintenance(payload.maintenance ?? null);
+                        setRawReport(payload.report);
+                        setRawMaintenance(payload.maintenance ?? null);
                         setReadAt(typeof payload.readAt === 'string' ? payload.readAt : new Date().toISOString());
                         return;
                     }
@@ -3795,16 +4074,16 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                     // point of leading with the initialize command is that reaching it is
                     // expected on a project that has never been analysed.
                     if (res.status === 404 && body?.code === 'not-indexed') {
-                        setReport({ repo: { indexed: false, path: projectPath } });
-                        setMaintenance(null);
+                        setRawReport({ repo: { indexed: false, path: activeProject } });
+                        setRawMaintenance(null);
                         setReadAt(body?.readAt ?? new Date().toISOString());
                         return;
                     }
                     if (!body?.ok || body.report === undefined) {
                         throw new Error(body?.message ?? `请求失败 (${res.status})`);
                     }
-                    setReport(body.report);
-                    setMaintenance(body.maintenance ?? null);
+                    setRawReport(body.report);
+                    setRawMaintenance(body.maintenance ?? null);
                     setReadAt(typeof body.readAt === 'string' ? body.readAt : new Date().toISOString());
                 }
                 catch (cause) {
@@ -3813,7 +4092,7 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                     const error = cause;
                     if (error?.name === 'AbortError')
                         return;
-                    setError(String(error?.message ?? cause));
+                    setRawError(String(error?.message ?? cause));
                 }
                 finally {
                     if (!controller.signal.aborted) {
@@ -3824,7 +4103,7 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
             };
             void load();
             return () => controller.abort();
-        }, [projectPath, reloadToken]);
+        }, [activeProject, projectListFor, workspacePath, loadToken, resolving]);
         /**
          * Read the Tier 0 verdict whenever the project or the index changes.
          *
@@ -3837,10 +4116,15 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
          * changed; there is no polling here for the same reason the run poll is conditional.
          */
         React.useEffect(() => {
-            if (projectPath === null) {
+            // A gate read for the previous project must not be shown under the new one. A
+            // refresh of the same project keeps the readable verdict while it is re-read.
+            if (deltaRepoRef.current !== projectPath) {
+                deltaRepoRef.current = projectPath;
                 setDelta(null);
                 setDeltaError(null);
                 setDeltaRoute('unknown');
+            }
+            if (projectPath === null) {
                 return undefined;
             }
             const controller = new AbortController();
@@ -3878,11 +4162,6 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
             })();
             return () => controller.abort();
         }, [projectPath, reloadToken]);
-        // A different project means the previous drill-down is another repository's
-        // community: keeping the scope would ask the new project for an id that cannot exist.
-        React.useEffect(() => {
-            setGraphScope(null);
-        }, [projectPath]);
         /**
          * Read the graph projection for the current scope.
          *
@@ -3895,14 +4174,40 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
          */
         React.useEffect(() => {
             if (projectPath === null) {
+                graphRepoRef.current = null;
+                setGraphProjection(null);
+                setGraphError(null);
+                setGraphLoading(false);
+                setGraphScope(null);
+                return undefined;
+            }
+            const projectChanged = graphRepoRef.current !== projectPath;
+            if (projectChanged) {
+                graphRepoRef.current = projectPath;
+                setGraphProjection(null);
+                setGraphError(null);
+                // The previous scope is another repository's community. Clearing it makes the
+                // next render fetch the overview instead of asking the new project for an id it
+                // cannot have.
+                setGraphScope(null);
+            }
+            if (!graphAvailable) {
                 setGraphProjection(null);
                 setGraphError(null);
+                setGraphLoading(false);
+                return undefined;
+            }
+            if (projectChanged && graphScope !== null) {
+                // The setGraphScope(null) above re-runs this effect; do not also fire a request
+                // for the old scope against the new project.
                 return undefined;
             }
             const controller = new AbortController();
             setGraphLoading(true);
-            const view = graphScope === null ? 'communities' : 'community';
-            const suffix = graphScope === null ? '' : `&id=${encodeURIComponent(graphScope)}`;
+            setGraphError(null);
+            const effectiveScope = projectChanged ? null : graphScope;
+            const view = effectiveScope === null ? 'communities' : 'community';
+            const suffix = effectiveScope === null ? '' : `&id=${encodeURIComponent(effectiveScope)}`;
             void (async () => {
                 try {
                     const res = await fetch((0, navigation_3.routeUrl)(`/api/gitnexus/graph?repo=${encodeURIComponent(projectPath)}&view=${view}${suffix}`), { signal: controller.signal });
@@ -3940,7 +4245,7 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                 }
             })();
             return () => controller.abort();
-        }, [projectPath, reloadToken, graphScope, graphReload]);
+        }, [projectPath, reloadToken, graphScope, graphReload, graphAvailable]);
         /**
          * Open a symbol node, with the same fallbacks the search hits use.
          *
@@ -3979,18 +4284,32 @@ define("views/panel", ["require", "exports", "react", "@deepseek-ai/dsh-client-u
                 setGraphError(`当前宿主没有可用的文件打开能力；位置：${text}`);
             }
         }, [sessionId]);
-        const fallbackMaintenance = React.useMemo(() => (maintenance === null && projectPath !== null ? { commands: [], rationale: [] } : maintenance), [maintenance, projectPath]);
+        const selectProject = React.useCallback((path) => {
+            if (workspacePath === null)
+                return;
+            setActiveProject(path);
+            setProjectsError(null);
+            rememberProject(workspacePath, path);
+        }, [workspacePath]);
+        const visibleRun = runProject === projectPath ? run : null;
+        const visibleRunError = runProject === projectPath ? runError : null;
         return (0, primitives_11.h)(CoverageView, {
             report,
-            maintenance: fallbackMaintenance,
+            maintenance,
             projectPath,
-            context: projectPath === null ? (0, navigation_3.contextDiagnostic)(props) : null,
-            busy,
-            progress,
+            workspacePath,
+            projects: visibleProjects,
+            projectsVisited: projectsReady ? projectList?.visited ?? 0 : undefined,
+            projectsTruncated: projectsReady ? projectList?.truncated === true : undefined,
+            projectsError: projectsReady ? projectsError : null,
+            onSelectProject: selectProject,
+            context: workspacePath === null ? (0, navigation_3.contextDiagnostic)(props) : null,
+            busy: busy || resolving,
+            progress: resolving ? { percent: 0, label: '正在查找项目索引…' } : progress,
             error,
             readAt,
-            run,
-            runError,
+            run: visibleRun,
+            runError: visibleRunError,
             delta,
             deltaError,
             deltaRoute,
@@ -4184,6 +4503,7 @@ define("index", ["require", "exports", "format", "navigation", "primitives", "se
         compactNumber: format_11.compactNumber,
         useProjectPath: navigation_4.useProjectPath,
         contextDiagnostic: navigation_4.contextDiagnostic,
+        chooseProject: panel_1.chooseProject,
         CoveragePanel: panel_1.CoveragePanel,
         CoverageView: panel_1.CoverageView,
         CoverageTitle: panel_1.CoverageTitle,