@vibesdotdev/logging 0.0.2 → 1.0.0-rc.4

package/dist/browser/sinks/browser/browser.impl.browser.js

@@ -0,0 +1,247 @@
+/**
+ * Browser Sink Implementation
+ *
+ * Browser-optimized sink with:
+ * - localStorage buffering for persistence across reloads
+ * - Styled console output using CSS
+ * - Batched writes for performance
+ * - Automatic cleanup on page unload
+ */
+import { RuntimeLogEntrySchema } from '@vibesdotdev/logging/schemas/entry';
+import * as z from 'zod/v4';
+import { trackLoggingResource, untrackLoggingResource } from "../../../core/output-resources.js";
+import { attempt } from "../../../core/outcome.js";
+import { LoggedErrorSchema } from "../../../core/redact.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+/** CSS styles for levels (browser devtools) */
+const LEVEL_STYLES = {
+    debug: 'color: #6b7280', // gray-500
+    info: 'color: #3b82f6', // blue-500
+    warn: 'color: #f59e0b', // amber-500
+    error: 'color: #ef4444; font-weight: bold' // red-500
+};
+/** Namespace badge colors */
+const NAMESPACE_COLORS = [
+    '#3b82f6', // blue
+    '#8b5cf6', // violet
+    '#ec4899', // pink
+    '#f97316', // orange
+    '#10b981', // emerald
+    '#06b6d4', // cyan
+    '#6366f1' // indigo
+];
+function getNamespaceColor(namespace) {
+    let hash = 0;
+    for (let i = 0; i < namespace.length; i++) {
+        hash = namespace.charCodeAt(i) + ((hash << 5) - hash);
+    }
+    return NAMESPACE_COLORS[Math.abs(hash) % NAMESPACE_COLORS.length];
+}
+/** Default localStorage key */
+const DEFAULT_STORAGE_KEY = 'vibes:log:buffer';
+/** Maximum buffer size to prevent localStorage overflow */
+const MAX_BUFFER_SIZE = 1000;
+const BrowserSinkConfigSchema = z.object({
+    storageKey: z.string().min(1).default(DEFAULT_STORAGE_KEY),
+    maxBufferSize: z.number().int().nonnegative().default(MAX_BUFFER_SIZE),
+    consoleEnabled: z.boolean().default(true),
+    localStorageEnabled: z.boolean().default(true)
+});
+/** Stored buffer text parsed at the storage boundary: JSON, then wire entries. */
+const StoredBufferSchema = z.string().transform((raw, context) => {
+    const parsed = attempt(() => JSON.parse(raw));
+    if (!parsed.failed)
+        return parsed.value;
+    context.addIssue({ code: 'custom', message: parsed.cause instanceof Error ? parsed.cause.message : 'The stored log buffer is not JSON.' });
+    return z.NEVER;
+}).pipe(RuntimeLogEntrySchema.array());
+/**
+ * Browser sink - optimized for browser environments with:
+ * - Styled console output with color-coded namespaces
+ * - localStorage buffering for persistence
+ * - Batched writes and automatic cleanup
+ */
+export default class BrowserSink {
+    id;
+    descriptor;
+    config;
+    buffer = [];
+    /** The one-shot persist pending for the current buffer (lifecycle-owned, RC07). */
+    flushDisposer = null;
+    /** Batched persistence delay; unset when batching is off. */
+    batchWaitMs;
+    runtime;
+    browser;
+    console;
+    unsubscribeUnload = null;
+    closed = false;
+    lastStorageFailure = null;
+    constructor(descriptor, context) {
+        this.id = descriptor.id;
+        this.descriptor = descriptor;
+        if (!context.runtime?.lifecycle) {
+            throw new CapabilityError('Browser sink requires its owning runtime.', 'INVALID_INPUT', { reason: 'sink-runtime-missing' });
+        }
+        this.runtime = context.runtime;
+        this.browser = context['runtime/browser-host'];
+        this.console = context['runtime/stdio'];
+        if (!this.browser || !this.console) {
+            throw new CapabilityError('Browser sink requires descriptor-injected browser and console ports.', 'INVALID_INPUT', { reason: 'sink-host-context-missing' });
+        }
+        this.config = BrowserSinkConfigSchema.parse(context.config ?? descriptor.config ?? {});
+        this.batchWaitMs = descriptor.batching?.enabled ? descriptor.batching.maxWait : undefined;
+        this.restoreBuffer();
+        this.unsubscribeUnload = this.browser.subscribeBeforeUnload(() => this.persistBuffer());
+        trackLoggingResource(this.runtime, this);
+    }
+    emit(entry) {
+        if (this.closed || this.runtime.lifecycle.signal.aborted) {
+            throw new CapabilityError('Browser sink no longer accepts entries.', this.runtime.lifecycle.signal.aborted ? 'CANCELLED' : 'UNAVAILABLE', {
+                reason: this.closed ? 'sink-closed' : 'sink-runtime-disposed', retryable: false
+            });
+        }
+        if (this.config.consoleEnabled)
+            this.writeToConsole(entry);
+        if (!this.config.localStorageEnabled)
+            return;
+        this.buffer.push(entry);
+        if (this.buffer.length > this.config.maxBufferSize) {
+            this.buffer = this.config.maxBufferSize === 0 ? [] : this.buffer.slice(-this.config.maxBufferSize);
+        }
+        if (entry.level === 'error')
+            this.persistBuffer();
+        else
+            this.schedulePersist();
+    }
+    schedulePersist() {
+        if (this.batchWaitMs === undefined || this.flushDisposer || this.buffer.length === 0)
+            return;
+        const lifecycle = this.runtime.lifecycle;
+        if (lifecycle.signal.aborted) {
+            this.persistBuffer();
+            return;
+        }
+        this.flushDisposer = lifecycle.timeout(() => {
+            this.flushDisposer = null;
+            this.persistBuffer();
+        }, this.batchWaitMs);
+    }
+    async flush() {
+        this.persistBuffer();
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.flushDisposer?.();
+        this.flushDisposer = null;
+        this.unsubscribeUnload?.();
+        this.unsubscribeUnload = null;
+        this.persistBuffer();
+        untrackLoggingResource(this.runtime, this);
+    }
+    /**
+     * Absorb a storage failure observably: record it for {@link storageFailure}
+     * and report it once on the handed console when it is a new kind of failure,
+     * so a refused or full storage is never silent and never floods the console.
+     */
+    recordStorageFailure(failure) {
+        const repeated = this.lastStorageFailure?.operation === failure.operation;
+        this.lastStorageFailure = failure;
+        if (repeated)
+            return;
+        this.console.callConsole('warn', [`[logging:browser-sink] storage ${failure.operation} failed`, {
+                key: failure.key, error: LoggedErrorSchema.parse(failure.cause)
+            }]);
+    }
+    /**
+     * The latest absorbed storage failure, or `null` when none was recorded. A
+     * later successful write clears a `write` failure. See {@link BrowserStorageFailure}.
+     */
+    storageFailure() {
+        return this.lastStorageFailure;
+    }
+    /**
+     * Valid persisted wire entries. An absent buffer (or disabled storage) is
+     * empty; a refused read or a malformed buffer is also empty and is recorded
+     * on {@link storageFailure}.
+     */
+    getBufferedEntries() {
+        if (!this.config.localStorageEnabled)
+            return [];
+        const key = this.config.storageKey;
+        const read = attempt(() => this.browser.storage.getItem(key));
+        if (read.failed) {
+            this.recordStorageFailure({ operation: 'read', key, cause: read.cause });
+            return [];
+        }
+        if (read.value === null)
+            return [];
+        const parsed = StoredBufferSchema.safeParse(read.value);
+        if (parsed.success)
+            return parsed.data;
+        this.recordStorageFailure({ operation: 'malformed', key, cause: parsed.error });
+        return [];
+    }
+    clearBuffer() {
+        this.buffer = [];
+        if (!this.config.localStorageEnabled)
+            return;
+        const key = this.config.storageKey;
+        const removed = attempt(() => this.browser.storage.removeItem(key));
+        // The accepted memory buffer is cleared either way; a refused removal stays observable.
+        if (removed.failed)
+            this.recordStorageFailure({ operation: 'remove', key, cause: removed.cause });
+    }
+    writeToConsole(entry) {
+        const { level, namespace, message, context } = entry;
+        const payload = { ...context };
+        delete payload.timestamp;
+        delete payload.level;
+        delete payload.namespace;
+        delete payload.runtime;
+        const args = [
+            `%c${level.toUpperCase().padStart(5)}%c %c[%s]%c %s`,
+            LEVEL_STYLES[level],
+            '',
+            `background: ${getNamespaceColor(namespace)}; color: white; padding: 1px 4px; border-radius: 3px; font-size: 10px`,
+            namespace,
+            '',
+            message
+        ];
+        if (Object.keys(payload).length > 0)
+            args.push(payload);
+        this.console.callConsole(level, args);
+    }
+    persistBuffer() {
+        if (!this.config.localStorageEnabled || this.buffer.length === 0)
+            return;
+        const key = this.config.storageKey;
+        const merged = [...this.getBufferedEntries(), ...this.buffer];
+        const trimmed = this.config.maxBufferSize === 0 ? [] : merged.slice(-this.config.maxBufferSize);
+        const written = attempt(() => this.browser.storage.setItem(key, JSON.stringify(trimmed)));
+        if (written.failed) {
+            // Quota and availability failures keep accepted entries for the next explicit or batched flush.
+            this.recordStorageFailure({ operation: 'write', key, cause: written.cause });
+            return;
+        }
+        this.buffer = [];
+        // A successful write resolves a prior write refusal; read and malformed records stay until replaced.
+        if (this.lastStorageFailure?.operation === 'write')
+            this.lastStorageFailure = null;
+    }
+    restoreBuffer() {
+        const errors = this.getBufferedEntries().filter(entry => entry.level === 'error');
+        if (errors.length === 0 || !this.config.consoleEnabled)
+            return;
+        this.console.callConsole('groupCollapsed', [`📋 ${errors.length} error(s) from previous session`]);
+        try {
+            for (const entry of errors)
+                this.writeToConsole(entry);
+        }
+        finally {
+            this.console.callConsole('groupEnd', []);
+        }
+    }
+}
+//# sourceMappingURL=browser.impl.browser.js.map

