chore(docs): harden CI supply chain + update deps (#401)

chore(docs): harden CI supply chain + update deps (#378)

Author: vishr

.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+updates:
+  # Astro docs site (site/). Group everything into a single weekly PR so the
+  # advisory stream is one reviewed change, not nonstop noise. No auto-merge —
+  # updates are deliberate (see the supply-chain hardening discussion in #378).
+  - package-ecosystem: npm
+    directory: /site
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+    groups:
+      site-dependencies:
+        patterns:
+          - "*"
+
+  # Keep the GitHub Actions used by the deploy workflow current.
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      github-actions:
+        patterns:
+          - "*"

.github/workflows/deploy.yaml

@@ -15,6 +15,10 @@ jobs:
   deploy:
     name: Deploy to GitHub Pages
     runs-on: ubuntu-latest
+    # Least privilege: the build only needs to push the gh-pages branch. Limits
+    # blast radius if a build-time dependency is ever compromised.
+    permissions:
+      contents: write
     steps:
       - uses: actions/checkout@v5
       - uses: actions/setup-node@v6
@@ -23,8 +27,11 @@ jobs:
           cache: npm
           cache-dependency-path: site/package-lock.json
 
+      # --ignore-scripts blocks install/postinstall (and binding.gyp/node-gyp)
+      # supply-chain vectors — see npm worm advisories (Shai-Hulud). The build
+      # works without lifecycle scripts (sharp ships prebuilt binaries).
       - name: Install dependencies
-        run: npm ci
+        run: npm ci --ignore-scripts
         working-directory: site
       - name: Build website
         run: npm run build

site/package-lock.json

@@ -9,8 +9,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/starlight": "0.40.0",
-    "astro": "6.4.6",
-    "sharp": "0.35.1"
+    "@astrojs/starlight": "^0.40.0",
+    "astro": "^6.4.7",
+    "sharp": "^0.35.1"
   }
 }