fullshield 3.2.1 → 3.2.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 CHANGED
@@ -2,6 +2,12 @@
2
2
 
3
3
  All notable changes to FullShield are documented here.
4
4
 
5
+ ## 3.2.2 — 2026-10-29
6
+
7
+ ### Stored response
8
+
9
+ - Phase 566: with `FULLSHIELD_EXPERIMENTAL_SAST_PARITY` already on, a same-file `req.body` binding later passed to `res.send` or `res.end` is a medium, low-confidence finding. Encoded output, Prisma `$queryRaw`, tRPC `input`, Nest `@Body()`, and `req.params.id` are not. No new command or flag.
10
+
5
11
  ## 3.2.1 — 2026-10-29
6
12
 
7
13
  ### SAST parity
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # FullShield
2
2
 
3
- **v3.2.1.** 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`.
3
+ **v3.2.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.2.1 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. 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.
13
+ 3.2.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. 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.2.1 --version
19
+ npx fullshield@3.2.2 --version
20
20
  ```
21
21
 
22
- Package page: [npmjs.com/package/fullshield](https://www.npmjs.com/package/fullshield). Release tag: [v3.2.1](https://github.com/kathanp/fullshield/releases/tag/v3.2.1). 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.
22
+ Package page: [npmjs.com/package/fullshield](https://www.npmjs.com/package/fullshield). Release tag: [v3.2.2](https://github.com/kathanp/fullshield/releases/tag/v3.2.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.2.1'
31
+ version: '3.2.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.
@@ -263,7 +263,7 @@ app.use(shieldGuard({ mode: 'monitor', authRoutes: ['/login'] }));
263
263
  | `agent` | **Experimental** remediation agent (`FULLSHIELD_EXPERIMENTAL_AGENT=1`). Mock/localhost GitHub API + local git remote only — never a real network. Never merges, never pushes to `main`/`master`. `--max-prs` (default 3). |
264
264
  | `scan --changed` / `--since` | **Experimental** incremental scan (`FULLSHIELD_EXPERIMENTAL_PLATFORM=1`). |
265
265
  | `scan --diff` | **Experimental** (`FULLSHIELD_EXPERIMENTAL_DIFFSCAN=1` or `--experimental-diffscan`). Scans git-changed JS/TS files, the files they import by a relative literal, and the files that import them the same way. One hop. A sink in an unchanged importer still reports when the changed file returns the request value. A git failure is `FS-E018` and does not scan the rest of the tree. Off, or `scan` without `--diff`, matches today's scan. `init --recommended` writes `.github/workflows/fullshield-diff.yml`, which sets `FULLSHIELD_EXPERIMENTAL_DIFFSCAN=1` and runs `scan --diff`. |
266
- | `scan --counts` / `fix --finding` | **Experimental** (`FULLSHIELD_EXPERIMENTAL_SAST_PARITY=1`). `--counts` prints severity × reachability totals and never a letter grade. `fullshield.rules.yml` is a local list of `schema: 1` rules (`pattern`, `message`, `severity`). Patterns are literal substrings and are never downloaded. `fix --finding ruleId:file:line` writes one safe fix and does not run project tests. The HTML report lists a `source` and `sink` only when a taint trace already has both. |
266
+ | `scan --counts` / `fix --finding` | **Experimental** (`FULLSHIELD_EXPERIMENTAL_SAST_PARITY=1`). `--counts` prints severity × reachability totals and never a letter grade. `fullshield.rules.yml` is a local list of `schema: 1` rules (`pattern`, `message`, `severity`). Patterns are literal substrings and are never downloaded. `fix --finding ruleId:file:line` writes one safe fix and does not run project tests. The HTML report lists a `source` and `sink` only when a taint trace already has both. The same flag reports a same-file `req.body` value later passed to `res.send` or `res.end` as medium and low confidence. `encodeURIComponent`, `prisma.$queryRaw`, `publicProcedure.input`, and `@Body()` are not that finding. `req.params.id` is not an IDOR finding and does not fail the default high gate. |
267
267
  | `bumps plan` / `bumps open` | **Experimental** (`FULLSHIELD_EXPERIMENTAL_BUMP_PR=1`). Ranks reachable high and critical `DEPS-VULN-001` bumps from a local `scan --json` file (`--from`). One pull request covers one package name and target (`clears` counts the findings). Plan JSON includes `skippedNotImported` and static `installScripts` (never executed). With `FULLSHIELD_EXPERIMENTAL_PROVENANCE=1`, a local cache entry that lacks `dist.attestations` is `provenanceBlocked` and is not opened. `open` runs `gh pr create` and never merges. `templates/fullshield-bumps.yml` is a nightly copy-in workflow. |
268
268
  | License policy | **Experimental** (`FULLSHIELD_EXPERIMENTAL_LICENSE_POLICY=1`). `deps.licenseDeny` and `deps.licenseAllow` match the installed direct dependency `license` string. `DEPS-LICENSE-002` is a license policy, not a vulnerability. A missing license stays silent. |
269
269
  | Private registry | **Experimental** (`FULLSHIELD_EXPERIMENTAL_PRIVATE_REG=1`). `deps.registry` must be https with no userinfo. The host is not contacted and is not added to the allowlist. Org advisories are read from `<cacheDir>/org-advisories.json` (`DEPS-ORG-ADV-001`), at most 1000000 bytes. |