@kkeve/suite 0.0.15 → 0.0.17

package/dist/bin/keve.js

@@ -47,10 +47,11 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
 // package.json is in the package root, not in dist/
 // __dirname → dist/bin/ → go up 2 levels to package root
 const pkgPath = path.resolve(__dirname, '..', '..', 'package.json');
-const pkg = require(pkgPath);
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
 const program = new commander_1.Command();
 program
     .name('keve')

package/dist/commands/clean.js

@@ -43,7 +43,7 @@ exports.clean = clean;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("../config");
+const config_js_1 = require("../config.js");
 function removeDir(dir, dryRun) {
     if (!fs.existsSync(dir))
         return;
@@ -55,7 +55,7 @@ function removeDir(dir, dryRun) {
     console.log(chalk_1.default.green(`  ✓ Removed: ${path.relative(process.cwd(), dir)}`));
 }
 async function clean(options) {
-    const keveDir = (0, config_1.findKeveDir)();
+    const keveDir = (0, config_js_1.findKeveDir)();
     if (!keveDir) {
         console.error(chalk_1.default.red('  ✗ .keve/ directory not found'));
         process.exit(1);

package/dist/commands/config.js

@@ -43,13 +43,13 @@ exports.config = config;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("../config");
-const pw_config_1 = require("../core/pw-config");
+const config_js_1 = require("../config.js");
+const pw_config_js_1 = require("../engine-playwright/pw-config.js");
 async function config(options) {
-    const keveDir = (0, config_1.findKeveDir)();
-    const taskDir = (0, config_1.resolveTaskDir)(keveDir);
+    const keveDir = (0, config_js_1.findKeveDir)();
+    const taskDir = (0, config_js_1.resolveTaskDir)(keveDir);
     if (options.show) {
-        const configPath = (0, pw_config_1.findExistingConfig)(keveDir, taskDir);
+        const configPath = (0, pw_config_js_1.findExistingConfig)(keveDir, taskDir);
         if (configPath) {
             console.log(chalk_1.default.green(`  Config: ${configPath}`));
             console.log(fs.readFileSync(configPath, 'utf-8'));
@@ -69,14 +69,14 @@ async function config(options) {
         timeout: options.timeout ? parseInt(options.timeout, 10) : undefined,
         retries: options.retries ? parseInt(options.retries, 10) : undefined,
     };
-    const content = (0, pw_config_1.generatePwConfig)(pwOptions);
+    const content = (0, pw_config_js_1.generatePwConfig)(pwOptions);
     if (options.print) {
         console.log(content);
         return;
     }
     const outputPath = options.output
         ? path.resolve(options.output)
-        : (0, pw_config_1.resolveConfigOutputPath)();
+        : (0, pw_config_js_1.resolveConfigOutputPath)();
     console.log(chalk_1.default.cyan('\n⚙️  keve config\n'));
     if (fs.existsSync(outputPath) && !options.force) {
         console.log(chalk_1.default.yellow(`  ⚠ ${path.relative(process.cwd(), outputPath)} already exists. Use --force to overwrite.`));

package/dist/commands/init.js

@@ -50,7 +50,7 @@ const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
-const pw_config_1 = require("../core/pw-config");
+const pw_config_js_1 = require("../engine-playwright/pw-config.js");
 // Skills bundled in this package — copied to global ~/.codeflicker/skills/
 const KEVE_SKILLS = [
     'keve-bddcase-gen',
@@ -254,7 +254,7 @@ async function init(options) {
         webServer: !options.cdp,
     };
     if (!fs.existsSync(pwConfigPath) || options.force) {
-        fs.writeFileSync(pwConfigPath, (0, pw_config_1.generatePwConfig)(pwOptions), 'utf-8');
+        fs.writeFileSync(pwConfigPath, (0, pw_config_js_1.generatePwConfig)(pwOptions), 'utf-8');
         console.log(chalk_1.default.green('  ✓ Created keve-test.config.ts'));
         console.log(chalk_1.default.gray(`    baseURL: ${pwOptions.baseUrl || '(from env)'}`));
         console.log(chalk_1.default.gray(`    CDP:     ${pwOptions.cdp ? 'enabled' : 'disabled'}`));

package/dist/commands/report.js

@@ -46,20 +46,20 @@ exports.report = report;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("../config");
-const index_1 = require("../index");
+const config_js_1 = require("../config.js");
+const index_js_1 = require("../index.js");
 /**
  * Resolve paths for report inputs
  */
 function resolvePaths(options) {
-    const keveDir = (0, config_1.findKeveDir)();
+    const keveDir = (0, config_js_1.findKeveDir)();
     // Determine round
     let round = null;
     if (options.round) {
         round = parseInt(options.round, 10);
     }
     else if (keveDir) {
-        const branchDir = (0, config_1.getBranchDir)(keveDir);
+        const branchDir = (0, config_js_1.getBranchDir)(keveDir);
         const artifactsBase = branchDir ? path.join(branchDir, 'test-artifacts') : path.join(keveDir, 'test-artifacts');
         if (fs.existsSync(artifactsBase)) {
             const dirs = fs.readdirSync(artifactsBase)
@@ -73,7 +73,7 @@ function resolvePaths(options) {
     // Resolve test-results.json
     let resultsPath = options.results;
     if (!resultsPath && keveDir && round !== null) {
-        const branchDir = (0, config_1.getBranchDir)(keveDir);
+        const branchDir = (0, config_js_1.getBranchDir)(keveDir);
         const resultBase = branchDir ? path.join(branchDir, 'test-artifacts', `round-${round}`) : path.join(keveDir, 'test-artifacts', `round-${round}`);
         const candidate = path.join(resultBase, 'test-results.json');
         if (fs.existsSync(candidate))
@@ -96,7 +96,7 @@ function resolvePaths(options) {
     // Resolve confidence-data.jsonl
     let confidencePath = '';
     if (keveDir && round !== null) {
-        const branchDir = (0, config_1.getBranchDir)(keveDir);
+        const branchDir = (0, config_js_1.getBranchDir)(keveDir);
         const resultBase = branchDir ? path.join(branchDir, 'test-artifacts', `round-${round}`) : path.join(keveDir, 'test-artifacts', `round-${round}`);
         const candidate = path.join(resultBase, 'confidence-data.jsonl');
         if (fs.existsSync(candidate))
@@ -117,7 +117,7 @@ async function invokeReport(options) {
     const projectRoot = keveDir || path.dirname(resultsPath);
     console.log(chalk_1.default.cyan('\n📊 keve report\n'));
     try {
-        const reportData = await (0, index_1.generateReportData)({
+        const reportData = await (0, index_js_1.generateReportData)({
             projectRoot,
             resultsPath,
             confidencePath: confidencePath || undefined,

package/dist/commands/run.js

@@ -50,9 +50,9 @@ const path = __importStar(require("node:path"));
 const os = __importStar(require("node:os"));
 const node_child_process_1 = require("node:child_process");
 const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("../config");
-const report_1 = require("../core/generateReport/report");
-const reportData_1 = require("../core/generateReport/reportData");
+const config_js_1 = require("../config.js");
+const report_js_1 = require("../core/generateReport/report.js");
+const reportData_js_1 = require("../core/generateReport/reportData.js");
 function isPlaywrightBrowserInstalled() {
     const cacheDir = os.platform() === 'darwin'
         ? path.join(os.homedir(), 'Library/Caches/ms-playwright')
@@ -95,7 +95,7 @@ function findPlaywrightConfig(keveDir, optionsConfig) {
         console.error(chalk_1.default.red(`  ✗ Config not found: ${optionsConfig}`));
         return null;
     }
-    const taskDir = (0, config_1.resolveTaskDir)(keveDir);
+    const taskDir = (0, config_js_1.resolveTaskDir)(keveDir);
     const searchPaths = [
         taskDir ? path.join(taskDir, 'keve-test.config.mjs') : null,
         taskDir ? path.join(taskDir, 'keve-test.config.ts') : null,
@@ -139,7 +139,7 @@ class KeveRunError extends Error {
 }
 exports.KeveRunError = KeveRunError;
 async function run(options) {
-    const keveDir = (0, config_1.findKeveDir)();
+    const keveDir = (0, config_js_1.findKeveDir)();
     const cwd = process.cwd();
     const configPath = findPlaywrightConfig(keveDir || '', options.config);
     if (!configPath) {
@@ -150,12 +150,13 @@ async function run(options) {
         pwConfig = await new Function('return import(' + JSON.stringify(configPath) + ')')();
     }
     catch (e) {
-        throw new KeveRunError(`Failed to import Playwright config: ${e.message}`);
+        // 包含 config 路径和完整错误堆栈，便于定位 "Invalid left-hand side" 等语法错误
+        throw new KeveRunError(`Failed to import Playwright config (${configPath}): ${e.message}\n${e.stack || ''}`);
     }
     const configDefault = pwConfig?.default || pwConfig;
     const taskDir = process.env.KEVE_TASK_DIR
         ? path.resolve(process.env.KEVE_TASK_DIR)
-        : (0, config_1.resolveTaskDir)(keveDir) || cwd;
+        : (0, config_js_1.resolveTaskDir)(keveDir) || cwd;
     let resultDir = '';
     let resultsFile = '';
     if (configDefault?.reporter) {
@@ -173,7 +174,7 @@ async function run(options) {
         round = parseInt(options.round, 10);
     }
     else {
-        round = (0, config_1.getNextRoundFromState)(taskDir);
+        round = (0, config_js_1.getNextRoundFromState)(taskDir);
     }
     resultDir = path.join(taskDir, 'test-artifacts', `round-${round}`);
     resultsFile = path.join(resultDir, 'test-results.json');
@@ -265,7 +266,7 @@ async function run(options) {
     console.log(chalk_1.default.green(`\n  ✓ Round ${round} complete`));
     console.log(chalk_1.default.gray(`    Tests: ${stats.expected || 0} expected, ${stats.actual || 0} actual`));
     console.log(chalk_1.default.gray(`    Passed: ${passed}, Failed: ${failed}, Skipped: ${skipped}`));
-    (0, config_1.completeRound)(taskDir, round, { passed, failed, skipped });
+    (0, config_js_1.completeRound)(taskDir, round, { passed, failed, skipped });
     stripBase64FromTestResults(resultsFile, resultDir);
     // ── 生成 report-data.json：在 Playwright 进程结束后统一生成，避免 keve-reporter 的 onEnd 与 JSON reporter 的 race condition ──
     // keve-reporter.ts 的 onEnd 在 Playwright 进程内部执行，此时 JSON reporter 可能尚未完全刷新 test-results.json，
@@ -275,7 +276,7 @@ async function run(options) {
     try {
         const confidencePath = path.join(resultDir, 'confidence-data.jsonl');
         const casesPath = path.join(taskDir, 'cases', 'test-cases.yaml');
-        const reportData = await (0, reportData_1.generateReportData)({
+        const reportData = await (0, reportData_js_1.generateReportData)({
             projectRoot: taskDir,
             resultsPath: resultsFile,
             confidencePath: fs.existsSync(confidencePath) ? confidencePath : undefined,
@@ -399,7 +400,7 @@ async function runGenerateReport(resultDir, resultsFile, keveDir, taskDir) {
     const confidenceFile = path.join(resultDir, 'confidence-data.jsonl');
     console.log(chalk_1.default.gray('  Step 1: Generating report data...'));
     try {
-        const { reportData } = await (0, report_1.generateReport)({
+        const { reportData } = await (0, report_js_1.generateReport)({
             projectRoot,
             resultsPath: resultsFile,
             confidencePath: fs.existsSync(confidenceFile) ? confidenceFile : undefined,

package/dist/commands/test.js

@@ -44,12 +44,12 @@ exports.test = test;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("../config");
-const run_1 = require("./run");
-const report_1 = require("./report");
+const config_js_1 = require("../config.js");
+const run_js_1 = require("./run.js");
+const report_js_1 = require("./report.js");
 async function test(options) {
     const maxRounds = parseInt(options.maxRounds || '3', 10);
-    const keveDir = (0, config_1.findKeveDir)();
+    const keveDir = (0, config_js_1.findKeveDir)();
     console.log(chalk_1.default.cyan('\n🔄 keve test — Full pipeline\n'));
     console.log(chalk_1.default.gray(`  Max rounds: ${maxRounds}`));
     for (let round = 1; round <= maxRounds; round++) {
@@ -57,14 +57,14 @@ async function test(options) {
         // Step 1: Run tests
         console.log(chalk_1.default.yellow('  [1/2] Running tests...'));
         try {
-            await (0, run_1.run)({
+            await (0, run_js_1.run)({
                 config: options.config,
                 grep: options.grep,
                 verbose: options.verbose,
             });
         }
         catch (e) {
-            if (e instanceof run_1.KeveRunError) {
+            if (e instanceof run_js_1.KeveRunError) {
                 console.error(chalk_1.default.red(`  ✗ Run failed: ${e.message}`));
                 break;
             }
@@ -72,7 +72,7 @@ async function test(options) {
         }
         // Step 2: Generate report
         console.log(chalk_1.default.yellow('  [2/2] Generating report...'));
-        await (0, report_1.report)({});
+        await (0, report_js_1.report)({});
         // Check if all passed — if so, we're done
         if (keveDir) {
             const summaryPath = path.join(keveDir, 'reports', 'latest', 'execution-summary.json');

package/dist/config.js

@@ -51,10 +51,10 @@ exports.readRunState = readRunState;
 exports.writeRunState = writeRunState;
 exports.getNextRoundFromState = getNextRoundFromState;
 exports.completeRound = completeRound;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
 const yaml = __importStar(require("yaml"));
-const child_process_1 = require("child_process");
+const node_child_process_1 = require("node:child_process");
 const DEFAULT_CONFIG = {
     project: {
         name: '',
@@ -166,7 +166,7 @@ function getBranchDir(keveDir) {
  */
 function getCurrentBranch() {
     try {
-        return (0, child_process_1.execSync)('git branch --show-current', { encoding: 'utf-8' }).trim();
+        return (0, node_child_process_1.execSync)('git branch --show-current', { encoding: 'utf-8' }).trim();
     }
     catch {
         return null;
@@ -177,7 +177,7 @@ function getCurrentBranch() {
  */
 function getGitUserName() {
     try {
-        return (0, child_process_1.execSync)('git config user.name', { encoding: 'utf-8' }).trim();
+        return (0, node_child_process_1.execSync)('git config user.name', { encoding: 'utf-8' }).trim();
     }
     catch {
         return process.env.KEVE_USER_NAME || '';
@@ -188,7 +188,7 @@ function getGitUserName() {
  */
 function getGitRepoName() {
     try {
-        const url = (0, child_process_1.execSync)('git remote get-url origin', { encoding: 'utf-8' }).trim();
+        const url = (0, node_child_process_1.execSync)('git remote get-url origin', { encoding: 'utf-8' }).trim();
         const parts = url.replace(/\.git$/, '').split('/');
         return parts[parts.length - 1] || '';
     }
@@ -201,7 +201,7 @@ function getGitRepoName() {
  */
 function getGitBranchName() {
     try {
-        return (0, child_process_1.execSync)('git branch --show-current', { encoding: 'utf-8' }).trim();
+        return (0, node_child_process_1.execSync)('git branch --show-current', { encoding: 'utf-8' }).trim();
     }
     catch {
         return '';

package/dist/core/action-log-writer.js

@@ -46,7 +46,10 @@ class ActionLogWriter {
     filePath;
     constructor(taskDir) {
         const dir = taskDir || process.env.KEVE_TASK_DIR || '.keve';
-        const logDir = path.join(dir, 'test-artifacts', `round-${process.env.KEVE_ROUND || 'latest'}`);
+        // 优先写入 runner 注入的当前轮次目录；缺失时回退旧布局。
+        const logDir = process.env.KEVE_RESULT_DIR
+            ? path.resolve(process.env.KEVE_RESULT_DIR)
+            : path.join(dir, 'test-artifacts', `round-${process.env.KEVE_ROUND || 'latest'}`);
         fs.mkdirSync(logDir, { recursive: true });
         this.filePath = path.join(logDir, 'action-log.jsonl');
     }

package/dist/core/decorator/keve-decorators.d.ts

@@ -0,0 +1,128 @@
+/**
+ * keve-decorators — @keveModel + @keveScene 装饰器
+ *
+ * 使用 TC39 Stage 3 装饰器 API (Playwright 1.58+ 默认支持)
+ *
+ * 执行顺序（TC39 Stage 3 规范）：
+ * 1. Method decorator 函数调用 → 注册 addInitializer
+ * 2. Class decorator 函数调用 → 注册 addInitializer
+ * 3. Method addInitializers 执行 → @keveScene 注册场景到 WeakMap
+ * 4. Class addInitializer 执行 → @keveModel 读取 WeakMap 并调用 test.describe
+ *
+ * 两层装饰器 + 函数调用：
+ *   Model (模块) → test.describe → @keveModel(id, desc, { setup, teardown, precondition?, before? })
+ *   Scene (场景) → test → @keveScene(id, desc, { tag?, precondition?, before?, afterHook? })
+ *   Goal  (步骤) → 步骤元数据 → keveGoal() 函数调用（在方法体内，支持 precondition）
+ *
+ * @keveGroup 已消除：
+ *   - setup → @keveModel setup 选项（独立 Page，所有 Scene 前执行）
+ *   - teardown → @keveModel teardown 选项（所有 Scene 后执行，扫描 E2E_ 前缀）
+ *   - identity → Scene 内 keveGoal(fn) 中调用 globalThis.switchIdentity
+ *   - afterHook → @keveScene afterHook 选项（Scene 后保证执行）
+ */
+import { type KeveGoalMeta } from './keve-registry.js';
+import { type KeveHost } from './keve-host.js';
+/**
+ * 注册宿主（推荐入口，引擎无关）。
+ */
+export declare function setKeveTestHost(host: KeveHost): void;
+/**
+ * Playwright 兼容适配：把 @playwright/test 的 test 对象包成 KeveHost。
+ * 保留该名称是为了不破坏既有调用（keve-test.ts / 外部脚本）。
+ */
+export declare function setKeveTest(t: any): void;
+/** Get the current keve test instance (Playwright 兼容查询；Cypress 下返回宿主) */
+export declare function getKeveTest(): KeveHost;
+/** 是否已注册宿主 */
+export declare function hasKeveTest(): boolean;
+export type { KeveGoalMeta, KeveEvalMeta, ErrorCategory } from './keve-registry.js';
+export interface KeveModelOptions {
+    /**
+     * Module 级 setup：在所有 Scene 之前执行一次。
+     * 拥有独立 Page（完成后销毁，不与 Scene 共享）。
+     * 用 keveGoal(fn) → API 成功零 AI 开销，失败 AI 自愈。
+     * 签名：async ({ page, keveGoal }) => { ... }
+     * Playwright 将其作为独立 test() 执行，因此可以解构 fixture。
+     */
+    setup?: Function;
+    /**
+     * Module 级 teardown：在所有 Scene 之后执行一次。
+     * 保证执行（即使 Scene 失败/超时）。
+     * 无 Playwright fixture —— 纯异步函数，用于 API 清理、E2E_ 前缀扫描等。
+     * 签名：async () => { ... }
+     */
+    teardown?: Function;
+    /**
+     * Module 级前置条件（声明式描述）：进入任何 Scene 之前必须满足的条件列表。
+     * 仅作元数据声明，供 Reporter/平台侧展示与归因（blocked ≠ fail）。
+     * 需要可执行校验时用 before。
+     */
+    precondition?: string[];
+    /**
+     * Module 级可执行前置校验：在所有 Scene 之前执行一次（beforeAll）。
+     * 返回 false 或抛错 → 整个 Model 下所有 Scene 跳过（skip，不是 fail）。
+     * 无 Playwright fixture —— 纯异步函数（可用自有 API client 做环境检查）。
+     * 签名：async () => boolean
+     */
+    before?: () => Promise<boolean>;
+}
+export interface KeveSceneOptions {
+    /** 场景标签（可选，用于分类过滤） */
+    tag?: string;
+    /**
+     * 用例级前置条件（声明式描述）：本 Scene 执行前必须满足的条件列表。
+     * 仅作元数据声明，供 Reporter/平台侧展示与归因（对应旧系统 stepGroup.extraInfo.precondition）。
+     * 需要可执行校验时用 before。
+     */
+    precondition?: string[];
+    /**
+     * Scene 级可执行前置校验：本 Scene 执行前调用一次（beforeEach，仅对本 Scene 生效）。
+     * 返回 false 或抛错 → 本 Scene 跳过（skip，不是 fail）。
+     * 无 Playwright fixture —— 纯异步函数。
+     * 签名：async () => boolean
+     */
+    before?: () => Promise<boolean>;
+    /**
+     * Scene 级 afterHook：Scene 执行后保证调用（即使失败/超时）。
+     * 无 Playwright fixture —— 纯异步函数，用于 API 清理等。
+     * 签名：async () => { ... }
+     */
+    afterHook?: Function;
+}
+export interface KeveSceneMeta {
+    id: string;
+    description: string;
+    title: string;
+    code: string;
+    goals: KeveGoalMeta[];
+    fn: Function;
+    /** 用例级前置条件描述列表 */
+    precondition?: string[];
+    /** 可执行前置校验 */
+    before?: () => Promise<boolean>;
+    afterHook?: Function;
+}
+/**
+ * @keveModel(id, description, options?) — Class decorator (模块层)
+ * Uses context.addInitializer to defer test.describe() registration
+ * until AFTER all @keveScene addInitializers have run.
+ *
+ * options.setup: 第一个 test() 调用，拥有独立 Page + keveGoal
+ * options.teardown: test.afterAll 回调，保证执行
+ */
+export declare function keveModel(id: string, description: string, options?: KeveModelOptions): <T extends {
+    new (...args: any[]): {};
+}>(ctor: T, context: ClassDecoratorContext) => T;
+/**
+ * @keveScene(id, description, options?) — Method decorator (场景层, static methods only)
+ * Captures fn.toString() as the complete scene script.
+ * Registers scene metadata to both WeakMap and global Map.
+ * If options.afterHook is provided, registers it in sceneAfterHooks Map
+ * for afterEach consumption.
+ *
+ * Returns the original function unchanged — Playwright resolves fixture dependencies
+ * by parsing fn.toString() / AST. Wrapping would break this resolution.
+ */
+export declare function keveScene(id: string, description: string, options?: KeveSceneOptions): (fn: any, context: ClassMethodDecoratorContext) => any;
+/** 获取 Model 下注册的所有 Scene */
+export declare function getModelScenes(ctor: Function): KeveSceneMeta[] | null;