# THE BPHEN/DIS MASTER COPY
## Deterministic Inference System — Conceptual Framework
### Version: BASE (v3.1.0 — pre-upgrade master)
### Created: August 31, 2026
### Author: Javelion Griffin (JU), DBA Javelion Analytics™
### Documented by: SuperNinja AI (integrity auditor)

---

## PART 1: WHAT MAKES THE DIS THE DIS

The BPHEN/DIS (Deterministic Inference System) is a proprietary analytical engine created by Javelion Analytics™ for the study of systemic patterns in Black American history and the reparations movement. It is NOT a content repository, NOT a white paper, and NOT a methodology document. It is a classification and inference system — a deterministic engine that categorizes real-world events into structured analytical patterns.

### The Core Principle

The DIS operates on a simple but powerful principle: every recorded event in Black American history can be classified by which microcycle it belongs to, which phenomena it exhibits, and which era it occurred in. Once classified, patterns become visible — cycles of suppression and resistance, phenomena of erasure and reversal, eras of historical periodization. The DIS doesn't interpret; it classifies. The interpretation emerges from the classification patterns.

This is what "Deterministic" means in the name: given the same input (a news article, a historical record, a policy document), the system deterministically assigns it to a cycle, a phenomenon, and an era. The classification is not subjective — it follows defined rules. Once enough records are classified, the deterministic patterns reveal themselves.

### What the DIS IS

1. **A classification engine** — assigns every record to one of 4 microcycles, one or more of 7 phenomena, and one of 11 eras
2. **An archive of verified records** — 980 records (and growing), each with full metadata classification
3. **A real-time collection tracker** — the DIS Tracker monitors live collection from Black media sources
4. **An AI analyst (Ida)** — queries the classified archive to find patterns, transitions, and insights
5. **A cycle state monitor** — tracks which microcycle is dominant at any given time through cycle snapshots
6. **A pattern detection system** — identifies when cycle dominance shifts (transitions), when phenomena cluster (convergence), and when historical patterns repeat

### What the DIS IS NOT

1. **NOT a PENS methodology repository** — PENS is accessed through the Private Workspace application
2. **NOT a white paper** — the Dependency Loop™ white paper is a separate document
3. **NOT an analysis embedding system** — analysis is generated on-demand by Ida, not pre-embedded
4. **NOT a content management system** — it classifies and infers, it doesn't editorialize
5. **NOT a general-purpose AI** — Ida is purpose-built for DIS classification analysis

---

## PART 2: THE FOUR MICROCYCLES

The Cycle Engine Classifier assigns every record to exactly one primary microcycle. These are the fundamental analytical units of the DIS.

### C1 — FREEDOM_SUPPRESSION
**Definition:** Direct attacks on Black freedom, safety, and civil rights. State violence, voter suppression, police killings, mass incarceration, judicial discrimination, legislative rollback of civil rights protections.

**Characteristics:**
- Records document acute harm: killings, arrests, legal attacks, suppressive legislation
- Tone is defensive/reactive — the community is under attack
- Examples: police shootings, voter ID laws, gerrymandering, book bans, anti-CRT legislation
- In the current archive: 443 total records (345 in Era 11)

### C2 — ADVANCEMENT_RESISTANCE
**Definition:** Organized institutional pushback against suppression — political mobilization, legislative reparations actions, legal challenges, grassroots organizing, policy advocacy.

**Characteristics:**
- Records document active resistance: protests, lawsuits, legislative advocacy, political campaigns
- Tone is proactive/offensive — the community is fighting back
- Examples: reparations bills, voting rights litigation, grassroots political campaigns, NAACP legal actions
- In the current archive: 346 total records (230 in Era 11)

### C3 — INSTITUTIONAL_RESPONSE
**Definition:** Formal institutional reactions to Black demands — government reports, commission findings, corporate responses, university acknowledgments, policy adjustments.

