check-embed

Overview ¶

Command check-embed is the build-time gate for server actions on embeddable surfaces. It fails (exit 1) when an embed.Surface's screen renders a component whose registered ClientJS calls G.serverAction — the one thing that does not work inside a frame, because the action registry is app-global with no relationship to any surface.

Usage:

go run ./cmd/check-embed             # scans ./...
go run ./cmd/check-embed ./pkg/...   # scans a specific pattern

Exits 0 when clean, 1 when a surface registers a server action, and 2 on infrastructure error (a package failed to parse or type-check). Mirrors the check-csp exit-code convention; see framework/uihost/embed_actions.go for the boot-time backstop that catches whatever this static pass cannot reach.