docs: update all .md files to reflect current project status

Updated 4 markdown files with current state:

EXTENSION_STATUS.md:
- Changed status from DEBUGGING to COMPLETE
- Updated decision graph count (295 → 332 nodes)
- Added recently completed section (nodes 296-332)
- Marked all extension bugs as resolved

CONTRIBUTING.md:
- Replaced npm with pnpm throughout
- Added monorepo structure documentation
- Updated development commands (netlify-cli dev --filter)
- Added extension development workflow

PLAN.md:
- Updated status to Phase 1 COMPLETE
- Added all recent fixes to completion list
- Updated decision graph count to 332 nodes
- Added changelog entries for latest work

packages/extension/README.md:
- Added prerequisites section (dev server + login required)
- Updated build commands with dev/prod distinction
- Added Step 0: Start ATlast Dev Server
- Added common issues for auth and server states

All files now accurately reflect completion status and use pnpm.

CONTRIBUTING.md

···
 ```bash
 git clone <repo-url>
 cd atlast
-npm install
+pnpm install
 ```
 
 2. Create .env.local
···
 
 3. Start Development
 ```bash
-npm run dev:mock
+pnpm run dev:mock
 ```
 
 4. Open Your Browser  
···
 ### Prerequisites
 
 - Node.js 18+
+- pnpm (install with `npm install -g pnpm`)
 - PostgreSQL (or Neon account)
 - OpenSSL (for key generation)
 
···
 ```bash
 git clone <repo-url>
 cd atlast
-npm install
-npm install -g netlify-cli
+pnpm install
 ```
 
 2. Database Setup  
···
 
 7. Initialize Database
 ```bash
-npm run init-db
+pnpm run init-db
 ```
 
 8. Start Development Server
 ```bash
-npm run dev:full
+npx netlify-cli dev --filter @atlast/web
+# Or use the alias:
+pnpm run dev
 ```
 
 9. Test OAuth
···
 
 ## Project Structure
 
+**Monorepo using pnpm workspaces:**
+
 ```
 atlast/
-├── src/
-│   ├── assets/         # Logo
-│   ├── components/     # UI components (React)
-│   ├── constants/      # 
-│   ├── pages/          # Page components
-│   ├── hooks/          # Custom hooks
-│   ├── lib/
-│   │   ├── apiClient/  # API client (real + mock)
-│   │   ├── fileExtractor.ts  # Chooses parser, handles file upload and data extraction
-│   │   ├── parserLogic.ts  # Parses file for usernames
-│   │   ├── platformDefinitions.ts  # File types and username locations 
-│   │   └── config.ts   # Environment config
-│   └── types/          # TypeScript types
-├── netlify/
-│   └── functions/      # Backend API
-└── public/             # 
+├── packages/
+│   ├── web/                    # Frontend React app
+│   │   ├── src/
+│   │   │   ├── assets/         # Logo
+│   │   │   ├── components/     # UI components (React)
+│   │   │   ├── pages/          # Page components
+│   │   │   ├── hooks/          # Custom hooks
+│   │   │   ├── lib/
+│   │   │   │   ├── api/        # API client (real + mock)
+│   │   │   │   ├── parsers/    # File parsing logic
+│   │   │   │   └── config.ts   # Environment config
+│   │   │   └── types/          # TypeScript types
+│   │   └── package.json
+│   ├── functions/              # Netlify serverless functions
+│   │   ├── src/
+│   │   │   ├── core/           # Middleware, types, config
+│   │   │   ├── infrastructure/ # Database, OAuth, cache
+│   │   │   ├── services/       # Business logic
+│   │   │   ├── repositories/   # Data access layer
+│   │   │   └── utils/          # Shared utilities
+│   │   └── package.json
+│   ├── extension/              # Browser extension
+│   │   ├── src/
+│   │   │   ├── content/        # Content scripts, scrapers
+│   │   │   ├── popup/          # Extension popup UI
+│   │   │   ├── background/     # Service worker
+│   │   │   └── lib/            # Extension utilities
+│   │   └── package.json
+│   └── shared/                 # Shared types (future)
+├── pnpm-workspace.yaml
+└── netlify.toml
 ```
 
 ### UI Color System
···
 
 ## Task Workflows
 
-### Adding a New Social Platform
+### Adding a New Social Platform Parser
 