package/dist/browser/sinks/browser/browser.impl.browser.js.map

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

package/dist/cli/failures.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A `vibes logs` command that ran on several outputs or audit loggers reports
+ * each failure on its own line and keeps going, then refuses as a whole so the
+ * command never ends as a success after any of them failed.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+/** A raised value that is provably a `CapabilityError`, else undefined; the check never throws (a Proxy trap or a revoked Proxy is not one). */
+export declare const CapabilityErrorOfSchema: z.ZodPipe<z.ZodUnknown, z.ZodTransform<CapabilityError | undefined, unknown>>;
+/** One output or audit logger the command could not serve, and why. */
+export interface FailedTarget {
+    readonly id: string;
+    readonly cause: unknown;
+}
+/** Every target a command could not serve, by kind. */
+export interface FailedTargets {
+    readonly outputs: FailedTarget[];
+    readonly audits: FailedTarget[];
+}
+/** The message a failed target's cause carries, for its report line. */
+export declare function failureMessage(target: FailedTarget): string;
+/**
+ * The command's typed refusal naming every failed id, by the kind of target
+ * (`outputs`, `audits`). Every cause stays attached.
+ */
+export declare function failedTargetsError(command: string, failed: FailedTargets): CapabilityError;
+/** True when any target failed. */
+export declare function anyFailed(failed: FailedTargets): boolean;
+//# sourceMappingURL=failures.d.ts.map

