"""Shakedown runner: run a voyage's workflows on KAB remotely, as the kab-automation identity. python3 -m shakedown_lib token-check python3 -m shakedown_lib run capabilities/cp1-agentic-landing-zone/voyages/ENG-CYMBAL-001.yaml --dry-run python3 -m shakedown_lib run [--only f02 f03] python3 -m shakedown_lib run --resume ledger/ENG-CYMBAL-001/ Environment: KAB_CLIENT_SECRET (required), KAB_CLIENT_ID (kab-automation), KAB_TOKEN_URL, KAB_API, KAB_TENANT, CP1_AGENTS_DIR (the cp1-agents clone, default ../cp1-agents), SHAKEDOWN_LEDGER (default ./ledger). Which projects the runner may decide gates in is set only in config/runner.yaml. Exit status: 0 done, 2 configuration or KAB refused, 3 stopped for a fix, 4 nobody decided a review point in time, 5 a stage ran too long. """ from __future__ import annotations import argparse import base64 import json import os import sys from pathlib import Path from .auth import AuthError, ClientCredentials from .kab import CP1_TENANT, DEFAULT_API, Kab from .ledger import Ledger, default_root from .runner import EXIT_CONFIG, Runner, Settings from .voyage import VoyageError, load_config, load_voyage def _claims(token: str) -> dict: try: payload = token.split(".")[1] return json.loads(base64.urlsafe_b64decode(payload + "=" * (-len(payload) % 4))) except (IndexError, ValueError): return {} def token_check() -> int: tokens = ClientCredentials.from_env() claims = _claims(tokens.token()) shown = {k: claims.get(k) for k in ("iss", "azp", "email", "preferred_username", "exp")} print(f"Token issued to {tokens.client_id}, valid for {tokens.expires_in()} s. Claims: {json.dumps(shown)}") return 0 def run(args) -> int: voyage = load_voyage(Path(args.voyage)) settings = Settings.from_config(load_config()) kab = Kab(ClientCredentials.from_env(), api=os.getenv("KAB_API", DEFAULT_API), tenant=os.getenv("KAB_TENANT", CP1_TENANT), project=voyage.project) ledger = Ledger(Path(args.resume)) if args.resume else Ledger.new(default_root(), voyage.name) return Runner(kab=kab, ledger=ledger, voyage=voyage, settings=settings).run(dry_run=args.dry_run, only=args.only) def main(argv=None) -> int: parser = argparse.ArgumentParser(prog="shakedown_lib", description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) commands = parser.add_subparsers(dest="command", required=True) commands.add_parser("token-check", help="get a token as kab-automation and show who it names") start = commands.add_parser("run", help="run a voyage") start.add_argument("voyage") start.add_argument("--dry-run", action="store_true", help="build and check every stage's inputs; start nothing") start.add_argument("--resume", help="a ledger folder of an earlier run of this voyage") start.add_argument("--only", nargs="+", help="run only these stages (earlier ones must be completed)") args = parser.parse_args(argv) try: return token_check() if args.command == "token-check" else run(args) except (AuthError, VoyageError, FileNotFoundError, RuntimeError) as error: print(f"Refused: {error}", file=sys.stderr) return EXIT_CONFIG if __name__ == "__main__": sys.exit(main())