All checks were successful
check agents / check (push) Successful in 10s
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>
153 lines
7.8 KiB
Python
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())
|