package/dist/cli/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../src/cli/failures.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,gJAAgJ;AAChJ,eAAO,MAAM,uBAAuB,+EAGlC,CAAC;AAEH,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;CAChC;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,eAAe,CAgB1F;AAED,mCAAmC;AACnC,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAExD"}

package/dist/cli/failures.js

@@ -0,0 +1,44 @@
+/**
+ * A `vibes logs` command that ran on several outputs or audit loggers reports
+ * each failure on its own line and keeps going, then refuses as a whole so the
+ * command never ends as a success after any of them failed.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { ThrownMessageSchema } from "../core/redact.js";
+import { attempt } from "../core/outcome.js";
+/** A raised value that is provably a `CapabilityError`, else undefined; the check never throws (a Proxy trap or a revoked Proxy is not one). */
+export const CapabilityErrorOfSchema = z.unknown().transform((cause) => {
+    const typed = attempt(() => (cause instanceof CapabilityError ? cause : undefined));
+    return typed.failed ? undefined : typed.value;
+});
+/** The message a failed target's cause carries, for its report line. */
+export function failureMessage(target) {
+    return ThrownMessageSchema.parse(target.cause);
+}
+/**
+ * The command's typed refusal naming every failed id, by the kind of target
+ * (`outputs`, `audits`). Every cause stays attached.
+ */
+export function failedTargetsError(command, failed) {
+    const all = [...failed.outputs, ...failed.audits];
+    const named = [
+        failed.outputs.length > 0 ? `output(s) ${failed.outputs.map((target) => target.id).join(', ')}` : '',
+        failed.audits.length > 0 ? `audit logger(s) ${failed.audits.map((target) => target.id).join(', ')}` : ''
+    ].filter((part) => part !== '').join(' and ');
+    return new CapabilityError(`vibes logs ${command} failed for ${named}.`, 'UNAVAILABLE', {
+        reason: 'logs-command-targets-failed',
+        retryable: false,
+        details: {
+            command,
+            outputs: failed.outputs.map((target) => target.id),
+            audits: failed.audits.map((target) => target.id)
+        },
+        cause: all.length === 1 ? all[0].cause : new AggregateError(all.map((target) => target.cause), `vibes logs ${command}: ${all.length} targets failed.`)
+    });
+}
+/** True when any target failed. */
+export function anyFailed(failed) {
+    return failed.outputs.length > 0 || failed.audits.length > 0;
+}
+//# sourceMappingURL=failures.js.map

