webtap-tool 0.8.0__tar.gz → 0.8.1__tar.gz

{webtap_tool-0.8.0 → webtap_tool-0.8.1}/CHANGELOG.md

@@ -15,6 +15,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## [0.8.1] - 2025-10-16
+
+### Added
+
+### Changed
+
+### Fixed
+- **Extension setup**: Added missing `background.js` to downloaded extension files (setup-extension command now downloads all 5 required files)
+
+### Removed
+
 ## [0.8.0] - 2025-10-16
 
 ### Added

{webtap_tool-0.8.0 → webtap_tool-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webtap-tool
-Version: 0.8.0
+Version: 0.8.1
 Summary: Terminal-based web page inspector for AI debugging sessions
 Author-email: Fredrik Angelsen <fredrikangelsen@gmail.com>
 Classifier: Development Status :: 3 - Alpha

webtap_tool-0.8.1/docs/summaries/HANDOFF_2025-10-16_223809.md

@@ -0,0 +1,125 @@
+# WebTap Session Handoff - 2025-10-16
+
+## Accomplishments
+
+### Critical Bug Fix: Reconnection After Page Crashes
+- **Problem**: When a connected page crashed/closed, WebTap couldn't reconnect (got "Already connected" error)
+- **Root cause**: `CDPSession._on_close()` never cleared `ws_app` and `page_info` state
+- **Solution**: Proper state lifecycle management
+  - `_on_close()` now clears state after detecting unexpected disconnect
+  - `disconnect()` preserves DB thread and events (only `cleanup()` stops DB thread)
+  - Added `atexit` hook for proper cleanup on app exit
+  - Events now persist across connection cycles (cleared only by Clear button or exit)
+- **Files changed**:
+  - `cdp/session.py`: Added `cleanup()`, modified `disconnect()` and `_on_close()`
+  - `app.py`: Added `atexit` registration
+  - `__init__.py`: Wire up cleanup on exit
+  - `services/main.py`: `_handle_unexpected_disconnect()` preserves events
+
+### Code Generation Features
+- **New quicktype command**: Generate types for 12+ languages (TypeScript, Go, Rust, Python, etc.)
+  - Auto-detects language from file extension
+  - Language-aware header comments with event metadata
+  - Full quicktype CLI options support via `options` dict
+- **Request body support**: `body()` and `to_model()` now work with POST/PUT/PATCH requests
+  - Auto-detects `Network.requestWillBeSent` events and fetches POST data
+  - Returns event data for `expr` evaluation on any CDP event type
+- **Refactoring**: Created `_code_generation.py` with shared utilities
+  - Eliminated 166 duplicate lines across `to_model()` and `quicktype()`
+  - Reduced queries from 2→1 per generation call
+  - New `BodyService.prepare_for_generation()` orchestrator
+
+### Extension Safety & UX
+- **Safety**: Eliminated XSS/encoding issues
+  - Replaced UTF-8 cross (✕) with pure CSS icon
+  - All `innerHTML` replaced with safe DOM creation
+  - New `showError()` and `showMessage()` helpers with auto-escaping
+- **UX**: Added "Reload Pages" button for manual page list refresh
+- **UX**: Context menu for switching between sidepanel and popup window modes
+- **Concurrency**: Added global operation lock to prevent concurrent button operations
+
+### State Management Improvements
+- **Thread-safe SSE**: New immutable snapshot architecture
+  - `StateSnapshot` frozen dataclass with atomic updates
+  - `WebTapService._create_snapshot()` and `_trigger_broadcast()` replace direct broadcasts
+  - All service mutations trigger snapshot updates via RLock-protected operations
+- **Service layer**: Broadcast callback pattern (DOMService, FetchService use callbacks instead of direct queue access)
+
+### Tips System
+- Added contextual tips to `page()` and `pages()` commands
+- `info_response()` now supports `tips` parameter (matches `table_response()`)
+
+## Current Status
+
+**Production Ready**
+
+- All linting passed (ruff check)
+- Type checking passed (basedpyright)
+- Released as webtap-tool 0.8.0 to PyPI
+- No known blockers
+
+## Key Files
+
+### Changed Files (24 total)
+- **Core fixes**: `cdp/session.py`, `services/main.py`, `app.py`, `__init__.py`
+- **New features**: `commands/quicktype.py`, `commands/_code_generation.py`, `services/state_snapshot.py`
+- **Extension**: `extension/sidepanel.js`, `extension/sidepanel.html`, `extension/background.js`
+- **Refactored**: `services/body.py`, `commands/to_model.py`, `commands/body.py`
+- **Docs**: `commands/TIPS.md`, `commands/_builders.py`, `commands/connection.py`, `commands/navigation.py`
+
+### Architecture Documents
+- `src/webtap/VISION.md` - Native CDP storage philosophy
+- `commands/DEVELOPER_GUIDE.md` - Command development patterns
+- `commands/TIPS.md` - User-facing tips with examples
+
+### Changelogs
+- `.claude/CHANGELOG.md` - Documented new `/handoff` command
+- `packages/webtap/CHANGELOG.md` - Full 0.8.0 release notes
+
+## Next Steps
+
+**No immediate tasks** - system is stable and released.
+
+## Future Work
+
+### Nice-to-Have Enhancements
+1. **HAR export command** (~100 lines)
+   - Map CDP events → HAR format for compatibility with other tools
+   - Reference: Network Timing API spec
+
+2. **Service Worker commands**
+   - CDP has dedicated ServiceWorker domain (already works via `events()` with expr)
+   - Could add convenience commands if needed
+
+3. **Code cleanup opportunities**
+   - Extract `_insert_header()` to shared utils if `to_model()` needs headers
+   - Consolidate language detection map (currently duplicated in 2 files)
+   - Standardize error response builders
+
+### Architecture Insights
+- **Service layer owns orchestration**: `prepare_for_generation()` lives in BodyService (has state, domain knowledge)
+- **Utils stay pure**: `_code_generation.py` has no dependencies, pure transforms
+- **expr is universal**: Works for ANY CDP event type, no special cases needed
+- **DB lifecycle**: Tied to app lifetime (not connection lifetime) for event preservation
+
+## Testing Evidence
+
+- Manual testing: Page crash → reconnect → works
+- Extension tested: Reload button, safe HTML rendering
+- Code generation tested: quicktype with multiple languages
+- Linting: `ruff check packages/webtap/src --fix`
+- Type checking: `basedpyright packages/webtap/src`
+- Released to PyPI: webtap-tool 0.8.0
+
+## Commits This Session
+```
+0572ced feat(webtap): fix reconnection and add code generation features
+b53608e chore(claude): add handoff slash command
+```
+
+## Statistics
+- **Lines changed**: +1,544 / -360
+- **Files modified**: 24
+- **New files**: 4 (background.js, _code_generation.py, quicktype.py, state_snapshot.py)
+- **Duplicate code removed**: 166 lines
+- **Query optimization**: 2 queries → 1 per generation call

{webtap_tool-0.8.0 → webtap_tool-0.8.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "webtap-tool"
-version = "0.8.0"
+version = "0.8.1"
 description = "Terminal-based web page inspector for AI debugging sessions"
 readme = "README.md"
 authors = [

{webtap_tool-0.8.0 → webtap_tool-0.8.1}/src/webtap/services/setup/extension.py

@@ -12,7 +12,7 @@ logger = logging.getLogger(__name__)
 
 # GitHub URLs for extension files
 EXTENSION_BASE_URL = "https://raw.githubusercontent.com/angelsen/tap-tools/main/packages/webtap/extension"
-EXTENSION_FILES = ["manifest.json", "content.js", "sidepanel.html", "sidepanel.js"]
+EXTENSION_FILES = ["manifest.json", "background.js", "content.js", "sidepanel.html", "sidepanel.js"]
 
 
 class ExtensionSetupService: