@orgloop/logger-file 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrgLoop contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/file-logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * JSONL file logger with buffering and rotation.
+ *
+ * The default production logger for OrgLoop.
+ */
+import type { LogEntry, Logger } from '@orgloop/sdk';
+export declare class FileLogger implements Logger {
+    readonly id = "file";
+    private filePath;
+    private buffer;
+    private bufferSize;
+    private flushTimer;
+    private rotation;
+    private dirEnsured;
+    init(config: Record<string, unknown>): Promise<void>;
+    log(entry: LogEntry): Promise<void>;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private ensureDir;
+}
+//# sourceMappingURL=file-logger.d.ts.map

package/dist/file-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-logger.d.ts","sourceRoot":"","sources":["../src/file-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAmBrD,qBAAa,UAAW,YAAW,MAAM;IACxC,QAAQ,CAAC,EAAE,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,QAAQ,CAKd;IACF,OAAO,CAAC,UAAU,CAAS;IAErB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DpD,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAQjB,SAAS;CAUvB"}

package/dist/file-logger.js

@@ -0,0 +1,126 @@
+/**
+ * JSONL file logger with buffering and rotation.
+ *
+ * The default production logger for OrgLoop.
+ */
+import { appendFile, mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, resolve } from 'node:path';
+import { parseDuration } from '@orgloop/sdk';
+import { needsRotation, parseSize, rotateFile } from './rotation.js';
+export class FileLogger {
+    id = 'file';
+    filePath = '';
+    buffer = [];
+    bufferSize = 100;
+    flushTimer = null;
+    rotation = {
+        maxSize: 100 * 1024 * 1024, // 100MB
+        maxAge: 7 * 24 * 60 * 60 * 1000, // 7d
+        maxFiles: 10,
+        compress: true,
+    };
+    dirEnsured = false;
+    async init(config) {
+        const cfg = config;
+        // Resolve file path (expand ~ to home directory)
+        const rawPath = cfg.path ?? `${homedir()}/.orgloop/logs/orgloop.log`;
+        const expanded = rawPath.startsWith('~/') ? rawPath.replace('~', homedir()) : rawPath;
+        this.filePath = resolve(expanded);
+        // Parse rotation config
+        if (cfg.rotation) {
+            if (cfg.rotation.max_size) {
+                this.rotation.maxSize = parseSize(cfg.rotation.max_size);
+            }
+            if (cfg.rotation.max_age) {
+                this.rotation.maxAge = parseDuration(cfg.rotation.max_age);
+            }
+            if (cfg.rotation.max_files !== undefined) {
+                this.rotation.maxFiles = cfg.rotation.max_files;
+            }
+            if (cfg.rotation.compress !== undefined) {
+                this.rotation.compress = cfg.rotation.compress;
+            }
+        }
+        // Parse buffer config
+        if (cfg.buffer) {
+            if (cfg.buffer.size !== undefined) {
+                this.bufferSize = cfg.buffer.size;
+            }
+            if (cfg.buffer.flush_interval) {
+                const intervalMs = parseDuration(cfg.buffer.flush_interval);
+                this.flushTimer = setInterval(() => {
+                    void this.flush();
+                }, intervalMs);
+                if (this.flushTimer.unref) {
+                    this.flushTimer.unref();
+                }
+            }
+        }
+        // Default flush interval of 1s if not configured
+        if (!this.flushTimer) {
+            this.flushTimer = setInterval(() => {
+                void this.flush();
+            }, 1000);
+            if (this.flushTimer.unref) {
+                this.flushTimer.unref();
+            }
+        }
+        // Create log file on init so tail -f works immediately
+        await this.ensureDir();
+        try {
+            await appendFile(this.filePath, '', 'utf-8');
+        }
+        catch {
+            // Best-effort — will retry on first flush
+        }
+    }
+    async log(entry) {
+        try {
+            this.buffer.push(JSON.stringify(entry));
+            if (this.buffer.length >= this.bufferSize) {
+                await this.flush();
+            }
+        }
+        catch {
+            // Loggers must not throw
+        }
+    }
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const entries = this.buffer.splice(0);
+        const data = entries.map((e) => `${e}\n`).join('');
+        try {
+            await this.ensureDir();
+            await appendFile(this.filePath, data, 'utf-8');
+            // Check if rotation is needed
+            if (await needsRotation(this.filePath, this.rotation.maxSize)) {
+                await rotateFile(this.filePath, this.rotation);
+            }
+        }
+        catch {
+            // Loggers must not throw — entries are lost on write failure
+        }
+    }
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+    async ensureDir() {
+        if (this.dirEnsured)
+            return;
+        try {
+            await mkdir(dirname(this.filePath), { recursive: true });
+            this.dirEnsured = true;
+        }
+        catch {
+            // Directory may already exist
+            this.dirEnsured = true;
+        }
+    }
+}
+//# sourceMappingURL=file-logger.js.map

