Skip to content

fix(docs): align every @docusaurus package on 3.10.2 so the Pages deploy builds again - #1475

Merged
gHashTag merged 1 commit into
mainfrom
fix/docs-docusaurus-align
Oct 7, 2026
Merged

gHashTag merged 1 commit into
mainfrom
fix/docs-docusaurus-align

Conversation

@gHashTag

@gHashTag gHashTag commented Oct 7, 2026 •

Copy link
Copy Markdown
Owner

Closes #1474

deploy-docs.yml is the only publisher of t27.ai (branch gh-pages). It has failed on every main push since 2026-10-04:

[ERROR] Error: Unable to build website for locale en.
  [cause]: Error: Invalid name=docusaurus-plugin-content-docs version number=3.10.0.

Dependabot (#1268, #1269, #1270) moved @docusaurus/core, theme-live-codeblock and tsconfig to 3.10.2 and left preset-classic, theme-mermaid, types and module-type-aliases on 3.10.0; Docusaurus refuses a mixed install. This PR pins all seven on 3.10.2 (npm install --save-exact); the lockfile shrinks because the duplicate 3.10.0 tree is gone. Last deploy on gh-pages: 840053f (2026-10-04), so nothing merged since has reached t27.ai.

{
  "version": 1,
  "head_sha": "0bdc7cfba2f5297ad727028f01f72d1934234d2b",
  "summary": "Align every @docusaurus package in docs/ on 3.10.2 so deploy-docs.yml builds again and t27.ai stops serving the 2026-10-04 build.",
  "changes": [
    "docs/package.json: preset-classic, theme-mermaid, types and module-type-aliases pinned to 3.10.2, matching core, tsconfig and theme-live-codeblock",
    "docs/package-lock.json: regenerated by npm install; the duplicate 3.10.0 plugin tree is removed"
  ],
  "tests": [
    {
      "command": "cd docs && npm install && npm run build",
      "result": "[SUCCESS] Generated static files in build, zero [ERROR] lines; on origin/main the same build fails with the Invalid version number error",
      "status": "passed",
      "evidence": "local run on 0bdc7cfba, Node 22, build rc 0, log checked for ERROR lines"
    }
  ],
  "limitations": [
    "apps/website is untouched; only the docs half of the Pages job was broken",
    "Dependabot can split the group again; grouping @docusaurus/* in dependabot.yml is a follow-up"
  ],
  "tags": [
    "docs",
    "deploy",
    "pages"
  ],
  "blog": {
    "title": "Why t27.ai stood still for three days",
    "summary": "A half-applied dependency bump left the docs on two Docusaurus versions, the Pages build refused them, and the site stopped updating.",
    "outline": [
      "Three dependabot PRs moved part of the Docusaurus packages to 3.10.2 while four sibling packages stayed on 3.10.0 in the same docs folder.",
      "Docusaurus checks that its plugins share one version, so every main push after 2026-10-04 failed the Pages build before anything was published.",
      "The fix pins all seven packages on 3.10.2; the local build that failed on main now generates the static files without a single error line."
    ]
  }
}

🤖🤖 Generated with Claude Code

…loy builds again

Dependabot bumped core, tsconfig and theme-live-codeblock to 3.10.2 on
2026-10-04 and left preset-classic, theme-mermaid, types and
module-type-aliases on 3.10.0. Docusaurus refuses mixed versions
("Invalid name=docusaurus-plugin-content-docs version number=3.10.0"),
so deploy-docs.yml has failed on every main push since, and t27.ai
still serves the 2026-10-04 build.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions github-actions Bot added the status:in-progress 🔵 Agent working label Oct 7, 2026
@github-actions

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

X Brain Health Check

Score: 100.0/100
Status: 🟢 HEALTHY
Threshold: 80/100

X Brain is above merge threshold

@gHashTag
gHashTag merged commit eea167f into main Oct 7, 2026
38 of 40 checks passed
@github-actions github-actions Bot added status:completed Done and removed status:in-progress 🔵 Agent working labels Oct 7, 2026
github-actions Bot added a commit that referenced this pull request Oct 7, 2026
Merge pull request #1475 from gHashTag/fix/docs-docusaurus-align

fix(docs): align every @Docusaurus package on 3.10.2 so the Pages deploy builds again
@github-actions

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

🧪 Brain Stress Test Results

Tests: 261/261 passed, 0 leaked
Status: 🟢 PASS
Gate: every test in zig build test-brain-stress passes and none leaks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Pages deploy fails since 2026-10-04: mixed @docusaurus versions in docs/

1 participant