feature: storage agent references

[Rodriguespn]

Summary

Adds 7 Storage reference files covering the complete storage lifecycle:

• Access Control (storage-access-control): Bucket visibility, Storage RLS on storage.objects, helper functions (storage.filename(), storage.foldername(), storage.extension())
• Uploads (storage-upload-*): Standard uploads (< 6MB) with upsert and signed URLs, plus TUS resumable uploads for large files
• Downloads (storage-download-urls): Public URLs via getPublicUrl(), signed URLs for private content
• Transforms (storage-transform-images): On-the-fly resize, crop, format conversion (2500px/25MB/50MP limits)
• CDN (storage-cdn-caching): Smart CDN with automatic revalidation and immutable assets pattern
• File Ops (storage-ops-file-management): Move, copy, delete, list with pagination

Each reference addresses common pain points like "public bucket doesn't mean unrestricted uploads" and "never delete storage files via SQL." Updates SKILL.md, AGENTS.md, and _sections.md.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (2)

• !master
• !main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/storage-agent-references

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Rodriguespn]

Hey Storage team, I've gave this another look by comparing the information from the reference files and our documentation. Below is the changelog report with the changes for each file and the sources I used for each one.

---

storage-access-control.md — Fixed move operation from SELECT + UPDATE to SELECT + INSERT, fixed remove from SELECT + DELETE to just DELETE, added ::text cast to owner-based access pattern (owner_id = (select auth.uid()::text)).

• https://supabase.com/docs/guides/storage/management/copy-move-objects
• https://supabase.com/docs/guides/storage/management/delete-objects
• https://supabase.com/docs/guides/storage/security/ownership

storage-cdn-caching.md — Added query-string versioning bypass technique (?version=N), clarified cacheControl scope (browser-only with Smart CDN, influences CDN too without it), expanded cf-cache-status values from HIT/MISS to include STALE, REVALIDATED, UPDATING, EXPIRED, BYPASS, DYNAMIC.

• https://supabase.com/docs/guides/storage/cdn/smart-cdn#bypassing-cache
• https://supabase.com/docs/guides/storage/cdn/smart-cdn
• https://supabase.com/docs/guides/storage/cdn/metrics

storage-ops-file-management.md — Added 1,000-object limit on remove() calls, replaced simple delete folder pattern with recursive version handling nested subfolders and pagination, added 5GB size limit on move() and copy() operations.

• https://supabase.com/docs/guides/storage/management/delete-objects
• https://supabase.com/docs/guides/storage/management/copy-move-objects

storage-upload-resumable.md — Removed unused CreateMultipartUploadCommand import (dead code), fixed S3 Upload constructor to match docs (new Upload(s3, { Bucket, Key, ... }) instead of new Upload({ client, params })).

• https://supabase.com/docs/guides/storage/uploads/s3-uploads

storage-upload-standard.md — Clarified "up to 60 seconds" CDN stale content figure is Smart CDN (Pro+) specific, removed direct storage hostname tip (documented only for resumable uploads).

• https://supabase.com/docs/guides/storage/cdn/smart-cdn#cache-duration
• https://supabase.com/docs/guides/storage/uploads/resumable-uploads

storage-transform-images.md — Removed unsupported "may letterbox" claim from contain mode description; docs only state it fits within dimensions keeping aspect ratio.

• https://supabase.com/docs/guides/storage/serving/image-transformations#modes