Skip to content

Latest commit

 

History

History

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Workspace Protocol docs

The specification, in flight. Each folder has its own index.

  • Format: What a workspace is on disk and how it's addressed.
  • Sync: How a workspace's content replicates and merges between peers.
  • Network: How peers find and reach each other, and stay available.
  • Permissions and identity: Who may do what, how access is granted, and how identity survives lost devices.
  • Security: What Workspace protects, what it doesn't, and where it could fall down.
  • Lighthouse: always-on peers a workspace opts into: principles, deployment, prior art
  • Workspace actions: sandboxed functions in a document, across files or for a workspace (a spike within the spec)
  • Decisions: architecture decision records

Start with format/workspace-format.md for what's being built, then security/threat-model.md for the contract that bounds it, format/uri-scheme.md for addressing, permissions/permissions-model.md for the protocol underneath, and security/risks.md for where it could fall down.