Release v1.0.2: UX, reliability, adapters, sharing, and test hardening

Author: apartsin

INSTALL.md

@@ -22,7 +22,7 @@ Simple step-by-step instructions to install and use the Web2Comics Chrome extens
    ```
 
 4. **Select the extracted Web2Comics release folder**
-   - Navigate to the extracted folder (for example `Web2Comics-v1.0.1`)
+   - Navigate to the extracted folder (for example `Web2Comics-v1.0.2`)
    - Select the folder that contains `manifest.json`
    - Click "Select Folder" or "Open"
 
@@ -91,8 +91,8 @@ The extension needs AI providers to generate comics. You must configure at least
    - Click `Save Providers`
 
 4. **Note**
-   - Cloudflare Workers AI is currently supported for text generation in this extension
-   - Use another provider for image generation
+   - Cloudflare Workers AI supports both text and image generation in this extension
+   - Exact model availability may vary by account and region
 
 ---
 
@@ -102,11 +102,7 @@ The extension needs AI providers to generate comics. You must configure at least
 
 1. **Navigate to any article** (news, blog, etc.)
 2. **Click the Web2Comics extension icon** in the toolbar
-3. You'll see:
-   - Extracted content preview
-   - Panel count selector (3-12 panels)
-   - Style presets (Noir, Manga, etc.)
-   - Provider selection
+3. Click **Create Comic** in the launcher and use defaults for a fast first run, or expand options to customize.
 4. **Click "Generate Comic"**
 5. Wait for generation (progress shown)
 6. **Click "Open Comic Viewer"** to see your comic!
@@ -152,7 +148,7 @@ Check:
 1. API key is configured
 2. You haven't exceeded rate limits
 3. Network is working
-4. Using a provider that supports images (Gemini or OpenAI)
+4. Using a provider that supports images (Gemini, OpenAI, Cloudflare, OpenRouter, or Hugging Face depending on your account/model access)
 ```
 
 ### Service worker errors
@@ -176,7 +172,7 @@ Check chrome://extensions > Service worker for logs.
 ## What's Included
 
 ```
-Web2Comics-v1.0.1/
+Web2Comics-v1.0.2/
 ├── manifest.json           # Extension config
 ├── popup/                 # Main popup UI
 ├── sidepanel/            # Comic viewer
@@ -200,4 +196,4 @@ Web2Comics-v1.0.1/
 
 ---
 
-*Version 1.0.1 | Last Updated: 2026-02-26*
+*Version 1.0.2 | Last Updated: 2026-02-28*

README.md

@@ -10,20 +10,21 @@ Web2Comics is a Chrome extension that:
 - generates panel images
 - shows the result in a comic viewer side panel
 - saves history and exports a single composite comic image
+- supports right-click selected-text flows (instant generate or open composer prefilled)
 
 ## Install (Release ZIP)
 
 Release links:
 - [Releases page](https://github.com/ApartsinProjects/Web2Comics/releases)
-- [Current release (`v1.0.1`) ZIP](https://github.com/ApartsinProjects/Web2Comics/releases/download/v1.0.1/Web2Comics-v1.0.1-extension.zip)
+- [Current release (`v1.0.2`) ZIP](https://github.com/ApartsinProjects/Web2Comics/releases/download/v1.0.2/Web2Comics-v1.0.2-extension.zip)
 
 1. Open the repository `Releases` page on GitHub (link above).
-2. Download the latest release asset ZIP (for example `Web2Comics-v1.0.1-extension.zip`).
+2. Download the latest release asset ZIP (for example `Web2Comics-v1.0.2-extension.zip`).
 3. Extract the ZIP to a folder (for example `C:\Web2Comics`).
 4. Open Chrome and go to `chrome://extensions`.
 5. Turn on `Developer mode` (top-right).
 6. Click `Load unpacked`.
