@vibesdotdev/logging 0.0.1

package/dist/core/namespace.js

@@ -0,0 +1,136 @@
+/**
+ * Namespace Filtering
+ *
+ * Controls which log entries are emitted based on namespace patterns.
+ */
+import { LOG_LEVEL_ORDER } from "../schemas/entry.js";
+const DEFAULT_LEVEL = 'info';
+const REGEX_SPECIAL_CHARS = /[\\^$+?.()|[\]{}]/g;
+/**
+ * Compile a glob pattern to regex.
+ */
+function compilePattern(pattern) {
+    const escaped = pattern.replace(REGEX_SPECIAL_CHARS, '\\$&').replace(/\*/g, '.*');
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Parse a selector string into includes/excludes.
+ * Format: "namespace1,namespace2,-excluded1,-excluded2"
+ */
+function parseSelectors(raw) {
+    const selectors = { includes: [], excludes: [] };
+    for (const token of raw.split(',').map((value) => value.trim())) {
+        if (!token)
+            continue;
+        const isExclusion = token.startsWith('-');
+        const normalized = isExclusion ? token.slice(1) : token;
+        if (!normalized)
+            continue;
+        const selector = {
+            raw: normalized,
+            regex: compilePattern(normalized),
+            isExclusion
+        };
+        if (isExclusion) {
+            selectors.excludes.push(selector);
+        }
+        else {
+            selectors.includes.push(selector);
+        }
+    }
+    return selectors;
+}
+/**
+ * Normalize a level string to LogLevel.
+ */
+function normalizeLevel(level) {
+    switch ((level || '').toLowerCase()) {
+        case 'debug':
+            return 'debug';
+        case 'warn':
+            return 'warn';
+        case 'error':
+            return 'error';
+        default:
+            return 'info';
+    }
+}
+/**
+ * Parse namespace settings from input string.
+ */
+export function parseNamespaceSettings({ input, defaultLevel }) {
+    const selectors = input ? parseSelectors(input) : { includes: [], excludes: [] };
+    return {
+        ...selectors,
+        defaultLevel: normalizeLevel(defaultLevel)
+    };
+}
+/**
+ * Parse namespace settings from environment variables.
+ */
+export function parseNamespaceSettingsFromEnv(env) {
+    const logSelectors = env.VIBES_LOG ?? env.vibes_log ?? undefined;
+    const level = env.VIBES_LOG_LEVEL ?? env.vibes_log_level ?? env.LOG_LEVEL ?? env.log_level ?? undefined;
+    return parseNamespaceSettings({
+        input: logSelectors,
+        defaultLevel: level
+    });
+}
+/**
+ * Check if a namespace matches a selector.
+ */
+export function matchesSelector(namespace, selector) {
+    return selector.regex.test(namespace);
+}
+/**
+ * Check if a namespace is included by settings.
+ */
+export function isNamespaceIncluded(namespace, settings) {
+    const included = settings.includes.length === 0 ||
+        settings.includes.some((selector) => matchesSelector(namespace, selector));
+    if (!included)
+        return false;
+    return !settings.excludes.some((selector) => matchesSelector(namespace, selector));
+}
+/**
+ * Determine if a log entry should be emitted.
+ */
+export function shouldLog({ namespace, level, settings }) {
+    const defaultLevel = settings.defaultLevel ?? DEFAULT_LEVEL;
+    const levelIndex = LOG_LEVEL_ORDER[level];
+    const baselineIndex = LOG_LEVEL_ORDER[defaultLevel] ?? LOG_LEVEL_ORDER[DEFAULT_LEVEL];
+    if (levelIndex >= baselineIndex) {
+        return !settings.excludes.some((selector) => matchesSelector(namespace, selector));
+    }
+    return settings.includes.some((selector) => matchesSelector(namespace, selector));
+}
+/**
+ * Default namespace settings.
+ */
+export const defaultNamespaceSettings = {
+    includes: [],
+    excludes: [],
+    defaultLevel: DEFAULT_LEVEL
+};
+/**
+ * Global active namespace settings.
+ * Updated from environment or explicit configuration.
+ *
+ * Initialization is lazy: defaults are used until explicitly configured
+ * via updateNamespaceSettings(). The logging-fs plugin initializes
+ * settings from the host environment at startup automatically.
+ */
+let activeNamespaceSettings = defaultNamespaceSettings;
+/**
+ * Update the active namespace settings.
+ */
+export function updateNamespaceSettings(settings) {
+    activeNamespaceSettings = settings;
+}
+/**
+ * Get the current active namespace settings.
+ */
+export function getNamespaceSettings() {
+    return activeNamespaceSettings;
+}
+//# sourceMappingURL=namespace.js.map

package/dist/core/namespace.js.map

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

package/dist/core/parsing.d.ts

@@ -0,0 +1,3 @@
+export declare function parseSize(size: string | undefined): number;
+export declare function parseDuration(duration: string | undefined): number;
+//# sourceMappingURL=parsing.d.ts.map

package/dist/core/parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../../src/core/parsing.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM1D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYlE"}

package/dist/core/parsing.js

@@ -0,0 +1,25 @@
+export function parseSize(size) {
+    if (!size)
+        return 10 * 1024 * 1024;
+    const units = { B: 1, KB: 1024, MB: 1024 ** 2, GB: 1024 ** 3 };
+    const match = size.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)$/i);
+    if (!match)
+        return 10 * 1024 * 1024;
+    return Math.floor(parseFloat(match[1]) * (units[match[2].toUpperCase()] ?? 1));
+}
+export function parseDuration(duration) {
+    if (!duration)
+        return 7 * 24 * 60 * 60 * 1000;
+    const units = {
+        s: 1000,
+        m: 60 * 1000,
+        h: 60 * 60 * 1000,
+        d: 24 * 60 * 60 * 1000,
+        w: 7 * 24 * 60 * 60 * 1000
+    };
+    const match = duration.match(/^(\d+)\s*(s|m|h|d|w)$/i);
+    if (!match)
+        return 7 * 24 * 60 * 60 * 1000;
+    return parseInt(match[1], 10) * (units[match[2].toLowerCase()] ?? 1);
+}
+//# sourceMappingURL=parsing.js.map

