LogAdapter

Implements ILog

Log adapter with pluggable storage backend.

Features:

• Adapter pattern for swappable log implementations
• Default adapter: LogMemoryUtils (in-memory storage)
• Alternative adapters: LogPersistUtils, LogDummyUtils
• Convenience methods: usePersist(), useMemory(), useDummy()

Constructor

constructor();
Copy

Properties

_logFactory

_logFactory: any
Copy

Factory producing the active log utils instance

getInstance

getInstance: any
Copy

Lazily constructs the log utils from the registered factory and memoizes the result via singleshot.

The instance is built on the first call and cached for all subsequent calls. Reset via clear() so the next call rebuilds from the current factory (e.g. when process.cwd() changes between strategy iterations).

getList

getList: () => Promise<ILogEntry[]>
Copy

Lists all stored log entries. Proxies call to the underlying log adapter.

log

log: (topic: string, ...args: any[]) => void
Copy

Logs a general-purpose message. Proxies call to the underlying log adapter.

debug

debug: (topic: string, ...args: any[]) => void
Copy

Logs a debug-level message. Proxies call to the underlying log adapter.

info

info: (topic: string, ...args: any[]) => void
Copy

Logs an info-level message. Proxies call to the underlying log adapter.

warn

warn: (topic: string, ...args: any[]) => void
Copy

Logs a warning-level message. Proxies call to the underlying log adapter.

useLogger

useLogger: (Ctor: TLogCtor) => void
Copy

Sets the log adapter constructor. All future log operations will use this adapter.

usePersist

usePersist: () => void
Copy

Switches to persistent log adapter. Log entries will be persisted to disk.

useMemory

useMemory: () => void
Copy

Switches to in-memory log adapter (default). Log entries will be stored in memory only.

useDummy

useDummy: () => void
Copy

Switches to dummy log adapter. All future log writes will be no-ops.

useJsonl

useJsonl: (fileName?: string, dirName?: string) => void
Copy

Switches to JSONL file log adapter. Log entries will be appended to {dirName}/{fileName}.jsonl. Reads are performed by parsing all lines from the file.

clear

clear: () => void
Copy

Clears the memoized log instance. Call this when process.cwd() changes between strategy iterations so a new adapter instance is created with the updated base path.