@vibesdotdev/logging 0.0.1 → 1.0.0-rc.4

package/dist/host.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @vibesdotdev/logging/host
+ *
+ * The portable contract host packages implement (C092). It carries the
+ * descriptors, schemas and types a host's file outputs, sinks and audit
+ * loggers need, plus the portable pieces they compose (the JSONL formatter,
+ * audit entry shaping, the fallback logger, the captured logging config and
+ * resource tracking). It holds no host code: no `node:`/`bun:` import and no
+ * `Bun` global. `./host-files` is its base implementation over a host's file
+ * primitives; each runtime-environment host registers it with its own.
+ */
+export { FILE_OUTPUT_ID, type FileOutputDescriptor, type FileOutputImplementation, type AppendedFileRotation, type AppendedFileRotationPolicy } from './kinds/file-output.ts';
+export type { OutputImplementation, OutputBackendFactory, OutputContext, OutputReadOptions, OutputTailOptions, TailHandle, OutputStats } from './kinds/output.types.ts';
+export { DefaultOutputImplementation } from './kinds/output.impl.ts';
+export type { SinkImplementation, SinkContext } from './kinds/sink.ts';
+export type { FormatterImplementation } from './kinds/formatter.ts';
+export { buildAuditEntry, type AuditImplementation, type AuditContext, type AuditLogInput, type AuditQueryOptions } from './kinds/audit.ts';
+export { fileOutputDescriptor } from './outputs/file/file.outputs.descriptor.ts';
+export { fileSinkDescriptor } from './sinks/file/file.sinks.descriptor.ts';
+export { default as stdoutCaptureOutputDescriptor } from './stdout-capture/stdout-capture.output.descriptor.ts';
+export { ALL_AUDIT_DESCRIPTORS } from './audit/audit.descriptor.ts';
+export { auditRetentionJobDescriptor } from './audit/audit-retention.job.descriptor.ts';
+export { AuditRetentionJob } from './audit/audit-retention.job.impl.ts';
+export { OutputDescriptorSchema, type OutputDescriptor, type OutputRotation, type OutputBuffering } from './schemas/output.ts';
+export { resolveOutputRotation, resolveOutputBuffering } from './schemas/output-defaults.ts';
+export { resolveFileOutputRotation } from './config/file-rotation.ts';
+export { SinkDescriptorSchema, type SinkDescriptor } from './schemas/sink.ts';
+export { RuntimeLogEntrySchema, type RuntimeLogEntry, type LogContext } from './schemas/entry.ts';
+export { AuditDescriptorSchema, AuditEntrySchema, auditSeverityMeets, type AuditDescriptor, type AuditEntry, type AuditSeverity } from './schemas/audit.ts';
+export { default as JsonlFormatter } from './formatters/jsonl/jsonl.impl.ts';
+export { default as jsonlFormatterDescriptor } from './formatters/jsonl/jsonl.descriptor.ts';
+export { createFallbackLogger } from './contexts/fallback-logger.ts';
+export { LoggedErrorSchema, type LoggedError } from './core/redact.ts';
+export { trackLoggingResource, untrackLoggingResource } from './core/output-resources.ts';
+export { captureLoggingConfig, getCapturedLoggingConfig } from './config/load-config.ts';
+export { parseSize, parseDuration } from './core/parsing.ts';
+export { attempt, attemptSync, isMissingPath, type Attempt, type Failure } from './core/attempt.ts';
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACN,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACX,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACN,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAChH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/H,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EACN,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/host.js

