Files
Jonathan Boniface 416c66ced4
All checks were successful
check agents / check (push) Successful in 10s
Add CP1 Discovery agents in both patterns
ALZ-F01 Discovery as a sub-agent orchestrator (sub-agents/) and as eight
individual declarative agents (individual-agents/), with their KAB workflow
exports. Shared check, render and import scripts, the alz-discovery-sample
MCP server, the crucible-kab-dev deploy profile, deployment docs, platform
issue reports and the source material. Agent steps time out at 20 minutes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 18:25:57 +00:00

153 lines
7.8 KiB
Python

#!/usr/bin/env python3
"""Write workflows/cp1-alz-discovery.json: the KAB workflow export for ALZ-F01 Discovery.
The same export format as cp4-agents' workflow (export_version 2.0.0). Four steps call the one orchestrator agent,
one per phase. A step can pass only workflow inputs and earlier steps' outputs, so step 1 sends no phase (the agent
plans a new run) and each later step sends the previous step's next_phase. The critique step stops for the
Engagement Lead's approval. The step schemas are the agent's own contract, read from its schemas/ folder, so run
this again after changing them. Standard library only.
Front steps (ADR 0012, the repository's scripts/kab_front_steps.py), feeding the plan step only -- the orchestrator imports them into
its workspace and its sub-agents see only records:
u1 Parse Assessment Files: the run form's upload field `file` -> plan step's `source_documents`
a1 Artifacts: project artifacts fixed by id -> plan step's `artifacts`
Usage (from the Feature folder): python3 scripts/build_workflow.py [--no-upload] [--artifact-id ID ...] [--out FILE]
(the committed export is the default: with the upload step, no artifacts)
"""
from __future__ import annotations
import argparse
import json
import sys
from pathlib import Path
# kab_front_steps is shared by every Feature, in the repository's scripts/ folder.
sys.path.insert(0, str(Path(__file__).resolve().parents[3] / "scripts"))
from kab_front_steps import AGENT_STEP_TIMEOUT_MINUTES, ARTIFACTS_ID, UPLOAD_ID, front_steps, shift # noqa: E402
ROOT = Path(__file__).resolve().parents[1]
AGENT = "cp1-alz-discovery-orchestrator-agent"
AGENT_ID = AGENT.replace("-", "_")
DISPLAY = "CP1 - ALZ Discovery Orchestrator Agent"
URL = f"http://{AGENT}.agents.svc.cluster.local:8080"
NAME = "CP1 - Agentic Landing Zone - Discovery"
STAMP = "2026-10-29T12:00:00"
PHASES = [
("plan", "Turn the scope, sources and budgets into a task graph that accounts for every scope entry."),
("collect", "Ingest CMDB / ITSM records and scan the planned targets into one finding per scope entry."),
("analyse", "Build the canonical inventory, CMDB drift, data classification, network map and dependency graph."),
("critique", "Validate coverage, injection handling, evidence and tool-call integrity; the verdict is enforced in code."),
]
def build(with_upload: bool = True, artifact_ids=()) -> dict:
schemas = ROOT / AGENT / "schemas"
input_schema = json.loads((schemas / "input.json").read_text())
output_schema = json.loads((schemas / "output.json").read_text())
front = front_steps(
with_upload, list(artifact_ids), upload_label="Discovery source files",
upload_description="Optional client files for discovery: a CMDB or asset export, a scope list, network "
"documentation. They are imported into the run's workspace and given to the planner "
"and the inventory and CMDB steps as evidence, never as instructions.",
artifacts_description="Project artifacts for discovery, e.g. an earlier run's outputs. Imported into the "
"run's workspace with their id, type and hash as provenance.")
lead = 1 if front else 0
steps, connections = list(front), []
for index, (phase, description) in enumerate(PHASES):
step_id = f"s{index + 1}"
inputs = {"from_workflow": ["engagement_id", "run_id"]}
depends = [f"s{index}"] if index else []
if index:
inputs["from_steps"] = {"phase": f"s{index}.next_phase"}
connections.append({"source": f"s{index}", "target": step_id})
else:
# Only the plan step takes files: the orchestrator imports them; its sub-agents get records.
wired = {}
if any(f["id"] == UPLOAD_ID for f in front):
wired["source_documents"] = f"{UPLOAD_ID}.parsed_content"
if any(f["id"] == ARTIFACTS_ID for f in front):
wired["artifacts"] = f"{ARTIFACTS_ID}.artifacts"
if wired:
inputs["from_steps"] = wired
for f in front:
depends.append(f["id"])
connections.append({"source": f["id"], "target": step_id})
hitl = {"enabled": False}
if phase == "critique":
hitl = {
"enabled": True,
"checkpoint_type": "approval",
"review_focus": "The Engagement Lead reviews the critic's verdict, declared gaps and SME queues before "
"Assessment starts. A fail verdict is never auto-approved.",
"timeout_hours": 24,
"allowed_actions": ["continue", "rerun", "abort"],
"max_reruns": 2,
}
step_name = f"{DISPLAY} - {phase} Step"
steps.append(shift({
"id": step_id,
"agent": AGENT_ID,
"agent_type": AGENT_ID,
"name": step_name,
"timeout_minutes": AGENT_STEP_TIMEOUT_MINUTES,
"type": "sequential",
"executionLevel": index,
"parallelGroup": index,
"depends_on": depends,
"position": {"x": 320 * index, "y": 0},
"inputs": inputs,
"hitl": hitl,
"data": {
"agentType": AGENT_ID,
"name": step_name,
"description": f"Phase {phase}: {description}",
"category": "agent",
"temporalActivityName": "generic_agent_call",
"endpoint": {"url": URL, "method": "POST", "timeout": AGENT_STEP_TIMEOUT_MINUTES * 60, "protocol": "JSONRPC",
"protocol_version": "0.3.0"},
"agent_metadata": {"agent_name": AGENT_ID},
"inputSchema": input_schema,
"outputSchema": output_schema,
},
}, lead))
description = f"{NAME}: {DISPLAY} runs plan; then collect; then analyse; then critique (Engagement Lead approval)."
return {
"export_version": "2.0.0",
"export_timestamp": STAMP,
"source_environment": "unknown",
"workflow": {"name": NAME, "description": description, "version": "0.2.0",
"category": "cross-industry-catalog", "sub_category": "Public Cloud",
"tags": ["cp1", "public-cloud", "agentic-landing-zone"]},
"dependencies": {"activities": [],
"agents": [{"name": AGENT_ID, "display_name": DISPLAY, "source_url": URL, "category": "agent"}]},
"template": {
"name": NAME, "version": "0.2.0", "description": description,
"metadata": {"name": NAME, "description": description,
"category": {"main": "cross-industry-catalog", "sub": "Public Cloud"},
"sub_category": "Public Cloud", "status": "draft",
"tags": ["cp1", "public-cloud", "agentic-landing-zone"],
"created": f"{STAMP}.000Z", "modified": f"{STAMP}.000Z",
"display_order": 1, "is_public": False, "edge_visuals": []},
"connections": connections,
"steps": steps,
},
}
def main(argv=None) -> int:
parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
parser.add_argument("--no-upload", action="store_true", help="leave out the Parse Assessment Files step")
parser.add_argument("--artifact-id", action="append", default=[], help="add an Artifacts step with this id")
parser.add_argument("--out", type=Path, default=ROOT / "workflows" / "cp1-alz-discovery.json")
args = parser.parse_args(argv)
export = build(not args.no_upload, args.artifact_id)
args.out.write_text(json.dumps(export, indent=2) + "\n")
print(f"wrote {args.out}: {len(export['template']['steps'])} steps")
return 0
if __name__ == "__main__":
raise SystemExit(main())