Skip to content

Commit b8f02f7

Browse files
committed
CLI documentation update from CI
1 parent 776a19d commit b8f02f7

17 files changed

Lines changed: 132 additions & 31 deletions

cli-cache.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"v8": "aa8fff11cdab94fff1a2160ee5241f5f4632e96b",
33
"v9": "64763a341e7aa5b456e696f956759bf9b3440dc1",
4-
"v10": "49a764e354ab321da88b499fc4233eee3fa98406",
5-
"v11": "21ea382a60b3693ff6c44c81447caa5d0294169c"
4+
"v10": "dd3c80e9965d240957684e9951603cf22eaae74c",
5+
"v11": "0629fbf736eafcb555428d96bd86a69f8e791d70"
66
}

content/cli/v10/commands/npm-ls.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
3636
Positional arguments are `name@version-range` identifiers, which will limit the results to only the paths to the packages named. Note that nested packages will _also_ show the paths to the specified packages. For example, running `npm ls promzard` in npm's source tree will show:
3737

3838
```bash
39-
npm@10.9.6 /path/to/npm
39+
npm@10.9.8 /path/to/npm
4040
└─┬ init-package-json@0.0.4
4141
└── promzard@0.1.5
4242
```

content/cli/v10/commands/npm.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Note: This command is unaware of workspaces.
2323

2424
### Version
2525

26-
10.9.6
26+
10.9.8
2727

2828
### Description
2929

content/cli/v10/using-npm/changelog.mdx

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,33 @@ redirect_from:
99
- /cli/v10/misc/changelog
1010
---
1111

12+
### Dependencies
13+
14+
- [workspace](https://github.com/npm/cli/releases/tag/arborist-v8.0.5): `@npmcli/arborist@8.0.5`
15+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmdiff-v7.0.5): `libnpmdiff@7.0.5`
16+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmexec-v9.0.5): `libnpmexec@9.0.5`
17+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmfund-v6.0.5): `libnpmfund@6.0.5`
18+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmpack-v8.0.5): `libnpmpack@8.0.5`
19+
20+
## [10.9.7](https://github.com/npm/cli/compare/v10.9.6...v10.9.7) (2026-03-18)
21+
22+
### Bug Fixes
23+
24+
- [`bbcd455`](https://github.com/npm/cli/commit/bbcd45502315365286ce8b35a9585c5e4c516e6b) [#9120](https://github.com/npm/cli/pull/9120) arborist: v10 - backport store, lock-only, and override sibling fixes (#9120) (@manzoorwanijk)
25+
26+
### Dependencies
27+
28+
- [`cc9a4de`](https://github.com/npm/cli/commit/cc9a4de0a9552f7942dcaa3d72e7a2c7163e3b31) [#9130](https://github.com/npm/cli/pull/9130) hoist production @sigstore dependencies
29+
30+
### Chores
31+
32+
- [`e5c1309`](https://github.com/npm/cli/commit/e5c1309693f9a94044be87d7642b0327a8f27569) [#9130](https://github.com/npm/cli/pull/9130) dev dependency updates (@wraithgar)
33+
- [workspace](https://github.com/npm/cli/releases/tag/arborist-v8.0.4): `@npmcli/arborist@8.0.4`
34+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmdiff-v7.0.4): `libnpmdiff@7.0.4`
35+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmexec-v9.0.4): `libnpmexec@9.0.4`
36+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmfund-v6.0.4): `libnpmfund@6.0.4`
37+
- [workspace](https://github.com/npm/cli/releases/tag/libnpmpack-v8.0.4): `libnpmpack@8.0.4`
38+
1239
## [10.9.6](https://github.com/npm/cli/compare/v10.9.5...v10.9.6) (2026-03-10)
1340

1441
### Bug Fixes

content/cli/v11/commands/npm-audit.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,14 @@ $ npm audit signatures
6767

6868
The `audit signatures` command will also verify the provenance attestations of downloaded packages. Because provenance attestations are such a new feature, security features may be added to (or changed in) the attestation format over time. To ensure that you're always able to verify attestation signatures check that you're running the latest version of the npm CLI. Please note this often means updating npm beyond the version that ships with Node.js.
6969

70+
To include the full sigstore attestation bundles in JSON output, use:
71+
72+
```bash
73+
$ npm audit signatures --json --include-attestations
74+
```
75+
76+
This adds a `verified` array to the JSON output containing the attestation bundles (DSSE envelopes, verification material, and transparency log entries) for each verified package.
77+
7078
The npm CLI supports registry signatures and signing keys provided by any registry if the following conventions are followed:
7179

7280
1. Signatures are provided in the package's `packument` in each published version within the `dist` object:
@@ -325,6 +333,13 @@ If true, npm does not run scripts specified in package.json files.
325333

326334
Note that commands explicitly intended to run a particular script, such as `npm start`, `npm stop`, `npm restart`, `npm test`, and `npm run` will still run their intended script if `ignore-scripts` is set, but they will _not_ run any pre- or post-scripts.
327335

336+
#### `include-attestations`
337+
338+
- Default: false
339+
- Type: Boolean
340+
341+
When used with `npm audit signatures --json`, includes the full sigstore attestation bundles in the JSON output for each verified package. The bundles contain DSSE envelopes, verification material, and transparency log entries.
342+
328343
#### `workspace`
329344

330345
- Default:

content/cli/v11/commands/npm-install-test.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -217,6 +217,8 @@ This flag is a complement to `before`, which accepts an exact date instead of a
217217

218218
This config cannot be used with: `before`
219219

220+
This value is not exported to the environment for child processes.
221+
220222
#### `bin-links`
221223

222224
- Default: true

content/cli/v11/commands/npm-install.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -521,6 +521,8 @@ This flag is a complement to `before`, which accepts an exact date instead of a
521521
522522
This config cannot be used with: `before`
523523
524+
This value is not exported to the environment for child processes.
525+
524526
#### `bin-links`
525527
526528
- Default: true

content/cli/v11/commands/npm-ls.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
5252
Positional arguments are `name@version-range` identifiers, which will limit the results to only the paths to the packages named. Note that nested packages will _also_ show the paths to the specified packages. For example, running `npm ls promzard` in npm's source tree will show:
5353

5454
```bash
55-
npm@11.11.1 /path/to/npm
55+
npm@11.13.0 /path/to/npm
5656
└─┬ init-package-json@0.0.4
5757
└── promzard@0.1.5
5858
```

content/cli/v11/commands/npm-outdated.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -173,6 +173,8 @@ This flag is a complement to `before`, which accepts an exact date instead of a
173173

174174
This config cannot be used with: `before`
175175

176+
This value is not exported to the environment for child processes.
177+
176178
### See Also
177179

178180
- [package spec](/cli/v11/using-npm/package-spec)

content/cli/v11/commands/npm-publish.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,8 @@ A `package` is interpreted the same way as other commands (like `npm install`) a
8383
- f) a `<name>` that has a "latest" tag satisfying (e)
8484
- g) a `<git remote url>` that resolves to (a)
8585

86+
If either (a) or (b) is specified as a relative path, it should begin with an explicit `./` prefix.
87+
8688
The publish will fail if the package name and version combination already exists in the specified registry.
8789

8890
Once a package is published with a given name and version, that specific name and version combination can never be used again, even if it is removed with [`npm unpublish`](/cli/v11/commands/npm-unpublish).

0 commit comments

Comments
 (0)