@@ -0,0 +1,39 @@
+/**
+ * @vibesdotdev/logging/host
+ *
+ * The portable contract host packages implement (C092). It carries the
+ * descriptors, schemas and types a host's file outputs, sinks and audit
+ * loggers need, plus the portable pieces they compose (the JSONL formatter,
+ * audit entry shaping, the fallback logger, the captured logging config and
+ * resource tracking). It holds no host code: no `node:`/`bun:` import and no
+ * `Bun` global. `./host-files` is its base implementation over a host's file
+ * primitives; each runtime-environment host registers it with its own.
+ */
+// Typed file-output contract
+export { FILE_OUTPUT_ID } from "./kinds/file-output.js";
+export { DefaultOutputImplementation } from "./kinds/output.impl.js";
+export { buildAuditEntry } from "./kinds/audit.js";
+// Descriptors
+export { fileOutputDescriptor } from "./outputs/file/file.outputs.descriptor.js";
+export { fileSinkDescriptor } from "./sinks/file/file.sinks.descriptor.js";
+export { default as stdoutCaptureOutputDescriptor } from "./stdout-capture/stdout-capture.output.descriptor.js";
+export { ALL_AUDIT_DESCRIPTORS } from "./audit/audit.descriptor.js";
+export { auditRetentionJobDescriptor } from "./audit/audit-retention.job.descriptor.js";
+export { AuditRetentionJob } from "./audit/audit-retention.job.impl.js";
+// Schemas and rotation defaults
+export { OutputDescriptorSchema } from "./schemas/output.js";
+export { resolveOutputRotation, resolveOutputBuffering } from "./schemas/output-defaults.js";
+export { resolveFileOutputRotation } from "./config/file-rotation.js";
+export { SinkDescriptorSchema } from "./schemas/sink.js";
+export { RuntimeLogEntrySchema } from "./schemas/entry.js";
+export { AuditDescriptorSchema, AuditEntrySchema, auditSeverityMeets } from "./schemas/audit.js";
+// Portable pieces a host composes
+export { default as JsonlFormatter } from "./formatters/jsonl/jsonl.impl.js";
+export { default as jsonlFormatterDescriptor } from "./formatters/jsonl/jsonl.descriptor.js";
+export { createFallbackLogger } from "./contexts/fallback-logger.js";
+export { LoggedErrorSchema } from "./core/redact.js";
+export { trackLoggingResource, untrackLoggingResource } from "./core/output-resources.js";
+export { captureLoggingConfig, getCapturedLoggingConfig } from "./config/load-config.js";
+export { parseSize, parseDuration } from "./core/parsing.js";
+export { attempt, attemptSync, isMissingPath } from "./core/attempt.js";
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,6BAA6B;AAC7B,OAAO,EACN,cAAc,EAKd,MAAM,wBAAwB,CAAC;AAYhC,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE,OAAO,EACN,eAAe,EAKf,MAAM,kBAAkB,CAAC;AAE1B,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAChH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,gCAAgC;AAChC,OAAO,EAAE,sBAAsB,EAAoE,MAAM,qBAAqB,CAAC;AAC/H,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAyC,MAAM,oBAAoB,CAAC;AAClG,OAAO,EACN,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAIlB,MAAM,oBAAoB,CAAC;AAE5B,kCAAkC;AAClC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAA8B,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -22,14 +22,18 @@
  * export default descriptor;
  * ```
  *
- * 2. Get the logger from runtime:
+ * 2. Get the logger by descriptor id (same string as `descriptor.id`):
  * ```ts
- * import { getLogger } from '@vibesdotdev/logging';
+ * import { getLogger, initializeLoggers } from '@vibesdotdev/logging';
  *
- * const logger = getLogger('myapp');
+ * // `runtime` is the runtime your host booted and handed to this code. After its
+ * // plugins register (plugins-core / app bootstrap calls this):
+ * await initializeLoggers(runtime);
+ *
+ * const logger = getLogger('myapp', runtime);
  * logger.info('Application started', { version: '1.0.0' });
  *
- * // Child loggers
+ * // Child loggers — use .child(), not getLogger('myapp:database')
  * const dbLogger = logger.child('database');
  * dbLogger.debug('Connected to database');
  * ```
@@ -44,24 +48,31 @@
  *   action: 'login',
  *   actor: { id: 'user-123', type: 'user' },
  *   outcome: 'success'
- * });
+ * }, runtime);
  * ```
  *
  * @module
  */
-export { default as loggingPlugin } from './logging.plugin';
+export { default as loggingPlugin } from './logging.plugin.ts';
+export { loggingStdoutCapturePlugin } from './stdout-capture.plugin.ts';
+export { REDACTED, FUNCTION_MARKER, SecretValue, isSecretKey, CREDENTIAL_KEY_WORDS, SecretValueSchema, RedactedLogValueSchema, secret, LoggedErrorSchema, type LoggedError } from './core/redact.ts';
+export { RedactedEndpointSchema, UNPARSEABLE_ENDPOINT, UNSCRUBBABLE_FAILURE_MESSAGE, SUBSTRING_FRAGMENT_MIN_LENGTH, CREDENTIAL_QUERY_PARAMETER_NAMES, createEndpointFailureSchema, createEndpointTextSchema, UNSCRUBBABLE_TEXT } from './core/endpoint.ts';
+export { NormalizedLogContextSchema, LogMethodSchema, PerformanceFailureSchema, type LogMethod, type PerformanceFailureMethod } from './core/normalize.ts';
+export { acquireStdoutCapture, StdoutCaptureOptionsSchema, type StdoutCaptureOptions, type StdoutCaptureHandle } from './stdout-capture.ts';
+export { rotateAppendedFile } from './rotation/rotate-appended-file.ts';
+export { readRotationMaxAge, readRotationPolicy } from './rotation/rotation-policy.ts';
 export type { Logger, Runtime, RuntimeLoggerOptions, RuntimeLoggerConfig } from './core/types.ts';
 export type { LoggerChildOptions } from './schemas/index.ts';
