@lumenflow/core 3.2.0 → 3.2.2

package/dist/logs-lib.js

@@ -0,0 +1,214 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Logs Library (WU-2064)
+ *
+ * Core library for unified log aggregation following Anthropic's agent logging patterns.
+ * Aggregates logs from multiple sources:
+ * - .logs/web.log (structured JSON from Next.js)
+ * - .lumenflow/commands.log (git command audit trail)
+ * - .lumenflow/flow.log (WU flow events)
+ * - .logs/tool-audit.ndjson (Claude Code tool usage audit)
+ *
+ * LIBRARY-FIRST: No general-purpose library exists for project-specific log
+ * aggregation across custom log locations. Uses native JSON.parse like existing
+ * tail-logs.ts in the codebase.
+ *
+ * @see docs/02-technical/standards/logging.md
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
+export const LOG_SOURCES = [
+    { path: '.logs/web.log', source: 'web.log' },
+    { path: LUMENFLOW_PATHS.COMMANDS_LOG, source: 'commands.log' },
+    { path: LUMENFLOW_PATHS.FLOW_LOG, source: 'flow.log' },
+    { path: '.logs/tool-audit.ndjson', source: 'tool-audit.ndjson' },
+];
+/**
+ * Parse a single log line (NDJSON format)
+ *
+ * @param {string} line - JSON log line
+ * @returns {object|null} Parsed log object or null if invalid
+ */
+export function parseLogLine(line) {
+    if (!line || typeof line !== 'string') {
+        return null;
+    }
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Filter log entries by criteria
+ *
+ * @param {object[]} logs - Array of log objects
+ * @param {FilterLogsOptions} options - Filter options
+ * @returns {object[]} Filtered logs
+ */
+export function filterLogs(logs, options = {}) {
+    const { level, service, filter, last } = options;
+    let result = logs;
+    // Filter by level
+    if (level) {
+        result = result.filter((log) => log.level === level);
+    }
+    // Filter by service (message prefix)
+    if (service) {
+        result = result.filter((log) => {
+            const msg = log.msg || log.message || '';
+            const pattern = '.' + service + '.';
+            return msg.startsWith(service) || msg.includes(pattern);
+        });
+    }
+    // Filter by arbitrary text pattern
+    if (filter) {
+        result = result.filter((log) => {
+            const jsonStr = JSON.stringify(log);
+            return jsonStr.includes(filter);
+        });
+    }
+    // Limit to last N entries
+    if (last && last > 0) {
+        result = result.slice(-last);
+    }
+    return result;
+}
+/**
+ * Read and parse a single log file
+ *
+ * @param {string} filePath - Path to log file
+ * @param {string} source - Source identifier for tagging
+ * @returns {object[]} Parsed log entries with _source field
+ */
+function readLogFile(filePath, source) {
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    try {
+        const content = readFileSync(filePath, 'utf8');
+        const lines = content.split('\n').filter(Boolean);
+        const logs = [];
+        for (const line of lines) {
+            const parsed = parseLogLine(line);
+            if (parsed) {
+                parsed._source = source;
+                logs.push(parsed);
+            }
+        }
+        return logs;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Aggregate logs from all configured sources
+ *
+ * @param {AggregateLogsOptions} options - Options
+ * @returns {Promise<object[]>} Aggregated and sorted log entries
+ */
+export async function aggregateLogs(options = {}) {
+    const { cwd = process.cwd() } = options;
+    const allLogs = [];
+    for (const { path: logPath, source } of LOG_SOURCES) {
+        const fullPath = path.join(cwd, logPath);
+        const logs = readLogFile(fullPath, source);
+        allLogs.push(...logs);
+    }
+    // Sort by time (oldest first)
+    allLogs.sort((a, b) => {
+        const timeA = new Date(a.time || 0).getTime();
+        const timeB = new Date(b.time || 0).getTime();
+        return timeA - timeB;
+    });
+    return allLogs;
+}
+/**
+ * Parse command line arguments for logs command
+ *
+ * @param {string[]} args - Command line arguments (without node and script)
+ * @returns {object} Parsed options
+ */
+export function parseLogsArgs(args) {
+    const result = {};
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--last') {
+            i++;
+            const lastArg = args[i];
+            if (typeof lastArg === 'string' && lastArg.length > 0) {
+                result.last = parseInt(lastArg, 10);
+            }
+        }
+        else if (arg === '--level') {
+            i++;
+            result.level = args[i];
+        }
+        else if (arg === '--service') {
+            i++;
+            result.service = args[i];
+        }
+        else if (arg === '--filter') {
+            i++;
+            result.filter = args[i];
+        }
+        else if (arg === '--json') {
+            result.json = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            result.help = true;
+        }
+        // Ignore unknown flags
+        i++;
+    }
+    return result;
+}
+/**
+ * Format a log entry for console display
+ *
+ * @param {object} log - Log object
+ * @returns {string} Formatted log line
+ */
+export function formatLogEntry(log) {
+    const levelColors = {
+        debug: '\x1b[36m', // cyan
+        info: '\x1b[32m', // green
+        warn: '\x1b[33m', // yellow
+        error: '\x1b[31m', // red
+    };
+    const reset = '\x1b[0m';
+    const dim = '\x1b[2m';
+    const level = log.level || 'info';
+    const color = levelColors[level] || reset;
+    const time = log.time
+        ? new Date(log.time).toLocaleTimeString('en-GB', {
+            hour12: false,
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+        })
+        : '??:??:??';
+    const msg = log.msg || log.message || log.event || 'unknown';
+    const source = log._source ? dim + '[' + log._source + ']' + reset : '';
+    // Build metadata string excluding known fields
+    const knownFields = ['time', 'level', 'msg', 'message', 'event', '_source'];
+    const meta = {};
+    for (const [key, value] of Object.entries(log)) {
+        if (!knownFields.includes(key)) {
+            meta[key] = value;
+        }
+    }
+    const metaStr = Object.keys(meta).length > 0 ? ' ' + JSON.stringify(meta) : '';
+    const levelStr = level.toUpperCase().padEnd(5);
+    return color + '[' + time + '] ' + levelStr + reset + ' ' + source + ' ' + msg + metaStr;
+}
+//# sourceMappingURL=logs-lib.js.map

package/dist/logs-lib.js.map

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