@arvoretech/runtime-lens-mcp 1.0.0

package/dist/log-collector.js

@@ -0,0 +1,349 @@
+import { randomUUID } from "node:crypto";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, basename } from "node:path";
+const MAX_BUFFER_SIZE = 10000;
+export class LogCollector {
+    buffer = {
+        logs: [],
+        requests: [],
+        metrics: [],
+    };
+    logPaths;
+    projectRoot;
+    constructor(projectRoot, logPaths) {
+        this.projectRoot = projectRoot || process.cwd();
+        this.logPaths = logPaths || [];
+    }
+    async collectFromFiles() {
+        const paths = this.logPaths.length > 0
+            ? this.logPaths
+            : await this.discoverLogFiles();
+        for (const filePath of paths) {
+            try {
+                const content = await readFile(filePath, "utf-8");
+                const entries = this.parseLogFile(content, filePath);
+                this.addLogs(entries);
+            }
+            catch {
+                // skip unreadable files
+            }
+        }
+    }
+    async collectFromProcess() {
+        const mem = process.memoryUsage();
+        const cpu = process.cpuUsage();
+        this.addMetric({
+            name: "memory.rss",
+            value: mem.rss,
+            unit: "bytes",
+            timestamp: new Date().toISOString(),
+            tags: { source: "process" },
+        });
+        this.addMetric({
+            name: "memory.heap_used",
+            value: mem.heapUsed,
+            unit: "bytes",
+            timestamp: new Date().toISOString(),
+            tags: { source: "process" },
+        });
+        this.addMetric({
+            name: "cpu.user",
+            value: cpu.user,
+            unit: "microseconds",
+            timestamp: new Date().toISOString(),
+            tags: { source: "process" },
+        });
+        this.addMetric({
+            name: "cpu.system",
+            value: cpu.system,
+            unit: "microseconds",
+            timestamp: new Date().toISOString(),
+            tags: { source: "process" },
+        });
+    }
+    async scanProjectStructure() {
+        const framework = await this.detectFramework();
+        const logFiles = await this.discoverLogFiles();
+        const configFiles = await this.discoverConfigFiles();
+        return { framework, logFiles, configFiles };
+    }
+    addLog(entry) {
+        this.buffer.logs.push({
+            ...entry,
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+        });
+        this.trimBuffer("logs");
+    }
+    addLogs(entries) {
+        this.buffer.logs.push(...entries);
+        this.trimBuffer("logs");
+    }
+    addRequest(request) {
+        this.buffer.requests.push({
+            ...request,
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+        });
+        this.trimBuffer("requests");
+    }
+    addMetric(metric) {
+        this.buffer.metrics.push(metric);
+        this.trimBuffer("metrics");
+    }
+    getLogs(options) {
+        let logs = [...this.buffer.logs];
+        if (options?.level) {
+            logs = logs.filter((l) => l.level === options.level);
+        }
+        if (options?.framework) {
+            logs = logs.filter((l) => l.framework === options.framework);
+        }
+        if (options?.source) {
+            logs = logs.filter((l) => l.source?.includes(options.source));
+        }
+        const limit = options?.lines || 50;
+        return logs.slice(-limit);
+    }
+    searchLogs(options) {
+        let logs = [...this.buffer.logs];
+        const regex = new RegExp(options.query, "i");
+        if (options.since) {
+            const sinceDate = new Date(options.since);
+            logs = logs.filter((l) => new Date(l.timestamp) >= sinceDate);
+        }
+        if (options.level) {
+            logs = logs.filter((l) => l.level === options.level);
+        }
+        if (options.framework) {
+            logs = logs.filter((l) => l.framework === options.framework);
+        }
+        logs = logs.filter((l) => regex.test(l.message) ||
+            (l.stackTrace && regex.test(l.stackTrace)) ||
+            (l.source && regex.test(l.source)));
+        return logs.slice(-(options.limit || 50));
+    }
+    getErrors(options) {
+        let errors = this.buffer.logs.filter((l) => l.level === "error" || l.level === "fatal");
+        if (options?.framework) {
+            errors = errors.filter((l) => l.framework === options.framework);
+        }
+        if (options?.grouped) {
+            const groups = new Map();
+            for (const error of errors) {
+                const key = error.message.slice(0, 100);
+                const existing = groups.get(key);
+                if (existing) {
+                    existing.count++;
+                    if (error.timestamp > existing.lastSeen) {
+                        existing.lastSeen = error.timestamp;
+                        existing.sample = error;
+                    }
+                }
+                else {
+                    groups.set(key, { count: 1, lastSeen: error.timestamp, sample: error });
+                }
+            }
+            return Array.from(groups.entries())
+                .map(([message, data]) => ({ message, ...data }))
+                .sort((a, b) => b.count - a.count)
+                .slice(0, options?.limit || 20);
+        }
+        return errors.slice(-(options?.limit || 20));
+    }
+    getRequests(options) {
+        let requests = [...this.buffer.requests];
+        if (options?.id) {
+            return requests.filter((r) => r.id === options.id);
+        }
+        if (options?.method) {
+            requests = requests.filter((r) => r.method.toUpperCase() === options.method.toUpperCase());
+        }
+        if (options?.urlPattern) {
+            const regex = new RegExp(options.urlPattern, "i");
+            requests = requests.filter((r) => regex.test(r.url));
+        }
+        if (options?.statusCode) {
+            requests = requests.filter((r) => r.statusCode === options.statusCode);
+        }
+        return requests.slice(-(options?.limit || 20));
+    }
+    getMetrics(options) {
+        let metrics = [...this.buffer.metrics];
+        if (options?.metric) {
+            metrics = metrics.filter((m) => m.name.includes(options.metric));
+        }
+        if (options?.since) {
+            const sinceDate = new Date(options.since);
+            metrics = metrics.filter((m) => new Date(m.timestamp) >= sinceDate);
+        }
+        return metrics.slice(-(options?.limit || 20));
+    }
+    clearLogs() {
+        const count = this.buffer.logs.length + this.buffer.requests.length + this.buffer.metrics.length;
+        this.buffer = { logs: [], requests: [], metrics: [] };
+        return { cleared: count };
+    }
+    getStats() {
+        const byLevel = {};
+        const byFramework = {};
+        for (const log of this.buffer.logs) {
+            byLevel[log.level] = (byLevel[log.level] || 0) + 1;
+            const fw = log.framework || "unknown";
+            byFramework[fw] = (byFramework[fw] || 0) + 1;
+        }
+        return {
+            totalLogs: this.buffer.logs.length,
+            totalRequests: this.buffer.requests.length,
+            totalMetrics: this.buffer.metrics.length,
+            byLevel,
+            byFramework,
+        };
+    }
+    parseLogFile(content, filePath) {
+        const lines = content.split("\n").filter(Boolean);
+        const entries = [];
+        const framework = this.inferFramework(filePath);
+        for (const line of lines) {
+            const entry = this.parseLogLine(line, filePath, framework);
+            if (entry)
+                entries.push(entry);
+        }
+        return entries;
+    }
+    parseLogLine(line, source, framework) {
+        const jsonMatch = this.tryParseJson(line);
+        if (jsonMatch) {
+            return {
+                id: randomUUID(),
+                timestamp: jsonMatch.timestamp || jsonMatch.time || new Date().toISOString(),
+                level: this.normalizeLevel(jsonMatch.level || jsonMatch.severity || "info"),
+                message: jsonMatch.message || jsonMatch.msg || JSON.stringify(jsonMatch),
+                source: basename(source),
+                framework,
+                metadata: jsonMatch,
+            };
+        }
+        const timestampRegex = /^(\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}[.\d]*Z?)\s*/;
+        const levelRegex = /\b(DEBUG|INFO|WARN|ERROR|FATAL|debug|info|warn|error|fatal)\b/;
+        const tsMatch = line.match(timestampRegex);
+        const lvlMatch = line.match(levelRegex);
+        return {
+            id: randomUUID(),
+            timestamp: tsMatch?.[1] || new Date().toISOString(),
+            level: this.normalizeLevel(lvlMatch?.[1] || "info"),
+            message: line,
+            source: basename(source),
+            framework,
+        };
+    }
+    tryParseJson(line) {
+        try {
+            const parsed = JSON.parse(line.trim());
+            if (typeof parsed === "object" && parsed !== null)
+                return parsed;
+        }
+        catch {
+            // not JSON
+        }
+        return null;
+    }
+    normalizeLevel(level) {
+        const normalized = level.toLowerCase();
+        if (["debug", "info", "warn", "error", "fatal"].includes(normalized)) {
+            return normalized;
+        }
+        if (normalized === "warning")
+            return "warn";
+        if (normalized === "critical" || normalized === "emergency")
+            return "fatal";
+        if (normalized === "trace" || normalized === "verbose")
+            return "debug";
+        return "info";
+    }
+    inferFramework(filePath) {
+        if (filePath.includes(".next") || filePath.includes("next"))
+            return "nextjs";
+        if (filePath.includes("nest") || filePath.includes("dist/main"))
+            return "nestjs";
+        if (filePath.includes("react") || filePath.includes("src/App"))
+            return "react";
+        return "unknown";
+    }
+    async detectFramework() {
+        try {
+            const pkgPath = join(this.projectRoot, "package.json");
+            const content = await readFile(pkgPath, "utf-8");
+            const pkg = JSON.parse(content);
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (deps["@nestjs/core"])
+                return "nestjs";
+            if (deps["next"])
+                return "nextjs";
+            if (deps["react"])
+                return "react";
+        }
+        catch {
+            // no package.json
+        }
+        return "unknown";
+    }
+    async discoverLogFiles() {
+        const candidates = [
+            "logs",
+            ".next/server",
+            "dist",
+            "tmp",
+        ];
+        const logFiles = [];
+        for (const dir of candidates) {
+            const fullPath = join(this.projectRoot, dir);
+            try {
+                const dirStat = await stat(fullPath);
+                if (!dirStat.isDirectory())
+                    continue;
+                const files = await readdir(fullPath);
+                for (const file of files) {
+                    if (file.endsWith(".log") || file.endsWith(".json")) {
+                        logFiles.push(join(fullPath, file));
+                    }
+                }
+            }
+            catch {
+                // directory doesn't exist
+            }
+        }
+        return logFiles;
+    }
+    async discoverConfigFiles() {
+        const candidates = [
+            "package.json",
+            "tsconfig.json",
+            "next.config.js",
+            "next.config.mjs",
+            "nest-cli.json",
+            ".env",
+            ".env.local",
+            "vite.config.ts",
+            "webpack.config.js",
+        ];
+        const found = [];
+        for (const file of candidates) {
+            try {
+                await stat(join(this.projectRoot, file));
+                found.push(file);
+            }
+            catch {
+                // doesn't exist
+            }
+        }
+        return found;
+    }
+    trimBuffer(key) {
+        const arr = this.buffer[key];
+        if (arr.length > MAX_BUFFER_SIZE) {
+            this.buffer[key] = arr.slice(-MAX_BUFFER_SIZE);
+        }
+    }
+}
+//# sourceMappingURL=log-collector.js.map

