gen-apisurface

Overview ¶

Command gen-apisurface genera apisurface.json: el DENOMINADOR del gate de cobertura del superapp — todo símbolo exportado de la superficie pública de Quark (el paquete raíz + los subpaquetes públicos). Usa go/packages + go/types (no reflexión), así que se puede `go install`ear y correr en CI.

go run ./examples/superapp/cmd/gen-apisurface            # escribe examples/superapp/apisurface.json
go run ./examples/superapp/cmd/gen-apisurface -out=/tmp/x.json

El formato lo define control.Manifest/Symbol (fuente única); el reconciliador de control/manifest.go cruza esto contra lo que el recorder marca como invocado, y el gate falla por cada símbolo in-scope no ejercido (salvo allowlist.json).