From 2cb3ded00fd6e7969a3b171259ae3bb7406c1283 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Sun, 11 Oct 2026 09:18:24 +0200 Subject: [PATCH] Release map and prior art: quiet gear identifiable, hull layout from class Map: hull layout and aim point (V15, V16), model rows for layout, located item and the scan, rules R8-R11, and cuts layout-aim and inspection-scanner, for ruling quiet-gear-identifiable-hull-layout-known. Research section 6: game scanners and identification of non-emitting equipment, serving questions scanner-reveals-its-user and scanner-held-or-pulse. Co-Authored-By: Claude Opus 5.5 --- docs/aetheria-release-map.md | 106 ++++++++++++++++-- ...-launch-and-graded-visibility-prior-art.md | 69 ++++++++++++ 2 files changed, 165 insertions(+), 10 deletions(-) diff --git a/docs/aetheria-release-map.md b/docs/aetheria-release-map.md index 51d53d4b2..7c0a2e4a3 100644 --- a/docs/aetheria-release-map.md +++ b/docs/aetheria-release-map.md @@ -8007,8 +8007,10 @@ Imagination imagination-aeth-visibility, session self-2026-10-11-ag, 2026-10-11. Pinned to Aetheria origin/master 93b7ff8da0f67d4958cbe4b6e96f1d824c62a629 (lock-warning and envelope-from-columns merged). Rulings: visibility-per-capability-reveal, sensor-stat-set, illuminator-beamforming, lock-and-visibility-rethink, launcher-lock-solution-quality, -lock-warning-strength, shared-track-bearing-only, missiles-seeker-retarget, vapour-cloud-obscuration. -Prior art: docs/research/lock-launch-and-graded-visibility-prior-art.md (cited below as PA:line). +lock-warning-strength, shared-track-bearing-only, missiles-seeker-retarget, vapour-cloud-obscuration, +quiet-gear-identifiable-hull-layout-known (revision pass by imagination-aeth-quiet-gear, same day). +Prior art: docs/research/lock-launch-and-graded-visibility-prior-art.md (cited below as PA:line; +section 6 for quiet gear and hull layout). This section owns follow-up sensor-stat-set-cut. ## Body facts (probes and source reads at 93b7ff8d) @@ -8103,6 +8105,25 @@ autofire-threshold (FireControl, Entity 82/791/1050/1453), controls-hud (ActionG 1041-1057, 1390-1410), faction-play-1/2 (Flight, Sensor.Ping callers), consumable-ai (Combat.cs). The cuts below keep their hunks out of those regions. +V15. Hull layout (read at 93b7ff8d for ruling quiet-gear-identifiable-hull-layout-known). A hull's +layout is catalog data: `HullData.Hardpoints`, a list of `HardpointData {Type, Position, Shape, +Rotation, Armor, FiringArc}` (ItemData.cs:511-514, 559-569); `HardpointType` has Reactor, Shield, +Sensors, Radiator, Thruster, weapon and other types (Enums.cs:38-53). Entity builds a per-cell map +`Hardpoints[x,y]` at Position + each Shape coordinate, no rotation applied (Entity.cs:941-948). +`EquippedItem.Hardpoint` is the one hardpoint an item occupies, null for Tool gear and the hull +(Entity.cs:1716-1718). `Entity.HullData` is public (131, set 819). Tool gear sits anywhere in +InteriorCells and is not part of the layout. + +V16. Aim point. `Entity.TargetItem` (Entity.cs:76) is written only by `TrySelectTargetItem`, gated +on IsRevealed (344-357); `ResolvedTargetItem` re-checks IsRevealed (363-366). FireControl reads it +in HitProbability (`Silhouette(..., source.ResolvedTargetItem, ...)`, FireControl.cs:362) and freezes +it into `PendingShot.Aimed` at Fire (746, field 1969), read back at 905. `ResolveAimPoint` centres +the kernel on the aimed item's occupied cells, `CellsOf` from GearOccupancy (1748-1753, 1948-1956), +else the hull's centre of mass. Selection lists: the player's cycle (ActionGameManager.cs:431-443), +SchematicDisplay's enemy weapon list (UI/HUD/SchematicDisplay.cs:98-104), AI Combat (Combat.cs:40-53), +which also reads the revealed weapon's RangeDamagePerSecond. About 48 test sites read TargetItem or +Aimed across 8 test files; FireControlCut12Tests pins ResolveAimPoint's cell average (520-590). + ## Model page | Kind | Identity | Lifecycle | Authority | @@ -8112,9 +8133,12 @@ The cuts below keep their hunks out of those regions. | Active emission (`ActiveEmission {Item, HearRange, Mode}` in `Entity.ActiveEmissions`) | (emitting entity, emitting item, tick). No persistent id. | Posted to the emitter's inbox each tick it emits (a ping wavefront in flight: Search; a lock paint inside LockAngle: Track); published in the zone's pre-phase with paints; lives exactly one tick. Never saved. | Sensor.Execute (search) and LockWeapon.Execute (track) through `Entity.Emit`; Entity publishes. HearRange = the emitter's range / its InterceptFactor, fixed at the emit. | | Paint warning (`PaintWarning {Bearing, EmitterClass, Mode, Strength}` in `Entity.IncomingPaints`; was LockWarning / IncomingLocks) | (painted entity, tick, painter beam). No id. | One tick after its last paint (unchanged from lock-warning). Search paints carry Strength 0. | LockWeapon.Execute (Track) and a ping wavefront crossing (Search, Sensor.Execute) call ReceivePaint; Entity publishes. Painted targets are always warned (sensor-stat-set 4). | | Track (`EntityInfoGathered[subject]`) | (observer, subject entity). | Seeded 0 on zone entry, revised each tick by each active sensor (passive gain, decay), plus one gain per ping crossing from the observer's own pings and its allies' (bistatic); removed when the subject leaves; cleared on Deactivate. Runtime only. | Sensor.Execute only, reading the observer's own receivers. Forbidden: shared-track writes (ruling shared-track-bearing-only), presenters, other ships. | -| Reveal (`Reveal {Item, Channel, Bearing, Time}` in the observer's reveal book, keyed (subject, item)) | (observer, subject entity, revealed item), by reference. | Created on the first act the observer's instruments receive; Channel, Bearing and Time refreshed by each later act; filtered on read when the item is destroyed (Durability < .01) or off the subject; removed when the subject leaves the zone; cleared on Deactivate. Not decayed: memory of the sitting. Never saved. | `Entity.Sense` (once per Entity.Update) for light acts and heard emissions; `ReceivePaint` for paints. Forbidden: Sensor's track loop, presenters, another ship, shared tracks. | +| Reveal (`Reveal {Item, Channel, Bearing, Time}` in the observer's reveal book, keyed (subject, item)) | (observer, subject entity, revealed item), by reference. Channel is null for a reveal by inspection (cut inspection-scanner). | Created on the first act the observer's instruments receive, or for every live item when the observer's scanner completes a scan; Channel, Bearing and Time refreshed by each later act; filtered on read when the item is destroyed (Durability < .01) or off the subject; removed when the subject leaves the zone; cleared on Deactivate. Not decayed: memory of the sitting. Never saved. | `Entity.Sense` (once per Entity.Update) for light acts and heard emissions; `ReceivePaint` for paints; `Entity.RecordInspection` (called by the observer's own Scanner) for scans. Forbidden: Sensor's track loop, presenters, another ship, shared tracks. | +| Hull layout knowledge (derived by `Entity.LayoutOf(subject)`) | (observer, subject hull class). The class is the subject's HullData; the layout is its Hardpoints (type, position, shape). | Derived on read: the subject's HullData.Hardpoints while ContactOf(subject).Identified, else empty. Stored nowhere; never says what is fitted. | `Entity.LayoutOf` is the one derivation (ruling quiet-gear-identifiable-hull-layout-known). Readers: IsLocated, the target schematic, the player's cycle. | | Contact (`Contact`, derived by `Entity.ContactOf(subject)`) | (observer, subject). | Derived on read from track, reveals, the zone clock and `BearingMemory`; stored nowhere. Flags: Detected (tracked, or a reveal younger than BearingMemory), Tracked (track > TargetDetectionInfoThreshold, which is VisibleEntities), Classified (detected and any reveal), Identified (track >= TargetGearInfoThreshold, name kept, now the identify threshold). Bearing: the true bearing while tracked, else the freshest reveal's. | `Entity.ContactOf` is the one derivation. HUD and AI read it; VisibleEntities stays the tracked set. | -| Sensor stats (SensorData Sensitivity key 3 = detection power, BeamWidth key 12, InterceptFactor key 13; LockWeaponData.InterceptFactor key 26; ListenerData.Multiple key 1) | Fields of a catalog design; brand flavour through product role quality. | Authored by AetherDb (cut sensor-catalog); resolved per item through StatResolver. PingVisibility (key 7) is retired, never reused. | The catalog. Readers: Sensor (BeamWidth, InterceptFactor), LockWeapon (InterceptFactor), Entity.HearingMultiple (ListenerData). | +| Located item (`FireControl.IsLocated(observer, item)`) and aim point | (observer, subject item). | Derived on every read: revealed, or on a hardpoint of a layout the observer holds. The aim point is the item's own cells when revealed, else its hardpoint's cells; the choice is frozen into the shot with Aimed. | FireControl (R10). TrySelectTargetItem and ResolvedTargetItem gate on IsLocated; anything that reads an item's stats or class (AI weapon choice, schematic weapon rows) gates on IsRevealed. | +| Scan (`Scanner` behaviour; progress per (scanner, target)) | (scanning item, the ship's Target). | Progress builds while the Target is tracked and within Range, at 1/ScanTime per second; falls at the same rate otherwise; reset on target change; at 1 the scan completes (RecordInspection) and progress restarts. Runtime only. | The Scanner behaviour; RecordInspection in Entity.cs writes the reveals. While scanning: a Scan paint (Strength = progress) on the target and an Emit(Item, Range / InterceptFactor, Scan) (question scanner-reveals-its-user, recommended). | +| Sensor stats (SensorData Sensitivity key 3 = detection power, BeamWidth key 12, InterceptFactor key 13; LockWeaponData.InterceptFactor key 26; ListenerData.Multiple key 1; ScannerData Range 1, ScanTime 2, InterceptFactor 3) | Fields of a catalog design; brand flavour through product role quality. | Authored by AetherDb (cut sensor-catalog); resolved per item through StatResolver. PingVisibility (key 7) is retired, never reused. | The catalog. Readers: Sensor (BeamWidth, InterceptFactor), LockWeapon (InterceptFactor), Entity.HearingMultiple (ListenerData). | No empty cell. Two decisions are defaults, not rulings: reveals never decay within a sitting (a ship you saw fire a railgun still has one), and a reveal carries a bearing only; position comes only from @@ -8132,15 +8156,19 @@ gives it"). listeners and settings. - Outputs: EntityInfoGathered and the Visible sets (unchanged meaning), reveals, IncomingPaints, `ContactOf`, `IsRevealed`. -- Derived state: Visibility (sum of light signatures); Contact and its levels; IsRevealed (a reveal +- Derived state: Visibility (sum of light signatures); Contact and its levels; LayoutOf (the + identified subject's hardpoints); IsLocated and the aim point's cells; IsRevealed (a reveal of a live item, after cut reveals-replace-tiers); HearRange (range / alpha at the emit); HearingMultiple (1 with an active sensor, else 0, raised by listener gear). - Demotions: "Visibility is no longer the whole signature; it is the light-channel sum, the track input only." "IsRevealed is no longer derived from track tiers; it is derived from reveals." "A ping is no longer a brightness bump; it is a search emission heard within PingRange / alpha." "TargetedBy and TargetedByCount are not owners of anything; they are deleted (cut contact-hud)." + "Track quality no longer reveals gear; at the identify threshold it gives the hull's layout only, + and quiet gear is learned by inspection." - Forbidden writers: any code writing `VisibilitySources` except `Entity.SetSignature`; any reveal - write outside `Entity.Sense` and `ReceivePaint`; Sensor's track loop writing reveals; any + write outside `Entity.Sense`, `ReceivePaint` and `RecordInspection`; any stats or class read of a + located but unrevealed item (AI dps, schematic weapon rows); Sensor's track loop writing reveals; any presenter or Agents/ code reading another ship's `EntityInfoGathered`, weapons, lock or `IncomingPaints`; shared tracks writing track or reveals. - Shared paths: the player's HUD and the AI read the same `ContactOf`, `VisibleEnemies`, @@ -8196,8 +8224,32 @@ GameplaySettings value (default 6 s). TargetGearInfoThreshold keeps its name and becomes the Identified threshold; TargetArmorInfoThreshold is deleted. R8. IsRevealed(O, item) is true exactly when O holds a reveal of item, item is on its subject and -Durability >= .01 (cut reveals-replace-tiers, under question gear-reveal-by-dwell's recommended -option). +Durability >= .01 (cut reveals-replace-tiers). Question gear-reveal-by-dwell was answered with +neither option: ruling quiet-gear-identifiable-hull-layout-known ("Identifying those quiet +subsystems should still be possible, even if you need special gear to do it. Also, with enough data +to infer the hull class I should know where the reactor is even if I don't have its specs."). Acts +still reveal (R4-R6); watching alone reveals no gear; quiet gear is revealed by inspection (R11). + +R9. Layout. LayoutOf(O, E) is E.HullData.Hardpoints while ContactOf(E).Identified, else empty. +Inferring the hull class is the Identified level (track >= TargetGearInfoThreshold). The layout +says where each mount is and its type; never what is fitted, its class or its specs. + +R10. Located and aimed. IsLocated(O, item) = IsRevealed(O, item) or (item.Hardpoint != null and +LayoutOf(O, item.Entity) holds item.Hardpoint). Subsystem selection (player and AI) gates on +IsLocated. The aim point of a revealed item is its own occupied cells (as today); of a located, +unrevealed item, its hardpoint's cells (Position + Shape). The choice is frozen at Fire with Aimed. +A selection list shows a located, unrevealed item by its hardpoint type only ("Reactor mount"). +Anything that reads an item's stats or class (AI weapon choice by RangeDamagePerSecond, the +schematic's weapon rows) still gates on IsRevealed. + +R11. Inspection. A Scanner (Tool gear, cut inspection-scanner) works on its ship's Target. While the +target is Tracked and within Range, progress rises at 1/ScanTime per second, else falls at the same +rate; a target change resets it. At 1, RecordInspection(target) records a reveal (Channel null, +Bearing and Time as any reveal) of every live non-hull item on the target, and progress restarts. +Under the recommended options of questions scanner-reveals-its-user and scanner-held-or-pulse: each +scanning tick paints the target Mode Scan with Strength = progress, and emits (Item, +Range / InterceptFactor, Scan), so the target is warned and third parties can hear the scanner. +Cargo is not equipment and is not revealed (no cut owns cargo scanning). ## Rationale @@ -8222,6 +8274,22 @@ option). - Hearing and reveals live in one per-entity `Sense` step rather than in Sensor.Execute so that a ship with two sensors or with listener gear and no sensor senses once; Sensor.Execute keeps the track arithmetic byte-for-byte, which the 80 test sites pin. +- Layout from class (R9): recognition works by identifying the class and reading the class + reference for where its mounts are, without the ship's fit or condition (PA section 6b). Layout is + derived from the identify level rather than remembered, because aiming already needs a track. +- Occupancy shows (a default): only filled mounts can be selected, so an observer learns which + mounts are filled. A fitted mount is a structural fact imaging resolves (PA section 6b, ISAR + antenna returns), and keeping selection item-based avoids retyping the aim slot across 48 test + sites. Hiding occupancy would need the aim slot to name a hardpoint instead of an item. +- Mount-cell aim (R10): an observer that knows only the mount aims at the mount; centring on the + fitted item's own cells would leak its footprint through the hit forecast (invariant + instruments-bound). +- Inspection (R11): every game found that identifies non-emitting fit does it with a dedicated + scanner gated on a lock or a held range (EVE partial scans, Elite's 10 s held scan that alerts the + target and degrades when broken); the real analogues are ISAR imaging (active) and ACINT (long + specialised dwell) (PA section 6a-6c). A full reveal at completion replaces EVE's random partial + result: ScanTime is the cost knob, and randomness would be a second one. Range is a catalog stat, + authored well inside weapon range, not a question. - Emissions publish in the zone pre-phase beside paints because lock-warning's fix batch found order dependence when a ship read state another ship wrote mid-tick (LW fix 1, 1c5c6020). @@ -8232,8 +8300,11 @@ incoming-lock indicator already in tree. ## Cut order signature-channels -> paint-modes -> contact-reveals -> emissions-heard -> sensor-catalog; -contact-reveals -> reveals-replace-tiers (waits on question gear-reveal-by-dwell); -emissions-heard + paint-modes -> contact-hud. consumable-ai's re-map follows paint-modes. +contact-reveals -> reveals-replace-tiers (r2, unblocked by ruling +quiet-gear-identifiable-hull-layout-known) -> layout-aim; +emissions-heard + paint-modes -> contact-hud; +sensor-catalog + contact-hud + reveals-replace-tiers -> inspection-scanner (waits on questions +scanner-reveals-its-user and scanner-held-or-pulse). consumable-ai's re-map follows paint-modes. ## Admitted (receipts mind-commit-7a633910..., mind-commit-b158ffb9..., mind-commit-2892979b...) @@ -8251,3 +8322,18 @@ extraction on PassiveInfoPerSignature (follow-up missile-records-settled-info); ping cadence keeps calling Sensor.Ping, and Lucent's loud doctrine is the low InterceptFactor the sensor-catalog cut authors; autofire-threshold and controls-hud are unchanged (VisibleEnemies, Designated and the crosshair regions keep their meaning and lines). + +### Revision for ruling quiet-gear-identifiable-hull-layout-known (receipt mind-commit-e0e8fe50...) + +imagination-aeth-quiet-gear, 2026-10-11, same base 93b7ff8d (master e0b123a9 moved docs only). +Admitted: cut-reveals-replace-tiers.r2 (r1 superseded by resolution +cut_spec.cut-reveals-replace-tiers.r1.n1: unblocked, dwell alternative dropped); cut-layout-aim.r1 +(new, after reveals-replace-tiers: LayoutOf, IsLocated, mount-cell aim, mount rows on the target +schematic); cut-inspection-scanner.r1 (new, after sensor-catalog, contact-hud and +reveals-replace-tiers: the special gear; its own cut because sensor-catalog is already sized near +one Hands pass). Questions scanner-reveals-its-user (recommended scan-is-an-act) and +scanner-held-or-pulse (recommended held-beam), both raised in inspection-scanner. context-pack read +every anchor SAME at 93b7ff8d. Unchanged and still in force: signature-channels.r1, paint-modes.r2, +contact-reveals.r1 (layout is derived, not stored in the reveal record; the scanner cut widens +Reveal.Channel to nullable), emissions-heard.r1, contact-hud.r1 (the scanner cut adds Scan paints to +the incoming indicator), sensor-catalog.r1. diff --git a/docs/research/lock-launch-and-graded-visibility-prior-art.md b/docs/research/lock-launch-and-graded-visibility-prior-art.md index 0cee9d6bb..5ff439a7b 100644 --- a/docs/research/lock-launch-and-graded-visibility-prior-art.md +++ b/docs/research/lock-launch-and-graded-visibility-prior-art.md @@ -99,3 +99,72 @@ The exact passage about forcing a target to reveal capabilities one by one was n - Nebulous wiki 403; CMO manual, Children of a Dead Earth, Highfleet, Avorion detail, EVE d-scan/target warning not obtained. - Did not open Unity GuidedProjectile or AI code consuming IncomingLocks. - SEARCH items are secondary summaries. + +## 6. Identifying quiet equipment, and hull class to layout (addendum, 2026-10-11) + +Gathered by imagination-aeth-quiet-gear for ruling quiet-gear-identifiable-hull-layout-known +("Identifying those quiet subsystems should still be possible, even if you need special gear to do +it. Also, with enough data to infer the hull class I should know where the reactor is even if I +don't have its specs."). Bounded pass, 8 searches and fetches. + +### 6a. Dedicated scanning gear in games +- FETCHED EVE University wiki "Ship scanning": the ship scanner module reveals the target's fit and + capacitor level; a single scan shows a random subset of the fitted modules (one example: three of + nine), so full knowledge takes repeated scans; structures always show the full fit. Range, cycle + time and target notification are not on the page. +- SEARCH (EVE University "Cargo scanning", same targeting-then-scanning process): the scanner needs + a lock first; the active module draws a faint scanning beam toward the target, visible but easy + to miss. Combined with section 3c (a normal lock alerts the target; the Passive Targeter exists to + lock without alerting), EVE's scan is covert only in that its own effect is subtle: the lock it + needs is noticed. +- SEARCH (Elite Dangerous fan wiki, Prima guide, Steam threads): the Kill Warrant Scanner is a held + scan of about 10 s; the target must stay within the scanner's range the whole time or the scan is + interrupted; partial data degrades gradually rather than resetting at once; the target is alerted + as soon as the scan begins and may flee or deploy hardpoints. The manifest (cargo) scanner reads + cargo; timing not found. +- SEARCH (Highfleet guides): composition intelligence is a strategic-map activity (radio tracking, + radar, an optional ELINT/IR ship in a strike group); no in-battle equipment scanner found. +- SEARCH (Nebulous): store text only: capabilities are learned gradually, half a battle may go to + determining them; detail of what each track-quality level shows was NOT obtained (wiki 403 in + section 3c). Recollection, unverified: hull class shows at higher track quality and fitted + components are visible on the model. +- SEARCH (Cold Waters, Steam threads): contact codes record how a contact was first found (S, E, V, + R, M); class identity comes from the player matching against the unit reference; players report + positive identification often only after the kill. No timed classification rule found. + +### 6b. Real-world identification of equipment that does not emit +- SEARCH (Wikipedia "Acoustical intelligence", Center for Maritime Strategy, Marasco et al., + Acoustics 2023): ACINT is a MASINT discipline; narrowband spectral lines from internal machinery, + propellers and sonars identify category, type and ideally the individual hull; a 2023 proof of + concept determined the running status of a subset of a known ship's systems from its radiated + noise. Collection assets are few, time on station short, analysis delayed. Reading: machinery that + never transmits still radiates, and specialised analysis over a dwell recovers it. +- SEARCH (MIT Lincoln Laboratory ISAR ship classification, Navy SBIR topics, Adelaide ISAR slides): + inverse synthetic aperture radar, an active imaging radar, classifies ship class from + superstructure shape; viewing geometry limits it (along the length is best, broadside poor); + returns from rotating antennas reveal their position on the ship and their configuration. Imaging + is an active act the target can detect (as any radar, section 3b). +- SEARCH (ONI recognition manuals on ibiblio, Jane's help centre and case study): class recognition + rests on the overall mass of hull and superstructure; Jane's narrows an unknown ship to one class + from dimensions, and a class profile then lists its weapons and systems and where they are. + Variants and refits within a class: not covered by the results (gap). +- KNOWLEDGE: technical intelligence (TECHINT, exploitation) learns specifications from captured or + closely examined equipment; recognition handbooks give a class's layout (mount positions, sensor + masts) but a given ship's fit and condition are confirmed only by closer collection. + +### 6c. Reading for Aetheria +- Hull class to layout is how recognition works: identify the class, then the class reference says + where the mounts are; it does not say what a given ship carries in them or their specifications + (6b). In Aetheria the class is HullData, and its Hardpoints (type, position, shape) are that + reference. +- Every game found that identifies non-emitting fit does it with a dedicated scanner that needs a + lock or held range: EVE (partial, repeated scans), Elite (held 10 s, interrupted out of range, + target alerted at once). The real-world analogues are either long passive dwell by specialised + analysis (ACINT) or active imaging (ISAR), which reveals the imager. +- No source found where the scanned party learns nothing at all: EVE's covertness is a weak beam on + top of a noticed lock; Elite alerts outright. + +### 6d. Gaps +- EVE ship-scanner range, cycle time and whether the target is told: not obtained. +- Nebulous track-quality levels and component visibility; CMO classification rules: not obtained. +- Refit variants within a class in recognition references: not obtained.