All commands · lifecycle
pm close
Close an item. Close reason requirement follows governance.require_close_reason.
Transitions work to terminal closed state with explicit rationale.
Usage
pm close [options] [command] <id> [text]Arguments
| <id> | Item id | required |
|---|---|---|
| <text> | Close reason text (alias: --reason) | optional |
Options
| --release-assignment | Release ownership after closure | optional |
|---|---|---|
| -r, --reason <value> | Close reason text (alias for positional <text>) | optional |
| --close-reason <value> | Close reason text (alias for positional <text>) | optional |
| --completed-at <value> | Actual completion timestamp (ISO or relative), distinct from tracker close time | optional |
| -d, --duplicate-of <id> | Close as a duplicate of the canonical item id and auto-fill duplicate closure metadata | optional |
| --author <value> | Mutation author | optional |
| -m, --message <value> | History message | optional |
| --validate-close [mode] | Validate closure metadata before close: "off", "warn", or "strict" (default: settings governance preset) | optional |
| --resolution <value> | Closure resolution summary (checked by --validate-close strict) | optional |
| --expected-result <value> | Expected outcome for closure validation | optional |
| --expected <value> | Short alias for --expected-result | optional |
| --actual-result <value> | Observed outcome for closure validation | optional |
| --actual <value> | Short alias for --actual-result | optional |
| --force | Force ownership override | optional |
Examples
pm close pm-a1b2 "Done" --release-assignment --validate-close warn