@flash-ai-team/flash-test-framework 0.0.12 → 0.0.13

package/dist/cli/index.js

@@ -6,6 +6,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
 const args = process.argv.slice(2);
 const command = args[0];
 if (command === 'init') {
@@ -15,8 +16,13 @@ if (command === 'init') {
 else if (command === '--version' || command === '-v') {
     printVersion();
 }
+else if (command === 'history') {
+    const suiteName = args[1];
+    showHistory(suiteName);
+}
 else {
     console.log('Usage: flash-test init [project-name]');
+    console.log('       flash-test history [suite-name]');
     console.log('       flash-test -v / --version');
     process.exit(1);
 }
@@ -149,3 +155,184 @@ function createFile(filePath, content) {
         console.log(`Created: ${path_1.default.basename(filePath)}`);
     }
 }
+function showHistory(suiteFilter) {
+    const reportsDir = path_1.default.join(process.cwd(), 'reports');
+    if (!fs_1.default.existsSync(reportsDir)) {
+        console.log('No reports found.');
+        return;
+    }
+    let runs = [];
+    const suites = suiteFilter ? [suiteFilter] : fs_1.default.readdirSync(reportsDir).filter(f => fs_1.default.statSync(path_1.default.join(reportsDir, f)).isDirectory());
+    for (const suite of suites) {
+        const suitePath = path_1.default.join(reportsDir, suite);
+        if (!fs_1.default.existsSync(suitePath))
+            continue;
+        const testRuns = fs_1.default.readdirSync(suitePath).filter(f => f.startsWith('test_') && fs_1.default.statSync(path_1.default.join(suitePath, f)).isDirectory());
+        for (const run of testRuns) {
+            const runPath = path_1.default.join(suitePath, run);
+            let status = 'Unknown';
+            let duration = 0;
+            let total = 0;
+            let passed = 0;
+            let failed = 0;
+            // Try to read custom-report.json for details
+            const jsonPath = path_1.default.join(runPath, 'custom-report.json');
+            if (fs_1.default.existsSync(jsonPath)) {
+                try {
+                    const data = JSON.parse(fs_1.default.readFileSync(jsonPath, 'utf-8'));
+                    if (Array.isArray(data)) {
+                        total = data.length;
+                        passed = data.filter((t) => t.status === 'passed').length;
+                        failed = data.filter((t) => t.status === 'failed' || t.status === 'timedOut').length;
+                        // Sum duration or max? Let's use sum for now as a simple metric
+                        duration = data.reduce((acc, curr) => acc + (curr.duration || 0), 0);
+                        status = failed > 0 ? 'Failed' : (passed === total && total > 0 ? 'Passed' : 'Mixed');
+                    }
+                    else if (data.stats) {
+                        // Legacy support if needed
+                        duration = data.stats.duration;
+                        total = data.stats.total;
+                        passed = data.stats.passed;
+                        failed = data.stats.failed;
+                        status = failed > 0 ? 'Failed' : (passed === total && total > 0 ? 'Passed' : 'Mixed');
+                    }
+                }
+                catch (e) { /* ignore */ }
+            }
+            // Extract timestamp from folder name test_YYYY-MM-DD_HHmmss
+            const timePart = run.replace('test_', '');
+            // Format for display: YYYY-MM-DD HH:mm:ss
+            const formattedTime = timePart.replace('_', ' ').replace(/(\d{4}-\d{2}-\d{2}) (\d{2})(\d{2})(\d{2})/, '$1 $2:$3:$4');
+            runs.push({
+                suite,
+                runFolder: run,
+                timestamp: formattedTime,
+                rawTimestamp: timePart,
+                path: runPath,
+                status,
+                duration,
+                passed,
+                failed,
+                total
+            });
+        }
+    }
+    // Sort by newest first
+    runs.sort((a, b) => b.rawTimestamp.localeCompare(a.rawTimestamp));
+    // Console Output
+    console.table(runs.map(r => ({
+        Suite: r.suite,
+        Timestamp: r.timestamp,
+        Status: r.status,
+        Passed: r.passed,
+        Failed: r.failed,
+        Duration: `${(r.duration / 1000).toFixed(2)}s`
+    })));
+    // Generate HTML Dashboard
+    generateHistoryHtml(runs, reportsDir);
+}
+function generateHistoryHtml(runs, reportsDir) {
+    const htmlPath = path_1.default.join(reportsDir, 'history.html');
+    // Group by Stats
+    const totalRuns = runs.length;
+    const passedRuns = runs.filter(r => r.status === 'Passed').length;
+    const failedRuns = runs.filter(r => r.status === 'Failed').length;
+    const rows = runs.map(r => {
+        const statusClass = r.status === 'Passed' ? 'passed' : (r.status === 'Failed' ? 'failed' : 'mixed');
+        // Relative path from reports/history.html to reports/suite/run/report.html
+        const reportLink = `${r.suite}/${r.runFolder}/report.html`;
+        return `
+            <tr>
+                <td>${r.timestamp}</td>
+                <td><span class="suite-badge">${r.suite}</span></td>
+                <td><span class="status-badge status-${statusClass}">${r.status}</span></td>
+                <td>${r.passed} / ${r.total}</td>
+                <td>${(r.duration / 1000).toFixed(2)}s</td>
+                <td><a href="${reportLink}" target="_blank" class="view-btn">View Report</a></td>
+            </tr>
+        `;
+    }).join('');
+    const html = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Test Run History</title>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Arial, sans-serif; background: #f4f4f4; padding: 20px; color: #333; }
+        .container { max-width: 1000px; margin: 0 auto; background: white; padding: 30px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.05); }
+        h1 { margin-top: 0; border-bottom: 2px solid #eee; padding-bottom: 15px; }
+        
+        .stats-grid { display: flex; gap: 20px; margin-bottom: 30px; }
+        .stat-card { flex: 1; background: #fafafa; padding: 15px; border-radius: 6px; text-align: center; border: 1px solid #eee; }
+        .stat-value { font-size: 2em; font-weight: bold; display: block; }
+        .stat-label { color: #666; font-size: 0.9em; text-transform: uppercase; letter-spacing: 1px; }
+        .stat-passed .stat-value { color: #4caf50; }
+        .stat-failed .stat-value { color: #f44336; }
+
+        table { width: 100%; border-collapse: collapse; margin-top: 20px; }
+        th, td { padding: 12px 15px; text-align: left; border-bottom: 1px solid #eee; }
+        th { background: #f8f8f8; font-weight: 600; color: #555; }
+        tr:hover { background: #fcfcfc; }
+        
+        .status-badge { padding: 4px 8px; border-radius: 4px; font-size: 0.85em; font-weight: 600; }
+        .status-passed { background: #e8f5e9; color: #2e7d32; }
+        .status-failed { background: #ffebee; color: #c62828; }
+        .status-mixed { background: #fff3e0; color: #ef6c00; }
+        
+        .suite-badge { background: #e3f2fd; color: #1565c0; padding: 2px 6px; border-radius: 4px; font-size: 0.9em; }
+        
+        .view-btn { text-decoration: none; background: #333; color: white; padding: 6px 12px; border-radius: 4px; font-size: 0.9em; transition: background 0.2s; }
+        .view-btn:hover { background: #555; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>📜 Test Run History</h1>
+        
+        <div class="stats-grid">
+            <div class="stat-card">
+                <span class="stat-value">${totalRuns}</span>
+                <span class="stat-label">Total Runs</span>
+            </div>
+            <div class="stat-card stat-passed">
+                <span class="stat-value">${passedRuns}</span>
+                <span class="stat-label">Passed</span>
+            </div>
+            <div class="stat-card stat-failed">
+                <span class="stat-value">${failedRuns}</span>
+                <span class="stat-label">Failed</span>
+            </div>
+        </div>
+
+        <table>
+            <thead>
+                <tr>
+                    <th>Timestamp</th>
+                    <th>Suite</th>
+                    <th>Status</th>
+                    <th>Pass / Total</th>
+                    <th>Duration</th>
+                    <th>Action</th>
+                </tr>
+            </thead>
+            <tbody>
+                ${rows}
+            </tbody>
+        </table>
+    </div>
+</body>
+</html>
+    `;
+    fs_1.default.writeFileSync(htmlPath, html);
+    console.log(`\nHistory Dashboard generated: ${htmlPath}`);
+    // Open in browser
+    try {
+        const startCmd = process.platform === 'win32' ? 'start' : (process.platform === 'darwin' ? 'open' : 'xdg-open');
+        (0, child_process_1.execSync)(`${startCmd} "${htmlPath}"`);
+    }
+    catch (e) {
+        console.log('Could not auto-open browser. Please open the file manually.');
+    }
+}

package/dist/core/Keyword.d.ts

@@ -1,10 +1,5 @@
 import { Page, TestInfo } from '@playwright/test';
 export declare const KeywordRegistry: Record<string, Function>;
-/**
- * Decorator to register a function as a Keyword and wrap it in a Playwright Step
- * Supports both Stage 3 (Standard) and Stage 2 (Legacy/Experimental) decorators.
- * @param name Custom name for the keyword (optional)
- */
 export declare function Keyword(name?: string): (targetOrValue: any, contextOrKey: any, descriptor?: PropertyDescriptor) => any;
 /**
  * Context holder to share Page and TestInfo across keywords

package/dist/core/Keyword.js

@@ -33,6 +33,16 @@ function formatArg(arg) {
  * Supports both Stage 3 (Standard) and Stage 2 (Legacy/Experimental) decorators.
  * @param name Custom name for the keyword (optional)
  */
+// Helper to check for options object
+function extractDescription(args) {
+    if (args.length > 0) {
+        const lastArg = args[args.length - 1];
+        if (lastArg && typeof lastArg === 'object' && 'description' in lastArg && typeof lastArg.description === 'string') {
+            return lastArg.description;
+        }
+    }
+    return undefined;
+}
 function Keyword(name) {
     return function (targetOrValue, contextOrKey, descriptor) {
         // Stage 3: (value, context) where context is an object
@@ -43,8 +53,14 @@ function Keyword(name) {
             // Registry
             exports.KeywordRegistry[keywordName] = originalMethod;
             return async function (...args) {
-                const argString = args.map(formatArg).join(', ');
-                const stepName = argString ? `${keywordName} (${argString})` : keywordName;
+                const customDescription = extractDescription(args);
+                // Filter out the options object from display args if it was used for description
+                const displayArgs = customDescription ? args.slice(0, -1) : args;
+                const argString = displayArgs.map(formatArg).join(', ');
+                let stepName = argString ? `${keywordName} (${argString})` : keywordName;
+                if (customDescription) {
+                    stepName = customDescription;
+                }
                 return await test_1.test.step(stepName, async () => {
                     return await originalMethod.apply(this, args);
                 });
@@ -60,8 +76,14 @@ function Keyword(name) {
             const originalMethod = legacyDescriptor.value;
             const keywordName = name || contextOrKey;
             legacyDescriptor.value = async function (...args) {
-                const argString = args.map(formatArg).join(', ');
-                const stepName = argString ? `${keywordName} (${argString})` : keywordName;
+                const customDescription = extractDescription(args);
+                // Filter out the options object from display args if it was used for description
+                const displayArgs = customDescription ? args.slice(0, -1) : args;
+                const argString = displayArgs.map(formatArg).join(', ');
+                let stepName = argString ? `${keywordName} (${argString})` : keywordName;
+                if (customDescription) {
+                    stepName = customDescription;
+                }
                 return await test_1.test.step(stepName, async () => {
                     return await originalMethod.apply(this, args);
                 });

package/dist/keywords/WebUI.d.ts

@@ -6,66 +6,91 @@ export declare class Web {
      * Navigates to the specified URL.
      * @param url - The URL to navigate to.
      */
-    static navigateToUrl(url: string): Promise<void>;
+    static navigateToUrl(url: string, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Verifies that the current page URL matches the expected URL.
      * @param url - The expected URL.
      * @param timeout - The maximum time to wait in milliseconds (default: 5000).
      */
-    static verifyUrl(url: string, timeout?: number): Promise<void>;
+    static verifyUrl(url: string, timeout?: number, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Clicks on the specified element.
      * @param to - The TestObject representing the element.
+     * @param options - Optional parameters (description).
      */
-    static click(to: TestObject): Promise<void>;
+    static click(to: TestObject, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Sets the text of an input element.
      * @param to - The TestObject representing the input element.
      * @param text - The text to set.
      */
-    static setText(to: TestObject, text: string): Promise<void>;
+    static setText(to: TestObject, text: string, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Searches for the specified text using heuristic selectors.
      * @param text - The text to search for.
      */
-    static search(text: string): Promise<void>;
+    static search(text: string, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Verifies that the specified element is present (visible) on the page.
      * @param to - The TestObject representing the element.
      * @param timeout - The maximum time to wait in milliseconds (default: 5000).
      */
-    static verifyElementPresent(to: TestObject, timeout?: number): Promise<void>;
+    static verifyElementPresent(to: TestObject, timeout?: number, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Gets the visible text of the specified element.
      * @param to - The TestObject representing the element.
      * @returns The text content of the element.
      */
-    static getText(to: TestObject): Promise<string>;
+    static getText(to: TestObject, options?: {
+        description?: string;
+    }): Promise<string>;
     /**
      * Closes the current browser context/page.
      */
-    static closeBrowser(): Promise<void>;
+    static closeBrowser(options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Double clicks on the specified element.
      * @param to - The TestObject representing the element.
      */
-    static doubleClick(to: TestObject): Promise<void>;
+    static doubleClick(to: TestObject, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Right clicks (context click) on the specified element.
      * @param to - The TestObject representing the element.
      */
-    static rightClick(to: TestObject): Promise<void>;
+    static rightClick(to: TestObject, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Hovers over the specified element.
      * @param to - The TestObject representing the element.
      */
-    static mouseOver(to: TestObject): Promise<void>;
+    static mouseOver(to: TestObject, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Drags the source element and drops it onto the target element.
      * @param source - The TestObject representing the source element.
      * @param target - The TestObject representing the target element.
      */
-    static dragAndDrop(source: TestObject, target: TestObject): Promise<void>;
+    static dragAndDrop(source: TestObject, target: TestObject, options?: {
+        description?: string;
+    }): Promise<void>;
     /**
      * Checks (selects) the specified checkbox or radio button.
      * @param to - The TestObject representing the element.

package/dist/keywords/WebUI.js

@@ -28,7 +28,7 @@ class Web {
      * Navigates to the specified URL.
      * @param url - The URL to navigate to.
      */
-    static async navigateToUrl(url) {
+    static async navigateToUrl(url, options) {
         await this.page.goto(url);
     }
     /**
@@ -36,14 +36,15 @@ class Web {
      * @param url - The expected URL.
      * @param timeout - The maximum time to wait in milliseconds (default: 5000).
      */
-    static async verifyUrl(url, timeout = 5000) {
+    static async verifyUrl(url, timeout = 5000, options) {
         await (0, test_1.expect)(this.page).toHaveURL(url, { timeout });
     }
     /**
      * Clicks on the specified element.
      * @param to - The TestObject representing the element.
+     * @param options - Optional parameters (description).
      */
-    static async click(to) {
+    static async click(to, options) {
         await this.getLocator(to).click();
     }
     /**
@@ -51,14 +52,14 @@ class Web {
      * @param to - The TestObject representing the input element.
      * @param text - The text to set.
      */
-    static async setText(to, text) {
+    static async setText(to, text, options) {
         await this.getLocator(to).fill(text);
     }
     /**
      * Searches for the specified text using heuristic selectors.
      * @param text - The text to search for.
      */
-    static async search(text) {
+    static async search(text, options) {
         // Common search input selectors
         const selectors = [
             'input[name="q"]',
@@ -78,7 +79,7 @@ class Web {
      * @param to - The TestObject representing the element.
      * @param timeout - The maximum time to wait in milliseconds (default: 5000).
      */
-    static async verifyElementPresent(to, timeout = 5000) {
+    static async verifyElementPresent(to, timeout = 5000, options) {
         await (0, test_1.expect)(this.getLocator(to)).toBeVisible({ timeout });
     }
     /**
@@ -86,13 +87,13 @@ class Web {
      * @param to - The TestObject representing the element.
      * @returns The text content of the element.
      */
-    static async getText(to) {
+    static async getText(to, options) {
         return await this.getLocator(to).innerText();
     }
     /**
      * Closes the current browser context/page.
      */
-    static async closeBrowser() {
+    static async closeBrowser(options) {
         await this.page.close();
     }
     // --- Interaction Keywords ---
@@ -100,21 +101,21 @@ class Web {
      * Double clicks on the specified element.
      * @param to - The TestObject representing the element.
      */
-    static async doubleClick(to) {
+    static async doubleClick(to, options) {
         await this.getLocator(to).dblclick();
     }
     /**
      * Right clicks (context click) on the specified element.
      * @param to - The TestObject representing the element.
      */
-    static async rightClick(to) {
+    static async rightClick(to, options) {
         await this.getLocator(to).click({ button: 'right' });
     }
     /**
      * Hovers over the specified element.
      * @param to - The TestObject representing the element.
      */
-    static async mouseOver(to) {
+    static async mouseOver(to, options) {
         await this.getLocator(to).hover();
     }
     /**
@@ -122,7 +123,7 @@ class Web {
      * @param source - The TestObject representing the source element.
      * @param target - The TestObject representing the target element.
      */
-    static async dragAndDrop(source, target) {
+    static async dragAndDrop(source, target, options) {
         await this.getLocator(source).dragTo(this.getLocator(target));
     }
     /**
@@ -391,73 +392,73 @@ exports.Web = Web;
 __decorate([
     (0, Keyword_1.Keyword)("Navigate To Url"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
+    __metadata("design:paramtypes", [String, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "navigateToUrl", null);
 __decorate([
     (0, Keyword_1.Keyword)("Verify Url"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Number]),
+    __metadata("design:paramtypes", [String, Number, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "verifyUrl", null);
 __decorate([
     (0, Keyword_1.Keyword)("Click"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "click", null);
 __decorate([
     (0, Keyword_1.Keyword)("Set Text"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, String]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, String, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "setText", null);
 __decorate([
     (0, Keyword_1.Keyword)("Search"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
+    __metadata("design:paramtypes", [String, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "search", null);
 __decorate([
     (0, Keyword_1.Keyword)("Verify Element Present"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Number]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Number, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "verifyElementPresent", null);
 __decorate([
     (0, Keyword_1.Keyword)("Get Text"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "getText", null);
 __decorate([
     (0, Keyword_1.Keyword)("Close Browser"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
+    __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], Web, "closeBrowser", null);
 __decorate([
     (0, Keyword_1.Keyword)("Double Click"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "doubleClick", null);
 __decorate([
     (0, Keyword_1.Keyword)("Right Click"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "rightClick", null);
 __decorate([
     (0, Keyword_1.Keyword)("Mouse Over"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "mouseOver", null);
 __decorate([
     (0, Keyword_1.Keyword)("Drag And Drop"),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, ObjectRepository_1.TestObject]),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, ObjectRepository_1.TestObject, Object]),
     __metadata("design:returntype", Promise)
 ], Web, "dragAndDrop", null);
 __decorate([

package/dist/reporting/HtmlReporter.d.ts

@@ -2,6 +2,7 @@ import { Reporter, FullConfig, Suite, TestCase, TestResult, FullResult } from '@
 declare class HtmlReporter implements Reporter {
     private suiteStartTime;
     private reportPath;
+    private envInfo;
     private fileCache;
     onBegin(config: FullConfig, suite: Suite): void;
     onEnd(result: FullResult): Promise<void>;

package/dist/reporting/HtmlReporter.js

@@ -35,11 +35,13 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const os = __importStar(require("os"));
 const ReporterUtils_1 = require("./ReporterUtils");
 class HtmlReporter {
     constructor() {
         this.suiteStartTime = 0;
         this.reportPath = '';
+        this.envInfo = { user: 'Unknown', os: 'Unknown', ip: 'Unknown' };
         // Cache for file contents to avoid repeated reads
         this.fileCache = new Map();
         // onExit removed as generation is now in onEnd
@@ -49,6 +51,31 @@ class HtmlReporter {
         this.suiteStartTime = Date.now();
         const folder = (0, ReporterUtils_1.getReportFolder)(suite);
         this.reportPath = path.join(folder, 'report.html');
+        // Collect Env Info
+        try {
+            const userInfo = os.userInfo();
+            this.envInfo.user = userInfo.username;
+        }
+        catch (e) { /* ignore */ }
+        try {
+            this.envInfo.os = `${os.type()} ${os.release()} (${os.platform()})`;
+        }
+        catch (e) { /* ignore */ }
+        try {
+            const nets = os.networkInterfaces();
+            for (const name of Object.keys(nets)) {
+                for (const net of nets[name]) {
+                    // Skip internal and non-IPv4 addresses
+                    if (net.family === 'IPv4' && !net.internal) {
+                        this.envInfo.ip = net.address;
+                        break;
+                    }
+                }
+                if (this.envInfo.ip !== 'Unknown')
+                    break;
+            }
+        }
+        catch (e) { /* ignore */ }
     }
     async onEnd(result) {
         if (!this.reportPath)
@@ -542,6 +569,15 @@ class HtmlReporter {
                             </div>
                         </div>
 
+                        <div style="margin-top:15px; font-size:0.8em; color:#666; text-align:center" id="reportTimestamp"></div>
+
+                        <!-- Environment Info -->
+                        <div style="margin-top:15px; padding:15px; background-color:#2a2d2e; border-top:1px solid var(--border-color); font-size:0.85em; color:#bbb">
+                            <div style="margin-bottom:5px"><strong style="color:#888">User:</strong> <span id="envUser">...</span></div>
+                            <div style="margin-bottom:5px"><strong style="color:#888">OS:</strong> <span id="envOs">...</span></div>
+                            <div><strong style="color:#888">IP:</strong> <span id="envIp">...</span></div>
+                        </div>
+
                         <div class="filter-group">
                             <button class="filter-btn active" onclick="setFilter('all')">All</button>
                             <button class="filter-btn" onclick="setFilter('failed')">Failures</button>
@@ -563,9 +599,21 @@ class HtmlReporter {
 
                 <script>
                     const data = ${resultsData};
+                    const startTime = ${this.suiteStartTime};
+                    const envInfo = ${JSON.stringify(this.envInfo)};
                     let currentId = null;
                     let currentFilter = 'all';
 
+                    // Set local timestamp
+                    document.getElementById('reportTimestamp').textContent = new Date(startTime).toLocaleString();
+
+                    // Set Env Info
+                    if (envInfo) {
+                        document.getElementById('envUser').textContent = envInfo.user;
+                        document.getElementById('envOs').textContent = envInfo.os;
+                        document.getElementById('envIp').textContent = envInfo.ip;
+                    }
+
                     function setFilter(filter) {
                         currentFilter = filter;
                         // Update buttons

package/dist/reporting/ReporterUtils.js

@@ -39,15 +39,26 @@ exports.resetReportFolderCache = resetReportFolderCache;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 let cachedReportFolder = null;
+// Helper to get local YYYY-MM-DD_HHmmss timestamp
+function getLocalTimestamp() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day}_${hours}${minutes}${seconds}`;
+}
 function generateReportPath(baseDir = 'reports', prefix = 'test') {
-    const timestamp = new Date().toISOString().replace(/T/, '_').replace(/:/g, '').split('.')[0];
+    const timestamp = getLocalTimestamp();
     return path.join(process.cwd(), baseDir, `${prefix}_${timestamp}`);
 }
 function getReportFolder(suite) {
     if (cachedReportFolder) {
         return cachedReportFolder;
     }
-    const timestamp = new Date().toISOString().replace(/T/, '_').replace(/:/g, '').split('.')[0];
+    const timestamp = getLocalTimestamp();
     // Find the first test file suite
     let suiteName = 'TestRun';
     if (suite.suites.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flash-ai-team/flash-test-framework",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "A powerful keyword-driven automation framework built on top of Playwright and TypeScript.",
   "keywords": [
     "playwright",