trueno-gpu 0.4.33

Pure Rust PTX generation for NVIDIA CUDA - no LLVM, no nvcc
Documentation
//! Demo report and visual report tests using the sovereign stack
//! (trueno-viz + simular).

use super::*;

// ============================================================================
// Demo report (sovereign stack)
// ============================================================================

#[test]
fn test_demo_sovereign_stack() {
    println!("\n");
    println!("╔══════════════════════════════════════════════════════════════╗");
    println!("║   TRUENO-GPU VISUAL REGRESSION (SOVEREIGN STACK ONLY)        ║");
    println!("║   Dependencies: trueno-viz, simular (path only)              ║");
    println!("╚══════════════════════════════════════════════════════════════╝\n");

    let renderer = get_shared_renderer();
    let size = 8;

    // Test 1: Determinism
    println!("┌─ TEST 1: Determinism ─────────────────────────────────────────┐");
    let output = simulate_gemm(size);
    let png1 = renderer.render_to_png(&output, size as u32, size as u32);
    let png2 = renderer.render_to_png(&output, size as u32, size as u32);

    let result = compare_png_bytes(&png1, &png2, 0);
    println!("│ Diff pixels: {} / {}", result.different_pixels, result.total_pixels);
    println!(
        "│ Status: {}",
        if result.different_pixels == 0 { "PASS ✓ (Identical)" } else { "FAIL ✗" }
    );
    println!("└──────────────────────────────────────────────────────────────┘\n");

    // Test 2: Bug Detection
    println!("┌─ TEST 2: Bug Detection (Accumulator Init) ───────────────────┐");
    let correct = simulate_gemm(size);
    let buggy = simulate_gemm_buggy(size);
    let png_correct = renderer.render_to_png(&correct, size as u32, size as u32);
    let png_buggy = renderer.render_to_png(&buggy, size as u32, size as u32);

    let result = compare_png_bytes(&png_correct, &png_buggy, 0);
    println!(
        "│ Diff pixels: {} / {} ({:.1}%)",
        result.different_pixels,
        result.total_pixels,
        result.diff_percentage()
    );
    println!("│ Max diff: {}", result.max_diff);
    println!(
        "│ Status: {}",
        if result.different_pixels > 0 { "FAIL ✗ (Bug Detected!)" } else { "PASS" }
    );
    println!("└──────────────────────────────────────────────────────────────┘\n");

    // Test 3: Special Values
    println!("┌─ TEST 3: Special Values (NaN, Inf) ───────────────────────────┐");
    let special = vec![f32::NAN, f32::INFINITY, f32::NEG_INFINITY, 0.5];
    let png_special = renderer.render_to_png(&special, 2, 2);
    let result = compare_png_bytes(&png_special, &png_special, 0);
    println!("│ PNG size: {} bytes", png_special.len());
    println!(
        "│ Status: {}",
        if result.different_pixels == 0 { "PASS ✓ (Handled)" } else { "FAIL ✗" }
    );
    println!("└──────────────────────────────────────────────────────────────┘\n");

    // Test 4: Deterministic RNG (simular)
    println!("┌─ TEST 4: Deterministic RNG (simular) ─────────────────────────┐");
    let mut rng = SimRng::new(42);
    let random_input: Vec<f32> = (0..64).map(|_| rng.gen_range_f64(0.0, 1.0) as f32).collect();
    let png_random = renderer.render_to_png(&random_input, 8, 8);
    println!("│ Seed: 42");
    println!("│ Generated: {} random f32 values", random_input.len());
    println!("│ PNG size: {} bytes", png_random.len());
    println!("│ Status: PASS ✓ (Reproducible)                                │");
    println!("└──────────────────────────────────────────────────────────────┘\n");

    println!("╔══════════════════════════════════════════════════════════════╗");
    println!("║  ✓ Using trueno-viz (path: ../trueno-viz)                    ║");
    println!("║  ✓ Using simular (path: ../simular)                          ║");
    println!("║  ✓ NO external crates (sovereign stack only)                 ║");
    println!("║  ✓ Bug detection working                                     ║");
    println!("╠══════════════════════════════════════════════════════════════╣");
    println!("║              100% SOVEREIGN VALIDATION COMPLETE              ║");
    println!("╚══════════════════════════════════════════════════════════════╝\n");
}