-export declare const logger: import("./index.ts").LoggerImplementation;
-export { parseNamespaceSettings, parseNamespaceSettingsFromEnv, shouldLog, updateNamespaceSettings, getNamespaceSettings, defaultNamespaceSettings, type NamespaceSettings, type NamespaceSelector, type NamespaceSelectors } from './core/namespace.ts';
-export { LogLevelSchema, type LogLevel, LOG_LEVEL_ORDER, LogContextSchema, type LogContext, LoggerChildOptionsSchema, RuntimeLogEntrySchema, type RuntimeLogEntry, type RequestLogContext, type JobLogContext, type PerformanceTracker, type PerformanceTrackerParams, SinkDescriptorSchema, type SinkDescriptor, type SinkFormat, type SinkBatching, FormatterDescriptorSchema, type FormatterDescriptor, type FormatterOptions, OutputDescriptorSchema, type OutputDescriptor, type OutputRotation, type OutputBuffering, type OutputStorage, AuditDescriptorSchema, type AuditDescriptor, AuditEntrySchema, type AuditEntry, type AuditCategory, type AuditSeverity, type AuditOutcome, type AuditActor, type AuditTarget, LoggerDescriptorSchema, type LoggerDescriptor, type LoggerRuntime } from './schemas/index.ts';
+export { parseNamespaceSettings, parseNamespaceSettingsFromEnv, shouldLog, updateNamespaceSettings, updateNamespaceSettingsFromRuntime, getNamespaceSettings, defaultNamespaceSettings, type NamespaceSettings, type NamespaceSelector, type NamespaceSelectors } from './core/namespace.ts';
+export { LogLevelSchema, type LogLevel, LOG_LEVEL_ORDER, LogContextSchema, type LogContext, LoggerChildOptionsSchema, RuntimeLogEntrySchema, type RuntimeLogEntry, type RequestLogContext, type JobLogContext, type PerformanceTracker, type PerformanceTrackerParams, SinkDescriptorSchema, type SinkDescriptor, type SinkFormat, type SinkBatching, FormatterDescriptorSchema, type FormatterDescriptor, type FormatterOptions, OutputDescriptorSchema, type OutputDescriptor, type OutputRotation, type OutputBuffering, type OutputStorage, type OutputRetentionBySurface, OutputRetentionBySurfaceSchema, DEFAULT_FILE_OUTPUT_ROTATION, DEFAULT_FILE_OUTPUT_BUFFERING, DEFAULT_ROTATED_FILE_CLEANUP_INTERVAL_MS, DEFAULT_AUDIT_RETENTION_INTERVAL_MS, resolveOutputRotation, resolveOutputBuffering, type ResolveOutputRotationOptions, AuditDescriptorSchema, type AuditDescriptor, AuditEntrySchema, type AuditEntry, type AuditCategory, type AuditSeverity, type AuditOutcome, type AuditActor, type AuditTarget, LoggerDescriptorSchema, type LoggerDescriptor, type LoggerRuntime } from './schemas/index.ts';
 export { sinkKind, type SinkImplementation, type SinkContext } from './kinds/sink.ts';
 export { formatterKind, type FormatterImplementation, type FormatterContext } from './kinds/formatter.ts';
-export { outputKind, type OutputImplementation, type OutputContext, type OutputReadOptions, type OutputTailOptions, type TailHandle, type OutputStats } from './kinds/output.ts';
-export { auditKind, type AuditImplementation, type AuditContext, type AuditLogInput, type AuditQueryOptions } from './kinds/audit.ts';
+export { outputKind, type OutputImplementation, type OutputBackendFactory, type OutputContext, type OutputReadOptions, type OutputTailOptions, type TailHandle, type OutputStats } from './kinds/output.ts';
+export { FILE_OUTPUT_ID, type FileOutputDescriptor, type FileOutputImplementation, type AppendedFileRotation, type AppendedFileRotationPolicy } from './kinds/file-output.ts';
+export { auditKind, type AuditImplementation, type AuditContext, type AuditLogInput, type AuditQueryOptions, auditLog, buildAuditEntry, emitAuditEntry, redactAuditContext } from './kinds/audit.ts';
 export { loggerKind } from './kinds/logger.ts';
-export { type LoggerImplementation, type LoggerContext } from './kinds/logger.impl';
-export { configureLoggerContext, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers, type LoggerContextConfig, type LoggerContextProvider, type RuntimeLogger, type AuditContextConfig, type AuditContextProvider } from './contexts/index.ts';
+export { type LoggerImplementation, type LoggerContext } from './kinds/logger.impl.ts';
+export { configureLoggerContext, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers, LoggerContextConfigSchema, type LoggerContextConfig, type LoggerContextProvider, type RuntimeLogger } from './contexts/index.ts';
 export { type MemorySinkQueryOptions } from './sinks/index.ts';
 export { AuditEntryStorageSchema, type AuditEntryStorage, type AuditRetentionPolicy, DEFAULT_RETENTION_POLICIES, type AuditStorageConfig, defaultAuditStorageConfig } from './audit/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAGH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG5D,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGlG,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAa7D,eAAO,MAAM,MAAM,2CAAqB,CAAC;AAGzC,OAAO,EACN,sBAAsB,EACtB,6BAA6B,EAC7B,SAAS,EACT,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAEN,cAAc,EACd,KAAK,QAAQ,EACb,eAAe,EACf,gBAAgB,EAChB,KAAK,UAAU,EACf,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAE7B,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EAEjB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EAErB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,qBAAqB,EACrB,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAEhB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACN,aAAa,EACb,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,UAAU,EACV,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,SAAS,EACT,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAEN,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAElB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EACN,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,yBAAyB,EACzB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -22,14 +22,18 @@
  * export default descriptor;
  * ```
  *
- * 2. Get the logger from runtime:
+ * 2. Get the logger by descriptor id (same string as `descriptor.id`):
  * ```ts