package/dist/log-collector.js.map

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

package/dist/process-inspector.d.ts

@@ -0,0 +1,44 @@
+import { ProcessInfo, Framework } from "./types.js";
+interface RunningProcess {
+    pid: number;
+    command: string;
+    port?: number;
+    framework?: Framework;
+}
+export declare class ProcessInspector {
+    private readonly projectRoot;
+    constructor(projectRoot?: string);
+    getProcessInfo(): ProcessInfo;
+    findRunningProcesses(): Promise<RunningProcess[]>;
+    getPortListeners(): Promise<{
+        port: number;
+        pid: number;
+        process: string;
+    }[]>;
+    getEnvironmentInfo(): Promise<{
+        process: ProcessInfo;
+        runningProcesses: RunningProcess[];
+        ports: {
+            port: number;
+            pid: number;
+            process: string;
+        }[];
+        projectStructure: {
+            framework: Framework;
+            logFiles: string[];
+            configFiles: string[];
+        };
+    }>;
+    executeExpression(expression: string): Promise<{
+        result: string;
+        type: string;
+    }>;
+    private scanProject;
+    private detectProjectFramework;
+    private findConfigFiles;
+    private findLogFiles;
+    private detectFrameworkFromCommand;
+    private findPortForPid;
+}
+export {};
+//# sourceMappingURL=process-inspector.d.ts.map

