@vibesdotdev/logging 0.0.2 → 1.0.0-rc.4

package/dist/host-files/file-output.read.base.js

@@ -0,0 +1,229 @@
+/**
+ * Reading and tailing a file output's active file over the host's file
+ * primitives (`LoggingFileHost`): bounded filtered reads, and a tail that
+ * follows appends and replacement of the active file through directory events.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { LoggedErrorSchema } from "../core/redact.js";
+import { attempt, attemptSync, isMissingPath } from "../core/attempt.js";
+const ReadOptionsSchema = z.object({
+    lines: z.number().int().nonnegative().default(50),
+    offset: z.number().int().nonnegative().default(0),
+    filter: z.union([z.string(), z.instanceof(RegExp)]).optional(),
+    ignoreCase: z.boolean().default(false)
+});
+function parseFilter(filter, ignoreCase) {
+    if (filter === undefined || filter === '')
+        return undefined;
+    try {
+        return filter instanceof RegExp
+            ? new RegExp(filter.source, filter.flags)
+            : new RegExp(filter, ignoreCase ? 'i' : undefined);
+    }
+    catch (error) {
+        throw new CapabilityError('The output filter is not a valid regular expression.', 'INVALID_INPUT', {
+            reason: 'output-read-filter-invalid', cause: error
+        });
+    }
+}
+function matchesFilter(filter, line) {
+    if (!filter)
+        return true;
+    filter.lastIndex = 0;
+    return filter.test(line);
+}
+export async function readLines(host, filePath, options) {
+    const parsed = ReadOptionsSchema.safeParse(options ?? {});
+    if (!parsed.success) {
+        throw new CapabilityError('The output read options are invalid.', 'INVALID_INPUT', {
+            reason: 'output-read-options-invalid', cause: parsed.error
+        });
+    }
+    const { lines: lineCount, offset, filter, ignoreCase } = parsed.data;
+    const regex = parseFilter(filter, ignoreCase);
+    const read = await attempt(() => host.readText(filePath));
+    if ('failure' in read) {
+        if (isMissingPath(read.failure))
+            return [];
+        throw new CapabilityError('Could not read the file output.', 'INTERNAL', {
+            reason: 'output-read-failed', details: { path: filePath }, cause: read.failure.cause
+        });
+    }
+    const lines = read.value.split('\n').filter(line => line.trim() && matchesFilter(regex, line));
+    const end = Math.max(0, lines.length - offset);
+    return lines.slice(Math.max(0, end - lineCount), end);
+}
+const TailOptionsSchema = ReadOptionsSchema.omit({ offset: true }).extend({
+    lines: z.number().int().nonnegative().default(10)
+});
+/** Native directory events follow both appends and replacement of the active file. */
+export function tailFile(host, filePath, callback, options, reportError) {
+    const parsed = TailOptionsSchema.safeParse(options ?? {});
+    if (!parsed.success) {
+        throw new CapabilityError('The output tail options are invalid.', 'INVALID_INPUT', {
+            reason: 'output-tail-options-invalid', cause: parsed.error
+        });
+    }
+    const { lines: initialLines, filter, ignoreCase } = parsed.data;
+    const regex = parseFilter(filter, ignoreCase);
+    const directory = host.dirname(filePath);
+    const name = host.basename(filePath);
+    let file = null;
+    let identity = null;
+    let position = 0;
+    let decoder = new TextDecoder();
+    let partial = '';
+    let initial = true;
+    let closed = false;
+    let dirty = false;
+    let reading = null;
+    let closing = null;
+    const pendingDiagnostics = new Set();
+    const diagnosticFailures = [];
+    function report(error) {
+        // A diagnostic that cannot be delivered is kept and raised by `close`.
+        const completed = attempt(() => reportError(error)).then(reported => {
+            if ('failure' in reported)
+                diagnosticFailures.push(LoggedErrorSchema.parse(reported.failure.cause));
+        });
+        pendingDiagnostics.add(completed);
+        void completed.then(() => pendingDiagnostics.delete(completed));
+    }
+    function deliver(line) {
+        if (closed || !line.trim() || !matchesFilter(regex, line))
+            return;
+        const delivered = attemptSync(() => callback(line));
+        if ('failure' in delivered)
+            report(LoggedErrorSchema.parse(delivered.failure.cause));
+    }
+    function reset() {
+        position = 0;
+        decoder = new TextDecoder();
+        partial = '';
+    }
+    async function drain() {
+        if (!file || closed)
+            return;
+        const current = await file.stat();
+        if (current.size < position)
+            reset();
+        const latest = [];
+        const bytes = new Uint8Array(65536);
+        while (!closed && position < current.size) {
+            const read = await file.read(bytes, 0, Math.min(bytes.byteLength, current.size - position), position);
+            if (read.bytesRead === 0)
+                break;
+            position += read.bytesRead;
+            const lines = (partial + decoder.decode(bytes.subarray(0, read.bytesRead), { stream: true })).split('\n');
+            partial = lines.pop() ?? '';
+            for (const line of lines) {
+                if (initial) {
+                    if (initialLines > 0 && line.trim() && matchesFilter(regex, line)) {
+                        latest.push(line);
+                        if (latest.length > initialLines)
+                            latest.shift();
+                    }
+                }
+                else
+                    deliver(line);
+            }
+        }
+        if (initial) {
+            initial = false;
+            for (const line of latest)
+                deliver(line);
+        }
+    }
+    async function refresh() {
+        // Drain the previous inode before switching, including an append that
+        // arrived immediately before its rename.
+        await drain();
+        if (closed)
+            return;
+        const statted = await attempt(() => host.stat(filePath));
+        if ('failure' in statted) {
+            if (isMissingPath(statted.failure))
+                return;
+            throw statted.failure.cause;
+        }
+        const selected = statted.value;
+        if (identity && identity.dev === selected.dev && identity.ino === selected.ino)
+            return;
+        if (file)
+            await file.close();
+        file = null;
+        identity = null;
+        reset();
+        const reopened = await attempt(() => host.open(filePath, 'r'));
+        if ('failure' in reopened) {
+            if (isMissingPath(reopened.failure))
+                return;
+            throw reopened.failure.cause;
+        }
+        file = reopened.value;
+        const opened = await file.stat();
+        identity = { dev: opened.dev, ino: opened.ino };
+        await drain();
+    }
+    function requestRead() {
+        if (closed)
+            return;
+        dirty = true;
+        if (reading)
+            return;
+        reading = attempt(async () => {
+            while (dirty && !closed) {
+                dirty = false;
+                await refresh();
+            }
+        }).then(refreshed => {
+            if ('failure' in refreshed)
+                report(LoggedErrorSchema.parse(refreshed.failure.cause));
+        }).finally(() => { reading = null; });
+    }
+    let watcher;
+    try {
+        host.mkdirRecursiveSync(directory);
+        watcher = host.watchDirectory(directory, (changed) => {
+            if (changed === null || changed === name)
+                requestRead();
+        });
+    }
+    catch (error) {
+        throw new CapabilityError('Could not watch the file output.', 'INTERNAL', {
+            reason: 'output-tail-watch-failed', details: { path: filePath }, cause: error
+        });
+    }
+    // The watcher's failure ends its native events: report it, then release it.
+    const watchFailed = new Promise((_resolve, reject) => { watcher.onError(reject); });
+    void attempt(() => watchFailed).then(watched => {
+        if (!('failure' in watched))
+            return;
+        report(LoggedErrorSchema.parse(watched.failure.cause));
+        watcher.close();
+    });
+    requestRead();
+    return {
+        close() {
+            if (closing)
+                return closing;
+            closed = true;
+            dirty = false;
+            watcher.close();
+            closing = (async () => {
+                if (reading)
+                    await reading;
+                const opened = file;
+                file = null;
+                if (opened)
+                    await opened.close();
+                await Promise.all(pendingDiagnostics);
+                if (diagnosticFailures.length)
+                    throw new AggregateError(diagnosticFailures, 'File tail diagnostics failed.');
+            })();
+            return closing;
+        }
+    };
+}
+//# sourceMappingURL=file-output.read.base.js.map

