improvement(ci): job timeouts everywhere, docs-only PR skip, event-scoped sticky disks, Node pin; drop dead i18n workflow

- timeout-minutes on every runnable job (defaults ran hung jobs to the
  6-hour cap — the i18n workflow burned three full 6-hour runs in Feb
  before its schedule was pulled)
- paths-ignore on the pull_request trigger: docs content and markdown
  don't affect the app build or images; push runs stay unfiltered
- sticky-disk keys scoped by event name so fork PR runs never share a
  disk with the push runs that feed production image builds
- node-version pinned to 22 (was 'latest', non-deterministic)
- delete i18n.yml: schedule already removed after repeated 6-hour hangs,
  workflow_dispatch-only since, comments stale

Author: waleedlatif1

.github/workflows/ci.yml

@@ -5,6 +5,11 @@ on:
     branches: [main, staging, dev]
   pull_request:
     branches: [main, staging, dev]
+    # Docs content and markdown don't affect the app build or images; push
+    # runs stay unfiltered because they feed the deploy pipeline.
+    paths-ignore:
+      - 'apps/docs/content/**'
+      - '**/*.md'
 
 concurrency:
   group: ci-${{ github.ref }}
@@ -24,6 +29,7 @@ jobs:
   detect-version:
     name: Detect Version
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 5
     if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/staging' || github.ref == 'refs/heads/dev')
     outputs:
       version: ${{ steps.extract.outputs.version }}
@@ -76,6 +82,7 @@ jobs:
     needs: [detect-version, migrate-dev]
     if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
     runs-on: blacksmith-8vcpu-ubuntu-2404
+    timeout-minutes: 30
     permissions:
       contents: read
       id-token: write
