agent_doc/
lib.rs

1//! agent-doc library — shared components for CLI, FFI, and editor plugins.
2//!
3//! Re-exports the core document manipulation modules that are shared between
4//! the CLI binary and native plugin bindings (JNI, napi-rs).
5
6pub mod component;
7pub mod crdt;
8pub mod debounce;
9pub mod ffi;
10pub mod frontmatter;
11pub mod merge;
12pub mod template;
13
14/// Default number of hex characters for boundary IDs.
15pub const BOUNDARY_ID_LEN: usize = 8;
16
17/// Generate a new boundary ID (short hex string from UUID v4).
18pub fn new_boundary_id() -> String {
19    let full = uuid::Uuid::new_v4().to_string().replace('-', "");
20    full[..BOUNDARY_ID_LEN.min(full.len())].to_string()
21}
22
23/// Generate a boundary ID with an optional summary suffix.
24///
25/// Format: `a0cfeb34` or `a0cfeb34:boundary-fix` (with summary).
26/// The summary is slugified (lowercase, non-alphanumeric → `-`, max 20 chars).
27pub fn new_boundary_id_with_summary(summary: Option<&str>) -> String {
28    let id = new_boundary_id();
29    match summary {
30        Some(s) if !s.is_empty() => {
31            let slug: String = s.to_lowercase()
32                .chars()
33                .map(|c| if c.is_alphanumeric() { c } else { '-' })
34                .collect::<String>()
35                .split('-')
36                .filter(|s| !s.is_empty())
37                .take(3) // max 3 words
38                .collect::<Vec<&str>>()
39                .join("-");
40            let slug = &slug[..slug.len().min(20)];
41            format!("{}:{}", id, slug)
42        }
43        _ => id,
44    }
45}
46
47/// Format a boundary marker comment.
48pub fn format_boundary_marker(id: &str) -> String {
49    format!("<!-- agent:boundary:{} -->", id)
50}
agent_doc/lib.rs

agent_doc/
lib.rs
