{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Proposed company specification envelope",
  "description": "Author proposal for research, not an industry standard. Structural validation must be followed by validate_spec.py semantic checks.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "schema_version",
    "revision",
    "kind",
    "audience",
    "status",
    "owner",
    "executor",
    "acceptor",
    "goal",
    "scope",
    "inputs",
    "requirements",
    "criteria",
    "tasks",
    "open_questions",
    "execution",
    "evidence",
    "acceptance",
    "change_log",
    "authority"
  ],
  "properties": {
    "id": {
      "$ref": "#/$defs/id"
    },
    "schema_version": {
      "const": "1.0"
    },
    "revision": {
      "$ref": "#/$defs/text"
    },
    "kind": {
      "enum": [
        "product",
        "technical",
        "task",
        "service"
      ]
    },
    "audience": {
      "enum": [
        "agent",
        "developer",
        "employee",
        "contractor",
        "client"
      ]
    },
    "status": {
      "enum": [
        "draft",
        "in_review",
        "approved",
        "superseded",
        "retired"
      ]
    },
    "owner": {
      "$ref": "#/$defs/id"
    },
    "executor": {
      "$ref": "#/$defs/id"
    },
    "acceptor": {
      "$ref": "#/$defs/id"
    },
    "goal": {
      "$ref": "#/$defs/text"
    },
    "scope": {
      "$ref": "#/$defs/scope"
    },
    "inputs": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/input"
      }
    },
    "requirements": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/requirement"
      },
      "minItems": 1
    },
    "criteria": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/criterion"
      }
    },
    "tasks": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/task"
      }
    },
    "open_questions": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/question"
      }
    },
    "execution": {
      "$ref": "#/$defs/execution"
    },
    "evidence": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/evidence"
      }
    },
    "acceptance": {
      "$ref": "#/$defs/acceptance"
    },
    "change_log": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/change"
      },
      "minItems": 1
    },
    "authority": {
      "$ref": "#/$defs/authority"
    }
  },
  "$defs": {
    "text": {
      "type": "string",
      "minLength": 1,
      "pattern": "\\S"
    },
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9._:-]*$"
    },
    "scope": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "included",
        "excluded"
      ],
      "properties": {
        "included": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/text"
          },
          "minItems": 1
        },
        "excluded": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/text"
          }
        }
      }
    },
    "input": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "reference",
        "revision",
        "access"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/id"
        },
        "reference": {
          "$ref": "#/$defs/text"
        },
        "revision": {
          "$ref": "#/$defs/text"
        },
        "access": {
          "$ref": "#/$defs/text"
        }
      }
    },
    "requirement": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "text",
        "priority",
        "source_ref",
        "confirmed"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/id"
        },
        "text": {
          "$ref": "#/$defs/text"
        },
        "priority": {
          "enum": [
            "must",
            "should"
          ]
        },
        "source_ref": {
          "$ref": "#/$defs/id"
        },
        "confirmed": {
          "type": "boolean"
        }
      }
    },
    "criterion": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "requirement_ids",
        "method",
        "procedure",
        "expected",
        "evidence_required"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/id"
        },
        "requirement_ids": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/id"
          },
          "minItems": 1,
          "uniqueItems": true
        },
        "method": {
          "enum": [
            "test",
            "inspection",
            "measurement",
            "analysis",
            "demonstration"
          ]
        },
        "procedure": {
          "$ref": "#/$defs/text"
        },
        "expected": {
          "$ref": "#/$defs/text"
        },
        "evidence_required": {
          "type": "boolean"
        }
      }
    },
    "task": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "requirement_ids",
        "criterion_ids"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/id"
        },
        "requirement_ids": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/id"
          },
          "minItems": 1,
          "uniqueItems": true
        },
        "criterion_ids": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/id"
          },
          "uniqueItems": true
        }
      }
    },
    "question": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "text",
        "blocking",
        "resolved"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/id"
        },
        "text": {
          "$ref": "#/$defs/text"
        },
        "blocking": {
          "type": "boolean"
        },
        "resolved": {
          "type": "boolean"
        }
      }
    },
    "execution": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "status",
        "artifact_ref",
        "artifact_revision"
      ],
      "properties": {
        "status": {
          "enum": [
            "not_started",
            "in_progress",
            "submitted",
            "changes_requested",
            "accepted",
            "rejected"
          ]
        },
        "artifact_ref": {
          "anyOf": [
            {
              "$ref": "#/$defs/text"
            },
            {
              "type": "null"
            }
          ]
        },
        "artifact_revision": {
          "anyOf": [
            {
              "$ref": "#/$defs/text"
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "evidence": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "criterion_id",
        "spec_revision",
        "artifact_revision",
        "result",
        "reference",
        "checker"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/id"
        },
        "criterion_id": {
          "$ref": "#/$defs/id"
        },
        "spec_revision": {
          "$ref": "#/$defs/text"
        },
        "artifact_revision": {
          "$ref": "#/$defs/text"
        },
        "result": {
          "enum": [
            "pass",
            "fail",
            "not_run"
          ]
        },
        "reference": {
          "$ref": "#/$defs/text"
        },
        "checker": {
          "$ref": "#/$defs/id"
        }
      }
    },
    "acceptance": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "decision",
        "actor",
        "reason",
        "evidence_ids",
        "spec_revision",
        "artifact_revision",
        "decided_at"
      ],
      "properties": {
        "decision": {
          "enum": [
            "pending",
            "accept",
            "return",
            "reject"
          ]
        },
        "actor": {
          "anyOf": [
            {
              "$ref": "#/$defs/id"
            },
            {
              "type": "null"
            }
          ]
        },
        "reason": {
          "$ref": "#/$defs/text"
        },
        "evidence_ids": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/id"
          },
          "uniqueItems": true
        },
        "spec_revision": {
          "anyOf": [
            {
              "$ref": "#/$defs/text"
            },
            {
              "type": "null"
            }
          ]
        },
        "artifact_revision": {
          "anyOf": [
            {
              "$ref": "#/$defs/text"
            },
            {
              "type": "null"
            }
          ]
        },
        "decided_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        }
      }
    },
    "change": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "revision",
        "reason",
        "affected_ids"
      ],
      "properties": {
        "revision": {
          "$ref": "#/$defs/text"
        },
        "reason": {
          "$ref": "#/$defs/text"
        },
        "affected_ids": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/id"
          },
          "minItems": 1,
          "uniqueItems": true
        }
      }
    },
    "authority": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "allowed",
        "forbidden",
        "stop_conditions"
      ],
      "properties": {
        "allowed": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/text"
          }
        },
        "forbidden": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/text"
          }
        },
        "stop_conditions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/text"
          }
        }
      }
    }
  }
}
