#15746: docs(nodes): add exec cwd validation errors to troubleshooting
docs
stale
size: XS
Cluster:
Node and macOS Enhancements
Add two new error codes to the troubleshooting guide:
- `Exec cwd does not exist: <path>` — cwd doesn't exist on the node
- `Exec cwd is not a directory: <path>` — cwd is a file, not a dir
These errors were introduced in #15454 (node-host cwd validation). Previously, an invalid cwd would silently fall back to $HOME, which could cause confusing behavior. The new errors give clear guidance on what went wrong and how to fix it.
Includes zh-CN translation.
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
Updates the node troubleshooting docs to document two new `nodes.run` exec working-directory validation errors (`cwd` missing on node, or `cwd` points to a file).
The English doc change is straightforward and fits the existing "Common node error codes" section. However, the PR also manually edits `docs/zh-CN/nodes/troubleshooting.md`, which is treated as generated content in this repo; that should be produced via the docs i18n pipeline (English source → glossary/TM tweaks if needed → `scripts/docs-i18n`) to avoid drift/being overwritten.
<h3>Confidence Score: 4/5</h3>
- Mostly safe to merge, but fix the docs i18n workflow issue first.
- The English doc update is low-risk and consistent. The only blocking issue found is that the PR directly edits `docs/zh-CN/**`, which the repo treats as generated output; that will drift or be overwritten unless the change is made through the translation pipeline.
- docs/zh-CN/nodes/troubleshooting.md
<sub>Last reviewed commit: 67d1da5</sub>
<!-- greptile_other_comments_section -->
<sub>(5/5) You can turn off certain types of comments like style [here](https://app.greptile.com/review/github)!</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
#10894: Docs: fix legacy branding, add config reference, expand cron troubl...
by biv0711 · 2026-02-07
78.0%
#18792: docs: add macOS source-run troubleshooting for setup/auth issues
by yash27-lab · 2026-02-17
76.4%
#20843: docs: add troubleshooting for A2UI bundling and missing node_modules
by yahiag04 · 2026-02-19
76.2%
#7083: 说明文档
by 1213718318 · 2026-02-02
76.1%
#15852: fix: pass agentId when resolving IRC session paths
by MisterGuy420 · 2026-02-14
76.0%
#12688: docs: add troubleshooting guide for thinking.signature error
by abhishekabhi779 · 2026-02-09
75.9%
#7252: docs: align config examples and tool docs with current runtime
by nice-and-precise · 2026-02-02
75.5%
#22632: docs: fix redirects and small reorg
by gianpaj · 2026-02-21
74.9%
#11951: Prepending Windows Node to PATH didn’t help
by tranhoangtu-it · 2026-02-08
74.5%
#11048: fix: address repository issues (env, author, CI comments, security ...
by cavula · 2026-02-07
74.2%