package/dist/core/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../src/core/parsing.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAwB;IACjD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IACnC,MAAM,KAAK,GAA2B,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;IACvF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAA4B;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC9C,MAAM,KAAK,GAA2B;QACrC,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,EAAE,GAAG,IAAI;QACZ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QACtB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;KAC1B,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Core Logger Types
+ *
+ * Interfaces for logger instances and factories.
+ */
+import type { LogLevel, LogContext, LoggerChildOptions, RequestLogContext, JobLogContext, PerformanceTracker, PerformanceTrackerParams } from '../schemas/entry.ts';
+import type { SinkImplementation } from '../kinds/sink.ts';
+/**
+ * Base logger interface.
+ */
+export interface Logger {
+    debug(message: string, context?: unknown): void;
+    info(message: string, context?: unknown): void;
+    warn(message: string, context?: unknown): void;
+    error(message: string, context?: unknown): void;
+    child?(options: LoggerChildOptions): Logger;
+    namespace?: string;
+}
+/**
+ * Extended runtime logger with context helpers.
+ */
+export interface RuntimeLogger extends Logger {
+    /** Create a child logger with additional context */
+    child(options: LoggerChildOptions): RuntimeLogger;
+    /** Add arbitrary context to this logger */
+    withContext(context: LogContext): RuntimeLogger;
+    /** Add request-specific context */
+    withRequestContext(context: RequestLogContext): RuntimeLogger;
+    /** Add job-specific context */
+    withJobContext(context: JobLogContext): RuntimeLogger;
+    /** Create a performance tracker for timing operations */
+    performanceTracker(params: PerformanceTrackerParams): PerformanceTracker;
+    /** Logger namespace */
+    namespace: string;
+    /** Full namespace path (including parent namespaces) */
+    fullNamespace: string;
+}
+/**
+ * Runtime type identifier.
+ */
+export type Runtime = 'server' | 'cli' | 'worker' | 'browser' | 'mcp';
+/**
+ * Options for creating a runtime logger.
+ */
+export interface RuntimeLoggerOptions {
+    /** Base namespace (e.g., 'vibes', 'pm') */
+    namespace: string;
+    /** Runtime environment */
+    runtime?: Runtime;
+    /** Override default log level */
+    level?: LogLevel;
+    /** Static metadata added to all entries */
+    staticMetadata?: LogContext;
+    /** Custom sink IDs for runtime resolution */
+    sinks?: string[];
+    /** Direct sink implementations (bypasses runtime resolution) */
+    sinkImpls?: SinkImplementation[];
+}
+/**
+ * Internal logger configuration.
+ */
+export interface RuntimeLoggerConfig {
+    namespace: string;
+    fullNamespace: string;
+    runtime: Runtime;
+    staticMetadata: LogContext;
+    sinkIds: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,MAAM;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,MAAM;IAC5C,oDAAoD;IACpD,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAAC;IAClD,2CAA2C;IAC3C,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAAC;IAChD,mCAAmC;IACnC,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAC9D,+BAA+B;IAC/B,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAAC;IACtD,yDAAyD;IACzD,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAAC;IACzE,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,UAAU,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/core/types.js

@@ -0,0 +1,7 @@
+/**
+ * Core Logger Types
+ *
+ * Interfaces for logger instances and factories.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/docs/levels.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=levels.docs.descriptor.d.ts.map

package/dist/docs/levels.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/levels.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBAmVjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/levels.docs.descriptor.js

@@ -0,0 +1,342 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'logging.levels',
+    title: 'Log Levels',
+    summary: 'Log levels (debug, info, warn, error) and filtering',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: Log Levels
+summary: Log levels (debug, info, warn, error) and filtering
+tags: [logging, levels, debug, info, warn, error, filtering]
+parent: logging
+order: 1
+surfaces: [cli, web, in-app]
+hardware: [consumer, cloud]
+---
+
+# Log Levels
+
+Log levels categorize log entries by severity. The logging system provides five standard levels with automatic filtering based on configuration.
+
+## Level Hierarchy
+
+\`\`\`
+trace < debug < info < warn < error
+\`\`\`
+
+Each level includes all levels above it. Setting level to \`warn\` logs \`warn\` and \`error\` only.
+
+## Level Definitions
+
+### Trace (0)
+
+Fine-grained debugging information:
+
+\`\`\`ts
+logger.trace('Entering function', { fn: 'processUser', userId: '123' });
+\`\`\`
+
+**Use for:**
+- Function entry/exit
+- Variable values during debugging
+- Detailed execution flow
+
+**Typical output:**
+\`\`\`
+[TRACE] [app:user] Entering function {"fn":"processUser","userId":"123"}
+\`\`\`
+
+### Debug (1)
+
+Debugging information for development:
+
+\`\`\`ts
+logger.debug('Database query executed', {
+  query: 'SELECT * FROM users',
+  duration: 45
+});
+\`\`\`
+
+**Use for:**
+- SQL queries
+- API requests
+- Configuration values
+- Performance metrics
+
+**Typical output:**
+\`\`\`
+[DEBUG] [app:db] Database query executed {"query":"SELECT * FROM users","duration":45}
+\`\`\`
+
+### Info (2)
+
+General informational messages:
+
+\`\`\`ts
+logger.info('Server started', {
+  port: 3000,
+  environment: 'development'
+});
+\`\`\`
+
+**Use for:**
+- Application lifecycle events
+- User actions (login, logout)
+- System state changes
+- Successful operations
+
+**Typical output:**
+\`\`\`
+[INFO] [app:server] Server started {"port":3000,"environment":"development"}
+\`\`\`
+
+### Warn (3)
+
+Warning conditions:
+
+\`\`\`ts
+logger.warn('High memory usage detected', {
+  usage: '85%',
+  threshold: '80%'
+});
+\`\`\`
+
+**Use for:**
+- Resource warnings
+- Deprecated API usage
+- Recoverable errors
+- Performance degradation
+
+**Typical output:**
+\`\`\`
+[WARN] [app:monitor] High memory usage detected {"usage":"85%","threshold":"80%"}
+\`\`\`
+
+### Error (4)
+
+Error conditions:
+
+\`\`\`ts
+logger.error('Database connection failed', {
+  error: error.message,
+  host: config.db.host
+});
+\`\`\`
+
+**Use for:**
+- Unhandled exceptions
+- Failed operations
+- System errors
+- External service failures
+
+**Typical output:**
+\`\`\`
+[ERROR] [app:db] Database connection failed {"error":"ECONNREFUSED","host":"localhost"}
+\`\`\`
+
+## Setting Log Level
+
+### Environment Variable
+
+\`\`\`bash
+# Set minimum level
+export LOG_LEVEL=debug
+
+# Levels: trace, debug, info, warn, error
+\`\`\`
+
+### Programmatic Configuration
+
+\`\`\`ts
+import { logger } from '@vibesdotdev/logging';
+
+logger.setLevel('debug');
+
+// Only debug, info, warn, error will be logged
+// trace will be filtered out
+\`\`\`
+
+### Config Manifest
+
+\`\`\`ts
+const loggingConfig = await runtime.query('config/manifest')
+  .filter(d => d.id === 'logging')
+  .resolve();
+
+const config = await loggingConfig.loadWithDefaults(context);
+
+console.log(config.level);  // 'info'
+\`\`\`
+
+## Level Filtering
+
+### Filter by Level
+
+\`\`\`ts
+logger.setLevel('warn');
+
+logger.trace('Will NOT be logged');  // filtered
+logger.debug('Will NOT be logged');  // filtered
+logger.info('Will NOT be logged');   // filtered
+logger.warn('Will be logged');       // ✓
+logger.error('Will be logged');      // ✓
+\`\`\`
+
+### Filter by Namespace
+
+\`\`\`ts
+import { createLogger } from '@vibesdotdev/logging';
+
+// Create logger with namespace
+const dbLogger = createLogger('app:db');
+const authLogger = createLogger('app:auth');
+
+dbLogger.setLevel('debug');
+authLogger.setLevel('error');
+
+dbLogger.debug('Query executed');    // logged
+authLogger.debug('Token validated');  // filtered
+\`\`\`
+
+### Filter by Context
+
+\`\`\`ts
+logger.debug('Debug message', {
+  context: {
+    userId: '123',
+    requestId: 'req-456'
+  }
+});
+
+// Output includes context
+// [DEBUG] [app] Debug message {"userId":"123","requestId":"req-456"}
+\`\`\`
+
+## Namespace Patterns
+
+### Namespace Hierarchy
+
+\`\`\`ts
+// Namespace structure
+app:server
+app:database
+app:auth
+app:api:users
+app:api:posts
+
+// Set level for namespace pattern
+logger.setLevel('app:api:*', 'debug');  // All API logs
+\`\`\`
+
+### Wildcard Patterns
+
+\`\`\`ts
+// Wildcard matching
+logger.setLevel('app:*', 'info');       // All app logs
+logger.setLevel('app:api:*', 'debug');  // All API logs
+logger.setLevel('*', 'warn');           // All logs
+\`\`\`
+
+## Level-Specific Methods
+
+### Convenience Methods
+
+\`\`\`ts
+logger.trace('Trace message');
+logger.debug('Debug message');
+logger.info('Info message');
+logger.warn('Warning message');
+logger.error('Error message');
+\`\`\`
+
+### Structured Logging
+
+\`\`\`ts
+logger.info('User logged in', {
+  userId: '123',
+  email: 'user@example.com',
+  timestamp: new Date().toISOString()
+});
+
+logger.error('Payment failed', {
+  userId: '123',
+  amount: 99.99,
+  error: 'Insufficient funds',
+  code: 'PAYMENT_FAILED'
+});
+\`\`\`
+
+## Conditional Logging
+
+### Level Guards
+
+\`\`\`ts
+if (logger.isLevelEnabled('debug')) {
+  // Expensive operation only if debug logging enabled
+  const debugData = computeExpensiveDebugData();
+  logger.debug('Debug info', debugData);
+}
+\`\`\`
+
+### Dynamic Level Changes
+
+\`\`\`ts
+// Temporarily increase verbosity
+const previousLevel = logger.getLevel();
+logger.setLevel('trace');
+
+// ... debug-heavy operation ...
+
+logger.setLevel(previousLevel);  // restore
+\`\`\`
+
+## Audit Logging
+
+Audit logs use special level handling:
+
+\`\`\`ts
+import { auditLogger } from '@vibesdotdev/logging';
+
+// Audit logs always logged regardless of level
+auditLogger.authentication({
+  userId: '123',
+  action: 'login',
+  success: true,
+  ipAddress: '192.168.1.1'
+});
+
+auditLogger.authorization({
+  userId: '123',
+  resource: 'users/456',
+  action: 'delete',
+  allowed: false
+});
+\`\`\`
+
+## Best Practices
+
+1. **Use appropriate levels** — Don't log everything as error
+2. **Include context** — Help debugging with relevant data
+3. **Avoid sensitive data** — Never log passwords, tokens, PII
+4. **Consistent namespaces** — Use hierarchical naming
+5. **Production level** — Typically 'info' or 'warn'
+6. **Development level** — Typically 'debug'
+
+:::card{title="See also"}
+- [\`logging.transports\`](logging.transports) — Transport layers
+- [\`logging.structured\`](logging.structured) — Structured logging
+- [\`config.environment\`](config.environment) — Environment configuration
+:::
+`
+    },
+    parent: 'logging',
+    order: 1,
+    tags: ['logging', 'levels', 'debug', 'info', 'warn', 'error', 'filtering'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=levels.docs.descriptor.js.map

package/dist/docs/levels.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/levels.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,qDAAqD;IAC9D,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmUT;KACC;IACD,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;IAC1E,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/structured.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=structured.docs.descriptor.d.ts.map

package/dist/docs/structured.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/structured.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBAubjB,CAAC;AAEF,eAAe,UAAU,CAAC"}