@vibesdotdev/logging 0.0.2 → 1.0.0-rc.5

package/dist/formatters/jsonl/jsonl.impl.js

@@ -3,6 +3,7 @@
  *
  * Uses Bun's native JSON serialization for performance.
  */
+import { RuntimeLogEntrySchema } from "../../schemas/entry.js";
 /**
  * JSONL formatter - one JSON object per line.
  */
@@ -17,14 +18,14 @@ export default class JsonlFormatter {
         return JSON.stringify(entry);
     }
     parse(formatted) {
-        return JSON.parse(formatted);
+        return RuntimeLogEntrySchema.parse(JSON.parse(formatted));
     }
     formatBatch(entries) {
         return entries.map((e) => JSON.stringify(e)).join('\n');
     }
     parseBatch(formatted) {
         const lines = formatted.split('\n').filter((line) => line.trim());
-        return lines.map((line) => JSON.parse(line));
+        return lines.map((line) => this.parse(line));
     }
 }
 //# sourceMappingURL=jsonl.impl.js.map

package/dist/formatters/jsonl/jsonl.impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonl.impl.js","sourceRoot":"","sources":["../../../src/formatters/jsonl/jsonl.impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACzB,EAAE,CAAS;IACX,UAAU,CAAsB;IAEzC,YAAY,UAA+B,EAAE,QAA0B;QACtE,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,KAAsB;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,SAAiB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAoB,CAAC;IACjD,CAAC;IAED,WAAW,CAAC,OAA0B;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,SAAiB;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC,CAAC;IACjE,CAAC;CACD"}
+{"version":3,"file":"jsonl.impl.js","sourceRoot":"","sources":["../../../src/formatters/jsonl/jsonl.impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,qBAAqB,EAAwB,MAAM,wBAAwB,CAAC;AAErF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACzB,EAAE,CAAS;IACX,UAAU,CAAsB;IAEzC,YAAY,UAA+B,EAAE,QAA0B;QACtE,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,KAAsB;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,SAAiB;QACtB,OAAO,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,WAAW,CAAC,OAA0B;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,SAAiB;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;CACD"}

package/dist/formatters/pretty/{pretty.impl.cli.d.ts → pretty.impl.consumer.d.ts}

@@ -20,4 +20,4 @@ export default class PrettyFormatter implements FormatterImplementation {
     formatBatch(entries: RuntimeLogEntry[]): string;
     parseBatch(formatted: string): RuntimeLogEntry[];
 }
-//# sourceMappingURL=pretty.impl.cli.d.ts.map
+//# sourceMappingURL=pretty.impl.consumer.d.ts.map

package/dist/formatters/pretty/pretty.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/formatters/pretty/pretty.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAmBpF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,uBAAuB;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAE/B,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB;IAOvE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAsCtC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe;IAYzC,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM;IAI/C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;CAGhD"}

package/dist/formatters/pretty/{pretty.impl.cli.js → pretty.impl.consumer.js}

@@ -78,4 +78,4 @@ export default class PrettyFormatter {
         return formatted.split('\n').map((line) => this.parse(line));
     }
 }
-//# sourceMappingURL=pretty.impl.cli.js.map
+//# sourceMappingURL=pretty.impl.consumer.js.map

package/dist/formatters/pretty/pretty.impl.consumer.js.map

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

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

