dsh-gitnexus-plus 0.1.2 → 0.1.3

package/lib/client.js

@@ -818,10 +818,160 @@ function activityView(activity) {
  * whether the graph knows about it.
  * @param {{file: any}} props
  */
-function ActivityFileRow({ file }) {
+function ActivityFileRow({ file, onSelect, }) {
     const tone = file.verdict === 'indexed' ? 'solid' : file.verdict === 'missing' ? 'outline' : 'neutral';
     const label = file.verdict === 'indexed' ? '已索引' : file.verdict === 'missing' ? '缺失' : '排除';
-    return h('div', { style: styles.fileRow }, h(FileTypeIcon, { path: file.path, size: 16 }), h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, h(PathLabel, { path: file.path })), h('span', { style: styles.fileMeta }, h(Tag, { tone }, label), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${file.changes}×`)));
+    const interactive = typeof onSelect === 'function';
+    return h('div', {
+        role: interactive ? 'button' : undefined,
+        tabIndex: interactive ? 0 : undefined,
+        title: interactive ? '查看该文件的提交时间线' : undefined,
+        onClick: interactive ? () => onSelect?.(file.path) : undefined,
+        onKeyDown: interactive
+            ? (event) => {
+                if (event.key === 'Enter' || event.key === ' ') {
+                    event.preventDefault();
+                    onSelect?.(file.path);
+                }
+            }
+            : undefined,
+        style: { ...styles.fileRow, cursor: interactive ? 'pointer' : undefined },
+    }, h(FileTypeIcon, { path: file.path, size: 16 }), h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, h(PathLabel, { path: file.path })), h('span', { style: styles.fileMeta }, interactive
+        ? h('span', { style: { ...MUTED, fontSize: '10px', whiteSpace: 'nowrap' } }, '时间线')
+        : null, h(Tag, { tone }, label), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${file.changes}×`)));
+}
+/** Shared labels/tones for the three activity verdicts. */
+function activityVerdict(verdict) {
+    if (verdict === 'indexed')
+        return { label: '已索引', tone: 'solid', dot: 'done' };
+    if (verdict === 'missing')
+        return { label: '索引缺失', tone: 'outline', dot: 'warning' };
+    return { label: '设计排除', tone: 'neutral', dot: 'idle' };
+}
+/**
+ * The three-way verdict with the volume behind it.
+ *
+ * The old UI had counts only, which made "2 missing" look as urgent as "2 excluded"
+ * even when the missing files accounted for 40 commits. This table adds the volume
+ * without changing the verdict definition.
+ */
+function ActivityCrossTable({ cross }) {
+    const rows = Array.isArray(cross.rows) ? cross.rows : [];
+    if (rows.length === 0)
+        return null;
+    const cell = { padding: '3px 0', textAlign: 'right' };
+    return h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, `活动 × 索引交叉对比 · ${compactNumber(cross.totalFiles ?? 0)} 文件 / ` +
+        `${compactNumber(cross.totalChanges ?? 0)} 次变更`), h('div', {
+        style: {
+            display: 'grid',
+            gridTemplateColumns: 'minmax(0, 1.5fr) repeat(4, minmax(0, 0.65fr))',
+            gap: '4px',
+            alignItems: 'center',
+            fontSize: '10px',
+        },
+    }, h('span', { style: MUTED }, '分类'), h('span', { style: { ...MUTED, ...cell } }, '文件'), h('span', { style: { ...MUTED, ...cell } }, '变更'), h('span', { style: { ...MUTED, ...cell } }, '+行'), h('span', { style: { ...MUTED, ...cell } }, '−行'), rows.map((row) => {
+        const verdict = activityVerdict(row.verdict);
+        return [
+            h('span', { key: `${row.verdict}-label`, style: { display: 'flex', alignItems: 'center', gap: '5px' } }, h(StateDot, { state: verdict.dot }), verdict.label),
+            h('span', { key: `${row.verdict}-files`, style: cell }, compactNumber(row.files)),
+            h('span', { key: `${row.verdict}-changes`, style: cell }, compactNumber(row.changes)),
+            h('span', { key: `${row.verdict}-ins`, style: cell }, `+${compactNumber(row.insertions)}`),
+            h('span', { key: `${row.verdict}-del`, style: cell }, `−${compactNumber(row.deletions)}`),
+        ];
+    })));
+}
+/** HEAD against the commit the index was built from. */
+function ActivityBaseline({ baseline, onSelect, }) {
+    const changedFiles = Array.isArray(baseline.changedFiles) ? baseline.changedFiles : [];
+    const short = baseline.shortSha ?? baseline.ref?.slice(0, 8) ?? '未知';
+    const date = typeof baseline.date === 'string' ? baseline.date.slice(0, 10) : '';
+    const windowBaseline = baseline.source === 'window';
+    return h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, `${windowBaseline ? '活动窗口基线审查' : '索引基线审查'} · ${short}` +
+        (date === '' ? '' : ` · ${date}`)), windowBaseline
+        ? h('div', { style: { ...MUTED, fontSize: '10px', marginBottom: '3px' } }, '索引没有记录基线提交，使用活动窗口最早的提交作为基线。')
+        : null, baseline.available === false
+        ? h('div', { style: { display: 'flex', gap: '6px', alignItems: 'flex-start' } }, h(StateDot, { state: 'warning' }), h('span', null, baseline.reason ?? '基线提交不可读'))
+        : h('div', { style: { ...MUTED } }, (baseline.commits ?? 0) === 0 && (baseline.files ?? 0) === 0
+            ? '工作区与索引基线一致，没有新增变更。'
+            : `自基线以来 ${compactNumber(baseline.commits ?? 0)} 个提交 · ` +
+                `${compactNumber(baseline.files ?? 0)} 个文件 · ` +
+                `+${compactNumber(baseline.insertions ?? 0)} / −${compactNumber(baseline.deletions ?? 0)}`), changedFiles.length > 0
+        ? h('div', { style: { marginTop: '4px' } }, changedFiles
+            .slice(0, 8)
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect })))
+        : null);
+}
+/** Newest-first commit list with per-commit index verdict. */
+function ActivityTimeline({ timeline, indexKnown, }) {
+    if (timeline.length === 0) {
+        return h('div', { style: { ...MUTED } }, '该时间范围内没有提交。');
+    }
+    return h('div', null, timeline.slice(0, 15).map((commit) => {
+        const verdict = indexKnown
+            ? activityVerdict(commit.verdict)
+            : { label: '索引未知', tone: 'neutral', dot: 'idle' };
+        return h('div', {
+            key: commit.sha,
+            style: {
+                display: 'flex',
+                flexDirection: 'column',
+                gap: '2px',
+                padding: '4px 0',
+                borderTop: HAIRLINE,
+                minWidth: 0,
+            },
+        }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0 } }, h(StateDot, { state: verdict.dot }), h('span', { style: { ...styles.mono, color: 'inherit', whiteSpace: 'nowrap' } }, commit.shortSha ?? commit.sha.slice(0, 8)), h('span', {
+            style: {
+                minWidth: 0,
+                flex: '1 1 auto',
+                overflow: 'hidden',
+                textOverflow: 'ellipsis',
+                whiteSpace: 'nowrap',
+            },
+            title: commit.subject,
+        }, commit.subject === '' ? '(无提交说明)' : commit.subject)), h('div', {
+            style: {
+                ...MUTED,
+                fontSize: '10px',
+                display: 'flex',
+                flexWrap: 'wrap',
+                alignItems: 'center',
+                gap: '6px',
+                marginLeft: '14px',
+            },
+        }, h(Tag, { tone: verdict.tone }, verdict.label), h('span', { style: { whiteSpace: 'nowrap' } }, commit.date.slice(0, 10)), h('span', { style: { whiteSpace: 'nowrap' } }, commit.author), h('span', { style: { whiteSpace: 'nowrap' } }, `+${compactNumber(commit.insertions)}/−${compactNumber(commit.deletions)}`), h('span', { style: { whiteSpace: 'nowrap' } }, `${compactNumber(commit.files)} 文件`)));
+    }));
+}
+/** On-demand commit timeline for one file selected from the activity lists. */
+function FileHistorySection({ filePath, history, busy, error, onClose, }) {
+    if (filePath === null)
+        return null;
+    return h('div', { style: { borderTop: HAIRLINE, paddingTop: '6px', marginTop: '2px' } }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0 } }, h('span', { style: { ...MUTED, flexShrink: 0 } }, '文件时间线'), h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, h(PathLabel, { path: filePath })), h(Button, { variant: 'ghost', onClick: onClose }, '关闭')), busy
+        ? h('div', { style: { ...MUTED, marginTop: '4px' } }, '读取文件历史…')
+        : error !== null
+            ? h('div', { style: { ...MUTED, color: 'var(--dsw-alias-state-error-primary, inherit)' } }, error)
+            : history === null
+                ? null
+                : history.available === false
+                    ? h('div', { style: { ...MUTED, marginTop: '4px' } }, history.reason ?? '文件历史不可用')
+                    : h('div', { style: { marginTop: '4px' } }, h('div', { style: { ...MUTED, fontSize: '10px', marginBottom: '3px' } }, `近 ${history.days} 天 · ${history.commits} 提交 · ` +
+                        `+${compactNumber(history.insertions)} / −${compactNumber(history.deletions)}`), history.timeline.length === 0
+                        ? h('div', { style: { ...MUTED } }, '该时间范围内没有提交。')
+                        : history.timeline.length > 30
+                            ? h('div', { style: { ...MUTED, fontSize: '10px', marginBottom: '2px' } }, `仅显示最近 30 个提交（共 ${history.timeline.length} 个）`)
+                            : null, history.timeline.slice(0, 30).map((commit) => h('div', {
+                        key: commit.sha,
+                        style: { ...styles.fileRow, alignItems: 'flex-start' },
+                    }, h('span', { style: { ...styles.mono, color: 'inherit', whiteSpace: 'nowrap' } }, commit.shortSha ?? commit.sha.slice(0, 8)), h('span', {
+                        style: {
+                            minWidth: 0,
+                            flex: '1 1 auto',
+                            overflow: 'hidden',
+                            textOverflow: 'ellipsis',
+                            whiteSpace: 'nowrap',
+                        },
+                        title: commit.subject,
+                    }, commit.subject === '' ? '(无提交说明)' : commit.subject), h('span', { style: { ...styles.fileMeta, flexWrap: 'wrap' } }, h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, commit.date.slice(0, 10)), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, commit.author), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `+${compactNumber(commit.insertions)}/−${compactNumber(commit.deletions)}`))))));
 }
 /**
  * Git activity, crossed with the index.
@@ -831,7 +981,16 @@ function ActivityFileRow({ file }) {
  * never expands it learns whether recent work is visible to the graph.
  * @param {{activity: any}} props
  */
