dsh-config-manager 0.1.19 → 0.1.21

package/src/client/sync/SyncSettingsView.tsx

@@ -7,8 +7,10 @@
  *   + gitBin（可选）；
  * - 私有仓库强制提示横幅（常驻）；
  * - 推送按钮 → SyncPushReport（快照 id / 分区 / 告警）；
- * - 拉取按钮 → SyncPullReport.changes 差异摘要（description/kind/severity）+
- *   「预览不执行导入」提示；needsReview 高亮（v1 不做完整导入接线）；
+ * - 拉取按钮 → SyncPullReport.changes 差异摘要（description/kind/severity）；
+ * - 【方案 A】一键同步主按钮：拉取 → 差异确认会话（SyncConfirmView 逐项确认）→
+ *   确认导入（apply-items）→ 执行结果 + 一键回滚（restoreId）；「选择历史快照」下拉；
+ * - 【方案 A】自动同步设置区块：总开关 + 间隔下拉 + 状态（上次运行 / 下次倒计时）；
  * - 状态行：凭据配置 + 上次同步时间 + 通道（来自 GET /sync/status，组件挂载时加载）。
  *
  * 全部渲染模型来自 ./sync-view.ts 纯函数（node 单测覆盖），组件只做装配；
@@ -22,12 +24,18 @@ import type { SyncPullReport, SyncPushReport } from '../../sync/sync-engine.ts'
 import { Badge, Banner, Button, Card, SectionTitle, Spinner } from '../common/ui.tsx'
 import { ErrorBanner } from '../common/ErrorBanner.tsx'
 import { SYNC_CREDENTIAL_REF } from './sync-api.ts'
-import type { SyncApi, SyncStatusResponse } from './sync-api.ts'
+import type {
+  AutosyncInterval, AutosyncStatusResponse, SyncApi, SyncSnapshotLite, SyncStartResponse,
+  SyncStatusResponse,
+} from './sync-api.ts'
 import {
-  computeGithubLoginView, computeSyncButtons, computeSyncStatus, githubPollMessage,
-  kindLabel, privateRepoHint, pullReportView, pushReportView, severityLabel,
+  autosyncIntervalMs, autosyncStatusText, computeAutosyncCountdown, computeGithubLoginView,
+  computeSyncButtons, computeSyncStatus, formatIntervalDuration, githubPollMessage, kindLabel,
+  privateRepoHint, pullReportView, pushReportView, severityLabel,
 } from './sync-view.ts'
 import type { GithubLoginPhase } from './sync-view.ts'
