import { createMockHttpBridge, resetMockHttpBridge, type MockHttpBridge } from '../_helpers/mockHttpBridge';
// 相对路径按各分区深度调整:
//   tests/unit/assistants/x.test.ts    → '../_helpers/mockHttpBridge'
//   tests/unit/providers/x.test.ts     → '../_helpers/mockHttpBridge'
//   tests/unit/bootstrap/x.test.ts     → '../_helpers/mockHttpBridge'

import { describe, it, expect, beforeEach } from 'vitest';
import {} from /* 被测 */ '@/path/to/module';

describe('moduleUnderTest', () => {
  beforeEach(() => {
    // 每个测试独立;无 mock 残留
  });

  it('happy path', () => {
    expect(moduleUnderTest.foo('bar')).toBe('baz');
  });
  // ...
});

import { describe, it, expect, beforeEach, vi } from 'vitest';
import { createMockHttpBridge, type MockHttpBridge } from '../_helpers/mockHttpBridge';

// 顶部 inline vi.mock(不引用外部 const;仅 vi.fn() 占位)
vi.mock('@/common/adapter/httpBridge', () => ({
  httpGet: vi.fn(),
  httpPost: vi.fn(),
  httpPut: vi.fn(),
  httpPatch: vi.fn(),
  httpDelete: vi.fn(),
  stubProvider: vi.fn(),
  withResponseMap: vi.fn(),
  wsEmitter: vi.fn(),
  wsMappedEmitter: vi.fn(),
  stubEmitter: vi.fn(),
  httpRequest: vi.fn(),
  getBaseUrl: vi.fn(() => ''),
  BackendHttpError: class BackendHttpError extends Error {
    constructor(
      public status: number,
      public code: string,
      message: string
    ) {
      super(message);
      this.name = 'BackendHttpError';
    }
  },
  isBackendHttpError: (e: unknown): boolean => e instanceof Error && e.name === 'BackendHttpError',
}));

// 然后 import 被测 + helper
import {} from /* 被测 */ '@/path/to/module';
import * as httpBridge from '@/common/adapter/httpBridge';

describe('moduleUnderTest', () => {
  let mock: MockHttpBridge;

  beforeEach(() => {
    // clearAllMocks 清调用记录,不毁 vi.mock 模块替换
    vi.clearAllMocks();

    // 每个 test 重建 mock 实例并把 asModule() 的工厂绑定到 vi.fn() 上
    mock = createMockHttpBridge({ unmatched: 'throw' });
    const m = mock.asModule();
    // 把 mock 实例的每个工厂绑到 vi.mock 声明的 vi.fn() 上
    (httpBridge.httpGet as any).mockImplementation(m.httpGet);
    (httpBridge.httpPost as any).mockImplementation(m.httpPost);
    (httpBridge.httpPut as any).mockImplementation(m.httpPut);
    (httpBridge.httpPatch as any).mockImplementation(m.httpPatch);
    (httpBridge.httpDelete as any).mockImplementation(m.httpDelete);
    (httpBridge.stubProvider as any).mockImplementation(m.stubProvider);
    (httpBridge.withResponseMap as any).mockImplementation(m.withResponseMap);
    (httpBridge.wsEmitter as any).mockImplementation(m.wsEmitter);
    (httpBridge.wsMappedEmitter as any).mockImplementation(m.wsMappedEmitter);
    (httpBridge.stubEmitter as any).mockImplementation(m.stubEmitter);
  });

  it('registers GET route and records call', async () => {
    mock.onGet('/api/foo', () => ({ value: 42 }));
    const result = await httpBridge.httpGet('/api/foo').invoke();
    expect(result).toEqual({ value: 42 });
    expect(mock.calls).toHaveLength(1);
    expect(mock.calls[0]).toMatchObject({ method: 'GET', path: '/api/foo' });
  });
});

vi.mock('@/common', () => ({
  ipcBridge: {
    assistants: {
      list: { invoke: vi.fn(), provider: vi.fn() },
      create: { invoke: vi.fn(), provider: vi.fn() },
      // ... 按被测模块实际用到的 method 列
    },
    // 其它 namespace 按需
  },
}));
import { ipcBridge } from '@/common';
// beforeEach 里 (ipcBridge.assistants.list.invoke as any).mockResolvedValue([...])

mock.asModule().wsEmitter('cron.onJobCreated').on((job: any) => {
  /* subscriber side */
});
mock.emit('cron.onJobCreated', { id: 'j1', ... });

// ❌ 不行:vi.mock 工厂引用外部 const
const mock = createMockHttpBridge();
vi.mock('@/common/adapter/httpBridge', () => mock.asModule()); // 死