@@ -139,6 +146,7 @@ jobs:
     needs: [migrate-dev]
     if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
     steps:
       - name: Checkout code
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
@@ -185,6 +193,7 @@ jobs:
       github.event_name == 'push' &&
       (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/staging')
     runs-on: blacksmith-8vcpu-ubuntu-2404
+    timeout-minutes: 30
     permissions:
       contents: read
       packages: write
@@ -284,6 +293,7 @@ jobs:
       github.event_name == 'push' &&
       (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/staging')
     runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 10
     permissions:
       contents: read
       id-token: write
@@ -351,6 +361,7 @@ jobs:
   build-ghcr-arm64:
     name: Build ARM64 (GHCR Only)
     runs-on: blacksmith-8vcpu-ubuntu-2404-arm
+    timeout-minutes: 30
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     permissions:
       contents: read
@@ -399,6 +410,7 @@ jobs:
   create-ghcr-manifests:
     name: Create GHCR Manifests
     runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 10
     needs: [promote-images, build-ghcr-arm64, detect-version]
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     permissions:
@@ -462,6 +474,7 @@ jobs:
   check-docs-changes:
     name: Check Docs Changes
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 5
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     outputs:
       docs_changed: ${{ steps.filter.outputs.docs }}
@@ -490,6 +503,7 @@ jobs:
   create-release:
     name: Create GitHub Release
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 10
     needs: [create-ghcr-manifests, detect-version]
     if: needs.detect-version.outputs.is_release == 'true'
     permissions:

.github/workflows/companion-pr-check.yml

@@ -30,6 +30,7 @@ permissions:
 jobs:
   companion:
     runs-on: ubuntu-latest
+    timeout-minutes: 5
     steps:
       - uses: actions/github-script@f28e40c7f34bde8b3046d885e986cb6290c5673b # v7
         env:

.github/workflows/docs-embeddings.yml

@@ -11,6 +11,7 @@ jobs:
   process-docs-embeddings:
     name: Process Documentation Embeddings
     runs-on: blacksmith-8vcpu-ubuntu-2404
+    timeout-minutes: 30
     if: github.ref == 'refs/heads/main'
 
     steps:
@@ -25,7 +26,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: latest
+          node-version: 22
 
       - name: Cache Bun dependencies
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5

.github/workflows/i18n.yml

@@ -25,6 +25,7 @@ jobs:
   migrate:
     name: Apply Database Migrations
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
 
     steps:
       - name: Checkout code

.github/workflows/migrations.yml

@@ -12,6 +12,7 @@ permissions:
 jobs:
   publish-npm:
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
     steps:
       - name: Checkout repository
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6

.github/workflows/publish-cli.yml

@@ -12,6 +12,7 @@ permissions:
 jobs:
   publish-pypi:
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
     steps:
       - name: Checkout repository
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6

.github/workflows/publish-python-sdk.yml

@@ -12,6 +12,7 @@ permissions:
 jobs:
   publish-npm:
     runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
     steps:
       - name: Checkout repository
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6

.github/workflows/publish-ts-sdk.yml

@@ -11,6 +11,7 @@ jobs:
   test-build:
     name: Lint and Test
     runs-on: blacksmith-8vcpu-ubuntu-2404
+    timeout-minutes: 15
 
     steps:
       - name: Checkout code
@@ -24,24 +25,28 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: latest
+          node-version: 22
 
+      # Sticky-disk keys are scoped by event name so pull_request runs (which
+      # include fork PRs on this public repo) never share a disk with push
+      # runs — the push disks feed builds that end up in production images,
+      # and a shared disk would let a fork PR poison them.
       - name: Mount Bun cache (Sticky Disk)
         uses: useblacksmith/stickydisk@4c034ba57b706cf0e3b4b0ce098c2a3b1071580c # v1
         with:
-          key: ${{ github.repository }}-bun-cache
+          key: ${{ github.repository }}-bun-cache-${{ github.event_name }}
           path: ~/.bun/install/cache
 
       - name: Mount node_modules (Sticky Disk)
         uses: useblacksmith/stickydisk@4c034ba57b706cf0e3b4b0ce098c2a3b1071580c # v1
         with:
-          key: ${{ github.repository }}-node-modules
+          key: ${{ github.repository }}-node-modules-${{ github.event_name }}
           path: ./node_modules
 
       - name: Mount Turbo cache (Sticky Disk)
         uses: useblacksmith/stickydisk@4c034ba57b706cf0e3b4b0ce098c2a3b1071580c # v1
         with:
-          key: ${{ github.repository }}-turbo-cache
+          key: ${{ github.repository }}-turbo-cache-${{ github.event_name }}
           path: ./.turbo
 
       - name: Install dependencies
@@ -184,6 +189,7 @@ jobs:
   build:
     name: Build App
     runs-on: blacksmith-8vcpu-ubuntu-2404
+    timeout-minutes: 15
 
     steps:
       - name: Checkout code
@@ -197,24 +203,24 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: latest
+          node-version: 22
 
       - name: Mount Bun cache (Sticky Disk)
         uses: useblacksmith/stickydisk@4c034ba57b706cf0e3b4b0ce098c2a3b1071580c # v1
         with:
-          key: ${{ github.repository }}-bun-cache
+          key: ${{ github.repository }}-bun-cache-${{ github.event_name }}
           path: ~/.bun/install/cache
 
       - name: Mount node_modules (Sticky Disk)
         uses: useblacksmith/stickydisk@4c034ba57b706cf0e3b4b0ce098c2a3b1071580c # v1
         with:
-          key: ${{ github.repository }}-node-modules
+          key: ${{ github.repository }}-node-modules-${{ github.event_name }}
           path: ./node_modules
 
       - name: Mount Turbo cache (Sticky Disk)
         uses: useblacksmith/stickydisk@4c034ba57b706cf0e3b4b0ce098c2a3b1071580c # v1
         with:
-          key: ${{ github.repository }}-turbo-cache-build
+          key: ${{ github.repository }}-turbo-cache-build-${{ github.event_name }}
           path: ./.turbo
 
       - name: Restore Next.js build cache