-function GitActivitySection({ activity: rawActivity }) {
+function GitActivitySection({ activity: rawActivity, projectPath, }) {
+    // The project timeline defaults to 7 days and caps at 30; the file timeline
+    // reuses the same range. Hooks are before the "activity unavailable" return so
+    // the hook order cannot change with the data.
+    const [timelineDays, setTimelineDays] = React.useState(7);
+    const [selectedFile, setSelectedFile] = React.useState(null);
+    const [fileHistory, setFileHistory] = React.useState(null);
+    const [fileHistoryBusy, setFileHistoryBusy] = React.useState(false);
+    const [fileHistoryError, setFileHistoryError] = React.useState(null);
+    const fileHistorySeq = React.useRef(0);
     // Narrowed to a local const before use. `activityView` returns null for an absent
     // activity, but TypeScript cannot carry that back to the parameter, so every later
     // read would need its own guard — and a guard per read is how one gets forgotten.
@@ -841,6 +1000,62 @@ function GitActivitySection({ activity: rawActivity }) {
         return h('div', { style: { ...MUTED } }, 'Git 活动不可用');
     }
     const missing = view.verdicts.find((v) => v.key === 'missing')?.value ?? 0;
+    const requestFileHistory = (path, days) => {
+        if (projectPath === null)
+            return;
+        const seq = fileHistorySeq.current + 1;
+        fileHistorySeq.current = seq;
+        setSelectedFile(path);
+        setFileHistory(null);
+        setFileHistoryError(null);
+        setFileHistoryBusy(true);
+        const query = `/api/gitnexus/file-history?repo=${encodeURIComponent(projectPath)}` +
+            `&path=${encodeURIComponent(path)}&days=${days}`;
+        fetch(routeUrl(query))
+            .then(async (res) => ({ status: res.status, body: await res.json().catch(() => null) }))
+            .then(({ status, body }) => {
+            if (seq !== fileHistorySeq.current)
+                return;
+            // The client bundle can hot-reload before the host does. An unregistered
+            // route comes back as the desktop carrier's 401/404, not the route's own
+            // not-a-project JSON; say that instead of a generic status.
+            if ((status === 404 && body?.code !== 'not-a-project') ||
+                status === 401) {
+                throw new Error('当前宿主没有文件时间线路由；重启 DSH 后再试。');
+            }
+            if (!body?.ok) {
+                throw new Error(typeof body?.message === 'string' ? body.message : `请求失败 (${status})`);
+            }
+            setFileHistory(body);
+        })
+            .catch((cause) => {
+            if (seq !== fileHistorySeq.current)
+                return;
+            setFileHistoryError(String(cause?.message ?? cause));
+        })
+            .finally(() => {
+            if (seq === fileHistorySeq.current)
+                setFileHistoryBusy(false);
+        });
+    };
+    const openFileHistory = (path) => requestFileHistory(path, timelineDays);
+    const closeFileHistory = () => {
+        fileHistorySeq.current += 1;
+        setSelectedFile(null);
+        setFileHistory(null);
+        setFileHistoryError(null);
+        setFileHistoryBusy(false);
+    };
+    const changeTimelineDays = (days) => {
+        setTimelineDays(days);
+        if (selectedFile !== null)
+            requestFileHistory(selectedFile, days);
+    };
+    const cutoff = Date.now() - timelineDays * 86_400_000;
+    const projectTimeline = (Array.isArray(activity.timeline) ? activity.timeline : []).filter((commit) => {
+        const at = Date.parse(commit.date);
+        return !Number.isFinite(at) || at >= cutoff;
+    });
     return h('div', { style: { display: 'flex', flexDirection: 'column', gap: '10px', paddingTop: '4px' } }, h('div', { style: MUTED }, view.totals), view.truncated
         ? h('div', { style: MUTED }, `活动窗口达到提交上限，更早的改动未统计`)
         : null, h(MetricGrid, {
@@ -852,27 +1067,61 @@ function GitActivitySection({ activity: rawActivity }) {
     activity.histogram !== undefined && activity.histogram !== null
         ? h(Histogram, { histogram: activity.histogram })
         : null, 
+    // Three views over the same window: what the index sees, what changed since the
+    // index baseline, and the individual commits in order. Old hosts omit these
+    // fields; each block disappears rather than rendering a false empty state.
+    activity.totals?.indexKnown === false
+        ? h('div', { style: { ...MUTED } }, '项目尚未建立索引：无法把活动文件与图谱交叉，也没有索引基线可审查。')
+        : activity.cross !== undefined && activity.cross !== null
+            ? h(ActivityCrossTable, { cross: activity.cross })
+            : null, activity.baseline !== undefined && activity.baseline !== null
+        ? h(ActivityBaseline, { baseline: activity.baseline, onSelect: openFileHistory })
+        : null, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0 } }, h('span', { style: { ...MUTED } }, `提交时间线 · 近 ${timelineDays} 天 · ${projectTimeline.length} 个`), h('span', { style: { flex: 1 } }), h('select', {
+        value: String(timelineDays),
+        'aria-label': '项目提交时间线范围',
+        onChange: (event) => changeTimelineDays(Number(event.target.value)),
+        style: {
+            font: 'inherit',
+            fontSize: '10px',
+            padding: '2px 4px',
+            border: HAIRLINE,
+            borderRadius: '4px',
+            background: SOFT_BG,
+            color: 'inherit',
+        },
+    }, [7, 14, 30].map((days) => h('option', { key: days, value: String(days) }, `${days} 天`)))), h(ActivityTimeline, {
+        timeline: projectTimeline,
+        indexKnown: activity.totals?.indexKnown === true,
+    }), activity.timelineTruncated === true
+        ? h('div', { style: { ...MUTED, fontSize: '10px' } }, '时间线最多显示最近 100 个提交；缩短范围可看更早记录。')
+        : null, 
     // Missing files come from their own list, not from the display-capped
     // by-changes slice — otherwise the summary can report a count with no rows.
     missing > 0 && Array.isArray(activity.missingFiles) && activity.missingFiles.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '应被索引却缺失'), activity.missingFiles
             .slice(0, 8)
-            .map((file) => h(ActivityFileRow, { key: file.path, file })))
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect: openFileHistory })))
         : null, Array.isArray(activity.byChanges) && activity.byChanges.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '改动最频繁'), activity.byChanges
             .filter((f) => f.verdict !== 'excluded')
             .slice(0, 8)
