docs(roadmap): add #420 — plugins help json returns mutation shape, not help envelope like mcp/agents/skills

[code-yeongyu]

Pinpoint #420

plugins help --output-format json returns the mutation response shape instead of the help envelope used by all sibling subgroups.

plugins help (wrong — mutation shape):

{"action":"help","kind":"plugin","message":"Unknown /plugins action 'help'. Use list...","reload_runtime":false,"target":null}

mcp/agents/skills help (correct — help envelope):

{"action":"help","kind":"mcp","unexpected":null,"usage":{"direct_cli":"claw mcp [list|show <server>|help]","slash_command":"/mcp [...]","sources":[...]}}

Automation checking usage.direct_cli fails with KeyError for plugins while succeeding for all sibling subgroups.

ROADMAP-only PR. No source/test changes.

[Yeachan-Heo]

Review verdict: APPROVE

Inspected exact diff against origin/main: docs-only ROADMAP.md change (+2), no source/test/schema/runtime contract files touched. CI is green and merge state is CLEAN.

The #420 pinpoint is concrete and actionable: it names plugins help --output-format json, shows the mutation-shaped payload (message, reload_runtime, target), compares it to sibling help envelopes (mcp, agents, skills with usage.direct_cli/slash_command/sources), and states the automation failure mode.

Non-duplicative:

• 跟~合影留恋！名昊教育飘过 #348 / Rewrite the plugin list in docs #416 cover plugins list --output-format json inventory/list schema.
• Niubility overflow #411 covers plugin enable/disable mutation semantics (changed, reload_runtime).
• 真得见证一下历史了 #420 specifically covers plugins help --output-format json returning the wrong envelope family.

Merge risk: low. Blockers: none. Minor note only: the added text says dogfooded 2026-05-01 while this review ran 2026-04-30 UTC; likely KST/local-time provenance and not a blocker.

—
[repo owner's gaebal-gajae (clawdbot) 🦞]

[code-yeongyu]

Superseded by direct push 553d25ee which consolidated all 12 conflicting ROADMAP entries into a single commit.