feat: add Jest tests and migrate to pnpm

.github/workflows/scrape-feeds.yml

@@ -20,14 +20,19 @@ jobs:
         with:
           token: ${{ github.token }}
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
       - name: Setup Node.js
         uses: actions/setup-node@v3
         with:
           node-version: '20'
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install
 
       - name: Run scraper
         env:

AGENTS.md

@@ -94,12 +94,12 @@ Update the `ACCESS_TOKEN_HASH` constant in `public/index.html` with the output.
    ```bash
    cp .env.example .env
    # Edit .env and add your actual API keys
-   npm install
+   pnpm install
    ```
 
 2. **Run locally**:
    ```bash
-   npm start
+   pnpm start
    # Server runs on http://localhost:3000
    # Access the frontend and test API endpoints
    ```
@@ -116,7 +116,7 @@ Update the `ACCESS_TOKEN_HASH` constant in `public/index.html` with the output.
 
 2. **Test locally** first:
    ```bash
-   npm start
+   pnpm start
    node src/scraper-cli.js
    ```
 
@@ -261,7 +261,7 @@ schedule:
 
 Before pushing changes:
 
-- [ ] Run `npm start` and verify server starts
+- [ ] Run `pnpm start` and verify server starts
 - [ ] Visit `http://localhost:3000` and verify feed loads
 - [ ] Test access token gate (clear localStorage and reload)
 - [ ] Test all source filters (Twitter, Reddit, GitHub)
@@ -284,7 +284,7 @@ Currently no automated tests. To add:
 3. Write unit tests for scrapers
 4. Write integration tests for feed aggregation
 5. Add to `package.json`: `"test": "jest"`
-6. Run `npm test` before commits
+6. Run `pnpm test` before commits
 
 ## Common Issues & Solutions
 
@@ -351,7 +351,7 @@ When deploying to a new environment:
 5. Check for security alerts (Dependabot)
 
 **Monthly maintenance**:
-1. Update dependencies: `npm update`
+1. Update dependencies: `pnpm update`
 2. Review and clean old feed data if growing large
 3. Audit access logs if needed
 4. Rotate access tokens if compromised

CONTRIBUTING.md

@@ -23,7 +23,7 @@ Thank you for your interest in contributing! This project is open source and we
    ```bash
    cp .env.example .env
    # Add your API keys to .env
-   npm install
+   pnpm install
    ```
 4. **Create a branch:**
    ```bash
@@ -36,10 +36,10 @@ Thank you for your interest in contributing! This project is open source and we
 
 ```bash
 # Run the local server
-npm start
+pnpm start
 
 # Test the scraper
-npm run scrape
+pnpm run scrape
 
 # Check the output
 cat docs/data/feed.json
@@ -56,8 +56,8 @@ cat docs/data/feed.json
 
 Before submitting:
 
-1. **Test locally** - Run `npm start` and verify everything works
-2. **Test scraping** - Run `npm run scrape` and check output
+1. **Test locally** - Run `pnpm start` and verify everything works
+2. **Test scraping** - Run `pnpm run scrape` and check output
 3. **Check for secrets** - Run `git diff` and ensure no API keys are included
 4. **Verify the frontend** - Open http://localhost:3000 and test the UI
 
@@ -161,7 +161,7 @@ Want to add a new social platform? Here's how:
 - Verify token names match `.env.example`
 
 ### "Cannot find module"
-- Run `npm install` to ensure all dependencies are installed
+- Run `pnpm install` to ensure all dependencies are installed
 - Check Node.js version (requires 18+)
 
 ### "GitHub Actions Failing"

README.md

@@ -18,9 +18,9 @@ A private social media feed aggregator for tracking mentions across Twitter, Red
 ### Local Development
 
 ```bash
-npm install
+pnpm install
 cp .env.example .env  # Add your API tokens
-npm start             # Visit http://localhost:3000
+pnpm start             # Visit http://localhost:3000
 ```
 
 ### GitHub Pages Deployment