chore: restructuring before push

.gitignore

···
+.cursor/
+
 # Dependencies
 node_modules/
 

README.md

···
-# Bluesky to Leaflet.pub Reply Synchronization
+## ATProto Experiments
 
-A real-time service that monitors Bluesky posts linking to leaflet.pub and synchronizes replies as comments.
+A monorepo of AT Protocol experiments, managed via Yarn workspaces.
 
-## Overview
+### Packages
 
-This application:
-- Monitors Bluesky Jetstream for real-time post events
-- Tracks Bluesky posts containing leaflet.pub links
-- Detects replies to tracked posts
-- Creates corresponding comments in leaflet.pub via AT Protocol's PDS
-- **Automatically deletes comments when Bluesky replies are deleted** (new!)
+- **[@atproto-experiments/bsky-leaflet-sync](./packages/bsky-leaflet-sync)** — Automatic syncing of Bluesky replies to Leaflet.pub posts as Leaflet.pub comments
 
-## Prerequisites
-
-- Node.js 18 or higher
-- Yarn package manager
-- Bluesky account with app password
-- Leaflet.pub documents published on AT Protocol
-
-## Installation
+### Development
 
 ```bash
-# Install dependencies
+# Install dependencies for all packages
 yarn install
 
-# Build the project
+# Build all packages
 yarn build
-```
-
-## Configuration
-
-Create a `.env` file based on `.env.example`:
-
-```env
-BLUESKY_HANDLE=your.handle.bsky.social
-BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx
-JETSTREAM_URL=wss://jetstream2.us-east.bsky.network
-CURSOR_FILE=data/cursor.json
-LOG_LEVEL=info
-```
-
-### Creating a Bluesky App Password
-
-1. Log in to Bluesky
-2. Go to Settings → App Passwords
-3. Create a new app password
-4. Copy the password (format: `xxxx-xxxx-xxxx-xxxx`)
-5. Add it to your `.env` file
-
-## Usage
-
-```bash
-# Development mode (with auto-reload)
-yarn dev
-
-# Production mode
-yarn build
-yarn start
-```
-
-## How It Works
-
-1. **Startup**: Authenticates with Bluesky and loads saved cursor
-2. **Initial Scan**: Queries leaflet.pub documents with `postRef` to build tracking map
-3. **Real-time Monitoring**: Connects to Jetstream and processes events
-4. **Post Tracking**: Adds new posts with leaflet.pub links to tracking
-5. **Reply Detection**: Detects replies to tracked posts
-6. **Comment Creation**: Creates comments in leaflet.pub with reply text and URL
-7. **Deduplication**: Checks existing comments to prevent duplicates
-8. **Reply Deletion**: Detects when Bluesky replies are deleted and removes corresponding comments
-
-## Architecture
-
-- **Jetstream Client**: WebSocket connection with automatic reconnection
-- **Post Tracker**: In-memory Map for O(1) post lookup
-- **Event Processor**: Filters and routes Jetstream events (creates & deletes)
-- **Comment Checker**: Two-level caching for deduplication
-- **Comment Creator**: Creates PDS records for comments
-- **Comment Deleter**: Removes comments via URL search (no state needed!)
-- **Cursor Manager**: Persists cursor for gapless replay
-
-### Deletion Strategy
 
