Aster Specification

Aster v2 gateway, distribution, and space runtime architecture.

Aster v2 is assembled as a gateway distribution. The desktop and dev launchers run @aster/distro, which composes asterGateway() and starts it through the Effect runtime in @aster/gate/node.

Runtime stack

@aster/gate owns gateway contracts, graph validation, runtime orchestration, HTTP routes, sockets, database contracts, marketplace contracts, analytics, and observability service interfaces.
@aster/gate-adapters owns concrete providers such as SQLite, PostHog, and OpenTelemetry.
@aster/distro owns the Aster product graph: spaces, plugins, extensions, tools, skills, apps, routes, auth, database, analytics, observability, and marketplaces.
@aster/spaces owns space composition and run/lifecycle hooks.

The runtime is Effect-first: services are layers, startup and shutdown are scoped workflows, validation uses Effect Schema, and filesystem/path work goes through Effect platform services.