relayburn-sdk: implement search + export_ledger + export_stamps verbs

[willwashburn]

Summary

Fill in `crates/relayburn-sdk/src/export_verbs.rs` with the three new verbs from the #259 redesign:

• `search(SearchQueryOptions) -> Result` — FTS5 over content blobs, BM25-ranked hits with snippets.
• `export_ledger(ExportLedgerOptions) -> Result<impl Iterator<Item = serde_json::Value>>` — emits the event stream as JSONL-shaped values for `jq` / audit-trail consumers.
• `export_stamps(ExportStampsOptions) -> Result<impl Iterator<Item = serde_json::Value>>` — same pattern for the stamps table.

Each verb is callable as a `LedgerHandle` method and as a free function. Exports use the buffered approach (write into a `Vec`, split on newlines, parse each line) — relayburn ledgers are small enough that this is fine, and the iterator surface lets us add a streaming variant later.

Part of #246.

Test plan

• `cargo test -p relayburn-sdk` — 6 passed (FTS5 hit, session-filter scope, limit cap, free-function ledger open, export turn round-trip, export stamp round-trip)
• `cargo test --workspace` green
• `cargo doc --no-deps -p relayburn-sdk` clean

Stacking

Stacked on #300 (module stubs) — base is `claude/sdk-module-stubs` and will rebase to `main` once that lands.

🤖 Generated with Claude Code

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR introduces a new export_verbs.rs module to the relayburn-sdk crate that provides public APIs for searching ledger content via FTS5 and exporting ledger and stamp data as JSONL. The module exports option structs, result types, and both method and free-function variants of search, export_ledger, and export_stamps operations.

Changes

Search and Export Verbs

Layer / File(s)	Summary
Data Shapes crates/relayburn-sdk/src/export_verbs.rs (lines 17–66)	SearchQueryOptions, SearchResult, ExportLedgerOptions, and ExportStampsOptions define the public API contracts for search and export operations, with optional limit, session filtering, and ledger home overrides.
Core Implementation crates/relayburn-sdk/src/export_verbs.rs (lines 67–179)	LedgerHandle methods and free functions implement search (building a lower-level SearchOptions and delegating to inner.search_content) and export operations (streaming JSONL via inner.export_ledger_jsonl and inner.export_stamps_jsonl).
Helper Utilities crates/relayburn-sdk/src/export_verbs.rs (lines 180–194)	parse_jsonl_lines splits JSONL buffers and deserializes each line into serde_json::Value objects for consumption by export iterators.
Tests & Documentation crates/relayburn-sdk/src/export_verbs.rs (lines 195–387)	Comprehensive test suite covers search query execution, limit enforcement, session filtering, and both ledger and stamp export flows via method and free-function variants.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• AgentWorkforce/burn#300: Implements the actual search and export verb logic that builds on the scaffolding introduced here.
• AgentWorkforce/burn#299: The prior scaffold that this module builds upon with concrete implementations.

Poem

🐰 A rabbit hops through ledgers deep,
With FTS5 secrets to keep,
Search and export, JSONL streams,
Making data dance, or so it seems!
Let the verbs fly, the queries sing—
New SDK powers on the wing! ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main changes: implementing three verbs (search, export_ledger, export_stamps) in the relayburn-sdk, which matches the primary purpose of the changeset.
Description check	✅ Passed	The description is directly related to the changeset, providing clear details about the three implemented verbs, their signatures, usage patterns, test coverage, and the overall objective of filling in the export_verbs.rs module.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch claude/sdk-export-search

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}