Generate and deploy all M2O docs from the public repository

[Segfaultd]

Summary

• make this public repository the only owner of guide composition, complete Server and Client reference generation, branding, local preview, and standalone deployment
• download contracts from the public Services endpoint, optionally pin immutable revisions, verify every file size and SHA-256 digest, and reject unsafe or incomplete manifests/configuration
• replace the separate Astro approximation with one production generator for both pnpm dev and CI, including live rebuilds
• deploy on docs main changes or explicit maintainer workflow runs; the Mod never triggers this repository

Contributor outcome

A contributor only clones this repository and runs pnpm install followed by pnpm dev. The preview is the complete production site; no Mod checkout, game installation, token, or private source is required.

Validation

• node syntax and workflow YAML checks
• pnpm install --frozen-lockfile
• full pnpm build using a locally generated authoritative contract
• verified dist contains Server API, Client API, guides, and contract provenance
• manually verified the full local preview and live rebuild path

Dependency and setup

Depends on MafiaHub/services#13 being merged/deployed, @mafiahub/services-cli 0.6.3 being published, and an M2O contract being available on the selected public channel.

Before merging, configure repository variables M2O_SERVICES_API_URL=https://api.mafiahub.dev and M2O_SERVICES_MOD_ID=a54dd3fe-7d33-4efb-9dd0-736665fa8f5f, plus secret M2O_DOCS_UPLOAD_TOKEN. After this workflow is active, the old site deployment token can be removed from the closed Mod repository.

[Segfaultd]

Current check failure is the expected contract 404. The merged Mod publication run failed because production Services still expects the abandoned dedicated token; the token-reuse follow-up missed the already-merged Services PR. Fix: MafiaHub/services#14. After #14 is deployed, rerun the Mod contract publication and then this check.