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

package/dist/src/cli/dev/extract-contract.js

@@ -0,0 +1,114 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { buildCrudBusinessModuleContract, extractCodeListSummary, extractHtmlPage, extractJavaAction, extractSpecYaml, } from '../../index.js';
+/**
+ * 解析 dev/extract-contract.ts 的命令行参数。
+ *
+ * @param argv - process.argv.slice(2)。
+ * @returns 解析后的 ExtractContractArgs。
+ * @throws 缺少必填参数或显式使用废弃的 --module 时抛错。
+ */
+function parseExtractContractArgs(argv) {
+    const result = {};
+    const normalizedArgv = argv.filter((arg) => arg !== '--');
+    for (let index = 0; index < normalizedArgv.length; index += 2) {
+        const key = normalizedArgv[index];
+        const value = normalizedArgv[index + 1];
+        if (!key?.startsWith('--') || !value) {
+            throw new Error(`Invalid argument pair near ${key ?? '<empty>'}`);
+        }
+        result[key.slice(2)] = value;
+    }
+    if (result.module) {
+        throw new Error('已废弃 --module，请使用 --module-id。');
+    }
+    for (const key of ['module-id', 'docs', 'code-list', 'webapp', 'java-actions', 'out']) {
+        if (!result[key]) {
+            throw new Error(`Missing required argument --${key}`);
+        }
+    }
+    return {
+        module: result['module-id'],
+        docs: result.docs,
+        codeList: result['code-list'],
+        webapp: result.webapp,
+        javaActions: result['java-actions'],
+        hints: result.hints,
+        out: result.out,
+    };
+}
+/**
+ * 列出指定目录下所有 .html 文件并返回排序后的绝对路径。
+ *
+ * @param dir - HTML 物料目录。
+ * @returns 排序后的绝对路径数组。
+ */
+function htmlFiles(dir) {
+    return readdirSync(dir)
+        .filter((fileName) => fileName.endsWith('.html'))
+        .sort()
+        .map((fileName) => path.join(dir, fileName));
+}
+/**
+ * 列出指定目录下所有 *Action.java 文件并返回排序后的绝对路径。
+ *
+ * @param dir - Java Action 物料目录。
+ * @returns 排序后的绝对路径数组。
+ */
+function javaFiles(dir) {
+    return readdirSync(dir)
+        .filter((fileName) => fileName.endsWith('Action.java'))
+        .sort()
+        .map((fileName) => path.join(dir, fileName));
+}
+/**
+ * 解析 docs 目录下的 spec.yaml；缺失时返回最小空骨架（保证 contract 构建不阻断）。
+ *
+ * @param docsDir - 需求文档目录。
+ * @param moduleId - 模块 ID。
+ * @param codeListSummary - 已解析的 code_list 摘要。
+ * @returns ExtractedSpecYaml。
+ */
+function resolveSpec(docsDir, moduleId, codeListSummary) {
+    const specPath = path.join(docsDir, 'spec.yaml');
+    if (existsSync(specPath))
+        return extractSpecYaml(specPath);
+    return {
+        path: specPath,
+        module: { id: moduleId, label: codeListSummary.moduleLabel },
+        fields: [],
+        businessRules: [],
+    };
+}
+/**
+ * 开发期 contract 提取入口（REQ-CLI-03）。被 generate:crud-contract pnpm script 调用，
+ * 不在 index.ts 注册为子命令，不出现在任何 SKILL.md。
+ *
+ * 行为与 0.0.3-alpha.2 的 generate-crud-contract.ts 完全等价；本次重构仅把执行
+ * 入口包装成可被 pnpm script 与 generate-testcase 子命令复用的纯函数。
+ *
+ * @param argv - 命令行参数（--module-id/--docs/--code-list/--webapp/--java-actions/--hints/--out）。
+ * @returns 写入的 contract.json 绝对路径。
+ */
+export function runExtractContract(argv) {
+    const args = parseExtractContractArgs(argv);
+    const hints = args.hints
+        ? JSON.parse(readFileSync(args.hints, 'utf8'))
+        : undefined;
+    const codeList = extractCodeListSummary(args.codeList);
+    const contract = buildCrudBusinessModuleContract({
+        moduleId: args.module,
+        spec: resolveSpec(args.docs, args.module, codeList),
+        codeList,
+        pages: htmlFiles(args.webapp).map(extractHtmlPage),
+        actions: javaFiles(args.javaActions).map(extractJavaAction),
+        hints,
+    });
+    mkdirSync(path.dirname(args.out), { recursive: true });
+    writeFileSync(args.out, `${JSON.stringify(contract, null, 2)}\n`, 'utf8');
+    console.log(`Wrote ${args.out}`);
+    return { contractPath: path.resolve(args.out) };
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runExtractContract(process.argv.slice(2));
+}

