okstra 0.207.0 → 0.208.0

package/runtime/schemas/business-flow-v1.schema.json

@@ -0,0 +1,847 @@
+{
+  "$defs": {
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "projectId",
+        "path",
+        "line",
+        "endLine",
+        "excerpt"
+      ],
+      "properties": {
+        "projectId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "line": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "endLine": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "excerpt": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "fact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key",
+        "business",
+        "value",
+        "level",
+        "evidence"
+      ],
+      "properties": {
+        "key": {
+          "type": "string",
+          "minLength": 1
+        },
+        "business": {
+          "type": "string",
+          "minLength": 1
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1
+        },
+        "level": {
+          "enum": [
+            "static",
+            "execution-verified",
+            "expected",
+            "unknown"
+          ]
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/evidence"
+          }
+        },
+        "executionEvidence": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "relatedKeys": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "aliases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "step": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "title",
+        "purpose",
+        "projectIds",
+        "inputs",
+        "outputs",
+        "rules",
+        "states",
+        "failures",
+        "retries",
+        "recovery",
+        "factKeys",
+        "before",
+        "after",
+        "risks",
+        "sideEffects"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1
+        },
+        "projectIds": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        },
+        "inputs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "outputs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "rules": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "states": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "failures": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "retries": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "recovery": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "factKeys": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        },
+        "before": {
+          "type": "string"
+        },
+        "after": {
+          "type": "string"
+        },
+        "risks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "sideEffects": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "relationship": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to",
+        "kind",
+        "data",
+        "factKeys"
+      ],
+      "properties": {
+        "from": {
+          "type": "string",
+          "minLength": 1
+        },
+        "to": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "enum": [
+            "call",
+            "event",
+            "queue",
+            "shared-data",
+            "file",
+            "batch"
+          ]
+        },
+        "data": {
+          "type": "string",
+          "minLength": 1
+        },
+        "factKeys": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "resolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "claimIds",
+        "acceptedClaimId",
+        "reason"
+      ],
+      "properties": {
+        "claimIds": {
+          "type": "array",
+          "minItems": 2,
+          "uniqueItems": true,
+          "items": {
+            "type": "string"
+          }
+        },
+        "acceptedClaimId": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "result": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "summary",
+        "terms",
+        "steps",
+        "relationships",
+        "facts",
+        "inspectedProjects",
+        "gaps",
+        "questions",
+        "resolutions"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 1
+        },
+        "terms": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "term",
+              "meaning"
+            ],
+            "properties": {
+              "term": {
+                "type": "string"
+              },
+              "meaning": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/step"
+          }
+        },
+        "relationships": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/relationship"
+          }
+        },
+        "facts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/fact"
+          }
+        },
+        "inspectedProjects": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string"
+          }
+        },
+        "gaps": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "questions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "resolutions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/resolution"
+          }
+        }
+      }
+    },
+    "knowledge": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "claims",
+        "resolutions"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "claims": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/claim"
+          }
+        },
+        "resolutions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/storedResolution"
+          }
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "id",
+        "createdAt",
+        "request",
+        "projects",
+        "status"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "id": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "request": {
+          "$ref": "#/$defs/flowRequest"
+        },
+        "projects": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/sourceSnapshot"
+          }
+        },
+        "status": {
+          "enum": [
+            "prepared",
+            "running",
+            "awaiting-native",
+            "complete",
+            "partial",
+            "failed"
+          ]
+        },
+        "result": {
+          "$ref": "#/$defs/result"
+        },
+        "reports": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "markdown": {
+              "type": "string"
+            },
+            "html": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "taskLink": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "taskKey",
+        "executions"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "taskKey": {
+          "type": "string"
+        },
+        "executions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/taskLinkRow"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "claim": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key",
+        "business",
+        "value",
+        "level",
+        "evidence",
+        "id",
+        "sourceStates",
+        "producer",
+        "producers",
+        "createdAt",
+        "status"
+      ],
+      "properties": {
+        "key": {
+          "type": "string",
+          "minLength": 1
+        },
+        "business": {
+          "type": "string",
+          "minLength": 1
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1
+        },
+        "level": {
+          "enum": [
+            "static",
+            "execution-verified",
+            "expected",
+            "unknown"
+          ]
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/evidence"
+          }
+        },
+        "executionEvidence": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "relatedKeys": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "aliases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "id": {
+          "type": "string"
+        },
+        "sourceStates": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "required": [
+              "root",
+              "digest",
+              "head"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "root": {
+                "type": "string"
+              },
+              "digest": {
+                "type": "string"
+              },
+              "head": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "producer": {
+          "type": "object"
+        },
+        "producers": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "status": {
+          "enum": [
+            "accepted",
+            "conflict",
+            "superseded"
+          ]
+        }
+      }
+    },
+    "taskRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "taskKey",
+        "taskType",
+        "question",
+        "sourceRoot",
+        "reportLanguage",
+        "hostRuntime"
+      ],
+      "properties": {
+        "taskKey": {
+          "type": "string",
+          "minLength": 1
+        },
+        "taskType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sourceRoot": {
+          "type": "string",
+          "minLength": 1
+        },
+        "reportLanguage": {
+          "type": "string",
+          "minLength": 1
+        },
+        "hostRuntime": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "taskLinkRow": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "mode",
+        "status",
+        "inputDigest",
+        "reports",
+        "summary",
+        "error"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "mode": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "inputDigest": {
+          "type": "string"
+        },
+        "summary": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        },
+        "reports": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "markdown": {
+              "type": "string"
+            },
+            "html": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "verificationReceipt": {
+      "type": "object",
+      "required": [
+        "command",
+        "startedAt",
+        "endedAt",
+        "exitCode",
+        "sourceStates",
+        "output"
+      ],
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "startedAt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "endedAt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "exitCode": {
+          "const": 0
+        },
+        "output": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sourceStates": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "flowRequest": {
+      "type": "object",
+      "required": [
+        "project_root",
+        "question",
+        "mode",
+        "task_key",
+        "baseline",
+        "source_root",
+        "report_language",
+        "source_artifacts",
+        "host_runtime"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "project_root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mode": {
+          "enum": [
+            "current",
+            "pre",
+            "post",
+            "contribute",
+            "reconcile"
+          ]
+        },
+        "task_key": {
+          "type": "string"
+        },
+        "baseline": {
+          "type": "string"
+        },
+        "source_root": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "report_language": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source_artifacts": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "host_runtime": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "sourceSnapshot": {
+      "type": "object",
+      "required": [
+        "projectId",
+        "root",
+        "head",
+        "digest",
+        "files",
+        "dirty",
+        "gaps"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "projectId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "head": {
+          "type": "string"
+        },
+        "digest": {
+          "type": "string"
+        },
+        "files": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "dirty": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "gaps": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "indexDigest": {
+          "type": "string"
+        },
+        "indexPatch": {
+          "type": "string"
+        },
+        "statusDigest": {
+          "type": "string"
+        }
+      }
+    },
+    "storedResolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "claimIds",
+        "acceptedClaimId",
+        "reason",
+        "producer",
+        "createdAt"
+      ],
+      "properties": {
+        "claimIds": {
+          "type": "array",
+          "minItems": 2,
+          "uniqueItems": true,
+          "items": {
+            "type": "string"
+          }
+        },
+        "acceptedClaimId": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "producer": {
+          "type": "object"
+        },
+        "createdAt": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}