# BlackRoad OS Research Index

This index collects the core theory, specifications, and experiments that form the research substrate for BlackRoad OS. Use it to navigate foundational SIG geometry, PS-SHA∞ identity mechanics, Lucidia orchestration theory, and supporting audits or simulations.

## Research Engine
- **Master Prompt**
  - [Research Engine Master Prompt (V0.1.64)](research/system/prompts/research_master_prompt.md): the 64-Lab Research Intelligence Specification defining the scientific and philosophical engine of the BlackRoad OS civilization.

## Core Foundations
- **Spiral Information Geometry**
  - [SIG Overview](sig/sig-overview.md): defines the `(r, θ, τ)` spiral coordinate system, interference patterns, and factor-tree projection.
  - [SIG Overview (Paper)](papers/spiral-information-geometry/sig-overview.md): paper-style treatment of the spiral model with additional context.
  - [SIG Factor Tree](papers/spiral-information-geometry/sig-factor-tree.md): prime-factor DNA and tree mapping for agents on the spiral.
- **PS-SHA∞ Identity**
  - [PS-SHA∞ Definition](ps-sha-infinity/definition.md): identity-first hashing, worldline anchoring, and separation of identity vs. truth.
  - [PS-SHA∞ Overview (Paper)](papers/ps-sha-infinity/ps-sha-infinity.md): worldline journaling, chain properties, and audit motivations.
  - [PS-SHA∞ References](papers/ps-sha-infinity/references.md): supporting citations and related prior art.
- **Lucidia Kernel**
  - [Lucidia Architecture](lucidia/architecture.md): mesh-based Generation-0 agent kernel, QLM-inspired routing, and contradiction handling.
- **RoadChain Ledger**
  - [RoadChain Ledger Theory](roadchain/ledger-theory.md): event journaling, deterministic aggregation, and block formation aligned to PS-SHA∞.

## Glossary and Reference
- [Concepts](glossary/concepts.md): canonical definitions across SIG, PS-SHA∞, agents, and orchestration.
- [Symbols](glossary/symbols.md): symbol table for recurrent notation.
- [References](references/README.md): external citations and supporting resources.
- [Notes](notes/README.md): working notes and research stubs.

## Papers by Domain
- **Agent Architecture**
  - [Trinary Logic in BlackRoad OS](papers/agent-architecture/trinary-logic.md): three-state reasoning and aggregation rules.
  - [Contradiction Handling](papers/agent-architecture/contradiction-handling.md): managing disagreement and escalation patterns.
- **Spiral Information Geometry**
  - [SIG Overview (Paper)](papers/spiral-information-geometry/sig-overview.md)
  - [SIG Factor Tree](papers/spiral-information-geometry/sig-factor-tree.md)
- **PS-SHA∞**
  - [PS-SHA∞ Overview](papers/ps-sha-infinity/ps-sha-infinity.md)
  - [PS-SHA∞ References](papers/ps-sha-infinity/references.md)
- **Truth and Orchestration Drafts**
  - [Truth Engine Spec (Draft)](papers/draft/truth-engine-spec.md)
- **Finance Automation**
  - [Regulated Industry Considerations](papers/finance-automation/regulated-industry-considerations.md)
  - [Automated Finance Architecture](papers/finance-automation/automated-finance-architecture.md)

## Experiments and Simulations
- [Contradiction Simulator](experiments/contradiction-sim/README.md): trinary belief aggregation and conflict scoring sandbox.
- [SIG Visualizations](experiments/sig-visualizations/README.md): text-based factor tree rendering and spiral coordinate experiments.

## Catalogs and Schemas
- **Library**: JSON metadata catalogs under [`/library`](library/) for external references.
- **Schemas**: JSON Schemas under [`/schemas`](schemas/) describing PS-SHA∞ journal entries, SIG nodes, and related structures.