Struct Task 

pub struct Task {

    pub id: String,
    pub title: String,
    pub task_type: TaskType,
    pub priority: u8,
    pub status: Status,
    pub parent: Option<String>,
    pub depends_on: Vec<String>,
    pub description: String,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub closed_at: Option<DateTime<Utc>>,
    pub claimed_by: Option<String>,
    pub branch: Option<String>,
    pub tags: Vec<String>,
    pub notes: Vec<Note>,
    pub links: Vec<Link>,
    pub closed_children: Vec<ArchivedChild>,
    pub external: BTreeMap<String, Value>,
    pub synced_at: BTreeMap<String, DateTime<Utc>>,
    pub sync_status: BTreeMap<String, String>,
    pub delivered_in: Option<String>,
    pub repo: Option<String>,
    pub target_branch: Option<String>,
    pub extra: BTreeMap<String, Value>,
}

Fields

id: String

title: String

task_type: TaskType

priority: u8

status: Status

parent: Option<String>

depends_on: Vec<String>

description: String

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

closed_at: Option<DateTime<Utc>>

claimed_by: Option<String>

branch: Option<String>

tags: Vec<String>

notes: Vec<Note>

links: Vec<Link>

closed_children: Vec<ArchivedChild>

external: BTreeMap<String, Value>

synced_at: BTreeMap<String, DateTime<Utc>>

Per-plugin timestamp of the last applied push/sync response. Plugins compare their remote’s updated_at against this for bidirectional conflict resolution without a side-cache. Missing keys mean “never synced by that plugin”.

sync_status: BTreeMap<String, String>

SPEC §9/§8.1 — per-participant verbatim reason a native best-effort negotiation did not land (a reject reason or wire-failure message). Set on skip, cleared on next success. Legacy-shim skips stay silent so SPEC §12 byte-identity holds.

delivered_in: Option<String>

Performance hint: SHA of the squash-merge on main that delivered this task. Ground truth is the [id] tag embedded in the commit message — see crate::delivery.

repo: Option<String>

Provenance: the code repo this task was created in (origin URL, else repo path). Set at create; legible on a shared hub. Older bl round-trips it via extra (SPEC §13 / bl-d31c).

target_branch: Option<String>

Per-task override of the repo-level config.target_branch (SPEC §6.2). When set, bl review squashes this task into this branch, ignoring both the repo default and the current-branch fallback — the smallest unit that expresses git-flow’s hotfix→main vs feature→develop split. Optional and skip_serializing_if None, so existing task files stay byte-identical and an older bl (no deny_unknown_fields) silently round-trips it via extra.

extra: BTreeMap<String, Value>

Forward-compat passthrough. Any top-level JSON field that the current struct doesn’t name lands here on deserialize and round-trips back out on save. Lets an older bl load a task file written by a future version without silently dropping new first-party fields. external already exists for plugin data; extra is the catch-all for everything else.

Implementations

impl Task

pub fn generate_id(title: &str, ts: DateTime<Utc>, id_length: usize) -> String

Task ids are persisted forever once minted, and id generation must work in stealth/no-git mode. SHA-1 here is load-bearing on-disk state, same shape as store_paths::stealth_tasks_dir: the algorithm and its byte output are the on-disk contract, not an implementation detail. Backed by the vendored in-tree crate::hash::sha1_hex so the RustCrypto stack is not in the dependency tree.

pub fn new(opts: NewTaskOpts, id: String) -> Self

pub fn touch(&mut self)

pub fn append_note(&mut self, author: &str, text: &str)

In-memory note append. Does not persist. For on-disk persistence, use task_io::append_note_to, which writes to the append-only sibling file and is safe for concurrent writers.

impl Task

pub fn load(path: &Path) -> Result<Self>

Load a task from path. Notes live in a sibling file; load handles both the new layout (notes in sibling) and legacy task files whose notes array is embedded in the JSON. Either way, the returned Task.notes is the union of both sources.

pub fn save(&self, path: &Path) -> Result<()>

Persist a task to path in the text-mergeable format. Never writes the notes sidecar content; use append_note_to for that. Does ensure the notes sidecar exists as an empty file on first save, so that concurrent first-append operations on divergent branches see the file in the merge base and use git’s union merge driver instead of racing on add/add.

Trait Implementations

impl Clone for Task

fn clone(&self) -> Task

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Task

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Task

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Task

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.