reviewloop 0.2.1

Reproducible, guardrailed automation for academic review workflows on paperreview.ai
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

//
//  WidgetState.swift
//  ReviewLoopWidget
//
//  This file mirrors the Rust-emitted JSON schema. See
//  docs/widget-schema.md (in the reviewloop repo) for the full
//  contract, schema-bump procedure, and field semantics.
//

import Foundation

// MARK: - Top-level snapshot

/// Mirrors the JSON contract written by the reviewloop daemon (schema_version = 1).
struct WidgetState: Codable {
    let schemaVersion: Int
    let generatedAt: Date
    let projectId: String
    let summary: Summary
    let activeJobs: [ActiveJob]
    let recentFailures: [Failure]
    let lastTickAt: Date
    let lastTickError: TickError?
    let tickHealth: TickHealth

    enum CodingKeys: String, CodingKey {
        case schemaVersion = "schema_version"
        case generatedAt = "generated_at"
        case projectId = "project_id"
        case summary
        case activeJobs = "active_jobs"
        case recentFailures = "recent_failures"
        case lastTickAt = "last_tick_at"
        case lastTickError = "last_tick_error"
        case tickHealth = "tick_health"
    }
}

// MARK: - Summary

extension WidgetState {
    struct Summary: Codable {
        let activeCount: Int
        let failedRecent24h: Int
        let completedToday: Int

        enum CodingKeys: String, CodingKey {
            case activeCount = "active_count"
            case failedRecent24h = "failed_recent_24h"
            case completedToday = "completed_today"
        }
    }
}

// MARK: - ActiveJob

extension WidgetState {
    struct ActiveJob: Codable, Identifiable {
        let paperId: String
        let status: String
        let attempt: Int
        let nextPollAt: Date?
        let startedAt: Date?

        var id: String { paperId }

        enum CodingKeys: String, CodingKey {
            case paperId = "paper_id"
            case status
            case attempt
            case nextPollAt = "next_poll_at"
            case startedAt = "started_at"
        }
    }
}

// MARK: - Failure

extension WidgetState {
    struct Failure: Codable, Identifiable {
        let paperId: String
        let status: String
        let lastError: String
        let occurredAt: Date

        var id: String { paperId }

        enum CodingKeys: String, CodingKey {
            case paperId = "paper_id"
            case status
            case lastError = "last_error"
            case occurredAt = "occurred_at"
        }
    }
}

// MARK: - TickError

extension WidgetState {
    struct TickError: Codable {
        let at: Date
        let message: String
    }
}

// MARK: - TickHealth

extension WidgetState {
    enum TickHealth: String, Codable {
        case normal
        case stale
        case stuck
        case unknown

        // Fallback for unknown future values
        init(from decoder: Decoder) throws {
            let raw = try decoder.singleValueContainer().decode(String.self)
            self = TickHealth(rawValue: raw) ?? .unknown
        }
    }
}

// MARK: - Placeholder

extension WidgetState {
    static var placeholder: WidgetState {
        let now = Date()
        return WidgetState(
            schemaVersion: 1,
            generatedAt: now,
            projectId: "—",
            summary: Summary(activeCount: 0, failedRecent24h: 0, completedToday: 0),
            activeJobs: [],
            recentFailures: [],
            lastTickAt: now,
            lastTickError: nil,
            tickHealth: .unknown
        )
    }
}