agent-first-data 0.32.0

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.
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

{
  "$schema": "https://cmn.dev/schemas/v1/spore-core.json",
  "id": "agent-first-data",
  "name": "Agent-First Data",
  "version": "0.32.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": [
    "Add a declared value-source grammar so any string argument can accept its value indirectly — env:NAME, file:PATH#DOT_PATH, stdin, fd:N, prompt — with literal: as the escape for a value that begins with a recognized prefix",
    "Return credentials from a value source as SecretString, which renders as *** under Debug and Display and exposes the value only through an explicit expose_secret boundary",
    "Classify and reject a malformed or unaccepted value source in the CLI registry as cli_invalid_argument_value, before any config, filesystem, terminal, network, or domain I/O",
    "Let a host declare its own source scheme, validated against the reserved built-in names, so a host-read source appears in help and validation beside the built-ins",
    "Reject the prompt source on an argument whose id does not end in _secret, because prompting blocks on a terminal and suppresses echo",
    "Retire the afdata CLI's private --secret-from reader in favor of the shared value-source library, keeping the flag's opt-in shape and its released error wording",
    "Read INI entries appearing before the first section header as document root keys addressed by bare name, refusing a document where a root key and a section share a name",
    "Add file+FORMAT:PATH#DOT_PATH so a source can name its document parser when the filename cannot, with the format before the colon so a Windows drive letter is never mistaken for it",
    "Share one Format::from_cli_name table between value sources and the afdata CLI's --input-format instead of maintaining two"
  ],
  "bonds": [],
  "tree": {
    "algorithm": "blob_tree_blake3_nfc",
    "exclude_names": [
      ".git",
      ".cmn"
    ],
    "follow_rules": [
      ".gitignore"
    ]
  }
}