@vibesdotdev/logging 0.0.2 → 1.0.0-rc.4

package/dist/config/logging.config.descriptor.js

@@ -0,0 +1,208 @@
+/**
+ * Logging settings — the config manifest the logging owner reads (L1).
+ *
+ * `rotation` declares named rotation policies for files the logging owner
+ * rotates on another owner's behalf. A policy uses the file output's size and
+ * count semantics (`schemas/output-defaults.ts`): `maxSize` is a size string
+ * (`10MB`), `maxFiles` the number of archives kept, and the optional `maxAge`
+ * (`14d`) how long an archived file is kept before its owner removes it. PM's
+ * child-process capture is the first declared entry, replacing PM's own
+ * 10 MB / 3 constants.
+ *
+ * Declared as data with `createRuntimeAsset` so logging takes no package edge
+ * on `@vibesdotdev/config` (config depends on logging). The runtime holds the
+ * descriptor until the `config/manifest` kind registers.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { CredentialReferenceSchema } from '@vibesdotdev/kernel/credentials';
+import { DEFAULT_FILE_OUTPUT_ROTATION } from "../schemas/output-defaults.js";
+/** The conventional credential key for the OTLP exporter headers (`key=value` pairs, comma separated); a host declares it in `otelHeadersCredential`. */
+export const OTEL_HEADERS_CREDENTIAL_KEY = 'OTEL_EXPORTER_OTLP_HEADERS';
+/** A size the logging owner can parse: an integer or decimal and a unit. */
+const SizeStringSchema = z.string().regex(/^\d+(?:\.\d+)?\s*(B|KB|MB|GB)$/i, 'a size such as 10MB');
+/** An age the logging owner can parse: an integer and a unit. */
+const DurationStringSchema = z.string().regex(/^\d+\s*(s|m|h|d|w)$/i, 'a duration such as 14d');
+/** A whole positive number of archives; an empty or non-numeric env value is malformed, never a default. */
+function readArchiveCount(raw, fallback) {
+    return raw === undefined ? fallback : raw.trim() === '' ? Number.NaN : Number(raw);
+}
+export const RotationPolicyConfigSchema = z.object({
+    maxSize: SizeStringSchema,
+    maxFiles: z.number().int().positive(),
+    /** How long an archived file is kept; absent, the policy keeps archives by count only. */
+    maxAge: DurationStringSchema.optional()
+});
+/** The declared policy names and their defaults. */
+export const DECLARED_ROTATION_POLICIES = {
+    /** PM-managed child stdout/stderr and the PM daemon's own stdout/stderr logs. */
+    'pm.process-capture': { maxSize: '10MB', maxFiles: 3, maxAge: '14d' },
+    /** Launched harness stdout/stderr; copy-truncate preserves inherited append handles. */
+    'launch.capture': { maxSize: '10MB', maxFiles: 3 }
+};
+/** Every named rotation policy, declared or stored. */
+const RotationPoliciesSchema = z.record(z.string(), RotationPolicyConfigSchema);
+export const LoggingConfigSchema = z.object({
+    logSelectors: z.string().default(''),
+    logLevel: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+    infoSamplingRate: z.number().min(0).max(1).default(1),
+    fileName: z.string().min(1).default('app.log'),
+    retentionCleanupIntervalMs: z.number().int().positive().default(60 * 60 * 1000),
+    /** File outputs' rotation size where neither the descriptor nor its surface sets one. */
+    fileRotationMaxSize: SizeStringSchema.default(DEFAULT_FILE_OUTPUT_ROTATION.maxSize),
+    /** File outputs' rotation age where neither the descriptor nor its surface sets one. */
+    fileRotationMaxAge: DurationStringSchema.default(DEFAULT_FILE_OUTPUT_ROTATION.maxAge),
+    /** Rotated files a file output keeps where neither the descriptor nor its surface sets a count. */
+    fileRotationMaxFiles: z.number().int().positive().default(DEFAULT_FILE_OUTPUT_ROTATION.maxFiles),
+    rotation: RotationPoliciesSchema
+        .default({ ...DECLARED_ROTATION_POLICIES })
+        .transform((declared) => ({ ...DECLARED_ROTATION_POLICIES, ...declared })),
+    /** HTTP endpoint a remote output without its own `endpoint` posts to. No default: a remote output with neither refuses `remote-endpoint-missing`. */
+    remoteEndpoint: z.url().optional(),
+    otelServiceName: z.string().min(1).default('vibes'),
+    otelServiceVersion: z.string().min(1).default('0.0.1'),
+    otelEndpoint: z.string().min(1).default('http://localhost:4317'),
+    otelLogsEndpoint: z.string().min(1).default('http://localhost:4318/v1/logs'),
+    /**
+     * Composition on-switch. When omitted, telemetry still turns on from
+     * `OTEL_ENABLED=true` or a set `OTEL_EXPORTER_OTLP_ENDPOINT` (previous
+     * host on-switch). `false` is explicit off.
+     */
+    otelEnabled: z.boolean().optional(),
+    /** Previous `NODE_ENV || 'development'` resource attribute. */
+    otelEnvironment: z.string().min(1).default('development'),
+    /** Previous `HOSTNAME || 'localhost'` resource attribute. */
+    otelHostName: z.string().min(1).default('localhost'),
+    /**
+     * Where the OTLP exporter headers live: a credential reference, resolved
+     * only through `runtime.resolveCredential`, never a stored value or an
+     * environment read. Optional: omitted, the exporter sends no headers and
+     * nothing is looked up, so a host with no secrets store still starts
+     * telemetry. The conventional key is `OTEL_HEADERS_CREDENTIAL_KEY`.
+     */
+    otelHeadersCredential: CredentialReferenceSchema.optional(),
+    otelSamplingRate: z.number().min(0).max(1).default(1),
+    otelExportInterval: z.number().int().positive().default(30_000)
+});
+export const LOGGING_CONFIG_MANIFEST_ID = 'logging';
+export const loggingConfigDescriptor = createRuntimeAsset({
+    kind: 'config/manifest',
+    id: LOGGING_CONFIG_MANIFEST_ID,
+    name: 'Logging',
+    namespace: 'logging',
+    description: 'Logging owner settings: named rotation policies and the remote output endpoint',
+    tier: 'user',
+    category: 'runtime',
+    schema: LoggingConfigSchema,
+    fields: {
+        logSelectors: {
+            defaults: { base: '', resolver: ({ runtime }) => runtime.getEnv('VIBES_LOG') ?? runtime.getEnv('vibes_log') ?? '' },
+            ui: { label: 'Namespace selectors', component: 'input', group: 'filtering' }
+        },
+        logLevel: {
+            defaults: { base: 'info', resolver: ({ runtime }) => {
+                    // Returned unvalidated: a level outside the schema's enum refuses at the manifest
+                    // (`logging-config-invalid`) instead of silently becoming `info`.
+                    return (runtime.getEnv('VIBES_LOG_LEVEL') ?? runtime.getEnv('vibes_log_level') ?? runtime.getEnv('LOG_LEVEL') ?? runtime.getEnv('log_level') ?? 'info').toLowerCase();
+                } },
+            ui: { label: 'Minimum log level', component: 'select', group: 'filtering' }
+        },
+        infoSamplingRate: {
+            defaults: { base: 1, resolver: ({ runtime }) => {
+                    const rate = runtime.getEnv('VIBES_LOG_INFO_SAMPLING_RATE');
+                    // An empty value is malformed, not zero: `Number('')` is 0 and would silently drop every info entry.
+                    return rate === undefined ? 1 : rate.trim() === '' ? Number.NaN : Number(rate);
+                } },
+            ui: { label: 'Info sampling rate', component: 'number', group: 'filtering' }
+        },
+        fileName: {
+            defaults: { base: 'app.log', resolver: ({ runtime }) => runtime.getEnv('VIBES_LOG_FILE') ?? 'app.log' },
+            ui: { label: 'File sink name', component: 'input', group: 'outputs' }
+        },
+        retentionCleanupIntervalMs: {
+            defaults: { base: 60 * 60 * 1000, resolver: ({ runtime }) => Number(runtime.getEnv('VIBES_LOG_RETENTION_INTERVAL_MS') ?? String(60 * 60 * 1000)) },
+            ui: { label: 'Retention cleanup interval (ms)', component: 'number', group: 'rotation' }
+        },
+        fileRotationMaxSize: {
+            defaults: { base: DEFAULT_FILE_OUTPUT_ROTATION.maxSize, resolver: ({ runtime }) => runtime.getEnv('VIBES_LOG_MAX_SIZE') ?? DEFAULT_FILE_OUTPUT_ROTATION.maxSize },
+            ui: { label: 'File rotation size', description: 'Rotate a file output at this size (e.g. 25MB) unless it declares its own', component: 'input', group: 'rotation' }
+        },
+        fileRotationMaxAge: {
+            defaults: { base: DEFAULT_FILE_OUTPUT_ROTATION.maxAge, resolver: ({ runtime }) => runtime.getEnv('VIBES_LOG_MAX_AGE') ?? DEFAULT_FILE_OUTPUT_ROTATION.maxAge },
+            ui: { label: 'File rotation age', description: 'Rotate a file output at this age (e.g. 14d) unless it declares its own', component: 'input', group: 'rotation' }
+        },
+        fileRotationMaxFiles: {
+            defaults: { base: DEFAULT_FILE_OUTPUT_ROTATION.maxFiles, resolver: ({ runtime }) => readArchiveCount(runtime.getEnv('VIBES_LOG_MAX_FILES'), DEFAULT_FILE_OUTPUT_ROTATION.maxFiles) },
+            ui: { label: 'Rotated files kept', description: 'Rotated files a file output keeps unless it declares its own count', component: 'number', group: 'rotation' }
+        },
+        rotation: {
+            ui: {
+                label: 'Rotation policies',
+                description: 'Named policies: maxSize (e.g. 10MB), maxFiles (archives kept) and an optional maxAge (e.g. 14d, how long archives are kept)',
+                component: 'json',
+                group: 'rotation'
+            }
+        },
+        remoteEndpoint: {
+            ui: {
+                label: 'Remote log endpoint',
+                description: 'HTTP URL the remote logging output posts batched entries to',
+                component: 'input',
+                group: 'outputs'
+            }
+        },
+        otelServiceName: {
+            ui: { label: 'OTEL service name', component: 'input', group: 'telemetry' }
+        },
+        otelServiceVersion: {
+            ui: { label: 'OTEL service version', component: 'input', group: 'telemetry' }
+        },
+        otelEndpoint: {
+            ui: { label: 'OTLP gRPC endpoint', component: 'input', group: 'telemetry' }
+        },
+        otelLogsEndpoint: {
+            ui: { label: 'OTLP logs HTTP endpoint', component: 'input', group: 'telemetry' }
+        },
+        otelEnabled: {
+            ui: { label: 'Enable OpenTelemetry', component: 'switch', group: 'telemetry' }
+        },
+        otelEnvironment: {
+            ui: { label: 'Deployment environment', component: 'input', group: 'telemetry' }
+        },
+        otelHostName: {
+            ui: { label: 'Host name resource', component: 'input', group: 'telemetry' }
+        },
+        otelHeadersCredential: {
+            ui: {
+                label: 'OTLP headers credential',
+                description: 'The secret holding the exporter headers (key=value pairs, comma separated); omit for no headers',
+                component: 'json',
+                group: 'telemetry'
+            }
+        },
+        otelSamplingRate: {
+            ui: { label: 'Trace sampling rate', component: 'number', group: 'telemetry' }
+        },
+        otelExportInterval: {
+            ui: { label: 'Metric export interval (ms)', component: 'number', group: 'telemetry' }
+        }
+    },
+    groups: [
+        { id: 'filtering', label: 'Filtering' },
+        { id: 'rotation', label: 'Rotation' },
+        { id: 'outputs', label: 'Outputs' },
+        { id: 'telemetry', label: 'Telemetry' }
+    ],
+    allowedAdapters: ['storage.localdb', 'storage.json'],
+    defaultAdapter: 'storage.localdb',
+    scope: 'auto',
+    customTables: false,
+    version: 1,
+    internal: false,
+    context: {
+        surfaces: ['cli', 'tui', 'bridge']
+    },
+    enabled: true
+});
+export default loggingConfigDescriptor;
+//# sourceMappingURL=logging.config.descriptor.js.map

