#12688: docs: add troubleshooting guide for thinking.signature error
docs
stale
Cluster:
Node and macOS Enhancements
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
Adds a new troubleshooting doc (`docs/debug/thinking-signature-error.md`) explaining the `thinking.signature: Field required` failure mode and how to recover (delete or manually edit the corrupted session `.jsonl`) when external AI messages are written into the session history.
<h3>Confidence Score: 4/5</h3>
- This PR is safe to merge after correcting a misleading field name in the troubleshooting instructions.
- The change is documentation-only and limited in scope, but the current manual-edit recovery steps reference a different key (`thoughtSignature`) than the actual error path (`thinking.signature`), which would directly prevent users from following the fix.
- docs/debug/thinking-signature-error.md
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
**Context used:**
- Context from `dashboard` - CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=fd949e91-5c3a-4ab5-90a1-cbe184fd6ce8))
- Context from `dashboard` - AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=0d0c8278-ef8e-4d6c-ab21-f5527e322f13))
<!-- /greptile_comment -->
Most Similar PRs
#7083: 说明文档
by 1213718318 · 2026-02-02
77.1%
#14871: Claude/audit codebase architecture 8a ql2
by MagnoliaLex · 2026-02-12
76.5%
#7487: docs: add code review for recent security commits (b796f6e..411d5fd)
by INTEGRITY2077 · 2026-02-02
76.1%
#13833: Cursor/cloud agent 1770777372587 3zom0
by zhch158 · 2026-02-11
76.0%
#7701: Update README.md
by stephenchen2025 · 2026-02-03
75.9%
#15746: docs(nodes): add exec cwd validation errors to troubleshooting
by andrewdamelio · 2026-02-13
75.9%
#13819: docs: fix FAQ heading punctuation
by eliaseffects · 2026-02-11
75.2%
#18792: docs: add macOS source-run troubleshooting for setup/auth issues
by yash27-lab · 2026-02-17
75.0%
#10894: Docs: fix legacy branding, add config reference, expand cron troubl...
by biv0711 · 2026-02-07
74.8%
#15852: fix: pass agentId when resolving IRC session paths
by MisterGuy420 · 2026-02-14
74.2%