- Scripts to run workflows from a YAML context or run inputs (kab_run_workflow.py, with --input name=@file), store per-project discovery connections, bootstrap agent MCP keys, refresh the KAB token, publish reports and build estate snapshots. - Hyperscaler discovery servers extended in place; cloud-knowledge folded into them. - deploy/crucible-kab-dev.yaml: the Discovery package agent and the Assessment agents. - Platform issue write-ups and current-wiring notes under docs/platform-issues/. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
74 lines
3.7 KiB
Python
74 lines
3.7 KiB
Python
#!/usr/bin/env python3
|
|
"""Upload an approved Discovery report to a KAB project, as a file artifact.
|
|
|
|
A workflow step's output is always registered as output.json, so the customer's page reaches KAB this way, after the
|
|
Engagement Lead has approved the run. The `file` type is used because `report` artifacts need Azure Blob, S3 or MongoDB
|
|
storage through a route that has no blob store on crucible-kab-dev; `file` artifacts stay on the shared volume. Render the clean copy first with the Feature's scripts/render_discovery_report.py.
|
|
|
|
Authentication: your KAB session's access token, from --token-file (default ~/.kab_token). It is sent only as the
|
|
Authorization header and never printed. Uploading needs the Editor role in the project. Standard library only.
|
|
|
|
Usage (from the repository root):
|
|
python3 scripts/kab_publish_report.py <report.html> --project <id> --name <name> # shows what it would do
|
|
python3 scripts/kab_publish_report.py <report.html> --project <id> --name <name> --apply
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import json
|
|
import sys
|
|
import urllib.error
|
|
import urllib.request
|
|
import uuid
|
|
from pathlib import Path
|
|
|
|
from kab_run_workflow import CP1_TENANT, DEFAULT_API
|
|
|
|
TYPES = {".html": "text/html", ".md": "text/markdown"}
|
|
|
|
|
|
def multipart(fields: dict, path: Path, boundary: str) -> bytes:
|
|
parts = [f'--{boundary}\r\nContent-Disposition: form-data; name="{k}"\r\n\r\n{v}\r\n'.encode() for k, v in fields.items()]
|
|
head = (f'--{boundary}\r\nContent-Disposition: form-data; name="file"; filename="{path.name}"\r\n'
|
|
f"Content-Type: {TYPES[path.suffix]}\r\n\r\n").encode()
|
|
return b"".join(parts) + head + path.read_bytes() + f"\r\n--{boundary}--\r\n".encode()
|
|
|
|
|
|
def main() -> int:
|
|
parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
|
|
parser.add_argument("report", type=Path)
|
|
parser.add_argument("--project", required=True)
|
|
parser.add_argument("--name", required=True)
|
|
parser.add_argument("--description", default="Discovery report")
|
|
parser.add_argument("--api", default=DEFAULT_API)
|
|
parser.add_argument("--tenant", default=CP1_TENANT)
|
|
parser.add_argument("--token-file", type=Path, default=Path.home() / ".kab_token")
|
|
parser.add_argument("--apply", action="store_true", help="upload; without it nothing is sent")
|
|
args = parser.parse_args()
|
|
if args.report.suffix not in TYPES:
|
|
raise SystemExit("the report must be a .html or .md file")
|
|
text = args.report.read_text()
|
|
if "Draft. Not for release" in text:
|
|
raise SystemExit("this copy is marked as a draft: render a clean one from the approved run")
|
|
print(f"{args.report.name}: {len(text) // 1024} KB, to project {args.project} as {args.name!r}")
|
|
if not args.apply:
|
|
print("Nothing sent. Add --apply to upload.")
|
|
return 0
|
|
boundary = uuid.uuid4().hex
|
|
body = multipart({"name": args.name, "type_id": "file", "description": args.description}, args.report, boundary)
|
|
request = urllib.request.Request(f"{args.api}/api/v1/projects/{args.project}/artifacts/upload", data=body, method="POST", headers={
|
|
"Authorization": f"Bearer {args.token_file.read_text().strip()}", "X-Tenant-ID": args.tenant, "X-Project-ID": args.project,
|
|
"Content-Type": f"multipart/form-data; boundary={boundary}"})
|
|
try:
|
|
with urllib.request.urlopen(request, timeout=60) as response:
|
|
print("Uploaded:", json.load(response).get("id"))
|
|
except urllib.error.HTTPError as error:
|
|
print(f"HTTP {error.code}: {error.read().decode(errors='replace')[:300]}", file=sys.stderr)
|
|
return 1
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|