agent-first-data 0.29.1

{
  "$schema": "https://cmn.dev/schemas/v1/spore-core.json",
  "id": "agent-first-data",
  "name": "Agent-First Data",
  "version": "0.29.1",
  "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": [
    "Scope reserved argument names to where AFDATA actually parses them: --version and --docs are reserved at the root command only, so a subcommand may declare its own --version VALUE business argument instead of being forced to rename it",
    "Add write_raw so a CLI compiled from a registry no longer hand-rolls the write for --docs, plain help and other raw documents: AFDATA injects those outcomes, so it owns stream routing and the rule that a closed reader (tool --docs | head) is success rather than a failure exit code",
    "Fix the TOML document editor so unset can remove a key inside an inline table that set can already write, preserving the table's closing whitespace",
    "Drop the unread command_path and argument_names fields from CliError; the command path is already in hint and the offending argument in message",
    "Correct shipped documentation that no longer matched the code: the tracing layer writes to stderr not stdout, the Go export is BuildCLIError, --help-combination never shipped, and cli-spec-v1 is an authoring contract with no runtime export"
  ],
  "bonds": [],
  "tree": {
    "algorithm": "blob_tree_blake3_nfc",
    "exclude_names": [
      ".git",
      ".cmn"
    ],
    "follow_rules": [
      ".gitignore"
    ]
  }
}