package/dist/host-files/file-output.read.base.js.map

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

package/dist/host-files/file-sink.base.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The `file` sink over the host's file primitives: a host file stream
+ * (`fileOutputFor(host)`) at the global log directory, batched by entries and
+ * elapsed time. `fileSinkFor(host)` is the class a host registers.
+ */
+import { type SinkImplementation, type SinkContext, type SinkDescriptor, type RuntimeLogEntry } from '../host.ts';
+import type { LoggingFileHost } from '../schemas/file-host.ts';
+/** File sinks and file outputs share the owner's ordered append and cleanup. */
+export declare class FileSinkBase implements SinkImplementation {
+    readonly id: string;
+    readonly descriptor: SinkDescriptor;
+    private readonly output;
+    constructor(host: LoggingFileHost, descriptor: SinkDescriptor, context: SinkContext);
+    emit(entry: RuntimeLogEntry): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+type FileSinkClass = new (descriptor: SinkDescriptor, context: SinkContext) => FileSinkBase;
+/** The `file` sink class over `host`, one per host. */
+export declare function fileSinkFor(host: LoggingFileHost): FileSinkClass;
+export {};
+//# sourceMappingURL=file-sink.base.d.ts.map

package/dist/host-files/file-sink.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.base.d.ts","sourceRoot":"","sources":["../../src/host-files/file-sink.base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,eAAe,EAGpB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,gFAAgF;AAChF,qBAAa,YAAa,YAAW,kBAAkB;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW;IAmBnF,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtB;AAED,KAAK,aAAa,GAAG,KAAK,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,KAAK,YAAY,CAAC;AAI5F,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAWhE"}

package/dist/host-files/file-sink.base.js

@@ -0,0 +1,56 @@
+/**
+ * The `file` sink over the host's file primitives: a host file stream
+ * (`fileOutputFor(host)`) at the global log directory, batched by entries and
+ * elapsed time. `fileSinkFor(host)` is the class a host registers.
+ */
+import { SinkDescriptorSchema, OutputDescriptorSchema, getCapturedLoggingConfig } from "../host.js";
+import { getVibesGlobalLogDir } from "../paths.js";
+import { fileOutputFor } from "./file-output.base.js";
+/** File sinks and file outputs share the owner's ordered append and cleanup. */
+export class FileSinkBase {
+    id;
+    descriptor;
+    output;
+    constructor(host, descriptor, context) {
+        this.descriptor = SinkDescriptorSchema.parse(descriptor);
+        this.id = this.descriptor.id;
+        const runtime = context.runtime;
+        const logsDir = getVibesGlobalLogDir(runtime);
+        const path = host.join(logsDir, getCapturedLoggingConfig(runtime).fileName);
+        this.output = new (fileOutputFor(host))(OutputDescriptorSchema.parse({
+            kind: 'logging/output', id: this.id, storage: 'file', path, format: 'jsonl',
+            rotation: { maxSize: '10MB', maxAge: '7d', maxFiles: 5 },
+            buffering: {
+                enabled: this.descriptor.batching?.enabled ?? true,
+                // Sink batches are bounded by entries and elapsed time.
+                size: Number.MAX_SAFE_INTEGER,
+                maxBufferEntries: this.descriptor.batching?.maxSize ?? 50,
+                flushInterval: this.descriptor.batching?.maxWait ?? 2000
+            }
+        }), { runtime });
+    }
+    emit(entry) {
+        return this.output.write(entry);
+    }
+    flush() {
+        return this.output.flush();
+    }
+    close() {
+        return this.output.close();
+    }
+}
+const sinkClasses = new WeakMap();
+/** The `file` sink class over `host`, one per host. */
+export function fileSinkFor(host) {
+    let bound = sinkClasses.get(host);
+    if (!bound) {
+        bound = class FileSink extends FileSinkBase {
+            constructor(descriptor, context) {
+                super(host, descriptor, context);
+            }
+        };
+        sinkClasses.set(host, bound);
+    }
+    return bound;
+}
+//# sourceMappingURL=file-sink.base.js.map

package/dist/host-files/file-sink.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.base.js","sourceRoot":"","sources":["../../src/host-files/file-sink.base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAGN,oBAAoB,EAGpB,sBAAsB,EACtB,wBAAwB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAuB,MAAM,uBAAuB,CAAC;AAE3E,gFAAgF;AAChF,MAAM,OAAO,YAAY;IACf,EAAE,CAAS;IACX,UAAU,CAAiB;IACnB,MAAM,CAAiB;IAExC,YAAY,IAAqB,EAAE,UAA0B,EAAE,OAAoB;QAClF,IAAI,CAAC,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC;YACpE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO;YAC3E,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;YACxD,SAAS,EAAE;gBACV,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;gBAClD,wDAAwD;gBACxD,IAAI,EAAE,MAAM,CAAC,gBAAgB;gBAC7B,gBAAgB,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE;gBACzD,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;aACxD;SACD,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,KAAsB;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD;AAID,MAAM,WAAW,GAAG,IAAI,OAAO,EAAkC,CAAC;AAElE,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,IAAqB;IAChD,IAAI,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,GAAG,MAAM,QAAS,SAAQ,YAAY;YAC1C,YAAY,UAA0B,EAAE,OAAoB;gBAC3D,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;SACD,CAAC;QACF,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/host-files/host-file-logging.plugin.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A host's file logging plugin (C092): the `file` sink, the `file` output (and
+ * the `mcp-stdout-capture` storage it backs), the file-backed audit logger and
+ * the scheduled audit retention job, each over the host's own file primitives.
+ * Each runtime-environment host registers it under its own plugin identity;
+ * consumer hardware only. `{ files: false }` registers none of them.
+ */
+import type { HostFileLoggingDefinition, HostFileLoggingOptions } from '../schemas/file-host.ts';
+/** The host's file logging plugin, registered under `definition`'s identity over `definition.host`. */
+export declare function createHostFileLoggingPlugin(definition: HostFileLoggingDefinition, options?: HostFileLoggingOptions): import("@vibesdotdev/kernel").RuntimePlugin;
+//# sourceMappingURL=host-file-logging.plugin.d.ts.map

