@united-workforce/cli 0.2.1-rc.1 → 0.2.1-rc.3

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 +1 @@
1
- {"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EAEnC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAQF,wBAAgB,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAgK3C"}
1
+ {"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EAEnC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAQF,wBAAgB,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAmM3C"}
@@ -15,10 +15,45 @@ Set up or upgrade uwf (United Workforce) — from zero to running your first wor
15
15
 
16
16
  ## Scenario A: Fresh Install
17
17
 
18
+ ### Step 0 — Environment pre-flight check
19
+
20
+ Run ALL checks below BEFORE installing anything. If any check fails, fix it first — do NOT skip ahead.
21
+
22
+ \`\`\`bash
23
+ # 1. Node.js
24
+ node --version # need v20+
25
+ # FIX: install via nvm (https://github.com/nvm-sh/nvm) or your OS package manager
26
+
27
+ # 2. Package manager — pnpm (preferred) or npm
28
+ pnpm --version || npm --version
29
+ # FIX for pnpm: corepack enable pnpm (Node 20+)
30
+ # or: npm install -g pnpm
31
+ # If pnpm is not an option, npm works too — adjust install commands below
32
+
33
+ # 3. Global bin directory is in PATH
34
+ # For pnpm:
35
+ pnpm root -g 2>/dev/null && pnpm bin -g
36
+ # For npm:
37
+ npm prefix -g
38
+ # The "bin" directory printed above MUST be in your PATH.
39
+ # Test: echo $PATH | tr ':' '\\n' | grep -E "(pnpm|npm|node)"
40
+ # FIX: add the bin directory to ~/.profile or ~/.bashrc:
41
+ # export PATH="$(pnpm bin -g):$PATH" # pnpm
42
+ # export PATH="$(npm prefix -g)/bin:$PATH" # npm
43
+
44
+ # 4. (uwf-hermes only) hermes CLI
45
+ which hermes
46
+ # FIX: if hermes is in a virtualenv, add it to PATH:
47
+ # export PATH="$HOME/.hermes/hermes-agent/.venv/bin:$PATH"
48
+ # or create a symlink: ln -s ~/.hermes/hermes-agent/.venv/bin/hermes ~/.local/bin/hermes
49
+ \`\`\`
50
+
51
+ **All checks must pass before continuing.** If you had to modify PATH, verify the change persists by opening a new shell or sourcing your profile.
52
+
18
53
  ### Step 1 — Install CLI and agent adapter
19
54
 
20
55
  \`\`\`bash
21
- npm install -g @united-workforce/cli
56
+ pnpm add -g @united-workforce/cli # or: npm install -g @united-workforce/cli
22
57
  uwf --version # should print ${VERSION}
23
58
  \`\`\`
24
59
 
@@ -26,9 +61,9 @@ Install an agent adapter (at least one is required):
26
61
 
27
62
  | Adapter | Install | When to use |
28
63
  |---------|---------|-------------|
29
- | uwf-hermes | \`npm install -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
30
- | uwf-claude-code | \`npm install -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
31
- | uwf-builtin | \`npm install -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
64
+ | uwf-hermes | \`pnpm add -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
65
+ | uwf-claude-code | \`pnpm add -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
66
+ | uwf-builtin | \`pnpm add -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
32
67
 
33
68
  **uwf-hermes** also requires the Hermes ACP plugin. After installing \`hermes-agent\`, run:
34
69
  \`\`\`bash
@@ -116,11 +151,11 @@ If the thread reaches \`$END\` with status \`completed\`, the setup is working.
116
151
  ### Step 1 — Update packages
117
152
 
118
153
  \`\`\`bash
119
- npm install -g @united-workforce/cli@latest
154
+ pnpm add -g @united-workforce/cli@latest # or: npm install -g @united-workforce/cli@latest
120
155
  uwf --version # should print ${VERSION}
121
156
 
122
157
  # Also update your adapter(s)
123
- npm install -g @united-workforce/agent-hermes@latest
158
+ pnpm add -g @united-workforce/agent-hermes@latest
124
159
  \`\`\`
125
160
 
126
161
  ### Step 2 — Regenerate skills
@@ -1 +1 @@
1
- {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EAClC,OAAO,GACR,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAEF,MAAM,cAAc,GAA4D;IAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACnD,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;IAC5E,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;CAC7E,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;iCAUwB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAkGP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDvC,CAAC;AACF,CAAC"}
1
+ {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EAClC,OAAO,GACR,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAEF,MAAM,cAAc,GAA4D;IAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACnD,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;IAC5E,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;CAC7E,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCA6CwB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAkGP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDvC,CAAC;AACF,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@united-workforce/cli",
3
- "version": "0.2.1-rc.1",
3
+ "version": "0.2.1-rc.3",
4
4
  "files": [
5
5
  "src",
6
6
  "dist",
@@ -28,10 +28,45 @@ Set up or upgrade uwf (United Workforce) — from zero to running your first wor
28
28
 
29
29
  ## Scenario A: Fresh Install
30
30
 
31
+ ### Step 0 — Environment pre-flight check
32
+
33
+ Run ALL checks below BEFORE installing anything. If any check fails, fix it first — do NOT skip ahead.
34
+
35
+ \`\`\`bash
36
+ # 1. Node.js
37
+ node --version # need v20+
38
+ # FIX: install via nvm (https://github.com/nvm-sh/nvm) or your OS package manager
39
+
40
+ # 2. Package manager — pnpm (preferred) or npm
41
+ pnpm --version || npm --version
42
+ # FIX for pnpm: corepack enable pnpm (Node 20+)
43
+ # or: npm install -g pnpm
44
+ # If pnpm is not an option, npm works too — adjust install commands below
45
+
46
+ # 3. Global bin directory is in PATH
47
+ # For pnpm:
48
+ pnpm root -g 2>/dev/null && pnpm bin -g
49
+ # For npm:
50
+ npm prefix -g
51
+ # The "bin" directory printed above MUST be in your PATH.
52
+ # Test: echo $PATH | tr ':' '\\n' | grep -E "(pnpm|npm|node)"
53
+ # FIX: add the bin directory to ~/.profile or ~/.bashrc:
54
+ # export PATH="$(pnpm bin -g):$PATH" # pnpm
55
+ # export PATH="$(npm prefix -g)/bin:$PATH" # npm
56
+
57
+ # 4. (uwf-hermes only) hermes CLI
58
+ which hermes
59
+ # FIX: if hermes is in a virtualenv, add it to PATH:
60
+ # export PATH="$HOME/.hermes/hermes-agent/.venv/bin:$PATH"
61
+ # or create a symlink: ln -s ~/.hermes/hermes-agent/.venv/bin/hermes ~/.local/bin/hermes
62
+ \`\`\`
63
+
64
+ **All checks must pass before continuing.** If you had to modify PATH, verify the change persists by opening a new shell or sourcing your profile.
65
+
31
66
  ### Step 1 — Install CLI and agent adapter
32
67
 
33
68
  \`\`\`bash
34
- npm install -g @united-workforce/cli
69
+ pnpm add -g @united-workforce/cli # or: npm install -g @united-workforce/cli
35
70
  uwf --version # should print ${VERSION}
36
71
  \`\`\`
37
72
 
@@ -39,9 +74,9 @@ Install an agent adapter (at least one is required):
39
74
 
40
75
  | Adapter | Install | When to use |
41
76
  |---------|---------|-------------|
42
- | uwf-hermes | \`npm install -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
43
- | uwf-claude-code | \`npm install -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
44
- | uwf-builtin | \`npm install -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
77
+ | uwf-hermes | \`pnpm add -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
78
+ | uwf-claude-code | \`pnpm add -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
79
+ | uwf-builtin | \`pnpm add -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
45
80
 
46
81
  **uwf-hermes** also requires the Hermes ACP plugin. After installing \`hermes-agent\`, run:
47
82
  \`\`\`bash
@@ -129,11 +164,11 @@ If the thread reaches \`$END\` with status \`completed\`, the setup is working.
129
164
  ### Step 1 — Update packages
130
165
 
131
166
  \`\`\`bash
132
- npm install -g @united-workforce/cli@latest
167
+ pnpm add -g @united-workforce/cli@latest # or: npm install -g @united-workforce/cli@latest
133
168
  uwf --version # should print ${VERSION}
134
169
 
135
170
  # Also update your adapter(s)
136
- npm install -g @united-workforce/agent-hermes@latest
171
+ pnpm add -g @united-workforce/agent-hermes@latest
137
172
  \`\`\`
138
173
 
139
174
  ### Step 2 — Regenerate skills