Guide / README / Glossary

DungLang Federation 4.0 Guide

A short guide for readers who think the homepage looks interesting, but are not yet sure whether this is a compiler demo, a fictional language ecosystem, a simulation, or a cave joke. The answer is: yes, carefully.

What Is This?

DungLang Federation 4.0 is a prototype compiler and simulation showcase. Multiple fictional frontends compile into a shared intermediate representation called Odor IR. Programs are executed by the CEK Cave Machine, which emits odor events. Those events are then processed by a fictional civilization layer featuring constitutions, elections, history rewriting, metrics, and myth generation.

The project is both a compiler demo and a worldbuilding joke. The names are absurd on purpose, but the layers are real enough to read as a small architecture: frontend languages, shared IR, execution machine, event log, simulation layer, report output.

Architecture

DungLang / ScatLang / SeaIR / YakiimoIR ↓ Odor IR ↓ CEK Cave Machine ↓ Odor events ↓ Civilization Stack ↓ constitution / elections / history rewrite / myth / metrics ↓ outputs/dunglang_federation_4_0_report.json

Key Terms

Odor IR

A shared intermediate representation. The frontends look different, but they compile into the same internal structure.

CEK Cave Machine

The execution engine for Odor IR. It tracks control, environment, and continuation state. Allegedly in a cave.

Odor Event

An event log entry for something that happened during execution: when it happened, how strong it was, and who it affected.

OdorSink

The place where odor events are collected. Think runtime log, but less hygienic and more politically dangerous.

DiplomaticEvent

An event where odor affects tribes, factions, or political relationships. In this civilization, smell can become foreign policy.

Banana GC

A garbage-collection joke. It cleans up leftover banana-flavored runtime artifacts after execution.

Error Federation

Representative checks showing that different frontends can reach the same error shape through the same IR. Not a proof.

OdorOptimizer

A small optimization pass. If an odor-level calculation can be simplified before runtime, it gets folded early.

Ghost Odor

An odor event that is not in the official history, but still exists in a secret or reconstructed log.

BananaRewrite

A history-rewriting mechanism that uses banana tokens as the cost or currency for changing official history.

WitnessCouncil

A fictional review council for artifacts. Philosopher-gorillas are excluded because otherwise the meeting never ends.

Constitution Federation

A rules layer. When the simulated civilization violates one of its constitutional articles, a violation event is emitted.

Election System

A faction-based political layer. Change the ruling coalition, and the same odor event may receive a different verdict.

CivilizationMetrics

A dashboard for civilization health: stability, diplomatic tension, philosophy pollution, and myth pressure.

MythGenerator

A narrative layer that turns erased history, unexplained events, and missing bananas into legend, myth, and religion.

What This Is Not

  • It is not a complete production compiler.
  • It is not a formal proof of frontend equivalence.
  • It does not claim every possible program has been checked.
  • The Error Federation results are representative-case checks, not mathematical proof.
  • The DungLang frontend is a mapping from v0.7 event structures to Odor IR, not a full parser.

The useful reading is: a prototype showing how several fictional language frontends can converge into one shared IR, run through one execution model, and feed one event-driven civilization simulator.