recker 1.0.20-next.de24f7d → 1.0.20-next.e194d90

package/dist/cli/index.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { program } from 'commander';
 import { promises as fs } from 'node:fs';
 import { join } from 'node:path';
@@ -127,6 +126,8 @@ async function main() {
         .version(version)
         .argument('[args...]', 'URL, Method, Headers (Key:Value), Data (key=value)')
         .option('-v, --verbose', 'Show full request/response details')
+        .option('-q, --quiet', 'Output only response body (no colors, perfect for piping)')
+        .option('-o, --output <file>', 'Write response body to file')
         .option('-j, --json', 'Force JSON content-type')
         .option('-e, --env [path]', 'Load .env file from current directory or specified path')
         .addHelpText('after', `
@@ -179,7 +180,59 @@ ${colors.bold(colors.yellow('Available Presets:'))}
             return;
         }
         if (url.startsWith('udp://')) {
-            console.log(colors.yellow('UDP mode coming soon...'));
+            const dgram = await import('node:dgram');
+            const { Buffer } = await import('node:buffer');
+            const u = new URL(url);
+            const host = u.hostname;
+            const port = parseInt(u.port || '9000');
+            const client = dgram.createSocket('udp4');
+            let payload;
+            let bodyData = undefined;
+            if (stdinData) {
+                bodyData = stdinData;
+            }
+            else if (Object.keys(data).length > 0) {
+                bodyData = JSON.stringify(data);
+            }
+            else {
+                bodyData = '';
+            }
+            if (typeof bodyData === 'string') {
+                payload = Buffer.from(bodyData);
+            }
+            else {
+                payload = Buffer.from(JSON.stringify(bodyData));
+            }
+            console.log(colors.gray(`Sending ${payload.length} bytes to ${host}:${port}...`));
+            client.on('message', (msg, rinfo) => {
+                if (!options.quiet) {
+                    console.log(colors.green(`\nResponse from ${rinfo.address}:${rinfo.port}:`));
+                }
+                console.log(msg.toString());
+                client.close();
+            });
+            client.on('error', (err) => {
+                console.error(colors.red(`UDP Error: ${err.message}`));
+                client.close();
+                process.exit(1);
+            });
+            client.send(payload, port, host, (err) => {
+                if (err) {
+                    console.error(colors.red(`Send Error: ${err.message}`));
+                    client.close();
+                    process.exit(1);
+                }
+                if (!options.quiet) {
+                    console.log(colors.gray('Message sent. Waiting for response (2s timeout)...'));
+                }
+            });
+            setTimeout(() => {
+                if (!options.quiet) {
+                    console.log(colors.gray('\nNo response received (timeout).'));
+                }
+                client.close();
+                process.exit(0);
+            }, 2000);
             return;
         }
         try {
@@ -201,14 +254,18 @@ ${colors.bold(colors.yellow('Available Presets:'))}
                 headers,
                 body,
                 verbose: options.verbose,
+                quiet: options.quiet,
+                output: options.output,
                 presetConfig
             });
         }
         catch (error) {
-            console.error(colors.red(`
+            if (!options.quiet) {
+                console.error(colors.red(`
 Error: ${error.message}`));
-            if (options.verbose && error.cause) {
-                console.error(error.cause);
+                if (options.verbose && error.cause) {
+                    console.error(error.cause);
+                }
             }
             process.exit(1);
         }
@@ -725,7 +782,7 @@ ${colors.gray('Status:')} ${statusIcon}
         .command('generate-dmarc')
         .description('Generate a DMARC record interactively')
         .option('-p, --policy <policy>', 'Policy: none, quarantine, reject', 'none')
-        .option('-sp, --subdomain-policy <policy>', 'Subdomain policy')
+        .option('--subdomain-policy <policy>', 'Subdomain policy')
         .option('--pct <percent>', 'Percentage of emails to apply policy', '100')
         .option('--rua <emails>', 'Aggregate report email(s), comma-separated')
         .option('--ruf <emails>', 'Forensic report email(s), comma-separated')
@@ -880,12 +937,507 @@ ${colors.bold(colors.yellow('Examples:'))}
         const { startLoadDashboard } = await import('./tui/load-dashboard.js');
         await startLoadDashboard({ url, users, duration, mode, http2, rampUp });
     });
