docs: add comprehensive V3 catalog API reference

- Document granular artifact file formats (RPM, DEB, Docker)
- Add JSON schema examples for all artifact types
- Document aggregation logic and status computation
- Add usage examples for V3 scripts
- Include migration guide from V2 to V3
- Document atomic writes and race condition prevention
- Add testing section with test file references

Author: SckyzO