@its-not-rocket-science/ananke 0.1.54 → 0.1.56

package/CHANGELOG.md

@@ -6,6 +6,38 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.56] — 2026-03-30
+
+### Added
+
+- **PA-7 — Advanced Non-Visual Sensory Systems (complete):**
+  - `src/sim/sensory-extended.ts`: added `thermalVisionRange_m?: number` to `ExtendedSenses` interface — fourth modality alongside echolocation, electroreception, and olfaction. Effective range scales with target thermal signature; degraded by precipitation; dead entities have no thermal signature.
+  - `src/extended-senses.ts` (new): unified extended-senses module with `AtmosphericState` integration (PA-6).
+    - Body-plan predicates: `hasEcholocation`, `hasElectroreception`, `hasThermalVision`, `hasOlfaction`, `dominantSense` (priority: electroreception > echolocation > thermal > olfaction > vision).
+    - `thermalSignature(entity)` → Q: dead=q(0); living=base q(0.30) + q(0.10) per bleeding region + q(0.15) if shock≥q(0.40).
+    - `canDetectByThermalVision(observer, subject, dist_m, precipIntensity?)`: effective range = baseRange × signature / SCALE.Q × (1 − precipIntensity × 0.60). Detection quality `DETECT_THERMAL = q(0.35)`.
+    - `canDetectExtendedAtmospheric(observer, subject, env, atmospheric, sensorBoost?)`: drop-in replacement for Phase 52 `canDetectExtended` that uses `AtmosphericState.scentStrength_Q` from `queryAtmosphericModifiers` for olfaction, and `precipIntensity_Q` for thermal attenuation.
+    - `stepExtendedSenses(observer, world, atmospheric, env)` → `ExtendedSensesResult { detections }`: per-tick batch detection accumulator; iterates all world entities, checks all four extended modalities, returns `SensoryDetection[]` with `entityId`, `modality`, `quality_Q`, `dist_Sm`. Multiple detections per target are possible.
+  - Exports: `SenseModality`, `SensoryDetection`, `ExtendedSensesResult`, `THERMAL_BASE_SIGNATURE_Q`, `THERMAL_BLEED_BONUS_Q`, `THERMAL_SHOCK_BONUS_Q`, `THERMAL_SHOCK_THRESHOLD`, `THERMAL_PRECIP_PENALTY`, `DETECT_THERMAL`, `DETECT_OLFACTION_ATMO_MIN`, `DETECT_OLFACTION_ATMO_MAX`.
+  - `"./extended-senses"` subpath export added to `package.json`.
+- 60 new tests (187 test files, 5,512 tests total). Build: clean.
+
+---
+
+## [0.1.55] — 2026-03-30
+
+### Added
+
+- **PA-6 — Unified Atmosphere Model (complete):**
+  - `src/atmosphere.ts` (new): single `AtmosphericState` struct derived from Phase 51 `WeatherState` and Phase 68 `BiomeContext`, with a unified per-pair query API.
+  - `deriveAtmosphericState(weather?, biome?)` → `AtmosphericState`: maps WeatherState wind to 3D `AtmosphericWind` (adds `dz_m`, derives `turbulence_Q` from speed); derives `precipIntensity_Q` from precipitation type; computes `baseVisibility_Sm` from fog × precipitation; computes `acousticMask_Q` from wind noise; maps biome `soundPropagation_Q` (vacuum = 0, water = 4×, standard air = 1×); derives `tractionMod_Q` and `thermalOffset_Q` from `deriveWeatherModifiers`.
+  - `queryAtmosphericModifiers(from, to, state)` → `AtmosphericModifiers`: single call yields all position-pair atmospheric effects — `crossWindSpeed_mps` (perpendicular wind for projectile drift), `hazardConeMul_Q` (gas/smoke cone range 0.5×–1.5× from headwind/tailwind), `acousticMaskMul_Q` (hearing range including upwind bonus and biome propagation), `visibilityRange_Sm` (headwind-boosted precipitation degradation), `tractionMod_Q`, `scentStrength_Q` (q(1.0) fully downwind of target, q(0) upwind — prerequisite for PA-7), `thermalOffset_Q`.
+  - `"./atmosphere"` subpath export added to `package.json`.
+  - Exports: `AtmosphericWind`, `AtmosphericState`, `AtmosphericModifiers`, `deriveAtmosphericState`, `queryAtmosphericModifiers`; constants `ATMO_BASE_VISIBILITY_Sm`, `ATMO_ACOUSTIC_FULL_MASK_MPS`, `ATMO_TURBULENCE_FULL_MPS`, `ATMO_HAZARD_TAILWIND_MUL_MAX`, `ATMO_HAZARD_HEADWIND_MUL_MIN`, `ATMO_HEARING_UPWIND_BONUS`.
+- 53 new tests (186 test files, 5,452 tests total). Build: clean.
+
+---
+
 ## [0.1.54] — 2026-03-28
 
 ### Added

package/dist/src/atmosphere.d.ts

