gip-remote 1.1.1 → 1.2.1

package/index.js

@@ -23,9 +23,12 @@ class Remote extends ReadyResource {
     if (typeof this._link === 'string') {
       this._name = this._link
       config = {}
-    } else {
+    } else if (this._link.drive) {
       this._name = this._link.pathname?.split('/').slice(1)[0]
-      config = this._link.drive
+      config = { key: this._link.drive.key }
+    } else {
+      this._name = this._link.name
+      config = this._link
     }
 
     const bee = new Hyperbee(store, config, { autoUpdate: true })
@@ -75,6 +78,16 @@ class Remote extends ReadyResource {
 
   // --- Refs / Branches ---
 
+  async getHead() {
+    const record = await this._db.get('@gip/head', {})
+    return record ? record.branch : null
+  }
+
+  async setHead(branch) {
+    await this._db.insert('@gip/head', { branch })
+    await this._db.flush()
+  }
+
   async getAllRefs() {
     const branches = this._db.find('@gip/branches')
     const refs = []
@@ -83,8 +96,11 @@ class Remote extends ReadyResource {
       refs.push({ ref: `refs/heads/${b.name}`, oid: b.commitOid })
     }
 
-    const main = refs.find((r) => r.ref === 'refs/heads/main')
-    if (main) refs.push({ ref: 'HEAD', oid: main.oid })
+    const headBranch = await this.getHead()
+    if (headBranch) {
+      const head = refs.find((r) => r.ref === `refs/heads/${headBranch}`)
+      if (head) refs.push({ ref: 'HEAD', symref: head.ref, oid: head.oid })
+    }
 
     return refs.reverse()
   }
@@ -162,7 +178,13 @@ class Remote extends ReadyResource {
       objects: [...objects.keys()]
     })
 
-    // 6. Flush
+    // 6. Set HEAD to first branch pushed (like git init)
+    const currentHead = await this.getHead()
+    if (!currentHead) {
+      await this._db.insert('@gip/head', { branch: branchName })
+    }
+
+    // 7. Flush
     await this._db.flush()
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gip-remote",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "Git+Pear remote DB for handling git data",
   "main": "index.js",
   "scripts": {

package/schema/hyperdb/db.json

@@ -1,5 +1,5 @@
 {
-  "version": 1,
+  "version": 2,
   "offset": 0,
   "schema": [
     {
@@ -12,7 +12,9 @@
       "indexes": [],
       "schema": "@gip/repos",
       "derived": false,
-      "key": ["name"],
+      "key": [
+        "name"
+      ],
       "trigger": null
     },
     {
@@ -25,7 +27,9 @@
       "indexes": [],
       "schema": "@gip/branches",
       "derived": false,
-      "key": ["name"],
+      "key": [
+        "name"
+      ],
       "trigger": null
     },
     {
@@ -35,10 +39,15 @@
       "type": 1,
       "version": 1,
       "versionField": null,
-      "indexes": ["@gip/files-by-branch"],
+      "indexes": [
+        "@gip/files-by-branch"
+      ],
       "schema": "@gip/files",
       "derived": false,
-      "key": ["branch", "path"],
+      "key": [
+        "branch",
+        "path"
+      ],
       "trigger": null
     },
     {
@@ -51,7 +60,9 @@
       "indexes": [],
       "schema": "@gip/objects",
       "derived": false,
-      "key": ["oid"],
+      "key": [
+        "oid"
+      ],
       "trigger": null
     },
     {
@@ -63,7 +74,22 @@
       "collection": "@gip/files",
       "unique": false,
       "deprecated": false,
-      "key": ["branch"]
+      "key": [
+        "branch"
+      ]
+    },
+    {
+      "name": "head",
+      "namespace": "gip",
+      "id": 5,
+      "type": 1,
+      "version": 2,
+      "versionField": null,
+      "indexes": [],
+      "schema": "@gip/head",
+      "derived": false,
+      "key": [],
+      "trigger": null
     }
   ]
-}
+}

package/schema/hyperdb/index.js

@@ -4,12 +4,14 @@
 const { IndexEncoder, c, b4a } = require('hyperdb/runtime')
 const { version, getEncoding, setVersion } = require('./messages.js')
 
-const versions = { schema: version, db: 1 }
+const versions = { schema: version, db: 2 }
 
 // '@gip/repos' collection key
-const collection0_key = new IndexEncoder([IndexEncoder.STRING], { prefix: 0 })
+const collection0_key = new IndexEncoder([
+  IndexEncoder.STRING
+], { prefix: 0 })
 
-function collection0_indexify(record) {
+function collection0_indexify (record) {
   const a = record.name
   return a === undefined ? [] : [a]
 }
@@ -18,7 +20,7 @@ function collection0_indexify(record) {
 const collection0_enc = getEncoding('@gip/repos/hyperdb#0')
 
 // '@gip/repos' reconstruction function
-function collection0_reconstruct(schemaVersion, keyBuf, valueBuf) {
+function collection0_reconstruct (schemaVersion, keyBuf, valueBuf) {
   const key = collection0_key.decode(keyBuf)
   setVersion(schemaVersion)
   const state = { start: 0, end: valueBuf.byteLength, buffer: valueBuf }
@@ -30,7 +32,7 @@ function collection0_reconstruct(schemaVersion, keyBuf, valueBuf) {
   return record
 }
 // '@gip/repos' key reconstruction function
-function collection0_reconstruct_key(keyBuf) {
+function collection0_reconstruct_key (keyBuf) {
   const key = collection0_key.decode(keyBuf)
   return {
     name: key[0]
@@ -42,11 +44,11 @@ const collection0 = {
   name: '@gip/repos',
   id: 0,
   version: 1,
-  encodeKey(record) {
+  encodeKey (record) {
     const key = [record.name]
     return collection0_key.encode(key)
   },
-  encodeKeyRange({ gt, lt, gte, lte } = {}) {
+  encodeKeyRange ({ gt, lt, gte, lte } = {}) {
     return collection0_key.encodeRange({
       gt: gt ? collection0_indexify(gt) : null,
       lt: lt ? collection0_indexify(lt) : null,
@@ -54,7 +56,7 @@ const collection0 = {
       lte: lte ? collection0_indexify(lte) : null
     })
   },
-  encodeValue(schemaVersion, collectionVersion, record) {
+  encodeValue (schemaVersion, collectionVersion, record) {
     setVersion(schemaVersion)
     const state = { start: 0, end: 2, buffer: null }
     collection0_enc.preencode(state, record)
@@ -72,9 +74,11 @@ const collection0 = {
 }
 
 // '@gip/branches' collection key
-const collection1_key = new IndexEncoder([IndexEncoder.STRING], { prefix: 1 })
+const collection1_key = new IndexEncoder([
+  IndexEncoder.STRING
+], { prefix: 1 })
 
-function collection1_indexify(record) {
+function collection1_indexify (record) {
   const a = record.name
   return a === undefined ? [] : [a]
 }
@@ -83,7 +87,7 @@ function collection1_indexify(record) {
 const collection1_enc = getEncoding('@gip/branches/hyperdb#1')
 
 // '@gip/branches' reconstruction function
-function collection1_reconstruct(schemaVersion, keyBuf, valueBuf) {
+function collection1_reconstruct (schemaVersion, keyBuf, valueBuf) {
   const key = collection1_key.decode(keyBuf)
   setVersion(schemaVersion)
   const state = { start: 0, end: valueBuf.byteLength, buffer: valueBuf }
@@ -95,7 +99,7 @@ function collection1_reconstruct(schemaVersion, keyBuf, valueBuf) {
   return record
 }
 // '@gip/branches' key reconstruction function
-function collection1_reconstruct_key(keyBuf) {
+function collection1_reconstruct_key (keyBuf) {
   const key = collection1_key.decode(keyBuf)
   return {
     name: key[0]
@@ -107,11 +111,11 @@ const collection1 = {
   name: '@gip/branches',
   id: 1,
   version: 1,
-  encodeKey(record) {
+  encodeKey (record) {
     const key = [record.name]
     return collection1_key.encode(key)
   },
-  encodeKeyRange({ gt, lt, gte, lte } = {}) {
+  encodeKeyRange ({ gt, lt, gte, lte } = {}) {
     return collection1_key.encodeRange({
       gt: gt ? collection1_indexify(gt) : null,
       lt: lt ? collection1_indexify(lt) : null,
@@ -119,7 +123,7 @@ const collection1 = {
       lte: lte ? collection1_indexify(lte) : null
     })
   },
-  encodeValue(schemaVersion, collectionVersion, record) {
+  encodeValue (schemaVersion, collectionVersion, record) {
     setVersion(schemaVersion)
     const state = { start: 0, end: 2, buffer: null }
     collection1_enc.preencode(state, record)
@@ -137,9 +141,12 @@ const collection1 = {
 }
 
 // '@gip/files' collection key
-const collection2_key = new IndexEncoder([IndexEncoder.STRING, IndexEncoder.STRING], { prefix: 2 })
+const collection2_key = new IndexEncoder([
+  IndexEncoder.STRING,
+  IndexEncoder.STRING
+], { prefix: 2 })
 
-function collection2_indexify(record) {
+function collection2_indexify (record) {
   const arr = []
 
   const a0 = record.branch
@@ -157,7 +164,7 @@ function collection2_indexify(record) {
 const collection2_enc = getEncoding('@gip/files/hyperdb#2')
 
 // '@gip/files' reconstruction function
-function collection2_reconstruct(schemaVersion, keyBuf, valueBuf) {
+function collection2_reconstruct (schemaVersion, keyBuf, valueBuf) {
   const key = collection2_key.decode(keyBuf)
   setVersion(schemaVersion)
   const state = { start: 0, end: valueBuf.byteLength, buffer: valueBuf }
@@ -170,7 +177,7 @@ function collection2_reconstruct(schemaVersion, keyBuf, valueBuf) {
   return record
 }
 // '@gip/files' key reconstruction function
-function collection2_reconstruct_key(keyBuf) {
+function collection2_reconstruct_key (keyBuf) {
   const key = collection2_key.decode(keyBuf)
   return {
     branch: key[0],
@@ -183,11 +190,11 @@ const collection2 = {
   name: '@gip/files',
   id: 2,
   version: 1,
-  encodeKey(record) {
+  encodeKey (record) {
     const key = [record.branch, record.path]
     return collection2_key.encode(key)
   },
-  encodeKeyRange({ gt, lt, gte, lte } = {}) {
+  encodeKeyRange ({ gt, lt, gte, lte } = {}) {
     return collection2_key.encodeRange({
       gt: gt ? collection2_indexify(gt) : null,
       lt: lt ? collection2_indexify(lt) : null,
@@ -195,7 +202,7 @@ const collection2 = {
       lte: lte ? collection2_indexify(lte) : null
     })
   },
-  encodeValue(schemaVersion, collectionVersion, record) {
+  encodeValue (schemaVersion, collectionVersion, record) {
     setVersion(schemaVersion)
     const state = { start: 0, end: 2, buffer: null }
     collection2_enc.preencode(state, record)
@@ -213,9 +220,11 @@ const collection2 = {
 }
 
 // '@gip/objects' collection key
-const collection3_key = new IndexEncoder([IndexEncoder.STRING], { prefix: 3 })
+const collection3_key = new IndexEncoder([
+  IndexEncoder.STRING
+], { prefix: 3 })
 
-function collection3_indexify(record) {
+function collection3_indexify (record) {
   const a = record.oid
   return a === undefined ? [] : [a]
 }
@@ -224,7 +233,7 @@ function collection3_indexify(record) {
 const collection3_enc = getEncoding('@gip/objects/hyperdb#3')
 
 // '@gip/objects' reconstruction function
-function collection3_reconstruct(schemaVersion, keyBuf, valueBuf) {
+function collection3_reconstruct (schemaVersion, keyBuf, valueBuf) {
   const key = collection3_key.decode(keyBuf)
   setVersion(schemaVersion)
   const state = { start: 0, end: valueBuf.byteLength, buffer: valueBuf }
@@ -236,7 +245,7 @@ function collection3_reconstruct(schemaVersion, keyBuf, valueBuf) {
   return record
 }
 // '@gip/objects' key reconstruction function
-function collection3_reconstruct_key(keyBuf) {
+function collection3_reconstruct_key (keyBuf) {
   const key = collection3_key.decode(keyBuf)
   return {
     oid: key[0]
@@ -248,11 +257,11 @@ const collection3 = {
   name: '@gip/objects',
   id: 3,
   version: 1,
-  encodeKey(record) {
+  encodeKey (record) {
     const key = [record.oid]
     return collection3_key.encode(key)
   },
-  encodeKeyRange({ gt, lt, gte, lte } = {}) {
+  encodeKeyRange ({ gt, lt, gte, lte } = {}) {
     return collection3_key.encodeRange({
       gt: gt ? collection3_indexify(gt) : null,
       lt: lt ? collection3_indexify(lt) : null,
@@ -260,7 +269,7 @@ const collection3 = {
       lte: lte ? collection3_indexify(lte) : null
     })
   },
-  encodeValue(schemaVersion, collectionVersion, record) {
+  encodeValue (schemaVersion, collectionVersion, record) {
     setVersion(schemaVersion)
     const state = { start: 0, end: 2, buffer: null }
     collection3_enc.preencode(state, record)
@@ -278,12 +287,13 @@ const collection3 = {
 }
 
 // '@gip/files-by-branch' collection key
-const index4_key = new IndexEncoder(
-  [IndexEncoder.STRING, IndexEncoder.STRING, IndexEncoder.STRING],
-  { prefix: 4 }
-)
+const index4_key = new IndexEncoder([
+  IndexEncoder.STRING,
+  IndexEncoder.STRING,
+  IndexEncoder.STRING
+], { prefix: 4 })
 
-function index4_indexify(record) {
+function index4_indexify (record) {
   const arr = []
 
   const a0 = record.branch
@@ -306,10 +316,10 @@ const index4 = {
   name: '@gip/files-by-branch',
   version: 1,
   id: 4,
-  encodeKey(record) {
+  encodeKey (record) {
     return index4_key.encode(index4_indexify(record))
   },
-  encodeKeyRange({ gt, lt, gte, lte } = {}) {
+  encodeKeyRange ({ gt, lt, gte, lte } = {}) {
     return index4_key.encodeRange({
       gt: gt ? index4_indexify(gt) : null,
       lt: lt ? index4_indexify(lt) : null,
@@ -318,7 +328,7 @@ const index4 = {
     })
   },
   encodeValue: (record) => index4.collection.encodeKey(record),
-  encodeIndexKeys(record, context) {
+  encodeIndexKeys (record, context) {
     return [index4_key.encode([record.branch, record.branch, record.path])]
   },
   reconstruct: (keyBuf, valueBuf) => valueBuf,
@@ -327,32 +337,94 @@ const index4 = {
 }
 collection2.indexes.push(index4)
 
-const collections = [collection0, collection1, collection2, collection3]
+// '@gip/head' collection key
+const collection5_key = new IndexEncoder([
+], { prefix: 5 })
 
-const indexes = [index4]
+function collection5_indexify (record) {
+  return []
+}
+
+// '@gip/head' value encoding
+const collection5_enc = getEncoding('@gip/head')
+
+// '@gip/head' reconstruction function
+function collection5_reconstruct (schemaVersion, keyBuf, valueBuf) {
+  setVersion(schemaVersion)
+  const state = { start: 0, end: valueBuf.byteLength, buffer: valueBuf }
+  const type = c.uint.decode(state)
+  if (type !== 0) throw new Error('Unknown collection type: ' + type)
+  collection5.decodedVersion = c.uint.decode(state)
+  const record = collection5_enc.decode(state)
+  return record
+}
+// '@gip/head' key reconstruction function
+function collection5_reconstruct_key (keyBuf) {
+  return {}
+}
+
+// '@gip/head'
+const collection5 = {
+  name: '@gip/head',
+  id: 5,
+  version: 2,
+  encodeKey (record) {
+    const key = []
+    return collection5_key.encode(key)
+  },
+  encodeKeyRange ({ gt, lt, gte, lte } = {}) {
+    return collection5_key.encodeRange({
+      gt: gt ? collection5_indexify(gt) : null,
+      lt: lt ? collection5_indexify(lt) : null,
+      gte: gte ? collection5_indexify(gte) : null,
+      lte: lte ? collection5_indexify(lte) : null
+    })
+  },
+  encodeValue (schemaVersion, collectionVersion, record) {
+    setVersion(schemaVersion)
+    const state = { start: 0, end: 2, buffer: null }
+    collection5_enc.preencode(state, record)
+    state.buffer = b4a.allocUnsafe(state.end)
+    state.buffer[state.start++] = 0
+    state.buffer[state.start++] = collectionVersion
+    collection5_enc.encode(state, record)
+    return state.buffer
+  },
+  trigger: null,
+  reconstruct: collection5_reconstruct,
+  reconstructKey: collection5_reconstruct_key,
+  indexes: [],
+  decodedVersion: 0
+}
+
+const collections = [
+  collection0,
+  collection1,
+  collection2,
+  collection3,
+  collection5
+]
+
+const indexes = [
+  index4
+]
 
 module.exports = { versions, collections, indexes, resolveCollection, resolveIndex }
 
-function resolveCollection(name) {
+function resolveCollection (name) {
   switch (name) {
-    case '@gip/repos':
-      return collection0
-    case '@gip/branches':
-      return collection1
-    case '@gip/files':
-      return collection2
-    case '@gip/objects':
-      return collection3
-    default:
-      return null
+    case '@gip/repos': return collection0
+    case '@gip/branches': return collection1
+    case '@gip/files': return collection2
+    case '@gip/objects': return collection3
+    case '@gip/head': return collection5
+    default: return null
   }
 }
 
-function resolveIndex(name) {
+function resolveIndex (name) {
   switch (name) {
-    case '@gip/files-by-branch':
-      return index4
-    default:
-      return null
+    case '@gip/files-by-branch': return index4
+    default: return null
   }
 }

package/schema/hyperdb/messages.js

@@ -1,12 +1,12 @@
 // This file is autogenerated by the hyperschema compiler
-// Schema Version: 1
+// Schema Version: 2
 /* eslint-disable camelcase */
 /* eslint-disable quotes */
 /* eslint-disable space-before-function-paren */
 
 const { c } = require('hyperschema/runtime')
 
-const VERSION = 1
+const VERSION = 2
 
 // eslint-disable-next-line no-unused-vars
 let version = VERSION
@@ -151,10 +151,10 @@ const encoding3_enum = {
 
 // @gip/object-type enum
 const encoding3 = {
-  preencode(state, m) {
+  preencode (state, m) {
     state.end++ // max enum is 4 so always one byte
   },
-  encode(state, m) {
+  encode (state, m) {
     switch (m) {
       case 'blob':
         c.uint.encode(state, 1)
@@ -172,7 +172,7 @@ const encoding3 = {
         throw new Error('Unknown enum')
     }
   },
-  decode(state) {
+  decode (state) {
     switch (c.uint.decode(state)) {
       case 1:
         return 'blob'
@@ -182,8 +182,7 @@ const encoding3 = {
         return 'commit'
       case 4:
         return 'tag'
-      default:
-        return null
+      default: return null
     }
   }
 }
@@ -217,8 +216,25 @@ const encoding4 = {
   }
 }
 
-// @gip/repos/hyperdb#0
+// @gip/head
 const encoding5 = {
+  preencode(state, m) {
+    c.string.preencode(state, m.branch)
+  },
+  encode(state, m) {
+    c.string.encode(state, m.branch)
+  },
+  decode(state) {
+    const r0 = c.string.decode(state)
+
+    return {
+      branch: r0
+    }
+  }
+}
+
+// @gip/repos/hyperdb#0
+const encoding6 = {
   preencode(state, m) {
     c.buffer.preencode(state, m.key)
     state.end++ // flags are fixed size
@@ -249,10 +265,10 @@ const encoding5 = {
 }
 
 // @gip/branches/hyperdb#1.objects
-const encoding6_6 = encoding1_6
+const encoding7_6 = encoding1_6
 
 // @gip/branches/hyperdb#1
-const encoding6 = {
+const encoding7 = {
   preencode(state, m) {
     c.string.preencode(state, m.commitOid)
     c.string.preencode(state, m.treeOid)
@@ -261,7 +277,7 @@ const encoding6 = {
     if (m.author) c.string.preencode(state, m.author)
     if (m.message) c.string.preencode(state, m.message)
     if (m.timestamp) c.uint.preencode(state, m.timestamp)
-    if (m.objects) encoding6_6.preencode(state, m.objects)
+    if (m.objects) encoding7_6.preencode(state, m.objects)
   },
   encode(state, m) {
     const flags =
@@ -274,7 +290,7 @@ const encoding6 = {
     if (m.author) c.string.encode(state, m.author)
     if (m.message) c.string.encode(state, m.message)
     if (m.timestamp) c.uint.encode(state, m.timestamp)
-    if (m.objects) encoding6_6.encode(state, m.objects)
+    if (m.objects) encoding7_6.encode(state, m.objects)
   },
   decode(state) {
     const r1 = c.string.decode(state)
@@ -288,13 +304,13 @@ const encoding6 = {
       author: (flags & 1) !== 0 ? c.string.decode(state) : null,
       message: (flags & 2) !== 0 ? c.string.decode(state) : null,
       timestamp: (flags & 4) !== 0 ? c.uint.decode(state) : 0,
-      objects: (flags & 8) !== 0 ? encoding6_6.decode(state) : null
+      objects: (flags & 8) !== 0 ? encoding7_6.decode(state) : null
     }
   }
 }
 
 // @gip/files/hyperdb#2
-const encoding7 = {
+const encoding8 = {
   preencode(state, m) {
     c.string.preencode(state, m.oid)
     c.string.preencode(state, m.mode)
@@ -337,7 +353,7 @@ const encoding7 = {
 }
 
 // @gip/objects/hyperdb#3
-const encoding8 = {
+const encoding9 = {
   preencode(state, m) {
     encoding3.preencode(state, m.type)
     c.uint.preencode(state, m.size)
@@ -397,14 +413,16 @@ function getEncoding(name) {
       return encoding3
     case '@gip/objects':
       return encoding4
-    case '@gip/repos/hyperdb#0':
+    case '@gip/head':
       return encoding5
-    case '@gip/branches/hyperdb#1':
+    case '@gip/repos/hyperdb#0':
       return encoding6
-    case '@gip/files/hyperdb#2':
+    case '@gip/branches/hyperdb#1':
       return encoding7
-    case '@gip/objects/hyperdb#3':
+    case '@gip/files/hyperdb#2':
       return encoding8
+    case '@gip/objects/hyperdb#3':
+      return encoding9
     default:
       throw new Error('Encoder not found ' + name)
   }

package/schema/hyperschema/index.js

@@ -1,12 +1,12 @@
 // This file is autogenerated by the hyperschema compiler
-// Schema Version: 1
+// Schema Version: 2
 /* eslint-disable camelcase */
 /* eslint-disable quotes */
 /* eslint-disable space-before-function-paren */
 
 const { c } = require('hyperschema/runtime')
 
-const VERSION = 1
+const VERSION = 2
 
 // eslint-disable-next-line no-unused-vars
 let version = VERSION
@@ -151,10 +151,10 @@ const encoding3_enum = {
 
 // @gip/object-type enum
 const encoding3 = {
-  preencode(state, m) {
+  preencode (state, m) {
     state.end++ // max enum is 4 so always one byte
   },
-  encode(state, m) {
+  encode (state, m) {
     switch (m) {
       case 'blob':
         c.uint.encode(state, 1)
@@ -172,7 +172,7 @@ const encoding3 = {
         throw new Error('Unknown enum')
     }
   },
-  decode(state) {
+  decode (state) {
     switch (c.uint.decode(state)) {
       case 1:
         return 'blob'
@@ -182,8 +182,7 @@ const encoding3 = {
         return 'commit'
       case 4:
         return 'tag'
-      default:
-        return null
+      default: return null
     }
   }
 }
@@ -217,6 +216,23 @@ const encoding4 = {
   }
 }
 
+// @gip/head
+const encoding5 = {
+  preencode(state, m) {
+    c.string.preencode(state, m.branch)
+  },
+  encode(state, m) {
+    c.string.encode(state, m.branch)
+  },
+  decode(state) {
+    const r0 = c.string.decode(state)
+
+    return {
+      branch: r0
+    }
+  }
+}
+
 function setVersion(v) {
   version = v
 }
@@ -252,6 +268,8 @@ function getEncoding(name) {
       return encoding3
     case '@gip/objects':
       return encoding4
+    case '@gip/head':
+      return encoding5
     default:
       throw new Error('Encoder not found ' + name)
   }

package/schema/hyperschema/schema.json

@@ -1,5 +1,5 @@
 {
-  "version": 1,
+  "version": 2,
   "schema": [
     {
       "name": "repos",
@@ -194,6 +194,20 @@
           "version": 1
         }
       ]
+    },
+    {
+      "name": "head",
+      "namespace": "gip",
+      "compact": true,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "branch",
+          "required": true,
+          "type": "string",
+          "version": 2
+        }
+      ]
     }
   ]
 }