feat: modernize extension with WXT, TypeScript, and comprehensive testing

.github/workflows/ci.yml

@@ -0,0 +1,109 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [master, main]
+  push:
+    branches: [master, main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run Biome checks
+        run: npm run lint
+
+  test:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run unit tests with coverage
+        run: npm run test:coverage -- --run
+
+      - name: Upload coverage report
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage/
+          retention-days: 7
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build extension
+        run: npm run build
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: extension-build
+          path: .output/chrome-mv3/
+          retention-days: 7
+
+  e2e:
+    name: E2E Tests
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install chromium --with-deps
+
+      - name: Build extension
+        run: npm run build
+
+      - name: Run E2E tests
+        run: npm run test:e2e
+
+      - name: Upload Playwright report
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 7

.gitignore

@@ -5,3 +5,14 @@ node_modules
 npm-debug.log
 .DS_Store
 .opencode
+
+# WXT
+.wxt/
+.output/
+
+# Test coverage
+coverage/
+
+# Playwright
+playwright-report/
+test-results/

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

.planning/PROJECT.md

@@ -0,0 +1,89 @@
+# QuickTab
+
+## What This Is
+
+A Chrome extension for Zendesk users that intercepts zendesk.com navigation and routes it to existing agent tabs instead of opening new ones. Originally abandoned by maintainers and removed from Chrome Web Store — now being modernized for security, maintainability, and republishing.
+
+## Core Value
+
+Zendesk links open in existing agent tabs, not new ones. This single behavior must work reliably across all supported URL patterns.
+
+## Requirements
+
+### Validated
+
+- ✓ Intercept zendesk.com/agent navigation events — existing
+- ✓ Route intercepted URLs to existing Zendesk agent tabs — existing
+- ✓ URL pattern matching (Lotus routes, ticket routes, restricted routes) — existing
+- ✓ User-configurable detection modes (all URLs, ticket URLs, disabled) — existing
+- ✓ Popup UI for settings and status display — existing
+- ✓ Welcome page on first install — existing
+- ✓ Icon state reflects current detection mode — existing
+- ✓ Settings persist via Chrome storage — existing
+- ✓ i18n support with localized strings — existing
+
+### Active
+
+- [ ] Migrate from jQuery 1.6.1 to vanilla JavaScript
+- [ ] Replace Handlebars templates with plain HTML + JS
+- [ ] Convert ES5 codebase to TypeScript
+- [ ] Replace Grunt + Webpack 1.x with Vite
+- [ ] Add unit test coverage with Vitest
+- [ ] Add E2E browser tests with Playwright
+- [ ] Set up GitHub Actions CI pipeline (lint, test, build, security scan)
+- [ ] Ensure full Chrome Web Store policy compliance
+- [ ] Create release workflow with versioning and artifacts
+- [ ] Document codebase for maintainer handoff
+
+### Out of Scope
+
+- New features beyond bug fixes — this is a technical modernization
+- Rebrand or visual refresh — keeping QuickTab identity
+- Automated Chrome Web Store publishing — manual upload for now
+- Support for non-Chrome browsers — Chrome/Chromium only
+
+## Context
+
+**Origin:** Forked from abandoned extension removed from Chrome Web Store. Original functionality intact but built on outdated dependencies with known vulnerabilities.
+
+**Current State:**
+- jQuery 1.6.1 (2011, multiple CVEs)
+- Handlebars 2.0.0
+- ES5 JavaScript throughout
+- Grunt 1.6.1 + Webpack 1.x build system
+- No tests, no CI/CD, no security scanning
+- Already partially migrated to Manifest V3
+
+**Target State:**
+- Zero jQuery — vanilla TypeScript
+- No templating runtime — plain HTML
+- Modern ES2022+ TypeScript
+- Vite build system
+- Vitest + Playwright test coverage
+- GitHub Actions CI with security scanning
+- Chrome Web Store compliant and published
+
+**Publishing:** Chrome developer account ready. Manual upload workflow until automation needs justify investment.
+
+## Constraints
+
+- **Manifest Version**: Must be Manifest V3 compliant — V2 deprecated
+- **Browser Support**: Chrome/Chromium only — no Firefox/Safari/Edge
+- **Scope**: Technical modernization — no new end-user features
+- **Dependencies**: Minimize runtime dependencies — prefer vanilla implementations
+- **Testing**: Must have CI gates before merging — no untested code to main
+
+## Key Decisions
+
+| Decision | Rationale | Outcome |
+|----------|-----------|---------|
+| Remove jQuery entirely | Minimal DOM manipulation, security vulnerabilities, unnecessary weight | — Pending |
+| Remove Handlebars | Simple UI doesn't justify templating runtime, reduces dependencies | — Pending |
+| TypeScript over JavaScript | Type safety, better maintainability, IDE support, catches bugs early | — Pending |
+| Vite over alternatives | Fast, modern, excellent Chrome extension ecosystem support | — Pending |
+| Vitest + Playwright | Modern test stack, fast unit tests, real browser E2E | — Pending |
+| GitHub Actions | Free for public repos, good ecosystem, team familiarity | — Pending |
+| Manual Web Store publishing | Focus on codebase quality first, automation later if needed | — Pending |
+
+---
+*Last updated: 2026-01-25 after initialization*

.planning/REQUIREMENTS.md

@@ -0,0 +1,165 @@
+# Requirements: QuickTab Modernization
+
+**Defined:** 2026-01-25
+**Core Value:** Zendesk links open in existing agent tabs, not new ones. This single behavior must work reliably.
+
+## v1 Requirements
+
+Requirements for modernization release. Each maps to roadmap phases.
+
+### Build System
+
+- [ ] **BUILD-01**: Project uses WXT framework with Vite for extension bundling
+- [ ] **BUILD-02**: TypeScript 5.9+ with ES2022 target and strict mode enabled
+- [ ] **BUILD-03**: Source maps generated for development debugging
+- [ ] **BUILD-04**: npm scripts for dev, build, test, and lint workflows
+- [ ] **BUILD-05**: Hot module replacement (HMR) works during development
+- [ ] **BUILD-06**: Bundle size analysis available via build script
+
+### Code Quality
+
+- [ ] **QUAL-01**: Biome configured for linting and formatting
+- [ ] **QUAL-02**: Pre-commit hooks enforce lint and format via Husky + lint-staged
+- [ ] **QUAL-03**: @types/chrome provides TypeScript definitions for Chrome APIs
+- [ ] **QUAL-04**: CI runs Biome checks on pull requests
+
+### Testing
+
+- [ ] **TEST-01**: Vitest configured for unit testing
+- [ ] **TEST-02**: Chrome API mocking via @webext-core/fake-browser
+- [ ] **TEST-03**: Unit tests cover URL matching logic
+- [ ] **TEST-04**: Unit tests cover storage operations
+- [ ] **TEST-05**: Unit tests cover service worker event handlers
+- [ ] **TEST-06**: E2E tests with Playwright for navigation flows
+- [ ] **TEST-07**: Coverage reporting integrated with test runs
+- [ ] **TEST-08**: Service worker termination tests validate state persistence
+
+### CI/CD
+
+- [ ] **CICD-01**: GitHub Actions workflow runs lint, test, build on PR
+- [ ] **CICD-02**: GitHub Actions workflow runs on push to main
+- [ ] **CICD-03**: Automated version bumping on release
+- [ ] **CICD-04**: Changelog generated from conventional commits
+- [ ] **CICD-05**: Release workflow creates ZIP artifact on tag
+
+### Web Store Compliance
+
+- [ ] **STORE-01**: Privacy policy document created and linked
+- [ ] **STORE-02**: Permission audit completed — unused permissions removed
+- [ ] **STORE-03**: All dependencies bundled — no remote code execution
+- [ ] **STORE-04**: Code is minified but not obfuscated
+- [ ] **STORE-05**: Store metadata updated (description, screenshots)
+
+### Git Workflow
+
+- [ ] **GIT-01**: Each phase developed on dedicated feature branch
+- [ ] **GIT-02**: Git worktrees used for parallel development and safe rollback
+- [ ] **GIT-03**: Atomic commits per logical change with conventional commit messages
+- [ ] **GIT-04**: PRs required for merging to main — no direct commits
+- [ ] **GIT-05**: Main branch always deployable — broken code never merged
+- [ ] **GIT-06**: Tags mark each phase completion for easy revert points
+
+### Code Migration
+
+- [ ] **MIGR-01**: jQuery 1.6.1 removed — all DOM manipulation uses vanilla TypeScript
+- [ ] **MIGR-02**: Handlebars removed — popup uses plain HTML with TypeScript
+- [ ] **MIGR-03**: ES5 code converted to ES2022+ TypeScript
+- [ ] **MIGR-04**: Service worker uses storage-first architecture (no global state)
+- [ ] **MIGR-05**: Event listeners registered synchronously at module scope
+- [ ] **MIGR-06**: Type-safe Chrome API wrappers for storage, tabs, webNavigation
+- [ ] **MIGR-07**: URL matching logic ported to typed TypeScript module
+- [ ] **MIGR-08**: Popup UI ported to vanilla TypeScript
+- [ ] **MIGR-09**: Welcome page ported to vanilla TypeScript
+- [ ] **MIGR-10**: i18n system preserved and working
+
+## v2 Requirements
+
+Deferred to future release. Not in current roadmap.
+
+### Enhanced Testing
+
+- **TEST-V2-01**: Visual regression testing for popup UI
+- **TEST-V2-02**: Performance benchmarking for URL matching
+
+### Automation
+
+- **AUTO-V2-01**: Automated Chrome Web Store publishing via CI
+- **AUTO-V2-02**: Automated screenshot generation for store listing
+
+### Features
+
+- **FEAT-V2-01**: Additional locale support beyond English
+- **FEAT-V2-02**: User-configurable URL patterns (advanced mode)
+
+## Out of Scope
+
+Explicitly excluded. Documented to prevent scope creep.
+
+| Feature | Reason |
+|---------|--------|
+| React/Vue for popup | Overkill for simple settings UI — adds bundle size and complexity |
+| Analytics/telemetry | Requires privacy policy disclosure and user consent — complexity not worth it |
+| Monorepo structure | Single extension doesn't benefit from monorepo overhead |
+| Firefox/Safari support | Chrome-only focus for v1 — cross-browser adds significant testing burden |
+| Remote configuration | MV3 compliance risk — all code must be bundled |
+| New end-user features | This is a technical modernization — feature work is post-v1 |
+
+## Traceability
+
+Which phases cover which requirements. Updated during roadmap creation.
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| BUILD-01 | Phase 1 | Complete |
+| BUILD-02 | Phase 1 | Complete |
+| BUILD-03 | Phase 1 | Complete |
+| BUILD-04 | Phase 1 | Complete |
+| BUILD-05 | Phase 1 | Complete |
+| BUILD-06 | Phase 1 | Complete |
+| QUAL-01 | Phase 1 | Complete |
+| QUAL-02 | Phase 1 | Complete |
+| QUAL-03 | Phase 1 | Complete |
+| QUAL-04 | Phase 4 | Pending |
+| TEST-01 | Phase 4 | Pending |
+| TEST-02 | Phase 4 | Pending |
+| TEST-03 | Phase 4 | Pending |
+| TEST-04 | Phase 4 | Pending |
+| TEST-05 | Phase 4 | Pending |
+| TEST-06 | Phase 4 | Pending |
+| TEST-07 | Phase 4 | Pending |
+| TEST-08 | Phase 4 | Pending |
+| CICD-01 | Phase 6 | Pending |
+| CICD-02 | Phase 6 | Pending |
+| CICD-03 | Phase 6 | Pending |
+| CICD-04 | Phase 6 | Pending |
+| CICD-05 | Phase 6 | Pending |
+| STORE-01 | Phase 5 | Pending |
+| STORE-02 | Phase 5 | Pending |
+| STORE-03 | Phase 2 | Complete |
+| STORE-04 | Phase 5 | Pending |
+| STORE-05 | Phase 5 | Pending |
+| MIGR-01 | Phase 3 | Complete |
+| MIGR-02 | Phase 3 | Complete |
+| MIGR-03 | Phase 2 | Complete |
+| MIGR-04 | Phase 2 | Complete |
+| MIGR-05 | Phase 2 | Complete |
+| MIGR-06 | Phase 2 | Complete |
+| MIGR-07 | Phase 2 | Complete |
+| MIGR-08 | Phase 3 | Complete |
+| MIGR-09 | Phase 3 | Complete |
+| MIGR-10 | Phase 3 | Complete |
+| GIT-01 | All Phases | Pending |
+| GIT-02 | All Phases | Pending |
+| GIT-03 | All Phases | Pending |
+| GIT-04 | All Phases | Pending |
+| GIT-05 | All Phases | Pending |
+| GIT-06 | All Phases | Pending |
+
+**Coverage:**
+- v1 requirements: 44 total (38 deliverable + 6 workflow constraints)
+- Mapped to phases: 44
+- Unmapped: 0
+
+---
+*Requirements defined: 2026-01-25*
+*Last updated: 2026-01-25 after roadmap creation*