package/dist/host-files/host-file-logging.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-file-logging.plugin.d.ts","sourceRoot":"","sources":["../../src/host-files/host-file-logging.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,uGAAuG;AACvG,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,yBAAyB,EAAE,OAAO,GAAE,sBAA2B,+CAoDtH"}

package/dist/host-files/host-file-logging.plugin.js

@@ -0,0 +1,63 @@
+/**
+ * A host's file logging plugin (C092): the `file` sink, the `file` output (and
+ * the `mcp-stdout-capture` storage it backs), the file-backed audit logger and
+ * the scheduled audit retention job, each over the host's own file primitives.
+ * Each runtime-environment host registers it under its own plugin identity;
+ * consumer hardware only. `{ files: false }` registers none of them.
+ */
+import { CapabilityError, createRuntimePlugin, getRuntimeStdioCapture } from '@vibesdotdev/kernel';
+import { fileOutputDescriptor } from "../outputs/file/file.outputs.descriptor.js";
+import { fileSinkDescriptor } from "../sinks/file/file.sinks.descriptor.js";
+import stdoutCaptureOutputDescriptor from "../stdout-capture/stdout-capture.output.descriptor.js";
+import { ALL_AUDIT_DESCRIPTORS } from "../audit/audit.descriptor.js";
+import { auditRetentionJobDescriptor } from "../audit/audit-retention.job.descriptor.js";
+import { captureLoggingConfig } from "../config/load-config.js";
+/** The host's file logging plugin, registered under `definition`'s identity over `definition.host`. */
+export function createHostFileLoggingPlugin(definition, options = {}) {
+    const files = options.files ?? true;
+    const { host } = definition;
+    return createRuntimePlugin({
+        id: definition.id,
+        name: definition.name,
+        description: definition.description,
+        // No declared dependency on the portable `logging` plugin: a host registers this from its
+        // environment onRegister, before the composition registers `logging`. Descriptors and
+        // loaders for logging kinds that do not exist yet are queued by the kernel and install
+        // when `logging` registers its kinds; a composition without logging leaves them inert.
+        descriptors: files ? [fileSinkDescriptor, fileOutputDescriptor, auditRetentionJobDescriptor] : [],
+        onRegister: async (runtime) => {
+            if (!files)
+                return;
+            // Audit descriptors declare `optionalContext: ['runtime/workspace-path']`
+            // (Logging owns them): the file audit selects on an unbound host and
+            // its writes refuse `workspace-unbound`, typed.
+            runtime.registerLoader('logging/sink', fileSinkDescriptor.id, async () => {
+                await captureLoggingConfig(runtime);
+                return { impl: (await import("./file-sink.base.js")).fileSinkFor(host) };
+            }, { constraint: { hardware: ['consumer'] } });
+            runtime.registerLoader('logging/output', fileOutputDescriptor.id, async () => {
+                return { impl: (await import("./file-output.factory.base.js")).fileOutputFactoryFor(host) };
+            }, { constraint: { hardware: ['consumer'] } });
+            // Capture storage stays selected by the handed host's stdio capability.
+            runtime.registerLoader('logging/output', stdoutCaptureOutputDescriptor.id, async (handedRuntime) => {
+                if (!handedRuntime)
+                    throw new CapabilityError('Capture storage selection requires its resolving Runtime.', 'INVALID_INPUT', {
+                        reason: 'stdout-capture-runtime-missing', retryable: false
+                    });
+                await getRuntimeStdioCapture(handedRuntime);
+                return { impl: (await import("./file-output.factory.base.js")).fileOutputFactoryFor(host) };
+            });
+            for (const descriptor of ALL_AUDIT_DESCRIPTORS) {
+                runtime.registerLoader('logging/audit', descriptor.id, async () => {
+                    return { impl: (await import("./file-audit.base.js")).fileAuditFor(host) };
+                }, { constraint: { hardware: ['consumer'] } });
+            }
+            // The audit retention schedule is a Workers job (RC11, D19): no timer here.
+            runtime.registerLoader('workers/job', auditRetentionJobDescriptor.id, async () => {
+                const { AuditRetentionJob } = await import("../audit/audit-retention.job.impl.js");
+                return { impl: AuditRetentionJob };
+            }, { constraint: { hardware: ['consumer'] } });
+        }
+    });
+}
+//# sourceMappingURL=host-file-logging.plugin.js.map

