hyungi_document_server/Sources/DSKit/Models/Catalog.swift

import Foundation

/// Recursive domain tree (documents_tree.json is a top-level ARRAY). `children` is optional so
/// SwiftUI OutlineGroup can treat leaves cleanly; `kids` is the non-optional accessor.
public struct DomainTreeNode: Codable, Sendable, Identifiable {
    public let name: String
    public let path: String
    public let count: Int
    public let children: [DomainTreeNode]?

    public var id: String { path }
    public var kids: [DomainTreeNode] { children ?? [] }
}

public struct CategoryCounts: Codable, Sendable {
    public let total: Int
    public let documents: Int
    public let byDomain: [String: Int]
    public let reviewPending: Int
    public let pipelineFailed: Int

    enum CodingKeys: String, CodingKey {
        case total, documents
        case byDomain = "by_domain"
        case reviewPending = "review_pending"
        case pipelineFailed = "pipeline_failed"
    }
}

public struct DuplicateGroup: Codable, Sendable, Identifiable {
    public let canonicalId: Int
    public let members: [Int]
    public let reason: String
    public let detail: String?

    public var id: Int { canonicalId }

    enum CodingKeys: String, CodingKey {
        case members, reason, detail
        case canonicalId = "canonical_id"
    }
}

public struct DuplicatesResponse: Codable, Sendable {
    public let groups: [DuplicateGroup]
    public let totalGroups: Int
    public let totalDuplicateDocs: Int

    enum CodingKeys: String, CodingKey {
        case groups
        case totalGroups = "total_groups"
        case totalDuplicateDocs = "total_duplicate_docs"
    }
}