explorbot 0.0.1

package/dist/src/utils/url-matcher.js

@@ -0,0 +1,48 @@
+import micromatch from 'micromatch';
+export function matchesUrl(pattern, path) {
+    if (pattern === '*')
+        return true;
+    const norm = (s) => s?.replace(/\/+$/, '').toLowerCase();
+    if (norm(pattern) === norm(path))
+        return true;
+    if (pattern.endsWith('/*')) {
+        const base = pattern.slice(0, -2).replace(/\/+$/, '');
+        const normPath = path.replace(/\/+$/, '');
+        if (normPath === base || path.startsWith(`${base}/`))
+            return true;
+    }
+    if (pattern.startsWith('^')) {
+        try {
+            return new RegExp(pattern.slice(1)).test(path);
+        }
+        catch {
+            return false;
+        }
+    }
+    if (pattern.startsWith('~') && pattern.endsWith('~') && pattern.length > 2) {
+        try {
+            return new RegExp(pattern.slice(1, -1)).test(path);
+        }
+        catch {
+            return false;
+        }
+    }
+    try {
+        return micromatch.isMatch(path, pattern);
+    }
+    catch {
+        return false;
+    }
+}
+export function extractStatePath(url) {
+    if (url.startsWith('/'))
+        return url;
+    try {
+        const urlObj = new URL(url);
+        return urlObj.pathname + urlObj.hash;
+    }
+    catch {
+        return url;
+    }
+}
+//# sourceMappingURL=url-matcher.js.map

package/dist/src/utils/url-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-matcher.js","sourceRoot":"","sources":["../../../src/utils/url-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAY;IACtD,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACjE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC;YACH,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/src/utils/web-element.js

