サンプル

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