explorbot 0.0.1 → 0.1.0

package/src/commands/test-command.ts

@@ -0,0 +1,84 @@
+import { Test } from '../test-plan.js';
+import { tag } from '../utils/logger.js';
+import { BaseCommand } from './base-command.js';
+
+export class TestCommand extends BaseCommand {
+  name = 'test';
+  description = 'Launch tester agent to execute test scenarios';
+  suggestions = ['/test - to run next test', '/plan - to create new plan'];
+
+  async execute(args: string): Promise<void> {
+    const plan = this.explorBot.getCurrentPlan();
+    const toExecute: Test[] = [];
+
+    const requirePlan = () => {
+      if (!plan) throw new Error('No plan found. Please run /plan first to create test scenarios.');
+      return plan;
+    };
+
+    if (!args) {
+      const pending = requirePlan().getPendingTests();
+      if (pending.length === 0) {
+        throw new Error('All tests are already complete. Please run /plan to create new test scenarios.');
+      }
+      toExecute.push(pending[0]);
+    } else if (args === '*' || args === 'all') {
+      toExecute.push(...requirePlan().getPendingTests());
+    } else if (args.match(/^[\d,\-\s]+$/)) {
+      const pending = requirePlan().getPendingTests();
+      const indices = parseTestIndices(args, pending.length);
+      for (const idx of indices) {
+        toExecute.push(pending[idx]);
+      }
+    } else {
+      const matching = plan?.getPendingTests().filter((test) => test.scenario.toLowerCase().includes(args.toLowerCase())) || [];
+      if (matching.length > 0) {
+        toExecute.push(...matching);
+      } else {
+        const state = this.explorBot.getExplorer().getStateManager().getCurrentState();
+        if (!state) {
+          throw new Error('No page loaded. Please navigate to a page first.');
+        }
+        const newTest = new Test(args, 'unknown', [], state.url);
+        if (plan) {
+          plan.addTest(newTest);
+          tag('info').log(`Created new test: "${args}" and added to current plan.`);
+        } else {
+          tag('info').log(`Created ad-hoc test: "${args}"`);
+        }
+        toExecute.push(newTest);
+      }
+    }
+
+    if (toExecute.length === 0) {
+      throw new Error('No tests to execute.');
+    }
+
+    tag('info').log(`Launching ${toExecute.length} test scenario(s).`);
+    const tester = this.explorBot.agentTester();
+    for (const test of toExecute) {
+      await tester.test(test);
+    }
+    tag('success').log('Test execution finished');
+  }
+}
+
+function parseTestIndices(input: string, total: number): number[] {
+  const indices = new Set<number>();
+
+  const addIndex = (n: number) => {
+    if (n < 1 || n > total) throw new Error(`Test #${n} not found. Available: 1-${total}`);
+    indices.add(n - 1);
+  };
+
+  for (const part of input.split(',')) {
+    const trimmed = part.trim();
+    const range = trimmed.match(/^(\d+)-(\d+)$/);
+    if (range) {
+      for (let i = Number.parseInt(range[1]); i <= Number.parseInt(range[2]); i++) addIndex(i);
+    } else {
+      addIndex(Number.parseInt(trimmed));
+    }
+  }
+  return [...indices].sort((a, b) => a - b);
+}

package/src/components/ActivityPane.tsx

@@ -0,0 +1,80 @@
+import { Box, Text } from 'ink';
+import React from 'react';
+import { useEffect, useState } from 'react';
+import { type ActivityEntry, addActivityListener, removeActivityListener } from '../activity.ts';
+
+interface ActivityPaneProps {
+  isInputVisible?: boolean;
+}
+
+const ActivityPane: React.FC<ActivityPaneProps> = React.memo(({ isInputVisible = false }) => {
+  const [activity, setActivity] = useState<ActivityEntry | null>(null);
+  const [animationState, setAnimationState] = useState(0);
+
+  useEffect(() => {
+    const listener = (newActivity: ActivityEntry | null) => {
+      setActivity(newActivity);
+    };
+
+    addActivityListener(listener);
+
+    return () => {
+      removeActivityListener(listener);
+    };
+  }, []);
+
+  useEffect(() => {
+    if (!activity) return;
+
+    const interval = setInterval(() => {
+      setAnimationState((prev) => (prev + 1) % 4);
+    }, 1200);
+
+    return () => clearInterval(interval);
+  }, [activity]);
+
+  if (!activity) {
+    if (isInputVisible) {
+      return (
+        <Box height={1} paddingX={1}>
+          <Text dimColor>Enter command or press Enter to continue</Text>
+        </Box>
+      );
+    }
+    return (
+      <Box height={1} paddingX={1}>
+        <Text dimColor>Done. Press [ESC] to enable input. Press [CTRL + t] to toggle session timer.</Text>
+      </Box>
+    );
+  }
+
+  const getActivityColor = (type: ActivityEntry['type']) => {
+    switch (type) {
+      case 'ai':
+        return 'cyan';
+      case 'action':
+        return 'green';
+      case 'navigation':
+        return 'blue';
+      default:
+        return 'yellow';
+    }
+  };
+
+  const getDots = () => {
+    return '.'.repeat(animationState);
+  };
+
+  const isDimmed = animationState % 2 === 0;
+
+  return (
+    <Box height={1} marginY={1} paddingX={1}>
+      <Text color={getActivityColor(activity.type)} dimColor={isDimmed}>
+        {activity.message}
+        {getDots()}
+      </Text>
+    </Box>
+  );
+});
+
+export default ActivityPane;

