carryctx 0.8.1

Local-first project lifecycle control for coding agents and human collaborators.
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

pub struct NewWorktree {
    pub id: String,
    pub project_id: String,
    pub path: String,
    pub branch: Option<String>,
    pub head: Option<String>,
    pub task_id: Option<String>,
}

#[derive(serde::Serialize)]
pub struct WorktreeRecord {
    pub id: String,
    pub project_id: String,
    pub path: String,
    pub branch: Option<String>,
    pub head: Option<String>,
    pub task_id: Option<String>,
    pub created_at: String,
    pub updated_at: String,
    #[serde(default)]
    pub cleanup_pending: bool,
}

pub trait WorktreeRepository {
    fn upsert(
        &self,
        input: &NewWorktree,
        now: &str,
    ) -> Result<WorktreeRecord, crate::error::CarryCtxError>;
    fn find_by_id(
        &self,
        project_id: &str,
        id: &str,
    ) -> Result<Option<WorktreeRecord>, crate::error::CarryCtxError>;
    fn find_by_path(
        &self,
        project_id: &str,
        path: &str,
    ) -> Result<Option<WorktreeRecord>, crate::error::CarryCtxError>;
    fn find_by_task_id(
        &self,
        project_id: &str,
        task_id: &str,
    ) -> Result<Option<WorktreeRecord>, crate::error::CarryCtxError>;
    fn list(&self, project_id: &str) -> Result<Vec<WorktreeRecord>, crate::error::CarryCtxError>;
    fn unbind_task(
        &self,
        id: &str,
        project_id: &str,
        now: &str,
    ) -> Result<WorktreeRecord, crate::error::CarryCtxError>;
    /// Delete the registration row entirely (CTX-0083). Unlike
    /// [`WorktreeRepository::unbind_task`], which only detaches the task,
    /// this removes the worktrees row itself.
    fn delete(&self, id: &str, project_id: &str) -> Result<(), crate::error::CarryCtxError>;
    fn prune_stale(
        &self,
        project_id: &str,
        repository_root: &std::path::Path,
        actor_agent_id: Option<&str>,
        session_id: Option<&str>,
        now: &str,
    ) -> Result<Vec<WorktreeRecord>, crate::error::CarryCtxError>;
}