@united-workforce/cli 0.2.1-rc.2 → 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.
Files changed (5) hide show
  1. package/dist/commands/prompt.d.ts.map +1 -1
  2. package/dist/commands/prompt.js +41 -11
  3. package/dist/commands/prompt.js.map +1 -1
  4. package/package.json +2 -2
  5. package/src/commands/prompt.ts +41 -11
package/dist/commands/prompt.d.ts.map CHANGED
@@ -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,CAqK3C"}
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"}
package/dist/commands/prompt.js CHANGED
@@ -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,20 +61,15 @@ 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
35
70
  pip install hermes-agent[acp] # or: pip install -e .[acp] if installed from source
36
71
  \`\`\`
37
72
 
38
- Verify \`hermes\` is in your PATH: \`which hermes\`. If Hermes is installed in a virtualenv (e.g. \`~/.hermes/hermes-agent/.venv/\`), activate it or add the bin directory to PATH:
39
- \`\`\`bash
40
- export PATH="$HOME/.hermes/hermes-agent/.venv/bin:$PATH"
41
- \`\`\`
42
-
43
73
  Verify the adapter is installed: \`uwf-hermes --version\` (or whichever you chose).
44
74
 
45
75
  ### Step 2 — Configure provider and model
@@ -121,11 +151,11 @@ If the thread reaches \`$END\` with status \`completed\`, the setup is working.
121
151
  ### Step 1 — Update packages
122
152
 
123
153
  \`\`\`bash
124
- npm install -g @united-workforce/cli@latest
154
+ pnpm add -g @united-workforce/cli@latest # or: npm install -g @united-workforce/cli@latest
125
155
  uwf --version # should print ${VERSION}
126
156
 
127
157
  # Also update your adapter(s)
128
- npm install -g @united-workforce/agent-hermes@latest
158
+ pnpm add -g @united-workforce/agent-hermes@latest
129
159
  \`\`\`
130
160
 
131
161
  ### Step 2 — Regenerate skills
package/dist/commands/prompt.js.map CHANGED
@@ -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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAuGP,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.2",
3
+ "version": "0.2.1-rc.3",
4
4
  "files": [
5
5
  "src",
6
6
  "dist",
@@ -18,7 +18,7 @@
18
18
  "mustache": "^4.2.0",
19
19
  "yaml": "^2.8.4",
20
20
  "@united-workforce/protocol": "^0.1.0",
21
- "@united-workforce/util": "^0.1.3-rc.0",
21
+ "@united-workforce/util": "^0.1.2",
22
22
  "@united-workforce/util-agent": "^0.1.0"
23
23
  },
24
24
  "publishConfig": {
package/src/commands/prompt.ts CHANGED
@@ -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,20 +74,15 @@ 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
48
83
  pip install hermes-agent[acp] # or: pip install -e .[acp] if installed from source
49
84
  \`\`\`
50
85
 
51
- Verify \`hermes\` is in your PATH: \`which hermes\`. If Hermes is installed in a virtualenv (e.g. \`~/.hermes/hermes-agent/.venv/\`), activate it or add the bin directory to PATH:
52
- \`\`\`bash
53
- export PATH="$HOME/.hermes/hermes-agent/.venv/bin:$PATH"
54
- \`\`\`
55
-
56
86
  Verify the adapter is installed: \`uwf-hermes --version\` (or whichever you chose).
57
87
 
58
88
  ### Step 2 — Configure provider and model
@@ -134,11 +164,11 @@ If the thread reaches \`$END\` with status \`completed\`, the setup is working.
134
164
  ### Step 1 — Update packages
135
165
 
136
166
  \`\`\`bash
137
- npm install -g @united-workforce/cli@latest
167
+ pnpm add -g @united-workforce/cli@latest # or: npm install -g @united-workforce/cli@latest
138
168
  uwf --version # should print ${VERSION}
139
169
 
140
170
  # Also update your adapter(s)
141
- npm install -g @united-workforce/agent-hermes@latest
171
+ pnpm add -g @united-workforce/agent-hermes@latest
142
172
  \`\`\`
143
173
 
144
174
  ### Step 2 — Regenerate skills