-            .map((file) => h(ActivityFileRow, { key: file.path, file })))
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect: openFileHistory })))
         : null, Array.isArray(activity.byRecency) && activity.byRecency.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '最近改动'), activity.byRecency
             .filter((f) => f.verdict !== 'excluded')
             .slice(0, 5)
-            .map((file) => h(ActivityFileRow, { key: file.path, file })))
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect: openFileHistory })))
         : null, Array.isArray(activity.authors) && activity.authors.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '提交者'), activity.authors.slice(0, 6).map((author) => h('div', { key: `${author.name}-${author.email}`, style: styles.fileRow }, h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, author.name), h('span', { style: styles.fileMeta }, author.bot ? h(Tag, { tone: 'neutral' }, 'bot') : null, h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${author.commits} 提交`), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${author.files} 文件`)))))
         : null, Array.isArray(activity.branches) && activity.branches.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, `分支 · ${activity.branches.length}`), activity.branches.slice(0, 6).map((branch) => h('div', { key: branch.name, style: styles.fileRow }, h('span', { style: { minWidth: 0, flex: '1 1 auto', ...styles.mono } }, branch.name), h('span', { style: styles.fileMeta }, branch.current ? h(Tag, { tone: 'solid' }, '当前') : null, h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, branch.lastCommitDate ? branch.lastCommitDate.slice(0, 10) : '')))))