**Characteristics:**
- Records document institutional action: official responses, policy changes, commission reports
- Tone is reactive/institutional — systems respond to pressure
- Examples: reparations task force reports, corporate diversity initiatives, university land acknowledgments, government apologies
- In the current archive: present in the classification system, counts vary by era

### C4 — CULTURAL_POWER_DYNAMICS
**Definition:** Cultural and soft-power dynamics — media representation, artistic expression, cultural appropriation, narrative control, hip-hop and Black media as tools of resistance.

**Characteristics:**
- Records document cultural phenomena: media coverage, artistic movements, cultural debates
- Tone is cultural/representational — the battle for narrative and identity
- Examples: hip-hop's role in chronicling resistance, media representation debates, cultural appropriation cases, Black media ownership
- In the current archive: present in the classification system, counts vary by era

### How Cycles Interact

Cycles are not static — they oscillate. When C1 (suppression) surges, it often triggers a C2 (resistance) response. When C2 builds momentum, C3 (institutional response) follows. C4 (cultural dynamics) runs parallel, providing the narrative framework. The DIS tracks these oscillations through the cycle distribution and transition detection tools.

A **micro shockwave** is a specific event that triggers a rapid cycle shift — like the March on Washington 2026 (August 28) that catalyzed the C1→C2 transition in late August 2026.

---

## PART 3: THE SEVEN PHENOMENA

Phenomena are cross-cutting analytical patterns that can appear in any cycle. A record can have multiple phenomena. These are defined in the client-side code as `PHENOMENON_DEFINITIONS`:

| Phenomenon | Definition |
|-----------|-----------|
| **ECLIPSE** | Annihilation with erasure. The complete destruction of a person, institution, or achievement, accompanied by the erasure of memory. |
| **DORMANCY** | Silence with continuity beneath the surface. A period of apparent quiet where structural patterns continue invisibly. |
| **EXODUS** | Exit at population or community scale. Large-scale departure of Black people from a place, institution, or system. |
| **COVERT_MODE** | A hidden, indirect, or deniable institutional operation. Suppression that operates through proxies, plausible deniability, or structural rather than direct means. |
| **CATALYST** | A triggering event that produces a rapid or disproportionate response. The spark that ignites a larger reaction. |
| **REVERSAL** | A rollback of an earlier gain or forward movement. The undoing of progress that was previously achieved. |
| **CONVERGENCE** | Three or more Ida cycles firing simultaneously. When multiple microcycles are all active at once, indicating a period of intense multi-dimensional activity. |

### How Phenomena Relate to Cycles

Phenomena are orthogonal to cycles — they describe the *nature* of what's happening, while cycles describe the *domain*. A C1 (suppression) record might exhibit ECLIPSE (a killing that erases a person), COVERT_MODE (a hidden voter suppression operation), or REVERSAL (rolling back voting rights). A C2 (resistance) record might exhibit CATALYST (a triggering protest) or CONVERGENCE (multiple resistance efforts firing simultaneously).

---

## PART 4: THE ELEVEN ERAS

Eras provide historical periodization. Each record belongs to exactly one era. The current era is Era 11.

| Era | Name | Period |
|-----|------|--------|
| 1 | The Middle Passage and Colonial Slavery Era | 1619–1775 |
| 2 | The Revolutionary War and Early Republic Era | 1775–1820 |
| 3 | The Antebellum Slavery Era | 1820–1865 |
| 4 | The Reconstruction Era | 1865–1877 |
| 5 | The Jim Crow Era | 1877–1915 |
| 6 | The Great Migration Era | 1915–1940 |
| 7 | The Civil Rights Movement Era | 1940–1970 |
| 8 | The Black Power Era | 1970–1980 |
| 9 | The Mass Incarceration Era | 1980–2008 |
| 10 | The Obama Era | 2008–2013 |
| 11 | The Black Lives Matter Era | 2013–Present |

**Era 11 (The Black Lives Matter Era)** is the current focus of LIVE collection. The DIS Tracker actively collects from Black media sources to build the LIVE record set for this era.

---

## PART 5: THE SYSTEM ARCHITECTURE

