@playcraft/cli 0.0.49 → 0.0.52

package/dist/commands/fix-ids.test.js

@@ -1,264 +0,0 @@
-/**
- * fix-ids 命令测试
- *
- * 覆盖：
- * - URL 优先级：CLI 参数 → BACKEND_API_URL → PLAYCRAFT_URL → globalConfig.backendUrl →
- *               globalConfig.url → DEFAULT_PLAYCRAFT_CLOUD_BASE
- * - Token 优先级：CLI 参数 → PLAYCRAFT_TOKEN → globalConfig.token
- * - 成功/失败分支
- * - 本地开发鉴权绕过（X-Local-User）
- */
-import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from 'vitest';
-import http from 'node:http';
-// ─── Mock loadGlobalConfig ────────────────────────────────────────────────────
-vi.mock('../config.js', () => ({
-    loadGlobalConfig: vi.fn(() => ({})),
-    saveGlobalConfig: vi.fn(),
-    loadConfig: vi.fn(),
-}));
-import { loadGlobalConfig } from '../config.js';
-import { fixIdsCommand } from './fix-ids.js';
-import { DEFAULT_PLAYCRAFT_CLOUD_BASE } from './login.js';
-let server;
-let baseUrl;
-let lastRequest;
-let responseStatus = 200;
-let responseBody = { success: true };
-beforeAll(async () => {
-    server = http.createServer((req, res) => {
-        lastRequest = {
-            url: req.url ?? '',
-            method: req.method ?? '',
-            headers: req.headers,
-        };
-        res.writeHead(responseStatus, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify(responseBody));
-    });
-    await new Promise((resolve) => {
-        server.listen(0, '127.0.0.1', () => resolve());
-    });
-    const addr = server.address();
-    baseUrl = `http://127.0.0.1:${addr.port}`;
-});
-afterAll(async () => {
-    await new Promise((resolve) => server.close(() => resolve()));
-});
-beforeEach(() => {
-    lastRequest = null;
-    responseStatus = 200;
-    responseBody = { success: true };
-    vi.mocked(loadGlobalConfig).mockReturnValue({});
-    // 清理鉴权绕过相关环境变量
-    delete process.env.BACKEND_API_URL;
-    delete process.env.PLAYCRAFT_URL;
-    delete process.env.PLAYCRAFT_TOKEN;
-    delete process.env.NEXT_PUBLIC_LOCAL_AUTH_BYPASS;
-    delete process.env.NEXT_PUBLIC_LOCAL_USER;
-});
-afterEach(() => {
-    delete process.env.BACKEND_API_URL;
-    delete process.env.PLAYCRAFT_URL;
-    delete process.env.PLAYCRAFT_TOKEN;
-    delete process.env.NEXT_PUBLIC_LOCAL_AUTH_BYPASS;
-    delete process.env.NEXT_PUBLIC_LOCAL_USER;
-});
-// ─── URL resolution tests ─────────────────────────────────────────────────────
-describe('URL 优先级', () => {
-    it('明确传入 --api-url 时优先使用 CLI 参数', async () => {
-        vi.mocked(loadGlobalConfig).mockReturnValue({
-            backendUrl: 'http://should-not-use.example.com',
-        });
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.url).toBe('/api/projects/123/fix-ids');
-        // 确保确实打到了我们的测试服务器
-        expect(lastRequest?.method).toBe('POST');
-    });
-    it('无 CLI 参数时从 BACKEND_API_URL 环境变量读取 URL', async () => {
-        process.env.BACKEND_API_URL = baseUrl;
-        await fixIdsCommand({ projectId: '123' });
-        expect(lastRequest?.url).toBe('/api/projects/123/fix-ids');
-    });
-    it('无 BACKEND_API_URL 时从 PLAYCRAFT_URL 环境变量读取 URL', async () => {
-        process.env.PLAYCRAFT_URL = baseUrl;
-        await fixIdsCommand({ projectId: '123' });
-        expect(lastRequest?.url).toBe('/api/projects/123/fix-ids');
-    });
-    it('环境变量均未设置时，从全局配置 backendUrl 读取', async () => {
-        vi.mocked(loadGlobalConfig).mockReturnValue({ backendUrl: baseUrl });
-        await fixIdsCommand({ projectId: '123' });
-        expect(lastRequest?.url).toBe('/api/projects/123/fix-ids');
-    });
-    it('backendUrl 未设置时，从全局配置 url 读取', async () => {
-        vi.mocked(loadGlobalConfig).mockReturnValue({ url: baseUrl });
-        await fixIdsCommand({ projectId: '123' });
-        expect(lastRequest?.url).toBe('/api/projects/123/fix-ids');
-    });
-    it('所有来源均未设置时，回退到 DEFAULT_PLAYCRAFT_CLOUD_BASE（不打本地服务器）', async () => {
-        // 确认默认地址指向公有云，不含 localhost
-        expect(DEFAULT_PLAYCRAFT_CLOUD_BASE).toMatch(/^https:\/\//);
-        expect(DEFAULT_PLAYCRAFT_CLOUD_BASE).not.toContain('localhost');
-        expect(DEFAULT_PLAYCRAFT_CLOUD_BASE).not.toContain('127.0.0.1');
-        expect(DEFAULT_PLAYCRAFT_CLOUD_BASE).not.toContain(':3001');
-    });
-    it('CLI 参数 > 环境变量 > 全局配置（优先级链路）', async () => {
-        process.env.BACKEND_API_URL = 'http://should-not-use-env.example.com';
-        vi.mocked(loadGlobalConfig).mockReturnValue({
-            backendUrl: 'http://should-not-use-config.example.com',
-        });
-        // CLI 参数最高优先级：打到我们的测试服务器
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.url).toBe('/api/projects/123/fix-ids');
-    });
-    it('URL 尾部 slash 会被正确去除', async () => {
-        vi.mocked(loadGlobalConfig).mockReturnValue({ url: `${baseUrl}/` });
-        await fixIdsCommand({ projectId: '123' });
-        expect(lastRequest?.url).toBe('/api/projects/123/fix-ids');
-    });
-    it('projectId 含特殊字符时被正确 encodeURIComponent', async () => {
-        vi.mocked(loadGlobalConfig).mockReturnValue({ url: baseUrl });
-        await fixIdsCommand({ projectId: 'abc/def' });
-        expect(lastRequest?.url).toBe('/api/projects/abc%2Fdef/fix-ids');
-    });
-});
-// ─── Token / auth tests ───────────────────────────────────────────────────────
-describe('Token 优先级', () => {
-    it('明确传入 --token 时优先使用 CLI 参数', async () => {
-        vi.mocked(loadGlobalConfig).mockReturnValue({
-            url: baseUrl,
-            token: 'global-token',
-        });
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl, token: 'cli-token' });
-        expect(lastRequest?.headers['authorization']).toBe('Bearer cli-token');
-    });
-    it('CLI 未传 token，从 PLAYCRAFT_TOKEN 环境变量读取', async () => {
-        process.env.PLAYCRAFT_TOKEN = 'env-token';
-        vi.mocked(loadGlobalConfig).mockReturnValue({
-            url: baseUrl,
-            token: 'global-token-should-not-use',
-        });
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.headers['authorization']).toBe('Bearer env-token');
-    });
-    it('环境变量未设置时，从全局配置 token 读取（login 保存的 PAT）', async () => {
-        vi.mocked(loadGlobalConfig).mockReturnValue({
-            url: baseUrl,
-            token: 'playcraft_pat_from_login',
-        });
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.headers['authorization']).toBe('Bearer playcraft_pat_from_login');
-    });
-    it('三者均未设置时不带 Authorization header', async () => {
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.headers['authorization']).toBeUndefined();
-    });
-    it('CLI 参数 > 环境变量 > 全局配置（token 优先级链路）', async () => {
-        process.env.PLAYCRAFT_TOKEN = 'env-token-should-not-use';
-        vi.mocked(loadGlobalConfig).mockReturnValue({
-            url: baseUrl,
-            token: 'global-token-should-not-use',
-        });
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl, token: 'cli-wins' });
-        expect(lastRequest?.headers['authorization']).toBe('Bearer cli-wins');
-    });
-});
-// ─── 本地开发鉴权绕过 ────────────────────────────────────────────────────────
-describe('本地开发鉴权绕过（X-Local-User）', () => {
-    it('NEXT_PUBLIC_LOCAL_AUTH_BYPASS=true 时附加 X-Local-User header', async () => {
-        process.env.NEXT_PUBLIC_LOCAL_AUTH_BYPASS = 'true';
-        process.env.NEXT_PUBLIC_LOCAL_USER = 'admin@example.com';
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.headers['x-local-user']).toBe('admin@example.com');
-    });
-    it('NEXT_PUBLIC_LOCAL_AUTH_BYPASS 未设置时不附加 X-Local-User', async () => {
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.headers['x-local-user']).toBeUndefined();
-    });
-    it('NEXT_PUBLIC_LOCAL_AUTH_BYPASS=false 时不附加 X-Local-User', async () => {
-        process.env.NEXT_PUBLIC_LOCAL_AUTH_BYPASS = 'false';
-        process.env.NEXT_PUBLIC_LOCAL_USER = 'user@example.com';
-        await fixIdsCommand({ projectId: '123', apiUrl: baseUrl });
-        expect(lastRequest?.headers['x-local-user']).toBeUndefined();
-    });
-});
-// ─── 成功 / 失败分支 ─────────────────────────────────────────────────────────
-describe('成功/失败响应处理', () => {
-    it('成功时不抛出异常', async () => {
-        responseBody = { success: true };
-        await expect(fixIdsCommand({ projectId: '123', apiUrl: baseUrl })).resolves.toBeUndefined();
-    });
-    it('HTTP 4xx 时调用 process.exit(1)', async () => {
-        responseStatus = 401;
-        responseBody = { message: 'Unauthorized' };
-        const mockExit = vi.spyOn(process, 'exit').mockImplementation((() => {
-            throw new Error('process.exit called');
-        }));
-        await expect(fixIdsCommand({ projectId: '123', apiUrl: baseUrl })).rejects.toThrow('process.exit called');
-        expect(mockExit).toHaveBeenCalledWith(1);
-        mockExit.mockRestore();
-    });
-    it('HTTP 500 时调用 process.exit(1)', async () => {
-        responseStatus = 500;
-        responseBody = { message: 'Internal Server Error' };
-        const mockExit = vi.spyOn(process, 'exit').mockImplementation((() => {
-            throw new Error('process.exit called');
-        }));
-        await expect(fixIdsCommand({ projectId: '123', apiUrl: baseUrl })).rejects.toThrow('process.exit called');
-        expect(mockExit).toHaveBeenCalledWith(1);
-        mockExit.mockRestore();
-    });
-    it('响应 success 字段为 false 时调用 process.exit(1)', async () => {
-        responseStatus = 200;
-        responseBody = { success: false };
-        const mockExit = vi.spyOn(process, 'exit').mockImplementation((() => {
-            throw new Error('process.exit called');
-        }));
-        await expect(fixIdsCommand({ projectId: '123', apiUrl: baseUrl })).rejects.toThrow('process.exit called');
-        expect(mockExit).toHaveBeenCalledWith(1);
-        mockExit.mockRestore();
-    });
-    it('网络错误时调用 process.exit(1)', async () => {
-        const mockExit = vi.spyOn(process, 'exit').mockImplementation((() => {
-            throw new Error('process.exit called');
-        }));
-        // 使用一个必定拒绝连接的地址
-        await expect(fixIdsCommand({ projectId: '123', apiUrl: 'http://127.0.0.1:1' })).rejects.toThrow('process.exit called');
-        expect(mockExit).toHaveBeenCalledWith(1);
-        mockExit.mockRestore();
-    });
-});
-// ─── AgentApiClient 凭证验证（无 localhost 默认）────────────────────────────
-describe('AgentApiClient 凭证行为', () => {
-    it('PLAYCRAFT_API_URL / PLAYCRAFT_SANDBOX_TOKEN 均未设置时抛出 Missing credentials 错误', async () => {
-        const origApiUrl = process.env.PLAYCRAFT_API_URL;
-        const origSandboxToken = process.env.PLAYCRAFT_SANDBOX_TOKEN;
-        delete process.env.PLAYCRAFT_API_URL;
-        delete process.env.PLAYCRAFT_SANDBOX_TOKEN;
-        const { AgentApiClient } = await import('../utils/agent-api-client.js');
-        expect(() => new AgentApiClient()).toThrow(/Missing PlayCraft API credentials/);
-        if (origApiUrl !== undefined)
-            process.env.PLAYCRAFT_API_URL = origApiUrl;
-        if (origSandboxToken !== undefined)
-            process.env.PLAYCRAFT_SANDBOX_TOKEN = origSandboxToken;
-    });
-    it('AgentApiClient 不使用 localhost:3001 作为默认地址', async () => {
-        const origApiUrl = process.env.PLAYCRAFT_API_URL;
-        const origSandboxToken = process.env.PLAYCRAFT_SANDBOX_TOKEN;
-        delete process.env.PLAYCRAFT_API_URL;
-        delete process.env.PLAYCRAFT_SANDBOX_TOKEN;
-        const { AgentApiClient } = await import('../utils/agent-api-client.js');
-        let errorMessage = '';
-        try {
-            new AgentApiClient();
-        }
-        catch (e) {
-            errorMessage = e instanceof Error ? e.message : String(e);
-        }
-        // 错误信息不应包含 localhost 地址 —— 不存在隐式降级到本地
-        expect(errorMessage).not.toContain('localhost');
-        expect(errorMessage).not.toContain('127.0.0.1');
-        if (origApiUrl !== undefined)
-            process.env.PLAYCRAFT_API_URL = origApiUrl;
-        if (origSandboxToken !== undefined)
-            process.env.PLAYCRAFT_SANDBOX_TOKEN = origSandboxToken;
-    });
-});

