# MANIFEST: toml updated: 2026-08-16T12:22:22+00:00 state: approved blocks: 8 planning_feedback: | analyze-display_name applied ARCHITECTURE.md analyze-short_description applied ARCHITECTURE.md applied: ARCHITECTURE.md=0345a497799dd4903923852244d1cf493fb2f964,ARCHITECTURE_compact.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Arrays-Inline.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Conformance.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Datetimes.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Decoder-Contract.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Keys.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Lexical-Boundaries.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Lexical-Scalars.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Strings.md=0345a497799dd4903923852244d1cf493fb2f964,FEATURE-Tables.md=0345a497799dd4903923852244d1cf493fb2f964,common.md=0345a497799dd4903923852244d1cf493fb2f964,full_test.sh=0345a497799dd4903923852244d1cf493fb2f964,go.md=0345a497799dd4903923852244d1cf493fb2f964,run_conformance.sh=0345a497799dd4903923852244d1cf493fb2f964,setup_harness.sh=0345a497799dd4903923852244d1cf493fb2f964,stage_contract.sh=0345a497799dd4903923852244d1cf493fb2f964,stage_test.sh=0345a497799dd4903923852244d1cf493fb2f964,toml-v1.0.0.md=0345a497799dd4903923852244d1cf493fb2f964 applied_specs: | ARCHITECTURE.md sha256=6646ccb2ae8ad921dc31d34da5e69944e93580c2c27202b96b0aca8e9fa9b284 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-1 applied_at=2026-08-16T12:26:09+00:00 build_sha256=1b77ff4b1e495d6d32d7ef3b825d75c95f06f495cdbe94ee06aca4f74831d8fc ARCHITECTURE_compact.md sha256=65b8417ac4704c76603773a940a26ce0f26b27cbdaee514c8fb70f3435f5b019 commit=- applied_by=block-8 applied_at=2026-08-16T13:04:01+00:00 build_sha256=65b8417ac4704c76603773a940a26ce0f26b27cbdaee514c8fb70f3435f5b019 FEATURE-Arrays-Inline.md sha256=c9825f443a74c80b060a569b9309aa7b384cefec54a7da4c9cb183ddf4b83f12 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-7 applied_at=2026-08-16T13:01:16+00:00 build_sha256=9a49d707332a79f82d47a38e4b273f237350c21190bdb68c91abcdbf981017e6 FEATURE-Conformance.md sha256=239b33c310c26fa58cc1c9e8f467ad78f65a520df876943457cc67a47423010a commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-8 applied_at=2026-08-16T13:04:01+00:00 build_sha256=5e43959f7cec9cae36ba5a39134cd9daf3740b85b64a2c7427984305a73fb2ea FEATURE-Datetimes.md sha256=21a2ed9a7ea7e847f2b509ac0a55427dabea12f576725f166b246e2429314f14 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-6 applied_at=2026-08-16T12:56:44+00:00 build_sha256=d5cb0e0fe2d7efcf59fc1cdf310024883363da11f99eb4942bea3c1b8de27b61 FEATURE-Decoder-Contract.md sha256=f102f9780aed8c0c0cf02fdcf708585559579c8b5e2636dae1a2f35cb93b8d36 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-2 applied_at=2026-08-16T12:28:17+00:00 build_sha256=3b6378a91d595f57abbe2e1ac77dc67aaa386f3259ab98a9196dbf3eeffc64a5 FEATURE-Keys.md sha256=6128a55dc0a6e896540f6757b3c1aa914da129a7f16dc51f0848866d1ea9ad07 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-3 applied_at=2026-08-16T12:37:18+00:00 build_sha256=c991eeae78dd3c1ea2fdc39e6352116851aaba1c824c2a9ce65d635875d98f03 FEATURE-Lexical-Boundaries.md sha256=e298b34f95fc662f043945074795de0bea3805294e9edf3155c15fdd71728aab commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-5 applied_at=2026-08-16T12:48:00+00:00 build_sha256=12c2e4b00ccef4f55384cd686949c77866efd1088cc14b715a419862a8450abf FEATURE-Lexical-Scalars.md sha256=af7b4b7d8d7e0f33ac4da5f9ec12ea61fb2bfbd90ef61799b9f2bfbb63487bbb commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-4 applied_at=2026-08-16T12:42:49+00:00 build_sha256=f881e9028d024677566e2f4813b156c183980358d8d0191010139127592a6d7a FEATURE-Strings.md sha256=cc413121a98db193bf3d0aa72117538945d1e4fd79b1815d5960e2fcf4a8e3a1 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-3 applied_at=2026-08-16T12:37:18+00:00 build_sha256=6054c5a82b1b5537fbdc354185b4c970371ebb0b9e40fb0038f74cdc2a032aba FEATURE-Tables.md sha256=b9b2fb4b527832c5c6d09e9a6995d2fa38981a9435bcc8ae6045de9f9bb4944f commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-6 applied_at=2026-08-16T12:56:44+00:00 build_sha256=e4103fd0341694ff427a077f8e2bd49723b05820ba6b1cf19c1e08ab6b3b990f full_test.sh sha256=54fcd3c5b0b92e31d7c4c90c3a04ff65617600dcd858947455cda8fbcb2800a6 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-8 applied_at=2026-08-16T13:04:01+00:00 build_sha256=54fcd3c5b0b92e31d7c4c90c3a04ff65617600dcd858947455cda8fbcb2800a6 run_conformance.sh sha256=15ecb784a928f4835ca1620341fcaf8af6bcf97ffd26aa8946c9ceecff475afe commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-8 applied_at=2026-08-16T13:04:01+00:00 build_sha256=15ecb784a928f4835ca1620341fcaf8af6bcf97ffd26aa8946c9ceecff475afe setup_harness.sh sha256=a94f9cee6ae45b4265e244f40b882f9692f59c67aff16953d2db837fb3885a56 commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-8 applied_at=2026-08-16T13:04:01+00:00 build_sha256=a94f9cee6ae45b4265e244f40b882f9692f59c67aff16953d2db837fb3885a56 stage_contract.sh sha256=c95f3a314d9d8099bf27a64404a7eba213710c2948d41c1ce6c44f87f225227b commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-2 applied_at=2026-08-16T12:28:17+00:00 build_sha256=c95f3a314d9d8099bf27a64404a7eba213710c2948d41c1ce6c44f87f225227b stage_test.sh sha256=93254a9d7ac72f19345b48fc36faffb1dc79dcc66f55cf18fee48c2cdce988cd commit=f6ff6797304818caa07e183da3f753a909ce5250 applied_by=block-7 applied_at=2026-08-16T13:01:16+00:00 build_sha256=93254a9d7ac72f19345b48fc36faffb1dc79dcc66f55cf18fee48c2cdce988cd ## story 1: Establish the standard-library-only Go module and decoder command. id: architecture evidence: evidence/block-1.md summary: Establish the standard-library-only Go module and decoder command. type: foundational kind: capability phase: 1 block: 1 implements: ARCHITECTURE.md covers: ARCHITECTURE-001 stack: go.md, common.md stack_mode: builder size: 9127 provides: cmd/toml-decoder, internal/toml, Go module instructions: | Create the Go module and command structure required by the supplied build path. Use only the standard library and keep cmd/toml-decoder compilable. acceptance: yes state: closed/verified scope: target ## story 2: Implement the TOML decoder stdin, tagged-JSON, diagnostic, and exit-status contract. id: decoder-contract evidence: evidence/block-2.md summary: Implement the TOML decoder stdin, tagged-JSON, diagnostic, and exit-status contract. type: service kind: capability phase: 1 block: 2 implements: FEATURE-Decoder-Contract.md covers: ARCHITECTURE-002 context: stage_contract.sh, ARCHITECTURE_compact.md stack: go.md, common.md stack_mode: consumer size: 8802 provides: stdin TOML decoder, tagged JSON stdout, stderr diagnostics consumes: internal/toml instructions: | Implement the executable boundary around the parser. Read only stdin, emit the required tagged JSON on successful parses, and emit diagnostics only on stderr with a non-zero exit for invalid input. acceptance: yes depends: architecture state: closed/verified scope: target ## story 3: Parse TOML basic, literal, and multiline string values. id: parser-strings evidence: evidence/block-3.md summary: Parse TOML basic, literal, and multiline string values. type: service kind: capability phase: 1 block: 3 implements: FEATURE-Strings.md covers: STRINGS-001, STRINGS-002 context: toml-v1.0.0.md, stage_test.sh, ARCHITECTURE_compact.md stack: go.md stack_mode: consumer size: 11272 provides: TOML string parsing consumes: internal/toml instructions: | Implement all TOML 1.0.0 basic, literal, multiline basic, and multiline literal string forms, including escapes, trimming, continuation, delimiters, Unicode, and prohibited-control validation. Bind acceptance to the string conformance slice. acceptance: yes depends: architecture state: closed/verified scope: target ## story 4: Parse TOML key forms and enforce key-definition semantics. id: parser-keys evidence: evidence/block-3.md summary: Parse TOML key forms and enforce key-definition semantics. type: service kind: capability phase: 1 block: 3 implements: FEATURE-Keys.md covers: KEYS-001, KEYS-002 context: toml-v1.0.0.md, stage_test.sh, ARCHITECTURE_compact.md stack: go.md stack_mode: consumer size: 11187 provides: TOML bare, quoted, dotted, and duplicate-key semantics consumes: internal/toml instructions: | Implement bare, quoted, and dotted keys with nested assignment. Track ownership and reject duplicate keys, scalar-to-table conversion, and other prohibited redefinitions. Bind acceptance to the key conformance slice. acceptance: yes depends: architecture, parser-strings state: closed/verified scope: target ## story 5: Parse TOML booleans, integers, and floating-point scalar values. id: parser-lexical-scalars evidence: evidence/block-4.md summary: Parse TOML booleans, integers, and floating-point scalar values. type: service kind: capability phase: 1 block: 4 implements: FEATURE-Lexical-Scalars.md covers: SCALARS-001, SCALARS-002 context: toml-v1.0.0.md, stage_test.sh, ARCHITECTURE_compact.md stack: go.md stack_mode: consumer size: 11317 provides: TOML boolean, integer, and float parsing consumes: internal/toml instructions: | Implement booleans, signed 64-bit decimal and base-prefixed integers, decimal floats, exponents, underscores, signed zero, infinity, and NaN. Preserve integer values losslessly and bind acceptance to the boolean, integer, and float slices. acceptance: yes depends: architecture state: closed/verified scope: target ## story 6: Handle TOML comments, whitespace, line endings, UTF-8, and control-character rules. id: parser-lexical-boundaries evidence: evidence/block-5.md summary: Handle TOML comments, whitespace, line endings, UTF-8, and control-character rules. type: service kind: capability phase: 1 block: 5 implements: FEATURE-Lexical-Boundaries.md covers: LEXICAL-001, LEXICAL-002 context: toml-v1.0.0.md, stage_test.sh, ARCHITECTURE_compact.md stack: go.md stack_mode: consumer size: 11280 provides: TOML lexical boundary validation consumes: internal/toml instructions: | Implement comment handling, permitted whitespace and line endings, invalid UTF-8 rejection, and prohibited control-character rejection across applicable contexts. Bind acceptance to the comment, control, and encoding conformance slices. acceptance: yes depends: architecture state: closed/verified scope: target ## story 7: Parse standard tables and arrays of tables with ordering and conflict rules. id: parser-tables evidence: evidence/block-6.md summary: Parse standard tables and arrays of tables with ordering and conflict rules. type: service kind: capability phase: 2 block: 6 implements: FEATURE-Tables.md covers: TABLES-001, TABLES-002, TABLES-003 context: toml-v1.0.0.md, stage_test.sh, ARCHITECTURE_compact.md stack: go.md stack_mode: consumer size: 11213 provides: TOML standard tables and arrays-of-tables semantics consumes: internal/toml instructions: | Implement implicit and explicit tables, table lifecycle tracking, arrays of tables, most-recent-element targeting, nested paths, and all ordering and conflict validations. Bind acceptance to the table conformance slice. acceptance: yes depends: parser-keys state: closed/verified scope: target ## story 8: Parse and format TOML offset and local date/time values. id: parser-datetimes evidence: evidence/block-6.md summary: Parse and format TOML offset and local date/time values. type: service kind: capability phase: 2 block: 6 implements: FEATURE-Datetimes.md covers: DATETIMES-001, DATETIMES-002 context: toml-v1.0.0.md, stage_test.sh, ARCHITECTURE_compact.md stack: go.md stack_mode: consumer size: 11267 provides: TOML datetime, local datetime, local date, and local time parsing consumes: internal/toml instructions: | Implement validation and tagged formatting for offset datetimes, local datetimes, local dates, and local times, including fractional precision truncation and invalid forms. Bind acceptance to the datetime conformance slices. acceptance: yes depends: architecture state: closed/verified scope: target ## story 9: Parse arrays and inline tables with closure and conflict semantics. id: parser-arrays-inline evidence: evidence/block-7.md summary: Parse arrays and inline tables with closure and conflict semantics. type: service kind: capability phase: 2 block: 7 implements: FEATURE-Arrays-Inline.md covers: ARRAYS-001, ARRAYS-002, ARRAYS-003 context: toml-v1.0.0.md, stage_test.sh, ARCHITECTURE_compact.md stack: go.md stack_mode: consumer size: 11442 provides: TOML arrays and inline-table parsing consumes: internal/toml instructions: | Implement nested and multiline arrays, comments and trailing commas, inline tables, nested inline keys, prohibited newlines and trailing commas, closure rules, and conflicts with later table definitions. Bind acceptance to the array and inline-table conformance slices. acceptance: yes depends: parser-keys, parser-tables state: closed/verified scope: target ## story 10: Assemble the completed parser and verify the complete TOML 1.0.0 suite. id: conformance evidence: evidence/block-8.md summary: Assemble the completed parser and verify the complete TOML 1.0.0 suite. type: feature kind: test harness phase: 3 block: 8 implements: FEATURE-Conformance.md covers: CONFORMANCE-001 accepts: st-001 context: full_test.sh, run_conformance.sh, setup_harness.sh, ARCHITECTURE_compact.md stack: go.md, common.md stack_mode: consumer size: 6929 provides: complete TOML 1.0.0 conformance verdict consumes: cmd/toml-decoder, sources/full_test.sh instructions: | Assemble the completed decoder and run the supplied unfiltered full conformance command. Preserve all scoring assets and require the terminal suite to exit zero. acceptance: yes depends: decoder-contract, parser-strings, parser-lexical-scalars, parser-lexical-boundaries, parser-keys, parser-tables, parser-arrays-inline, parser-datetimes state: closed/verified scope: target