[aicayzer]

Summary

The Readwise and Readwise Reader catalog pages now describe the highlight title and body fields, the date, time and address field kinds, original_values, and the schema step an existing install needs. This matches withmarfa/marfa-connectors#308, which should merge first, because these pages link to the README section it adds.

Changes

• Readwise: under Types it writes, a paragraph on title and body (the title is the passage's first paragraph, where a blank line ends one and a heading is one of its own, without leading list or quotation markers, a permalink mark or a gap before closing punctuation) and one on field kinds and original_values. Under What to know, the upgrade step and what the first run does.
• Readwise Reader: how the highlight body and title are chosen (the title from the export passage, or Reader's when the export has no words, ended by a heading in either), title and body listed as read only under What goes back, and a link to the upgrade section from the schema bullet.

Testing

• pnpm test passes (39 files, 709 tests), including the content lint and the link check.
• Each claim was checked against the connector code and tests in fix(readwise): give highlights titles and declare field kinds marfa-connectors#308, and the upgrade behavior against a script run on the proof's pinned server.
• Not tested: the rendered pages in a browser. The README anchor resolves only once fix(readwise): give highlights titles and declare field kinds marfa-connectors#308 merges.

Notes for reviewers

A light review is enough: two catalog pages, with every fact taken from the connector change.

Checklist

• The title is a scoped Conventional Commit.
• New behavior has a test that was seen failing first, or no test was needed and the reason is above.
• Docs, comments and the contract still say what is true after this change.

[aicayzer]

Review depth: reviewed with withmarfa/marfa-connectors#308 over two rounds.