explorbot 0.1.6 → 0.1.8

package/bin/explorbot-cli.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import chalk from 'chalk';
 import { Command } from 'commander';
 import figureSet from 'figures';
@@ -20,7 +21,13 @@ import { parseMarkdownToTerminal } from '../src/utils/markdown-terminal.js';
 const program = new Command();
 const cli = getCliName();
 
-program.name(cli).description('AI-powered web exploration tool');
+const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../package.json');
+const pkgVersion = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version as string;
+
+program.name(cli).description('AI-powered web exploration tool').version(pkgVersion, '-V, --version');
+program.hook('preAction', () => {
+  console.log(chalk.dim(`${cli} v${pkgVersion}`));
+});
 
 interface CLIOptions {
   verbose?: boolean;
@@ -113,7 +120,7 @@ addCommonOptions(program.command('start [path]').description('Start web explorat
   await startTUI(explorBot);
 });
 
-addCommonOptions(program.command('explore <path>').description('Explore a page autonomously and run invented scenarios').option('--max-tests <count>', 'Maximum number of tests to run')).action(async (explorePath, options) => {
+addCommonOptions(program.command('explore <path>').description('Explore a page autonomously and run invented scenarios').option('--max-tests <count>', 'Maximum number of tests to run').option('--focus <feature>', 'Focus area for exploration')).action(async (explorePath, options) => {
   try {
     const explorBot = new ExplorBot(buildExplorBotOptions(explorePath, options));
     await explorBot.start();
@@ -121,7 +128,9 @@ addCommonOptions(program.command('explore <path>').description('Explore a page a
     const { ExploreCommand } = await import('../src/commands/explore-command.js');
     const cmd = new ExploreCommand(explorBot);
     if (options.maxTests) cmd.maxTests = Number.parseInt(options.maxTests, 10);
-    await cmd.execute('');
+    const execArgs: string[] = [];
+    if (options.focus) execArgs.push('--focus', `"${options.focus}"`);
+    await cmd.execute(execArgs.join(' '));
     await explorBot.stop();
     await showStatsAndExit(0);
   } catch (error) {

package/dist/bin/explorbot-cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import chalk from 'chalk';
 import { Command } from 'commander';
 import figureSet from 'figures';
@@ -18,7 +19,12 @@ import { jsonToTable } from '../src/utils/markdown-parser.js';
 import { parseMarkdownToTerminal } from '../src/utils/markdown-terminal.js';
 const program = new Command();
 const cli = getCliName();
-program.name(cli).description('AI-powered web exploration tool');
+const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../package.json');
+const pkgVersion = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version;
+program.name(cli).description('AI-powered web exploration tool').version(pkgVersion, '-V, --version');
+program.hook('preAction', () => {
+    console.log(chalk.dim(`${cli} v${pkgVersion}`));
+});
 function buildExplorBotOptions(from, options) {
     return {
         from,
@@ -86,7 +92,7 @@ addCommonOptions(program.command('start [path]').description('Start web explorat
     await explorBot.start();
     await startTUI(explorBot);
 });
-addCommonOptions(program.command('explore <path>').description('Explore a page autonomously and run invented scenarios').option('--max-tests <count>', 'Maximum number of tests to run')).action(async (explorePath, options) => {
+addCommonOptions(program.command('explore <path>').description('Explore a page autonomously and run invented scenarios').option('--max-tests <count>', 'Maximum number of tests to run').option('--focus <feature>', 'Focus area for exploration')).action(async (explorePath, options) => {
     try {
         const explorBot = new ExplorBot(buildExplorBotOptions(explorePath, options));
         await explorBot.start();
@@ -95,7 +101,10 @@ addCommonOptions(program.command('explore <path>').description('Explore a page a
         const cmd = new ExploreCommand(explorBot);
         if (options.maxTests)
             cmd.maxTests = Number.parseInt(options.maxTests, 10);
-        await cmd.execute('');
+        const execArgs = [];
+        if (options.focus)
+            execArgs.push('--focus', `"${options.focus}"`);
+        await cmd.execute(execArgs.join(' '));
         await explorBot.stop();
         await showStatsAndExit(0);
     }

package/dist/package.json

@@ -0,0 +1,145 @@
+{
+  "name": "explorbot",
+  "version": "0.1.8",
+  "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
+  "license": "Elastic-2.0",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "exports": {
+    ".": {
+      "bun": "./src/index.tsx",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "bin": {
+    "explorbot": "./dist/bin/explorbot-cli.js"
+  },
+  "files": [
+    "dist/",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "bin/**/*.ts",
+    "boat/api-tester/src/**/*.ts",
+    "rules/",
+    "assets/sample-files/"
+  ],
+  "scripts": {
+    "build": "bun run src/index.tsx build && bun run build:bin",
+    "build:bin": "bun build bin/explorbot-cli.ts --outdir bin --target node --external commander --format esm",
+    "build:npm": "bash scripts/build-npm.sh",
+    "prepublishOnly": "npm run build:npm",
+    "dev": "bun run src/index.tsx",
+    "start": "node dist/index.js",
+    "init": "bun run src/index.tsx init",
+    "test": "codeceptjs run",
+    "test:headless": "codeceptjs run --headless",
+    "test:ui": "bun test tests/ui",
+    "test:unit": "bun test tests/unit",
+    "test:node": "node --test tests/node/*.mjs",
+    "test:unit:coverage": "bun test tests/unit --coverage && find . -name '.lcov.info*.tmp' -type f -delete 2>/dev/null || true",
+    "test:coverage": "bun test tests/unit --coverage --coverage-reporter=text && find . -name '.lcov.info*.tmp' -type f -delete 2>/dev/null || true",
+    "test:coverage:html": "echo 'Run: bun test tests/unit --coverage for detailed coverage report'",
+    "test:coverage:summary": "bun test tests/unit --coverage --coverage-reporter=text | tail -n 20 && find . -name '.lcov.info*.tmp' -type f -delete 2>/dev/null || true",
+    "test:coverage:clean": "find . -name '.lcov.info*.tmp' -type f -delete 2>/dev/null || true",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "langfuse:export": "bun run .claude/skills/explorbot-debug/langfuse-export.ts"
+  },
+  "keywords": [
+    "cli",
+    "react",
+    "ink",
+    "codeceptjs",
+    "playwright"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/testomatio/explorbot"
+  },
+  "author": "",
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0",
+    "@ai-sdk/groq": "^3.0",
+    "@ai-sdk/openai": "^3.0",
+    "@axe-core/playwright": "^4.11.0",
+    "@codeceptjs/reflection": "^0.5.2",
+    "@inkjs/ui": "^2.0.0",
+    "@langfuse/otel": "^4.5.1",
+    "@openrouter/ai-sdk-provider": "^2.3.3",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.67.3",
+    "@opentelemetry/instrumentation": "^0.208.0",
+    "@opentelemetry/resources": "^2.2.0",
+    "@opentelemetry/sdk-node": "^0.208.0",
+    "@opentelemetry/sdk-trace-base": "^2.2.0",
+    "@opentelemetry/semantic-conventions": "^1.38.0",
+    "@scalar/openapi-parser": "^0.25.6",
+    "@testomatio/reporter": "^2.7.6",
+    "ai": "^6.0.6",
+    "axe-core": "^4.11.1",
+    "bash-tool": "^1.3.15",
+    "cli-highlight": "^2.1.11",
+    "codeceptjs": "4.0.0-rc.11",
+    "commander": "^14.0.1",
+    "debug": "^4.4.3",
+    "dedent": "^1.6.0",
+    "expect": "^30.3.0",
+    "figures": "^6.1.0",
+    "gray-matter": "^4.0.3",
+    "html-minifier-next": "^2.1.5",
+    "ink": "^6.3.1",
+    "ink-big-text": "^2.0.0",
+    "ink-select-input": "^6.2.0",
+    "ink-text-input": "^6.0.0",
+    "jsdom": "^28.0.0",
+    "jsonpath-plus": "^10.4.0",
+    "just-bash": "^2.14.0",
+    "langfuse": "^3.5.0",
+    "marked": "^16.2.0",
+    "marked-terminal": "^7.3.0",
+    "micromatch": "^4.0.8",
+    "ora-classic": "^5.4.2",
+    "parse5": "^8.0.0",
+    "playwright": "^1.40.0",
+    "react": "^19.1.1",
+    "strip-ansi": "^7.1.2",
+    "turndown": "^7.2.1",
+    "unique-names-generator": "^4.7.1",
+    "yargs": "^17.7.2",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.5.3",
+    "@copilotkit/aimock": "^1.14.0",
+    "@testing-library/react": "^16.3.0",
+    "@types/debug": "^4.1.12",
+    "@types/jsdom": "^27.0.0",
+    "@types/micromatch": "^4.0.9",
+    "@types/react": "^18.2.0",
+    "@types/yargs": "^17.0.24",
+    "bunosh": "^0.4.0",
+    "ink-testing-library": "^4.0.0",
+    "langwatch": "^0.10.0",
+    "msw": "^2.11.3",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "overrides": {
+    "has-flag": "4.0.0",
+    "supports-color": "7.2.0"
+  },
+  "resolutions": {
+    "marked-terminal": {
+      "supports-hyperlinks": "2.3.0"
+    },
+    "has-flag": "4.0.0",
+    "supports-color": "7.2.0"
+  }
+}

package/dist/src/ai/rules.js

@@ -131,7 +131,15 @@ export const fileUploadRule = dedent `
 export const protectionRule = dedent `
   <important>
   Do not sign out current user of the application.
-  Do not change current user account settings
+  Do not change current user account settings.
+
+  Pre-existing data on the page belongs to the application, not the test.
+  Items that were not created inside the current test scenario must not be deleted, removed, emptied, reset, archived, or otherwise destroyed.
+  If a scenario needs to verify destructive behaviour, the same scenario must first create a disposable target and then destroy that specific target — never operate on data that was already there when the test started.
+
+  The resource that the current page URL represents is "under test".
+  The test must not destroy the resource it is running against — doing so invalidates every subsequent scenario that starts on the same URL.
+  Do not propose or perform delete/remove/archive actions on the entity that owns the current URL; propose such actions only on disposable children created within the scenario itself.
   </important>
 `;
 export const focusedElementRule = dedent `

package/dist/src/ai/tester.js

@@ -12,7 +12,7 @@ import { detectFocusArea, extractFocusedElement } from "../utils/aria.js";
 import { HooksRunner } from "../utils/hooks-runner.js";
 import { createDebug, tag } from "../utils/logger.js";
 import { loop } from "../utils/loop.js";
-import { actionRule, focusedElementRule, locatorRule, multipleTabsRule, sectionContextRule } from "./rules.js";
+import { actionRule, focusedElementRule, locatorRule, multipleTabsRule, protectionRule, sectionContextRule } from "./rules.js";
 import { TaskAgent } from "./task-agent.js";
 import { createCodeceptJSTools, createSpecialContextTools } from "./tools.js";
 const debugLog = createDebug('explorbot:tester');
@@ -97,6 +97,22 @@ export class Tester extends TaskAgent {
         this.explorer.getStateManager().clearHistory();
         this.resetFailureCount();
         this.pilot?.reset();
+        const requestStore = this.explorer.getRequestStore();
+        requestStore?.clear();
+        const offFailedRequest = requestStore?.onFailedRequest((r) => {
+            task.addNote(`Network error: ${r.method} ${r.path} → ${r.status}`, TestResult.FAILED);
+        });
+        const page = this.explorer.playwrightHelper?.page;
+        const onPageError = (err) => {
+            task.addNote(`Console error: ${err.message}`, TestResult.FAILED);
+        };
+        const onConsoleMessage = (msg) => {
+            if (msg.type() !== 'error')
+                return;
+            task.addNote(`Console error: ${msg.text()}`, TestResult.FAILED);
+        };
+        page?.on('pageerror', onPageError);
+        page?.on('console', onConsoleMessage);
         const initialState = ActionResult.fromState(state);
         const conversation = this.provider.startConversation(this.getSystemMessage(), 'tester');
         this.currentConversation = conversation;
@@ -295,6 +311,9 @@ export class Tester extends TaskAgent {
         }
         await this.getQuartermaster().analyzeSession(task, initialState, conversation);
         offStateChange();
+        offFailedRequest?.();
+        page?.off('pageerror', onPageError);
+        page?.off('console', onConsoleMessage);
         await this.finishTest(task);
         await this.explorer.stopTest(task, {
             startUrl: task.startUrl,
@@ -606,6 +625,8 @@ export class Tester extends TaskAgent {
       When creating or editing items via form() or type() you should include ${task.sessionName} in the value (if it is not restricted by the application logic)
       Initial page URL: ${actionResult.url}
 
+      ${protectionRule}
+
       ${this.buildDeletionScope(task)}
 
       ${this.buildAvailableFiles()}

package/dist/src/utils/aria.js

@@ -394,7 +394,7 @@ export const detectFocusArea = (snapshot) => {
     if (result)
         return result;
     const fallback = findOverlayByCloseButton(nodes);
-    if (fallback && fallback.name)
+    if (fallback?.name)
         return fallback;
     return { detected: false, type: null, name: null };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explorbot",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
   "license": "Elastic-2.0",
   "type": "module",

package/src/ai/rules.ts

@@ -135,7 +135,15 @@ export const fileUploadRule = dedent`
 export const protectionRule = dedent`
   <important>
   Do not sign out current user of the application.
-  Do not change current user account settings
+  Do not change current user account settings.
+
+  Pre-existing data on the page belongs to the application, not the test.
+  Items that were not created inside the current test scenario must not be deleted, removed, emptied, reset, archived, or otherwise destroyed.
+  If a scenario needs to verify destructive behaviour, the same scenario must first create a disposable target and then destroy that specific target — never operate on data that was already there when the test started.
+
+  The resource that the current page URL represents is "under test".
+  The test must not destroy the resource it is running against — doing so invalidates every subsequent scenario that starts on the same URL.
+  Do not propose or perform delete/remove/archive actions on the entity that owns the current URL; propose such actions only on disposable children created within the scenario itself.
   </important>
 `;
 

package/src/ai/tester.ts

@@ -17,13 +17,13 @@ import { codeToMarkdown } from '../utils/html.ts';
 import { createDebug, tag } from '../utils/logger.ts';
 import { loop } from '../utils/loop.ts';
 import type { Agent } from './agent.ts';
+import type { Captain } from './captain.ts';
 import type { Conversation } from './conversation.ts';
 import { Navigator } from './navigator.ts';
-import type { Captain } from './captain.ts';
 import type { Pilot } from './pilot.ts';
 import { Provider } from './provider.ts';
 import { Researcher } from './researcher.ts';
-import { actionRule, focusedElementRule, locatorRule, multipleTabsRule, sectionContextRule } from './rules.ts';
+import { actionRule, focusedElementRule, locatorRule, multipleTabsRule, protectionRule, sectionContextRule } from './rules.ts';
 import { TaskAgent } from './task-agent.ts';
 import { createCodeceptJSTools, createSpecialContextTools } from './tools.ts';
 
@@ -125,6 +125,23 @@ export class Tester extends TaskAgent implements Agent {
     this.resetFailureCount();
     this.pilot?.reset();
 
+    const requestStore = this.explorer.getRequestStore();
+    requestStore?.clear();
+    const offFailedRequest = requestStore?.onFailedRequest((r) => {
+      task.addNote(`Network error: ${r.method} ${r.path} → ${r.status}`, TestResult.FAILED);
+    });
+
+    const page = this.explorer.playwrightHelper?.page;
+    const onPageError = (err: Error) => {
+      task.addNote(`Console error: ${err.message}`, TestResult.FAILED);
+    };
+    const onConsoleMessage = (msg: any) => {
+      if (msg.type() !== 'error') return;
+      task.addNote(`Console error: ${msg.text()}`, TestResult.FAILED);
+    };
+    page?.on('pageerror', onPageError);
+    page?.on('console', onConsoleMessage);
+
     const initialState = ActionResult.fromState(state);
 
     const conversation = this.provider.startConversation(this.getSystemMessage(), 'tester');
@@ -355,6 +372,9 @@ export class Tester extends TaskAgent implements Agent {
     await this.getQuartermaster().analyzeSession(task, initialState, conversation);
 
     offStateChange();
+    offFailedRequest?.();
+    page?.off('pageerror', onPageError);
+    page?.off('console', onConsoleMessage);
     await this.finishTest(task);
     await this.explorer.stopTest(task, {
       startUrl: task.startUrl,
@@ -691,6 +711,8 @@ export class Tester extends TaskAgent implements Agent {
       When creating or editing items via form() or type() you should include ${task.sessionName} in the value (if it is not restricted by the application logic)
       Initial page URL: ${actionResult.url}
 
+      ${protectionRule}
+
       ${this.buildDeletionScope(task)}
 
       ${this.buildAvailableFiles()}

package/src/utils/aria.ts

@@ -421,7 +421,7 @@ export const detectFocusArea = (snapshot: string | null): FocusAreaResult => {
   if (result) return result;
 
   const fallback = findOverlayByCloseButton(nodes);
-  if (fallback && fallback.name) return fallback;
+  if (fallback?.name) return fallback;
 
   return { detected: false, type: null, name: null };
 };