v0.2.2 — PyPI metadata & CLI entrypoint polish

📦 PyPI Package: https://pypi.org/project/captchaai-workflow-doctor/ (pip install captchaai-workflow-doctor)

Release v0.2.2: added comprehensive PyPI metadata, classifiers, project URLs, and PyPI installation quickstart.

v0.2.1 - NOTICE attribution + trust polish

Pure trust / packaging / docs release. No runtime changes; safe to upgrade from v0.2.0 with no profile or CLI changes.

See CHANGELOG.md for the full list.

Companion launch article: https://blog.captchaai.com/why-captcha-tokens-fail-in-browser

v0.2.0 - multi-CAPTCHA expansion

Changelog

All notable changes to captchaai-workflow-doctor are documented here.

The format is based on Keep a Changelog;
this project adheres to Semantic Versioning.

0.2.0 — 2026-05-01

Added — multi-CAPTCHA-type expansion

• reCAPTCHA v3 end-to-end (PR #12). New captcha_type=recaptcha_v3,
  submit_recaptcha_v3 (passes version=v3, action, min_score),
  detector heuristic for the ?render=SITEKEY script-tag shape, mock
  contact form (port 8768), profile, CLI demo, and live-solve coverage
  against the antcpt public test sitekey.
• Cloudflare Turnstile invisible mode end-to-end (PR #13). Detector
  reads data-size="invisible"; profile + CLI demo + mock variant.
• Cloudflare Challenge end-to-end (PR #14). New
  captcha_type=cloudflare_challenge, submit_cloudflare_challenge
  with the verified proxy/proxytype parameter contract, new Proxy
  schema model (required when captcha_type=cloudflare_challenge —
  the cf_clearance cookie is bound to the egress IP that solved it),
  new ApplyClearanceCookieAction that parses the JSON clearance,
  sets the cookie via BrowserContext.add_cookies, replays the
  matching User-Agent via Page.set_extra_http_headers, and reloads.
  Detector heuristic for the "Just a moment..." interstitial. Mock app
  (port 8769), profile, CLI demo, sample reports.
• New root cause cloudflare_proxy_misconfigured for missing
  proxy credential env vars; classifier recommendation included.

Repo / process

• CODEOWNERS + PR template (PR #10).
• Ready-to-apply branch-protection ruleset under
  .github/rulesets/protect-main.json (PR #11). Application is gated
  on the repo flipping public.

Notes

• Live-solve verification: reCAPTCHA v2, reCAPTCHA v3, and Turnstile
  (managed + invisible) all confirmed against ocr.captchaai.com.
  Cloudflare Challenge is partially verified — the method name +
  parameter contract are accepted live, but a full solve requires a
  real residential proxy (Cloudflare binds the cookie to the worker's
  egress IP); deferred until a proxy is plumbed in.
• hCaptcha was probed and not offered by CaptchaAI; the slot was
  taken by Cloudflare Challenge.

0.1.0 — 2026-04-29

Initial public-ready release: walking-skeleton runner for Cloudflare
Turnstile + reCAPTCHA v2 with profile validation, redaction, fake
client for offline demos, mock Flask targets, sample reports, and a
green CI matrix (lint/type/test on 3.11 + 3.12, demo-smoke, and
secrets-scan).

v0.1.0 — first beta release

First beta release of CaptchaAI Workflow Doctor.

What's in

• End-to-end workflow runner (Playwright + CaptchaAI client) with profile system
• Detector + injector + verifier + classifier (12 root causes)
• HTML and JSON reports, with published Draft 2020-12 JSON Schema (captchaai-doctor schema)
• Bundled local mock demos for Turnstile and reCAPTCHA v2 (no API key needed)
• Real-API tested end to end (see docs/real-e2e-evidence.md)
• 134 tests, ruff + mypy --strict clean
• 3 GitHub Actions workflows: lint+type+test (3.11/3.12), demo-smoke (real Chromium), gitleaks

Get started

git clone https://github.com/CaptchaAI/captchaai-workflow-doctor
cd captchaai-workflow-doctor
python -m venv .venv && . .venv/bin/activate
pip install -e '.[dev]'
python -m playwright install chromium
captchaai-doctor demo turnstile

See README and docs/ for the full walkthrough.

Status

Repo is private during beta. To go public, see PROGRESS.md.