docs: clarify Claro v1 status and validation

tools/validate_v1_17.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+EXE = ROOT / ("claro.exe" if os.name == "nt" else "claro")
+SRC = ROOT / "src" / "claro.c"
+ZIG_CC = Path.home() / "AppData" / "Local" / "hermes" / "tools" / "zig-x86_64-windows-0.14.1" / "zig.exe"
+
+
+def run(cmd):
+    print("$", " ".join(str(c) for c in cmd))
+    result = subprocess.run(cmd, cwd=ROOT, text=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT)
+    print(result.stdout, end="")
+    if result.returncode != 0:
+        raise SystemExit(result.returncode)
+    return result.stdout
+
+
+def compiler_cmd():
+    env_cc = os.environ.get("CLARO_CC")
+    if env_cc:
+        parts = env_cc.split()
+        return parts + ["-std=c99", "src/claro.c", "-O0", "-o", str(EXE), "-lm"]
+    if ZIG_CC.exists():
+        return [str(ZIG_CC), "cc", "-std=c99", "src/claro.c", "-O0", "-o", str(EXE), "-lm"]
+    return ["gcc", "-std=c99", "src/claro.c", "-O0", "-o", str(EXE), "-lm"]
+
+
+def build():
+    if not SRC.exists():
+        raise SystemExit("Missing src/claro.c")
+    run(compiler_cmd())
+
+
+def main():
+    build()
+    out = run([str(EXE), "--version"])
+    if "Claro v1.18.26" not in out:
+        raise SystemExit("Wrong version string")
+    run([str(EXE), "test"])
+    run([str(EXE), "validate"])
+    run([sys.executable, "tools/validate_ide_metadata.py"])
+    run([sys.executable, "tools/validate_lsp_helper.py"])
+    run([sys.executable, "tools/validate_concurrency.py"])
+    run([sys.executable, "tools/validate_package_security.py"])
+    run([sys.executable, "tools/validate_typecheck_diagnostics.py"])
+    run([sys.executable, "tools/validate_version_convention.py"])
+    run([str(EXE), "examples/networking.claro"])
+    print("v1.18.26 validation complete")
+
+if __name__ == "__main__":
+    main()