package/dist/config/logging.config.descriptor.js.map

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

package/dist/config/otel-service.d.ts

@@ -0,0 +1,9 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+/**
+ * The OpenTelemetry service name both the `otel` log sink and telemetry
+ * report: `OTEL_SERVICE_NAME`, else `SERVICE_TYPE` mapped to `vibes-web` /
+ * `vibes-workers` / `vibes-mcp` (`worker` too maps to `vibes-workers`), else
+ * `fallback` (the logging manifest's `otelServiceName`).
+ */
+export declare function resolveOtelServiceName(runtime: Pick<RuntimeRef, 'getEnv'>, fallback: string): string;
+//# sourceMappingURL=otel-service.d.ts.map

package/dist/config/otel-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-service.d.ts","sourceRoot":"","sources":["../../src/config/otel-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOpG"}

package/dist/config/otel-service.js

@@ -0,0 +1,18 @@
+/**
+ * The OpenTelemetry service name both the `otel` log sink and telemetry
+ * report: `OTEL_SERVICE_NAME`, else `SERVICE_TYPE` mapped to `vibes-web` /
+ * `vibes-workers` / `vibes-mcp` (`worker` too maps to `vibes-workers`), else
+ * `fallback` (the logging manifest's `otelServiceName`).
+ */
+export function resolveOtelServiceName(runtime, fallback) {
+    const serviceName = runtime.getEnv('OTEL_SERVICE_NAME')?.trim();
+    if (serviceName)
+        return serviceName;
+    const serviceType = runtime.getEnv('SERVICE_TYPE')?.trim().toLowerCase();
+    if (serviceType === 'web' || serviceType === 'workers' || serviceType === 'mcp')
+        return `vibes-${serviceType}`;
+    if (serviceType === 'worker')
+        return 'vibes-workers';
+    return fallback;
+}
+//# sourceMappingURL=otel-service.js.map

