fix(cli): render ReadWorkItem IDs without literal quotes

[aaight]

Summary

Fixes Trello card: https://trello.com/c/6a004c0d4975d097b09a527c

• Centralizes shell-safe example formatting for native-tool prompt guidance and cascade-tools --help examples.
• Renders safe scalar values like --workItemId abc123, --labels needs-work, numbers, and enums without quote characters while preserving shell-quoted JSON for object payloads.
• Adds ReadWorkItem-specific regression coverage for native-tool prompts, generated oclif examples, built CLI help, and command parsing.
• Adds narrow ReadWorkItem CLI hardening that strips one accidental outer quote layer from PM IDs only.
• Updates gadget docs and changelog for the scalar example formatting rule.

Testing

• npx vitest run --project unit-backends tests/unit/backends/shared-nativeToolPrompts.test.ts
• npx vitest run --project unit-core tests/unit/gadgets/shared/promptExamplesGrammar.test.ts tests/unit/gadgets/shared/cli/examples.test.ts tests/unit/cli/pm/pm-commands.test.ts tests/unit/cli/cascade-tools-help.test.ts
• npm run build
• ./bin/cascade-tools.js pm read-work-item --help
• npx vitest run --project unit-core tests/unit/cli/cascade-tools-help.test.ts
• npm run lint
• npm run typecheck
• npm test

Note: npm run lint exits 0 and still reports existing non-failing warnings in unrelated files.

🕵️ codex · gpt-5.5 · run details

[codecov]

Codecov Report

❌ Patch coverage is 92.10526% with 3 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/gadgets/shared/cli/shellValues.ts	83.33%	3 Missing ⚠️

📢 Thoughts on this report? Let us know!

[nhopeatall]

LGTM - verified the shared shell-value formatter keeps scalar examples bare while preserving quoted JSON payloads, and ReadWorkItem quote normalization is scoped to the PM ID path. Targeted unit checks passed locally; CI is green.

🕵️ codex · gpt-5.5 · run details