{"id":44244742,"url":"https://github.com/ib823/riina","last_synced_at":"2026-02-10T12:04:38.702Z","repository":{"id":335778472,"uuid":"1146966173","full_name":"ib823/riina","owner":"ib823","description":"Formally verified programming language with security properties proven in Coq. Zero external dependencies. Thousands theorems. 0 admits.","archived":false,"fork":false,"pushed_at":"2026-02-09T22:27:32.000Z","size":51710,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-10T02:23:06.030Z","etag":null,"topics":["bahasa-melayu","compiler","coq","effect-system","formal-verification","information-flow","mpl-2","non-interference","programming-language","rust","security","theorem-proving","type-system","zero-trust"],"latest_commit_sha":null,"homepage":"https://ib823.github.io/riina/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ib823.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-01T00:54:53.000Z","updated_at":"2026-02-09T22:26:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ib823/riina","commit_stats":null,"previous_names":["ib823/riina"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ib823/riina","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib823%2Friina","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib823%2Friina/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib823%2Friina/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib823%2Friina/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ib823","download_url":"https://codeload.github.com/ib823/riina/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ib823%2Friina/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29298525,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T10:40:02.018Z","status":"ssl_error","status_checked_at":"2026-02-10T10:38:28.459Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bahasa-melayu","compiler","coq","effect-system","formal-verification","information-flow","mpl-2","non-interference","programming-language","rust","security","theorem-proving","type-system","zero-trust"],"created_at":"2026-02-10T12:02:56.436Z","updated_at":"2026-02-10T12:04:38.694Z","avatar_url":"https://github.com/ib823.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RIINA\n\n**Formally verified programming language.**\n\n***If it compiles, it's secure.***\n\nSecurity properties are not tested, not assumed — they are *mathematically proven* at compile time.\n\n**[Try the Playground](https://ib823.github.io/riina/#playground)** | **[RIINA vs Rust](07_EXAMPLES/showcase/riina_vs_rust/)** | **[Website](https://ib823.github.io/riina/)**\n\n```\n  ██████╗ ██╗██╗███╗   ██╗ █████╗\n  ██╔══██╗██║██║████╗  ██║██╔══██╗\n  ██████╔╝██║██║██╔██╗ ██║███████║\n  ██╔══██╗██║██║██║╚██╗██║██╔══██║\n  ██║  ██║██║██║██║ ╚████║██║  ██║\n  ╚═╝  ╚═╝╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝\n\n  Rigorous Immutable Invariant, No Assumptions\n```\n\n**[Bahasa Melayu](docs/i18n/README_ms.md)** | **[中文](docs/i18n/README_zh.md)**\n\n\u003e **Write with vibes. Ship with proofs.**\n\n---\n\n## AI-Native Language\n\nRIINA is the world's first programming language that is both **formally verified** and **AI-native**. Every security guarantee has a machine-checked mathematical proof, and the language is designed from the ground up for AI agents to read, write, and reason about.\n\n**AI-Writability Score: 9.7/10** -- Consistent Bahasa Melayu keywords, minimal syntax, strong types, and deterministic compilation make RIINA one of the most AI-friendly languages ever designed.\n\nAI agents: See [llms.txt](llms.txt) for a machine-readable language reference.\n\n### For AI Agents\n\nRIINA provides first-class support for AI-assisted development:\n\n- **Programmatic compilation:** `riinac check --json --stdin` accepts source on stdin and returns structured JSON diagnostics\n- **Full machine reference:** [llms-full.txt](llms-full.txt) contains the complete language specification, type system, and effect system in a single file\n- **Code patterns:** [07_EXAMPLES/](07_EXAMPLES/) contains 130+ annotated examples across 10 categories (security, effects, compliance, design patterns, FFI, and more)\n- **IDE integration:** [.cursorrules](.cursorrules) and [.clinerules](.clinerules) provide pre-configured rules for Cursor and Cline; [.github/copilot-instructions.md](.github/copilot-instructions.md) provides GitHub Copilot context\n\n---\n\n## What is RIINA?\n\nRIINA is a programming language where **every security guarantee has a machine-checked mathematical proof**. If your program compiles, it is secure — not by convention, not by best practice, but by proof.\n\nMost languages ask you to *trust* that your code is secure. RIINA asks you to *verify* it.\n\n| What RIINA proves at compile time | How |\n|---|---|\n| No information leaks between security levels | Non-interference theorem (Coq) |\n| No unauthorized effect execution | Effect gate algebra (Coq) |\n| Type safety (no runtime type errors) | Progress + Preservation theorems (Coq) |\n| No secret data in public outputs | Declassification policy proofs (Coq) |\n| Termination of all pure computations | Strong normalization proofs (Coq) |\n| Memory safety without garbage collection | Separation logic proofs (Coq) |\n\nThese are not aspirational goals — they are proven theorems that compile today.\n\n---\n\n## Why RIINA?\n\n**If you write software where security matters, RIINA is for you.**\n\n- Building a payments system? RIINA *proves* cardholder data never leaks.\n- Building healthcare software? RIINA *proves* patient records stay confidential.\n- Building infrastructure? RIINA *proves* no unauthorized side effects execute.\n- Building anything? RIINA gives you **zero-trust guarantees from the compiler itself**.\n\nRIINA doesn't care what industry you're in. If you care about getting security right — provably, permanently, without hoping your tests caught everything — RIINA is the tool.\n\n### What makes RIINA different from every other language\n\n| Feature | RIINA | Rust | Haskell | Ada/SPARK |\n|---------|-------|------|---------|-----------|\n| Memory safety | Proven (separation logic) | Borrow checker (no proof) | GC | Proven (SPARK subset) |\n| Information flow control | Proven (non-interference) | None | None | None |\n| Effect tracking | Proven (effect algebra) | None | Monads (no proof) | None |\n| Type safety | Proven (Progress + Preservation) | Tested | Tested | Proven (SPARK subset) |\n| Zero external dependencies | Yes (compiler, crypto, stdlib) | No | No | No |\n| Formal proofs ship with compiler | Yes (7,740 Coq + 7900 Lean + 8072 Isabelle) | No | No | Partial |\n| Triple-prover verification | Yes (Coq + Lean 4 + Isabelle/HOL) | No | No | No |\n| Bahasa Melayu native syntax | Yes | No | No | No |\n\n---\n\n**Website:** [ib823.github.io/riina](https://ib823.github.io/riina/)\n\n---\n\n## Quick Start\n\n### Install\n\n```bash\ngit clone https://github.com/ib823/riina.git\ncd riina/03_PROTO\ncargo build --release\n```\n\nThe compiler binary is `riinac`. Zero external dependencies — everything is built from source.\n\n**Alternative install methods:**\n\n```bash\n# Docker (build from source)\ndocker build -t riina .\ndocker run --rm riina check myfile.rii\n\n# Nix\nnix run github:ib823/riina\n\n# Portable installer (builds from source)\nbash scripts/install.sh\n```\n\n### Hello World\n\nCreate `hello.rii`:\n\n```riina\n// Hello World in RIINA\n// Keywords are in Bahasa Melayu (Malaysian Malay)\n\nfungsi utama() -\u003e Teks kesan IO {\n    biar mesej = \"Selamat datang ke RIINA!\";\n    cetakln(mesej);\n    pulang mesej;\n}\n```\n\n```bash\nriinac check hello.rii    # Type-check and verify\nriinac run hello.rii      # Run directly\nriinac build hello.rii    # Compile to native binary via C\n```\n\n### Security in Action\n\n```riina\n// RIINA prevents information leaks at compile time\n\nfungsi proses_pembayaran(kad: Rahsia\u003cTeks\u003e, jumlah: Nombor) -\u003e Teks kesan Crypto {\n    // 'kad' is Secret — the compiler PROVES it never reaches public output\n\n    biar hash = sha256(kad);           // OK: crypto on secret data\n    biar resit = \"Jumlah: \" + ke_teks(jumlah);  // OK: amount is public\n\n    // cetakln(kad);                   // COMPILE ERROR: secret data in IO effect\n    // pulang kad;                     // COMPILE ERROR: secret in public return\n\n    pulang resit;                      // OK: only public data returned\n}\n```\n\nThis is not a runtime check. This is not a linter warning. The **compiler proves** at the type level that secret data cannot flow to public outputs. If it compiles, the guarantee holds.\n\n### Effect System\n\n```riina\n// Every side effect is tracked and proven safe\n\nfungsi baca_config(laluan: Teks) -\u003e Teks kesan IO {\n    biar kandungan = fail_baca(laluan);\n    pulang kandungan;\n}\n\nfungsi kira_cukai(pendapatan: Nombor) -\u003e Nombor kesan Bersih {\n    // This function is PROVEN pure — no IO, no network, no side effects\n    // The compiler enforces this, not the programmer\n    pulang pendapatan * 0.06;\n}\n\n// Dependencies cannot escalate effects without explicit permission\n// A crypto library cannot secretly open network connections\n```\n\n---\n\n## Bahasa Melayu Syntax\n\nRIINA uses **Bahasa Melayu** (Malaysian Malay) keywords — the first systems programming language with native Southeast Asian syntax.\n\n| RIINA | English | Example |\n|-------|---------|---------|\n| `fungsi` | fn | `fungsi tambah(x: Nombor) -\u003e Nombor` |\n| `biar` | let | `biar nama = \"Ahmad\";` |\n| `kalau` | if | `kalau x \u003e 0 { ... }` |\n| `lain` | else | `lain { ... }` |\n| `untuk` | for | `untuk x dalam senarai { ... }` |\n| `selagi` | while | `selagi aktif { ... }` |\n| `pulang` | return | `pulang hasil;` |\n| `padan` | match | `padan nilai { ... }` |\n| `rahsia` | secret | `biar kunci: Rahsia\u003cTeks\u003e` |\n| `dedah` | declassify | `dedah(nilai)` |\n| `kesan` | effect | `kesan IO` |\n| `bersih` | pure | `kesan Bersih` |\n| `betul` / `salah` | true / false | Boolean values |\n| `ubah` | mut | `biar ubah x = 0;` |\n\nYou don't need to speak Malay to use RIINA. The keywords are consistent, short, and learnable in an afternoon. But if you *do* speak Malay, this is the first language that speaks your language.\n\n---\n\n## What's Been Built\n\nThis is not a whitepaper. This is working software.\n\n### Formal Proofs — Triple-Prover Verification\n\n| Prover | Proofs | Files | Sorry/Admitted | Axioms | Foundation |\n|--------|--------|-------|----------------|--------|-----------|\n| **Coq 8.20.1** (Primary) | 7,740 Qed | 284 .v (244 active) | 0 | 0 | CIC |\n| **Lean 4** (Secondary) | 7,900 theorems | 255 .lean | 0 | 0 | DTT |\n| **Isabelle/HOL** (Tertiary) | 8,072 lemmas | 260 .thy | 0 | 0 | HOL |\n| **Total** | **23,712** | **799** | **0** | **0** | **3 independent** |\n\n7,205 cross-prover theorems are aligned across Coq, Lean, and Isabelle.\n\n**What's proven:**\n- Type safety (Progress + Preservation)\n- Non-interference (information flow security)\n- Effect system soundness\n- Declassification policy correctness\n- Termination guarantees (strong normalization)\n- Memory safety (separation logic)\n- Translation validation (certified compilation)\n- Hardware contract verification\n- Concurrency safety (session types, data-race freedom)\n- 15 industry compliance properties (HIPAA, PCI-DSS, GDPR, PDPA MY/SG, SOX, DO-178C, ISO 26262, CC EAL7, NIST 800-53, CCPA, FERPA, BNM RMiT, MAS TRM, ISO 27001)\n\n### Compiler \u0026 Toolchain (Rust)\n\n| Metric | Value |\n|--------|-------|\n| Rust crates | 15 |\n| Test count | 852 (all passing) |\n| External dependencies | **0** |\n| Lines of Rust | 31,043 |\n| Standard library builtins | 88 across 9 modules |\n\n**Crates:**\n\n| Crate | Purpose |\n|-------|---------|\n| `riinac` | Compiler driver — check, run, build, emit-c, emit-ir, repl, fmt, doc, lsp, verify, pkg |\n| `riina-lexer` | Tokenizer with 70+ bilingual keywords |\n| `riina-parser` | AST construction |\n| `riina-types` | Type system definitions (22 types, 17 effects, 6 security levels) |\n| `riina-typechecker` | Type inference and checking |\n| `riina-codegen` | IR lowering, C/WASM/mobile code generation, interpreter, FFI |\n| `riina-wasm` | WASM playground library (in-browser compiler via cdylib) |\n| `riina-fmt` | Code formatter |\n| `riina-lsp` | Language Server Protocol (VS Code integration) |\n| `riina-doc` | HTML documentation generator |\n| `riina-pkg` | Package manager (SemVer resolution, SHA-256 integrity, effect escalation checking) |\n| `riina-arena` | Memory arena allocator |\n| `riina-span` | Source location tracking |\n| `riina-symbols` | String interning |\n| `riina-compliance` | Industry compliance validation (15 profiles, audit report generator) |\n\n### Developer Tools\n\n- **VS Code extension** — Syntax highlighting, 12 code snippets, LSP integration\n- **Formatter** — `riinac fmt` for consistent code style\n- **Doc generator** — `riinac doc` produces HTML documentation\n- **LSP server** — Diagnostics, hover info, keyword completion\n- **Package manager** — `riinac pkg init/add/remove/lock/build/publish/list/tree/clean`\n- **Verification gate** — `riinac verify --fast` (zero-trust: runs tests, clippy, Coq audit)\n- **Docker image** — Multi-stage build, ~85MB runtime image\n- **Nix flake** — `nix run github:ib823/riina` or `nix develop` for full dev shell\n- **Release scripts** — `scripts/release.sh` (one-command release: bump, tag, tarball, GitHub Release, deploy website), `scripts/bump-version.sh`, `scripts/install.sh`\n- **Website** — 15-page site at [ib823.github.io/riina](https://ib823.github.io/riina/) — includes \"Why Proof\" executive page, 15 industry verticals, Releases page; deployed via `scripts/deploy-website.sh`\n- **REPL** — Interactive mode for experimentation\n\n### Example Programs\n\n130 example `.rii` files across 10 categories:\n\n| Category | Examples | Topics |\n|----------|----------|--------|\n| Basics | 20 | Arithmetic, closures, pattern matching, loops, pipes |\n| Security | 18 | Secret types, capabilities, information flow, secure channels |\n| Effects | 15 | IO, crypto, network, filesystem, effect composition |\n| Applications | 15 | Web server, chat app, password manager, API gateway |\n| Compliance | 10 | GDPR, HIPAA, PCI-DSS, PDPA, SOX, NIST |\n| Design Patterns | 15 | Builder, state machine, visitor, monad, phantom types |\n| FFI | 2 | C function calls (puts, abs, rand) |\n| Showcase | 3 | Secure web server, PQ messenger, HIPAA medical records |\n| AI Context | 1 | Complete corpus for LLM training |\n\n### Cryptographic Tooling\n\nThe `05_TOOLING/` workspace contains 35,000+ lines of hand-written cryptographic primitives:\n\n- **Symmetric:** AES-256, SHA-256 (FIPS 180-4), HMAC, ChaCha20-Poly1305\n- **Asymmetric:** X25519, Ed25519 (interfaces + partial implementations)\n- **Post-quantum:** ML-KEM, ML-DSA (interfaces)\n- **Zero external crypto dependencies** — everything auditable from source\n\n---\n\n## Repository Structure\n\n```\nriina/\n├── 02_FORMAL/coq/         284 Coq proof files (147K lines total, 122K active)\n│   ├── foundations/        Core language semantics\n│   ├── type_system/        Progress, Preservation, Type Safety\n│   ├── properties/         Non-Interference, Declassification, Composition\n│   ├── effects/            Effect algebra and gate proofs\n│   ├── domains/            183 domain-specific proofs (R-Z, Σ, compliance)\n│   ├── termination/        Strong normalization, sized types\n│   ├── compliance/         DO-178C, ISO-26262, Common Criteria\n│   └── Industries/         15 regulatory compliance proofs\n│\n├── 02_FORMAL/lean/          Lean 4 proofs (7,900 theorems, 255 files, 0 sorry)\n│   └── RIINA/               Syntax, Semantics, Typing, Progress, Preservation,\n│                             TypeSafety, EffectAlgebra, EffectSystem, EffectGate,\n│                             NonInterference\n│\n├── 02_FORMAL/isabelle/      Isabelle/HOL proofs (8,072 lemmas, 260 files, 0 sorry)\n│   └── RIINA/               Same 10 theory files as Lean\n│\n├── 03_PROTO/               Rust compiler (15 crates, 852 tests, 0 deps)\n│   └── crates/\n│       ├── riinac/         Compiler driver (11 subcommands)\n│       ├── riina-lexer/    Tokenizer\n│       ├── riina-parser/   Parser\n│       ├── riina-types/    Type system\n│       ├── riina-typechecker/\n│       ├── riina-codegen/  IR + C backend + interpreter\n│       ├── riina-pkg/      Package manager\n│       ├── riina-fmt/      Formatter\n│       ├── riina-lsp/      Language server\n│       ├── riina-doc/      Doc generator\n│       ├── riina-arena/    Memory allocator\n│       ├── riina-span/     Source spans\n│       ├── riina-symbols/  String interning\n│       └── riina-compliance/ Compliance profile validator\n│\n├── 04_SPECS/               Language specifications, compliance specs\n├── 05_TOOLING/             Crypto primitives, build system (35K lines Rust)\n├── 07_EXAMPLES/            130 example .rii files\n├── docs/                   Enterprise docs, multilingual READMEs\n├── VERSION                 Semver source of truth (0.2.0)\n├── CHANGELOG.md            Public-facing changelog\n├── website/                15-page Vite/React website (Why Proof, Enterprise, Playground, etc.)\n├── scripts/                Build, install, release, deploy, sync scripts\n└── riina-vscode/           VS Code extension\n```\n\n---\n\n## Research Scope\n\nEvery research track in `01_RESEARCH/` (55 domains, A through AJ, plus Greek letter tracks) has corresponding Coq proofs in the active build. 100% coverage, verified by audit.\n\n| Track | Domain | Coq Proofs | Status |\n|-------|--------|-----------|--------|\n| A | Core type system, non-interference | 55 files (38K lines) | Proven |\n| R | Certified compilation (translation validation) | 1 file (955 lines) | Proven |\n| S | Hardware contracts (CPU side-channel models) | 1 file (560 lines) | Proven |\n| T | Hermetic build (binary bootstrap verification) | 1 file (502 lines) | Proven |\n| U | Runtime guardian (verified micro-hypervisor) | 1 file (604 lines) | Proven |\n| V | Termination guarantees (strong normalization) | 6 files (3K lines) | Proven |\n| W | Verified memory (separation logic) | 1 file (739 lines) | Proven |\n| X | Concurrency (session types, data-race freedom) | 1 file (750 lines) | Proven |\n| Y | Verified standard library | 1 file (780 lines) | Proven |\n| Z | Declassification policy (budgets, robust) | 1 file (665 lines) | Proven |\n| Σ | Verified persistent storage | 1 file (712 lines) | Proven |\n| — | Industry compliance (15 jurisdictions) | 15 files (2K lines) | Proven |\n| — | Domain security (timing, protocols, hardware, ...) | 183 files (76K lines) | Proven |\n| Π | Verified performance (WCET, SIMD, lock-free) | 1 file (470 lines) | Proven |\n| Δ | Verified distribution (Raft, BFT, CRDTs) | 1 file (500 lines) | Proven |\n| Ω | Network defense (rate limiting, SYN cookies) | 1 file (530 lines) | Proven |\n| Ψ | Operational security (Shamir, duress, dead man) | 1 file (560 lines) | Proven |\n| L | FFI boundary safety, attack surface research | 1 file (17 Qed) | Proven |\n| — | Mobile OS security (27 subsystems) | 27 files | Proven |\n| — | Security foundations (boot, IOMMU, crypto) | 11 files | Proven |\n| — | UI/UX accessibility and safety | 7 files | Proven |\n| — | Capital markets (order matching, settlement) | 1 file (15 Qed) | Proven |\n| — | Physical systems security (sensors, timing) | 1 file (16 Qed) | Proven |\n\n---\n\n## Current Status\n\n**Build: Passing. Grade: A.**\n**Verification:** 7,740 Coq Qed (compiled, 0 Admitted, 0 active axioms) | 10 independent provers | 852 Rust tests\n\n| Phase | Description | Status |\n|-------|-------------|--------|\n| 1. Compiler | Lexer, parser, typechecker, codegen, REPL, diagnostics | Done |\n| 2. Standard Library | 88 builtins across 9 modules | Done |\n| 3. Formal Verification | 7,740 Coq Qed + 7900 Lean + 8072 Isabelle = 82,968 total (10 provers), 0 admits/sorry, 0 active axioms | Stable |\n| 4. Developer Experience | Formatter, LSP, doc generator, VS Code extension, 130 examples | Done |\n| 5. Ecosystem | CI/CD, package manager, Docker, Nix flake, release system, installer | Done |\n| 6. Adoption | C FFI, 8 demos, community, enterprise, public branch, 15-page website (Why Proof, 15 industries, Releases) | Done |\n| 7. Platform Universality | Multi-backend (WASM, Android, iOS), platform-conditional stdlib, WASM playground, backend verification | Done |\n| 8. Long-term | Self-hosting compiler, hardware verification, verified OS | Planned |\n\n### What's next\n\n- **Triple-prover verification:** Complete — 86 theorems proved in Coq + Lean 4 + Isabelle/HOL. 0 sorry across all provers.\n- **Axiom status:** Active build is axiom-free (`Axioms=0`, `Admitted=0`, explicit assumptions `=0`).\n- **Phase 8 (Long-term):** Self-hosting compiler, hardware verification, verified OS\n- **Compliance system:** `--compliance` flag with 15 industry profiles, audit report generation (text + JSON), certification pipeline — see [Compliance Guide](docs/enterprise/COMPLIANCE_GUIDE.md)\n\n---\n\n## Security \u0026 Verification\n\nRIINA uses **compiler-integrated verification** — no external CI/CD. Verification lives inside the compiler.\n\n```bash\nriinac verify --fast    # Tests + clippy (runs on every commit via pre-commit hook)\nriinac verify --full    # + Coq admits/axioms scan (runs on every push via pre-push hook)\n```\n\n**Git hooks** enforce verification automatically:\n- **Pre-commit:** `riinac verify --fast` blocks commits with failing tests\n- **Pre-push:** `riinac verify --full` + GPG signature check + secret detection + Trojan source scan\n\nInstall hooks: `./00_SETUP/scripts/install_hooks.sh`\n\n**Deep verification** (manual, 7 levels): `bash 05_TOOLING/scripts/verify.sh [0-6]`\n\nVerification is enforced automatically via git hooks installed by `./00_SETUP/scripts/install_hooks.sh`.\n\n---\n\n## Contributing\n\nRIINA is open source under the [RIINA Proprietary License](LICENSE).\n\n```bash\n# Clone and set up\ngit clone https://github.com/ib823/riina.git\ncd riina\n\n# Verify environment\nbash 00_SETUP/scripts/verify_setup.sh\n\n# Build compiler\ncd 03_PROTO \u0026\u0026 cargo build --release -p riinac \u0026\u0026 cd ..\n\n# Run all tests\ncd 03_PROTO \u0026\u0026 cargo test --all \u0026\u0026 cd ..\n\n# Check a .rii file\n./03_PROTO/target/release/riinac check 07_EXAMPLES/hello_dunia.rii\n\n# Run the REPL\n./03_PROTO/target/release/riinac repl\n\n# Run the verification gate\n./03_PROTO/target/release/riinac verify --fast\n\n# Install git hooks (recommended for contributors)\n./00_SETUP/scripts/install_hooks.sh\n```\n\nRead [`CONTRIBUTING.md`](CONTRIBUTING.md) for detailed development instructions and coding standards.\n\n---\n\n## FAQ\n\n**Is RIINA production-ready?**\nThe compiler, proofs, and toolchain are functional. Phases 1-6 (compiler, stdlib, proofs, developer tools, ecosystem, adoption) are complete. Phase 7 (Platform Universality — WASM, mobile backends) is in progress. Phase 8 (self-hosting, hardware verification) is the long-term vision. You can write, compile, and run RIINA programs today — via source build, Docker, or Nix.\n\n**Do I need to know Bahasa Melayu?**\nNo. The keywords are short and consistent — `fungsi` (function), `biar` (let), `kalau` (if), `pulang` (return). You'll learn them in minutes. A [cheatsheet](07_EXAMPLES/06_ai_context/RIINA_CHEATSHEET.md) is included.\n\n**Do I need to understand Coq or formal verification?**\nNo. The proofs run at compile time automatically. You write normal code; the compiler does the proving. The Coq proofs are there for auditability — you benefit from them without reading them.\n\n**Why zero external dependencies?**\nTrust. Every line of RIINA — compiler, crypto, standard library — is auditable from source. No supply chain attacks. No dependency confusion. No left-pad incidents.\n\n**Why Bahasa Melayu?**\nRIINA developed by Malaysians for the world. Programming languages have been English-only for 70 years. RIINA proves that formal verification and native-language syntax are not mutually exclusive. If a language can be proven correct, it can be proven correct in any language.\n\n**How does RIINA compare to SPARK/Ada?**\nSPARK proves absence of runtime errors (overflow, division by zero) for a subset of Ada. RIINA proves information flow security (non-interference), effect safety, declassification correctness, and more — for the entire language. Both are formally verified; RIINA's scope is broader.\n\n---\n\n*RIINA — Rigorous Immutable Invariant, No Assumptions*\n\n*Q.E.D. Aeternum.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fib823%2Friina","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fib823%2Friina","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fib823%2Friina/lists"}