Phase 439: structured message.* and reaction.* platform error logs (v0.8.402)

Wrap sendMessage, editMessage, deleteMessage, and toggleReaction with log.time
spans and message.* / reaction.toggle error records on failure.

Co-authored-by: Cursor <[email protected]>

README.md

@@ -143,6 +143,8 @@ Primary consumer: `apps/pearcord/index.js` sidecar reading pear-pipe JSON.
 
 **v0.8.400:** `createChannelWebhook`/`deleteChannelWebhook`/`executeChannelWebhook` log `webhook.*` spans and errors; `registerSlashCommands`/`deleteSlashCommand`/`executeSlashCommand` log `slash.*` spans and errors.
 
+**v0.8.402:** `sendMessage`/`editMessage`/`deleteMessage` log `message.*` spans and errors; `toggleReaction` logs `reaction.toggle` span and `reaction.toggle error` on failure.
+
 **v0.8.401:** `createGuildCustomRole`/`updateGuildCustomRole`/`deleteGuildCustomRole`/`reorderGuildCustomRoles`/`setMemberCustomRoles` log `role.*` spans and errors; `upsertChannelPermissionOverwrite`/`deleteChannelPermissionOverwrite` log `permission.overwrite*` spans and errors.
 
 **v0.8.252:** Guild search mesh skipped when `guildOpenNoViewableChannels`; emoji batch prefetch skips negative miss TTL; sticker gossip prefetch gated on `attachments`; `session.startup` logs INFO when initial guild mesh flush was bounded. Smoke: `test:guild-search-no-viewable-skip`, `test:sticker-prefetch-attachments-ready`.

index.js

@@ -10071,12 +10071,24 @@ class PearcordPlatform extends EventEmitter {
   }
 
   async sendMessage (content, opts = {}) {
-    if (this._readOnly) throw new Error('read-only companion mode cannot send messages')
-    if (!this.messages) throw new Error('no channel')
     if (this.mode === 'guild' && parseSlashInvocation(content)) {
       return this.executeSlashCommand(content, opts)
     }
-    return this._sendPlainMessage(content, opts)
+    const span = this.log.time('message.send', { channelId: this.activeChannelId })
+    try {
+      if (this._readOnly) throw new Error('read-only companion mode cannot send messages')
+      if (!this.messages) throw new Error('no channel')
+      const msg = await this._sendPlainMessage(content, opts)
+      span.end({ messageId: msg?.id })
+      return msg
+    } catch (err) {
+      this.log.error('message.send error', {
+        channelId: this.activeChannelId,
+        error: err?.message || String(err)
+      })
+      span.fail(err)
+      throw err
+    }
   }
 
   _onGuildTyping (payload) {
@@ -10189,12 +10201,23 @@ class PearcordPlatform extends EventEmitter {
   }
 
   async editMessage (messageId, content) {
-    await this._assertCanModifyMessage(messageId, 'edit')
-    const msg = await this.messages.edit(messageId, content)
-    if (this.mode === 'dm' && this.dm) this.dm.gossipMessageUpdate(msg)
-    else if (this.guild) this.guild.gossipMessageUpdate(msg)
-    this.emit('message', msg)
-    return msg
+    const span = this.log.time('message.edit', { messageId })
+    try {
+      await this._assertCanModifyMessage(messageId, 'edit')
+      const msg = await this.messages.edit(messageId, content)
+      if (this.mode === 'dm' && this.dm) this.dm.gossipMessageUpdate(msg)
+      else if (this.guild) this.guild.gossipMessageUpdate(msg)
+      this.emit('message', msg)
+      span.end({ messageId: msg?.id })
+      return msg
+    } catch (err) {
+      this.log.error('message.edit error', {
+        messageId,
+        error: err?.message || String(err)
+      })
+      span.fail(err)
+      throw err
+    }
   }
 
   async createCategory ({ name }) {
@@ -10636,13 +10659,25 @@ class PearcordPlatform extends EventEmitter {
   }
 
   async toggleReaction (messageId, emoji) {
-    const user = this.identity.user
-    if (!user) throw new Error('register first')
-    if (this.mode === 'guild') await this._assertCanParticipate()
-    const result = await this.messages.toggleReaction(messageId, emoji, user.id)
-    if (this.mode !== 'dm' && this.guild) this.guild.gossipReaction(result)
-    this.emit('reaction', result)
-    return result
+    const span = this.log.time('reaction.toggle', { messageId, emoji: String(emoji || '').slice(0, 16) })
+    try {
+      const user = this.identity.user
+      if (!user) throw new Error('register first')
+      if (this.mode === 'guild') await this._assertCanParticipate()
+      const result = await this.messages.toggleReaction(messageId, emoji, user.id)
+      if (this.mode !== 'dm' && this.guild) this.guild.gossipReaction(result)
+      this.emit('reaction', result)
+      span.end({ messageId, emoji: String(emoji || '').slice(0, 16) })
+      return result
+    } catch (err) {
+      this.log.error('reaction.toggle error', {
+        messageId,
+        emoji: String(emoji || '').slice(0, 16),
+        error: err?.message || String(err)
+      })
+      span.fail(err)
+      throw err
+    }
   }
 
   _groupReactions (rows) {
@@ -10662,17 +10697,28 @@ class PearcordPlatform extends EventEmitter {
   }
 
   async deleteMessage (messageId) {
-    await this._assertCanModifyMessage(messageId, 'delete')
-    const channelId = this.activeChannelId
-    await this.messages.remove(messageId)
-    const payload = {
-      id: messageId,
-      channelId,
-      guildId: this.mode === 'dm' ? DM_GUILD_ID : this.guild?.guild?.id
+    const span = this.log.time('message.delete', { messageId })
+    try {
+      await this._assertCanModifyMessage(messageId, 'delete')
+      const channelId = this.activeChannelId
+      await this.messages.remove(messageId)
+      const payload = {
+        id: messageId,
+        channelId,
+        guildId: this.mode === 'dm' ? DM_GUILD_ID : this.guild?.guild?.id
+      }
+      if (this.mode === 'dm' && this.dm) this.dm.gossipMessageDelete(payload)
+      else if (this.guild) this.guild.gossipMessageDelete(payload)
+      this.emit('message-delete', payload)
+      span.end({ messageId })
+    } catch (err) {
+      this.log.error('message.delete error', {
+        messageId,
+        error: err?.message || String(err)
+      })
+      span.fail(err)
+      throw err
     }
-    if (this.mode === 'dm' && this.dm) this.dm.gossipMessageDelete(payload)
-    else if (this.guild) this.guild.gossipMessageDelete(payload)
-    this.emit('message-delete', payload)
   }
 
   async channelHistory () {