package/dist/commands/tools-research.test.js

@@ -1,216 +0,0 @@
-/**
- * playcraft tools research / fetch-url 命令测试
- *
- * 覆盖：
- * - 正确路径：research 返回 answer + citations
- * - 正确路径：fetch-url 返回 answer + citations
- * - focus 参数透传
- * - query 参数透传
- * - 后端返回 4xx / 5xx 时抛出错误
- * - 鉴权头：sandbox JWT → X-Sandbox-Token；PAT → Authorization: Bearer
- * - citation 为空时不崩溃
- */
-import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from 'vitest';
-import http from 'node:http';
-import { researchCommand, fetchUrlCommand } from './tools-research.js';
-// ─── Mock loadGlobalConfig ─────────────────────────────────────────────────────
-vi.mock('../config.js', () => ({
-    loadGlobalConfig: vi.fn(() => ({})),
-    saveGlobalConfig: vi.fn(),
-    loadConfig: vi.fn(),
-}));
-let server;
-let baseUrl;
-let lastRequest = null;
-let responseStatus = 200;
-let responseBody = {
-    answer: 'Test answer from Gemini',
-    citations: [],
-};
-beforeAll(async () => {
-    server = http.createServer((req, res) => {
-        let body = '';
-        req.on('data', (chunk) => { body += chunk.toString(); });
-        req.on('end', () => {
-            lastRequest = {
-                url: req.url ?? '',
-                method: req.method ?? '',
-                headers: req.headers,
-                body,
-            };
-            res.writeHead(responseStatus, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify(responseBody));
-        });
-    });
-    await new Promise((resolve) => {
-        server.listen(0, '127.0.0.1', () => resolve());
-    });
-    const addr = server.address();
-    baseUrl = `http://127.0.0.1:${addr.port}`;
-});
-afterAll(async () => {
-    await new Promise((resolve) => server.close(() => resolve()));
-});
-beforeEach(() => {
-    lastRequest = null;
-    responseStatus = 200;
-    responseBody = { answer: 'Test answer', citations: [] };
-    delete process.env.PLAYCRAFT_API_URL;
-    delete process.env.PLAYCRAFT_SANDBOX_TOKEN;
-});
-afterEach(() => {
-    delete process.env.PLAYCRAFT_API_URL;
-    delete process.env.PLAYCRAFT_SANDBOX_TOKEN;
-});
-// ─── Helper ───────────────────────────────────────────────────────────────────
-/** 解析测试服务器收到的请求 body */
-function parseBody() {
-    return JSON.parse(lastRequest?.body ?? '{}');
-}
-// ─── researchCommand ──────────────────────────────────────────────────────────
-describe('researchCommand', () => {
-    it('发送 POST 到 /api/agent/tools/research', async () => {
-        const result = await researchCommand({
-            query: 'match-3 level design',
-            apiUrl: baseUrl,
-            token: 'test-sandbox-token',
-        });
-        expect(lastRequest?.url).toBe('/api/agent/tools/research');
-        expect(lastRequest?.method).toBe('POST');
-        expect(result.answer).toBe('Test answer');
-    });
-    it('将 query 和 focus 正确写入请求 body', async () => {
-        await researchCommand({
-            query: 'pixel art color palette',
-            focus: 'visual',
-            apiUrl: baseUrl,
-            token: 'test-sandbox-token',
-        });
-        const body = parseBody();
-        expect(body.query).toBe('pixel art color palette');
-        expect(body.focus).toBe('visual');
-    });
-    it('不传 focus 时 body 中 focus 为 undefined（不发送该字段）', async () => {
-        await researchCommand({
-            query: 'game mechanics',
-            apiUrl: baseUrl,
-            token: 'test-sandbox-token',
-        });
-        const body = parseBody();
-        expect(body.query).toBe('game mechanics');
-        expect(body.focus).toBeUndefined();
-    });
-    it('所有 focus 枚举值均可正常透传', async () => {
-        const focuses = ['gameplay', 'visual', 'audio', 'code', 'compliance'];
-        for (const focus of focuses) {
-            await researchCommand({ query: 'test', focus, apiUrl: baseUrl, token: 'tok' });
-            expect(parseBody().focus).toBe(focus);
-        }
-    });
-    it('返回包含 citations 的完整结果', async () => {
-        responseBody = {
-            answer: 'Answer with citations',
-            citations: [
-                { url: 'https://example.com/1', title: 'Source 1' },
-                { url: 'https://example.com/2', title: 'Source 2', excerpt: 'excerpt text' },
-            ],
-        };
-        const result = await researchCommand({
-            query: 'test query',
-            apiUrl: baseUrl,
-            token: 'test-token',
-        });
-        expect(result.answer).toBe('Answer with citations');
-        expect(result.citations).toHaveLength(2);
-        expect(result.citations[0].url).toBe('https://example.com/1');
-        expect(result.citations[1].excerpt).toBe('excerpt text');
-    });
-    it('citations 为空数组时不崩溃', async () => {
-        responseBody = { answer: 'No citations answer', citations: [] };
-        const result = await researchCommand({
-            query: 'test',
-            apiUrl: baseUrl,
-            token: 'test-token',
-        });
-        expect(result.citations).toEqual([]);
-    });
-    it('使用沙箱 JWT 时发送 X-Sandbox-Token 头', async () => {
-        await researchCommand({ query: 'test', apiUrl: baseUrl, token: 'sandbox-jwt-eyJ...' });
-        expect(lastRequest?.headers['x-sandbox-token']).toBe('sandbox-jwt-eyJ...');
-        expect(lastRequest?.headers['authorization']).toBeUndefined();
-    });
-    it('使用 PAT 时发送 Authorization: Bearer 头', async () => {
-        await researchCommand({ query: 'test', apiUrl: baseUrl, token: 'playcraft_pat_abc123' });
-        expect(lastRequest?.headers['authorization']).toBe('Bearer playcraft_pat_abc123');
-        expect(lastRequest?.headers['x-sandbox-token']).toBeUndefined();
-    });
-    it('后端返回 400 时抛出错误', async () => {
-        responseStatus = 400;
-        responseBody = { error: 'query is required' };
-        await expect(researchCommand({ query: 'test', apiUrl: baseUrl, token: 'tok' })).rejects.toThrow(/400/);
-    });
-    it('后端返回 500 时抛出错误', async () => {
-        responseStatus = 500;
-        responseBody = { error: 'Internal server error' };
-        await expect(researchCommand({ query: 'test', apiUrl: baseUrl, token: 'tok' })).rejects.toThrow(/500/);
-    });
-});
-// ─── fetchUrlCommand ──────────────────────────────────────────────────────────
-describe('fetchUrlCommand', () => {
-    it('发送 POST 到 /api/agent/tools/fetch-url', async () => {
-        const result = await fetchUrlCommand({
-            url: 'https://phaser.io/docs/3.60.0',
-            apiUrl: baseUrl,
-            token: 'test-token',
-        });
-        expect(lastRequest?.url).toBe('/api/agent/tools/fetch-url');
-        expect(lastRequest?.method).toBe('POST');
-        expect(result.answer).toBe('Test answer');
-    });
-    it('将 url 和 query 正确写入请求 body', async () => {
-        await fetchUrlCommand({
-            url: 'https://phaser.io/docs/3.60.0',
-            query: 'how does TileMap collision work',
-            apiUrl: baseUrl,
-            token: 'test-token',
-        });
-        const body = parseBody();
-        expect(body.url).toBe('https://phaser.io/docs/3.60.0');
-        expect(body.query).toBe('how does TileMap collision work');
-    });
-    it('不传 query 时请求 body 中 query 为 undefined', async () => {
-        await fetchUrlCommand({
-            url: 'https://example.com',
-            apiUrl: baseUrl,
-            token: 'tok',
-        });
-        const body = parseBody();
-        expect(body.url).toBe('https://example.com');
-        expect(body.query).toBeUndefined();
-    });
-    it('返回包含 citations 的完整结果', async () => {
-        responseBody = {
-            answer: 'Content from URL',
-            citations: [{ url: 'https://phaser.io/docs', title: 'Phaser Docs' }],
-        };
-        const result = await fetchUrlCommand({
-            url: 'https://phaser.io/docs',
-            apiUrl: baseUrl,
-            token: 'tok',
-        });
-        expect(result.answer).toBe('Content from URL');
-        expect(result.citations[0].title).toBe('Phaser Docs');
-    });
-    it('使用 PAT 时发送 Authorization: Bearer 头', async () => {
-        await fetchUrlCommand({
-            url: 'https://example.com',
-            apiUrl: baseUrl,
-            token: 'playcraft_pat_xyz',
-        });
-        expect(lastRequest?.headers['authorization']).toBe('Bearer playcraft_pat_xyz');
-    });
-    it('后端返回 400 时抛出错误', async () => {
-        responseStatus = 400;
-        await expect(fetchUrlCommand({ url: 'https://example.com', apiUrl: baseUrl, token: 'tok' })).rejects.toThrow(/400/);
-    });
-});