package/dist/src/cli/generate-crud-contract.js

@@ -1,77 +1,7 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { buildCrudBusinessModuleContract, extractCodeListSummary, extractHtmlPage, extractJavaAction, extractSpecYaml } from '../index.js';
-function parseArgs(argv) {
-    const result = {};
-    const normalizedArgv = argv.filter((arg) => arg !== '--');
-    for (let index = 0; index < normalizedArgv.length; index += 2) {
-        const key = normalizedArgv[index];
-        const value = normalizedArgv[index + 1];
-        if (!key?.startsWith('--') || !value) {
-            throw new Error(`Invalid argument pair near ${key ?? '<empty>'}`);
-        }
-        result[key.slice(2)] = value;
-    }
-    if (result.module) {
-        throw new Error('已废弃 --module，请使用 --module-id。' +
-            '例: pnpm generate:crud-contract -- --module-id zwplace ...');
-    }
-    const required = ['module-id', 'docs', 'code-list', 'webapp', 'java-actions', 'out'];
-    for (const key of required) {
-        if (!result[key]) {
-            throw new Error(`Missing required argument --${key}`);
-        }
-    }
-    return {
-        module: result['module-id'],
-        docs: result.docs,
-        codeList: result['code-list'],
-        webapp: result.webapp,
-        javaActions: result['java-actions'],
-        hints: result.hints,
-        out: result.out
-    };
-}
-function htmlFiles(dir) {
-    return readdirSync(dir)
-        .filter((fileName) => fileName.endsWith('.html'))
-        .sort()
-        .map((fileName) => path.join(dir, fileName));
-}
-function javaFiles(dir) {
-    return readdirSync(dir)
-        .filter((fileName) => fileName.endsWith('Action.java'))
-        .sort()
-        .map((fileName) => path.join(dir, fileName));
-}
-const args = parseArgs(process.argv.slice(2));
-const hints = args.hints
-    ? JSON.parse(readFileSync(args.hints, 'utf8'))
-    : undefined;
-const codeList = extractCodeListSummary(args.codeList);
-function resolveSpec(docsDir, moduleId, codeListSummary) {
-    const specPath = path.join(docsDir, 'spec.yaml');
-    if (existsSync(specPath)) {
-        return extractSpecYaml(specPath);
-    }
-    return {
-        path: specPath,
-        module: {
-            id: moduleId,
-            label: codeListSummary.moduleLabel
-        },
-        fields: [],
-        businessRules: []
-    };
-}
-const contract = buildCrudBusinessModuleContract({
-    moduleId: args.module,
-    spec: resolveSpec(args.docs, args.module, codeList),
-    codeList,
-    pages: htmlFiles(args.webapp).map(extractHtmlPage),
-    actions: javaFiles(args.javaActions).map(extractJavaAction),
-    hints
-});
-mkdirSync(path.dirname(args.out), { recursive: true });
-writeFileSync(args.out, `${JSON.stringify(contract, null, 2)}\n`, 'utf8');
-console.log(`Wrote ${args.out}`);
+import { runExtractContract } from './dev/extract-contract.js';
+/**
+ * 旧 pnpm script 入口薄壳（REQ-CLI-03 修订）：所有逻辑搬到 dev/extract-contract.ts。
+ * 本文件不删除，保持旧 pnpm script `generate:crud-contract` 零回归；新代码请直接
+ * 调用 `runExtractContract`。
+ */
+runExtractContract(process.argv.slice(2));

package/dist/src/cli/generate-playwright-tests.d.ts

@@ -1,30 +1,2 @@
-/**
- * Playwright 测试脚本生成 CLI 入口
- *
- * 从 CRUD 业务模块契约 JSON 文件生成基于 glue 模板骨架的 Playwright 测试脚本。
- *
- * 使用方式：
- * ```bash
- * pnpm generate:playwright-tests -- \
- *   --contract <contract-json-path> \
- *   --out <output-spec-ts-path> \
- *   --menu <menu-path> \
- *   --testcase <glue-testcase-json-path>
- * ```
- *
- * 参数说明：
- * - --contract (必填): 契约 JSON 文件路径
- * - --out (必填): 输出的 .spec.ts 文件路径
- * - --menu (必填): 菜单路径，传给 MenuPage.navigateToMenu()
- * - --testcase (可选): 已确认的 glue testcase JSON；传入后会校验用例与 contract 粒度一致。
- *
- * 示例：
- * ```bash
- * pnpm generate:playwright-tests -- \
- *   --contract output/zwplace.crud.contract.json \
- *   --out ../stage-project/src/tests/generated-zwplace.skeleton.spec.ts \
- *   --menu "场所窗口信息管理>场所窗口信息列表"
- * ```
- */
 export {};
 //# sourceMappingURL=generate-playwright-tests.d.ts.map

