Skip to content

CLAUDE.md

Latest commit

 

History

History
77 lines (57 loc) · 3.29 KB

CLAUDE.md

File metadata and controls

77 lines (57 loc) · 3.29 KB
Raw

jules-task-archiver

Chrome Extension (Manifest V3) for bulk operations on Jules tasks via batchexecute API.

Structure

  • manifest.json -- Extension config: permissions, content_scripts, action
  • background.js -- Service worker: batchexecute client, response parser, orchestrator, suggestions
  • content.js -- Content script: WIZ_global_data token extraction + fetch observer (MAIN world)
  • popup.html/js/css -- Popup UI: settings, operation mode, controls, progress display
  • icons/ -- Extension icons (16/48/128px)
  • tests/ -- Unit tests (node:test + vm sandbox)

Architecture (v2)

popup.js (UI) <-> background.js (batchexecute client) <-> content.js (token extractor)
                        |                                        |
                  fetch() to jules.google.com          MAIN world injection
                  /_/Swebot/data/batchexecute          reads WIZ_global_data
                        |
                chrome.storage.session (state)
                chrome.storage.sync (settings)

Two operation modes:

  1. Archive Tasks -- ListTasks (p1Takd) -> check GitHub PRs -> ArchiveTask (Tjmm5c)
  2. Start Suggestions -- ListSources (YqkSHd) filtered to Suggestions-enabled repos -> ListSuggestions (hQP40d) per repo -> cap to remaining daily quota (KQOO7) -> StartSuggestion (Rja83d). Only repos whose per-repo Suggestions toggle is ON are touched; the daily session limit is never exceeded.

Content script extracts auth tokens (SNlM0e, cfb2h, FdrFJe) from WIZ_global_data via MAIN world script injection. Also observes fetch() for Rja83d calls to capture model config and experiment IDs.

Background service worker makes all API calls. No DOM automation.

Key RPC IDs

  • p1Takd -- ListTasks (filter, state)
  • Tjmm5c -- ArchiveTask (taskId, action)
  • tqq5v -- PauseTask / stop a running session (taskId)
  • YqkSHd -- ListSources (connected repos); row [5][2][0] === 2 => Suggestions toggle ON
  • hQP40d -- ListSuggestions (repo); returns the raw pool, does NOT respect the toggle
  • e4motb -- SetSuggestionsToggle (repo, [2]=enable / [1]=disable)
  • Rja83d -- StartSuggestion (prompt, model config, repo, experiment IDs)
  • UTrvy -- Suggestions-repo counter [max, enabled, free] (e.g. [5,3,2] = 3/5 repos enabled)
  • KQOO7 -- Daily session quota [usedToday, [windowSeconds], dailyLimit, ...]

Development

# Lint + format
npx @biomejs/biome check .
npx @biomejs/biome check --write .

# Run tests
node --test

# Load extension
# chrome://extensions -> Developer mode -> Load unpacked -> select this folder

Commit Convention

Conventional Commits enforced by pre-commit hook. Tag format: v{version}. PSR config: semantic-release.toml.

CD Pipeline

workflow_dispatch (beta/stable) -> PSR v10 -> zip extension files -> upload to GitHub Release. No Docker, no npm/pypi, no MCP registry.

Important Notes

  • Zero dependencies -- vanilla JS, no build step
  • Biome for linting (biome.json config): single quotes, no semicolons, 120 line width
  • batchexecute responses have XSS prefix )]}' and may contain raw control chars in JSON strings
  • Service worker keepAlive: setInterval calling chrome.runtime.getPlatformInfo() every 25s
  • State persisted in chrome.storage.session -- survives SW restart
  • Tests use vm.createContext sandbox to mock Chrome APIs