@@ -0,0 +1,222 @@
+import { type Q } from "./units.js";
+import { type WeatherState } from "./sim/weather.js";
+import type { BiomeContext } from "./sim/biome.js";
+/**
+ * Wind speed [WindField mps units, 100 per m/s] that produces maximum acoustic
+ * masking (q(1.0)).  Calibrated at 40 m/s (gale / violent storm).
+ */
+export declare const ATMO_ACOUSTIC_FULL_MASK_MPS = 4000;
+/**
+ * Wind speed [WindField mps units] that produces maximum turbulence (q(1.0)).
+ * Calibrated at 50 m/s (hurricane-force).
+ */
+export declare const ATMO_TURBULENCE_FULL_MPS = 5000;
+/**
+ * Clear-sky baseline visibility range [SCALE.m].  1 000 m = 10 000 000 SCALE.m.
+ */
+export declare const ATMO_BASE_VISIBILITY_Sm = 10000000;
+/**
+ * Maximum hazard-cone range multiplier from a strong tailwind (1.5× base range).
+ * Stored as a raw multiplier where SCALE.Q = 1.0.
+ */
+export declare const ATMO_HAZARD_TAILWIND_MUL_MAX = 15000;
+/**
+ * Minimum hazard-cone range multiplier from a strong headwind (0.5× base range).
+ */
+export declare const ATMO_HAZARD_HEADWIND_MUL_MIN = 5000;
+/**
+ * Acoustic hearing range bonus when the sound source is directly upwind
+ * (sound carries toward the listener): +20% of SCALE.Q.
+ */
+export declare const ATMO_HEARING_UPWIND_BONUS = 2000;
+/**
+ * 3-D wind field with vertical component and turbulence.
+ *
+ * Extends `WeatherState.WindField` (2-D) — `deriveAtmosphericState` maps the
+ * existing 2-D wind field and adds a zero vertical component when the source
+ * has no vertical wind data.
+ *
+ * Speed units: 100 units = 1 m/s (same convention as WeatherState.WindField).
+ */
+export interface AtmosphericWind {
+    /** X component of wind direction — unit vector in SCALE.m space. */
+    dx_m: number;
+    /** Y component of wind direction — unit vector in SCALE.m space. */
+    dy_m: number;
+    /**
+     * Vertical (Z) component — positive = rising (updraft).
+     * Unit vector in SCALE.m space.  `0` for standard horizontal wind.
+     */
+    dz_m: number;
+    /** Wind speed [100 units = 1 m/s]. */
+    speed_mps: number;
+    /**
+     * Turbulence intensity [Q 0..SCALE.Q].
+     * q(0) = laminar flow; q(1.0) = severe gusts (hurricane-force).
+     * Added to aim-error grouping radius for ranged attacks; derived from wind
+     * speed by `deriveAtmosphericState`.
+     */
+    turbulence_Q: Q;
+}
+/**
+ * Unified atmospheric state — combines wind, precipitation, visibility,
+ * acoustic environment, and thermal offset into a single queryable struct.
+ *
+ * Build once per tick from `WeatherState` and `BiomeContext` via
+ * `deriveAtmosphericState`, then query per entity-pair via
+ * `queryAtmosphericModifiers`.
+ */
+export interface AtmosphericState {
+    /** 3-D wind field. */
+    wind: AtmosphericWind;
+    /**
+     * Precipitation intensity [Q 0..SCALE.Q].
+     * q(0) = none; q(1.0) = blizzard/torrential rain.
+     * Affects traction, visibility, and acoustic masking.
+     */
+    precipIntensity_Q: Q;
+    /**
+     * Baseline visibility range [SCALE.m] — clear-sky minus fog and precipitation.
+     * `queryAtmosphericModifiers` adjusts this for headwind-driven precipitation.
+     */
+    baseVisibility_Sm: number;
+    /**
+     * Surface traction multiplier [Q].
+     * Multiply `KernelContext.tractionCoeff` by this value (already derived from
+     * `deriveWeatherModifiers().tractionMul_Q`).
+     */
+    tractionMod_Q: Q;
+    /**
+     * Ambient acoustic masking from wind noise [Q 0..SCALE.Q].
+     * q(0) = still air (no masking); q(1.0) = severe wind noise (hearing near zero).
+     * Applied to base hearing range before directional adjustments in
+     * `queryAtmosphericModifiers`.
+     */
+    acousticMask_Q: Q;
+    /**
+     * Sound propagation multiplier from biome [Q].
+     * q(1.0) = normal air propagation (default).
+     * q(0.0) = vacuum (no sound).
+     * q(4.0) = water (~4× faster propagation).
+     * Multiplies the post-masking hearing range in `queryAtmosphericModifiers`.
+     */
+    soundPropagation_Q: Q;
+    /**
+     * Thermal offset in Phase-29 Q encoding.
+     * Add to `KernelContext.thermalAmbient_Q`.
+     */
+    thermalOffset_Q: number;
+}
+/**
+ * Per-pair atmospheric modifiers returned by `queryAtmosphericModifiers`.
+ *
+ * All values are ready to apply:
+ * - Multiply Q fields using `Math.round(value × mul / SCALE.Q)`.
+ * - Add offset fields directly.
+ *
+ * @see queryAtmosphericModifiers
+ */
+export interface AtmosphericModifiers {
+    /**
+     * Perpendicular wind component relative to the shot/query direction
+     * [100 units = 1 m/s].
+     *
+     * Convert to projectile drift [SCALE.m]:
+     * ```
+     * drift_Sm = crossWindSpeed_mps × range_Sm / proj_speed_mps
+     * ```
+     * where `range_Sm` is in SCALE.m and `proj_speed_mps` is in the same
+     * 100-per-m/s wind units.  Zero when the query pair is coincident.
+     */
+    crossWindSpeed_mps: number;
+    /**
+     * Hazard-cone range multiplier for gas/smoke cones aimed from `from` to `to`
+     * [raw factor, SCALE.Q = 1.0].
+     *
+     * Values > SCALE.Q are valid and intentional:
+     * - Tailwind extends range up to `ATMO_HAZARD_TAILWIND_MUL_MAX` (1.5×).
+     * - Headwind reduces range down to `ATMO_HAZARD_HEADWIND_MUL_MIN` (0.5×).
+     * - Crosswind or calm → SCALE.Q (1.0×, no change).
+     *
+     * Apply: `adjustedRange_Sm = Math.round(baseRange_Sm × hazardConeMul_Q / SCALE.Q)`.
+     */
+    hazardConeMul_Q: number;
+    /**
+     * Effective hearing range multiplier [Q 0..SCALE.Q + ATMO_HEARING_UPWIND_BONUS].
+     *
+     * Combines wind noise masking and directional propagation:
+     * - Values < SCALE.Q: hearing degraded (wind noise or vacuum).
+     * - Values up to SCALE.Q + ATMO_HEARING_UPWIND_BONUS: enhanced (sound downwind of listener).
+     *
+     * Apply: `effectiveRange_Sm = Math.round(baseRange_Sm × acousticMaskMul_Q / SCALE.Q)`.
+     */
+    acousticMaskMul_Q: number;
+    /**
+     * Effective visibility range [SCALE.m] for the query direction.
+     * Already adjusted for headwind-driven precipitation and fog.
+     * Use as maximum ranged-detection distance for this query pair.
+     */
+    visibilityRange_Sm: number;
+    /**
+     * Surface traction modifier [Q] — same as `AtmosphericState.tractionMod_Q`.
+     * Included here for convenience so callers can read all mods from one struct.
+     */
+    tractionMod_Q: Q;
+    /**
+     * Scent propagation strength from `to` toward `from` [Q 0..SCALE.Q].
+     *
+     * Physics: the observer at `from` smells the entity at `to` when the wind
+     * blows from `to` toward `from` (i.e., `from` is downwind of `to`).
+     *
+     * - q(1.0) = `from` is directly downwind of `to` (maximum scent).
+     * - q(0)   = `from` is upwind of `to` (no scent reaches observer).
+     * - Intermediate values for crosswind/partial alignment.
+     *
+     * Used by PA-7 olfactory detection.
+     */
+    scentStrength_Q: Q;
+    /**
+     * Thermal offset in Phase-29 Q encoding.
+     * Same as `AtmosphericState.thermalOffset_Q`.
+     */
+    thermalOffset_Q: number;
+}
+/**
+ * Build an `AtmosphericState` from Phase 51 `WeatherState` and Phase 68
+ * `BiomeContext`.
+ *
+ * Both parameters are optional — absent values produce calm, clear-sky,
+ * standard-air atmosphere with no modifiers.
+ *
+ * @example
+ * ```ts
+ * const atmo = deriveAtmosphericState(ctx.weather, ctx.biome);
+ * // Use once per tick, query per entity-pair:
+ * const mods = queryAtmosphericModifiers(attacker, target, atmo);
+ * ```
+ */
+export declare function deriveAtmosphericState(weather?: WeatherState, biome?: BiomeContext): AtmosphericState;
+/**
+ * Query all atmospheric modifiers for a position pair.
+ *
+ * Computes wind-relative effects along the `from → to` vector:
+ * - Crosswind component for projectile drift.
+ * - Tailwind/headwind ratio for hazard-cone range.
+ * - Directional acoustic effects.
+ * - Headwind-boosted precipitation degrading visibility.
+ * - Scent propagation strength (downwind = strong, upwind = none).
+ *
+ * Pure function — no mutation, safe to call multiple times per tick.
+ *
+ * @param from  Observer / attacker position [SCALE.m].
+ * @param to    Target / source position [SCALE.m].
+ * @param state Atmospheric state built by `deriveAtmosphericState`.
+ * @returns     All modifiers for this position pair.
+ */
+export declare function queryAtmosphericModifiers(from: {
+    x_Sm: number;
+    y_Sm: number;
+}, to: {
+    x_Sm: number;
+    y_Sm: number;
+}, state: AtmosphericState): AtmosphericModifiers;

