The Forgotten Code Research Institute

CEREBRO

Civilizational Dynamics Engine · Pendulum Physics Applied to History

Live Site & Locations

1. LIVE SITE & LOCATIONS

Live site (Vercel)	https://cerebro-deploy.vercel.app/
Codebase	cerebro/

What It Is

2. WHAT IT IS

CEREBRO models four societal pendulums (clocks) and a Composite Pressure Index to quantify system state. Users ask plain-English predictive queries via the Oracle and read long-form dispatches in the Pendulum Gazette.

Concept	Description
Four Clocks	Harm Tolerance, Class Permeability, Sexual Pendulum, Good vs. Evil
Composite Pressure Index	Weighted aggregate (−10 to +10); e.g. +0.8 = "SYSTEM SWINGING"
Saddle	Inflection point: low velocity, acceleration opposes direction; high policy-change risk
Oracle	Plain-English predictive query engine (GSS + Pew Ring B loaded)
Pendulum Gazette	Long-form dispatches for each clock

The Four Clocks

CLOCK 01

HARM TOLERANCE

Maximum Harm ←→ Maximum Protection

CLOCK 02

SEXUAL PENDULUM

Constraint ←→ Autonomy

CLOCK 03

CLASS PERMEABILITY

Extraction ←→ Redistribution

CLOCK 04

GOOD VS. EVIL

Cruelty ←→ Accountability

Data Architecture — Ring System

3. RING SYSTEM

Ring	Purpose	Data Type	Confidence
Ring A	Structural (behavioral, institutional)	FRED, BJS, FBI, CDC, World Bank	90%+
Ring B	Normative (attitudes, beliefs)	GSS, Pew, ISSP	94% (GSS)
Ring C	External pressure (geopolitical, environmental)	UCDP, ACLED, Freedom House, UNHCR	88–92%
L1	Leading indicators (search, attention)	Google Trends	85%
L2	Narrative intelligence (text, migration)	GBCD Corpus	82%

Saddle Detection

4. PRODUCTION RULE

detect_saddle_canonical: |v| < 0.15 AND sign(a) opposes sign(v)

v = velocity (rate of change). a = acceleration. Opposes = (v>0 and a<0) or (v<0 and a>0). Calibration expands candidates for statistical power; production uses core saddles only.

Key Metrics & File Locations

5. KEY METRICS

Harm Clock: clock_position_10pt, velocity, acceleration, saddle_score (0–3), ring_B_pct, analogues, release_risk, energy_score.

Composite Pressure Index: Weighted average of four clock positions. Phases: SYSTEM SWINGING, LOADING, RECOVERY.

Country Risk: (Gini × 0.3) + (income polarization × 0.25) + (redistribution demand × 0.2) + (migration narrative × 0.15) + (UCDP trend × 0.1)

6. KEY FILE LOCATIONS

Scripts: run_all.sh, cerebro_export_ui_data.py, cerebro_oracle_router.py, cerebro_pipeline.py, cerebro_calibration.py, cerebro_risk_engine.py, cerebro_core/__init__.py

Data: cerebro_harm_clock_data.csv, public/cerebro_data.json

Docs: DATA_SOURCES_REGISTRY.md, DATA_COLLECTION_STEPS.md, DEPLOY.md

Deploy & Oracle

7. DEPLOY & REFRESH

Vercel: Output directory public/. Build: python cerebro_export_ui_data.py.

Refresh: ./run_all.sh then python cerebro_export_ui_data.py, then push.

8. ORACLE QUERY TYPES

Intent	Example
METHOD	"What is the exact mathematical rule for saddle detection?"
era	"What historical era does 2022 most resemble?"
FORECAST	"When does the wealth redistribution crisis peak?"
country_unequal	"Top 10 most unequal countries"
country_risk	"Country risk of class-driven political violence before 2030"
apogee_multi	"Show all four apogees"
loaded	"How loaded is the system right now?"
trends	"Cultural velocity for 'defund the police' vs 'back the blue'"
punitive	"Are we heading into a punitive crime era?"

What Makes It Special

9. WHAT MAKES IT SPECIAL

Pendulum physics applied to history — position, velocity, acceleration, saddle detection
Ring system — Structural (A), normative (B), external (C), leading (L1), narrative (L2)
Walk-forward calibration — past-only analogues; no future leakage
Redundant pipeline — PRIMARY (Trends) → BACKUP 1 (cache) → BACKUP 2 (GSS) → BACKUP 3 (static)
Oracle — plain-English queries routed to live engine
Country risk — Gini + polarization + redistribution + migration + UCDP
CHIMERA — synthetic adversarial worlds, stress-test saddle detection