- * import { getLogger } from '@vibesdotdev/logging';
+ * import { getLogger, initializeLoggers } from '@vibesdotdev/logging';
  *
- * const logger = getLogger('myapp');
+ * // `runtime` is the runtime your host booted and handed to this code. After its
+ * // plugins register (plugins-core / app bootstrap calls this):
+ * await initializeLoggers(runtime);
+ *
+ * const logger = getLogger('myapp', runtime);
  * logger.info('Application started', { version: '1.0.0' });
  *
- * // Child loggers
+ * // Child loggers — use .child(), not getLogger('myapp:database')
  * const dbLogger = logger.child('database');
  * dbLogger.debug('Connected to database');
  * ```
@@ -44,27 +48,26 @@
  *   action: 'login',
  *   actor: { id: 'user-123', type: 'user' },
  *   outcome: 'success'
- * });
+ * }, runtime);
  * ```
  *
  * @module
  */
 // Plugin
-export { default as loggingPlugin } from './logging.plugin.js';
-/**
- * Default logger instance.
- * For most server-side code, use this directly.
- *
- * @example
- * ```ts
- * import { logger } from '@vibesdotdev/logging';
- * logger.info('Server started');
- * ```
- */
-import { getDefaultLogger } from "./contexts/logger.js";
-export const logger = getDefaultLogger();
+export { default as loggingPlugin } from "./logging.plugin.js";
+export { loggingStdoutCapturePlugin } from "./stdout-capture.plugin.js";
+// Redaction and structured errors: every entry context passes through them.
+export { REDACTED, FUNCTION_MARKER, SecretValue, isSecretKey, CREDENTIAL_KEY_WORDS, SecretValueSchema, RedactedLogValueSchema, secret, LoggedErrorSchema } from "./core/redact.js";
+export { RedactedEndpointSchema, UNPARSEABLE_ENDPOINT, UNSCRUBBABLE_FAILURE_MESSAGE, SUBSTRING_FRAGMENT_MIN_LENGTH, CREDENTIAL_QUERY_PARAMETER_NAMES, createEndpointFailureSchema, createEndpointTextSchema, UNSCRUBBABLE_TEXT } from "./core/endpoint.js";
+export { NormalizedLogContextSchema, LogMethodSchema, PerformanceFailureSchema } from "./core/normalize.js";
+// Stdout diagnostic capture resolves through the selected host and sink.
+export { acquireStdoutCapture, StdoutCaptureOptionsSchema } from "./stdout-capture.js";
+// Rotation of files another process appends to: the named policy from the
+// logging config manifest, applied by the selected host's typed file output.
+export { rotateAppendedFile } from "./rotation/rotate-appended-file.js";
+export { readRotationMaxAge, readRotationPolicy } from "./rotation/rotation-policy.js";
 // Namespace utilities
-export { parseNamespaceSettings, parseNamespaceSettingsFromEnv, shouldLog, updateNamespaceSettings, getNamespaceSettings, defaultNamespaceSettings } from "./core/namespace.js";
+export { parseNamespaceSettings, parseNamespaceSettingsFromEnv, shouldLog, updateNamespaceSettings, updateNamespaceSettingsFromRuntime, getNamespaceSettings, defaultNamespaceSettings } from "./core/namespace.js";
 // Schemas
 export { 
 // Entry types
@@ -74,7 +77,7 @@ SinkDescriptorSchema,
 // Formatter schemas
 FormatterDescriptorSchema, 
 // Output schemas
-OutputDescriptorSchema, 
+OutputDescriptorSchema, OutputRetentionBySurfaceSchema, DEFAULT_FILE_OUTPUT_ROTATION, DEFAULT_FILE_OUTPUT_BUFFERING, DEFAULT_ROTATED_FILE_CLEANUP_INTERVAL_MS, DEFAULT_AUDIT_RETENTION_INTERVAL_MS, resolveOutputRotation, resolveOutputBuffering, 
 // Audit schemas
 AuditDescriptorSchema, AuditEntrySchema, 
 // Logger schemas
@@ -83,13 +86,14 @@ LoggerDescriptorSchema } from "./schemas/index.js";
 export { sinkKind } from "./kinds/sink.js";
 export { formatterKind } from "./kinds/formatter.js";
 export { outputKind } from "./kinds/output.js";
-export { auditKind } from "./kinds/audit.js";
+export { FILE_OUTPUT_ID } from "./kinds/file-output.js";
+export { auditKind, auditLog, buildAuditEntry, emitAuditEntry, redactAuditContext } from "./kinds/audit.js";
 export { loggerKind } from "./kinds/logger.js";
