Skip to content

OpenBrain v1.0.1

Latest

Choose a tag to compare

@rinfa0108 rinfa0108 released this 11 Mar 17:51
· 4 commits to main since this release
bb4ecfd

OpenBrain v1.0.1

Patch release focused on write-path reliability and replay safety for production ingest flows, with no breaking API
changes.

Highlights

  • Enforced write idempotency ledger on OSS write path (idempotency_key now replay-safe).
  • Deterministic write receipts added (additive response metadata).
  • HTTP and MCP parity for idempotency behavior.
  • New DB-backed tests for replay, mismatch rejection, workspace scoping, bounded receipts, and persistence across
    reconnects.
  • README/runtime truth-sync documentation cleanup.

What Changed

Reliability: Idempotent Writes + Receipts

  • First write with (workspace, idempotency_key) writes normally and stores a receipt.
  • Replay with same key + same payload returns prior receipt with replayed=true and does not duplicate objects/
    events.
  • Same key + different payload is rejected deterministically with:
    • OB_INVALID_REQUEST
    • reason_code=OB_IDEMPOTENCY_KEY_REUSE_MISMATCH

Additive Write Response Fields

POST /v1/write / openbrain.write now include additive receipt metadata (non-breaking):

  • replayed
  • request_id (optional)
  • accepted_count
  • object_ids (bounded)
  • receipt_hash (optional)

Compatibility

  • v1.0.1 is backward-compatible with v1.0.0 clients.
  • No endpoint renames, no schema-breaking contract changes.
  • Response additions are optional/additive only.

Upgrade Notes

  • Apply latest migrations before running production writes.
  • Recommended for webhook/event ingest users needing replay safety.

Known Follow-up

  • Future-incompat warning from sqlx-postgres remains tracked in follow-up IT13B / IT9C.2.