@ontrails/logging 1.0.0-beta.0 → 1.0.0-beta.1

package/.turbo/turbo-lint.log

@@ -1,3 +1,3 @@
 $ oxlint ./src
 Found 0 warnings and 0 errors.
-Finished in 106ms on 13 files with 93 rules using 24 threads.
+Finished in 39ms on 13 files with 93 rules using 24 threads.

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @ontrails/logging
 
+## 1.0.0-beta.1
+
+### Patch Changes
+
+- Fix two blocking bugs from real-world migration:
+  - Published packages now resolve correctly (workspace:^ instead of workspace:\*)
+  - Error forwarding works across different success types (Err no longer carries phantom T)
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.1
+
 ## 1.0.0-beta.0
 
 ### Minor Changes

package/README.md

@@ -1,20 +1,8 @@
 # @ontrails/logging
 
-Structured logging for Trails. One API: `createLogger(config)`. Built-in sinks and formatters, hierarchical category filtering, automatic redaction, and an optional LogTape adapter.
+Structured logging for Trails. One entry point: `createLogger`. Built-in sinks and formatters, hierarchical category filtering, automatic redaction, and an optional LogTape adapter.
 
-## Installation
-
-```bash
-bun add @ontrails/logging @ontrails/core
-```
-
-For LogTape integration:
-
-```bash
-bun add @logtape/logtape
-```
-
-## Quick Start
+## Usage
 
 ```typescript
 import { createLogger } from '@ontrails/logging';
@@ -28,112 +16,65 @@ logger.info('Entity created', { entityId: 'e1', name: 'Alpha' });
 // 10:00:00 INFO  [app.entity] Entity created  entityId=e1 name=Alpha
 ```
 
-## API Overview
-
-### `createLogger(config)`
-
-The single entry point. Returns a `Logger` (from `@ontrails/core`) that plugs directly into `TrailContext.logger`.
-
-```typescript
-const logger = createLogger({
-  name: 'app.db.queries',
-  level: 'info',
-  levels: {
-    app: 'info',
-    'app.db': 'debug',
-    'app.http': 'warn',
-  },
-  sinks: [createConsoleSink(), createFileSink({ path: './app.log' })],
-  redaction: { sensitiveKeys: ['password', 'token'] },
-});
-```
-
-### Sinks
-
-A `LogSink` receives formatted log records and writes them somewhere.
-
-```typescript
-import { createConsoleSink, createFileSink } from '@ontrails/logging';
-
-// Console output (default sink)
-createConsoleSink({ formatter: createPrettyFormatter() });
-
-// File output
-createFileSink({ path: './logs/app.log', formatter: createJsonFormatter() });
-```
-
-### Formatters
+The returned `Logger` plugs directly into `TrailContext.logger`.
 
-```typescript
-import { createJsonFormatter, createPrettyFormatter } from '@ontrails/logging';
+## API
 
-// Structured JSON -- one object per line, ISO 8601 timestamps
-createJsonFormatter();
-// {"level":"info","message":"Entity created","category":"app.entity","timestamp":"2026-03-25T10:00:00.000Z"}
+| Export | What it does |
+| --- | --- |
+| `createLogger(config)` | Create a logger with sinks, formatters, and level config |
+| `createConsoleSink(options?)` | Sink that writes to the console |
+| `createFileSink(options)` | Sink that writes to a file |
+| `createJsonFormatter()` | One JSON object per line, ISO timestamps |
+| `createPrettyFormatter()` | Human-readable with optional ANSI colors |
 
-// Human-readable -- optional ANSI colors, compact metadata
-createPrettyFormatter();
-// 10:00:00 INFO  [app.entity] Entity created  entityId=e1
-```
+See the [API Reference](../../docs/api-reference.md) for the full list.
 
-### Hierarchical Category Filtering
+## Hierarchical filtering
 
-Categories are dot-separated. Level resolution walks up the hierarchy until a match is found:
+Categories are dot-separated. Level resolution walks up the hierarchy:
 
 ```typescript
 const logger = createLogger({
   name: 'app.db.queries',
-  level: 'info', // global fallback
+  level: 'info',
   levels: {
     app: 'info',
-    'app.db': 'debug', // matches "app.db.queries"
+    'app.db': 'debug',   // matches "app.db.queries"
     'app.http': 'warn',
   },
 });
 ```
 
-Resolution for `"app.db.queries"`: check exact match, then `"app.db"` (found: `"debug"`), then `"app"`, then `config.level`, then `TRAILS_LOG_LEVEL` env var, then `"info"`.
+Resolution for `"app.db.queries"`: exact match, then `"app.db"` (debug), then `"app"`, then `config.level`, then `TRAILS_LOG_LEVEL`, then `"info"`.
 
-### Child Loggers
+## Child loggers
 
 ```typescript
 const child = logger.child({ requestId: 'abc-123', trail: 'entity.show' });
 child.info('Processing');
-// Every log record from this child includes requestId and trail metadata
+// Every record from this child includes requestId and trail metadata
 ```
 
-Children inherit the parent's sinks, level config, and redaction. They share the parent's sink pipeline.
+Children inherit sinks, level config, and redaction from the parent.
 
-### Redaction
+## Redaction
 
-Sensitive data is automatically stripped before any sink dispatch. Uses `@ontrails/core/redaction` under the hood.
+Sensitive data is stripped before sink dispatch, using `@ontrails/core/redaction`:
 
 ```typescript
 const logger = createLogger({
   name: 'app',
-  redaction: {
-    patterns: [/custom-secret-\w+/g],
-    sensitiveKeys: ['password', 'internalToken'],
-  },
+  redaction: { sensitiveKeys: ['password', 'token'] },
 });
 
 logger.info('Auth', { user: 'admin', password: 'hunter2' });
-// password is redacted: "[REDACTED]"
+// password → "[REDACTED]"
 ```
 
-### Environment Configuration
-
-Log level can be set via environment:
+## LogTape adapter
 
-1. Explicit `config.level` (highest priority)
-2. `config.levels` hierarchy
-3. `TRAILS_LOG_LEVEL` env var
-4. `TRAILS_ENV` profile defaults (`development` = `"debug"`, `test` = silent)
-5. Fallback: `"info"`
-
-### LogTape Adapter (`@ontrails/logging/logtape`)
-
-Bridge Trails logging to an existing LogTape infrastructure:
+Bridge to an existing LogTape setup via the `/logtape` subpath:
 
 ```typescript
 import { logtapeSink } from '@ontrails/logging/logtape';
@@ -145,16 +86,10 @@ const logger = createLogger({
 });
 ```
 
-`@logtape/logtape` is an optional peer dependency. The main package does not depend on it.
-
-## Subpath Exports
+`@logtape/logtape` is an optional peer dependency.
 
-| Export | Contents |
-| --- | --- |
-| `@ontrails/logging` | `createLogger`, `createConsoleSink`, `createFileSink`, `createJsonFormatter`, `createPrettyFormatter`, level resolution |
-| `@ontrails/logging/logtape` | `logtapeSink` adapter (requires `@logtape/logtape` peer) |
-
-## Further Reading
+## Installation
 
-- [Getting Started](../../docs/getting-started.md)
-- [Architecture](../../docs/architecture.md)
+```bash
+bun add @ontrails/logging @ontrails/core
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/logging",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.1",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -15,7 +15,7 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "peerDependencies": {
-    "@ontrails/core": "workspace:*"
+    "@ontrails/core": "workspace:^"
   },
   "peerDependenciesMeta": {
     "@logtape/logtape": {