package/src/components/AddKnowledge.tsx

@@ -0,0 +1,169 @@
+import { Box, Text, useInput } from 'ink';
+import React, { useEffect, useState } from 'react';
+import { KnowledgeTracker } from '../knowledge-tracker.js';
+import InputReadline from './InputReadline.js';
+
+interface AddKnowledgeProps {
+  initialUrl?: string;
+  onComplete?: () => void;
+  onCancel?: () => void;
+}
+
+const AddKnowledge: React.FC<AddKnowledgeProps> = ({ initialUrl = '', onComplete, onCancel }) => {
+  const [urlPattern, setUrlPattern] = useState(initialUrl);
+  const [description, setDescription] = useState('');
+  const [activeField, setActiveField] = useState<'url' | 'description'>(initialUrl ? 'description' : 'url');
+  const [suggestedUrls, setSuggestedUrls] = useState<string[]>([]);
+  const [existingKnowledge, setExistingKnowledge] = useState<string[]>([]);
+
+  const isStandalone = !onComplete;
+
+  useEffect(() => {
+    try {
+      const knowledgeTracker = new KnowledgeTracker();
+      const urls = knowledgeTracker.getExistingUrls();
+      setSuggestedUrls(urls);
+    } catch (error) {
+      console.error('Failed to load suggestions:', error);
+    }
+  }, []);
+
+  useEffect(() => {
+    if (urlPattern.trim()) {
+      try {
+        const knowledgeTracker = new KnowledgeTracker();
+        const knowledge = knowledgeTracker.getKnowledgeForUrl(urlPattern);
+        setExistingKnowledge(knowledge);
+      } catch (error) {
+        console.error('Failed to load existing knowledge:', error);
+        setExistingKnowledge([]);
+      }
+    } else {
+      setExistingKnowledge([]);
+    }
+  }, [urlPattern]);
+
+  const handleSave = () => {
+    if (!urlPattern.trim() || !description.trim()) {
+      return;
+    }
+
+    try {
+      const knowledgeTracker = new KnowledgeTracker();
+      const result = knowledgeTracker.addKnowledge(urlPattern.trim(), description.trim());
+      const action = result.isNewFile ? 'Created' : 'Updated';
+      console.log(`\nKnowledge ${action} in: ${result.filename}`);
+
+      if (isStandalone) {
+        process.exit(0);
+      } else {
+        onComplete?.();
+      }
+    } catch (error) {
+      console.error(`\nFailed to save knowledge: ${error instanceof Error ? error.message : 'Unknown error'}`);
+      if (isStandalone) {
+        process.exit(1);
+      }
+    }
+  };
+
+  const handleUrlSubmit = () => {
+    if (urlPattern.trim()) {
+      setActiveField('description');
+    }
+  };
+
+  const handleDescriptionSubmit = () => {
+    if (description.trim()) {
+      handleSave();
+    }
+  };
+
+  useInput((input, key) => {
+    if (key.ctrl && input === 'c') {
+      if (isStandalone) {
+        process.exit(0);
+      } else {
+        onCancel?.();
+      }
+    }
+
+    if (key.escape) {
+      if (!isStandalone) {
+        onCancel?.();
+      }
+    }
+
+    if (key.tab) {
+      if (activeField === 'url' && urlPattern.trim()) {
+        setActiveField('description');
+      } else if (activeField === 'description') {
+        setActiveField('url');
+      }
+    }
+  });
+
+  return (
+    <Box flexDirection="column" padding={1}>
+      <Box marginBottom={1}>
+        <Text color="cyan" bold>
+          Add Knowledge
+        </Text>
+      </Box>
+
+      <Box marginBottom={1} flexDirection="column">
+        <Box marginBottom={1}>
+          <Text color={activeField === 'url' ? 'blue' : 'gray'}>URL Pattern:</Text>
+        </Box>
+        <Box borderStyle="single" borderColor={activeField === 'url' ? 'blue' : 'gray'} paddingX={1}>
+          <InputReadline value={urlPattern} onChange={setUrlPattern} onSubmit={handleUrlSubmit} placeholder={suggestedUrls.length > 0 ? suggestedUrls[0] : '/login, *, ^/admin'} isActive={activeField === 'url'} showPrompt={false} />
+        </Box>
+        <Text color="gray" dimColor>
+          Wildcards (*) or regexes (^pattern, ~pattern)
+        </Text>
+      </Box>
+
+      {existingKnowledge.length > 0 && (
+        <Box marginBottom={1} flexDirection="column">
+          <Box marginBottom={1}>
+            <Text color="yellow" bold>
+              Existing Knowledge:
+            </Text>
+          </Box>
+          <Box borderStyle="single" borderColor="gray" paddingX={1} flexDirection="column">
+            {existingKnowledge.map((knowledge, index) => (
+              <Box key={index} flexDirection="column" marginBottom={index < existingKnowledge.length - 1 ? 1 : 0}>
+                <Text color="gray">{knowledge}</Text>
+                {index < existingKnowledge.length - 1 && (
+                  <Text color="gray" dimColor>
+                    ---
+                  </Text>
+                )}
+              </Box>
+            ))}
+          </Box>
+        </Box>
+      )}
+
+      <Box marginBottom={1} flexDirection="column">
+        <Box marginBottom={1}>
+          <Text color={activeField === 'description' ? 'blue' : 'gray'}>Description:</Text>
+        </Box>
+        <Box borderStyle="single" borderColor={activeField === 'description' ? 'blue' : 'gray'} paddingX={1}>
+          <InputReadline value={description} onChange={setDescription} onSubmit={handleDescriptionSubmit} placeholder="Describe actions, locators, or page behavior..." isActive={activeField === 'description'} showPrompt={false} />
+        </Box>
+        <Text color="gray" dimColor>
+          Actions, locators, validation rules
+        </Text>
+      </Box>
+
+      <Box marginTop={1}>
+        <Text color="gray" dimColor>
+          Tab: Switch | Enter: Next/Save | {isStandalone ? 'Ctrl+C' : 'Esc'}: Exit
+        </Text>
+      </Box>
+    </Box>
+  );
+};
+
+export default AddKnowledge;