@@ -0,0 +1,39 @@
+import { type AuditImplementation, type AuditContext, type AuditLogInput, type AuditQueryOptions, type AuditDescriptor, type AuditEntry } from '../host.ts';
+import type { LoggingFileHost } from '../schemas/file-host.ts';
+export declare class FileAuditBase implements AuditImplementation {
+    readonly id: string;
+    private readonly host;
+    readonly descriptor: AuditDescriptor;
+    /** The descriptor-injected workspace (`optionalContext`); undefined on an unbound host. */
+    private readonly workspacePath;
+    private readonly retentionPolicy;
+    private readonly runtime;
+    private readonly accepted;
+    private closing;
+    private closePromise;
+    constructor(host: LoggingFileHost, descriptor: AuditDescriptor, context: AuditContext);
+    /** The category's live audit file; refuses `workspace-unbound` when no workspace is bound. */
+    private get auditPath();
+    private assertLive;
+    private trackAccepted;
+    close(): Promise<void>;
+    log(input: AuditLogInput): Promise<AuditEntry>;
+    private appendEntry;
+    private readSegment;
+    private readSegments;
+    private timestamp;
+    private rotateIfNeeded;
+    query(options?: AuditQueryOptions): Promise<AuditEntry[]>;
+    private readEntries;
+    enforceRetention(): Promise<{
+        deleted: number;
+        archived: number;
+        retentionDays: number;
+    }>;
+    private pruneSegments;
+}
+type FileAuditClass = new (descriptor: AuditDescriptor, context: AuditContext) => FileAuditBase;
+/** The file audit class over `host`, one per host. */
+export declare function fileAuditFor(host: LoggingFileHost): FileAuditClass;
+export {};
+//# sourceMappingURL=file-audit.base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-audit.base.d.ts","sourceRoot":"","sources":["../../src/host-files/file-audit.base.ts"],"names":[],"mappings":"AAOA,OAAO,EAGN,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAOf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAgB/D,qBAAa,aAAc,YAAW,mBAAmB;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,2FAA2F;IAC3F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAA4B;gBAEpC,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY;IAgBrF,8FAA8F;IAC9F,OAAO,KAAK,SAAS,GAKpB;IAED,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,aAAa;IAMrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYhB,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;YAOtC,WAAW;YAaX,WAAW;YAyBX,YAAY;IAiB1B,OAAO,CAAC,SAAS;YAQH,cAAc;IAiBtB,KAAK,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAOrD,WAAW;IAsBnB,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;YAOjF,aAAa;CAiC3B;AAED,KAAK,cAAc,GAAG,KAAK,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,KAAK,aAAa,CAAC;AAIhG,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAWlE"}

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

