docs: Audit and update upload documentation

Executed content-audit-agent. Audited content/docs/guides/upload-content.md against code. Added technical details about multipart uploads and troubleshooting steps.

Co-authored-by: PR0M3TH3AN <[email protected]>

content/docs/guides/upload-content.md

@@ -137,6 +137,8 @@ bitvid will verify your credentials by attempting to list or upload a test file.
 - **Missing Source:** "Provide a hosted URL, magnet link, or an imeta variant before publishing."
 - **Invalid URL Protocol:** "Hosted video URLs must use HTTPS."
 - **Storage Not Configured:** "Please configure storage before selecting a file."
+- **Invalid S3 Settings:** "Invalid S3 settings." Double-check your endpoint, region, and bucket name in the Storage configuration tab.
+- **Concurrent Uploads:** "Please wait for uploads to complete." The client currently supports uploading one video at a time to prevent memory exhaustion.
 - **CORS Errors ("Network Error"):** If uploads fail immediately or the console shows "CORS", verify your bucket's CORS policy matches the JSON above. Ensure `AllowedHeaders` includes `*`, `AllowedMethods` includes `PUT`, and `ExposeHeaders` lists `ETag`.
 - **Permission Errors ("Access Denied"):** Check your API credentials. Ensure the token has `Object Read & Write` permissions (specifically `s3:PutObject` and `s3:DeleteObject`).
 - **Browser Crashes / Slow Performance:** Large files (>2GB) can exhaust browser memory during the hashing process. Try using a smaller file or ensuring you have plenty of free RAM.
@@ -147,7 +149,7 @@ bitvid will verify your credentials by attempting to list or upload a test file.
 
 ### How Uploads Work
 
-1. **Direct Upload:** Your browser uploads the file directly to your storage bucket. No video data passes through a bitvid server.
+1. **Direct Upload:** Your browser uploads the file directly to your storage bucket using **Multipart Upload**. This ensures reliability for larger files by splitting them into chunks. No video data passes through a bitvid server.
 2. **External Link:** Your browser streams directly from the provided URL (or via WebTorrent if a magnet is also provided). No video data passes through the bitvid server.
 3. **Client-Side Hashing:** Your browser calculates a cryptographic hash (info hash) of the file locally to enable WebTorrent support. This happens in memory, so large files require sufficient RAM.
 4. **Publication:** The video metadata (title, URL, hash, tags) is signed by your Nostr key and published to relays.

context/CONTEXT_2026-02-14.md

@@ -0,0 +1,12 @@
+# Audit Goal
+Audit upload/contribution documentation in `/content` against code and runtime behavior.
+
+# Scope
+- Documentation: `content/docs/guides/upload-content.md`
+- Code: `js/services/r2Service.js`, `js/services/s3Service.js`, `js/ui/components/UploadModal.js`, `js/constants.js`
+
+# Branch
+`agents/daily/content-audit-agent`
+
+# Metadata
+- Date: 2026-02-14

decisions/DECISIONS_2026-02-14.md

@@ -0,0 +1,5 @@
+# Decisions
+
+- Decision: Audit `content/docs/guides/upload-content.md` as primary source.
+- Rationale: Most critical user-facing documentation for uploading.
+- Alternatives: Audit all of `content/` but `upload-content.md` is most relevant to the "content-audit-agent" mission.

docs/agents/task-logs/daily/2026-02-14_00-00-00_content-audit-agent_completed.md

@@ -0,0 +1,24 @@
+# Agent Completion Log
+
+- **Agent:** content-audit-agent
+- **Cadence:** daily
+- **Date:** 2026-02-14
+- **Status:** Completed
+- **Branch:** agents/daily/content-audit-agent
+
+## Summary
+Audited `content/docs/guides/upload-content.md` against the codebase. Verified claims regarding file types, size limits, and metadata fields.
+
+Updates made to documentation:
+1.  **Multipart Upload**: Clarified that direct uploads use multipart upload for reliability.
+2.  **Concurrency**: Added a note about the "one upload at a time" constraint.
+3.  **Troubleshooting**: Added "Invalid S3 Settings" error message.
+
+## Artifacts
+- `artifacts/docs-audit/2026-02-14/inventory.md`
+- `artifacts/docs-audit/2026-02-14/verification.md`
+- `artifacts/docs-audit/2026-02-14/validation.md`
+- `context/CONTEXT_2026-02-14.md`
+- `todo/TODO_2026-02-14.md`
+- `decisions/DECISIONS_2026-02-14.md`
+- `test_logs/TEST_LOG_2026-02-14.md`

test_logs/TEST_LOG_2026-02-14.md

@@ -0,0 +1,5 @@
+# Test Log 2026-02-14
+
+- [x] Initialized artifacts
+- [x] Verify claims (Validated against code in js/services/s3UploadService.js and js/ui/components/UploadModal.js)
+- [x] Validate updates (Documentation updated with correct technical details)

todo/TODO_2026-02-14.md

@@ -0,0 +1,5 @@
+- [x] Inventory claims from `content/docs/guides/upload-content.md`
+- [x] Verify claims against code
+- [x] Update `content/docs/guides/upload-content.md`
+- [x] Validate updated documentation
+- [x] Create PR