-**Completely stateless** using [Constellation API](https://constellation.microcosm.blue/)! When a reply is deleted, we:
-1. Query Constellation for each tracked post: "what replies to this post?"
-2. Check if the deleted reply URI is in the backlinks
-3. If found, delete the comment from that specific Leaflet document
-
-**Zero local state** - we query the AT Protocol network graph dynamically via Constellation's real-time index.
-
-See [REPLY_DELETION_TRACKING.md](./REPLY_DELETION_TRACKING.md) for the beautiful details.
-
-## Logging
-
-Logs are written to:
-- Console (colorized for development)
-- `logs/combined.log` (all logs)
-- `logs/error.log` (errors only)
-
-## Troubleshooting
-
-**Authentication fails:**
-- Verify `BLUESKY_HANDLE` is your full handle (e.g., `user.bsky.social`)
-- Ensure `BLUESKY_APP_PASSWORD` is correct
-- Check that app password has required permissions
-
-**No posts tracked:**
-- Verify you have leaflet.pub documents with `postRef` field
-- Check logs for errors during initial scan
-
-**Comments not created:**
-- Ensure replies are to tracked posts
-- Check logs for PDS record creation errors
-- Verify leaflet.pub comment schema is correct
-
-**Connection issues:**
-- Check `JETSTREAM_URL` is correct
-- Verify internet connection
-- Review logs for reconnection attempts
-
-## Development
-
-```bash
 # Clean build artifacts
 yarn clean
 
-# Build project
-yarn build
-
-# Run in development mode
-yarn dev
-```
-
-## Project Structure
-
-```
-src/
-├── index.ts                 # Entry point
-├── app.ts                   # Main application
-├── config.ts                # Configuration
-├── auth.ts                  # Authentication
-├── services/
-│   ├── jetstreamClient.ts   # WebSocket client
-│   ├── postTracker.ts       # Post tracking
-│   ├── eventProcessor.ts    # Event filtering
-│   ├── commentChecker.ts    # Deduplication
-│   ├── commentCreator.ts    # Comment creation
-│   └── commentDeleter.ts    # Comment deletion (stateless!)
-├── utils/
-│   ├── cursorManager.ts     # Cursor persistence
-│   ├── urlParser.ts         # URL utilities
-│   └── logger.ts            # Logging
-└── types/
-    ├── jetstream.ts         # Jetstream types
-    └── lexicons.ts          # Lexicon types
-```
-
-## License
-
-MIT
+# Run specific workspace
+yarn start  # Runs bsky-leaflet-sync
+yarn dev    # Dev mode for bsky-leaflet-sync
 
+# Run command in specific workspace
+yarn workspace @atproto-experiments/bsky-leaflet-sync <command>
+```

package.json

···
 {
   "name": "atproto-experiments",
   "version": "1.0.0",
-  "main": "dist/index.js",
+  "private": true,
   "author": "Kaushik Chakraborty <[e-mail]>",
   "license": "MIT",
+  "workspaces": [
+    "packages/*"
+  ],
   "scripts": {
-    "build": "tsc",
-    "start": "yarn build && node dist/index.js",
-    "dev": "ts-node src/index.ts",
-    "clean": "rm -rf dist"
-  },
-  "dependencies": {
-    "@atproto/api": "^0.17.2",
-    "dotenv": "^17.2.3",
-    "winston": "^3.18.3",
-    "ws": "^8.18.3"
+    "build": "yarn workspaces run build",
+    "clean": "yarn workspaces run clean",
+    "start": "yarn workspace @atproto-experiments/bsky-leaflet-sync start",
+    "dev": "yarn workspace @atproto-experiments/bsky-leaflet-sync dev"
   },
   "devDependencies": {
     "@types/node": "^24.7.2",
-    "@types/ws": "^8.18.1",
-    "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   }
 }

packages/bsky-leaflet-sync/README.md

···
+# @atproto-experiments/bsky-leaflet-sync
+
+Automatic syncing of Bluesky replies to Leaflet.pub posts as Leaflet.pub comments.
+
+## Setup
+
+1. Copy `.env.example` to `.env` and configure:
+   - Bluesky credentials
+   - Leaflet.pub credentials
+
+2. Install dependencies:
+   ```bash
+   yarn install
+   ```
+
+3. Build:
+   ```bash
+   yarn build
+   ```
+
+4. Run:
+   ```bash
+   yarn start
+   ```
+
+## Development
+
+```bash
+# Run in development mode
+yarn dev
+```
+

packages/bsky-leaflet-sync/package.json

···
+{
+  "name": "@atproto-experiments/bsky-leaflet-sync",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "yarn build && node dist/index.js",
+    "dev": "ts-node index.ts",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@atproto/api": "^0.17.2",
+    "dotenv": "^17.2.3",
+    "winston": "^3.18.3",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1",
+    "ts-node": "^10.9.2"
+  }
+}
+

packages/bsky-leaflet-sync/tsconfig.json

···
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "."
+  },
+  "include": ["./**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+

tsconfig.json

···
     "target": "ES2022",
     "module": "commonjs",
     "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,
···
     "declaration": true,
     "declarationMap": true,
     "sourceMap": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+  }
 }