Skip to content

chore(weave): add audio/media data flow doc for security review#6661

Draft
tssweeney wants to merge 3 commits intomasterfrom
tssweeney/audio-dataflow-doc
Draft

chore(weave): add audio/media data flow doc for security review#6661
tssweeney wants to merge 3 commits intomasterfrom
tssweeney/audio-dataflow-doc

Conversation

@tssweeney
Copy link
Copy Markdown
Collaborator

Description

Adds AUDIO_DATAFLOW.md, a concise few-pager describing how audio bytes (mp3 / wav / flac / ogg / m4a) travel from the Python SDK through the Weave service to blob or database storage when bucket storage is enabled. The doc is aimed at external security reviewers and covers: architecture, write/read sequence diagrams, security properties (TLS, at-rest encryption, auth, SHA-256 integrity, tenant isolation, no direct blob URLs), and the operator-facing configuration controls.

Testing

Verified mermaid diagrams render. No code changes.

Adds AUDIO_DATAFLOW.md describing how audio files travel from the
Python SDK through the Weave service to blob or database storage when
bucket storage is enabled. Intended as a few-pager for customer
security reviewers: architecture diagram, write/read sequence diagrams,
and a summary of transit/at-rest encryption, auth, integrity, and
tenant isolation properties.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@wandbot-3000
Copy link
Copy Markdown

wandbot-3000 Bot commented Apr 21, 2026

tssweeney and others added 2 commits April 20, 2026 17:29
Annotate the HTTPS messages in the write and read sequence diagrams
with their endpoint paths (/file/create, /call/start and /call/end,
/file/content) so reviewers can correlate the flows with observable
traffic.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
List the WF_FILE_STORAGE_* environment variables that control bucket
routing (URI, allow list, ramp percent) and provider credentials
(AWS / GCS / Azure), so security reviewers and operators can reference
the actual knobs.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 21, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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.

1 participant