-7. Select the extracted folder that contains `manifest.json` (for example `Web2Comics-v1.0.1`).
+7. Select the extracted folder that contains `manifest.json` (for example `Web2Comics-v1.0.2`).
 8. In `chrome://extensions`, confirm the `Web2Comics` card is enabled (toggle ON).
 9. Open the Chrome Extensions menu (puzzle icon), find `Web2Comics`, and click the pin icon to show it in the toolbar.
 10. Open the extension and configure a [`Google Gemini` API key (free tier)](docs/Gemini_key.md) in `Options -> Providers` (recommended first-run setup).
@@ -39,13 +40,14 @@ Note: `Code -> Download ZIP` downloads the full source repository. Use the relea
 - Track live progress (elapsed time + ETA)
 - Review history of generated comics
 - Export a single PNG comic sheet with captions and source URL
+- Share to Facebook, X, LinkedIn, WhatsApp, Telegram, Reddit, or Email (plus copy-link/caption flows)
 
 ## Supported Providers
 
 Current provider support:
 - OpenAI
 - Google Gemini
-- Cloudflare Workers AI (text only in current extension build)
+- Cloudflare Workers AI (text + image)
 - OpenRouter (model/account dependent)
 - Hugging Face Inference API
 
@@ -85,7 +87,7 @@ Some sample outputs may come from earlier probe/test runs and may not exactly ma
 
 ### Cloudflare Workers AI
 
-Cloudflare support in the current extension is text generation only. This sample is kept as a reference artifact from prior provider testing/output workflows.
+Cloudflare Workers AI supports both text and image generation in the current extension build (account/token and model availability dependent).
 
 ![Cloudflare CNN comic sample](samplecomics/2026-02-25_13-38-32/cloudflare-cnn-comic-sheet.png)
 
@@ -141,6 +143,11 @@ For step-by-step key/token instructions, see:
 7. Review the comic in the side panel.
 8. Click `Download` to export a single comic sheet PNG.
 
+Optional selected-text right-click flow:
+1. Highlight text on any page.
+2. Right-click.
+3. Choose `Generate comic from selected text (Default)` for instant generation, or `Open Create Comic with selected text` to review/customize before generating.
+
 ## Project Structure (Quick Overview)
 
 - `background/` - service worker, provider orchestration, generation pipeline

RELEASE_NOTES.md

@@ -0,0 +1,18 @@
+# Web2Comics Release Notes
+
+## v1.0.2 (2026-02-28)
+
+### Highlights
+- Improved context-menu generation reliability and settings propagation.
+- Added broader integration coverage for context-menu generation/composer flows.
+- Hardened popup integration tests to reduce readiness-related flakiness.
+- Expanded resilience checks for side-panel/popup fallback behavior.
+
+### Quality
+- Full automated test suite executed:
+  - `npm run test`
+  - `npm run test:e2e`
+
+### Packaging
+- Release artifact: `Web2Comics-v1.0.2-extension.zip`
+- Built via: `scripts/package-release.ps1`

background/README.md

@@ -4,7 +4,7 @@
 Extension background/service-worker logic: generation orchestration, provider routing, storage, progress, and diagnostics.
 
 ## Contents
-- `service-worker.js` : Main extension service worker. Handles message routing (`START_GENERATION`, `GET_STATUS`, `TEST_PROVIDER_MODEL`), provider selection, storyboard/image generation orchestration, retries/timeouts, progress updates, storage persistence/history, refusal-handling policy, and provider implementations (OpenAI, Gemini, Cloudflare, OpenRouter, Hugging Face).
+- `service-worker.js` : Main extension service worker. Handles message routing (`START_GENERATION`, `GET_STATUS`, `TEST_PROVIDER_MODEL`, panel edits, optional OAuth connection actions), provider selection, storyboard/image generation orchestration, retries/timeouts, progress updates, storage persistence/history, refusal-handling policy, context-menu flows for selected text (instant generate + open composer prefill), provider implementations (OpenAI, Gemini, Cloudflare, OpenRouter, Hugging Face), and optional Google Drive HTML backup upload.
 
 ## Artifacts
 - No generated artifacts are expected here. Runtime state (jobs, history, debug logs) is stored in `chrome.storage.local`, not as files in this folder.

