@mcphero/logger 1.1.6 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
 
2
- > @mcphero/logger@1.1.6 build /Users/atomic/projects/ai/mcphero/packages/logger
2
+ > @mcphero/logger@1.2.0 build /Users/atomic/projects/ai/mcphero/packages/logger
3
3
  > tsup
4
4
 
5
5
  CLI Building entry: src/index.ts
@@ -11,7 +11,7 @@ CLI Cleaning output folder
11
11
  ESM Build start
12
12
  ESM build/index.js 2.10 KB
13
13
  ESM build/index.js.map 4.77 KB
14
- ESM ⚡️ Build success in 5ms
14
+ ESM ⚡️ Build success in 8ms
15
15
  DTS Build start
16
- DTS ⚡️ Build success in 376ms
16
+ DTS ⚡️ Build success in 443ms
17
17
  DTS build/index.d.ts 1.04 KB
@@ -1,12 +1,12 @@
1
1
 
2
- > @mcphero/logger@1.1.6 check /Users/atomic/projects/ai/mcphero/packages/logger
2
+ > @mcphero/logger@1.2.0 check /Users/atomic/projects/ai/mcphero/packages/logger
3
3
  > pnpm lint && pnpm typecheck
4
4
 
5
5
 
6
- > @mcphero/logger@1.1.6 lint /Users/atomic/projects/ai/mcphero/packages/logger
6
+ > @mcphero/logger@1.2.0 lint /Users/atomic/projects/ai/mcphero/packages/logger
7
7
  > eslint
8
8
 
9
9
 
10
- > @mcphero/logger@1.1.6 typecheck /Users/atomic/projects/ai/mcphero/packages/logger
10
+ > @mcphero/logger@1.2.0 typecheck /Users/atomic/projects/ai/mcphero/packages/logger
11
11
  > tsc --noEmit
12
12
 
@@ -0,0 +1,5 @@
1
+
2
+ 
3
+ > @mcphero/logger@1.2.0 lint /Users/atomic/projects/ai/mcphero/packages/logger
4
+ > eslint
5
+
@@ -1,14 +1,14 @@
1
1
 
2
2
  
3
- > @mcphero/logger@1.1.6 prepack /Users/atomic/projects/ai/mcphero/packages/logger
3
+ > @mcphero/logger@1.2.0 prepack /Users/atomic/projects/ai/mcphero/packages/logger
4
4
  > pnpm clean && pnpm build
5
5
 
6
6
 
7
- > @mcphero/logger@1.1.6 clean /Users/atomic/projects/ai/mcphero/packages/logger
7
+ > @mcphero/logger@1.2.0 clean /Users/atomic/projects/ai/mcphero/packages/logger
8
8
  > rimraf build
9
9
 
10
10
 
11
- > @mcphero/logger@1.1.6 build /Users/atomic/projects/ai/mcphero/packages/logger
11
+ > @mcphero/logger@1.2.0 build /Users/atomic/projects/ai/mcphero/packages/logger
12
12
  > tsup
13
13
 
14
14
  CLI Building entry: src/index.ts
@@ -22,5 +22,5 @@
22
22
  ESM build/index.js.map 4.77 KB
23
23
  ESM ⚡️ Build success in 6ms
24
24
  DTS Build start
25
- DTS ⚡️ Build success in 408ms
25
+ DTS ⚡️ Build success in 400ms
26
26
  DTS build/index.d.ts 1.04 KB
package/README.md ADDED
@@ -0,0 +1,62 @@
1
+ # @mcphero/logger
2
+
3
+ Logging utilities for [MCPHero](https://github.com/atomicbi/mcphero). Provides a unified `Logger` interface with multiple backends — pino for stream logging, clack for terminal UI, and callback hooks for MCP notifications.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ pnpm add @mcphero/logger
9
+ ```
10
+
11
+ ## What's Inside
12
+
13
+ - **`Logger`** interface — 8 severity levels (`debug` through `emergency`) plus `progress()`
14
+ - **`createLogger()`** — Factory that creates a Logger backed by pino, with optional `onLog` and `onProgress` callbacks
15
+ - **`createCLILogger()`** — Logger that outputs via `@clack/prompts` for beautiful terminal UI
16
+ - **`buildLogLevels()`** — Build a log-level record from a single callback function
17
+
18
+ ## Usage
19
+
20
+ ```typescript
21
+ import { createLogger } from '@mcphero/logger'
22
+
23
+ const logger = createLogger({
24
+ stream: process.stderr,
25
+ onLog: (level, data) => {
26
+ // Hook into log events (e.g., send MCP notifications)
27
+ },
28
+ onProgress: ({ progress, total, message }) => {
29
+ // Hook into progress events
30
+ }
31
+ })
32
+
33
+ logger.info('Starting operation')
34
+ logger.progress({ progress: 5, total: 10, message: 'Halfway there' })
35
+ ```
36
+
37
+ ## Logger Interface
38
+
39
+ ```typescript
40
+ interface Logger {
41
+ debug: (data: unknown) => void
42
+ info: (data: unknown) => void
43
+ notice: (data: unknown) => void
44
+ warning: (data: unknown) => void
45
+ error: (data: unknown) => void
46
+ critical: (data: unknown) => void
47
+ alert: (data: unknown) => void
48
+ emergency: (data: unknown) => void
49
+ progress: (options: ProgressOptions) => void
50
+ }
51
+
52
+ interface ProgressOptions {
53
+ progress: number
54
+ total?: number
55
+ message?: string
56
+ }
57
+ ```
58
+
59
+ ## See Also
60
+
61
+ - [MCPHero README](https://github.com/atomicbi/mcphero) — Full documentation
62
+ - [`@mcphero/core`](https://www.npmjs.com/package/@mcphero/core) — Core library
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcphero/logger",
3
- "version": "1.1.6",
3
+ "version": "1.3.0",
4
4
  "description": "MCP Hero Logger",
5
5
  "repository": {
6
6
  "type": "git",