release: promote develop → main (machine-sizing + Mintlify rebuild + page-coverage CI)#57
Merged
Conversation
…gate (#54) The installer now hard-fails below ~5 GB RAM on Linux (was warn-only), so the old "it only warns" line was wrong. State minimum-to-run (2 CPU / 5 GB / 10 GB) vs recommended-to-train (4 CPU / 16 GB / 50 GB) consistently across quickstart, deploy-local, and the setup guide. A single training job reserves ~8 GB. Pairs with tracebloc/client#217 · refs tracebloc/backend#744 Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Mintlify dev preview at tracebloc-develop.mintlify.app was returning 404 on every page that wasn't part of a recent incremental build. Confirmed by curl: the 3 paths touched by #54 returned 200, all others 404. Adding a trailing newline to all 31 .mdx files marks them as changed in git so Mintlify's incremental builder treats every page as needing update, restoring full dev preview coverage. No content change — just file-mtime/hash bump. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
) Catches the failure mode that bit us on 2026-06-06: Mintlify's incremental build pipeline silently left the dev preview at tracebloc-develop.mintlify.app serving 404s on most pages for days. Mintlify's own deploy check reported "success" every time — only an end-to-end HTTP probe of each declared page would have detected the gap. The new workflow: - Parses docs.json to extract every page path referenced in navigation - GETs each path on dev preview and prod docs site (parallel matrix) - Fails the job if any page returns non-200 - Reports broken paths in the workflow summary with the likely fix (touch all .mdx files to force Mintlify full rebuild) Triggers: - schedule: 06:00 UTC daily (catches Mintlify state drift) - push to develop / main (catches build regressions immediately, with a 120s wait for Mintlify deploy to complete) - workflow_dispatch with env=dev|prod|both for manual reruns Reference: docs PR #55 (the force-rebuild fix that surfaced this gap). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3 tasks
Contributor
Author
|
👋 Heads-up — Code review queue is at 13 / 8 Above the WIP limit. The team convention is to review existing PRs before opening new work. Open PRs currently in Code review (oldest first):
Pull from review before opening new work. (This is a nudge from the kanban WIP check, not a block.) |
…6-04) docs was exempted from the FR-gate on 2026-06-04 (content-only, low-risk, may promote develop to main directly). The caller workflow was never removed, so it kept firing "fail" on every develop to main release PR. It is not a required status check and the exemption is intentional. Removing the caller stops the spurious red X on docs release PRs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Promote
develop → mainfor the docs site. Ships 3 changes to production (docs.tracebloc.io).What's included (3 commits)
docs(environment-setup): reconcile machine sizing with the preflight gate— aligns the documented RAM/CPU minimums with what the installer's hard gate actually enforces.chore(docs): touch all .mdx files to force Mintlify full rebuild— fixes the dev-preview 404s caused by Mintlify's incremental builder dropping un-touched pages.ci(docs): nightly + on-push probe for page coverage on dev and prod— new CI that GETs every page declared in docs.json against both dev preview and prod, fails if any 404s. Prevents the silent page-outage that chore(docs): touch all .mdx files to force Mintlify full rebuild #55 fixed from recurring.Why merge to main
Per CLAUDE.md, docs is exempt from the develop-only rule (content-only, low-risk) — docs PRs may promote to
maindirectly at Lukas's request. The content has been reviewable on the dev preview (tracebloc-develop.mintlify.app, now rendering all pages after #55).Review
Dev preview reflects exactly this state: https://tracebloc-develop.mintlify.app/overview/tracebloc
Test plan
🤖 Generated with Claude Code