- shakedown_lib: runs F01 -> F02 -> F03 for one engagement on KAB with no personal token. Signs in as the kab-automation client (client credentials, provisioned by Stellwerk from crucible-platform-deploy) and renews the token itself. - Each stage checks its workflow id against the registered sub-agent name, builds inputs from the case and upstream stages, starts the run, follows it and judges it with cp1-agents evaluate_case.py. - Gates (plan 5b): in config/runner.yaml gate_projects only, continue on a critic pass with no failed step and a note saying the system decided. Never on a fail. Elsewhere, wait for a person and record who decided. gate_projects is empty for now. - Ledger per voyage run, with --resume; nothing secret is written. - Cymbal voyage ENG-CYMBAL-001; workflow registry; Dockerfile and an unapplied Job template; 15 tests against a fake KAB. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
79 lines
2.9 KiB
Python
79 lines
2.9 KiB
Python
"""The run ledger: one folder per voyage run, and one per stage inside it (plan §4).
|
|
|
|
<root>/<voyage>/<started UTC>/state.json every stage's state, ids, gate decisions; rewritten on each change
|
|
<root>/<voyage>/<started UTC>/<stage>/inputs.json the run inputs as sent, uploads shown by name only
|
|
<root>/<voyage>/<started UTC>/<stage>/context.yaml the context file as uploaded or sent (with `generated:`)
|
|
<root>/<voyage>/<started UTC>/<stage>/status.json, steps.json, evaluation.json
|
|
|
|
No token or secret is ever written here. state.json is what a resumed run reads.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
import os
|
|
from datetime import datetime, timezone
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
|
|
def utc_stamp(now: float | None = None) -> str:
|
|
moment = datetime.fromtimestamp(now, timezone.utc) if now is not None else datetime.now(timezone.utc)
|
|
return moment.strftime("%Y%m%dT%H%M%SZ")
|
|
|
|
|
|
def utc_iso(now: float | None = None) -> str:
|
|
moment = datetime.fromtimestamp(now, timezone.utc) if now is not None else datetime.now(timezone.utc)
|
|
return moment.strftime("%Y-%m-%dT%H:%M:%SZ")
|
|
|
|
|
|
def default_root() -> Path:
|
|
return Path(os.getenv("SHAKEDOWN_LEDGER") or Path(__file__).resolve().parents[1] / "ledger")
|
|
|
|
|
|
class Ledger:
|
|
def __init__(self, folder: Path) -> None:
|
|
self.folder = Path(folder)
|
|
self.folder.mkdir(parents=True, exist_ok=True)
|
|
|
|
@classmethod
|
|
def new(cls, root: Path, voyage: str, now: float | None = None) -> "Ledger":
|
|
return cls(Path(root) / voyage / utc_stamp(now))
|
|
|
|
def path(self, *parts: str) -> Path:
|
|
target = self.folder.joinpath(*parts)
|
|
target.parent.mkdir(parents=True, exist_ok=True)
|
|
return target
|
|
|
|
def write(self, name: str, data: Any, stage: str | None = None) -> Path:
|
|
target = self.path(*([stage] if stage else []), name)
|
|
tmp = target.with_suffix(target.suffix + ".tmp")
|
|
if isinstance(data, (bytes, bytearray)):
|
|
tmp.write_bytes(data)
|
|
elif isinstance(data, str):
|
|
tmp.write_text(data)
|
|
else:
|
|
tmp.write_text(json.dumps(data, indent=1, default=str))
|
|
tmp.replace(target)
|
|
return target
|
|
|
|
def load_state(self) -> dict:
|
|
path = self.folder / "state.json"
|
|
return json.loads(path.read_text()) if path.is_file() else {}
|
|
|
|
def save_state(self, state: dict) -> None:
|
|
self.write("state.json", state)
|
|
|
|
|
|
def shown_inputs(inputs: dict) -> dict:
|
|
"""The inputs as recorded: uploads by name, long documents by length (their text is kept beside, in the stage)."""
|
|
out = {}
|
|
for key, value in inputs.items():
|
|
if key == "file" and isinstance(value, list):
|
|
out[key] = [item.get("name") for item in value if isinstance(item, dict)]
|
|
elif isinstance(value, str) and len(value) > 200:
|
|
out[key] = f"<{len(value)} characters>"
|
|
else:
|
|
out[key] = value
|
|
return out
|