explorbot 0.2.2 → 0.2.3

package/README.md

@@ -138,7 +138,7 @@ EXPLORBOT_KNOWLEDGE="Log in as admin@example.com / secret123" \
   npx explorbot explore /admin/users --max-tests 3
 ```
 
-Output lands in a temp directory and nothing is written to your project. See [Agentic Usage](docs/workflow/agentic-usage.md).
+Output lands in a per-host state directory, `~/.explorbot/state/<host>/`, so runs against the same app collect in one place and nothing is written to your project. Set `EXPLORBOT_EPHEMERAL=1` to keep nothing between runs. See [Agentic Usage](docs/workflow/agentic-usage.md).
 
 ## Teaching Explorbot
 

package/bin/explorbot-cli.ts

@@ -40,6 +40,7 @@ interface CLIOptions {
   headless?: boolean;
   incognito?: boolean;
   session?: string | boolean;
+  spec?: string;
 }
 
 function buildExplorBotOptions(from: string | undefined, options: CLIOptions): ExplorBotOptions {
@@ -52,6 +53,7 @@ function buildExplorBotOptions(from: string | undefined, options: CLIOptions): E
     headless: options.headless,
     incognito: options.incognito,
     session: options.session,
+    applicationSpec: options.spec,
   } as ExplorBotOptions;
 }
 
@@ -64,6 +66,7 @@ function addCommonOptions(cmd: Command): Command {
     .option('-s, --show', 'Show browser window')
     .option('--headless', 'Run browser in headless mode')
     .option('--incognito', 'Run without recording experiences')
+    .option('--spec <path>', 'Use a Docbot application spec directory or index.md')
     .option('--session [file]', 'Save/restore browser session from file');
 }
 
@@ -386,6 +389,14 @@ program
     }
   });
 
+program
+  .command('sites')
+  .description('List sites registered in the global installation')
+  .action(async () => {
+    const { SitesCommand } = await import('../src/commands/sites-command.js');
+    await new SitesCommand(new ExplorBot()).execute('');
+  });
+
 addCommonOptions(program.command('rerun <filename> [index]').description('Re-run generated tests with AI auto-healing')).action(async (filename, index, options) => {
   try {
     const explorBot = new ExplorBot(buildExplorBotOptions(undefined, options));
@@ -421,17 +432,28 @@ addCommonOptions(
 
 program
   .command('init')
-  .description('Initialize a new project with configuration')
-  .option('-c, --config-path <path>', 'Path for the config file', './explorbot.config.js')
+  .description('Initialize configuration for a project or for this machine')
+  .option('-c, --config-path <path>', 'Path for the config file')
   .option('-f, --force', 'Overwrite existing config file')
   .option('-p, --path <path>', 'Working directory for initialization')
+  .option('-g, --global', 'Configure explorbot in ~/.explorbot to run from anywhere')
+  .option('--provider <name>', `AI provider for the global config: ${Object.keys(PROVIDERS).join(', ')}`)
+  .option('--api-key <key>', 'API key stored in ~/.explorbot/.env')
   .action(async (options) => {
-    const { runInitCommand } = await import('../src/commands/init-command.js');
-    runInitCommand({
-      configPath: options.configPath,
-      force: options.force,
-      path: options.path,
-    });
+    try {
+      const { runInit } = await import('../src/commands/init-command.js');
+      await runInit({
+        configPath: options.configPath,
+        force: options.force,
+        path: options.path,
+        global: options.global,
+        provider: options.provider,
+        apiKey: options.apiKey,
+      });
+    } catch (error) {
+      console.error('Failed:', error instanceof Error ? error.message : 'Unknown error');
+      process.exit(1);
+    }
   });
 
 program
@@ -694,7 +716,7 @@ program
       const explorBot = new ExplorBot(mainOptions);
       await explorBot.start();
 
-      await explorBot.agentNavigator().visit(url);
+      await explorBot.visit(url);
 
       const { ContextCommand } = await import('../src/commands/context-command.js');
       const argParts: string[] = [];
@@ -716,7 +738,7 @@ addCommonOptions(program.command('shell <url> <command>').description('Execute a
   try {
     const explorBot = new ExplorBot(buildExplorBotOptions(url, options));
     await explorBot.start();
-    await explorBot.agentNavigator().visit(url);
+    await explorBot.visit(url);
 
     const action = explorBot.getExplorer().action();
     await action.execute(command);
@@ -740,10 +762,11 @@ browserCmd
   .description('Launch a persistent browser server')
   .option('-s, --show', 'Launch browser in headed mode (visible window)')
   .option('--headless', 'Launch browser in headless mode')
+  .option('--instance <name>', 'Named browser instance (lowercase letters, digits, dashes)')
   .option('-c, --config <path>', 'Path to configuration file')
   .option('-p, --path <path>', 'Working directory path')
   .action(async (options) => {
-    const { launchServer, removeEndpointFile } = await import('../src/browser-server.js');
+    const { launchServer, removeEndpointFile, keepServerRunning } = await import('../src/browser-server.js');
     await ConfigParser.getInstance().loadConfig({
       config: options.config,
       path: options.path,
@@ -754,55 +777,45 @@ browserCmd
     if (options.show !== undefined) show = true;
     if (options.headless !== undefined) show = false;
 
-    const server = await launchServer({
-      browser: config.playwright.browser,
-      show,
-    });
-
-    console.log('Browser server is running. Press Ctrl+C to stop.');
-
-    const cleanup = () => {
-      console.log('\nStopping browser server...');
-      server.close();
-      removeEndpointFile();
-      process.exit(0);
-    };
+    const server = await launchServer(
+      {
+        browser: config.playwright.browser,
+        show,
+      },
+      options.instance
+    );
 
-    process.on('SIGINT', cleanup);
-    process.on('SIGTERM', cleanup);
+    await keepServerRunning(async () => {
+      await server.close();
+      removeEndpointFile(options.instance);
+    });
   });
 
 browserCmd
   .command('stop')
   .description('Stop a running browser server')
+  .option('--instance <name>', 'Named browser instance (lowercase letters, digits, dashes)')
   .option('-c, --config <path>', 'Path to configuration file')
   .option('-p, --path <path>', 'Working directory path')
   .action(async (options) => {
-    const { getAliveEndpoint, removeEndpointFile } = await import('../src/browser-server.js');
+    const { stopServer } = await import('../src/browser-server.js');
     await ConfigParser.getInstance().loadConfig({
       config: options.config,
       path: options.path,
     });
 
-    const endpoint = await getAliveEndpoint();
-    if (!endpoint) {
+    if (!(await stopServer(options.instance))) {
       console.log('No running browser server found.');
       process.exit(0);
     }
 
-    try {
-      const { chromium } = await import('playwright-core');
-      const browser = await chromium.connect(endpoint, { timeout: 3000 });
-      await browser.close();
-    } catch {}
-
-    removeEndpointFile();
     console.log('Browser server stopped.');
   });
 
 browserCmd
   .command('status')
   .description('Check if a browser server is running')
+  .option('--instance <name>', 'Named browser instance (lowercase letters, digits, dashes)')
   .option('-c, --config <path>', 'Path to configuration file')
   .option('-p, --path <path>', 'Working directory path')
   .action(async (options) => {
@@ -812,7 +825,7 @@ browserCmd
       path: options.path,
     });
 
-    const endpoint = await getAliveEndpoint();
+    const endpoint = await getAliveEndpoint(options.instance);
     if (endpoint) {
       console.log(`Browser server is running at: ${endpoint}`);
     } else {
@@ -871,8 +884,10 @@ program
 
 import { createApiCommands } from '../boat/api-tester/src/cli.ts';
 import { createDocsCommands } from '../boat/doc-collector/src/cli.ts';
+import { createPrimaCommands } from '../boat/prima/src/cli.ts';
 program.addCommand(createApiCommands('api'));
 program.addCommand(createDocsCommands('docs'));
+program.addCommand(createPrimaCommands('prima'));
 
 const envHelp = () => {
   const width = Math.max(...EXPLORBOT_ENV_VARS.map((v) => v.name.length));

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

@@ -33,7 +33,7 @@ export class ApiBot {
   }
 
   async start(): Promise<void> {
-    this.config = await this.configParser.loadConfig({ config: this.options.config, path: this.options.path });
+    this.config = await this.configParser.loadConfig({ config: this.options.config, path: this.options.path, endpoint: this.options.endpoint });
     this.provider = new AIProvider(this.config.ai);
     await this.provider.validateConnection();
 
@@ -101,12 +101,13 @@ export class ApiBot {
     return (this.agents.curler ||= this.createAgent(({ ai, apiClient, requestState }) => new Curler(ai, apiClient, requestState, this.reporter)));
   }
 
-  async plan(endpoint: string, opts: { style?: string; fresh?: boolean } = {}): Promise<Plan> {
+  async plan(target: string, opts: { style?: string; fresh?: boolean } = {}): Promise<Plan> {
     if (opts.fresh) {
       this.currentPlan = undefined;
       this.agents.chief = undefined;
     }
 
+    const endpoint = this.configParser.resolveEndpointPath(target);
     const chief = this.agentChief();
     const specDefinition = this.getEndpointDefinition(endpoint);
     this.currentPlan = await chief.plan(endpoint, { style: opts.style, specDefinition });
@@ -198,6 +199,7 @@ interface ApibotOptions {
   verbose?: boolean;
   config?: string;
   path?: string;
+  endpoint?: string;
 }
 
 export type { ApibotOptions };

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

@@ -49,7 +49,7 @@ export function createApiCommands(name = 'api'): Command {
   addCommonOptions(cmd.command('plan <endpoint>').description('Generate test plan for an API endpoint').option('--style <style>', 'Planning style: basename of a file in rules/chief/styles/').option('--fresh', 'Start planning from scratch')).action(async (endpoint, options) => {
     setPreserveConsoleLogs(true);
     try {
-      const bot = new ApiBot(buildOptions(options));
+      const bot = new ApiBot({ ...buildOptions(options), endpoint });
       await bot.start();
 
       await bot.plan(endpoint, { style: options.style, fresh: options.fresh });
@@ -122,7 +122,7 @@ export function createApiCommands(name = 'api'): Command {
   addCommonOptions(cmd.command('explore <endpoint>').description('Full cycle: plan all styles, execute tests, re-plan')).action(async (endpoint, options) => {
     setPreserveConsoleLogs(true);
     try {
-      const bot = new ApiBot(buildOptions(options));
+      const bot = new ApiBot({ ...buildOptions(options), endpoint });
       await bot.start();
 
       const styles = Object.keys(getStyles());

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

@@ -1,7 +1,8 @@
 import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import path, { resolve } from 'node:path';
 import { parseEnv } from 'node:util';
-import { type AIConfig, type ApiHookFn, type ApiConfig as BaseApiConfig, EXPLORBOT_CONFIG_PATHS, createModel, materializeKnowledge, resolveModel, resolveOutputRoot } from '../../../src/config.ts';
+import { type AIConfig, type ApiHookFn, type ApiConfig as BaseApiConfig, ConfigMissingError, EXPLORBOT_CONFIG_PATHS, createModel, envConfigRequested, materializeKnowledge, missingConfigMessage, resolveConfigModels, resolveModel, resolveOutputRoot } from '../../../src/config.ts';
+import { type SiteRecord, findGlobalConfig, globalEnvPath, isGlobalConfigPath, registerSite, resolveSiteTarget } from '../../../src/global-config.ts';
 
 export type { AIConfig };
 
@@ -26,6 +27,7 @@ export class ApibotConfigParser {
   private static instance: ApibotConfigParser;
   private config: ApibotConfig | null = null;
   private configPath: string | null = null;
+  private site: SiteRecord | null = null;
 
   private constructor() {}
 
@@ -42,7 +44,7 @@ export class ApibotConfigParser {
     Object.assign(process.env, parseEnv(readFileSync(resolved, 'utf8')));
   }
 
-  async loadConfig(options?: { config?: string; path?: string }): Promise<ApibotConfig> {
+  async loadConfig(options?: { config?: string; path?: string; endpoint?: string }): Promise<ApibotConfig> {
     if (this.config && !options?.config && !options?.path) return this.config;
 
     const originalCwd = process.cwd();
@@ -50,6 +52,7 @@ export class ApibotConfigParser {
       process.chdir(resolve(options.path));
     }
 
+    ApibotConfigParser.loadEnv(globalEnvPath());
     ApibotConfigParser.loadEnv('.env');
 
     const resolvedPath = options?.config || this.findConfigFile();
@@ -78,7 +81,14 @@ export class ApibotConfigParser {
       }
 
       this.config = this.mergeWithDefaults(loadedConfig);
+      await resolveConfigModels(this.config.ai);
       this.configPath = resolvedPath;
+      this.site = null;
+
+      if (isGlobalConfigPath(resolvedPath)) {
+        this.enterGlobalMode(this.config, options?.endpoint);
+      }
+
       this.validateConfig(this.config);
 
       return this.config;
@@ -100,9 +110,22 @@ export class ApibotConfigParser {
 
   getOutputDir(): string {
     const config = this.getConfig();
+    return path.join(this.getProjectRoot(), config.dirs?.output || 'output');
+  }
+
+  getProjectRoot(): string {
+    if (this.site) return this.site.dir;
     const configPath = this.getConfigPath();
     if (!configPath) throw new Error('Config path not found');
-    return path.join(path.dirname(configPath), config.dirs?.output || 'output');
+    return path.dirname(configPath);
+  }
+
+  resolveEndpointPath(endpoint: string): string {
+    if (!this.site) return endpoint;
+
+    const resolved = resolveSiteTarget(endpoint, this.site.url);
+    if (resolved.baseUrl !== this.site.url) return endpoint;
+    return resolved.path;
   }
 
   getPlansDir(): string {
@@ -115,9 +138,7 @@ export class ApibotConfigParser {
 
   getKnowledgeDir(): string {
     const config = this.getConfig();
-    const configPath = this.getConfigPath();
-    if (!configPath) throw new Error('Config path not found');
-    return path.join(path.dirname(configPath), config.dirs?.knowledge || 'knowledge');
+    return path.join(this.getProjectRoot(), config.dirs?.knowledge || 'knowledge');
   }
 
   ensureDirectory(dirPath: string): void {
@@ -126,11 +147,20 @@ export class ApibotConfigParser {
     }
   }
 
+  private enterGlobalMode(config: ApibotConfig, endpoint?: string): void {
+    const site = resolveSiteTarget(endpoint);
+    this.site = registerSite(site.baseUrl);
+
+    config.dirs = { output: 'output', knowledge: 'knowledge' };
+    config.api = { ...config.api, baseEndpoint: site.baseUrl };
+    if (process.env.EXPLORBOT_API_SPEC) config.api.spec = [process.env.EXPLORBOT_API_SPEC];
+  }
+
   private async loadEnvConfig(): Promise<ApibotConfig> {
     const provider = process.env.EXPLORBOT_AI_PROVIDER;
     const modelSpec = process.env.EXPLORBOT_AI_MODEL;
     if (!provider && !modelSpec) {
-      throw new Error('No configuration file found. Create apibot.config.js or set EXPLORBOT_URL and EXPLORBOT_AI_PROVIDER environment variables');
+      throw new ConfigMissingError(missingConfigMessage('apibot.config.js'));
     }
     if (modelSpec && !provider && !modelSpec.includes('/')) {
       throw new Error('EXPLORBOT_AI_MODEL needs a provider — set EXPLORBOT_AI_PROVIDER, or write it as "provider/model-id"');
@@ -177,7 +207,8 @@ export class ApibotConfigParser {
       if (existsSync(fullPath)) return fullPath;
     }
 
-    return null;
+    if (envConfigRequested()) return null;
+    return findGlobalConfig();
   }
 
   private async loadConfigModule(configPath: string): Promise<any> {

package/boat/doc-collector/src/cli.ts

@@ -55,6 +55,7 @@ export function createDocsCommands(name = 'docs'): Command {
       console.log(`Skipped ${result.skipped.length} page(s)`);
       console.log(`Spec index: ${result.indexPath}`);
       console.log(`Pages dir: ${path.join(result.outputDir, 'pages')}`);
+      console.log(`Use in Explorbot: npx explorbot start ${startPath} --spec "${result.outputDir}"`);
 
       await bot.stop();
       process.exit(0);

package/boat/doc-collector/src/docs-renderer.ts

@@ -1,9 +1,11 @@
 import path from 'node:path';
+import matter from 'gray-matter';
+import { APPLICATION_SPEC_FORMAT, APPLICATION_SPEC_VERSION } from '../../../src/application-spec-contract.ts';
 import { type WebPageState } from '../../../src/state-manager.ts';
+import { normalizeInlineText } from '../../../src/utils/strings.ts';
 import type { PageDocumentation, StateTransition } from './ai/documentarian.ts';
 import type { DocumentationScreenshot } from './screenshots.ts';
-import { buildStateGraph, renderMermaidFromGraph, renderStateMapFromGraph, type DocumentedPage, type SkippedPage } from './state-diagram.ts';
-import { normalizeInlineText } from '../../../src/utils/strings.ts';
+import { type DocumentedPage, type SkippedPage, buildStateGraph, renderMermaidFromGraph, renderPageStateDiagram, renderStateMapFromGraph } from './state-diagram.ts';
 
 function renderPageDocumentation(state: WebPageState, documentation: PageDocumentation, screenshots: DocumentationScreenshot[] = []): string {
   const lines: string[] = [];
@@ -33,6 +35,13 @@ function renderPageDocumentation(state: WebPageState, documentation: PageDocumen
   }
 
   const interactions = documentation.interactions;
+  const pageStateDiagram = renderPageStateDiagram(state.title || state.url || 'page', state.url || '', interactions || []);
+  if (pageStateDiagram) {
+    lines.push('## State Map');
+    lines.push('');
+    lines.push(`\`\`\`mermaid\n${pageStateDiagram}\n\`\`\``);
+    lines.push('');
+  }
   if (interactions && interactions.length > 0) {
     lines.push('## State Transitions');
     lines.push('');
@@ -101,7 +110,11 @@ function renderPageDocumentation(state: WebPageState, documentation: PageDocumen
     lines.push('');
   }
 
-  return `${lines.join('\n').trimEnd()}\n`;
+  return matter.stringify(`${lines.join('\n').trimEnd()}\n`, {
+    url: state.url,
+    format: APPLICATION_SPEC_FORMAT,
+    version: APPLICATION_SPEC_VERSION,
+  });
 }
 
 function renderSpecIndex(outputDir: string, startPath: string, pages: DocumentedPage[], skipped: SkippedPage[], maxPages: number): string {
@@ -116,9 +129,10 @@ function renderSpecIndex(outputDir: string, startPath: string, pages: Documented
   lines.push(`Max pages: ${maxPages}`);
   lines.push('');
   const graph = buildStateGraph(outputDir, pages);
+  const mermaid = renderMermaidFromGraph(graph, true);
   lines.push('## State Transitions');
   lines.push('');
-  lines.push(`\`\`\`mermaid\n${renderMermaidFromGraph(graph)}\n\`\`\``);
+  lines.push(`\`\`\`mermaid\n${mermaid}\n\`\`\``);
   lines.push('');
   const stateMap = renderStateMapFromGraph(graph);
   if (stateMap) {

package/boat/doc-collector/src/state-diagram.ts

@@ -69,8 +69,12 @@ function buildStateGraph(outputDir: string, pages: DocumentedPage[]): StateGraph
         continue;
       }
 
-      const pairKey = `${sourceId}>${targetId}`;
-      if (adjacency.get(targetId)?.has(sourceId)) {
+      if (adjacency.get(sourceId)?.has(targetId)) {
+        continue;
+      }
+
+      if (createsCycle(sourceId, targetId, adjacency)) {
+        const pairKey = `${sourceId}>${targetId}`;
         if (drawnBack.has(pairKey)) {
           continue;
         }
@@ -78,10 +82,6 @@ function buildStateGraph(outputDir: string, pages: DocumentedPage[]): StateGraph
         edges.push({ source: sourceId, target: targetId, action: transition.action, isBack: true });
         continue;
       }
-
-      if (adjacency.get(sourceId)?.has(targetId) || createsCycle(sourceId, targetId, adjacency)) {
-        continue;
-      }
       adjacency.get(sourceId)?.add(targetId);
       edges.push({ source: sourceId, target: targetId, action: transition.action, isBack: false });
     }
@@ -104,8 +104,8 @@ function renderMermaidBody(outputDir: string, pages: DocumentedPage[]): string {
   return renderMermaidFromGraph(buildStateGraph(outputDir, pages));
 }
 
-function renderMermaidFromGraph(graph: StateGraph): string {
-  const lines: string[] = ['flowchart TD'];
+function renderMermaidFromGraph(graph: StateGraph, compact = false): string {
+  const lines: string[] = [compact ? 'flowchart LR' : 'flowchart TD'];
   if (graph.pages.length === 0) {
     lines.push('  empty["No documented states"]');
     return lines.join('\n');
@@ -117,6 +117,12 @@ function renderMermaidFromGraph(graph: StateGraph): string {
     if (!children || children.length === 0) {
       continue;
     }
+    if (compact) {
+      for (const child of children) {
+        lines.push(`  ${renderNodeLine(child)}`);
+      }
+      continue;
+    }
     lines.push(`  subgraph sg_${page.id} ["${escapeMermaidLabel(page.label)} — transient states"]`);
     for (const child of children) {
       lines.push(`    ${renderNodeLine(child)}`);
@@ -125,11 +131,12 @@ function renderMermaidFromGraph(graph: StateGraph): string {
   }
 
   for (const edge of graph.edges) {
-    let arrow = '-->';
-    if (edge.isBack) {
-      arrow = '-.->';
+    const arrow = edge.isBack ? '-.->' : '-->';
+    if (compact) {
+      lines.push(`  ${edge.source} ${arrow} ${edge.target}`);
+    } else {
+      lines.push(`  ${edge.source} ${arrow}|"${escapeMermaidLabel(edge.action)}"| ${edge.target}`);
     }
-    lines.push(`  ${edge.source} ${arrow}|"${escapeMermaidLabel(edge.action)}"| ${edge.target}`);
   }
 
   lines.push('  classDef page fill:#dbeafe,stroke:#2563eb,color:#0f172a;');
@@ -174,6 +181,46 @@ function renderStateMapFromGraph(graph: StateGraph): string {
   return rows.join('\n');
 }
 
+function renderPageStateDiagram(label: string, url: string, interactions: StateTransition[]): string {
+  const targets = new Map<string, { node: StateNode; action: string; screenshot?: { title: string; relativePath: string } }>();
+  let index = 0;
+  for (const interaction of interactions) {
+    const targetState = interaction.targetState;
+    if (!targetState) {
+      continue;
+    }
+    const key = `${targetState.kind}:${targetState.label}:${normalizeUrl(targetState.url)}`;
+    if (targets.has(key)) {
+      continue;
+    }
+    targets.set(key, {
+      node: { id: `target${index++}`, kind: targetState.kind, label: targetState.label, subLabel: targetState.kind },
+      action: interaction.action,
+      screenshot: interaction.screenshot,
+    });
+  }
+
+  if (targets.size === 0) {
+    return '';
+  }
+
+  const lines: string[] = ['flowchart LR'];
+  lines.push(`  ${renderNodeLine({ id: 'self', kind: 'page', label, subLabel: url })}`);
+  for (const target of targets.values()) {
+    lines.push(`  ${renderNodeLine(target.node)}`);
+  }
+  for (const target of targets.values()) {
+    lines.push(`  self -->|"${escapeMermaidLabel(target.action)}"| ${target.node.id}`);
+  }
+  for (const target of targets.values()) {
+    if (target.screenshot) {
+      lines.push(`  click ${target.node.id} "${target.screenshot.relativePath}" "${escapeMermaidLabel(target.screenshot.title)}"`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
 function renderNodeLine(node: StateNode): string {
   const label = `${escapeMermaidLabel(node.label)}<br/>${escapeMermaidLabel(node.subLabel)}`;
   if (node.kind === 'dialog' || node.kind === 'modal') {
@@ -207,7 +254,7 @@ function createsCycle(sourceId: string, targetId: string, adjacency: Map<string,
 }
 
 function escapeMermaidLabel(value: string): string {
-  return normalizeInlineText(value).replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('|', '&#124;');
+  return normalizeInlineText(value).replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('#', '&#35;').replaceAll('<', '&#60;').replaceAll('>', '&#62;').replaceAll('|', '&#124;');
 }
 
 function escapeTable(value: string): string {
@@ -277,5 +324,5 @@ interface StateGraph {
   classAssignment: Map<StateClass, string[]>;
 }
 
-export { buildStateGraph, renderMermaidBody, renderMermaidFromGraph, renderStateMapFromGraph };
+export { buildStateGraph, renderMermaidBody, renderMermaidFromGraph, renderPageStateDiagram, renderStateMapFromGraph };
 export type { DocumentedPage, SkippedPage, StateGraph, StateNode, StateEdge, StateClick };

package/boat/prima/bin/prima-cli.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env bun
+import { createPrimaCommands } from '../src/cli.ts';
+
+const program = createPrimaCommands('prima');
+program.parse();

package/boat/prima/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "prima",
+  "version": "1.0.0",
+  "description": "High-level browser driver CLI for orchestrating agents",
+  "type": "module",
+  "bin": { "prima": "./bin/prima-cli.ts" },
+  "scripts": {
+    "format": "biome format --write .",
+    "lint:fix": "biome lint --write .",
+    "check:fix": "biome check --write ."
+  },
+  "dependencies": {
+    "commander": "^14.0.1",
+    "dedent": "^1.6.0"
+  }
+}