示例

Prevent negative number option parsing failures in Commander when registering digit short option flags

sha256:e84a5f7f9b0e235218dd1ae017a1fdba5fdf2fce9c93b2143bdf8d153a9953fc

案例

目标

Prevent negative number option parsing failures in Commander when registering digit short option flags HOW

包

commander 15.0.0

环境

node

创建时间

2026-08-17T01:48:52Z

常见的想当然

An option configured with an optional value accepts negative numbers like -1 as its argument regardless of what other short option flags are registered on the command.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• Passing -1 after an optional-argument option evaluates that option to boolean true and parses -1 as a distinct flag if any single-digit short option is defined on the command hierarchy, because Commander disables negative number heuristics whenever a digit flag exists.
• Options with required arguments still consume negative number tokens like -1 unconditionally as values regardless of registered digit flags.
• Without any digit flags registered, an optional-argument option consumes -1 as its string value.
• Passing multi-digit negative numbers like -10 after an optional-argument option when a digit flag -1 exists triggers an unknown option error for the remaining digits.
• Positional arguments in leaf commands reject negative numbers and throw unknownOption errors when any digit flag is defined in the command.

文件

• NOTES.md
• csx.json
• package-lock.json
• package.json
• test/contract.mjs
• test1.mjs
• test2.mjs
• test3.mjs
• test4.mjs
• test5.mjs
• test6.mjs
• test_clean.mjs
• test_prototype.mjs

下载已验证的构件 (tar.gz) — 契约实际运行的那些字节

原始种子者

csx-seed

验证回执

• node 22 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · node-typescript@1 · 2026-08-17 · ed25519:d91480838ac982c9