-        : null);
+        : null, h(FileHistorySection, {
+        filePath: selectedFile,
+        history: fileHistory,
+        busy: fileHistoryBusy,
+        error: fileHistoryError,
+        onClose: closeFileHistory,
+    }));
 }
 /**
  * Resolve the project this panel is about.
@@ -1344,7 +1593,37 @@ function MaintenanceSection({ maintenance, projectPath, indexed, run, runError,
         },
     }));
 }
-function CoverageView({ report, maintenance, projectPath, context, busy, error, readAt, run, runError, now, onRefresh, onStartRun, onCancelRun, installRun, installError, onInstall, onCancelInstall, search, }) {
+function LoadingBar({ label, percent }) {
+    const value = percent === null || percent === undefined
+        ? undefined
+        : Math.max(0, Math.min(100, Math.round(percent)));
+    const text = value === undefined ? label : `${label} · ${value}%`;
+    return h('div', {
+        style: {
+            gridColumn: '1 / -1',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: '4px',
+        },
+    }, h('progress', {
+        value,
+        max: 100,
+        'aria-label': label,
+        'aria-valuetext': text,
+        'aria-valuenow': value,
+        style: {
+            width: '100%',
+            height: '4px',
+            border: 0,
+            borderRadius: '999px',
+            overflow: 'hidden',
+            background: 'var(--dsw-alias-bg-layer-3, rgba(127, 127, 127, 0.16))',
+            accentColor: 'var(--dsw-alias-brand-primary, #4f8cff)',
+            color: 'var(--dsw-alias-brand-primary, #4f8cff)',
+        },
+    }), h('div', { style: { ...MUTED, fontSize: '10px' } }, text));
+}
+function CoverageView({ report, maintenance, projectPath, context, busy, progress, error, readAt, run, runError, now, onRefresh, onStartRun, onCancelRun, installRun, installError, onInstall, onCancelInstall, search, }) {
     // 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.
@@ -1365,6 +1644,16 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
         title: '重新读取报告（不会重建索引；重建见下方「维护命令」）',
         'aria-label': '重新读取报告',
     }, h(IconRefreshOutlineRegular, { size: 14 })));
+    // 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):
+    // the native progress element is then indeterminate, not a made-up number.
+    const progressBar = report === null || busy
+        ? h(LoadingBar, {
+            label: progress?.label ?? (report === null ? '正在读取索引…' : '正在刷新索引…'),
+            percent: progress?.percent ?? null,
+        })
+        : null;
     // "I cannot tell which project this is" and "this project has no index" are
     // different facts, and the first revision conflated them: an unresolved project
     // fell through to the no-index branch and told the operator to initialise an
@@ -1385,7 +1674,7 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
             }, h(MaintenanceSection, { maintenance, projectPath, indexed: false, run, runError, now, onStartRun, onCancelRun })));
     }
     if (report === null) {
-        return h('div', { style: styles.root }, header, h('div', { style: MUTED }, '正在读取索引…'));
+        return h('div', { style: styles.root }, header, progressBar);
     }
     // Defaults are resolved before the no-index branch: a scan-only report still has
     // totals, a cap and languages even though it has no graph. Building them only for
@@ -1403,7 +1692,7 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
     // only "没有索引" and a command, which made an otherwise healthy repository look
     // empty. The scan is the "at least something to look at" floor.
     if (report.repo?.indexed !== true) {
-        return h('div', { style: styles.root }, h('div', { style: { gridColumn: '1 / -1', display: 'flex', flexDirection: 'column', gap: '6px' } }, header), h(ToolchainNotice, {
+        return h('div', { style: styles.root }, h('div', { style: { gridColumn: '1 / -1', display: 'flex', flexDirection: 'column', gap: '6px' } }, header), progressBar, h(ToolchainNotice, {
             toolchain: report.toolchain,
             run: installRun,
             runError: installError,
@@ -1430,7 +1719,7 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
     return h('div', { style: styles.root }, 
     // The header and the two status lines span everything: they describe the whole
     // panel, so giving them a column would make them look like one card's heading.
-    h('div', { style: { gridColumn: '1 / -1', display: 'flex', flexDirection: 'column', gap: '6px' } }, header), 
+    h('div', { style: { gridColumn: '1 / -1', display: 'flex', flexDirection: 'column', gap: '6px' } }, header), progressBar, 
     // Immediately after the header, before any index content. If GitNexus is missing,
     // that single fact explains everything the panel is about to show or fail to show,
     // so it belongs above the numbers rather than beside them.
@@ -1566,7 +1855,7 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
             meta: h('span', { style: { display: 'inline-flex', alignItems: 'center', gap: '5px', ...MUTED, fontSize: '11px' } }, h(StateDot, {
                 state: activityView(report.activity)?.verdicts.find((v) => v.key === 'missing')?.tone ?? 'done',
             }), activityCollapsed(report.activity)),
-        }, h(GitActivitySection, { activity: report.activity })), 
+        }, h(GitActivitySection, { activity: report.activity, projectPath })), 
     // Wide, and always open: the commands are the action this panel offers.
     maintenance === null || maintenance === undefined
         ? null
@@ -1596,6 +1885,7 @@ function CoveragePanel(props) {
     const [maintenance, setMaintenance] = React.useState(null);
     const [error, setError] = React.useState(null);
     const [busy, setBusy] = React.useState(false);
+    const [progress, setProgress] = React.useState(null);
     const [reloadToken, setReloadToken] = React.useState(0);
     // When the report on screen was read. Without it a refresh of an unchanged
     // repository produces a byte-identical panel, so the control looks inert even
@@ -1933,32 +2223,107 @@ function CoveragePanel(props) {
         const controller = new AbortController();
         setBusy(true);
         setError(null);
-        const query = `/api/gitnexus/coverage?repo=${encodeURIComponent(projectPath)}` + (wantsFresh ? '&refresh=1' : '');
-        fetch(routeUrl(query), {
-            signal: controller.signal,
-        })
-            .then(async (res) => ({ status: res.status, body: await res.json().catch(() => null) }))
-            .then(({ status, body }) => {
-            // `not-indexed` is a state the panel renders, not a failure: the whole
-            // point of leading with the initialize command is that reaching it is
-            // expected on a project that has never been analysed.
-            if (status === 404 && body?.code === 'not-indexed') {
-                setReport({ repo: { indexed: false, path: projectPath } });
-                setMaintenance(null);
-                setReadAt(body?.readAt ?? new Date().toISOString());
-                return;
+        setProgress({ percent: 0, label: '连接索引服务…' });
+        const query = `/api/gitnexus/coverage?repo=${encodeURIComponent(projectPath)}` +
+            (wantsFresh ? '&refresh=1' : '') +
+            '&stream=1';
+        const load = async () => {
+            try {
+                const res = await fetch(routeUrl(query), { signal: controller.signal });
+                const contentType = res.headers.get('content-type') ?? '';
+                if (contentType.includes('application/x-ndjson') && res.body !== null) {
+                    const reader = res.body.getReader();
+                    const decoder = new TextDecoder();
+                    const reports = [];
+                    let buffer = '';
+                    const consume = (line) => {
+                        if (line.trim() === '' || controller.signal.aborted)
+                            return;
+                        let message;
+                        try {
+                            message = JSON.parse(line);
+                        }
+                        catch {
+                            return;
+                        }
+                        if (message.type === 'progress') {
+                            const raw = typeof message.percent === 'number' ? message.percent : 0;
+                            const percent = Math.max(0, Math.min(100, Math.round(raw)));
+                            const label = typeof message.label === 'string' ? message.label : '读取索引…';
+                            setProgress({ percent, label });
+                            return;
+                        }
+                        if (message.type === 'report') {
+                            reports.push(message);
+                            return;
+                        }
+                        if (message.type === 'error') {
+                            throw new Error(typeof message.message === 'string' ? message.message : '读取索引失败。');
+                        }
+                    };
+                    for (;;) {
+                        const chunk = await reader.read();
+                        if (chunk.done)
+                            break;
+                        buffer += decoder.decode(chunk.value, { stream: true });
+                        let newline = buffer.indexOf('\n');
+                        while (newline >= 0) {
+                            const line = buffer.slice(0, newline);
+                            buffer = buffer.slice(newline + 1);
+                            consume(line);
+                            newline = buffer.indexOf('\n');
+                        }
+                    }
+                    buffer += decoder.decode();
+                    if (buffer.trim() !== '')
+                        consume(buffer);
+                    const payload = reports[0];
+                    if (payload === undefined)
+                        throw new Error('读取中断：没有收到完整报告。');
+                    if (controller.signal.aborted)
+                        return;
+                    setReport(payload.report);
+                    setMaintenance(payload.maintenance ?? null);
+                    setReadAt(typeof payload.readAt === 'string' ? payload.readAt : new Date().toISOString());
+                    return;
+                }
+                // An older host ignores `stream=1` and answers plain JSON. Drop the numeric
+                // channel and let the native progress element go indeterminate rather than
+                // leaving a frozen 0%.
+                setProgress(null);
+                const body = (await res.json().catch(() => null));
+                // `not-indexed` is a state the panel renders, not a failure: the whole
+                // 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);
+                    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);
+                setReadAt(typeof body.readAt === 'string' ? body.readAt : new Date().toISOString());
             }
-            if (!body?.ok)
-                throw new Error(body?.message ?? `请求失败 (${status})`);
-            setReport(body.report);
-            setMaintenance(body.maintenance ?? null);
-            setReadAt(typeof body.readAt === 'string' ? body.readAt : new Date().toISOString());
-        })
-            .catch((cause) => {
-            if (cause?.name !== 'AbortError')
-                setError(String(cause?.message ?? cause));
-        })
-            .finally(() => setBusy(false));
+            catch (cause) {
+                if (controller.signal.aborted)
+                    return;
+                const error = cause;
+                if (error?.name === 'AbortError')
+                    return;
+                setError(String(error?.message ?? cause));
+            }
+            finally {
+                if (!controller.signal.aborted) {
+                    setBusy(false);
+                    setProgress(null);
+                }
+            }
+        };
+        void load();
         return () => controller.abort();
     }, [projectPath, reloadToken]);
     const fallbackMaintenance = React.useMemo(() => (maintenance === null && projectPath !== null ? { commands: [], rationale: [] } : maintenance), [maintenance, projectPath]);
@@ -1968,6 +2333,7 @@ function CoveragePanel(props) {
         projectPath,
         context: projectPath === null ? contextDiagnostic(props) : null,
         busy,
+        progress,
         error,
         readAt,
         run,
@@ -2117,6 +2483,7 @@ module.exports = {
         MetricGrid,
         Histogram,
         GitActivitySection,
+        FileHistorySection,
         ProvenanceBlock,
         MaintenanceSection,
         CapabilityStrip,

package/lib/gitnexus/analyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/gitnexus/analyze.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/gitnexus/analyze.ts"],"names":[],"mappings":"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"}

package/lib/gitnexus/analyze.js

@@ -27,6 +27,7 @@
  * deployment's decision. A denial is then reported as a denial, not retried wider:
  * the same rule the subagent prompt states, for the same reason.
  */
