~bigbes/sr-ht-spec: 72f58940

docs: federate the read side into api.sr.ht from Phase 2

Reverses the earlier no-federation call. The deciding arguments are one
endpoint plus one meta PAT for agents already querying git/todo/builds,
hut ergonomics, and core-go/webhooks being GraphQL-native so Phase 5
pulls gqlgen in regardless. The dolt precedent does not generalize: its
API is a chunk-store protocol, whereas documents and proposals are an
ordinary CRUD graph.

Mutations stay on REST + MCP. If-Match optimistic concurrency is an HTTP
idiom with well-defined 409 semantics, and a federated type is a consumed
contract, so the unsettled proposal types stay out of the gateway.

Also records that federation is not cross-service search: thistle merges
schemas and routes fields, so the meta-project still needs our own index.

bigbes <bigbes@gmail.com> — 2026-07-22 01:19:36 UTC

Commit 72f589404c6017c55decb59aafd8337996d45139view raw patch

Parent(s): c945f382

1 changed file(s)

FileStatus+
docs/DESIGN.md M +73 -23