feat(testgen): support pip install

[aarthy-dk]

Summary

Adds a pip-via-uv install path for TestGen alongside the existing Docker Compose path, driven by Windows Docker abandonment data. End users now have a one-command experience: tg install resolves the right mode, runs the install steps, and leaves the app running.

Motivation

Telemetry shows a meaningful share of Windows users abandon installs at the Docker prerequisite step. The pip path uses an embedded Postgres and a uv-managed venv, removing Docker as a hard requirement for evaluation/light use. Docker remains the recommended path for persistent installs.

What's new

• tg install --pip / tg install --docker — explicit mode selection. With no flag, the installer auto-detects: if Docker prerequisites pass it prompts the user for a mode; if Docker can't even be reached (engine missing, registry blocked) it asks Install with pip instead? [Y/n] rather than silently routing.
• tg start — new command that runs the app. Pip mode runs testgen run-app in the foreground until Ctrl+C; Docker mode runs docker compose up --wait.
• Auto-start at the end of tg install (pip mode) — "one command, app running" requirement. The installer keeps the foreground subprocess alive until the user interrupts, then prints a tg start hint for next time.
• All TestGen sub-commands handle both modes — tg upgrade, tg delete, tg run-demo, tg delete-demo read an install marker (dk-tg-install.json) and dispatch accordingly. Legacy Docker installs without a marker are still recognized via the compose-file + credentials fallback.
• Telemetry — install_mode, actual installed testgen_version, actual installed uv_version (parsed from uv --version), and uv_source (existing-on-PATH vs downloaded) on every relevant event.

Architecture notes for reviewers

• Single Testgen*Action per CLI command, replacing an earlier dispatcher pattern (separate *PipInstall, *DockerInstall, etc. classes). Each unified class resolves mode once in check_requirements, persists self._resolved_mode, and switches self.steps / branches in execute accordingly. See "TestGen install modes" in CLAUDE.md for the pattern.
• Per-invocation reset (Action._per_invocation_attrs + _reset_per_invocation_state) clears _cmd_idx, ctx, _resolved_mode, etc. at the top of execute_with_log so repeated invocations from the Windows menu start fresh.
• uv bootstrap pins UV_VERSION = 0.11.7 and SHA256-pins each platform asset. Three retries with exponential backoff for transient network errors; deterministic failures (SHA256 mismatch, malformed archive) fail fast. Bump procedure documented in CLAUDE.md.
• start_testgen_app uses Popen directly with DEVNULL for stdout/stderr (TestGen writes its own logs via TESTGEN_LOG_FILE_PATH; capturing the pipes would deadlock on the indefinite-running subprocess once the OS pipe buffer fills). Port readiness is detected via socket.create_connection polling.
• Config-driven port/SSL for start_testgen_app — reads ~/.testgen/config.env rather than args so tg start works without re-passing --port / --ssl-* flags.

Test plan

• Linux/macOS pip install: python3 dk-installer.py tg install --pip → app reachable at http://localhost:8501. Ctrl+C → tg start brings it back up at the same URL.
• Linux/macOS Docker install: python3 dk-installer.py tg install --docker → containers running, URLs in dk-tg-credentials.txt. tg start after docker compose down brings them back.
• Auto-detect with Docker missing: uninstall Docker, run tg install (no flag) → "Docker is not fully available... Install TestGen with pip? [Y/n]" prompt. Y → pip install; n → abort with hints.
• Auto-detect with Docker present: run tg install (no flag) → [d] Docker / [p] Pip prompt. Both choices route correctly.
• Custom port: tg install --pip --port 9000 → app at :9000. Ctrl+C, tg start → still :9000 (read from ~/.testgen/config.env, no flag re-pass needed).
• Mode-aware upgrade/delete/run-demo/delete-demo: install one mode, run each sub-command, verify the right path is taken (e.g., pip delete removes ~/.testgen and dataops-testgen from uv's tool list; docker delete removes containers and volumes).
• Existing-install detection: install once, run tg install again → "Found an existing TestGen … installation" abort with tg upgrade / tg delete hints.
• Legacy Docker install detection: with no dk-tg-install.json but docker-compose.yml + dk-tg-credentials.txt present, tg upgrade / tg delete should still resolve to Docker mode.
• Windows .exe via menu: install → run via menu, then run another menu action, then run install again — confirm no state leaks across invocations (e.g., correct mode resolution each time).
• Support zip on failure: trigger an install failure (e.g., set up a port collision, or block docker.io), confirm the .dk-installer/<action>-<timestamp>.zip contains the expected per-command output and that the autogenerated password is not in any file.
• Existing obs install / obs upgrade / obs delete flows — regression check, no behavior changes intended.

Files

• dk-installer.py (~+930 lines) — the installer.
• tests/ — 174 tests passing; new files for pip install/upgrade/delete/demo, the tg start command, install-mode marker, and uv bootstrap.
• CLAUDE.md, README.md, .gitignore updated.

[github-actions]

Coverage Report •

File	Stmts	Miss	Cover	Missing
dk-installer.py	1767	413	77%	154–155, 159–160, 172–184, 212–213, 216, 221–225, 235–236, 245–257, 262, 275, 321–322, 381, 421–428, 435, 447, 469–470, 514, 564–567, 586–587, 589, 639–668, 672–705, 736–754, 825, 896–897, 965, 982–983, 1000–1005, 1079–1080, 1090, 1106–1110, 1113, 1116, 1119, 1130–1163, 1257, 1263, 1309, 1312, 1319–1320, 1326–1328, 1428–1439, 1488–1503, 1506–1517, 1534–1535, 1572–1573, 1599–1600, 1607, 1612, 1618–1619, 1652–1655, 1664–1665, 1670–1671, 1687–1698, 1743–1745, 1924–1949, 1990–1993, 2058–2061, 2114, 2139–2141, 2149–2151, 2200, 2202, 2204, 2316–2317, 2335, 2365, 2374, 2377–2379, 2422–2434, 2439–2446, 2454–2464, 2500–2501, 2517, 2532–2534, 2571, 2679–2749, 2752–2754, 2757–2759, 2825, 2868–2886, 2890, 2895, 2946–2948, 2951–2953, 2979–2982, 3001–3017, 3020–3022, 3025–3027, 3051–3056, 3065–3067, 3103–3111, 3114–3116, 3122–3124, 3188–3190, 3195, 3206–3209, 3214–3215, 3221–3222, 3233–3242, 3251–3305, 3309–3345, 3349–3364
TOTAL	1767	413	77%

Tests	Skipped	Failures	Errors	Time
178	0 💤	0 ❌	0 🔥	2.141s ⏱️