@epoint-testtech/ep-stage-skill 0.0.3-alpha.2 → 0.0.4-alpha.1

package/dist/src/validation/projects-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-index.d.ts","sourceRoot":"","sources":["../../../src/validation/projects-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,6BAA6B,CAAC;AAEjG;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAqBjE"}

package/dist/src/validation/projects-index.js

@@ -0,0 +1,37 @@
+/**
+ * 校验 ~/.ep-stage/projects.index.json5 的顶层结构（REQ-DATA-01 修订）。
+ *
+ * 必含 projects[] 与 systems[]；projects[] 条目必含 stageCreateVersion；
+ * 拒绝 stage-context.md 砍掉后遗留的 stageContextPath/envPath/knowledgeRoot/codeListPaths 字段。
+ *
+ * @param obj - 从 JSON5 解析出来的原始对象。
+ * @returns 归一化后的 ProjectsIndex。
+ * @throws 缺字段或含已废弃字段时抛结构化错误。
+ */
+export function validateProjectsIndex(obj) {
+    if (!obj || typeof obj !== 'object')
+        throw new Error('projects.index.json5 顶层必须是对象');
+    const raw = obj;
+    if (!Array.isArray(raw.projects))
+        throw new Error('projects.index.json5 缺 projects[] 字段');
+    if (!Array.isArray(raw.systems))
+        throw new Error('projects.index.json5 缺 systems[] 字段');
+    const removedFields = ['stageContextPath', 'envPath', 'knowledgeRoot', 'codeListPaths'];
+    for (const entry of raw.projects) {
+        const e = entry;
+        if (typeof e.projectName !== 'string')
+            throw new Error('projects[] 条目缺 projectName');
+        if (typeof e.projectDir !== 'string')
+            throw new Error('projects[] 条目缺 projectDir');
+        if (e.mode !== 'glue')
+            throw new Error('projects[] 条目 mode 必须为 glue');
+        if (typeof e.stageCreateVersion !== 'string' || !e.stageCreateVersion) {
+            throw new Error('projects[] 条目缺 stageCreateVersion（承接砍掉的 stage-context.md 元信息）');
+        }
+        for (const f of removedFields) {
+            if (f in e)
+                throw new Error(`projects[] 条目含已废弃字段 ${f}（stage-context.md 已砍，应 removed）`);
+        }
+    }
+    return { projects: raw.projects, systems: raw.systems };
+}

package/dist/src/validation/testcase.d.ts

@@ -0,0 +1,13 @@
+import type { TestcaseV2 } from '../testcase/testcase-v2.js';
+/**
+ * 校验 testcase.json5 v2 schema（REQ-DATA-02 / REQ-SCHEMA-01）。
+ *
+ * 必含 schemaVersion:"v2" + scenario + menuPath + requiredSystems[] + requiredRoles[] +
+ * coveredActions[] + uncoveredCandidates[] + cases[]；evidence 元素符合 <kind>=<ref>。
+ *
+ * @param obj - 从 JSON5 解析出来的原始对象。
+ * @returns 归一化后的 TestcaseV2。
+ * @throws 缺字段 / 版本不匹配 / evidence 格式错时抛结构化错误。
+ */
+export declare function validateTestcase(obj: unknown): TestcaseV2;
+//# sourceMappingURL=testcase.d.ts.map

package/dist/src/validation/testcase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcase.d.ts","sourceRoot":"","sources":["../../../src/validation/testcase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAuCzD"}

package/dist/src/validation/testcase.js

