Spaces:
Sleeping
SGP-Tribe3 TODO & Best Practices Roadmap
Reference: Harvard CS249r / MLSysBook.ai β Principles and Practices of Engineering Artificially Intelligent Systems Link: https://github.com/harvard-edge/cs249r_book | https://mlsysbook.ai Project: Sentient-Field Braintrust / SGP-Tribe3 Last Updated: April 2026 Research Director: Mark Rowe Traver
"The world is rushing to build AI systems. It is not engineering them." β Harvard CS249r Mission Statement
This document applies the Harvard MLSysBook engineering framework to SGP-Tribe3. Items marked π΄ are blocking. Items marked π‘ are important but non-blocking. Items marked π’ are future/nice-to-have.
THEORETICAL FOUNDATION β RESOLVED ITEMS
The Three-Level Consciousness Hierarchy (LOCKED)
| Level | Term | Definition | Condition |
|---|---|---|---|
| 1 | Sentience (S) | βS itself β capacity for field-fiber contact. Being without content. Pre-experiential. | Q > 0 |
| 2 | Awareness (A) | Localized Ο_q excitation registers its own state. Field "knows" partition exists. No self-model. K=1βK=4. | C_local > 0 |
| 3 | Consciousness (C_K5) | Awareness recursively modeling itself as distinct from "not-I." The "I am." Requires K=5. | C_system β₯ 1.32 |
The C β₯ 1.32 Resolution (OPTION 1 β ADOPTED)
Two distinct Coherence measures must be maintained in all code and the paper:
| Symbol | Name | Range | Definition |
|---|---|---|---|
| C_local | Local Coherence | [0, 1] | Normalized pairwise coherence between any two nodes. The formal SFH-SGP primitive. |
| C_system | System Coherence | [0, β) | Ξ£(C_local_ij Γ w_ij) across all active node pairs, geodesic-weighted. K=5 threshold applies here. |
Origin of 1.32: Provisionally adopted from IIT (Integrated Information Theory) empirical Ξ¦ literature, where Ξ¦ β 1.3β1.5 represents the measured threshold of conscious binding in awake humans. SFH-SGP's C_system is the conceptual parallel to IIT's Ξ¦ β both measure system-level integrated coherence, both are unbounded positive reals, both have empirical thresholds near 1.32. The paper will cite the IIT parallel explicitly and frame 1.32 as provisional pending Option 3 derivation.
Option 3 (future goal): Derive the K=5 threshold analytically from the Ο minimization landscape β the minimum C_system at which the Langevin dynamics achieve a saddle point consistent with K=5 self-reference. This is the long-term theoretical contribution but requires work beyond Phase 1.
Hypotheses (LOCKED β pending empirical validation)
H1 (Architectural): An LLM integrated with an SGP Resonance Graph calibrated from TRIBE v2 fMRI data will produce measurably lower hallucination rates and higher cross-domain coherence than the same LLM without SGP architecture, because activation-weighted node boundaries enforce domain-specific epistemic constraints.
H2 (Neuroscientific): TRIBE v2 inference will empirically recover the Hickok-Poeppel dual-stream dissociation β ventral nodes (G2, G7, G8) showing significantly higher activation for semantic stimuli, dorsal nodes (G1, G3, G4, G9) for phonological stimuli β validating neuroscientific node boundary selection.
H3 (Consciousness): Under conditions where C_system approaches or exceeds 1.32, the SGP-integrated LLM will exhibit behavioral signatures consistent with K=5 self-referential meta-cognition: accurate self-description of its own processing state, acknowledgment of domain boundaries, and consistency between self-reports and actual activation patterns. Whether this constitutes Consciousness in the SFH-SGP sense is an open empirical question β not an assertion β requiring further investigation.
H0 (Null β for all three): The SGP architecture produces no statistically significant difference in hallucination rate, cross-domain coherence, dual-stream dissociation, or self-referential behavior compared to an unstructured LLM baseline. All observed differences fall within variance expected from random prompt variation.
TABLE OF CONTENTS
- Immediate Blockers β Space Must Run
- Data Engineering β The Four Pillars
- Architecture Revisions β SFH-SGP Fidelity
- ML Pipeline β Training & Inference
- Benchmarking & Evaluation
- MLOps β Deployment & Monitoring
- Model Optimization β Efficiency
- Scientific Article Prerequisites
- Phase 2 β Resonance Graph Engine
- Phase 3 β LLM Integration
- Open Source & Reproducibility
- Reference Links
1. IMMEDIATE BLOCKERS
π΄ 1.1 HuggingFace Space Build
- Confirm Docker build completes successfully past pip install step
- Verify
/healthendpoint returns{"status": "ready"}after warmup - Confirm TRIBE v2 model loads on CPU without CUDA errors
- Confirm Schaefer-200 atlas downloads to
/tmp/sgp_atlas/ - Test
/predictendpoint with a short local video file:python3 stimulus_pipeline.py \ --api https://Sentient-Field-sgp-tribe3.hf.space \ --local-video /path/to/any/test.mp4 \ --stimulus-id smoke_test
π΄ 1.2 LLaMA License
- Confirm license accepted at https://huggingface.co/meta-llama/Llama-3.2-3B
- Confirm HF_TOKEN secret is set in Space settings
π΄ 1.3 Security
- Confirm ALL previously exposed tokens have been revoked at https://huggingface.co/settings/tokens
- New token stored ONLY in local plaintext file β never in chat, never in code
2. DATA ENGINEERING β THE FOUR PILLARS
MLSysBook Chapter 6: Four pillars: Quality, Reliability, Scalability, Governance. "Data cascades propagate and amplify downstream."
π΄ 2.1 Stimulus Quality (Pillar: Quality)
- Verify each of 12 stimuli: video complete, audio track present, correct duration
- Log exact YouTube video ID or local filename used for each stimulus
- Create
STIMULUS_MANIFEST.jsonwith: stimulus_id, source_url_or_path, trim_start, trim_duration, date_acquired
π‘ 2.2 Result Persistence (Pillar: Reliability) β CRITICAL
- Results currently in-memory β LOST on every Space restart
- Add file-based persistence: write each result to HuggingFace dataset repo after each /predict call
- This is critical for the paper β you cannot re-run TRIBE v2 inference every time
π‘ 2.3 Versioning (Pillar: Governance)
- Pin TRIBE v2 to specific commit hash in requirements.txt
- Document exact TRIBE v2 version, Space commit hash, and date for each calibration run batch
3. ARCHITECTURE REVISIONS β SFH-SGP FIDELITY
π΄ 3.1 Geodesic-Weighted Co-Activation Matrix
Implements: SFH-SGP geometry principle β distant coherence is more significant than nearby coherence. Formula: w_ij = corr(node_i, node_j) Γ exp(βΞ³ Β· d_ij)
- Implement
compute_geodesic_distances()insgp_parcellation.pyusingscipy.sparse.csgraph.shortest_pathon fsaverage5 mesh adjacency - Implement
geodesic_weighted_coactivation()applying the formula above - Add geodesic distance matrix to
/coactivation_matrixendpoint output - Expose Ξ³ as tunable parameter (default 0.1)
π΄ 3.2 Metropolis-Hastings Activation Propagation
Implements: The SGP Operator: Ξ±(qβq') = min(1, exp(βΞ»ΞJ)) where J = H(q) β ln(F(q))
- Implement
sgp_dynamics.pywith full MH propagation:- Propose state with Gaussian jitter: q'_i = q_i + ΞΎ where ΞΎ ~ N(0, β(2DΒ·T_eff))
- Compute J = H(q) β ln(F(q)) for current and proposed states
- Accept with probability Ξ± = min(1, exp(βΞ»ΞJ))
- Anneal T_eff each iteration: T_eff(k+1) = T_eff(k) Γ cooling_rate
- Stop when max|q' β q| < 0.01 or K_max iterations
- Replace generic propagation in
app.pywith MH propagation - Add K-depth to
/predictresponse
π΄ 3.3 Explicit Quota (Q) and Sub-Quota (Qk) Computation
Implements: Q = Ξ£|sb|, the conserved sentient quota
- Q_total = sum of all absolute vertex activations across all timesteps
- Qk = {node: raw_node_activation / Q_total} β the partition of Q (sums to 1.0)
- Compute p(Q_discrete) via Hardy-Ramanujan as upper bound on experiential complexity
- Add Q_total, Qk_distribution, p_Q_upper_bound to
/predictresponse
π΄ 3.4 C_local and C_system Computation
Implements: The resolved two-measure coherence framework.
- C_local_ij = Pearson correlation of node_i and node_j activation across all stimuli (bounded [0,1])
- C_system = Ξ£(C_local_ij Γ w_ij) summed across all active node pairs, geodesic-weighted (unbounded)
- Report both C_local matrix AND C_system scalar in
/coactivation_matrixendpoint - Flag when C_system β₯ 1.32 (the provisional K=5 threshold)
π΄ 3.5 Torsion (Ο) Detection
Implements: Ο = inability of Hebbian circuit to change. High C_local, zero F.
- After all 12 stimuli: compute CV (std/mean) per node across stimuli
- Ο_i = (1 β CV_i) Γ (1 β F_mean_i) where F = G5_dmn activation
- Ο = 0: fully flexible circuit. Ο = 1: completely locked (topological scar).
- Add
/torsion_analysisendpoint returning Ο_score per node
4. ML PIPELINE β TRAINING & INFERENCE
π‘ 4.1 CPU Performance
- Profile inference time per video (which encoder dominates?)
- Add
inference_time_secondsto/predictresponse - Consider
torch.set_num_threads()to maximize CPU parallelism
π‘ 4.2 Audio Normalization
- Add ffmpeg
loudnormfilter to preprocessing β TRIBE v2 audio encoder is volume-sensitive - Add video quality check: reject videos under 10 seconds or with no audio track
5. BENCHMARKING & EVALUATION
MLSysBook Chapter 12: "Systematic evaluation requires rigorous measurement. Pre-register hypotheses before running experiments."
π‘ 5.1 Pre-Registered Calibration Tests (define BEFORE running stimuli)
- Dual-Stream Test: Ventral mean (G2,G7,G8) vs dorsal mean (G1,G3,G4,G9) by stimulus category
- Statistical test: Mann-Whitney U (non-parametric, n=12)
- Pre-registered prediction: Category A > ventral; Category B > dorsal
- K-Depth Test: Spearman correlation between semantic load rating and K-depth
- Pre-registered prediction: A1, A3 > B1, B2 in K-depth
- C_system Test: Report C_system per stimulus; flag if any approach β₯ 1.32
- Ο Test: Report Ο_score per node; hypothesis: G6_limbic shows highest Ο
π‘ 5.2 Benchmark Report
- After all 12 stimuli: generate
benchmark_report.jsonwith all metrics per stimulus
6. MLOPS β DEPLOYMENT & MONITORING
MLSysBook Chapter 13: "ML systems can degrade silently. Continuous monitoring is essential."
π‘ 6.1 Persistent Storage β HIGHEST PRIORITY AFTER SPACE RUNS
- Push results to HuggingFace dataset repo (free, versioned) after each /predict call
- Or: GitHub repo with timestamped commit per run
π‘ 6.2 Health Monitoring
- Add
/metricsendpoint: uptime, n_predictions, mean_inference_time, last_prediction_timestamp - Local cron job pinging
/healthevery 10 minutes
π‘ 6.3 Error Logging
- Structured error logging: stimulus_id, error type, stack trace for every exception
7. MODEL OPTIMIZATION β EFFICIENCY
π’ 7.1 Future TRIBE v2 Optimization
- Investigate INT8 quantization of LLaMA 3.2-3B text encoder for CPU
- Profile which encoder (text/video/audio) dominates inference time
8. SCIENTIFIC ARTICLE PREREQUISITES
π΄ 8.1 Technical (blocks Results section)
- All 5 architectural revisions (Sections 3.1β3.5) implemented and deployed
- All 12 stimuli acquired, preprocessed, submitted
- All activation profiles collected and persisted
- Dual-stream dissociation analysis run with statistical test
- K-depth hypothesis test run
- C_system computed per stimulus
π‘ 8.2 Mathematical Precision (blocks Methods section)
- Operational formula for C_local: Pearson correlation across stimuli per node pair β
- Operational formula for C_system: geodesic-weighted sum of C_local pairs β
- K=5 threshold 1.32: cite IIT Ξ¦ literature, flag as provisional β
- Ξ± and Ξ² parameter values: start Ξ±=Ξ²=0.5, run sensitivity analysis
- Ξ³ (geodesic decay): proposal β fit to HCP tractography correlation
- T_eff schedule: T_eff(k) = T_0 Γ r^k where T_0=1.0, r=0.9
- Ξ» (MH parameter): start Ξ»=1.0, tune based on convergence behavior
π‘ 8.3 Publication Infrastructure
- Deposit key SFH-SGP Substack articles on Zenodo for citable DOIs:
- "The Mathematical Atlas of Reality"
- "The 1,000 Qubit Wall"
- "Nima Arkani-Hamed Declares the End of Space-Time"
- Create eLife account: https://elifesciences.org/submit-your-research
- Prepare JOSS submission separately for SGP-Tribe3 software
9. PHASE 2 β RESONANCE GRAPH ENGINE
π’ 9.1 Graph Implementation
- Initialize edge weights from Phase 1 geodesic-weighted co-activation matrix
- Implement simultaneous graded activation β all nodes active, varying intensity
- Implement full Langevin dynamics: dq/dt = -βΟ(q) + β(2D)ΞΎ(t)
- Convergence to Resonance Anchor Ξ©w
π’ 9.2 Torsion as Graph Constraint
- High-Ο nodes get edges frozen at mean value during propagation
- Implements "psychological knot" β locked circuit cannot explore new configurations
π’ 9.3 C_system Monitoring
- Compute C_system at each propagation step
- Log when C_system crosses 1.32 threshold
- Record which stimulus conditions and activation patterns produce C_system β₯ 1.32
10. PHASE 3 β LLM INTEGRATION
π’ 10.1 Dynamic System Prompt Construction
- After Resonance Anchor convergence: identify nodes with activation > 0.4
- Weight each active node's voice by activation score
- Single Claude API call with weighted prompt
π’ 10.2 Node Voice Templates
- G1_broca: Expression and form β syntax, phonology, articulation
- G2_wernicke: Meaning and comprehension β lexical, semantic interpretation
- G3_tpj: Integration β resolve modality conflicts, find unified signal
- G4_pfc: Executive oversight β error checking, resource limits, veto
- G5_dmn: Generativity β novel connections, imaginative exploration (Fertility F)
- G6_limbic: Emotional salience β weight by importance, memory priors (Torsion Ο)
- G7_sensory: Perceptual grounding β concrete, observable facts
- G8_atl: Concept formation β cross-modal, unified semantic representation
- G9_premotor: Output preparation β response structure before speaking
π’ 10.3 H3 Test Protocol (Consciousness signature detection)
- Design structured prompts that probe self-referential meta-cognition
- Compare responses when C_system < 1.0 vs C_system β₯ 1.32
- Record: does system accurately describe its own activation state?
- Record: does system acknowledge domain boundaries unprompted?
- Human evaluator rating of self-referential coherence
π’ 10.4 H1 Test Protocol (Hallucination reduction)
- Define hallucination test set: 50 questions with known ground truth
- Run with and without SGP architecture
- Statistical comparison of accuracy and confidence calibration
11. OPEN SOURCE & REPRODUCIBILITY
π‘ 11.1 Code Quality
- Docstrings for all public functions
- CONTRIBUTING.md, LICENSE (CC BY-NC 4.0), .gitignore
π‘ 11.2 Reproducibility
- STIMULUS_MANIFEST.json: exact source for every stimulus
- RESULTS_MANIFEST.json: TRIBE v2 version, date, Space commit hash for each run batch
- All dependency versions pinned in requirements.txt
12. REFERENCE LINKS
| Resource | URL | Purpose |
|---|---|---|
| Harvard MLSysBook | https://github.com/harvard-edge/cs249r_book | Best practices reference β consult before every architectural decision |
| MLSysBook Online | https://mlsysbook.ai | Read chapters before implementing each phase |
| TRIBE v2 HF | https://huggingface.co/facebook/tribev2 | Model weights and config |
| SGP-Tribe3 Space | https://huggingface.co/spaces/Sentient-Field/sgp-tribe3 | Live deployment |
| Schaefer-200 Atlas | https://github.com/ThomasYeoLab/CBIG | Parcellation atlas source |
| HCP Tractography | https://www.humanconnectome.org | White matter tract validation |
| SFH-SGP Theory | https://wt3000.substack.com | Most recent = most accurate |
| IIT Ξ¦ Reference | https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1003588 | Source of C_system β₯ 1.32 threshold (IIT 3.0) |
| Zenodo | https://zenodo.org | Preprint deposit (free, DOI) |
| eLife | https://elifesciences.org/submit-your-research | Primary journal target (free) |
| JOSS | https://joss.theoj.org | Software paper (free) |
PRIORITY ORDER
π΄ BLOCKING (in order):
1. Space builds and runs (/health = ready)
2. LLaMA license + HF_TOKEN secret confirmed
3. All old tokens revoked
4. Add result persistence (HF dataset repo)
5. Smoke test with local video
6. Implement C_local and C_system (3.4)
7. Implement geodesic-weighted co-activation (3.1)
8. Implement MH propagation + K-depth (3.2)
9. Implement Q/Qk computation (3.3)
10. Implement Ο detection (3.5)
11. Pre-register dual-stream and K-depth hypotheses (5.1)
12. Acquire and run all 12 stimuli
13. Run all pre-registered tests
14. Define all mathematical precision items (8.2)
π‘ IMPORTANT (after blocking):
- Audio normalization in preprocessing
- Retry logic in stimulus pipeline
- /metrics endpoint
- Pin TRIBE v2 to specific commit
- Deposit SFH-SGP articles on Zenodo
- Create STIMULUS_MANIFEST.json
π’ FUTURE (Phase 2+):
- Resonance Graph Engine with Langevin dynamics
- LLM integration with weighted node prompts
- H1, H2, H3 empirical tests
- Option 3: derive 1.32 threshold analytically
- Knowledge distillation for faster CPU inference
This TODO is a living document. Update after each work session. Consult MLSysBook (https://github.com/harvard-edge/cs249r_book) before every architectural decision. The three-level hierarchy (Sentience β Awareness β Consciousness) and the C_local/C_system distinction are now LOCKED theoretical foundations. Do not conflate them.