package/dist/host-files/host-file-logging.plugin.js.map

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

package/dist/host-files/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @vibesdotdev/logging/host-files
+ *
+ * The base implementation of the file contract in `@vibesdotdev/logging/host`
+ * (C092): the `file` sink, the `file` output and its streams, copy-truncate
+ * rotation, the file audit and the host plugin that registers them, all over
+ * a host's file primitives (`LoggingFileHost`). It reads no host API; each
+ * runtime-environment host supplies the primitives and registers
+ * `createHostFileLoggingPlugin` under its own identity.
+ */
+export { createHostFileLoggingPlugin } from './host-file-logging.plugin.ts';
+export { FileOutputBase, fileOutputFor } from './file-output.base.ts';
+export { FileOutputFactoryBase, fileOutputFactoryFor } from './file-output.factory.base.ts';
+export { FileSinkBase, fileSinkFor } from './file-sink.base.ts';
+export { FileAuditBase, fileAuditFor } from './file-audit.base.ts';
+export { rotateAppendedFileOn } from './rotate-appended-file.base.ts';
+export { readLines, tailFile } from './file-output.read.base.ts';
+export type { FileTailHandle, HostFileLoggingDefinition, HostFileLoggingOptions, LoggingDirectoryWatch, LoggingFileHandle, LoggingFileHost, LoggingFileStats } from '../schemas/file-host.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/host-files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host-files/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EACX,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,MAAM,yBAAyB,CAAC"}