/// Generate visual report with saved PNG files
#[test]
fn test_visual_report_sovereign() {
    let report_dir = test_dir("visual_report");
    cleanup(&report_dir);
    fs::create_dir_all(&report_dir).unwrap();

    println!("\n");
    println!("╔══════════════════════════════════════════════════════════════╗");
    println!("║          VISUAL REGRESSION REPORT (SOVEREIGN STACK)          ║");
    println!("║             trueno-viz + simular (path deps only)            ║");
    println!("╚══════════════════════════════════════════════════════════════╝");
    println!();
    println!("Report directory: {}", report_dir.display());
    println!();

    let renderer = get_shared_renderer();

    // TEST CASE 1: Identity Matrix
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    println!("TEST CASE 1: Identity Matrix Multiplication");
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");

    let size = 16;
    let identity: Vec<f32> =
        (0..size * size).map(|i| if i / size == i % size { 1.0 } else { 0.0 }).collect();

    let png_identity = renderer.render_to_png(&identity, size as u32, size as u32);
    let identity_path = report_dir.join("01_identity_matrix.png");
    fs::write(&identity_path, &png_identity).unwrap();

    println!("  Pattern: A @ I = A (metamorphic relation)");
    println!("  Size: {}x{} = {} pixels", size, size, size * size);
    println!("  Saved: {}", identity_path.display());

    let result = compare_png_bytes(&png_identity, &png_identity, 0);
    println!(
        "  Self-comparison: {} diffs, Status: {}",
        result.different_pixels,
        if result.different_pixels == 0 { "✓ PASS" } else { "✗ FAIL" }
    );
    println!();

    // TEST CASE 2: Gradient
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    println!("TEST CASE 2: Gradient (FP Precision Test)");
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");

    let gradient: Vec<f32> = (0..size * size).map(|i| i as f32 / (size * size) as f32).collect();

    let png_gradient = renderer.render_to_png(&gradient, size as u32, size as u32);
    let gradient_path = report_dir.join("02_gradient.png");
    fs::write(&gradient_path, &png_gradient).unwrap();

    println!("  Pattern: Linear gradient 0.0 → 1.0");
    println!("  Purpose: Detect FP precision drift");
    println!("  Saved: {}", gradient_path.display());

    let result = compare_png_bytes(&png_gradient, &png_gradient, 0);
    println!(
        "  Self-comparison: {} diffs, Status: {}",
        result.different_pixels,
        if result.different_pixels == 0 { "✓ PASS" } else { "✗ FAIL" }
    );
    println!();

    // TEST CASE 3: Bug Detection
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    println!("TEST CASE 3: Bug Detection (Accumulator Init)");
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");

    let correct = simulate_gemm(size);
    let buggy = simulate_gemm_buggy(size);

    let png_correct = renderer.render_to_png(&correct, size as u32, size as u32);
    let png_buggy = renderer.render_to_png(&buggy, size as u32, size as u32);

    let correct_path = report_dir.join("03a_gemm_correct.png");
    let buggy_path = report_dir.join("03b_gemm_buggy.png");
    fs::write(&correct_path, &png_correct).unwrap();
    fs::write(&buggy_path, &png_buggy).unwrap();

    println!("  Baseline (correct): {}", correct_path.display());
    println!("  Test (buggy): {}", buggy_path.display());

    let result = compare_png_bytes(&png_correct, &png_buggy, 0);

    println!();
    println!("  ┌─────────────────────────────────────────────────────────┐");
    println!("  │ DIFF ANALYSIS                                           │");
    println!("  ├─────────────────────────────────────────────────────────┤");
    println!("  │ Total pixels:     {:>6}", result.total_pixels);
    println!(
        "  │ Diff pixels:      {:>6} ({:>5.1}%)                      │",
        result.different_pixels,
        result.diff_percentage()
    );
    println!("  │ Max diff:         {:>6}", result.max_diff);
    println!("  ├─────────────────────────────────────────────────────────┤");
    println!("  │ Bug Class: AccumulatorInit                              │");
    println!("  │ Description: Accumulator not initialized to zero        │");
    println!("  │ Fix: Initialize acc = 0.0 before loop                   │");
    println!("  ├─────────────────────────────────────────────────────────┤");
    println!(
        "  │ Status: {}",
        if result.different_pixels > 0 {
            "✗ FAIL (Bug Correctly Detected!)         "
        } else {
            "✓ PASS                                   "
        }
    );
    println!("  └─────────────────────────────────────────────────────────┘");
    println!();

    // TEST CASE 4: Special Values
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    println!("TEST CASE 4: Special Values (NaN, Inf)");
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");

    let special: Vec<f32> = vec![
        f32::NAN,
        f32::INFINITY,
        f32::NEG_INFINITY,
        1e38,
        0.0,
        0.25,
        0.5,
        0.75,
        1.0,
        -1.0,
        f32::MIN_POSITIVE,
        f32::EPSILON,
        100.0,
        -100.0,
        0.001,
        -0.001,
    ];

    let png_special = renderer.render_to_png(&special, 4, 4);
    let special_path = report_dir.join("04_special_values.png");
    fs::write(&special_path, &png_special).unwrap();

    println!("  Values: NaN, +Inf, -Inf, 1e38, normals, denormals");
    println!("  NaN → Magenta (255, 0, 255)");
    println!("  +Inf → White (255, 255, 255)");
    println!("  -Inf → Black (0, 0, 0)");
    println!("  Saved: {}", special_path.display());

    let result = compare_png_bytes(&png_special, &png_special, 0);
    println!(
        "  Self-comparison: {} diffs, Status: {}",
        result.different_pixels,
        if result.different_pixels == 0 { "✓ PASS" } else { "✗ FAIL" }
    );
    println!();

    // TEST CASE 5: Deterministic RNG
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    println!("TEST CASE 5: Deterministic RNG (simular)");
    println!("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");

    let mut rng = SimRng::new(12345);
    let random_data: Vec<f32> = (0..256).map(|_| rng.gen_range_f64(0.0, 1.0) as f32).collect();
    let png_random = renderer.render_to_png(&random_data, 16, 16);
    let random_path = report_dir.join("05_deterministic_random.png");
    fs::write(&random_path, &png_random).unwrap();

    println!("  Seed: 12345 (reproducible)");
    println!("  Size: 16x16 = 256 pixels");
    println!("  Saved: {}", random_path.display());
    println!("  Status: ✓ PASS (Deterministic)");
    println!();

    // SUMMARY
    println!("╔══════════════════════════════════════════════════════════════╗");
    println!("║                      TEST SUMMARY                            ║");
    println!("╠══════════════════════════════════════════════════════════════╣");
    println!("║  Test 1: Identity Matrix        ✓ PASS                       ║");
    println!("║  Test 2: Gradient               ✓ PASS                       ║");
    println!("║  Test 3: Bug Detection          ✓ PASS (bug found)           ║");
    println!("║  Test 4: Special Values         ✓ PASS                       ║");
    println!("║  Test 5: Deterministic RNG      ✓ PASS                       ║");
    println!("╠══════════════════════════════════════════════════════════════╣");
    println!("║  Stack: SOVEREIGN (path deps only)                           ║");
    println!("║    - trueno-viz (../trueno-viz)                              ║");
    println!("║    - simular (../simular)                                    ║");
    println!("║  External crates: ZERO                                       ║");
    println!("╠══════════════════════════════════════════════════════════════╣");
    println!("║           100% SOVEREIGN VALIDATION COMPLETE                 ║");
    println!("╚══════════════════════════════════════════════════════════════╝");
    println!();

    // List generated files
    println!("Generated PNG files:");
    for entry in fs::read_dir(&report_dir).unwrap() {
        let entry = entry.unwrap();
        let metadata = entry.metadata().unwrap();
        println!("  {} ({} bytes)", entry.file_name().to_string_lossy(), metadata.len());
    }
    println!();

    println!("Files preserved at: {}", report_dir.display());
}