package/dist/file-logger.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @orgloop/logger-file — registration entry point.
+ */
+import type { LoggerRegistration } from '@orgloop/sdk';
+export declare function register(): LoggerRegistration;
+export { FileLogger } from './file-logger.js';
+export { parseSize, rotateFile, needsRotation } from './rotation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,wBAAgB,QAAQ,IAAI,kBAAkB,CA+C7C;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,55 @@
+/**
+ * @orgloop/logger-file — registration entry point.
+ */
+import { FileLogger } from './file-logger.js';
+export function register() {
+    return {
+        id: 'file',
+        logger: FileLogger,
+        configSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'Log file path (default: ~/.orgloop/logs/orgloop.log)',
+                },
+                format: {
+                    type: 'string',
+                    enum: ['jsonl'],
+                    description: 'Log format (only "jsonl" for MVP).',
+                    default: 'jsonl',
+                },
+                rotation: {
+                    type: 'object',
+                    properties: {
+                        max_size: {
+                            type: 'string',
+                            description: 'Rotate when file exceeds this size (e.g., "100MB")',
+                        },
+                        max_age: {
+                            type: 'string',
+                            description: 'Delete rotated files after this duration (e.g., "7d")',
+                        },
+                        max_files: { type: 'number', description: 'Keep at most N rotated files', default: 10 },
+                        compress: { type: 'boolean', description: 'Gzip rotated files', default: true },
+                    },
+                },
+                buffer: {
+                    type: 'object',
+                    properties: {
+                        size: { type: 'number', description: 'Buffer N entries before flushing', default: 100 },
+                        flush_interval: {
+                            type: 'string',
+                            description: 'Flush at least every N (e.g., "1s")',
+                            default: '1s',
+                        },
+                    },
+                },
+            },
+            additionalProperties: false,
+        },
+    };
+}
+export { FileLogger } from './file-logger.js';
+export { parseSize, rotateFile, needsRotation } from './rotation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,QAAQ;IACvB,OAAO;QACN,EAAE,EAAE,MAAM;QACV,MAAM,EAAE,UAAU;QAClB,YAAY,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,IAAI,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACnE;gBACD,MAAM,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,CAAC;oBACf,WAAW,EAAE,oCAAoC;oBACjD,OAAO,EAAE,OAAO;iBAChB;gBACD,QAAQ,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACX,QAAQ,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,oDAAoD;yBACjE;wBACD,OAAO,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uDAAuD;yBACpE;wBACD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE,OAAO,EAAE,EAAE,EAAE;wBACvF,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE;qBAC/E;iBACD;gBACD,MAAM,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACX,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE,OAAO,EAAE,GAAG,EAAE;wBACvF,cAAc,EAAE;4BACf,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,qCAAqC;4BAClD,OAAO,EAAE,IAAI;yBACb;qBACD;iBACD;aACD;YACD,oBAAoB,EAAE,KAAK;SAC3B;KACD,CAAC;AACH,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/rotation.d.ts

@@ -0,0 +1,28 @@
+/**
+ * File rotation logic for the JSONL file logger.
+ *
+ * Handles: renaming current file to timestamped name, optional gzip compression,
+ * and cleanup of old rotated files.
+ */
+export interface RotationConfig {
+    maxSize: number;
+    maxAge: number;
+    maxFiles: number;
+    compress: boolean;
+}
+/**
+ * Parse a size string (e.g., "100MB", "1GB") to bytes.
+ */
+export declare function parseSize(size: string): number;
+/**
+ * Check if a file exceeds the max size.
+ */
+export declare function needsRotation(filePath: string, maxSize: number): Promise<boolean>;
+/**
+ * Rotate the current log file:
+ * 1. Rename to timestamped name
+ * 2. Optionally gzip
+ * 3. Clean up old files
+ */
+export declare function rotateFile(filePath: string, config: RotationConfig): Promise<void>;
+//# sourceMappingURL=rotation.d.ts.map

