sideby 0.0.0-stage → 0.2.1

package/schemas/app-install.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/app-install.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "platform",
+    "path",
+    "files",
+    "mode",
+    "node",
+    "entry",
+    "updated",
+    "hints"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "platform": {
+      "anyOf": [
+        {
+          "type": "string",
+          "const": "darwin"
+        },
+        {
+          "type": "string",
+          "const": "linux"
+        }
+      ]
+    },
+    "path": {
+      "type": "string"
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "mode": {
+      "anyOf": [
+        {
+          "type": "string",
+          "const": "panel"
+        },
+        {
+          "type": "string",
+          "const": "url"
+        }
+      ]
+    },
+    "url": {
+      "type": "string"
+    },
+    "node": {
+      "type": "string"
+    },
+    "entry": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "boolean"
+    },
+    "hints": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "title": "sideby app install --json"
+}

package/schemas/app-uninstall.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/app-uninstall.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "platform",
+    "removed",
+    "skipped"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "platform": {
+      "anyOf": [
+        {
+          "type": "string",
+          "const": "darwin"
+        },
+        {
+          "type": "string",
+          "const": "linux"
+        }
+      ]
+    },
+    "removed": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "skipped": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "path",
+          "reason"
+        ],
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "title": "sideby app uninstall --json"
+}

package/schemas/config.json

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/config.json",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "accounts": {
+      "type": "object",
+      "patternProperties": {
+        "^.*$": {
+          "type": "object",
+          "properties": {
+            "args": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "description": "Per-Account settings keyed by `<family>:<name>`."
+    },
+    "aliases": {
+      "type": "object",
+      "patternProperties": {
+        "^[A-Za-z_][A-Za-z0-9_-]*$": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object",
+              "required": [
+                "account"
+              ],
+              "properties": {
+                "account": {
+                  "type": "string",
+                  "pattern": "^[^:]+:.+$",
+                  "description": "The Account ref, `<family>:<name>`."
+                },
+                "args": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Host arguments `sideby run <alias>` adds after the Account `args`, before the user’s."
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        }
+      },
+      "description": "Short shell function names created by `sideby shell-init`, mapped to an Account ref or to `{ account, args }`."
+    },
+    "ignore": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Account refs that are not Accounts."
+    },
+    "pluginDirs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Absolute or `~/` paths of Plugin directories."
+    },
+    "plugins": {
+      "type": "object",
+      "patternProperties": {
+        "^.*$": {
+          "type": "object",
+          "patternProperties": {
+            "^.*$": {}
+          }
+        }
+      },
+      "description": "Per-Plugin settings; `enabled: false` turns a Plugin off."
+    },
+    "extraSharedItems": {
+      "type": "object",
+      "patternProperties": {
+        "^.*$": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "path",
+              "mode"
+            ],
+            "properties": {
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "^(?!/)(?!.*(^|/)\\.\\.(/|$)).+$"
+              },
+              "mode": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "const": "link"
+                  },
+                  {
+                    "type": "string",
+                    "const": "copy"
+                  },
+                  {
+                    "type": "string",
+                    "const": "link-or-copy"
+                  },
+                  {
+                    "type": "string",
+                    "const": "link-or-local"
+                  },
+                  {
+                    "type": "string",
+                    "const": "local"
+                  },
+                  {
+                    "type": "string",
+                    "const": "local-if-api"
+                  },
+                  {
+                    "type": "string",
+                    "const": "info"
+                  }
+                ]
+              },
+              "noSymlink": {
+                "type": "boolean"
+              },
+              "credential": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      }
+    },
+    "resumeRouting": {
+      "type": "boolean",
+      "description": "Make `sideby shell-init` also define Host-named functions (`claude`, `codex`, `grok`) that resume a session by id in the Account that holds it. Off by default."
+    },
+    "shellInitFile": {
+      "type": "object",
+      "properties": {
+        "zsh": {
+          "type": "string",
+          "minLength": 1
+        },
+        "bash": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false,
+      "description": "Absolute or `~/` paths of files sideby rewrites with the `sideby shell-init <shell>` output whenever it adds an Account or an alias; source the file from your shell rc."
+    }
+  },
+  "additionalProperties": false,
+  "title": "sideby config"
+}

package/schemas/doctor.json

@@ -0,0 +1,229 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/doctor.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "status",
+    "accounts",
+    "general",
+    "fixes"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "status": {
+      "anyOf": [
+        {
+          "type": "string",
+          "const": "ok"
+        },
+        {
+          "type": "string",
+          "const": "issues"
+        }
+      ]
+    },
+    "accounts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "ref",
+          "family",
+          "name",
+          "kind",
+          "dir",
+          "shared",
+          "backups",
+          "findings"
+        ],
+        "properties": {
+          "ref": {
+            "type": "string"
+          },
+          "family": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "kind": {
+            "anyOf": [
+              {
+                "type": "string",
+                "const": "subscription"
+              },
+              {
+                "type": "string",
+                "const": "api"
+              }
+            ]
+          },
+          "dir": {
+            "type": "string"
+          },
+          "shared": {
+            "type": "object",
+            "required": [
+              "ok",
+              "total"
+            ],
+            "properties": {
+              "ok": {
+                "type": "number"
+              },
+              "total": {
+                "type": "number"
+              }
+            }
+          },
+          "backups": {
+            "type": "number"
+          },
+          "findings": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "level",
+                "account",
+                "item",
+                "code",
+                "message",
+                "source",
+                "fixable"
+              ],
+              "properties": {
+                "level": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "const": "ok"
+                    },
+                    {
+                      "type": "string",
+                      "const": "warn"
+                    },
+                    {
+                      "type": "string",
+                      "const": "fail"
+                    }
+                  ]
+                },
+                "account": {
+                  "type": "string"
+                },
+                "item": {
+                  "type": "string"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "hint": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "string"
+                },
+                "fixable": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "general": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "level",
+          "account",
+          "item",
+          "code",
+          "message",
+          "source",
+          "fixable"
+        ],
+        "properties": {
+          "level": {
+            "anyOf": [
+              {
+                "type": "string",
+                "const": "ok"
+              },
+              {
+                "type": "string",
+                "const": "warn"
+              },
+              {
+                "type": "string",
+                "const": "fail"
+              }
+            ]
+          },
+          "account": {
+            "type": "string"
+          },
+          "item": {
+            "type": "string"
+          },
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "hint": {
+            "type": "string"
+          },
+          "source": {
+            "type": "string"
+          },
+          "fixable": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    "fixes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "account",
+          "item",
+          "code",
+          "ok",
+          "message"
+        ],
+        "properties": {
+          "account": {
+            "type": "string"
+          },
+          "item": {
+            "type": "string"
+          },
+          "code": {
+            "type": "string"
+          },
+          "ok": {
+            "type": "boolean"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "title": "sideby doctor --json"
+}

package/schemas/error.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/error.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "error",
+    "code"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "error": {
+      "type": "string",
+      "description": "What went wrong and what to do next."
+    },
+    "code": {
+      "type": "string",
+      "description": "`usage` for a malformed command line (exit 2), a reason such as `no-quota-source` or `alias-invalid`, or `error`."
+    }
+  },
+  "title": "sideby error --json"
+}