package/dist/config/otel-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-service.js","sourceRoot":"","sources":["../../src/config/otel-service.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAmC,EAAE,QAAgB;IAC3F,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC;IAChE,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzE,IAAI,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,SAAS,WAAW,EAAE,CAAC;IAC/G,IAAI,WAAW,KAAK,QAAQ;QAAE,OAAO,eAAe,CAAC;IACrD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/contexts/bootstrap.plugin.d.ts

@@ -0,0 +1,3 @@
+/** Host console preparation only; no settings, descriptors, sinks or outputs are resolved. */
+export declare const loggingBootstrapPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+//# sourceMappingURL=bootstrap.plugin.d.ts.map

package/dist/contexts/bootstrap.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.plugin.d.ts","sourceRoot":"","sources":["../../src/contexts/bootstrap.plugin.ts"],"names":[],"mappings":"AAIA,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,6CAOjC,CAAC"}

package/dist/contexts/bootstrap.plugin.js

@@ -0,0 +1,13 @@
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import { prepareLoggerContext } from "./logger.js";
+import { closeLoggingEmission } from "../core/emission-window.js";
+/** Host console preparation only; no settings, descriptors, sinks or outputs are resolved. */
+export const loggingBootstrapPlugin = createRuntimePlugin({
+    id: 'logging.bootstrap',
+    name: 'Logging Host Preparation',
+    dependencies: ['context'],
+    onRegister: prepareLoggerContext,
+    // A host with only this preparation still closes its loggers when it finalizes.
+    onDispose: closeLoggingEmission
+});
+//# sourceMappingURL=bootstrap.plugin.js.map

