Crate beads_rust 

beads_rust - Agent-first issue tracker library

This crate provides the core functionality for the br CLI tool, a Rust port of the classic beads issue tracker.

Architecture

The crate is organized into the following modules:

• cli - Command-line interface using clap
• model - Data types (Issue, Dependency, Comment, Event)
• storage - SQLite database layer
• sync - JSONL import/export operations
• config - Configuration management
• cache - Pure cache policies for high-RAM acceleration
• coordination - Pure swarm coordination evidence contracts
• error - Error types and handling
• [format] - Output formatting (text, JSON)
• util - Utility functions (hashing, time, paths)
• write_combining - Compatibility contracts for future write combining

Re-exports

pub use error::BeadsError;

pub use error::ErrorCode;

pub use error::Result;

pub use error::StructuredError;

Modules

cache

Pure cache policies for future high-RAM workspace acceleration.

cli

CLI definitions and entry point.

close_policy

Closure-time policy gates (issue #274 — Phase 1).

config

Configuration management for beads_rust.

coordination

Pure evidence contracts for swarm coordination diagnosis.

error

Error types and handling for beads_rust.

format

Output formatting for beads_rust.

health

inheritance

Inherited agent context (beads_rust#297).

logging

Logging configuration and initialization.

model

Core data types for beads_rust.

output

Output Module

policy

Deterministic adaptive policy documents.

shutdown

Cooperative shutdown coordination for SIGINT, SIGTERM, and SIGHUP.

storage

SQLite storage layer for beads_rust.

sync

JSONL import/export for beads_rust.

util

Shared utilities for beads_rust.

validation

Validation helpers for beads_rust.

write_combining

Pure contracts for future .write.lock write combining.

Functions

run

Run the CLI application.