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
• Labels
  • schema/fields
  • negation
  • signature lifecycle (with key rotation)
  • stream format
  • HTTP header

Additions to existing specs:

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