@stemtrooper/learningcode 0.4.2 → 0.4.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 (2) hide show
  1. package/README.md +31 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -63,6 +63,34 @@ npm install -g @stemtrooper/learningcode
63
63
  learningcode --version
64
64
  ```
65
65
 
66
+ `node --version` must report **22.19.0 or newer**. If it is older — and
67
+ Ubuntu's own `apt` package is usually Node 18 — install a current one first:
68
+
69
+ ```bash
70
+ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
71
+ source ~/.bashrc
72
+ nvm install 24
73
+ nvm alias default 24
74
+ ```
75
+
76
+ **If the install fails with a permissions error**, npm's global directory belongs
77
+ to root. Move it somewhere you own, then install again:
78
+
79
+ ```bash
80
+ mkdir -p ~/.npm-global
81
+ npm config set prefix ~/.npm-global
82
+ export PATH="$HOME/.npm-global/bin:$PATH"
83
+ echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
84
+
85
+ npm install -g @stemtrooper/learningcode
86
+ ```
87
+
88
+ The last line is what makes `learningcode` visible in future terminals; without
89
+ it you will think the install failed.
90
+
91
+ **Do not use `sudo npm install -g`.** It appears to work, then writes
92
+ root-owned files that break your next upgrade with a confusing error.
93
+
66
94
  ### Termux (Android)
67
95
 
68
96
  No root and no `proot-distro` needed.
@@ -167,7 +195,9 @@ A footer shows your remaining quota whenever you are connected to Spark:
167
195
  ## Troubleshooting
168
196
 
169
197
  **`Node 22.19.0 or newer is required`**
170
- Upgrade Node, then reinstall: `npm i -g @stemtrooper/learningcode`.
198
+ Upgrade Node, then reinstall: `npm i -g @stemtrooper/learningcode`. On Linux this
199
+ is usually the first thing to check, because Ubuntu ships Node 18 — see
200
+ [macOS / Linux](#macos--linux).
171
201
 
172
202
  **`No Spark API token configured`**
173
203
  You do not have a token yet, or it is not cached. Run `learningcode --login` to
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stemtrooper/learningcode",
3
- "version": "0.4.2",
3
+ "version": "0.4.3",
4
4
  "description": "TLC Spark coding agent for students: Pi wired to the Spark OpenAI-compatible endpoint with per-student tokens, quota and seat-queue awareness.",
5
5
  "type": "module",
6
6
  "license": "MIT",