Skip formatting cde-tool managed files

Author: fatbobman

.githooks/README.md

@@ -28,6 +28,7 @@ git config core.hooksPath .githooks
   - 检测所有待提交的 `.swift` 文件
   - 使用 `swift-format` 格式化这些文件
   - 自动将格式化后的文件重新暂存
+  - 自动跳过 `cde-tool` 托管的 generated files（例如 `*+CoreDataEvolution.swift`）
   - 如果未安装 `swift-format`，会给出警告但不会阻止提交
 
 ## 安装 swift-format

.githooks/pre-commit

@@ -39,6 +39,22 @@ fi
 
 # swift-format 使用默认规则或项目根目录的 .swift-format 配置
 
+# `cde-tool` managed files participate in exact drift validation. Formatting them in the hook would
+# introduce noise that the generator did not emit.
+is_cde_managed_file() {
+    local file="$1"
+
+    if [[ "$file" == *"+CoreDataEvolution.swift" ]]; then
+        return 0
+    fi
+
+    if [ -f "$file" ] && grep -q '^// cde-tool:generated$' "$file"; then
+        return 0
+    fi
+
+    return 1
+}
+
 # 格式化每个文件
 FORMATTED_COUNT=0
 for file in $SWIFT_FILES; do
@@ -49,6 +65,11 @@ for file in $SWIFT_FILES; do
             ;;
     esac
 
+    if is_cde_managed_file "$file"; then
+        echo "  ⏭️  跳过 cde-tool 托管文件: $file"
+        continue
+    fi
+
     if [ -f "$file" ]; then
         echo "  📝 格式化: $file"
 

Integration/GeneratedFlowFixture/Sources/GeneratedModels/FlowTask+CoreDataEvolution.swift

@@ -8,9 +8,7 @@ import Foundation
 @objc(FlowTask)
 @PersistentModel
 public final class FlowTask: NSManagedObject {
-  @Attribute(
-    persistentName: "config_blob", storageMethod: .codable,
-    decodeFailurePolicy: .fallbackToDefaultValue)
+  @Attribute(persistentName: "config_blob", storageMethod: .codable, decodeFailurePolicy: .fallbackToDefaultValue)
   public var config: FlowTaskConfig? = nil
 
   @Attribute(persistentName: "created_at")
@@ -24,13 +22,10 @@ public final class FlowTask: NSManagedObject {
   @Attribute(persistentName: "name")
   public var title: String = ""
 
-  @Attribute(
-    persistentName: "status_raw", storageMethod: .raw, decodeFailurePolicy: .fallbackToDefaultValue)
+  @Attribute(persistentName: "status_raw", storageMethod: .raw, decodeFailurePolicy: .fallbackToDefaultValue)
   public var status: FlowTaskStatus? = nil
 
-  @Attribute(
-    persistentName: "tags_payload", storageMethod: .transformed(name: "NSSecureUnarchiveFromData"),
-    decodeFailurePolicy: .fallbackToDefaultValue)
+  @Attribute(persistentName: "tags_payload", storageMethod: .transformed(name: "NSSecureUnarchiveFromData"), decodeFailurePolicy: .fallbackToDefaultValue)
   public var tags: [String]? = nil
 
   @Relationship(persistentName: "owner_project", inverse: "owned_tasks", deleteRule: .nullify)