-export {} from './kinds/logger.impl.js';
+export {} from "./kinds/logger.impl.js";
 // Context providers
 export { 
 // Logger context
-configureLoggerContext, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers } from "./contexts/index.js";
+configureLoggerContext, createLoggerContextProvider, getLoggerContext, setLoggerContext, getLogger, getDefaultLogger, registerLogger, initializeLoggers, LoggerContextConfigSchema } from "./contexts/index.js";
 // Sinks (types only — implementations autoloaded by runtime)
 export {} from "./sinks/index.js";
 // Audit (storage schemas only — implementations autoloaded by runtime)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQ5D;;;;;;;;;GASG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;AAEzC,sBAAsB;AACtB,OAAO,EACN,sBAAsB,EACtB,6BAA6B,EAC7B,SAAS,EACT,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EAIxB,MAAM,qBAAqB,CAAC;AAE7B,UAAU;AACV,OAAO;AACN,cAAc;AACd,cAAc,EAEd,eAAe,EACf,gBAAgB,EAEhB,wBAAwB,EACxB,qBAAqB;AAMrB,eAAe;AACf,oBAAoB;AAIpB,oBAAoB;AACpB,yBAAyB;AAGzB,iBAAiB;AACjB,sBAAsB;AAKtB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB;AAOhB,iBAAiB;AACjB,sBAAsB,EAGtB,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,OAAO,EAAE,QAAQ,EAA6C,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACN,aAAa,EAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,UAAU,EAOV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,SAAS,EAKT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAiD,MAAM,qBAAqB,CAAC;AAEpF,oBAAoB;AACpB,OAAO;AACN,iBAAiB;AACjB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAOjB,MAAM,qBAAqB,CAAC;AAE7B,6DAA6D;AAC7D,OAAO,EAA+B,MAAM,kBAAkB,CAAC;AAE/D,uEAAuE;AACvE,OAAO,EACN,uBAAuB,EAGvB,0BAA0B,EAE1B,yBAAyB,EACzB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,4EAA4E;AAC5E,OAAO,EACN,QAAQ,EACR,eAAe,EACf,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,MAAM,EACN,iBAAiB,EAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,gCAAgC,EAChC,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,wBAAwB,EAAiD,MAAM,qBAAqB,CAAC;AAE3J,yEAAyE;AACzE,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAuD,MAAM,qBAAqB,CAAC;AAE5I,0EAA0E;AAC1E,6EAA6E;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAQvF,sBAAsB;AACtB,OAAO,EACN,sBAAsB,EACtB,6BAA6B,EAC7B,SAAS,EACT,uBAAuB,EACvB,kCAAkC,EAClC,oBAAoB,EACpB,wBAAwB,EAIxB,MAAM,qBAAqB,CAAC;AAE7B,UAAU;AACV,OAAO;AACN,cAAc;AACd,cAAc,EAEd,eAAe,EACf,gBAAgB,EAEhB,wBAAwB,EACxB,qBAAqB;AAMrB,eAAe;AACf,oBAAoB;AAIpB,oBAAoB;AACpB,yBAAyB;AAGzB,iBAAiB;AACjB,sBAAsB,EAMtB,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,EAC7B,wCAAwC,EACxC,mCAAmC,EACnC,qBAAqB,EACrB,sBAAsB;AAEtB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB;AAOhB,iBAAiB;AACjB,sBAAsB,EAGtB,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,OAAO,EAAE,QAAQ,EAA6C,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACN,aAAa,EAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,UAAU,EAQV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,cAAc,EAKd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,SAAS,EAKT,QAAQ,EACR,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAiD,MAAM,wBAAwB,CAAC;AAEvF,oBAAoB;AACpB,OAAO;AACN,iBAAiB;AACjB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EAIzB,MAAM,qBAAqB,CAAC;AAE7B,6DAA6D;AAC7D,OAAO,EAA+B,MAAM,kBAAkB,CAAC;AAE/D,uEAAuE;AACvE,OAAO,EACN,uBAAuB,EAGvB,0BAA0B,EAE1B,yBAAyB,EACzB,MAAM,kBAAkB,CAAC"}

package/dist/kinds/audit.d.ts

@@ -3,7 +3,9 @@
  *
  * Audit loggers capture compliance and security events.
  */
-import type { RuntimeKindDescriptor, KindContext } from '@vibesdotdev/runtime/schemas/kind';
+import type { RuntimeKindDescriptor, KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { LogContext } from '../schemas/entry.ts';
 import { type AuditDescriptor, type AuditEntry, type AuditCategory, type AuditSeverity, type AuditOutcome, type AuditActor, type AuditTarget } from '../schemas/audit.ts';
 /**
  * Input for logging an audit event.
@@ -22,7 +24,7 @@ export interface AuditLogInput {
     /** Event outcome */
     outcome: AuditOutcome;
     /** Additional context */
-    context?: Record<string, unknown>;
+    context?: LogContext;
     /** Error details */
     error?: string;
 }
@@ -60,22 +62,52 @@ export interface AuditImplementation {
     log(input: AuditLogInput): Promise<AuditEntry>;
     /** Query audit entries (if supported) */
     query?(options: AuditQueryOptions): Promise<AuditEntry[]>;
+    /** Enforce category retention policy (file-backed implementations) */
+    enforceRetention?(): Promise<{
+        deleted: number;
+        archived: number;
+        retentionDays: number;
+    }>;
 }
 /**
  * Context provided to audit implementations.
  */
 export interface AuditContext extends KindContext {
-    /** Runtime reference */
-    readonly runtime: unknown;
-    /** Workspace path for storage */
-    readonly workspacePath?: string;
+    /**
+     * An explicitly requested workspace context. Portable implementations need
+     * no workspace; relative file destinations require the descriptor-injected
+     * root and refuse when it was not supplied.
+     */
+    readonly 'runtime/workspace-path'?: string;
 }
