Palash DebnathandClaude Opus 4.8
24a00bea64
* test(probe): add spec-driven AI-agent test harness (L1/L2/L4/L5 + report + triage) Introduces `tests/probe/`, a portable, mostly-deterministic test harness built on the Actor/Judge split: AI agents may drive and self-heal, but verdicts are always deterministic code + metrics — no LLM on the verdict path. Layers: - L1 API: Schemathesis property-fuzz over in-process ASGI (enable-on-demand). - L2 web: Playwright Driver + deterministic self-heal (id→test-id→text, loosened CSS) → pluggable Healer; LLMHealer/anthropic_healer for genuine agentic heal. Judges + self-heal logic unit-tested offline via FakePage; live browser skips. - L4 media: audio correctness — exists/decode/duration/not-silent/clipping/NaN, round-trip ASR WER (pure-python, faster-whisper backend), speaker similarity. No golden-WAV (device-stable metrics only); naturalness is advisory-only. - L5 env/first-run: fresh-data-dir backend boot in a SUBPROCESS (no session contamination), asserts health + DB init + endpoint reachability. Docker gated. Plus: hybrid YAML spec engine + JudgeResult/registry; self-contained HTML report that auto-opens (suppressed in CI/headless/PROBE_NO_OPEN); Triager that clusters failures and drafts a prefilled GitHub issue URL (sanitized, no auto-submit) with a one-click button in the report. Dependency-light: runs in the base venv; schemathesis/resemblyzer/playwright/ anthropic are enable-on-demand and skip cleanly. Generated reports gitignored. Full suite green (657 passed); no contamination of existing tests. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * test(probe): add L3 desktop layer (Tauri config-integrity + guarded launch) Per the architecture decision, desktop E2E is substituted by backend-over-HTTP (L5) + browser (L2) since Tauri has no official macOS WebDriver. L3 guards the packaging/shell contract a browser test can't see, against the real tauri.conf.json (with platform-override merge), running on any platform with no Tauri toolchain: - version parity between tauri.conf.json and pyproject (release integrity) - dev/build wiring (devUrl matches the Vite frontend, frontendDist, before* cmds) - bundled binaries first-run depends on (uv / ffmpeg / ffprobe in externalBin) - CSP actually permits the local backend origins (desktop-only failure mode: packaged app can't reach :3900 while the browser build works) Adds desktop.py (config load + platform deep-merge + bundle discovery + launch guard), judges/desktop.py (config_present/config_eq/config_contains/csp_allows), desktop_smoke.probe.yaml, and tests covering integrity, platform-merge replace semantics, and a live bundle launch that skips without a built bundle/display. Full suite green (662 passed). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
27 lines
1.3 KiB
Python
27 lines
1.3 KiB
Python
"""probe — a spec-driven test harness for OmniVoice Studio (and reusable beyond it).
|
|
|
|
Design spine: **separate the Actor from the Judge.**
|
|
|
|
- The *Actor* (an AI agent, an HTTP call, a browser session) drives the app.
|
|
It is allowed to be flexible, self-healing, non-deterministic.
|
|
- The *Judge* renders the verdict. It is deterministic code + objective
|
|
metrics only. **No LLM ever sits on the verdict path** (except an explicitly
|
|
labelled, non-blocking ``advisory`` lane).
|
|
|
|
This package currently ships the deterministic Judge side first — the part that
|
|
is trustworthy — across these layers:
|
|
|
|
L1 api_fuzz.py Schemathesis property fuzzing of the FastAPI app.
|
|
L4 judges/ Media verification (audio correctness, not quality).
|
|
-- spec.py The hybrid YAML spec engine that wires judges together.
|
|
|
|
The honest ceiling (read tests/probe/README.md): this harness verifies that
|
|
output is *correct and not broken*. It does NOT verify that output is *good*
|
|
(natural, well-prosodied, accurate accent). Those stay human-judgment-only;
|
|
the naturalness metrics live in the non-blocking ``advisory`` lane.
|
|
"""
|
|
|
|
from .spec import JudgeResult, Spec, load_spec, run_judges, JUDGE_REGISTRY
|
|
|
|
__all__ = ["JudgeResult", "Spec", "load_spec", "run_judges", "JUDGE_REGISTRY"]
|