Appendix#

This is the "I need to look something up" section. Not for reading cover-to-cover (unless that's your thing -- no judgment), but for those moments when you can't remember the exact syntax for a cron schedule, or you're staring at an error message that doesn't quite make sense, or you need to know what @context.origin gives you.

Reference Materials#

A. Language Grammar#

The full BNF-style grammar for the Adama language. When you need the precise syntax for declarations, statements, expressions, and types -- it's all here.

B. @ Constants#

All the special @ constants -- @who, @web, @context, @headers, @parameters, @viewer, @no_one, and the rest. What they are, where they're available, and how to use them.

C. Operators#

Operator reference with precedence tables, type compatibility, and examples. Arithmetic, comparison, logical, assignment -- the works.

D. Common Errors#

The error messages you're most likely to hit, what they mean, and how to fix them. Saves you from staring at a compiler error for twenty minutes when the answer is "you declared things in the wrong order."

E. CLI Reference#

Every CLI command, its options, and examples. For when adama --help isn't quite enough.

F. Configuration Reference#

All configuration options -- the config file, environment variables, @static blocks, service blocks, deployment settings.

G. Glossary#

Adama-specific terminology: document, space, principal, channel, delta, formula, bubble, and all the other words that mean something specific in this context.

How to Use These#

These are lookup references, not tutorials. Come here when:

• You need the exact syntax for a language construct
• You hit an error message you don't recognize
• You want to explore available CLI commands
• You need to understand a specific Adama concept
• You're configuring a deployment

For actually learning Adama, start with the Quickstart Guide and Language Reference. Come back here as needed.