#!/usr/bin/env python3
"""Synthetic CPython example. Does not install or invoke any agent client.

Pass a NEW output directory. All generated files are retained there. The
child's normal startup cache is redirected there as well. Only the helper
import is then allowed to use its default adjacent cache location.
"""

import argparse
import hashlib
import json
from pathlib import Path
import subprocess
import sys


def snapshot(directory):
    return {
        str(path.relative_to(directory)): hashlib.sha256(path.read_bytes()).hexdigest()
        for path in sorted(directory.rglob("*")) if path.is_file()
    }


def run_case(root, suppress_bytecode):
    case = root / ("bytecode-disabled" if suppress_bytecode else "default-import")
    package = case / "package"
    package.mkdir(parents=True)
    (package / "helper.py").write_text("answer = 42\n", encoding="utf-8")
    (package / "hook.py").write_text(
        "import sys\n"
        "sys.pycache_prefix = None  # Cache this fixture's helper beside its source.\n"
        "import helper\n"
        "assert helper.answer == 42\n"
        "print('{\"checkpoint_accepted\": false}')\n",
        encoding="utf-8",
    )
    # Do not inherit PYTHONPATH, PYTHONHOME, or a user's bytecode settings.
    environment = {"PYTHONPYCACHEPREFIX": str(case / "startup-cache")}
    if suppress_bytecode:
        environment["PYTHONDONTWRITEBYTECODE"] = "1"
    original = snapshot(package)
    steps = []
    for invocation in (1, 2):
        completed = subprocess.run(
            [sys.executable, "-S", "-s", str(package / "hook.py")],
            cwd=package, env=environment, capture_output=True, text=True,
            timeout=20, check=False,
        )
        after = snapshot(package)
        result = json.loads(completed.stdout) if completed.returncode == 0 else None
        steps.append({
            "invocation": invocation,
            "process_exit": completed.returncode,
            "stderr": completed.stderr,
            "hook_result": result,
            "package_matches_initial_manifest": after == original,
            "added_files": sorted(set(after) - set(original)),
            "removed_files": sorted(set(original) - set(after)),
            "changed_files": sorted(p for p in original.keys() & after.keys()
                                    if original[p] != after[p]),
            "manifest_after": after,
        })
    return {"suppress_bytecode": suppress_bytecode,
            "initial_manifest": original, "steps": steps}


def main():
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("output_directory", type=Path)
    args = parser.parse_args()
    proposed = args.output_directory.expanduser().absolute()
    if any(p.is_symlink() for p in (proposed, *proposed.parents)):
        raise ValueError("Use a directory path with no symlink components.")
    root = proposed.resolve()
    root.mkdir(parents=False, exist_ok=False)
    cases = [run_case(root, False), run_case(root, True)]
    report = {
        "classification": "SYNTHETIC_TEACHING_EXAMPLE_NOT_A_MUSE_TEST",
        "python": sys.version,
        "premise": "The fake hook deliberately reports checkpoint_accepted=false.",
        "cases": cases,
    }
    (root / "result.json").write_text(json.dumps(report, indent=2) + "\n", encoding="utf-8")
    for case in cases:
        for step in case["steps"]:
            if step["process_exit"] != 0 or step["hook_result"] != {"checkpoint_accepted": False}:
                raise RuntimeError("The fixture hook did not produce the specified result.")
            if step["package_matches_initial_manifest"] != case["suppress_bytecode"]:
                raise RuntimeError("The observed import did not match this example's prediction.")
            if step["removed_files"] or step["changed_files"]:
                raise RuntimeError("An original fixture file changed unexpectedly.")
    print(json.dumps(report, indent=2))


if __name__ == "__main__":
    main()
