@kkeve/suite 0.0.13 → 0.0.17

package/scripts/runtime/playwright.config.mjs

@@ -0,0 +1,41 @@
+/**
+ * Playwright 任务级配置（静态模板）
+ *
+ * 该文件不再随任务生成，任务差异全部通过环境变量注入：
+ *   KEVE_TASK_DIR    任务根（specs 位于其下）
+ *   KEVE_RESULT_DIR  当前轮次产物目录
+ * 因此任务目录只保留 specs / reports / runs / cases，不再落 package.json 与配置副本。
+ */
+import { defineConfig } from '@playwright/test';
+import * as path from 'node:path';
+import * as url from 'node:url';
+
+const runtimeDir = path.dirname(url.fileURLToPath(import.meta.url));
+const suiteRoot = path.resolve(runtimeDir, '..', '..');
+
+const taskDir = process.env.KEVE_TASK_DIR || path.resolve(suiteRoot, '.keve', 'default');
+const resultDir = process.env.KEVE_RESULT_DIR || path.join(taskDir, 'reports', 'round-latest');
+
+export default defineConfig({
+  testDir: path.join(taskDir, 'specs'),
+  globalSetup: '@kkeve/suite/global-setup',
+  fullyParallel: false,
+  workers: 1,
+  retries: 0,
+  timeout: 120000,
+  expect: { timeout: 10000 },
+  reporter: [
+    ['list'],
+    ['json', { outputFile: path.join(resultDir, 'test-results.json') }],
+    ['@kkeve/suite/keve-report'],
+  ],
+  use: {
+    baseURL: process.env.KEVE_TARGET_URL || '',
+    storageState: process.env.KEVE_STORAGE_STATE,
+    trace: 'off',
+    screenshot: 'off',
+    video: 'on',
+    actionTimeout: 10000,
+  },
+  outputDir: path.join(resultDir, 'test-results'),
+});

package/scripts/verify-shot-diff.mjs

