Skip to content

Improve error messages with actionable hints across all platforms#40

Merged
devxoul merged 3 commits intomainfrom
fix/improve-error-messages
Mar 5, 2026
Merged

Improve error messages with actionable hints across all platforms#40
devxoul merged 3 commits intomainfrom
fix/improve-error-messages

Conversation

@devxoul
Copy link
Owner

@devxoul devxoul commented Mar 5, 2026

Summary

  • Audit all user-facing error messages across Slack, Discord, Discordbot, and Teams platforms and add actionable hints so users know how to recover from each error state.

Changes

Slack (src/platforms/slack/commands/)

  • auth.ts — Workspace not set now suggests "workspace list" or "auth extract".
  • workspace.ts — Workspace not found includes recovery hint.
  • reaction.ts — Message not found now includes ts value in error.
  • file.ts — File not found includes hint to check the file ID.

Discord / Discordbot (src/platforms/discord/, src/platforms/discordbot/)

  • server.ts — Server not found suggests "server list"; missing current server suggests "auth extract" or "server switch".
  • client.ts — Channel not found suggests using channel ID or exact channel name.

Teams (src/platforms/teams/)

  • client.ts — Token expired now suggests "auth extract" to refresh.
  • team.ts — Team not found suggests "team list"; missing config/account suggests "auth extract" first.

Verified

  • bun typecheck — clean.
  • bun test src/ — 868 pass, 0 fail.
  • bun lint — clean.

Summary by cubic

Add actionable recovery hints to user-facing errors across Slack, Discord/Discordbot, and Teams. Standardizes wording for missing workspace/server/team and adds helpful context where needed.

  • New Features
    • Slack: Workspace not found now suggests "workspace list"; standardized "No current workspace set" message; message not found includes ts; file not found suggests "file list".
    • Discord/Discordbot: Server not found suggests "server list"; missing current server suggests "auth extract" or "server switch"; channel not found suggests using channel ID or exact name.
    • Teams: Token expired suggests "auth extract"; team not found suggests "team list"; missing config/account suggests "auth extract" first.

Written for commit 475094e. Summary will update on new commits.

devxoul added 3 commits March 5, 2026 22:23
…ints

Standardize workspace-missing messages to 'No current workspace set'
across auth status and reaction commands. Add recovery hints to
workspace-not-found and file-not-found errors. Include timestamp in
reaction message-not-found error for debugging.
@vercel
Copy link

vercel bot commented Mar 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
agent-messenger Ignored Ignored Mar 5, 2026 1:26pm

Request Review

Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 8 files

@devxoul devxoul merged commit 81e7fb1 into main Mar 5, 2026
5 checks passed
@devxoul devxoul deleted the fix/improve-error-messages branch March 5, 2026 13:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant