@pipod/cli 0.1.18 → 0.1.19
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.
- package/README.md +19 -0
- package/man/pipod-config.5 +1 -1
- package/man/pipod.1 +1 -1
- package/npm-shrinkwrap.json +4237 -0
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -21,6 +21,25 @@ The npm release works with any server at least as new as it; a CLI newer than it
|
|
|
21
21
|
refused, so upgrade the server first. Building the CLI from the server's own checkout always
|
|
22
22
|
matches.
|
|
23
23
|
|
|
24
|
+
## Release dependencies
|
|
25
|
+
|
|
26
|
+
The CLI is an application package: its committed `npm-shrinkwrap.json` ships in
|
|
27
|
+
npm releases so fresh installs and `pipod update` use the same dependency graph
|
|
28
|
+
validated by `npm ci`. A plain `package-lock.json` is not published and would let
|
|
29
|
+
Pi's transitive semver ranges drift, even with Pi itself pinned exactly. For
|
|
30
|
+
example, pi-coding-agent 1.0.2 imports exports removed by pi-codemode 1.2.0.
|
|
31
|
+
|
|
32
|
+
Keep the shrinkwrap when updating dependencies (`make bump-pi VERSION=x.y.z` for
|
|
33
|
+
Pi). Do not replace it with package-level `overrides`: npm ignores those when this
|
|
34
|
+
package is installed as a dependency.
|
|
35
|
+
|
|
36
|
+
Install releases from the registry (`npm install -g @pipod/cli` or `pipod update`).
|
|
37
|
+
Direct `.tgz` installs with npm 10/11 lack the registry's shrinkwrap metadata and
|
|
38
|
+
can still resolve newer transitive dependencies. To verify a packed release
|
|
39
|
+
before publishing, extract it into a clean directory, run `npm ci --omit=dev`
|
|
40
|
+
there, and run `node dist/cli.js --version`; after publishing, verify a fresh
|
|
41
|
+
registry install as well.
|
|
42
|
+
|
|
24
43
|
## Secrets
|
|
25
44
|
|
|
26
45
|
```bash
|
package/man/pipod-config.5
CHANGED
package/man/pipod.1
CHANGED