Merge pull request #639 from Chris0Jeky/fix/615-capture-triage-error-messages

Show meaningful error messages for failed capture triage

Author: Chris0Jeky

backend/src/Taskdeck.Application/DTOs/CaptureDtos.cs

@@ -20,6 +20,7 @@ public record CaptureItemDto(
     DateTimeOffset CreatedAt,
     DateTimeOffset? ProcessedAt,
     int RetryCount,
+    string? ErrorMessage = null,
     CaptureProvenanceV1? Provenance = null);
 
 public record CaptureItemSummaryDto(

backend/src/Taskdeck.Application/Services/CaptureService.cs

@@ -492,6 +492,7 @@ private static CaptureItemDto MapToDetailDto(LlmRequest item, CapturePayloadV1 p
             item.CreatedAt,
             item.ProcessedAt,
             item.RetryCount,
+            item.ErrorMessage,
             payload.Provenance);
     }
 

frontend/taskdeck-web/src/types/capture.ts

@@ -58,6 +58,7 @@ export interface CaptureProvenance {
 export interface CaptureItem extends CaptureItemSummary {
   rawText: string
   retryCount: number
+  errorMessage?: string | null
   provenance?: CaptureProvenance | null
 }
 

frontend/taskdeck-web/src/views/InboxView.vue

@@ -499,6 +499,10 @@ function triageButtonLabel(status: CaptureStatusValue | undefined): string {
     return 'Converted'
   }
 
+  if (label === 'Failed') {
+    return 'Retry Triage'
+  }
+
   return 'Start Triage'
 }
 
@@ -851,6 +855,19 @@ onUnmounted(() => {
             </template>
           </div>
 
+          <div
+            v-if="selectedItem.status === 6 || selectedItem.status === 'Failed'"
+            class="td-inbox-detail__error-banner"
+            data-testid="capture-error-banner"
+            role="alert"
+          >
+            <p class="td-inbox-detail__error-title">Triage failed</p>
+            <p v-if="selectedItem.errorMessage" class="td-inbox-detail__error-message">{{ selectedItem.errorMessage }}</p>
+            <p class="td-inbox-detail__error-hint">
+              You can edit the text and retry, or ignore this capture if it is no longer needed.
+            </p>
+          </div>
+
           <div v-if="selectedItem.provenance?.proposalId" class="td-inbox-detail__proposal-link">
             <span>A proposed board update is ready for approval.</span>
             <button
@@ -1256,6 +1273,40 @@ onUnmounted(() => {
   justify-content: flex-end;
 }
 
+/* ─── Error banner (Failed captures) ─── */
+
+.td-inbox-detail__error-banner {
+  background: rgba(255, 77, 77, 0.08);
+  border: 0.5px solid rgba(255, 77, 77, 0.25);
+  border-radius: var(--td-radius-md);
+  padding: var(--td-space-3) var(--td-space-4);
+}
+
+.td-inbox-detail__error-title {
+  font-family: 'Space Grotesk', system-ui, sans-serif;
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 0.2em;
+  color: var(--td-color-ember, #ff4d4d);
+  margin: 0 0 var(--td-space-2) 0;
+  font-weight: 600;
+}
+
+.td-inbox-detail__error-message {
+  color: var(--td-text-primary);
+  font-size: var(--td-font-sm);
+  line-height: 1.5;
+  margin: 0 0 var(--td-space-2) 0;
+  word-break: break-word;
+}
+
+.td-inbox-detail__error-hint {
+  color: var(--td-text-tertiary);
+  font-size: var(--td-font-xs);
+  line-height: 1.5;
+  margin: 0;
+}
+
 .td-inbox-detail__proposal-link {
   display: inline-flex;
   align-items: center;