nils-common 1.25.5

Library crate for nils-common in the nils-cli workspace.
Documentation 
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

//! Foundation crate shared across nils-* CLIs.
//!
//! Each public module documents its own surface; `crates/nils-common/README.md` carries the
//! per-module narrative and the consumer index, and
//! `docs/specs/workspace-shared-crate-boundary-v1.md` carries the boundary contract.
//!
//! ## Compatibility rules
//! - Returns structured results only; user-facing warning/error text stays in caller adapters.
//! - Exit-code mapping stays in caller crates.
//! - APIs stay domain-neutral and must not encode crate-specific UX policies.
//! - Quoting and ANSI differences are expressed via explicit mode/policy parameters.
//!
//! ## Determinism contract (Resolved Decision #9)
//!
//! `nils-agent-runtime` consumes this crate on its render path, so
//! `std::collections::HashMap`, `std::time::SystemTime::now`, and
//! `chrono::Utc::now` are forbidden inside this crate. The crate-wide
//! `#![deny(...)]` below pairs with `clippy.toml` to make every
//! violation a build failure. Use `IndexMap` or `BTreeMap` for any map
//! that wants stable iteration. Source:
//! `agent-runtime-kit/docs/source/inventory-target-architecture.md`
//! → Resolved Decision #9.
#![deny(clippy::disallowed_types, clippy::disallowed_methods)]

pub mod cli_contract;
pub mod clipboard;
pub mod coordination_projection;
pub mod diag_output;
pub mod env;
pub mod fs;
pub mod git;
pub mod markdown;
pub mod process;
pub mod provider_payload;
pub mod provider_runtime;
pub mod provider_usage;
pub mod rate_limits_ansi;
pub mod redact;
pub mod shell;
pub mod slug;
pub mod usage_cache_policy;
pub mod usage_time;

pub fn greeting(name: &str) -> String {
    format!("Hello, {name}!")
}

#[cfg(test)]
mod tests {
    use super::*;
    use pretty_assertions::assert_eq;

    #[test]
    fn greeting_formats_name() {
        let result = greeting("Nils");
        assert_eq!(result, "Hello, Nils!");
    }
}