@@ -0,0 +1,255 @@
+/**
+ * The file-backed audit logger over the host's file primitives: one JSONL
+ * segment per category under the bound workspace, rotated by size, age and
+ * count, with retention over the archived segments. `fileAuditFor(host)` is
+ * the class a host registers.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { trackLoggingResource, untrackLoggingResource, AuditDescriptorSchema, AuditEntrySchema, auditSeverityMeets, buildAuditEntry, attempt, isMissingPath } from "../host.js";
+import { normalizeRetention, retentionAgeField, retentionCutoff, retentionPolicyIsMeaningful } from '@vibesdotdev/kernel/schemas';
+const MAX_SEGMENT_BYTES = 10 * 1024 * 1024;
+const MAX_SEGMENT_AGE_MS = 24 * 60 * 60 * 1000;
+export class FileAuditBase {
+    id;
+    host;
+    descriptor;
+    /** The descriptor-injected workspace (`optionalContext`); undefined on an unbound host. */
+    workspacePath;
+    retentionPolicy;
+    runtime;
+    accepted = new Set();
+    closing = false;
+    closePromise;
+    constructor(host, descriptor, context) {
+        this.host = host;
+        this.runtime = context.runtime;
+        this.descriptor = AuditDescriptorSchema.parse(descriptor);
+        this.id = this.descriptor.id;
+        // Optional context: the audit selects on an unbound host, and every
+        // operation that needs its file refuses typed (C092), never skips.
+        this.workspacePath = context['runtime/workspace-path'] || undefined;
+        const policy = normalizeRetention(this.descriptor.retention);
+        if (!policy)
+            throw new CapabilityError('Audit retention cannot be normalized.', 'INVALID_INPUT', {
+                reason: 'audit-retention-invalid', details: { id: this.id }
+            });
+        this.retentionPolicy = policy;
+        trackLoggingResource(this.runtime, this);
+    }
+    /** The category's live audit file; refuses `workspace-unbound` when no workspace is bound. */
+    get auditPath() {
+        if (!this.workspacePath)
+            throw new CapabilityError('A file audit requires its descriptor-injected workspace.', 'NOT_FOUND', {
+                reason: 'workspace-unbound', details: { kind: 'context', id: 'runtime/workspace-path', audit: this.id }, retryable: false
+            });
+        return this.host.join(this.workspacePath, 'logs', 'audit', `${this.descriptor.category}.jsonl`);
+    }
+    assertLive() {
+        if (this.closing || this.runtime.lifecycle.signal.aborted)
+            throw new CapabilityError('The file audit no longer accepts operations.', 'CANCELLED', {
+                reason: this.runtime.lifecycle.signal.aborted ? 'audit-runtime-disposed' : 'audit-closed', cause: this.runtime.lifecycle.signal.reason
+            });
+    }
+    trackAccepted(operation) {
+        this.accepted.add(operation);
+        // Tracking only waits for settlement; the operation's caller receives its failure.
+        void Promise.allSettled([operation]).then(() => this.accepted.delete(operation));
+    }
+    close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closing = true;
+        this.closePromise = (async () => {
+            const drained = await Promise.allSettled(this.accepted);
+            untrackLoggingResource(this.runtime, this);
+            const failures = drained.filter(result => result.status === 'rejected').map(result => result.reason);
+            if (failures.length)
+                throw new AggregateError(failures, 'File audit operations failed during disposal.');
+        })();
+        return this.closePromise;
+    }
+    async log(input) {
+        this.assertLive();
+        const accepted = this.appendEntry(input);
+        this.trackAccepted(accepted.then(() => { }));
+        return accepted;
+    }
+    async appendEntry(input) {
+        const entry = buildAuditEntry(input);
+        // Logging's one severity rank decides what reaches the file.
+        if (auditSeverityMeets(input.severity, this.descriptor.severity)) {
+            const wire = JSON.stringify(entry) + '\n';
+            await this.host.mkdirRecursive(this.host.dirname(this.auditPath));
+            await this.rotateIfNeeded(await this.readSegment(this.auditPath, true), new TextEncoder().encode(wire).byteLength);
+            // One append operation: no shared buffer, read/modify/write or private file lock.
+            await this.host.appendText(this.auditPath, wire);
+        }
+        return entry;
+    }
+    async readSegment(path, live) {
+        const read = await attempt(async () => ({
+            content: await this.host.readText(path),
+            bytes: (await this.host.stat(path)).size
+        }));
+        if ('failure' in read) {
+            if (isMissingPath(read.failure))
+                return undefined;
+            throw new CapabilityError('Could not read audit entries.', 'INTERNAL', {
+                reason: 'audit-read-failed', details: { id: this.id, path }, cause: read.failure.cause
+            });
+        }
+        const { content, bytes } = read.value;
+        const entries = [];
+        for (const [index, line] of content.split('\n').entries()) {
+            if (!line.trim())
+                continue;
+            try {
+                entries.push(AuditEntrySchema.parse(JSON.parse(line)));
+            }
+            catch (error) {
+                throw new CapabilityError('Audit file contains an invalid entry.', 'INVALID_INPUT', {
+                    reason: 'audit-entry-invalid', details: { id: this.id, path, line: index + 1 }, cause: error
+                });
+            }
+        }
+        return { path, entries, bytes, live };
+    }
+    async readSegments() {
+        const listed = await attempt(() => this.host.readdir(this.host.dirname(this.auditPath)));
+        if ('failure' in listed) {
+            if (isMissingPath(listed.failure))
+                return [];
+            throw listed.failure.cause;
+        }
+        const prefix = this.host.basename(this.auditPath) + '.';
+        const paths = listed.value.filter(name => name.startsWith(prefix)).sort().map(name => this.host.join(this.host.dirname(this.auditPath), name));
+        paths.push(this.auditPath);
+        const segments = [];
+        for (const path of paths) {
+            const segment = await this.readSegment(path, path === this.auditPath);
+            if (segment)
+                segments.push(segment);
+        }
+        return segments;
+    }
+    timestamp(entry) {
+        const timestamp = Date.parse(entry.timestamp);
+        if (!Number.isFinite(timestamp))
+            throw new CapabilityError('Audit retention requires a valid timestamp.', 'INVALID_INPUT', {
+                reason: 'audit-retention-clock-invalid', details: { id: this.id, entryId: entry.id }
+            });
+        return timestamp;
+    }
+    async rotateIfNeeded(segment, additionalBytes = 0) {
+        if (!segment || segment.entries.length === 0)
+            return 0;
+        const oldest = segment.entries.reduce((value, entry) => Math.min(value, this.timestamp(entry)), Infinity);
+        const maxBytes = Math.min(MAX_SEGMENT_BYTES, this.retentionPolicy.maxBytes ?? MAX_SEGMENT_BYTES);
+        const maxAgeMs = Math.min(MAX_SEGMENT_AGE_MS, (this.retentionPolicy.maxAgeDays ?? 1) * MAX_SEGMENT_AGE_MS);
+        const countBound = this.retentionPolicy.maxEntries !== undefined && segment.entries.length >= this.retentionPolicy.maxEntries;
+        if (!countBound && segment.bytes + additionalBytes < maxBytes && Date.now() - oldest < maxAgeMs)
+            return 0;
+        const archive = `${this.auditPath}.${Date.now()}.${crypto.randomUUID()}`;
+        const renamed = await attempt(() => this.host.rename(this.auditPath, archive));
+        if ('failure' in renamed) {
+            // Another appender/retention worker may already have rotated the live name.
+            if (isMissingPath(renamed.failure))
+                return 0;
+            throw renamed.failure.cause;
+        }
+        return segment.entries.length;
+    }
+    async query(options = {}) {
+        this.assertLive();
+        const accepted = this.readEntries(options);
+        this.trackAccepted(accepted.then(() => { }));
+        return accepted;
+    }
+    async readEntries(options) {
+        let entries = (await this.readSegments()).flatMap(segment => segment.entries);
+        if (options.category)
+            entries = entries.filter(entry => entry.category === options.category);
+        const minimum = options.severity;
+        if (minimum)
+            entries = entries.filter(entry => auditSeverityMeets(entry.severity, minimum));
+        if (options.actorId)
+            entries = entries.filter(entry => entry.actor.id === options.actorId);
+        if (options.targetId)
+            entries = entries.filter(entry => entry.target?.id === options.targetId);
+        if (options.action)
+            entries = entries.filter(entry => entry.action === options.action);
+        if (options.outcome)
+            entries = entries.filter(entry => entry.outcome === options.outcome);
+        if (options.after) {
+            const after = new Date(options.after).getTime();
+            entries = entries.filter(entry => new Date(entry.timestamp).getTime() >= after);
+        }
+        if (options.before) {
+            const before = new Date(options.before).getTime();
+            entries = entries.filter(entry => new Date(entry.timestamp).getTime() <= before);
+        }
+        if (options.offset !== undefined)
+            entries = entries.slice(options.offset);
+        if (options.limit !== undefined)
+            entries = entries.slice(0, options.limit);
+        return entries;
+    }
+    async enforceRetention() {
+        this.assertLive();
+        const accepted = this.pruneSegments();
+        this.trackAccepted(accepted.then(() => { }));
+        return accepted;
+    }
+    async pruneSegments() {
+        const policy = this.retentionPolicy;
+        const ageField = retentionAgeField({ ...policy, ageField: policy.ageField ?? 'timestamp' });
+        if (policy.cascadeFrom || policy.enforcedBy || ageField !== 'timestamp' ||
+            !retentionPolicyIsMeaningful(policy) ||
+            (policy.maxAgeDays !== undefined && !Number.isFinite(policy.maxAgeDays))) {
+            throw new CapabilityError('This audit retention policy is not supported by the file audit implementation.', 'UNAVAILABLE', {
+                reason: 'audit-retention-unsupported', details: { id: this.id, policy }
+            });
+        }
+        // Validate every aging clock before mutating any name, including an archive.
+        const before = await this.readSegments();
+        for (const segment of before)
+            for (const entry of segment.entries)
+                this.timestamp(entry);
+        const archived = await this.rotateIfNeeded(before.find(segment => segment.live));
+        const segments = (await this.readSegments()).filter(segment => !segment.live);
+        const cutoff = retentionCutoff(policy, Date.now())?.getTime();
+        const latest = (segment) => segment.entries.reduce((value, entry) => Math.max(value, this.timestamp(entry)), 0);
+        segments.sort((left, right) => latest(left) - latest(right) || left.path.localeCompare(right.path));
+        let entries = segments.reduce((count, segment) => count + segment.entries.length, 0);
+        let bytes = segments.reduce((count, segment) => count + segment.bytes, 0);
+        let deleted = 0;
+        for (const segment of segments) {
+            if ((cutoff === undefined || latest(segment) >= cutoff) &&
+                (policy.maxEntries === undefined || entries <= policy.maxEntries) &&
+                (policy.maxBytes === undefined || bytes <= policy.maxBytes))
+                continue;
+            const unlinked = await attempt(() => this.host.unlink(segment.path));
+            if ('failure' in unlinked && !isMissingPath(unlinked.failure))
+                throw unlinked.failure.cause;
+            entries -= segment.entries.length;
+            bytes -= segment.bytes;
+            deleted += segment.entries.length;
+        }
+        return { deleted, archived, retentionDays: policy.maxAgeDays ?? 0 };
+    }
+}
+const auditClasses = new WeakMap();
+/** The file audit class over `host`, one per host. */
+export function fileAuditFor(host) {
+    let bound = auditClasses.get(host);
+    if (!bound) {
+        bound = class AuditLogger extends FileAuditBase {
+            constructor(descriptor, context) {
+                super(host, descriptor, context);
+            }
+        };
+        auditClasses.set(host, bound);
+    }
+    return bound;
+}
+//# sourceMappingURL=file-audit.base.js.map

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

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

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

