Mark
7da30afa0a
Three surgical edits in src/content/index.ts flip the 7 RED tests from commit3dbc51cto GREEN (full vitest 180/180; tsc-clean preserved). * P1 #11 — fetch URL extraction (TWO sites, identical narrow): - line ~190 (ok-branch of setupNetworkLogging) - line ~210 (catch-branch of setupNetworkLogging) Both replace the implicit-coercion `target: args[0]?.toString() || 'unknown'` with the explicit type-narrow `target: (args[0] instanceof Request ? args[0].url : String(args[0])) || 'unknown'`. This unmasks the failing URL when the page calls `fetch(new Request(url))` — the original code captured the literal '[object Request]' (Request has no custom toString and falls back to Object.prototype.toString). * P1 #14 — navigation URL tracking via module-level previousUrl: - ADD `let previousUrl = window.location.href;` at module scope (line 29; typeof window guard keeps node-env unit tests importable). - REWRITE handleNavigation to swap-then-emit: const fromUrl = previousUrl; const toUrl = window.location.href; previousUrl = toUrl; addUserEvent({ ..., meta: { previousUrl: fromUrl } }); This replaces `meta: { previousUrl: history.state?.url || 'unknown' }` which always emitted 'unknown' in apps that don't populate history.state (almost all of them) — making meta.previousUrl useless for support reproducing where the operator was before a failing navigation. * P1 #15 — rrweb emit timestamp normalization: - Prepend `event.timestamp = Date.now();` inside the rrweb record() emit callback at ~line 312. rrweb-internal timestamps are page-load-relative small ints; without normalization the cleanupOldEvents arithmetic at ~line 33 `(now - event.timestamp) < RRWEB_RETENTION_MS` is a category error (Date.now() - 42 ≫ 10 min retention). Plan: 04-01 Wave 1 (closes Wave 0 RED gate from3dbc51c) Files: - src/content/index.ts (~30 lines added; 3 surgical edits + Plan-citing comments) Verification (GREEN gate): - npm test -- tests/content/ --run → 9 passed (9) - npm test -- --run → 180 passed (180); was 171/171 pre-Plan-04-01 - npx tsc --noEmit → exit 0 - grep -c "instanceof Request" src/content/index.ts → 3 (≥2 expected) - grep -cE "args\[0\]\?\.toString" src/content/index.ts → 0 (old pattern purged) - grep -cE "^let previousUrl" src/content/index.ts → 1 - grep -cE "meta: \{ previousUrl: fromUrl \}" src/content/index.ts → 1 - grep -cE "event\.timestamp = Date\.now\(\)" src/content/index.ts → 2 (1 in addUserEvent normalization at line 54 + 1 new in rrweb emit at line 315) Pre-checkpoint bundle gates: - npm run build → 4.66s; dist/ ships cleanly - Tier-1 FORBIDDEN_HOOK_STRINGS test (no-test-hooks-in-prod-bundle.test.ts) → 13/13 GREEN; inventory at 12 strings (unchanged — Plan 04-01 added no harness hooks). - SW CSP-safety: 1 `new Function("...")` in SW chunk — pre-existing setimmediate polyfill from vite-plugin-node-polyfills, NOT a Plan 04-01 regression; documented at .planning/phases/01-stabilize-video-pipeline/ deferred-items.md as Plan 04-02 fix scope. - Node-globals / DOM-globals in SW chunk: 1 Buffer + 4 window/document references — all from JSZip internals (pre-existing across all Phase 1+2+3 builds; lower-case `Buffer` field names + DOM shimming inside zip assembly). - manifest.json: present, name uses chrome.i18n __MSG_extName__ message resolution (no en↔ru parity surface touched by Plan 04-01). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Mokosh — Session Capture
Chrome MV3 extension that records operator sessions for bug reports.
Фаза 1 — Локальная запись + экспорт архива
Установка и запуск
Разработка
# Установка зависимостей
npm install
# Сборка для разработки с HMR
npm run dev
# Сборка для продакшена
npm run build
Установка расширения в Chrome
-
Соберите проект:
npm run build -
Откройте Chrome и перейдите по адресу:
chrome://extensions/ -
Включите "Режим разработчика" (Developer mode) в правом верхнем углу
-
Нажмите кнопку "Загрузить распакованное расширение" (Load unpacked)
-
Выберите папку
distв корне проекта -
Расширение установлено!
Использование
-
При первом открытии popup расширение запросит разрешение на запись экрана
-
Разрешение обязательно для работы расширения
-
Расширение автоматически начнет запись:
- Видео: последние 30 секунд (кольцевой буфер)
- DOM-события через rrweb: последние 10 минут
- Лог действий пользователя: последние 10 минут
-
Для сохранения отчета об ошибке:
- Нажмите на иконку расширения
- Нажмите кнопку "Сохранить отчёт об ошибке"
- Архив автоматически загрузится в папку "Загрузки"
Структура архива
Архив session_report_YYYY-MM-DD_HH-MM-SS.zip содержит:
session_report_2025-05-15_14-32-10.zip
├── video/
│ └── last_30sec.webm # склеенные чанки видеобуфера
├── rrweb/
│ └── session.json # массив DOM-событий rrweb
├── logs/
│ └── events.json # лог действий пользователя
├── screenshot.png # скриншот в момент сохранения
└── meta.json # метаданные сессии
Технический стек
- Тип расширения: Chrome Extension, Manifest V3
- Service Worker: Background script (Manifest V3)
- Захват экрана:
chrome.tabCaptureAPI - Захват DOM:
rrweb(npm: rrweb) - Лог событий: Content Script
- Упаковка архива:
JSZip(npm: jszip) - Сохранение файла:
chrome.downloadsAPI - Хранение буфера: In-memory (Service Worker + Content Script)
- Build: Vite + crxjs + TypeScript
Особенности
Маскирование чувствительных данных
- Пароли (
input[type=password]) маскируются автоматически в rrweb и логах - Поля с атрибутом
data-sensitive="true"также маскируются в rrweb
Записываемые события
Пользовательские события
- click — клик по любому элементу
- input — изменение значения поля (без паролей)
- navigation — переходы по страницам (popstate, hashchange, History API)
- js_error — JavaScript ошибки (window.onerror, unhandledrejection)
- network_error — сетевые ошибки (fetch/XHR с кодом ответа >= 400)
Кольцевой буфер
- Видео: 30 секунд, первый чанк (WebM заголовок) хранится всегда
- rrweb события: 10 минут, максимум 5000 событий
- Пользовательские события: 10 минут
Память
- Ожидаемое потребление: ~5-10 МБ в фоновом режиме
Критерии приёмки Фазы 1
- ✅ Расширение устанавливается в Chrome без ошибок
- ✅ Видеобуфер непрерывно работает на любой вкладке
- ✅ В буфере всегда есть не более 30 секунд видео
- ✅ rrweb пишет DOM-события без ошибок на типовых страницах
- ✅ Лог событий фиксирует клики, навигацию и сетевые ошибки
- ✅ При нажатии кнопки архив скачивается в "Загрузки" за < 5 секунд
- ✅ Архив открывается,
last_30sec.webmвоспроизводится в браузере - ✅ Пароли не попадают в лог и rrweb-снимки
- ✅ RAM-потребление расширения не превышает 50 МБ в фоне
Отладка
Console Logs
Расширение пишет подробные логи в консоль:
- Service Worker: Chrome DevTools → Extensions → Service Worker → Console
- Content Script: Chrome DevTools на любой странице → Console
- Popup: Правый клик по popup → Проверить
Структура проекта
ai-call-extension/
├── src/
│ ├── background/ # Service Worker
│ │ └── index.ts
│ ├── content/ # Content Script
│ │ └── index.ts
│ ├── popup/ # Popup UI
│ │ ├── index.html
│ │ ├── index.ts
│ │ └── style.css
│ └── shared/ # Общие типы и утилиты
│ ├── types.ts
│ └── logger.ts
├── icons/ # Иконки расширения
├── dist/ # Собранные файлы
├── manifest.json # Manifest расширения
├── vite.config.ts # Конфигурация Vite
├── tsconfig.json # Конфигурация TypeScript
└── package.json
Лицензия
MIT
Контакты
Для вопросов и предложений обращайтесь в support.