Unhandled Promise Rejection: Bad substitution: chunks[1].startOffset

Summary

Command Code crashes with an unhandled promise rejection when parsing a shell command.

Environment:

• OS: Ubuntu Linux
• Node.js: v22.20.0
• Command Code: latest installed version
• Shell: [bash/zsh/etc.]

Error:
CRITICAL: Unhandled Promise Rejection!
This is an unexpected error. Please file a bug report.

ERROR: Error
REASON → Bad substitution: chunks[1].startOffset

Stack trace:
Error: Bad substitution: chunks[1].startOffset
at parseEnvVar (.../command-code/node_modules/shell-quote/parse.js:171:12)
at .../command-code/node_modules/shell-quote/parse.js:256:17
at Array.map ()
at parseInternal (.../command-code/node_modules/shell-quote/parse.js:113:17)
at parse (.../command-code/node_modules/shell-quote/parse.js:309:15)
...

Trace ID:
c58b9fbd1d12acef3534f9db896e4142

The error appears to originate while parsing the shell command/environment
variable substitution through the shell-quote dependency.

Expected Behavior

The command should either execute normally or return a handled/clear
validation error rather than crashing with an unhandled promise rejection.

Actual Behavior

The command should either execute normally.

Steps to reproduce the issue

The issue doesn’t require reproduction.

Command Code Version

1.53.0

Operating System

Linux

Terminal/IDE

Terminal

Shell

bash

Session file (optional)

No response

Fix prompt (optional)

No response

Additional context

This was reproduced on Ubuntu with Node.js v22.20.0.

从调用 shell-quote 的命令解析路径开始，然后检查堆栈跟踪中的 parse.js 位置以及周围的 promise 错误处理。识别一个会触发替换失败的输入，并验证该命令要么能够运行，要么产生一个已处理且清晰的验证错误，而不是未处理的拒绝。