Skip to content

docs: align public OpenAPI with corrected MCP API contracts - #126

Merged
acedatacloud-dev merged 2 commits into
mainfrom
codex/mcp-contract-parity-20261101
Nov 1, 2026
Merged

acedatacloud-dev merged 2 commits into
mainfrom
codex/mcp-contract-parity-20261101

Conversation

@acedatacloud-dev

@acedatacloud-dev acedatacloud-dev commented Oct 31, 2026 •

Copy link
Copy Markdown
Member

Regenerate the existing public OpenAPI documents from PlatformBackend 00a635440eea357a9e7add2ae7b734e345d0d605. Eight request schemas had drifted from their source, and the MCP contract audit identified additional source fixes now included here.

Uses the repository's load_services, sync_openapi, merge_openapi_specs and generated-tree validation functions. Output is restricted to the existing public service/path set: 11 files change, covering 22 operations and 13 request-body schemas. No new private operation, navigation entry or translated guide is published.

Validation:

  • Source tree was clean at the pinned revision; 109 input hashes and 35 generated output hashes were recorded and read back.
  • All eight original drift cases are resolved; regenerated OpenAPI tree validation passes.
  • Python compile/unittest: 50 passed; MDX unit tests: 4 passed; syntax/local-link validation: 4,143 pages passed.
  • Full-site validation still reports five unchanged editorial pages with pre-existing artifact URL placeholders. Mint broken-links also reports the unchanged n8n submission template reference. These are baseline diagnostics outside the generated OpenAPI changes.

Companion: https://github.com/AceDataCloud/PlatformBackend/pull/2250. Merge/publish after the backend contract release. Updated source guides in that companion follow the normal DB source-hash and translation-readiness workflow; this PR does not bypass those publication gates. No production sync or deployment was performed.

Related audit fixes:

@acedatacloud-dev
acedatacloud-dev merged commit e126a48 into main Nov 1, 2026
1 check passed
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