package/dist/src/atmosphere.js

@@ -0,0 +1,200 @@
+// src/atmosphere.ts — PA-6: Unified Atmosphere Model
+//
+// Provides a single `AtmosphericState` struct that derives from WeatherState
+// (Phase 51) and BiomeContext (Phase 68) and exposes a unified query API.
+//
+// `queryAtmosphericModifiers(from, to, state)` returns all atmospheric effects
+// relevant to a position pair in one call — projectile drift, hazard cone
+// distortion, acoustic masking, visibility, traction, and scent propagation —
+// so hosts no longer need per-system wind configuration.
+//
+// Integration:
+//   1. Build once per tick: state = deriveAtmosphericState(weather, biome)
+//   2. Query per-pair:     mods  = queryAtmosphericModifiers(from, to, state)
+//   3. Apply mods to:
+//      - resolveShoot: gRadius_m += crossWindSpeed_mps × range / proj_speed
+//      - adjustConeRange: multiply result by hazardConeMul_Q / SCALE.Q
+//      - sensoryEnv.hearingRange_m: multiply by acousticMaskMul_Q / SCALE.Q
+//      - KernelContext.tractionCoeff: multiply by mods.tractionMod_Q / SCALE.Q
+//      - PA-7 senses: use scentStrength_Q for olfactory detection
+import { SCALE, q, clampQ } from "./units.js";
+import { deriveWeatherModifiers, } from "./sim/weather.js";
+// ── Constants ─────────────────────────────────────────────────────────────────
+/**
+ * Wind speed [WindField mps units, 100 per m/s] that produces maximum acoustic
+ * masking (q(1.0)).  Calibrated at 40 m/s (gale / violent storm).
+ */
+export const ATMO_ACOUSTIC_FULL_MASK_MPS = 4_000;
+/**
+ * Wind speed [WindField mps units] that produces maximum turbulence (q(1.0)).
+ * Calibrated at 50 m/s (hurricane-force).
+ */
+export const ATMO_TURBULENCE_FULL_MPS = 5_000;
+/**
+ * Clear-sky baseline visibility range [SCALE.m].  1 000 m = 10 000 000 SCALE.m.
+ */
+export const ATMO_BASE_VISIBILITY_Sm = 10_000_000;
+/**
+ * Maximum hazard-cone range multiplier from a strong tailwind (1.5× base range).
+ * Stored as a raw multiplier where SCALE.Q = 1.0.
+ */
+export const ATMO_HAZARD_TAILWIND_MUL_MAX = 15_000; // 1.5 × SCALE.Q
+/**
+ * Minimum hazard-cone range multiplier from a strong headwind (0.5× base range).
+ */
+export const ATMO_HAZARD_HEADWIND_MUL_MIN = 5_000; // 0.5 × SCALE.Q
+/**
+ * Acoustic hearing range bonus when the sound source is directly upwind
+ * (sound carries toward the listener): +20% of SCALE.Q.
+ */
+export const ATMO_HEARING_UPWIND_BONUS = 2_000; // 0.2 × SCALE.Q
+// ── Zero-wind sentinel ────────────────────────────────────────────────────────
+const ZERO_WIND = {
+    dx_m: SCALE.m, // direction irrelevant at zero speed; default East
+    dy_m: 0,
+    dz_m: 0,
+    speed_mps: 0,
+    turbulence_Q: q(0),
+};
+// ── deriveAtmosphericState ────────────────────────────────────────────────────
+/**
+ * Build an `AtmosphericState` from Phase 51 `WeatherState` and Phase 68
+ * `BiomeContext`.
+ *
+ * Both parameters are optional — absent values produce calm, clear-sky,
+ * standard-air atmosphere with no modifiers.
+ *
+ * @example
+ * ```ts
+ * const atmo = deriveAtmosphericState(ctx.weather, ctx.biome);
+ * // Use once per tick, query per entity-pair:
+ * const mods = queryAtmosphericModifiers(attacker, target, atmo);
+ * ```
+ */
+export function deriveAtmosphericState(weather, biome) {
+    // ── Wind ──────────────────────────────────────────────────────────────────
+    const srcWind = weather?.wind;
+    const turbulence_Q = srcWind
+        ? clampQ(Math.round(srcWind.speed_mps * SCALE.Q / ATMO_TURBULENCE_FULL_MPS), q(0), SCALE.Q)
+        : q(0);
+    const wind = srcWind
+        ? { dx_m: srcWind.dx_m, dy_m: srcWind.dy_m, dz_m: 0, speed_mps: srcWind.speed_mps, turbulence_Q }
+        : ZERO_WIND;
+    // ── Weather-derived modifiers ─────────────────────────────────────────────
+    const wmod = weather ? deriveWeatherModifiers(weather) : null;
+    const tractionMod_Q = (wmod?.tractionMul_Q ?? SCALE.Q);
+    const thermalOffset_Q = wmod?.thermalOffset_Q ?? 0;
+    // ── Precipitation intensity ───────────────────────────────────────────────
+    // Map WeatherModifiers.precipVisionMul_Q inversely: q(1.0) = none, q(0.30) = blizzard
+    const precipVisionMul = wmod?.precipVisionMul_Q ?? SCALE.Q;
+    // precipIntensity = 1.0 - precipVisionMul (inverted, clamped to [0, 1])
+    const precipIntensity_Q = clampQ((SCALE.Q - precipVisionMul), q(0), SCALE.Q);
+    // ── Visibility ────────────────────────────────────────────────────────────
+    // Fog: q(0) → full visibility; q(1.0) → 1% of baseline
+    const fogDensity = weather?.fogDensity_Q ?? 0;
+    const fogMul = Math.max(100, SCALE.Q - Math.round(fogDensity * 9_900 / SCALE.Q)); // 100..10000
+    const precipMul = precipVisionMul; // already in [q(0.30), q(1.0)]
+    // Combined: fog + precip (multiplicative)
+    const combinedVisionMul = Math.round(fogMul * precipMul / SCALE.Q);
+    const baseVisibility_Sm = Math.max(10 * SCALE.m, // minimum: 10 m visibility
+    Math.round(ATMO_BASE_VISIBILITY_Sm * combinedVisionMul / SCALE.Q));
+    // ── Acoustic masking (ambient wind noise) ─────────────────────────────────
+    const acousticMask_Q = clampQ(Math.round(wind.speed_mps * SCALE.Q / ATMO_ACOUSTIC_FULL_MASK_MPS), q(0), SCALE.Q);
+    // ── Sound propagation from biome ──────────────────────────────────────────
+    const soundPropagation_Q = biome?.soundPropagation !== undefined
+        ? biome.soundPropagation
+        : SCALE.Q;
+    return {
+        wind,
+        precipIntensity_Q,
+        baseVisibility_Sm,
+        tractionMod_Q,
+        acousticMask_Q,
+        soundPropagation_Q,
+        thermalOffset_Q,
+    };
+}
+// ── queryAtmosphericModifiers ─────────────────────────────────────────────────
+/**
+ * Query all atmospheric modifiers for a position pair.
+ *
+ * Computes wind-relative effects along the `from → to` vector:
+ * - Crosswind component for projectile drift.
+ * - Tailwind/headwind ratio for hazard-cone range.
+ * - Directional acoustic effects.
+ * - Headwind-boosted precipitation degrading visibility.
+ * - Scent propagation strength (downwind = strong, upwind = none).
+ *
+ * Pure function — no mutation, safe to call multiple times per tick.
+ *
+ * @param from  Observer / attacker position [SCALE.m].
+ * @param to    Target / source position [SCALE.m].
+ * @param state Atmospheric state built by `deriveAtmosphericState`.
+ * @returns     All modifiers for this position pair.
+ */
+export function queryAtmosphericModifiers(from, to, state) {
+    const shotDx = to.x_Sm - from.x_Sm;
+    const shotDy = to.y_Sm - from.y_Sm;
+    const distSq = shotDx * shotDx + shotDy * shotDy;
+    const dist_Sm = distSq > 0 ? Math.trunc(Math.sqrt(distSq)) : 0;
+    const { wind } = state;
+    // ── Wind-direction geometry ────────────────────────────────────────────────
+    // Dot and cross products of wind direction (unit vector × SCALE.m) with shot
+    // direction (SCALE.m).  Both raw values have units SCALE.m², scaled by dist.
+    // We normalise by dividing by dist_Sm to recover SCALE.m-range cosine/sine.
+    // dotNorm ∈ [-SCALE.m, SCALE.m]: positive = tailwind, negative = headwind.
+    // crossNorm ∈ [0, SCALE.m]: magnitude of perpendicular component.
+    let dotNorm = 0;
+    let crossNorm = 0;
+    if (dist_Sm > 0 && wind.speed_mps > 0) {
+        const dotRaw = wind.dx_m * shotDx + wind.dy_m * shotDy;
+        const crossRaw = wind.dx_m * shotDy - wind.dy_m * shotDx;
+        dotNorm = Math.trunc(dotRaw / dist_Sm); // SCALE.m units (cosine component)
+        crossNorm = Math.trunc(Math.abs(crossRaw) / dist_Sm); // SCALE.m units (sine component)
+        // Clamp to valid range (floating-point-free but integer rounding can exceed SCALE.m)
+        dotNorm = Math.max(-SCALE.m, Math.min(SCALE.m, dotNorm));
+        crossNorm = Math.min(SCALE.m, crossNorm);
+    }
+    // ── Crosswind speed (projectile drift) ───────────────────────────────────
+    // crossWindSpeed_mps = |sin θ| × wind.speed_mps
+    const crossWindSpeed_mps = Math.round(crossNorm * wind.speed_mps / SCALE.m);
+    // ── Hazard-cone multiplier ────────────────────────────────────────────────
+    // At full tailwind (dotNorm = +SCALE.m): 1.5× range.
+    // At full headwind (dotNorm = -SCALE.m): 0.5× range.
+    // Range: [ATMO_HAZARD_HEADWIND_MUL_MIN, ATMO_HAZARD_TAILWIND_MUL_MAX].
+    const HAZARD_HALF_RANGE = Math.round((ATMO_HAZARD_TAILWIND_MUL_MAX - ATMO_HAZARD_HEADWIND_MUL_MIN) / 2);
+    const hazardConeMul_Q = Math.max(ATMO_HAZARD_HEADWIND_MUL_MIN, Math.min(ATMO_HAZARD_TAILWIND_MUL_MAX, SCALE.Q + Math.round(dotNorm * HAZARD_HALF_RANGE / SCALE.m)));
+    // ── Acoustic masking multiplier ───────────────────────────────────────────
+    // Base: 1.0 − ambient wind noise masking.
+    // Directional bonus: source upwind of listener (negative dotNorm) → sound
+    // carries toward the listener → up to +ATMO_HEARING_UPWIND_BONUS.
+    const baseHearing = SCALE.Q - state.acousticMask_Q;
+    const upwindBonus = Math.max(0, Math.round(-dotNorm * ATMO_HEARING_UPWIND_BONUS / SCALE.m));
+    // Apply biome sound propagation (e.g. ×4 in water, ×0 in vacuum)
+    const rawAcousticMul = Math.round((baseHearing + upwindBonus) * state.soundPropagation_Q / SCALE.Q);
+    const acousticMaskMul_Q = Math.max(0, rawAcousticMul);
+    // ── Visibility (directional) ──────────────────────────────────────────────
+    // Headwind drives precipitation particles directly at the sensor, increasing
+    // effective precipitation density and reducing visibility further.
+    const headwindFrac = Math.max(0, -dotNorm); // 0..SCALE.m for headwind
+    // precipBoostPenalty: extra vision reduction from headwind-driven precipitation
+    const precipBoostPenalty = Math.round(headwindFrac * state.precipIntensity_Q / SCALE.m * q(0.30) / SCALE.Q);
+    const visionMul = Math.max(100, // ≥ 1% of base
+    SCALE.Q - Math.round(state.precipIntensity_Q * 3_000 / SCALE.Q) - precipBoostPenalty);
+    const visibilityRange_Sm = Math.max(10 * SCALE.m, Math.round(state.baseVisibility_Sm * visionMul / SCALE.Q));
+    // ── Scent strength ────────────────────────────────────────────────────────
+    // "from" smells "to" when wind blows from to→from (reversed shot direction
+    // aligns with wind direction).
+    // scentDotNorm = -dotNorm (positive = wind blows from `to` toward `from`).
+    const scentDotNorm = -dotNorm;
+    const scentStrength_Q = clampQ(Math.round(scentDotNorm * SCALE.Q / SCALE.m), q(0), SCALE.Q);
+    return {
+        crossWindSpeed_mps,
+        hazardConeMul_Q,
+        acousticMaskMul_Q,
+        visibilityRange_Sm,
+        tractionMod_Q: state.tractionMod_Q,
+        scentStrength_Q,
+        thermalOffset_Q: state.thermalOffset_Q,
+    };
+}

