Author against stable contracts.

01

THE SURFACE

One trait and a manifest.

03

QUICKSTART

Clone it. Run the whole loop.

$ git clone https://github.com/gawd-ai/alpha
$ cd alpha
$ cargo run -p walkthrough     # the whole loop, narrated

// a critter is one Rhai function: no crate, no compiler
fn handle(env) {
    env.text.to_upper()   // reply with the message, upshouted
}

$ cargo run -p alpha -- node   # boot a live node → the alpha> REPL
alpha> author --critter reverse a string
✓ authored → signed → admitted → hot-loaded critter as id=7
alpha> send 7 hello
reply: olleh

$ cargo build --release -p alpha -p omega   # two poles: control + fabric
$ alpha node --node-id op --cluster-listen 127.0.0.1:9302   # your control surface
$ omega serve --node-id fab --realm crew --cluster-listen 127.0.0.1:9301 \
      --seed [email protected]:9302#<op-pub>   # a fabric node, seeded to your alpha
alpha> cluster join [email protected]:9301#<fab-pub>   # admit it; gossip carries the rest
op ── fab   (connected)

use forge::prelude::*;

#[derive(Default)]
struct Echo;

impl Creature for Echo {
    // wired once, before any envelope; keep a Bus handle here if you emit.
    fn bind(&mut self, _ctx: CreatureCtx) {}

    // one envelope in, dispatches out.
    fn handle(&mut self, env: Envelope) -> Outcome {
        let reversed: Vec<u8> = env.payload.iter().copied().rev().collect();
        Outcome::reply(&env, reversed)   // emit a reply back through the Bus
    }
}

forge::declare_creature!(Echo);

{
  "name": "echo",
  "version": "0.1.0",
  "abi": { "backend": "daemon", "abi_tag": "gawd_creature_v1" },
  "entrypoints": [{ "name": "handle", "signature": "(Envelope) -> Outcome" }],
  "provides": ["handler"]
}

alpha> load ./echo.json ./target/debug/libecho.so
loaded id=7
alpha> send 7 hello
reply: olleh
alpha> reload 7 ./target/debug/libecho.so   # swap in a new build, live
reloaded id=7  (threads joined, rss stable)

06

OPEN PROBLEMS

The hard parts, in the open.