// ❌ 不行:async factory + dynamic import
vi.mock('@/common/adapter/httpBridge', async () => {
  const m = createMockHttpBridge();
  return m.asModule();
}); // worker fork 死锁

// ❌ 不行:vi.hoisted + require
const { mock } = vi.hoisted(() => {
  return { mock: require('../_helpers/mockHttpBridge').createMockHttpBridge() };
}); // MODULE_NOT_FOUND

// ❌ 不行:restoreAllMocks() — 会移除 vi.mock,后续测试炸
afterEach(() => {
  vi.restoreAllMocks();
});

// ✅ 应该:
afterEach(() => {
  vi.clearAllMocks();
});
// 或靠 beforeEach 重建,啥都不加

cd /Users/zhoukai/Documents/github/AionUi
git fetch origin

# 检查远端是否已有 feat/n4-test-rewrite-domains
if git show-ref --quiet refs/remotes/origin/feat/n4-test-rewrite-domains; then
  echo "N4_BRANCH_EXISTS_REMOTE"
  git rev-parse origin/feat/n4-test-rewrite-domains
else
  echo "N4_BRANCH_NEW"
fi

cd /Users/zhoukai/Documents/github/AionUi

node --version            # 预期: v22.x
bun --version             # 预期: 1.x
bunx vitest --version     # 预期: vitest/4.x
bunx tsc --version        # 预期: Version 5.x
which prek                # 预期: 非空
prek --version            # 预期: 可读
which gh                  # 预期: 非空(handoff 备用)
git --version             # 预期: 2.x

# 验证 N3 产物存在
test -f tests/unit/_helpers/mockHttpBridge.ts && echo "helper OK" || { echo "MISSING helper"; exit 1; }
test -f tests/unit/_helpers/mockHttpBridge.test.ts && echo "helper self-test OK"

cd /Users/zhoukai/Documents/github/AionUi
git fetch origin
git show-ref --quiet refs/remotes/origin/feat/n4-test-rewrite-domains && echo "N4_BRANCH_EXISTS_REMOTE" || echo "N4_BRANCH_NEW"

git status --porcelain
# 预期:无输出。非空 → STOP,escalate。

git rev-parse origin/feat/n3-test-rewrite-adapter-common > /tmp/n4-baseline-n3-sha.txt
cat /tmp/n4-baseline-n3-sha.txt
# 预期:df071f82a... 或更新(N3 分支最新 SHA)

git rev-parse origin/feat/backend-migration > /tmp/n4-baseline-base-sha.txt
cat /tmp/n4-baseline-base-sha.txt
# 预期:e4cdff41f...(基线)

mkdir -p /tmp/n4-baseline

# 记录 N3 测试基线(6 files / 88 tests 全绿)
bunx vitest run --reporter=default 2>&1 | tee /tmp/n4-baseline/vitest.log | tail -10
echo "exit=$?" >> /tmp/n4-baseline/vitest.log
# 预期:Test Files 6 passed (6),Tests 88 passed (88),退出 0

# 记录骨架目录的文件数(N4 开工前,每个分区目录只有 .gitkeep)
for d in assistants skills extension providers system cron previews assets bootstrap; do
  find tests/unit/$d -type f 2>/dev/null | wc -l
done > /tmp/n4-baseline/dir-counts.txt
cat /tmp/n4-baseline/dir-counts.txt
# 预期:9 行每行为 1(各目录只有 .gitkeep);若是 0 说明 .gitkeep 已删

cd /Users/zhoukai/Documents/github/AionUi

# 基于 N3 最新分支创建 N4 分支
git checkout -b feat/n4-test-rewrite-domains origin/feat/n3-test-rewrite-adapter-common
git rev-parse --abbrev-ref HEAD
# 预期:feat/n4-test-rewrite-domains

git merge-base --is-ancestor origin/feat/n3-test-rewrite-adapter-common HEAD && echo "base OK"
# 预期:base OK

# 立即 push 空分支,让其它 executor 能检测到
git push -u origin feat/n4-test-rewrite-domains
# 预期:成功

cd /Users/zhoukai/Documents/github/AionUi

git fetch origin feat/n4-test-rewrite-domains
git checkout -b feat/n4-test-rewrite-domains origin/feat/n4-test-rewrite-domains 2>/dev/null || {
  git checkout feat/n4-test-rewrite-domains
  git pull --rebase origin feat/n4-test-rewrite-domains
}

git rev-parse --abbrev-ref HEAD
# 预期:feat/n4-test-rewrite-domains

