Translate repository documentation and reorganize version history

tools/validate_release.py

@@ -48,6 +48,25 @@ def check_version() -> None:
     ok(f"Version exports are valid ({app_version})")
 
 
+
+def check_repository_documentation() -> None:
+    required = [
+        ROOT / "README.md",
+        ROOT / "CONTRIBUTING.md",
+        ROOT / "SECURITY.md",
+        ROOT / "THIRD_PARTY_NOTICES.md",
+        ROOT / "docs" / "architecture" / "SOFTWARE-CLIENT-ARCHITECTURE.md",
+        ROOT / "docs" / "version-history" / "README.md",
+        ROOT / "docs" / "version-history" / f"UPDATE-{(ROOT / 'VERSION').read_text(encoding='utf-8').strip()}.md",
+    ]
+    missing = [str(path.relative_to(ROOT)) for path in required if not path.is_file()]
+    if missing:
+        fail("Required repository documentation is missing: " + ", ".join(missing))
+    root_notes = sorted(ROOT.glob("UPDATE-*.txt")) + sorted(ROOT.glob("UPDATE-*.md"))
+    if root_notes:
+        fail("Release notes must be stored under docs/version-history/: " + ", ".join(path.name for path in root_notes))
+    ok("Repository documentation layout is valid")
+
 def check_compile() -> None:
     if not compileall.compile_dir(str(APP_DIR), quiet=1, force=True):
         fail("Python compilation failed")
@@ -136,6 +155,7 @@ def check_fastapi_import() -> None:
 def main() -> None:
     print("AssetManager release validation")
     check_version()
+    check_repository_documentation()
     check_compile()
     check_translations()
     check_templates()