@tiic-tech/openworkflow 0.1.0

package/schemas/artifact-contracts.schema.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/artifact-contracts.schema.json",
+  "title": "OpenWorkflow Artifact Contracts Index",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "title",
+    "status",
+    "source_of_truth",
+    "artifacts"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "workflow"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "source_of_truth": {
+      "type": "string"
+    },
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+          "required": [
+            "artifact_type",
+            "contract_type",
+            "command",
+            "source_of_truth_path",
+            "template_path",
+            "required_keys"
+          ],
+        "properties": {
+          "artifact_type": {
+            "type": "string"
+          },
+          "contract_type": {
+            "type": "string"
+          },
+          "command": {
+            "type": "string"
+          },
+          "source_of_truth_path": {
+            "type": "string"
+          },
+          "template_path": {
+            "type": "string"
+          },
+          "read_policy": {
+            "type": "object",
+            "required": [
+              "load_by_default",
+              "agent_read_order",
+              "max_yaml_lines",
+              "max_note_lines",
+              "raw_evidence"
+            ],
+            "properties": {
+              "load_by_default": {
+                "type": "boolean"
+              },
+              "agent_read_order": {
+                "type": "integer"
+              },
+              "max_yaml_lines": {
+                "type": "integer"
+              },
+              "max_note_lines": {
+                "type": "integer"
+              },
+              "raw_evidence": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": true
+          },
+          "active_pointer": {
+            "type": "object",
+            "required": [
+              "index_path",
+              "pointer_key",
+              "collection_key",
+              "id_key",
+              "path_key"
+            ],
+            "properties": {
+              "index_path": {
+                "type": "string"
+              },
+              "pointer_key": {
+                "type": "string"
+              },
+              "collection_key": {
+                "type": "string"
+              },
+              "id_key": {
+                "type": "string"
+              },
+              "path_key": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": true
+          },
+          "required_keys": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/change.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/change.schema.json",
+  "title": "OpenWorkflow Change Contract",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "title",
+    "status",
+    "problem",
+    "goals",
+    "non_goals",
+    "affected_paths",
+    "acceptance",
+    "validation"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "change"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "problem": {
+      "type": "string"
+    },
+    "goals": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "non_goals": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "affected_paths": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "acceptance": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "validation": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": true
+}
+

package/schemas/contract-graph.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/contract-graph.schema.json",
+  "title": "OpenWorkflow Contract Graph",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "title",
+    "status",
+    "nodes",
+    "edges"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "workflow"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "contract_id",
+          "contract_type",
+          "path"
+        ],
+        "properties": {
+          "contract_id": {
+            "type": "string"
+          },
+          "contract_type": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "edges": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "from",
+          "to",
+          "relation"
+        ],
+        "properties": {
+          "from": {
+            "type": "string"
+          },
+          "to": {
+            "type": "string"
+          },
+          "relation": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}
+

package/schemas/decision-record.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/decision-record.schema.json",
+  "title": "OpenWorkflow Decision Record Artifact",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "artifact_type",
+    "title",
+    "status",
+    "reviewed_evidence",
+    "outcome",
+    "rationale",
+    "accepted_scope",
+    "rejected_scope",
+    "revision_scope",
+    "next_command",
+    "follow_up_questions"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "decision"
+    },
+    "artifact_type": {
+      "const": "decision_record"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "reviewed_evidence": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "outcome": {
+      "type": "string",
+      "enum": [
+        "continue",
+        "revise",
+        "pivot",
+        "stop",
+        "needs_more_evidence"
+      ]
+    },
+    "rationale": {
+      "type": "string"
+    },
+    "accepted_scope": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "rejected_scope": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "revision_scope": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "next_command": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "follow_up_questions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/disclosure-levels.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/disclosure-levels.schema.json",
+  "title": "OpenWorkflow Disclosure Levels",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "title",
+    "status",
+    "levels"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "workflow"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "levels": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "level",
+          "name",
+          "default_for_agents",
+          "purpose",
+          "examples"
+        ],
+        "properties": {
+          "level": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "default_for_agents": {
+            "type": "boolean"
+          },
+          "purpose": {
+            "type": "string"
+          },
+          "examples": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/openworkflow-contract.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/openworkflow-contract.schema.json",
+  "title": "OpenWorkflow Common Contract",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "title",
+    "status"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "pattern": "^0\\.1\\.0$"
+    },
+    "contract_id": {
+      "type": "string",
+      "pattern": "^[a-z_]+:[A-Za-z0-9_.-]+$"
+    },
+    "contract_type": {
+      "type": "string",
+      "enum": [
+        "workflow",
+        "context",
+        "vision",
+        "design",
+        "decision",
+        "spec",
+        "validation",
+        "prototype",
+        "change",
+        "work_items",
+        "team",
+        "runtime"
+      ]
+    },
+    "artifact_type": {
+      "type": "string",
+      "enum": [
+        "vision_session",
+        "validation_target",
+        "prototype_evidence",
+        "decision_record",
+        "product_design"
+      ]
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft",
+        "active",
+        "superseded",
+        "archived"
+      ]
+    },
+    "source_artifacts": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "depends_on": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "produces": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "updated_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "additionalProperties": true
+}