# The Cosmic Codex
> The reference for Universal Language — a mathematically proven formal language built on five geometric primitives.

## Overview
Universal Language (UL) is a formal system where meaning IS geometry. Every concept is constructed from five shapes (Point, Line, Angle, Curve, Enclosure) composed through eleven algebraic operations on four algebraic sorts.

## Sections

### Five Codex Siblings
- [Lexicon](https://cosmiccodex.app/lexicon): 42 canonical definitions organized by constructive level. Each entry is justified by geometric uniqueness.
- [Thesaurus](https://cosmiccodex.app/thesaurus): Paths between related meanings organized by 5 primitive families (Existence Family, Relation Family, Quality Family, Process Family, Concept Family).
- [Syntax](https://cosmiccodex.app/syntax): How marks connect — 4 algebraic sorts, 6 well-formedness rules, 3 sentence types, 5-pass reading procedure.
- [Grammar](https://cosmiccodex.app/grammar): Why meanings emerge from geometry — Erlangen Program hierarchy, symmetry classification → parts of speech.
- [Symbology](https://cosmiccodex.app/symbology): The 5 geometric primitives (Point, Line, Angle, Curve, Enclosure) and their distinguished forms.
- [Proofs](https://cosmiccodex.app/proofs): 23 proven theorems establishing the formal foundations.
- [Compose](https://cosmiccodex.app/compose): Expression builder — build UL expressions from primitives and operations. Includes blueprint recipes.

### Reference Collections
- [Greek Alphabet](https://cosmiccodex.app/reference/greek): 24 letters with scientific, mathematical, and metaphysical associations.
- [Hebrew Alphabet](https://cosmiccodex.app/reference/hebrew): 22 letters with pictographic meanings and cultural significance.
- [Adinkras](https://cosmiccodex.app/reference/adinkras): African cultural symbology meets quantum physics supersymmetry.
- [Quantum Physics](https://cosmiccodex.app/reference/quantum-physics): Bosons and fermions — fundamental particles reference.
- [Calendars](https://cosmiccodex.app/reference/calendars): Galactic Center–aligned calendars for 2024–2048.

## Key Concepts
- **Five Primitives**: Point (Existence), Line (Relation), Angle (Quality), Curve (Process), Enclosure (Concept)
- **Four Sorts**: Entity (e), Relation (r), Modifier (m), Assertion (a)
- **Eleven Operations**: predicate, modify_entity, modify_relation, negate, conjoin, disjoin, embed, abstract, compose, invert, quantify
- **Three Tiers**: T1 (forced by axioms), T2 (motivated by geometry), T3 (conventional)
- **Governing Principle**: A construction's meaning IS its geometry.

## Theorems

### Foundation (5)
- [T1 Unique Grounding Theorem](https://cosmiccodex.app/proofs#unique-grounding): Every well-formed UL expression has a unique decomposition into the five primitives.
- [T2 Primitive Irreducibility](https://cosmiccodex.app/proofs#primitive-irreducibility): No primitive can be derived from the other four.
- [T3 Sort Completeness](https://cosmiccodex.app/proofs#sort-completeness): The four sorts (G, T, R, C) classify all well-formed expressions without overlap or gap.
- [T4 Operation Closure](https://cosmiccodex.app/proofs#operation-closure): The 11 Σ_UL operations are closed over the set of well-formed expressions.
- [T5 Finite Composition](https://cosmiccodex.app/proofs#finite-composition): Every well-formed expression uses finitely many applications of primitives and operations.

### Structural (7)
- [T6 Sort Preservation Under Operations](https://cosmiccodex.app/proofs#sort-preservation): Each operation signature specifies the sorts of its inputs and output.
- [T7 Level Monotonicity](https://cosmiccodex.app/proofs#level-monotonicity): The constructive level of a compound expression is always greater than or equal to the levels of its constituent parts.
- [T8 Level Well-Ordering](https://cosmiccodex.app/proofs#level-well-ordering): The constructive levels form a well-ordered set.
- [T9 Sort–Operation Compatibility](https://cosmiccodex.app/proofs#sort-operation-compatibility): The sort system and operation system are mutually consistent: no operation can produce a sort violation, and no sort restriction blocks a structurally valid operation.
- [T10 Negation Involution](https://cosmiccodex.app/proofs#negation-involution): Applying the negate operation twice to any well-formed expression returns the original expression.
- [T11 Composition Associativity](https://cosmiccodex.app/proofs#composition-associativity): The compose operation is associative: composing (f ∘ g) ∘ h yields the same result as f ∘ (g ∘ h) for all composable well-formed expressions.
- [T12 Abstraction–Embedding Duality](https://cosmiccodex.app/proofs#abstraction-embedding-duality): The abstract and embed operations form a dual pair: abstracting an embedded expression recovers the original, and embedding an abstracted expression recovers the original, up to canonical equivalence.

### Advanced (11)
- [T13 Symmetry Classification Theorem](https://cosmiccodex.app/proofs#symmetry-classification): Every well-formed expression belongs to exactly one symmetry class determined by its transformation group under the Erlangen Program hierarchy.
- [T14 Invariant Preservation](https://cosmiccodex.app/proofs#invariant-preservation): For each symmetry class, there exists a set of geometric invariants that are preserved by all transformations in the corresponding group.
- [T15 Erlangen Completeness](https://cosmiccodex.app/proofs#erlangen-completeness): The Erlangen Program hierarchy applied to UL captures all geometrically meaningful distinctions between expressions.
- [T16 Primitive Independence of Axioms](https://cosmiccodex.app/proofs#primitive-independence): The axioms governing each primitive are independent: no axiom can be derived from the remaining axioms.
- [T17 Expressive Completeness](https://cosmiccodex.app/proofs#expressive-completeness): Any concept expressible in any natural or formal language can be represented as a well-formed UL expression using the five primitives and eleven operations.
- [T18 Unique Normal Form](https://cosmiccodex.app/proofs#unique-normal-form): Every well-formed expression has a unique normal form obtained by exhaustive application of reduction rules.
- [T19 Self-Description Theorem](https://cosmiccodex.app/proofs#self-description): Universal Language can describe its own syntax, semantics, and proof system entirely within its own formalism.
- [T20 Dimensional Consistency](https://cosmiccodex.app/proofs#dimensional-consistency): The dimensional assignments to primitives (0D Point, 1D Line, 2D Angle, 3D Curve, 4D Enclosure) are consistent with all operations and sort assignments.
- [T21 Quantifier Well-Definedness](https://cosmiccodex.app/proofs#quantifier-well-definedness): The quantify operation (the sole T2 operation) is well-defined over all T1 expressions and always produces a well-formed T2 expression.
- [T22 Inversion Completeness](https://cosmiccodex.app/proofs#inversion-completeness): Every invertible well-formed expression has a unique inverse under the invert operation.
- [T23 Geometric–Semantic Correspondence](https://cosmiccodex.app/proofs#geometric-semantic-correspondence): There is a one-to-one correspondence between geometric constructions and semantic meanings in UL.

## Lexicon Entries

### Level 0 — Pre-Constructive
- [§1.1 Void](https://cosmiccodex.app/lexicon/1.1): Empty glyph space

### Level 1 — Atomic Carriers
- [§2.1 Existence](https://cosmiccodex.app/lexicon/2.1): A single point in the glyph space
- [§2.2 Relation](https://cosmiccodex.app/lexicon/2.2): Two points connected by a straight segment
- [§2.3 Action](https://cosmiccodex.app/lexicon/2.3): Two points connected by an arrow
- [§2.4 Quality](https://cosmiccodex.app/lexicon/2.4): Two rays sharing a vertex, with angle θ
- [§2.5 Process](https://cosmiccodex.app/lexicon/2.5): A non-straight continuous path between two points
- [§2.6 Empty concept](https://cosmiccodex.app/lexicon/2.6): A closed boundary with nothing inside

### Level 2 — Distinguished Angles
- [§3.1.1 Identity](https://cosmiccodex.app/lexicon/3.1.1): Two rays, same direction (θ = 0°)
- [§3.1.2 Independence](https://cosmiccodex.app/lexicon/3.1.2): Two rays at right angles (θ = 90°)
- [§3.1.3 Opposition](https://cosmiccodex.app/lexicon/3.1.3): Two rays, opposite directions (θ = 180°)
- [§3.1.4 Completion](https://cosmiccodex.app/lexicon/3.1.4): A ray rotated fully back (θ = 360°)
- [§3.1.5 Harmony](https://cosmiccodex.app/lexicon/3.1.5): Two rays at 60°
- [§3.1.6 Efficiency](https://cosmiccodex.app/lexicon/3.1.6): Two rays at 120°

### Level 2 — Distinguished Enclosures
- [§3.2.1 Fundamental](https://cosmiccodex.app/lexicon/3.2.1): 3-sided closed polygon
- [§3.2.2 Structural](https://cosmiccodex.app/lexicon/3.2.2): 4-sided polygon, equal sides and right angles
- [§3.2.3 Organic](https://cosmiccodex.app/lexicon/3.2.3): 5-sided closed polygon
- [§3.2.4 Networked](https://cosmiccodex.app/lexicon/3.2.4): 6-sided closed polygon
- [§3.2.5 Universal](https://cosmiccodex.app/lexicon/3.2.5): Closed curve with constant curvature
- [§3.2.6 Concept of nothing](https://cosmiccodex.app/lexicon/3.2.6): A circle enclosing nothing

### Level 2 — Distinguished Curves
- [§3.3.1 Cycle](https://cosmiccodex.app/lexicon/3.3.1): Constant curvature, closed (circle as process)
- [§3.3.2 Growth](https://cosmiccodex.app/lexicon/3.3.2): Monotonically increasing radius (spiral)
- [§3.3.3 Rhythm](https://cosmiccodex.app/lexicon/3.3.3): Periodic curvature (sine wave)

### Level 2 — Point-on-Point
- [§3.4.1 Identity](https://cosmiccodex.app/lexicon/3.4.1): Two points at the same position

### Level 2 — Modification Operations
- [§3.5.1 Qualification of entity](https://cosmiccodex.app/lexicon/3.5.1): Transformation applied to an entity
- [§3.5.2 Qualification of relation](https://cosmiccodex.app/lexicon/3.5.2): Transformation applied to a relation

### Level 3 — Entity-in-Enclosure
- [§4.1.1 Truth](https://cosmiccodex.app/lexicon/4.1.1): A single point centered in a circle
- [§4.1.2 Atom](https://cosmiccodex.app/lexicon/4.1.2): A single point centered in a triangle
- [§4.1.3 Constraint](https://cosmiccodex.app/lexicon/4.1.3): A single point centered in a square

### Level 3 — Open-Ended
- [§4.2.1 Potential](https://cosmiccodex.app/lexicon/4.2.1): A point with a ray extending outward

### Level 4 — Multi-Primitive
- [§5.1 Duality](https://cosmiccodex.app/lexicon/5.1): Two points connected at 180°
- [§5.2 Trinity](https://cosmiccodex.app/lexicon/5.2): Three points at equilateral triangle vertices
- [§5.3 Aspiration](https://cosmiccodex.app/lexicon/5.3): Entity directing relation toward circular concept
- [§5.4 Analogy](https://cosmiccodex.app/lexicon/5.4): Two circular enclosures connected by a line
- [§5.5 Infinity](https://cosmiccodex.app/lexicon/5.5): Enclosure containing enclosure, recursively
- [§5.6 Not](https://cosmiccodex.app/lexicon/5.6): Complete sentence frame reflected

### Level 5+ — Higher Compositions
- [§6.1 And](https://cosmiccodex.app/lexicon/6.1): Two sentence frames with overlapping boundaries
- [§6.2 Or](https://cosmiccodex.app/lexicon/6.2): Two sentence frames touching, not overlapping
- [§6.3 Nominalization](https://cosmiccodex.app/lexicon/6.3): Sentence frame shrunk inside an enclosure
- [§6.4 Adjectivalization](https://cosmiccodex.app/lexicon/6.4): Extracting boundary shape as modifier
- [§6.5 Transitivity](https://cosmiccodex.app/lexicon/6.5): Three entities connected by two sequential relations
- [§6.6 Passive voice](https://cosmiccodex.app/lexicon/6.6): A directed relation with arrow reversed
- [§6.7 All / Some / None](https://cosmiccodex.app/lexicon/6.7): Entity scaled relative to its sentence frame

## Machine-Readable Endpoints
- Full data export: https://cosmiccodex.app/codex-data.json
- Agent card: https://cosmiccodex.app/agent-card.json
- OpenAPI spec: https://cosmiccodex.app/api/openapi.json
- Sitemap: https://cosmiccodex.app/sitemap.xml
- API: https://cosmiccodex.app/api/mcp/lexicon, /api/mcp/primitives, /api/mcp/operations, /api/mcp/sorts, /api/mcp/theorems, /api/mcp/thesaurus, /api/mcp/all

## Author
Jordan Traña — researcher, developer, founder of the Tho'ra Clan.

## Related Systems
- Universal Language formal proofs: https://github.com/Jthora/universal_language
- Cosmic Cypher (decryption tool): companion application
- Source code: https://github.com/Jthora/cosmiccodex-app