Files
serumalt/Source/Tests/AGENTS.md
T
biggy e4cea300db chore: land janitor round 1 and graft integration
Round 1 findings and fixes, all previously uncommitted:
- FXProcessor per-slot DSP history repair (HEAD does not compile without it)
- SynthVoice::getModulationValue, editor control-lock guard
- ExactCompare.h naming the deliberate exact float comparisons
- KnobLookAndFeel replacing the never-installed SerumLookAndFeel
- 55 first-party compiler warnings to 0
- AGENT.md renamed to AGENTS.md across Source/
- graft repository context graph and its hooks
- JANITOR_TASKS.md and UI_UX_AUDIT.md records
2026-10-06 08:50:45 +02:00

1.4 KiB

tests module

Owned files

  • TestMain.cpp

Rules

  • Keep this a headless console harness that drives the real SerumAltAudioProcessor.
  • Check rendered blocks for NaN and inf. Check non-silence over the full preset render, not each block, because note release can legitimately produce silent blocks.
  • Print PASS or FAIL per preset to std::cout.
  • Return a non-zero exit code when any check fails.
  • Never show a JUCE alert window.
  • Do not add GUI interaction beyond juce::ScopedJuceInitialiser_GUI.

IF-THEN

  • IF a check fails THEN increment the failure count and print the preset name.
  • Build and run natively from the repository root with ./build_harness.sh --run. Building the SerumAltTest target alone does not run checks.
  • The harness-only configuration sets SERUMALT_BUILD_PLUGIN=OFF and SERUMALT_BUILD_TESTS=ON. Production scripts disable the harness.
  • The harness links the real processor and editor sources but creates no plugin bundles. Keep that build separation when adding checks.

Examples

// BAD: a failing check does not fail the run
bool ok = ! hasNaN (buffer) && peak (buffer) > 0.001f;   // result ignored
return 0;
// GOOD: accumulate failures and exit non-zero
int failures = 0;
const bool ok = ! hasNaN (buffer) && peak (buffer) > 0.001f;
if (! ok) ++failures;
...
return failures == 0 ? 0 : 1;

This file overrides /AGENTS.md where they conflict.