@haystackeditor/cli 0.19.0 → 0.20.0

package/schemas/init.v1.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.haystackeditor.com/cli/schemas/init.v1.json",
+  "title": "Haystack init: this repository's setup for `haystack verify`",
+  "description": "Machine-readable output of `haystack init --json`. `changes` are the project-local changes init planned (made when status is done); `onboarding` is the base's OnboardingStatusV1 (onboarding_contracts.ts, APP-ONBOARDING-V1) as POST /api/agent/cloud-verifier/onboarding returns it, null unless status is done. Exit codes: 0 done (onboarding running or ready), 1 failed (the error envelope), 2 planned (nothing written; run with --yes), 3 done but onboarding blocked, 4 login-required, 5 app-required (install the Haystack GitHub App), 6 done but onboarding stopped before finishing (run init again).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "status", "repository", "changes", "notices", "onboarding"],
+  "properties": {
+    "schema_version": { "const": "1.0.0" },
+    "status": { "enum": ["done", "planned", "login-required", "app-required"] },
+    "repository": { "type": "string" },
+    "changes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "action", "reason", "diff"],
+        "properties": {
+          "path": { "type": "string" },
+          "action": { "enum": ["create", "update"] },
+          "reason": { "type": "string" },
+          "diff": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "notices": { "type": "array", "items": { "type": "string" } },
+    "onboarding": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "verify.v1.json#/$defs/onboardingStatus" }
+      ]
+    }
+  }
+}

package/schemas/login.v1.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.haystackeditor.com/cli/schemas/login.v1.json",
+  "title": "Haystack login: a GitHub device-flow sign-in",
+  "description": "Machine-readable output of `haystack login --json`. With --no-wait, status is pending and carries the URL to open and the code to enter (never the device code); the next `haystack login` finishes it. Otherwise status is logged-in with the account signed in.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "status", "verificationUri", "userCode", "expiresAt", "login"],
+  "properties": {
+    "schema_version": { "const": "1.0.0" },
+    "status": { "enum": ["pending", "logged-in"] },
+    "verificationUri": { "type": ["string", "null"] },
+    "userCode": { "type": ["string", "null"] },
+    "expiresAt": { "type": ["string", "null"], "format": "date-time" },
+    "login": { "type": ["string", "null"] }
+  }
+}

package/schemas/verify-answer.v1.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.haystackeditor.com/cli/schemas/verify-answer.v1.json",
+  "title": "Haystack verify answer: the repository's onboarding facts after an answer",
+  "description": "Machine-readable output of `haystack verify answer <question-id> <choice> --json`: OnboardingFactsView (onboarding_contracts.ts, APP-ONBOARDING-V1) as POST /api/agent/cloud-verifier/onboarding/answers returns it.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "facts"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1.0.0"
+    },
+    "facts": {
+      "type": "object",
+      "required": [
+        "repository",
+        "facts",
+        "factsDigest",
+        "openQuestions"
+      ],
+      "properties": {
+        "repository": {
+          "type": "string"
+        },
+        "factsDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "facts": {
+          "type": "object",
+          "required": [
+            "dbProfile",
+            "answers"
+          ],
+          "properties": {
+            "dbProfile": {
+              "oneOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                }
+              ]
+            },
+            "answers": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "openQuestions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "message",
+              "choices"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              },
+              "choices": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/verify-onboarding.v1.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.haystackeditor.com/cli/schemas/verify-onboarding.v1.json",
+  "title": "Haystack verify onboarding: the onboarding of this checkout's base",
+  "description": "Machine-readable output of `haystack verify onboarding --json`: OnboardingStatusV1 (onboarding_contracts.ts, APP-ONBOARDING-V1) of the base `haystack verify` would use, as GET /api/agent/cloud-verifier/onboarding?repository=&baseCommit= returns it.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "onboarding"],
+  "properties": {
+    "schema_version": { "const": "1.0.0" },
+    "onboarding": { "$ref": "verify.v1.json#/$defs/onboardingStatus" }
+  }
+}

package/schemas/verify.v1.json

@@ -2,12 +2,33 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://docs.haystackeditor.com/cli/schemas/verify.v1.json",
   "title": "Haystack verify: the crawl of the current change (CRAWL-V1)",
