"""Verify rollback material, or restore it into a NEW LOCAL directory only.""" import argparse import hashlib import json from pathlib import Path, PurePosixPath import sys import zipfile MAX_TOTAL = 128 * 1024 * 1024 def verify(snapshot): plan = json.loads((snapshot / 'rollback-plan.json').read_text(encoding='utf-8')) if plan.get('archive') != 'rollback-before.zip': raise ValueError('Unexpected rollback archive') archive = snapshot / plan['archive'] if archive.is_symlink(): raise ValueError('Symlink archive refused') if archive.stat().st_size > MAX_TOTAL: raise ValueError('Archive too large') if hashlib.sha256(archive.read_bytes()).hexdigest() != plan['archive_sha256']: raise ValueError('Rollback archive checksum mismatch') records = plan['files'] expected = {row['path']: row for row in records} if len(expected) != len(records): raise ValueError('Duplicate rollback manifest paths') with zipfile.ZipFile(archive) as zipped: names = zipped.namelist() if len(set(names)) != len(names) or set(names) != set(expected): raise ValueError('Rollback members differ from manifest') if sum(info.file_size for info in zipped.infolist()) > MAX_TOTAL: raise ValueError('Archive expands beyond limit') for name in names: path = PurePosixPath(name) if path.is_absolute() or '..' in path.parts or '\\' in name or ':' in name: raise ValueError('Unsafe rollback member') if not name.startswith(('apps/system_manage/', 'apps/static/admin/', 'ui/src/', 'ui/dist/admin/')): raise ValueError('Rollback member outside application scope') if zipped.getinfo(name).file_size != expected[name]['size']: raise ValueError('Member size mismatch') raw = zipped.read(name) if hashlib.sha256(raw).hexdigest() != expected[name]['sha256']: raise ValueError('Rollback file checksum mismatch') return plan def restore(snapshot, destination): plan = verify(snapshot) if destination.exists(): raise ValueError('Destination must be a new local directory') if any(parent.is_symlink() for parent in [destination, *destination.parents]): raise ValueError('Symlink destination refused') destination.mkdir(parents=True, exist_ok=False) with zipfile.ZipFile(snapshot / plan['archive']) as zipped: for row in plan['files']: file = destination / row['path'] file.parent.mkdir(parents=True, exist_ok=True) with file.open('xb') as stream: stream.write(zipped.read(row['path'])) (destination / 'LOCAL_ONLY.txt').write_text( 'This is a local reconstruction for review. No remote files were restored or removed.\n', encoding='utf-8') return len(plan['files']) def main(): parser = argparse.ArgumentParser(description=__doc__) parser.add_argument('snapshot', type=Path) parser.add_argument('--destination', type=Path, help='Optional new LOCAL reconstruction directory') args = parser.parse_args() snapshot = args.snapshot.resolve() if args.destination: count = restore(snapshot, args.destination.absolute()) print(json.dumps({'restored_local_files': count, 'remote_mutation': False})) else: plan = verify(snapshot) print(json.dumps({'verified_files': len(plan['files']), 'remote_mutation': False})) if __name__ == '__main__': try: main() except (OSError, ValueError, KeyError, zipfile.BadZipFile) as exc: print('Local rollback verification failed: ' + type(exc).__name__, file=sys.stderr) sys.exit(1)