Testing Infrastructure and Guardrails

Testing Infrastructure and Guardrails An architecture diagram generated by Archify. src/notebooklm · system under test · Architecture component src/notebooklm system under test Unit tests · logic · local I/O · Deterministic, credential-free validation Unit tests logic · local I/O Server adapter tests · REST behavior and mappings · Deterministic, credential-free validation Server adapter tests REST behavior and mappings VCR integration · recorded Web + Android replay · Deterministic, credential-free validation VCR integration recorded Web + Android replay Authenticated E2E · live Google · explicit credentials · Architecture component Authenticated E2E live Google · explicit credentials Real-loopback faults · HTTP · gRPC · curl transports · Deterministic, credential-free validation · local, deterministic Real-loopback faults HTTP · gRPC · curl transports local, deterministic Static guardrails · contracts · fixtures · APIs · docs · Deterministic, credential-free validation Static guardrails contracts · fixtures · APIs · docs PR / push CI · quality + focused OS/Python matrix · Architecture component · test lanes use --no-cov PR / push CI quality + focused OS/Python matrix test lanes use --no-cov Fault stress CI · PR full deck · scheduled ≥400 · Architecture component Fault stress CI PR full deck · scheduled ≥400 Nightly CI · coverage · full scheduled matrix · Architecture component · coverage owner Nightly CI coverage · full scheduled matrix coverage owner ordinary suite seeded stress coverage floors protected live lanes Deterministic, credential-free validation Legend Backend Database Cloud Security Message bus External

Two kinds of integration evidence

  • • VCR replays sanitized recordings; the fault suite drives real loopback sockets.
  • • Both are local and credential-free; neither is a live Google API run.

CI scope

  • • PR test lanes use --no-cov; quality still audits threshold configuration and RPC coverage.
  • • Nightly enforces ≥90% aggregate plus per-file floors; scheduled runs add the full 3×5 matrix.