jadpo declines

List or clear declines.

A judgement-call error, such as a helper like a library's, can be declined with a reason: a decline <rule>: "<reason>" line above the declaration it is on. list shows every decline with its rule, place and reason, so each can be reviewed. clear removes the decline lines, so each finding comes back and jadpo check fails until it is fixed or declined again: after a compiler upgrade, a new standard type, or as a periodic sweep. --rule and a path narrow both.

jadpo declines <action> [path]

Arguments

• action: What to do: list or clear
• path (optional): Only the declines in this file or folder

Flags

• --rule <id>: Only the declines of this rule

On every command

• --json: Print data for tools instead of text
• --help: Show every flag, with examples
• --color <when>: Choose when to use colour

jadpo declines --json writes one JSON document to standard output instead of text, with the same exit code. The document has schemaVersion, command ("declines"), ok, data (what the command produced, null when it failed) and diagnostics (each error with its rule, reason, next and help). A command that needs a terminal refuses --json and names the flags that do the same job.

Examples

# See every decline and its reasonjadpo declines list# Decide again every similar-helper declinejadpo declines clear --rule library.similar_exists# List the declines in shared/ as data for toolsjadpo declines list shared --json

Errors

• cli.declines_arguments: Declines command has invalid arguments
• toolchain.artifact_write_failed: Generated file could not be written
• toolchain.project_not_found: Project could not be found