refactor(thinking-engine): D-PERT-1 — mechanical ResonanceDto -> PerturbationDto (M2)

The mechanical Morton-tile inverse-pyramid field (Psi) renames to
PerturbationDto with a deprecated ResonanceDto alias at the definition
site; the perspectival (Piaget Three-Mountains) ResonanceDto in
awareness_dto.rs KEEPS its name, untouched. 8 files; cascade key-tier
vocabulary untouched. thinking-engine 362 tests green; shader-driver
(with-engine) 100 green; zero in-crate deprecated-alias usage remains.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MLBnPuScZy6w9di2QEjsXM

Author: claude

crates/cognitive-shader-driver/src/engine_bridge.rs

@@ -3,7 +3,7 @@
 //! Two DTO pipelines exist in isolation:
 //!
 //! ```text
-//! thinking-engine:           Φ StreamDto → Ψ ResonanceDto → B BusDto → Γ ThoughtStruct
+//! thinking-engine:           Φ StreamDto → Ψ PerturbationDto → B BusDto → Γ ThoughtStruct
 //! cognitive-shader-driver:   Φ ShaderDispatch → Ψ ShaderResonance → B ShaderBus → Γ ShaderCrystal
 //! ```
 //!
@@ -12,7 +12,7 @@
 //!
 //! ```text
 //! [1] StreamDto.codebook_indices  → populate BindSpace content fingerprints
-//! [2] ResonanceDto.top_k          → seed ShaderDispatch.rows (which rows to scan)
+//! [2] PerturbationDto.top_k       → seed ShaderDispatch.rows (which rows to scan)
 //! [3] ShaderBus.cycle_fingerprint → produce BusDto (top-1 hit = codebook_index)
 //! [4] ShaderCrystal               → produce ThoughtStruct with sensor provenance
 //! [5] Qualia17D                   → fill BindSpace QualiaColumn (17 → 18: pad 0)
@@ -88,7 +88,7 @@ pub fn ingest_codebook_indices(
 }
 
 // ═══════════════════════════════════════════════════════════════════════════
-// ResonanceDto → ShaderDispatch (top-k seeds the scan window)
+// PerturbationDto → ShaderDispatch (top-k seeds the scan window)
 // ═══════════════════════════════════════════════════════════════════════════
 
 /// Build a ShaderDispatch from resonance top-k.

crates/thinking-engine/Cargo.lock

@@ -12,7 +12,7 @@
 //!
 //! Built from StackedN::cosine() via ClamCodebook, matching bgz-tensor pipeline.
 
-use crate::dto::{BusDto, ResonanceDto};
+use crate::dto::{BusDto, PerturbationDto};
 use bgz_tensor::stacked_n::{bf16_to_f32, f32_to_bf16};
 use ndarray::hpc::heel_f64x8::cosine_f32_to_f64_simd;
 use ndarray::simd::F32x16;
@@ -283,7 +283,7 @@ impl BF16ThinkingEngine {
     }
 
     /// Think until convergence.
