# Antigravity Handoff — Playlist Butler (Private)

This folder contains the **agent-ready project brief** for Google Antigravity.

## Quick start (human)
1. Load the extension in Chrome:
   - `chrome://extensions` → enable **Developer mode**
   - **Load unpacked** → select repo folder `playlist-butler/`
2. Open YouTube playlist page:
   - `https://www.youtube.com/playlist?list=<PLAYLIST_ID>` (or Watch Later: `list=WL`)
3. Open the extension popup → **Index list**
4. Open **Debug** → **Refresh** → **Copy report**

## Current priority
**Mission 001: Continuations (>100 items) import reliability.**
The importer currently stops at ~100 because the continuation response parses to 0 items.

See: `MISSION_001_CONTINUATION.md`

## Where to look in code
- Content script bridge: `src/content/content_bridge.js`
- Page context extraction: `src/content/page_context.js`
- Background worker: `src/background/service_worker.js`
- Popup UI + debug panel: `src/popup/*`

## Notes
- This repo is private; no telemetry/server. Local-first only.
- Use the Debug panel logs as the primary truth (no DevTools required).

Generated: 2026-01-26T00:31:58Z


## Read-only analysis
Use `antigravity/ANALYSIS_REPORT_TEMPLATE.md` to write the report for Mission 001.