所有命令 · evidence
pm item notes
Manage merge-safe text notes and JSON context events.
Adds or reviews durable implementation notes linked to an item.
用法
pm item notes [options] <id> [text]参数
| <id> | Item id | 必填 |
|---|---|---|
| <text> | Optional note text shorthand for --add | 可选 |
选项
| --add <text> | Add a text note (- reads stdin) | 可选 |
|---|---|---|
| --add-json <json> | Append a JSON event | 可选 |
| --stdin | Read note text from stdin | 可选 |
| --file <path> | Read note from file or stdin (-) | 可选 |
| --edit <index> | Replace a 1-based note using the selected text input | 可选 |
| --delete <index> | Delete the note at 1-based <index> | 可选 |
| --limit <n> | Return only latest n notes | 可选 |
| --since <timestamp> | Filter JSON events from this ISO time | 可选 |
| --event-type <value> | Filter JSON events by top-level type | 可选 |
| --include-meta | Include count and truncation metadata | 可选 |
| --full-history | Return complete note history instead of a bounded receipt | 可选 |
| --if-absent | Append only when resolved author and text are absent | 可选 |
| --author [value] | Author; defaults to PM_AUTHOR/settings | 可选 |
| --message <value> | History message | 可选 |
| --force | Force ownership override | 可选 |
示例
pm item notes pm-a1b2 --add "Investigated parser edge case and documented fallback logic."