+    const serve = program.command('serve').description('Start mock servers for testing protocols');
+    serve
+        .command('http')
+        .description('Start a mock HTTP server')
+        .option('-p, --port <number>', 'Port to listen on', '3000')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--echo', 'Echo request body back in response')
+        .option('--delay <ms>', 'Add delay to responses (milliseconds)', '0')
+        .option('--cors', 'Enable CORS', true)
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve http')}                    ${colors.gray('Start on port 3000')}
+  ${colors.green('$ rek serve http -p 8080')}            ${colors.gray('Start on port 8080')}
+  ${colors.green('$ rek serve http --echo')}             ${colors.gray('Echo mode')}
+  ${colors.green('$ rek serve http --delay 500')}        ${colors.gray('Add 500ms delay')}
+`)
+        .action(async (options) => {
+        const { MockHttpServer } = await import('../testing/mock-http-server.js');
+        const server = await MockHttpServer.create({
+            port: parseInt(options.port),
+            host: options.host,
+            delay: parseInt(options.delay),
+            cors: options.cors,
+        });
+        if (options.echo) {
+            server.any('/*', (req) => ({
+                status: 200,
+                body: {
+                    method: req.method,
+                    path: req.path,
+                    query: req.query,
+                    headers: req.headers,
+                    body: req.body,
+                },
+            }));
+        }
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock HTTP Server')}                   │
+├─────────────────────────────────────────────┤
+│  URL: ${colors.cyan(server.url.padEnd(37))}│
+│  Mode: ${colors.yellow((options.echo ? 'Echo' : 'Default').padEnd(36))}│
+│  Delay: ${colors.gray((options.delay + 'ms').padEnd(35))}│
+├─────────────────────────────────────────────┤
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('request', (req) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.cyan(req.method.padEnd(7)) + req.path);
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            await server.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('websocket')
+        .alias('ws')
+        .description('Start a mock WebSocket server')
+        .option('-p, --port <number>', 'Port to listen on', '8080')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--echo', 'Echo messages back (default: true)', true)
+        .option('--no-echo', 'Disable echo mode')
+        .option('--delay <ms>', 'Add delay to responses (milliseconds)', '0')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve websocket')}               ${colors.gray('Start on port 8080')}
+  ${colors.green('$ rek serve ws -p 9000')}              ${colors.gray('Start on port 9000')}
+  ${colors.green('$ rek serve ws --no-echo')}            ${colors.gray('Disable echo')}
+`)
+        .action(async (options) => {
+        const { MockWebSocketServer } = await import('../testing/mock-websocket-server.js');
+        const server = await MockWebSocketServer.create({
+            port: parseInt(options.port),
+            host: options.host,
+            echo: options.echo,
+            delay: parseInt(options.delay),
+        });
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock WebSocket Server')}              │
+├─────────────────────────────────────────────┤
+│  URL: ${colors.cyan(server.url.padEnd(37))}│
+│  Echo: ${colors.yellow((options.echo ? 'Enabled' : 'Disabled').padEnd(36))}│
+│  Delay: ${colors.gray((options.delay + 'ms').padEnd(35))}│
+├─────────────────────────────────────────────┤
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('connection', (client) => {
+            console.log(colors.green(`+ Connected: ${client.id}`));
+        });
+        server.on('message', (msg, client) => {
+            const data = msg.data.toString().slice(0, 50);
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.cyan(client.id) + ` ${data}${msg.data.toString().length > 50 ? '...' : ''}`);
+        });
+        server.on('disconnect', (client) => {
+            console.log(colors.red(`- Disconnected: ${client.id}`));
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            await server.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('sse')
+        .description('Start a mock SSE (Server-Sent Events) server')
+        .option('-p, --port <number>', 'Port to listen on', '8081')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--path <string>', 'SSE endpoint path', '/events')
+        .option('--heartbeat <ms>', 'Send heartbeat every N ms (0 = disabled)', '0')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve sse')}                     ${colors.gray('Start on port 8081')}
+  ${colors.green('$ rek serve sse -p 9000')}             ${colors.gray('Start on port 9000')}
+  ${colors.green('$ rek serve sse --heartbeat 5000')}    ${colors.gray('Send heartbeat every 5s')}
+
+${colors.bold(colors.yellow('Interactive Commands:'))}
+  Type a message and press Enter to broadcast it to all clients.
+`)
+        .action(async (options) => {
+        const { MockSSEServer } = await import('../testing/mock-sse-server.js');
+        const readline = await import('node:readline');
+        const server = await MockSSEServer.create({
+            port: parseInt(options.port),
+            host: options.host,
+            path: options.path,
+        });
+        if (parseInt(options.heartbeat) > 0) {
+            server.startPeriodicEvents('heartbeat', parseInt(options.heartbeat));
+        }
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock SSE Server')}                    │
+├─────────────────────────────────────────────┤
+│  URL: ${colors.cyan(server.url.padEnd(37))}│
+│  Heartbeat: ${colors.yellow((options.heartbeat === '0' ? 'Disabled' : options.heartbeat + 'ms').padEnd(31))}│
+├─────────────────────────────────────────────┤
+│  Type message + Enter to broadcast          │
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('connection', (client) => {
+            console.log(colors.green(`+ Connected: ${client.id}`));
+        });
+        server.on('disconnect', (client) => {
+            console.log(colors.red(`- Disconnected: ${client.id}`));
+        });
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.on('line', (line) => {
+            if (line.trim()) {
+                const sent = server.sendData(line.trim());
+                console.log(colors.gray(`Broadcast to ${sent} client(s): ${line.trim()}`));
+            }
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            rl.close();
+            await server.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('hls')
+        .description('Start a mock HLS streaming server')
+        .option('-p, --port <number>', 'Port to listen on', '8082')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--mode <type>', 'Stream mode: vod, live, event', 'vod')
+        .option('--segments <number>', 'Number of segments (VOD mode)', '10')
+        .option('--duration <seconds>', 'Segment duration in seconds', '6')
+        .option('--qualities <list>', 'Comma-separated quality variants', '720p,480p,360p')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve hls')}                     ${colors.gray('Start VOD server')}
+  ${colors.green('$ rek serve hls --mode live')}         ${colors.gray('Start live stream')}
+  ${colors.green('$ rek serve hls --segments 20')}       ${colors.gray('VOD with 20 segments')}
+  ${colors.green('$ rek serve hls --qualities 1080p,720p,480p')}
+
+${colors.bold(colors.yellow('Endpoints:'))}
+  ${colors.cyan('/master.m3u8')}     Master playlist (multi-quality)
+  ${colors.cyan('/playlist.m3u8')}   Single quality playlist
+  ${colors.cyan('/<quality>/playlist.m3u8')}  Quality-specific playlist
+`)
+        .action(async (options) => {
+        const { MockHlsServer } = await import('../testing/mock-hls-server.js');
+        const http = await import('node:http');
+        const port = parseInt(options.port);
+        const host = options.host;
+        const qualities = options.qualities.split(',').map(q => q.trim());
+        const resolutions = ['1920x1080', '1280x720', '854x480', '640x360', '426x240'];
+        const bandwidths = [5000000, 2500000, 1400000, 800000, 500000];
+        const variants = qualities.map((name, i) => ({
+            name,
+            bandwidth: bandwidths[i] || 500000,
+            resolution: resolutions[i] || '640x360',
+        }));
+        const baseUrl = `http://${host}:${port}`;
+        const hlsServer = await MockHlsServer.create({
+            baseUrl,
+            mode: options.mode,
+            segmentCount: parseInt(options.segments),
+            segmentDuration: parseInt(options.duration),
+            multiQuality: variants.length > 1,
+            variants: variants.length > 1 ? variants : undefined,
+        });
+        const httpServer = http.createServer(async (req, res) => {
+            const url = `${baseUrl}${req.url}`;
+            try {
+                const response = await hlsServer.transport.dispatch({ url, method: req.method || 'GET' });
+                res.statusCode = response.status;
+                response.headers.forEach((value, key) => {
+                    res.setHeader(key, value);
+                });
+                const body = await response.arrayBuffer();
+                res.end(Buffer.from(body));
+            }
+            catch {
+                res.statusCode = 404;
+                res.end('Not Found');
+            }
+        });
+        httpServer.listen(port, host, () => {
+            console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock HLS Server')}                    │
+├─────────────────────────────────────────────┤
+│  Master: ${colors.cyan((hlsServer.manifestUrl).padEnd(34))}│
+│  Mode: ${colors.yellow(options.mode.padEnd(36))}│
+│  Segments: ${colors.gray(options.segments.padEnd(32))}│
+│  Duration: ${colors.gray((options.duration + 's').padEnd(32))}│
+│  Qualities: ${colors.cyan(qualities.join(', ').padEnd(31))}│
+├─────────────────────────────────────────────┤
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            httpServer.close();
+            await hlsServer.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('udp')
+        .description('Start a mock UDP server')
+        .option('-p, --port <number>', 'Port to listen on', '9000')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--echo', 'Echo messages back (default: true)', true)
+        .option('--no-echo', 'Disable echo mode')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve udp')}                     ${colors.gray('Start on port 9000')}
+  ${colors.green('$ rek serve udp -p 5353')}             ${colors.gray('Start on port 5353')}
+  ${colors.green('$ rek serve udp --no-echo')}           ${colors.gray('Disable echo')}
+`)
+        .action(async (options) => {
+        const { MockUDPServer } = await import('../testing/mock-udp-server.js');
+        const server = new MockUDPServer({
+            port: parseInt(options.port),
+            host: options.host,
+            echo: options.echo,
+        });
+        await server.start();
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock UDP Server')}                    │
+├─────────────────────────────────────────────┤
+│  Address: ${colors.cyan(`${options.host}:${options.port}`.padEnd(33))}│
+│  Echo: ${colors.yellow((options.echo ? 'Enabled' : 'Disabled').padEnd(36))}│
+├─────────────────────────────────────────────┤
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('message', (msg) => {
+            const data = msg.data.toString().slice(0, 50);
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.cyan(`${msg.rinfo.address}:${msg.rinfo.port}`) + ` ${data}${msg.data.toString().length > 50 ? '...' : ''}`);
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            await server.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('dns')
+        .description('Start a mock DNS server')
+        .option('-p, --port <number>', 'Port to listen on', '5353')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--delay <ms>', 'Add delay to responses (milliseconds)', '0')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve dns')}                     ${colors.gray('Start on port 5353')}
+  ${colors.green('$ rek serve dns -p 53')}               ${colors.gray('Start on standard port (requires root)')}
+  ${colors.green('$ dig @127.0.0.1 -p 5353 example.com')} ${colors.gray('Test with dig')}
+
+${colors.bold(colors.yellow('Default Records:'))}
+  ${colors.cyan('localhost')}      A: 127.0.0.1, AAAA: ::1
+  ${colors.cyan('example.com')}    A, AAAA, NS, MX, TXT records
+  ${colors.cyan('test.local')}     A: 192.168.1.100
+`)
+        .action(async (options) => {
+        const { MockDnsServer } = await import('../testing/mock-dns-server.js');
+        const server = await MockDnsServer.create({
+            port: parseInt(options.port),
+            host: options.host,
+            delay: parseInt(options.delay),
+        });
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock DNS Server')}                    │
+├─────────────────────────────────────────────┤
+│  Address: ${colors.cyan(`${options.host}:${options.port}`.padEnd(33))}│
+│  Protocol: ${colors.yellow('UDP'.padEnd(32))}│
+├─────────────────────────────────────────────┤
+│  Test: dig @${options.host} -p ${options.port} example.com        │
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('query', (query) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.cyan(query.type.padEnd(6)) + ` ${query.domain}`);
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            await server.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('whois')
+        .description('Start a mock WHOIS server')
+        .option('-p, --port <number>', 'Port to listen on', '4343')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--delay <ms>', 'Add delay to responses (milliseconds)', '0')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve whois')}                    ${colors.gray('Start on port 4343')}
+  ${colors.green('$ whois -h 127.0.0.1 -p 4343 example.com')} ${colors.gray('Test with whois')}
+
+${colors.bold(colors.yellow('Default Domains:'))}
+  ${colors.cyan('example.com')}    IANA reserved domain
+  ${colors.cyan('google.com')}     MarkMonitor registrar
+  ${colors.cyan('test.local')}     Test domain
+`)
+        .action(async (options) => {
+        const { MockWhoisServer } = await import('../testing/mock-whois-server.js');
+        const server = await MockWhoisServer.create({
+            port: parseInt(options.port),
+            host: options.host,
+            delay: parseInt(options.delay),
+        });
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock WHOIS Server')}                  │
+├─────────────────────────────────────────────┤
+│  Address: ${colors.cyan(`${options.host}:${options.port}`.padEnd(33))}│
+│  Protocol: ${colors.yellow('TCP'.padEnd(32))}│
+├─────────────────────────────────────────────┤
+│  Test: whois -h ${options.host} -p ${options.port} example.com │
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('query', (query) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + `Query: ${colors.cyan(query)}`);
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            await server.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('telnet')
+        .description('Start a mock Telnet server')
+        .option('-p, --port <number>', 'Port to listen on', '2323')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('--echo', 'Echo input back (default: true)', true)
+        .option('--no-echo', 'Disable echo mode')
+        .option('--delay <ms>', 'Add delay to responses (milliseconds)', '0')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve telnet')}                   ${colors.gray('Start on port 2323')}
+  ${colors.green('$ telnet localhost 2323')}              ${colors.gray('Connect to server')}
+
+${colors.bold(colors.yellow('Built-in Commands:'))}
+  ${colors.cyan('help')}        Show available commands
+  ${colors.cyan('echo <msg>')} Echo message back
+  ${colors.cyan('date')}        Show current date
+  ${colors.cyan('time')}        Show current time
+  ${colors.cyan('ping')}        Returns "pong"
+  ${colors.cyan('quit')}        Disconnect
+`)
+        .action(async (options) => {
+        const { MockTelnetServer } = await import('../testing/mock-telnet-server.js');
+        const server = await MockTelnetServer.create({
+            port: parseInt(options.port),
+            host: options.host,
+            echo: options.echo,
+            delay: parseInt(options.delay),
+        });
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock Telnet Server')}                 │
+├─────────────────────────────────────────────┤
+│  Address: ${colors.cyan(`${options.host}:${options.port}`.padEnd(33))}│
+│  Echo: ${colors.yellow((options.echo ? 'Enabled' : 'Disabled').padEnd(36))}│
+├─────────────────────────────────────────────┤
+│  Connect: telnet ${options.host} ${options.port}               │
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('connect', (session) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.green('+ Connected: ') + colors.cyan(session.id));
+        });
+        server.on('disconnect', (session) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.red('- Disconnected: ') + colors.cyan(session.id));
+        });
+        server.on('command', (cmd, session) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.cyan(session.id) + ` $ ${cmd}`);
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            await server.stop();
+            process.exit(0);
+        });
+    });
+    serve
+        .command('ftp')
+        .description('Start a mock FTP server')
+        .option('-p, --port <number>', 'Port to listen on', '2121')
+        .option('-h, --host <string>', 'Host to bind to', '127.0.0.1')
+        .option('-u, --username <user>', 'Username for auth', 'user')
+        .option('--password <pass>', 'Password for auth', 'pass')
+        .option('--anonymous', 'Allow anonymous login (default: true)', true)
+        .option('--no-anonymous', 'Disable anonymous login')
+        .option('--delay <ms>', 'Add delay to responses (milliseconds)', '0')
+        .addHelpText('after', `
+${colors.bold(colors.yellow('Examples:'))}
+  ${colors.green('$ rek serve ftp')}                      ${colors.gray('Start on port 2121')}
+  ${colors.green('$ ftp localhost 2121')}                 ${colors.gray('Connect to server')}
+  ${colors.green('$ rek serve ftp --no-anonymous')}       ${colors.gray('Require authentication')}
+
+${colors.bold(colors.yellow('Default Files:'))}
+  ${colors.cyan('/welcome.txt')}        Welcome message
+  ${colors.cyan('/readme.md')}          README file
+  ${colors.cyan('/data/sample.json')}   Sample JSON data
+  ${colors.cyan('/public/index.html')}  HTML file
+
+${colors.bold(colors.yellow('Credentials:'))}
+  Username: ${colors.cyan('user')}  Password: ${colors.cyan('pass')}
+  Or use anonymous login with user: ${colors.cyan('anonymous')}
+`)
+        .action(async (options) => {
+        const { MockFtpServer } = await import('../testing/mock-ftp-server.js');
+        const server = await MockFtpServer.create({
+            port: parseInt(options.port),
+            host: options.host,
+            username: options.username,
+            password: options.password,
+            anonymous: options.anonymous,
+            delay: parseInt(options.delay),
+        });
+        console.log(colors.green(`
+┌─────────────────────────────────────────────┐
+│  ${colors.bold('Recker Mock FTP Server')}                    │
+├─────────────────────────────────────────────┤
+│  Address: ${colors.cyan(`${options.host}:${options.port}`.padEnd(33))}│
+│  Anonymous: ${colors.yellow((options.anonymous ? 'Allowed' : 'Disabled').padEnd(31))}│
+│  User: ${colors.cyan(options.username.padEnd(36))}│
+├─────────────────────────────────────────────┤
+│  Connect: ftp ${options.host} ${options.port}                  │
+│  Press ${colors.bold('Ctrl+C')} to stop                       │
+└─────────────────────────────────────────────┘
+`));
+        server.on('connect', (session) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.green('+ Connected: ') + colors.cyan(session.id));
+        });
+        server.on('disconnect', (session) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.red('- Disconnected: ') + colors.cyan(session.id));
+        });
+        server.on('command', (cmd, _args, session) => {
+            console.log(colors.gray(`${new Date().toISOString()} `) + colors.cyan(session.id) + ` ${cmd}`);
+        });
+        process.on('SIGINT', async () => {
+            console.log(colors.yellow('\nShutting down...'));
+            await server.stop();
+            process.exit(0);
+        });
+    });
     program
         .command('mcp')
         .description('Start MCP server for AI agents to access Recker documentation')
         .option('-t, --transport <mode>', 'Transport mode: stdio, http, sse', 'stdio')
         .option('-p, --port <number>', 'Server port (for http/sse modes)', '3100')
         .option('-d, --docs <path>', 'Path to documentation folder')
