Skip to content

build(docs): migrate to TypeScript 7 - #373

Open
praetordev wants to merge 2 commits into
mainfrom
codex/docs-typescript-7
Open

build(docs): migrate to TypeScript 7#373
praetordev wants to merge 2 commits into
mainfrom
codex/docs-typescript-7

Conversation

@praetordev

@praetordev praetordev commented Jul 26, 2026

Copy link
Copy Markdown
Collaborator

Closes #316

Scope

  • upgrade the documentation site from TypeScript 6.0.3 to 7.0.2
  • replace Docusaurus 3.10.2’s incompatible published tsconfig with the equivalent TypeScript 7-compatible configuration already merged upstream
  • remove the unused direct @docusaurus/tsconfig dependency
  • document the compatibility decision, configuration-drift risk, and future return to the published config
  • add a change-aware documentation CI gate so docs-site/** changes run only clean install, typecheck, and production build instead of silently skipping documentation validation

Required tests

  • clean npm ci from the final lockfile
  • npm run typecheck with TypeScript 7.0.2
  • npm run build including Docusaurus MDX/link validation
  • Node 22 development-server compilation
  • HTTP 200 route smokes for /, /getting-started, and /concepts/execution-packs
  • focused CI planner and workflow contract tests
  • pinned actionlint
  • complete ./scripts/verify-changed.sh local preflight: Go, UI, docs, database, deployment, product, and gosec gates passed

The documentation package does not define separate lint or unit-test scripts. TypeScript strict checking provides source/static validation, while the Docusaurus production build validates configuration, MDX, generated routes, and links.

Security and RBAC impact

Build-time documentation tooling only. No application runtime, authorization, or RBAC behavior changes. No compiler compatibility suppression is added; the removed baseUrl option and prior ignoreDeprecations setting are eliminated.

Dependencies

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.

Plan the documentation site migration to TypeScript 7

1 participant