Files
wickra/fuzz/fuzz_targets/indicator_update_crosssection.rs
kingchenc c096943bdf feat(breadth): complete the Market Breadth family (14 indicators) (#157)
Completes expansion-roadmap block **A2 — Market Breadth**: the 14 indicators that remained after the `AdvanceDecline` bootstrap, all built on the existing `CrossSection` input.

## Indicators (all scalar `Indicator<Input = CrossSection, Output = f64>`)

| Indicator | Reading |
|-----------|---------|
| `AdvanceDeclineRatio` | advancers / decliners |
| `AdVolumeLine` | cumulative net advancing volume |
| `McClellanOscillator` | 19/39 EMAs of ratio-adjusted net advances |
| `McClellanSummationIndex` | running total of the oscillator |
| `Trin` (Arms Index) | A/D ratio over up/down volume ratio |
| `BreadthThrust` (Zweig) | SMA of the advancing-issues share |
| `NewHighsNewLows` | new highs − new lows |
| `HighLowIndex` | SMA of the record-high percent |
| `PercentAboveMa` | % of the universe above its MA |
| `UpDownVolumeRatio` | advancing / declining volume |
| `BullishPercentIndex` | % on a point-and-figure buy signal |
| `CumulativeVolumeIndex` | volume-normalised cumulative net advancing volume |
| `AbsoluteBreadthIndex` | \|advancers − decliners\| |
| `TickIndex` | instantaneous net advancers − decliners |

## Input model

`AdVolumeLine` and `CumulativeVolumeIndex` are kept distinct (the latter normalises each tick's net advancing volume by total volume, so it stays comparable across volume regimes). `PercentAboveMa` and `BullishPercentIndex` need a per-symbol state signal that `Member` did not carry, so `Member` gains two additive flags (`above_ma`, `on_buy_signal`) via a new `Member::with_signals` constructor; the 4-arg `Member::new` leaves both cleared, so every existing caller and binding is unchanged. `CrossSection` gains volume / new-extreme / state aggregation helpers.

## Wiring

Fully wired across the Rust core, the python/node/wasm bindings, the cross-section fuzz target, the README + docs indicator counters (325 → 339), and dedicated python/node streaming-vs-batch tests. `fmt` / `test --workspace --all-features` / `clippy --workspace -D warnings` / node build+test / pytest all green locally.
2026-06-03 17:24:33 +02:00

62 lines
2.7 KiB
Rust

#![no_main]
//! Fuzz market-breadth `Indicator<Input = CrossSection>` implementations with
//! arbitrary cross-section streams.
//!
//! Each iteration consumes a byte stream, interprets it as a sequence of `f64`
//! values (8 bytes each), packs consecutive pairs into [`Member`]s (a `change`
//! and a `volume`, with the high/low flags taken from the value bit parity), and
//! groups the members into bounded-size [`CrossSection`] ticks. Cross-sections
//! are built with `new_unchecked` so the fuzzer can explore degenerate values
//! (non-finite changes, negative volumes, empty-adjacent groups) that the
//! validating constructor would reject — the indicators must never panic,
//! streaming or batched.
use libfuzzer_sys::fuzz_target;
use wickra_core::{AbsoluteBreadthIndex, AdVolumeLine, AdvanceDecline, AdvanceDeclineRatio, BatchExt, BreadthThrust, BullishPercentIndex, CrossSection, CumulativeVolumeIndex, HighLowIndex, Indicator, McClellanOscillator, McClellanSummationIndex, Member, NewHighsNewLows, PercentAboveMa, TickIndex, Trin, UpDownVolumeRatio};
#[inline(never)]
fn drive<I>(make: impl Fn() -> I, sections: &[CrossSection])
where
I: Indicator<Input = CrossSection, Output = f64> + BatchExt,
{
let mut streaming = make();
for section in sections {
let _ = streaming.update(section.clone());
}
let _ = make().batch(sections);
}
fuzz_target!(|data: &[u8]| {
let floats: Vec<f64> = data
.chunks_exact(8)
.map(|c| f64::from_le_bytes(c.try_into().expect("8 bytes")))
.collect();
let members: Vec<Member> = floats
.chunks_exact(2)
.map(|c| Member::new(c[0], c[1], c[0].to_bits() & 1 == 1, c[1].to_bits() & 1 == 1))
.collect();
// Group members into cross-sections of up to eight symbols each so a single
// input yields a stream of ragged universes.
let sections: Vec<CrossSection> = members
.chunks(8)
.filter(|chunk| !chunk.is_empty())
.map(|chunk| CrossSection::new_unchecked(chunk.to_vec(), 0))
.collect();
drive(AdvanceDecline::new, &sections);
drive(AdvanceDeclineRatio::new, &sections);
drive(AdVolumeLine::new, &sections);
drive(McClellanOscillator::new, &sections);
drive(McClellanSummationIndex::new, &sections);
drive(Trin::new, &sections);
drive(|| BreadthThrust::new(10).unwrap(), &sections);
drive(NewHighsNewLows::new, &sections);
drive(|| HighLowIndex::new(10).unwrap(), &sections);
drive(PercentAboveMa::new, &sections);
drive(UpDownVolumeRatio::new, &sections);
drive(BullishPercentIndex::new, &sections);
drive(CumulativeVolumeIndex::new, &sections);
drive(AbsoluteBreadthIndex::new, &sections);
drive(TickIndex::new, &sections);
});