package/dist/contexts/bootstrap.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.plugin.js","sourceRoot":"","sources":["../../src/contexts/bootstrap.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;IACzD,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,0BAA0B;IAChC,YAAY,EAAE,CAAC,SAAS,CAAC;IACzB,UAAU,EAAE,oBAAoB;IAChC,gFAAgF;IAChF,SAAS,EAAE,oBAAoB;CAC/B,CAAC,CAAC"}

package/dist/contexts/fallback-logger.d.ts

@@ -1,3 +1,8 @@
-import type { LoggerImplementation } from '../kinds/logger.impl';
-export declare function createFallbackLogger(namespace: string): LoggerImplementation;
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { LoggerImplementation } from '../kinds/logger.impl.ts';
+/** Prepare the existing host console once, then construct synchronous diagnostics: warnings and errors always print. */
+export declare function prepareFallbackLoggerFactory(runtime: RuntimeRef): Promise<(namespace: string) => LoggerImplementation>;
+/** The logger an undeclared id resolves to: the host console, filtered by the Root's level and namespace settings before any context is read. */
+export declare function prepareUndeclaredLoggerFactory(runtime: RuntimeRef): Promise<(namespace: string) => LoggerImplementation>;
+export declare function createFallbackLogger(namespace: string, runtime: RuntimeRef): Promise<LoggerImplementation>;
 //# sourceMappingURL=fallback-logger.d.ts.map

