build(deps): upgrade workspace to TypeScript 6 (#5167)

Author: rschlaefli

.agents/skills/klicker-data-model/SKILL.md

@@ -18,6 +18,8 @@ pnpm run build               # 4. regenerate Prisma client + dependent packages
 
 Then, if the change is API-visible: update Pothos types/resolvers (`klicker-graphql-api`) — the Pothos Prisma plugin picks up new fields, but object types expose them explicitly.
 
+Run Prisma client generation only through `pnpm --filter @klicker-uzh/prisma generate` (or a build that calls it). The package script owns the TypeScript 6 generated-namespace patch; direct `prisma generate` bypasses it. The package's canonical `check` includes the patch invariant tests. If generation fails at the patch, run `pnpm --filter @klicker-uzh/prisma test:patch-namespace` and inspect the new generated declarations instead of weakening the exact-cardinality guard.
+
 Provenance: steps 2 requires a database; on a machine without one running, write the schema change and STOP — hand the migration step to the user rather than faking a migration file.
 
 ## Rules that prevent real incidents

.agents/skills/klicker-testing-verification/SKILL.md

@@ -18,7 +18,7 @@ Facts about the test landscape: [docs/testing.md](../../../docs/testing.md). Thi
 
 Never run root `pnpm run test:run` blind — its turbo fan-out includes Cypress, which needs a running seeded stack.
 
-Direct checks for `auth`, `chat`, `frontend-control`, `frontend-manage`, and `frontend-pwa` generate ignored Next route types first through each app's `check` script. Do not hand-edit or commit `next-env.d.ts`; keep it ignored and included by `tsconfig.json`. The three PWA apps use `tsconfig.check.json` to exclude `.next/dev/types` from raw `tsc`; otherwise stale dev and fresh production Pages Router validators duplicate global declarations.
+Direct checks for `auth`, `chat`, `frontend-control`, `frontend-manage`, and `frontend-pwa` generate ignored Next route types first through each app's `check` script. Do not hand-edit or commit `next-env.d.ts`; keep it ignored and included by `tsconfig.json`. The three PWA apps use `tsconfig.check.json` only for raw package checks so stale `.next/dev/types` cannot duplicate fresh Pages Router validators. Next builds use the canonical `tsconfig.json`; Next 16 filters development validators on its production typecheck path. Auth and Chat use their main config for both checks and builds.
 
 For Next framework or bundler changes, verify both repository-supported paths. `pnpm run build:test` uses Turbopack in all five Next apps. `pnpm run build` uses Turbopack for auth/chat and Webpack for control/manage/PWA until their service-worker integration moves to Serwist. Confirm standalone server paths for all five apps and `sw.js`, Workbox, and custom worker outputs for the three PWA apps.
 
@@ -36,12 +36,14 @@ CI runs Cypress (8-way split) and Playwright (8-way shard) on almost every code
 
 Every item, in order; paste evidence (command + tail of output, screenshots) into the PR or task report:
 
-1. `pnpm run check:all` — typecheck + format + lint + syncpack (same as pre-commit hook).
+1. `pnpm run check:all` — typecheck + format + lint + syncpack + AGENTS.md validation + Prisma-sync validation (same as pre-commit hook). The Prisma package check regenerates its client before typechecking, so it is safe from a clean checkout.
 2. `pnpm run build` — same as pre-push hook; also refreshes generated artifacts.
 3. Targeted tests per the routing table above — quote failures exactly; never delete/weaken a test to pass.
 4. **Codegen artifacts committed** if any `.graphql` op or schema changed (`git status` must be clean after `pnpm --filter @klicker-uzh/graphql generate`).
 5. **i18n pair check** if UI text changed: the key exists in BOTH `packages/i18n/messages/de.ts` and `en.ts`.
-6. **Browser evidence for UI changes** — open the changed pages with `npx agent-browser` (never bare `agent-browser`), log in with delegated/test credentials (AGENTS.md), capture before/after screenshots. "The logic looks correct" does not count.
+6. **Browser evidence for UI changes** — open the changed pages with `npx agent-browser@0.32.2` (never bare `agent-browser`), log in with delegated/test credentials (AGENTS.md), capture before/after screenshots. "The logic looks correct" does not count.
+
+For TypeScript or other compiler/toolchain upgrades, root `check:all` includes the Cypress and Playwright compilers through their package `check` scripts. Also run `pnpm run build:test` and the Docs production build; those surfaces remain outside the root check. Use direct package `tsc --noEmit -p tsconfig.json` commands only to isolate a Cypress or Playwright failure. When a check config extends a declaration-emitting config, verify the resolved compiler options: `noEmit` does not disable declaration portability analysis, so the check may also need explicit `declaration: false` and `declarationMap: false`. Incremental checks must use a different `tsBuildInfoFile` from the emitting build.
 
 ## Reporting
 

.syncpackrc.mjs

@@ -55,6 +55,13 @@ export default {
       packages: ['@klicker-uzh/office-addin'],
       isIgnored: true,
     },
+    {
+      // Office Add-in compiler/tooling is owned by a separate upgrade PR.
+      label: 'Office Add-in TypeScript can differ from the workspace',
+      dependencies: ['typescript'],
+      packages: ['@klicker-uzh/office-addin'],
+      isIgnored: true,
+    },
     {
       // FIXME: update when consistent versions are possible (e.g., do other remark updates in apps)
       label: 'remark-math can be inconsistent between docs and apps',

apps/auth/package.json

@@ -47,7 +47,7 @@
     "tailwindcss": "~4.1.11",
     "tailwindcss-animate": "~1.0.7",
     "tw-animate-css": "~1.3.4",
-    "typescript": "~5.6.3"
+    "typescript": "~6.0.3"
   },
   "scripts": {
     "build": "next build --turbopack",

apps/auth/tsconfig.json

@@ -21,7 +21,6 @@
     "jsx": "react-jsx",
     "isolatedModules": true,
     // Path Mapping
-    "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"]
     },

