API changelog

0.1.0 — initial public pre-release

The first public API surface. There is no dated API-version header and no version-pin — Brain has one current protocol (see API & wire versioning). Requests carry only the credential (Authorization: Bearer <key> or X-API-Key: <key>).

What the surface covers:

• Memory data plane — POST /v1/memories (encode), GET /v1/memories (list), DELETE /v1/memories (forget), GET /v1/memories/{id}/inspect, and the single read verb POST /v1/recall returning a single / many / none membership verdict.
• Memory graph — POST / DELETE /v1/links (directed edges between memories).
• Typed graph — POST / GET /v1/entities, POST /v1/entities/resolve, GET /v1/entities/{id}, POST /v1/entities/{id}/traverse, GET /v1/entities/{id}/relations, GET /v1/statements(/{id}), GET /v1/relations/{id}, and the whole-graph export GET /v1/graph.
• Reasoning — POST /v1/plan, POST /v1/reason (edge builds only).
• Introspection — GET /v1/whoami, GET /v1/capabilities (edge builds only).
• Error envelope — a { error: { code, message } } body over nine categories (Protocol, Authentication, Authorization, Validation, NotFound, Conflict, ResourceExhausted, Internal, Unavailable); retryable failures carry a Retry-After hint.
• Wire protocol — BRN0 frames (32-byte header + CBOR payload + optional trailing f32 vectors), version negotiated in the handshake, exercised by the cross-language conformance corpus.