+        .option('-T, --tools <paths...>', 'Paths to external tool modules to load')
         .option('--debug', 'Enable debug logging')
         .addHelpText('after', `
 ${colors.bold(colors.yellow('Transport Modes:'))}
@@ -921,6 +1473,7 @@ ${colors.bold(colors.yellow('Claude Code config (~/.claude.json):'))}
             port: parseInt(options.port),
             docsPath: options.docs,
             debug: options.debug,
+            toolPaths: options.tools,
         });
         if (transport === 'stdio') {
             await server.start();

package/dist/cli/presets.d.ts

@@ -1,2 +1 @@
 export declare function resolvePreset(name: string): any;
-//# sourceMappingURL=presets.d.ts.map

package/dist/cli/tui/ai-chat.d.ts

@@ -1,3 +1,2 @@
 import readline from 'node:readline';
 export declare function startAIChat(rl: readline.Interface, provider?: string, apiKey?: string, model?: string): Promise<void>;
-//# sourceMappingURL=ai-chat.d.ts.map

package/dist/cli/tui/load-dashboard.d.ts

@@ -1,3 +1,2 @@
 import { LoadConfig } from '../../bench/generator.js';
 export declare function startLoadDashboard(config: LoadConfig): Promise<void>;
-//# sourceMappingURL=load-dashboard.d.ts.map

package/dist/cli/tui/scroll-buffer.d.ts

@@ -40,4 +40,3 @@ export declare function parseScrollKey(data: Buffer): 'pageUp' | 'pageDown' | 's
 export declare function parseMouseScroll(data: Buffer): 'scrollUp' | 'scrollDown' | null;
 export declare function enableMouseReporting(): void;
 export declare function disableMouseReporting(): void;
-//# sourceMappingURL=scroll-buffer.d.ts.map

package/dist/cli/tui/search-panel.d.ts

@@ -38,4 +38,3 @@ export declare class SearchPanel {
 }
 export declare function openSearchPanel(query?: string): Promise<void>;
 export {};
-//# sourceMappingURL=search-panel.d.ts.map

package/dist/cli/tui/shell-search.d.ts

@@ -43,4 +43,3 @@ export declare class ShellSearch {
     private parseTypeDefinitions;
 }
 export declare function getShellSearch(): ShellSearch;
-//# sourceMappingURL=shell-search.d.ts.map

package/dist/cli/tui/shell.d.ts

@@ -73,4 +73,3 @@ export declare class RekShell {
     private printMarkdown;
     private printHelp;
 }
-//# sourceMappingURL=shell.d.ts.map