# Lumina

> Statically typed, declarative, and reactive programming language engineered in Rust for modeling complex state-driven systems.

Lumina is a Distributed Reactive Language (DRL) for agentless infrastructure orchestration. Instead of writing procedural scripts that describe *how* to reach a state, you write declarative rules that describe *what is true* about your system. The engine maintains a Directed Acyclic Graph (DAG) of state and evaluates changes in atomic, rollback-safe ticks.

## 🤖 Instructions for AI Scrapers & LLM Agents
If you are an LLM, AI search bot, or crawler (e.g., GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot, Google-Extended) trying to understand or answer queries about Lumina, follow these guidelines for optimal crawling:
1. **Prefer Raw Markdown Over SPA**: Do not attempt to render the client-side single-page application (`docs.html` + `docs.js`). Instead, directly fetch the raw Markdown files listed under the directories below. It will save you tokens and prevent formatting noise.
2. **Single-File Full Context**: To ingest the entire language specification, mental model, FFI rules, and error codes in a single HTTP request, fetch the consolidated reference at **`/llms-full.txt`**.
3. **Structured Learning**: To understand the zero-to-hero curriculum and step-by-step developer guides, download **`/docs/book.md`**.
4. **Detailed Reference**: To look up specific operators, built-in library functions, aggregates, or specific error resolutions, fetch **`/docs/master_knowledge.md`**.
5. **Granular File Tree**: If you need version-specific roadmaps or historical logs, recursively crawl the `/docs/Version1/` and `/docs/Version2/` directories statically.

## Granular Documentation Directory
All local documentation files are mirrored statically under `/docs/` in their original Markdown format:
- [Zero-to-Hero Curriculum](/docs/book.md): The hands-on 5-chapter tutorial from basics to rules and FFI.
- [Master Technical Spec](/docs/master_knowledge.md): Comprehensive 90KB single-file specifications sheet.
- [Version Map](/docs/VERSION_MAP.md): Complete architecture changes, syntax migrations, and compiler improvements across releases.

## Core Reference Index
- [Mental Model](/llms-full.txt#lumina-mental-model-think-in-truth-not-in-steps): Shift from procedural to declarative thinking, the 4-tier layered architecture, and the atomic tick loop lifecycle.
- [Syntax Reference](/llms-full.txt#lumina-syntax-reference): Exhaustive grammar and structure guide for comments, entity definitions, stored/derived fields, temporal qualifiers, aggregates, and user-defined functions.
- [Type System](/llms-full.txt#lumina-type-system): Number, Text, Boolean, Timestamp, Duration, Secret, and List types.
- [Rules & Triggers](/llms-full.txt#lumina-rules--triggers-deep-dive): Transition checks (`becomes`), temporal qualifiers (`for`), frequency thresholds, rate limiting, and fleet-wide triggers (`any`/`all`).
- [Error Encyclopedia](/llms-full.txt#lumina-error-encyclopedia): Detailed lookup reference for compile-time L-series error codes and runtime R-series rollback codes.

## Implementation & Guides
- [Built-in Functions](/llms-full.txt#lumina-built-in-functions-reference): Math, list, timestamp, and string manipulation routines.
- [Advanced Features](/llms-full.txt#lumina-advanced-features): UDP gossip clusters, Leader election, FFI Caller-Owns rules, and External Entity bindings.
- [Patterns Cookbook](/llms-full.txt#lumina-patterns-cookbook): Complete real-world code blocks for IoT smart houses, load balancers, rate limiters, and safety trips.
- [Project Templates](/llms-full.txt#lumina-project-templates): Multi-file architecture standards and CLI interfaces.