Alle Befehle · quality
pm item test
Manage tests linked to an item and optionally run them.
Links test commands/paths and optionally executes them for one item.
Aufruf
pm item test [options] [command] <id>Argumente
| <id> | Item id | erforderlich |
|---|
Optionen
| --add <value> | Add verified isolated test (CSV/markdown or stdin) | optional |
|---|---|---|
| --add-json <value> | Add verified isolated test (JSON object/array or stdin) | optional |
| --remove <value> | Remove exact command/path (command=<value>, path=<value>, or stdin -) | optional |
| --remove-index <n> | Remove 1-based --list position (repeatable) | optional |
| --list | List linked tests without mutating | optional |
| --update <value> | Edit exact command or path=<value> | optional |
| --update-index <n> | Edit current 1-based --list position | optional |
| --set-json <value> | Metadata patch; null clears optional fields | optional |
| --run | Run linked test commands | optional |
| --match <value> | Run matching command/path substring | optional |
| --only-index <n> | Run 1-based --list position | optional |
| --only-last | Run most recently added test | optional |
| --full-history | Return all linked tests after a write | optional |
| --acknowledge-linked-tests | Trust current commands in this clone without execution | optional |
| --background | Run linked tests in managed background mode | optional |
| --timeout <seconds> | Default run timeout in seconds (requires --run) | optional |
| --progress | Emit stderr run progress (requires --run; automatic in TTY) | optional |
| --env-set <value> | Set run environment (KEY=VALUE, repeatable) | optional |
| --env-clear <value> | Clear run environment (NAME, repeatable) | optional |
| --shared-host-safe | Apply additive shared-host-safe run defaults | optional |
| --pm-context <mode> | PM test context: schema|tracker|auto|none (default: schema) | optional |
| --override-linked-pm-context | Override stored context with --pm-context | optional |
| --workspace-context <mode> | Source-workspace mode: source|isolated|snapshot (default: source) | optional |
| --override-linked-workspace-context | Override stored context with --workspace-context | optional |
| --allow-untrusted-linked-tests | Execute untrusted linked commands when project policy also permits it | optional |
| --fail-on-context-mismatch | Fail linked PM commands when context item counts differ | optional |
| --fail-on-skipped | Treat skipped linked tests as dependency failures | optional |
| --fail-on-empty-test-run | Fail successful commands reporting zero executed tests | optional |
| --require-assertions-for-pm | Require assertion metadata for linked PM command tests | optional |
| --check-context | Check PM context before execution | optional |
| --auto-pm-context | Route mismatched PM tracker reads through tracker context | optional |
| --measure <value> | Record name=value[,unit=...][,threshold=...]; requires --run | optional |
| --metric-below <value> | Return evidence below name=value | optional |
| --metric-diff <name> | Diff the latest two values | optional |
| --author <value> | Mutation author | optional |
| --message <value> | History message | optional |
| --force | Force ownership override | optional |
Beispiele
pm item test pm-a1b2 --add "command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,timeout_seconds=2400"