[CI] Add Skeleton for Premerge Advisor Server

This patch adds a skeleton for the premerge advisor server. Currently we just
add some endpoints with mostly dummy implementations. Having a skeleton enables
setting up the infrastructure to run the server and also adding infrastructure
in the monorepo to connect.

Reviewers: cmtice

Reviewed By: cmtice

Pull Request: #605

Author: boomanaiden154

premerge/advisor/advisor_lib.py

@@ -0,0 +1,25 @@
+from typing import TypedDict
+
+
+class TestFailure(TypedDict):
+    name: str
+    message: str
+
+
+class FailureExplanation(TypedDict):
+    name: str
+    explained: bool
+    reason: str | None
+
+
+def upload_failures(test_failures: list[TestFailure]):
+    pass
+
+
+def explain_failures(test_failures: list[TestFailure]) -> list[FailureExplanation]:
+    explanations = []
+    for test_failure in test_failures:
+        explanations.append(
+            {"name": test_failure["name"], "explained": False, "reason": None}
+        )
+    return explanations

premerge/advisor/advisor_lib_test.py

@@ -0,0 +1,16 @@
+import unittest
+
+import advisor_lib
+
+
+class AdvisorLibTest(unittest.TestCase):
+    def test_upload_failures(self):
+        failures = [{"name": "a.ll", "message": "failed"}]
+        advisor_lib.upload_failures(failures)
+
+    def test_explain_failures(self):
+        failures = [{"name": "a.ll", "message": "failed"}]
+        self.assertListEqual(
+            advisor_lib.explain_failures(failures),
+            [{"name": "a.ll", "explained": False, "reason": None}],
+        )

premerge/advisor/requirements.lock.txt

@@ -0,0 +1,23 @@
+#
+# This file is autogenerated by pip-compile with Python 3.13
+# by the following command:
+#
+#    pip-compile --output-file=requirements.lock.txt ./requirements.txt
+#
+blinker==1.9.0
+    # via flask
+click==8.3.0
+    # via flask
+flask==3.1.2
+    # via -r requirements.txt
+itsdangerous==2.2.0
+    # via flask
+jinja2==3.1.6
+    # via flask
+markupsafe==3.0.3
+    # via
+    #   flask
+    #   jinja2
+    #   werkzeug
+werkzeug==3.1.3
+    # via flask

premerge/advisor/requirements.txt

@@ -0,0 +1,2 @@
+flask==3.1.2
+

premerge/advisor/server.py

@@ -0,0 +1,21 @@
+import flask
+from flask import Flask
+
+import advisor_lib
+
+app = Flask(__name__)
+
+
+@app.route("/upload", methods=["POST"])
+def upload():
+    advisor_lib.upload_failures(flask.request.json)
+    return flask.Response(status=204)
+
+
+@app.route("/explain")
+def explain():
+    return advisor_lib.explain_failures(flask.request.json)
+
+
+if __name__ == "__main__":
+    app.run(host="0.0.0.0", port=5000)