Emoji Garden — orz the tiny seed, Athena the patient lexicon, and a world that speaks “earth, water, wind, and fire” without a single imperative line.

You whispered “the sun feels warm today.”
A seed named orz bowed in gratitude.
Athena listened, translated an emoji into Thai, and added it to her dictionary.
You didn’t write a single if.

Welcome to MDS, where you cultivate meaning instead of orchestrating logic.

import { World } from '@v1b3x0r/mds-core'

const world = new World({
  features: {
    ontology: true,
    history: true,
    communication: true,
    linguistics: true,
    physics: true,
    rendering: 'headless'
  }
})

// Semantic Bus: hint the garden
world.broadcastContext({
  'env.temp.c': 33.5,
  'env.humidity': 0.72,
  'env.light.lux': 18000,
  'env.noise.db': 38
})

// Do nothing else. Listen.
console.log(world.logger.tailText(10).join('\n'))

What you’ll see (translations pop out once your .mdm files exist):

[17:14:12.045] 🌱 orz (emoji): 🌱
[17:14:12.046] 🧬 Athena (short): ดิน
[17:14:18.019] 🌱 orz (proto): oru…
[17:14:18.021] 🧬 Athena (short): พระอาทิตย์
[17:14:18.050] translation.learn → th: พระอาทิตย์ ← 🌤

Starter vocabulary (emoji → Thai → English gloss):

Legend says: if harmony stays above 0.6 and the night is quiet (env.noise.db is low), orz bows and quietly whispers “orz.” Try nudging the breeze.

TL;DR

• Push meaning in: world.broadcastContext({ 'env.temp.c': 33.5, 'env.humidity': 0.7, … }).
• Triggers and where clauses interpret those values.
• Declarative actions (say, mod.emotion, relation.update, memory.write) fire automatically.

Example meanings

Control without control

• Quiet night? orz sings proto lullabies.
• Noisy afternoon? Athena answers with Thai tongue-twisters.
• You nudge the world, it interprets. No wiring required.

1. World Logger stream — subscribe() or tailText() for clean human logs (mode, text, climate, translation notes). Perfect for dashboards, LED signs, or reading to your cat.
2. Athena hooks — translation.learn + memory.write + say = emoji → Thai loops without imperative glue.
3. Auto speech mode + locale overlays — emoji ↔ proto ↔ short is chosen automatically via utterance policy.
4. Pure ESM — <script type="module"> works out of the box. No Node globals required.

Bundle sizes (fresh build artefacts):

• Needs & Resource Fields — resource pressure (water/food/energy) with decay and competition.
• Memory — salience, recall windows, consolidation hooks.
• Emotion — PAD model, declarative transitions, climate influence.
• Communication — message queues, mention triggers, say policies (emoji / proto / short).
• World Mind — grief, vitality, tension, harmony, plus human-readable summaries.
• Learning & Skills — reward loops, intent stacks, skill progression.
• Physics — collision, energy transfer, field resonance (toggle as you like).
• Save/Load — deterministic snapshots, world exports.
• Semantic Bus — broadcastContext() is the meaning channel.

Everything remains meaning-first; .mdm declarations orchestrate the responses.

1. Describe orz & Athena in .mdm
   • orz: emoji cycles (time.every), occasional proto lines, optional context.set for journaling.
   • Athena: listens via mention(others), calls translation.learn, replies with short Thai, writes to memory.
2. Spawn them

   world.spawn(orZMaterial,    { x: 0,   y: 0 })
   world.spawn(athenaMaterial, { x: 160, y: 0 })

3. Hint the world

   world.broadcastContext({
     'env.temp.c': 34,
     'env.humidity': 0.65,
     'env.noise.db': 42
   })

4. Observe the stream
   • world.logger.tailText(20).join('\n') for quick peeks.
   • world.logger.subscribe(entry => render(entry)) for dashboards.
5. Optional climate nudges Use CollectiveIntelligence.updateEmotionalClimate if you want manual control, but defaults already decay and influence nicely.

Cheat sheet: when harmony > 0.6 and noise < 40, orz is likely to whisper “orz”. Try it.

Q. Do I need actual sensors?
A. Nope. Broadcast imaginary weather if you want. But real humidity sensors make the garden giggle.

Q. Does it run on Raspberry Pi?
A. Yes. Node ≥ 18, pure ESM. Seeds love small boards.

Q. Can I reuse the desert survival demo?
A. Absolutely. It’s still there (demos/desert-survival.mjs). You just discovered a new biome.

Q. Isn’t this just data + state machines?
A. Only if you call your friends “finite automata.” We call them “meaning interpreters.”

• Kids / classrooms: Let them shout “hot!” and broadcast env.temp.c. orz responds with 🔥; Athena translates politely.
• Artists: Pipe world.logger into lights. When orz says “พระจันทร์,” turn the room blue.
• Researchers: Deterministic snapshots + semantic logs = clean experiments.
• Engineers: Keep the logger stream; plug it into Kafka if you need to impress your PM.

Cultivation, not control. Essence-first design, meaning-first execution. orz bows, Athena replies, you sip your cocoa.

• JSON can be tiny and still birth ecosystems.
• The world still remembers grief; now it remembers gratitude too.
• “Don’t fight the world. Whisper to it.” — Someone in orz corp, probably.

• 📚 Reference — API & MDM spec
• 📝 Changelog
• 🧠 Philosophy
• 🍳 Cookbook
• 🌵 Legacy Desert Demo

Made in Chiang Mai, Thailand 🇹🇭 · MIT License
If you hear “orz” in the breeze, the garden is thanking you.