explorbot 0.1.8 → 0.1.10

package/src/reporter.ts

@@ -3,6 +3,8 @@ import { Client } from '@testomatio/reporter';
 import type { Step } from '@testomatio/reporter/types/types.js';
 import { ConfigParser, outputPath } from './config.js';
 import type { ReporterConfig } from './config.js';
+import type { StateManager } from './state-manager.js';
+import { Stats } from './stats.js';
 import { Test } from './test-plan.js';
 import { createDebug } from './utils/logger.js';
 
@@ -18,22 +20,33 @@ export interface ReporterStep {
 }
 
 export class Reporter {
-  private client: Client;
+  private client!: Client;
   private isRunStarted = false;
   private reporterEnabled: boolean;
+  private stateManager?: StateManager;
 
-  constructor(config?: ReporterConfig) {
+  constructor(config?: ReporterConfig, stateManager?: StateManager) {
     this.reporterEnabled = Reporter.resolveEnabled(config);
+    this.stateManager = stateManager;
 
     if (this.reporterEnabled && (!process.env.TESTOMATIO || config?.html)) {
       this.configureHtmlPipe();
     }
 
-    this.client = new Client({ apiKey: process.env.TESTOMATIO || '' });
     const pipe = process.env.TESTOMATIO && config?.html ? 'both' : process.env.TESTOMATIO ? 'testomatio' : 'html';
     debugLog('Reporter initialized', { enabled: this.reporterEnabled, pipe });
   }
 
+  private buildTitle(): string {
+    if (process.env.TESTOMATIO_TITLE) return process.env.TESTOMATIO_TITLE;
+    const url = this.stateManager?.getCurrentState()?.url;
+    const parts = ['Explorbot session'];
+    if (url) parts.push(url);
+    if (Stats.focus) parts.push(`focus: "${Stats.focus}"`);
+    parts.push(`at ${new Date().toISOString().slice(0, 16)}`);
+    return parts.join(' ');
+  }
+
   static resolveEnabled(config?: ReporterConfig): boolean {
     if (config?.enabled === true) return true;
     if (config?.enabled === false) return false;
@@ -56,6 +69,7 @@ export class Reporter {
     }
 
     try {
+      this.client = new Client({ apiKey: process.env.TESTOMATIO || '', title: this.buildTitle() });
       const timeoutMs = Number(process.env.TESTOMATIO_TIMEOUT_MS || '15000');
       const timeoutPromise = new Promise<'timeout'>((resolve) => setTimeout(() => resolve('timeout'), timeoutMs));
 

package/src/stats.ts

@@ -4,11 +4,15 @@ interface TokenUsage {
   total: number;
 }
 
+export type ExplorbotMode = 'explore' | 'test' | 'freesail' | 'tui';
+
 export class Stats {
   static startTime = Date.now();
   static researches = 0;
   static tests = 0;
   static plans = 0;
+  static mode?: ExplorbotMode;
+  static focus?: string;
   static models: Record<string, TokenUsage> = {};
 
   static recordTokens(_agent: string, model: string, usage: TokenUsage): void {

package/src/suite.ts

@@ -3,8 +3,8 @@ import path from 'node:path';
 import { Reflection } from '@codeceptjs/reflection';
 import { ConfigParser } from './config.ts';
 import { normalizeUrl } from './state-manager.ts';
-import { parsePlanFromMarkdown } from './utils/test-plan-markdown.ts';
 import { createDebug } from './utils/logger.ts';
+import { parsePlanFromMarkdown } from './utils/test-plan-markdown.ts';
 
 const debugLog = createDebug('explorbot:suite');
 

package/src/utils/error-page.ts

@@ -21,3 +21,13 @@ export function isErrorPage(actionResult: ActionResult): boolean {
 
   return false;
 }
+
+export class ErrorPageError extends Error {
+  constructor(
+    public readonly url: string,
+    public readonly title?: string
+  ) {
+    super(`Error page detected at ${url}${title ? ` (${title})` : ''}`);
+    this.name = 'ErrorPageError';
+  }
+}

package/src/utils/logger.ts

@@ -5,9 +5,9 @@ import chalk from 'chalk';
 import debug from 'debug';
 import dedent from 'dedent';
 import { marked } from 'marked';
+import stripAnsi from 'strip-ansi';
 import { ConfigParser } from '../config.js';
 import { Observability } from '../observability.ts';
-import stripAnsi from 'strip-ansi';
 import { parseMarkdownToTerminal } from './markdown-terminal.ts';
 
 export type LogType = 'info' | 'success' | 'error' | 'warning' | 'debug' | 'substep' | 'step' | 'multiline' | 'html' | 'input';

package/src/utils/rules-loader.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import { basename, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { tag } from './logger.ts';

package/src/utils/test-files.ts

@@ -3,9 +3,9 @@ import path from 'node:path';
 import chalk from 'chalk';
 import { highlight } from 'cli-highlight';
 import * as codeceptjs from 'codeceptjs';
-import store from 'codeceptjs/lib/store';
 import stepsListener from 'codeceptjs/lib/listener/steps';
 import storeListener from 'codeceptjs/lib/listener/store';
+import store from 'codeceptjs/lib/store';
 import figureSet from 'figures';
 import { ConfigParser } from '../config.ts';
 

package/src/utils/url-matcher.ts

@@ -1,4 +1,47 @@
 import micromatch from 'micromatch';
+import { ConfigParser } from '../config.js';
+
+export function isDynamicSegment(segment: string): boolean {
+  try {
+    const configRegex = ConfigParser.getInstance().getConfig().dynamicPageRegex;
+    if (configRegex) return new RegExp(configRegex, 'i').test(segment);
+  } catch {
+    /* config not loaded yet */
+  }
+
+  // numeric: /users/123
+  if (/^\d+$/.test(segment)) return true;
+  // UUID: /items/550e8400-e29b-41d4-a716-446655440000
+  if (/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(segment)) return true;
+  // ULID: /items/01ARZ3NDEKTSV4RRFFQ69G5FAV
+  if (/^[0-9A-HJKMNP-TV-Z]{26}$/.test(segment)) return true;
+  // hex ID (4+ chars): /suite/70dae98a
+  if (/^[a-f0-9]{4,}$/i.test(segment)) return true;
+  // hex-prefixed slug (8+ hex before dash): /suite/95ef0c94-mobile
+  if (/^[a-f0-9]{8,}-/i.test(segment)) return true;
+  // short mixed alphanumeric (digits + letters, ≤8 chars, no dash): /item/x7f2
+  if (segment.length <= 8 && !segment.includes('-') && /\d/.test(segment) && /[a-z]/i.test(segment)) return true;
+  return false;
+}
+
+export function hasDynamicUrlSegment(url: string): boolean {
+  return url.split('/').some((seg) => seg.length > 0 && isDynamicSegment(seg));
+}
+
+export function generalizeSegment(segment: string): string {
+  if (/^\d+$/.test(segment)) return '\\d+';
+  if (/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(segment)) return '[a-f0-9-]+';
+  if (/^[0-9A-HJKMNP-TV-Z]{26}$/.test(segment)) return '[0-9A-HJKMNP-TV-Z]+';
+  if (/^[a-f0-9]+$/i.test(segment)) return '[a-f0-9]+';
+  return '[^/]+';
+}
+
+export function generalizeUrl(url: string): string {
+  return url
+    .split('/')
+    .map((seg) => (seg.length > 0 && isDynamicSegment(seg) ? generalizeSegment(seg) : seg))
+    .join('/');
+}
 
 export function matchesUrl(pattern: string, path: string): boolean {
   if (pattern === '*') return true;