@@ -0,0 +1,243 @@
+/**
+ * verify-shot-diff — 截图基线对比核心逻辑验证（零浏览器、零外部依赖）
+ *
+ * 前置：EVE/packages/suite 已构建（npm run build，产物 dist/core/*.js）。
+ * 运行：cd EVE/packages/suite && node scripts/verify-shot-diff.mjs
+ *
+ * 覆盖（对齐设计方案 §3 判定语义）：
+ *   1. pngCodec 编解码往返（RGB/RGBA）
+ *   2. 解码器对 PNG 全部 4 种行滤波（Sub/Up/Average/Paeth）的正确性
+ *      —— Playwright 截图会用任意滤波，必须都能解
+ *   3. 基线生命周期：无基线 → baseline_required（候选基线，不判通过）→ 模拟审核转正
+ *      → 二跑 identical → matched；未审核再跑仍 baseline_required（候选门控 / A06）
+ *   4. 超阈值 → 抛 ScreenshotDiffError（exceeded），差异区块/差异图/meta 齐全
+ *   5. 掩码生效：把差异区写进 meta.masks → matched（动态区域治理闭环）
+ *   6. 视口变化：同 key 其它视口基线存在 → size_mismatch（不自举新基线 / A20）
+ *   7. goal 捕获缓冲：begin → record → drain 语义
+ */
+
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as zlib from 'node:zlib';
+
+// ── 隔离环境：基线/产物写进临时目录，绝不污染真实 baselines ──
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'keve-shotdiff-verify-'));
+process.env.KEVE_BASELINE_DIR = path.join(tmp, 'baselines');
+process.env.KEVE_TASK_DIR = path.join(tmp, 'task');
+delete process.env.KEVE_ENV; // 默认 test
+process.env.KEVE_SHOT_DIFF_THRESHOLD = '1.0';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const dist = path.resolve(here, '../dist/core');
+let decodePng, encodePng, screenshotDiff;
+try {
+    ({ decodePng, encodePng } = await import(`${dist}/pngCodec.js`));
+    screenshotDiff = await import(`${dist}/screenshotDiff.js`);
+} catch (err) {
+    console.error('✗ 无法加载 dist 产物 —— 请先构建：cd EVE/packages/suite && npm run build');
+    console.error(`  (${err.message})`);
+    process.exit(2);
+}
+
+let passed = 0, failed = 0;
+function ok(name, cond, extra = '') {
+    if (cond) { passed++; console.log(`  ✓ ${name}`); }
+    else { failed++; console.error(`  ✗ ${name}${extra ? ` — ${extra}` : ''}`); }
+}
+
+// ── 造图工具 ──
+
+const W = 96, H = 64;
+function fillImage(w, h, fn) {
+    const data = new Uint8Array(w * h * 4);
+    for (let y = 0; y < h; y++) for (let x = 0; x < w; x++) {
+        const [r, g, b, a = 255] = fn(x, y);
+        const i = (y * w + x) * 4;
+        data[i] = r; data[i + 1] = g; data[i + 2] = b; data[i + 3] = a;
+    }
+    return data;
+}
+const solid = (r, g, b) => fillImage(W, H, () => [r, g, b]);
+function withSquare(base, x0, y0, size, [r, g, b]) {
+    const out = Uint8Array.from(base);
+    for (let y = y0; y < y0 + size; y++) for (let x = x0; x < x0 + size; x++) {
+        const i = (y * W + x) * 4;
+        out[i] = r; out[i + 1] = g; out[i + 2] = b;
+    }
+    return out;
+}
+
+// ── 手工组 PNG（验证解码器对滤波 1-4 的支持；encodePng 只产滤波 0） ──
+
+function paeth(a, b, c) {
+    const p = a + b - c, pa = Math.abs(p - a), pb = Math.abs(p - b), pc = Math.abs(p - c);
+    return pa <= pb && pa <= pc ? a : pb <= pc ? b : c;
+}
+const CRC_TABLE = (() => {
+    const t = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1; t[n] = c >>> 0; }
+    return t;
+})();
+const crc32 = (buf) => { let c = 0xffffffff; for (const b of buf) c = CRC_TABLE[(c ^ b) & 0xff] ^ (c >>> 8); return (c ^ 0xffffffff) >>> 0; };
+function chunk(type, data) {
+    const len = Buffer.alloc(4); len.writeUInt32BE(data.length);
+    const t = Buffer.from(type, 'ascii');
+    const crc = Buffer.alloc(4); crc.writeUInt32BE(crc32(Buffer.concat([t, data])));
+    return Buffer.concat([len, t, data, crc]);
+}
+/** raw RGBA + 每行滤波类型 → 合法 PNG Buffer（colorType 6, 8bit） */
+function craftPng(w, h, raw, filters) {
+    const bpp = 4, stride = w * bpp;
+    const body = Buffer.alloc((stride + 1) * h);
+    let prev = new Uint8Array(stride);
+    for (let y = 0; y < h; y++) {
+        const f = filters[y % filters.length];
+        body[y * (stride + 1)] = f;
+        for (let i = 0; i < stride; i++) {
+            const x = raw[y * stride + i];
+            const a = i >= bpp ? raw[y * stride + i - bpp] : 0;
+            const b = prev[i];
+            const c = i >= bpp ? prev[i - bpp] : 0;
+            let v;
+            if (f === 0) v = x;
+            else if (f === 1) v = x - a;
+            else if (f === 2) v = x - b;
+            else if (f === 3) v = x - ((a + b) >> 1);
+            else v = x - paeth(a, b, c);
+            body[y * (stride + 1) + 1 + i] = v & 0xff;
+        }
+        prev = raw.slice(y * stride, (y + 1) * stride);
+    }
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(w, 0); ihdr.writeUInt32BE(h, 4);
+    ihdr[8] = 8; ihdr[9] = 6;
+    return Buffer.concat([
+        Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+        chunk('IHDR', ihdr), chunk('IDAT', zlib.deflateSync(body)), chunk('IEND', Buffer.alloc(0)),
+    ]);
+}
+
+// ═══ 1. 编解码往返 ═══
+console.log('\n[1] pngCodec 往返');
+{
+    const img = solid(200, 30, 90);
+    const dec = decodePng(encodePng(W, H, img));
+    ok('RGBA 往返像素一致', Buffer.compare(Buffer.from(dec.data), Buffer.from(img)) === 0);
+    const rgb = fillImage(W, H, (x) => [x & 0xff, (x * 3) & 0xff, 7]); // 非纯色
+    const dec2 = decodePng(encodePng(W, H, rgb));
+    ok('非纯色往返像素一致', Buffer.compare(Buffer.from(dec2.data), Buffer.from(rgb)) === 0);
+    let threw = false;
+    try { decodePng(Buffer.from('not a png')); } catch { threw = true; }
+    ok('非 PNG 输入抛错', threw);
+}
+
+// ═══ 2. 滤波 1-4 解码 ═══
+console.log('\n[2] 解码器滤波支持（Playwright 截图会用任意滤波）');
+{
+    const raw = fillImage(W, H, (x, y) => [(x * 2) & 0xff, (y * 3) & 0xff, (x + y) & 0xff]);
+    const filters = [1, 2, 3, 4]; // Sub / Up / Average / Paeth 逐行轮换
+    const dec = decodePng(craftPng(W, H, raw, filters));
+    ok('滤波 1-4 混合解码像素一致', Buffer.compare(Buffer.from(dec.data), Buffer.from(raw)) === 0);
+}
+
+// ═══ 3-5. 基线生命周期 ═══
+const { createBaseline, compareWithBaseline, ScreenshotDiffError, beginGoalShotDiffCapture, drainGoalShotDiff, resolveBaselinePaths } = screenshotDiff;
+const KEY = 'step-24497';
+const baselinePng = () => encodePng(W, H, solid(200, 30, 90));
+const samePng = () => encodePng(W, H, solid(200, 30, 90));
+
+console.log('\n[3] 首跑：无基线 → baseline_required（候选基线落盘，不判通过）');
+let created;
+{
+    beginGoalShotDiffCapture();
+    created = createBaseline(KEY, baselinePng());
+    ok('status=baseline_required', created.status === 'baseline_required', `实际 ${created.status}`);
+    ok('diffRatio=null（无差异率可言）', created.diffRatio === null, `实际 ${created.diffRatio}`);
+    ok('基线文件已写盘', fs.existsSync(created.baselinePath));
+    const meta = JSON.parse(fs.readFileSync(created.baselinePath.replace(/\.png$/, '.json'), 'utf-8'));
+    ok('meta：v1 / candidate / first-run', meta.version === 1 && meta.state === 'candidate' && meta.sourceType === 'first-run');
+    const paths = resolveBaselinePaths(KEY, W, H);
+    ok('key+env+viewport 进基线文件名', paths.pngPath.endsWith(`step-24497.test.${W}x${H}.png`));
+}
+
+console.log('\n[4] 候选门控：未审核再跑 → 仍 baseline_required（不比对不判过 / A06）');
+{
+    const r = compareWithBaseline(KEY, samePng());
+    ok('status=baseline_required', r.status === 'baseline_required', `实际 ${r.status}`);
+    ok('diffRatio=null', r.diffRatio === null, `实际 ${r.diffRatio}`);
+    ok('基线版本未推进（v1）', r.baselineVersion === 1, `实际 v${r.baselineVersion}`);
+}
+
+console.log('\n[5] 模拟基线审核转正（meta.state candidate → active）');
+{
+    const metaPath = resolveBaselinePaths(KEY, W, H).metaPath;
+    const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+    meta.state = 'active';
+    fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2));
+    ok('meta.state 已置为 active', true);
+}
+
+console.log('\n[6] 转正后二跑 identical → matched');
+{
+    beginGoalShotDiffCapture();
+    const r = compareWithBaseline(KEY, samePng());
+    ok('status=matched', r.status === 'matched');
+    ok('message 含差异率与阈值', /差异率.*阈值/.test(r.message));
+    ok('基线状态 active', r.baselineState === 'active', `实际 ${r.baselineState}`);
+    const drained = drainGoalShotDiff();
+    ok('goal 缓冲收集到 1 条', drained.length === 1 && drained[0].status === 'matched');
+}
+
+console.log('\n[7] 超阈值 → ScreenshotDiffError（确定性 fail）');
+let diffResult;
+{
+    const changed = encodePng(W, H, withSquare(solid(200, 30, 90), 8, 8, 24, [20, 90, 230]));
+    beginGoalShotDiffCapture();
+    let threw = false;
+    try { compareWithBaseline(KEY, changed); } catch (e) {
+        threw = e instanceof ScreenshotDiffError;
+        diffResult = e.shotDiff;
+    }
+    ok('抛 ScreenshotDiffError', threw);
+    ok('status=exceeded 且携带差异结果', diffResult?.status === 'exceeded');
+    ok('差异区块 ≥1 且坐标在图内', (diffResult?.regions?.length ?? 0) >= 1
+        && diffResult.regions.every(rg => rg.x >= 0 && rg.y >= 0 && rg.x + rg.w <= W && rg.y + rg.h <= H));
+    ok('差异图已落盘', diffResult?.diffPath && fs.existsSync(diffResult.diffPath) && diffResult.diffPath !== diffResult.actualPath);
+    ok('diffRatio 在 (1, 100] 区间', diffResult?.diffRatio > 1 && diffResult.diffRatio <= 100);
+    const drained = drainGoalShotDiff();
+    ok('异常路径下 goal 缓冲仍收集到', drained.length === 1 && drained[0].status === 'exceeded');
+}
+
+console.log('\n[8] 掩码生效：差异区写进 meta.masks → matched');
+{
+    // 把 [5] 的主差异区写回 meta（模拟「忽略此区域」闭环）
+    const metaPath = resolveBaselinePaths(KEY, W, H).metaPath;
+    const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+    const rg = diffResult.regions[0];
+    meta.masks = [{ x: rg.x, y: rg.y, w: rg.w, h: rg.h }];
+    fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2));
+    const changed = encodePng(W, H, withSquare(solid(200, 30, 90), 8, 8, 24, [20, 90, 230]));
+    const r = compareWithBaseline(KEY, changed);
+    ok('掩码覆盖差异区后 matched', r.status === 'matched', `实际 status=${r.status} ratio=${r.diffRatio}`);
+}
+
+console.log('\n[9] 视口变化：同 key 其它视口基线存在 → size_mismatch（不自举，杜绝掩盖变化 / A20）');
+{
+    const other = encodePng(W, H + 16, fillImage(W, H + 16, () => [200, 30, 90]));
+    beginGoalShotDiffCapture();
+    const r = compareWithBaseline(KEY, other);
+    ok('不同视口 → size_mismatch', r.status === 'size_mismatch', `实际 ${r.status}`);
+    ok('diffRatio=null（无差异率可言）', r.diffRatio === null, `实际 ${r.diffRatio}`);
+    ok('未自举新视口基线（96x80 文件不存在）', !fs.existsSync(resolveBaselinePaths(KEY, W, H + 16).pngPath));
+    const drained = drainGoalShotDiff();
+    ok('goal 缓冲收集到 size_mismatch', drained.length === 1 && drained[0].status === 'size_mismatch');
+    // 原视口基线不受影响：同尺寸二跑仍 matched
+    const r2 = compareWithBaseline(KEY, samePng());
+    ok('原视口基线不受污染（仍 matched）', r2.status === 'matched');
+}
+
+console.log(`\n结果：${passed} 通过 / ${failed} 失败`);
+console.log(`（临时目录：${tmp}，验证后保留供人工查看）`);
+process.exit(failed ? 1 : 0);

