supply-chain-threat-awareness

name	supply-chain-threat-awareness
description	Supply chain threat posture assessment for projects and packages. Use when reviewing a project's .github/workflows/*.yml, package.json, pyproject.toml, requirements.txt, pixi.toml, or lockfiles for exposure to active 2025–2026 campaigns. Covers Shai-Hulud (500+ npm packages), TeamPCP (Trivy, Checkmarx, LiteLLM, Bitwarden CLI, SAP CAP via tag hijacking), axios (100M weekly downloads), and LiteLLM .pth persistence — all attack patterns CVE scanners miss.
metadata	{"references":["references/campaigns/shai-hulud.md","references/campaigns/teampcp.md","references/campaigns/axios.md","references/campaigns/litellm-pth.md","references/posture-report-template.md"]}

Supply Chain Threat Awareness

Threat Model

Maintainer account takeover and release-tag hijacking of widely-trusted packages are the dominant supply-chain threats in 2025–2026.

CVE Scanner Limitations

Treat scanner-clean as necessary, not sufficient — the audit below covers what advisories miss.

Active Campaigns

Each campaign has a deep-dive reference. Load on demand based on which applies to the project under review.

• Shai-Hulud — 500+ npm packages compromised via maintainer account takeover. → references/campaigns/shai-hulud.md
• TeamPCP — Trivy, Checkmarx, LiteLLM, Bitwarden CLI, SAP CAP via release-tag hijacking (March 2026). → references/campaigns/teampcp.md
• axios — 100M weekly npm downloads; maintainer account compromise. → references/campaigns/axios.md
• LiteLLM 1.82.8 — Malicious .pth file for persistent Python execution. → references/campaigns/litellm-pth.md

Audit Workflow

Run this assessment in order. Each step has a verifying command. Stop and remediate before continuing if any FAIL is critical (lockfile not committed, no --ignore-scripts, mutable action refs).

Step 1 — Lockfile hygiene

# Check which lockfiles exist and are committed
git ls-files | grep -E '(package-lock\.json|yarn\.lock|pnpm-lock\.yaml|poetry\.lock|uv\.lock|pixi\.lock|conda-lock\.yml|Cargo\.lock|go\.sum)$'

# Check CI uses lockfile-respecting install commands
grep -rnE '(npm ci|yarn install --frozen-lockfile|pnpm install --frozen-lockfile|uv sync --frozen|poetry install|pixi install|cargo build --locked)' .github/workflows/

• Each detected ecosystem has a committed lockfile (verify with git ls-files).
• CI uses the lockfile-respecting install command — not bare npm install or pip install.
• CI caches scoped to the lockfile hash (e.g., key: deps-${{ hashFiles('package-lock.json') }}).

If any FAIL: STOP and fix before continuing — without lockfile hygiene, every other check is moot.

Step 2 — Action pinning

# Find all mutable uses: refs
grep -nE '^\s*-?\s*uses:\s+[^@]+@[^a-f0-9]' .github/workflows/*.yml || echo "All uses: refs SHA-pinned"

• Every uses: ref is a 40-character commit SHA (not @v4, @main, @latest).
• Trailing comment after SHA records the human-readable version (e.g., uses: actions/checkout@<sha> # v4.2.2).

If FAIL: run /supply-chain-pin-actions (dry-run first), then re-verify.

Step 3 — Install-time execution

# Check npm scripts that run on install
test -f package.json && jq '.scripts | {preinstall, install, postinstall} // empty' package.json

# Check for ignore-scripts discipline
grep -rE '(npm ci.*--ignore-scripts|ignore-scripts\s*=\s*true)' .github/workflows/ .npmrc 2>/dev/null || echo "WARN: no --ignore-scripts found"

# Python .pth scan (run only if Python is on PATH)
command -v python >/dev/null && find "$(python -c 'import site; print(site.getsitepackages()[0])' 2>/dev/null)" -name "*.pth" -exec grep -lE '^(import|exec|os\.|subprocess)' {} \; 2>/dev/null

• npm ci --ignore-scripts in every CI install step OR .npmrc has ignore-scripts=true.
• No .pth file in Python site-packages contains executable Python (only path additions).
• preinstall/postinstall scripts in package.json are reviewed (or absent).

If FAIL: see references/campaigns/shai-hulud.md (postinstall vector) or references/campaigns/litellm-pth.md (.pth vector).

Step 4 — Dependency velocity

# Last 10 lockfile updates with timestamps
git log --follow --pretty=format:"%h %ai %s" -10 package-lock.json 2>/dev/null
git log --follow --pretty=format:"%h %ai %s" -10 uv.lock 2>/dev/null
git log --follow --pretty=format:"%h %ai %s" -10 pixi.lock 2>/dev/null

• Lockfile updates spaced ≥7 days apart on average — no rapid-fire adds without cooldown.
• No unexpected version bumps without an explicit PR/changelog entry.

If FAIL: hold new deps ≥7 days before merging (most malicious releases yanked within hours).

Step 5 — SBOM and provenance

# Check release workflow for SBOM/signing steps
grep -rE '(syft|cyclonedx|spdx|cosign|sigstore|--provenance|attest-build-provenance)' .github/workflows/

• SBOM generated for releases (CycloneDX or SPDX).
• Sigstore or npm provenance attestations applied.

If FAIL: see supply-chain-sbom-provenance skill.

Output: Posture Report

When invoked for a posture review, produce the Markdown report defined in references/posture-report-template.md. The template specifies the required tables (campaign applicability, step results, top 3 priority actions) and the finding-entry rules (campaign name, file:line, blast radius, remediation command or skill).