@haystackeditor/cli 0.16.0 → 0.17.0

package/schemas/case-batch.v1.json

@@ -2,12 +2,12 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://docs.haystackeditor.com/cli/schemas/case-batch.v1.json",
   "title": "Haystack hosted case batch (CASE-BATCH-V1)",
-  "description": "Machine-readable output of `haystack case-batch submit|status|cancel|bundle --json`. The run-side shapes mirror infra/lambda/haystack-design-verifier-shared/case_batch_contracts.ts.",
+  "description": "Machine-readable output of `haystack case-batch submit|status|cancel|finalize|bundle --json`. The run-side shapes mirror infra/lambda/haystack-design-verifier-shared/case_batch_contracts.ts.",
   "type": "object",
   "required": ["schema_version", "operation", "run_id"],
   "properties": {
-    "schema_version": { "const": "1.0.0" },
-    "operation": { "enum": ["submit", "status", "cancel", "bundle"] },
+    "schema_version": { "const": "1.0.1" },
+    "operation": { "enum": ["submit", "status", "cancel", "finalize", "bundle"] },
     "run_id": { "type": "string", "pattern": "^cv_[0-9a-f]{48}$" },
     "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]{1,100}/[A-Za-z0-9_.-]{1,100}$" },
     "admitted": { "enum": ["created", "existing"] },
@@ -44,6 +44,28 @@
               "case_bundle_path": { "type": ["string", "null"] },
               "differing_outcomes": { "type": "array", "items": { "type": "string" } },
               "detail": { "type": ["string", "null"] },
+              "execution_path": { "enum": ["resident-sealed-plan", "sealed-plan", "record-replay", null] },
+              "node_ids": {
+                "description": "v4: the node each arm's VM was placed on; null when the outcome names none.",
+                "type": ["object", "null"],
+                "required": ["base1", "head"],
+                "properties": {
+                  "base1": { "type": ["string", "null"] },
+                  "head": { "type": ["string", "null"] }
+                }
+              },
+              "failure": {
+                "description": "v4: the typed failure behind an UNKNOWN that is not an arrival or wall outcome, and behind an arrival-failed whose two arms stalled on the same step (error_class same-step-stall); null otherwise. Source is open like unknown_reason: a source added later still reads.",
+                "type": ["object", "null"],
+                "required": ["source", "arm", "error_class", "error_code", "node_id"],
+                "properties": {
+                  "source": { "type": "string", "description": "control-plane, transport, harness or runner" },
+                  "arm": { "enum": ["base1", "head", null] },
+                  "error_class": { "type": "string" },
+                  "error_code": { "type": ["string", "null"] },
+                  "node_id": { "type": ["string", "null"] }
+                }
+              },
               "phases": { "type": ["object", "null"] },
               "vm_ids": { "type": "array", "items": { "type": "string" } },
               "lease_ids": { "type": "array", "items": { "type": "string" } }
@@ -136,6 +158,11 @@
     "exit_code": { "type": "integer", "minimum": 0, "maximum": 2 },
     "error": { "type": "string" },
     "cancel_requested": { "const": true },
+    "previous_status": { "description": "On finalize, the batch's recorded status just before it.", "type": "string" },
+    "last_updated_at": { "description": "On finalize, the batch record's last update before it.", "type": "string" },
+    "eligibility": { "description": "On finalize, what made the batch finalizable.", "enum": ["cancel-requested", "stale"] },
+    "reason": { "description": "On finalize, the operator's reason, recorded as the batch error.", "type": "string" },
+    "finalized_at": { "type": "string" },
     "next_command": { "type": "string" },
     "out_dir": { "type": "string" },
     "manifest": {
@@ -161,6 +188,26 @@
       }
     },
     "artifact_count": { "type": "integer", "minimum": 0 },
+    "pending": {
+      "description": "On bundle, the listed PNGs the service reported as still uploading (HTTP 409, reason artifact-pending): the coordinator publishes a batch's PNGs after it is terminal. Nothing is written for them. Non-empty means the command exited 75 (EX_TEMPFAIL); retry, for example with --only for each path.",
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "failed": {
+      "description": "On bundle, the listed PNGs the service reported as failed for good (HTTP 410, reason artifact-failed): the coordinator gave up on their upload and recorded why. Nothing is written for them and a retry cannot fetch them. Non-empty with nothing pending means the command exited 1.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "error_class", "status", "message"],
+        "properties": {
+          "path": { "type": "string" },
+          "error_class": { "type": "string" },
+          "status": { "type": ["integer", "null"] },
+          "message": { "type": "string" }
+        }
+      }
+    },
     "total_bytes": { "type": "integer", "minimum": 0 }
   },
   "allOf": [
@@ -176,6 +223,10 @@
       "if": { "properties": { "operation": { "const": "cancel" } }, "required": ["operation"] },
       "then": { "required": ["repository", "cancel_requested"] }
     },
+    {
+      "if": { "properties": { "operation": { "const": "finalize" } }, "required": ["operation"] },
+      "then": { "required": ["repository", "status", "terminal", "cleanup_complete", "generation", "previous_status", "last_updated_at", "eligibility", "reason", "finalized_at"] }
+    },
     {
       "if": { "properties": { "operation": { "const": "bundle" } }, "required": ["operation"] },
       "then": { "required": ["repository", "out_dir", "manifest", "artifacts", "artifact_count", "total_bytes"] }

package/schemas/submit.v1.json

@@ -6,7 +6,7 @@
   "type": "object",
   "required": ["schema_version", "status"],
   "properties": {
-    "schema_version": { "type": "string", "const": "1.0.0" },
+    "schema_version": { "type": "string", "const": "1.0.1" },
     "status": { "type": "string", "enum": ["created", "already_exists", "error"] },
     "error": { "type": "string", "description": "Present only when status is 'error'. Actionable message including the remediation." },
     "ref": { "type": "string", "description": "owner/repo#number" },
@@ -61,7 +61,9 @@
               "file": { "type": "string" },
               "line": { "type": ["integer", "null"] },
               "message": { "type": "string" },
-              "rule": { "type": ["string", "null"] }
+              "rule": { "type": ["string", "null"] },
+              "category": { "type": ["string", "null"], "description": "Finding category (e.g. null-access, secret, rule-violation)." },
+              "failure_scenario": { "type": ["string", "null"], "description": "Concrete inputs/state and the resulting wrong behavior." }
             }
           }
         }