explorbot 0.1.9 → 0.1.10

package/bin/explorbot-cli.ts

@@ -26,7 +26,7 @@ const pkgVersion = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version as stri
 
 program.name(cli).description('AI-powered web exploration tool').version(pkgVersion, '-V, --version');
 program.hook('preAction', () => {
-  console.log(chalk.dim(`${cli} v${pkgVersion}`));
+  console.log(`⛵ ${chalk.yellow.bold(`Explorbot v${pkgVersion}`)} ${chalk.dim('Autonomous Testing Agent')}`);
 });
 
 interface CLIOptions {
@@ -193,17 +193,21 @@ addCommonOptions(program.command('plan <path>').description('Generate test plan
       const cliFlags = [options.path ? `--path ${options.path}` : '', options.session ? '--session' : ''].filter(Boolean).join(' ');
       const cliSuffix = cliFlags ? ` ${cliFlags}` : '';
 
-      const lines: string[] = [];
-      lines.push('Run commands:');
-      lines.push(`\`${cli} test ${planFile} 1${cliSuffix}\` → run first new test`);
-      lines.push(`\`${cli} test ${planFile} *${cliSuffix}\` → run all new tests`);
+      const { PlanCommand } = await import('../src/commands/plan-command.js');
+      const planCommand = new PlanCommand(explorBot);
+      planCommand.suggestions = [
+        { command: `test ${planFile} 1${cliSuffix}`, hint: 'run first new test' },
+        { command: `test ${planFile} *${cliSuffix}`, hint: 'run all new tests' },
+      ];
       if (suite && suite.automatedTestCount > 0) {
         for (const f of suite.getAutomatedTestFiles()) {
-          lines.push(`\`${cli} rerun ${path.relative(process.cwd(), f)}${cliSuffix}\` → re-run automated tests`);
+          planCommand.suggestions.push({
+            command: `rerun ${path.relative(process.cwd(), f)}${cliSuffix}`,
+            hint: 're-run automated tests',
+          });
         }
       }
-
-      log(parseMarkdownToTerminal(lines.join('\n')));
+      planCommand.printSuggestions();
 
       await explorBot.stop();
       await showStatsAndExit(0);
@@ -492,6 +496,64 @@ program
     }
   });
 