apps/backend-docker/package.json

@@ -66,7 +66,7 @@
     "rollup": "~4.34.9",
     "source-map-support": "~0.5.21",
     "tsx": "~4.19.4",
-    "typescript": "~5.6.3"
+    "typescript": "~6.0.3"
   },
   "scripts": {
     "build": "cross-env NODE_ENV=production run-s --npm-path pnpm build:ts",

apps/backend-docker/tsconfig.check.json

@@ -1,5 +1,9 @@
 {
   "extends": "./tsconfig.json",
   "include": ["./src/**/*", "./scripts/**/*"],
-  "exclude": ["./instrumented/**/*"]
+  "exclude": ["./instrumented/**/*"],
+  "compilerOptions": {
+    "noEmit": true,
+    "tsBuildInfoFile": "dist/tsconfig.check.tsbuildinfo"
+  }
 }

apps/backend-docker/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "include": ["./src/**/*", "./scripts/**/*", "./instrumented/**/*"],
   "compilerOptions": {
-    "baseUrl": ".",
     /* Base Options: */
     "esModuleInterop": true,
     "skipLibCheck": true,
@@ -19,6 +18,7 @@
     "module": "NodeNext",
     "outDir": "dist",
     "sourceMap": true,
+    "incremental": true,
     "tsBuildInfoFile": "dist/tsconfig.tsbuildinfo",
     /* If your code doesn't run in the DOM: */
     "lib": ["es2022"]

apps/chat/package.json

@@ -66,7 +66,7 @@
     "eslint": "~9.30.1",
     "eslint-config-next": "~16.2.10",
     "tailwindcss": "~4.1.11",
-    "typescript": "~5.6.3",
+    "typescript": "~6.0.3",
     "vitest": "~3.2.4"
   },
   "scripts": {

apps/chat/src/app/RuntimeProvider.tsx

@@ -1,19 +1,19 @@
 'use client'
 
+import { useChatResponse } from '@/src/hooks/useChatResponse'
+import { useThreadManagement } from '@/src/hooks/useThreadManagement'
+import {
+  useChatStore,
+  type ExtendedThreadMessageLike,
+} from '@/src/stores/chatStore'
+import { useSettingsStore } from '@/src/stores/settingsStore'
 import {
   AssistantRuntimeProvider,
   useExternalStoreRuntime,
   type ThreadMessageLike,
 } from '@assistant-ui/react'
 import { useParams, useRouter, useSearchParams } from 'next/navigation'
 import { useCallback, useEffect, useRef, useState } from 'react'
-import { useChatResponse } from 'src/hooks/useChatResponse'
-import { useThreadManagement } from 'src/hooks/useThreadManagement'
-import {
-  useChatStore,
-  type ExtendedThreadMessageLike,
-} from 'src/stores/chatStore'
-import { useSettingsStore } from 'src/stores/settingsStore'
 import { useChatUi } from '../components/chat-ui-context'
 import { imageAttachmentAdapter } from '../lib/attachments/imageAttachmentAdapter'