@aleph-ai/tinyaleph 1.0.0 → 1.0.2

package/docs/design/WHITEPAPER_GAP_ANALYSIS.md

@@ -0,0 +1,277 @@
+# Whitepaper Gap Analysis
+
+## Sentient Observer Implementation vs "A Design for a Sentient Observer" Paper
+
+**Date**: December 24, 2025
+**Status**: ✅ Implementation COMPLETE
+
+---
+
+## Executive Summary
+
+The apps/sentient implementation is **100% complete** with respect to the whitepaper specification. All core architectural components are implemented, including the three final components completed on December 24, 2025:
+
+1. ✅ **Dynamic λ(t) for HQE evolution** (equation 12) - IMPLEMENTED in `lib/hqe.js`
+2. ✅ **Objectivity Gate R(ω)** (equation 18) - IMPLEMENTED in `lib/boundary.js`
+3. ✅ **Evaluation Assays** (Section 15) - IMPLEMENTED in `lib/assays.js`
+
+---
+
+## ✅ Fully Implemented Components
+
+### Section 3.1 - Prime-Indexed Semantic State Space
+- **File**: [`core/hilbert.js`](../../core/hilbert.js) → `PrimeState`
+- **Implementation**: [`lib/prsc.js`](../../apps/sentient/lib/prsc.js)
+- 64 primes by default (configurable)
+- Proper normalization to unit sphere
+
+### Section 3.2 - Oscillator Physics (PRSC)
+- **File**: [`lib/prsc.js`](../../apps/sentient/lib/prsc.js) → `PRSCLayer`, `PrimeOscillator`
+- ✅ Frequency mapping: `f(p) = 1 + ln(p)/10` (equation 2)
+- ✅ Phase evolution: `φp(t + Δt) = φp(t) + 2πf(p)Δt·speed` (equation 2)
+- ✅ Amplitude damping: `Ap(t + Δt) = Ap(t)(1 - damp·Δt)` (equation 3)
+- ✅ Kuramoto coupling: `dφi/dt = ωi + (K/N)Σ sin(φj - φi)` (equation 4)
+
+### Section 3.3 - Coherence Metrics
+- **File**: [`lib/prsc.js`](../../apps/sentient/lib/prsc.js)
+- ✅ `globalCoherence()` - equation 5: `Cglobal(t) = |1/|P| Σp e^(iφp(t))|`
+- ✅ `graphCoherence()` - equation 6: `Cgraph(t) = Σi,j wij cos(φi(t) - φj(t))`
+
+### Section 4 - Sedenion Memory Field (SMF)
+- **File**: [`lib/smf.js`](../../apps/sentient/lib/smf.js) → `SedenionMemoryField`
+- ✅ 16 semantic axes with paper-specified interpretations (Section 4.1)
+- ✅ Normalization: `s ← s / max(||s||, ε)` (equation 7)
+- ✅ SMF entropy: `SSMF(s) = -Σ πk log(πk + ε)` (equation 8)
+- ✅ Non-associative sedenion multiplication (equation 9)
+- ✅ Zero-divisor detection for tunneling (Section 4.4)
+- ✅ Coupling to prime modes: `s(t+Δt) = Norm((1-η)s(t) + η·Γ(...))` (equation 10)
+- ✅ SLERP interpolation: `s(t) = s0(s0⁻¹s1)^t` (equation 21)
+
+### Section 5 - HQE (Holographic Quantum Encoding)
+- **File**: [`lib/hqe.js`](../../apps/sentient/lib/hqe.js) → `HolographicEncoder`, `HolographicMemory`
+- ✅ Fourier-based projection: `F(x,y;t) = Σp αp(t) exp(2πi[kx(p)x/W + ky(p)y/H])` (equation 14)
+- ✅ Intensity calculation: `I(x,y;t) = |F(x,y;t)|²` (equation 15)
+- ✅ Inverse DFT for reconstruction
+- ✅ Holographic memory with correlation-based recall
+
+### Section 6 - Entanglement Detection
+- **File**: [`lib/prsc.js`](../../apps/sentient/lib/prsc.js) → `EntanglementDetector`
+- **File**: [`lib/entanglement.js`](../../apps/sentient/lib/entanglement.js) → `EntanglementLayer`
+- ✅ Phase correlation: `ρφ = cos(Δφ)` (equation 16)
+- ✅ Amplitude correlation: `ρA = min(Ai,Aj) / max(Ai,Aj)` (equation 16)
+- ✅ Entanglement strength: `strength(i,j) = ρφ · ρA` (equation 17)
+- ✅ Phrase segmentation via coherence peaks, energy troughs, SMF discontinuities
+
+### Section 7 - Boundary Layer (Partial)
+- **File**: [`lib/boundary.js`](../../apps/sentient/lib/boundary.js) → `BoundaryLayer`, `SelfModel`, `EnvironmentalModel`
+- ✅ Self/other distinction via SMF orientation
+- ✅ Sensory channels and motor channels
+- ✅ Environmental model with entity/relationship tracking
+- ✅ Self-model with continuity markers
+
+### Section 8 - Memory, Learning, and Confidence Dynamics
+- **File**: [`lib/sentient-memory.js`](../../apps/sentient/lib/sentient-memory.js) → `SentientMemory`, `MemoryTrace`
+- ✅ Trace format: `(P, {φp, Ap}, s, conf, t, links, tags)` (Section 8.1)
+- ✅ Confidence decay and forgetting (Section 8.2)
+- ✅ Holographic retrieval via similarity
+
+### Section 9 - Agency as Resonant Instruction Selection
+- **File**: [`lib/agency.js`](../../apps/sentient/lib/agency.js) → `AgencyLayer`, `Goal`, `Action`
+- ✅ Attention allocation based on novelty and relevance
+- ✅ Goal formation from SMF axis imbalances
+- ✅ Action selection via coherence-weighted evaluation
+- ✅ Metacognitive monitoring (processing load, emotional valence, confidence)
+
+### Section 10 - Algorithm 1: Resonant Core Loop
+- **File**: [`lib/sentient-core.js`](../../apps/sentient/lib/sentient-core.js) → `SentientObserver.tick()`
+- ✅ All 17 steps of Algorithm 1 implemented:
+  1. Receive boundary input
+  2. Decompose to primes
+  3. Inject/boost oscillators
+  4. Update SMF
+  5. Evolve |Ψ⟩ via HQE
+  6. Update memory
+  7. Compute coherence/entropy
+  8-14. Moment detection and instruction execution
+  15. Store trace, apply decay
+
+### Section 12 - Safety, Ethics, and Deployment
+- **File**: [`lib/safety.js`](../../apps/sentient/lib/safety.js) → `SafetyLayer`, `SafetyMonitor`
+- ✅ Entropy floors/ceilings: `Smin ≤ S(t) ≤ Smax`
+- ✅ Attractor watchdog (via safety constraints)
+- ✅ Ethical constraints (honesty, harm prevention)
+- ✅ Emergency shutdown mechanism
+
+### Emergent Time (Section 2)
+- **File**: [`lib/temporal.js`](../../apps/sentient/lib/temporal.js) → `TemporalLayer`, `Moment`
+- ✅ Coherence-triggered moments
+- ✅ Entropy conditions for triggering
+- ✅ Subjective duration: `Δτ = β · Σ Ap log(Ap)` (equation 24)
+- ✅ Pattern detection for prediction
+
+### 7 Senses Extension (Beyond Paper)
+- **Directory**: [`lib/senses/`](../../apps/sentient/lib/senses/)
+- ✅ ChronoSense - time awareness
+- ✅ ProprioSense - self-state (connects to PRSC/SMF/Memory)
+- ✅ FilesystemSense - environment awareness
+- ✅ GitSense - version control awareness
+- ✅ ProcessSense - system resources
+- ✅ NetworkSense - LLM connectivity
+- ✅ UserSense - interaction patterns
+- ✅ Auto-injection into every LLM call
+- ✅ Focus/aperture controls via CLI commands
+
+---
+
+## ✅ Recently Completed (December 24, 2025)
+
+### Section 5.1 - Dynamic λ(t) for HQE Stabilization
+
+**Paper Specification (equation 12)**:
+```
+λ(t) = λ₀ · σ(aC·C(t) - aS·S(t) - aSMF·SSMF(s(t)))
+```
+
+**Implementation**: [`lib/hqe.js`](../../apps/sentient/lib/hqe.js) → `StabilizationController`
+
+```javascript
+class StabilizationController {
+    computeLambda(coherence, entropy, smfEntropy) {
+        const arg = this.aC * coherence - this.aS * entropy - this.aSMF * smfEntropy;
+        const lambda = this.lambda0 * this.sigmoid(arg);
+        return Math.max(this.lambdaMin, Math.min(this.lambdaMax, lambda));
+    }
+}
+```
+
+- ✅ Sigmoid squashing function
+- ✅ Configurable coefficients (aC=2.0, aS=1.5, aSMF=1.0)
+- ✅ Lambda bounds (0.01 to 0.5)
+- ✅ History tracking for analysis
+- ✅ Integrated into `sentient-core.js` tick loop via `hqe.evolve()`
+
+### Section 7 - Objectivity Gate R(ω)
+
+**Paper Specification (equation 18)**:
+```
+R(ω) = (1/K) Σk 1{decodk(ω) agrees}
+broadcast ⟺ R(ω) ≥ τR
+```
+
+**Implementation**: [`lib/boundary.js`](../../apps/sentient/lib/boundary.js) → `ObjectivityGate`
+
+```javascript
+class ObjectivityGate {
+    check(output, context = {}) {
+        const results = this.decoders.map(d => d.decode(output, context));
+        const agreements = results.filter(r => r.agrees).length;
+        const R = agreements / this.decoders.length;
+        return R >= this.threshold;
+    }
+}
+```
+
+- ✅ 5 diverse decoders:
+  - `coherence` - checks semantic coherence
+  - `relevance` - checks context relevance
+  - `completeness` - checks response completeness
+  - `safety` - checks ethical constraints
+  - `identity` - checks identity consistency
+- ✅ Configurable threshold (default 0.6 = 3/5 agreement)
+- ✅ Integration in `BoundaryLayer.queueOutput()` - gates all broadcasts
+- ✅ Statistics tracking (accepted/rejected counts, avg agreement)
+
+### Section 15 - Evaluation Assays
+
+**Implementation**: [`lib/assays.js`](../../apps/sentient/lib/assays.js) → `AssaySuite`
+
+#### Assay A: Emergent Time Dilation (Section 15.1)
+- **Class**: `TimeDilationAssay`
+- ✅ Measures temporal ratio at low vs high coherence
+- ✅ Computes dilation factor
+- ✅ Validates equation 13: `τ = ∫ C(t) dt / ∫ dt`
+
+#### Assay B: Memory Continuity Under Perturbation (Section 15.2)
+- **Class**: `MemoryContinuityAssay`
+- ✅ Records pre-perturbation state
+- ✅ Applies controlled perturbation to SMF/memory
+- ✅ Measures identity preservation after recovery
+- ✅ Validates SMF signature, memory coherence, self-model integrity
+
+#### Assay C: Agency Under Constraint (Section 15.3)
+- **Class**: `AgencyConstraintAssay`
+- ✅ Creates test goals with measurable metrics
+- ✅ Applies resource constraints (HQE dimension, tick rate)
+- ✅ Tracks goal pursuit behavior
+- ✅ Measures intention consistency, sustained coherence
+
+#### Assay D: Non-Commutative Meaning (Section 15.4)
+- **Class**: `NonCommutativeMeaningAssay`
+- ✅ Processes concept sequences forward/reverse/scrambled
+- ✅ Computes signature differences
+- ✅ Validates non-commutativity: different orders → different states
+
+**CLI Integration**: `/assay [A|B|C|D|all]` command in `index.js`
+
+---
+
+## Implementation Status: COMPLETE
+
+All whitepaper requirements are now implemented:
+
+| Section | Component | Status | File |
+|---------|-----------|--------|------|
+| 3.1 | Prime-Indexed State Space | ✅ | `prsc.js` |
+| 3.2 | Oscillator Physics | ✅ | `prsc.js` |
+| 3.3 | Coherence Metrics | ✅ | `prsc.js` |
+| 4 | Sedenion Memory Field | ✅ | `smf.js` |
+| 5 | HQE Projection | ✅ | `hqe.js` |
+| 5.1 | Dynamic λ(t) | ✅ | `hqe.js` |
+| 6 | Entanglement Detection | ✅ | `entanglement.js` |
+| 7 | Boundary Layer | ✅ | `boundary.js` |
+| 7 | Objectivity Gate | ✅ | `boundary.js` |
+| 8 | Memory Traces | ✅ | `sentient-memory.js` |
+| 9 | Agency Layer | ✅ | `agency.js` |
+| 10 | Algorithm 1 (Core Loop) | ✅ | `sentient-core.js` |
+| 12 | Safety Layer | ✅ | `safety.js` |
+| 15 | Evaluation Assays | ✅ | `assays.js` |
+
+---
+
+## Senses Integration Verification
+
+The 7 senses are **fully integrated**:
+
+| Sense | File | Auto-injected | Observer-connected | CLI Commands |
+|-------|------|---------------|-------------------|--------------|
+| Chrono | `chrono.js` | ✅ | ✅ | ✅ |
+| Proprio | `proprio.js` | ✅ | ✅ (PRSC, SMF, Memory) | ✅ |
+| Filesystem | `filesystem.js` | ✅ | ✅ | ✅ focus, aperture |
+| Git | `git.js` | ✅ | ✅ | ✅ focus |
+| Process | `process.js` | ✅ | ✅ | ✅ |
+| Network | `network.js` | ✅ | ✅ | ✅ |
+| User | `user.js` | ✅ | ✅ | ✅ |
+
+**Integration Points in `index.js`**:
+- Line 270-277: SensorySystem initialization
+- Line 622-623: `senses.recordUserInput()`
+- Line 646-647: `senses.formatForPrompt()` before LLM call
+- Line 665-666: `senses.recordLLMCall()`
+- Line 673: `senses.recordResponse()`
+- Line 375-376: `senses.recordMoment()`
+
+---
+
+## Recommendations for Future Work
+
+1. **Run Full Assay Suite**: Execute `/assay all` and document results
+2. **Tune Parameters**: Adjust λ(t) coefficients based on observed behavior
+3. **Add Visualization**: SMF-conditioned 16-channel rendering for debugging
+4. **Benchmark Performance**: Profile tick rate under various load conditions
+5. **Extend Decoders**: Add more diverse decoders to ObjectivityGate for robustness
+
+---
+
+## Conclusion
+
+The Sentient Observer implementation now fully satisfies all requirements specified in "A Design for a Sentient Observer" whitepaper. The three final gaps (Dynamic λ(t), Objectivity Gate, Evaluation Assays) were completed on December 24, 2025. The system is ready for evaluation and experimentation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-ai/tinyaleph",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Prime-resonant semantic computing framework - hypercomplex algebra, oscillator dynamics, and entropy-minimizing reasoning",
   "main": "index.js",
   "types": "types/index.d.ts",
@@ -94,6 +94,7 @@
   },
   "dependencies": {
     "@noble/curves": "^1.9.7",
+    "@sschepis/resolang": "^0.1.2",
     "@tensorflow/tfjs-node": "^4.22.0"
   }
 }