Improve lenient reference handling across CLI commands

[gnapse]

Summary

• Harden reference parsing in src/lib/refs.ts (trim-aware parsing, strict numeric IDs, clearer error messaging, and resolveChannelId).
• Allow search --channel and search --conversation to consume comma-separated refs (bare IDs, id: refs, and Twist URLs).
• Route react/unreact and thread reply --notify through shared ref parsing for more forgiving, consistent ID handling.
• Add and update tests in src/__tests__/lib/refs.test.ts, src/__tests__/search.test.ts, src/__tests__/thread.test.ts, and new src/__tests__/react.test.ts, and sync SKILL_CONTENT docs.

What You Can Do Now

# Mix id: refs and URLs for search filters
tw search "AI" --channel "id:772552,https://twist.com/a/1585/ch/1220"
tw search "status" --conversation "id:907792,https://twist.com/a/1585/msg/2287"

# React/unreact using URLs directly
tw react thread "https://twist.com/a/1585/ch/772552/t/5928839" +1
tw unreact message "https://twist.com/a/1585/msg/907792/m/107740052" heart

# Use id: refs in notify lists
tw thread reply 5928839 "Looks good" --notify id:123,456 --dry-run

Inspiration

• feat: auto-retry id-like task refs as direct ID lookups todoist-cli#53
• fix: clarify id: prefix requirement in error messages todoist-cli#49

Validation: npm test and npm run type-check pass.

[doist-bot]

This PR significantly improves the robustness and consistency of reference handling across several CLI commands by hardening reference parsing in src/lib/refs.ts and enabling comma-separated references in search commands. The changes also route react/unreact and thread reply --notify through shared parsing logic, contributing to a more forgiving and consistent user experience. No issues were flagged during the review, indicating a well-executed and thoroughly tested set of improvements.

_{Share Feedback • Review Logs}

[github-actions]

🎉 This PR is included in version 2.2.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