Skip to content

B-23: SKILL.md's exit-code "known exceptions" section describes two bugs that are already fixed #286

Description

@gfargo

Severity: medium — it actively instructs agents to distrust correct behaviour.

SKILL.md:957-964 claims two live defects "tracked in #128, open as of this writing" and tells agents to
"treat 1 as generic failure … rather than assuming JSON is always available." Both are fixed:
src/cli/index.ts:172-179 catches CommanderError and exits ExitCode.InvalidUsage; index.ts:129-132 applies
exitOverride() recursively; index.ts:196-199 routes generic errors through the JSON-aware error() helper.

Verified: bogus-command --json{"level":"error","message":"unknown command 'bogus-command'"}, exit 2;
list --bogus --json → JSON on stderr, exit 2; show --json (missing arg) → JSON on stderr, exit 2.

Fix direction: delete the section. Consider closing #128.


Extracted from a repo audit performed 2026-07 (the audit doc it came from was proposed via an unmerged docs PR).

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions