test: add search, memory, and admin HTTP integration tests; update README/CHANGELOG

Author: josedab

CHANGELOG.md

@@ -8,6 +8,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- Moonshot HTTP modules under `streamline_sdk`:
+  - `branches_admin.BranchesClient` (M5)
+  - `contracts.ContractsClient` (M4)
+  - `attestation.AttestationClient` (M4)
+  - `search.SearchClient` (M2)
+  - `memory.MemoryClient` (M1)
+- Each client is sync-friendly and uses `httpx` under the hood.
+
 ### Added
 - Admin: `cluster_info()` — cluster overview including broker list
 - Admin: `consumer_group_lag()` / `consumer_group_topic_lag()` — consumer group lag monitoring

README.md

@@ -324,6 +324,55 @@ Run any example:
 python examples/basic_usage.py
 ```
 
+## Moonshot Features
+
+> ⚠️ **Experimental** — These features require Streamline server 0.3.0+ with moonshot feature flags enabled.
+
+### Semantic Search
+
+Query topics by meaning instead of offset. Requires a topic created with `semantic.embed=true`.
+
+```python
+results = await consumer.search("logs.app", "payment failure", k=10)
+for hit in results:
+    print(f"[p{hit.partition}] offset={hit.offset} score={hit.score:.2f}")
+```
+
+### Attestation Verification
+
+Verify cryptographic provenance attestations attached to records by data contracts.
+
+```python
+from streamline_sdk import StreamlineVerifier
+
+verifier = StreamlineVerifier(public_key_bytes)
+result = verifier.verify(record)
+print(f"Verified: {result.verified}, Producer: {result.producer_id}")
+```
+
+### Agent Memory (MCP)
+
+Use Streamline as persistent memory for AI agents via the MCP protocol.
+
+```python
+from streamline_sdk import MemoryClient
+
+memory = MemoryClient("http://localhost:9094/mcp/v1")
+await memory.remember("user prefers dark mode", tags=["preferences"])
+results = await memory.recall("user preferences", k=5)
+```
+
+### Branched Streams
+
+Create topic branches for replay, A/B testing, or counterfactual analysis.
+
+```python
+branch = await admin.create_branch("events", "experiment-v2")
+# Consume from the branch independently
+async for msg in consumer.consume(branch.topic):
+    process(msg)
+```
+
 ## Contributing
 
 Contributions are welcome! Please see the [organization contributing guide](https://github.com/streamlinelabs/.github/blob/main/CONTRIBUTING.md) for guidelines.