brainstorm.md

@@ -0,0 +1,57 @@
+# Web2Comics Brainstorm: Google PM x Meta PM
+
+## Simulated Conversation
+
+**Google PM:** We need to optimize first-run success. If users do not get value in under 15 seconds, retention drops hard.  
+**Meta PM:** Agree. But success is not just generation speed, it is share-worthiness. The output must look post-ready immediately.
+
+**Google PM:** Then default flow should be two clicks only: `Create Comic -> Generate`, with smart auto-selection of source content.  
+**Meta PM:** Yes, and surface confidence before generation so users trust what is being summarized.
+
+**Google PM:** We should add intent presets and tune prompts per intent.  
+**Meta PM:** And pair that with lightweight, inline edits so creators can quickly polish before sharing.
+
+**Google PM:** Reliability must be excellent on high-traffic domains and social pages.  
+**Meta PM:** Plus explicit transparency: facts used, source attribution, and one-click jump back to source.
+
+**Google PM:** Sharing should be one-tap presets for each platform format.  
+**Meta PM:** Add remix loops and saved creator styles to drive repeat usage.
+
+**Google PM:** We should instrument the full funnel deeply.  
+**Meta PM:** Yes: creation, edit, share, and return behavior by domain and preset.
+
+**Google PM:** Let us align on top ten and sequence by impact.  
+**Meta PM:** Agreed. Let us ship these as focused change requests.
+
+## Agreed Top 10 Change Requests
+
+1. **CR-01: Two-click guided first run**
+   - Force onboarding flow to `Create Comic -> Generate` with advanced options hidden until first successful comic.
+
+2. **CR-02: Sub-15s first visible value**
+   - Default to fastest model, 3 panels, lightweight image settings, and stream first panel as soon as available.
+
+3. **CR-03: Auto-pick best source block with confidence**
+   - Automatically select best content section; show High/Medium/Low grounding confidence and only show manual picker when confidence is low.
+
+4. **CR-04: Intent presets with prompt tuning**
+   - Add presets (`News Recap`, `ELI5`, `Learn Step-by-Step`, `Meeting Notes`, `Timeline`, `Compare Views`) with tuned generation defaults and prompts.
+
+5. **CR-05: Domain reliability program (top sites + social)**
+   - Ship robust adapters + fallback extraction for top-tier news, docs, wiki, and social domains; include automatic retries and clear fallback messaging.
+
+6. **CR-06: Inline per-panel refinement controls**
+   - Add `Regenerate panel`, `Regenerate caption`, `Make more factual`, `Make simpler`, without re-running entire comic.
+
+7. **CR-07: Trust and attribution layer**
+   - For each panel, show facts/entities/dates/numbers used and source snippet; provide one-click jump to source context.
+
+8. **CR-08: Social-first export and sharing presets**
+   - One-tap export/share presets for X, LinkedIn, Facebook, Instagram Story/Reel cover, and Email with title + source attribution card.
+
+9. **CR-09: Remix and creator memory loop**
+   - Add `Remix this page/comic`, save reusable theme/style presets, and support quick re-generation from prior outputs.
+
+10. **CR-10: Funnel instrumentation and experiment framework**
+    - Track `time-to-first-panel`, extraction success by domain, edit rate, share rate, and retention cohorts by preset; run A/B experiments on onboarding and defaults.
+

content/README.md

@@ -4,7 +4,7 @@
 Content script code for extracting page text/content from the active tab.
 
 ## Contents
-- `content-script.js` : JavaScript source code.
+- `content-script.js` : Content extraction runtime with generic scoring fallback plus site adapters (including Wikipedia/news/social patterns such as Facebook/X/LinkedIn), candidate summaries, quality checks, and selected/full extraction modes.
 
 ## Artifacts
 - No obvious generated artifacts in this directory (or artifacts are stored elsewhere).