@logictan/dsh-config-manager 0.1.60

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

@@ -0,0 +1,194 @@
+/**
+ * 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 {
+  autosyncBadgeKind, autosyncStatusLabel, describeSkipReason, directionLabel, formatDateTime,
+  formatDateTimeFull, midEllipsis, projectAutosyncEntry, projectSyncHistoryEntries, summarizeSyncHistory,
+} 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), '未知');
+});
+
+// issue #31：宿主统一以 'mutation-locked' 落历史（不细分 LOCKED/STALE）→ 界面不得透出裸 token。
+test('describeSkipReason：mutation-locked 必须有可读中文且不再回退原串', () => {
+  const text = describeSkipReason('mutation-locked');
+  assert.notEqual(text, 'mutation-locked', '绝不透出裸机器 token');
+  assert.match(text, /环境锁/);
+  // 客户端拿不到细分 reason（活锁 vs 残留锁）→ 文案须同时覆盖两种可能并指向处理方向
+  assert.match(text, /残留锁/);
+  assert.match(text, /另一项任务/);
+});
+
+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');
+});
+
+/* ---------------------------------------------------------------- UI 重构新增（需求 4） */
+
+test('formatDateTimeFull：合法 ISO → 含秒的本地时间串；空/非法 → 空串（不渲染 title）', () => {
+  const full = formatDateTimeFull('2026-08-17T10:30:45.000Z');
+  assert.notEqual(full, '');
+  // toLocaleString 含秒字段（本地化格式：年份与秒都存在）
+  assert.match(full, /2026/);
+  assert.equal(formatDateTimeFull(''), '');
+  assert.equal(formatDateTimeFull('not-a-date'), '');
+  // 与短格式语义一致：同一条记录两者都能解析出相同日期
+  assert.match(formatDateTime('2026-08-17T10:30:45.000Z'), /^2026-08-17 \d{2}:30$/);
+});
+
+test('midEllipsis：短串原样返回（未超上限不截断）', () => {
+  assert.equal(midEllipsis('short'), 'short');
+  assert.equal(midEllipsis(''), '');
+  // 恰好等于上限：不截断
+  assert.equal(midEllipsis('a'.repeat(26)), 'a'.repeat(26));
+});
+
+test('midEllipsis：长串保留头尾且中段以 … 替代', () => {
+  const uuid = 'sync-930ceecc-d5cd-4daa-9231-5b837149f527';
+  const out = midEllipsis(uuid, 26);
+  assert.ok(out.includes('…'), '应含中段省略号');
+  assert.equal(out.length, 26, '长度应等于 max');
+  // 尾部是唯一区分信息，必须保留
+  assert.ok(uuid.endsWith(out.slice(out.indexOf('…') + 1)), '尾部应原样保留');
+  assert.ok(uuid.startsWith(out.slice(0, out.indexOf('…'))), '头部应原样保留');
+});
+
+test('midEllipsis：长度上限正确（含省略号在内恰好 max 字符；默认上限 26）', () => {
+  const long = 'x'.repeat(100);
+  assert.equal(midEllipsis(long).length, 26);
+  assert.equal(midEllipsis(long, 10).length, 10);
+  assert.equal(midEllipsis(long, 40).length, 40);
+  // 自定义 max 下头尾分配：head=ceil((max-1)/2)
+  const s = '0123456789ABCDEFGHIJ';
+  assert.equal(midEllipsis(s, 11), '01234…FGHIJ');
+});
+
+test('autosyncBadgeKind：四种状态 → 语义色全覆盖', () => {
+  assert.equal(autosyncBadgeKind('success'), 'ok');
+  assert.equal(autosyncBadgeKind('skipped'), 'warn');
+  assert.equal(autosyncBadgeKind('failed'), 'error');
+  assert.equal(autosyncBadgeKind('partial'), 'warn');
+});
+
+test('projectAutosyncEntry：badgeKind + skipReasonText（需求 D/E 的第二行小字）', () => {
+  const row = projectAutosyncEntry(autosyncEntry({ status: 'skipped', skipReason: 'conflict' }));
+  assert.equal(row.badgeKind, 'warn');
+  assert.equal(row.skipReasonText, '冲突项被跳过');
+  // 摘要串保留（兼容既有调用方/测试）
+  assert.match(row.summary, /冲突项被跳过/);
+
+  const noReason = projectAutosyncEntry(autosyncEntry({ status: 'success', skipReason: undefined }));
+  assert.equal(noReason.badgeKind, 'ok');
+  assert.equal(noReason.skipReasonText, undefined);
+
+  assert.equal(projectAutosyncEntry(autosyncEntry({ status: 'failed' })).badgeKind, 'error');
+  assert.equal(projectAutosyncEntry(autosyncEntry({ status: 'partial' })).badgeKind, 'warn');
+});
+
+test('summarizeSyncHistory：总数/快照数/自动同步数/失败数/跳过数', () => {
+  const rows: SyncHistoryEntry[] = [
+    { id: 'a', createdAt: '2026-08-17T10:00:00.000Z', kind: 'apply', sectionCount: 3, reviewCount: 0 },
+    { id: 'b', createdAt: '2026-08-17T11:00:00.000Z', kind: 'push', sectionCount: 1, reviewCount: 0 },
+    { id: 'c', createdAt: '2026-08-17T12:00:00.000Z', kind: 'rollback', sectionCount: 2, reviewCount: 0 },
+    {
+      id: 'd', createdAt: '2026-08-17T13:00:00.000Z', kind: 'autosync',
+      autosync: autosyncEntry({ status: 'success', createdAt: '2026-08-17T13:00:00.000Z' }),
+    },
+    {
+      id: 'e', createdAt: '2026-08-17T14:00:00.000Z', kind: 'autosync',
+      autosync: autosyncEntry({ status: 'skipped', createdAt: '2026-08-17T14:00:00.000Z' }),
+    },
+    {
+      id: 'f', createdAt: '2026-08-17T15:00:00.000Z', kind: 'autosync',
+      autosync: autosyncEntry({ status: 'failed', error: 'boom', createdAt: '2026-08-17T15:00:00.000Z' }),
+    },
+    {
+      id: 'g', createdAt: '2026-08-17T16:00:00.000Z', kind: 'autosync',
+      autosync: autosyncEntry({ status: 'partial', createdAt: '2026-08-17T16:00:00.000Z' }),
+    },
+  ];
+  assert.deepEqual(summarizeSyncHistory(rows), {
+    total: 7, snapshots: 3, autosync: 4, failed: 1, skipped: 2,
+  });
+});
+
+test('summarizeSyncHistory：空列表 → 全零', () => {
+  assert.deepEqual(summarizeSyncHistory([]), {
+    total: 0, snapshots: 0, autosync: 0, failed: 0, skipped: 0,
+  });
+});
+
+test('summarizeSyncHistory：autosync 缺 autosync 子对象 → 计入 autosync 但不计入 failed/skipped（防御）', () => {
+  const rows: SyncHistoryEntry[] = [{ id: 'x', createdAt: '2026-08-17T10:00:00.000Z', kind: 'autosync' }];
+  assert.deepEqual(summarizeSyncHistory(rows), {
+    total: 1, snapshots: 0, autosync: 1, failed: 0, skipped: 0,
+  });
+});

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