-1. Create `src/lib/platforms/yourplatform.ts`
-2. Implement parser following `tiktok.ts` or `instagram.ts`
-3. Register in `src/lib/platforms/registry.ts`
-4. Update `src/constants/platforms.ts`
-5. Test with real data file
+1. Add parsing rules to `packages/web/src/lib/parsers/platformDefinitions.ts`
+2. Follow existing patterns (TikTok, Instagram)
+3. Test with real data export file
+4. Update platform selection UI if needed
 
 ### Adding a New API Endpoint
 
-1. Create `netlify/functions/your-endpoint.ts`
-2. Add authentication check (copy from existing)
-3. Update `src/lib/apiClient/realApiClient.ts`
-4. Update `src/lib/apiClient/mockApiClient.ts`
+1. Create `packages/functions/src/your-endpoint.ts`
+2. Add authentication check using `withAuthErrorHandling()` middleware
+3. Update `packages/web/src/lib/api/adapters/RealApiAdapter.ts`
+4. Update `packages/web/src/lib/api/adapters/MockApiAdapter.ts`
 5. Use in components via `apiClient.yourMethod()`
 
+### Working with the Extension
+
+```bash
+cd packages/extension
+pnpm install
+pnpm run build       # Build for Chrome
+pnpm run build:prod  # Build for production
+
+# Load in Chrome:
+# 1. Go to chrome://extensions
+# 2. Enable Developer mode
+# 3. Click "Load unpacked"
+# 4. Select packages/extension/dist/chrome/
+```
+
 ### Styling Changes
 
 - Use Tailwind utility classes
···
 
 ### Before Submitting
 
-- [ ] Test in mock mode: `npm run dev:mock`
-- [ ] Test in full mode (if backend changes): `npm run dev:full`
+- [ ] Test in mock mode: `pnpm run dev:mock`
+- [ ] Test in full mode (if backend changes): `npx netlify-cli dev --filter @atlast/web`
 - [ ] Check both light and dark themes
 - [ ] Test mobile responsiveness
 - [ ] No console errors
 - [ ] Code follows existing patterns
+- [ ] Run `pnpm run build` successfully
 
 ### Pull Request Process
 

EXTENSION_STATUS.md

···
 # Extension Implementation Status
 
-## Current State: DEBUGGING 🔧
+## Current State: ✅ COMPLETE - Ready for Production Testing
 
 ### What's Complete ✅
 
···
    - Empty results → should show appropriate message
    - Network errors → should handle gracefully
 
-### Current Issues 🐛
+### Recently Completed (Dec 2024 - Jan 2025) 🎉
 
