Repo history rewrite

lexicons/com/atproto/sync/getCheckout.json

@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Gets the repo state.",
+      "description": "DEPRECATED - please use com.atproto.sync.getRepo instead",
       "parameters": {
         "type": "params",
         "required": ["did"],
@@ -13,11 +13,6 @@
             "type": "string",
             "format": "did",
             "description": "The DID of the repo."
-          },
-          "commit": {
-            "type": "string",
-            "format": "cid",
-            "description": "The commit to get the checkout from. Defaults to current HEAD."
           }
         }
       },

lexicons/com/atproto/sync/getHead.json

@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Gets the current HEAD CID of a repo.",
+      "description": "DEPRECATED - please use com.atproto.sync.getLatestCommit instead",
       "parameters": {
         "type": "params",
         "required": ["did"],
@@ -27,7 +27,7 @@
         }
       },
       "errors": [
-        {"name": "HeadNotFound"}
+        {"name": "RootNotFound"}
       ]
     }
   }

lexicons/com/atproto/sync/getLatestCommit.json

@@ -0,0 +1,35 @@
+{
+  "lexicon": 1,
+  "id": "com.atproto.sync.getLatestCommit",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "Gets the current commit CID & revision of the repo.",
+      "parameters": {
+        "type": "params",
+        "required": ["did"],
+        "properties": {
+          "did": {
+            "type": "string",
+            "format": "did",
+            "description": "The DID of the repo."
+          }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["cid", "rev"],
+          "properties": {
+            "cid": {"type": "string", "format": "cid"},
+            "rev": {"type": "string"}
+          }
+        }
+      },
+      "errors": [
+        {"name": "RepoNotFound"}
+      ]
+    }
+  }
+}

lexicons/com/atproto/sync/getRepo.json

@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Gets the repo state.",
+      "description": "Gets the did's repo, optionally catching up from a specific revision.",
       "parameters": {
         "type": "params",
         "required": ["did"],
@@ -14,15 +14,10 @@
             "format": "did",
             "description": "The DID of the repo."
           },
-          "earliest": {
+          "rev": {
             "type": "string",
             "format": "cid",
-            "description": "The earliest commit in the commit range (not inclusive)"
-          },
-          "latest": {
-            "type": "string",
-            "format": "cid",
-            "description": "The latest commit in the commit range (inclusive)"
+            "description": "The revision of the repo to catch up from."
           }
         }
       },

lexicons/com/atproto/sync/listBlobs.json

@@ -4,14 +4,13 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "List blob cids for some range of commits",
+      "description": "List blob cids since some revision",
       "parameters": {
         "type": "params",
         "required": ["did"],
         "properties": {
           "did": {"type": "string", "format": "did", "description": "The DID of the repo."},
-          "latest": { "type": "string", "format": "cid", "description": "The most recent commit"},
-          "earliest": { "type": "string", "format": "cid", "description": "The earliest commit to start from"}
+          "rev": { "type": "string", "format": "cid", "description": "Optional revision of the repo to list blobs since"}
         }
       },
       "output": {

lexicons/com/atproto/sync/subscribeRepos.json

@@ -33,15 +33,23 @@
     },
     "commit": {
       "type": "object",
-      "required": ["seq", "rebase", "tooBig", "repo", "commit", "prev", "blocks", "ops", "blobs", "time"],
-      "nullable": ["prev"],
+      "required": ["seq", "rebase", "tooBig", "repo", "commit", "rev", "since", "blocks", "ops", "blobs", "time"],
+      "nullable": ["prev", "since"],
       "properties": {
         "seq": {"type": "integer"},
         "rebase": {"type": "boolean"},
         "tooBig": {"type": "boolean"},
         "repo": {"type": "string", "format": "did"},
         "commit": {"type": "cid-link"},
         "prev": {"type": "cid-link"},
+        "rev": {
+          "type": "string",
+          "description": "The rev of the emitted commit"
+        },
+        "since": {
+          "type": "string",
+          "description": "The rev of the last emitted from this repo"
+        },
         "blocks": {
           "type": "bytes",
           "description": "CAR file containing relevant blocks",

lexicons/com/atproto/temp/upgradeRepoVersion.json

@@ -0,0 +1,20 @@
+{
+  "lexicon": 1,
+  "id": "com.atproto.temp.upgradeRepoVersion",
+  "defs": {
+    "main": {
+      "type": "procedure",
+      "description": "Upgrade a repo to v3",
+      "input": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["did"],
+          "properties": {
+            "did": { "type": "string", "format": "did" }
+          }
+        }
+      }
+    }
+  }
+}