@@ -0,0 +1,84 @@
+/**
+ * The `file` output (and each named file stream it creates) over the host's
+ * file primitives (`LoggingFileHost`): buffered ordered appends, size and age
+ * rotation, retention, reads, tails and the copy-truncate rotation of a file
+ * another process appends to. `fileOutputFor(host)` is the class a host
+ * registers; every stream it creates is that same class.
+ */
+import { type FileOutputImplementation, type AppendedFileRotation, type AppendedFileRotationPolicy, type OutputContext, type OutputReadOptions, type OutputTailOptions, type TailHandle, type OutputStats, type OutputDescriptor, type RuntimeLogEntry } from '../host.ts';
+import type { LoggingFileHost } from '../schemas/file-host.ts';
+export declare class FileOutputBase implements FileOutputImplementation {
+    readonly id: string;
+    private readonly host;
+    readonly descriptor: OutputDescriptor;
+    private readonly formatter;
+    private readonly filePath;
+    private readonly rotation;
+    private readonly buffering;
+    private readonly runtime;
+    private readonly context;
+    private buffer;
+    private bufferBytes;
+    private file;
+    private flushPromise;
+    private closePromise;
+    private closing;
+    private readonly tails;
+    private readonly acceptedLines;
+    private readonly pendingDiagnostics;
+    private readonly diagnosticFailures;
+    private rotationSequence;
+    /** The one-shot flush pending for the current buffer (lifecycle-owned). */
+    private flushDisposer;
+    /** The retention tick on a persistent host (lifecycle-owned). */
+    private retentionDisposer;
+    private currentSize;
+    private writeQueue;
+    constructor(host: LoggingFileHost, descriptor: OutputDescriptor, context: OutputContext);
+    /**
+     * Report a background operation's failure through the fallback logger. A
+     * failure that cannot be reported is kept and raised by `close`.
+     */
+    private diagnose;
+    private assertWritable;
+    write(entry: RuntimeLogEntry): Promise<void>;
+    writeBatch(entries: RuntimeLogEntry[]): Promise<void>;
+    private enqueue;
+    /** One lifecycle-owned flush per non-empty buffer, `flushInterval` after its first write. */
+    private scheduleFlush;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /** Run `work` in write order, after every write queued before it. */
+    private serialized;
+    private endFile;
+    /** Close the active file, archive it as `<file>.<timestamp>` and bound the archives; `null` when there was no active file. */
+    rotate(): Promise<{
+        archived: string | null;
+    }>;
+    /** Rotation itself; runs only inside the write queue, so it never flushes back into it. */
+    private rotateActiveFile;
+    enforceRetention(): Promise<{
+        removed: number;
+    }>;
+    read(options?: OutputReadOptions): Promise<string[]>;
+    tail(callback: (line: string) => void, options?: OutputTailOptions): TailHandle;
+    stats(): Promise<OutputStats>;
+    writeLine(line: string | Promise<string | null>): Promise<void>;
+    /** A separately configured file stream on this output's Runtime. */
+    create(descriptor: OutputDescriptor, namedContext: OutputContext): Promise<FileOutputBase>;
+    /** Admit a line now; write it once classified (`null` writes nothing). */
+    writeReservedLine(line: Promise<string | null>): Promise<void>;
+    /** Copy-truncate rotation for a file another process appends to (L1). */
+    rotateAppendedFile(path: string, policy: AppendedFileRotationPolicy): Promise<AppendedFileRotation>;
+    private writeChunk;
+    private ensureFile;
+    private shouldRotateBySize;
+    private maybeRotateStaleActiveFile;
+    private cleanupOldFiles;
+}
+/** The file output class one host registers: `FileOutputBase` over that host's primitives. */
+type FileOutputClass = new (descriptor: OutputDescriptor, context: OutputContext) => FileOutputBase;
+/** The file output class over `host`, one per host, so every stream it creates is the same class. */
+export declare function fileOutputFor(host: LoggingFileHost): FileOutputClass;
+export {};
+//# sourceMappingURL=file-output.base.d.ts.map

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

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