{ "type": "object", "title": "One discovery phase for one engagement run", "additionalProperties": false, "properties": { "engagement_id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$", "description": "The engagement being discovered. One engagement is one platform project.", "examples": [ "ENG-MERIDIAN-001" ] }, "run_id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$", "description": "The discovery run. Every phase of one run passes the same id, which is what lets a later phase read what an earlier one stored.", "examples": [ "RUN-2026-10-29-01" ] }, "phase": { "type": [ "string", "null" ], "enum": [ "plan", "collect", "analyse", "critique", null ], "default": null, "description": "Which phase to run. Phases run in this order; each needs the one before it in the same run. Left out, the run's workspace decides: the first phase it has not yet stored. A workflow step passes the previous step's next_phase." }, "batch": { "type": [ "integer", "null" ], "minimum": 1, "default": null, "description": "collect only: the scan batch from the plan to run. Null runs every batch, which suits a small estate." }, "source_documents": { "type": [ "string", "null" ], "default": null, "description": "plan only: the text of files uploaded at run time, as a 'Parse Assessment Files' step hands it on (its parsed_content), e.g. a CMDB or asset export or a scope list. Imported into the run workspace as plan/source-documents." }, "artifacts": { "type": [ "array", "null" ], "default": null, "items": { "type": "object" }, "description": "plan only: project artifacts an 'Artifacts' step selected (its artifacts output), e.g. an earlier run's outputs or a file added to the project. Each is imported into the run workspace as plan/artifact-NN, with its id, type and sha256 kept as provenance.", "x-artifact-types": [ "file", "structured_data", "report", "execution_output", "assessment_result" ] } }, "required": [ "engagement_id", "run_id" ] }