botrun-flow-lang 5.12.262__tar.gz → 5.12.263__tar.gz

{botrun_flow_lang-5.12.262 → botrun_flow_lang-5.12.263}/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [5.12.263]
+- 優化 `get_hatches` 向下相容機制：
+  - 使用 Firestore batch write 批量更新缺少 `updated_at` 的記錄（每批最多 500 個）
+  - 解決 Firestore 無法直接篩選"字段不存在"的架構限制
+  - 自動為舊記錄補充 `updated_at` 時間戳，確保所有 hatch 都能被正確查詢和排序
+  - 首次查詢時自動遷移，後續查詢效能正常
+
 ## [5.12.262]
 - 更新 requirement.txt，支援新版 botrun_hatch
 

{botrun_flow_lang-5.12.262 → botrun_flow_lang-5.12.263}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: botrun-flow-lang
-Version: 5.12.262
+Version: 5.12.263
 Summary: A flow language for botrun
 Author-email: sebastian-hsu <sebastian.hsu@gmail.com>
 License: MIT

{botrun_flow_lang-5.12.262 → botrun_flow_lang-5.12.263}/botrun_flow_lang/services/hatch/hatch_fs_store.py

@@ -61,6 +61,38 @@ class HatchFsStore(FirestoreBase):
         order: str = "desc",
     ) -> Tuple[List[Hatch], str]:
         try:
+            # 向下兼容：先找出没有 updated_at 字段的记录并批量更新
+            # 注意：Firestore 不支持直接筛选"字段不存在"，必须遍历所有记录
+            if sort_by == "updated_at":
+                missing_query = self.collection.where(
+                    filter=firestore.FieldFilter("user_id", "==", user_id)
+                )
+
+                # 收集需要更新的文档
+                docs_to_update = []
+                current_time = datetime.now(timezone.utc).isoformat()
+
+                for doc in missing_query.stream():
+                    data = doc.to_dict()
+                    # 如果没有 updated_at 字段或为空，收集起来
+                    if "updated_at" not in data or not data.get("updated_at"):
+                        docs_to_update.append((doc.reference, data))
+
+                # 使用批量写入更新（每批最多 500 个）
+                if docs_to_update:
+                    batch_size = 500
+                    for i in range(0, len(docs_to_update), batch_size):
+                        batch = self.db.batch()
+                        batch_docs = docs_to_update[i:i + batch_size]
+
+                        for doc_ref, data in batch_docs:
+                            data["updated_at"] = current_time
+                            batch.set(doc_ref, data)
+
+                        batch.commit()
+
+                    logging.info(f"Auto-migrated {len(docs_to_update)} hatches with updated_at for user {user_id}")
+
             # Build base query
             query = self.collection.where(
                 filter=firestore.FieldFilter("user_id", "==", user_id)

{botrun_flow_lang-5.12.262 → botrun_flow_lang-5.12.263}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "botrun-flow-lang"
-version = "5.12.262"
+version = "5.12.263"
 description = "A flow language for botrun"
 authors = [
     { name = "sebastian-hsu", email = "sebastian.hsu@gmail.com" }