@@ -0,0 +1,53 @@
+const EVIDENCE_RE = /^(html|java|spec|contract|skeleton|hint)=.+$/;
+/**
+ * 校验 testcase.json5 v2 schema（REQ-DATA-02 / REQ-SCHEMA-01）。
+ *
+ * 必含 schemaVersion:"v2" + scenario + menuPath + requiredSystems[] + requiredRoles[] +
+ * coveredActions[] + uncoveredCandidates[] + cases[]；evidence 元素符合 <kind>=<ref>。
+ *
+ * @param obj - 从 JSON5 解析出来的原始对象。
+ * @returns 归一化后的 TestcaseV2。
+ * @throws 缺字段 / 版本不匹配 / evidence 格式错时抛结构化错误。
+ */
+export function validateTestcase(obj) {
+    if (!obj || typeof obj !== 'object')
+        throw new Error('testcase.json5 顶层必须是对象');
+    const raw = obj;
+    if (raw.schemaVersion !== 'v2') {
+        throw new Error('testcase.json5 schemaVersion 不是 v2（可能是 v1）。请重跑 `ep-stage-skill testcase` 升级。');
+    }
+    for (const f of ['scenario', 'menuPath', 'moduleId', 'moduleName']) {
+        if (typeof raw[f] !== 'string')
+            throw new Error(`testcase.json5 缺 ${f}`);
+    }
+    for (const f of ['requiredSystems', 'requiredRoles', 'coveredActions', 'uncoveredCandidates', 'cases']) {
+        if (!Array.isArray(raw[f]))
+            throw new Error(`testcase.json5 缺 ${f}[]`);
+    }
+    const checkEvidence = (ev) => {
+        if (typeof ev !== 'string' || !EVIDENCE_RE.test(ev)) {
+            throw new Error(`evidence 必须为 <kind>=<ref> 格式（kind ∈ html/java/spec/contract/skeleton/hint），实际: ${String(ev)}`);
+        }
+    };
+    for (const a of raw.coveredActions) {
+        if (!Array.isArray(a.evidence))
+            throw new Error('coveredActions[].evidence 必须为数组');
+        a.evidence.forEach(checkEvidence);
+    }
+    for (const item of raw.uncoveredCandidates) {
+        if (typeof item.requiredRole !== 'string' || !item.requiredRole.trim()) {
+            throw new Error('uncoveredCandidates[].requiredRole 必填');
+        }
+        if (!Array.isArray(item.evidence))
+            throw new Error('uncoveredCandidates[].evidence 必须为数组');
+        item.evidence.forEach(checkEvidence);
+    }
+    for (const c of raw.cases) {
+        if (typeof c.requiredRole !== 'string' || !c.requiredRole.trim()) {
+            throw new Error('cases[].requiredRole 必填');
+        }
+        if (Array.isArray(c.evidence))
+            c.evidence.forEach(checkEvidence);
+    }
+    return raw;
+}

package/dist/test/cli/extract-contract.test.d.ts

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

package/dist/test/cli/extract-contract.test.d.ts.map

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

package/dist/test/cli/extract-contract.test.js

@@ -0,0 +1,32 @@
+/**
+ * dev/extract-contract.ts 入参解析单元测试。
+ *
+ * 实际 contract 提取已在 crud-contract.test.ts 端到端覆盖；本测试只检查参数解析
+ * 边界，避免依赖主仓 knowledge-project 物料（受顶级硬约束保护、本 worktree 可能未填充）。
+ */
+import { describe, expect, it } from 'vitest';
+import { runExtractContract } from '../../src/cli/dev/extract-contract.js';
+describe('runExtractContract 入参解析', () => {
+    it('显式使用废弃 --module 时抛错', () => {
+        expect(() => runExtractContract([
+            '--module', 'zwplace',
+            '--docs', '/tmp/docs',
+            '--code-list', '/tmp/code_list.md',
+            '--webapp', '/tmp/webapp',
+            '--java-actions', '/tmp/java',
+            '--out', '/tmp/out.json',
+        ])).toThrow(/已废弃 --module/);
+    });
+    it('缺失 --module-id 时抛错', () => {
+        expect(() => runExtractContract([
+            '--docs', '/tmp/docs',
+            '--code-list', '/tmp/code_list.md',
+            '--webapp', '/tmp/webapp',
+            '--java-actions', '/tmp/java',
+            '--out', '/tmp/out.json',
+        ])).toThrow(/Missing required argument --module-id/);
+    });
+    it('参数对非法时抛错', () => {
+        expect(() => runExtractContract(['--module-id'])).toThrow(/Invalid argument pair/);
+    });
+});

package/dist/test/cli/generate-testcase-inference.test.d.ts

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

package/dist/test/cli/generate-testcase-inference.test.d.ts.map

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

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

