From d3673e1f34e31f6a2062c35d38b166d49f8b6180 Mon Sep 17 00:00:00 2001
From: "Rodrigo Rodriguez (Pragmatismo)" <me@rodrigorodriguez.com>
Date: Sun, 12 Apr 2026 09:43:47 -0300
Subject: [PATCH] Add KB fail state migration: fail_count and last_failed_at
 columns

New migration 6.3.0-01-kb-fail-state to add columns to kb_documents
for intelligent backoff retry logic.
---
 migrations/6.3.0-01-kb-fail-state/down.sql |  8 ++++++++
 migrations/6.3.0-01-kb-fail-state/up.sql   | 14 ++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 migrations/6.3.0-01-kb-fail-state/down.sql
 create mode 100644 migrations/6.3.0-01-kb-fail-state/up.sql

diff --git a/migrations/6.3.0-01-kb-fail-state/down.sql b/migrations/6.3.0-01-kb-fail-state/down.sql
new file mode 100644
index 00000000..8bc8d954
--- /dev/null
+++ b/migrations/6.3.0-01-kb-fail-state/down.sql
@@ -0,0 +1,8 @@
+-- ============================================
+-- Rollback KB Fail State
+-- ============================================
+
+DROP INDEX IF EXISTS idx_kb_documents_fail;
+ALTER TABLE kb_documents 
+    DROP COLUMN IF EXISTS fail_count,
+    DROP COLUMN IF EXISTS last_failed_at;
diff --git a/migrations/6.3.0-01-kb-fail-state/up.sql b/migrations/6.3.0-01-kb-fail-state/up.sql
new file mode 100644
index 00000000..96e6b88b
--- /dev/null
+++ b/migrations/6.3.0-01-kb-fail-state/up.sql
@@ -0,0 +1,14 @@
+-- ============================================
+-- KB Documents Fail State
+-- Version: 6.3.0
+-- ============================================
+-- Add fail_count and last_failed_at to kb_documents
+-- for intelligent backoff retry logic
+
+ALTER TABLE kb_documents 
+    ADD COLUMN IF NOT EXISTS fail_count INT NOT NULL DEFAULT 0,
+    ADD COLUMN IF NOT EXISTS last_failed_at TIMESTAMPTZ;
+
+CREATE INDEX IF NOT EXISTS idx_kb_documents_fail 
+    ON kb_documents(bot_id, collection_name, fail_count) 
+    WHERE fail_count > 0;