package/dist/cli/failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.js","sourceRoot":"","sources":["../../src/cli/failures.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,gJAAgJ;AAChJ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAA+B,EAAE;IACnG,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACpF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;AAC/C,CAAC,CAAC,CAAC;AAcH,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,MAAoB;IAClD,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,MAAqB;IACxE,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG;QACb,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QACpG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;KACxG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,eAAe,CAAC,cAAc,OAAO,eAAe,KAAK,GAAG,EAAE,aAAa,EAAE;QACvF,MAAM,EAAE,6BAA6B;QACrC,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE;YACR,OAAO;YACP,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;SAChD;QACD,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,OAAO,KAAK,GAAG,CAAC,MAAM,kBAAkB,CAAC;KACtJ,CAAC,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,SAAS,CAAC,MAAqB;IAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC"}

package/dist/cli/flags.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Every `vibes logs` command flag is parsed here, at the command boundary, by a
+ * schema. Text a flag's schema does not accept is a typed refusal naming the
+ * flag and the value it was given, never a default quietly substituted
+ * (`parseInt('5abc')`) or a filter that matches nothing (`--level bogus`).
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { type LogLevel } from '../schemas/entry.ts';
+/** The refusal for a flag whose text its schema does not accept. */
+export declare function invalidFlag(flag: string, value: string, expected: string): CapabilityError;
+/** A flag's text read through `schema`: omitted, `fallback`; not accepted, the refusal naming the flag. */
+export declare function parseFlag<T>(flag: string, raw: string | undefined, schema: z.ZodType<T, string>, expected: string, fallback: T): T;
+/** A whole count of at least `min`, written in digits only. */
+export declare function countFlagSchema(min: number): z.ZodType<number, string>;
+/** A count flag: digits only, at least `min`. */
+export declare function parseCountFlag(flag: string, raw: string | undefined, fallback: number, min: number): number;
+/** A level flag: one of the log levels, or omitted (no level filter). */
+export declare function parseLevelFlag(flag: string, raw: string | undefined): LogLevel | undefined;
+/** A `--since` filter: a relative age or ISO date/date-time, as epoch milliseconds; omitted, no filter. */
+export declare function parseSinceFlag(flag: string, raw: string | undefined): number | undefined;
+/** A `--since` bound passed on as text: an ISO 8601 date or date-time; omitted, no bound. */
+export declare function parseIsoInstantFlag(flag: string, raw: string | undefined): string | undefined;
+//# sourceMappingURL=flags.d.ts.map

