所有命令 · 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.
用法
pm item test [options] [command] <id>参数
| <id> | Item id | 必填 |
|---|
选项
| --add <value> | Add verified isolated test (CSV/markdown or stdin) | 可选 |
|---|---|---|
| --add-json <value> | Add verified isolated test (JSON object/array or stdin) | 可选 |
| --remove <value> | Remove linked test entry by exact command/path (command=<value> and path=<value> preserve commas and equals signs; or - for stdin) | 可选 |
| --remove-index <n> | Remove the 1-based linked-test index from --list order (repeatable) | 可选 |
| --list | List linked tests without mutating | 可选 |
| --run | Run linked test commands | 可选 |
| --match <value> | Run only linked tests whose command/path contains this substring | 可选 |
| --only-index <n> | Run only the 1-based linked-test index from --list order | 可选 |
| --only-last | Run only the most recently added linked test | 可选 |
| --acknowledge-linked-tests | Trust the item's current linked commands in this clone without executing them | 可选 |
| --background | Run linked tests in managed background mode | 可选 |
| --timeout <seconds> | Default run timeout in seconds | 可选 |
| --progress | Emit linked-test progress to stderr (always shown in TTY, opt-in for non-TTY) | 可选 |
| --env-set <value> | Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable) | 可选 |
| --env-clear <value> | Clear environment variable(s) for linked-test runs (NAME, repeatable) | 可选 |
| --shared-host-safe | Apply additive shared-host-safe runtime defaults for linked-test runs | 可选 |
| --pm-context <mode> | PM test context: schema|tracker|auto|none (default: schema) | 可选 |
| --override-linked-pm-context | Force run-level --pm-context to override per-linked-test pm_context_mode metadata | 可选 |
| --workspace-context <mode> | Source-workspace mode: source|isolated|snapshot (default: source) | 可选 |
| --override-linked-workspace-context | Force run-level --workspace-context over per-linked-test metadata | 可选 |
| --allow-untrusted-linked-tests | Execute untrusted linked commands when project policy also permits it | 可选 |
| --fail-on-context-mismatch | Fail linked PM commands when context item counts differ | 可选 |
| --fail-on-skipped | Treat skipped linked tests as dependency failures | 可选 |
| --fail-on-empty-test-run | Treat successful linked-test commands that report zero executed tests as failures | 可选 |
| --require-assertions-for-pm | Require assertion metadata for linked PM command tests | 可选 |
| --check-context | Preflight linked PM command context diagnostics before executing commands | 可选 |
| --auto-pm-context | Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context | 可选 |
| --measure <value> | Record name=value[,unit=...][,threshold=...] evidence; repeatable | 可选 |
| --metric-below <value> | Return evidence below name=value | 可选 |
| --metric-diff <name> | Diff the latest two values | 可选 |
| --author <value> | Mutation author | 可选 |
| --message <value> | History message | 可选 |
| --force | Force ownership override | 可选 |
示例
pm item test pm-a1b2 --add "command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,timeout_seconds=2400"