+program
+  .command('compact [target]')
+  .description('Compact stored experience files; pass filename or URL substring to limit scope')
+  .option('--dry-run', 'Preview without running AI or writing files')
+  .option('--no-merge', 'Skip the cross-URL merge step when compacting all')
+  .option('-p, --path <path>', 'Working directory path')
+  .option('-c, --config <path>', 'Path to configuration file')
+  .option('-v, --verbose', 'Enable verbose logging')
+  .action(async (target, options) => {
+    try {
+      const explorBot = new ExplorBot({
+        path: options.path,
+        config: options.config,
+        verbose: options.verbose,
+      });
+      await explorBot.startProviderOnly();
+
+      const { CompactCommand } = await import('../src/commands/compact-command.js');
+      const argParts = [target, options.dryRun && '--dry-run', options.merge === false && '--no-merge'].filter(Boolean).join(' ');
+      const command = new CompactCommand(explorBot);
+      await command.execute(argParts);
+      command.printSuggestions();
+
+      await showStatsAndExit(0);
+    } catch (error) {
+      console.error('Failed:', error instanceof Error ? error.message : 'Unknown error');
+      await showStatsAndExit(1);
+    }
+  });
+
+program
+  .command('experience [filter] [index]')
+  .description('List stored experiences grouped by URL; pass URL substring to filter; pass tag (A.1) or index to expand a section')
+  .option('-p, --path <path>', 'Working directory path')
+  .option('-c, --config <path>', 'Path to configuration file')
+  .option('--recent', 'Only files modified within the last 30 days')
+  .option('--old', 'Only files modified more than 30 days ago')
+  .action(async (filter, index, options) => {
+    try {
+      await ConfigParser.getInstance().loadConfig({
+        config: options.config,
+        path: options.path || process.cwd(),
+      });
+      const { ExperienceCommand } = await import('../src/commands/experience-command.js');
+      const explorBot = new ExplorBot({ path: options.path });
+      const command = new ExperienceCommand(explorBot);
+      const flags: string[] = [];
+      if (options.recent) flags.push('--recent');
+      if (options.old) flags.push('--old');
+      const args = [...flags, filter, index].filter(Boolean).join(' ');
+      await command.execute(args);
+      command.printSuggestions();
+    } catch (error) {
+      console.error('Failed:', error instanceof Error ? error.message : 'Unknown error');
+      process.exit(1);
+    }
+  });
+
 addCommonOptions(program.command('research <url>').description('Research a page and print UI analysis').option('--data', 'Include data extraction in research').option('--deep', 'Enable deep analysis (expand hidden elements)').option('--no-fix', 'Skip locator fix cycle (for debugging)')).action(
   async (url, options) => {
     try {

package/boat/api-tester/src/ai/curler-tools.ts

@@ -1,13 +1,13 @@
-import { tool } from 'ai';
-import { expect } from 'expect';
 import { readFileSync } from 'node:fs';
+import { tool } from 'ai';
 import dedent from 'dedent';
+import { expect } from 'expect';
 import { z } from 'zod';
+import type { RequestStore } from '../../../../src/api/request-store.ts';
 import type { Test, TestResultType } from '../../../../src/test-plan.ts';
 import { TestResult } from '../../../../src/test-plan.ts';
 import { tag } from '../../../../src/utils/logger.ts';
 import type { ApiClient } from '../api-client.ts';
-import type { RequestStore } from '../../../../src/api/request-store.ts';
 
 const readResponseData = (responseFile: string) => {
   return JSON.parse(readFileSync(responseFile, 'utf8'));

package/boat/api-tester/src/ai/curler.ts

@@ -1,12 +1,12 @@
 import dedent from 'dedent';
 import { z } from 'zod';
 import type { AIProvider } from '../../../../src/ai/provider.ts';
+import type { RequestStore } from '../../../../src/api/request-store.ts';
 import type { Reporter } from '../../../../src/reporter.ts';
 import { type Test, TestResult } from '../../../../src/test-plan.ts';
 import { createDebug, tag } from '../../../../src/utils/logger.ts';
 import { loop } from '../../../../src/utils/loop.ts';
 import type { ApiClient } from '../api-client.ts';
-import type { RequestStore } from '../../../../src/api/request-store.ts';
 import { createCurlerTools } from './curler-tools.ts';
 
 const debugLog = createDebug('explorbot:curler');

package/boat/api-tester/src/apibot.ts

@@ -1,6 +1,8 @@
 import { existsSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
 import { AIProvider } from '../../../src/ai/provider.ts';
+import { RequestStore } from '../../../src/api/request-store.ts';
+import { extractEndpointDefinition, loadSpec, searchEndpoints, validateSpecs } from '../../../src/api/spec-reader.ts';
 import { Reporter } from '../../../src/reporter.ts';
 import { Plan } from '../../../src/test-plan.ts';
 import { setVerboseMode, tag } from '../../../src/utils/logger.ts';
@@ -8,8 +10,6 @@ import { Chief } from './ai/chief.ts';
 import { Curler } from './ai/curler.ts';
 import { ApiClient } from './api-client.ts';
 import { type ApibotConfig, ApibotConfigParser } from './config.ts';
-import { RequestStore } from '../../../src/api/request-store.ts';
-import { extractEndpointDefinition, loadSpec, searchEndpoints, validateSpecs } from '../../../src/api/spec-reader.ts';
 
 export class ApiBot {
   private configParser: ApibotConfigParser;

package/boat/api-tester/src/config.ts

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import path, { resolve } from 'node:path';
 import { parseEnv } from 'node:util';
-import { EXPLORBOT_CONFIG_PATHS, type AIConfig, type ApiConfig as BaseApiConfig, type ApiHookFn } from '../../../src/config.ts';
+import { type AIConfig, type ApiHookFn, type ApiConfig as BaseApiConfig, EXPLORBOT_CONFIG_PATHS } from '../../../src/config.ts';
 
 export type { AIConfig };
 

package/dist/bin/explorbot-cli.js

@@ -23,7 +23,7 @@ const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../p
 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}`));
+    console.log(`⛵ ${chalk.yellow.bold(`Explorbot v${pkgVersion}`)} ${chalk.dim('Autonomous Testing Agent')}`);
 });
 function buildExplorBotOptions(from, options) {
     return {
@@ -158,16 +158,21 @@ addCommonOptions(program.command('plan <path>').description('Generate test plan
         const planFile = savedPath ? path.basename(savedPath) : 'plan.md';
         const cliFlags = [options.path ? `--path ${options.path}` : '', options.session ? '--session' : ''].filter(Boolean).join(' ');
         const cliSuffix = cliFlags ? ` ${cliFlags}` : '';
-        const lines = [];
-        lines.push('Run commands:');
-        lines.push(`\`${cli} test ${planFile} 1${cliSuffix}\` → run first new test`);
-        lines.push(`\`${cli} test ${planFile} *${cliSuffix}\` → run all new tests`);
+        const { PlanCommand } = await import('../src/commands/plan-command.js');
+        const planCommand = new PlanCommand(explorBot);
+        planCommand.suggestions = [
+            { command: `test ${planFile} 1${cliSuffix}`, hint: 'run first new test' },
+            { command: `test ${planFile} *${cliSuffix}`, hint: 'run all new tests' },
+        ];
         if (suite && suite.automatedTestCount > 0) {
             for (const f of suite.getAutomatedTestFiles()) {
-                lines.push(`\`${cli} rerun ${path.relative(process.cwd(), f)}${cliSuffix}\` → re-run automated tests`);
+                planCommand.suggestions.push({
+                    command: `rerun ${path.relative(process.cwd(), f)}${cliSuffix}`,
+                    hint: 're-run automated tests',
+                });
             }
         }
-        log(parseMarkdownToTerminal(lines.join('\n')));
+        planCommand.printSuggestions();
         await explorBot.stop();
         await showStatsAndExit(0);
     }
@@ -439,6 +444,64 @@ program
         process.exit(1);
     }
 });