package/dist/cli/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/cli/flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAI1F;AAED,2GAA2G;AAC3G,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAKlI;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtE;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3G;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAE1F;AAgBD,2GAA2G;AAC3G,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAExF;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7F"}

package/dist/cli/flags.js

@@ -0,0 +1,56 @@
+/**
+ * Every `vibes logs` command flag is parsed here, at the command boundary, by a
+ * schema. Text a flag's schema does not accept is a typed refusal naming the
+ * flag and the value it was given, never a default quietly substituted
+ * (`parseInt('5abc')`) or a filter that matches nothing (`--level bogus`).
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { LogLevelSchema } from "../schemas/entry.js";
+/** The refusal for a flag whose text its schema does not accept. */
+export function invalidFlag(flag, value, expected) {
+    return new CapabilityError(`${flag} must be ${expected}; got ${JSON.stringify(value)}.`, 'INVALID_INPUT', {
+        reason: 'logs-flag-invalid', retryable: false, details: { flag, value }
+    });
+}
+/** A flag's text read through `schema`: omitted, `fallback`; not accepted, the refusal naming the flag. */
+export function parseFlag(flag, raw, schema, expected, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const parsed = schema.safeParse(raw);
+    if (!parsed.success)
+        throw invalidFlag(flag, raw, expected);
+    return parsed.data;
+}
+/** A whole count of at least `min`, written in digits only. */
+export function countFlagSchema(min) {
+    return z.string().regex(/^\d+$/).transform(Number).pipe(z.number().int().min(min));
+}
+/** A count flag: digits only, at least `min`. */
+export function parseCountFlag(flag, raw, fallback, min) {
+    return parseFlag(flag, raw, countFlagSchema(min), `a whole number of at least ${min}`, fallback);
+}
+/** A level flag: one of the log levels, or omitted (no level filter). */
+export function parseLevelFlag(flag, raw) {
+    return parseFlag(flag, raw, z.string().pipe(LogLevelSchema), `one of ${LogLevelSchema.options.join(', ')}`, undefined);
+}
+const SINCE_UNIT_MS = { s: 1000, m: 60 * 1000, h: 60 * 60 * 1000, d: 24 * 60 * 60 * 1000 };
+/** An ISO 8601 date or date-time (with or without an offset). */
+const IsoInstantSchema = z.union([z.iso.datetime({ offset: true, local: true }), z.iso.date()]);
+/** A relative age (`30s`, `15m`, `1h`, `2d`) or an ISO 8601 date/date-time, as the epoch milliseconds it names. */
+const SinceFlagSchema = z.union([
+    z.string().regex(/^\d+[smhd]$/).transform((text) => {
+        const unit = z.enum(['s', 'm', 'h', 'd']).parse(text.slice(-1));
+        return Date.now() - Number(text.slice(0, -1)) * SINCE_UNIT_MS[unit];
+    }),
+    IsoInstantSchema.transform((text) => Date.parse(text)).pipe(z.number().finite())
+]);
+/** A `--since` filter: a relative age or ISO date/date-time, as epoch milliseconds; omitted, no filter. */
+export function parseSinceFlag(flag, raw) {
+    return parseFlag(flag, raw, SinceFlagSchema, 'a relative age (30s, 15m, 1h, 2d) or an ISO 8601 date or date-time', undefined);
+}
+/** A `--since` bound passed on as text: an ISO 8601 date or date-time; omitted, no bound. */
+export function parseIsoInstantFlag(flag, raw) {
+    return parseFlag(flag, raw, IsoInstantSchema, 'an ISO 8601 date or date-time', undefined);
+}
+//# sourceMappingURL=flags.js.map

