[ctawiah]

Context

JSON, YAML, and TOML sources need exact scalar edits and clear read-only rules.

What changes

• Add the JSON adapter with a span-tracking parser. Objects and arrays keep the indentation of the text that they replace.
• Add the YAML adapter on the shared YAML tree. A plain scalar keeps its full span, also when it contains a comma or a bracket.
• Add the TOML adapter with scalar and string-family updates.

Design notes

• Anchors, aliases, merge keys, block scalars, multi-line plain scalars, and arrays of tables are read-only.
• Duplicate keys fail before any edit.

Review focus

• Does a plain YAML scalar with a comma get the right span?
• Do the fuzz tests cover the string codecs?

Verification

• make build
• go test ./...
• golangci-lint run ./...

Related changes

1. refactor(sync): remove Phase 1 source references #1005: Phase 1 reference removal
2. feat(sync): add projection and problem core #987: projection and problem core
3. feat(sync): add the adapter core and the Markdown adapter #988: adapter core and Markdown
4. This PR: structured adapters
5. feat(sync): add the Python adapter #991: Python adapter
6. feat(sync): add the TypeScript and JavaScript adapters #992: TypeScript and JavaScript adapters
7. feat(sync): add source descriptor storage #993: descriptor storage
8. feat(sync): compile and publish repository sources #994: compile and publish
9. feat(sync): detach descriptor-backed sources #1003: descriptor detach
10. feat(sync): prepare repository source links #997: link preparation
11. feat(sync): integrate repository sources with planning and link #995: planning and link
12. feat(sync): add the link commands #998: link commands

🤖 Generated with Claude Code

---

Note

Overview
Adds JSON, YAML, and TOML sync adapters in structured/ that build adapter.Node trees with exact byte spans for targeted scalar edits, registered via init() alongside existing formats.

Shared adapter core: EncodeJSON skips HTML escaping; large integers beyond float64 precision stay read-only with original text (ExactInteger, container propagation in JSON); positional IDs, Node.Clone(), and richer reference error messages via annotateProblem.

JSON: Custom parser tracks spans, rejects duplicates/malformed input, preserves indentation on rewrite, and treats empty arrays as values (not null).

YAML: Thin wrapper over yamltree with multi-document read-only rules; yamltree now preserves &/< in quoted strings and splits integer vs float write semantics.

TOML: Header/array-table/inline/dotted-key graph with structural read-only tables but writable scalars; string family encoders; arrays of tables and oversized numbers read-only.

Extensive tests (including TOML string fuzz) and sample testdata.

^{Reviewed by Cursor Bugbot for commit 57aea94. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 8757695. Configure here.}