#!/usr/bin/env python3 """Prepare a local VPS handoff record. No purchase, network or deployment.""" from __future__ import annotations import argparse from datetime import datetime, timezone import json import os from pathlib import Path import sys def make_report(origin: str) -> dict: if origin not in ("codex", "site"): raise ValueError("Origin must be codex or site") return { "schema": "ultimate-odycer.vps-request/v1", "origin_declared": origin, "created_at": datetime.now(timezone.utc).isoformat(), "status": "preparation_only", "installation_verified": False, "next_step": "qualify_linux_release_before_purchase_and_deployment", } def write_new_report(path: Path, report: dict) -> None: # Exclusive creation also refuses existing symlinks. Never truncate a report. payload = (json.dumps(report, ensure_ascii=False, indent=2) + "\n").encode("utf-8") descriptor = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600) with os.fdopen(descriptor, "wb") as stream: stream.write(payload) def main(argv: list[str] | None = None) -> int: parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("--origin", required=True, choices=("codex", "site")) parser.add_argument("--output", type=Path, help="Create a new local JSON report; never overwrite") args = parser.parse_args(argv) report = make_report(args.origin) if args.output is None: print(json.dumps(report, ensure_ascii=False, indent=2)) return 0 try: write_new_report(args.output, report) except FileExistsError: print("Existing report refused; nothing overwritten.", file=sys.stderr) return 2 except OSError as error: print(f"Cannot write report: {error}", file=sys.stderr) return 2 print(f"Local preparation report written: {args.output}") print("Server installation has not been verified.") return 0 if __name__ == "__main__": raise SystemExit(main())