#!/usr/bin/env python3
"""Print a non-destructive ~/.hermes to ~/.miadi/navigator migration plan.

This helper intentionally does not move, copy, or delete files. It exists to
make the state-root transition visible before a human chooses to perform it.
"""

from __future__ import annotations

from pathlib import Path


def main() -> int:
    legacy = Path.home() / ".hermes"
    target = Path.home() / ".miadi" / "navigator"

    print("Hermes Navigator state-root migration plan")
    print(f"legacy: {legacy}")
    print(f"target: {target}")
    print()

    if not legacy.exists():
        print("No legacy ~/.hermes directory was found. Nothing to migrate.")
        print("New state defaults to ~/.miadi/navigator.")
        return 0

    print("No files were moved.")
    print("When ready, review the legacy directory and copy only the state you want:")
    print(f"  mkdir -p {target}")
    print(f"  cp -a {legacy}/. {target}/")
    print()
    print("Then prefer MIADI_HOME for explicit overrides:")
    print(f"  export MIADI_HOME={target}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
