Skip to content

docs: add Transaction Protocol guide + fix silent CSV size check#11270

Open
vystartasv wants to merge 2 commits intodeepset-ai:mainfrom
vystartasv:docs/transaction-protocol
Open

docs: add Transaction Protocol guide + fix silent CSV size check#11270
vystartasv wants to merge 2 commits intodeepset-ai:mainfrom
vystartasv:docs/transaction-protocol

Conversation

@vystartasv
Copy link
Copy Markdown

What This Adds

Two changes:

1. Transaction Protocol Integration Guide

TRANSACTION_PROTOCOL.md — documents how the Transaction Protocol adds idempotency, rollback, and audit trails to Haystack pipelines. Includes architecture diagram, code example wrapping a Haystack pipeline, and why it matters for production RAG deployments.

2. Bug Fix: Silent CSV Size Check

haystack/components/converters/csv.py — the os.stat() call for file size warning had a bare except Exception: pass. Added logger.debug() so operators can see which files failed size detection.

Why Transaction Protocol for Haystack

Haystack is the leading RAG framework in production. Production means:

  • API costs matter → idempotency prevents accidental re-execution
  • State integrity matters → rollback keeps systems consistent
  • Compliance matters → audit trails for regulated industries

References

vystartasv added 2 commits May 6, 2026 20:47
The os.stat() call for file size warning had a bare
except Exception: pass with no diagnostic output.
Added logger.debug() so operators can see which files
failed size detection.
@vystartasv vystartasv requested review from a team as code owners May 6, 2026 19:48
@vystartasv vystartasv requested review from bogdankostic and removed request for a team May 6, 2026 19:48
@vercel
Copy link
Copy Markdown

vercel Bot commented May 6, 2026

@vystartasv is attempting to deploy a commit to the deepset Team on Vercel.

A member of the Team first needs to authorize it.

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 6, 2026

CLA assistant check
All committers have signed the CLA.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants