@mcphero/cli 1.1.6 → 1.2.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.
Files changed (5) hide show
  1. package/.turbo/turbo-build.log +17 -18
  2. package/.turbo/turbo-check.log +3 -3
  3. package/.turbo/turbo-prepack.log +5 -5
  4. package/README.md +67 -0
  5. package/package.json +3 -3
package/.turbo/turbo-build.log CHANGED
@@ -1,18 +1,17 @@
1
-
2
- 
3
- > @mcphero/cli@1.1.6 build /Users/atomic/projects/ai/mcphero/packages/cli
4
- > tsup
5
-
6
- CLI Building entry: src/index.ts
7
- CLI Using tsconfig: tsconfig.json
8
- CLI tsup v8.5.1
9
- CLI Using tsup config: /Users/atomic/projects/ai/mcphero/packages/cli/tsup.config.ts
10
- CLI Target: es2022
11
- CLI Cleaning output folder
12
- ESM Build start
13
- ESM build/index.js 3.18 KB
14
- ESM build/index.js.map 5.63 KB
15
- ESM ⚡️ Build success in 8ms
16
- DTS Build start
17
- DTS ⚡️ Build success in 473ms
18
- DTS build/index.d.ts 101.00 B
1
+
2
+ > @mcphero/cli@1.1.7 build /Users/atomic/projects/ai/mcphero/packages/cli
3
+ > tsup
4
+
5
+ CLI Building entry: src/index.ts
6
+ CLI Using tsconfig: tsconfig.json
7
+ CLI tsup v8.5.1
8
+ CLI Using tsup config: /Users/atomic/projects/ai/mcphero/packages/cli/tsup.config.ts
9
+ CLI Target: es2022
10
+ CLI Cleaning output folder
11
+ ESM Build start
12
+ ESM build/index.js 3.18 KB
13
+ ESM build/index.js.map 5.63 KB
14
+ ESM ⚡️ Build success in 15ms
15
+ DTS Build start
16
+ DTS ⚡️ Build success in 733ms
17
+ DTS build/index.d.ts 101.00 B
package/.turbo/turbo-check.log CHANGED
@@ -1,12 +1,12 @@
1
1
 
2
- > @mcphero/cli@1.1.6 check /Users/atomic/projects/ai/mcphero/packages/cli
2
+ > @mcphero/cli@1.1.7 check /Users/atomic/projects/ai/mcphero/packages/cli
3
3
  > pnpm lint && pnpm typecheck
4
4
 
5
5
 
6
- > @mcphero/cli@1.1.6 lint /Users/atomic/projects/ai/mcphero/packages/cli
6
+ > @mcphero/cli@1.1.7 lint /Users/atomic/projects/ai/mcphero/packages/cli
7
7
  > eslint
8
8
 
9
9
 
10
- > @mcphero/cli@1.1.6 typecheck /Users/atomic/projects/ai/mcphero/packages/cli
10
+ > @mcphero/cli@1.1.7 typecheck /Users/atomic/projects/ai/mcphero/packages/cli
11
11
  > tsc --noEmit
12
12
 
package/.turbo/turbo-prepack.log CHANGED
@@ -1,14 +1,14 @@
1
1
 
2
2
  
3
- > @mcphero/cli@1.1.6 prepack /Users/atomic/projects/ai/mcphero/packages/cli
3
+ > @mcphero/cli@1.1.7 prepack /Users/atomic/projects/ai/mcphero/packages/cli
4
4
  > pnpm clean && pnpm build
5
5
 
6
6
 
7
- > @mcphero/cli@1.1.6 clean /Users/atomic/projects/ai/mcphero/packages/cli
7
+ > @mcphero/cli@1.1.7 clean /Users/atomic/projects/ai/mcphero/packages/cli
8
8
  > rimraf build
9
9
 
10
10
 
11
- > @mcphero/cli@1.1.6 build /Users/atomic/projects/ai/mcphero/packages/cli
11
+ > @mcphero/cli@1.1.7 build /Users/atomic/projects/ai/mcphero/packages/cli
12
12
  > tsup
13
13
 
14
14
  CLI Building entry: src/index.ts
@@ -20,7 +20,7 @@
20
20
  ESM Build start
21
21
  ESM build/index.js 3.18 KB
22
22
  ESM build/index.js.map 5.63 KB
23
- ESM ⚡️ Build success in 9ms
23
+ ESM ⚡️ Build success in 12ms
24
24
  DTS Build start
25
- DTS ⚡️ Build success in 652ms
25
+ DTS ⚡️ Build success in 690ms
26
26
  DTS build/index.d.ts 101.00 B
package/README.md ADDED
@@ -0,0 +1,67 @@
1
+ # @mcphero/cli
2
+
3
+ CLI adapter for [MCPHero](https://github.com/atomicbi/mcphero) — turn your actions into a complete command-line application with help text, option parsing, and styled terminal output via clack.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ pnpm add @mcphero/core @mcphero/cli
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```typescript
14
+ import { mcphero } from '@mcphero/core'
15
+ import { cli } from '@mcphero/cli'
16
+ import { GreetAction } from './actions/greet.js'
17
+
18
+ await mcphero({ name: 'mytool', description: 'My CLI Tool', version: '1.0.0' })
19
+ .adapter(cli())
20
+ .action(GreetAction)
21
+ .start()
22
+ ```
23
+
24
+ ```
25
+ $ mytool greet --name "World" --enthusiastic
26
+ ◇ mytool - greet
27
+ ℹ HELLO, WORLD!!!
28
+ ```
29
+
30
+ ## How Zod Types Map to CLI Options
31
+
32
+ | Zod Type | CLI Representation |
33
+ |----------|-------------------|
34
+ | `z.string()` | `--option-name <string>` |
35
+ | `z.number()` | `--option-name <number>` |
36
+ | `z.boolean()` | `--option-name` / `--no-option-name` |
37
+ | `z.enum([...])` | `--option-name <choice>` with choices validation |
38
+ | `z.record()` | `--option-name <json>` |
39
+ | `.default(value)` | Sets the default in help text |
40
+ | `.describe('...')` | Sets the option description |
41
+
42
+ Field names are automatically converted to `kebab-case`. Action names become subcommands.
43
+
44
+ ## Positional Arguments
45
+
46
+ Use the `args` property on an action to promote fields to positional arguments:
47
+
48
+ ```typescript
49
+ const DeployAction = createAction({
50
+ name: 'deploy',
51
+ input: z.object({
52
+ environment: z.string(),
53
+ dryRun: z.boolean().default(false)
54
+ }),
55
+ args: ['environment'],
56
+ // ...
57
+ })
58
+ ```
59
+
60
+ ```
61
+ $ mytool deploy production --dry-run
62
+ ```
63
+
64
+ ## See Also
65
+
66
+ - [MCPHero README](https://github.com/atomicbi/mcphero) — Full documentation
67
+ - [`@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/cli",
3
- "version": "1.1.6",
3
+ "version": "1.2.0",
4
4
  "description": "MCP Hero CLI Adapter",
5
5
  "repository": {
6
6
  "type": "git",
@@ -15,8 +15,8 @@
15
15
  "change-case": "^5.4.4",
16
16
  "commander": "^13.1.0",
17
17
  "zod": "^4.3.6",
18
- "@mcphero/core": "1.1.6",
19
- "@mcphero/logger": "1.1.6"
18
+ "@mcphero/core": "1.2.0",
19
+ "@mcphero/logger": "1.2.0"
20
20
  },
21
21
  "devDependencies": {
22
22
  "@eslint/js": "^10.0.1",