-  "description": "Machine-readable output of `haystack verify --json`: the caller's crawl of the exact captured checkout (its code and its change title), as GET /api/agent/cloud-verifier/crawls?repository=&workCommit= or, for a crawl the command just submitted, GET /api/agent/cloud-verifier/crawls/:runId?repository= returns it, or null when no crawl of the capture could be started. The crawl shapes mirror infra/lambda/haystack-design-verifier-shared/crawl_contracts.ts (with amendments 1, 8 and 9); that file wins where they differ.",
+  "description": "Machine-readable output of `haystack verify --json`: the caller's crawl of the exact captured checkout (its code and its change title), as GET /api/agent/cloud-verifier/crawls?repository=&workCommit= or, for a crawl the command just submitted, GET /api/agent/cloud-verifier/crawls/:runId?repository= returns it, or null when no crawl of the capture could be started. The crawl shapes mirror infra/lambda/haystack-design-verifier-shared/crawl_contracts.ts (with amendments 1, 8, 9, 10 and 11); that file wins where they differ. Crawl amendment 11 (schema 1.0.1): when the capture's base is not onboarded yet, `onboarding` is the base's OnboardingStatusV1 (onboarding_contracts.ts, APP-ONBOARDING-V1) and `crawl` is null until the app is ready; it is null when onboarding was not involved.",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema_version", "crawl"],
   "properties": {
-    "schema_version": { "const": "1.0.0" },
+    "onboarding": {
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "$ref": "#/$defs/onboardingStatus"
+        }
+      ]
+    },
+    "schema_version": { "const": "1.0.2" },
+    "change": {
+      "description": "Schema 1.0.2: what this verify checked: the capture's base commit (where HEAD meets origin's default branch), its work commit (committed and uncommitted changes), and the files that differ between them.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["baseCommit", "workCommit", "files"],
+      "properties": {
+        "baseCommit": { "$ref": "#/$defs/commit" },
+        "workCommit": { "$ref": "#/$defs/commit" },
+        "files": { "type": "array", "items": { "type": "string" } }
+      }
+    },
     "crawl": {
       "oneOf": [
         { "type": "null" },
@@ -16,6 +37,253 @@
     }
   },
   "$defs": {
+    "onboardingBlock": {
+      "type": "object",
+      "required": [
+        "kind",
+        "stage",
+        "reason",
+        "evidence",
+        "ask"
+      ],
+      "properties": {
+        "kind": {
+          "enum": [
+            "not-enabled",
+            "no-web-app",
+            "unsupported",
+            "question",
+            "outside-credential",
+            "outside-dependency",
+            "evidence-too-large",
+            "budget",
+            "proof-failed"
+          ]
+        },
+        "stage": {
+          "enum": [
+            "admission",
+            "inventory",
+            "plan",
+            "runtime",
+            "boot",
+            "data",
+            "accounts",
+            "workflow",
+            "publish",
+            "cleanup"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "evidence": {
+          "$ref": "#/$defs/strings"
+        },
+        "names": {
+          "$ref": "#/$defs/strings"
+        },
+        "ask": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "message"
+              ],
+              "properties": {
+                "message": {
+                  "type": "string"
+                },
+                "command": {
+                  "type": "string"
+                },
+                "question": {
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "choices"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "choices": {
+                      "$ref": "#/$defs/strings"
+                    }
+                  }
+                }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "onboardingStatus": {
+      "type": "object",
+      "required": [
+        "version",
+        "repository",
+        "baseCommit",
+        "state",
+        "onboardRunId",
+        "recordDigest",
+        "checkpoint",
+        "block",
+        "dataAbsences",
+        "versionChoices"
+      ],
+      "properties": {
+        "version": {
+          "const": "app-onboarding-v1"
+        },
+        "repository": {
+          "type": "string"
+        },
+        "baseCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "state": {
+          "enum": [
+            "ready",
+            "onboarding",
+            "blocked",
+            "incomplete",
+            "cancelled",
+            "not-started"
+          ]
+        },
+        "onboardRunId": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "string",
+              "pattern": "^ob_[0-9a-f]{48}$"
+            }
+          ]
+        },
+        "recordDigest": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            }
+          ]
+        },
+        "checkpoint": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "status",
+                "stage",
+                "execution",
+                "owned"
+              ],
+              "properties": {
+                "status": {
+                  "enum": [
+                    "queued",
+                    "running",
+                    "cleanup-pending",
+                    "published",
+                    "reused",
+                    "blocked",
+                    "incomplete",
+                    "cancelled"
+                  ]
+                },
+                "stage": {
+                  "enum": [
+                    "inventory",
+                    "plan",
+                    "runtime",
+                    "boot",
+                    "data",
+                    "accounts",
+                    "workflow",
+                    "publish",
+                    "cleanup"
+                  ]
+                },
+                "owned": {
+                  "$ref": "#/$defs/strings"
+                },
+                "execution": {
+                  "type": "object",
+                  "required": [
+                    "stages"
+                  ],
+                  "properties": {
+                    "stages": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "stage",
+                          "status"
+                        ],
+                        "properties": {
+                          "stage": {
+                            "enum": [
+                              "inventory",
+                              "plan",
+                              "runtime",
+                              "boot",
+                              "data",
+                              "accounts",
+                              "workflow",
+                              "publish",
+                              "cleanup"
+                            ]
+                          },
+                          "status": {
+                            "enum": [
+                              "pending",
+                              "running",
+                              "ok",
+                              "reused",
+                              "failed",
+                              "blocked"
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          ]
+        },
+        "block": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/onboardingBlock"
+            }
+          ]
+        },
+        "dataAbsences": {
+          "$ref": "#/$defs/strings"
+        },
+        "versionChoices": {
+          "$ref": "#/$defs/strings"
+        }
+      }
+    },
     "runId": { "type": "string", "pattern": "^cv_[0-9a-f]{48}$" },
     "commit": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
     "count": { "type": "integer", "minimum": 0 },