"""Generate RELEASE_MANIFEST.md for the curated public release (Phase 5).

Lists every file in the curated release tree with its size and sha256, computed from disk.
Also emits a machine-readable models/checksums.sha256-style listing for the whole release.
"""
import hashlib
import os
import sys
import datetime

HERE = os.path.dirname(os.path.abspath(__file__))
REPO = os.path.abspath(os.path.join(HERE, "..", "repo"))
OUT = os.path.join(REPO, "RELEASE_MANIFEST.md")

SKIP_NAMES = {"RELEASE_MANIFEST.md"}


def sha256_of(path, chunk=1 << 20):
    h = hashlib.sha256()
    with open(path, "rb") as fh:
        while True:
            b = fh.read(chunk)
            if not b:
                break
            h.update(b)
    return h.hexdigest()


def main():
    rows = []
    for dirpath, dirnames, filenames in os.walk(REPO):
        dirnames[:] = sorted(d for d in dirnames if d not in {"__pycache__", ".git"})
        for fn in sorted(filenames):
            if fn in SKIP_NAMES:
                continue
            full = os.path.join(dirpath, fn)
            rel = os.path.relpath(full, REPO).replace(os.sep, "/")
            rows.append((rel, os.path.getsize(full), sha256_of(full)))

    rows.sort()

    total = sum(r[1] for r in rows)
    lines = []
    lines.append("# Release Manifest")
    lines.append("")
    lines.append("**Repository:** `Anish-lab-blip/SatQuery-AI` (public)")
    lines.append(f"**Generated:** {datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()}")
    lines.append("**Generator:** `release/tools/generate_release_manifest.py` (computed from disk, never typed)")
    lines.append("")
    lines.append(f"**Files:** {len(rows)} · **Total size:** {total:,} bytes ({total/1024:.1f} KiB)")
    lines.append("")
    lines.append("Every file in this release, with its size and sha256. Verify a checkout with:")
    lines.append("")
    lines.append("```bash")
    lines.append("# for each row:  echo '<sha256>  <path>' | sha256sum -c -")
    lines.append("```")
    lines.append("")
    lines.append("| # | Path | Bytes | sha256 |")
    lines.append("|---|---|---|---|")
    for i, (rel, size, h) in enumerate(rows, 1):
        lines.append(f"| {i} | `{rel}` | {size:,} | `{h}` |")
    lines.append("")
    lines.append("## Machine-readable listing")
    lines.append("")
    lines.append("```")
    for rel, size, h in rows:
        lines.append(f"{h}  {rel}")
    lines.append("```")
    lines.append("")
    lines.append("## Contents summary")
    lines.append("")
    lines.append("| Area | What it is |")
    lines.append("|---|---|")
    lines.append("| `README.md` | the repository front page |")
    lines.append("| `MODEL_CARD.md` | model card for the six trained artifacts |")
    lines.append("| `docs/` | the research + engineering documentation set |")
    lines.append("| `docs/architecture/` | the deep architecture reference (multi-part) |")
    lines.append("| `models/manifest.json` | generated manifest of the six trained artifacts |")
    lines.append("| `models/checksums.sha256` | generated checksums for the six trained artifacts |")
    lines.append("| `screenshots/` | real live-run captures |")
    lines.append("")
    lines.append("## What this release deliberately does NOT contain")
    lines.append("")
    lines.append("- **Backbone weights.** They are fetched from the Hugging Face Hub, pinned by revision.")
    lines.append("- **Secrets.** No tokens, keys, or environment files.")
    lines.append("- **The private deployment repositories.** Their sources are not published here.")
    lines.append("- **Datasets.** Acquisition procedures are documented; the data is not redistributed.")
    lines.append("- **A licence file.** None has been selected yet — this is an OPEN item.")

    with open(OUT, "w", encoding="utf-8", newline="\n") as fh:
        fh.write("\n".join(lines) + "\n")

    print(f"wrote {OUT}")
    print(f"files: {len(rows)}  total: {total:,} bytes")
    for rel, size, h in rows:
        print(f"  {size:>10,}  {rel}")
    return 0


if __name__ == "__main__":
    sys.exit(main())