qqq-cli 0.12.0

Local-first task queue for coding agent sessions
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

//! Shared single-task and projected-batch archive validation.
use crate::{db::Task, errors::Info};
use anyhow::{Context, Result, ensure};
use rusqlite::{Connection, OptionalExtension};
use std::collections::BTreeMap;

pub(crate) fn validate(
    conn: &Connection,
    task: &Task,
    archived: bool,
    changes: &BTreeMap<i64, bool>,
) -> Result<()> {
    if task.archived == archived {
        return Ok(());
    }
    if archived {
        ensure!(
            task.status != "in_progress",
            Info::transition(
                task.id,
                &task.status,
                &["new", "error", "completed"],
                format!("Task {} is in progress and cannot be archived", task.id)
            )
        );
        if task.status != "completed" {
            let mut statement = conn.prepare(
                "SELECT id,archived FROM tasks WHERE status!='completed' AND
                 (parent_id=?1 OR id IN (SELECT task_id FROM task_dependencies WHERE prerequisite_id=?1))"
            )?;
            let rows = statement.query_map([task.id], |r| {
                Ok((r.get::<_, i64>(0)?, r.get::<_, bool>(1)?))
            })?;
            for row in rows {
                let (id, current) = row?;
                ensure!(
                    changes.get(&id).copied().unwrap_or(current),
                    Info::transition(
                        task.id,
                        &task.status,
                        &["completed"],
                        format!(
                            "Task {} has non-archived unfinished child or dependent",
                            task.id
                        )
                    )
                    .detail("reason", "unfinished_child")
                );
            }
        }
    } else if task.status != "completed" {
        if let Some(parent) = task.parent_id {
            available(conn, parent, true, changes)?;
        }
        for prerequisite in &task.prerequisites {
            available(conn, prerequisite.id, false, changes)?;
        }
    }
    Ok(())
}

fn available(
    conn: &Connection,
    id: i64,
    parent: bool,
    changes: &BTreeMap<i64, bool>,
) -> Result<()> {
    let (status, archived) = conn
        .query_row("SELECT status,archived FROM tasks WHERE id=?", [id], |r| {
            Ok((r.get::<_, String>(0)?, r.get::<_, bool>(1)?))
        })
        .optional()?
        .with_context(|| Info::missing_task(id))?;
    let archived = changes.get(&id).copied().unwrap_or(archived);
    let mut info = Info::transition(
        id,
        &status,
        &["completed"],
        format!(
            "Task {id} is archived unfinished {}",
            if parent { "parent" } else { "prerequisite" }
        ),
    )
    .detail("actual_archived", true);
    if !parent {
        info = info.detail("reason", "archived_unfinished_prerequisite");
    }
    ensure!(!archived || status == "completed", info);
    Ok(())
}