git log --oneline -5
# 检查已有哪些 commit(来自先到路的工作)

bun install
git diff bun.lock
# 预期:无输出(bun install 未改 lockfile)

# N4a
for d in assistants skills extension; do test -d "tests/unit/$d" || { echo "MISSING: tests/unit/$d"; exit 1; }; done
# N4b
for d in providers system cron; do test -d "tests/unit/$d" || { echo "MISSING: tests/unit/$d"; exit 1; }; done
# N4c
for d in previews assets bootstrap; do test -d "tests/unit/$d" || { echo "MISSING: tests/unit/$d"; exit 1; }; done

# 自己分区的 .gitkeep 存在(首次加文件前删除)
# N4a:ls tests/unit/{assistants,skills,extension}/.gitkeep
# N4b:ls tests/unit/{providers,system,cron}/.gitkeep
# N4c:ls tests/unit/{previews,assets,bootstrap}/.gitkeep

git rm tests/unit/assistants/.gitkeep

bunx vitest run tests/unit/assistants/assistantUtils.test.ts --reporter=verbose 2>&1 | tee /tmp/n4a-phase2a-vitest.log | tail -20
echo "exit=$?"
# 预期:退出 0;passed ≥ 5

git add tests/unit/assistants/
git commit -m "test(n4a): add assistantUtils unit tests (A5)

Covers sortAssistants() builtin-first ordering, stable sort, and
null/undefined guard paths (L1 pure function suite, no mock)."

import { describe, it, expect, beforeEach, vi } from 'vitest';
import { renderHook, act, waitFor } from '@testing-library/react';

vi.mock('@/common', () => ({
  ipcBridge: {
    assistants: {
      list: { invoke: vi.fn(), provider: vi.fn() },
      get: { invoke: vi.fn(), provider: vi.fn() },
      create: { invoke: vi.fn(), provider: vi.fn() },
      update: { invoke: vi.fn(), provider: vi.fn() },
      delete: { invoke: vi.fn(), provider: vi.fn() },
      // 按源码实际用到的 method 扩
    },
    skills: {
      list: { invoke: vi.fn(), provider: vi.fn() },
      // ...
    },
  },
}));

// react-i18next 的 useTranslation 为被测 hook 所用
vi.mock('react-i18next', () => ({
  useTranslation: () => ({
    t: (k: string) => k,
    i18n: { language: 'en', changeLanguage: vi.fn() },
  }),
}));

bunx vitest run tests/unit/assistants/ --reporter=verbose 2>&1 | tee /tmp/n4a-phase3a-vitest.log | tail -30
echo "exit=$?"
# 预期:退出 0;5 个文件全绿(A1-A5),tests ≥ 5 + 4*3 = 17

git add tests/unit/assistants/
git commit -m "test(n4a): add assistants hooks dom tests (A1-A4)

Covers useAssistantList load/select/error paths, useAssistantEditor
form state management, useAssistantSkills CRUD, and useDetectedAgents
detection logic via ipcBridge mocks."

import { describe, it, expect, beforeEach, vi } from 'vitest';
import { render, screen, cleanup } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { ConfigProvider } from '@arco-design/web-react';

vi.mock('@/common', () => ({
  ipcBridge: { /* 按被测 component 实际调用的 method */ },
}));
vi.mock('react-i18next', () => ({
  useTranslation: () => ({ t: (k: string) => k, i18n: { language: 'en' } }),
}));

import { ComponentUnderTest } from '@/renderer/pages/.../ComponentUnderTest';

describe('ComponentUnderTest', () => {
  const renderWithProviders = (props: any) =>
    render(
      <ConfigProvider>
        <ComponentUnderTest {...props} />
      </ConfigProvider>
    );

  beforeEach(() => {
    vi.clearAllMocks();
  });

  afterEach(() => {
    cleanup();
  });

  it('renders without crashing (happy)', () => { /* 渲染 + assert */ });
  it('handles user interaction (click/type)', async () => {
    const user = userEvent.setup();
    renderWithProviders({ ... });
    await user.click(screen.getByRole('button', { name: /.../ }));
    /* assert */
  });
  it('shows loading state', () => { /* ... */ });
  it('shows error state', () => { /* ... */ });
  it('shows empty state', () => { /* ... */ });
});