package/dist/host-files/index.js

@@ -0,0 +1,18 @@
+/**
+ * @vibesdotdev/logging/host-files
+ *
+ * The base implementation of the file contract in `@vibesdotdev/logging/host`
+ * (C092): the `file` sink, the `file` output and its streams, copy-truncate
+ * rotation, the file audit and the host plugin that registers them, all over
+ * a host's file primitives (`LoggingFileHost`). It reads no host API; each
+ * runtime-environment host supplies the primitives and registers
+ * `createHostFileLoggingPlugin` under its own identity.
+ */
+export { createHostFileLoggingPlugin } from "./host-file-logging.plugin.js";
+export { FileOutputBase, fileOutputFor } from "./file-output.base.js";
+export { FileOutputFactoryBase, fileOutputFactoryFor } from "./file-output.factory.base.js";
+export { FileSinkBase, fileSinkFor } from "./file-sink.base.js";
+export { FileAuditBase, fileAuditFor } from "./file-audit.base.js";
+export { rotateAppendedFileOn } from "./rotate-appended-file.base.js";
+export { readLines, tailFile } from "./file-output.read.base.js";
+//# sourceMappingURL=index.js.map

package/dist/host-files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host-files/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/host-files/rotate-appended-file.base.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copy-truncate rotation for a file another process appends to (L1), over
+ * the host's file primitives (`LoggingFileHost`).
+ *
+ * PM children and the PM daemon write their stdout/stderr through inherited
+ * `O_APPEND` descriptors so the files outlive — and are adopted across —
+ * daemon restarts. Rename-based rotation would leave those writers appending
+ * to the archive, so this rotation copies the active file to `.1` and
+ * truncates it in place; an `O_APPEND` writer then continues at the new end.
+ *
+ * Semantics match the file output (`schemas/output-defaults.ts`): a file at or
+ * over `maxSizeBytes` rotates, and at most `maxFiles` archives are kept
+ * (`<path>.1` newest … `<path>.<maxFiles>` oldest).
+ *
+ * KNOWN LIMIT — bytes can be lost. Bytes a writer appends after the copy
+ * reads them and before the truncate lands are in neither file. The window
+ * is kept to the copy itself (a copy-on-write clone where the filesystem
+ * supports it) plus one truncate issued immediately after, with nothing else
+ * awaited between them. Full capture is the policy, so this limit is stated,
+ * not hidden: a writer that must lose nothing needs a log owner that holds
+ * the write side, not an inherited descriptor.
+ *
+ * A writer WITHOUT `O_APPEND` keeps its old offset after the truncate and
+ * produces a sparse file; only `O_APPEND` writers may be rotated this way.
+ */
+import type { AppendedFileRotation, AppendedFileRotationPolicy } from '../kinds/file-output.ts';
+import type { LoggingFileHost } from '../schemas/file-host.ts';
+/**
+ * Rotate `path` when it has reached `policy.maxSizeBytes`: shift
+ * `.1 … .maxFiles-1` up one, drop `.maxFiles`, copy the active file to `.1`,
+ * then truncate it in place. A missing active file is nothing to rotate; every
+ * other failure propagates. The file operations are `host`'s.
+ */
+export declare function rotateAppendedFileOn(host: LoggingFileHost, path: string, policy: AppendedFileRotationPolicy): Promise<AppendedFileRotation>;
+//# sourceMappingURL=rotate-appended-file.base.d.ts.map

