Aye-Aye Percussive Foraging: Resonance Grub Detection (2D)

Aye-ayes are documented "percussive foragers": the thin, specialized middle finger taps a branch several times per second while the animal's oversized ears listen for the change in the tap's vibration that betrays a hollow beetle-larva tunnel underneath the bark. This 2D companion turns that behaviour into a real bioacoustic model instead of a decorative tapping animation. Every tap is solved as a damped harmonic oscillator: a solid wood plug has high stiffness and low damping, producing a sharp, high-pitched decay; a grub cavity thins the surrounding wood shell, which lowers the effective stiffness and raises the damping, so the tap's frequency drops and its decay speeds up — the same "hollow thunk" a real listener would notice. The strength of that signature fades the deeper the cavity sits below the bark, mirroring how a real vibration attenuates with distance, so the aye-aye's detector compares each tap's (frequency, damping) reading against the solid-wood baseline, adds measurement noise, and only flags a hit once the resulting confidence clears the sensitivity threshold you set. A correctly flagged grub is still only harvested if the finger-reach-depth slider is deep enough to physically extract it — so cavity density, detection sensitivity and finger reach each drive a real, independently verifiable change in the detection and extraction statistics on the panel.