+/** Apply the logging owner's recursive key and value redaction to audit context. */
+export declare function redactAuditContext(context: LogContext | undefined): LogContext | undefined;
+/**
+ * Build a fully-formed, redacted audit entry from an input.
+ *
+ * Single source of truth for entry shaping (id/timestamp generation + context
+ * redaction). Surfaces that need the entry value (e.g. to forward it onward)
+ * call this; surfaces that only emit use {@link auditLog}. The input is read
+ * once, through guards, and refuses typed and value-free (see `buildRedactedAuditEntry`).
+ */
+export declare function buildAuditEntry(input: AuditLogInput): AuditEntry;
+/**
+ * Write an audit entry through the handed host's stderr provider. The entry is
+ * read once and shaped exactly as `buildAuditEntry` shapes an input (its
+ * context through the emitted-context redaction, every other field through the
+ * redaction walk) before it is validated, so a caller-built entry cannot bypass
+ * redaction, and a value that cannot be read refuses with a typed, value-free
+ * `ZodError`, never with what the value threw.
+ */
+export declare function emitAuditEntry(entry: AuditEntry, runtime: RuntimeRef): Promise<void>;
+/** Build a redacted entry and await its emission through the handed Runtime. */
+export declare function auditLog(input: AuditLogInput, runtime: RuntimeRef): Promise<void>;
 /**
  * Audit kind definition for runtime registration.
  */
 export declare const auditKind: RuntimeKindDescriptor<AuditDescriptor, AuditImplementation, AuditContext>;