@@ -0,0 +1,195 @@
+/**
+ * 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;
+  /** 关联到该快照的待审项数（待审队列已随合并逻辑删除，当前恒为 0；保留字段兼容契约） */
+  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())}`;
+}
+
+/**
+ * ISO 时间 → 完整本地时间字符串（含秒，用于 td 的 title 悬停提示）。
+ * 非法/空输入回退 ''（不渲染 title，避免出现无意义的提示）。
+ */
+export function formatDateTimeFull(iso: string): string {
+  if (!iso) return '';
+  const d = new Date(iso);
+  if (isNaN(d.getTime())) return '';
+  return d.toLocaleString();
+}
+
+/* ---------------------------------------------------------------- 自动同步记录投影 */
+
+/** 自动同步执行记录的方向可读标签。 */
+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 '网络问题';
+    // issue #31：宿主侧的分类锁判定（LOCKED/STALE/UNKNOWN）统一以 'mutation-locked' 落历史，
+    // 客户端拿不到细分 reason → 文案必须同时覆盖「活锁占用」与「残留锁需回收」两种可能，
+    // 并给出可操作方向（否则界面只显示裸 token，用户无从判断要不要处理）。
+    case 'mutation-locked': return '环境锁被占用（另一项任务进行中，或存在需回收的残留锁）';
+    default: return reason ?? '未知';
+  }
+}
+
+/** 把一条自动同步记录投影为展示行（摘要文本 + 可展开的被跳过冲突分区明细）。 */
+export interface AutosyncHistoryRow {
+  id: string;
+  createdAt: string;
+  direction: string;
+  status: string;
+  /** 摘要行文本（如「下载 · 已跳过 · 冲突项被跳过」）。 */
+  summary: string;
+  /** 状态徽章语义色（列表类型列，见 autosyncBadgeKind）。 */
+  badgeKind: 'ok' | 'warn' | 'error';
+  /** 跳过原因可读文本（列表第二行小字）；无跳过原因则 undefined。 */
+  skipReasonText?: string;
+  /** 被跳过的冲突分区 id（展开明细用）；无则 undefined。 */
+  conflictedSections?: string[];
+  /** 实际应用的分区 id。 */
+  appliedSections?: string[];
+  error?: string;
+  notifiedAt?: string;
+  /** 是否有关联的跳过分区明细可展开。 */
+  hasDetail: boolean;
+}
+
+/* ---------------------------------------------------------------- 展示辅助（UI 重构新增） */
+/**
+ * 中段省略：保留头尾，中段以 … 替代（尾部才是区分信息，不可被截掉）。
+ * 与备份页表格的同名私有函数语义一致；此处导出以便本模块复用 + 单测覆盖
+ * （不在组件间跨文件 import 私有函数）。
+ */
+export function midEllipsis(s: string, max = 26): string {
+  if (s.length <= max) return s;
+  const keep = max - 1;
+  const head = Math.ceil(keep / 2);
+  const tail = keep - head;
+  return `${s.slice(0, head)}…${s.slice(-tail)}`;
+}
+
+/**
+ * 自动同步状态 → Badge 语义色。
+ * success → ok（成功）/ skipped → warn（被动放弃）/ failed → error / partial → warn（未完整成功）。
+ */
+export function autosyncBadgeKind(status: AutosyncHistoryEntry['status']): 'ok' | 'warn' | 'error' {
+  switch (status) {
+    case 'success': return 'ok';
+    case 'failed': return 'error';
+    // skipped / partial：都不是失败，但都需要用户注意
+    default: return 'warn';
+  }
+}
+
+/** 同步历史统计摘要（列表头部徽章行）。 */
+export interface SyncHistorySummary {
+  total: number;
+  snapshots: number;
+  autosync: number;
+  failed: number;
+  skipped: number;
+}
+
+/**
+ * 统计同步历史条目。基于 projectSyncHistoryEntries 的投影结果（本函数不排序）。
+ * - snapshots：apply / push / pull / rollback（快照类）
+ * - autosync：kind='autosync' 的条目数
+ * - failed：自动同步 status='failed'（含 error）
+ * - skipped：自动同步 status='skipped' 或 'partial'（部分成功也计入「需注意」）
+ */
+export function summarizeSyncHistory(rows: readonly SyncHistoryEntry[]): SyncHistorySummary {
+  let snapshots = 0;
+  let autosync = 0;
+  let failed = 0;
+  let skipped = 0;
+  for (const r of rows) {
+    if (r.kind === 'autosync') {
+      autosync += 1;
+      const status = r.autosync?.status;
+      if (status === 'failed') failed += 1;
+      else if (status === 'skipped' || status === 'partial') skipped += 1;
+    } else {
+      snapshots += 1;
+    }
+  }
+  return { total: rows.length, snapshots, autosync, failed, skipped };
+}
+
+/** 自动同步记录 → 展示行投影。 */
+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(' · '),
+    badgeKind: autosyncBadgeKind(entry.status),
+    // E：跳过原因从摘要串里拆出来，单独走第二行小字（摘要串保留以兼容既有测试/调用方）
+    skipReasonText: entry.skipReason !== undefined ? describeSkipReason(entry.skipReason) : undefined,
+    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,
+  };
+}