{
"$schema": "https://cmn.dev/schemas/v1/spore-core.json",
"id": "agent-first-data",
"name": "Agent-First Data",
"version": "0.35.0",
"domain": "agentfirstkit.com",
"key": "ed25519.BwbSzqdDYyMN1pPW5snRk3afrJAovHn8aueMvDpfNKVw",
"synopsis": "A naming convention that lets AI agents understand your data without being told what it means, plus a CLI and library for reading Markdown structure and safely editing structured JSON, TOML, YAML, dotenv, and INI documents.",
"intent": [
"Encode all semantic information in the field name itself so agents parse structured data without external schemas, documentation, or type systems — _ms/_s/_epoch_ms for time, _msats/_sats/_usd_cents for currency, _bytes for size, _secret for auto-redaction",
"Define a JSONL output protocol where every line carries a kind discriminator (result, error, progress, or log), a payload field named after that kind, and a trace object for execution context (duration, token counts, cost, data source) — same structure whether the transport is CLI stdout, HTTP response body, MCP tool result, or SSE stream",
"Provide three output formats via --output json|yaml|plain: JSON is the canonical lossless format, YAML preserves structure with quoted strings and --- separators, plain applies suffix-driven human formatting (epoch_ms → RFC 3339, _bytes → human-readable, _secret → ***, _ms ≥ 1000 → seconds)"
],
"license": "MIT",
"mutations": [
"Fail closed on a _url value that is not a clean URL but contains ://, so a secret behind a BOM, zero-width space, control character, or label no longer leaks",
"Keep CRLF line endings on dotenv and TOML edits; dotenv no longer doubles a key's first character on CRLF files",
"Write a TOML string containing a newline as a single-line escaped string, so the stored value is the one set",
"Cap CLI document file reads at 16 MiB by default, adjustable with --max-file-bytes on every document command and lint",
"Use one explicit grammar for YAML numeric-key quoting, Plain quoting, and _url whitespace across Rust, Go, Python, and TypeScript",
"Send render output where --output-to says",
"Exit 0 when the stdout reader closes early, in the Rust CLI and the Python and TypeScript emitters",
"Upgrade noyalib to 0.0.53"
],
"bonds": [],
"tree": {
"algorithm": "blob_tree_blake3_nfc",
"exclude_names": [
".git",
".cmn"
],
"follow_rules": [
".gitignore"
]
}
}