@@ -0,0 +1,63 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import JSON5 from 'json5';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runGenerateTestcase } from '../../src/cli/generate-testcase.js';
+const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../../../..');
+const codeList = join(repoRoot, 'knowledge-project/epoint-web-v9.5.2/_docs/014-测试需求10-20260622/code_list.md');
+/**
+ * HOME 隔离 + 预填 projects.index.json5，让 runGenerateTestcase 的 requirement 追加不报错、不污染真实环境。
+ */
+function seedIsolatedHomeWithProject(homeDir, projectDir) {
+    const indexPath = join(homeDir, '.ep-stage', 'projects.index.json5');
+    mkdirSync(dirname(indexPath), { recursive: true });
+    writeFileSync(indexPath, `${JSON5.stringify({
+        projects: [
+            {
+                projectName: 'test-inference',
+                projectDir,
+                mode: 'glue',
+                stageCreateVersion: '0.0.0-test',
+                requirements: [],
+            },
+        ],
+        systems: [],
+    }, null, 2)}\n`, 'utf8');
+}
+describe('runGenerateTestcase inference trace output', () => {
+    let tmpDir = '';
+    let tmpHome = '';
+    const originalHome = process.env.HOME;
+    beforeEach(() => {
+        tmpHome = mkdtempSync(join(tmpdir(), 'ep-stage-inference-home-'));
+        process.env.HOME = tmpHome;
+    });
+    afterEach(() => {
+        process.env.HOME = originalHome;
+        if (tmpHome)
+            rmSync(tmpHome, { recursive: true, force: true });
+        if (tmpDir)
+            rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('只传 code_list 时落 contract.json 与 inference-trace.json，不落独立 module-hints 文件', () => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'ep-stage-testcase-'));
+        const projectDir = join(tmpDir, 'project');
+        const testsDir = join(projectDir, 'src', 'tests', '014-测试需求10-20260622');
+        seedIsolatedHomeWithProject(tmpHome, projectDir);
+        runGenerateTestcase({ codeList, testsDir, requirementDir: dirname(codeList), projectDir });
+        const tracePath = join(testsDir, '.ep-stage/inference-trace.json');
+        const contractPath = join(testsDir, '.ep-stage/contract.json');
+        expect(existsSync(tracePath)).toBe(true);
+        expect(existsSync(contractPath)).toBe(true);
+        expect(existsSync(join(testsDir, '.ep-stage/source-spec.json'))).toBe(false);
+        expect(existsSync(join(testsDir, '.ep-stage/module-hints.inferred.json5'))).toBe(false);
+        const trace = JSON.parse(readFileSync(tracePath, 'utf8'));
+        expect(trace.schemaVersion).toBe('inference-trace/v1');
+        expect(trace.sourceAnalysis.mode).toMatch(/prd|mixed|inferred/);
+        expect(trace.moduleHintsInference.dataKey.selectedField).toBe('placename');
+        const testcase = JSON5.parse(readFileSync(join(testsDir, 'testcase.json5'), 'utf8'));
+        expect(testcase.moduleId).toBe('zwplace');
+    });
+});

package/dist/test/cli/generate-testcase-paths.test.d.ts

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

package/dist/test/cli/generate-testcase-paths.test.d.ts.map

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

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

