@osstack/protocol 0.15.0 → 0.22.0

package/schemas/follow-up-obligation.schema.json

@@ -0,0 +1,343 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSStack FollowUpObligation",
+  "$comment": "Local ledger only; parsing does not authorize remote delivery. Runtime validates canonical repository, source binding, revisions and response byte budget.",
+  "type": "object",
+  "properties": {
+    "repo_path": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4096
+    },
+    "default_tenant": {
+      "type": "boolean",
+      "const": true
+    },
+    "obligation_id": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "source_session_id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "source_task_id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "source_run_id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "source_creation_version": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740990
+    },
+    "source_identity_digest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "actor": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "promise": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4096
+    },
+    "destination_ref": {
+      "type": "string",
+      "const": "local_operator"
+    },
+    "resolution_condition": {
+      "type": "string",
+      "enum": [
+        "manual",
+        "session_completed"
+      ]
+    },
+    "due_at": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 8640000000000000
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "state": {
+      "type": "string",
+      "enum": [
+        "open",
+        "drafted",
+        "fulfilled_local",
+        "waived"
+      ]
+    },
+    "revision": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740990
+    },
+    "created_at": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 8640000000000000
+    },
+    "updated_at": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 8640000000000000
+    },
+    "draft": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "text": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 8192
+            },
+            "content_digest": {
+              "type": "string",
+              "pattern": "^[a-f0-9]{64}$"
+            },
+            "source": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "starting",
+                        "running",
+                        "awaiting_decision",
+                        "idle",
+                        "completed",
+                        "failed",
+                        "cancelled"
+                      ]
+                    },
+                    "version": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740990
+                    },
+                    "updated_at": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 8640000000000000
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "version",
+                    "updated_at"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "source_missing": {
+              "type": "boolean"
+            },
+            "created_at": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 8640000000000000
+            },
+            "delivery_state": {
+              "type": "string",
+              "const": "unsent"
+            }
+          },
+          "required": [
+            "text",
+            "content_digest",
+            "source",
+            "source_missing",
+            "created_at",
+            "delivery_state"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "resolution": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "waive",
+                "condition"
+              ]
+            },
+            "actor": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128
+            },
+            "reason": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024
+            },
+            "source": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "starting",
+                        "running",
+                        "awaiting_decision",
+                        "idle",
+                        "completed",
+                        "failed",
+                        "cancelled"
+                      ]
+                    },
+                    "version": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740990
+                    },
+                    "updated_at": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 8640000000000000
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "version",
+                    "updated_at"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "resolved_at": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 8640000000000000
+            },
+            "external_delivery": {
+              "type": "string",
+              "const": "unsupported"
+            }
+          },
+          "required": [
+            "mode",
+            "actor",
+            "reason",
+            "source",
+            "resolved_at",
+            "external_delivery"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "source": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "state": {
+              "type": "string",
+              "enum": [
+                "starting",
+                "running",
+                "awaiting_decision",
+                "idle",
+                "completed",
+                "failed",
+                "cancelled"
+              ]
+            },
+            "version": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740990
+            },
+            "updated_at": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 8640000000000000
+            }
+          },
+          "required": [
+            "state",
+            "version",
+            "updated_at"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "source_missing": {
+      "type": "boolean"
+    },
+    "external_delivery": {
+      "type": "string",
+      "const": "unsupported"
+    }
+  },
+  "required": [
+    "repo_path",
+    "default_tenant",
+    "obligation_id",
+    "source_session_id",
+    "source_task_id",
+    "source_run_id",
+    "source_creation_version",
+    "source_identity_digest",
+    "actor",
+    "promise",
+    "destination_ref",
+    "resolution_condition",
+    "due_at",
+    "state",
+    "revision",
+    "created_at",
+    "updated_at",
+    "draft",
+    "resolution",
+    "source",
+    "source_missing",
+    "external_delivery"
+  ],
+  "additionalProperties": false
+}

package/schemas/follow-up-resolve-params.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSStack FollowUpResolveParams",
+  "$comment": "Local ledger only; parsing does not authorize remote delivery. Runtime validates canonical repository, source binding, revisions and response byte budget.",
+  "type": "object",
+  "properties": {
+    "repo_path": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4096
+    },
+    "default_tenant": {
+      "type": "boolean",
+      "const": true
+    },
+    "obligation_id": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "expected_revision": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740990
+    },
+    "actor": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "waive",
+        "condition"
+      ]
+    }
+  },
+  "required": [
+    "repo_path",
+    "default_tenant",
+    "obligation_id",
+    "expected_revision",
+    "actor",
+    "reason",
+    "mode"
+  ],
+  "additionalProperties": false
+}

package/schemas/frozen-delivery-contract-v2.schema.json

@@ -0,0 +1,258 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSStack Frozen Delivery Contract v2",
+  "$comment": "Shape only. The host must recompute the canonical contract digest and bind it to the actual repository and accepted policy.",
+  "type": "object",
+  "properties": {
+    "contract": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 2
+        },
+        "contract_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "parent_contract_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "task_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "canonical_repo": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "scout",
+            "implement"
+          ]
+        },
+        "base_head": {
+          "type": "string",
+          "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$"
+        },
+        "goal": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "required_checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              },
+              "registry_ref": {
+                "type": "string",
+                "pattern": "^sha256:[a-f0-9]{64}$"
+              }
+            },
+            "required": [
+              "id",
+              "registry_ref"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1,
+          "maxItems": 100
+        },
+        "review_policy_ref": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "requested_completion": {
+          "type": "string",
+          "enum": [
+            "local_verified",
+            "pr_opened",
+            "merged",
+            "deployed"
+          ]
+        },
+        "allowed_paths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4096
+          },
+          "minItems": 1,
+          "maxItems": 1000
+        },
+        "requested_actions": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "build",
+              "verify",
+              "commit",
+              "push",
+              "open_pr",
+              "merge",
+              "deploy:staging",
+              "deploy:production"
+            ]
+          },
+          "minItems": 1,
+          "maxItems": 8
+        },
+        "budget_ref": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "policy_digest": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "publication_scope": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "const": "none"
+                }
+              },
+              "required": [
+                "mode"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "push",
+                    "draft_pr",
+                    "review_pr"
+                  ]
+                },
+                "hostname": {
+                  "type": "string",
+                  "const": "github.com"
+                },
+                "repository": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$"
+                },
+                "remote": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+                },
+                "base_ref": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 255
+                },
+                "head_ref": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 255
+                }
+              },
+              "required": [
+                "mode",
+                "hostname",
+                "repository",
+                "remote",
+                "base_ref",
+                "head_ref"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "merge_authority": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "const": "none"
+                }
+              },
+              "required": [
+                "mode"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "const": "existing_guarded_policy"
+                },
+                "policy_ref": {
+                  "type": "string",
+                  "pattern": "^sha256:[a-f0-9]{64}$"
+                }
+              },
+              "required": [
+                "mode",
+                "policy_ref"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        }
+      },
+      "required": [
+        "schema_version",
+        "contract_id",
+        "task_id",
+        "canonical_repo",
+        "mode",
+        "base_head",
+        "goal",
+        "required_checks",
+        "review_policy_ref",
+        "requested_completion",
+        "allowed_paths",
+        "requested_actions",
+        "budget_ref",
+        "policy_digest",
+        "publication_scope",
+        "merge_authority"
+      ],
+      "additionalProperties": false
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "brief": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 32000
+    }
+  },
+  "required": [
+    "contract",
+    "digest",
+    "brief"
+  ],
+  "additionalProperties": false
+}