diff --git a/.gitignore b/.gitignore
index 5c6cc51b1..2bfb2cd26 100644
--- a/.gitignore
+++ b/.gitignore
@@ -84,5 +84,3 @@ pkg/interface/link-webext/web-ext-artifacts
 *.log
 
 .vercel
-
-pkg/hodl/
\ No newline at end of file
diff --git a/pkg/npm/api/hood/types.ts b/pkg/npm/api/hood/types.ts
index a6e32ec3e..17676b47a 100644
--- a/pkg/npm/api/hood/types.ts
+++ b/pkg/npm/api/hood/types.ts
@@ -191,6 +191,14 @@ export interface Pike {
   wefts: Weft[];
   /**
    * how live is this pike?
+   * 
+   * live - app is running
+   * held - app is not running, but is trying to run. this state can be entered
+   * in two main ways: 
+   *   - when installing an app but it hasn't finished downloading (or it did 
+   *     but failed to install for some reason)
+   *   - when user forced a kelvin upgrade by suspending desks.
+   * dead - app is not running
    */
   zest: "live" | "dead" | "held";
 }