+program
+    .command('compact [target]')
+    .description('Compact stored experience files; pass filename or URL substring to limit scope')
+    .option('--dry-run', 'Preview without running AI or writing files')
+    .option('--no-merge', 'Skip the cross-URL merge step when compacting all')
+    .option('-p, --path <path>', 'Working directory path')
+    .option('-c, --config <path>', 'Path to configuration file')
+    .option('-v, --verbose', 'Enable verbose logging')
+    .action(async (target, options) => {
+    try {
+        const explorBot = new ExplorBot({
+            path: options.path,
+            config: options.config,
+            verbose: options.verbose,
+        });
+        await explorBot.startProviderOnly();
+        const { CompactCommand } = await import('../src/commands/compact-command.js');
+        const argParts = [target, options.dryRun && '--dry-run', options.merge === false && '--no-merge'].filter(Boolean).join(' ');
+        const command = new CompactCommand(explorBot);
+        await command.execute(argParts);
+        command.printSuggestions();
+        await showStatsAndExit(0);
+    }
+    catch (error) {
+        console.error('Failed:', error instanceof Error ? error.message : 'Unknown error');
+        await showStatsAndExit(1);
+    }
+});
+program
+    .command('experience [filter] [index]')
+    .description('List stored experiences grouped by URL; pass URL substring to filter; pass tag (A.1) or index to expand a section')
+    .option('-p, --path <path>', 'Working directory path')
+    .option('-c, --config <path>', 'Path to configuration file')
+    .option('--recent', 'Only files modified within the last 30 days')
+    .option('--old', 'Only files modified more than 30 days ago')
+    .action(async (filter, index, options) => {
+    try {
+        await ConfigParser.getInstance().loadConfig({
+            config: options.config,
+            path: options.path || process.cwd(),
+        });
+        const { ExperienceCommand } = await import('../src/commands/experience-command.js');
+        const explorBot = new ExplorBot({ path: options.path });
+        const command = new ExperienceCommand(explorBot);
+        const flags = [];
+        if (options.recent)
+            flags.push('--recent');
+        if (options.old)
+            flags.push('--old');
+        const args = [...flags, filter, index].filter(Boolean).join(' ');
+        await command.execute(args);
+        command.printSuggestions();
+    }
+    catch (error) {
+        console.error('Failed:', error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    }
+});
 addCommonOptions(program.command('research <url>').description('Research a page and print UI analysis').option('--data', 'Include data extraction in research').option('--deep', 'Enable deep analysis (expand hidden elements)').option('--no-fix', 'Skip locator fix cycle (for debugging)')).action(async (url, options) => {
     try {
         const explorBot = new ExplorBot(buildExplorBotOptions(url, options));

package/dist/boat/api-tester/src/ai/curler-tools.js

@@ -1,7 +1,7 @@
-import { tool } from 'ai';
-import { expect } from 'expect';
 import { readFileSync } from 'node:fs';
+import { tool } from 'ai';
 import dedent from 'dedent';
+import { expect } from 'expect';
 import { z } from 'zod';
 import { TestResult } from "../../../../src/test-plan.js";
 import { tag } from "../../../../src/utils/logger.js";

package/dist/boat/api-tester/src/apibot.js

@@ -1,6 +1,8 @@
 import { existsSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
 import { AIProvider } from "../../../src/ai/provider.js";
+import { RequestStore } from "../../../src/api/request-store.js";
+import { extractEndpointDefinition, loadSpec, searchEndpoints, validateSpecs } from "../../../src/api/spec-reader.js";
 import { Reporter } from "../../../src/reporter.js";
 import { Plan } from "../../../src/test-plan.js";
 import { setVerboseMode, tag } from "../../../src/utils/logger.js";
@@ -8,8 +10,6 @@ import { Chief } from "./ai/chief.js";
 import { Curler } from "./ai/curler.js";
 import { ApiClient } from "./api-client.js";
 import { ApibotConfigParser } from "./config.js";
-import { RequestStore } from "../../../src/api/request-store.js";
-import { extractEndpointDefinition, loadSpec, searchEndpoints, validateSpecs } from "../../../src/api/spec-reader.js";
 export class ApiBot {
     configParser;
     provider;

package/dist/package.json

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

package/dist/src/ai/bosun.js

@@ -372,7 +372,11 @@ export class Bosun extends TaskAgent {
         const actionResult = ActionResult.fromState(state);
         const successfulInteractions = results.filter((r) => r.result === 'success' && r.code);
         for (const interaction of successfulInteractions) {
-            await experienceTracker.saveSuccessfulResolution(actionResult, `Drill ${interaction.action}: ${interaction.component}`, interaction.code, interaction.description);
+            experienceTracker.writeAction(actionResult, {
+                title: `Drill ${interaction.action}: ${interaction.component}`,
+                code: interaction.code,
+                explanation: interaction.description,
+            });
         }
         if (successfulInteractions.length > 0) {
             tag('success').log(`Saved ${successfulInteractions.length} interactions to experience`);