@@ -0,0 +1,165 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import JSON5 from 'json5';
+/**
+ * HOME 隔离 + 预填 projects.index.json5，让 runGenerateTestcase 的 requirement 追加不报错、不污染真实环境。
+ * 仅服务于本文件的路径解析断言；requirement 追加的正确性由 generate-testcase-requirements.test.ts 覆盖。
+ */
+function seedIsolatedHomeWithProject(homeDir, projectDir) {
+    const indexPath = path.join(homeDir, '.ep-stage', 'projects.index.json5');
+    mkdirSync(path.dirname(indexPath), { recursive: true });
+    writeFileSync(indexPath, `${JSON5.stringify({
+        projects: [
+            {
+                projectName: 'test-paths',
+                projectDir,
+                mode: 'glue',
+                stageCreateVersion: '0.0.0-test',
+                requirements: [],
+            },
+        ],
+        systems: [],
+    }, null, 2)}\n`, 'utf8');
+}
+const probe = vi.hoisted(() => ({
+    runProbeAndCoverage: vi.fn(() => ({
+        contract: { contractVersion: 'crud-business-module/v1', module: { id: 'm1', label: '模块' } },
+        testcaseV2: {
+            schemaVersion: 'v2',
+            scenario: 'crud.single-page',
+            moduleId: 'm1',
+            moduleName: '模块',
+            menuPath: '一级>二级',
+            requiredSystems: [{ url: '', systemName: undefined }],
+            requiredRoles: [{ role: 'admin', hint: undefined }],
+            coveredActions: [],
+            uncoveredCandidates: [],
+            cases: [],
+            reasoningSummary: {
+                conclusion: 'ok',
+                evidenceChain: [],
+                alternatives: [],
+                confidence: 'high',
+                risks: [],
+                needsHumanReview: false,
+            },
+        },
+        inferenceTrace: {
+            schemaVersion: 'inference-trace/v1',
+            codeListPath: 'mock',
+            generatedAt: '2026-06-25T00:00:00.000Z',
+            materialInventory: {
+                knowledgeRoot: '',
+                moduleId: { status: 'resolved', value: 'm1' },
+                menu: { status: 'resolved', value: '一级>二级' },
+                htmlFiles: [],
+                javaActionFiles: [],
+                docsFiles: [],
+                missing: [],
+            },
+            sourceAnalysis: {
+                mode: 'inferred',
+                confidence: 'medium',
+                sources: [],
+                fields: [],
+                businessRules: [],
+                uiSignals: [],
+                backendSignals: [],
+                unresolved: [],
+            },
+            moduleHintsInference: {
+                mode: 'inferred',
+                confidence: 'medium',
+                dataKey: { evidence: [] },
+                searchConditions: [],
+                buttonAliases: {},
+                deletePolicy: { evidence: [] },
+                assertionPolicy: {},
+                customWorkflows: [],
+                unresolved: [],
+            },
+            coverageDiff: {
+                coveredActions: [],
+                uncoveredCandidates: [],
+                needsReview: [],
+            },
+            reasoningSummary: {
+                conclusion: 'ok',
+                confidence: 'high',
+                risks: [],
+                needsHumanReview: false,
+            },
+        },
+    })),
+}));
+const softlink = vi.hoisted(() => ({
+    createSoftlinkWithFallback: vi.fn(() => ({ strategy: 'symlink' })),
+}));
+vi.mock('../../src/cli/probe.js', () => probe);
+vi.mock('../../src/util/softlink.js', () => softlink);
+const { runGenerateTestcase } = await import('../../src/cli/generate-testcase.js');
+describe('runGenerateTestcase 路径解析', () => {
+    let tmpDir;
+    let tmpHome;
+    const originalHome = process.env.HOME;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(path.join(os.tmpdir(), 'generate-testcase-paths-'));
+        tmpHome = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-paths-home-'));
+        process.env.HOME = tmpHome;
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        process.env.HOME = originalHome;
+        rmSync(tmpHome, { recursive: true, force: true });
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('根据 code_list.md 的整理目录与物料路径推导 probe 输入，而不是误用 requirementDir', () => {
+        const knowledgeRoot = path.join(tmpDir, 'knowledge-project', 'sample-app');
+        const requirementDir = path.join(knowledgeRoot, '_docs', '014-测试需求10-20260622');
+        const testsDir = path.join(tmpDir, 'project', 'src', 'tests', '014-测试需求10-20260622');
+        const codeListPath = path.join(requirementDir, 'code_list.md');
+        const htmlDir = path.join(knowledgeRoot, 'src', 'main', 'webapp', 'perpage', 'zwplace');
+        const javaDir = path.join(knowledgeRoot, 'src', 'main', 'java', 'com', 'epoint', 'zwplace', 'action');
+        const htmlPath = path.join(htmlDir, 'gxhzwplacelist.html');
+        const javaPath = path.join(javaDir, 'GxhZwPlaceListAction.java');
+        const docsDir = path.join(knowledgeRoot, '_docs', 'zwplace-observable-docs');
+        const docsPath = path.join(docsDir, 'spec.yaml');
+        const hintsPath = path.join(knowledgeRoot, '_docs', 'zwplace.module-hints.json');
+        mkdirSync(requirementDir, { recursive: true });
+        mkdirSync(htmlDir, { recursive: true });
+        mkdirSync(javaDir, { recursive: true });
+        mkdirSync(docsDir, { recursive: true });
+        writeFileSync(htmlPath, '<html></html>\n', 'utf8');
+        writeFileSync(javaPath, 'public class GxhZwPlaceListAction {}\n', 'utf8');
+        writeFileSync(docsPath, 'module:\n  id: zwplace\n', 'utf8');
+        writeFileSync(hintsPath, '{}\n', 'utf8');
+        writeFileSync(codeListPath, `# 测试模块代码清单
+
+> 整理目录：\`${knowledgeRoot}\`
+
+menu: 一级>二级
+
+| 文件路径 |
+|---------|
+| \`_docs/zwplace-observable-docs/spec.yaml\` |
+| \`src/main/webapp/perpage/zwplace/gxhzwplacelist.html\` |
+| \`src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java\` |
+| \`_docs/zwplace.module-hints.json\` |
+`, 'utf8');
+        // HOME 隔离 + 预填 index（projectDir = <tmpDir>/project，与 testsDir 反推一致），避开末尾 requirement 追加校验。
+        seedIsolatedHomeWithProject(tmpHome, path.join(tmpDir, 'project'));
+        runGenerateTestcase({
+            codeList: codeListPath,
+            testsDir,
+            requirementDir,
+        });
+        expect(probe.runProbeAndCoverage).toHaveBeenCalledWith(expect.objectContaining({
+            docsDir,
+            webappDir: htmlDir,
+            javaActionsDir: javaDir,
+            hintsPath,
+        }));
+    });
+});