package/dist/host-files/rotate-appended-file.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotate-appended-file.base.d.ts","sourceRoot":"","sources":["../../src/host-files/rotate-appended-file.base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAqD/D;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,0BAA0B,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAwB/B"}

package/dist/host-files/rotate-appended-file.base.js

@@ -0,0 +1,104 @@
+/**
+ * Copy-truncate rotation for a file another process appends to (L1), over
+ * the host's file primitives (`LoggingFileHost`).
+ *
+ * PM children and the PM daemon write their stdout/stderr through inherited
+ * `O_APPEND` descriptors so the files outlive — and are adopted across —
+ * daemon restarts. Rename-based rotation would leave those writers appending
+ * to the archive, so this rotation copies the active file to `.1` and
+ * truncates it in place; an `O_APPEND` writer then continues at the new end.
+ *
+ * Semantics match the file output (`schemas/output-defaults.ts`): a file at or
+ * over `maxSizeBytes` rotates, and at most `maxFiles` archives are kept
+ * (`<path>.1` newest … `<path>.<maxFiles>` oldest).
+ *
+ * KNOWN LIMIT — bytes can be lost. Bytes a writer appends after the copy
+ * reads them and before the truncate lands are in neither file. The window
+ * is kept to the copy itself (a copy-on-write clone where the filesystem
+ * supports it) plus one truncate issued immediately after, with nothing else
+ * awaited between them. Full capture is the policy, so this limit is stated,
+ * not hidden: a writer that must lose nothing needs a log owner that holds
+ * the write side, not an inherited descriptor.
+ *
+ * A writer WITHOUT `O_APPEND` keeps its old offset after the truncate and
+ * produces a sparse file; only `O_APPEND` writers may be rotated this way.
+ */
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { attempt, isMissingPath } from "../core/attempt.js";
+async function removeIfPresent(host, path) {
+    const removed = await attempt(() => host.unlink(path));
+    if ('failure' in removed && !isMissingPath(removed.failure))
+        throw removed.failure.cause;
+}
+async function moveIfPresent(host, from, to) {
+    const moved = await attempt(() => host.rename(from, to));
+    if ('failure' in moved && !isMissingPath(moved.failure))
+        throw moved.failure.cause;
+}
+const RotationInputSchema = z.object({
+    path: z.string().min(1).refine((path) => !path.includes('\0')),
+    policy: z.object({
+        maxSizeBytes: z.number().finite().positive(),
+        maxFiles: z.number().int().min(1)
+    }).strict()
+}).strict();
+function invalidRotationInput(failure) {
+    return new CapabilityError('Rotation requires a path, maxSizeBytes > 0 and an integer maxFiles >= 1.', 'INVALID_INPUT', {
+        reason: 'rotation-policy-invalid',
+        retryable: false,
+        details: failure === undefined ? undefined : {
+            failureName: failure.name,
+            failureCode: failure.code ?? 'unspecified',
+            failureReason: failure.reason ?? 'unspecified'
+        }
+    });
+}
+function parseRotationInput(path, policy) {
+    try {
+        return { ok: true, parsed: RotationInputSchema.safeParse({ path, policy }) };
+    }
+    catch (error) {
+        return { ok: false, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+/** Read the public input once and return a detached copy, never caller-owned getters or proxies. */
+function readRotationInput(path, policy) {
+    const read = parseRotationInput(path, policy);
+    if (!read.ok)
+        throw invalidRotationInput(read.failure);
+    const parsed = read.parsed;
+    if (!parsed.success)
+        throw invalidRotationInput();
+    return parsed.data;
+}
+/**
+ * Rotate `path` when it has reached `policy.maxSizeBytes`: shift
+ * `.1 … .maxFiles-1` up one, drop `.maxFiles`, copy the active file to `.1`,
+ * then truncate it in place. A missing active file is nothing to rotate; every
+ * other failure propagates. The file operations are `host`'s.
+ */
+export async function rotateAppendedFileOn(host, path, policy) {
+    const input = readRotationInput(path, policy);
+    path = input.path;
+    policy = input.policy;
+    const measured = await attempt(async () => (await host.stat(path)).size);
+    if ('failure' in measured) {
+        if (isMissingPath(measured.failure))
+            return { rotated: false };
+        throw measured.failure.cause;
+    }
+    const size = measured.value;
+    if (size < policy.maxSizeBytes)
+        return { rotated: false };
+    await removeIfPresent(host, `${path}.${policy.maxFiles}`);
+    for (let index = policy.maxFiles - 1; index >= 1; index--) {
+        await moveIfPresent(host, `${path}.${index}`, `${path}.${index + 1}`);
+    }
+    // The loss window starts here: keep the copy fast (clone when supported)
+    // and truncate the moment it completes.
+    await host.copyFileClone(path, `${path}.1`);
+    await host.truncate(path, 0);
+    return { rotated: true, previousSize: size };
+}
+//# sourceMappingURL=rotate-appended-file.base.js.map

package/dist/host-files/rotate-appended-file.base.js.map

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