package/src/components/AddRule.tsx

@@ -0,0 +1,174 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { Box, Text, useInput } from 'ink';
+import React, { useEffect, useState } from 'react';
+import { AddRuleCommand } from '../commands/add-rule-command.js';
+import InputReadline from './InputReadline.js';
+
+const KNOWN_AGENTS = ['researcher', 'tester', 'planner', 'pilot', 'captain', 'bosun', 'navigator'];
+
+interface AddRuleProps {
+  initialAgent?: string;
+  initialName?: string;
+  onComplete?: () => void;
+  onCancel?: () => void;
+}
+
+const AddRule: React.FC<AddRuleProps> = ({ initialAgent = '', initialName = '', onComplete, onCancel }) => {
+  const [agent, setAgent] = useState(initialAgent);
+  const [ruleName, setRuleName] = useState(initialName);
+  const [urlPattern, setUrlPattern] = useState('');
+  const [content, setContent] = useState('');
+  const [activeField, setActiveField] = useState<'agent' | 'name' | 'url' | 'content'>(initialAgent ? (initialName ? 'url' : 'name') : 'agent');
+  const [existingRules, setExistingRules] = useState<string[]>([]);
+
+  const isStandalone = !onComplete;
+
+  useEffect(() => {
+    if (!agent.trim()) {
+      setExistingRules([]);
+      return;
+    }
+    const rulesDir = join(process.cwd(), 'rules', agent);
+    if (!existsSync(rulesDir)) {
+      setExistingRules([]);
+      return;
+    }
+    const files = readdirSync(rulesDir)
+      .filter((f) => f.endsWith('.md'))
+      .map((f) => f.replace(/\.md$/, ''));
+    setExistingRules(files);
+  }, [agent]);
+
+  const handleSave = () => {
+    if (!agent.trim() || !ruleName.trim() || !content.trim()) return;
+
+    const result = AddRuleCommand.createRuleFile(agent.trim(), ruleName.trim(), {
+      content: content.trim(),
+      urlPattern: urlPattern.trim() || undefined,
+    });
+
+    if (isStandalone) {
+      process.exit(result ? 0 : 1);
+    } else {
+      onComplete?.();
+    }
+  };
+
+  const fields: Array<'agent' | 'name' | 'url' | 'content'> = ['agent', 'name', 'url', 'content'];
+
+  const advanceField = () => {
+    const idx = fields.indexOf(activeField);
+    if (idx < fields.length - 1) {
+      setActiveField(fields[idx + 1]);
+    }
+  };
+
+  useInput((input, key) => {
+    if (key.ctrl && input === 'c') {
+      if (isStandalone) {
+        process.exit(0);
+      } else {
+        onCancel?.();
+      }
+    }
+
+    if (key.escape && !isStandalone) {
+      onCancel?.();
+    }
+
+    if (key.tab) {
+      advanceField();
+    }
+  });
+
+  return (
+    <Box flexDirection="column" padding={1}>
+      <Box marginBottom={1}>
+        <Text color="cyan" bold>
+          Add Rule
+        </Text>
+      </Box>
+
+      <Box marginBottom={1} flexDirection="column">
+        <Box marginBottom={1}>
+          <Text color={activeField === 'agent' ? 'blue' : 'gray'}>Agent:</Text>
+        </Box>
+        <Box borderStyle="single" borderColor={activeField === 'agent' ? 'blue' : 'gray'} paddingX={1}>
+          <InputReadline
+            value={agent}
+            onChange={setAgent}
+            onSubmit={() => {
+              if (agent.trim()) advanceField();
+            }}
+            placeholder={KNOWN_AGENTS.join(', ')}
+            isActive={activeField === 'agent'}
+            showPrompt={false}
+          />
+        </Box>
+      </Box>
+
+      {existingRules.length > 0 && (
+        <Box marginBottom={1} flexDirection="column">
+          <Text color="yellow">Existing rules: {existingRules.join(', ')}</Text>
+        </Box>
+      )}
+
+      <Box marginBottom={1} flexDirection="column">
+        <Box marginBottom={1}>
+          <Text color={activeField === 'name' ? 'blue' : 'gray'}>Rule name:</Text>
+        </Box>
+        <Box borderStyle="single" borderColor={activeField === 'name' ? 'blue' : 'gray'} paddingX={1}>
+          <InputReadline
+            value={ruleName}
+            onChange={setRuleName}
+            onSubmit={() => {
+              if (ruleName.trim()) advanceField();
+            }}
+            placeholder="e.g. check-tooltips, wait-for-toasts"
+            isActive={activeField === 'name'}
+            showPrompt={false}
+          />
+        </Box>
+        <Text color="gray" dimColor>
+          Saved as rules/{agent || '<agent>'}/{ruleName || '<name>'}.md
+        </Text>
+      </Box>
+
+      <Box marginBottom={1} flexDirection="column">
+        <Box marginBottom={1}>
+          <Text color={activeField === 'url' ? 'blue' : 'gray'}>URL pattern (optional):</Text>
+        </Box>
+        <Box borderStyle="single" borderColor={activeField === 'url' ? 'blue' : 'gray'} paddingX={1}>
+          <InputReadline value={urlPattern} onChange={setUrlPattern} onSubmit={advanceField} placeholder="Leave empty for all URLs, or /admin/*, /checkout, etc." isActive={activeField === 'url'} showPrompt={false} />
+        </Box>
+      </Box>
+
+      <Box marginBottom={1} flexDirection="column">
+        <Box marginBottom={1}>
+          <Text color={activeField === 'content' ? 'blue' : 'gray'}>Rule content:</Text>
+        </Box>
+        <Box borderStyle="single" borderColor={activeField === 'content' ? 'blue' : 'gray'} paddingX={1}>
+          <InputReadline
+            value={content}
+            onChange={setContent}
+            onSubmit={() => {
+              if (content.trim()) handleSave();
+            }}
+            placeholder="Instructions for the agent..."
+            isActive={activeField === 'content'}
+            showPrompt={false}
+          />
+        </Box>
+      </Box>
+
+      <Box marginTop={1}>
+        <Text color="gray" dimColor>
+          Tab: Next field | Enter: Next/Save | {isStandalone ? 'Ctrl+C' : 'Esc'}: Exit
+        </Text>
+      </Box>
+    </Box>
+  );
+};
+
+export default AddRule;