package/dist/commands/auth-update.d.ts

@@ -1,16 +0,0 @@
-/**
- * keve auth-update - Update auth storage state (cookies/localStorage)
- *
- * Opens a browser for the user to manually log in, then saves the
- * storage state to `.auth/storage-state.json`.
- *
- * Usage:
- *   npx keve auth-update
- *   npx keve auth-update --url http://localhost:3000
- *   npx keve auth-update --config .keve/keve-test.config.ts
- */
-export interface AuthUpdateOptions {
-    url?: string;
-    config?: string;
-}
-export declare function authUpdate(options?: AuthUpdateOptions): Promise<void>;

package/dist/commands/auth-update.js

@@ -1,88 +0,0 @@
-"use strict";
-/**
- * keve auth-update - Update auth storage state (cookies/localStorage)
- *
- * Opens a browser for the user to manually log in, then saves the
- * storage state to `.auth/storage-state.json`.
- *
- * Usage:
- *   npx keve auth-update
- *   npx keve auth-update --url http://localhost:3000
- *   npx keve auth-update --config .keve/keve-test.config.ts
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.authUpdate = authUpdate;
-const chalk_1 = __importDefault(require("chalk"));
-const path = __importStar(require("path"));
-const auth_1 = require("../core/auth");
-async function authUpdate(options = {}) {
-    const targetUrl = options.url || process.env.PWGEN_TARGET_URL || 'http://localhost:3000';
-    const storageStatePath = path.resolve(process.cwd(), '.auth/storage-state.json');
-    console.log(chalk_1.default.cyan('\n  keve auth-update'));
-    console.log(chalk_1.default.gray(`  Target URL: ${targetUrl}`));
-    console.log(chalk_1.default.gray(`  Storage state: ${storageStatePath}`));
-    console.log(chalk_1.default.yellow('\n  Opening browser for manual login...'));
-    console.log(chalk_1.default.gray('  (Auto-save when you navigate away from login page)\n'));
-    const success = await (0, auth_1.acquireStorageState)({
-        targetUrl,
-        storageStatePath,
-        logPrefix: '  [keve auth-update]',
-        onLoginDetected: (url) => console.log(chalk_1.default.green(`  Login detected! URL: ${url}`)),
-        onStateSaved: (cookieCount, originCount) => {
-            console.log(chalk_1.default.green(`\n  ✓ Auth state saved`));
-            console.log(chalk_1.default.gray(`  Cookies: ${cookieCount}, localStorage origins: ${originCount}`));
-            if (cookieCount === 0) {
-                console.log(chalk_1.default.yellow('  ⚠ No cookies saved — login may not have completed.'));
-                console.log(chalk_1.default.yellow('  Try `npx keve auth-update` again.'));
-            }
-            else {
-                console.log(chalk_1.default.green('  ✓ Auth update complete! Run tests with: npx keve run'));
-            }
-        },
-        onError: (msg) => console.error(chalk_1.default.red(`  Error: ${msg}`)),
-        onBrowserFailed: (msg) => {
-            console.error(chalk_1.default.red(`  Cannot launch browser: ${msg}`));
-            console.error(chalk_1.default.yellow('  Ensure a display is available, or run in a local environment.'));
-        },
-    });
-    if (!success && !options.url) {
-        console.log(chalk_1.default.yellow('\n  Hint: Specify target URL if different from default:'));
-        console.log(chalk_1.default.yellow('  npx keve auth-update --url http://your-app-url'));
-    }
-}

package/dist/core/auth.d.ts

@@ -1,17 +0,0 @@
-/**
- * Auth utilities — acquire storage state for Playwright tests
- *
- * 1. Existing valid storage-state.json → skip
- * 2. CDP connect to user Chrome → reuse login state
- * 3. Manual browser login → fallback
- */
-export interface AcquireOptions {
-    targetUrl?: string;
-    storageStatePath?: string;
-    logPrefix?: string;
-    onLoginDetected?: (url: string) => void;
-    onStateSaved?: (cookieCount: number, originCount: number) => void;
-    onError?: (msg: string) => void;
-    onBrowserFailed?: (msg: string) => void;
-}
-export declare function acquireStorageState(options?: AcquireOptions): Promise<boolean>;

