additional spec docs (Spring 2024)

[bnewbold]

Things that are maturing and need formal write-ups in the specs:

• [ ] Blobs: media files referenced by records, but stored and transmitted separately (short spec)
  • getBlob, uploadBlob
  • [ ] document behavior of re-uploading a blob in the same repo (HTTP status code, etc)
  • [ ] document sort-order of list blobs (?)
• [ ] Repository Sync: how content flows though the system
  • repo event stream ("firehose"): event schemas and details
  • getRepo endpoint
  • requestCrawl / notifyOfUpdate
• [ ] Accounts
  • account migration
  • lifecycle states
  • private settings
• [ ] Auth
  • service auth (JWTs)
  • OAuth
• [x] Labels
  • schema/fields
  • negation
  • signature lifecycle (with key rotation)
  • stream format
  • HTTP header

Additions to existing specs:

• [x] HTTP: generic proxying to remote services, based on HTTP headers
• [ ] Data Model: recommended limits