<requirement name="go-parser-architecture" stories="architecture">
The implementation language is Go, fixed by this Target's `TECHNOLOGY_STACK.md` and governed by `stack/go.md`.
</requirement>
<requirement name="stdin-tagged-json-contract" stories="decoder-contract">
The program is a filter: read TOML from **stdin**, write tagged JSON to **stdout**, exit `0`.
</requirement>
<requirement name="reject-invalid-toml" stories="decoder-invalid-input">
On invalid TOML, write a diagnostic to **stderr** and exit non-zero.
</requirement>
<requirement name="tagged-json-encoding" stories="decoder-tagged-json">
Every TOML **value** becomes `{"type": "<TOML_TYPE>", "value": "<TOML_VALUE>"}`.
</requirement>
<requirement name="parse-strings" stories="lexical-strings">
basic and literal strings, then multi-line strings with their line-ending backslash and trimming rules.
</requirement>
<requirement name="parse-scalars" stories="lexical-numbers">
**Scalars** — booleans, integers (including `0x`, `0o`, `0b`, underscores), floats (including `inf`, `nan`, exponents), basic and literal strings, then
</requirement>
<requirement name="parse-datetimes" stories="lexical-datetime">
**Datetimes** — offset, local datetime, local date, local time.
</requirement>
<requirement name="process-lexical-input" stories="lexical-whitespace-comments">
**Scaffolding** — line handling, comments, whitespace, the stdin/stdout/exit
contract, tagged JSON emission.
</requirement>
<requirement name="parse-key-forms" stories="keys-forms">
**Keys** — bare, quoted, and dotted keys; the redefinition rules.
</requirement>
<requirement name="parse-arrays" stories="structures-arrays">
**Inline tables and arrays** — including nesting and the TOML 1.0 restriction
that inline tables are closed to later extension.
</requirement>
<requirement name="enforce-key-semantics" stories="keys-semantics">
**Invalid-input hardening** — control characters, bad UTF-8, duplicate keys,
redefinition after an inline table, unterminated constructs.
</requirement>
<requirement name="parse-inline-tables" stories="structures-inline-tables">
**Inline tables and arrays** — including nesting and the TOML 1.0 restriction
that inline tables are closed to later extension.
</requirement>
<requirement name="close-inline-tables" stories="structures-inline-table-closure">
the TOML 1.0 restriction that inline tables are closed to later extension.
</requirement>
<requirement name="parse-standard-tables" stories="tables-standard">
**Tables** — `[table]`, `[a.b.c]` implicit creation, `[[array of tables]]`,
</requirement>
<requirement name="reject-table-redefinitions" stories="tables-redefinition">
and the rules governing which of these may follow which.
</requirement>
<requirement name="parse-arrays-of-tables" stories="tables-arrays">
`[[array of tables]]`
</requirement>
<requirement name="enforce-array-table-ordering" stories="tables-arrays-ordering">
the rules governing which of these may follow which.
</requirement>
<requirement name="pass-conformance-suite" stories="conformance">
Every supplied valid and invalid case passes: the failed, errored, and skipped
counts are all zero.
</requirement>Run artifact