import { describe, it, afterEach, mock } from 'node:test'; import assert from 'node:assert/strict'; import axios from 'axios'; import { mkdtemp, writeFile, chmod, rm } from 'fs/promises'; import { tmpdir } from 'os'; import { join } from 'path'; import { checkRequiredEnv, verifyGiteaToken, verifyCommentToken, verifyLLM, runPreflight } from '../preflight.js'; const LLM_ENV_KEYS = [ 'AI_ASSISTANT_CLI', 'MODEL', 'OPENCODE_MODEL', 'PATH', ]; const ORIGINAL_PATH = process.env.PATH; function clearLLMEnv() { for (const k of LLM_ENV_KEYS) delete process.env[k]; } let tempDir; afterEach(async () => { mock.restoreAll(); clearLLMEnv(); process.env.PATH = ORIGINAL_PATH; if (tempDir) await rm(tempDir, { recursive: true, force: true }); tempDir = null; }); async function installFakeCLI(command = 'codex') { tempDir = await mkdtemp(join(tmpdir(), 'preflight-cli-test-')); const script = join(tempDir, command); await writeFile(script, '#!/bin/sh\nexit 0\n'); await chmod(script, 0o755); process.env.PATH = tempDir; } describe('checkRequiredEnv', () => { it('reports all three missing when nothing provided', () => { const result = checkRequiredEnv({ token: '', repo: '', pr: '' }); assert.equal(result.ok, false); assert.deepEqual(result.missing, ['GITEA_TOKEN', 'GITEA_REPOSITORY', 'PR_NUMBER']); }); it('reports only the missing ones', () => { const result = checkRequiredEnv({ token: 't', repo: '', pr: '5' }); assert.equal(result.ok, false); assert.deepEqual(result.missing, ['GITEA_REPOSITORY']); }); it('ok when all provided', () => { const result = checkRequiredEnv({ token: 't', repo: 'owner/repo', pr: '5' }); assert.equal(result.ok, true); assert.deepEqual(result.missing, []); }); }); describe('verifyGiteaToken', () => { it('ok when repo endpoint returns successfully', async () => { let capturedUrl, capturedOpts; mock.method(axios, 'get', async (url, opts) => { capturedUrl = url; capturedOpts = opts; return { data: { full_name: 'owner/repo' } }; }); const result = await verifyGiteaToken('tok', 'owner/repo'); assert.equal(result.ok, true); assert.ok(capturedUrl.includes('/api/v1/repos/owner/repo')); assert.equal(capturedOpts.headers['Authorization'], 'token tok'); }); it('fails with HTTP status when token is invalid', async () => { mock.method(axios, 'get', async () => { const e = new Error('Unauthorized'); e.response = { status: 401 }; throw e; }); const result = await verifyGiteaToken('bad', 'owner/repo'); assert.equal(result.ok, false); assert.match(result.error, /HTTP 401/); }); }); describe('verifyCommentToken', () => { it('skips when no comment token provided', async () => { const result = await verifyCommentToken(''); assert.deepEqual(result, { ok: true, skipped: true }); }); it('ok when /user returns successfully', async () => { let capturedUrl, capturedOpts; mock.method(axios, 'get', async (url, opts) => { capturedUrl = url; capturedOpts = opts; return { data: { login: 'bot' } }; }); const result = await verifyCommentToken('ctok'); assert.equal(result.ok, true); assert.ok(capturedUrl.endsWith('/api/v1/user')); assert.equal(capturedOpts.headers['Authorization'], 'token ctok'); }); it('fails when comment token is invalid', async () => { mock.method(axios, 'get', async () => { const e = new Error('Unauthorized'); e.response = { status: 401 }; throw e; }); const result = await verifyCommentToken('bad'); assert.equal(result.ok, false); assert.match(result.error, /HTTP 401/); }); }); describe('verifyLLM', () => { it('fails when no supported assistant CLI is detected', async () => { clearLLMEnv(); process.env.AI_ASSISTANT_CLI = 'no-such-ai-cli'; process.env.PATH = ''; const result = await verifyLLM(); assert.equal(result.ok, false); assert.match(result.error, /AI 助理 CLI/); }); it('passes when a supported assistant CLI is detected', async () => { clearLLMEnv(); await installFakeCLI('codex'); process.env.AI_ASSISTANT_CLI = 'codex'; process.env.MODEL = 'gpt-5-mini'; const result = await verifyLLM(); assert.equal(result.ok, true); assert.equal(result.provider, 'codex'); assert.equal(result.command, 'codex'); assert.equal(result.model, 'gpt-5-mini'); }); it('fails when a requested CLI is not installed', async () => { clearLLMEnv(); process.env.AI_ASSISTANT_CLI = 'missing-cli'; process.env.PATH = ''; const result = await verifyLLM(); assert.equal(result.ok, false); assert.match(result.error, /AI 助理 CLI/); }); }); describe('runPreflight', () => { function makeDeps(overrides = {}) { return { checkEnv: () => ({ ok: true, missing: [] }), verifyToken: async () => ({ ok: true }), verifyComment: async () => ({ ok: true }), verifyRemote: () => ({ ok: true }), verifyLLMFn: async () => ({ ok: true, provider: 'codex' }), ...overrides, }; } it('returns false and stops early when required env is missing', async () => { const result = await runPreflight(); assert.equal(result, false); }); it('returns true when every verification step succeeds', async () => { const result = await runPreflight('/ws', makeDeps()); assert.equal(result, true); }); it('returns true when the comment token check is skipped', async () => { const result = await runPreflight('/ws', makeDeps({ verifyComment: async () => ({ ok: true, skipped: true }), })); assert.equal(result, true); }); it('returns false when the Gitea token check fails', async () => { let remoteCalled = false; const result = await runPreflight('/ws', makeDeps({ verifyToken: async () => ({ ok: false, error: 'HTTP 401' }), verifyRemote: () => { remoteCalled = true; return { ok: true }; }, })); assert.equal(result, false); assert.equal(remoteCalled, false, 'should stop before later checks'); }); it('returns false when the comment token check fails', async () => { const result = await runPreflight('/ws', makeDeps({ verifyComment: async () => ({ ok: false, error: 'HTTP 401' }), })); assert.equal(result, false); }); it('returns false when git remote access fails', async () => { let llmCalled = false; const result = await runPreflight('/ws', makeDeps({ verifyRemote: () => ({ ok: false, error: 'auth failed' }), verifyLLMFn: async () => { llmCalled = true; return { ok: true }; }, })); assert.equal(result, false); assert.equal(llmCalled, false, 'should stop before the LLM check'); }); it('returns false when LLM verification fails', async () => { const result = await runPreflight('/ws', makeDeps({ verifyLLMFn: async () => ({ ok: false, error: 'AI 助理 CLI 驗證失敗' }), })); assert.equal(result, false); }); it('passes the workspace through to the remote-access check', async () => { let captured; await runPreflight('/custom/ws', makeDeps({ verifyRemote: (ws) => { captured = ws; return { ok: true }; }, })); assert.equal(captured, '/custom/ws'); }); });