package/dist/contexts/fallback-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallback-logger.d.ts","sourceRoot":"","sources":["../../src/contexts/fallback-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA6EjE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAE5E"}
+{"version":3,"file":"fallback-logger.d.ts","sourceRoot":"","sources":["../../src/contexts/fallback-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAqGpE,wHAAwH;AACxH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,oBAAoB,CAAC,CAG5H;AAED,iJAAiJ;AACjJ,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,oBAAoB,CAAC,CAI9H;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEhH"}

package/dist/contexts/fallback-logger.js

@@ -1,67 +1,94 @@
-function createFallbackLoggerInternal(namespace, baseContext) {
-    const normalizeLogContext = (context) => {
-        if (context === undefined || context === null) {
-            return {};
-        }
-        if (context instanceof Error) {
-            return {
-                errorName: context.name,
-                errorMessage: context.message,
-                stack: context.stack
-            };
-        }
-        if (typeof context === 'object' && !Array.isArray(context)) {
-            return context;
-        }
-        return { value: context };
-    };
-    const emit = (level, message, context) => {
-        if (level === 'debug')
+import { getRuntimeConsole } from '@vibesdotdev/kernel';
+import { PerformanceFailureSchema } from "../core/normalize.js";
+import { derivedLoggerMetadata, JOB_CONTEXT_FIELDS, LogCallSchema, mergeCallContextFields, mergeCallContexts, mergeFailureContexts, prepareEntryContext, OptionalCallContextSchema, readTrackerParams, REQUEST_CONTEXT_FIELDS } from "../core/entry-context.js";
+import { deriveChildConfig } from "../kinds/logger.utils.js";
+import { getNamespaceSettings, shouldLog } from "../core/namespace.js";
+/** Logging's own diagnostics: every warning and error is printed (a failure is never silenced by a level), debug never. */
+const diagnosticsGate = (_namespace, level) => level !== 'debug';
+/** An undeclared logger id: the Root's level and namespace settings (`VIBES_LOG_LEVEL` / `LOG_LEVEL`, `VIBES_LOG`), the same `shouldLog` the declared loggers apply. */
+function rootLevelGate(runtime) {
+    return (namespace, level) => shouldLog({ namespace, level, settings: getNamespaceSettings(runtime) });
+}
+/**
+ * The console method a fallback line prints with. Stdout is reserved (a server host's `console.info` and
+ * `console.debug` write stdout and would corrupt an MCP stream), so `info` and `debug` print on the warning
+ * (stderr) channel; `warn` prints as `warn` and `error` as `error`.
+ */
+function fallbackConsoleMethod(level) {
+    return level === 'error' ? 'error' : 'warn';
+}
+/**
+ * The head of every fallback line, `[namespace] level:`. `info`, `debug` and `warn` share the warning channel,
+ * so the label is the only place a reader learns a line's level.
+ */
+function fallbackLinePrefix(namespace, level) {
+    return `[${namespace}] ${level}:`;
+}
+/** One line on the host console. An unreadable context prints its `loggingError` in the line itself: this logger is the diagnostics path. */
+function fallbackEmitter(namespace, baseContext, hostConsole, gate) {
+    /** `readCall` reads the call's context; a line its gate drops is dropped before it runs, so its context is never walked. */
+    return (level, message, readCall = () => undefined) => {
+        if (!gate(namespace, level))
             return;
-        const prefix = `[${namespace}]`;
-        const merged = { ...baseContext, ...normalizeLogContext(context) };
+        const merged = prepareEntryContext(baseContext, readCall()).context;
         const payloadStr = Object.keys(merged).length > 0 ? ` ${JSON.stringify(merged)}` : '';
-        const line = `${prefix} ${message}${payloadStr}`;
-        console.error(line);
+        const line = `${fallbackLinePrefix(namespace, level)} ${message}${payloadStr}`;
+        hostConsole.callConsole(fallbackConsoleMethod(level), [line]);
     };
+}
+function createFallbackLoggerInternal(namespace, baseContext, hostConsole, gate) {
+    const emit = fallbackEmitter(namespace, baseContext, hostConsole, gate);
+    // A derived context is read without throwing; an unreadable one rides every line as its loggingError.
+    const derive = (merged) => createFallbackLoggerInternal(namespace, derivedLoggerMetadata(merged), hostConsole, gate);
     return {
         namespace,
         fullNamespace: namespace,
-        debug: (msg, ctx) => emit('debug', msg, ctx),
-        info: (msg, ctx) => emit('info', msg, ctx),
-        warn: (msg, ctx) => emit('warn', msg, ctx),
-        error: (msg, ctx) => emit('error', msg, ctx),
+        debug: LogCallSchema.implement((msg, ctx, extra) => emit('debug', msg, () => (extra === undefined ? OptionalCallContextSchema.parse(ctx) : mergeCallContexts({}, ctx, extra)))),
+        info: LogCallSchema.implement((msg, ctx, extra) => emit('info', msg, () => (extra === undefined ? OptionalCallContextSchema.parse(ctx) : mergeCallContexts({}, ctx, extra)))),
+        warn: LogCallSchema.implement((msg, ctx, extra) => emit('warn', msg, () => (extra === undefined ? OptionalCallContextSchema.parse(ctx) : mergeCallContexts({}, ctx, extra)))),
+        error: LogCallSchema.implement((msg, ctx, extra) => emit('error', msg, () => (extra === undefined ? OptionalCallContextSchema.parse(ctx) : mergeCallContexts({}, ctx, extra)))),
+        // The options are read once, without throwing; unreadable ones ride every line as the `loggingError`.
         child: (options) => {
-            const childNs = typeof options === 'string'
-                ? `${namespace}:${options}`
-                : `${namespace}:${options.namespace ?? options.context ?? ''}`;
-            return createFallbackLoggerInternal(childNs, baseContext);
+            const { nextNamespace, childMetadata, failure } = deriveChildConfig(namespace, options);
+            return createFallbackLoggerInternal(nextNamespace, derivedLoggerMetadata({ context: { ...baseContext, ...childMetadata }, failure }), hostConsole, gate);
         },
-        withContext: (ctx) => createFallbackLoggerInternal(namespace, { ...baseContext, ...ctx }),
-        withRequestContext: (ctx) => createFallbackLoggerInternal(namespace, { ...baseContext, ...ctx }),
-        withJobContext: (ctx) => createFallbackLoggerInternal(namespace, { ...baseContext, ...ctx }),
+        withContext: (ctx) => derive(mergeCallContexts(baseContext, ctx)),
+        withRequestContext: (ctx) => derive(mergeCallContextFields(baseContext, ctx, REQUEST_CONTEXT_FIELDS)),
+        withJobContext: (ctx) => derive(mergeCallContextFields(baseContext, ctx, JOB_CONTEXT_FIELDS)),
         performanceTracker: (params) => {
             let startTime = 0;
-            const tracker = createFallbackLoggerInternal(namespace, {
-                ...baseContext,
-                operation: params.operation,
-                ...params.metadata
-            });
+            // The params are read once, without throwing: a non-string operation is labelled `unlabeled`, its failure on every line.
+            const { operation, merged } = readTrackerParams(baseContext, params);
+            const trackerEmit = fallbackEmitter(namespace, derivedLoggerMetadata(merged), hostConsole, gate);
             return {
-                start() { startTime = Date.now(); tracker.debug(`operation.${params.operation}.start`); },
+                start() {
+                    startTime = Date.now();
+                    trackerEmit('debug', `operation.${operation}.start`);
+                },
                 end(successContext) {
                     const duration = Date.now() - startTime;
-                    tracker.info(`operation.${params.operation}.success`, { duration, ...successContext });
+                    trackerEmit('info', `operation.${operation}.success`, () => mergeCallContexts({ duration }, successContext));
                 },
-                fail(error, errorContext) {
+                fail: PerformanceFailureSchema.implement((error, errorContext) => {
                     const duration = Date.now() - startTime;
-                    tracker.error(`operation.${params.operation}.failure`, { duration, error, ...errorContext });
-                }
+                    trackerEmit('error', `operation.${operation}.failure`, () => mergeFailureContexts({ duration }, error, errorContext));
+                })
             };
         }
     };
 }
-export function createFallbackLogger(namespace) {
-    return createFallbackLoggerInternal(namespace, {});
+/** Prepare the existing host console once, then construct synchronous diagnostics: warnings and errors always print. */
+export async function prepareFallbackLoggerFactory(runtime) {
+    const hostConsole = await getRuntimeConsole(runtime);
+    return namespace => createFallbackLoggerInternal(namespace, {}, hostConsole, diagnosticsGate);
+}
+/** The logger an undeclared id resolves to: the host console, filtered by the Root's level and namespace settings before any context is read. */
+export async function prepareUndeclaredLoggerFactory(runtime) {
+    const hostConsole = await getRuntimeConsole(runtime);
+    const gate = rootLevelGate(runtime);
+    return namespace => createFallbackLoggerInternal(namespace, {}, hostConsole, gate);
+}
+export async function createFallbackLogger(namespace, runtime) {
+    return (await prepareFallbackLoggerFactory(runtime))(namespace);
 }
 //# sourceMappingURL=fallback-logger.js.map

package/dist/contexts/fallback-logger.js.map

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

package/dist/contexts/index.d.ts

@@ -3,6 +3,6 @@
  *
  * Context providers for dependency injection.
  */
-export { configureLoggerContext, getLoggerContextConfig, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers, type LoggerContextConfig, type LoggerContextProvider, type RuntimeLogger } from './logger.ts';
-export { type AuditContextConfig, type AuditContextProvider } from './audit.ts';
+export { configureLoggerContext, getLoggerContextConfig, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers, LoggerContextConfigSchema, type LoggerContextConfig, type LoggerContextProvider, type RuntimeLogger } from './logger.ts';
+export { loggingBootstrapPlugin } from './bootstrap.plugin.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/contexts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/contexts/index.js

@@ -3,7 +3,6 @@
  *
  * Context providers for dependency injection.
  */
-export { configureLoggerContext, getLoggerContextConfig, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers } from "./logger.js";
-// Audit context types only — use runtime to resolve audit implementations
-export {} from "./audit.js";
+export { configureLoggerContext, getLoggerContextConfig, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers, LoggerContextConfigSchema } from "./logger.js";
+export { loggingBootstrapPlugin } from "./bootstrap.plugin.js";
 //# sourceMappingURL=index.js.map

package/dist/contexts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAIjB,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,OAAO,EAAsD,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EAIzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/contexts/logger.d.ts

@@ -3,24 +3,48 @@
  *
  * Provides logger instances to runtime assets via context injection.
  * Loggers are resolved from the runtime and cached for sync access.
+ *
+ * `getLogger(id)` expects `id` to match a registered `logging/logger` descriptor
+ * (not a dotted namespace). Use `descriptor.namespace` or `.child()` for namespacing.
  */
-import type { LoggerImplementation } from '../kinds/logger.impl';
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { LoggerImplementation } from '../kinds/logger.impl.ts';
 export type RuntimeLogger = LoggerImplementation;
-export interface LoggerContextConfig {
-    defaultNamespace: string;
-    defaultRuntime: 'server' | 'cli' | 'worker' | 'browser' | 'mcp';
-}
-export declare function configureLoggerContext(config: Partial<LoggerContextConfig>): void;
-export declare function getLoggerContextConfig(): LoggerContextConfig;
-export declare function registerLogger(id: string, logger: LoggerImplementation): void;
-export declare function initializeLoggers(): Promise<void>;
+export declare const LoggerContextConfigSchema: z.ZodObject<{
+    defaultNamespace: z.ZodString;
+    defaultRuntime: z.ZodEnum<{
+        browser: "browser";
+        cli: "cli";
+        worker: "worker";
+        mcp: "mcp";
+        server: "server";
+    }>;
+}, z.core.$strip>;
+export type LoggerContextConfig = z.infer<typeof LoggerContextConfigSchema>;
 export interface LoggerContextProvider {
     getLogger(id: string): LoggerImplementation;
     getDefaultLogger(): LoggerImplementation;
 }
-export declare function createLoggerContextProvider(config?: Partial<LoggerContextConfig>): LoggerContextProvider;
-export declare function getLoggerContext(): LoggerContextProvider;
-export declare function setLoggerContext(provider: LoggerContextProvider): void;
-export declare function getLogger(id: string): LoggerImplementation;
-export declare function getDefaultLogger(): LoggerImplementation;
+/** Configure this Runtime's logger-context defaults; they never reach another Runtime. */
+export declare function configureLoggerContext(config: Partial<LoggerContextConfig>, runtime?: RuntimeRef): void;
+export declare function getLoggerContextConfig(runtime?: RuntimeRef): LoggerContextConfig;
+/** Register `logger` for `id` on this Runtime only; it takes precedence over the Runtime's resolved logger. */
+export declare function registerLogger(id: string, logger: LoggerImplementation, runtime?: RuntimeRef): void;
+/** Prepare only host diagnostics; registration must never read stored settings. */
+export declare function prepareLoggerContext(runtime: RuntimeRef): Promise<void>;
+/** Explicit awaited host preparation; synchronous emits never start host work. */
+export declare function initializeLoggers(runtime: RuntimeRef): Promise<void>;
+/** A provider's lazy loggers bind at emit to the Runtime handed here, else to the default binding. */
+export declare function createLoggerContextProvider(config?: Partial<LoggerContextConfig>, runtime?: RuntimeRef): LoggerContextProvider;
+/** The provider this Runtime serves: the one substituted with `setLoggerContext`, else the one bound to it. */
+export declare function getLoggerContext(runtime?: RuntimeRef): LoggerContextProvider;
+/** Substitute the provider that `getLogger(id, runtime)` and `getDefaultLogger(runtime)` serve for this Runtime only. */
+export declare function setLoggerContext(provider: LoggerContextProvider, runtime?: RuntimeRef): void;
+/**
+ * A logger by id. With a Runtime it is that Runtime's logger through its
+ * provider; without one it is a lazy logger bound at emit to the default binding.
+ */
+export declare function getLogger(id: string, runtime?: RuntimeRef): LoggerImplementation;
+export declare function getDefaultLogger(runtime?: RuntimeRef): LoggerImplementation;
 //# sourceMappingURL=logger.d.ts.map

package/dist/contexts/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/contexts/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;CAChE;AASD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAEjF;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAID,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAE7E;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkCvD;AAED,MAAM,WAAW,qBAAqB;IACrC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC5C,gBAAgB,IAAI,oBAAoB,CAAC;CACzC;AAED,wBAAgB,2BAA2B,CAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACnC,qBAAqB,CAgBvB;AAID,wBAAgB,gBAAgB,IAAI,qBAAqB,CAKxD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAEtE;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,CAE1D;AAED,wBAAgB,gBAAgB,IAAI,oBAAoB,CAEvD"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/contexts/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAkBpE,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD,eAAO,MAAM,yBAAyB;;;;;;;;;iBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAkI5E,MAAM,WAAW,qBAAqB;IACrC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC5C,gBAAgB,IAAI,oBAAoB,CAAC;CACzC;AAoDD,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAGvG;AAED,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,mBAAmB,CAEhF;AAOD,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAEnG;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpE;AAuBD,sGAAsG;AACtG,wBAAgB,2BAA2B,CAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACrC,OAAO,CAAC,EAAE,UAAU,GAClB,qBAAqB,CA8BvB;AAED,+GAA+G;AAC/G,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,qBAAqB,CAU5E;AAED,yHAAyH;AACzH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAE5F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,oBAAoB,CAEhF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,oBAAoB,CAE3E"}