agent-first-data 0.25.0

A naming convention that lets AI agents understand your data without being told what it means, plus a CLI and library for reading and safely editing structured JSON, TOML, YAML, dotenv, and INI documents.
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

//! Format-independent document values: dot-path get/set/add/remove, type-directed
//! CLI-string coercion, keyed-list (slug-addressed array) helpers, and typed
//! serde adapters, backed by pluggable JSON/TOML/YAML/dotenv/INI format readers
//! and writers.
//!
//! # Features
//!
//! JSON support is always compiled in — `agent_first_data` already depends on
//! `serde_json` as a core dependency.
//!
//! - **toml**: Enable TOML format support (format-preserving with toml_edit)
//! - **yaml**: Enable YAML format support with CST-backed source-preserving mutation
//! - **dotenv**: Enable source-preserving dotenv format support
//! - **ini**: Enable INI Core v1 format support
//! - **schema**: Enable the `CliSchema` trait and documentation rendering
//!
//! This module never redacts values on decode/encode/save — it returns and
//! saves raw values as-is; redaction is the caller's responsibility.

pub mod coerce;
pub mod error;
pub mod file;
pub mod keyed;
pub mod path;
pub mod traverse;
pub mod typed;
pub mod value;

pub mod format;

#[cfg(feature = "schema")]
pub mod schema;

pub use coerce::{
    ScalarKind, ValueType, coerce_toward, coerce_values_toward, guard_bare_overwrite, scalar_kind,
    value_from_type, value_matches_type,
};
pub use error::{DocumentError, DocumentResult};
pub use file::{Document, DocumentFile};
pub use keyed::{KeyedList, add_keyed, remove_keyed};
pub use path::{join_path, parse_path};
pub use traverse::{get_path, get_path_ref, set_path, unset_path};
pub use typed::{from_value, to_value};
pub use value::Value;

pub use format::Format;

#[cfg(feature = "schema")]
pub use schema::{
    CliSchema, FieldDef, render_annotated_toml, render_annotated_yaml, render_doc_markdown,
};