ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
docs: publish reproducible README measurements
Juan Denis2de3a971c537
diff --git a/.github/workflows/measurements-ci.yml b/.github/workflows/measurements-ci.ymlnew file mode 100644index 00000000..9ba5c28d--- /dev/null+++ b/.github/workflows/measurements-ci.yml@@ -0,0 +1,42 @@+name: Measurement tools and README tables++on:+ push:+ branches: [dev]+ paths:+ - 'README.md'+ - 'docs/README*.md'+ - 'docs/measurements/**'+ - 'scripts/measure-repository.py'+ - 'scripts/update-readme-measurements.py'+ - 'scripts/profile-api.py'+ - 'scripts/test/test_repository_measurements.py'+ - 'scripts/test/test_profile_api.py'+ - '.github/workflows/measurements-ci.yml'+ pull_request:+ branches: [main]+ paths:+ - 'README.md'+ - 'docs/README*.md'+ - 'docs/measurements/**'+ - 'scripts/measure-repository.py'+ - 'scripts/update-readme-measurements.py'+ - 'scripts/profile-api.py'+ - 'scripts/test/test_repository_measurements.py'+ - 'scripts/test/test_profile_api.py'+ - '.github/workflows/measurements-ci.yml'++jobs:+ measurements:+ runs-on: ubuntu-latest+ steps:+ - uses: actions/checkout@v4+ - uses: actions/setup-python@v5+ with:+ python-version: '3.11'+ - name: Test measurement tools (stdlib only)+ run: |+ python -m unittest discover -s scripts/test -p test_repository_measurements.py+ python -m unittest discover -s scripts/test -p test_profile_api.py+ - name: Check translated README tables against reviewed snapshots+ run: python scripts/update-readme-measurements.pydiff --git a/README.md b/README.mdindex 594c730a..7ae3f9db 100644--- a/README.md+++ b/README.md@@ -44,25 +44,26 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P## 📊 By the Numbers-Everything below is measured from this repository, not estimated.+<!-- BEGIN GENERATED MEASUREMENTS -->+Snapshot: **2026-09-05**. [Definitions, raw measurements and reproduction commands](docs/METRICS.md).| | ||---|---|-| **1,350+** REST endpoints | across 109 blueprints — `/api/v1/*`, with OpenAPI + Swagger UI at `/api/v1/docs` |-| **118** one-click app templates | bundled in the repo, no registry account needed |-| **4,300+** backend tests | the whole suite runs on every change, with a CI-enforced floor on the collected count |-| **1.75 MB** gzipped web UI | 60+ screens, assets served from your own box — no CDN |-| **~180 MB** resident | the entire panel, single process — sits comfortably beside your apps on a 1 GB VPS |-| **501 MB** container image | or install straight onto the host; Docker is optional for the panel itself |-| **$0** | MIT-licensed. No tiers, no seat limits, no upsell — and nothing phones home. |+| **1,212** core route declarations | in **104** blueprint declarations under `backend/app/api`; source inventory, excluding extensions |+| **118** bundled app templates | root-level app YAML files; database extension templates counted separately |+| **5,089** backend test cases collected | clean-checkout collection; this is not a claim that every case passed or ran |+| **0.83 MB** gzip, HTML-linked JS/CSS | scripts, stylesheets and modulepreloads listed in the production HTML |+| **3.31 MB** gzip, all built JS/CSS | includes lazy chunks, locale bundles and vendor shims; excludes fonts and images |+| **$0** license cost | MIT-licensed, without subscription or seat fees |-Self-hosted and Docker-native, on hardware you already pay for.+Gzip values sum separately compressed files at level 9; they are not measured page-load times. RAM usage and image size depend on the build, platform and workload; no universal footprint is claimed.+<!-- END GENERATED MEASUREMENTS -->---## 🚀 Quick Start-> ⏱️ Up and running in under 2 minutes+> Installation time depends on the server, network and required packages.### Option 1: One-Line Install (Recommended)@@ -114,7 +115,7 @@ See the [Installation Guide](docs/INSTALLATION.md) for step-by-step instructions| **Disk** | 10 GB | 20+ GB || **Docker** | 24.0+ (optional for the panel itself) | Latest |-> The panel itself only needs ~180 MB of RAM and ~500 MB of disk — the rest is headroom for your apps. It runs happily on a 1 GB VPS, a spare laptop, or a Raspberry Pi (ARM64), so it's as much at home in a homelab as it is on production hardware.+> These requirements are sizing guidance, not a capacity benchmark. Allow additional RAM and disk for managed apps, images, databases, logs and backups. Measure your own workload using the [measurement guide](docs/METRICS.md).---diff --git a/docs/METRICS.md b/docs/METRICS.mdnew file mode 100644index 00000000..85a53481--- /dev/null+++ b/docs/METRICS.md@@ -0,0 +1,115 @@+# ServerKit measurements++The README tables are a dated snapshot, generated from the same JSON files for+English, Spanish, Portuguese and Chinese. They separate source inventory from+build sizes and runtime measurements. A count of collected tests is not a count+of passing tests, and compressed asset bytes are not a page-load benchmark.++## Recorded snapshot++- [Source inventory](measurements/repository.json): measured on September 5,+ 2026 with Python 3.11.7 on Windows. The clean collection count was also checked+ on Linux. The base source revision, whether measured source has uncommitted+ changes, and a hash of that measured source are recorded. The hash describes+ the working files, so a pre-commit snapshot is not attributed to an unchanged+ historical revision.+- [Production build inventory](measurements/frontend-build.json): Node version,+ per-asset byte/gzip sizes and a content hash are recorded. Built from an+ isolated copy of tracked/new frontend source after the request/form cleanup,+ excluding ignored files and reusing the installed dependencies, with+ `npm run build`. Its code hash matched the ordinary working-checkout build.+- Runtime memory and container image bytes are **unmeasured in this snapshot**.+ The previous ~180 MB RAM and 501 MB image figures had no reproducible+ environment or image digest, so they were removed instead of repeated.++### What each number includes++| Measurement | Definition |+| --- | --- |+| Core route declarations | Route decorators in Git-tracked Python under `backend/app/api/`. A function with two route decorators counts twice. This is source inventory, not the set of enabled runtime endpoints. |+| Core blueprint declarations | `Blueprint(...)` declarations in the same files. Extension blueprints and conditionally loaded routes are outside this count. |+| Explicit method/route pairs | Literal route methods, excluding automatic HEAD/OPTIONS. The JSON separately reports declarations whose methods cannot be resolved statically. |+| App templates | Git-tracked YAML files directly inside `backend/templates/`; nested database-extension templates are excluded. |+| Backend tests | Pytest collection from `backend/tests` using the existing clean-collection instrument; ignored installed extension copies do not inflate the count. Skipped/opt-in tests can still be collected. |+| HTML-linked code | JS/MJS/CSS referenced by script, stylesheet or modulepreload tags in production `index.html`. Later runtime requests, fonts and images are excluded. |+| All built code | Every JS/MJS/CSS file in the production output, including lazy chunks, translations, extension code and public vendor shims. HTML, fonts, images, source maps and other assets are excluded. |+| Gzip bytes | Sum of each file compressed independently with gzip level 9. MB means 1,000,000 bytes. These are reproducible compression estimates; actual transfer depends on server compression and browser caching. |++The old “1.75 MB web UI” number had no precise asset scope. The new HTML-linked+and all-code totals must not be interpreted as a measured speedup over that+old figure. Non-English locale chunks are already loaded on demand; their+build-size warnings alone do not show that every visitor downloads them.++## Refresh the source and build measurements++Use the backend Python environment with its dependencies installed. From the+repository root:++```bash+python scripts/measure-repository.py --collect-tests --output docs/measurements/repository.json+cd frontend+npm run build+npm run measure:build -- --output ../docs/measurements/frontend-build.json+cd ..+python scripts/update-readme-measurements.py --write+python scripts/update-readme-measurements.py+```++On Windows, `backend\venv\Scripts\python.exe` can replace `python`. Review the+snapshot and README diffs together. The final command checks agreement between+all translated tables and the snapshots; it does not pretend an old build+snapshot is a fresh measurement. Rebuild when publishing new size claims.++## Measure API latency and database work++The panel already records API timings through its analytics middleware. For a+bounded investigation, enable `SERVERKIT_PROFILE_REQUESTS=true` on an authorized+local or staging panel and restart it. This adds a `Server-Timing` response+header containing application elapsed time, SQL elapsed time and statement+count. It records neither SQL text nor parameters and creates no new database+table. The profiler is off by default and installs no SQL listeners when off.++Use the real HTTP sampler against the running panel:++```bash+python scripts/profile-api.py --base-url http://127.0.0.1:47927 --path /api/v1/system/health --samples 20 --warmup 2 --output .reviews/api-profile.json+```++For protected endpoints, supply a short-lived JWT through+`SERVERKIT_PROFILE_TOKEN`, or `SERVERKIT_PROFILE_API_KEY` only for routes that+already support API keys. Do not supply both. The sampler makes GET requests,+refuses redirects, and does not include bodies, credentials or query values in+its report. HTTP/transport failures are recorded and make the command fail.+Missing profiler headers produce `null` fields, never invented zero costs.++Reports contain sample count, response sizes/statuses, min/p50/p95/max latency,+and optional application/SQL distributions. Warmup is excluded from the latency+summary, but its requests and failures remain visible. Turn profiling off when+the investigation is finished.++Record panel revision, OS/architecture, Python version, database engine,+server/resource counts, cache state, concurrency and whether the panel is idle+or loaded. Compare the same dataset and environment before and after a change.+The sampler is sequential and does not establish throughput under concurrency.+Profiler SQL counts cover statements on the HTTP request thread through response+construction; background jobs and streamed body iteration are not included.++## Measure memory, images and browser loading separately++- **Memory:** record the exact process/container, workload, uptime and sampling+ interval. Process RSS and Docker memory accounting are different measurements.+ Include workers and enabled services; do not describe one idle sample as a+ universal minimum or capacity guarantee.+- **Image size:** record image digest, architecture, build arguments and whether+ bytes describe the local uncompressed image or registry transfer. A cached+ image from a different commit is not a measurement of the current source.+- **Browser loading:** record cold/warm cache, device, connection, route, locale+ and extension set. Use a production build and inspect actual requests and+ navigation timings; source-file counts and total dist size cannot substitute+ for this. Large assets should be optimized when that trace shows they affect+ a relevant user flow.++No production latency, memory, capacity or percentage-speedup claim is made by+the source/build snapshot. Existing fleet tests enforce one metrics query per+reader at multiple fleet sizes; the opt-in profiler makes that kind of query+budget observable on a running panel too.diff --git a/docs/README.es.md b/docs/README.es.mdindex 3b3bb1e8..3685972e 100644--- a/docs/README.es.md+++ b/docs/README.es.md@@ -44,25 +44,26 @@ ni el coste de las plataformas gestionadas.## 📊 En Números-Todo lo siguiente está medido sobre este repositorio, no estimado.+<!-- BEGIN GENERATED MEASUREMENTS -->+Instantánea: **2026-09-05**. [Definiciones, medidas y comandos para reproducirlas](METRICS.md).| | ||---|---|-| **1.519** endpoints REST | repartidos en 107 blueprints — `/api/v1/*`, con OpenAPI y Swagger UI en `/api/v1/docs` |-| **106** plantillas de apps | incluidas en el repositorio, sin necesidad de cuenta en ningún registro |-| **2.633** pruebas de backend | la suite completa se ejecuta ante cada cambio |-| **1,75 MB** de interfaz web (gzip) | 65 pantallas, servidas desde tu propio servidor — sin CDN |-| **~180 MB** en memoria | el panel entero, un solo proceso — convive sin apreturas con tus apps en un VPS de 1 GB |-| **501 MB** de imagen de contenedor | o instálalo directamente en el host; Docker es opcional para el panel |-| **$0** | Licencia MIT. Sin planes, sin límite de usuarios, sin ventas adicionales — y nada se comunica hacia afuera. |+| **1.212** declaraciones de rutas del núcleo | en **104** declaraciones de blueprints de `backend/app/api`; inventario del código, sin extensiones |+| **118** plantillas de apps incluidas | archivos YAML de apps en el directorio raíz; las plantillas de extensiones de bases de datos se cuentan aparte |+| **5.089** casos de prueba de backend recopilados | recopilación de un checkout limpio; no significa que todos se hayan ejecutado o aprobado |+| **0,83 MB** gzip de JS/CSS enlazado por el HTML | scripts, estilos y precargas de módulos del HTML de producción |+| **3,31 MB** gzip de todo el JS/CSS generado | incluye módulos diferidos, idiomas y adaptadores de dependencias; excluye fuentes e imágenes |+| **$0** de licencia | Licencia MIT, sin suscripciones ni tarifas por usuario |-Autoalojado y nativo en Docker, sobre hardware que ya estás pagando.+Los valores gzip suman archivos comprimidos por separado a nivel 9; no son tiempos de carga medidos. La RAM y el tamaño de imagen dependen de la compilación, plataforma y carga de trabajo.+<!-- END GENERATED MEASUREMENTS -->---## 🚀 Inicio Rápido-> ⏱️ En funcionamiento en menos de 2 minutos+> El tiempo de instalación depende del servidor, la red y los paquetes necesarios.### Opción 1: Instalación en Una Línea (Recomendada)@@ -115,7 +116,7 @@ Consulta la [Guía de Instalación](INSTALLATION.md) para instrucciones paso a p| **Disco** | 10 GB | 20+ GB || **Docker** | 24.0+ (opcional para el panel) | Última versión |-> El panel en sí solo usa ~180 MB de RAM y ~500 MB de disco — el resto es margen para tus apps. Funciona bien en un VPS de 1 GB, un portátil viejo o una Raspberry Pi (ARM64): pensado tanto para homelabs como para producción.+> Estos requisitos orientan el dimensionamiento; no son una prueba de capacidad. Reserva RAM y disco adicionales para apps, imágenes, bases de datos, registros y copias de seguridad. Consulta la [guía de medición](METRICS.md) para medir tu carga de trabajo.---diff --git a/docs/README.pt.md b/docs/README.pt.mdindex 39ce1760..44eccdab 100644--- a/docs/README.pt.md+++ b/docs/README.pt.md@@ -44,25 +44,26 @@ ou o custo de plataformas gerenciadas.## 📊 Em Números-Tudo abaixo é medido a partir deste repositório, não estimado.+<!-- BEGIN GENERATED MEASUREMENTS -->+Registro: **2026-09-05**. [Definições, medições e comandos de reprodução](METRICS.md).| | ||---|---|-| **1.519** endpoints REST | distribuídos em 107 blueprints — `/api/v1/*`, com OpenAPI e Swagger UI em `/api/v1/docs` |-| **106** templates de aplicações | incluídos no repositório, sem precisar de conta em nenhum registro |-| **2.633** testes de backend | a suíte completa roda a cada alteração |-| **1,75 MB** de interface web (gzip) | 65 telas, servidas do seu próprio servidor — sem CDN |-| **~180 MB** residentes | o painel inteiro, um único processo — convive folgadamente com suas apps num VPS de 1 GB |-| **501 MB** de imagem de contêiner | ou instale direto no host; Docker é opcional para o painel |-| **$0** | Licença MIT. Sem planos, sem limite de usuários, sem upsell — e nada é enviado para fora. |+| **1.212** declarações de rotas do núcleo | em **104** declarações de blueprints em `backend/app/api`; inventário do código, sem extensões |+| **118** templates de apps incluídos | arquivos YAML de apps no diretório raiz; templates de extensões de banco são contados separadamente |+| **5.089** casos de teste de backend coletados | coleta de um checkout limpo; não significa que todos executaram ou passaram |+| **0,83 MB** gzip de JS/CSS vinculado pelo HTML | scripts, estilos e pré-carregamentos de módulos no HTML de produção |+| **3,31 MB** gzip de todo o JS/CSS gerado | inclui módulos sob demanda, idiomas e adaptadores de dependências; exclui fontes e imagens |+| **$0** de licença | Licença MIT, sem assinaturas ou taxas por usuário |-Auto-hospedado e nativo em Docker, em hardware que você já paga.+Os valores gzip somam arquivos comprimidos separadamente no nível 9; não são tempos de carregamento medidos. A RAM e o tamanho da imagem dependem da compilação, plataforma e carga de trabalho.+<!-- END GENERATED MEASUREMENTS -->---## 🚀 Início Rápido-> ⏱️ Pronto para usar em menos de 2 minutos+> O tempo de instalação depende do servidor, da rede e dos pacotes necessários.### Opção 1: Instalação em Uma Linha (Recomendado)@@ -115,7 +116,7 @@ Consulte o [Guia de Instalação](INSTALLATION.md) para instruções passo a pas| **Disco** | 10 GB | 20+ GB || **Docker** | 24.0+ (opcional para o painel) | Mais recente |-> O painel em si usa apenas ~180 MB de RAM e ~500 MB de disco — o resto é margem para os seus apps. Funciona bem num VPS de 1 GB, num notebook antigo ou num Raspberry Pi (ARM64): feito tanto para homelabs quanto para produção.+> Estes requisitos orientam o dimensionamento; não são um teste de capacidade. Reserve RAM e disco adicionais para apps, imagens, bancos, logs e backups. Consulte o [guia de medição](METRICS.md) para medir sua carga de trabalho.---diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.mdindex 9f13c1c7..07aae096 100644--- a/docs/README.zh-CN.md+++ b/docs/README.zh-CN.md@@ -44,25 +44,26 @@ Docker 容器和安全策略——无需 Kubernetes 的复杂性,## 📊 数据一览-以下数据均实测自本仓库,并非估算。+<!-- BEGIN GENERATED MEASUREMENTS -->+测量快照:**2026-09-05**。[定义、原始测量结果和复现命令](METRICS.md)。| | ||---|---|-| **1,519** 个 REST 接口 | 分布在 107 个蓝图中 — `/api/v1/*`,并在 `/api/v1/docs` 提供 OpenAPI 与 Swagger UI |-| **106** 个一键应用模板 | 随仓库内置,无需注册任何应用市场账号 |-| **2,633** 项后端测试 | 每次变更都会跑完整套件 |-| **1.75 MB** 前端界面(gzip 后) | 65 个页面,静态资源全部由你自己的服务器提供 — 不依赖 CDN |-| **~180 MB** 常驻内存 | 整个面板仅一个进程 — 在 1 GB 内存的 VPS 上与你的应用从容共存 |-| **501 MB** 容器镜像 | 也可直接装在宿主机上;面板本身并不强制使用 Docker |-| **$0** | MIT 许可证。没有套餐分级、没有席位限制、没有增值推销 — 也不会向外回传任何数据。 |+| **1,212** 个核心路由声明 | 来自 `backend/app/api` 中 **104** 个蓝图声明;这是源码清单,不包括扩展 |+| **118** 个内置应用模板 | 模板目录根层级的应用 YAML 文件;数据库扩展模板另计 |+| **5,089** 个已收集的后端测试用例 | 基于干净检出的测试收集结果;不代表所有用例均已运行或通过 |+| **0.83 MB** gzip 的 HTML 直接引用 JS/CSS | 生产 HTML 中的脚本、样式表和模块预加载资源 |+| **3.31 MB** gzip 的全部构建 JS/CSS | 包括按需模块、语言包和依赖适配文件;不含字体和图片 |+| **$0** 许可费用 | MIT 许可证,无订阅或席位费用 |-自托管、Docker 原生,跑在你已经付过钱的机器上。+gzip 数值为各文件分别按级别 9 压缩后的总和,并非实测页面加载时间。内存占用与镜像大小取决于构建、平台和工作负载,不作通用占用保证。+<!-- END GENERATED MEASUREMENTS -->---## 🚀 快速开始-> ⏱️ 不到 2 分钟即可启动运行+> 安装时间取决于服务器、网络和所需的软件包。### 方式一:一键安装(推荐)@@ -113,7 +114,7 @@ docker compose up -d # 访问 http://localhost:5000| **磁盘** | 10 GB | 20+ GB || **Docker** | 24.0+(面板本身可选) | 最新版 |-> 面板本身仅占用约 180 MB 内存和 500 MB 磁盘——其余都是为你的应用预留的空间。在 1 GB VPS、闲置笔记本或树莓派(ARM64)上都能流畅运行:既适合家庭实验室,也适合生产环境。+> 这些要求是资源规划建议,并非容量基准测试。请为托管应用、镜像、数据库、日志和备份预留额外内存与磁盘空间。可参考[测量指南](METRICS.md)评估自己的工作负载。---diff --git a/docs/measurements/frontend-build.json b/docs/measurements/frontend-build.jsonnew file mode 100644index 00000000..b086ef60--- /dev/null+++ b/docs/measurements/frontend-build.json@@ -0,0 +1,1008 @@+{+ "schema_version": 1,+ "measured_at_utc": "2026-09-05T18:36:33.444Z",+ "node_version": "v22.17.0",+ "measured_code_sha256": "150d84e581e07c19533a81a25946e1e62e9666ef3287c6a99159625e8ad8acd6",+ "compression": "gzip, level 9, each file separately; sizes are bytes",+ "scope": "Built JS/MJS/CSS, including public vendor shims. Excludes HTML, fonts, images, maps and other non-code assets.",+ "html_linked_scope": "Only script, stylesheet and modulepreload URLs in index.html; not a complete runtime network trace or every later lazy import.",+ "all_code": {+ "files": 185,+ "bytes": 11683004,+ "gzip_bytes": 3306531+ },+ "html_linked_code": {+ "files": 74,+ "bytes": 3293694,+ "gzip_bytes": 828863+ },+ "largest_code_assets": [+ {+ "path": "assets/index-CVanDihf.css",+ "bytes": 974501,+ "gzip_bytes": 138204+ },+ {+ "path": "assets/bn-DQJxc4qM.js",+ "bytes": 598496,+ "gzip_bytes": 131054+ },+ {+ "path": "assets/th-DHsDkRJN.js",+ "bytes": 578831,+ "gzip_bytes": 128442+ },+ {+ "path": "assets/ru-BiYZQRSY.js",+ "bytes": 487932,+ "gzip_bytes": 135557+ },+ {+ "path": "assets/ar-0QC_HyYN.js",+ "bytes": 415266,+ "gzip_bytes": 120978+ },+ {+ "path": "assets/vendor-charts-_7lweA91.js",+ "bytes": 395861,+ "gzip_bytes": 102971+ },+ {+ "path": "assets/vi-BBWpEAcO.js",+ "bytes": 378809,+ "gzip_bytes": 114517+ },+ {+ "path": "assets/fr-B3wJvclY.js",+ "bytes": 354826,+ "gzip_bytes": 115299+ },+ {+ "path": "assets/ko-cbntekXb.js",+ "bytes": 352061,+ "gzip_bytes": 113937+ },+ {+ "path": "assets/de-CMeQ0Q04.js",+ "bytes": 349793,+ "gzip_bytes": 115655+ },+ {+ "path": "assets/pl-IIic_FFF.js",+ "bytes": 340721,+ "gzip_bytes": 117822+ },+ {+ "path": "assets/es-XJqtqF-U.js",+ "bytes": 339857,+ "gzip_bytes": 111055+ }+ ],+ "assets": [+ {+ "path": "assets/AgentFleet-B7_nz7or.js",+ "bytes": 25349,+ "gzip_bytes": 5714+ },+ {+ "path": "assets/AppMap-CTfYFAwx.js",+ "bytes": 8785,+ "gzip_bytes": 3623+ },+ {+ "path": "assets/Backups-Oz9kMTOB.js",+ "bytes": 51208,+ "gzip_bytes": 13490+ },+ {+ "path": "assets/BandwidthSparkline-I7vIa8HL.js",+ "bytes": 3706,+ "gzip_bytes": 1327+ },+ {+ "path": "assets/BuildpackPreview-Q2-EkG9o.js",+ "bytes": 5774,+ "gzip_bytes": 1804+ },+ {+ "path": "assets/Coexistence-si7t-Es2.js",+ "bytes": 7182,+ "gzip_bytes": 2697+ },+ {+ "path": "assets/ConfirmDialog-Xo0CScem.js",+ "bytes": 5916,+ "gzip_bytes": 2192+ },+ {+ "path": "assets/CopyButton-COhap6yN.js",+ "bytes": 891,+ "gzip_bytes": 531+ },+ {+ "path": "assets/CronJobs-BtIZjJkN.js",+ "bytes": 21282,+ "gzip_bytes": 6357+ },+ {+ "path": "assets/DangerZone-CeOUNJX1.js",+ "bytes": 436,+ "gzip_bytes": 261+ },+ {+ "path": "assets/Dashboard-C7wEIJzA.js",+ "bytes": 92154,+ "gzip_bytes": 27286+ },+ {+ "path": "assets/DatabaseMigration-IBv_4l6X.js",+ "bytes": 11400,+ "gzip_bytes": 3158+ },+ {+ "path": "assets/Databases-DnIYu_4Y.js",+ "bytes": 140972,+ "gzip_bytes": 36620+ },+ {+ "path": "assets/DeliveryLog-BaOYzcsI.js",+ "bytes": 11805,+ "gzip_bytes": 3960+ },+ {+ "path": "assets/DeployConsole-CTg1peo-.js",+ "bytes": 22982,+ "gzip_bytes": 7274+ },+ {+ "path": "assets/DeploymentTimeline-Cd5SKe1b.js",+ "bytes": 20334,+ "gzip_bytes": 5105+ },+ {+ "path": "assets/Deployments-Cb4SIJ1_.js",+ "bytes": 8442,+ "gzip_bytes": 3090+ },+ {+ "path": "assets/Docker-NZDQdIHg.js",+ "bytes": 72809,+ "gzip_bytes": 17031+ },+ {+ "path": "assets/DocsLink-Bp7QN8rQ.js",+ "bytes": 520,+ "gzip_bytes": 361+ },+ {+ "path": "assets/Documentation-dM5OBmcr.js",+ "bytes": 5673,+ "gzip_bytes": 1976+ },+ {+ "path": "assets/Domains-Bsg8FNM-.js",+ "bytes": 38171,+ "gzip_bytes": 10964+ },+ {+ "path": "assets/Downloads-ezWmWO2h.js",+ "bytes": 11505,+ "gzip_bytes": 3157+ },+ {+ "path": "assets/EmptyState-Y4MOQukK.js",+ "bytes": 9160,+ "gzip_bytes": 1935+ },+ {+ "path": "assets/Errors-DzPb9SiS.js",+ "bytes": 10264,+ "gzip_bytes": 3192+ },+ {+ "path": "assets/FavoriteStar-1bzf-gC-.js",+ "bytes": 1037,+ "gzip_bytes": 539+ },+ {+ "path": "assets/FileManager-cHPvs09J.js",+ "bytes": 51779,+ "gzip_bytes": 13761+ },+ {+ "path": "assets/FleetProxy-h7e8g-IF.js",+ "bytes": 7114,+ "gzip_bytes": 2499+ },+ {+ "path": "assets/FormField-2_Ug2SOb.js",+ "bytes": 854,+ "gzip_bytes": 413+ },+ {+ "path": "assets/GithubAppCallback-b0_L6wmf.js",+ "bytes": 2024,+ "gzip_bytes": 972+ },+ {+ "path": "assets/ImportWizard-Dzlrl0qj.js",+ "bytes": 25368,+ "gzip_bytes": 6529+ },+ {+ "path": "assets/Incidents-BtO5YA7X.js",+ "bytes": 12305,+ "gzip_bytes": 4092+ },+ {+ "path": "assets/InfoList-ChCWQp3d.js",+ "bytes": 527,+ "gzip_bytes": 310+ },+ {+ "path": "assets/Jobs-DbCbs30I.js",+ "bytes": 9760,+ "gzip_bytes": 3317+ },+ {+ "path": "assets/LogContent-C6VMFag4.js",+ "bytes": 6859,+ "gzip_bytes": 2564+ },+ {+ "path": "assets/Login-CShxPoYB.js",+ "bytes": 8043,+ "gzip_bytes": 2886+ },+ {+ "path": "assets/LogsDrawerContext-CV3lsDLs.js",+ "bytes": 367,+ "gzip_bytes": 245+ },+ {+ "path": "assets/Marketplace-BXogLkIf.js",+ "bytes": 48828,+ "gzip_bytes": 13409+ },+ {+ "path": "assets/Modal-BkNur6mo.js",+ "bytes": 811,+ "gzip_bytes": 435+ },+ {+ "path": "assets/MonitorDetail-DhRumRM0.js",+ "bytes": 18171,+ "gzip_bytes": 5457+ },+ {+ "path": "assets/Monitoring-6f1eTDj5.js",+ "bytes": 56756,+ "gzip_bytes": 14857+ },+ {+ "path": "assets/Monitors-Oo9D7iNc.js",+ "bytes": 15393,+ "gzip_bytes": 4850+ },+ {+ "path": "assets/NewService-Do77mcY9.js",+ "bytes": 31523,+ "gzip_bytes": 8734+ },+ {+ "path": "assets/NotFound-Bf7Nc2HG.js",+ "bytes": 1454,+ "gzip_bytes": 700+ },+ {+ "path": "assets/Notifications-BB-uc34Y.js",+ "bytes": 6111,+ "gzip_bytes": 2027+ },+ {+ "path": "assets/OperationsContext-BWUXcieJ.js",+ "bytes": 8343,+ "gzip_bytes": 3264+ },+ {+ "path": "assets/PageLayout-2EmhsU7a.js",+ "bytes": 721,+ "gzip_bytes": 365+ },+ {+ "path": "assets/PageLoader-B1ff2He2.js",+ "bytes": 399,+ "gzip_bytes": 293+ },+ {+ "path": "assets/ProcessTable-C5Xw0IBc.js",+ "bytes": 6783,+ "gzip_bytes": 2472+ },+ {+ "path": "assets/ProjectDetail-DO9cznS3.js",+ "bytes": 9680,+ "gzip_bytes": 3157+ },+ {+ "path": "assets/Projects-BW641fiW.js",+ "bytes": 5805,+ "gzip_bytes": 2244+ },+ {+ "path": "assets/ProviderBrands-n8ow8BwC.js",+ "bytes": 4127,+ "gzip_bytes": 1933+ },+ {+ "path": "assets/PublicStatusPage-B_FGxbpY.js",+ "bytes": 5410,+ "gzip_bytes": 1634+ },+ {+ "path": "assets/QueueDetail-Ds3f4209.js",+ "bytes": 11537,+ "gzip_bytes": 3580+ },+ {+ "path": "assets/QueueOperations-hNYzIn9Y.js",+ "bytes": 18011,+ "gzip_bytes": 4699+ },+ {+ "path": "assets/Recipes-EH0l2sQ3.js",+ "bytes": 9972,+ "gzip_bytes": 3508+ },+ {+ "path": "assets/Register-BONdPwz7.js",+ "bytes": 4791,+ "gzip_bytes": 1420+ },+ {+ "path": "assets/RemoteAccess-DRR_o5VW.js",+ "bytes": 13731,+ "gzip_bytes": 4086+ },+ {+ "path": "assets/RequiresDocker-DUCyiExP.js",+ "bytes": 2139,+ "gzip_bytes": 923+ },+ {+ "path": "assets/ResourceListPage-3tIVlPoI.js",+ "bytes": 4915,+ "gzip_bytes": 2138+ },+ {+ "path": "assets/ResourcePicker-C_YXfpQh.js",+ "bytes": 18302,+ "gzip_bytes": 6792+ },+ {+ "path": "assets/SSLCertificates-qbXCdUWI.js",+ "bytes": 17225,+ "gzip_bytes": 4988+ },+ {+ "path": "assets/SSOCallback-rgvpTdcS.js",+ "bytes": 2078,+ "gzip_bytes": 967+ },+ {+ "path": "assets/SSOProviderIcon-suLUgNY8.js",+ "bytes": 1889,+ "gzip_bytes": 989+ },+ {+ "path": "assets/SchedulePicker-DAtjeFHA.js",+ "bytes": 8809,+ "gzip_bytes": 2831+ },+ {+ "path": "assets/Security-qC_UMwg3.js",+ "bytes": 54385,+ "gzip_bytes": 13122+ },+ {+ "path": "assets/ServerDetail-CDd5Wkip.js",+ "bytes": 129188,+ "gzip_bytes": 31455+ },+ {+ "path": "assets/ServerKitLogo-aeIpNoKQ.js",+ "bytes": 1270,+ "gzip_bytes": 649+ },+ {+ "path": "assets/ServerTemplates-D7bkBRSw.js",+ "bytes": 12569,+ "gzip_bytes": 3856+ },+ {+ "path": "assets/Servers-TCnaphdY.js",+ "bytes": 32392,+ "gzip_bytes": 9407+ },+ {+ "path": "assets/ServiceDetail-Cn35S5nZ.js",+ "bytes": 167733,+ "gzip_bytes": 40071+ },+ {+ "path": "assets/Services-RVzvCk8b.js",+ "bytes": 13044,+ "gzip_bytes": 4162+ },+ {+ "path": "assets/ServicesTab-BJea8xcn.js",+ "bytes": 9478,+ "gzip_bytes": 3355+ },+ {+ "path": "assets/Settings-BA5eqeLx.js",+ "bytes": 288851,+ "gzip_bytes": 66778+ },+ {+ "path": "assets/Setup-PIskKI_6.js",+ "bytes": 30350,+ "gzip_bytes": 7839+ },+ {+ "path": "assets/SharedVariables-S12uNdkC.js",+ "bytes": 12971,+ "gzip_bytes": 3701+ },+ {+ "path": "assets/SourceConnectionCallback-EDi4BaCM.js",+ "bytes": 2060,+ "gzip_bytes": 1000+ },+ {+ "path": "assets/Spinner-CtgnlSA5.js",+ "bytes": 501,+ "gzip_bytes": 296+ },+ {+ "path": "assets/StatusBadge-DRJArhzg.js",+ "bytes": 488,+ "gzip_bytes": 327+ },+ {+ "path": "assets/StyleGuide-CdNNP6XM.js",+ "bytes": 76602,+ "gzip_bytes": 16097+ },+ {+ "path": "assets/TargetPicker-Bld9Lg9q.js",+ "bytes": 2156,+ "gzip_bytes": 1032+ },+ {+ "path": "assets/Telemetry-1jNM23AA.js",+ "bytes": 11187,+ "gzip_bytes": 3763+ },+ {+ "path": "assets/Templates-DVdE6NeT.js",+ "bytes": 19594,+ "gzip_bytes": 6928+ },+ {+ "path": "assets/Terminal-DCB2JSbv.js",+ "bytes": 32222,+ "gzip_bytes": 9040+ },+ {+ "path": "assets/TestSandbox-B-JFVi1o.js",+ "bytes": 11876,+ "gzip_bytes": 4025+ },+ {+ "path": "assets/Trans-DUhiEKWi.js",+ "bytes": 10742,+ "gzip_bytes": 4523+ },+ {+ "path": "assets/Vaults-B6sy9xuk.js",+ "bytes": 11796,+ "gzip_bytes": 3422+ },+ {+ "path": "assets/WorkspaceDetail-Z46ncHsN.js",+ "bytes": 28809,+ "gzip_bytes": 7316+ },+ {+ "path": "assets/Workspaces-DFAW186J.js",+ "bytes": 7880,+ "gzip_bytes": 2799+ },+ {+ "path": "assets/api-CCJRyK9u.js",+ "bytes": 150808,+ "gzip_bytes": 30239+ },+ {+ "path": "assets/ar-0QC_HyYN.js",+ "bytes": 415266,+ "gzip_bytes": 120978+ },+ {+ "path": "assets/badge-DAehhJoZ.js",+ "bytes": 302,+ "gzip_bytes": 235+ },+ {+ "path": "assets/bn-DQJxc4qM.js",+ "bytes": 598496,+ "gzip_bytes": 131054+ },+ {+ "path": "assets/button-DRJXHEms.js",+ "bytes": 2804,+ "gzip_bytes": 1263+ },+ {+ "path": "assets/card-GJcYnddq.js",+ "bytes": 1077,+ "gzip_bytes": 363+ },+ {+ "path": "assets/clipboard-Dn2VjE_I.js",+ "bytes": 468,+ "gzip_bytes": 297+ },+ {+ "path": "assets/de-CMeQ0Q04.js",+ "bytes": 349793,+ "gzip_bytes": 115655+ },+ {+ "path": "assets/deployActivity-Bhx2ttym.js",+ "bytes": 1123,+ "gzip_bytes": 589+ },+ {+ "path": "assets/dialog-ZZdAdpRd.js",+ "bytes": 1416,+ "gzip_bytes": 563+ },+ {+ "path": "assets/dist-4WJ2Dj-L.js",+ "bytes": 303,+ "gzip_bytes": 216+ },+ {+ "path": "assets/dist-BvEkDNZs.js",+ "bytes": 2782,+ "gzip_bytes": 1233+ },+ {+ "path": "assets/dist-CDyCHLYj.js",+ "bytes": 3647,+ "gzip_bytes": 1623+ },+ {+ "path": "assets/docsLinks-xcEiS2b-.js",+ "bytes": 361,+ "gzip_bytes": 192+ },+ {+ "path": "assets/downloadBlob-DzNlCt_E.js",+ "bytes": 384,+ "gzip_bytes": 276+ },+ {+ "path": "assets/dropdown-menu-DR95iY5T.js",+ "bytes": 20837,+ "gzip_bytes": 6160+ },+ {+ "path": "assets/ds-D9j8MO1I.js",+ "bytes": 44492,+ "gzip_bytes": 14462+ },+ {+ "path": "assets/en-Bo0tKDxj.js",+ "bytes": 298916,+ "gzip_bytes": 100788+ },+ {+ "path": "assets/engineHelpers-C4Oij3xe.js",+ "bytes": 2719,+ "gzip_bytes": 1354+ },+ {+ "path": "assets/es-XJqtqF-U.js",+ "bytes": 339857,+ "gzip_bytes": 111055+ },+ {+ "path": "assets/expiry-CenJDggT.js",+ "bytes": 566,+ "gzip_bytes": 366+ },+ {+ "path": "assets/fleetMetrics-DwDMpmOp.js",+ "bytes": 226,+ "gzip_bytes": 184+ },+ {+ "path": "assets/formatBytes-hXxZgKZa.js",+ "bytes": 537,+ "gzip_bytes": 385+ },+ {+ "path": "assets/fr-B3wJvclY.js",+ "bytes": 354826,+ "gzip_bytes": 115299+ },+ {+ "path": "assets/grid-DeT-2Rw7.js",+ "bytes": 39447,+ "gzip_bytes": 11750+ },+ {+ "path": "assets/id-B0jBKWcn.js",+ "bytes": 317606,+ "gzip_bytes": 106301+ },+ {+ "path": "assets/index-CVanDihf.css",+ "bytes": 974501,+ "gzip_bytes": 138204+ },+ {+ "path": "assets/index-EBJ5Gl3z.js",+ "bytes": 261895,+ "gzip_bytes": 70767+ },+ {+ "path": "assets/input-Bv21FA6l.js",+ "bytes": 290,+ "gzip_bytes": 222+ },+ {+ "path": "assets/intl-CYUOvOJ7.js",+ "bytes": 3788,+ "gzip_bytes": 1391+ },+ {+ "path": "assets/it-cbe2smqs.js",+ "bytes": 336985,+ "gzip_bytes": 111563+ },+ {+ "path": "assets/ko-cbntekXb.js",+ "bytes": 352061,+ "gzip_bytes": 113937+ },+ {+ "path": "assets/label-oL-uqm3Y.js",+ "bytes": 966,+ "gzip_bytes": 583+ },+ {+ "path": "assets/monitorShared-DVkEym-a.js",+ "bytes": 2004,+ "gzip_bytes": 657+ },+ {+ "path": "assets/pl-IIic_FFF.js",+ "bytes": 340721,+ "gzip_bytes": 117822+ },+ {+ "path": "assets/popover-grWqLIUn.js",+ "bytes": 65548,+ "gzip_bytes": 22239+ },+ {+ "path": "assets/pt-Cg2aVclu.js",+ "bytes": 334621,+ "gzip_bytes": 111049+ },+ {+ "path": "assets/recents-FDjDwDOB.js",+ "bytes": 908,+ "gzip_bytes": 462+ },+ {+ "path": "assets/redirectAfterLogin-CPIFFUZ-.js",+ "bytes": 915,+ "gzip_bytes": 524+ },+ {+ "path": "assets/reducedMotion-0K54bujL.js",+ "bytes": 191,+ "gzip_bytes": 146+ },+ {+ "path": "assets/rolldown-runtime-QTnfLwEv.js",+ "bytes": 694,+ "gzip_bytes": 422+ },+ {+ "path": "assets/ru-BiYZQRSY.js",+ "bytes": 487932,+ "gzip_bytes": 135557+ },+ {+ "path": "assets/sanitizeSvg-CXkzvfQS.js",+ "bytes": 1168,+ "gzip_bytes": 656+ },+ {+ "path": "assets/sdk-96DUmOoT.css",+ "bytes": 20337,+ "gzip_bytes": 4151+ },+ {+ "path": "assets/sdk-BEMkzTit.js",+ "bytes": 158165,+ "gzip_bytes": 42507+ },+ {+ "path": "assets/select--cDlodis.js",+ "bytes": 21203,+ "gzip_bytes": 7215+ },+ {+ "path": "assets/si-CWfS2ftP.js",+ "bytes": 34706,+ "gzip_bytes": 14957+ },+ {+ "path": "assets/sidebarItems-BQHByGBH.js",+ "bytes": 9738,+ "gzip_bytes": 2847+ },+ {+ "path": "assets/socket-DQzBk5Bx.js",+ "bytes": 44588,+ "gzip_bytes": 13691+ },+ {+ "path": "assets/status-BxnZ9AU0.js",+ "bytes": 2499,+ "gzip_bytes": 991+ },+ {+ "path": "assets/switch-CdYeyLle.js",+ "bytes": 2206,+ "gzip_bytes": 1135+ },+ {+ "path": "assets/tabs-C3UHtSwH.js",+ "bytes": 4682,+ "gzip_bytes": 2008+ },+ {+ "path": "assets/textarea-Dhv2X_qv.js",+ "bytes": 285,+ "gzip_bytes": 217+ },+ {+ "path": "assets/th-DHsDkRJN.js",+ "bytes": 578831,+ "gzip_bytes": 128442+ },+ {+ "path": "assets/time-CUKTAUl6.js",+ "bytes": 155,+ "gzip_bytes": 127+ },+ {+ "path": "assets/tr-Cgpafv9G.js",+ "bytes": 339275,+ "gzip_bytes": 113917+ },+ {+ "path": "assets/useAuth-DvhpMS6C.js",+ "bytes": 277,+ "gzip_bytes": 220+ },+ {+ "path": "assets/useClipboard-DVlBSA7W.js",+ "bytes": 579,+ "gzip_bytes": 389+ },+ {+ "path": "assets/useConfirm-COuqNMAk.js",+ "bytes": 986,+ "gzip_bytes": 475+ },+ {+ "path": "assets/useDeployJobStream-D1vDRLvz.js",+ "bytes": 460,+ "gzip_bytes": 335+ },+ {+ "path": "assets/useDevMode-Dq_QB4CY.js",+ "bytes": 29017,+ "gzip_bytes": 8669+ },+ {+ "path": "assets/useFocusParam-CreB-V8z.js",+ "bytes": 486,+ "gzip_bytes": 330+ },+ {+ "path": "assets/useForm-C2D0nl4x.js",+ "bytes": 3562,+ "gzip_bytes": 1350+ },+ {+ "path": "assets/useLockBodyScroll-gg82pj_N.js",+ "bytes": 352,+ "gzip_bytes": 247+ },+ {+ "path": "assets/useNotifications-Dg5pvKZV.js",+ "bytes": 203,+ "gzip_bytes": 171+ },+ {+ "path": "assets/usePolling-lF1Jduua.js",+ "bytes": 1518,+ "gzip_bytes": 762+ },+ {+ "path": "assets/useResourceTier-UN-1X2SK.js",+ "bytes": 292,+ "gzip_bytes": 225+ },+ {+ "path": "assets/useRunStream-Dh5UfWEc.js",+ "bytes": 2817,+ "gzip_bytes": 1369+ },+ {+ "path": "assets/useServerQuery-CFbs0jQD.js",+ "bytes": 3631,+ "gzip_bytes": 1533+ },+ {+ "path": "assets/useServerStream-CGv3kSRa.js",+ "bytes": 569,+ "gzip_bytes": 351+ },+ {+ "path": "assets/useServerkitAI-CpuE8vn8.js",+ "bytes": 279,+ "gzip_bytes": 224+ },+ {+ "path": "assets/useShortcut-DO6Hv-Zh.js",+ "bytes": 487,+ "gzip_bytes": 329+ },+ {+ "path": "assets/useTabParam-DRBvsDeG.js",+ "bytes": 170,+ "gzip_bytes": 162+ },+ {+ "path": "assets/useTheme-CpQxtsz9.js",+ "bytes": 278,+ "gzip_bytes": 220+ },+ {+ "path": "assets/useToast-CU7WGWSC.js",+ "bytes": 278,+ "gzip_bytes": 219+ },+ {+ "path": "assets/useTopbarActions-ByKBotYf.js",+ "bytes": 571,+ "gzip_bytes": 372+ },+ {+ "path": "assets/useWorkspace-Cj3WMLIv.js",+ "bytes": 286,+ "gzip_bytes": 224+ },+ {+ "path": "assets/utils-Dc1WCZV1.js",+ "bytes": 48525,+ "gzip_bytes": 15746+ },+ {+ "path": "assets/vendor-charts-_7lweA91.js",+ "bytes": 395861,+ "gzip_bytes": 102971+ },+ {+ "path": "assets/vendor-flow-BW6KGJkc.js",+ "bytes": 297879,+ "gzip_bytes": 93822+ },+ {+ "path": "assets/vendor-flow-CHpVij2M.css",+ "bytes": 15395,+ "gzip_bytes": 2518+ },+ {+ "path": "assets/vendor-icons-jUsvj-1n.js",+ "bytes": 55257,+ "gzip_bytes": 16367+ },+ {+ "path": "assets/vendor-react-hujXv21x.js",+ "bytes": 197077,+ "gzip_bytes": 62099+ },+ {+ "path": "assets/vendor-xterm-DK8RooJ5.js",+ "bytes": 291643,+ "gzip_bytes": 68496+ },+ {+ "path": "assets/vendor-xterm-kHJ-D0s7.css",+ "bytes": 2853,+ "gzip_bytes": 770+ },+ {+ "path": "assets/vi-BBWpEAcO.js",+ "bytes": 378809,+ "gzip_bytes": 114517+ },+ {+ "path": "assets/zh-Hans-CHEKgzkQ.js",+ "bytes": 292831,+ "gzip_bytes": 111140+ },+ {+ "path": "assets/zh-Hant-mu8MTZYn.js",+ "bytes": 292985,+ "gzip_bytes": 112962+ },+ {+ "path": "serverkit-vendor/i18next.mjs",+ "bytes": 1020,+ "gzip_bytes": 469+ },+ {+ "path": "serverkit-vendor/react-dom-client.mjs",+ "bytes": 507,+ "gzip_bytes": 340+ },+ {+ "path": "serverkit-vendor/react-dom.mjs",+ "bytes": 1050,+ "gzip_bytes": 509+ },+ {+ "path": "serverkit-vendor/react-i18next.mjs",+ "bytes": 1427,+ "gzip_bytes": 538+ },+ {+ "path": "serverkit-vendor/react-jsx-runtime.mjs",+ "bytes": 518,+ "gzip_bytes": 340+ },+ {+ "path": "serverkit-vendor/react-router-dom.mjs",+ "bytes": 7498,+ "gzip_bytes": 1593+ },+ {+ "path": "serverkit-vendor/react.mjs",+ "bytes": 1958,+ "gzip_bytes": 702+ },+ {+ "path": "serverkit-vendor/serverkit-sdk.mjs",+ "bytes": 5217,+ "gzip_bytes": 1437+ },+ {+ "path": "sw.js",+ "bytes": 2064,+ "gzip_bytes": 786+ }+ ]+}diff --git a/docs/measurements/repository.json b/docs/measurements/repository.jsonnew file mode 100644index 00000000..52ab20de--- /dev/null+++ b/docs/measurements/repository.json@@ -0,0 +1,20 @@+{+ "schema_version": 1,+ "measured_at_utc": "2026-09-05T18:41:48.234988+00:00",+ "source_revision": "d67e5d07d0c8027d7611048ac74b371db43cd7d1",+ "measured_source_has_uncommitted_changes": false,+ "measured_source_sha256": "4e6556b3e881b20b53caf0e0c9d23956da514d95e0e6ec9a1bf43ffe0546a8b8",+ "scope": "Git-tracked core API Python declarations and root-level bundled app YAML templates; excludes extensions, dependencies and generated/install copies.",+ "python_version": "3.11.7",+ "platform": "Windows",+ "core_route_declarations": 1212,+ "core_blueprint_declarations": 104,+ "explicit_method_route_pairs_excluding_head_options": 1216,+ "route_declarations_with_dynamic_methods": 0,+ "core_api_source_files": 111,+ "bundled_app_templates": 118,+ "backend_tests_clean_collected": 5089,+ "collection_scope": "backend/tests, SERVERKIT_CLEAN_COLLECT=1; collected cases, not passed tests",+ "runtime_memory_bytes": null,+ "container_image_bytes": null+}diff --git a/scripts/test/test_repository_measurements.py b/scripts/test/test_repository_measurements.pynew file mode 100644index 00000000..80aaffc8--- /dev/null+++ b/scripts/test/test_repository_measurements.py@@ -0,0 +1,63 @@+"""Source counters and README snapshots must use explicit, consistent scopes."""++import importlib.util+from pathlib import Path+import unittest+++def load(name, filename):+ spec = importlib.util.spec_from_file_location(name, Path(__file__).parents[1] / filename)+ module = importlib.util.module_from_spec(spec)+ spec.loader.exec_module(module)+ return module+++measure = load('measure_repository', 'measure-repository.py')+readmes = load('readme_measurements', 'update-readme-measurements.py')+++class MeasurementTests(unittest.TestCase):+ def test_counts_declarations_separately_from_methods(self):+ result = measure.source_counts(['''+bp = Blueprint('test', __name__)[email protected]('/a')[email protected]('/b', methods=['GET', 'POST', 'HEAD', 'OPTIONS'])+def handler(): pass[email protected]('/c')+def remove(): pass[email protected]('/d', methods=METHODS)+def dynamic(): pass+'''])+ self.assertEqual(result['core_route_declarations'], 4)+ self.assertEqual(result['core_blueprint_declarations'], 1)+ self.assertEqual(result['explicit_method_route_pairs_excluding_head_options'], 4)+ self.assertEqual(result['route_declarations_with_dynamic_methods'], 1)++ def test_all_languages_render_the_same_snapshot_without_footprint_claims(self):+ source = {'measured_at_utc': '2026-09-05T12:00:00Z', 'core_route_declarations': 1234,+ 'core_blueprint_declarations': 99, 'bundled_app_templates': 118,+ 'backend_tests_clean_collected': 5678}+ build = {'html_linked_code': {'gzip_bytes': 800_000},+ 'all_code': {'gzip_bytes': 3_200_000}}+ blocks = readmes.blocks(source, build)+ self.assertEqual(len(blocks), 4)+ for block in blocks.values():+ self.assertIn('2026-09-05', block)+ self.assertIn('**118**', block)+ self.assertIn('**99**', block)+ self.assertNotIn('180 MB', block)+ self.assertNotIn('501 MB', block)+ self.assertIn('**5,678**', blocks['README.md'])+ self.assertIn('**5.678**', blocks['docs/README.es.md'])+ self.assertIn('**0,80 MB**', blocks['docs/README.pt.md'])+ self.assertIn('**3.20 MB**', blocks['docs/README.zh-CN.md'])++ def test_unknown_test_count_cannot_be_published_as_zero(self):+ with self.assertRaisesRegex(ValueError, 'collect-tests'):+ readmes.blocks({'measured_at_utc': '2026-09-05', 'core_route_declarations': 1,+ 'core_blueprint_declarations': 1, 'bundled_app_templates': 1,+ 'backend_tests_clean_collected': None}, {})+++if __name__ == '__main__':+ unittest.main()diff --git a/scripts/update-readme-measurements.py b/scripts/update-readme-measurements.pynew file mode 100644index 00000000..a7fbfbc5--- /dev/null+++ b/scripts/update-readme-measurements.py@@ -0,0 +1,106 @@+#!/usr/bin/env python3+"""Render all README measurement tables from the same reviewed JSON snapshots.++Run with --write after refreshing docs/measurements/*.json; without it, check+that all four language versions match. This validates documentation agreement,+not whether a stored build was rebuilt from the current checkout.+"""++import argparse+import json+from pathlib import Path+import re++ROOT = Path(__file__).resolve().parents[1]+BEGIN = '<!-- BEGIN GENERATED MEASUREMENTS -->'+END = '<!-- END GENERATED MEASUREMENTS -->'+++def blocks(source, build):+ date = source['measured_at_utc'][:10]+ routes = source['core_route_declarations']+ blueprints = source['core_blueprint_declarations']+ templates = source['bundled_app_templates']+ tests = source['backend_tests_clean_collected']+ if tests is None:+ raise ValueError('Refresh repository.json with --collect-tests before publishing counts')+ linked = build['html_linked_code']['gzip_bytes'] / 1_000_000+ total = build['all_code']['gzip_bytes'] / 1_000_000+ en = [+ f'Snapshot: **{date}**. [Definitions, raw measurements and reproduction commands](docs/METRICS.md).',+ f'| **{routes:,}** core route declarations | in **{blueprints}** blueprint declarations under `backend/app/api`; source inventory, excluding extensions |',+ f'| **{templates}** bundled app templates | root-level app YAML files; database extension templates counted separately |',+ f'| **{tests:,}** backend test cases collected | clean-checkout collection; this is not a claim that every case passed or ran |',+ f'| **{linked:.2f} MB** gzip, HTML-linked JS/CSS | scripts, stylesheets and modulepreloads listed in the production HTML |',+ f'| **{total:.2f} MB** gzip, all built JS/CSS | includes lazy chunks, locale bundles and vendor shims; excludes fonts and images |',+ '| **$0** license cost | MIT-licensed, without subscription or seat fees |',+ 'Gzip values sum separately compressed files at level 9; they are not measured page-load times. RAM usage and image size depend on the build, platform and workload; no universal footprint is claimed.',+ ]+ es = [+ f'Instantánea: **{date}**. [Definiciones, medidas y comandos para reproducirlas](METRICS.md).',+ f'| **{routes:,}** declaraciones de rutas del núcleo | en **{blueprints}** declaraciones de blueprints de `backend/app/api`; inventario del código, sin extensiones |',+ f'| **{templates}** plantillas de apps incluidas | archivos YAML de apps en el directorio raíz; las plantillas de extensiones de bases de datos se cuentan aparte |',+ f'| **{tests:,}** casos de prueba de backend recopilados | recopilación de un checkout limpio; no significa que todos se hayan ejecutado o aprobado |',+ f'| **{linked:.2f} MB** gzip de JS/CSS enlazado por el HTML | scripts, estilos y precargas de módulos del HTML de producción |',+ f'| **{total:.2f} MB** gzip de todo el JS/CSS generado | incluye módulos diferidos, idiomas y adaptadores de dependencias; excluye fuentes e imágenes |',+ '| **$0** de licencia | Licencia MIT, sin suscripciones ni tarifas por usuario |',+ 'Los valores gzip suman archivos comprimidos por separado a nivel 9; no son tiempos de carga medidos. La RAM y el tamaño de imagen dependen de la compilación, plataforma y carga de trabajo.',+ ]+ pt = [+ f'Registro: **{date}**. [Definições, medições e comandos de reprodução](METRICS.md).',+ f'| **{routes:,}** declarações de rotas do núcleo | em **{blueprints}** declarações de blueprints em `backend/app/api`; inventário do código, sem extensões |',+ f'| **{templates}** templates de apps incluídos | arquivos YAML de apps no diretório raiz; templates de extensões de banco são contados separadamente |',+ f'| **{tests:,}** casos de teste de backend coletados | coleta de um checkout limpo; não significa que todos executaram ou passaram |',+ f'| **{linked:.2f} MB** gzip de JS/CSS vinculado pelo HTML | scripts, estilos e pré-carregamentos de módulos no HTML de produção |',+ f'| **{total:.2f} MB** gzip de todo o JS/CSS gerado | inclui módulos sob demanda, idiomas e adaptadores de dependências; exclui fontes e imagens |',+ '| **$0** de licença | Licença MIT, sem assinaturas ou taxas por usuário |',+ 'Os valores gzip somam arquivos comprimidos separadamente no nível 9; não são tempos de carregamento medidos. A RAM e o tamanho da imagem dependem da compilação, plataforma e carga de trabalho.',+ ]+ zh = [+ f'测量快照:**{date}**。[定义、原始测量结果和复现命令](METRICS.md)。',+ f'| **{routes:,}** 个核心路由声明 | 来自 `backend/app/api` 中 **{blueprints}** 个蓝图声明;这是源码清单,不包括扩展 |',+ f'| **{templates}** 个内置应用模板 | 模板目录根层级的应用 YAML 文件;数据库扩展模板另计 |',+ f'| **{tests:,}** 个已收集的后端测试用例 | 基于干净检出的测试收集结果;不代表所有用例均已运行或通过 |',+ f'| **{linked:.2f} MB** gzip 的 HTML 直接引用 JS/CSS | 生产 HTML 中的脚本、样式表和模块预加载资源 |',+ f'| **{total:.2f} MB** gzip 的全部构建 JS/CSS | 包括按需模块、语言包和依赖适配文件;不含字体和图片 |',+ '| **$0** 许可费用 | MIT 许可证,无订阅或席位费用 |',+ 'gzip 数值为各文件分别按级别 9 压缩后的总和,并非实测页面加载时间。内存占用与镜像大小取决于构建、平台和工作负载,不作通用占用保证。',+ ]+ result = {}+ for path, rows in [('README.md', en), ('docs/README.es.md', es), ('docs/README.pt.md', pt), ('docs/README.zh-CN.md', zh)]:+ if path.endswith(('.es.md', '.pt.md')):+ for old, new in [(f'{routes:,}', f'{routes:,}'.replace(',', '.')),+ (f'{tests:,}', f'{tests:,}'.replace(',', '.')),+ (f'{linked:.2f} MB', f'{linked:.2f} MB'.replace('.', ',')),+ (f'{total:.2f} MB', f'{total:.2f} MB'.replace('.', ','))]:+ rows = [row.replace(old, new) for row in rows]+ result[path] = '\n'.join([BEGIN, rows[0], '', '| | |', '|---|---|', *rows[1:-1], '', rows[-1], END])+ return result+++def update(write=False):+ source = json.loads((ROOT / 'docs/measurements/repository.json').read_text(encoding='utf-8'))+ build = json.loads((ROOT / 'docs/measurements/frontend-build.json').read_text(encoding='utf-8'))+ stale = []+ for path, block in blocks(source, build).items():+ file = ROOT / path+ original = file.read_text(encoding='utf-8')+ if BEGIN in original:+ result = re.sub(re.escape(BEGIN) + r'.*?' + re.escape(END), lambda _match: block, original, flags=re.S)+ else:+ result, count = re.subn(r'(^## 📊[^\n]*\n\n).*?(\n---\n)', lambda match: match[1] + block + '\n' + match[2], original, count=1, flags=re.S | re.M)+ if count != 1:+ raise ValueError(f'{path}: cannot find the measurements section')+ if result != original:+ stale.append(path)+ if write:+ file.write_text(result, encoding='utf-8')+ if stale and not write:+ raise SystemExit('README measurements are stale: ' + ', '.join(stale))+ print(('Updated' if write else 'Checked') + ' all four README measurement tables.')+++if __name__ == '__main__':+ parser = argparse.ArgumentParser(description=__doc__)+ parser.add_argument('--write', action='store_true')+ update(parser.parse_args().write)