scripts/

Command catalog-smoke prepares and reports the local template smoke run.

Command gen-api-reference regenerates the route tables in docs/api-reference.md and the route metadata in internal/api/openapi_gen.go, both derived from the mux registrations in internal/api/routes*.go.

Command gen-arm-compat writes docs/arm-compatibility.md from the catalog's registry scan (platforms.json) and the recorded smoke results in docs/templates-status.md.

Command gen-runtime-settings-docs writes docs/runtime-settings.md and the generated env seed block in docs/environment-variables.md from the real runtime settings registry, so the docs cannot drift from the code.

Command gen-template-catalog-docs regenerates the per-category tables in docs/template-catalog.md from internal/catalog.Templates, the same data GET /api/v1/service-templates serves.

Command gen-template-gallery exports internal/catalog.Templates as the versioned catalog index (docs/catalog-index.md) that the docs gallery, the marketing site and a future catalog API all read.

Command gen-template-platforms rewrites the arm64 section of docs/templates-status.md from internal/catalog/platforms.json (merged into catalog.Templates).

Command glinr-bot evaluates one pull request against .github/glinr-bot.yml.

Command go-top-level-idents prints every top-level identifier (func, method, type, var, const, including grouped blocks) a single Go file declares, one per line.

Command idle-footprint measures the idle footprint of the control plane on Linux and guards it against a committed baseline.

Command mcp-eval runs scripted agent tasks through the real MCP server and reports pass or fail and the estimated tokens each one costs.

Command perf-fixtures seeds a scratch control plane data dir with a large, deterministic resource graph for UI performance measurement.

Command plugin-publish signs plugin manifests and marketplace indexes offline.

Command record-verified folds one passed smoke run into verified.json and images.lock.json.

Command refresh-db-catalog builds the published database version catalog (databases.v1.json) and its ed25519 signature.

Command scan-catalog-platforms inspects every catalog image in the registry and records which platforms its manifest lists in internal/catalog/platforms.json.

Package smokerecord folds one passed smoke run into verified.json and images.lock.json.

Command template-smoke starts catalog templates under real Docker and reports per template whether services stay running, exit, pass their healthcheck or fail to pull.

Command validate-templates checks template manifests and, optionally, a directory of raw compose files against the same parse, guard and translation path a real deploy uses.