Skip to content

Commit 3c6cd2b

Browse files
committed
docs(hpc): record entropy_ladder layering decision (validate in ndarray, migrate later)
Operator decision on the PR #218 coderabbit layering thread: keep entropy_ladder in ndarray::hpc for the validation phase, migrate to the lance-graph thinking layer once the ladder stabilizes. Module header now states the rationale (no thinking/protocol crate dependency — pure fns on (u8,f64)+enums, decompose_spo takes raw indices not a CausalEdge64; sits beside existing hpc::nars and hpc::causal_diff) and the planned migration. https://claude.ai/code/session_01D2WSmezQBNC3bUdHuGfGmo
1 parent 5a34b0d commit 3c6cd2b

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

src/hpc/entropy_ladder.rs

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,15 @@
2323
//! Validation: [`nars_entropy`] is a *reliability proxy* — it anti-correlates
2424
//! with an edge's empirical prediction accuracy (see the module tests and the
2525
//! `entropy_ladder_probe` example), grounded via [`crate::hpc::reliability`].
26+
//!
27+
//! ## Layering (PR #218 review — operator decision 2026-06-14)
28+
//! This module carries cognition vocabulary (Staunen/Wisdom, SPO rungs) but has
29+
//! NO dependency on the thinking/protocol crates: it is pure functions on
30+
//! `(u8, f64)` + plain enums (`decompose_spo` takes raw palette indices, never a
31+
//! `CausalEdge64`). It is VALIDATED here during the instrument phase, beside the
32+
//! existing `hpc::nars` (NarsTruth) and `hpc::causal_diff` (CausalEdge64).
33+
//! **Planned migration to the lance-graph thinking layer once the ladder
34+
//! stabilizes** — tracked via the open coderabbit layering thread on PR #218.
2635
2736
/// Staunen↔Wisdom entropy of a NARS truth value `(f, c)`, in `[0, 1]`.
2837
///

0 commit comments

Comments
 (0)