You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Document that YAML quoted strings are normalized to bare scalars on output
(e.g. "100m" → 100m), affecting all keys not just those touched by the query.
This was the last undocumented behavior from the drift audit.
Add a "Known behaviors" callout to the README formats section listing all five
normalization behaviors in one place: comment stripping, YAML anchor expansion,
quoted-string normalization, TOML inline-table rewrite, and JSON compact output.
| YAML |`.yaml`, `.yml`| Single-document per file; anchors/aliases resolved on decode, not re-emitted |
64
64
| TOML |`.toml`| Tables and arrays of tables; nested tables emitted as inline syntax |
65
65
66
+
> **Known behaviors:** Comments are stripped from all formats on output. YAML anchors/aliases are resolved and not re-emitted. YAML quoted strings are normalized to bare scalars. TOML `[section]` headers are rewritten to inline-table syntax (`{key = value}`). JSON output is always compact (single-line). None of these affect the parsed value — only the serialized form.
67
+
66
68
Format is auto-detected from the file extension. Use `--format json|jsonl|yaml|toml` to override input format, and `--output-format json|yaml|toml` to transcode to a different output format.
Copy file name to clipboardExpand all lines: docs/examples/formats/index.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,7 @@
6
6
- **Comments** are not preserved across round-trips. This is an explicit non-goal for v1. If your files contain comments that matter, keep the source-of-truth file elsewhere and generate the deployed copy from it.
7
7
- **YAML anchors and aliases** are resolved on decode and not re-emitted. Output always contains the fully expanded values, not the original anchor references.
8
8
- **JSON output is always compact** (single-line, no indentation). `--pretty` currently only affects TOML output.
9
+
- **YAML quoted strings** are normalized to bare scalars on output. A value like `"100m"` becomes `100m`. This applies to all keys in the document, not only those touched by the query.
0 commit comments