@geekbeer/minion 1.0.0 → 1.0.1

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 (3) hide show
  1. package/README.md +105 -0
  2. package/minion-cli.sh +4 -0
  3. package/package.json +1 -1
package/README.md ADDED
@@ -0,0 +1,105 @@
1
+ # @geekbeer/minion
2
+
3
+ AI Agent runtime for Minion - manages heartbeat, status, and skill deployment on VPS.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install -g @geekbeer/minion
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ### Setup (VPS)
14
+
15
+ ```bash
16
+ minion-cli setup \
17
+ --hq-url https://minion.geekbeer.co.jp \
18
+ --minion-id <MINION_ID> \
19
+ --api-token <API_TOKEN> \
20
+ --setup-tunnel \
21
+ --non-interactive
22
+ ```
23
+
24
+ ### Service Management
25
+
26
+ ```bash
27
+ minion-cli start # Start the minion agent
28
+ minion-cli stop # Stop the minion agent
29
+ minion-cli restart # Restart the minion agent
30
+ minion-cli status # Show service status
31
+ minion-cli health # Run health check
32
+ ```
33
+
34
+ ### Logging
35
+
36
+ ```bash
37
+ minion-cli log -m "Task completed" -l info -s skill-name
38
+ ```
39
+
40
+ ## npm公開手順
41
+
42
+ ### 初回セットアップ
43
+
44
+ 1. npmにログイン:
45
+ ```bash
46
+ npm login
47
+ ```
48
+
49
+ 2. `geekbeer` organizationがnpmに存在することを確認(なければ作成):
50
+ ```bash
51
+ npm org create geekbeer
52
+ ```
53
+ または https://www.npmjs.com/org/create から作成。
54
+
55
+ ### パッケージ公開
56
+
57
+ ```bash
58
+ cd packages/minion
59
+
60
+ # 含まれるファイルを事前確認
61
+ npm pack --dry-run
62
+
63
+ # 公開
64
+ npm publish --access public
65
+ ```
66
+
67
+ `publishConfig.access: "public"` が `package.json` に設定済みのため、`--access public` は省略可能。
68
+
69
+ ### バージョンアップ & 再公開
70
+
71
+ ```bash
72
+ cd packages/minion
73
+
74
+ # バージョンを上げる(patch: 1.0.0 → 1.0.1)
75
+ npm version patch
76
+
77
+ # または minor: 1.0.0 → 1.1.0
78
+ npm version minor
79
+
80
+ # または major: 1.0.0 → 2.0.0
81
+ npm version major
82
+
83
+ # 公開
84
+ npm publish
85
+ ```
86
+
87
+ ### 公開確認
88
+
89
+ ```bash
90
+ npm view @geekbeer/minion
91
+ ```
92
+
93
+ ## Environment Variables
94
+
95
+ | Variable | Description | Default |
96
+ |----------|-------------|---------|
97
+ | `HQ_URL` | Minion HQ server URL | - |
98
+ | `API_TOKEN` | Authentication token | - |
99
+ | `MINION_ID` | Minion UUID | - |
100
+ | `AGENT_PORT` | Agent API listen port | `3001` |
101
+ | `HEARTBEAT_INTERVAL` | Heartbeat interval (ms) | `30000` |
102
+
103
+ ## License
104
+
105
+ MIT
package/minion-cli.sh CHANGED
@@ -90,6 +90,10 @@ do_setup() {
90
90
  SETUP_TUNNEL=true
91
91
  shift
92
92
  ;;
93
+ --non-interactive)
94
+ # Accepted for cloud-init compatibility (setup is always non-interactive)
95
+ shift
96
+ ;;
93
97
  *)
94
98
  echo "Unknown option: $1"
95
99
  echo "Usage: minion-cli setup [--hq-url <URL>] [--minion-id <UUID>] [--api-token <TOKEN>] [--setup-tunnel]"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@geekbeer/minion",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "AI Agent runtime for Minion - manages heartbeat, status, and skill deployment on VPS",
5
5
  "main": "server.js",
6
6
  "bin": {