/** * tests/unit/app_context_workflow.test.ts * * 覆盖 src/commands/app/context.ts tryFetchWorkflows (2026-07-22 eventhub 阻断修复) * * 修复前 symptom: * - `dacli app context --json` 启动时调 POST /workflow/Engine/list, 后端返 404. * - 旧版直接套用 web 历史 fallback 端点, 没读 web .../api/workFlow/template.ts * 权威定义 (GET /workflow/template). * - 修复后改回 web 镜像权威端点, 跟 _auto_fix.ts:fetchExistingLists 一致. * * 测试目标: * - tryFetchWorkflows 走 GET /workflow/template 而非 POST /workflow/Engine/list * - 拉到 list 时返 `id:enCode` 字符串数组 * - 后端 code !== 200 → 返回 [] + warning 字符串 (不抛) * - 异常 (network/throw) → 返回 [] + warning 字符串 (不抛) * - 边界: list=[] / list 含无效项被过滤 */ import { describe, it, expect, vi } from 'vitest' // Mock JnpfClient 最小形状 (tryFetchWorkflows 只用 c.get) const mocks = vi.hoisted(() => ({ get: vi.fn(), })) vi.mock('../../src/core/client.ts', () => ({ JnpfClient: { fromToken: vi.fn(async () => ({ get: mocks.get })), }, })) vi.mock('../../src/core/log.ts', () => ({ log: { setQuiet: vi.fn(), setJsonMode: vi.fn(), isJsonMode: vi.fn(), flush: vi.fn(), discard: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn(), dim: vi.fn(), raw: vi.fn(), debug: vi.fn(), }, })) import { tryFetchWorkflows } from '../../src/commands/app/context.ts' describe('tryFetchWorkflows — 走 web 权威 GET /workflow/template (eventhub blocker 修复核心)', () => { it('调用 c.get 而非 c.postJson (端点权威 GET)', async () => { mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } }) const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) // 1. 必须走 GET (端点: GET /workflow/template, query 含 keyword/currentPage/pageSize) expect(mocks.get).toHaveBeenCalledTimes(1) const [url, query] = mocks.get.mock.calls[0] expect(url).toBe('/workflow/template') // query 应包含 keyword/currentPage/pageSize expect(query).toMatchObject({ keyword: '', currentPage: 1, pageSize: expect.any(Number), }) expect(result.workflows).toEqual([]) }) it('显式反断言: 不能走 POST /workflow/Engine/list (旧版 fallback 已禁用)', async () => { mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } }) const fakeClient = { get: mocks.get } as any await tryFetchWorkflows(fakeClient) // 取 url 参数: const url = mocks.get.mock.calls[0][0] expect(url).not.toBe('/workflow/Engine/list') expect(url).not.toMatch(/Engine\/list/) }) it('拉取成功: list=[{id, enCode}] → 返回 `id:enCode` 字符串', async () => { mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [ { id: '123', enCode: 'leaveFlow' }, { id: '456', enCode: 'approveFlow' }, ], }, }) const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual(['123:leaveFlow', '456:approveFlow']) expect(result.warning).toBeUndefined() }) it('拉取成功: list 含无效项 → 跳过 null + 跳过纯空对 `":"`', async () => { // 当前实现: 先 .filter 排除 null, 然后 map `${id}:${enCode}`, 最后 filter `s !== ':'`. // 因此 `{id:'', enCode:''}` → `:` 被过滤; // `{id:'3', enCode:''}` → `3:` 保留 (id 有值, 即使 enCode 空); // 这里只验: null 项被跳, 全空对 `:` 被过滤 (空 enCode+空 id 仍能进). mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [ { id: '1', enCode: 'good' }, { id: '3', enCode: '' }, // 3: 保留 (id 非空) { id: '', enCode: '' }, // : → 被 filter 跳 (全空) null, // null → 被 filter 跳 { id: '5', enCode: 'real' }, ], }, }) const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual(['1:good', '3:', '5:real']) // 显式反断言: 纯空对 `:` 不进入 (避免产生 ":" 字符串噪声) expect(result.workflows).not.toContain(':') }) it('拉取成功: 后端返空 list → [], no warning', async () => { mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } }) const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual([]) expect(result.warning).toBeUndefined() }) it('拉取成功: 后端无 data 字段 → fallback [] (容错)', async () => { mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 200 }) // 无 data const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual([]) expect(result.warning).toBeUndefined() }) }) describe('tryFetchWorkflows — 容错 (不抛, 返回 warning)', () => { it('后端 code !== 200 → warning 字符串 + 空数组', async () => { mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 500, msg: 'database down' }) const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual([]) expect(result.warning).toContain('workflow list 失败') expect(result.warning).toContain('500') expect(result.warning).toContain('database down') }) it('后端 code !== 200 但无 msg → warning 含默认 "未知错误" 痕迹', async () => { // 用例保证不抛 → warning 至少描述事件 (容错 stdout) mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 500 }) // 无 msg const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual([]) expect(result.warning).toContain('workflow list 失败') }) it('网络异常 (throw) → warning 含 "异常" 字样 + 空数组', async () => { mocks.get.mockReset() mocks.get.mockRejectedValueOnce(new Error('ECONNREFUSED 127.0.0.1:30000')) const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual([]) expect(result.warning).toContain('workflow list 异常') expect(result.warning).toContain('ECONNREFUSED') }) it('非 Error 类型异常 (字符串) → 不抛, warning 含"异常"字样 (不要求含原信息)', async () => { // 注: 当前实现 `(e as Error).message` 对非 Error 类型取 message 失败 → "undefined". // 这是 pre-existing 行为 (eventhub blocker 不要求修), 这里仅验证不抛 + warning 含 "异常". mocks.get.mockReset() mocks.get.mockRejectedValueOnce('network timeout') const fakeClient = { get: mocks.get } as any const result = await tryFetchWorkflows(fakeClient) expect(result.workflows).toEqual([]) expect(result.warning).toContain('workflow list 异常') }) }) describe('tryFetchWorkflows — PAGE_SIZE 默认 500 (与 _auto_fix.fetchExistingLists 一致)', () => { it('pageSize ≥ 500 (一次拉完, 避免分页遗漏)', async () => { mocks.get.mockReset() mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } }) const fakeClient = { get: mocks.get } as any await tryFetchWorkflows(fakeClient) const [, query] = mocks.get.mock.calls[0] expect((query as { pageSize: number }).pageSize).toBeGreaterThanOrEqual(500) }) })