+import { existsSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
 import { defaultGitnexusHome, effectiveSkipFts } from './commands.js';
 import { findGitnexusCli } from './toolchain.js';
@@ -103,6 +104,34 @@ export function analyzeCommandLine(cliPath, repoPath, options = {}) {
 function looksDenied(text) {
     return /\[sandbox:[^\]]*denied/i.test(text) || /access is denied|permission denied|EPERM/i.test(text);
 }
+/**
+ * GitNexus 1.6.12 creates these cache directories from the parse worker.
+ *
+ * A worker running under a restricted host token can be denied `mkdir` on the
+ * project's inherited `.gitnexus` ACL even though it can write files there. The
+ * failure is EPERM at the first shard write and takes the whole parse phase down
+ * with it. Creating the directories from the host, before the shell starts, makes
+ * the worker use the directories that already exist. Returns an actionable error
+ * instead of letting the worker fail on a path the panel then has to explain.
+ */
+const ANALYZE_CACHE_DIRS = ['parsedfile-store', 'parsedfile-cache', 'parse-cache'];
+function prepareAnalyzeCacheDirs(repoPath) {
+    const indexDir = path.join(repoPath, '.gitnexus');
+    if (!existsSync(indexDir))
+        return null;
+    for (const name of ANALYZE_CACHE_DIRS) {
+        const target = path.join(indexDir, name);
+        try {
+            mkdirSync(target, { recursive: true });
+        }
+        catch (cause) {
+            return (`无法创建 GitNexus 缓存目录（${path.join('.gitnexus', name)}）：` +
+                `${String(cause?.message ?? cause)}。` +
+                '请给项目 .gitnexus 目录写权限，或在普通终端执行下面的命令。');
+        }
+    }
+    return null;
+}
 /** Keep the last `limit` characters, on a line boundary when one is available. */
 function tail(text, limit) {
     if (text.length <= limit)
@@ -201,6 +230,17 @@ export function createAnalyzeRunner(options) {
             skipFts,
             gitnexusHome,
         });
+        const cacheError = prepareAnalyzeCacheDirs(key);
+        if (cacheError !== null) {
+            return finish(key, {
+                state: 'failed',
+                force,
+                command,
+                startedAt: now(),
+                output: '',
+                message: cacheError,
+            });
+        }
         const controller = new AbortController();
         inFlight.set(key, controller);
         const started = {