docs: document embedding workflow

[alltheseas]

Summary

- add a getting-started section that covers cloning, building libnostrdb, and linking requirements
- provide lifecycle examples for ingestion, querying, fulltext search, data access, and subscriptions
- document event-building helpers and how to regenerate the Swift/Rust/C bindings

## Testing
- not required (documentation-only change)