package/dist/test/cli/generate-testcase-requirements.test.d.ts

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

package/dist/test/cli/generate-testcase-requirements.test.d.ts.map

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

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

@@ -0,0 +1,229 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync, readFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import JSON5 from 'json5';
+// mock probe 避开真实钻探；requirements 追加逻辑不 mock，真实跑。
+const probe = vi.hoisted(() => ({
+    runProbeAndCoverage: vi.fn(() => ({
+        contract: { contractVersion: 'crud-business-module/v1', module: { id: 'm1', label: '模块' } },
+        testcaseV2: {
+            schemaVersion: 'v2',
+            scenario: 'crud.single-page',
+            moduleId: 'm1',
+            moduleName: '模块',
+            menuPath: '一级>二级',
+            requiredSystems: [{ url: '', systemName: undefined }],
+            requiredRoles: [{ role: 'admin', hint: undefined }],
+            coveredActions: [],
+            uncoveredCandidates: [],
+            cases: [],
+            reasoningSummary: {
+                conclusion: 'ok',
+                evidenceChain: [],
+                alternatives: [],
+                confidence: 'high',
+                risks: [],
+                needsHumanReview: false,
+            },
+        },
+        inferenceTrace: {
+            schemaVersion: 'inference-trace/v1',
+            codeListPath: 'mock',
+            generatedAt: '2026-06-26T00:00:00.000Z',
+            materialInventory: {
+                knowledgeRoot: '',
+                moduleId: { status: 'resolved', value: 'm1' },
+                menu: { status: 'resolved', value: '一级>二级' },
+                htmlFiles: [],
+                javaActionFiles: [],
+                docsFiles: [],
+                missing: [],
+            },
+            sourceAnalysis: {
+                mode: 'inferred',
+                confidence: 'medium',
+                sources: [],
+                fields: [],
+                businessRules: [],
+                uiSignals: [],
+                backendSignals: [],
+                unresolved: [],
+            },
+            moduleHintsInference: {
+                mode: 'inferred',
+                confidence: 'medium',
+                dataKey: { evidence: [] },
+                searchConditions: [],
+                buttonAliases: {},
+                deletePolicy: { evidence: [] },
+                assertionPolicy: {},
+                customWorkflows: [],
+                unresolved: [],
+            },
+            coverageDiff: {
+                coveredActions: [],
+                uncoveredCandidates: [],
+                needsReview: [],
+            },
+            reasoningSummary: {
+                conclusion: 'ok',
+                confidence: 'high',
+                risks: [],
+                needsHumanReview: false,
+            },
+        },
+    })),
+}));
+const softlink = vi.hoisted(() => ({
+    createSoftlinkWithFallback: vi.fn(() => ({ strategy: 'symlink' })),
+}));
+vi.mock('../../src/cli/probe.js', () => probe);
+vi.mock('../../src/util/softlink.js', () => softlink);
+const { runGenerateTestcase } = await import('../../src/cli/generate-testcase.js');
+const REQUIREMENT_NAME = '014-测试需求10-20260622';
+/**
+ * 构造一组能让 resolveProbeInputsFromCodeList 成功的最小物料 fixture
+ * （复用 generate-testcase-paths.test.ts 验证过的目录结构）。
+ */
+function buildMaterialFixture(workDir) {
+    const knowledgeRoot = path.join(workDir, 'knowledge-project', 'sample-app');
+    const requirementDir = path.join(knowledgeRoot, '_docs', REQUIREMENT_NAME);
+    const codeListPath = path.join(requirementDir, 'code_list.md');
+    const htmlDir = path.join(knowledgeRoot, 'src', 'main', 'webapp', 'perpage', 'zwplace');
+    const javaDir = path.join(knowledgeRoot, 'src', 'main', 'java', 'com', 'epoint', 'zwplace', 'action');
+    const htmlPath = path.join(htmlDir, 'gxhzwplacelist.html');
+    const javaPath = path.join(javaDir, 'GxhZwPlaceListAction.java');
+    const docsDir = path.join(knowledgeRoot, '_docs', 'zwplace-observable-docs');
+    const docsPath = path.join(docsDir, 'spec.yaml');
+    const hintsPath = path.join(knowledgeRoot, '_docs', 'zwplace.module-hints.json');
+    mkdirSync(requirementDir, { recursive: true });
+    mkdirSync(htmlDir, { recursive: true });
+    mkdirSync(javaDir, { recursive: true });
+    mkdirSync(docsDir, { recursive: true });
+    writeFileSync(htmlPath, '<html></html>\n', 'utf8');
+    writeFileSync(javaPath, 'public class GxhZwPlaceListAction {}\n', 'utf8');
+    writeFileSync(docsPath, 'module:\n  id: zwplace\n', 'utf8');
+    writeFileSync(hintsPath, '{}\n', 'utf8');
+    writeFileSync(codeListPath, `# 测试模块代码清单
+
+> 整理目录：\`${knowledgeRoot}\`
+
+menu: 一级>二级
+
+| 文件路径 |
+|---------|
+| \`_docs/zwplace-observable-docs/spec.yaml\` |
+| \`src/main/webapp/perpage/zwplace/gxhzwplacelist.html\` |
+| \`src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java\` |
+| \`_docs/zwplace.module-hints.json\` |
+`, 'utf8');
+    return { codeListPath, requirementDir };
+}
+/**
+ * 在临时 HOME 下造一个最小可用的 projects.index.json5（含一条 project + 一条 system），
+ * 用于验证 requirements 追加不丢 systems。
+ */
+function seedIndex(homeDir, projectDir) {
+    const indexPath = path.join(homeDir, '.ep-stage', 'projects.index.json5');
+    mkdirSync(path.dirname(indexPath), { recursive: true });
+    writeFileSync(indexPath, `${JSON5.stringify({
+        projects: [
+            {
+                projectName: 'demo-glue',
+                projectDir,
+                mode: 'glue',
+                stageCreateVersion: '0.0.0-test',
+                requirements: [],
+            },
+        ],
+        systems: [
+            {
+                url: 'http://demo.example.com',
+                knownRoles: ['admin'],
+                credentialsCache: {
+                    admin: {
+                        username: 'demo',
+                        password: 'secret',
+                        lastUsed: '2026-06-26T00:00:00.000Z',
+                    },
+                },
+            },
+        ],
+    }, null, 2)}\n`, 'utf8');
+}
+function readIndex(homeDir) {
+    const indexPath = path.join(homeDir, '.ep-stage', 'projects.index.json5');
+    return JSON5.parse(readFileSync(indexPath, 'utf8'));
+}
+describe('runGenerateTestcase 追加 requirement 到 projects.index', () => {
+    let tmpHome;
+    let tmpWork;
+    const originalHome = process.env.HOME;
+    beforeEach(() => {
+        tmpHome = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-req-home-'));
+        tmpWork = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-req-work-'));
+        // 关键：HOME 隔离，绝对不污染真实 ~/.ep-stage
+        process.env.HOME = tmpHome;
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        process.env.HOME = originalHome;
+        rmSync(tmpHome, { recursive: true, force: true });
+        rmSync(tmpWork, { recursive: true, force: true });
+    });
+    it('跑完后向对应 project.requirements 追加一条 name=<basename(testsDir)>, lastRunStatus=never', () => {
+        const { codeListPath, requirementDir } = buildMaterialFixture(tmpWork);
+        const projectDir = path.join(tmpWork, 'glue-project');
+        const testsDir = path.join(projectDir, 'src', 'tests', REQUIREMENT_NAME);
+        seedIndex(tmpHome, projectDir);
+        runGenerateTestcase({ codeList: codeListPath, testsDir, requirementDir, projectDir });
+        const index = readIndex(tmpHome);
+        const project = index.projects[0];
+        expect(project.projectDir).toBe(projectDir);
+        expect(project.requirements).toHaveLength(1);
+        const req = project.requirements[0];
+        expect(req.name).toBe(REQUIREMENT_NAME);
+        expect(req.testsDir).toBe(testsDir);
+        expect(req.requirementDir).toBe(requirementDir);
+        expect(req.lastRunStatus).toBe('never');
+    });
+    it('重跑同名需求不重复追加（去重更新）', () => {
+        const { codeListPath, requirementDir } = buildMaterialFixture(tmpWork);
+        const projectDir = path.join(tmpWork, 'glue-project');
+        const testsDir = path.join(projectDir, 'src', 'tests', REQUIREMENT_NAME);
+        seedIndex(tmpHome, projectDir);
+        runGenerateTestcase({ codeList: codeListPath, testsDir, requirementDir, projectDir });
+        runGenerateTestcase({ codeList: codeListPath, testsDir, requirementDir, projectDir });
+        const index = readIndex(tmpHome);
+        const project = index.projects[0];
+        expect(project.requirements).toHaveLength(1);
+    });
+    it('不丢 systems（整体覆写后 systems 仍在）', () => {
+        const { codeListPath, requirementDir } = buildMaterialFixture(tmpWork);
+        const projectDir = path.join(tmpWork, 'glue-project');
+        const testsDir = path.join(projectDir, 'src', 'tests', REQUIREMENT_NAME);
+        seedIndex(tmpHome, projectDir);
+        runGenerateTestcase({ codeList: codeListPath, testsDir, requirementDir, projectDir });
+        const index = readIndex(tmpHome);
+        expect(index.systems).toHaveLength(1);
+        const sys = index.systems[0];
+        expect(sys.url).toBe('http://demo.example.com');
+        expect(sys.credentialsCache.admin.username).toBe('demo');
+    });
+    it('projectDir 不在 index 时抛中文错误并引导先跑 /glue-create-project', () => {
+        const { codeListPath, requirementDir } = buildMaterialFixture(tmpWork);
+        const projectDir = path.join(tmpWork, 'unknown-project');
+        const testsDir = path.join(projectDir, 'src', 'tests', REQUIREMENT_NAME);
+        // seed 的是另一个 projectDir
+        seedIndex(tmpHome, path.join(tmpWork, 'another-project'));
+        expect(() => runGenerateTestcase({ codeList: codeListPath, testsDir, requirementDir, projectDir })).toThrowError(/未在.*projects\.index\.json5.*glue-create-project/u);
+    });
+    it('index 文件不存在时也按 projectDir 不在 index 处理并抛中文错误', () => {
+        const { codeListPath, requirementDir } = buildMaterialFixture(tmpWork);
+        const projectDir = path.join(tmpWork, 'glue-project');
+        const testsDir = path.join(projectDir, 'src', 'tests', REQUIREMENT_NAME);
+        // 不 seedIndex，连 index 文件都不存在
+        expect(() => runGenerateTestcase({ codeList: codeListPath, testsDir, requirementDir, projectDir })).toThrowError(/未在.*projects\.index\.json5.*glue-create-project/u);
+    });
+});

package/dist/test/cli/generate-testcase.test.d.ts

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

package/dist/test/cli/generate-testcase.test.d.ts.map

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