package/dist/src/cli/generate-playwright-tests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-playwright-tests.d.ts","sourceRoot":"","sources":["../../../src/cli/generate-playwright-tests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}
+{"version":3,"file":"generate-playwright-tests.d.ts","sourceRoot":"","sources":["../../../src/cli/generate-playwright-tests.ts"],"names":[],"mappings":""}

package/dist/src/cli/generate-playwright-tests.js

@@ -1,81 +1,4 @@
-/**
- * Playwright 测试脚本生成 CLI 入口
- *
- * 从 CRUD 业务模块契约 JSON 文件生成基于 glue 模板骨架的 Playwright 测试脚本。
- *
- * 使用方式：
- * ```bash
- * pnpm generate:playwright-tests -- \
- *   --contract <contract-json-path> \
- *   --out <output-spec-ts-path> \
- *   --menu <menu-path> \
- *   --testcase <glue-testcase-json-path>
- * ```
- *
- * 参数说明：
- * - --contract (必填): 契约 JSON 文件路径
- * - --out (必填): 输出的 .spec.ts 文件路径
- * - --menu (必填): 菜单路径，传给 MenuPage.navigateToMenu()
- * - --testcase (可选): 已确认的 glue testcase JSON；传入后会校验用例与 contract 粒度一致。
- *
- * 示例：
- * ```bash
- * pnpm generate:playwright-tests -- \
- *   --contract output/zwplace.crud.contract.json \
- *   --out ../stage-project/src/tests/generated-zwplace.skeleton.spec.ts \
- *   --menu "场所窗口信息管理>场所窗口信息列表"
- * ```
- */
-import { readFileSync, writeFileSync } from 'node:fs';
-import { generateStageSkeletonCrudSpec } from '../generators/stage-skeleton-script.js';
-import { validateGlueTestcaseDocumentForSpecAssembly } from '../testcase/testcase-spec-assembly.js';
-/**
- * 解析命令行参数
- *
- * 将 process.argv 转换为结构化的参数对象。
- * 支持 `--key value` 格式的参数对，自动过滤 `--` 分隔符。
- *
- * @param argv - 命令行参数数组（不含 node 和脚本路径）
- * @returns 解析后的参数对象
- * @throws 当参数格式无效或缺少必填参数时抛出错误
- */
-function parseArgs(argv) {
-    const result = {};
-    // 过滤 `--` 分隔符
-    const normalizedArgv = argv.filter((arg) => arg !== '--');
-    // 按键值对解析
-    for (let index = 0; index < normalizedArgv.length; index += 2) {
-        const key = normalizedArgv[index];
-        const value = normalizedArgv[index + 1];
-        if (!key?.startsWith('--') || !value) {
-            throw new Error(`无效的参数对，靠近 ${key ?? '<empty>'}`);
-        }
-        result[key.slice(2)] = value;
-    }
-    // 验证必填参数
-    if (!result.contract || !result.out || !result.menu) {
-        throw new Error('用法: tsx generate-playwright-tests.ts --contract <path> --out <path> --menu <menu-path>');
-    }
-    return {
-        contract: result.contract,
-        out: result.out,
-        menu: result.menu,
-        testcase: result.testcase,
-    };
-}
-// 执行主流程
-const args = parseArgs(process.argv.slice(2));
-// 读取契约 JSON 文件
-const contract = JSON.parse(readFileSync(args.contract, 'utf8'));
-if (args.testcase) {
-    const testcaseDocument = JSON.parse(readFileSync(args.testcase, 'utf8'));
-    validateGlueTestcaseDocumentForSpecAssembly(testcaseDocument, contract);
-}
-// 生成基于 glue 模板骨架的 Playwright 测试脚本
-const script = generateStageSkeletonCrudSpec({
-    contract,
-    menuNavigation: args.menu
-});
-// 写入输出文件
-writeFileSync(args.out, script, 'utf8');
-console.log(`已生成 ${args.out}`);
+// 薄壳：保留旧入口零回归，实际逻辑见 ./spec.ts（src/cli/index.ts spec 子命令统一入口）。
+// 新参数：--testcase <p> --out <p>（旧的 --contract / --menu 已迁移到 testcase 子命令 + spec 子命令链路）。
+import { parseSpecArgs, runSpec } from './spec.js';
+runSpec(parseSpecArgs(process.argv.slice(2)));

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