### 5.1 The Boot Terminal (Authentication Layer)

The DIS boots through a two-factor authentication terminal:
1. **STEP 1: ACCESS CODE** — a numeric access code (JU's credential)
2. **STEP 2: SECURITY CODE** — a 4-character security code (JU's credential)

The boot sequence displays a self-audit:
- COLLECTION STATUS: ACTIVE/STALE/OFFLINE
- ARCHIVE [MEMORY]: OK
- DETERMINISTIC INFERENCE SYSTEM [CORE]: OK
- SMART FILTER [GATE]: OK
- CYCLE ENGINE [CLASSIFIER]: OK
- BPHEN ARCHIVE: STANDBY
- HISTORICAL TRIGGER [RECALL]: STANDBY
- ARCHIVE COUNT: 980 RECORDS
- SECURITY SUBSYSTEM: ACTIVE

### 5.2 The DIS Tracker (Real-Time Collection Monitor)

The right sidebar displays real-time collection activity:
- **COLLECTION RECEIPTS** — logged from the `collection_log` table
- **ARCHIVE AUDITS** — from the `archive_audit_queue` table
- **MIRROR SYNCS** — from the `archive_sync_runs` table
- **LIVE PUBLICATIONS** — new records from `archive_items` where source_type=LIVE
- **CYCLE STATE OBSERVATIONS** — from the `cycle_snapshots` table

Operational status metrics:
- PULLING: ACTIVE/STALE
- STORIES: HEALTHY (pending count)
- VERIFIED: count of approved records
- UNUSABLE: count of rejected records
- SOURCE UNAVAILABLE: count of unreachable sources
- PENDING/PROCESSING/AUDIT FAILURES: queue states

### 5.3 The Applications

The DIS provides six applications accessible from the left sidebar:

1. **TERMINAL** — Ida's agentic workspace (chat with Ida, tool execution trace)
2. **Text Editor** — Private Writing (JU's personal writing space)
3. **Private Workspace** — PENS and Owner Records (PENS methodology studies, private analysis)
4. **Email** — Workspace Inbox
5. **Calendar** — Review Schedule
6. **Notes** — AI Journal (Ida's saved research notes)
7. **BPHEN Archive™** — Supabase Archive Records (the 980-record classified archive)

### 5.4 The Archive (Data Layer)

**Source Types:**
- **LIVE** — 623 records, actively collected from Black media sources (Era 11 focus)
- **HISTORICAL** — 356 records, archival records from earlier eras
- **ALL** — 980 total records

**Record Metadata Fields (each record has):**
- `id` — UUID
- `title` — record title
- `snippet` — short summary
- `full_text` — complete text
- `source_url` — original URL
- `source_name` — source publication name
- `source_domain` — source domain
- `source_type` — LIVE or HISTORICAL
- `primary_cycle` — C1/C2/C3/C4 classification
- `phenomena` — one or more of the 7 phenomena
- `era` — era classification
- `geo_scope` — DOMESTIC or INTERNATIONAL
- `published_at` — publication date
- `collected_at` — collection date
- `review_status` — APPROVED/PENDING/REJECTED
- `full_spectrum` — boolean flag

### 5.5 Ida (The AI Analyst)

**Model:** Google Gemini Flash Lite (via `generativelanguage.googleapis.com/v1beta`)

**Tools (6):**
1. `search_archive` — search by text AND/OR metadata fields (primary_cycle, source_type, phenomenon, era, date_from, date_to)
2. `cycle_distribution` — cycle counts grouped by publication date
3. `detect_transitions` — sliding-window cycle dominance shift detection
4. `web_search` — external DuckDuckGo search
5. `list_project_folders` — list owner's project folders
6. `append_project_note` — save research notes to project folders

**Tool Step Limit:** 12 turns (increased from 5 in the upgrade)

**System Prompt:** Defines Ida's identity and methodology. Currently includes PENS references (recommended for removal — see PENS embedding investigation).

---

## PART 6: THE DATABASE (SUPABASE TABLES)

The DIS uses the following Supabase tables:

### Core Archive Tables
| Table | Purpose |
|-------|---------|
| `archive_items` | The 980 classified records (all metadata fields) |
| `archive_folders` | System folders for eras and classifications |
| `archive_folder_items` | Mapping between folders and items |

### Collection Tracking Tables
| Table | Purpose |
|-------|---------|
| `collection_log` | Collection receipts (scan timestamps) |
| `archive_audit_queue` | Audit queue (review status tracking) |
| `archive_sync_runs` | Mirror sync runs (sync status) |
| `cycle_snapshots` | Pre-computed cycle state (dominant cycle, phase, confidence, scores) |

### Workspace Tables
| Table | Purpose |
|-------|---------|
| `workspace_conversations` | Chat conversations with Ida |
| `workspace_messages` | Individual messages (USER/IDA roles) |
| `workspace_notes` | Saved research notes |
| `workspace_project_folders` | Project folders for organizing notes |

### PENS Tables (Private Workspace — Separate from DIS Core)
| Table | Purpose |
|-------|---------|
| `ida_pens_methodologies` | PENS methodology catalog |
| `ida_pens_training_analyses` | Individual PENS training analyses |

---

## PART 7: THE API ENDPOINTS

### Archive API (`/api/archive`)
| Endpoint | Purpose |
|----------|---------|
| `?type=stats` | Archive statistics (cycle counts, source type counts) |
| `?type=items&source_type=LIVE&cycle=ADVANCEMENT_RESISTANCE` | Filtered archive items |
| `?type=folders` | System folders list |
| `?type=folder-items&slug=...` | Items in a specific folder |
| `?type=cycle-state` | Current cycle state from cycle_snapshots |
| `?type=activity` | Recent collection activity |
| `?type=audit` | Archive audit workload |
| `?type=health` | System health metrics |

### PENS API (`/api/pens/methodology`)
| Endpoint | Purpose |
|----------|---------|
| `/api/pens/methodology` | PENS methodology catalog + analysis list |
| `/api/pens/methodology/training/{id}` | Specific PENS training analysis (requires auth) |

### Workspace API
| Endpoint | Purpose |
|----------|---------|
| `/api/conversations` | List conversations |
| `/api/conversations/{id}/messages` | Get/post messages to Ida |
| `/api/notes` | List notes |
| `/api/notes/{id}` | Get specific note |
| `/api/project-folders` | List project folders |
| `/api/project-folders/{id}` | Get specific folder |
| `/api/login` | Authentication |
| `/api/logout` | End session |

---

## PART 8: WHAT SHOULD AND SHOULD NOT BE IN THE DIS

### SHOULD Be in the DIS (Core System):
- The 4 microcycles (C1-C4) and their definitions
- The 7 phenomena and their definitions
- The 11 eras and their periodization
- The archive of classified records
- The DIS Tracker (real-time collection monitoring)
- The cycle state system (cycle_snapshots)
- Ida's 6 tools for querying the archive
- The authentication system (boot terminal)
- The applications framework (Terminal, Archive, Notes, etc.)

### SHOULD NOT Be in the DIS (Accessed Through Applications):
- PENS methodology content → Private Workspace application
- PENS training analyses → Private Workspace application (already in separate tables)
- The Dependency Loop white paper → Separate document/application
- Pre-written analysis/study text → Should be generated on-demand by Ida, not embedded
- PENS references in Ida's base identity prompt → Should be removed (see investigation doc)

### The Principle:
The DIS is a classification and inference engine. It classifies records and infers patterns. Everything else — methodology, analysis, white papers, personal writing — lives in separate applications and is accessed through tools, not embedded in the system's core identity.

**JU's analogy is the guiding principle:** "Could you imagine if all the archives was embedded in the DIS? That would be silly, right? So why is the PENS frameworks and the analysis embedded within the DIS?"

The archive is accessed through `search_archive`. PENS should be accessed through the Private Workspace. Analysis should be generated by Ida on-demand. The DIS stays clean — a deterministic classification and inference engine.