@epoint-testtech/ep-stage-skill 0.0.9 → 0.5.0-alpha.2

package/dist/test/cli/generate-testcase-json5.test.js

@@ -0,0 +1,154 @@
+/**
+ * generate-testcase JSON5 新产线单元测试（Task 3）。
+ *
+ * 验收范围（与 brief 一致）：
+ * - 产出 contract.json5 / testcase.json5 / inference-trace.json（不产出 contract.json）
+ * - v1-draft schema 校验通过
+ * - skeletonSlots.crud 存在且形态对齐 StageSkeletonCrudFlowSlots
+ * - cases 全部 generationStrategy='glue'
+ * - uncoveredCandidates 至少存在 generationStrategy='ai'
+ * - testcase.menuPath 不再是必填字段，不从 roles[0].menuPath 推导
+ *
+ * 注意：本测试依赖 e2e 014 _docs/code_list.json5（新协议样例）。
+ */
+import { describe, expect, it, vi } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import JSON5 from 'json5';
+import { runGenerateTestcase } from '../../src/cli/generate-testcase.js';
+import { writeProjectIndex } from '../../src/context/stage-context.js';
+const REPO_CODE_LIST = path.resolve(__dirname, '../../../../e2e/glue-code-mvp/src/tests/014-测试需求10-20260622/_docs/code_list.json5');
+describe('generate testcase from code_list.json5', () => {
+    it('writes contract.json5 + testcase.json5 + inference-trace.json (no legacy outputs)', () => {
+        const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ep-stage-home-'));
+        const testsDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ep-stage-json5-'));
+        const projectDir = path.join(testsDir, 'glue-project');
+        const homedirSpy = vi.spyOn(os, 'homedir').mockReturnValue(homeDir);
+        try {
+            writeProjectIndex({
+                homeDir,
+                projects: [
+                    {
+                        projectName: 'glue-project',
+                        projectDir,
+                        mode: 'glue',
+                        stageCreateVersion: 'test',
+                        requirements: [],
+                    },
+                ],
+                systems: [],
+            });
+            const result = runGenerateTestcase({
+                codeList: REPO_CODE_LIST,
+                testsDir,
+                projectDir,
+                directUrl: 'http://example.test/epoint-web/perpage/zwplace/gxhzwplacelist.html',
+            });
+            expect(result.testcasePath).toBe(path.join(testsDir, 'testcase.json5'));
+            expect(fs.existsSync(path.join(testsDir, '.ep-stage', 'contract.json5'))).toBe(true);
+            expect(fs.existsSync(path.join(testsDir, '.ep-stage', 'inference-trace.json'))).toBe(true);
+            expect(fs.existsSync(path.join(testsDir, '.ep-stage', 'contract.json'))).toBe(false); // 旧产物不再生成
+            const contract = JSON5.parse(fs.readFileSync(path.join(testsDir, '.ep-stage', 'contract.json5'), 'utf8'));
+            const testcase = JSON5.parse(fs.readFileSync(path.join(testsDir, 'testcase.json5'), 'utf8'));
+            expect(contract.schemaVersion).toBe('ep-stage-contract/v1-draft');
+            expect(testcase.schemaVersion).toBe('ep-stage-testcase/v1-draft');
+            expect(contract.base.navigation.directUrl).toBe('http://example.test/epoint-web/perpage/zwplace/gxhzwplacelist.html');
+            expect(contract.scenario.searchFields.map((i) => i.field)).toEqual([
+                'placename',
+                'placecategory',
+                'status',
+            ]);
+            expect(contract.scenario.skeletonSlots.crud).toBeTruthy();
+            expect(testcase.cases.every((c) => c.generationStrategy === 'glue')).toBe(true);
+            expect(testcase.uncoveredCandidates.some((c) => c.generationStrategy === 'ai')).toBe(true);
+            expect(testcase.menuPath).toBeUndefined();
+            expect(testcase.runtimeContext?.testProjectDir).toBe(projectDir);
+            expect(testcase.runtimeContext?.caseDir).toBe(testsDir);
+            expect(testcase.runtimeContext?.specPath).toBe(path.join(testsDir, 'crud.spec.ts'));
+            expect(testcase.testAccess?.credentialRef).toBe('credentials.json5');
+            expect(testcase.testAccess?.requiredRoles).toEqual([
+                '业务管理员',
+                '领导/管理者',
+                '群众',
+            ]);
+            const allCaseIds = [
+                ...testcase.cases.map((item) => item.caseId),
+                ...testcase.uncoveredCandidates.map((item) => item.caseId),
+            ];
+            expect(allCaseIds).toEqual([
+                'TC01001',
+                'TC01002',
+                'TC01003',
+                'TC01004',
+                'TC01005',
+                'TC01006',
+                'TC01007',
+                'TC01008',
+                'TC01009',
+                'TC01010',
+                'TC01011',
+                'TC01012',
+                'TC01013',
+                'TC01014',
+                'TC01015',
+                'TC01016',
+            ]);
+            expect(new Set(allCaseIds).size).toBe(allCaseIds.length);
+            expect(allCaseIds.every((caseId) => /^TC\d{5}$/.test(caseId))).toBe(true);
+            expect(testcase.cases[0]?.queryKey).toBeTruthy();
+            expect(testcase.cases[0]?.steps).toContain('新增');
+            expect(testcase.cases[0]?.steps).toContain('点击{{新增按钮}}');
+            expect(testcase.cases[1]?.steps).toContain('点击{{查询按钮}}');
+            expect(testcase.cases[2]?.steps).toContain('点击{{修改按钮}}');
+            expect(testcase.cases[3]?.steps).toContain('点击{{删除按钮}}');
+            expect(testcase.cases[4]?.steps).toContain('选择首个有效下拉选项');
+            expect(testcase.cases[4]?.steps).not.toContain('带时间戳的测试值');
+            expect(testcase.cases[8]?.queryKey).toBe('状态');
+            expect(testcase.cases[8]?.precondition).not.toContain('已基于状态完成一条测试数据新增');
+            expect(testcase.cases[8]?.assertion).toContain('不强制断言列表数据命中数量');
+            expect(testcase.cases[9]?.steps).toContain('点击{{导出按钮}}');
+            expect(testcase.cases[0]?.steps).not.toBe(testcase.cases[1]?.steps);
+            expect(testcase.cases.map((item) => item.steps).join('\n')).not.toContain('按查询主键完成新增、查询、编辑、删除或导出流程');
+            expect(testcase.cases.map((item) => item.assertion).join('\n')).not.toContain('按查询主键、列表结果或导出行为验证执行结果');
+            expect(testcase.uncoveredCandidates.every((c) => c.generationStrategy === 'ai')).toBe(true);
+            expect(testcase.uncoveredCandidates[0]?.steps).toContain('由 AI Runtime Task 观察页面当前状态');
+            const testcaseMarkdown = fs.readFileSync(path.join(testsDir, 'testcase.md'), 'utf8');
+            expect(testcaseMarkdown).toContain('| 用例 ID | 生成策略 | 用例标题 | 查询主键 | 前置条件 | 执行步骤 | 执行断言 |');
+            expect(testcaseMarkdown).not.toContain('## 已覆盖用例');
+            expect(testcaseMarkdown).not.toContain('## 未覆盖候选');
+        }
+        finally {
+            homedirSpy.mockRestore();
+        }
+    });
+    it('缺少 directUrl 时阻断，避免产出不可执行 contract', () => {
+        const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ep-stage-home-'));
+        const testsDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ep-stage-json5-'));
+        const projectDir = path.join(testsDir, 'glue-project');
+        const homedirSpy = vi.spyOn(os, 'homedir').mockReturnValue(homeDir);
+        try {
+            writeProjectIndex({
+                homeDir,
+                projects: [
+                    {
+                        projectName: 'glue-project',
+                        projectDir,
+                        mode: 'glue',
+                        stageCreateVersion: 'test',
+                        requirements: [],
+                    },
+                ],
+                systems: [],
+            });
+            expect(() => runGenerateTestcase({
+                codeList: REPO_CODE_LIST,
+                testsDir,
+                projectDir,
+            })).toThrow(/缺少待测页面 directUrl/);
+        }
+        finally {
+            homedirSpy.mockRestore();
+        }
+    });
+});

