@lumenflow/core 3.1.2 → 3.2.0

package/dist/logs-lib.js

@@ -1,214 +0,0 @@
-// 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

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