@@ -4,6 +4,8 @@ The `changes` job runs Turborepo 2.9.14's `affectedTasks` query before installin
 
 A PR compares its merge base with the checked-out merge commit. Main/staging pushes execute all checks; the parent `ci` workflow skips checks on `dev` pushes, while PRs targeting `dev` still run checks. A manual `checks` run executes all checks unless supplied a full base commit SHA to reproduce a scoped plan. Missing history, an empty diff, unknown files outside the workspace graph, root script/CI changes, or a planner error run every check. Missing selection outputs fail the aggregate gate. The gate also rejects an omitted dependency, any failed/cancelled job, and any skip that its explicit selection flag did not authorize.
 
+Dedicated docs verification uses the same planner, comparing pushes with their previous commit and PRs with their merge base. Site acceptance follows `docs#build` and its transitive package dependencies. The app's docs-consumer task depends on server runtime and that docs build: backend-only changes run the platform consumer against the docs app, while site changes also run corpus and browser checks. Independent SDK and unit-only edits skip those production jobs. The required `docs HTTP` gate verifies explicit site/platform selections before accepting any skip.
+
 | Change | Expensive checks selected |
 | --- | --- |
 | Independent SDK | That workspace's tests and type-check; no app build, services, or browsers |
@@ -38,6 +40,8 @@ Desktop inbox protocol, assistant actions UI, and organization search UI run as
 
 Live Electron acceptance tracks its live-app suite, fixtures, and Playwright configuration separately from shell-only smoke tests. Changing a shell-only smoke case runs the dedicated desktop workflow without starting the app's production build and live lease checks.
 
+Desktop smoke weights also stay outside the desktop runtime task. Editing weights reruns desktop partition coverage without selecting live-app acceptance.
+
 Browser extension acceptance runs native interaction and access-revalidation groups in parallel jobs with isolated databases, apps, browser profiles, and reports. Both retain the same task boundary, so an affected extension harness selects both groups. Native streaming and first-open capture checks retain real timers. Access checks install Playwright's clock before the app mounts: advancing production polling timers preserves real HTTP and database authorization checks without waiting through each polling interval. Capture timestamps originate in Chromium's isolated world, so the harness restores wall time after each advance. The local `browser-extension` group still runs the complete suite; live-provider runs require this complete mode and retain native timing throughout.
 
 Integration shard weights come from successful reports for both push and migration provisioning paths. Refresh them with `scripts/update-integration-durations.ts`, then check the new partition against a separate complete run before adopting it. Weights only change scheduling; discovery still owns coverage. The current refresh uses runs [41348786822](https://github.com/simstudioai/sim/actions/runs/41348786822) and [41377145857](https://github.com/simstudioai/sim/actions/runs/41377145857), with [41377810718](https://github.com/simstudioai/sim/actions/runs/41377810718) held out for validation.
 
@@ -4,6 +4,7 @@ query($base: String!, $head: String!) {
     "test", "build", "type-check", "ci:integration", "ci:desktop-live",
     "ci:e2e-scim", "ci:e2e-cli", "ci:e2e-stop-after", "ci:e2e-desktop-inbox",
     "ci:e2e-assistant-actions", "ci:e2e-organization-search",
+    "ci:e2e-docs-platform",
     "ci:e2e-browser-extension", "ci:e2e-project-files", "ci:e2e-mobile", "ci:e2e-seo"
   ]) {
     items {
 
@@ -25,7 +25,10 @@ jobs:
           GH_REPO: ${{ github.repository }}
           PR_NUMBER: ${{ github.event.pull_request.number }}
         run: |
-          if [ "$(gh pr view "$PR_NUMBER" --json state --jq .state)" = OPEN ]; then
-            exit 0
-          fi
+          state=$(gh pr view "$PR_NUMBER" --json state --jq .state)
+          case "$state" in
+            OPEN) exit 0 ;;
+            CLOSED|MERGED) ;;
+            *) echo "::error::Unexpected pull request state: $state"; exit 1 ;;
+          esac
           gh cache delete --all --ref "refs/pull/${PR_NUMBER}/merge" --succeed-on-no-caches