package/dist/prad/check.test.js

@@ -1,49 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { describe, expect, it } from 'vitest';
-import { checkPradFile } from './check.js';
-import { explainPradPath, formatExplain } from './explain.js';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const mahjongSample = path.resolve(__dirname, '..', '..', '..', '..', 'docs', 'prad', 'samples', 'mahjong-gate4.atom-tree.json');
-describe('prad check', () => {
-    it('mahjong gate4 v0.2.1 passes with no E026 and draft warnings only', () => {
-        if (!fs.existsSync(mahjongSample))
-            return;
-        const result = checkPradFile(mahjongSample, { gate: 4 });
-        expect(result.errors).toEqual([]);
-        expect(result.warnings.some((w) => w.code === 'PRAD-W020')).toBe(true);
-        expect(result.warnings.some((w) => w.code === 'PRAD-E026')).toBe(false);
-        expect(result.errors.some((e) => e.code === 'PRAD-E026')).toBe(false);
-        expect(result.ok).toBe(true);
-    });
-    it('explain play_btn path', () => {
-        if (!fs.existsSync(mahjongSample))
-            return;
-        const doc = JSON.parse(fs.readFileSync(mahjongSample, 'utf-8'));
-        const result = explainPradPath(doc, 'scenes.entry.ui_layer.play_btn');
-        expect(result.found).toBe(true);
-        expect(result.slot?.spine).toBe('medium.hook.play');
-        expect(formatExplain(result)).toContain('medium.hook.play');
-    });
-    it('explain rule_engine itemSprites uses pick_and_match manifest', () => {
-        if (!fs.existsSync(mahjongSample))
-            return;
-        const doc = JSON.parse(fs.readFileSync(mahjongSample, 'utf-8'));
-        const result = explainPradPath(doc, 'scenes.gameplay.board_layer.rule_engine.props.itemSprites');
-        expect(result.found).toBe(true);
-        expect(result.bindAs).toBe('itemSprites');
-        expect(result.parentEffectiveAtom).toBe('pick_and_match_rules.aigameplay');
-        expect(result.manifestImportSlots).toContain('itemSprites');
-    });
-    it('explain hint_btn icon bindAs fingerTexture on tutorial_overlay', () => {
-        if (!fs.existsSync(mahjongSample))
-            return;
-        const doc = JSON.parse(fs.readFileSync(mahjongSample, 'utf-8'));
-        const result = explainPradPath(doc, 'scenes.gameplay.hud_layer.hint_btn.props.icon');
-        expect(result.found).toBe(true);
-        expect(result.bindAs).toBe('fingerTexture');
-        expect(result.parentEffectiveAtom).toBe('tutorial_overlay.aicomponent');
-        expect(result.manifestImportSlots).toContain('fingerTexture');
-    });
-});