@@ -0,0 +1,84 @@
+import type { TestcaseV2 } from '../testcase/testcase-v2.js';
+/**
+ * testcase 子命令解析后的参数（REQ-CHAIN-01 / REQ-SCENE-01）。
+ *
+ * - codeList：上游 code_list.md 绝对路径（必填）；
+ * - testsDir：<projectDir>/src/tests/<需求名> 绝对路径（必填）；
+ * - scenario：①档优先级（显式 CLI 参数）；
+ * - hints：ModuleHints JSON 路径（可选；推断 scenario 用）；
+ * - projectDir / requirementDir：可选覆盖，默认从 codeList 路径推断。
+ */
+export type GenerateTestcaseArgs = {
+    codeList: string;
+    testsDir: string;
+    scenario?: string;
+    hints?: string;
+    projectDir?: string;
+    requirementDir?: string;
+};
+/**
+ * testcase 子命令产物 + 推断结果（供 skill Step 5 交互确认）。
+ */
+export type GenerateTestcaseResult = {
+    testcasePath: string;
+    testcaseMdPath: string;
+    credentialsTemplatePath: string;
+    inferenceTracePath: string;
+    inference: {
+        scenario: string;
+        requiredSystems: TestcaseV2['requiredSystems'];
+        requiredRoles: TestcaseV2['requiredRoles'];
+        credentialsTemplatePath: string;
+        credentialsActualPath: string;
+        cachedSystemsHit: string[];
+    };
+};
+/**
+ * 解析 testcase 子命令参数。
+ *
+ * @param argv - 已剥离子命令名的命令行参数。
+ * @returns 解析后的 GenerateTestcaseArgs。
+ * @throws 缺少 --code-list 或 --tests-dir 时抛错。
+ */
+export declare function parseGenerateTestcaseArgs(argv: string[]): GenerateTestcaseArgs;
+/**
+ * scenario 3 档决策（REQ-SCENE-01）：
+ * 1. --scenario CLI 参数（最高优先级）
+ * 2. ModuleHints 文件路径包含 `scenario=<value>` 字串（粗推断）
+ * 3. 默认 "crud.single-page"（与 i18n 表 / skeleton scenario 一致）
+ *
+ * @param args - 解析后的参数。
+ * @returns 决策结果。
+ */
+export declare function decideScenario(args: GenerateTestcaseArgs): string;
+/**
+ * 把 TestcaseV2 渲染成中文 testcase.md（REQ-UX-03）。
+ *
+ * 设计：
+ * - 字段名 / 状态值通过 i18nTestcase() 翻译；
+ * - `unresolved` 字段标题硬编码「未确认项」（i18n 表中 `unresolved` 解析为状态值「未解决」）；
+ * - 每次重跑覆盖（REQ-DATA-03 由调用方 writeFileSync 触发）。
+ *
+ * @param testcase - TestcaseV2 顶层结构。
+ * @returns Markdown 文本。
+ */
+export declare function renderTestcaseMarkdown(testcase: TestcaseV2): string;
+/**
+ * testcase 子命令主体（REQ-CHAIN-01 / REQ-CHAIN-02 / REQ-SCENE-01 / REQ-DATA-02）。
+ *
+ * 流程：
+ * 1. 决定 scenario（3 档优先级，写入 testcase 顶层 scenario 字段）；
+ * 2. 调 runProbeAndCoverage 钻探上游物料 + 装配 TestcaseV2；
+ * 3. 落盘 testcase.json5 + testcase.md（中文 i18n） + credentials.template.json5；
+ * 4. 软链上游 code_list.md → <tests-dir>/code_list.md；
+ * 5. 返回推断结果（供 skill Step 5 交互确认 systemUrl / credentialsCache 命中）。
+ *
+ * 注意：contract 提取通过 probe 内部完成，不直接复用 dev/extract-contract.ts 的 CLI 入口
+ * （probe + extract-contract 共享同一组 buildCrudBusinessModuleContract + extractor 依赖，
+ * 二者各自负责自己的 I/O 边界，保持职责单一）。
+ *
+ * @param args - 已解析参数。
+ * @returns 产物路径 + 推断结果。
+ */
+export declare function runGenerateTestcase(args: GenerateTestcaseArgs): GenerateTestcaseResult;
+//# sourceMappingURL=generate-testcase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-testcase.d.ts","sourceRoot":"","sources":["../../../src/cli/generate-testcase.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;QAC/C,aAAa,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;QAC3C,uBAAuB,EAAE,MAAM,CAAC;QAChC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAqB9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAOjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAgDnE;AAkID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,sBAAsB,CA+DtF"}