+import { SyncHistoryView } from './SyncHistoryView.tsx'
+import { SyncConfirmView } from './SyncConfirmView.tsx'
 import css from '../config-manager.module.css'
 
 export interface SyncSettingsViewProps {
@@ -43,9 +51,23 @@ interface SyncUiState {
   gitBin: string
   /** 仅内存：成功后清空（已写入 DSH credentials），绝不持久化 */
   token: string
-  busy: 'push' | 'pull' | null
+  busy: 'sync' | 'push' | 'pull' | 'rollback' | null
   pushReport: SyncPushReport | null
   pullReport: SyncPullReport | null
+  /** 一键同步差异确认会话（POST /sync/sync 结果；非空时渲染 SyncConfirmView） */
+  confirmSession: SyncStartResponse | null
+  /** 远端历史快照列表（「选择历史快照」下拉数据源） */
+  snapshots: SyncSnapshotLite[]
+  /** 当前选中的历史快照 id（'' = 最新） */
+  selectedSnapshotId: string
+  /** 自动同步状态 */
+  autosync: AutosyncStatusResponse | null
+  /** 自动同步开关（回填自 autosync） */
+  autosyncEnabled: boolean
+  /** 自动同步间隔（回填自 autosync） */
+  autosyncInterval: AutosyncInterval
+  /** 最近一次一键同步执行结果（回滚入口） */
+  lastRestoreId: string | null
   error: string | null
   /** GitHub OAuth device flow 状态（flowId/userCode 仅内存，token 只存宿主） */
   github: GithubUiState
@@ -65,6 +87,8 @@ const initialGithub: GithubUiState = {
   phase: 'idle', flowId: '', userCode: '', verificationUri: '', interval: 5, error: null,
 }
 
+const AUTOSYNC_INTERVAL_OPTIONS: AutosyncInterval[] = ['5m', '15m', '30m', '60m', '6h', '12h', '24h'];
+
 const initial: SyncUiState = {
   loading: true,
   loadError: null,
@@ -75,6 +99,13 @@ const initial: SyncUiState = {
   busy: null,
   pushReport: null,
   pullReport: null,
+  confirmSession: null,
+  snapshots: [],
+  selectedSnapshotId: '',
+  autosync: null,
+  autosyncEnabled: false,
+  autosyncInterval: '30m',
+  lastRestoreId: null,
   error: null,
   github: initialGithub,
 }
@@ -87,17 +118,53 @@ export function SyncSettingsView({ api, t }: SyncSettingsViewProps) {
   /** GitHub 轮询定时器（卸载/取消时清理，防止泄漏与跨流程串扰） */
   const githubPollTimer = useRef<ReturnType<typeof setTimeout> | null>(null)
 
-  /** 挂载时读取同步状态（配置回填 + 上次同步时间 + 凭据状态） */
+  /** 挂载时读取同步状态（配置回填 + 上次同步时间 + 凭据状态 + autosync） */
   const loadStatus = async (): Promise<void> => {
     patch({ loading: true, loadError: null })
     try {
       const info = await api.status()
-      patch({ loading: false, statusInfo: info, repoUrl: info.repoUrl ?? '', gitBin: info.gitBin ?? '' })
+      patch({
+        loading: false,
+        statusInfo: info,
+        repoUrl: info.repoUrl ?? '',
+        gitBin: info.gitBin ?? '',
+        ...(info.autosync !== undefined
+          ? {
+              autosync: info.autosync,
+              autosyncEnabled: info.autosync.enabled,
+              autosyncInterval: info.autosync.interval,
+            }
+          : {}),
+      })
+      // 独立拉取 autosync（若 status 未带则补一次）
+      if (info.autosync === undefined) {
+        void loadAutosync()
+      }
     } catch (err) {
       patch({ loading: false, loadError: err instanceof Error ? err.message : String(err) })
     }
   }
 
+  /** 读取自动同步状态（GET /sync/autosync）。 */
+  const loadAutosync = async (): Promise<void> => {
+    try {
+      const autosync = await api.autosyncStatus()
+      patch({ autosync, autosyncEnabled: autosync.enabled, autosyncInterval: autosync.interval })
+    } catch (err) {
+      patch({ error: err instanceof Error ? err.message : String(err) })
+    }
+  }
+
+  /** 读取远端历史快照列表（「选择历史快照」下拉数据源）。 */
+  const loadSnapshots = async (): Promise<void> => {
+    try {
+      const res = await api.snapshotsList(payload())
+      patch({ snapshots: res.snapshots })
+    } catch {
+      // 拉取失败不阻断主流程（下拉留空，用户可重试）
+    }
+  }
+
   useEffect(() => {
     void loadStatus()
     // api 为注入单例（注册时创建），生命周期内稳定；仅挂载时加载一次
@@ -199,6 +266,60 @@ export function SyncSettingsView({ api, t }: SyncSettingsViewProps) {
     }
   }
 
+  /* ------------------------------------------------ 一键同步（方案 A） */
+
+  /** 一键同步：拉取 → 差异确认会话（先取消旧会话，再发起新会话）。 */
+  const runSync = async (snapshotId?: string): Promise<void> => {
+    // 清理旧的差异确认会话（避免残留临时 ZIP / 同 key 冲突）
+    if (state.confirmSession !== null) {
+      try { await api.cancel(state.confirmSession.syncSessionId) } catch { /* 尽力清理 */ }
+    }
+    patch({ busy: 'sync', error: null, confirmSession: null, lastRestoreId: null })
+    try {
+      const session = await api.sync({ ...payload(), ...(snapshotId !== undefined && snapshotId !== '' ? { snapshotId } : {}) })
+      if (!session.ok) {
+        patch({ busy: null, error: session.message ?? t('syncflow.syncFailed') })
+        return
+      }
+      patch({ busy: null, confirmSession: session, token: '' })
+      void loadSnapshots()
+    } catch (err) {
+      patch({ busy: null, error: err instanceof Error ? err.message : String(err) })
+    }
+  }
+
+  /** 用户取消差异确认：清除会话，复位到空闲。 */
+  const cancelConfirm = (): void => {
+    patch({ confirmSession: null })
+  }
+
+  /** 从 SyncConfirmView 透传的一键回滚完成信号。 */
+  const onRollbackApplied = (): void => {
+    patch({ lastRestoreId: null })
+  }
+
+  /* ------------------------------------------------ 自动同步（方案 A） */
+
+  const toggleAutosync = async (enabled: boolean): Promise<void> => {
+    patch({ autosyncEnabled: enabled, error: null })
+    try {
+      const updated = await api.autosyncUpdate({ enabled, interval: state.autosyncInterval })
+      patch({ autosync: updated, autosyncEnabled: updated.enabled, autosyncInterval: updated.interval })
+    } catch (err) {
+      patch({ error: err instanceof Error ? err.message : String(err) })
+    }
+  }
+
+  const updateAutosyncInterval = async (interval: AutosyncInterval): Promise<void> => {
+    patch({ autosyncInterval: interval, error: null })
+    try {
+      const updated = await api.autosyncUpdate({ enabled: state.autosyncEnabled, interval })
+      patch({ autosync: updated, autosyncEnabled: updated.enabled, autosyncInterval: updated.interval })
+    } catch (err) {
+      patch({ error: err instanceof Error ? err.message : String(err) })
+    }
+  }
+
   const status = computeSyncStatus(state.statusInfo, state.loading, state.loadError, uiT)
   const buttons = computeSyncButtons(state.busy, state.repoUrl, uiT)
   const pushView = pushReportView(state.pushReport, uiT)
@@ -210,6 +331,11 @@ export function SyncSettingsView({ api, t }: SyncSettingsViewProps) {
   const githubBusy =
     state.github.phase === 'starting' || state.github.phase === 'waiting' || state.github.phase === 'polling'
 
+  const autosyncText = state.autosync !== null ? autosyncStatusText(state.autosync, uiT) : t('autosync.statusNever')
+  const autosyncCountdown = state.autosync !== null && state.autosync.elapsedMs >= 0
+    ? formatIntervalDuration(computeAutosyncCountdown(state.autosync.elapsedMs, autosyncIntervalMs(state.autosync.interval)), uiT)
+    : null
+
   return (
     <div className={css.viewBody}>
       <SectionTitle title={t('section.label')} subtitle={t('section.description')} />
@@ -243,7 +369,7 @@ export function SyncSettingsView({ api, t }: SyncSettingsViewProps) {
                 className={css.input}
                 value={state.token}
                 autoComplete="off"
-                placeholder="ghp_…（可选）"
+                placeholder={t('config.tokenPlaceholder')}
                 disabled={state.busy !== null}
                 onChange={(e: ChangeEvent<HTMLInputElement>) => { patch({ token: e.target.value }) }}
               />
@@ -312,9 +438,16 @@ export function SyncSettingsView({ api, t }: SyncSettingsViewProps) {
             </div>
           </Card>
 
-          {/* 操作 */}
+          {/* 一键同步 + 手动推送/拉取 */}
           <div className={css.actionRow}>
-            <Button variant="primary" disabled={!buttons.canPush || githubBusy} onClick={() => { void runPush() }}>
+            <Button
+              variant="primary"
+              disabled={state.busy !== null || state.repoUrl.trim() === ''}
+              onClick={() => { void runSync() }}
+            >
+              {state.busy === 'sync' ? <Spinner label={t('syncflow.syncing')} /> : t('syncflow.button')}
+            </Button>
+            <Button disabled={!buttons.canPush || githubBusy} onClick={() => { void runPush() }}>
               {state.busy === 'push' ? <Spinner label={buttons.pushLabel} /> : buttons.pushLabel}
             </Button>
             <Button disabled={!buttons.canPull || githubBusy} onClick={() => { void runPull() }}>
@@ -322,8 +455,48 @@ export function SyncSettingsView({ api, t }: SyncSettingsViewProps) {
             </Button>
           </div>
 
+          {/* 选择历史快照下拉 */}
+          <div className={css.statRow}>
+            <label className={css.field}>
+              <span className={css.fieldLabel}>{t('syncflow.selectSnapshot')}</span>
+              <select
+                className={css.input}
+                value={state.selectedSnapshotId}
+                disabled={state.busy !== null}
+                onChange={(e: ChangeEvent<HTMLSelectElement>) => {
+                  const id = e.target.value
+                  patch({ selectedSnapshotId: id })
+                  void runSync(id === '' ? undefined : id)
+                }}
+              >
+                <option value="">{t('syncflow.latestSnapshot')}</option>
+                {state.snapshots.map((s) => (
+                  <option key={s.id} value={s.id}>
+                    {s.id}{t('syncflow.snapshotOption', { date: s.createdAt.slice(0, 10), count: String(s.sectionCount) })}
+                  </option>
+                ))}
+              </select>
+              {state.snapshots.length === 0 && <span className={css.hint}>{t('syncflow.noSnapshots')}</span>}
+            </label>
+          </div>
+
           {state.error !== null && <ErrorBanner error={state.error} />}
 
+          {/* 一键同步差异确认（拉取 → 逐项确认 → 导入） */}
+          {state.confirmSession !== null && (
+            <SyncConfirmView
+              api={api}
+              syncSessionId={state.confirmSession.syncSessionId}
+              snapshotId={state.confirmSession.snapshotId}
+              items={state.confirmSession.items}
+              needsReview={state.confirmSession.needsReview}
+              compatibility={state.confirmSession.compatibility}
+              t={t}
+              onCancel={cancelConfirm}
+              onRollbackDone={onRollbackApplied}
+            />
+          )}
+
           {/* 推送结果 */}
           {pushView !== null && (
             <Card>
@@ -378,6 +551,62 @@ export function SyncSettingsView({ api, t }: SyncSettingsViewProps) {
               {pullView.previewHint !== '' && <Banner kind="info">{pullView.previewHint}</Banner>}
             </Card>
           )}
+
+          {/* 自动同步设置（方案 A） */}
+          <Card>
+            <span className={css.groupLabel}>{t('autosync.title')}</span>
+            <span className={css.hint}>{t('autosync.description')}</span>
+            <label className={css.checkboxRow}>
+              <input
+                type="checkbox"
+                checked={state.autosyncEnabled}
+                disabled={state.busy !== null}
+                onChange={(e: ChangeEvent<HTMLInputElement>) => { void toggleAutosync(e.target.checked) }}
+              />
+              <span>{t('autosync.enable')}</span>
+            </label>
+            <label className={css.field}>
+              <span className={css.fieldLabel}>{t('autosync.interval')}</span>
+              <select
+                className={css.input}
+                value={state.autosyncInterval}
+                disabled={state.busy !== null}
+                onChange={(e: ChangeEvent<HTMLSelectElement>) => {
+                  void updateAutosyncInterval(e.target.value as AutosyncInterval)
+                }}
+              >
+                {AUTOSYNC_INTERVAL_OPTIONS.map((iv) => (
+                  <option key={iv} value={iv}>{intervalLabel(iv, t)}</option>
+                ))}
+              </select>
+              <span className={css.hint}>{t('autosync.intervalHint')}</span>
+            </label>
+            <div className={css.statRow}>
+              <Badge kind={state.autosync?.lastRunStatus === 'failed' ? 'error' : state.autosync?.lastRunStatus === 'skipped' ? 'warn' : 'info'}>
+                {autosyncText}
+              </Badge>
+              {autosyncCountdown !== null && state.autosyncEnabled && (
+                <Badge kind="info">{t('autosync.nextRun', { time: autosyncCountdown })}</Badge>
+              )}
+            </div>
+          </Card>
+
+          {/* P2：同步历史视图（Host /sync/history 端点） */}
+          <SyncHistoryView api={api} t={t} />
     </div>
   )
-}
+}
+
+/** AutosyncInterval → 可读标签（复用 i18n interval 键）。 */
+function intervalLabel(iv: AutosyncInterval, t: TranslateNS<'config-manager-sync'>): string {
+  switch (iv) {
+    case '5m': return t('autosync.interval5m');
+    case '15m': return t('autosync.interval15m');
+    case '30m': return t('autosync.interval30m');
+    case '60m': return t('autosync.interval60m');
+    case '6h': return t('autosync.interval6h');
+    case '12h': return t('autosync.interval12h');
+    case '24h': return t('autosync.interval24h');
+    default: return iv;
+  }
+}

package/src/client/sync/history-model.test.ts

@@ -0,0 +1,82 @@
+/**
+ * m-sync-ui (方案 A)：同步历史投影（含自动同步记录）纯函数测试。
+ * TDD：先写失败测试，再实现 history-model.ts 对应函数。
+ */
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import type { SyncHistoryEntry } from './sync-api.ts';
+import {
+  autosyncStatusLabel, describeSkipReason, directionLabel, formatDateTime,
+  projectAutosyncEntry, projectSyncHistoryEntries,
+} from './history-model.ts';
+import type { AutosyncHistoryEntry } from './sync-api.ts';
+
+const autosyncEntry = (overrides: Partial<AutosyncHistoryEntry>): AutosyncHistoryEntry => ({
+  direction: 'both',
+  status: 'skipped',
+  skipReason: 'conflict',
+  conflictedSections: ['settings', 'plugins'],
+  appliedSections: [],
+  failureCountAtRun: 0,
+  createdAt: '2026-08-17T10:00:00.000Z',
+  ...overrides,
+});
+
+test('projectSyncHistoryEntries：快照 + 自动同步 按 createdAt 倒序合并', () => {
+  const entries: SyncHistoryEntry[] = [
+    { id: 'a', createdAt: '2026-08-17T10:00:00.000Z', kind: 'apply', sectionCount: 3, reviewCount: 0 },
+    {
+      id: 'b', createdAt: '2026-08-17T12:00:00.000Z', kind: 'autosync',
+      autosync: autosyncEntry({ createdAt: '2026-08-17T12:00:00.000Z' }),
+    },
+    { id: 'c', createdAt: '2026-08-17T11:00:00.000Z', kind: 'apply', sectionCount: 2, reviewCount: 0 },
+  ];
+  const sorted = projectSyncHistoryEntries(entries);
+  assert.equal(sorted[0]!.id, 'b');
+  assert.equal(sorted[1]!.id, 'c');
+  assert.equal(sorted[2]!.id, 'a');
+});
+
+test('directionLabel / autosyncStatusLabel：方向与状态映射', () => {
+  assert.equal(directionLabel('pull'), '下载');
+  assert.equal(directionLabel('push'), '上传');
+  assert.equal(directionLabel('both'), '双向');
+  assert.equal(autosyncStatusLabel('success'), '成功');
+  assert.equal(autosyncStatusLabel('skipped'), '已跳过');
+  assert.equal(autosyncStatusLabel('failed'), '失败');
+  assert.equal(autosyncStatusLabel('partial'), '部分成功');
+});
+
+test('describeSkipReason：已知原因映射，未知回退原串', () => {
+  assert.equal(describeSkipReason('conflict'), '冲突项被跳过');
+  assert.equal(describeSkipReason('no-remote'), '远端无快照');
+  assert.equal(describeSkipReason('not-configured'), '未配置仓库');
+  assert.equal(describeSkipReason('network'), '网络问题');
+  assert.equal(describeSkipReason('weird'), 'weird');
+  assert.equal(describeSkipReason(undefined), '未知');
+});
+
+test('projectAutosyncEntry：摘要行 + 可展开明细（冲突分区 / 应用分区 / 错误）', () => {
+  const row = projectAutosyncEntry(autosyncEntry({}));
+  assert.equal(row.direction, '双向');
+  assert.equal(row.status, '已跳过');
+  assert.match(row.summary, /双向/);
+  assert.match(row.summary, /已跳过/);
+  assert.match(row.summary, /冲突项被跳过/);
+  assert.deepEqual(row.conflictedSections, ['settings', 'plugins']);
+  assert.equal(row.hasDetail, true);
+});
+
+test('projectAutosyncEntry：无冲突/无应用/无错误 → hasDetail=false', () => {
+  const row = projectAutosyncEntry(autosyncEntry({
+    conflictedSections: undefined, appliedSections: undefined, error: undefined,
+  }));
+  assert.equal(row.hasDetail, false);
+});
+
+test('formatDateTime：合法 ISO → 本地格式；空/非法回退', () => {
+  assert.match(formatDateTime('2026-08-17T10:30:00.000Z'), /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/);
+  assert.equal(formatDateTime(''), '—');
+  assert.equal(formatDateTime('not-a-date'), 'not-a-date');
+});

package/src/client/sync/history-model.ts

@@ -0,0 +1,112 @@
+/**
+ * m-sync-ui (P2b)：SyncHistoryView 的纯函数投影。
+ *
+ * 现状：本地祖先快照目录（manifest.json）→ SnapshotHistoryEntry；倒序排序 + ISO 格式化。
+ * 方案 A 扩展：/sync/history 现返回 { entries: SyncHistoryEntry[] }（快照 kind=apply
+ * + 自动同步 kind=autosync），投影需统一处理两源，并生成自动同步跳过冲突的可读明细。
+ */
+import type { AutosyncHistoryEntry, SyncHistoryEntry } from './sync-api.ts';
+
+/** 兼容旧快照条目（manifest.json 投影）。 */
+export interface SnapshotHistoryEntry {
+  id: string;
+  createdAt: string;
+  /** 分区数（manifest.sectionHashes 的 key 数） */
+  sectionCount: number;
+  /** 关联到该快照的待审项数（来自 sync-review-queue.json 中的 items） */
+  reviewCount: number;
+}
+
+/** 把快照 entries 排序（createdAt 倒序）并组装展示字段。 */
+export function projectHistoryRows(entries: readonly SnapshotHistoryEntry[]): SnapshotHistoryEntry[] {
+  return [...entries].sort(byCreatedAtDesc);
+}
+
+/** 统一历史条目（快照 + 自动同步）按 createdAt 倒序排序。 */
+export function projectSyncHistoryEntries(entries: readonly SyncHistoryEntry[]): SyncHistoryEntry[] {
+  return [...entries].sort(byCreatedAtDesc);
+}
+
+function byCreatedAtDesc(a: { createdAt: string }, b: { createdAt: string }): number {
+  return a.createdAt < b.createdAt ? 1 : a.createdAt > b.createdAt ? -1 : 0;
+}
+
+/** ISO 时间 → 本地可读字符串（短格式） */
+export function formatDateTime(iso: string): string {
+  if (!iso) return '—';
+  const d = new Date(iso);
+  if (isNaN(d.getTime())) return iso;
+  const pad = (n: number) => String(n).padStart(2, '0');
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+
+/* ---------------------------------------------------------------- 自动同步记录投影 */
+
+/** 自动同步执行记录的方向可读标签。 */
+export function directionLabel(direction: AutosyncHistoryEntry['direction']): string {
+  switch (direction) {
+    case 'pull': return '下载';
+    case 'push': return '上传';
+    default: return '双向';
+  }
+}
+
+/** 自动同步执行状态可读标签。 */
+export function autosyncStatusLabel(status: AutosyncHistoryEntry['status']): string {
+  switch (status) {
+    case 'success': return '成功';
+    case 'skipped': return '已跳过';
+    case 'partial': return '部分成功';
+    default: return '失败';
+  }
+}
+
+/** 跳过原因 → 可读描述（host 透传语义；未知原因回退原串）。 */
+export function describeSkipReason(reason: string | undefined): string {
+  switch (reason) {
+    case 'conflict': return '冲突项被跳过';
+    case 'no-remote': return '远端无快照';
+    case 'not-configured': return '未配置仓库';
+    case 'network': return '网络问题';
+    default: return reason ?? '未知';
+  }
+}
+
+/** 把一条自动同步记录投影为展示行（摘要文本 + 可展开的被跳过冲突分区明细）。 */
+export interface AutosyncHistoryRow {
+  id: string;
+  createdAt: string;
+  direction: string;
+  status: string;
+  /** 摘要行文本（如「下载 · 已跳过 · 冲突项被跳过」）。 */
+  summary: string;
+  /** 被跳过的冲突分区 id（展开明细用）；无则 undefined。 */
+  conflictedSections?: string[];
+  /** 实际应用的分区 id。 */
+  appliedSections?: string[];
+  error?: string;
+  notifiedAt?: string;
+  /** 是否有关联的跳过分区明细可展开。 */
+  hasDetail: boolean;
+}
+
+/** 自动同步记录 → 展示行投影。 */
+export function projectAutosyncEntry(entry: AutosyncHistoryEntry): AutosyncHistoryRow {
+  const parts: string[] = [directionLabel(entry.direction), autosyncStatusLabel(entry.status)];
+  if (entry.skipReason !== undefined) parts.push(describeSkipReason(entry.skipReason));
+  return {
+    id: entry.createdAt,
+    createdAt: entry.createdAt,
+    direction: directionLabel(entry.direction),
+    status: autosyncStatusLabel(entry.status),
+    summary: parts.join(' · '),
+    conflictedSections: entry.conflictedSections,
+    appliedSections: entry.appliedSections,
+    error: entry.error,
+    notifiedAt: entry.notifiedAt,
+    hasDetail:
+      (entry.conflictedSections !== undefined && entry.conflictedSections.length > 0) ||
+      (entry.appliedSections !== undefined && entry.appliedSections.length > 0) ||
+      entry.error !== undefined,
+  };
+}