09d30427f4
LinkSyncServer: - Fix app.py imports, add CORS middleware, lifespan events - Create api/routes.py router aggregator - Create config/settings.py for centralized configuration - Rewrite models/base.py with proper relationships and serialization - Rewrite all API endpoints with real DB integration (auth, links, collections, sync, queries, tags) - Add admin endpoints (user management, stats, audit log) - Complete query parser with recursive descent and proper precedence - Complete query executor with set operations and field filters - Set up Alembic migrations with initial schema - Create web interface (templates, CSS, JS) - Add 42 passing tests (auth, links, collections, queries) - Add deploy.ps1 and deploy.sh scripts - Update README with deployment workflow LinkSyncExtension: - Create utils/api.js (REST client with retries, auth, error handling) - Create utils/sync.js (3 sync modes + conflict detection) - Create utils/collection.js (collection management) - Create utils/query-engine.js (client-side query parser) - Rewrite background.js (sync loop, bookmark events, message routing) - Rewrite popup.js (tabs, settings modal, notifications, CRUD) - Update popup.html (tabbed interface, query builder, modal) - Update popup.css (full redesign) - Create content/content.js (page metadata extraction) - Create options.html/js (dedicated settings page) - Generate icons (48x48, 96x96) - Update manifest.json (host permissions, content scripts, options) - Create AGENTS.md
240 lines
6.1 KiB
Markdown
240 lines
6.1 KiB
Markdown
# LinkSyncExtension - Implementation Tasks
|
|
|
|
## Phase 1: Project Setup
|
|
|
|
### Setup Tasks
|
|
- [x] Create project directory structure
|
|
- [x] Write README.md
|
|
- [x] Write TODOs.txt
|
|
- [x] Write design.md
|
|
- [x] Write tasks.md
|
|
- [x] Write AGENTS.md
|
|
|
|
### Initial Files
|
|
- [x] Create manifest.json (v2, Firefox-compatible)
|
|
- [x] Add icon files (48x48, 96x96)
|
|
- [x] Create utils folder with all modules
|
|
- [x] Create content folder for content script
|
|
|
|
## Phase 2: Core Development
|
|
|
|
### Background Script
|
|
- [x] Create background.html
|
|
- [x] Create background.js
|
|
- [x] Implement init() on install/update
|
|
- [x] Implement sync loop with interval (5 min)
|
|
- [x] Add event handlers (message, install, bookmark changes)
|
|
- [x] Implement sync mode switching
|
|
- [x] Add collection mapping logic
|
|
- [x] Implement auto-sync timer
|
|
- [x] Add error handling and retries
|
|
|
|
### Popup Script
|
|
- [x] Create popup.html with tabbed interface
|
|
- [x] Create popup.css with full responsive styling
|
|
- [x] Create popup.js with all functionality
|
|
- [x] Implement bookmark form UI with auto-fill
|
|
- [x] Add bookmark list view with search
|
|
- [x] Add collection panel
|
|
- [x] Implement settings modal
|
|
- [x] Add sync button handler
|
|
- [x] Implement query builder tab
|
|
- [x] Add toast notifications
|
|
|
|
### Utility Modules
|
|
- [x] Create utils/api.js
|
|
- REST API client with Bearer token auth
|
|
- Retry logic (3 attempts with backoff)
|
|
- Timeout handling (10s)
|
|
- Rate limit handling (429)
|
|
- All endpoints: auth, links, collections, queries, sync, admin
|
|
|
|
- [x] Create utils/sync.js
|
|
- Bi-directional sync
|
|
- Browser-authoritative sync
|
|
- Server-authoritative sync
|
|
- Deletions handling
|
|
- Conflict detection
|
|
|
|
- [x] Create utils/collection.js
|
|
- List/create/update/delete collections
|
|
- Add/remove links from collections
|
|
- Execute queries
|
|
- Parse queries
|
|
|
|
- [x] Create utils/query-engine.js
|
|
- Tokenizer for query expressions
|
|
- Recursive descent parser
|
|
- AST generation (TERM, TERM_SET, FIELD, AND, OR, XOR)
|
|
- Query validation
|
|
- Query string builder
|
|
|
|
- [x] Create utils/bookmark.js
|
|
- Parse Firefox bookmark data
|
|
- Format bookmark for API
|
|
- Handle field validation
|
|
- Merge bookmarks for conflict resolution
|
|
- Duplicate detection
|
|
|
|
### Content Script
|
|
- [x] Create content/content.js
|
|
- [x] Implement page title extraction
|
|
- [x] Implement URL detection
|
|
- [x] Implement meta description extraction
|
|
- [x] Implement favicon extraction
|
|
- [x] Handle browser.runtime.onMessage
|
|
|
|
### Options Page
|
|
- [x] Create options.html
|
|
- [x] Create options.js
|
|
- [x] Server URL configuration
|
|
- [x] API key input
|
|
- [x] Sync mode dropdown
|
|
- [x] Deletions checkbox
|
|
- [x] Auto-sync checkbox
|
|
- [x] Test connection button
|
|
- [x] Sync now button
|
|
|
|
## Phase 3: Storage Management
|
|
|
|
### Storage Implementation
|
|
- [x] Use browser.storage.local for all settings
|
|
- [x] Store API key securely
|
|
- [x] Implement storage helper functions
|
|
- [x] Add sync timestamp tracking
|
|
- [x] Add pending changes counter
|
|
- [x] Add syncing state flag
|
|
|
|
### Storage Keys
|
|
- [x] `linksync_server_url` - Server base URL
|
|
- [x] `linksync_api_key` - JWT bearer token
|
|
- [x] `linksync_sync_mode` - Sync mode string
|
|
- [x] `linksync_deletions` - Boolean
|
|
- [x] `linksync_auto_sync` - Boolean
|
|
- [x] `linksync_last_sync` - ISO timestamp
|
|
- [x] `linksync_syncing` - Boolean flag
|
|
- [x] `linksync_pending` - Boolean flag
|
|
|
|
## Phase 4: Sync Logic
|
|
|
|
### Bi-directional Sync
|
|
- [x] Push browser→server (new bookmarks)
|
|
- [x] Push server→browser (new bookmarks)
|
|
- [x] Handle deletions when enabled
|
|
|
|
### Browser Authoritative Sync
|
|
- [x] Push browser→server (create + update)
|
|
- [x] Overwrite server data on conflict
|
|
- [x] Delete server bookmarks not in browser
|
|
|
|
### Server Authoritative Sync
|
|
- [x] Download from server
|
|
- [x] Overwrite local on conflict
|
|
- [x] No push to server
|
|
|
|
### Deletions
|
|
- [x] Implement deletions checkbox logic
|
|
- [x] Delete on both sides if enabled
|
|
|
|
### Conflict Resolution
|
|
- [x] Detect URL collision with different titles
|
|
- [x] Conflict detection method available
|
|
|
|
## Phase 5: UI Components
|
|
|
|
### Bookmark Form
|
|
- [x] URL input (auto-fill from active tab)
|
|
- [x] Title input (auto-fill from active tab)
|
|
- [x] Description textarea
|
|
- [x] Notes textarea
|
|
- [x] Tags input (comma-separated)
|
|
- [x] Folder path input
|
|
- [x] Add button
|
|
|
|
### Bookmark List
|
|
- [x] Display synced bookmarks
|
|
- [x] Search filter input
|
|
- [x] Tag display
|
|
|
|
### Collections Panel
|
|
- [x] Collection list display
|
|
- [x] Collection type indicator
|
|
|
|
### Query Builder
|
|
- [x] Query expression input
|
|
- [x] Parse button
|
|
- [x] Execute button
|
|
- [x] Result display
|
|
- [x] Syntax help
|
|
|
|
### Sync Status
|
|
- [x] Last sync timestamp
|
|
- [x] Sync indicator (syncing/synced/error)
|
|
- [x] Manual sync trigger
|
|
|
|
### Settings Modal
|
|
- [x] Server URL input
|
|
- [x] API Key input (show/hide toggle)
|
|
- [x] Sync mode dropdown
|
|
- [x] Deletions checkbox
|
|
- [x] Auto-sync checkbox
|
|
- [x] Test connection button
|
|
- [x] Save button
|
|
|
|
## Phase 6: Error Handling
|
|
|
|
### API Errors
|
|
- [x] Handle 401 (unauthorized)
|
|
- [x] Handle 429 (rate limited) with retry
|
|
- [x] Handle 500 (server error)
|
|
- [x] Handle timeout
|
|
- [x] Show user-friendly messages via notifications
|
|
|
|
### Network Errors
|
|
- [x] Offline detection (fetch errors)
|
|
- [x] Retry with backoff (3 attempts)
|
|
- [x] Request timeout (10s)
|
|
|
|
### UI Errors
|
|
- [x] Form validation (required fields)
|
|
- [x] Input sanitization (escapeHtml)
|
|
- [x] Error notifications
|
|
- [x] Empty state messages
|
|
|
|
## Phase 7: Testing
|
|
|
|
### Manual Testing
|
|
- [x] Testing checklist (tests/README.md)
|
|
- [ ] Test in Firefox (load temporary add-on)
|
|
- [ ] Test all sync modes
|
|
- [ ] Test conflict scenarios
|
|
- [ ] Test offline scenarios
|
|
|
|
## Phase 8: Packaging
|
|
|
|
### Distribution
|
|
- [x] All files present and valid
|
|
- [x] manifest.json verified
|
|
- [x] Icons present (48x48, 96x96)
|
|
|
|
## Phase 9: Documentation
|
|
|
|
- [x] API reference (README.md)
|
|
- [x] User guide (README.md)
|
|
- [x] Troubleshooting guide (README.md)
|
|
- [x] Query syntax reference (README.md)
|
|
- [x] Architecture docs (AGENTS.md, design.md)
|
|
|
|
## Future Enhancements
|
|
|
|
- [ ] Background sync notifications
|
|
- [ ] Keyboard shortcuts
|
|
- [ ] Dark theme toggle
|
|
- [ ] Bookmark edit/delete from popup
|
|
- [ ] Batch operations
|
|
- [ ] Conflict resolution UI
|
|
- [ ] Offline queue for pending changes
|
|
- [ ] Auto-sync scheduler customization
|
|
- [ ] Gesture controls
|
|
- [ ] Mobile companion app
|