Fix broken internal docs links

[mintlify]

Summary

mint broken-links reported 20 broken links across 6 docs files. Mintlify resolves page links by absolute path without file extensions, so relative .md links and references to files outside docs/ were not resolving. This PR converts all broken internal links to Mintlify-style absolute paths and updates external-repo references to GitHub URLs.

After the fix, both mint validate and mint broken-links pass with no errors.

Broken links found and fixes applied

docs/admin-control-plane.md

• [security-governance.md](security-governance.md) → [security-governance](/docs/security-governance)

docs/deployment.md

• [admin-control-plane.md](admin-control-plane.md) → [admin-control-plane](/docs/admin-control-plane)
• [security-governance.md](security-governance.md) → [security-governance](/docs/security-governance)
• [runtime-conformance.md](runtime-conformance.md) → [runtime-conformance](/docs/runtime-conformance)

docs/production-readiness.md

• [public-support-matrix.md](public-support-matrix.md) → [public-support-matrix](/docs/public-support-matrix)
• [worker-rpc-contract.md](worker-rpc-contract.md) → [worker-rpc-contract](/docs/worker-rpc-contract)

docs/public-support-matrix.md

• [releasing.md](releasing.md) → [releasing](/docs/releasing)
• [deployment.md](deployment.md) → [deployment](/docs/deployment)
• [deployment.md#upgrade-rehearsal-and-rollback](deployment.md#upgrade-rehearsal-and-rollback) → [deployment#upgrades](/docs/deployment#upgrades) — no #upgrade-rehearsal-and-rollback heading exists in deployment.md; the closest existing section is ## Upgrades (line 157), so the anchor was pointed there.
• [runtime-certification.md](runtime-certification.md) → [runtime-certification](/docs/runtime-certification)
• [runtime-conformance.md](runtime-conformance.md) → [runtime-conformance](/docs/runtime-conformance)
• [security-governance.md](security-governance.md) → [security-governance](/docs/security-governance)
• [deployment.md#support-bundles](deployment.md#support-bundles) → [deployment#support-bundles](/docs/deployment#support-bundles)

docs/rest-api.md

• [swagger.yaml](swagger.yaml) and [swagger.json](swagger.json) → GitHub raw paths under StacyOS/stacyvm/blob/main/docs/. These spec files live in docs/ but are not Mintlify pages, so they cannot be linked as internal docs.
• [admin-control-plane.md](admin-control-plane.md) → [admin-control-plane](/docs/admin-control-plane)
• [`web/src/`](../web/src/) → https://github.com/StacyOS/stacyvm/tree/main/web/src — the web/ directory is outside docs/ and cannot be linked as a doc page.
• [Python](../sdk/python/README.md) → [Python](/docs/sdks/python)
• [TypeScript](../sdk/js/README.md) → [TypeScript](/docs/sdks/typescript)

docs/worker-rpc-contract.md

• [cluster-conformance.md](cluster-conformance.md) → [cluster-conformance](/docs/cluster-conformance)

Notes

• The #upgrade-rehearsal-and-rollback anchor on public-support-matrix.md did not exist in deployment.md. I used the existing #upgrades section as the closest semantic replacement; if a dedicated rehearsal/rollback section is intended, please add it to deployment.md and update this anchor.
• SDK README links now point to the published SDK pages (/docs/sdks/python, /docs/sdks/typescript).
• mint validate still emits unrelated parsing warnings about images/evm/frontend/AGENTS.md and a tsconfig snippet; those are outside the scope of this link-fix task.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
stacy	🟢 Ready	View Preview	May 11, 2026, 9:20 AM