{"id":51891445,"url":"https://github.com/coldbricks/flow-fixer","last_synced_at":"2026-07-26T04:30:25.746Z","repository":{"id":370609602,"uuid":"1295703222","full_name":"coldbricks/flow-fixer","owner":"coldbricks","description":"Reliability toolkit for Google Flow — HAR forensics, fan-out analysis, eng brief. Not a bypass tool.","archived":false,"fork":false,"pushed_at":"2026-07-09T20:30:33.000Z","size":1649,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-07-09T21:11:21.549Z","etag":null,"topics":["chrome-devtools","forensics","google-flow","google-labs","har","observability","python","rate-limiting","recaptcha","reliability","veo"],"latest_commit_sha":null,"homepage":"https://github.com/coldbricks/flow-fixer","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coldbricks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-09T19:23:19.000Z","updated_at":"2026-07-09T20:30:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/coldbricks/flow-fixer","commit_stats":null,"previous_names":["coldbricks/flow-fixer"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/coldbricks/flow-fixer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coldbricks%2Fflow-fixer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coldbricks%2Fflow-fixer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coldbricks%2Fflow-fixer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coldbricks%2Fflow-fixer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coldbricks","download_url":"https://codeload.github.com/coldbricks/flow-fixer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coldbricks%2Fflow-fixer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35901460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-26T02:00:06.503Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chrome-devtools","forensics","google-flow","google-labs","har","observability","python","rate-limiting","recaptcha","reliability","veo"],"created_at":"2026-07-26T04:30:25.231Z","updated_at":"2026-07-26T04:30:25.737Z","avatar_url":"https://github.com/coldbricks.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flow Fixer\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eReliability toolkit for \u003ca href=\"https://labs.google/fx/tools/flow\"\u003eGoogle Flow\u003c/a\u003e\u003c/strong\u003e\u003cbr/\u003e\n  \u003csub\u003eHAR forensics · live monitor · optional self-pacing — not a bypass tool\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/coldbricks/flow-fixer/releases/latest/download/flow-fixer-extension.zip\"\u003e\u003cimg alt=\"Download extension zip\" src=\"https://img.shields.io/badge/download-extension%20.zip-blue?style=for-the-badge\u0026logo=googlechrome\u0026logoColor=white\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/coldbricks/flow-fixer/releases/latest\"\u003e\u003cimg alt=\"Latest release\" src=\"https://img.shields.io/github/v/release/coldbricks/flow-fixer?style=for-the-badge\u0026label=release\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Python 3.10+\" src=\"https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square\"/\u003e\n  \u003cimg alt=\"License MIT\" src=\"https://img.shields.io/badge/license-MIT-green?style=flat-square\"/\u003e\n  \u003cimg alt=\"Scope\" src=\"https://img.shields.io/badge/scope-local%20forensics-purple?style=flat-square\"/\u003e\n  \u003cimg alt=\"Not a bot\" src=\"https://img.shields.io/badge/not-a%20bot%20%2F%20bypass-red?style=flat-square\"/\u003e\n\u003c/p\u003e\n\n**Flow Fixer** helps you see *why* Google Flow shows *“unusual activity”* or *“too quickly”* when you’re clicking Generate / Retry like a normal user.\n\n**Core observation:** Flow scores **reCAPTCHA risk per generate HTTP call**, while the UI often turns **one click into N parallel generate calls** (multi-output ≈ 4; Retry-All often 12–20). Pass rate can collapse by fire-order inside a burst. Optional **AUTO-THROTTLE** paces *your own* clicks so you don’t overspeed into a sticky lockout.\n\nIt does **not** forge reCAPTCHA, automate generation, or evade abuse systems. Processing is **local** in your browser or on your machine.\n\nTechnical write-up: **[docs/ENG_BRIEF.md](docs/ENG_BRIEF.md)** · Limitations: **[docs/LIMITATIONS.md](docs/LIMITATIONS.md)** · Privacy: **[PRIVACY.md](PRIVACY.md)** · Security: **[SECURITY.md](SECURITY.md)**\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/extension_popup_full.png\" alt=\"Flow Fixer extension — HARD GATE, Molasses cool-down, full speed ladder\" width=\"420\"/\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eExtension UI: hard unusual-activity gate → auto downshift to Molasses + cool-down. Full speed ladder + live classify.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/ui_unusual_activity.png\" alt=\"Google Flow UI: Failed — We noticed some unusual activity\" width=\"820\"/\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eWhat users see in Flow: failed cards with Retry still available — retries add more scored HTTP calls.\u003c/sub\u003e\n\u003c/p\u003e\n\n---\n\n## Download the browser extension\n\n**[↓ flow-fixer-extension.zip](https://github.com/coldbricks/flow-fixer/releases/latest/download/flow-fixer-extension.zip)**  \n(stable URL — always the latest release)\n\n### Install (Chrome / Edge / Brave)\n\n1. Download the zip (link above)  \n2. Unzip somewhere permanent (don’t delete the folder later)  \n3. Open `chrome://extensions` or `edge://extensions`  \n4. Enable **Developer mode**  \n5. **Load unpacked** → select the folder that contains `manifest.json`  \n6. Open [Flow](https://labs.google/fx/tools/flow) → **hard refresh** (`Ctrl+Shift+R`)  \n7. Pin **Flow Fixer**\n\nChrome does not allow one-click install from GitHub (Web Store only). Download → unzip → Load unpacked is the normal open-source path.\n\nFull extension docs: **[extension/README.md](extension/README.md)**\n\n### What the extension does\n\n| Feature | Notes |\n|---------|--------|\n| Live soft / hard / filter classification | From generate responses |\n| Fan-position pass rates | UI burst shape |\n| **AUTO-THROTTLE** | Optional; default on. Paces/serializes *your* generate calls |\n| Speed ladder | Molasses → Casey Jones (see below) |\n| Export JSON / **Copy report** | Last **500** events; project IDs redacted; no prompts/tokens |\n| Diagnostics strip | Inject heartbeat + net hits; **project UUIDs redacted** for safer screenshots |\n| Settings persist | Auto-throttle / monitor / gear survive browser restart |\n\n**AUTO-THROTTLE off** = monitor only (no pacing).  \n**Casey Jones** = full parallel fan-out — will trip soft/hard quickly under load; use intentionally.\n\n---\n\n## Python CLI (HAR forensics)\n\n```bash\ngit clone https://github.com/coldbricks/flow-fixer.git\ncd flow-fixer\npython -m pip install -e .\n\npython -m flowfixer sanitize raw.har -o safe.har\npython -m flowfixer analyze safe.har\npython -m flowfixer report  safe.har -o report.md\n```\n\nNever share a **raw** HAR (cookies/auth). Always sanitize first.\n\n| Command | Purpose |\n|---------|---------|\n| `sanitize` | Redact cookies, auth, tokens, project/session IDs, credit numbers |\n| `analyze` | Soft vs hard vs filter · bursts · fan-position |\n| `report` | Markdown summary |\n\nRequires **Python 3.10+**.\n\n---\n\n## The request shape (diagram)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/architecture.png\" alt=\"One click becomes multiple scored HTTP generate calls\" width=\"820\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/cli_preview.png\" alt=\"flowfixer analyze terminal preview\" width=\"820\"/\u003e\n\u003c/p\u003e\n\n---\n\n## Fan-position chart\n\nPass rate by **fire-order inside a burst** (gap ≤ 2s). First call often lives; the tail often dies.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/fan_position.png\" alt=\"Pass rate by position in UI fan-out\" width=\"820\"/\u003e\n\u003c/p\u003e\n\n| Observation | Interpretation |\n|-------------|----------------|\n| Fresh unique reCAPTCHA tokens on failed calls | Not simply “stale captcha” |\n| Same creative payload, mixed 200 / 429 | Timing/burst position matters |\n| Soft vs hard are different reason codes | Two machines, not one |\n| Hard can stay sticky for many minutes | Short “try again” guidance may be incomplete |\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/outcomes.png\" alt=\"Outcome classification examples\" width=\"820\"/\u003e\n\u003c/p\u003e\n\nMore detail: **[docs/ENG_BRIEF.md](docs/ENG_BRIEF.md)** · Operating tips: **[docs/OPS_DOCTRINE.md](docs/OPS_DOCTRINE.md)** · Wire map: **[docs/INTERNAL_MAP.md](docs/INTERNAL_MAP.md)**\n\n---\n\n## Speed ladder (extension)\n\n| Gear | Idea | Approx gap |\n|------|------|------------|\n| 🧊 Molasses | Way under typical throttle | ~9s |\n| 💧 Water | Calm | ~4.5s |\n| 🚶 Brisk Walk | Human pace | ~2.5s |\n| 💼 The Job | Default work cadence | ~1.2s |\n| 🎸 Highway Star | Spicy but serialized | ~0.6s |\n| 🐎 Black Beauty | Fast | ~0.3s |\n| 🚂 Casey Jones | Full parallel | none |\n\n**Auto shift:** soft → downshift; hard → Molasses + cool-down; clean OK streak → gradual upshift.\n\n---\n\n## What this is not\n\n- Not a bot, undress tool, or unlimited-generation script  \n- Not a reCAPTCHA solver or score spoofer  \n- Not multi-account farming  \n- Not legal advice; not affiliated with Google  \n\nIssues asking how to evade abuse detection will be closed. See [SECURITY.md](SECURITY.md).\n\n---\n\n## Project layout\n\n```text\nextension/     Chrome/Edge MV3 extension (also shipped as release .zip)\nflowfixer/     Python CLI\ndocs/          Technical brief, ops notes, wire map, assets\nfixtures/      Synthetic HAR only\nscripts/       Package + chart helpers\n```\n\nRebuild extension zip: `powershell -ExecutionPolicy Bypass -File scripts/package_extension.ps1`\n\n---\n\n## License\n\nMIT — [LICENSE](LICENSE)\n\nGoogle Flow, Veo, Gemini, and related marks are Google’s. This is an independent project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoldbricks%2Fflow-fixer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoldbricks%2Fflow-fixer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoldbricks%2Fflow-fixer/lists"}