File size: 4,100 Bytes
7237a5c | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 | """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())
|