Introducing CEML

CEML is the world's first programming language custom-built for bringing people together.

It's for describing live coordinated events among people with different roles and across places.

All assignments and reassignments given through Groundcrew are actually CEML programs which are then executed on the server, resulting in a test message-, IM-, or mobile application-based coordination.

A sample program

"some quiet time"
takes 10m
offers quiet observation connection peace
gather many agents, 1 landmark

tell agents:
    at |landmark|, find a place to sit w hands on left leg
    in silence, listen to noises in the park
    after |duration|, cough gently and leave one at a time

or the slightly more complex rendezvous:

"a high five"
takes 2m
offers connection inclusion
gather 1 mobile_agent, 1 stationary_agent, 1 streetcorner

ask stationary_agent re clothing: What are you wearing (so the other person can recognize you)?

tell stationary_agent:
    mill around at |streetcorner|
    a stranger will approach you and give you a high five
    when that happens nod and run in the direction they came from
    find some trash and clean it up

tell mobile_agent:
    go to |streetcorner| and
    find someone wearing |stationary_agent.clothing|
    give them a high five
    nod, and keep walking around the corner

There are more examples in this repo.

Other resources

There is a TextMate bundle which does syntax highlighting for CEML. Someone will make a vim mode soon. I am sure of it.

Reference - Commands

CEML has a small number of keywords at this point: gather, tell, ask, and assign are the main four. nab is a variant of gather. takes and offers have a supporting role to provide metadata.

ask [role] re [varname]: [question]

Used to indicate that the information for the varname can be obtained by asking someone in the role/group the question provided.

tell [role]: [assignment]

Says to give the assignment to the people who match the role. Note that the assignment may have variables embedded within it, in which case the server will attempt to get values by asking questions, etc, before sending these assignments.

gather rolespec1, rolespec2, ... [block]

Declares a set of roles which need to be filled to run this script.

offers [tags]

Helps the user or the system pick which agents to involve, based on what they're up for.

takes [duration] [optional skill tags]

Also helps the user or the system pick which agents to involve, based on their skills and/or available time.

Reference - Syntax

The syntax is simple and a bit like a cross between tcl and ruby. Every line starts with a command keyword, some arguments, and possibly a string after a colon. The terminal string parameter can be indented on the following line.

Copyright

This software is licensed under the AGPL, the Affero General Public License 3.0.