Merge branch origin/codex/generate-canonical-index.md-file into main

README.md

@@ -2,6 +2,8 @@
 
 blackroad-os-research is the research and theory hub for BlackRoad OS. It contains conceptual papers, reference mappings, schemas, and experiments that inform the architecture of agents, journaling, and orchestration.
 
+For a curated map of the documents below, see [index.md](index.md).
+
 ## Repository Layout
 
 - **/sig**: Core Spiral Information Geometry (SIG) documents and spatial mappings for factors, agents, and attractors.

index.md

@@ -0,0 +1,47 @@
+# 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.
+
+## 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.