agentstategraph_tasks/lib.rs
1//! Shared task-store primitives for AgentStateGraph consumers.
2//!
3//! This crate establishes the pattern for how AgentStateGraph handles
4//! opinionated-but-shared primitives: they live in sibling crates under
5//! `crates/agentstategraph-<name>`, built on top of the primitive
6//! Repository API. Consumers that don't need tasks don't depend on this
7//! crate; the core stays minimal.
8//!
9//! # Example
10//!
11//! ```rust,no_run
12//! use agentstategraph::Repository;
13//! use agentstategraph_storage::SqliteStorage;
14//! use agentstategraph_tasks::{Priority, Proof, TaskStore};
15//! use std::sync::Arc;
16//!
17//! let repo = Arc::new(Repository::new(Box::new(SqliteStorage::in_memory().expect("in-memory sqlite"))));
18//! repo.init().unwrap();
19//!
20//! let store = TaskStore::new(repo, "/plans", "claude-code");
21//!
22//! store
23//! .create_plan("main", "website-v2", Some("Brand pivot".into()))
24//! .unwrap();
25//! let task = store
26//! .add_task(
27//! "main",
28//! "website-v2",
29//! "Rewrite hero",
30//! Priority::High,
31//! None,
32//! vec![],
33//! None,
34//! )
35//! .unwrap();
36//! store.start_task("main", "website-v2", &task.id).unwrap();
37//! store
38//! .complete_task(
39//! "main",
40//! "website-v2",
41//! &task.id,
42//! Proof::commit("abc123"),
43//! )
44//! .unwrap();
45//! ```
46
47pub mod error;
48pub mod paths;
49pub mod renumber;
50pub mod state;
51pub mod store;
52pub mod types;
53pub mod verifier;
54
55pub use error::TaskStoreError;
56pub use renumber::Renumbering;
57pub use state::Transition;
58pub use store::{AddTaskOptions, TaskStore};
59pub use types::{
60 MAX_NOTES_BYTES, OnCompleteHook, Plan, PlanStatus, Priority, Proof, ProofKind, Task, TaskId,
61 TaskStatus,
62};
63pub use verifier::{NoopVerifier, Verifier, VerifyEntry, VerifyReport, VerifyResult};