package/dist/test/cli/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/test/cli/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../test/cli/index.test.ts"],"names":[],"mappings":""}

package/dist/test/cli/index.test.js

@@ -0,0 +1,114 @@
+/**
+ * src/cli/index.ts 路由测试（REQ-CLI-02 修订）。
+ *
+ * 覆盖：
+ * - --help / -h 打印 testcase / spec / run 3 子命令且不含 contract
+ * - 未知子命令 → process.exit(1)
+ * - 路由到 parseGenerateTestcaseArgs / parseSpecArgs / parseRunArgs
+ *
+ * 用 vi.mock 替换 generate-testcase / spec / run 模块，避免占位 throw 干扰路由判定。
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync, symlinkSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+const generateTestcase = vi.hoisted(() => ({
+    parseGenerateTestcaseArgs: vi.fn((argv) => ({ codeList: 'parsed', testsDir: argv.join(' ') })),
+    runGenerateTestcase: vi.fn(() => 'TESTCASE_OK'),
+}));
+const spec = vi.hoisted(() => ({
+    parseSpecArgs: vi.fn((argv) => ({ testcase: 'parsed', out: argv.join(' ') })),
+    runSpec: vi.fn(() => 'SPEC_OK'),
+}));
+const run = vi.hoisted(() => ({
+    parseRunArgs: vi.fn((argv) => ({ testcase: argv.join(' '), headless: true })),
+    runRun: vi.fn(async () => 'RUN_OK'),
+}));
+vi.mock('../../src/cli/generate-testcase.js', () => generateTestcase);
+vi.mock('../../src/cli/spec.js', () => spec);
+vi.mock('../../src/cli/run.js', () => run);
+const { main, printHelp } = await import('../../src/cli/index.js');
+describe('ep-stage-skill CLI 路由', () => {
+    let logSpy;
+    let errSpy;
+    let exitSpy;
+    beforeEach(() => {
+        logSpy = vi.spyOn(console, 'log').mockImplementation(() => undefined);
+        errSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation(((code) => {
+            throw new Error(`__exit_${code ?? 0}__`);
+        }));
+    });
+    afterEach(() => {
+        logSpy.mockRestore();
+        errSpy.mockRestore();
+        exitSpy.mockRestore();
+        vi.clearAllMocks();
+    });
+    it('--help 打印 3 子命令 testcase/spec/run 且不注册 contract 子命令', async () => {
+        await main(['node', 'cli', '--help']);
+        const printed = logSpy.mock.calls.flat().join('\n');
+        expect(printed).toMatch(/ep-stage-skill testcase /);
+        expect(printed).toMatch(/ep-stage-skill spec /);
+        expect(printed).toMatch(/ep-stage-skill run --testcase <path>/);
+        expect(printed).not.toMatch(/ep-stage-skill run --spec/);
+        // 反向断言：不存在 `ep-stage-skill contract` 子命令入口
+        expect(printed).not.toMatch(/ep-stage-skill contract\b/);
+    });
+    it('-h 等价于 --help', async () => {
+        await main(['node', 'cli', '-h']);
+        expect(logSpy.mock.calls.flat().join('\n')).toMatch(/testcase/);
+    });
+    it('无参数时打印 help（不 exit）', async () => {
+        await main(['node', 'cli']);
+        expect(logSpy.mock.calls.flat().join('\n')).toMatch(/testcase/);
+        expect(exitSpy).not.toHaveBeenCalled();
+    });
+    it('printHelp 不注册 contract 子命令', () => {
+        printHelp();
+        expect(logSpy.mock.calls.flat().join('\n')).not.toMatch(/ep-stage-skill contract\b/);
+    });
+    it('未知子命令 exit 1 + stderr', async () => {
+        await expect(main(['node', 'cli', 'unknown-cmd'])).rejects.toThrow(/__exit_1__/);
+        expect(errSpy.mock.calls.flat().join('\n')).toMatch(/未知子命令/);
+    });
+    it('testcase 子命令路由到 runGenerateTestcase', async () => {
+        const result = await main(['node', 'cli', 'testcase', '--code-list', '/x']);
+        expect(generateTestcase.parseGenerateTestcaseArgs).toHaveBeenCalledWith(['--code-list', '/x']);
+        expect(generateTestcase.runGenerateTestcase).toHaveBeenCalled();
+        expect(result).toBe('TESTCASE_OK');
+    });
+    it('spec 子命令路由到 runSpec', async () => {
+        const result = await main(['node', 'cli', 'spec', '--testcase', '/t', '--out', '/o']);
+        expect(spec.parseSpecArgs).toHaveBeenCalledWith(['--testcase', '/t', '--out', '/o']);
+        expect(spec.runSpec).toHaveBeenCalled();
+        expect(result).toBe('SPEC_OK');
+    });
+    it('run 子命令路由到 runRun', async () => {
+        const result = await main(['node', 'cli', 'run', '--testcase', '/t']);
+        expect(run.parseRunArgs).toHaveBeenCalledWith(['--testcase', '/t']);
+        expect(run.runRun).toHaveBeenCalled();
+        expect(result).toBe('RUN_OK');
+    });
+    it('-- 分隔符被忽略', async () => {
+        await main(['node', 'cli', 'testcase', '--', '--code-list', '/x']);
+        expect(generateTestcase.parseGenerateTestcaseArgs).toHaveBeenCalledWith(['--code-list', '/x']);
+    });
+    it('软链 CLI 入口也应识别为直接执行', async () => {
+        const mod = await import('../../src/cli/index.js');
+        const tmpDir = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-skill-cli-'));
+        const realEntry = path.join(tmpDir, 'dist', 'src', 'cli', 'index.js');
+        const binEntry = path.join(tmpDir, '.bin', 'ep-stage-skill');
+        try {
+            mkdirSync(path.dirname(realEntry), { recursive: true });
+            mkdirSync(path.dirname(binEntry), { recursive: true });
+            writeFileSync(realEntry, '// mock cli entry\n', 'utf8');
+            symlinkSync(realEntry, binEntry);
+            expect(mod.isDirectExecution(pathToFileURL(realEntry).href, binEntry)).toBe(true);
+        }
+        finally {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+});

package/dist/test/cli/run.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run.test.d.ts.map

package/dist/test/cli/run.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.test.d.ts","sourceRoot":"","sources":["../../../test/cli/run.test.ts"],"names":[],"mappings":""}