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.

Comienza con la ruta de análisis de comandos que invoca shell-quote; después, inspecciona las ubicaciones de parse.js en el stack trace y el manejo de errores de promise circundante. Identifica una entrada que desencadene el fallo de sustitución y verifica que el comando se ejecute o produzca un error de validación claro y gestionado, en lugar de un rechazo no gestionado.