CodeSampleX

Sample

commander 10.0.1: Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the string into numeric indices as in Commander 10.0.0

Verified sample for npm commander 10.0.1: Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the…

sha256:997e08319af13c6ed363d7ec20d7adfe1887d84969fab414a089a8f815cf9f19

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment node linux x64 node node npm

Verification-run environments

Environment Contract Stages Run
node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-16
node 22 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-18

Case

HOW
Goal
Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the string into numeric indices as in Commander 10.0.0
Packages
Symbols
  • Option.implies
Environment
node
Created
2026-08-16T17:52:05Z

Contract

  1. Option.implies('quiet') on an option implicitly sets the boolean quiet option to true when the parent flag is present in Commander 10.0.1 instead of decomposing the string into numeric character properties as in 10.0.0
  2. opts().quiet is strict equal to true
  3. opts() does not contain string index keys ('0', '1', etc.)
  4. omitting the triggering option leaves implied options undefined
  5. direct --quiet flag sets quiet option independently

Files

  • NOTES.md
  • csx.json
  • package-lock.json
  • package.json
  • src/index.mjs
  • test/contract.mjs

Download the source artifact (tar.gz)

Source

NOTES.md
# Notes

- **Search answer:** `search_known_solution` returned existing sample `sha256:5c6d27a5983a0c5c7ab82d8867250554602d63b07860b3cdacd2dcd58f498252` ("Pass a string option name to Option.implies() to imply boolean options without string key decomposition").
- **How the wrong version fails:** In Commander 10.0.0, passing a string option name to `.implies('quiet')` fails silently with a green build in loose assertions because `Object.assign` treats the string as an array-like object (`{ '0': 'q', '1': 'u', '2': 'i', '3': 'e', '4': 't' }`), leaving `opts.quiet` undefined and polluting `opts` with numeric string index keys.
csx.json
{"case":{"believed":"Passing a string option name to Option.implies() sets that option to true when the triggering option is parsed.","caseId":"case:sha256:dd859b17c9ecd9511d5daccf4846a5c9aba87919ca8d75cf30bd86b39e3ddf6a","contract":["Option.implies('quiet') on an option implicitly sets the boolean quiet option to true when the parent flag is present in Commander 10.0.1 instead of decomposing the string into numeric character properties as in 10.0.0","opts().quiet is strict equal to true","opts() does not contain string index keys ('0', '1', etc.)","omitting the triggering option leaves implied options undefined","direct --quiet flag sets quiet option independently"],"goal":"Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the string into numeric indices as in Commander 10.0.0","kind":"HOW","packages":["pkg:npm/commander@10.0.1"],"schemaVersion":1,"symbols":["Option.implies"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","ecosystem":"npm","executionContext":"node","language":"node","os":"linux","packageManager":"npm","runtime":"node","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/commander@10.0.1"],"schemaVersion":1,"symbols":["Option.implies"],"verifierAdapter":"node-typescript@1"}
package-lock.json
{
  "name": "csx-sample-commander-implies-fix",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "csx-sample-commander-implies-fix",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "commander": "10.0.1"
      }
    },
    "node_modules/commander": {
      "version": "10.0.1",
      "resolved": "https://registry.npmjs.org/commander/-/commander-10.0.1.tgz",
      "integrity": "sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug==",
      "license": "MIT",
      "engines": {
        "node": ">=14"
      }
    }
  }
}
package.json
{
  "name": "csx-sample-commander-implies-fix",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "commander": "10.0.1"
  }
}
src/index.mjs
import { Command, Option } from 'commander';

/**
 * Parses CLI arguments for a command with implied option relationships.
 *
 * In Commander 10.0.0, passing a string option name to `.implies('quiet')`
 * decomposed the string as an object into `{ '0': 'q', '1': 'u', ... }` and left
 * `opts.quiet` undefined. Commander 10.0.1 (patch release fixing PR #1854)
 * handles string arguments directly as `{ quiet: true }`.
 *
 * @param {string[]} argv - CLI flags/arguments passed by user
 * @returns {Record<string, any>} Parsed options object
 */
export function parseOptions(argv) {
  const program = new Command();
  program
    .name('demo')
    .addOption(new Option('-s, --silent', 'suppress output').implies('quiet'))
    .option('-q, --quiet', 'quiet mode')
    .exitOverride();

  program.parse(argv, { from: 'user' });
  return program.opts();
}
test/contract.mjs
import { strict as assert } from 'node:assert';
import { parseOptions } from '../src/index.mjs';

// 1. Asserting string option name to Option.implies() sets target boolean option to true in Commander 10.0.1
const silentOpts = parseOptions(['--silent']);
assert.equal(silentOpts.silent, true);
assert.equal(silentOpts.quiet, true);

// 2. Asserting options dictionary is not polluted with decomposed numeric index keys ('0', '1', etc.)
assert.equal(silentOpts['0'], undefined);
assert.equal(silentOpts['1'], undefined);
assert.deepEqual(silentOpts, { silent: true, quiet: true });

// 3. Asserting target options remain undefined when triggering flag is omitted
const defaultOpts = parseOptions([]);
assert.equal(defaultOpts.silent, undefined);
assert.equal(defaultOpts.quiet, undefined);
assert.deepEqual(defaultOpts, {});

// 4. Asserting direct target flag still functions independently
const quietOpts = parseOptions(['--quiet']);
assert.equal(quietOpts.silent, undefined);
assert.equal(quietOpts.quiet, true);
assert.deepEqual(quietOpts, { quiet: true });

console.log('CONTRACT PASS: Option.implies() string argument implies boolean option in Commander 10.0.1 without string key decomposition');

Origin Seeder

csx-seed