docs: generate an HTTP API listing for the hub and the node control API

docs/MESHBAY_HTTP_API.md lists every route of the hub (by domain, with the
authentication each requires) and of the node's loopback control API. It is
written by docs/generate_http_api.py from the routes and their docstrings;
test_http_api_doc.py fails when the file drifts from the code or when a
route has no docstring, so a new route must say what it does.

79 routes had no docstring and get a one-line description; a few whose first
line did not describe the route get a summary line.

The login page's developer docs gain an API link next to Design and
Protocol, in every language. README, MESHBAY_DESIGN.md (§0.1, §6.7, §7) and
CLAUDE.md point to the listing; README also points to examples/.

The examples scripts with a shebang become executable.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

11 files changed, 12 insertions, 1 deletions

diff --git a/packages/meshbay-hub/src/meshbay_hub/static/auth-page.js b/packages/meshbay-hub/src/meshbay_hub/static/auth-page.js
index cb95816..c12db72 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/auth-page.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/auth-page.js
@@ -276,7 +276,8 @@ const WELCOME_DOCS = [
     ['welcome.docs_userguide', `${REPO}docs/USERGUIDE.md`]]],
   ['gear', 'welcome.docs_devel', [
     ['welcome.docs_design', `${REPO}docs/MESHBAY_DESIGN.md`],
-    ['welcome.docs_protocol', `${REPO}docs/MESHBAY_NODE_PROTOCOL.md`]]],
+    ['welcome.docs_protocol', `${REPO}docs/MESHBAY_NODE_PROTOCOL.md`],
+    ['welcome.docs_api', `${REPO}docs/MESHBAY_HTTP_API.md`]]],
 ];
 
 // Under the sign-in form rather than at the foot of the text: on a desktop the
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/de.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/de.js
index bb54c0d..0221c9a 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/de.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/de.js
@@ -123,6 +123,7 @@ export default {
   'welcome.docs_devel': 'Entwicklerdoku',
   'welcome.docs_design': 'Architektur',
   'welcome.docs_protocol': 'Protokoll',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Herunterladen (Beta)',
   'welcome.legal': 'Rechtliche Hinweise',
   'register.err_mismatch': 'Die Passwörter stimmen nicht überein',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/en.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/en.js
index 1bed529..4ee28cd 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/en.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/en.js
@@ -126,6 +126,7 @@ export default {
   'welcome.docs_devel': 'Developer docs',
   'welcome.docs_design': 'Design',
   'welcome.docs_protocol': 'Protocol',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Download (beta)',
   'welcome.legal': 'Legal information',
   'register.err_mismatch': 'Passwords do not match',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/es.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/es.js
index 936d8b6..f9f1497 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/es.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/es.js
@@ -122,6 +122,7 @@ export default {
   'welcome.docs_devel': 'Docs de desarrollo',
   'welcome.docs_design': 'Diseño',
   'welcome.docs_protocol': 'Protocolo',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Descargar (beta)',
   'welcome.legal': 'Información legal',
   'register.err_mismatch': 'Las contraseñas no coinciden',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/fr.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/fr.js
index 811db8d..6561ace 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/fr.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/fr.js
@@ -122,6 +122,7 @@ export default {
   'welcome.docs_devel': 'Docs développeur',
   'welcome.docs_design': 'Conception',
   'welcome.docs_protocol': 'Protocole',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Télécharger (bêta)',
   'welcome.legal': 'Informations légales',
   'register.err_mismatch': 'Les mots de passe ne correspondent pas',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/it.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/it.js
index 63bff86..052d02f 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/it.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/it.js
@@ -123,6 +123,7 @@ export default {
   'welcome.docs_devel': 'Documentazione tecnica',
   'welcome.docs_design': 'Architettura',
   'welcome.docs_protocol': 'Protocollo',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Scarica (beta)',
   'welcome.legal': 'Note legali',
   'register.err_mismatch': 'Le password non coincidono',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/ja.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/ja.js
index d9677c7..0c91c56 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/ja.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/ja.js
@@ -123,6 +123,7 @@ export default {
   'welcome.docs_devel': '開発者向け',
   'welcome.docs_design': '設計',
   'welcome.docs_protocol': 'プロトコル',
+  'welcome.docs_api': 'API',
   'welcome.download': 'ダウンロード（ベータ版）',
   'welcome.legal': '法的情報',
   'register.err_mismatch': 'パスワードが一致しません',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/nl.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/nl.js
index 2ddb872..cccb3cb 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/nl.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/nl.js
@@ -123,6 +123,7 @@ export default {
   'welcome.docs_devel': 'Ontwikkelaarsdocs',
   'welcome.docs_design': 'Ontwerp',
   'welcome.docs_protocol': 'Protocol',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Downloaden (bèta)',
   'welcome.legal': 'Juridische informatie',
   'register.err_mismatch': 'De wachtwoorden komen niet overeen',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/pl.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/pl.js
index 504dcd9..9937af6 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/pl.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/pl.js
@@ -126,6 +126,7 @@ export default {
   'welcome.docs_devel': 'Dla programistów',
   'welcome.docs_design': 'Architektura',
   'welcome.docs_protocol': 'Protokół',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Pobierz (beta)',
   'welcome.legal': 'Informacje prawne',
   'register.err_mismatch': 'Hasła nie są zgodne',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/pt-BR.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/pt-BR.js
index df1c140..0f6b331 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/pt-BR.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/pt-BR.js
@@ -124,6 +124,7 @@ export default {
   'welcome.docs_devel': 'Docs de desenvolvimento',
   'welcome.docs_design': 'Arquitetura',
   'welcome.docs_protocol': 'Protocolo',
+  'welcome.docs_api': 'API',
   'welcome.download': 'Baixar (beta)',
   'welcome.legal': 'Informações legais',
   'register.err_mismatch': 'As senhas não coincidem',
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/locales/zh-CN.js b/packages/meshbay-hub/src/meshbay_hub/static/locales/zh-CN.js
index 8e72359..ebefc71 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/locales/zh-CN.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/locales/zh-CN.js
@@ -123,6 +123,7 @@ export default {
   'welcome.docs_devel': '开发文档',
   'welcome.docs_design': '设计',
   'welcome.docs_protocol': '协议',
+  'welcome.docs_api': 'API',
   'welcome.download': '下载（测试版）',
   'welcome.legal': '法律信息',
   'register.err_mismatch': '两次输入的密码不一致',