package/dist/rotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotation.d.ts","sourceRoot":"","sources":["../src/rotation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB9C;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvF;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BxF"}

package/dist/rotation.js

@@ -0,0 +1,122 @@
+/**
+ * File rotation logic for the JSONL file logger.
+ *
+ * Handles: renaming current file to timestamped name, optional gzip compression,
+ * and cleanup of old rotated files.
+ */
+import { createReadStream, createWriteStream } from 'node:fs';
+import { mkdir, readdir, rename, stat, unlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { createGzip } from 'node:zlib';
+/**
+ * Parse a size string (e.g., "100MB", "1GB") to bytes.
+ */
+export function parseSize(size) {
+    const match = size.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)$/i);
+    if (!match) {
+        throw new Error(`Invalid size format: "${size}". Expected format: <number><unit> (e.g., 100MB, 1GB)`);
+    }
+    const value = Number.parseFloat(match[1]);
+    const unit = match[2].toUpperCase();
+    switch (unit) {
+        case 'B':
+            return value;
+        case 'KB':
+            return value * 1024;
+        case 'MB':
+            return value * 1024 * 1024;
+        case 'GB':
+            return value * 1024 * 1024 * 1024;
+        default:
+            throw new Error(`Unknown size unit: ${unit}`);
+    }
+}
+/**
+ * Check if a file exceeds the max size.
+ */
+export async function needsRotation(filePath, maxSize) {
+    try {
+        const st = await stat(filePath);
+        return st.size >= maxSize;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Rotate the current log file:
+ * 1. Rename to timestamped name
+ * 2. Optionally gzip
+ * 3. Clean up old files
+ */
+export async function rotateFile(filePath, config) {
+    const dir = dirname(filePath);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const baseName = filePath.split('/').pop();
+    const rotatedName = `${baseName}.${timestamp}`;
+    const rotatedPath = join(dir, rotatedName);
+    // Rename current → timestamped
+    try {
+        await rename(filePath, rotatedPath);
+    }
+    catch {
+        // File may not exist or be locked; skip rotation
+        return;
+    }
+    // Optionally compress
+    if (config.compress) {
+        try {
+            const gzPath = `${rotatedPath}.gz`;
+            await pipeline(createReadStream(rotatedPath), createGzip(), createWriteStream(gzPath));
+            await unlink(rotatedPath);
+        }
+        catch {
+            // Compression failed; leave the uncompressed file
+        }
+    }
+    // Clean up old files
+    await cleanupOldFiles(dir, baseName, config);
+}
+/**
+ * Remove rotated files that exceed maxFiles or maxAge.
+ */
+async function cleanupOldFiles(dir, baseName, config) {
+    try {
+        await mkdir(dir, { recursive: true });
+        const files = await readdir(dir);
+        // Find rotated files matching our base name
+        const rotated = [];
+        for (const file of files) {
+            if (file.startsWith(`${baseName}.`) && file !== baseName) {
+                try {
+                    const st = await stat(join(dir, file));
+                    rotated.push({ name: file, mtime: st.mtimeMs });
+                }
+                catch {
+                    // Skip files we can't stat
+                }
+            }
+        }
+        // Sort by mtime descending (newest first)
+        rotated.sort((a, b) => b.mtime - a.mtime);
+        const now = Date.now();
+        for (let i = 0; i < rotated.length; i++) {
+            const entry = rotated[i];
+            const isOverLimit = i >= config.maxFiles;
+            const isExpired = now - entry.mtime > config.maxAge;
+            if (isOverLimit || isExpired) {
+                try {
+                    await unlink(join(dir, entry.name));
+                }
+                catch {
+                    // Best effort cleanup
+                }
+            }
+        }
+    }
+    catch {
+        // Directory issues — skip cleanup
+    }
+}
+//# sourceMappingURL=rotation.js.map

package/dist/rotation.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@orgloop/logger-file",
+  "version": "0.1.0",
+  "description": "OrgLoop file logger — JSONL with rotation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@orgloop/sdk": "0.1.0"
+  },
+  "orgloop": {
+    "type": "logger",
+    "id": "file"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}