package/dist/cli/flags.js.map

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

package/dist/cli/log-line.d.ts

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+/** The fields the commands filter and render; every other field passes through. */
+declare const LineEntrySchema: z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    level: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    namespace: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    context: z.ZodOptional<z.ZodNullable<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+}, z.core.$loose>;
+export type LineEntry = z.infer<typeof LineEntrySchema>;
+export type LogLine = {
+    readonly kind: 'entry';
+    readonly entry: LineEntry;
+} | {
+    readonly kind: 'text';
+    readonly cause: unknown;
+};
+export declare function readLogLine(line: string): LogLine;
+export declare const RESET = "\u001B[0m";
+/** The terminal color for a line's level; a level outside the contract renders uncolored. */
+export declare function levelColor(level: string): string;
+export {};
+//# sourceMappingURL=log-line.d.ts.map

package/dist/cli/log-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-line.d.ts","sourceRoot":"","sources":["../../src/cli/log-line.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,mFAAmF;AACnF,QAAA,MAAM,eAAe;;;;;;iBAMnB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,MAAM,MAAM,OAAO,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjD;AASD,eAAO,MAAM,KAAK,cAAY,CAAC;AAE/B,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/dist/cli/log-line.js

@@ -0,0 +1,39 @@
+/**
+ * Output lines as the `vibes logs` commands read them.
+ *
+ * An output line is either a structured entry (a JSON object whose display
+ * fields are strings) or plain text. Reading a line answers which; a text line
+ * carries the parse failure that made it text instead of discarding it.
+ */
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+import { LogLevelSchema } from "../schemas/entry.js";
+import { attempt } from "../core/outcome.js";
+/** The fields the commands filter and render; every other field passes through. */
+const LineEntrySchema = z.looseObject({
+    timestamp: z.string().nullish(),
+    level: z.string().nullish(),
+    namespace: z.string().nullish(),
+    message: z.string().nullish(),
+    context: JsonValueSchema.nullish()
+});
+export function readLogLine(line) {
+    const decoded = attempt(() => JSON.parse(line));
+    if (decoded.failed)
+        return { kind: 'text', cause: decoded.cause };
+    const entry = LineEntrySchema.safeParse(decoded.value);
+    return entry.success ? { kind: 'entry', entry: entry.data } : { kind: 'text', cause: entry.error };
+}
+const LEVEL_COLORS = {
+    debug: '\x1b[90m', // gray
+    info: '\x1b[36m', // cyan
+    warn: '\x1b[33m', // yellow
+    error: '\x1b[31m' // red
+};
+export const RESET = '\x1b[0m';
+/** The terminal color for a line's level; a level outside the contract renders uncolored. */
+export function levelColor(level) {
+    const known = LogLevelSchema.safeParse(level);
+    return known.success ? LEVEL_COLORS[known.data] : '';
+}
+//# sourceMappingURL=log-line.js.map

