docs: added note about Prisma 7.x for TASK_RUN_STALLED_EXECUTING error

[isshaddad]

No description provided.

[changeset-bot]

⚠️ No Changeset found

Latest commit: f9f8652

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d5a27f0 and 7469eae.

📒 Files selected for processing (1)

• docs/troubleshooting.mdx

📜 Recent review details

🧰 Additional context used

🧠 Learnings (2)

📓 Common learnings

Learnt from: CR
Repo: triggerdotdev/trigger.dev PR: 0
File: .cursor/rules/writing-tasks.mdc:0-0
Timestamp: 2025-11-27T16:27:35.304Z
Learning: Applies to **/trigger/**/*.{ts,tsx,js,jsx} : Attach metadata to task runs using the metadata option when triggering, and access/update it inside runs using metadata functions

Learnt from: CR
Repo: triggerdotdev/trigger.dev PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-02-25T13:54:58.938Z
Learning: Applies to internal-packages/database/prisma/migrations/**/*.sql : PostgreSQL migration files must remove extraneous lines related to `_BackgroundWorkerToBackgroundWorkerFile`, `_BackgroundWorkerToTaskQueue`, `_TaskRunToTaskRunTag`, `_WaitpointRunConnections`, `_completedWaitpoints`, `SecretStore_key_idx`, and unmodified TaskRun indexes

📚 Learning: 2026-02-25T13:54:58.938Z

Learnt from: CR
Repo: triggerdotdev/trigger.dev PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-02-25T13:54:58.938Z
Learning: Applies to internal-packages/database/prisma/migrations/**/*.sql : PostgreSQL migration files must remove extraneous lines related to `_BackgroundWorkerToBackgroundWorkerFile`, `_BackgroundWorkerToTaskQueue`, `_TaskRunToTaskRunTag`, `_WaitpointRunConnections`, `_completedWaitpoints`, `SecretStore_key_idx`, and unmodified TaskRun indexes

Applied to files:

• docs/troubleshooting.mdx

🪛 LanguageTool

docs/troubleshooting.mdx

[style] ~246-~246: As an alternative to the over-used intensifier ‘very’, consider replacing this phrase.
Context: ... the event loop, like nested loops with very large arrays. If you use Prisma 7.x, que...

(EN_WEAK_ADJECTIVE)

🔇 Additional comments (1)

docs/troubleshooting.mdx (1)

248-249: No changes needed. The documentation accurately describes Prisma 7.x behavior: query compilation and caching do run on the main thread (via the WASM query compiler), causing potential event loop blocking, and the caching strategy (LRU cache with query shape normalization) was confirmed in Prisma v7.4.0 released February 11, 2026. The guidance to use heartbeats.yield() remains sound.

---

Walkthrough

The troubleshooting documentation was updated to provide Prisma 7.x-specific guidance on event-loop blocking. Changes include replacing a generic note with expanded instructions explaining that query compilation and caching run on the main thread and can block the event loop, along with a recommendation to use heartbeats.yield() for yielding during heavy or repetitive Prisma operations. A code example demonstrating usage patterns was added, and a note about an alternative approach using worker threads was included.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The pull request description is entirely missing; no content was provided by the author despite the template requiring sections like Testing, Changelog, and a checklist.	Add a complete pull request description following the template, including the issue number, checklist, testing steps, and a changelog entry describing the changes made.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: adding documentation about Prisma 7.x regarding the TASK_RUN_STALLED_EXECUTING error.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch docs/prisma-7.x-caching-issue

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.