@@ -0,0 +1,131 @@
+import { buildClickableXPath, evaluateXPath, isDynamicId, isGenericClass } from "./xpath.js";
+const KEY_DISPLAY_ATTRS = ['role', 'id', 'class', 'aria-label'];
+const KEY_ATTRS = ['role', 'aria-label', 'id', 'name', 'type', 'href'];
+export class WebElement {
+    tag;
+    xpath;
+    clickXPath;
+    attrs;
+    text;
+    outerHTML;
+    x;
+    y;
+    constructor(data) {
+        this.tag = data.tag;
+        this.xpath = data.xpath;
+        this.clickXPath = data.clickXPath;
+        this.attrs = data.attrs;
+        this.text = data.text;
+        this.outerHTML = data.outerHTML || '';
+        this.x = data.x;
+        this.y = data.y;
+    }
+    get description() {
+        const attrParts = KEY_DISPLAY_ATTRS.map((k) => (this.attrs[k] ? `${k}="${this.attrs[k].slice(0, 40)}"` : '')).filter(Boolean);
+        return `<${this.tag} ${attrParts.join(' ')}> text="${this.text.slice(0, 40)}"`;
+    }
+    get keyAttrs() {
+        return KEY_ATTRS.map((k) => (this.attrs[k] ? `${k}="${this.attrs[k]}"` : ''))
+            .filter(Boolean)
+            .join(' ');
+    }
+    get coordinates() {
+        return `(${this.x}, ${this.y})`;
+    }
+    get eidx() {
+        const val = this.attrs['data-explorbot-eidx'] || this.attrs.eidx;
+        return val ? Number.parseInt(val, 10) : null;
+    }
+    get isNavigationLink() {
+        if (this.tag !== 'a')
+            return false;
+        const href = this.attrs.href || '';
+        return !!href && href !== '#' && !href.startsWith('javascript:');
+    }
+    get filteredClasses() {
+        const cls = this.attrs.class || '';
+        return cls.split(/\s+/).filter((c) => c.length > 2 && !isDynamicId(c) && !isGenericClass(c));
+    }
+    static fromRawData(d) {
+        return new WebElement({
+            tag: d.tag,
+            xpath: '',
+            clickXPath: buildClickableXPath({ tag: d.tag, allAttrs: d.allAttrs, text: d.text }),
+            attrs: d.allAttrs,
+            text: d.text,
+            x: d.x,
+            y: d.y,
+        });
+    }
+    static fromXPathMatch(m) {
+        return new WebElement({
+            tag: m.tag,
+            xpath: m.absoluteXPath,
+            clickXPath: buildClickableXPath(m),
+            attrs: m.allAttrs,
+            text: m.text,
+            outerHTML: m.outerHTML,
+            x: 0,
+            y: 0,
+        });
+    }
+    static async fromPlaywrightLocator(locator) {
+        try {
+            const count = await locator.count();
+            if (count === 0)
+                return null;
+            const data = await locator.first().evaluate(extractElementData);
+            if (!data)
+                return null;
+            return WebElement.fromRawData(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    static async fromEidx(page, eidx) {
+        return WebElement.fromPlaywrightLocator(page.locator(`[data-explorbot-eidx="${eidx}"]`));
+    }
+    static async fromEidxList(page, eidxList) {
+        if (eidxList.length === 0)
+            return [];
+        const rawList = await page.evaluate(([list, extractFnStr]) => {
+            const extract = new Function(`return ${extractFnStr}`)();
+            const results = [];
+            for (const eidx of list) {
+                const el = document.querySelector(`[data-explorbot-eidx="${eidx}"]`);
+                if (!el)
+                    continue;
+                const data = extract(el);
+                if (data)
+                    results.push(data);
+            }
+            return results;
+        }, [eidxList, extractElementData.toString()]);
+        return rawList.map((d) => WebElement.fromRawData(d));
+    }
+    static async findByXPath(html, xpath) {
+        const result = await evaluateXPath(html, xpath);
+        if (result.error)
+            return { totalFound: 0, elements: [], error: result.error };
+        return { totalFound: result.totalFound, elements: result.matches.map((m) => WebElement.fromXPathMatch(m)) };
+    }
+}
+function extractElementData(el) {
+    const rect = el.getBoundingClientRect();
+    if (rect.width === 0 && rect.height === 0)
+        return null;
+    const allAttrs = {};
+    for (let i = 0; i < el.attributes.length; i++) {
+        const attr = el.attributes[i];
+        allAttrs[attr.name] = attr.value;
+    }
+    return {
+        tag: el.tagName.toLowerCase(),
+        text: (el.textContent || '').trim().slice(0, 80),
+        allAttrs,
+        x: Math.round(rect.x + rect.width / 2),
+        y: Math.round(rect.y + rect.height / 2),
+    };
+}
+//# sourceMappingURL=web-element.js.map

package/dist/src/utils/web-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-element.js","sourceRoot":"","sources":["../../../src/utils/web-element.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/xpath.js

@@ -0,0 +1,110 @@
+const MAX_MATCHES = 30;
+const MAX_OUTER_HTML = 200;
+const MAX_TEXT = 80;
+function truncate(str, max) {
+    if (str.length <= max)
+        return str;
+    return `${str.slice(0, max)}...`;
+}
+function getAbsoluteXPath(el) {
+    const parts = [];
+    let current = el;
+    while (current && current.nodeType === 1) {
+        const tag = current.tagName.toLowerCase();
+        if (tag === 'html') {
+            current = current.parentElement;
+            continue;
+        }
+        if (tag === 'body') {
+            parts.unshift('body');
+            current = current.parentElement;
+            continue;
+        }
+        let index = 1;
+        let sibling = current.previousElementSibling;
+        while (sibling) {
+            if (sibling.tagName === current.tagName)
+                index++;
+            sibling = sibling.previousElementSibling;
+        }
+        parts.unshift(`${tag}[${index}]`);
+        current = current.parentElement;
+    }
+    return `//${parts.join('/')}`;
+}
+export const isDynamicId = (id) => /^(ember|react|__next)\d|^\d+$/.test(id);
+export const isGenericClass = (cls) => /^ember-view$|^ember\d|^react-|^__next/.test(cls);
+export function buildClickableXPath(el) {
+    const a = el.allAttrs;
+    if (a.id && !isDynamicId(a.id))
+        return `//*[@id="${a.id}"]`;
+    const conditions = [`self::${el.tag}`];
+    if (a.role)
+        conditions.push(`@role="${a.role}"`);
+    if (a['aria-label'])
+        conditions.push(`@aria-label="${a['aria-label']}"`);
+    if (a.class) {
+        const classes = a.class.split(/\s+/).filter((c) => !isGenericClass(c) && c.length > 2);
+        for (const cls of classes.slice(0, 3)) {
+            conditions.push(`contains(@class,"${cls}")`);
+        }
+    }
+    if (el.text && el.text.length > 0 && el.text.length < 40) {
+        conditions.push(`contains(.,"${el.text.replace(/"/g, "'")}")`);
+    }
+    return `//*[${conditions.join(' and ')}]`;
+}
+export function cssToAncestorXPath(css) {
+    const trimmed = css.trim();
+    if (!trimmed)
+        return null;
+    const idMatch = trimmed.match(/^#([\w-]+)$/);
+    if (idMatch)
+        return `@id="${idMatch[1]}"`;
+    const tagClassMatch = trimmed.match(/^(\w+)\.([\w-]+)$/);
+    if (tagClassMatch)
+        return `self::${tagClassMatch[1]} and contains(@class,"${tagClassMatch[2]}")`;
+    const classMatch = trimmed.match(/^\.([\w-]+)$/);
+    if (classMatch)
+        return `contains(@class,"${classMatch[1]}")`;
+    const attrMatch = trimmed.match(/^\[([^\]]+)\]$/);
+    if (attrMatch)
+        return `@${attrMatch[1]}`;
+    return null;
+}
+export async function evaluateXPath(html, xpath) {
+    const { JSDOM } = await import('jsdom');
+    const dom = new JSDOM(html);
+    try {
+        const doc = dom.window.document;
+        const result = doc.evaluate(xpath, doc, null, 7, null);
+        const matches = [];
+        const totalFound = result.snapshotLength;
+        for (let i = 0; i < Math.min(totalFound, MAX_MATCHES); i++) {
+            const node = result.snapshotItem(i);
+            if (!node || node.nodeType !== 1)
+                continue;
+            const el = node;
+            const allAttrs = {};
+            for (let a = 0; a < el.attributes.length; a++) {
+                const attr = el.attributes[a];
+                allAttrs[attr.name] = attr.value;
+            }
+            matches.push({
+                tag: el.tagName.toLowerCase(),
+                outerHTML: truncate(el.outerHTML, MAX_OUTER_HTML),
+                text: truncate(el.textContent?.trim() || '', MAX_TEXT),
+                absoluteXPath: getAbsoluteXPath(el),
+                allAttrs,
+            });
+        }
+        return { totalFound, matches };
+    }
+    catch (err) {
+        return { totalFound: 0, matches: [], error: err?.message || 'XPath evaluation failed' };
+    }
+    finally {
+        dom.window.close();
+    }
+}
+//# sourceMappingURL=xpath.js.map

package/dist/src/utils/xpath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath.js","sourceRoot":"","sources":["../../../src/utils/xpath.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "explorbot",
+  "version": "0.0.1",
+  "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
+  "license": "Elastic-2.0",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "bin": {
+    "explorbot": "./dist/bin/explorbot-cli.js"
+  },
+  "files": ["dist/", "rules/", "assets/sample-files/", "prompts/"],
+  "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"],
+  "author": "",
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0",
+    "@ai-sdk/groq": "^3.0",
+    "@ai-sdk/openai": "^3.0",
+    "@axe-core/playwright": "^4.11.0",
+    "@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.3",
+    "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",
+    "@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/prompts/audit-rules.md

@@ -0,0 +1,124 @@
+# Prompt Audit System for Web Navigation/Testing Rules
+
+You are an expert prompt engineer specializing in AI-driven web testing automation. Your task is to audit the prompts and rules used for web navigation and testing in this codebase.
+
+## Files to Analyze
+
+1. **`@src/ai/rules.ts`** - Core rules and guidelines for locators, actions, and verification
+2. **`@src/ai/navigator.ts`** - Uses rules in prompts for navigation and verification
+3. **`@src/ai/tools.ts`** - Tool definitions that include locator rules and guidance
+
+## Audit Checklist
+
+### 1. Rules Analysis (`rules.ts`)
+
+Look for:
+- **Contradictions**: Rules that conflict with each other (e.g., "prefer ARIA" vs "use text first")
+- **Ambiguity**: Vague guidance that could be interpreted multiple ways
+- **Incomplete guidance**: Missing priority order, missing edge cases
+- **Locator priority**: Is ARIA → Text → CSS → XPath clearly defined?
+- **Disambiguation**: How to choose between multiple matching elements?
+- **Context parameter**: When and how to use it?
+- **Short vs Long locators**: Clear definitions?
+- **Unused rules**: Exported but never imported anywhere
+
+### 2. Rule Usage Analysis (`navigator.ts`)
+
+Check:
+- **Imported but unused**: Rules imported but not used in prompts
+- **Missing rules**: Prompts that should include locatorRule or actionRule but don't
+- **Duplication**: Inline rules that duplicate what's in rules.ts
+- **Consistency**: Do prompts follow the same structure?
+- **HTML tags**: Is HTML content wrapped in `<page_html>` tags?
+
+### 3. Tools Analysis (`tools.ts`)
+
+Verify:
+- **locatorRule usage**: Do tools that accept locators include locatorRule?
+- **Input schema descriptions**: Do they mention "ARIA, CSS or XPath"?
+- **Suggestions on failure**: Do failed results provide helpful suggestions?
+- **Unreachable code paths**: Logic that can never execute (like type with undefined locator)
+- **Consistent error handling**: Same pattern across all tools
+- **Tool differentiation**: Clear when to use click vs clickByText, type with/without locator
+
+## Severity Levels
+
+| Severity | Description | Examples |
+|----------|-------------|----------|
+| **🔴 Critical** | Breaks functionality or causes wrong behavior | Contradictory rules, unreachable code, missing required rules |
+| **🟠 High** | Significant confusion or incorrect guidance | Ambiguous priority, misleading examples, wrong format |
+| **🟡 Medium** | Suboptimal but functional | Redundant rules, verbose descriptions, missing suggestions |
+| **🟢 Minor** | Cosmetic or style issues | Typos, formatting, inconsistent spacing |
+
+## Output Format
+
+Structure your findings as follows:
+
+```markdown
+## Audit Results
+
+### Critical Issues 🔴
+1. **[File:Line]** Issue description
+   - Impact: What goes wrong
+   - Fix: Suggested resolution
+
+### High Priority Issues 🟠
+1. **[File:Line]** Issue description
+   - Impact: What confusion this causes
+   - Fix: Suggested resolution
+
+### Medium Priority Issues 🟡
+1. **[File:Line]** Issue description
+   - Impact: Why this matters
+   - Fix: Suggested resolution
+
+### Minor Issues 🟢
+1. **[File:Line]** Issue description
+   - Fix: Suggested resolution
+
+### Observations
+- General patterns noticed
+- Recommendations for improvement
+- Questions for clarification
+```
+
+## Specific Things to Check
+
+### Locator Rules
+- [ ] Priority order clearly defined (ARIA → Text → CSS → XPath)
+- [ ] Context parameter explained (when to use, which tools support it)
+- [ ] Disambiguation strategy documented (form flow, ARIA state, proximity)
+- [ ] Short vs Long locators defined
+- [ ] Examples consistent with rules (single quotes vs double quotes in JSON)
+
+### Action Rules
+- [ ] Function signatures included (I.click, I.fillField, I.see, etc.)
+- [ ] Required parameters explained (context for I.see)
+- [ ] Prohibited actions listed (no wait functions, no amOnPage)
+- [ ] Examples match documented format
+
+### Verification Rules
+- [ ] I.see requires context parameter
+- [ ] I.seeElement prefers ARIA locators
+- [ ] Strictness rules to avoid false positives
+- [ ] Examples show correct usage
+
+### Tool Definitions
+- [ ] Each tool includes relevant rules (locatorRule where needed)
+- [ ] Input schemas describe all locator types
+- [ ] Failed results include actionable suggestions
+- [ ] Description explains when to use this tool vs alternatives
+
+## Run This Audit
+
+To run this audit, execute:
+
+```
+Please analyze the following files for prompt/rule issues:
+@src/ai/rules.ts
+@src/ai/navigator.ts  
+@src/ai/tools.ts
+
+Follow the audit checklist and output format defined in @prompts/audit-rules.md
+```
+

package/rules/chief/general.md

@@ -0,0 +1,11 @@
+- Each scenario must be a complete, independent test
+- Steps should specify exact HTTP methods, paths, and key payload details
+- Expected outcomes should be specific and verifiable (status codes, response fields, error messages)
+- For CRUD operations, each test should handle its own setup and teardown
+- Expect standard REST conventions: 200 OK, 201 Created, 204 No Content, 400 Bad Request, 404 Not Found, 422 Unprocessable Entity
+- NEVER propose scenarios that test the same thing. "Create a basic suite" and "Successful creation of a simple suite" are DUPLICATES. Each scenario must test a DISTINCT behavior or aspect.
+- Before finalizing, review all scenarios and remove any that overlap in what they actually verify.
+
+API Usage Notes:
+
+- String is usually compatible with other data formats such as numbers or datetime, so do not check if number type strictly matches to number as it can be string too

package/rules/chief/styles/curious.md

@@ -0,0 +1,12 @@
+Maximize coverage by using every field and endpoint the API offers.
+
+Focus on:
+- Full payload create: POST with ALL optional and required fields populated, verify every field was saved
+- Field-by-field update: PATCH/PUT each field individually, verify the change persists via GET
+- Mixed combinations: create with some optional fields set and others omitted, then update the missing ones
+- Array fields: send multiple items in arrays, not just one — verify all items are stored
+- Enum fields: try every valid enum value, verify each is accepted and returned correctly
+- Related fields: if spec shows related IDs or nested objects, populate them all
+- All endpoints: exercise every available endpoint for the resource, not just the main CRUD
+- Multiple resources: create several items, list them, verify count and content
+- Default values: omit optional fields on create, then GET to see what defaults the API assigns

package/rules/chief/styles/hacker.md

@@ -0,0 +1,19 @@
+Analyze the request log and API spec to discover hidden endpoints, undocumented properties, and unprotected actions — then try to exploit them.
+
+Study previous responses carefully:
+- Look at response field names and values — guess related endpoints and properties not in the spec
+- If a response contains fields like "user_id", "org_id", "role" — try sending them on create/update to see if it is possible to self-promote
+- If responses include URLs or paths — follow them, they may reveal internal routes
+- Guess hidden endpoints by looking at response fields
+- If IDs are sequential — try adjacent IDs to access other users' resources
+- Try to create tests with custom ID values to see if they are accepted
+- If a response shows more fields than the spec defines — those extra fields are attack surface
+
+Use schemaFor to discover related endpoints, then try HTTP methods the spec doesn't list for them.
+Derive endpoint patterns from what you've seen — if /items exists, try /items/export, /items/bulk, /items/search.
+Send fields from GET responses back in POST/PUT — check which ones the server silently accepts.
+Try overriding read-only or server-computed fields you observed in responses.
+Strip or corrupt auth headers on sensitive operations to test enforcement.
+
+Every unexpected finding must be recorded immediately.
+Unclosed hidden exploits must be recorded as a failure.

package/rules/chief/styles/normal.md

@@ -0,0 +1,11 @@
+Focus on standard CRUD operations and happy-path flows.
+
+Test each HTTP method the endpoint supports:
+- POST: Create a new resource with valid data, verify 201 and response body
+- PUT/PATCH: Update the resource, verify changes persist
+- DELETE: Remove the resource, verify 204/200 and subsequent GET returns 404
+- GET: obtain data, list by filters, by search
+
+Validate response schemas match expected structure.
+Check that required fields are present in responses.
+Verify correct HTTP status codes for each operation.

package/rules/chief/styles/psycho.md

@@ -0,0 +1,17 @@
+Stress-test the endpoint with invalid, malformed, and extreme inputs.
+
+Focus on:
+
+- Missing required fields: send partial payloads, empty objects, empty body
+- Malformed JSON: trailing commas, unquoted keys, broken UTF-8
+- SQL injection
+- XSS payloads
+- Exposed secrets: passwords, tokens, etc
+- Wrong Content-Type: send form data as JSON, JSON as XML
+- Invalid HTTP methods: PATCH on POST-only endpoints
+- Boundary values: negative numbers, zero, MAX_INT, empty arrays, null values
+- Date fields: set creation date in future, and expiring date to past
+
+Expect proper responses with meaningful error messages if related.
+If server strips broken data it is ok
+Responses must be carefully validated to contain correct and secure data