Restore CST-Core body; drop misplaced CEx-Pck HLRs from section 8

Author: CuriousOne23

thought_simulator/requirements_20/20.32.010.010_cst-core.md

@@ -1 +1,278 @@
-PLACEHOLDER
+# **20.32.010.010 — CST-Core Requirements**
+
+## **0. Document Purpose (Informative)**
+
+This document defines the normative requirements for **CST-Core**, the foundational stability-tracking module in the Thought Simulator architecture. CST-Core computes structural stability metrics, detects instability, and emits freeze, thaw, and continuity-restoration signals for identity layers. All requirements in this document are derived from the architectural specification in *cst-core.md*.
+
+CST-Core tracks:
+
+- identity structure
+- referent structure
+- temporal anchors
+- discourse anchors
+- lineage continuity
+- register state
+- field-importance stability
+
+It computes drift, oscillation, ambiguity, collapse, continuity, freeze, thaw, and determinism signals over a 10-turn sliding window.
+
+**Architectural Role (Informative)**
+CST-Core is a **stateful metric generator**. It maintains metric histories across turns in order to detect temporal phenomena (drift, oscillation, ambiguity, collapse). It is **not a state machine** and has **no structural authority** over identity-layer topology. Structural commands (Freeze, Thaw, Collapse-recovery, Create, Split, Merge) are issued exclusively by CST-MS. CST-Core emits only the three signals Freeze, Thaw, and Continuity-restoration directly to COB; all other raw metrics are sent only to CST-MS and CST-Mux.
+
+## 0.1 Block Diagram of OuBA, COB, CST-Core, CST-MS and CST-Mux
+
+```mermaid
+flowchart LR
+
+    %% ===== Meaning Layer → Stability Layer =====
+    OuBA --> COB
+    OuBA --> CSTCore
+
+    %% ===== Stability Layer =====
+    CSTCore --> CSTMS
+    CSTCore --> CSTMux
+    CSTMS --> CSTMux
+    CSTCore --> COB
+    CSTMS --> COB
+    COB --> CSTCore
+    COB --> CSTMS
+```
+
+---
+
+# **1. Structural Snapshots**
+
+## **1.1 Snapshot Extraction (Informative)**
+At each turn *t*, CST-Core extracts a structural snapshot for each identity layer *L*. Snapshots include referent maps, temporal anchors, discourse anchors, lineage connections, register state, and field-importance weights. Snapshots are derived from COB identity-layer state and from committed OuBA (TPSnS) references.
+
+## **1.2 Snapshot Requirements (Normative)**
+**HLR-20.32.010.010-001**
+CST-Core SHALL extract a structural snapshot for every identity layer *L* at each turn *t*.
+
+**HLR-20.32.010.010-002**
+CST-Core SHALL store snapshots in a deterministic format that is replay-safe.
+
+**HLR-20.32.010.010-003**
+CST-Core SHALL ensure snapshot extraction uses no randomness, sampling, or external state.
+
+**HLR-20.32.010.010-040**
+CST-Core SHALL accept committed identity-layer snapshots from OuBA (TPSnS) as a stable, replay-safe reference for identity-layer topology, freeze/thaw state, and continuity status.
+
+---
+
+# **2. Counting, Frequency, and History**
+
+## **2.1 Feature Counting (Informative)**
+CST-Core counts how often structural features appear across the last 10 turns and computes normalized frequencies and ordered histories. These histories constitute the state required for temporal metric detection; they do not constitute a state machine.
+
+## **2.2 Counting Requirements (Normative)**
+**HLR-20.32.010.010-004**
+CST-Core SHALL compute feature counts over a fixed 10-turn sliding window.
+
+**HLR-20.32.010.010-005**
+CST-Core SHALL compute normalized feature frequencies over the same window.
+
+**HLR-20.32.010.010-006**
+CST-Core SHALL maintain ordered feature histories for all tracked features.
+
+---
+
+# **3. Drift Detection**
+
+## **3.1 Drift Definition (Informative)**
+Drift measures how much a structural feature changes from turn to turn. Integrated drift over 10 turns indicates sustained instability.
+
+## **3.2 Drift Requirements (Normative)**
+**HLR-20.32.010.010-007**
+CST-Core SHALL compute per-turn drift using a deterministic structural distance function.
+
+**HLR-20.32.010.010-008**
+CST-Core SHALL compute integrated drift over a 10-turn window.
+
+**HLR-20.32.010.010-009**
+CST-Core SHALL use domain-specific deterministic distance functions for identity, referent, lineage, register, and anchor drift.
+
+**HLR-20.32.010.010-010**
+CST-Core SHALL emit a drift signal when integrated drift exceeds the layer-specific drift threshold.
+
+---
+
+# **4. Oscillation Detection**
+
+## **4.1 Oscillation Definition (Informative)**
+Oscillation measures how often a structural feature flips state across the 10-turn window. High oscillation indicates instability.
+
+## **4.2 Oscillation Requirements (Normative)**
+**HLR-20.32.010.010-011**
+CST-Core SHALL compute oscillation as the count of state flips between consecutive turns.
+
+**HLR-20.32.010.010-012**
+CST-Core SHALL compare oscillation against a deterministic, monotonic oscillation threshold.
+
+**HLR-20.32.010.010-013**
+CST-Core SHALL emit an oscillation signal when oscillation exceeds the layer-specific threshold.
+
+---
+
+# **5. Ambiguity Detection**
+
+## **5.1 Ambiguity Definition (Informative)**
+Ambiguity measures uncertainty or overlap in structural interpretation. High ambiguity is a strong predictor of collapse.
+
+## **5.2 Ambiguity Requirements (Normative)**
+**HLR-20.32.010.010-014**
+CST-Core SHALL compute per-turn ambiguity using deterministic domain-specific ambiguity functions.
+
+**HLR-20.32.010.010-015**
+CST-Core SHALL compute integrated ambiguity over a 10-turn window.
+
+**HLR-20.32.010.010-016**
+CST-Core SHALL compare integrated ambiguity against a deterministic, monotonic ambiguity threshold.
+
+**HLR-20.32.010.010-017**
+CST-Core SHALL emit an ambiguity signal when integrated ambiguity exceeds the layer-specific threshold.
+
+---
+
+# **6. Collapse Detection**
+
+## **6.1 Collapse Definition (Informative)**
+Collapse measures structural failure — the point at which continuity cannot be maintained without intervention.
+
+## **6.2 Collapse Requirements (Normative)**
+**HLR-20.32.010.010-018**
+CST-Core SHALL compute stability scores per turn for all tracked structural domains.
+
+**HLR-20.32.010.010-019**
+CST-Core SHALL compute integrated stability over a 10-turn window.
+
+**HLR-20.32.010.010-020**
+CST-Core SHALL compute collapse as the complement of integrated stability.
+
+**HLR-20.32.010.010-021**
+CST-Core SHALL emit a collapse signal when collapse exceeds the layer-specific collapse threshold.
+
+---
+
+# **7. Freeze Detection**
+
+## **7.1 Freeze Definition (Informative)**
+Freeze halts structural updates to prevent further degradation when instability becomes unsafe. CST-Core emits a Freeze signal; it does not itself exercise structural authority over COB identity layers.
+
+## **7.2 Freeze Requirements (Normative)**
+**HLR-20.32.010.010-022**
+CST-Core SHALL compute a combined instability score from drift, oscillation, ambiguity, and collapse.
+
+**HLR-20.32.010.010-023**
+CST-Core SHALL emit a Freeze signal when combined instability exceeds the layer-specific freeze threshold.
+
+**HLR-20.32.010.010-024**
+CST-Core SHALL halt snapshot updates for frozen layers (local metric-tracking freeze).
+
+**HLR-20.32.010.010-025**
+CST-Core SHALL halt stability-metric updates for frozen layers (local metric-tracking freeze).
+
+**HLR-20.32.010.010-026**
+CST-Core SHALL halt threshold adaptation for frozen layers (local metric-tracking freeze).
+
+---
+
+# **8. Thaw Detection**
+
+## **8.1 Thaw Definition (Informative)**
+Thaw restores normal structural evolution once stability returns. Thaw is condition-based, not time-based. CST-Core emits a Thaw signal; it does not itself exercise structural authority over COB identity layers.
+
+## **8.2 Thaw Requirements (Normative)**
+**HLR-20.32.010.010-027**
+CST-Core SHALL emit a Thaw signal when combined instability falls below the layer-specific recovery threshold.
+
+**HLR-20.32.010.010-028**
+CST-Core SHALL resume snapshot updates upon thaw (local metric-tracking thaw).
+
+**HLR-20.32.010.010-029**
+CST-Core SHALL resume stability-metric updates upon thaw (local metric-tracking thaw).
+
+**HLR-20.32.010.010-030**
+CST-Core SHALL resume threshold adaptation upon thaw (local metric-tracking thaw).
+
+---
+
+# **9. Continuity Restoration**
+
+## **9.1 Continuity Definition (Informative)**
+Continuity restoration repairs structural stability after freeze or collapse, enabling safe resumption of normal evolution. CST-Core emits a Continuity-restoration signal; it does not itself exercise structural authority over COB identity layers.
+
+## **9.2 Continuity Requirements (Normative)**
+**HLR-20.32.010.010-031**
+CST-Core SHALL compute continuity scores per turn for each identity layer.
+
+**HLR-20.32.010.010-032**
+CST-Core SHALL compute integrated continuity over a 10-turn window.
+
+**HLR-20.32.010.010-033**
+CST-Core SHALL emit a Continuity-restoration signal when integrated continuity exceeds the layer-specific continuity-recovery threshold.
+
+**HLR-20.32.010.010-034**
+CST-Core SHALL apply queued structural corrections deterministically during continuity restoration (local metric-tracking only).
+
+---
+
+# **10. Determinism, Thresholds, and Replay**
+
+## **10.1 Determinism (Informative)**
+CST-Core is fully deterministic: no randomness, no external state, no wall-clock time, and replay-safe behavior. It maintains metric histories but is not a state machine.
+
+## **10.2 Determinism Requirements (Normative)**
+**HLR-20.32.010.010-035**
+CST-Core SHALL compute all metrics as pure functions of snapshots, OuBA cues, previous CST signals, and deterministic history.
+
+**HLR-20.32.010.010-036**
+CST-Core SHALL ensure all threshold updates follow deterministic, monotonic rules.
+
+**HLR-20.32.010.010-037**
+CST-Core SHALL guarantee replay-safe behavior for all metrics, thresholds, and signals.
+
+**HLR-20.32.010.010-038**
+CST-Core SHALL emit stability signals in a deterministic, fixed order.
+
+**HLR-20.32.010.010-039**
+CST-Core SHALL log all metric values required for replay consistency.
+
+---
+
+# **11. Signal Emission and Routing (New)**
+
+## **11.1 Signal Routing (Informative)**
+CST-Core emits two classes of signals:
+
+- **Structural signals** (Freeze, Thaw, Continuity-restoration) are sent to both COB and CST-Mux.
+- **Raw metric signals** (Drift, Oscillation, Ambiguity, Collapse) are sent only to CST-MS (for synthesis) and to CST-Mux (for TP replay).
+
+CST-Core never receives commands or feedback from CST-MS. All signals are also recorded via CST-Mux for deterministic TP replay.
+
+## **11.2 Signal Routing Requirements (Normative)**
+
+**HLR-20.32.010.010-041**
+CST-Core SHALL emit Freeze, Thaw, and Continuity-restoration signals to both COB and CST-Mux.
+
+**HLR-20.32.010.010-042**
+CST-Core SHALL emit Drift, Oscillation, Ambiguity, and Collapse signals only to CST-MS and CST-Mux.
+
+**HLR-20.32.010.010-043**
+CST-Core SHALL NOT emit Drift, Oscillation, Ambiguity, or Collapse signals directly to COB.
+
+**HLR-20.32.010.010-044**
+CST-Core SHALL send all raw metric values and metric histories required by CST-MS for synthesis.
+
+**HLR-20.32.010.010-045**
+CST-Core SHALL NOT accept commands, control signals, or feedback from CST-MS.
+
+**HLR-20.32.010.010-046**
+CST-Core SHALL ensure every emitted signal is also available to CST-Mux for inclusion in the Unified Stability Packet and TP replay.
+
+**HLR-20.32.010.010-047**
+CST-Core SHALL remain free of structural authority; it SHALL NOT issue Create, Split, Merge, or Collapse-recovery commands to COB.
+
+---
+
+# **End of Document**