Files
Jonathan Boniface 8bb62a4a42 ALZ-F01 Discovery sub-agent pattern: report phase and fetch in code
Orchestrator report phase (ADR 0013) and fetching in code (ADR 0014), with the report renderer.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 22:13:25 +00:00

97 lines
2.8 KiB
JSON

{
"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",
"report",
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"
]
},
"include_cmdb": {
"type": "string",
"enum": [
"yes",
"no"
],
"default": "yes",
"description": "Use the engagement's CMDB connection in this run: yes or no. Read in the plan phase."
},
"include_itsm": {
"type": "string",
"enum": [
"yes",
"no"
],
"default": "yes",
"description": "Use the engagement's ITSM connection in this run: yes or no. Read in the plan phase."
}
},
"required": [
"engagement_id",
"run_id"
]
}