package/dist/sync/sync-manager.test.js

@@ -1,80 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import os from 'node:os';
-import { SyncManager } from './sync-manager.js';
-describe('SyncManager', () => {
-    let tmpDir;
-    let mockConnection;
-    beforeEach(async () => {
-        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'sync-manager-test-'));
-        mockConnection = {
-            request: vi.fn(),
-            isConnected: true,
-            connectionState: 'connected',
-        };
-    });
-    afterEach(async () => {
-        if (tmpDir) {
-            await fs.rm(tmpDir, { recursive: true, force: true });
-        }
-    });
-    it('upload() reads file and calls cloud request', async () => {
-        const filePath = 'test.txt';
-        const fullPath = path.join(tmpDir, filePath);
-        await fs.mkdir(path.dirname(fullPath), { recursive: true });
-        await fs.writeFile(fullPath, 'hello', 'utf-8');
-        vi.mocked(mockConnection.request).mockResolvedValue({ success: true });
-        const manager = new SyncManager({
-            cloudConnection: mockConnection,
-            projectDir: tmpDir,
-        });
-        const result = await manager.upload(filePath);
-        expect(result.success).toBe(true);
-        expect(result.direction).toBe('up');
-        expect(mockConnection.request).toHaveBeenCalledWith('POST', '/api/sync/upload', expect.objectContaining({
-            path: filePath,
-            data: expect.any(String),
-            compressed: false,
-        }));
-    });
-    it('upload() returns error result when file missing', async () => {
-        const manager = new SyncManager({
-            cloudConnection: mockConnection,
-            projectDir: tmpDir,
-        });
-        const result = await manager.upload('nonexistent.txt');
-        expect(result.success).toBe(false);
-        expect(result.error).toBeDefined();
-        expect(mockConnection.request).not.toHaveBeenCalled();
-    });
-    it('download() calls cloud request and writes file', async () => {
-        const filePath = 'subdir/file.txt';
-        const content = Buffer.from('world').toString('base64');
-        vi.mocked(mockConnection.request).mockResolvedValue({ data: content });
-        const manager = new SyncManager({
-            cloudConnection: mockConnection,
-            projectDir: tmpDir,
-        });
-        const result = await manager.download(filePath);
-        expect(result.success).toBe(true);
-        expect(result.direction).toBe('down');
-        const fullPath = path.join(tmpDir, filePath);
-        const written = await fs.readFile(fullPath, 'utf-8');
-        expect(written).toBe('world');
-    });
-    it('getPendingUploads returns empty array', () => {
-        const manager = new SyncManager({
-            cloudConnection: mockConnection,
-            projectDir: tmpDir,
-        });
-        expect(manager.getPendingUploads()).toEqual([]);
-    });
-    it('getPendingDownloads returns empty array', () => {
-        const manager = new SyncManager({
-            cloudConnection: mockConnection,
-            projectDir: tmpDir,
-        });
-        expect(manager.getPendingDownloads()).toEqual([]);
-    });
-});