package/dist/cli/log-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-line.js","sourceRoot":"","sources":["../../src/cli/log-line.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,mFAAmF;AACnF,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC7B,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;CAClC,CAAC,CAAC;AAOH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACpG,CAAC;AAED,MAAM,YAAY,GAAG;IACpB,KAAK,EAAE,UAAU,EAAE,OAAO;IAC1B,IAAI,EAAE,UAAU,EAAE,OAAO;IACzB,IAAI,EAAE,UAAU,EAAE,SAAS;IAC3B,KAAK,EAAE,UAAU,CAAC,MAAM;CACW,CAAC;AAErC,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC;AAE/B,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC"}

package/dist/cli/logging.logs.descriptor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Logs CLI Group Descriptor
+ *
+ * Root group for log management commands.
+ */
+import type { CLIGroupAssetDescriptor } from './types.ts';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=logging.logs.descriptor.d.ts.map

package/dist/cli/logging.logs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.logs.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/logging.logs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logging.logs.descriptor.js

@@ -0,0 +1,16 @@
+/**
+ * Logs CLI Group Descriptor
+ *
+ * Root group for log management commands.
+ */
+const descriptor = {
+    kind: 'cli/group',
+    id: 'logs',
+    name: 'logs',
+    description: 'View and manage application logs',
+    surfaces: ['cli'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=logging.logs.descriptor.js.map

package/dist/cli/logging.logs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.logs.descriptor.js","sourceRoot":"","sources":["../../src/cli/logging.logs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,kCAAkC;IAC/C,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.audit.cleanup.descriptor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logs Audit Cleanup CLI Command Descriptor
+ */
+import type { CLICommandAssetDescriptor } from './types.ts';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=logs.audit.cleanup.descriptor.d.ts.map

package/dist/cli/logs.audit.cleanup.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.audit.cleanup.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/logs.audit.cleanup.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,QAAA,MAAM,UAAU,EAAE,yBAiBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.audit.cleanup.descriptor.js

@@ -0,0 +1,21 @@
+/**
+ * Logs Audit Cleanup CLI Command Descriptor
+ */
+const descriptor = {
+    kind: 'cli/command',
+    id: 'logs.audit.cleanup',
+    name: 'cleanup',
+    description: 'Enforce audit log retention policies for all audit loggers',
+    group: 'logs.audit',
+    options: [
+        {
+            flags: '--id <auditId>',
+            description: 'Only enforce retention for a single audit logger id'
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=logs.audit.cleanup.descriptor.js.map

package/dist/cli/logs.audit.cleanup.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.audit.cleanup.descriptor.js","sourceRoot":"","sources":["../../src/cli/logs.audit.cleanup.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,4DAA4D;IACzE,KAAK,EAAE,YAAY;IAEnB,OAAO,EAAE;QACR;YACC,KAAK,EAAE,gBAAgB;YACvB,WAAW,EAAE,qDAAqD;SAClE;KACD;IAED,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.audit.cleanup.impl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logs Audit Cleanup CLI Command Implementation
+ */
+import type { CommandContext } from './types.ts';
+/** `vibes logs audit cleanup` takes no positional arguments. */
+type AuditCleanupArgs = Readonly<Record<string, never>>;
+interface AuditCleanupOptions {
+    id?: string;
+}
+declare const _default: {
+    execute(_args: AuditCleanupArgs, opts: AuditCleanupOptions, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=logs.audit.cleanup.impl.d.ts.map

package/dist/cli/logs.audit.cleanup.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.audit.cleanup.impl.d.ts","sourceRoot":"","sources":["../../src/cli/logs.audit.cleanup.impl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjD,gEAAgE;AAChE,KAAK,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAExD,UAAU,mBAAmB;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ;;mBAGqB,gBAAgB,QAAQ,mBAAmB,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD1G,wBA2DE"}