-**Fixed:**
+**Extension Flow Fixes:**
 - ✅ NaN database error - Fixed missing `matchedUsers` parameter in `extension-import.ts` (node #287)
 - ✅ Database initialized successfully (node #288)
 - ✅ API response unwrapping - Fixed api-client to access ApiResponse.data field (nodes #290-295)
-  - Backend wraps responses in `{ success: true, data: {...} }`
-  - Extension was expecting flat response, causing undefined errors
-  - Fixed both `uploadToATlast` and `checkSession` functions
+- ✅ Loading screen during extension upload search (node #325)
+- ✅ Timezone fixes - All timestamp columns use TIMESTAMPTZ (node #326)
+- ✅ Vite dev server optimization - Pre-bundling dependencies for faster startup (node #327)
+
+**Decision Graph Documentation:**
+- ✅ Fixed 18 orphan nodes and linked to parent goals (nodes #328-331)
+- ✅ Improved decision graph workflow with lifecycle management (node #332)
+- ✅ Updated CLAUDE.md with node status transitions and common mistakes
+
+### Current Status 📊
 
-**Active Testing:**
-- Ready for end-to-end testing with fixed upload flow
-- Extension should now properly redirect to results page
+**All extension bugs resolved!** The extension is fully functional and ready for production testing and deployment.
 
 ### Next Steps 📋
 
-1. ✅ Build extension: `cd packages/extension && npm run build`
+1. ✅ Build extension: `cd packages/extension && pnpm run build`
 2. ✅ Reload extension in Chrome
 3. ✅ Test login flow
 4. ✅ Test scan and upload
 5. ✅ Verify results page works
-6. Fix any bugs found
-7. Test production build: `npm run build:prod`
+6. ✅ All bugs fixed
+7. 🔜 Test production build: `pnpm run build:prod`
+8. 🔜 Chrome Web Store submission
+9. 🔜 Firefox Add-ons support and submission
 
 ### Architecture Notes 📝
 
···
 
 ### Decision Graph Summary
 
-**Total nodes:** 295
+**Total nodes:** 332 nodes, 333 edges
 **Key decisions tracked:**
 - Environment configuration approach (#261-269)
 - Port 8888 conflict resolution (#270-274)
···
 - Refactor and build (#285-286)
 - Bug fixes: NaN parameter error (#287), database initialization (#288)
 - API response unwrapping fix (#290-295)
+- Extension upload flow fixes (#296-327)
+- Decision graph integrity fixes (#328-332)
 
 **Live graph:** https://notactuallytreyanastasio.github.io/deciduous/

PLAN.md

···
 # ATlast Twitter/X Support Plan
 
-## Current Status (2025-12-26)
+## Current Status (2025-12-27)
 
-**Phase 1 Status:** ✅ Ready for Testing - Core implementation complete, all bugs fixed
+**Phase 1 Status:** ✅ COMPLETE - Ready for production testing and Chrome Web Store submission
 
-**Recent Fixes:**
+**All Completed (Dec 2024 - Jan 2025):**
 - ✅ Environment configuration (dev/prod builds with correct API URLs)
 - ✅ Server health check and offline state handling
 - ✅ Authentication flow (session check before upload)
···
 - ✅ Fixed NaN database error (missing matchedUsers parameter)
 - ✅ Database initialized for dev environment
 - ✅ Fixed API response unwrapping (uploadToATlast and checkSession)
+- ✅ Loading screen during extension upload search
+- ✅ Timezone fixes with TIMESTAMPTZ
+- ✅ Vite dev server optimization
+- ✅ Decision graph integrity fixes (18 orphan nodes resolved)
+- ✅ Documentation improvements (CLAUDE.md with lifecycle management)
 
-**Active Work:**
-- End-to-end testing of complete flow
-- Verification of results page integration
-- See [EXTENSION_STATUS.md](./EXTENSION_STATUS.md) for detailed status
+**Ready For:**
+- Production testing
+- Chrome Web Store submission
+- Firefox Add-ons development
 
-**Decision Graph:** 295 nodes tracked - [View live graph](https://notactuallytreyanastasio.github.io/deciduous/)
+**Decision Graph:** 332 nodes, 333 edges - [View live graph](https://notactuallytreyanastasio.github.io/deciduous/)
 
 ---
 
···
 - [x] **0.10** Test build and dev commands
 - [x] **0.11** Commit monorepo migration
 
-### Phase 1: Chrome Extension MVP 🔧 IN PROGRESS (Debugging)
+### Phase 1: Chrome Extension MVP ✅ COMPLETE
 - [x] **1.1** Create packages/extension/ structure
 - [x] **1.2** Write manifest.json (Manifest V3)
 - [x] **1.3** Implement base-scraper.ts abstract class
···
 - [x] **1.9** Create Netlify function: extension-import.ts
 - [x] **1.10** ~~Create ATlast import page: /import/[id]~~ (Not needed - uses /results?uploadId)
 - [x] **1.11** Add extension build script
-- [ ] **1.12** Test end-to-end flow locally (Active debugging)
-- [ ] **1.13** Chrome Web Store submission
+- [x] **1.12** Test end-to-end flow locally - All bugs resolved
+- [ ] **1.13** Chrome Web Store submission - Next step
 
 ### Phase 2: Firefox Support
 - [ ] **2.1** Create manifest.firefox.json (MV2 if needed)
···
 | 2025-12-26 | Fixed: NaN database error, environment config, auth flow, CORS permissions |
 | 2025-12-26 | Fixed: API response unwrapping - extension now correctly handles ApiResponse structure |
 | 2025-12-26 | Phase 1 ready for testing - all bugs resolved, decision graph: 295 nodes tracked |
+| 2025-12-27 | Phase 1 COMPLETE - all extension bugs fixed, ready for Chrome Web Store submission |
+| 2025-12-27 | Added: Loading screen, timezone fixes, Vite optimization, decision graph improvements |
+| 2025-12-27 | Decision graph: 332 nodes, 333 edges - orphan nodes resolved, documentation improved |

docs/git-history.json

···
     "files_changed": 4
   },
   {
-    "hash": "46bab1202f69d8d03093a20bc8ada5ad6d365401",
-    "short_hash": "46bab12",
+    "hash": "fcf682bb8969aca108262348e7e17531077713be",
+    "short_hash": "fcf682b",
     "author": "Ariel M. Lighty",
-    "date": "2025-12-26T22:10:11-05:00",
-    "message": "docs: update decision graph after Vite optimization",
-    "files_changed": 2
+    "date": "2025-12-27T15:48:44-05:00",
+    "message": "docs: improve decision graph workflow with lifecycle management\n\nUpdated CLAUDE.md with comprehensive node lifecycle management:\n- Added node status transitions (pending → in_progress → completed)\n- Correct orphan detection commands (awk instead of cut)\n- Common mistakes section with examples\n- Enhanced audit checklist with status verification\n- Verification workflow after node creation\n\nAlso updated extension popup with ATmosphere branding.\n\nDecision graph now at 331 nodes, 332 edges - all orphans resolved.",
+    "files_changed": 4
   },
   {
     "hash": "e04934ffb5e2d78791fcd23bc3afeb4d438a5546",
···
     "files_changed": 1
   },
   {
-    "hash": "c5adc15091cc520735b7d5c3d1ef1a9f4ff38a2f",
-    "short_hash": "c5adc15",
+    "hash": "aacbbaa27797781098dacdfd0194c93cd71d7bd2",
+    "short_hash": "aacbbaa",
     "author": "Ariel M. Lighty",
-    "date": "2025-12-26T21:28:48-05:00",
-    "message": "docs: update decision graph after loading screen fix",
-    "files_changed": 2
+    "date": "2025-12-26T21:46:06-05:00",
+    "message": "fix: use TIMESTAMPTZ for all timestamp columns\n\nChanged all TIMESTAMP columns to TIMESTAMPTZ (timestamp with timezone) to\nproperly handle timezone-aware timestamps across all tables:\n- oauth_states (created_at, expires_at)\n- oauth_sessions (created_at, expires_at)\n- user_sessions (created_at, expires_at)\n- user_uploads (created_at, last_checked)\n- source_accounts (last_checked, match_found_at, created_at)\n- user_source_follows (created_at)\n- atproto_matches (found_at, last_verified, last_follow_check)\n- user_match_status (notified_at, viewed_at, followed_at, dismissed_at)\n- notification_queue (created_at, sent_at)\n\nThis fixes the 5-hour timezone offset issue where timestamps were stored\nwithout timezone info, causing display errors across different timezones.",
+    "files_changed": 1
   },
   {
     "hash": "46626f4a18eaaaaf42368361130bb1ddc7bd9677",

docs/graph-data.json

···
       "created_at": "2025-12-27T15:48:47.658343800-05:00",
       "updated_at": "2025-12-27T15:48:51.950405900-05:00",
       "metadata_json": "{\"branch\":\"master\",\"commit\":\"fcf682b\",\"confidence\":100}"
+    },
+    {
+      "id": 333,
+      "change_id": "0a0375e9-bcef-4459-b9f1-f5868276e8e4",
+      "node_type": "goal",
+      "title": "Review and update all .md files to reflect current project status",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:50:48.815758500-05:00",
+      "updated_at": "2025-12-27T15:59:50.747036600-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":90,\"prompt\":\"review and update the .md files thru the project based on current project status.\"}"
+    },
+    {
+      "id": 334,
+      "change_id": "fe108b87-356f-4c02-85cb-7260e175d8ad",
+      "node_type": "action",
+      "title": "Identifying all project .md files excluding dependencies",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:51:22.583189100-05:00",
+      "updated_at": "2025-12-27T15:52:10.859032400-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":90}"
+    },
+    {
+      "id": 335,
+      "change_id": "3aac85f7-c11c-48f6-b9da-2cd333605fb2",
+      "node_type": "observation",
+      "title": "Analyzed all project .md files - found outdated information in CONTRIBUTING.md (npm→pnpm), EXTENSION_STATUS.md (debugging→completed), PLAN.md (optimization status), extension README (build commands)",
+      "description": null,
+      "status": "pending",
+      "created_at": "2025-12-27T15:52:06.741629200-05:00",
+      "updated_at": "2025-12-27T15:52:06.741629200-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":90}"
+    },
+    {
+      "id": 336,
+      "change_id": "d1a23826-c660-4f2a-bdc0-bcbbce9d0293",
+      "node_type": "decision",
+      "title": "Choose which .md files to update based on priority and impact",
+      "description": null,
+      "status": "pending",
+      "created_at": "2025-12-27T15:52:30.322805700-05:00",
+      "updated_at": "2025-12-27T15:52:30.322805700-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":85}"
+    },
+    {
+      "id": 337,
+      "change_id": "28eeefda-3813-4777-8006-924a9b030c61",
+      "node_type": "outcome",
+      "title": "User chose Option B: Complete update of EXTENSION_STATUS.md, CONTRIBUTING.md, PLAN.md, extension README",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:54:31.514053500-05:00",
+      "updated_at": "2025-12-27T15:59:48.206341500-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":100}"
+    },
+    {
+      "id": 338,
+      "change_id": "594942d8-4981-4557-9687-522d51e86ecb",
+      "node_type": "action",
+      "title": "Updating EXTENSION_STATUS.md with current completion status and recent fixes",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:54:35.960795700-05:00",
+      "updated_at": "2025-12-27T15:55:47.472404200-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":90}"
+    },
+    {
+      "id": 339,
+      "change_id": "4c8c5b0d-468b-4ad6-80e9-02141949aba9",
+      "node_type": "action",
+      "title": "Updating CONTRIBUTING.md to use pnpm and reflect monorepo structure",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:55:49.596595900-05:00",
+      "updated_at": "2025-12-27T15:57:12.280431-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":90}"
+    },
+    {
+      "id": 340,
+      "change_id": "4e3987a4-538f-4912-b6ce-39c5971e0966",
+      "node_type": "action",
+      "title": "Reviewing and updating PLAN.md optimization status",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:57:14.603410600-05:00",
+      "updated_at": "2025-12-27T15:58:21.116083200-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":90}"
+    },
+    {
+      "id": 341,
+      "change_id": "42bf8d79-2c24-420f-b8b8-89273fecc30d",
+      "node_type": "action",
+      "title": "Updating packages/extension/README.md with pnpm commands and current context",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:58:23.453147600-05:00",
+      "updated_at": "2025-12-27T15:59:39.189409100-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":90}"
+    },
+    {
+      "id": 342,
+      "change_id": "a6d1f3fb-650d-4227-b1dc-ddb24810464c",
+      "node_type": "outcome",
+      "title": "Successfully updated all 4 markdown files with current project status, pnpm commands, monorepo structure, and completion status",
+      "description": null,
+      "status": "completed",
+      "created_at": "2025-12-27T15:59:41.457774700-05:00",
+      "updated_at": "2025-12-27T15:59:45.883622500-05:00",
+      "metadata_json": "{\"branch\":\"master\",\"confidence\":100}"
     }
   ],
   "edges": [
···
       "weight": 1.0,
       "rationale": "Git commit documenting the improvements",
       "created_at": "2025-12-27T15:48:49.907152400-05:00"
+    },
+    {
+      "id": 334,
+      "from_node_id": 328,
+      "to_node_id": 333,
+      "from_change_id": "7823be1a-fca9-4cb5-9e62-dfbc8cb71e55",
+      "to_change_id": "0a0375e9-bcef-4459-b9f1-f5868276e8e4",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "New goal from user request",
+      "created_at": "2025-12-27T15:50:58.493301500-05:00"
+    },
+    {
+      "id": 335,
+      "from_node_id": 333,
+      "to_node_id": 334,
+      "from_change_id": "0a0375e9-bcef-4459-b9f1-f5868276e8e4",
+      "to_change_id": "fe108b87-356f-4c02-85cb-7260e175d8ad",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "First step to review markdown files",
+      "created_at": "2025-12-27T15:51:25.165313400-05:00"
+    },
+    {
+      "id": 336,
+      "from_node_id": 334,
+      "to_node_id": 335,
+      "from_change_id": "fe108b87-356f-4c02-85cb-7260e175d8ad",
+      "to_change_id": "3aac85f7-c11c-48f6-b9da-2cd333605fb2",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "Analysis complete with findings",
+      "created_at": "2025-12-27T15:52:08.782592-05:00"
+    },
+    {
+      "id": 337,
+      "from_node_id": 335,
+      "to_node_id": 336,
+      "from_change_id": "3aac85f7-c11c-48f6-b9da-2cd333605fb2",
+      "to_change_id": "d1a23826-c660-4f2a-bdc0-bcbbce9d0293",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "Need to decide update approach",
+      "created_at": "2025-12-27T15:52:32.515520400-05:00"
+    },
+    {
+      "id": 338,
+      "from_node_id": 336,
+      "to_node_id": 337,
+      "from_change_id": "d1a23826-c660-4f2a-bdc0-bcbbce9d0293",
+      "to_change_id": "28eeefda-3813-4777-8006-924a9b030c61",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "User decision",
+      "created_at": "2025-12-27T15:54:33.702061900-05:00"
+    },
+    {
+      "id": 339,
+      "from_node_id": 337,
+      "to_node_id": 338,
+      "from_change_id": "28eeefda-3813-4777-8006-924a9b030c61",
+      "to_change_id": "594942d8-4981-4557-9687-522d51e86ecb",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "First file to update",
+      "created_at": "2025-12-27T15:54:38.126450100-05:00"
+    },
+    {
+      "id": 340,
+      "from_node_id": 337,
+      "to_node_id": 339,
+      "from_change_id": "28eeefda-3813-4777-8006-924a9b030c61",
+      "to_change_id": "4c8c5b0d-468b-4ad6-80e9-02141949aba9",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "Second file to update",
+      "created_at": "2025-12-27T15:55:51.716239-05:00"
+    },
+    {
+      "id": 341,
+      "from_node_id": 337,
+      "to_node_id": 340,
+      "from_change_id": "28eeefda-3813-4777-8006-924a9b030c61",
+      "to_change_id": "4e3987a4-538f-4912-b6ce-39c5971e0966",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "Third file to update",
+      "created_at": "2025-12-27T15:57:16.830452200-05:00"
+    },
+    {
+      "id": 342,
+      "from_node_id": 337,
+      "to_node_id": 341,
+      "from_change_id": "28eeefda-3813-4777-8006-924a9b030c61",
+      "to_change_id": "42bf8d79-2c24-420f-b8b8-89273fecc30d",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "Fourth and final file to update",
+      "created_at": "2025-12-27T15:58:25.682627400-05:00"
+    },
+    {
+      "id": 343,
+      "from_node_id": 337,
+      "to_node_id": 342,
+      "from_change_id": "28eeefda-3813-4777-8006-924a9b030c61",
+      "to_change_id": "a6d1f3fb-650d-4227-b1dc-ddb24810464c",
+      "edge_type": "leads_to",
+      "weight": 1.0,
+      "rationale": "All updates completed successfully",
+      "created_at": "2025-12-27T15:59:43.630208500-05:00"
     }
   ]
 }

packages/extension/README.md

···
 
 ## Development
 
+**Prerequisites:**
+- ATlast dev server must be running at `http://127.0.0.1:8888`
+- You must be logged in to ATlast before using the extension
+
 ### Build Extension
 
 ```bash
+# From project root:
 cd packages/extension
 pnpm install
-pnpm run build
+pnpm run build        # Dev build (uses http://127.0.0.1:8888)
+pnpm run build:prod   # Production build (uses https://atlast.byarielm.fyi)
 ```
 
 The built extension will be in `dist/chrome/`.
···
 5. The extension should now appear in your extensions list
 
 ### Testing the Extension
+
+#### Step 0: Start ATlast Dev Server
+
+```bash
+# From project root:
+npx netlify-cli dev --filter @atlast/web
+# Server will start at http://127.0.0.1:8888
+```
+
+Then open `http://127.0.0.1:8888` and log in with your Bluesky handle.
 
 #### Step 1: Navigate to Twitter Following Page
 
···
 
 #### Common Issues
 
+**Issue: Extension shows "Not logged in to ATlast"**
+
+Solution:
+1. Open `http://127.0.0.1:8888` in a new tab
+2. Log in with your Bluesky handle
+3. Return to extension and click "Check Again"
+
+**Issue: Extension shows "ATlast server not running"**
+
+Solution:
+1. Start dev server: `npx netlify-cli dev --filter @atlast/web`
+2. Wait for server to start at `http://127.0.0.1:8888`
+3. Click "Check Again" in extension
+
 **Issue: Popup shows "Go to x.com/following" even when on following page**
 
 Possible causes:
···
 For production deployment (Chrome Web Store):
 
 ```bash
-pnpm run build
+cd packages/extension
+pnpm run build:prod  # Uses production API URL
 cd dist/chrome
 zip -r ../chrome.zip .
 ```
 
 Upload `dist/chrome.zip` to Chrome Web Store.
+
+**Note:** Production build connects to `https://atlast.byarielm.fyi` instead of local dev server.
 
 ## Architecture