bunx vitest run tests/unit/assistants/*.dom.test.tsx --reporter=verbose 2>&1 | tee /tmp/n4a-phase4a-vitest.log | tail -40
echo "exit=$?"
# 预期:退出 0;5 个 dom.test.tsx 全绿,tests ≥ 5 * 5 = 25

git add tests/unit/assistants/
git commit -m "test(n4a): add assistants L3 component dom tests (A6-A10)

Covers AssistantListPanel list + interaction, AssistantEditDrawer form
flow, DeleteAssistantModal confirm guard, AddSkillsModal selection, and
SkillConfirmModals multi-modal dialogs via userEvent + ipcBridge mocks."

vi.mock('@/common/config/configMigration', () => ({
  migrateConfigStorage: vi.fn(),
  migrateProviders: vi.fn(),
}));
vi.mock('@/common/adapter/httpBridge', () => ({ httpRequest: vi.fn() }));
vi.mock('./migrateAssistants', () => ({ migrateAssistantsToBackend: vi.fn() }));
// ProcessConfig stub 同 A11

bunx vitest run tests/unit/assistants/migrateAssistants.test.ts tests/unit/assistants/runBackendMigrations.test.ts --reporter=verbose 2>&1 | tee /tmp/n4a-phase5a-vitest.log | tail -30
echo "exit=$?"
# 预期:退出 0;2 files / ≥ 10 tests 全绿

git add tests/unit/assistants/
git commit -m "test(n4a): add assistants L4 migration tests (A11-A12)

Covers migrateAssistants legacy→backend import path (empty, builtin
skip, flag set, per-item failure tolerance) and runBackendMigrations
orchestrator ordering + partial-failure allSucceeded flag."

bunx vitest run tests/unit/skills/ --reporter=verbose 2>&1 | tee /tmp/n4a-phase6a-vitest.log | tail -30
echo "exit=$?"
# 预期:退出 0;4 files / tests ≥ 5 + 5 + 3 + 5 = 18

git add tests/unit/skills/
git commit -m "test(n4a): add skills tests (SK1-SK4)

Covers skillSuggestParser pure parsing (L1), AddCustomPathModal input
validation (L3), useAssistantSkills integration via mockHttpBridge
(L4), and SkillsHubSettings page render + interaction (L3)."

# 删除 .gitkeep 在本 Phase 首次加文件时一次性处理
git rm tests/unit/extension/.gitkeep 2>/dev/null || true

bunx vitest run tests/unit/extension/ --reporter=verbose 2>&1 | tee /tmp/n4a-phase7a-vitest.log | tail -30
echo "exit=$?"
# 预期:退出 0;3 files / tests ≥ 15

git add tests/unit/extension/
git commit -m "test(n4a): add extension tests (E1-E3)

Covers ExtensionSettingsPage + ExtensionSettingsTabContent render/
interaction (L3) and extensionMapperIntegration /api/extension/* route
sequence + payload shape via mockHttpBridge (L4)."

git rm tests/unit/providers/.gitkeep

# 写 4 个文件后
bunx vitest run tests/unit/providers/RotatingApiClient.test.ts tests/unit/providers/ApiKeyManager.test.ts tests/unit/providers/ClientFactory.test.ts tests/unit/providers/ProtocolConverter.test.ts --reporter=verbose 2>&1 | tee /tmp/n4b-phase2b-vitest.log | tail -30
echo "exit=$?"
# 预期:退出 0;4 files / tests ≥ 20

git add tests/unit/providers/
git commit -m "test(n4b): add providers L1 pure function tests (P5-P8)

Covers ApiKeyManager rotation + 90s blacklist (with fake timers),
RotatingApiClient retry semantics, ClientFactory auth-type dispatch,
and ProtocolConverter OpenAI↔Anthropic roundtrip."

vi.mock('@/common', () => ({
  ipcBridge: {
    mode: {
      listProviders: { invoke: vi.fn(), provider: vi.fn() },
      createProvider: { invoke: vi.fn(), provider: vi.fn() },
      // ...
    },
  },
}));

// SWR cache 清理
import { SWRConfig } from 'swr';
const wrapper = ({ children }: any) => (
  <SWRConfig value={{ provider: () => new Map() }}>{children}</SWRConfig>
);

// 在 renderHook 时传 wrapper
renderHook(() => useModelProviderList(), { wrapper });

bunx vitest run tests/unit/providers/use*.dom.test.ts --reporter=verbose 2>&1 | tee /tmp/n4b-phase3b-vitest.log | tail -30
echo "exit=$?"

git add tests/unit/providers/
git commit -m "test(n4b): add providers hooks dom tests (P1-P3)

Covers useModelProviderList SWR fetch + availability filters,
useConfigModelListWithImage image-gen provider selection, and
useGoogleAuthModels OAuth model listing."

bunx vitest run tests/unit/providers/ModelModalContent.dom.test.tsx --reporter=verbose 2>&1 | tee /tmp/n4b-phase4b-vitest.log | tail -20
echo "exit=$?"

git add tests/unit/providers/
git commit -m "test(n4b): add ModelModalContent dom tests (P4)

Covers add/edit/delete provider and test-connection flows via userEvent
+ ipcBridge.mode.* mocks."

grep -rn "/api/settings/client" packages/desktop/src/renderer --include='*.ts' --include='*.tsx' | head

git rm tests/unit/system/.gitkeep

bunx vitest run tests/unit/system/ --reporter=verbose 2>&1 | tee /tmp/n4b-phase5b-vitest.log | tail -30
echo "exit=$?"

git add tests/unit/system/
git commit -m "test(n4b): add system settings tests (S1-S3)

Covers SystemModalContent main settings screen, clientPrefSettings
round-trip through /api/settings/client (mockHttpBridge), and
DisplayModalContent theme/font/language switch flows."

vi.mock('@/common', () => {
  const listeners: Record<string, Array<(p: any) => void>> = {};
  const ws = {
    on: (name: string) => (cb: (p: any) => void) => {
      (listeners[name] ||= []).push(cb);
      return () => {
        listeners[name] = listeners[name].filter((c) => c !== cb);
      };
    },
    emit: (name: string, payload: any) => {
      (listeners[name] || []).forEach((c) => c(payload));
    },
  };
  return {
    ipcBridge: {
      cron: {
        listJobs: { invoke: vi.fn(), provider: vi.fn() },
        listJobsByConversation: { invoke: vi.fn(), provider: vi.fn() },
        updateJob: { invoke: vi.fn(), provider: vi.fn() },
        removeJob: { invoke: vi.fn(), provider: vi.fn() },
        onJobCreated: { on: ws.on('cron.onJobCreated'), emit: vi.fn() },
        onJobUpdated: { on: ws.on('cron.onJobUpdated'), emit: vi.fn() },
        onJobRemoved: { on: ws.on('cron.onJobRemoved'), emit: vi.fn() },
        onJobExecuted: { on: ws.on('cron.onJobExecuted'), emit: vi.fn() },
      },
      conversation: {
        listByCronJob: { invoke: vi.fn(), provider: vi.fn() },
        listChanged: { on: ws.on('conv.listChanged'), emit: vi.fn() },
      },
    },
    __wsEmit: ws.emit,
  };
});
// 测试里 import { __wsEmit } from '@/common';(`(await import('@/common') as any).__wsEmit`)

git rm tests/unit/cron/.gitkeep

bunx vitest run tests/unit/cron/ --reporter=verbose 2>&1 | tee /tmp/n4b-phase6b-vitest.log | tail -50
echo "exit=$?"
# 预期:退出 0;7 files / tests ≥ 35

git add tests/unit/cron/
git commit -m "test(n4b): add cron tests (C1-C7)

Covers cronUtils pure helpers (L1), useCronJobs WS event subscription
+ state (L2, __wsEmit pattern), and 5 component tests for
CreateTaskDialog, TaskDetailPage, CronStatusTag, CronJobSiderSection,
and CronJobManager (L3)."

git rm tests/unit/previews/.gitkeep

bunx vitest run tests/unit/previews/fileUtils.test.ts tests/unit/previews/PreviewContext.dom.test.tsx tests/unit/previews/usePreviewHistory.dom.test.ts --reporter=verbose 2>&1 | tee /tmp/n4c-phase2c-vitest.log | tail -30
echo "exit=$?"

git add tests/unit/previews/
git commit -m "test(n4c): add preview utils/context/history hook tests (V1, V2, V11)

Covers fileUtils + previewUrls pure helpers (L1), PreviewContext
provider + hook API (L3), and usePreviewHistory snapshot debounce +
ipcBridge round-trip (L2)."

bunx vitest run tests/unit/previews/*Viewer.dom.test.tsx --reporter=verbose 2>&1 | tee /tmp/n4c-phase3c-vitest.log | tail -40
echo "exit=$?"
# 预期:6 files / tests ≥ 30

git add tests/unit/previews/
git commit -m "test(n4c): add preview viewers L3 dom tests (V3-V8)

Covers OfficeWatchViewer / PptViewer / OfficeDocViewer / ExcelViewer /
MarkdownViewer / HTMLViewer render + load-state + error handling via
stubbed renderers and PreviewContext."

import { PreviewPanel } from '@/renderer/pages/conversation/Preview/components/PreviewPanel/PreviewPanel';
import { PreviewHistoryDropdown } from '@/renderer/pages/conversation/Preview/components/PreviewPanel/PreviewHistoryDropdown';

find packages/desktop/src/renderer/pages/conversation/Preview -name "PreviewPanel.tsx" -o -name "PreviewHistoryDropdown.tsx"

bunx vitest run tests/unit/previews/PreviewPanel.dom.test.tsx tests/unit/previews/PreviewHistoryDropdown.dom.test.tsx tests/unit/previews/previewHistoryIntegration.test.ts --reporter=verbose 2>&1 | tee /tmp/n4c-phase4c-vitest.log | tail -30
echo "exit=$?"
# 预期:退出 0;3 files / tests ≥ 15

git add tests/unit/previews/
git commit -m "test(n4c): add preview panel + history tests (V9, V10, V12)

Covers PreviewPanel viewer dispatch + history dropdown integration,
PreviewHistoryDropdown snapshot list + delete, and
previewHistoryIntegration /api/preview-history/* route sequence via
mockHttpBridge (L4)."

git rm tests/unit/assets/.gitkeep

bunx vitest run tests/unit/assets/ --reporter=verbose 2>&1 | tee /tmp/n4c-phase5c-vitest.log | tail -20
echo "exit=$?"

git add tests/unit/assets/
git commit -m "test(n4c): add assets tests (X1-X2)

Covers agentLogo case-insensitive lookup + extension adapter path +
dark-theme variant swap, and presetAssistantResources default loader
+ fallback."

git rm tests/unit/bootstrap/.gitkeep

bunx vitest run tests/unit/bootstrap/ --reporter=verbose 2>&1 | tee /tmp/n4c-phase6c-vitest.log | tail -30
echo "exit=$?"

git add tests/unit/bootstrap/
git commit -m "test(n4c): add bootstrap tests (B1-B3)

Covers initStorage migration branch dispatch (L4), end-to-end
configMigration + migrateAssistants + runBackendMigrations first-boot
flow via mockHttpBridge, and per-step failure recovery preserving
allSucceeded flag."

for f in \
  tests/unit/assistants/useAssistantList.dom.test.ts \
  tests/unit/assistants/useAssistantEditor.dom.test.ts \
  tests/unit/assistants/useAssistantSkills.dom.test.ts \
  tests/unit/assistants/useDetectedAgents.dom.test.ts \
  tests/unit/assistants/assistantUtils.test.ts \
  tests/unit/assistants/AssistantListPanel.dom.test.tsx \
  tests/unit/assistants/AssistantEditDrawer.dom.test.tsx \
  tests/unit/assistants/DeleteAssistantModal.dom.test.tsx \
  tests/unit/assistants/AddSkillsModal.dom.test.tsx \
  tests/unit/assistants/SkillConfirmModals.dom.test.tsx \
  tests/unit/assistants/migrateAssistants.test.ts \
  tests/unit/assistants/runBackendMigrations.test.ts \
  tests/unit/skills/skillSuggestParser.test.ts \
  tests/unit/skills/AddCustomPathModal.dom.test.tsx \
  tests/unit/skills/useAssistantSkillsIntegration.dom.test.ts \
  tests/unit/skills/SkillsHubSettings.dom.test.tsx \
  tests/unit/extension/ExtensionSettingsPage.dom.test.tsx \
  tests/unit/extension/ExtensionSettingsTabContent.dom.test.tsx \
  tests/unit/extension/extensionMapperIntegration.test.ts; do
  test -f "$f" || { echo "MISSING: $f"; exit 1; }
done
echo "N4a file checklist OK (19)"

for f in \
  tests/unit/providers/useModelProviderList.dom.test.ts \
  tests/unit/providers/useConfigModelListWithImage.dom.test.ts \
  tests/unit/providers/useGoogleAuthModels.dom.test.ts \
  tests/unit/providers/ModelModalContent.dom.test.tsx \
  tests/unit/providers/RotatingApiClient.test.ts \
  tests/unit/providers/ApiKeyManager.test.ts \
  tests/unit/providers/ClientFactory.test.ts \
  tests/unit/providers/ProtocolConverter.test.ts \
  tests/unit/system/SystemModalContent.dom.test.tsx \
  tests/unit/system/clientPrefSettings.test.ts \
  tests/unit/system/DisplayModalContent.dom.test.tsx \
  tests/unit/cron/cronUtils.test.ts \
  tests/unit/cron/useCronJobs.dom.test.ts \
  tests/unit/cron/CreateTaskDialog.dom.test.tsx \
  tests/unit/cron/TaskDetailPage.dom.test.tsx \
  tests/unit/cron/CronStatusTag.dom.test.tsx \
  tests/unit/cron/CronJobSiderSection.dom.test.tsx \
  tests/unit/cron/CronJobManager.dom.test.tsx; do
  test -f "$f" || { echo "MISSING: $f"; exit 1; }
done
echo "N4b file checklist OK (18)"

for f in \
  tests/unit/previews/PreviewContext.dom.test.tsx \
  tests/unit/previews/usePreviewHistory.dom.test.ts \
  tests/unit/previews/OfficeWatchViewer.dom.test.tsx \
  tests/unit/previews/PptViewer.dom.test.tsx \
  tests/unit/previews/OfficeDocViewer.dom.test.tsx \
  tests/unit/previews/ExcelViewer.dom.test.tsx \
  tests/unit/previews/MarkdownViewer.dom.test.tsx \
  tests/unit/previews/HTMLViewer.dom.test.tsx \
  tests/unit/previews/PreviewPanel.dom.test.tsx \
  tests/unit/previews/PreviewHistoryDropdown.dom.test.tsx \
  tests/unit/previews/fileUtils.test.ts \
  tests/unit/previews/previewHistoryIntegration.test.ts \
  tests/unit/assets/agentLogo.test.ts \
  tests/unit/assets/presetAssistantResources.test.ts \
  tests/unit/bootstrap/initStorage.migrations.test.ts \
  tests/unit/bootstrap/configMigrationIntegration.test.ts \
  tests/unit/bootstrap/migrationErrorRecovery.test.ts; do
  test -f "$f" || { echo "MISSING: $f"; exit 1; }
done
echo "N4c file checklist OK (17)"

# 1. Lint
bun run lint 2>&1 | tee /tmp/n4-phase8-lint.log | tail -15
echo "exit=$?"
# 预期:0 errors(允许 warnings)

# 2. TSC
bunx tsc --noEmit 2>&1 | tee /tmp/n4-phase8-tsc.log | tail -20
echo "exit=$?"
# 预期:退出 0

# 3. Vitest full(所有 executor 跑完整个 suite)
bunx vitest run --reporter=verbose 2>&1 | tee /tmp/n4-phase8-vitest.log | tail -60
echo "exit=$?"
# 预期:Test Files ≥ 60 passed (60),Tests ≥ 88 + 180 = 268 passed

# 4. prek
prek run --from-ref origin/feat/backend-migration --to-ref HEAD 2>&1 | tee /tmp/n4-phase8-prek.log | tail -15
echo "exit=$?"
# 预期:退出 0;Oxfmt / Oxlint / TypeScript 都 Passed

# 5. 无 skip/todo
grep -rnE "\.skip\(|\.todo\(|test\.skip|it\.skip|xit\(|xtest\(" tests/unit 2>&1 | tee /tmp/n4-phase8-skip.log
# 预期:无输出(UC-F-4)

# 6. helper 未被改
git diff origin/feat/n3-test-rewrite-adapter-common -- tests/unit/_helpers/mockHttpBridge.ts 2>&1 | tee /tmp/n4-phase8-helper-diff.log
# 预期:无输出(N4 禁止改 helper)

bunx vitest run --coverage 2>&1 | tee /tmp/n4-phase8-coverage.log | grep -E "assistants|skills|extension|providers|system|cron|previews|assets|bootstrap|File" | head -40
# 预期:输出对应领域文件的覆盖率行;handoff Deviations 节对 < 60% 的解释

# 分区 test 总量下限
# N4a: 19 files * avg 3 case = 57 但 L3 组件 ≥ 5 所以至少 ≥ 12*5 + 4*3 + 3*5 = 87 (粗估)
# N4b: 18 files 类似估算 ≥ 65
# N4c: 17 files 类似估算 ≥ 60
# 合计 ≥ 180(requirements 第 253-255 行硬要求)

bunx vitest run --reporter=verbose 2>&1 | grep -E "^Tests" | tail -1
# 预期:"Tests NNN passed (NNN)" with NNN ≥ N3 的 88 + 你分区的下限

cd /Users/zhoukai/Documents/github/AionUi

git fetch origin feat/backend-migration
git log --oneline HEAD..origin/feat/backend-migration | head -10
# 情况 A:无输出 → 基线无新 commit,跳到 9.3
# 情况 B:有输出 → 执行 9.2

git merge origin/feat/backend-migration --no-ff -m "chore(n4): sync with feat/backend-migration"
# 冲突:
#   - 自己分区之外的冲突 → 跟 §4.2 一样,**不大概率**,若发生 escalate
#   - 自己分区的冲突 → 一般是自己修 + 新 commit,记录在 handoff Deviations

bun run lint 2>&1 | tee /tmp/n4-phase9-lint.log | tail -10
echo "exit=$?"

bunx tsc --noEmit 2>&1 | tee /tmp/n4-phase9-tsc.log | tail -10
echo "exit=$?"

bunx vitest run --reporter=verbose 2>&1 | tee /tmp/n4-phase9-vitest.log | tail -10
echo "exit=$?"

prek run --from-ref origin/feat/backend-migration --to-ref HEAD 2>&1 | tee /tmp/n4-phase9-prek.log | tail -10
echo "exit=$?"

git fetch origin feat/n4-test-rewrite-domains

# 情况 1:远端与本地一致 → 直接 push
# 情况 2:远端有别人的 commit → pull --rebase
git pull --rebase origin feat/n4-test-rewrite-domains

# rebase 冲突:
#   - 自己分区文件冲突 → 一定越界了,STOP escalate
#   - 自己分区 .gitkeep / 其它 metadata → 简单 resolve + git rebase --continue

git push -u origin feat/n4-test-rewrite-domains
# 预期:成功

git rev-parse HEAD > /tmp/n4-phase9-final-sha.txt
cat /tmp/n4-phase9-final-sha.txt

## N4{a|b|c} 分区 — 交付摘要

### 已交付(自己分区)

- {19/18/17} 个新测试文件
  - <列出每个文件 + ✓ N tests 行从 /tmp/n4*-phase*-vitest.log 截取>

### UC-F-1 命令输出(原始)

- 分支:feat/n4-test-rewrite-domains
- 最新 SHA(自己最后一个 push):<从 /tmp/n4-phase9-final-sha.txt>
- 基线同步:origin/feat/backend-migration @ <基线 sha> <已合入 / Already up to date>

#### bunx vitest run(自己分区)

<头 10 行 + 尾 10 行 + 总行数 + exit code,从 /tmp/n4-phase8-vitest.log 截取>

#### bunx tsc --noEmit

<同上>

#### bun run lint

<同上>

#### prek run

<同上>

#### skip grep(UC-F-4)

grep ... /tmp/n4-phase8-skip.log 无输出,PASS

#### helper 未改

git diff ... /tmp/n4-phase8-helper-diff.log 无输出,PASS

### 覆盖率(自己分区涉及的源码文件)

<从 /tmp/n4-phase8-coverage.log 截取 9 列表格>

### 与计划的偏离(Deviations)

- <对 requirements 路径的修正:如 V9/V10 实际路径,X1 实际文件>
- <源码路径对不上 requirements 的情况,改了哪些 test 的 import 路径>
- <L3 组件测试若只做浅 snapshot / render,解释原因 + 跟进计划>
- 其它

### Backend 修改(UC-G)

- 仓库 / 分支 / SHA / 文件 / 理由 / 验证(若无改为"无")

### Backend 问题发现(UC-G 必 escalate 情况)

- (若无则"无")

### 遗留问题 / 跟进项

- <本次遗留>

SendMessage({
  to: "team-lead",
  message: "N4{a|b|c} 完成。
  - 分支:feat/n4-test-rewrite-domains
  - SHA(自己最后一个 commit):<sha>
  - 基线同步:origin/feat/backend-migration @ <基线 sha> <已合入 / Already up to date>
  - 分区交付文件数:{19/18/17}
  - 总 tests passed:<N>(全 suite)
  - UC-F 证据:命令输出 ✓ / 无 skip ✓ / helper 未改 ✓ / 基线后复跑 ✓
  - Backend 改动:<有 / 无>,详见子节
  - 偏离计划:<列出>

  以下是本分区的 handoff 子节,请 merge 到 N4-outcome.md 的 {A / B / C} 节:

  <§10.2 模板内容完整粘贴>

  所有其它分区请 team-lead 汇总后统一 handoff。下一步请判定 3 个分区是否全部完成。"
})

TaskUpdate({
  taskId: "7",              // N4a/b/c 并行 executor 任务 id
  status: "completed",
  description: "<加一行:本路完成时间 + 自己的 SendMessage 时间>",
})

# 放弃所有未 push 的本地提交
git checkout feat/n3-test-rewrite-adapter-common
git branch -D feat/n4-test-rewrite-domains
# 完全回到 N3 状态

# 删远程分支,本地重做
git push origin --delete feat/n4-test-rewrite-domains
git checkout feat/n3-test-rewrite-adapter-common
git branch -D feat/n4-test-rewrite-domains
# 重新 checkout 新分支开工