Skip to content

chore(server): honest /openapi.json description + shared SERVER_VERSION#57

Merged
federicodeponte merged 1 commit intomainfrom
chore/openapi-description-clean
Apr 18, 2026
Merged

chore(server): honest /openapi.json description + shared SERVER_VERSION#57
federicodeponte merged 1 commit intomainfrom
chore/openapi-description-clean

Conversation

@federicodeponte
Copy link
Copy Markdown
Member

Summary

  • lib/server-version.ts: single SERVER_VERSION from apps/server/package.json (same mechanism as before in health.ts, now shared).
  • routes/health.ts: import SERVER_VERSION instead of duplicating createRequire.
  • index.ts /openapi.json: drop the multi-paragraph changelog disguised as info.description. Replace with a short factual overview (hub, per-app MCP + HTTP run, optional admin POST /mcp, optional routes, rate-limit pointer). info.version uses SERVER_VERSION (no hardcoded semver).
  • Connections paths in the hand-written OpenAPI doc: neutral summaries (remove Composio branding from copy; routes unchanged).

Why

Anyone curling /openapi.json on a self-host or preview was reading a wall of version-marketing noise. That reads like unfinished product, not API documentation.

Test plan

  • pnpm -w typecheck

Made with Cursor

…mmary

- Add lib/server-version.ts (package.json version) and use it in health +
  openapi info.version so they never drift.
- Replace the multi-KB info.description with a short factual overview:
  hub, per-app MCP/HTTP, optional admin POST /mcp, optional routes, rate
  limits pointer to SELF_HOST.
- Neutralize OpenAPI path summaries under /api/connections (no Composio
  brand in user-facing copy; implementation unchanged).

Made-with: Cursor
@federicodeponte federicodeponte merged commit de551c9 into main Apr 18, 2026
2 checks passed
@federicodeponte federicodeponte deleted the chore/openapi-description-clean branch April 18, 2026 02:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant