dev3000 0.0.0 → 0.0.2

package/README.md

@@ -0,0 +1,59 @@
+# dev3000
+
+Captures your web app's complete development timeline - server logs, browser events, console messages, network requests, and automatic screenshots - in a unified, timestamped feed for AI debugging.
+
+## Quick Start
+
+```bash
+pnpm install dev3000
+pnpx dev3000
+```
+
+## What it does
+
+Creates a comprehensive log of your development session that AI assistants can easily understand. When you have a bug or issue, Claude can see your server output, browser console, network requests, and screenshots all in chronological order.
+
+The tool monitors your app in a real browser and captures:
+- Server logs and console output
+- Browser console messages and errors  
+- Network requests and responses
+- Automatic screenshots on navigation, errors, and key events
+- Visual timeline at `http://localhost:3684/logs`
+
+## AI Integration
+
+Give Claude your log file for instant debugging:
+
+```
+Read /tmp/dev3000.log
+```
+
+Or use the MCP server at `http://localhost:3684/api/mcp/http` for advanced querying:
+- `read_consolidated_logs` - Get recent logs with filtering
+- `search_logs` - Regex search with context  
+- `get_browser_errors` - Extract browser errors by time period
+
+## Options
+
+```bash
+pnpx dev3000 [options]
+
+  -p, --port <port>         Your app's port (default: 3000)
+  --mcp-port <port>         MCP server port (default: 3684)  
+  -s, --script <script>     Package.json script to run (default: dev)
+  --profile-dir <dir>       Chrome profile directory (persists cookies/login state)
+  --logfile <file>          Log file path (default: /tmp/dev3000.log)
+```
+
+Examples:
+```bash
+# Custom port for Vite  
+pnpx dev3000 --port 5173
+
+# Persistent login state
+pnpx dev3000 --profile-dir ./chrome-profile
+```
+
+---
+
+_Made by [elsigh](https://github.com/elsigh)_

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { startDevEnvironment } from './dev-environment.js';
+function detectPackageManager() {
+    if (existsSync('pnpm-lock.yaml'))
+        return 'pnpm';
+    if (existsSync('yarn.lock'))
+        return 'yarn';
+    if (existsSync('package-lock.json'))
+        return 'npm';
+    return 'npm'; // fallback
+}
+const program = new Command();
+program
+    .name('dev3000')
+    .description('AI-powered development tools with browser monitoring and MCP server')
+    .version('0.0.1');
+program
+    .description('AI-powered development tools with browser monitoring and MCP server')
+    .option('-p, --port <port>', 'Development server port', '3000')
+    .option('--mcp-port <port>', 'MCP server port', '3684')
+    .option('-s, --script <script>', 'Package.json script to run (e.g. dev, build-start)', 'dev')
+    .option('--profile-dir <dir>', 'Chrome profile directory', join(tmpdir(), 'dev3000-chrome-profile'))
+    .option('--logfile <file>', 'Consolidated log file path', '/tmp/dev3000.log')
+    .action(async (options) => {
+    console.log(chalk.blue.bold('🤖 Starting AI Development Environment'));
+    // Convert script option to full command
+    const packageManager = detectPackageManager();
+    const serverCommand = `${packageManager} run ${options.script}`;
+    try {
+        await startDevEnvironment({
+            ...options,
+            logFile: options.logfile,
+            serverCommand
+        });
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Failed to start development environment:'), error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,SAAS,oBAAoB;IAC3B,IAAI,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,MAAM,CAAC;IAChD,IAAI,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,UAAU,CAAC,mBAAmB,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,KAAK,CAAC,CAAC,WAAW;AAC3B,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,qEAAqE,CAAC;KAClF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,WAAW,CAAC,qEAAqE,CAAC;KAClF,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,CAAC;KAC9D,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,CAAC;KACtD,MAAM,CAAC,uBAAuB,EAAE,oDAAoD,EAAE,KAAK,CAAC;KAC5F,MAAM,CAAC,qBAAqB,EAAE,0BAA0B,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC;KACnG,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,EAAE,kBAAkB,CAAC;KAC5E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC,CAAC;IAEvE,wCAAwC;IACxC,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,GAAG,cAAc,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC;YACxB,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/dev-environment.d.ts

@@ -0,0 +1,36 @@
+interface DevEnvironmentOptions {
+    port: string;
+    mcpPort: string;
+    serverCommand: string;
+    profileDir: string;
+    logFile: string;
+}
+export declare class DevEnvironment {
+    private serverProcess;
+    private mcpServerProcess;
+    private browser;
+    private browserContext;
+    private logger;
+    private stateTimer;
+    private browserType;
+    private options;
+    private screenshotDir;
+    private mcpPublicDir;
+    private pidFile;
+    private progressBar;
+    constructor(options: DevEnvironmentOptions);
+    private checkPortsAvailable;
+    start(): Promise<void>;
+    private startServer;
+    private startMcpServer;
+    private waitForServer;
+    private waitForMcpServer;
+    private startBrowserMonitoring;
+    private installPlaywrightBrowsers;
+    private takeScreenshot;
+    private setupPageMonitoring;
+    private setupCleanupHandlers;
+}
+export declare function startDevEnvironment(options: DevEnvironmentOptions): Promise<void>;
+export {};
+//# sourceMappingURL=dev-environment.d.ts.map

package/dist/dev-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-environment.d.ts","sourceRoot":"","sources":["../src/dev-environment.ts"],"names":[],"mappings":"AASA,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqCD,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,WAAW,CAAwD;IAC3E,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAwB;gBAE/B,OAAO,EAAE,qBAAqB;YA6B5B,mBAAmB;IA4B3B,KAAK;YA8CG,WAAW;YAiCX,cAAc;YAkEd,aAAa;YAwBb,gBAAgB;YAwBhB,sBAAsB;YA4HtB,yBAAyB;YA8DzB,cAAc;YAwBd,mBAAmB;IAyEjC,OAAO,CAAC,oBAAoB;CAkE7B;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,iBAGvE"}