vektor-slipstream 1.4.4 → 2.0.0

package/cloak-behaviour.js

@@ -1,596 +0,0 @@
-'use strict';
-
-/**
- * cloak-behaviour.js — Human behaviour noise injection for Playwright
- * ─────────────────────────────────────────────────────────────────────────────
- * Records and replays real human mouse/scroll/keyboard patterns inside
- * Playwright sessions. Defeats reCAPTCHA v3, Cloudflare, DataDome and
- * similar behavioural fingerprinting systems.
- *
- * How it works:
- *   1. Pre-recorded sessions: timestamped event streams captured from real
- *      human browsing, normalised to viewport-relative coordinates (0-1 range)
- *      so they scale to any window size on replay.
- *
- *   2. Replay engine: walks the event stream, reconstructing real timing gaps
- *      via page.waitForTimeout(). Events go through Playwright's CDP layer —
- *      identical to hardware input at the browser fingerprinting level.
- *
- *   3. Procedural synthesis: for cases without a matching recorded pattern,
- *      generates statistically realistic movement using Gaussian velocity
- *      curves, Bezier paths, and natural micro-pause distributions.
- *
- * Usage:
- *   const { injectBehaviour, replayPattern, randomPattern } = require('./cloak-behaviour');
- *
- *   // High-level: auto-pick a pattern for the context
- *   await injectBehaviour(page, 'reading');       // reading a page
- *   await injectBehaviour(page, 'form');          // filling a form
- *   await injectBehaviour(page, 'shopping');      // browsing a product list
- *   await injectBehaviour(page, 'login');         // login page interaction
- *
- *   // Low-level: replay a specific named pattern
- *   await replayPattern(page, 'deep-scroll-read');
- *
- *   // Record your own: paste cloak-recorder-snippet.js into browser DevTools
- *   // then load the JSON with: loadCustomPattern('my-pattern', json)
- * ─────────────────────────────────────────────────────────────────────────────
- */
-
-const path = require('path');
-const fs   = require('fs');
-const os   = require('os');
-
-// ── Pre-recorded pattern library ──────────────────────────────────────────────
-// Coordinates are NORMALISED: x/y in 0.0–1.0 range relative to viewport.
-// Timing gaps (dt) are in milliseconds.
-// Captured from real human browsing sessions, then sanitised.
-
-const PATTERN_LIBRARY = {
-
-  // ── Pattern: reading — user lands, reads top of page, scrolls slowly ────────
-  'reading': {
-    category:    'reading',
-    viewport:    { w: 1440, h: 900 },
-    durationMs:  8200,
-    description: 'Land on page, read hero content, slow scroll through body',
-    events: [
-      // Initial landing — cursor in upper-middle, small drift while reading
-      { dt: 0,    type: 'move',   x: 0.52, y: 0.18 },
-      { dt: 312,  type: 'move',   x: 0.53, y: 0.19 },
-      { dt: 489,  type: 'move',   x: 0.54, y: 0.19 },
-      { dt: 823,  type: 'move',   x: 0.53, y: 0.20 },
-      // Pause — reading headline
-      { dt: 1640, type: 'pause' },
-      { dt: 2180, type: 'move',   x: 0.41, y: 0.28 },
-      { dt: 2290, type: 'move',   x: 0.43, y: 0.30 },
-      // Slow scroll — reading body
-      { dt: 2800, type: 'scroll', dy: 80  },
-      { dt: 2980, type: 'scroll', dy: 100 },
-      { dt: 3190, type: 'scroll', dy: 90  },
-      { dt: 3510, type: 'scroll', dy: 60  },
-      // Pause mid-page — reading
-      { dt: 4100, type: 'pause' },
-      { dt: 4380, type: 'move',   x: 0.38, y: 0.44 },
-      { dt: 4490, type: 'move',   x: 0.40, y: 0.46 },
-      { dt: 4920, type: 'scroll', dy: 120 },
-      { dt: 5100, type: 'scroll', dy: 110 },
-      { dt: 5340, type: 'scroll', dy: 130 },
-      { dt: 5600, type: 'scroll', dy: 80  },
-      // Brief hover over a link (not clicking)
-      { dt: 6100, type: 'move',   x: 0.45, y: 0.58 },
-      { dt: 6210, type: 'move',   x: 0.46, y: 0.59 },
-      { dt: 6320, type: 'move',   x: 0.47, y: 0.59 },
-      { dt: 6800, type: 'pause' },
-      { dt: 7200, type: 'scroll', dy: 90  },
-      { dt: 7380, type: 'scroll', dy: 70  },
-      { dt: 7900, type: 'move',   x: 0.50, y: 0.65 },
-      { dt: 8100, type: 'move',   x: 0.51, y: 0.66 },
-    ],
-  },
-
-  // ── Pattern: form — navigate to form, fill fields with natural timing ────────
-  'form': {
-    category:    'form',
-    viewport:    { w: 1440, h: 900 },
-    durationMs:  9800,
-    description: 'Approach form, click fields with realistic inter-key timing',
-    events: [
-      { dt: 0,    type: 'move',   x: 0.50, y: 0.30 },
-      { dt: 280,  type: 'move',   x: 0.48, y: 0.35 },
-      { dt: 490,  type: 'move',   x: 0.47, y: 0.38 },
-      // Approach first input field
-      { dt: 820,  type: 'move',   x: 0.45, y: 0.42 },
-      { dt: 940,  type: 'move',   x: 0.44, y: 0.43 },
-      { dt: 1100, type: 'click',  x: 0.44, y: 0.43 },
-      // Typing pause (realistic inter-keystroke)
-      { dt: 1420, type: 'pause' },
-      { dt: 1680, type: 'pause' },
-      { dt: 2100, type: 'pause' },
-      // Tab to next field — slight mouse movement
-      { dt: 2800, type: 'move',   x: 0.44, y: 0.52 },
-      { dt: 2960, type: 'move',   x: 0.44, y: 0.53 },
-      { dt: 3100, type: 'click',  x: 0.44, y: 0.53 },
-      { dt: 3380, type: 'pause' },
-      { dt: 3720, type: 'pause' },
-      { dt: 4200, type: 'pause' },
-      // Brief scroll to see submit button
-      { dt: 4900, type: 'scroll', dy: 80  },
-      { dt: 5100, type: 'move',   x: 0.44, y: 0.63 },
-      { dt: 5280, type: 'move',   x: 0.44, y: 0.64 },
-      { dt: 5400, type: 'click',  x: 0.44, y: 0.64 },
-      { dt: 5680, type: 'pause' },
-      { dt: 6100, type: 'pause' },
-      // Hover over submit — realistic pre-click hesitation
-      { dt: 7200, type: 'move',   x: 0.38, y: 0.74 },
-      { dt: 7380, type: 'move',   x: 0.39, y: 0.74 },
-      { dt: 7540, type: 'move',   x: 0.40, y: 0.75 },
-      { dt: 7820, type: 'pause' },
-      // Submit click
-      { dt: 8400, type: 'move',   x: 0.40, y: 0.75 },
-      { dt: 8600, type: 'click',  x: 0.40, y: 0.75 },
-    ],
-  },
-
-  // ── Pattern: shopping — browse product grid, hover items, scroll ─────────────
-  'shopping': {
-    category:    'shopping',
-    viewport:    { w: 1440, h: 900 },
-    durationMs:  11400,
-    description: 'Browse product listing, hover items, deep scroll, occasional backtrack',
-    events: [
-      { dt: 0,    type: 'move',   x: 0.22, y: 0.28 },
-      { dt: 290,  type: 'move',   x: 0.24, y: 0.30 },
-      // Hover first product
-      { dt: 580,  type: 'move',   x: 0.25, y: 0.32 },
-      { dt: 790,  type: 'pause' },
-      // Move to second product
-      { dt: 1400, type: 'move',   x: 0.52, y: 0.32 },
-      { dt: 1590, type: 'move',   x: 0.53, y: 0.33 },
-      { dt: 1780, type: 'pause' },
-      // Scroll down
-      { dt: 2300, type: 'scroll', dy: 150 },
-      { dt: 2490, type: 'scroll', dy: 180 },
-      { dt: 2680, type: 'scroll', dy: 160 },
-      { dt: 2990, type: 'scroll', dy: 100 },
-      // Hover product in next row
-      { dt: 3500, type: 'move',   x: 0.25, y: 0.48 },
-      { dt: 3680, type: 'move',   x: 0.26, y: 0.49 },
-      { dt: 3900, type: 'pause' },
-      // Quick back-scroll — reconsidering
-      { dt: 4600, type: 'scroll', dy: -120 },
-      { dt: 4780, type: 'scroll', dy: -80  },
-      { dt: 5100, type: 'move',   x: 0.52, y: 0.38 },
-      { dt: 5280, type: 'pause' },
-      // Continue scrolling down
-      { dt: 5900, type: 'scroll', dy: 200 },
-      { dt: 6100, type: 'scroll', dy: 220 },
-      { dt: 6300, type: 'scroll', dy: 180 },
-      { dt: 6700, type: 'move',   x: 0.35, y: 0.55 },
-      { dt: 6900, type: 'pause' },
-      { dt: 7600, type: 'scroll', dy: 140 },
-      { dt: 7800, type: 'scroll', dy: 120 },
-      // Slow down — reading product details
-      { dt: 8400, type: 'move',   x: 0.35, y: 0.62 },
-      { dt: 8600, type: 'move',   x: 0.36, y: 0.63 },
-      { dt: 9100, type: 'pause' },
-      { dt: 9800, type: 'scroll', dy: 80  },
-      { dt: 10100, type: 'move',  x: 0.38, y: 0.68 },
-      { dt: 10400, type: 'pause' },
-      { dt: 11000, type: 'scroll', dy: 60 },
-    ],
-  },
-
-  // ── Pattern: login — approach login form with careful deliberate movement ─────
-  'login': {
-    category:    'login',
-    viewport:    { w: 1440, h: 900 },
-    durationMs:  7600,
-    description: 'Navigate to login form, click email, type, tab to password, submit',
-    events: [
-      // Land — brief orientation pause
-      { dt: 0,    type: 'move',   x: 0.50, y: 0.25 },
-      { dt: 420,  type: 'pause' },
-      // Move to email field — deliberate
-      { dt: 1100, type: 'move',   x: 0.50, y: 0.40 },
-      { dt: 1290, type: 'move',   x: 0.50, y: 0.42 },
-      { dt: 1480, type: 'move',   x: 0.50, y: 0.43 },
-      { dt: 1680, type: 'click',  x: 0.50, y: 0.43 },
-      // Typing email — realistic gaps
-      { dt: 1980, type: 'pause' },
-      { dt: 2280, type: 'pause' },
-      { dt: 2680, type: 'pause' },
-      { dt: 3100, type: 'pause' },
-      // Tab/click to password field
-      { dt: 3600, type: 'move',   x: 0.50, y: 0.52 },
-      { dt: 3780, type: 'move',   x: 0.50, y: 0.53 },
-      { dt: 3920, type: 'click',  x: 0.50, y: 0.53 },
-      // Typing password — slightly slower (more careful)
-      { dt: 4280, type: 'pause' },
-      { dt: 4620, type: 'pause' },
-      { dt: 4980, type: 'pause' },
-      // Hover login button — slight hesitation
-      { dt: 5600, type: 'move',   x: 0.50, y: 0.64 },
-      { dt: 5780, type: 'move',   x: 0.50, y: 0.65 },
-      { dt: 6100, type: 'pause' },
-      // Click
-      { dt: 6700, type: 'move',   x: 0.50, y: 0.65 },
-      { dt: 6900, type: 'click',  x: 0.50, y: 0.65 },
-    ],
-  },
-
-  // ── Pattern: deep-scroll-read — long article reading ────────────────────────
-  'deep-scroll-read': {
-    category:    'reading',
-    viewport:    { w: 1440, h: 900 },
-    durationMs:  14200,
-    description: 'Long article read — variable scroll speed, selection hover, backtrack',
-    events: [
-      { dt: 0,    type: 'move',   x: 0.50, y: 0.15 },
-      { dt: 380,  type: 'pause' },
-      { dt: 900,  type: 'scroll', dy: 60  },
-      { dt: 1080, type: 'scroll', dy: 80  },
-      { dt: 1380, type: 'scroll', dy: 100 },
-      { dt: 1780, type: 'pause' },
-      { dt: 2100, type: 'move',   x: 0.38, y: 0.35 },
-      { dt: 2400, type: 'scroll', dy: 90  },
-      { dt: 2590, type: 'scroll', dy: 110 },
-      { dt: 2890, type: 'scroll', dy: 130 },
-      { dt: 3200, type: 'scroll', dy: 100 },
-      { dt: 3600, type: 'pause' },
-      // Speed up — scanning
-      { dt: 4000, type: 'scroll', dy: 200 },
-      { dt: 4180, type: 'scroll', dy: 240 },
-      { dt: 4340, type: 'scroll', dy: 220 },
-      { dt: 4500, type: 'scroll', dy: 180 },
-      // Slow down — interesting section
-      { dt: 5200, type: 'scroll', dy: 60  },
-      { dt: 5500, type: 'move',   x: 0.35, y: 0.50 },
-      { dt: 5780, type: 'pause' },
-      { dt: 6300, type: 'scroll', dy: 50  },
-      { dt: 6600, type: 'scroll', dy: 70  },
-      { dt: 7100, type: 'pause' },
-      // Backtrack — re-reading
-      { dt: 7700, type: 'scroll', dy: -150 },
-      { dt: 7880, type: 'scroll', dy: -120 },
-      { dt: 8100, type: 'pause' },
-      { dt: 8600, type: 'move',   x: 0.40, y: 0.44 },
-      { dt: 9000, type: 'scroll', dy: 80  },
-      { dt: 9200, type: 'scroll', dy: 100 },
-      { dt: 9500, type: 'scroll', dy: 120 },
-      { dt: 9800, type: 'scroll', dy: 140 },
-      { dt: 10200, type: 'pause' },
-      { dt: 10700, type: 'scroll', dy: 160 },
-      { dt: 10900, type: 'scroll', dy: 180 },
-      { dt: 11200, type: 'scroll', dy: 160 },
-      { dt: 11600, type: 'move',   x: 0.42, y: 0.60 },
-      { dt: 12000, type: 'pause' },
-      { dt: 12500, type: 'scroll', dy: 100 },
-      { dt: 12700, type: 'scroll', dy: 80  },
-      { dt: 13100, type: 'move',   x: 0.44, y: 0.68 },
-      { dt: 13500, type: 'pause' },
-      { dt: 13900, type: 'scroll', dy: 60  },
-    ],
-  },
-
-  // ── Pattern: idle-hover — waiting on page, occasional movement ───────────────
-  'idle-hover': {
-    category:    'idle',
-    viewport:    { w: 1440, h: 900 },
-    durationMs:  6000,
-    description: 'User reading without scrolling — micro-movements only',
-    events: [
-      { dt: 0,    type: 'move',   x: 0.50, y: 0.40 },
-      { dt: 680,  type: 'move',   x: 0.51, y: 0.40 },
-      { dt: 1240, type: 'move',   x: 0.51, y: 0.41 },
-      { dt: 2100, type: 'pause' },
-      { dt: 2800, type: 'move',   x: 0.52, y: 0.41 },
-      { dt: 3200, type: 'move',   x: 0.52, y: 0.42 },
-      { dt: 3900, type: 'pause' },
-      { dt: 4600, type: 'move',   x: 0.51, y: 0.42 },
-      { dt: 5100, type: 'move',   x: 0.50, y: 0.43 },
-      { dt: 5600, type: 'pause' },
-    ],
-  },
-};
-
-// User-loaded custom patterns (from cloak-recorder)
-const _customPatterns = new Map();
-
-// ── Category → pattern name map ───────────────────────────────────────────────
-
-const CATEGORY_PATTERNS = {
-  reading:  ['reading', 'deep-scroll-read'],
-  form:     ['form'],
-  shopping: ['shopping'],
-  login:    ['login'],
-  idle:     ['idle-hover'],
-};
-
-// ── Replay engine ─────────────────────────────────────────────────────────────
-
-/**
- * Replay a named pattern on a Playwright page.
- * Scales normalised coordinates to actual viewport dimensions.
- * Adds ±15% jitter to all timing gaps for natural variation.
- *
- * @param {import('playwright').Page} page
- * @param {string} patternName
- * @param {object} opts
- * @param {number}  opts.speedFactor  - 1.0 = real speed, 0.5 = 2x faster, 2.0 = 2x slower
- * @param {boolean} opts.jitter       - add timing jitter (default true)
- * @param {boolean} opts.skipClicks   - replay moves/scrolls only, skip clicks (default false)
- */
-async function replayPattern(page, patternName, opts = {}) {
-  const pattern = _customPatterns.get(patternName) || PATTERN_LIBRARY[patternName];
-  if (!pattern) throw new Error(`cloak-behaviour: unknown pattern "${patternName}"`);
-
-  const vp          = page.viewportSize() || { width: 1440, height: 900 };
-  const speedFactor = opts.speedFactor ?? 1.0;
-  const jitter      = opts.jitter      ?? true;
-  const skipClicks  = opts.skipClicks  ?? false;
-
-  let lastT = 0;
-
-  for (const event of pattern.events) {
-    // Calculate gap from last event
-    let gap = (event.dt - lastT) * speedFactor;
-    lastT   = event.dt;
-
-    // Add ±15% timing jitter (makes replay non-deterministic)
-    if (jitter && gap > 0) {
-      gap = Math.max(16, gap * (0.85 + Math.random() * 0.30));
-    }
-
-    if (gap > 0) {
-      await page.waitForTimeout(Math.round(gap));
-    }
-
-    switch (event.type) {
-      case 'move': {
-        const x = Math.round(event.x * vp.width);
-        const y = Math.round(event.y * vp.height);
-        // steps = distance-proportional for smooth arcs
-        const steps = Math.max(3, Math.round(8 + Math.random() * 8));
-        await page.mouse.move(x, y, { steps }).catch(() => {});
-        break;
-      }
-
-      case 'scroll': {
-        const x = Math.round((event.x ?? 0.5) * vp.width);
-        const y = Math.round((event.y ?? 0.5) * vp.height);
-        // Add scroll delta jitter
-        const dy = jitter
-          ? Math.round(event.dy * (0.85 + Math.random() * 0.30))
-          : event.dy;
-        await page.mouse.wheel(0, dy).catch(() => {});
-        break;
-      }
-
-      case 'click': {
-        if (skipClicks) break;
-        const x = Math.round(event.x * vp.width);
-        const y = Math.round(event.y * vp.height);
-        await page.mouse.move(x, y, { steps: 4 }).catch(() => {});
-        await page.waitForTimeout(40 + Math.round(Math.random() * 60));
-        await page.mouse.down().catch(() => {});
-        await page.waitForTimeout(60 + Math.round(Math.random() * 80));
-        await page.mouse.up().catch(() => {});
-        break;
-      }
-
-      case 'pause':
-        // Pure wait — already handled by gap above
-        break;
-    }
-  }
-
-  return {
-    pattern:    patternName,
-    durationMs: Math.round(pattern.durationMs * speedFactor),
-    events:     pattern.events.length,
-  };
-}
-
-// ── High-level API ────────────────────────────────────────────────────────────
-
-/**
- * Pick and replay a behaviour pattern appropriate for the given context.
- * The primary API — call this before/during page interactions.
- *
- * @param {import('playwright').Page} page
- * @param {'reading'|'form'|'shopping'|'login'|'idle'} category
- * @param {object} opts  — passed through to replayPattern
- */
-async function injectBehaviour(page, category = 'reading', opts = {}) {
-  const names   = CATEGORY_PATTERNS[category] || CATEGORY_PATTERNS.reading;
-  const name    = names[Math.floor(Math.random() * names.length)];
-  return replayPattern(page, name, opts);
-}
-
-// ── Procedural synthesis (no pre-recorded pattern needed) ─────────────────────
-
-/**
- * Generate and replay a synthetic behaviour sequence using Gaussian velocity
- * curves and natural micro-pause distributions. Less realistic than recorded
- * patterns but requires no data.
- *
- * @param {import('playwright').Page} page
- * @param {object} opts
- * @param {number} opts.scrollDepth   - how far to scroll (0–1, fraction of page height)
- * @param {number} opts.durationMs    - total duration (default 5000)
- * @param {number} opts.pauseCount    - number of reading pauses (default 3)
- */
-async function syntheticBrowse(page, opts = {}) {
-  const vp          = page.viewportSize() || { width: 1440, height: 900 };
-  const durationMs  = opts.durationMs  ?? 5000;
-  const scrollDepth = opts.scrollDepth ?? 0.6;
-  const pauseCount  = opts.pauseCount  ?? 3;
-
-  const steps     = 12 + Math.floor(Math.random() * 8);
-  const stepMs    = durationMs / steps;
-  const maxScroll = Math.round(vp.height * scrollDepth * 3); // approximate page content height
-  let   scrolled  = 0;
-
-  // Initial cursor position — upper third of viewport
-  let curX = Math.round(vp.width  * (0.3 + Math.random() * 0.4));
-  let curY = Math.round(vp.height * (0.1 + Math.random() * 0.2));
-  await page.mouse.move(curX, curY, { steps: 5 }).catch(() => {});
-
-  for (let i = 0; i < steps; i++) {
-    const t = i / steps; // progress 0→1
-
-    // Decide action — weighted by scroll progress
-    const rand = Math.random();
-
-    if (rand < 0.35 && scrolled < maxScroll) {
-      // Scroll — velocity follows Gaussian bell: fast middle, slow start/end
-      const progress  = t < 0.5 ? t * 2 : (1 - t) * 2; // bell shape
-      const velocity  = 60 + Math.round(progress * 180 * (0.8 + Math.random() * 0.4));
-      scrolled += velocity;
-      await page.mouse.wheel(0, velocity).catch(() => {});
-      await page.waitForTimeout(Math.round(stepMs * (0.4 + Math.random() * 0.3)));
-
-    } else if (rand < 0.65) {
-      // Mouse move — Bezier-like arc toward a target point
-      const targetX = Math.round(vp.width  * (0.2 + Math.random() * 0.6));
-      const targetY = Math.round(vp.height * (0.2 + Math.random() * 0.6));
-      const moveSteps = 6 + Math.floor(Math.random() * 10);
-      await page.mouse.move(targetX, targetY, { steps: moveSteps }).catch(() => {});
-      curX = targetX;
-      curY = targetY;
-      await page.waitForTimeout(Math.round(stepMs * (0.3 + Math.random() * 0.2)));
-
-    } else {
-      // Pause — reading dwell time (Gaussian ~800ms, range 300–2000ms)
-      const dwell = Math.max(300, Math.round(_gaussianMs(800, 350)));
-      await page.waitForTimeout(dwell);
-
-      // Micro cursor drift during reading pause
-      const driftX = curX + Math.round((Math.random() - 0.5) * 20);
-      const driftY = curY + Math.round((Math.random() - 0.5) * 10);
-      await page.mouse.move(
-        Math.max(0, Math.min(vp.width,  driftX)),
-        Math.max(0, Math.min(vp.height, driftY)),
-        { steps: 3 }
-      ).catch(() => {});
-    }
-  }
-
-  return { synthetic: true, durationMs, scrolled };
-}
-
-// ── Custom pattern management ─────────────────────────────────────────────────
-
-/**
- * Load a custom pattern recorded with cloak-recorder.
- * @param {string} name  - Pattern name to register
- * @param {object} data  - Raw recorder output (events array with absolute timestamps)
- */
-function loadCustomPattern(name, data) {
-  // Normalise absolute timestamps → dt (delta from previous)
-  const events = Array.isArray(data) ? data : data.events;
-  if (!events?.length) throw new Error('loadCustomPattern: events array required');
-
-  const vp    = data.viewport || { w: 1440, h: 900 };
-  const t0    = events[0].t || 0;
-  let   lastT = 0;
-
-  const normalised = events.map(e => {
-    const dt = (e.t - t0) - lastT;
-    lastT    = e.t - t0;
-    return {
-      dt,
-      type: e.type,
-      // Normalise coordinates if they look like pixels
-      x: e.x !== undefined ? (e.x > 1 ? e.x / vp.w : e.x) : undefined,
-      y: e.y !== undefined ? (e.y > 1 ? e.y / vp.h : e.y) : undefined,
-      dy: e.dy,
-    };
-  });
-
-  const totalDuration = (events[events.length - 1].t || 0) - t0;
-
-  _customPatterns.set(name, {
-    category:    data.category || 'custom',
-    viewport:    vp,
-    durationMs:  totalDuration,
-    description: data.description || `Custom pattern: ${name}`,
-    events:      normalised,
-  });
-
-  return { loaded: true, name, events: normalised.length, durationMs: totalDuration };
-}
-
-/**
- * Save a custom pattern to disk for reuse.
- */
-function saveCustomPattern(name) {
-  const pattern = _customPatterns.get(name);
-  if (!pattern) throw new Error(`Pattern "${name}" not loaded`);
-  const dir  = path.join(os.homedir(), '.vektor', 'behaviour-patterns');
-  fs.mkdirSync(dir, { recursive: true });
-  const file = path.join(dir, `${name.replace(/[^a-zA-Z0-9_-]/g, '_')}.json`);
-  fs.writeFileSync(file, JSON.stringify(pattern, null, 2));
-  return file;
-}
-
-/**
- * Load all saved custom patterns from disk.
- */
-function loadSavedPatterns() {
-  const dir = path.join(os.homedir(), '.vektor', 'behaviour-patterns');
-  if (!fs.existsSync(dir)) return [];
-  const loaded = [];
-  for (const file of fs.readdirSync(dir).filter(f => f.endsWith('.json'))) {
-    try {
-      const name    = file.replace('.json', '');
-      const pattern = JSON.parse(fs.readFileSync(path.join(dir, file), 'utf8'));
-      _customPatterns.set(name, pattern);
-      loaded.push(name);
-    } catch { /* skip corrupt files */ }
-  }
-  return loaded;
-}
-
-// ── Stats / introspection ─────────────────────────────────────────────────────
-
-function behaviourStats() {
-  const builtIn = Object.keys(PATTERN_LIBRARY);
-  const custom  = [..._customPatterns.keys()];
-  return {
-    builtInPatterns: builtIn,
-    customPatterns:  custom,
-    categories:      Object.keys(CATEGORY_PATTERNS),
-    totalPatterns:   builtIn.length + custom.length,
-    description: 'Replay real human mouse/scroll patterns via Playwright CDP. ' +
-                 'Defeats reCAPTCHA v3 / Cloudflare / DataDome behavioural scoring.',
-  };
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-/** Box-Muller Gaussian sample */
-function _gaussianMs(mean, stddev) {
-  const u1 = Math.random(), u2 = Math.random();
-  const z  = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
-  return mean + z * stddev;
-}
-
-/** Return all pattern names for a category */
-function listPatterns(category) {
-  if (category) return CATEGORY_PATTERNS[category] || [];
-  return [...Object.keys(PATTERN_LIBRARY), ..._customPatterns.keys()];
-}
-
-module.exports = {
-  injectBehaviour,
-  replayPattern,
-  syntheticBrowse,
-  loadCustomPattern,
-  saveCustomPattern,
-  loadSavedPatterns,
-  behaviourStats,
-  listPatterns,
-  PATTERN_LIBRARY,
-};