~ knotless Search/
↑↓ move↵ open⇧↵ all results

socialweb.computer/socialweb-computer-kcp

socialweb.computer: a compute market on atproto (kcp)

1 collaborator
0
0
42 lines · 2.5 KB Raw History

docs

Start at the README. Agents: ../AGENTS.md first.

Use

docwhat
quickstart-prod.mdrequest from prod bidders: vouches, a command, hold and ssh, sizes, sign-in, run requester
quickstart-local.mda whole market on one machine: dev up, request, kubectl apply, dev down
bidder.mdbuilds and channels, install a bidder, who it serves, upgrade, self-update, uninstall
gateway.mdKubernetes clusters from the gateway; its deploy environment
deploy.mdhow a release reaches prod: CI, channels, what survives, rollback
inspect.mdreading live state
oauth.mdscripted OAuth sign-in
host-contract.mdwhat a host must provide (check-host)

How it works

docwhat
how-it-works.mdthe protocol in one page: the flow, who is who, who serves whom
protocol/flow.mdone contract end to end, with its real records and failure branches
protocol/compute-contract-flow-map.mdthe compute contract flow map: every layer from the lexicons to the guest transport
SYSTEM.mdthe whole system: repos, hosts, apps, market protocol, guests, identity, ssh gateway, atirc, clusters
protocol/README.mdthe atproto lexicons and the end-to-end sequence; protocol/glossary.md: every NSID
lexicon referenceevery record, object and method, generated from ../lexicons/ (on the site)
XRPC referencethe XRPC methods, generated from the same files (on the site)
KCP.mdhow every app uses kcp
ARCHITECTURE.mddecisions, measurements, invariants (open a section by heading)
../deploy/market-network/README.mdthe one-kcp market network
infra/inventory.mdwhat runs where on the non-gateway hosts

Verify and coordinate

docwhat
acceptance/the acceptance runbooks
ci-debug.mdCI by hand, debugging a CI run
ATIRC-WORKFLOW.mdhow agents coordinate over atirc
plans/plans and their status
spec/, research/integration catalog, research notes