@@ -1,6 +1,9 @@
 {
   "extends": ["//"],
   "tasks": {
+    "ci:runtime": {
+      "inputs": ["$TURBO_EXTENDS$", "!e2e-durations.json"]
+    },
     "build": {
       "inputs": [
         "$TURBO_DEFAULT$",
 
@@ -53,6 +53,7 @@
     "ci:e2e-desktop-inbox": "bash ../../.github/scripts/http-e2e.sh desktop-inbox",
     "ci:e2e-assistant-actions": "bash ../../.github/scripts/http-e2e.sh assistant-actions",
     "ci:e2e-organization-search": "bash ../../.github/scripts/http-e2e.sh organization-search",
+    "ci:e2e-docs-platform": "bun --no-env-file scripts/test-docs-search-provider-e2e.ts",
     "ci:e2e-project-files": "bash ../../.github/scripts/http-e2e.sh project-files",
     "ci:e2e-mobile": "bash ../../.github/scripts/http-e2e.sh mobile",
     "ci:e2e-seo": "bash ../../.github/scripts/http-e2e.sh seo",
 
@@ -27,6 +27,7 @@
         "!scripts/test-desktop-inbox-e2e.ts",
         "!scripts/test-assistant-actions-e2e.ts",
         "!scripts/test-organization-search-e2e.ts",
+        "!scripts/test-docs-search-provider-e2e.ts",
         "!scripts/test-file-*-e2e.ts",
         "!scripts/test-landing-seo-e2e.ts",
         "!scripts/test-mcp-host-e2e.ts",
@@ -133,6 +134,11 @@
       "inputs": ["scripts/test-organization-search-e2e.ts"],
       "cache": false
     },
+    "ci:e2e-docs-platform": {
+      "dependsOn": ["ci:server", "docs#build"],
+      "inputs": ["scripts/test-docs-search-provider-e2e.ts"],
+      "cache": false
+    },
     "ci:e2e-project-files": {
       "dependsOn": ["ci:server", "@sim/realtime#ci:runtime"],
       "inputs": ["scripts/test-project-file*-e2e.ts", "scripts/test-file-*-e2e.ts"],
@@ -165,6 +171,7 @@
         "!scripts/test-desktop-inbox-e2e.ts",
         "!scripts/test-assistant-actions-e2e.ts",
         "!scripts/test-organization-search-e2e.ts",
+        "!scripts/test-docs-search-provider-e2e.ts",
         "!scripts/test-file-*-e2e.ts",
         "!scripts/test-landing-seo-e2e.ts",
         "!scripts/test-mcp-host-e2e.ts",
 
@@ -15,6 +15,7 @@ interface Plan {
   production: { group: string }[]
   typecheckPackages: string[]
   testPackages: string[]
+  docsGroups: string[]
 }
 function git(cwd: string, ...args: string[]) {
   const result = spawnSync('git', args, { cwd, encoding: 'utf8' })
@@ -48,12 +49,18 @@ function fixture() {
     ['apps/realtime', '@sim/realtime', { '@sim/auth': 'workspace:*' }],
     ['apps/desktop', '@sim/desktop', {}],
     ['apps/extension', '@sim/extension', {}],
-    ['apps/docs', 'docs', {}],
+    ['apps/docs', 'docs', { '@sim/workflow-renderer': 'workspace:*' }],
     ['packages/auth', '@sim/auth', { '@sim/security': 'workspace:*' }],
     ['packages/security', '@sim/security', {}],
     ['packages/db', '@sim/db', {}],
     ['packages/ts-sdk', 'simstudio-ts-sdk', {}],
     ['packages/sim-cli', 'sim', {}],
+    [
+      'packages/workflow-renderer',
+      '@sim/workflow-renderer',
+      { '@sim/workflow-types': 'workspace:*' },
+    ],
+    ['packages/workflow-types', '@sim/workflow-types', {}],
   ] as const
   const appScripts = JSON.parse(
     readFileSync(resolve(root, 'apps/sim/package.json'), 'utf8')
@@ -84,6 +91,7 @@ function fixture() {
   for (const file of [
     'turbo.json',
     'apps/sim/turbo.json',
+    'apps/desktop/turbo.json',
     '.github/ci-suites.json',
     '.github/scripts/ci-plan.gql',
   ]) {
@@ -138,6 +146,7 @@ describe('CI task attribution through real Turborepo', () => {
       build: false,
       desktop_live: false,
       e2e_build: false,
+      docs: false,
     })
   })
   it('selects integration and browser checks for workspace code shared with desktop execution', () => {
@@ -190,9 +199,53 @@ describe('CI task attribution through real Turborepo', () => {
       build: false,
       integration: false,
       desktop_live: false,
+      docs: true,
     })
     expect(plan.testPackages).toEqual(['docs'])
   })
+  it('selects docs acceptance for a transitive rendering dependency', () => {
+    const plan = classifyFiles(['packages/workflow-types/src/index.ts'])
+    expect(plan.fallback).toBeUndefined()
+    expect(plan.flags.docs).toBe(true)
+    expect(plan.docsGroups).toEqual(['http', 'corpus', 'chromium', 'webkit'])
+  })
+  it('keeps docs unit-only edits out of production acceptance', () => {
+    const plan = classifyFiles(['apps/docs/lib/content/links.test.ts'])
+    expect(plan.fallback).toBeUndefined()
+    expect(plan.flags.docs).toBe(false)
+    expect(plan.testPackages).toEqual(['docs'])
+  })
+  it('selects docs acceptance for its standalone browser harness', () => {
+    const plan = classifyFiles(['apps/docs/scripts/test-navigation-e2e.ts'])
+    expect(plan.fallback).toBeUndefined()
+    expect(plan.flags.docs).toBe(true)
+  })
+  it('selects only the platform docs boundary for a consumer harness change', () => {
+    const plan = classifyFiles(['apps/sim/scripts/test-docs-search-provider-e2e.ts'])
+    expect(plan.fallback).toBeUndefined()
+    expect(groups(plan)).toEqual([])
+    expect(plan.docsGroups).toEqual(['platform'])
+    expect(plan.flags).toMatchObject({
+      docs: true,
+      docs_site: false,
+      docs_platform: true,
+      test_app: false,
+      e2e_build: false,
+      integration: false,
+      desktop_live: false,
+    })
+  })
+  it('selects platform docs for backend changes without site browser checks', () => {
+    const plan = classifyFiles(['apps/sim/lib/mothership/docs/search.ts'])
+    expect(plan.fallback).toBeUndefined()
+    expect(plan.flags).toMatchObject({ docs: true, docs_site: false, docs_platform: true })
+    expect(plan.docsGroups).toEqual(['platform'])
+  })
+  it('keeps desktop smoke weights out of live runtime attribution', () => {
+    const plan = classifyFiles(['apps/desktop/e2e-durations.json'])
+    expect(plan.fallback).toBeUndefined()
+    expect(plan.flags).toMatchObject({ desktop_live: false, e2e_build: false })
+  })
   it('does not build or run E2E for an app unit-test-only edit', () => {
     const plan = classifyFiles(['apps/sim/lib/auth/session.test.ts'])
     expect(plan.fallback).toBeUndefined()
 
@@ -98,6 +98,13 @@ const http = suites.http.filter((suite) => affected(suite.task))
 const production = suites.production.filter((suite) => affected(suite.task))
 const desktopLive = affected('ci:desktop-live')
 const appTest = affected('test')
+const docsSite = fallback !== undefined || selected.has('docs#build')
+const docsPlatform = affected('ci:e2e-docs-platform')
+const docsGroups = docsSite
+  ? ['http', 'corpus', 'chromium', 'webkit']
+  : docsPlatform
+    ? ['platform']
+    : []
 function taskPackages(name: string, omitApp = false): string[] {
   return fallback
     ? ['*']
@@ -112,6 +119,9 @@ function taskPackages(name: string, omitApp = false): string[] {
 const packages = taskPackages('test', true)
 const typecheckPackages = taskPackages('type-check')
 const flags = {
+  docs: docsSite || docsPlatform,
+  docs_site: docsSite,
+  docs_platform: docsPlatform,
   integration: affected('ci:integration'),
   http: http.length > 0,
   production: production.length > 0,
@@ -128,6 +138,7 @@ const outputs = {
   test_matrix: JSON.stringify({ shard: appTest ? [1, 2] : [1] }),
   test_packages: JSON.stringify(packages),
   typecheck_packages: JSON.stringify(typecheckPackages),
+  docs_matrix: JSON.stringify({ include: docsGroups.map((group) => ({ group })) }),
 }
 const report = {
   base,
@@ -140,6 +151,7 @@ const report = {
   production,
   testPackages: packages,
   typecheckPackages,
+  docsGroups,
 }
 if (process.env.CI_PLAN_PATH)
   writeFileSync(process.env.CI_PLAN_PATH, `${JSON.stringify(report, null, 2)}\n`)