Initial commit: LinkSyncServer and LinkSyncExtension projects with complete documentation, models, API endpoints, tests, and extension implementation

This commit is contained in:
DavidSaylor
2026-05-11 17:37:10 -05:00
parent ad0b12b452
commit aed69afdfd
691 changed files with 181874 additions and 28 deletions

103
LinkSyncExtension/TODOs.txt Normal file
View File

@@ -0,0 +1,103 @@
# LinkSyncExtension - Task List
## Project Setup
- [x] Create project directory structure
- [x] Write README.md
- [ ] Write TODOs.txt (in progress)
- [ ] Write design.md
- [ ] Write tasks.md
- [ ] Write AGENTS.md
## Core Development
### Extension Manifest
- [ ] Create manifest.json (MVP)
- [ ] Add icon files
- [ ] Configure permissions
- [ ] Set browser ID
### Background Script
- [ ] Create background.js service worker
- [ ] Implement sync logic
- [ ] Handle sync mode switching
- [ ] Manage collection mapping
- [ ] Auto-sync timer
- [ ] Error handling
### Popup Script
- [ ] Create popup.html
- [ ] Create popup.css
- [ ] Create popup.js
- [ ] Bookmark form UI
- [ ] Collection list UI
- [ ] Settings UI
- [ ] Search UI
### Utility Modules
- [ ] utils/bookmark.js - Bookmark manipulation
- [ ] utils/collection.js - Collection management
- [ ] utils/query-engine.js - Query parsing/execution
- [ ] utils/sync.js - Sync logic
### Content Script (Optional)
- [ ] content/content.js - Read page data
- [ ] Extract title/description
- [ ] Handle URL detection
- [ ] Inject into popup
### API Integration
- [ ] /api/auth/login/ - Authentication
- [ ] /api/links/ - Bookmark CRUD
- [ ] /api/collections/ - Collection CRUD
- [ ] /api/queries/execute/ - Query execution
- [ ] /api/sync/ - Sync endpoint
### Sync Logic
- [ ] Implement bi-directional sync
- [ ] Implement browser-authoritative sync
- [ ] Implement server-authoritative sync
- [ ] Handle deletions checkbox
- [ ] Conflict detection
- [ ] Conflict resolution UI
### UI Components
- [ ] Bookmark list view
- [ ] Collection builder UI
- [ ] Query editor
- [ ] Search interface
- [ ] Sync status indicator
- [ ] Conflict resolution modal
### Storage Management
- [ ] Store API key securely
- [ ] Store collection mapping
- [ ] Store sync settings
- [ ] Sync timestamp tracking
- [ ] Pending changes tracking
## Security
- [ ] Encrypted storage
- [ ] API key validation
- [ ] HTTPS enforcement checks
- [ ] CORS validation
- [ ] Input sanitization
## Testing
- [ ] Test sync modes
- [ ] Test conflict resolution
- [ ] Test query execution
- [ ] Test offline handling
- [ ] Test error handling
## Documentation
- [ ] API reference
- [ ] User guide
- [ ] Troubleshooting guide
- [ ] Query syntax guide
## Future Enhancements
- [ ] Background sync notifications
- [ ] Auto-sync scheduler
- [ ] Keyboard shortcuts
- [ ] Gesture controls
- [ ] Mobile companion app