cli-tslisted

# TypeScript CLI Engineering Build TypeScript command-line interfaces as stable public APIs. Optimize for predictable automation, packed-artifact correctness, safe releases, and maintainable provider boundaries. ## Scope This skill handles TypeScript CLI architecture, command contracts, package builds, npm distribution, CI/CD, documentation, and agent-facing output. It does not implement product-specific business rules, manage registry accounts, publish without authorization, or redesign an existing module system unless requested. ## Workflow 1. Inspect `package.json`, lockfile, TypeScript config, executable entry, command registration, tests, workflows, docs, and repository instructions. 2. Preserve the current package manager, module format, parser, test runner, and release model unless a measured requirement justifies change. 3. Classify the CLI: - Use Node `util.parseArgs` for one or two flat commands. - Use Commander for nested operational command trees. - Use oclif only when plugins, installers, autoupdate, or large lazy-loaded trees are real requirements. 4. Freeze the public contract before editing: binary names, command paths, flags, defaults, config precedence, stdout, stderr, exit behavior, and version policy. 5. Keep the executable and command handlers thin. Put reusable behavior in core services and isolate each external provider behind its own module. 6. Validate external input at boundaries. Treat SDK types as implementation help, not runtime vali