# Glossary

> For agents: start with the [agent guide](https://ratstack.sh/llms.txt). Every page is Markdown by default; add `Accept: text/html` for HTML.

## A

- [A2A](/systems/agent-front-door) → Agent2Agent protocol. This site's implementation answers documentation questions through search and read.

- [actor](/lore/lifecycles-are-machines) → A running unit that processes events or performs work for a state machine. Declared Effect actors perform this repo's side effects.

- [adapter](/lore/hexagonal-architecture) → An implementation that connects an application-owned interface to a particular external technology or provider.

- [admission control](/lore/admission-controls-new-work) → A decision at the entry point to accept, defer, or refuse new work under current load.

- [agent interfaces](/systems/agent-front-door) → The discovery documents and callable HTTP, MCP, A2A, and code-mode endpoints hosted by this site.

- [Alchemy](/skills/learn-alchemy) → An infrastructure tool built with Effect. Its program declares cloud resources and can produce a plan before applying changes.

- [Alchemy Domain](/lore/alchemy-domain) → Alchemy's domain-driven design framework for Effect: commands, aggregates and events, tested in memory and hosted on Cloudflare Durable Objects.

- [Alchemy Stack](/skills/learn-alchemy) → One program that declares infrastructure and returns its outputs.

- [AT Protocol](/lore/at-protocol) → The Authenticated Transfer Protocol, a decentralized protocol for social web applications with persistent account identities and signed public data repositories.

## B

- [backpressure](/lore/concurrent-work-needs-an-owner) → A consumer's demand limits how quickly its producer can progress. An unbounded queue can break that constraint.

- [Basin Pipelines](/lore/queues-pipelines-workflows-and-k2-do-different-jobs) → Cloudflare's streaming ingestion product, named Cloudflare.Pipelines in Alchemy. A stream receives events, SQL transforms them, and a sink writes them to R2.

- [binding](/lore/bindings) → A declared connection that gives a Cloudflare Worker a typed runtime value or access to a resource.

- [bulkhead](/lore/bulkheads-isolate-capacity) → A reserved share of capacity that one workload cannot take from another.

## C

- [capability](/systems/capabilities) → One named action with a contract describing its accepted values and a server-side implementation that performs the work.

- [capability projection](/lore/one-capability-every-surface) → Code that exposes a named action through a particular interface without adding separate business behavior.

- [cartridge](/lore/cartridges) → A package for one job that includes its implementation and needed infrastructure. It must pass the project's add-and-remove test.

- [cartridge test](/lore/cartridges) → Add one package and one provision line, then remove them without breaking unrelated packages. The package owns its resources and connections.

- [circuit breaker](/lore/circuit-breakers-have-state) → A guard that fails calls to an unhealthy dependency at once, then lets a probe test recovery.

- [client](/skills/uncomplect) → Browser code that owns queries, named commands, and the local copy of server state.

- [Cloudflare Queues](/lore/queues-pipelines-workflows-and-k2-do-different-jobs) → A Cloudflare message queue. A consumer Worker acknowledges or retries each message, and delivery is at least once.

- [Cloudflare Workflows](/lore/queues-pipelines-workflows-and-k2-do-different-jobs) → Cloudflare's durable multi-step execution. Each step retries on its own, and a run can sleep or wait for an external event.

- [code mode](/lore/one-program-can-replace-several-tool-calls) → Running one program that combines calls to declared actions inside a restricted environment.

- [composition root](/lore/structure-effect-by-domain) → Startup code that chooses and supplies the application's service implementations.

- [ConfigProvider](/lore/configuration-is-a-dependency) → The source of raw configuration inputs that Effect reads and validates.

- [configuration Layer](/lore/configuration-is-a-dependency) → A description of how to build a service containing validated configuration values.

- [content-addressed output](/lore/build-time-work-stays-out-of-requests) → Generated output identified by a hash of its content.

- [context](/lore/context-and-requirements) → The collection of services supplied to running work in Effect.

- [contract](/systems/capabilities) → The shared name, input, output, failure, and metadata for an action. It contains no server-side implementation.

## D

- [dead-letter queue](/lore/dead-letters-need-a-return-path) → A durable holding place for work that exhausted its retries, with an owner who repairs and redrives it.

- [decentralized identifier](/lore/at-protocol) → A DID (decentralized identifier) gives an AT Protocol account a persistent identity linked to keys and a hosting provider.

- [defect](/lore/effect-basics) → An unexpected execution failure, separate from the failures that callers are expected to handle.

- [doc-fence](/lore/code-snippets) → A published TypeScript code block that the content build writes out and pnpm check typechecks, with explicit reasons required for authored examples that opt out.

- [Durable Object](/lore/workers-answer-requests-durable-objects-own-named-state) → A Cloudflare Worker with a globally unique name and private, strongly consistent storage. Requests reach it by name.

## E

- [Effect](/lore/effect-basics) → A TypeScript library for describing work with typed failures and required services. A runtime executes the description.

- [engine-neutral token](/lore/engine-neutral-tokens-keep-adapters-replaceable) → A segment of source text with a syntax role and font style, independent of Shiki's types.

- [error accumulation](/lore/accumulate-independent-errors) → Collecting independent failures so one result reports all of them before generated files are written.

- [expected failure](/lore/error-model) → A declared failure carried in an Effect description's E type parameter. Callers can handle it.

## F

- [feature](/skills/uncomplect) → A thin browser route and view that reads client state and calls named client commands.

- [fence](/lore/the-fence) → Compiler checks, lint rules, and hooks that reject prohibited code and shortcuts. They do not prove every runtime behavior.

- [fence metadata](/lore/code-snippets) → Options on the opening line of a Markdown code block. These options are separate from the project's enforcement checks.

- [fiber](/lore/concurrent-work-needs-an-owner) → Independently running work in Effect. Its fork operation determines its lifetime and ownership.

- [Foldkit](/lore/a-browser-send-follows-one-path) → The browser UI framework in rat-stack. A program keeps a Model, handles Messages in update, and runs side effects as named Commands.

## G

- [Git snapshot](/lore/shitrat-bestiary) → Stored Git query results and source fingerprints that the content build checks for drift before rendering pages.

## H

- [handler](/systems/capabilities) → The server-side implementation called after input validation and any required approval.

- [highlighter port](/lore/engine-neutral-tokens-keep-adapters-replaceable) → An interface for turning source code into per-line syntax tokens.

## I

- [idempotency](/lore/http-responses-need-validation) → Repeating an operation creates no additional change beyond its first successful application.

- [implicit state machine](/lore/implicit-state-machines) → State-transition logic spread across flags, conditions and loops instead of written as named states and events, so nobody can list which moves are allowed.

- [interface](/lore/one-schema-three-surfaces) → A way to call a named action, such as the command line or HTTP API.

- [ISR](/lore/there-is-no-isr-on-cloudflare) → Incremental static regeneration: rebuilding a cached page after its revalidation interval while serving a previously generated page.

## K

- [K2](/lore/queues-pipelines-workflows-and-k2-do-different-jobs) → Cloudflare's durable event log. Every subscription reads every record, and records stay until retention ends.

## L

- [Layer](/lore/layers-make-dependencies-explicit) → A description of how to build service implementations and supply what their construction needs.

- [Layer memoization](/lore/layers-make-dependencies-explicit) → Sharing a constructed service within one build context by the identity of the Layer that builds it.

- [lexicon](/lore/at-protocol) → An AT Protocol schema definition for records, HTTP endpoints, or event stream messages, identified by a namespaced identifier.

## M

- [machine](/lore/lifecycles-are-machines) → A definition of named states and the events that permit movement between them.

- [managed runtime](/lore/run-effect-at-the-boundary) → A runtime that retains constructed services between calls until it is disposed.

- [Markdown code fence](/lore/code-snippets) → A code block delimited by backticks. Its opening line can carry a language and excerpt options.

- [MCP](/lore/mcp-is-another-surface) → Model Context Protocol: a protocol through which an agent client discovers and calls tools.

- [memoization](/lore/layers-make-dependencies-explicit) → Reusing a previously constructed result within a stated context. Service construction shares results by Layer identity within one build context.

## N

- [no comments](/lore/no-comments) → Prose comments are banned. Explained tool directives, safety assertions, and type-only JavaScript JSDoc have stated exceptions.

## O

- [observability](/lore/trace-meaningful-operations) → Understanding a running system through logs, metrics, and traces.

## P

- [PDS](/lore/at-protocol) → A Personal Data Server that hosts account data and serves as the authoritative host for the account's repository.

- [pin](/skills/gardener) → An exact dependency version or source revision.

- [port](/lore/hexagonal-architecture) → An application-owned interface named for the job the application needs.

- [projection](/lore/one-capability-every-surface) → Code that turns a named action and its shared definition into a command, HTTP API, MCP tool, RPC interface, or code-mode interface.

- [provenance](/lore/code-snippets) → The repository, commit, file, and original lines from which an excerpt comes.

## R

- [Rat King](/lore/rat-king) → An agent-mail system with named mailboxes, signed messages, optional encryption, and Pi, CLI, and MCP clients.

- [read model](/skills/add-a-store) → Derived data arranged for efficient reads. It does not become the authority for writes.

- [requirement](/lore/effect-basics) → A service that a description of work still needs before it can run.

- [resource finalizer](/lore/scopes-own-resources) → A cleanup operation registered with an owner or an acquire-use-release operation.

- [retry budget](/lore/retry-load-needs-a-budget) → A limit on the total retry attempts that one owner allows across a call path.

- [RPC](/skills/learn-rat-stack) → Remote procedure call: a client calls a named operation implemented on the server.

- [runtime boundary](/lore/run-effect-at-the-boundary) → The place where code outside Effect needs to execute a description of work.

## S

- [Schema](/lore/schemas-define-the-boundary) → A description of accepted values, their TypeScript types, and the rules for checking and converting them at runtime.

- [Scope](/lore/scopes-own-resources) → An owner for registered cleanup operations. Closing it runs those operations.

- [scoped fiber](/lore/concurrent-work-needs-an-owner) → Independently running work owned by a cleanup scope. Closing that scope interrupts the work.

- [service](/lore/services-capture-dependencies) → A named interface for one job. Callers request it by its identifier, and startup code supplies its implementation.

- [service tag](/lore/services-capture-dependencies) → The identifier used to request a service, a named interface for one job, from Effect's collection of available implementations.

- [ShitRat](/lore/shitrat) → Joel Hooks' terminal-dwelling AI familiar, with a public site and incident log at shitrat.ai.

- [shitratgit\[bot\]](/lore/shitratgit-bot) → The bot author identity used for ShitRat's commits in rat-stack's Git history.

- [source drift](/lore/pinned-sources-can-report-drift) → A difference between selected pinned lines and the current source. It does not replace the pinned text.

- [state machine](/lore/lifecycles-are-machines) → Named states and the events that permit movement between them.

- [stream backpressure](/lore/concurrent-work-needs-an-owner) → A stream consumer requests data as it can process it, limiting the producer's progress.

- [surface](/lore/one-schema-three-surfaces) → In the motto “one capability, every surface”, a way to call a named action. Other prose uses “interface”.

- [system of record](/skills/add-a-store) → The authoritative store for a fact. Derived copies can be rebuilt from it.

## T

- [tautological tests](/lore/tests-that-earn-their-place) → Tests whose expected answers repeat the implementation instead of stating an independent rule.

- [telemetry](/lore/trace-meaningful-operations) → The logs, measurements, and trace data recorded about a running system.

- [trace export](/lore/trace-meaningful-operations) → Sending recorded trace data to a collector. Sending, acceptance, and stored retrieval are separate observations.

- [trace span](/lore/trace-meaningful-operations) → A record of an operation's timing and outcome.

- [tracing span](/lore/trace-meaningful-operations) → A record of an operation's timing and outcome.

- [traversal concurrency](/lore/concurrent-work-needs-an-owner) → The number of collection items whose work can run at the same time.

## U

- [uncomplect](/skills/uncomplect) → Separate concerns that currently change together.

## W

- [waitUntil](/lore/request-lifetime-is-not-durability) → A Worker call that keeps work running after the response, within a shared post-response time allowance.

- [Worker](/lore/workers-answer-requests-durable-objects-own-named-state) → Cloudflare's request handler. One isolate may serve many requests and can be evicted, so code must not rely on module state.

- [Workers Cache](/lore/there-is-no-isr-on-cloudflare) → Cloudflare's programmable cache for HTTP responses. Each location holds its own cached responses.