package/dist/src/extended-senses.d.ts

@@ -0,0 +1,146 @@
+import { type Q } from "./units.js";
+import type { Entity } from "./sim/entity.js";
+import type { WorldState } from "./sim/world.js";
+import type { SensoryEnvironment } from "./sim/sensory.js";
+import { type AtmosphericState } from "./atmosphere.js";
+/** Sensory modality used for a detection. */
+export type SenseModality = "vision" | "echolocation" | "electroreception" | "olfaction" | "thermal";
+/**
+ * A single detected entity and the sense used to detect it.
+ *
+ * Multiple detections for the same `entityId` are possible (e.g. a close
+ * target may be detected by both olfaction and echolocation).  Callers should
+ * take the maximum `quality_Q` per entity for targeting decisions.
+ */
+export interface SensoryDetection {
+    /** Id of the detected entity. */
+    entityId: number;
+    /** Modality that produced this detection. */
+    modality: SenseModality;
+    /**
+     * Detection quality [Q 0..SCALE.Q].
+     * Higher = more precise positional information.
+     * q(0.80) = electroreception; q(0.70) = echolocation; q(0.40) = olfaction/thermal.
+     */
+    quality_Q: Q;
+    /** Distance from observer to detected entity [SCALE.m]. */
+    dist_Sm: number;
+}
+/** Result of a `stepExtendedSenses` call. */
+export interface ExtendedSensesResult {
+    /** All detections produced this tick. May be empty. */
+    detections: SensoryDetection[];
+}
+/** Thermal signature of a living entity at rest [Q]. */
+export declare const THERMAL_BASE_SIGNATURE_Q: Q;
+/**
+ * Additional thermal signature per bleeding body region [Q].
+ * Warm blood on the surface raises infrared contrast.
+ */
+export declare const THERMAL_BLEED_BONUS_Q: Q;
+/**
+ * Additional thermal signature when entity shock exceeds `THERMAL_SHOCK_THRESHOLD`.
+ * Fever and inflammation elevate core temperature.
+ */
+export declare const THERMAL_SHOCK_BONUS_Q: Q;
+/** Shock level [Q] above which a fever/inflammatory bonus applies. */
+export declare const THERMAL_SHOCK_THRESHOLD: Q;
+/**
+ * Precipitation reduces effective thermal range.
+ * At precipIntensity_Q = SCALE.Q: range × (1 - THERMAL_PRECIP_PENALTY).
+ */
+export declare const THERMAL_PRECIP_PENALTY: Q;
+/** Detection quality returned for thermal detections. */
+export declare const DETECT_THERMAL: Q;
+/** Minimum olfaction detection quality when atmospheric scentStrength_Q is q(1.0). */
+export declare const DETECT_OLFACTION_ATMO_MIN: Q;
+/** Maximum olfaction detection quality. */
+export declare const DETECT_OLFACTION_ATMO_MAX: Q;
+/** Returns `true` if the entity has echolocation capability. */
+export declare function hasEcholocation(entity: Entity): boolean;
+/** Returns `true` if the entity has electroreception capability. */
+export declare function hasElectroreception(entity: Entity): boolean;
+/** Returns `true` if the entity has thermal (infrared) vision. */
+export declare function hasThermalVision(entity: Entity): boolean;
+/** Returns `true` if the entity has olfaction (scent) capability. */
+export declare function hasOlfaction(entity: Entity): boolean;
+/**
+ * Returns the entity's dominant non-visual sense.
+ *
+ * Priority: electroreception > echolocation > thermal > olfaction > vision.
+ *
+ * Use this to steer AI targeting logic:
+ * - `"echolocation"` → entity can hunt in total darkness.
+ * - `"electroreception"` → entity detects living creatures at close range
+ *   regardless of light, noise, or scent.
+ * - `"thermal"` → entity detects warm-bodied prey by heat signature.
+ * - `"olfaction"` → entity tracks prey by scent trail (wind-dependent).
+ * - `"vision"` → standard visual detection (default).
+ */
+export declare function dominantSense(entity: Entity): SenseModality;
+/**
+ * Compute the thermal signature of an entity [Q 0..SCALE.Q].
+ *
+ * Dead entities return q(0) — no remaining metabolic heat.
+ * Living entities radiate at least `THERMAL_BASE_SIGNATURE_Q`.
+ * Active bleeding and fever raise the signature further.
+ */
+export declare function thermalSignature(entity: Entity): Q;
+/**
+ * Whether observer can detect subject via thermal (infrared) vision.
+ *
+ * - Requires `observer.extendedSenses.thermalVisionRange_m > 0`.
+ * - Dead entities have no thermal signature and are not detected.
+ * - Effective range: `thermalVisionRange_m × signature_Q / SCALE.Q`,
+ *   further reduced by precipitation (`THERMAL_PRECIP_PENALTY`).
+ * - Unaffected by ambient light or noise.
+ *
+ * @param dist_m          Distance from observer to subject [SCALE.m].
+ * @param precipIntensity Precipitation intensity [Q 0..SCALE.Q] from AtmosphericState.
+ */
+export declare function canDetectByThermalVision(observer: Entity, subject: Entity, dist_m: number, precipIntensity?: Q): boolean;
+/**
+ * Full detection check using all four extended modalities, with `AtmosphericState`
+ * integration for olfaction and thermal.
+ *
+ * Returns best detection quality [Q] across all active senses:
+ * - q(1.0):       vision (Phase 4)
+ * - q(0.80):      electroreception
+ * - q(0.70):      echolocation
+ * - q(0.20–0.40): olfaction (atmospheric, wind/precip dependent)
+ * - q(0.35):      thermal (heat-signature dependent)
+ * - q(0):         undetected
+ *
+ * Use this as a drop-in replacement for `canDetectExtended` when an
+ * `AtmosphericState` is available.
+ */
+export declare function canDetectExtendedAtmospheric(observer: Entity, subject: Entity, env: SensoryEnvironment, atmospheric: AtmosphericState, sensorBoost?: {
+    visionRangeMul: Q;
+    hearingRangeMul: Q;
+}): Q;
+/**
+ * Accumulate all extended-sense detections for one observer entity.
+ *
+ * Iterates all entities in `world`, skips the observer itself, and for each
+ * other entity checks all four extended modalities.  Multiple detections per
+ * target are possible and are all returned (callers take the max quality).
+ *
+ * Visual and hearing detection is **not** included — use `canDetect` (Phase 4)
+ * or `canDetectExtendedAtmospheric` for full detection checks.
+ *
+ * @param observer    The sensing entity.
+ * @param world       Current world state (iterated for targets).
+ * @param atmospheric Atmospheric state from `deriveAtmosphericState` (PA-6).
+ * @param env         Sensory environment for echolocation noise level.
+ * @returns           All detections this tick (may be empty).
+ *
+ * @example
+ * ```ts
+ * const atmo = deriveAtmosphericState(ctx.weather, ctx.biome);
+ * const result = stepExtendedSenses(bat, world, atmo, ctx.sensoryEnv ?? DEFAULT_SENSORY_ENV);
+ * for (const det of result.detections) {
+ *   // det.entityId, det.modality, det.quality_Q, det.dist_Sm
+ * }
+ * ```
+ */
+export declare function stepExtendedSenses(observer: Entity, world: WorldState, atmospheric: AtmosphericState, env: SensoryEnvironment): ExtendedSensesResult;