package/dist/core/auth.js

@@ -1,224 +0,0 @@
-"use strict";
-/**
- * Auth utilities — acquire storage state for Playwright tests
- *
- * 1. Existing valid storage-state.json → skip
- * 2. CDP connect to user Chrome → reuse login state
- * 3. Manual browser login → fallback
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.acquireStorageState = acquireStorageState;
-const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
-const path = __importStar(require("node:path"));
-const node_child_process_1 = require("node:child_process"); // getChromeWsUrl 需要用 lsof 检查端口
-const node_module_1 = require("node:module");
-// ─── Playwright Chromium resolver ───────────────────────────────────────────
-async function getChromium() {
-    const cwdRequire = (0, node_module_1.createRequire)(path.resolve(process.cwd(), 'node_modules'));
-    const pwAbsolutePath = cwdRequire.resolve('@playwright/test');
-    const pwModule = await Promise.resolve(`${pwAbsolutePath}`).then(s => __importStar(require(s)));
-    const chromium = pwModule.chromium || pwModule.default?.chromium;
-    if (!chromium)
-        throw new Error('Failed to resolve chromium from @playwright/test');
-    return chromium;
-}
-// ─── Chrome CDP helpers ─────────────────────────────────────────────────────
-function getChromeUserDataDir() {
-    const p = os.platform();
-    const h = os.homedir();
-    if (p === 'darwin')
-        return path.join(h, 'Library', 'Application Support', 'Google', 'Chrome');
-    if (p === 'win32')
-        return path.join(h, 'AppData', 'Local', 'Google', 'Chrome', 'User Data');
-    return path.join(h, '.config', 'google-chrome');
-}
-/** 读取 DevToolsActivePort 获取 CDP WebSocket URL（端口须正在监听） */
-function getChromeWsUrl() {
-    const portFile = path.join(getChromeUserDataDir(), 'DevToolsActivePort');
-    if (!fs.existsSync(portFile))
-        return null;
-    try {
-        const [portStr, wsPath] = fs.readFileSync(portFile, 'utf8').trim().split('\n').map(l => l.trim()).filter(Boolean);
-        const port = parseInt(portStr, 10);
-        if (!port || !wsPath)
-            return null;
-        try {
-            (0, node_child_process_1.execSync)(`lsof -P -i TCP:${port} 2>/dev/null | grep LISTEN`, { encoding: 'utf8' });
-        }
-        catch {
-            return null;
-        }
-        return `ws://127.0.0.1:${port}${wsPath}`;
-    }
-    catch {
-        return null;
-    }
-}
-/** CDP 连接用户 Chrome → 打开目标页 → 保存 storage-state → 断开
- *  仅连接已运行的 Chrome（keve run 已确保 Chrome 启动 + debug 端口就绪）
- */
-async function authViaCDP(targetUrl, storageStatePath, prefix) {
-    const wsUrl = getChromeWsUrl();
-    if (!wsUrl) {
-        console.log(`${prefix} Chrome CDP not available`);
-        return false;
-    }
-    console.log(`${prefix} Chrome CDP available, connecting...`);
-    try {
-        const chromium = await getChromium();
-        const browser = await chromium.connectOverCDP(wsUrl, { timeout: 10000 });
-        const context = browser.contexts()[0];
-        if (!context) {
-            browser.close();
-            return false;
-        }
-        // 访问目标页面，等登录重定向完成
-        const page = await context.newPage();
-        await page.goto(targetUrl, { waitUntil: 'networkidle', timeout: 60000 });
-        await waitForLoginRedirect(page);
-        const onLoginPage = /login|auth|signin/i.test(page.url());
-        if (onLoginPage) {
-            console.log(`${prefix} CDP connected but target requires login`);
-            await page.close();
-            browser.close();
-            return false;
-        }
-        // 保存 storage-state
-        const cookies = await context.cookies();
-        const state = { cookies, origins: [] };
-        fs.writeFileSync(storageStatePath, JSON.stringify(state, null, 2));
-        await page.close();
-        browser.close();
-        console.log(`${prefix} CDP auth success (${cookies.length} cookies) → ${storageStatePath}`);
-        return cookies.length > 0;
-    }
-    catch (e) {
-        console.warn(`${prefix} CDP connect failed: ${e.message}`);
-        return false;
-    }
-}
-function isStorageStateValid(statePath, targetDomain) {
-    if (!fs.existsSync(statePath))
-        return false;
-    try {
-        const s = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
-        if (!s.cookies?.length)
-            return false;
-        if (targetDomain && !s.cookies.some(c => c.domain?.includes(targetDomain)))
-            return false;
-        const now = Date.now() / 1000;
-        return s.cookies.some(c => !c.expires || c.expires === -1 || c.expires > now);
-    }
-    catch {
-        return false;
-    }
-}
-function extractDomain(url) {
-    try {
-        return new URL(url).hostname;
-    }
-    catch {
-        return undefined;
-    }
-}
-async function waitForLoginRedirect(page, maxMs = 30000) {
-    for (let i = 0; i < maxMs / 500; i++) {
-        if (!/login|auth|signin/i.test(page.url()))
-            break;
-        await page.waitForTimeout(500);
-    }
-    await page.waitForLoadState('networkidle', { timeout: 15000 }).catch(() => { });
-    return !/login|auth|signin|sign-in/i.test(page.url());
-}
-/** 手动登录 → 保存 storage-state */
-async function authViaManualLogin(targetUrl, storageStatePath, prefix) {
-    const loginUrl = targetUrl.replace(/\/?$/, '/login');
-    console.log(`${prefix} Opening browser for manual login: ${loginUrl}`);
-    console.log(`${prefix} Please login. Waiting up to 2 minutes...`);
-    try {
-        const browser = await (await getChromium()).launch({ headless: false });
-        const context = await browser.newContext();
-        const page = await context.newPage();
-        await page.goto(loginUrl, { waitUntil: 'domcontentloaded', timeout: 15000 })
-            .catch(() => page.goto(targetUrl, { waitUntil: 'domcontentloaded', timeout: 15000 }));
-        let loginDetected = false;
-        for (let i = 0; i < 120; i++) {
-            if (!/login|auth|signin|sign-in/i.test(page.url())) {
-                loginDetected = true;
-                break;
-            }
-            await page.waitForTimeout(1000);
-        }
-        if (!loginDetected)
-            console.log(`${prefix} Timeout (2min), saving current state...`);
-        await waitForLoginRedirect(page);
-        await context.storageState({ path: storageStatePath });
-        const c = JSON.parse(fs.readFileSync(storageStatePath, 'utf-8')).cookies?.length || 0;
-        console.log(`${prefix} Auth saved (${c} cookies) → ${storageStatePath}`);
-        await browser.close();
-        return c > 0;
-    }
-    catch (e) {
-        console.error(`${prefix} Manual login error: ${e.message}`);
-        return false;
-    }
-}
-async function acquireStorageState(options = {}) {
-    const targetUrl = options.targetUrl || process.env.PWGEN_TARGET_URL || 'http://localhost:3000';
-    const storageStatePath = options.storageStatePath || path.resolve(process.cwd(), '.auth/storage-state.json');
-    const prefix = options.logPrefix || '[keve]';
-    const targetDomain = extractDomain(targetUrl);
-    const authDir = path.dirname(storageStatePath);
-    if (!fs.existsSync(authDir))
-        fs.mkdirSync(authDir, { recursive: true });
-    // Skip mode
-    if (process.env.PWGEN_SKIP_AUTH === '1' || process.env.PWGEN_SKIP_AUTH === 'true') {
-        fs.writeFileSync(storageStatePath, JSON.stringify({ cookies: [], origins: [] }, null, 2));
-        console.log(`${prefix} PWGEN_SKIP_AUTH=1 → empty storage state saved`);
-        return true;
-    }
-    // Step 1: 已有有效 storage-state
-    if (isStorageStateValid(storageStatePath, targetDomain)) {
-        console.log(`${prefix} Storage state valid → ${storageStatePath}`);
-        return true;
-    }
-    // Step 2: CDP 连接用户 Chrome
-    if (await authViaCDP(targetUrl, storageStatePath, prefix))
-        return true;
-    // Step 3: 手动登录
-    return await authViaManualLogin(targetUrl, storageStatePath, prefix);
-}

package/dist/core/cdp-resolver.d.ts

@@ -1,5 +0,0 @@
-export interface CdpResolverOptions {
-    endpoint?: string;
-    wsEndpoint?: string;
-}
-export declare function resolveCdpWsUrl(options: CdpResolverOptions): Promise<string | null>;