fullshield 3.4.1 → 3.4.2
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/CHANGELOG.md +6 -0
- package/README.md +5 -5
- package/models/index.json +1 -1
- package/package.json +1 -1
- package/templates/action/action.yml +1 -1
- package/templates/fullshield-bumps.yml +2 -2
- package/templates/github-workflow-action.yml +1 -1
- package/templates/github-workflow-diff.yml +1 -1
- package/templates/stranger-check.md +14 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to FullShield are documented here.
|
|
4
4
|
|
|
5
|
+
## 3.4.2 — 2026-10-29
|
|
6
|
+
|
|
7
|
+
### Trust pages
|
|
8
|
+
|
|
9
|
+
- Phase 570: the compatibility page claims only the six existing CI jobs. Package managers and frameworks are not claimed. The npm-audit page states no finding count. The stranger-check template is not a workflow. No company quote. No new command or flag.
|
|
10
|
+
|
|
5
11
|
## 3.4.1 — 2026-10-29
|
|
6
12
|
|
|
7
13
|
### Adoption
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# FullShield
|
|
2
2
|
|
|
3
|
-
**v3.4.
|
|
3
|
+
**v3.4.2.** One install for Node.js/TypeScript backends: detect → classify → report → notify → fix → gate (CI `--fail-on` + runtime monitor). It does not stop attacks by itself. Scan when you want with `npx fullshield scan`, or install an every-2-hours timer with `npx fullshield schedule install`.
|
|
4
4
|
|
|
5
5
|
**Headline: dependency reachability.** A lockfile CVE is not the same as an unused package. FullShield classifies each OSV hit as `reachable` (imported and called), `imported-not-called` (−1), `reachable-via-dependency` (lockfile path from an imported direct dep — **severity kept**, path shown, e.g. `express > body-parser > qs`), `not-imported` (−2, only when no such path exists), or `reachability-unknown` (severity kept) when the lockfile format has no parsed dependency edges. DevDependency-only vulns are `info` with a `dev-only` note unless production sources import the package. Pair it with `fullshield sbom --format cyclonedx`.
|
|
6
6
|
|
|
@@ -10,16 +10,16 @@ npx fullshield scan --json --fail-on high
|
|
|
10
10
|
npx fullshield scan --sarif fullshield.sarif
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
3.4.
|
|
13
|
+
3.4.2 is the version of this tree. Python and other languages are out of scope. `schedule install` writes `fullShieldReport/fullShieldReport_YYYYMMDD_HHMM.md` every 2 hours and keeps 60 reports. `scan` does not create that folder. The stable contract is [docs/stability.md](docs/stability.md). The 1.0.1 release moved values that only experimental flags produce out of Stable. Experimental flags stay off unless you set them. `init --tour`, `init --stack`, and `digest --file` need `FULLSHIELD_EXPERIMENTAL_ADOPT=1`. The tour writes no file. The digest reads a local file and does not fetch. See [docs/security-page.md](docs/security-page.md), [docs/compare.md](docs/compare.md), [docs/compatibility.md](docs/compatibility.md), and [docs/vs-npm-audit.md](docs/vs-npm-audit.md). The compatibility page claims only the six existing CI jobs. Do not treat a scan as a penetration test. Reviewed recall for untouched apps is not published. From `bench/perf-v2.json` (`measured: true`, `label: unreviewed`), the stored Next.js cold p50 is 107.95 seconds — still above the 60-second target (target unmet). Default scans share one AST, run modules in parallel, and use lazy taint. Multi-workspace repos scan each workspace lockfile by default; single-package finding keys stay the same as 2.3.0.
|
|
14
14
|
|
|
15
15
|
## Verify in 60 seconds
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
18
|
# fresh temp / empty cache is enough — no install-guard phones home
|
|
19
|
-
npx fullshield@3.4.
|
|
19
|
+
npx fullshield@3.4.2 --version
|
|
20
20
|
```
|
|
21
21
|
|
|
22
|
-
Package page: [npmjs.com/package/fullshield](https://www.npmjs.com/package/fullshield). Release tag: [v3.4.
|
|
22
|
+
Package page: [npmjs.com/package/fullshield](https://www.npmjs.com/package/fullshield). Release tag: [v3.4.2](https://github.com/kathanp/fullshield/releases/tag/v3.4.2). Publish stages with npm provenance (OIDC). After install, the stranger checks in the build spec (scan / json / sarif / fail-on / fix / init / sbom) are the post-publish gate — no Rekor/sigstore SaaS dependency in the CLI.
|
|
23
23
|
|
|
24
24
|
## GitHub Action
|
|
25
25
|
|
|
@@ -28,7 +28,7 @@ Copy `templates/action/` into your repo (or use `kathanp/fullshield-action` once
|
|
|
28
28
|
```yaml
|
|
29
29
|
- uses: your-org/your-repo/.github/actions/fullshield@<commit-sha>
|
|
30
30
|
with:
|
|
31
|
-
version: '3.4.
|
|
31
|
+
version: '3.4.2'
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
Or run `npx fullshield init --recommended` to write `profile: "recommended"` and a workflow that calls `./templates/action`. The Action runs `fullshield scan`, uploads SARIF, and may cache the baseline. It does not post a pull-request comment, open issues, or phone home.
|
package/models/index.json
CHANGED
package/package.json
CHANGED
|
@@ -9,9 +9,9 @@ jobs:
|
|
|
9
9
|
runs-on: ubuntu-24.04
|
|
10
10
|
steps:
|
|
11
11
|
- uses: actions/checkout@v7
|
|
12
|
-
- run: npx fullshield@3.4.
|
|
12
|
+
- run: npx fullshield@3.4.2 bumps plan --from .fullshield/last-scan.json
|
|
13
13
|
env:
|
|
14
14
|
FULLSHIELD_EXPERIMENTAL_BUMP_PR: '1'
|
|
15
|
-
- run: npx fullshield@3.4.
|
|
15
|
+
- run: npx fullshield@3.4.2 bumps open --from .fullshield/last-scan.json
|
|
16
16
|
env:
|
|
17
17
|
FULLSHIELD_EXPERIMENTAL_BUMP_PR: '1'
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Stranger check
|
|
2
|
+
|
|
3
|
+
Run these steps yourself after a release is on npm. This file is a template. It is not a GitHub workflow and it does not post a status.
|
|
4
|
+
|
|
5
|
+
1. `npx fullshield@<version> --version`
|
|
6
|
+
2. `npx fullshield@<version> scan` on a project you own
|
|
7
|
+
3. `npx fullshield@<version> scan --json`
|
|
8
|
+
4. `npx fullshield@<version> scan --sarif`
|
|
9
|
+
5. `npx fullshield@<version> scan --fail-on high`
|
|
10
|
+
6. `npx fullshield@<version> fix --dry-run`
|
|
11
|
+
7. `npx fullshield@<version> init`
|
|
12
|
+
8. `npx fullshield@<version> sbom`
|
|
13
|
+
|
|
14
|
+
No company quote belongs in this file.
|