package/dist/src/extended-senses.js

@@ -0,0 +1,310 @@
+// src/extended-senses.ts — PA-7: Advanced Non-Visual Sensory Systems
+//
+// Extends Phase 52 (sensory-extended.ts) with:
+//   - Thermal (infrared) detection — 4th modality alongside echolocation,
+//     electroreception, and olfaction.
+//   - stepExtendedSenses(entity, world, atmospheric, env) — batch per-tick
+//     detection accumulator returning structured results per modality.
+//   - AtmosphericState integration — olfaction uses scentStrength_Q from
+//     queryAtmosphericModifiers (PA-6) rather than re-computing wind alignment.
+//   - Body-plan predicates: hasEcholocation, hasElectroreception,
+//     hasThermalVision, hasOlfaction, dominantSense.
+//
+// Compatibility: fully additive — does not modify the Phase 52 API.  Hosts
+// can replace calls to canDetectExtended with canDetectExtendedAtmospheric
+// for unified atmospheric integration, or continue using Phase 52 directly.
+import { SCALE, q, clampQ, mulDiv } from "./units.js";
+import { canDetect } from "./sim/sensory.js";
+import { canDetectByEcholocation, canDetectByElectroreception, DETECT_ECHOLOCATION, DETECT_ELECTRORECEPTION, } from "./sim/sensory-extended.js";
+import { queryAtmosphericModifiers, } from "./atmosphere.js";
+// ── Constants ─────────────────────────────────────────────────────────────────
+/** Thermal signature of a living entity at rest [Q]. */
+export const THERMAL_BASE_SIGNATURE_Q = q(0.30);
+/**
+ * Additional thermal signature per bleeding body region [Q].
+ * Warm blood on the surface raises infrared contrast.
+ */
+export const THERMAL_BLEED_BONUS_Q = q(0.10);
+/**
+ * Additional thermal signature when entity shock exceeds `THERMAL_SHOCK_THRESHOLD`.
+ * Fever and inflammation elevate core temperature.
+ */
+export const THERMAL_SHOCK_BONUS_Q = q(0.15);
+/** Shock level [Q] above which a fever/inflammatory bonus applies. */
+export const THERMAL_SHOCK_THRESHOLD = q(0.40);
+/**
+ * Precipitation reduces effective thermal range.
+ * At precipIntensity_Q = SCALE.Q: range × (1 - THERMAL_PRECIP_PENALTY).
+ */
+export const THERMAL_PRECIP_PENALTY = q(0.60);
+/** Detection quality returned for thermal detections. */
+export const DETECT_THERMAL = q(0.35);
+/** Minimum olfaction detection quality when atmospheric scentStrength_Q is q(1.0). */
+export const DETECT_OLFACTION_ATMO_MIN = q(0.20);
+/** Maximum olfaction detection quality. */
+export const DETECT_OLFACTION_ATMO_MAX = q(0.40);
+// ── Body-plan predicates ──────────────────────────────────────────────────────
+/** Returns `true` if the entity has echolocation capability. */
+export function hasEcholocation(entity) {
+    return (entity.extendedSenses?.echolocationRange_m ?? 0) > 0;
+}
+/** Returns `true` if the entity has electroreception capability. */
+export function hasElectroreception(entity) {
+    return (entity.extendedSenses?.electroreceptionRange_m ?? 0) > 0;
+}
+/** Returns `true` if the entity has thermal (infrared) vision. */
+export function hasThermalVision(entity) {
+    return (entity.extendedSenses?.thermalVisionRange_m ?? 0) > 0;
+}
+/** Returns `true` if the entity has olfaction (scent) capability. */
+export function hasOlfaction(entity) {
+    return (entity.extendedSenses?.olfactionSensitivity_Q ?? 0) > 0;
+}
+/**
+ * Returns the entity's dominant non-visual sense.
+ *
+ * Priority: electroreception > echolocation > thermal > olfaction > vision.
+ *
+ * Use this to steer AI targeting logic:
+ * - `"echolocation"` → entity can hunt in total darkness.
+ * - `"electroreception"` → entity detects living creatures at close range
+ *   regardless of light, noise, or scent.
+ * - `"thermal"` → entity detects warm-bodied prey by heat signature.
+ * - `"olfaction"` → entity tracks prey by scent trail (wind-dependent).
+ * - `"vision"` → standard visual detection (default).
+ */
+export function dominantSense(entity) {
+    if (hasElectroreception(entity))
+        return "electroreception";
+    if (hasEcholocation(entity))
+        return "echolocation";
+    if (hasThermalVision(entity))
+        return "thermal";
+    if (hasOlfaction(entity))
+        return "olfaction";
+    return "vision";
+}
+// ── Thermal detection ─────────────────────────────────────────────────────────
+/**
+ * Compute the thermal signature of an entity [Q 0..SCALE.Q].
+ *
+ * Dead entities return q(0) — no remaining metabolic heat.
+ * Living entities radiate at least `THERMAL_BASE_SIGNATURE_Q`.
+ * Active bleeding and fever raise the signature further.
+ */
+export function thermalSignature(entity) {
+    if (entity.injury?.dead)
+        return q(0);
+    let sig = THERMAL_BASE_SIGNATURE_Q;
+    // Bleeding: each bleeding region raises infrared contrast (warm blood visible)
+    if (entity.injury !== undefined) {
+        for (const region of Object.values(entity.injury.byRegion)) {
+            if (region.bleedingRate > 0) {
+                sig += THERMAL_BLEED_BONUS_Q;
+            }
+        }
+    }
+    // Fever / high shock: inflammation raises skin temperature
+    if ((entity.injury?.shock ?? 0) >= THERMAL_SHOCK_THRESHOLD) {
+        sig += THERMAL_SHOCK_BONUS_Q;
+    }
+    return clampQ(Math.round(sig), q(0), SCALE.Q);
+}
+/**
+ * Whether observer can detect subject via thermal (infrared) vision.
+ *
+ * - Requires `observer.extendedSenses.thermalVisionRange_m > 0`.
+ * - Dead entities have no thermal signature and are not detected.
+ * - Effective range: `thermalVisionRange_m × signature_Q / SCALE.Q`,
+ *   further reduced by precipitation (`THERMAL_PRECIP_PENALTY`).
+ * - Unaffected by ambient light or noise.
+ *
+ * @param dist_m          Distance from observer to subject [SCALE.m].
+ * @param precipIntensity Precipitation intensity [Q 0..SCALE.Q] from AtmosphericState.
+ */
+export function canDetectByThermalVision(observer, subject, dist_m, precipIntensity) {
+    const baseRange = observer.extendedSenses?.thermalVisionRange_m;
+    if (!baseRange || baseRange <= 0)
+        return false;
+    if (subject.injury?.dead)
+        return false;
+    const sig = thermalSignature(subject);
+    if (sig <= 0)
+        return false;
+    // Signature scales effective range (high-signature targets detectable at greater range)
+    const sigRange = mulDiv(baseRange, sig, SCALE.Q);
+    // Precipitation attenuates thermal radiation
+    const precipPenalty = precipIntensity !== undefined
+        ? mulDiv(THERMAL_PRECIP_PENALTY, precipIntensity, SCALE.Q)
+        : 0;
+    const precipMul = Math.max(0, SCALE.Q - precipPenalty);
+    const effectiveRange = mulDiv(sigRange, precipMul, SCALE.Q);
+    return dist_m <= effectiveRange;
+}
+// ── Atmospheric olfaction ─────────────────────────────────────────────────────
+/**
+ * Compute olfaction detection quality using pre-computed atmospheric context.
+ *
+ * Replaces calling `deriveScentDetection` when an `AtmosphericState` is
+ * available — uses `scentStrength_Q` from `queryAtmosphericModifiers` instead
+ * of independently re-computing wind alignment.
+ *
+ * @returns Q quality ∈ [0, DETECT_OLFACTION_ATMO_MAX].
+ */
+function _olfactionQualityAtmospheric(observer, subject, dist_m, scentStrength_Q, precipIntensity_Q) {
+    const sens = observer.extendedSenses?.olfactionSensitivity_Q;
+    if (!sens || sens <= 0)
+        return q(0);
+    if (dist_m <= 0)
+        return DETECT_OLFACTION_ATMO_MAX;
+    // Reference range: q(1.0) sensitivity detects at 50 m downwind (500 000 Sm)
+    const REF_RANGE_m = 50 * SCALE.m;
+    const distStrength = clampQ(Math.trunc(sens * REF_RANGE_m / dist_m), q(0), SCALE.Q);
+    // Wind alignment from atmospheric (scentStrength_Q from PA-6)
+    // Precipitation dispersal (q(0) intensity = no dispersal; q(1.0) = 60% reduction)
+    const precipDisperse = Math.max(q(0.20), SCALE.Q - Math.round(precipIntensity_Q * 8_000 / SCALE.Q));
+    const combined = Math.trunc(Math.trunc(distStrength * scentStrength_Q / SCALE.Q) * precipDisperse / SCALE.Q);
+    if (combined < DETECT_OLFACTION_ATMO_MIN)
+        return q(0);
+    return clampQ(combined, DETECT_OLFACTION_ATMO_MIN, DETECT_OLFACTION_ATMO_MAX);
+}
+// ── canDetectExtendedAtmospheric ──────────────────────────────────────────────
+/**
+ * Full detection check using all four extended modalities, with `AtmosphericState`
+ * integration for olfaction and thermal.
+ *
+ * Returns best detection quality [Q] across all active senses:
+ * - q(1.0):       vision (Phase 4)
+ * - q(0.80):      electroreception
+ * - q(0.70):      echolocation
+ * - q(0.20–0.40): olfaction (atmospheric, wind/precip dependent)
+ * - q(0.35):      thermal (heat-signature dependent)
+ * - q(0):         undetected
+ *
+ * Use this as a drop-in replacement for `canDetectExtended` when an
+ * `AtmosphericState` is available.
+ */
+export function canDetectExtendedAtmospheric(observer, subject, env, atmospheric, sensorBoost) {
+    // Phase 4 vision + hearing (existing canDetect)
+    const primary = canDetect(observer, subject, env, sensorBoost);
+    if (primary > q(0))
+        return primary;
+    // Distance (integer sqrt over 3D position)
+    const dx = subject.position_m.x - observer.position_m.x;
+    const dy = subject.position_m.y - observer.position_m.y;
+    const dz = subject.position_m.z - observer.position_m.z;
+    const dist_m = Math.trunc(Math.sqrt(dx * dx + dy * dy + dz * dz));
+    // Electroreception
+    if (canDetectByElectroreception(observer, subject, dist_m)) {
+        return DETECT_ELECTRORECEPTION;
+    }
+    // Echolocation — use atmospheric noiseMul if available
+    // acousticMaskMul_Q → inverse of noiseMul: q(1.0) = normal noise, lower = quieter
+    // Existing canDetectByEcholocation takes noiseMul directly from env
+    if (canDetectByEcholocation(observer, subject, dist_m, env.noiseMul)) {
+        return DETECT_ECHOLOCATION;
+    }
+    // Thermal detection
+    if (canDetectByThermalVision(observer, subject, dist_m, atmospheric.precipIntensity_Q)) {
+        return DETECT_THERMAL;
+    }
+    // Olfaction (atmospheric integration)
+    const from2d = { x_Sm: observer.position_m.x, y_Sm: observer.position_m.y };
+    const to2d = { x_Sm: subject.position_m.x, y_Sm: subject.position_m.y };
+    const mods = queryAtmosphericModifiers(from2d, to2d, atmospheric);
+    const olfactionQ = _olfactionQualityAtmospheric(observer, subject, dist_m, mods.scentStrength_Q, atmospheric.precipIntensity_Q);
+    if (olfactionQ > q(0))
+        return olfactionQ;
+    return q(0);
+}
+// ── stepExtendedSenses ────────────────────────────────────────────────────────
+/**
+ * Accumulate all extended-sense detections for one observer entity.
+ *
+ * Iterates all entities in `world`, skips the observer itself, and for each
+ * other entity checks all four extended modalities.  Multiple detections per
+ * target are possible and are all returned (callers take the max quality).
+ *
+ * Visual and hearing detection is **not** included — use `canDetect` (Phase 4)
+ * or `canDetectExtendedAtmospheric` for full detection checks.
+ *
+ * @param observer    The sensing entity.
+ * @param world       Current world state (iterated for targets).
+ * @param atmospheric Atmospheric state from `deriveAtmosphericState` (PA-6).
+ * @param env         Sensory environment for echolocation noise level.
+ * @returns           All detections this tick (may be empty).
+ *
+ * @example
+ * ```ts
+ * const atmo = deriveAtmosphericState(ctx.weather, ctx.biome);
+ * const result = stepExtendedSenses(bat, world, atmo, ctx.sensoryEnv ?? DEFAULT_SENSORY_ENV);
+ * for (const det of result.detections) {
+ *   // det.entityId, det.modality, det.quality_Q, det.dist_Sm
+ * }
+ * ```
+ */
+export function stepExtendedSenses(observer, world, atmospheric, env) {
+    const detections = [];
+    const hasEcho = hasEcholocation(observer);
+    const hasElec = hasElectroreception(observer);
+    const hasThermal = hasThermalVision(observer);
+    const hasOlf = hasOlfaction(observer);
+    // Early-out if observer has no extended senses
+    if (!hasEcho && !hasElec && !hasThermal && !hasOlf) {
+        return { detections };
+    }
+    const obsX = observer.position_m.x;
+    const obsY = observer.position_m.y;
+    const obsZ = observer.position_m.z;
+    for (const subject of world.entities) {
+        if (subject.id === observer.id)
+            continue;
+        const dx = subject.position_m.x - obsX;
+        const dy = subject.position_m.y - obsY;
+        const dz = subject.position_m.z - obsZ;
+        const dist_m = Math.trunc(Math.sqrt(dx * dx + dy * dy + dz * dz));
+        // Electroreception
+        if (hasElec && canDetectByElectroreception(observer, subject, dist_m)) {
+            detections.push({
+                entityId: subject.id,
+                modality: "electroreception",
+                quality_Q: DETECT_ELECTRORECEPTION,
+                dist_Sm: dist_m,
+            });
+        }
+        // Echolocation
+        if (hasEcho && canDetectByEcholocation(observer, subject, dist_m, env.noiseMul)) {
+            detections.push({
+                entityId: subject.id,
+                modality: "echolocation",
+                quality_Q: DETECT_ECHOLOCATION,
+                dist_Sm: dist_m,
+            });
+        }
+        // Thermal
+        if (hasThermal && canDetectByThermalVision(observer, subject, dist_m, atmospheric.precipIntensity_Q)) {
+            detections.push({
+                entityId: subject.id,
+                modality: "thermal",
+                quality_Q: DETECT_THERMAL,
+                dist_Sm: dist_m,
+            });
+        }
+        // Olfaction (atmospheric integration)
+        if (hasOlf) {
+            const from2d = { x_Sm: obsX, y_Sm: obsY };
+            const to2d = { x_Sm: subject.position_m.x, y_Sm: subject.position_m.y };
+            const mods = queryAtmosphericModifiers(from2d, to2d, atmospheric);
+            const q_olf = _olfactionQualityAtmospheric(observer, subject, dist_m, mods.scentStrength_Q, atmospheric.precipIntensity_Q);
+            if (q_olf > q(0)) {
+                detections.push({
+                    entityId: subject.id,
+                    modality: "olfaction",
+                    quality_Q: q_olf,
+                    dist_Sm: dist_m,
+                });
+            }
+        }
+    }
+    return { detections };
+}