-    pub fn think(&mut self, max_cycles: usize) -> ResonanceDto {
+    pub fn think(&mut self, max_cycles: usize) -> PerturbationDto {
         for _ in 0..max_cycles {
             let prev = self.energy.clone();
             self.cycle();
@@ -297,11 +297,15 @@ impl BF16ThinkingEngine {
                 break;
             }
         }
-        ResonanceDto::from_energy_f32(&self.energy, self.cycles)
+        PerturbationDto::from_energy_f32(&self.energy, self.cycles)
     }
 
     /// Think with temperature.
-    pub fn think_with_temperature(&mut self, max_cycles: usize, temperature: f32) -> ResonanceDto {
+    pub fn think_with_temperature(
+        &mut self,
+        max_cycles: usize,
+        temperature: f32,
+    ) -> PerturbationDto {
         for _ in 0..max_cycles {
             let prev = self.energy.clone();
             self.cycle_with_temperature(temperature);
@@ -315,7 +319,7 @@ impl BF16ThinkingEngine {
                 break;
             }
         }
-        ResonanceDto::from_energy_f32(&self.energy, self.cycles)
+        PerturbationDto::from_energy_f32(&self.energy, self.cycles)
     }
 
     /// Perturb with codebook indices.
@@ -344,7 +348,7 @@ impl BF16ThinkingEngine {
 
     /// Commit dominant peak.
     pub fn commit(&self) -> BusDto {
-        let resonance = ResonanceDto::from_energy_f32(&self.energy, self.cycles);
+        let resonance = PerturbationDto::from_energy_f32(&self.energy, self.cycles);
         BusDto {
             codebook_index: resonance.top_k[0].0,
             energy: resonance.top_k[0].1,

crates/thinking-engine/src/bf16_engine.rs

@@ -12,7 +12,7 @@
 //! ```
 
 use crate::builder::BuiltEngine;
-use crate::dto::ResonanceDto;
+use crate::dto::PerturbationDto;
 
 /// Result of multi-model composition.
 pub struct CompositeResult {
@@ -111,7 +111,7 @@ impl CompositeEngine {
 
         for (name, engine) in &mut self.lenses {
             engine.think(max_cycles);
-            let res = ResonanceDto::from_energy_f32(engine.energy(), engine.cycles());
+            let res = PerturbationDto::from_energy_f32(engine.energy(), engine.cycles());
 
             for &(idx, energy) in &res.top_k {
                 if energy > 1e-10 {

crates/thinking-engine/src/composite_engine.rs

@@ -1,9 +1,9 @@
 //! DTOs: bus adapters between cognitive speed zones.
 //!
-//! Φ Dispersion:   StreamDto      — sensor output enters the field
-//! Ψ Interference: ResonanceDto   — the ripple field IS f64[4096]
-//! B Consequence:   BusDto         — committed thought with provenance
-//! Γ Collapse:      ThoughtStruct  — stabilized, persisted, text is lazy
+//! Φ Dispersion:   StreamDto        — sensor output enters the field
+//! Ψ Interference: PerturbationDto  — the ripple field IS f64[4096]
+//! B Consequence:   BusDto           — committed thought with provenance
+//! Γ Collapse:      ThoughtStruct    — stabilized, persisted, text is lazy
 
 use crate::engine::CODEBOOK_SIZE;
 
@@ -47,24 +47,37 @@ pub struct StreamDto {
 }
 
 // ═══════════════════════════════════════════════════════════════════════════
-// Ψ — ResonanceDto: the ripple field
+// Ψ — PerturbationDto: the ripple field
 // ═══════════════════════════════════════════════════════════════════════════
 
-/// ResonanceDto IS f64[4096] energy. Not a struct with candidate lists.
+/// PerturbationDto IS f64[4096] energy. Not a struct with candidate lists.
 ///
 /// High energy at entry 42 = "thought 42 resonates."
 /// Zero at entry 200 = "thought 200 destructively interfered."
 /// Spike at entry 7 = "thought 7 crystallizing."
+///
+/// D-PERT-1: renamed from `ResonanceDto` — this is the mechanical
+/// Morton-tile inverse-pyramid perturbation field (Ψ), distinct from the
+/// PERSPECTIVAL (Piaget Three-Mountains) `ResonanceDto` in
+/// `awareness_dto.rs`, which keeps the `ResonanceDto` name.
 #[derive(Clone, Debug)]
-pub struct ResonanceDto {
+pub struct PerturbationDto {
     /// Energy distribution. f32 — matches u8 distance table precision.
     pub energy: Vec<f32>,
     pub cycle_count: u16,
     pub converged: bool,
     pub top_k: [(u16, f32); 8],
 }
 
-impl ResonanceDto {
+/// D-PERT-1: `ResonanceDto` (mechanical Ψ) renamed to `PerturbationDto`.
+/// `ResonanceDto` now names only the perspectival awareness DTO in
+/// `awareness_dto.rs`.
+#[deprecated(
+    note = "renamed to PerturbationDto (D-PERT-1); ResonanceDto now names only the perspectival awareness DTO"
+)]
+pub type ResonanceDto = PerturbationDto;
+
+impl PerturbationDto {
     /// Build from f32 energy array (fixed-size legacy compat).
     pub fn from_energy(energy: &[f32; CODEBOOK_SIZE], cycles: u16) -> Self {
         Self::from_energy_f32(energy.as_slice(), cycles)
@@ -237,7 +250,7 @@ mod tests {
         energy[100] = 0.3;
         energy[200] = 0.2;
 
-        let res = ResonanceDto::from_energy(&energy, 5);
+        let res = PerturbationDto::from_energy(&energy, 5);
         assert_eq!(res.top_k[0].0, 42);
         assert!((res.top_k[0].1 - 0.5).abs() < 1e-10);
         assert_eq!(res.top_k[1].0, 100);

crates/thinking-engine/src/dto.rs

@@ -4,7 +4,7 @@
 //! Same input, same perturbation, different encoding → measure disagreement.
 
 use crate::builder::BuiltEngine;
-use crate::dto::ResonanceDto;
+use crate::dto::PerturbationDto;
 
 /// Results from running both engines on the same input.
 pub struct DualResult {
@@ -105,8 +105,10 @@ impl DualEngine {
         self.engine_a.think(max_cycles);
         self.engine_b.think(max_cycles);
 
-        let res_a = ResonanceDto::from_energy_f32(self.engine_a.energy(), self.engine_a.cycles());
-        let res_b = ResonanceDto::from_energy_f32(self.engine_b.energy(), self.engine_b.cycles());
+        let res_a =
+            PerturbationDto::from_energy_f32(self.engine_a.energy(), self.engine_a.cycles());
+        let res_b =
+            PerturbationDto::from_energy_f32(self.engine_b.energy(), self.engine_b.cycles());
 
         let a_indices: Vec<u16> = res_a
             .top_k

crates/thinking-engine/src/dual_engine.rs

@@ -154,7 +154,7 @@
 //!   FIX 4: GPU Vulkan compute shader: ~10μs per cycle (see GPU design doc)
 //! ```
 
-use crate::dto::{BusDto, ResonanceDto};
+use crate::dto::{BusDto, PerturbationDto};
 use ndarray::hpc::heel_f64x8::cosine_f64_simd;
 use ndarray::simd::F32x16;
 use ndarray::simd_amx;
@@ -383,7 +383,11 @@ impl ThinkingEngine {
     /// Applies softmax(energy/T) after each cycle. This exponentiates
     /// small differences into large ones, breaking the attractor collapse
     /// on uniform tables. T=1.0 ≈ standard normalization.
-    pub fn think_with_temperature(&mut self, max_cycles: usize, temperature: f32) -> ResonanceDto {
+    pub fn think_with_temperature(
+        &mut self,
+        max_cycles: usize,
+        temperature: f32,
+    ) -> PerturbationDto {
         for _ in 0..max_cycles {
             let prev = self.energy.clone();
             self.cycle();
@@ -415,12 +419,12 @@ impl ThinkingEngine {
                 break;
             }
         }
-        ResonanceDto::from_energy_f32(&self.energy, self.cycles)
+        PerturbationDto::from_energy_f32(&self.energy, self.cycles)
     }
 
     /// Run until convergence. Returns the resonance state.
     /// Uses `cycle_auto` which tries VNNI first, falls back to F32x16.
-    pub fn think(&mut self, max_cycles: usize) -> ResonanceDto {
+    pub fn think(&mut self, max_cycles: usize) -> PerturbationDto {
         for _ in 0..max_cycles {
             let prev = self.energy.clone();
             self.cycle();
@@ -435,7 +439,7 @@ impl ThinkingEngine {
                 break;
             }
         }
-        ResonanceDto::from_energy_f32(&self.energy, self.cycles)
+        PerturbationDto::from_energy_f32(&self.energy, self.cycles)
     }
 
     /// ONE thinking cycle via AMX/VNNI dispatch path.
@@ -533,7 +537,7 @@ impl ThinkingEngine {
 
     /// Commit: dominant peak → BusDto.
     pub fn commit(&self) -> BusDto {
-        let resonance = ResonanceDto::from_energy_f32(&self.energy, self.cycles);
+        let resonance = PerturbationDto::from_energy_f32(&self.energy, self.cycles);
         BusDto {
             codebook_index: resonance.top_k[0].0,
             energy: resonance.top_k[0].1,

crates/thinking-engine/src/engine.rs

@@ -8,7 +8,7 @@
 //! Think cycle: signed MatVec with ReLU + normalization.
 //! No floor heuristic. No threshold. Full signed accumulation.
 
-use crate::dto::{BusDto, ResonanceDto};
+use crate::dto::{BusDto, PerturbationDto};
 
 /// F32 thinking engine. Distance table at full f32 precision.
 pub struct F32ThinkingEngine {
@@ -206,25 +206,29 @@ impl F32ThinkingEngine {
     }
 
     /// Think until convergence or max_cycles.
-    pub fn think(&mut self, max_cycles: usize) -> ResonanceDto {
+    pub fn think(&mut self, max_cycles: usize) -> PerturbationDto {
         for _ in 0..max_cycles {
             let delta = self.cycle();
             if delta < self.convergence_threshold {
                 break;
             }
         }
-        ResonanceDto::from_energy_f32(&self.energy, self.cycles)
+        PerturbationDto::from_energy_f32(&self.energy, self.cycles)
     }
 
     /// Think with temperature scaling (1/T applied to MatVec output before normalization).
-    pub fn think_with_temperature(&mut self, max_cycles: usize, temperature: f32) -> ResonanceDto {
+    pub fn think_with_temperature(
+        &mut self,
+        max_cycles: usize,
+        temperature: f32,
+    ) -> PerturbationDto {
         for _ in 0..max_cycles {
             let delta = self.cycle_with_temp(temperature);
             if delta < self.convergence_threshold {
                 break;
             }
         }
-        ResonanceDto::from_energy_f32(&self.energy, self.cycles)
+        PerturbationDto::from_energy_f32(&self.energy, self.cycles)
     }
 
     /// Access the energy distribution.
@@ -263,7 +267,7 @@ impl F32ThinkingEngine {
 
     /// Commit dominant peak as BusDto.
     pub fn commit(&self) -> BusDto {
-        let resonance = ResonanceDto::from_energy_f32(&self.energy, self.cycles);
+        let resonance = PerturbationDto::from_energy_f32(&self.energy, self.cycles);
         BusDto {
             codebook_index: resonance.top_k[0].0,
             energy: resonance.top_k[0].1,