package/dist/process-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-inspector.d.ts","sourceRoot":"","sources":["../src/process-inspector.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AAItE,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,CAAC,EAAE,MAAM;IAIhC,cAAc,IAAI,WAAW;IAwBvB,oBAAoB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IA2BjD,gBAAgB,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IA8B7E,kBAAkB,IAAI,OAAO,CAAC;QAClC,OAAO,EAAE,WAAW,CAAC;QACrB,gBAAgB,EAAE,cAAc,EAAE,CAAC;QACnC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACxD,gBAAgB,EAAE;YAChB,SAAS,EAAE,SAAS,CAAC;YACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,WAAW,EAAE,MAAM,EAAE,CAAC;SACvB,CAAC;KACH,CAAC;IAeI,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;YAiBxE,WAAW;YAYX,sBAAsB;YAetB,eAAe;YAoBf,YAAY;IAwB1B,OAAO,CAAC,0BAA0B;YAOpB,cAAc;CAY7B"}

package/dist/process-inspector.js

@@ -0,0 +1,190 @@
+import { exec } from "node:child_process";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { RuntimeLensError } from "./types.js";
+const execAsync = promisify(exec);
+export class ProcessInspector {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot || process.cwd();
+    }
+    getProcessInfo() {
+        const mem = process.memoryUsage();
+        const cpu = process.cpuUsage();
+        return {
+            pid: process.pid,
+            uptime: process.uptime(),
+            memoryUsage: {
+                rss: mem.rss,
+                heapTotal: mem.heapTotal,
+                heapUsed: mem.heapUsed,
+                external: mem.external,
+            },
+            cpuUsage: {
+                user: cpu.user,
+                system: cpu.system,
+            },
+            nodeVersion: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            cwd: process.cwd(),
+        };
+    }
+    async findRunningProcesses() {
+        const processes = [];
+        try {
+            const { stdout } = await execAsync("ps aux | grep -E '(node|next|nest|react-scripts)' | grep -v grep");
+            for (const line of stdout.split("\n").filter(Boolean)) {
+                const parts = line.trim().split(/\s+/);
+                const pid = parseInt(parts[1], 10);
+                const command = parts.slice(10).join(" ");
+                if (isNaN(pid))
+                    continue;
+                const framework = this.detectFrameworkFromCommand(command);
+                const port = await this.findPortForPid(pid);
+                processes.push({ pid, command, port: port || undefined, framework });
+            }
+        }
+        catch {
+            // ps command failed
+        }
+        return processes;
+    }
+    async getPortListeners() {
+        const listeners = [];
+        try {
+            const { stdout } = await execAsync("lsof -iTCP -sTCP:LISTEN -P -n 2>/dev/null | grep node || true");
+            for (const line of stdout.split("\n").filter(Boolean)) {
+                const parts = line.trim().split(/\s+/);
+                const processName = parts[0];
+                const pid = parseInt(parts[1], 10);
+                const portRegex = /:(\d+)$/;
+                const portMatch = parts[8] ? portRegex.exec(parts[8]) : null;
+                if (!isNaN(pid) && portMatch) {
+                    listeners.push({
+                        port: parseInt(portMatch[1], 10),
+                        pid,
+                        process: processName,
+                    });
+                }
+            }
+        }
+        catch {
+            // lsof failed
+        }
+        return listeners;
+    }
+    async getEnvironmentInfo() {
+        const [runningProcesses, ports, projectStructure] = await Promise.all([
+            this.findRunningProcesses(),
+            this.getPortListeners(),
+            this.scanProject(),
+        ]);
+        return {
+            process: this.getProcessInfo(),
+            runningProcesses,
+            ports,
+            projectStructure,
+        };
+    }
+    async executeExpression(expression) {
+        try {
+            const fn = new Function("require", `return (${expression})`);
+            const result = fn(require);
+            const type = typeof result;
+            return {
+                result: typeof result === "object" ? JSON.stringify(result, null, 2) : String(result),
+                type,
+            };
+        }
+        catch (error) {
+            throw new RuntimeLensError(`Expression evaluation failed: ${error instanceof Error ? error.message : String(error)}`, "EVAL_FAILED");
+        }
+    }
+    async scanProject() {
+        const framework = await this.detectProjectFramework();
+        const configFiles = await this.findConfigFiles();
+        const logFiles = await this.findLogFiles();
+        return { framework, logFiles, configFiles };
+    }
+    async detectProjectFramework() {
+        try {
+            const content = await readFile(join(this.projectRoot, "package.json"), "utf-8");
+            const pkg = JSON.parse(content);
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (deps["@nestjs/core"])
+                return "nestjs";
+            if (deps["next"])
+                return "nextjs";
+            if (deps["react"])
+                return "react";
+        }
+        catch {
+            // no package.json
+        }
+        return "unknown";
+    }
+    async findConfigFiles() {
+        const candidates = [
+            "package.json", "tsconfig.json", "next.config.js", "next.config.mjs",
+            "next.config.ts", "nest-cli.json", ".env", ".env.local",
+            "vite.config.ts", "webpack.config.js", "tailwind.config.js",
+            "tailwind.config.ts", "postcss.config.js",
+        ];
+        const found = [];
+        for (const file of candidates) {
+            try {
+                await stat(join(this.projectRoot, file));
+                found.push(file);
+            }
+            catch {
+                // doesn't exist
+            }
+        }
+        return found;
+    }
+    async findLogFiles() {
+        const dirs = ["logs", ".next/server", "dist", "tmp"];
+        const logFiles = [];
+        for (const dir of dirs) {
+            try {
+                const fullPath = join(this.projectRoot, dir);
+                const dirStat = await stat(fullPath);
+                if (!dirStat.isDirectory())
+                    continue;
+                const files = await readdir(fullPath);
+                for (const file of files) {
+                    if (file.endsWith(".log")) {
+                        logFiles.push(join(dir, file));
+                    }
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+        return logFiles;
+    }
+    detectFrameworkFromCommand(command) {
+        if (command.includes("next"))
+            return "nextjs";
+        if (command.includes("nest"))
+            return "nestjs";
+        if (command.includes("react-scripts") || command.includes("vite"))
+            return "react";
+        return "unknown";
+    }
+    async findPortForPid(pid) {
+        try {
+            const { stdout } = await execAsync(`lsof -iTCP -sTCP:LISTEN -P -n -p ${pid} 2>/dev/null | tail -1`);
+            const portRegex = /:(\d+)\s/;
+            const portMatch = portRegex.exec(stdout);
+            return portMatch ? parseInt(portMatch[1], 10) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=process-inspector.js.map

package/dist/process-inspector.js.map

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

package/dist/runtime-interceptor.d.ts

@@ -0,0 +1,18 @@
+import { LogCollector } from "./log-collector.js";
+import type { Framework } from "./types.js";
+export declare class RuntimeInterceptor {
+    private originalConsole;
+    private intercepting;
+    private readonly collector;
+    private readonly framework;
+    constructor(collector: LogCollector, framework?: Framework);
+    startIntercepting(): void;
+    stopIntercepting(): void;
+    isActive(): boolean;
+    private interceptStderr;
+    private interceptUncaughtErrors;
+    private serialize;
+    private captureStack;
+    private inferLevel;
+}
+//# sourceMappingURL=runtime-interceptor.d.ts.map

package/dist/runtime-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-interceptor.d.ts","sourceRoot":"","sources":["../src/runtime-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,YAAY,CAAC;AAYtD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,eAAe,CAAkE;IACzF,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,SAAS,EAAE,YAAY,EAAE,SAAS,GAAE,SAAqB;IAKrE,iBAAiB,IAAI,IAAI;IA4BzB,gBAAgB,IAAI,IAAI;IAaxB,QAAQ,IAAI,OAAO;IAInB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;CAQnB"}