package/dist/src/sim/sensory-extended.d.ts

@@ -27,6 +27,17 @@ export interface ExtendedSenses {
      * Precipitation disperses scent.
      */
     olfactionSensitivity_Q?: Q;
+    /**
+     * Thermal (infrared) detection range [SCALE.m].
+     * Non-zero = entity detects warm-bodied targets by heat signature.
+     * Effective range scales with target thermal signature strength.
+     * Degraded by precipitation (water absorbs thermal radiation).
+     * Dead entities have no thermal signature — not detectable.
+     *
+     * Added by PA-7. Typical values: pit-viper ≈ 5 m (50 000 Sm);
+     * evolved predator ≈ 30 m (300 000 Sm).
+     */
+    thermalVisionRange_m?: number;
 }
 /** Detected via echolocation — returned by canDetectExtended. */
 export declare const DETECT_ECHOLOCATION: Q;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -185,6 +185,14 @@
     "./terrain-bridge": {
       "import": "./dist/src/terrain-bridge.js",
       "types": "./dist/src/terrain-bridge.d.ts"
+    },
+    "./atmosphere": {
+      "import": "./dist/src/atmosphere.js",
+      "types": "./dist/src/atmosphere.d.ts"
+    },
+    "./extended-senses": {
+      "import": "./dist/src/extended-senses.js",
+      "types": "./dist/src/extended-senses.d.ts"
     }
   },
   "workspaces": [