-declare module '@vibesdotdev/runtime/schemas/kind-types' {
-    interface KindTypeMap {
+declare global {
+    interface VibesKindTypeMap {
         'logging/audit': {
             descriptor: AuditDescriptor;
             impl: AuditImplementation;

package/dist/kinds/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/kinds/audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAqB,MAAM,mCAAmC,CAAC;AAE/G,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oBAAoB;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,yBAAyB;IACzB,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,yCAAyC;IACzC,KAAK,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAChD,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CAChC;AAkED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,qBAAqB,CAAC,eAAe,EAAE,mBAAmB,EAAE,YAAY,CAO9F,CAAC;AAEH,OAAO,QAAQ,yCAAyC,CAAC;IACxD,UAAU,WAAW;QACpB,eAAe,EAAE;YAAE,UAAU,EAAE,eAAe,CAAC;YAAC,IAAI,EAAE,mBAAmB,CAAA;SAAE,CAAC;KAC5E;CACD"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/kinds/audit.ts"],"names":[],"mappings":"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"}

package/dist/kinds/audit.js

@@ -3,46 +3,107 @@
  *
  * Audit loggers capture compliance and security events.
  */
-import { AuditDescriptorSchema } from "../schemas/audit.js";
+import { CapabilityError, getRuntimeStdio } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { NormalizedLogContextSchema, EmittedLogContextSchema } from "../core/normalize.js";
+import { createFieldsReadSchema, RedactedLogValueSchema } from "../core/redact.js";
+import { AuditDescriptorSchema, AuditEntrySchema, auditSeverityMeets } from "../schemas/audit.js";
 /**
  * Default audit implementation - logs to stderr.
  * Used when no specific implementation is registered.
  */
 class DefaultAuditImplementation {
+    runtime;
     id;
     descriptor;
-    constructor(descriptor, _context) {
+    constructor(descriptor, context) {
+        this.runtime = context.runtime;
         this.id = descriptor.id;
-        this.descriptor = descriptor;
+        this.descriptor = AuditDescriptorSchema.parse(descriptor);
     }
     async log(input) {
-        const entry = {
-            id: crypto.randomUUID(),
-            timestamp: new Date().toISOString(),
-            category: input.category,
-            severity: input.severity,
-            action: input.action,
-            actor: input.actor,
-            target: input.target,
-            outcome: input.outcome,
-            context: input.context,
-            error: input.error
-        };
-        // Default: log to stderr to avoid stdout pollution (critical for MCP stdio)
-        console.error(`[AUDIT] ${JSON.stringify(entry)}`);
+        const entry = buildAuditEntry(input);
+        // Below the descriptor's minimum severity the entry is shaped and returned, never written.
+        if (auditSeverityMeets(entry.severity, this.descriptor.severity))
+            await emitAuditEntry(entry, this.runtime);
         return entry;
     }
 }
+/** Apply the logging owner's recursive key and value redaction to audit context. */
+export function redactAuditContext(context) {
+    return context === undefined ? undefined : NormalizedLogContextSchema.parse(context);
+}
+/** The fields an audit input carries; an entry adds its `id` and `timestamp`. */
+const AUDIT_INPUT_FIELDS = ['category', 'severity', 'action', 'actor', 'target', 'outcome', 'context', 'error'];
+const AuditInputFieldsSchema = createFieldsReadSchema(AUDIT_INPUT_FIELDS);
+const AuditEntryFieldsSchema = createFieldsReadSchema(['id', 'timestamp', ...AUDIT_INPUT_FIELDS]);
+/**
+ * The one shaping of a caller's audit value. Each top-level field is read once
+ * inside the guard; the entry's `context` passes through the emitted-context
+ * redaction (an Error as the context is described, a hostile nested value
+ * described in place); every other field is snapshotted through the redaction
+ * walk (each nested field read once, secret keys and `secret()` values
+ * replaced); and only then is the entry validated. A value that cannot be read
+ * (a getter, a Proxy trap, a revoked Proxy, the whole input or any field) or
+ * that is not the declared shape refuses with a typed, value-free `ZodError`:
+ * never with what the value threw, and nothing is written.
+ */
+function buildRedactedAuditEntry(fields, stamp) {
+    const { context, ...rest } = fields;
+    const snapshot = RedactedLogValueSchema.parse({ ...rest, ...stamp });
+    const redactedContext = context === undefined ? undefined : EmittedLogContextSchema.parse(context);
+    const entry = AuditEntrySchema.parse({ ...AuditSnapshotSchema.parse(snapshot), context: redactedContext });
+    // The entry keeps the context snapshot itself: the record schema's copy would drop an own `__proto__` field.
+    if (redactedContext !== undefined)
+        entry.context = redactedContext;
+    return entry;
+}
+/** The walked snapshot of an audit value's non-context fields: a plain record (the walk of a plain record). */
+const AuditSnapshotSchema = z.record(z.string(), z.unknown());
+/**
+ * Build a fully-formed, redacted audit entry from an input.
+ *
+ * Single source of truth for entry shaping (id/timestamp generation + context
+ * redaction). Surfaces that need the entry value (e.g. to forward it onward)
+ * call this; surfaces that only emit use {@link auditLog}. The input is read
+ * once, through guards, and refuses typed and value-free (see `buildRedactedAuditEntry`).
+ */
+export function buildAuditEntry(input) {
+    return buildRedactedAuditEntry(AuditInputFieldsSchema.parse(input), { id: crypto.randomUUID(), timestamp: new Date().toISOString() });
+}
+/**
+ * Write an audit entry through the handed host's stderr provider. The entry is
+ * read once and shaped exactly as `buildAuditEntry` shapes an input (its
+ * context through the emitted-context redaction, every other field through the
+ * redaction walk) before it is validated, so a caller-built entry cannot bypass
+ * redaction, and a value that cannot be read refuses with a typed, value-free
+ * `ZodError`, never with what the value threw.
+ */
+export async function emitAuditEntry(entry, runtime) {
+    if (!runtime)
+        throw new CapabilityError('Audit emission requires a handed Runtime.', 'INVALID_INPUT', {
+            reason: 'audit-runtime-missing', retryable: false
+        });
+    const { id, timestamp, ...fields } = AuditEntryFieldsSchema.parse(entry);
+    const redacted = buildRedactedAuditEntry(fields, { id, timestamp });
+    const stdio = await getRuntimeStdio(runtime);
+    stdio.write('stderr', '[AUDIT] ' + JSON.stringify(redacted) + '\n');
+}
+/** Build a redacted entry and await its emission through the handed Runtime. */
+export async function auditLog(input, runtime) {
+    await emitAuditEntry(buildAuditEntry(input), runtime);
+}
 /**
  * Audit kind resolution logic.
  * Selects audit logger based on category and hardware.
  */
 function resolveAudit(candidates, scope, _context) {
+    if (!candidates.every((candidate) => AuditDescriptorSchema.safeParse(candidate).success)) {
+        throw new CapabilityError('Logging kind received an invalid registered descriptor.', 'INVALID_INPUT', { reason: 'logging-descriptor-invalid' });
+    }
     const typed = candidates;
     if (typed.length === 0)
         return undefined;
-    if (typed.length === 1)
-        return typed[0];
     const hardware = scope.hardware;
     // Filter by hardware compatibility
     const matching = typed.filter((d) => {
@@ -66,6 +127,7 @@ export const auditKind = {
     descriptorSchema: AuditDescriptorSchema,
     defaultImplementation: DefaultAuditImplementation,
     resolve: resolveAudit,
-    contexts: ['runtime/workspace-path']
+    isEligible: (descriptor, _requestedScope, executionScope) => !descriptor.hardware?.length || descriptor.hardware.includes(executionScope.hardware),
+    contexts: []
 };
 //# sourceMappingURL=audit.js.map

package/dist/kinds/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/kinds/audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACN,qBAAqB,EAQrB,MAAM,qBAAqB,CAAC;AAuE7B;;;GAGG;AACH,MAAM,0BAA0B;IACtB,EAAE,CAAS;IACX,UAAU,CAAkB;IAErC,YAAY,UAA6B,EAAE,QAAsB;QAChE,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAA6B,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAoB;QAC7B,MAAM,KAAK,GAAe;YACzB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC;QAEF,4EAA4E;QAC5E,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAElD,OAAO,KAAK,CAAC;IACd,CAAC;CACD;AAED;;;GAGG;AACH,SAAS,YAAY,CACpB,UAA+B,EAC/B,KAAmB,EACnB,QAAqB;IAErB,MAAM,KAAK,GAAG,UAA+B,CAAC;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAExC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAEhC,mCAAmC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACnC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACxD,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GACrB;IACC,EAAE,EAAE,eAAe;IACnB,gBAAgB,EAAE,qBAAqB;IACvC,qBAAqB,EAAE,0BAA0B;IACjD,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,CAAC,wBAAwB,CAAC;CACpC,CAAC"}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/kinds/audit.ts"],"names":[],"mappings":"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"}

package/dist/kinds/contexts.d.ts

@@ -4,18 +4,19 @@
  * Shared context interfaces to avoid circular dependencies.
  * This file contains only type definitions - no implementations.
  */
-import type { KindContext } from '@vibesdotdev/runtime/schemas/kind';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
 import type { SinkImplementation } from './sink.ts';
 import type { OutputImplementation } from './output.ts';
 /**
  * Context provided to logger implementations.
  */
 export interface LoggerContext extends KindContext {
-    /** Runtime reference */
-    readonly runtime: unknown;
     /** Available sinks for this logger */
     readonly sinks?: Map<string, SinkImplementation> | SinkImplementation[];
     /** Available outputs for this logger */
     readonly outputs?: Map<string, OutputImplementation> | OutputImplementation[];
+    /** Explicit Runtime context requests use the same owning port types. */
+    readonly 'logging/sinks'?: Map<string, SinkImplementation> | SinkImplementation[];
+    readonly 'logging/outputs'?: Map<string, OutputImplementation> | OutputImplementation[];
 }
 //# sourceMappingURL=contexts.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../src/kinds/contexts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,kBAAkB,EAAE,CAAC;IACxE,wCAAwC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,oBAAoB,EAAE,CAAC;CAC9E"}
+{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../src/kinds/contexts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,kBAAkB,EAAE,CAAC;IACxE,wCAAwC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,oBAAoB,EAAE,CAAC;IAC9E,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,kBAAkB,EAAE,CAAC;IAClF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,oBAAoB,EAAE,CAAC;CACxF"}

package/dist/kinds/file-output.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The typed file-output contract (C092).
+ *
+ * The `logging/output` descriptor with id `file` is the file-storage backend a
+ * host package implements (`@vibesdotdev/host-node/logging`).
+ * Callers resolve it by id with these generics and call its required methods:
+ * no `instanceof`, no optional-method presence checks.
+ */
+import type { OutputDescriptor } from '../schemas/output.ts';
+import type { OutputContext, OutputImplementation } from './output.types.ts';
+/** The `logging/output` id of the file-storage backend. */
+export declare const FILE_OUTPUT_ID = "file";
+/** A file-storage output descriptor: the `file` backend or a named stream it creates. */
+export type FileOutputDescriptor = OutputDescriptor & {
+    readonly storage: 'file';
+};
+export interface AppendedFileRotationPolicy {
+    /** Rotate once the active file reaches this many bytes. */
+    maxSizeBytes: number;
+    /** Archives kept: `<path>.1` … `<path>.<maxFiles>`. */
+    maxFiles: number;
+}
+export interface AppendedFileRotation {
+    rotated: boolean;
+    /** Size of the active file when rotation copied it. */
+    previousSize?: number;
+}
+/** What a host's file output provides. Every member is required. */
+export interface FileOutputImplementation extends OutputImplementation {
+    /**
+     * Create a separately configured file stream with the same contract, on
+     * the stream context of the Runtime that selected this backend.
+     */
+    create(descriptor: OutputDescriptor, namedContext: OutputContext): Promise<FileOutputImplementation>;
+    /** Write a raw line, in write order. */
+    writeLine(line: string): Promise<void>;
+    /**
+     * Admit a line now and write it once it is classified: `null` writes
+     * nothing. Disposal joins every admitted line.
+     */
+    writeReservedLine(line: Promise<string | null>): Promise<void>;
+    /** Close the active file, archive it and bound the archives; `archived` is `null` when there was no active file. */
+    rotate(): Promise<{
+        archived: string | null;
+    }>;
+    /** Enforce rotation retention without rotating the active file. */
+    enforceRetention(): Promise<{
+        removed: number;
+    }>;
+    /**
+     * Copy-truncate rotation for a file another process appends to through an
+     * inherited `O_APPEND` descriptor.
+     */
+    rotateAppendedFile(path: string, policy: AppendedFileRotationPolicy): Promise<AppendedFileRotation>;
+}
+//# sourceMappingURL=file-output.d.ts.map

package/dist/kinds/file-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-output.d.ts","sourceRoot":"","sources":["../../src/kinds/file-output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,2DAA2D;AAC3D,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,yFAAyF;AACzF,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,0BAA0B;IAC1C,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oEAAoE;AACpE,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACrE;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrG,wCAAwC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,oHAAoH;IACpH,MAAM,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC/C,mEAAmE;IACnE,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpG"}