repack-logs-mcp 1.0.0

package/dist/log-watcher.js

@@ -0,0 +1,164 @@
+import { watch } from 'chokidar';
+import { readFile, stat } from 'fs/promises';
+import { existsSync } from 'fs';
+/**
+ * Watches a Re.Pack log file and streams entries to a LogStore.
+ */
+export class LogWatcher {
+    filePath;
+    store;
+    watcher = null;
+    lastPosition = 0;
+    watching = false;
+    constructor(filePath, store) {
+        this.filePath = filePath;
+        this.store = store;
+    }
+    /**
+     * Start watching the log file.
+     */
+    async start() {
+        if (this.watching)
+            return;
+        // Read existing content first
+        await this.readNewContent();
+        // Watch for changes
+        this.watcher = watch(this.filePath, {
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 100,
+                pollInterval: 50,
+            },
+        });
+        this.watcher.on('change', async () => {
+            await this.readNewContent();
+        });
+        this.watcher.on('add', async () => {
+            // File was created, reset position and read
+            this.lastPosition = 0;
+            await this.readNewContent();
+        });
+        this.watcher.on('unlink', () => {
+            // File was deleted, reset position
+            this.lastPosition = 0;
+        });
+        this.watching = true;
+    }
+    /**
+     * Stop watching the log file.
+     */
+    async stop() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        this.watching = false;
+    }
+    /**
+     * Read new content from the log file since last position.
+     */
+    async readNewContent() {
+        if (!existsSync(this.filePath)) {
+            return;
+        }
+        try {
+            const stats = await stat(this.filePath);
+            // If file was truncated, reset position
+            if (stats.size < this.lastPosition) {
+                this.lastPosition = 0;
+            }
+            // Read only new content
+            const content = await readFile(this.filePath, 'utf-8');
+            const newContent = content.slice(this.lastPosition);
+            if (newContent.length === 0)
+                return;
+            // Update position
+            this.lastPosition = content.length;
+            // Parse JSON lines
+            const lines = newContent.split('\n').filter(line => line.trim());
+            for (const line of lines) {
+                try {
+                    const entry = this.parseLine(line);
+                    if (entry) {
+                        this.store.add(entry);
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        catch {
+            // File might not exist yet or be inaccessible
+        }
+    }
+    /**
+     * Parse a single log line into a LogEntry.
+     */
+    parseLine(line) {
+        try {
+            const parsed = JSON.parse(line);
+            // Ensure required fields exist
+            if (!parsed.message && !parsed.msg) {
+                return null;
+            }
+            return {
+                timestamp: parsed.timestamp ?? parsed.time ?? new Date().toISOString(),
+                type: this.normalizeType(parsed.type ?? parsed.level ?? 'info'),
+                message: parsed.message ?? parsed.msg ?? '',
+                issuer: parsed.issuer ?? parsed.source ?? parsed.name,
+                request: parsed.request,
+                file: parsed.file ?? parsed.filename,
+                loader: parsed.loader,
+                stack: parsed.stack,
+                duration: parsed.duration,
+                ...parsed,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Normalize various log level formats to our LogType.
+     */
+    normalizeType(type) {
+        const normalized = type.toLowerCase();
+        if (normalized.includes('error') || normalized === 'err') {
+            return 'error';
+        }
+        if (normalized.includes('warn')) {
+            return 'warn';
+        }
+        if (normalized.includes('debug') || normalized === 'trace') {
+            return 'debug';
+        }
+        if (normalized.includes('success') || normalized === 'done') {
+            return 'success';
+        }
+        if (normalized.includes('progress')) {
+            return 'progress';
+        }
+        return 'info';
+    }
+    /**
+     * Check if the watcher is currently active.
+     */
+    get isWatching() {
+        return this.watching;
+    }
+    /**
+     * Check if the log file exists.
+     */
+    get fileExists() {
+        return existsSync(this.filePath);
+    }
+    /**
+     * Get the path being watched.
+     */
+    get path() {
+        return this.filePath;
+    }
+}
+//# sourceMappingURL=log-watcher.js.map

package/dist/log-watcher.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Log entry structure from Re.Pack's JSON log output.
+ * Re.Pack outputs JSON lines with webpack compilation info.
+ */
+export interface LogEntry {
+    timestamp: string;
+    type: LogType;
+    issuer?: string;
+    message: string;
+    /** Module request path */
+    request?: string;
+    /** File path being processed */
+    file?: string;
+    /** Webpack loader info */
+    loader?: string;
+    /** Error stack trace */
+    stack?: string;
+    /** Build duration in ms */
+    duration?: number;
+    /** Additional metadata */
+    [key: string]: unknown;
+}
+export type LogType = 'info' | 'warn' | 'error' | 'debug' | 'success' | 'progress';
+export interface LogFilter {
+    /** Filter by log type(s) */
+    types?: LogType[];
+    /** Maximum number of logs to return */
+    limit?: number;
+    /** Only logs after this timestamp (ISO string) */
+    since?: string;
+    /** Filter by issuer/source */
+    issuer?: string;
+    /** Search in message content */
+    search?: string;
+}
+export interface WatcherStatus {
+    watching: boolean;
+    filePath: string;
+    fileExists: boolean;
+    logCount: number;
+    errorCount: number;
+    warningCount: number;
+    lastUpdate: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,OAAO,GACf,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "repack-logs-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for tailing Re.Pack/Rock.js dev server logs",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "repack-logs-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "repack",
+    "react-native",
+    "logs",
+    "dev-tools"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "chokidar": "^4.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/config.ts

@@ -0,0 +1,37 @@
+import { resolve } from 'path';
+
+export interface Config {
+  logFilePath: string;
+  maxLogs: number;
+}
+
+const DEFAULT_LOG_FILE = '.repack-logs.json';
+const DEFAULT_MAX_LOGS = 1000;
+
+/**
+ * Parse configuration from CLI args and environment variables.
+ *
+ * Priority:
+ * 1. CLI argument (first positional arg)
+ * 2. REPACK_LOG_FILE environment variable
+ * 3. Default: .repack-logs.json in current directory
+ */
+export function getConfig(): Config {
+  const args = process.argv.slice(2);
+
+  // First positional argument is the log file path
+  const cliPath = args.find(arg => !arg.startsWith('-'));
+
+  const logFilePath = cliPath
+    ?? process.env.REPACK_LOG_FILE
+    ?? DEFAULT_LOG_FILE;
+
+  const maxLogs = process.env.REPACK_MAX_LOGS
+    ? parseInt(process.env.REPACK_MAX_LOGS, 10)
+    : DEFAULT_MAX_LOGS;
+
+  return {
+    logFilePath: resolve(logFilePath),
+    maxLogs,
+  };
+}

package/src/index.ts

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { getConfig } from './config.js';
+import { LogStore } from './log-store.js';
+import { LogWatcher } from './log-watcher.js';
+import type { LogType } from './types.js';
+
+const config = getConfig();
+const store = new LogStore(config.maxLogs);
+const watcher = new LogWatcher(config.logFilePath, store);
+
+// Create MCP server
+const server = new McpServer({
+  name: 'repack-logs-mcp',
+  version: '1.0.0',
+});
+
+// Tool: get_build_logs
+server.tool(
+  'get_build_logs',
+  'Get recent Re.Pack build logs with optional filtering',
+  {
+    limit: z.number().optional().describe('Maximum number of logs to return (default: 50)'),
+    types: z.array(z.enum(['info', 'warn', 'error', 'debug', 'success', 'progress']))
+      .optional()
+      .describe('Filter by log type(s)'),
+    since: z.string().optional().describe('Only logs after this ISO timestamp'),
+    issuer: z.string().optional().describe('Filter by issuer/source name'),
+    search: z.string().optional().describe('Search in log messages'),
+  },
+  async (args) => {
+    const logs = store.get({
+      limit: args.limit ?? 50,
+      types: args.types as LogType[] | undefined,
+      since: args.since,
+      issuer: args.issuer,
+      search: args.search,
+    });
+
+    if (logs.length === 0) {
+      return {
+        content: [{
+          type: 'text',
+          text: 'No logs found matching the criteria.',
+        }],
+      };
+    }
+
+    const formatted = logs.map(log => {
+      const parts = [
+        `[${log.timestamp}]`,
+        `[${log.type.toUpperCase()}]`,
+      ];
+      if (log.issuer) parts.push(`[${log.issuer}]`);
+      parts.push(log.message);
+      if (log.file) parts.push(`\n  File: ${log.file}`);
+      if (log.stack) parts.push(`\n  Stack: ${log.stack}`);
+      return parts.join(' ');
+    }).join('\n\n');
+
+    return {
+      content: [{
+        type: 'text',
+        text: `Found ${logs.length} log(s):\n\n${formatted}`,
+      }],
+    };
+  }
+);
+
+// Tool: get_errors
+server.tool(
+  'get_errors',
+  'Get only errors and warnings from Re.Pack build logs',
+  {
+    limit: z.number().optional().describe('Maximum number of errors to return (default: 20)'),
+  },
+  async (args) => {
+    const errors = store.getErrors(args.limit ?? 20);
+
+    if (errors.length === 0) {
+      return {
+        content: [{
+          type: 'text',
+          text: 'No errors or warnings found.',
+        }],
+      };
+    }
+
+    const formatted = errors.map(log => {
+      const icon = log.type === 'error' ? '❌' : '⚠️';
+      const parts = [
+        `${icon} [${log.timestamp}]`,
+        `[${log.type.toUpperCase()}]`,
+      ];
+      if (log.issuer) parts.push(`[${log.issuer}]`);
+      parts.push(log.message);
+      if (log.file) parts.push(`\n   File: ${log.file}`);
+      if (log.stack) parts.push(`\n   Stack: ${log.stack}`);
+      return parts.join(' ');
+    }).join('\n\n');
+
+    const errorCount = errors.filter(e => e.type === 'error').length;
+    const warnCount = errors.filter(e => e.type === 'warn').length;
+
+    return {
+      content: [{
+        type: 'text',
+        text: `Found ${errorCount} error(s) and ${warnCount} warning(s):\n\n${formatted}`,
+      }],
+    };
+  }
+);
+
+// Tool: clear_logs
+server.tool(
+  'clear_logs',
+  'Clear all logs from the in-memory buffer',
+  {},
+  async () => {
+    const count = store.count;
+    store.clear();
+
+    return {
+      content: [{
+        type: 'text',
+        text: `Cleared ${count} log(s) from buffer.`,
+      }],
+    };
+  }
+);
+
+// Tool: get_status
+server.tool(
+  'get_status',
+  'Get the current status of the log watcher',
+  {},
+  async () => {
+    const status = {
+      watching: watcher.isWatching,
+      filePath: watcher.path,
+      fileExists: watcher.fileExists,
+      logCount: store.count,
+      errorCount: store.countByType('error'),
+      warningCount: store.countByType('warn'),
+      lastUpdate: store.lastTimestamp,
+    };
+
+    const lines = [
+      `Watcher Status:`,
+      `  Watching: ${status.watching ? 'Yes' : 'No'}`,
+      `  Log File: ${status.filePath}`,
+      `  File Exists: ${status.fileExists ? 'Yes' : 'No'}`,
+      ``,
+      `Log Statistics:`,
+      `  Total Logs: ${status.logCount}`,
+      `  Errors: ${status.errorCount}`,
+      `  Warnings: ${status.warningCount}`,
+      `  Last Update: ${status.lastUpdate ?? 'Never'}`,
+    ];
+
+    return {
+      content: [{
+        type: 'text',
+        text: lines.join('\n'),
+      }],
+    };
+  }
+);
+
+// Start the server
+async function main() {
+  // Start watching the log file
+  await watcher.start();
+
+  // Connect via stdio
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+
+  // Handle shutdown
+  process.on('SIGINT', async () => {
+    await watcher.stop();
+    process.exit(0);
+  });
+
+  process.on('SIGTERM', async () => {
+    await watcher.stop();
+    process.exit(0);
+  });
+}
+
+main().catch((error) => {
+  console.error('Failed to start MCP server:', error);
+  process.exit(1);
+});

package/src/log-store.ts

@@ -0,0 +1,113 @@
+import type { LogEntry, LogFilter, LogType } from './types.js';
+
+/**
+ * In-memory circular buffer for storing log entries.
+ */
+export class LogStore {
+  private logs: LogEntry[] = [];
+  private maxSize: number;
+
+  constructor(maxSize: number = 1000) {
+    this.maxSize = maxSize;
+  }
+
+  /**
+   * Add a log entry to the store.
+   * Removes oldest entries if buffer is full.
+   */
+  add(entry: LogEntry): void {
+    this.logs.push(entry);
+
+    // Trim if over max size
+    if (this.logs.length > this.maxSize) {
+      this.logs = this.logs.slice(-this.maxSize);
+    }
+  }
+
+  /**
+   * Add multiple log entries at once.
+   */
+  addMany(entries: LogEntry[]): void {
+    for (const entry of entries) {
+      this.add(entry);
+    }
+  }
+
+  /**
+   * Get logs with optional filtering.
+   */
+  get(filter?: LogFilter): LogEntry[] {
+    let result = [...this.logs];
+
+    if (filter?.types && filter.types.length > 0) {
+      result = result.filter(log => filter.types!.includes(log.type));
+    }
+
+    if (filter?.since) {
+      const sinceDate = new Date(filter.since);
+      result = result.filter(log => new Date(log.timestamp) >= sinceDate);
+    }
+
+    if (filter?.issuer) {
+      const issuerLower = filter.issuer.toLowerCase();
+      result = result.filter(log =>
+        log.issuer?.toLowerCase().includes(issuerLower)
+      );
+    }
+
+    if (filter?.search) {
+      const searchLower = filter.search.toLowerCase();
+      result = result.filter(log =>
+        log.message.toLowerCase().includes(searchLower) ||
+        log.file?.toLowerCase().includes(searchLower) ||
+        log.request?.toLowerCase().includes(searchLower)
+      );
+    }
+
+    if (filter?.limit && filter.limit > 0) {
+      // Return most recent logs
+      result = result.slice(-filter.limit);
+    }
+
+    return result;
+  }
+
+  /**
+   * Get only errors and warnings.
+   */
+  getErrors(limit?: number): LogEntry[] {
+    return this.get({
+      types: ['error', 'warn'],
+      limit,
+    });
+  }
+
+  /**
+   * Count logs by type.
+   */
+  countByType(type: LogType): number {
+    return this.logs.filter(log => log.type === type).length;
+  }
+
+  /**
+   * Get total log count.
+   */
+  get count(): number {
+    return this.logs.length;
+  }
+
+  /**
+   * Get the timestamp of the most recent log.
+   */
+  get lastTimestamp(): string | null {
+    if (this.logs.length === 0) return null;
+    return this.logs[this.logs.length - 1].timestamp;
+  }
+
+  /**
+   * Clear all logs from the store.
+   */
+  clear(): void {
+    this.logs = [];
+  }
+}