From c8990d024248405493b79e3b4e6304381af72ad6 Mon Sep 17 00:00:00 2001 From: RJ Johnson Date: Thu, 1 Oct 2026 08:23:10 -0400 Subject: [PATCH 1/8] chore(python): upgrading to 3.12 python (#6) --- .python-version | 2 +- README.md | 3 + deploy/container_files/api/Containerfile | 8 +- pyproject.toml | 4 +- uv.lock | 132 +++++++++-------------- 5 files changed, 61 insertions(+), 88 deletions(-) diff --git a/.python-version b/.python-version index 2c07333..e4fba21 100644 --- a/.python-version +++ b/.python-version @@ -1 +1 @@ -3.11 +3.12 diff --git a/README.md b/README.md index 1246f51..f30bc6f 100644 --- a/README.md +++ b/README.md @@ -331,6 +331,8 @@ tests/ ## Quickstart (local dev) +**Python 3.12+** is required (`requires-python` in `pyproject.toml`; `.python-version` pins `3.12`). Install [uv](https://docs.astral.sh/uv/), then: + ### 1. Install dependencies ```bash @@ -470,6 +472,7 @@ Helm chart under [`deploy/helm/`](deploy/helm/) so components can be upgraded in | `oc` CLI logged in | `oc login ...` — needs cluster-admin (or a role covering Deployments, StatefulSets, Services, Routes, Jobs, CronJobs, Secrets, ConfigMaps, ServiceAccounts, and ClusterRoleBindings) | | `helm` 3.x | [Install Helm](https://helm.sh/docs/intro/install/) | | `podman` | To build and push images | +| Python 3.12 | API image is based on UBI9 `python-312` (`deploy/container_files/api/Containerfile`) | | GPU nodes | Required only when enabling `llm-service` on GPU | | NVIDIA GPU Operator | Required for GPU `llm-service` device profile | | Red Hat OpenShift AI | Required for in-cluster `llm-service` (KServe ServingRuntime / InferenceService) | diff --git a/deploy/container_files/api/Containerfile b/deploy/container_files/api/Containerfile index b65efbf..63afa3e 100644 --- a/deploy/container_files/api/Containerfile +++ b/deploy/container_files/api/Containerfile @@ -10,7 +10,7 @@ # podman push quay.io/robertsandoval/general-sim-api:latest # # Design notes: -# - UBI9 Python 3.11 base (Red Hat supported, OCI-compliant). +# - UBI9 Python 3.12 base (Red Hat supported, OCI-compliant). # - Multi-stage: build stage compiles deps into a venv; runtime stage is minimal. # - Runs as UID 1001; group 0 has read/execute so OpenShift arbitrary-UID can run. # - No secrets baked in; all config comes from env / mounted secrets. @@ -24,7 +24,7 @@ # ── Stage 0: export pinned requirements on the native build platform ────────── # $BUILDPLATFORM resolves to the host arch (arm64 on Apple Silicon), so uv # runs without QEMU emulation and cannot segfault. -FROM --platform=$BUILDPLATFORM python:3.11-slim AS deps-gen +FROM --platform=$BUILDPLATFORM python:3.12-slim AS deps-gen WORKDIR /gen @@ -38,7 +38,7 @@ RUN uv export --no-dev --frozen --no-hashes -o requirements.txt && \ sed -i '/^-e /d' requirements.txt # ── Stage 1: dependency builder ─────────────────────────────────────────────── -FROM registry.access.redhat.com/ubi9/python-311:1 AS builder +FROM registry.access.redhat.com/ubi9/python-312:1 AS builder # UBI9 Python defaults to user 1001; switch to root for build-time writes. USER root @@ -64,7 +64,7 @@ COPY domain/ ./domain/ RUN .venv/bin/pip install --no-cache-dir --no-deps . # ── Stage 2: minimal runtime image ──────────────────────────────────────────── -FROM registry.access.redhat.com/ubi9/python-311:1 +FROM registry.access.redhat.com/ubi9/python-312:1 # UBI9 Python defaults to user 1001; need root to chown/chmod the app tree. USER root diff --git a/pyproject.toml b/pyproject.toml index 05a1e63..ed2d186 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -3,7 +3,7 @@ name = "general-simulation" version = "0.1.0" description = "Domain-agnostic simulation & impact-reasoning platform (MVP)" readme = "README.md" -requires-python = ">=3.11" +requires-python = ">=3.12" dependencies = [ "asyncpg>=0.31.0", "fastapi>=0.138.0", @@ -14,6 +14,7 @@ dependencies = [ # Uncomment to re-enable the Llama Stack SDK backend (LLM_BACKEND=llamastack): # "llama-stack-client>=0.2.12", "pydantic-settings>=2.14.2", + "pyyaml>=6.0", "python-multipart>=0.0.9", "requests>=2.34.2", "uvicorn>=0.49.0", @@ -31,6 +32,7 @@ dev = [ bootstrap-schema = "lib.graph.bootstrap:main" ingest-run = "lib.ingestion.__main__:main" seed-demo = "lib.cli.seed_demo:main" +seed-network-overlay = "lib.cli.seed_network_overlay:main" [tool.pytest.ini_options] asyncio_mode = "auto" diff --git a/uv.lock b/uv.lock index 22d211e..4189716 100644 --- a/uv.lock +++ b/uv.lock @@ -1,17 +1,6 @@ version = 1 -revision = 2 -requires-python = ">=3.11" -resolution-markers = [ - "python_full_version >= '3.14' and sys_platform == 'win32'", - "python_full_version >= '3.14' and sys_platform == 'emscripten'", - "python_full_version >= '3.14' and sys_platform != 'emscripten' and sys_platform != 'win32'", - "python_full_version >= '3.12' and python_full_version < '3.14' and sys_platform == 'win32'", - "python_full_version >= '3.12' and python_full_version < '3.14' and sys_platform == 'emscripten'", - "python_full_version >= '3.12' and python_full_version < '3.14' and sys_platform != 'emscripten' and sys_platform != 'win32'", - "python_full_version < '3.12' and sys_platform == 'win32'", - "python_full_version < '3.12' and sys_platform == 'emscripten'", - "python_full_version < '3.12' and sys_platform != 'emscripten' and sys_platform != 'win32'", -] +revision = 3 +requires-python = ">=3.12" [[package]] name = "annotated-doc" @@ -50,14 +39,6 @@ version = "0.31.0" source = { registry = "https://pypi.org/simple" } sdist = { url = "https://files.pythonhosted.org/packages/fe/cc/d18065ce2380d80b1bcce927c24a2642efd38918e33fd724bc4bca904877/asyncpg-0.31.0.tar.gz", hash = "sha256:c989386c83940bfbd787180f2b1519415e2d3d6277a70d9d0f0145ac73500735", size = 993667, upload-time = "2025-11-24T23:27:00.812Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/08/17/cc02bc49bc350623d050fa139e34ea512cd6e020562f2a7312a7bcae4bc9/asyncpg-0.31.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:eee690960e8ab85063ba93af2ce128c0f52fd655fdff9fdb1a28df01329f031d", size = 643159, upload-time = "2025-11-24T23:25:36.443Z" }, - { url = "https://files.pythonhosted.org/packages/a4/62/4ded7d400a7b651adf06f49ea8f73100cca07c6df012119594d1e3447aa6/asyncpg-0.31.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2657204552b75f8288de08ca60faf4a99a65deef3a71d1467454123205a88fab", size = 638157, upload-time = "2025-11-24T23:25:37.89Z" }, - { url = "https://files.pythonhosted.org/packages/d6/5b/4179538a9a72166a0bf60ad783b1ef16efb7960e4d7b9afe9f77a5551680/asyncpg-0.31.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a429e842a3a4b4ea240ea52d7fe3f82d5149853249306f7ff166cb9948faa46c", size = 2918051, upload-time = "2025-11-24T23:25:39.461Z" }, - { url = "https://files.pythonhosted.org/packages/e6/35/c27719ae0536c5b6e61e4701391ffe435ef59539e9360959240d6e47c8c8/asyncpg-0.31.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c0807be46c32c963ae40d329b3a686356e417f674c976c07fa49f1b30303f109", size = 2972640, upload-time = "2025-11-24T23:25:41.512Z" }, - { url = "https://files.pythonhosted.org/packages/43/f4/01ebb9207f29e645a64699b9ce0eefeff8e7a33494e1d29bb53736f7766b/asyncpg-0.31.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:e5d5098f63beeae93512ee513d4c0c53dc12e9aa2b7a1af5a81cddf93fe4e4da", size = 2851050, upload-time = "2025-11-24T23:25:43.153Z" }, - { url = "https://files.pythonhosted.org/packages/3e/f4/03ff1426acc87be0f4e8d40fa2bff5c3952bef0080062af9efc2212e3be8/asyncpg-0.31.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37fc6c00a814e18eef51833545d1891cac9aa69140598bb076b4cd29b3e010b9", size = 2962574, upload-time = "2025-11-24T23:25:44.942Z" }, - { url = "https://files.pythonhosted.org/packages/c7/39/cc788dfca3d4060f9d93e67be396ceec458dfc429e26139059e58c2c244d/asyncpg-0.31.0-cp311-cp311-win32.whl", hash = "sha256:5a4af56edf82a701aece93190cc4e094d2df7d33f6e915c222fb09efbb5afc24", size = 521076, upload-time = "2025-11-24T23:25:46.486Z" }, - { url = "https://files.pythonhosted.org/packages/28/fc/735af5384c029eb7f1ca60ccb8fa95521dbdaeef788edf4cecfc604c3cab/asyncpg-0.31.0-cp311-cp311-win_amd64.whl", hash = "sha256:480c4befbdf079c14c9ca43c8c5e1fe8b6296c96f1f927158d4f1e750aacc047", size = 584980, upload-time = "2025-11-24T23:25:47.938Z" }, { url = "https://files.pythonhosted.org/packages/2a/a6/59d0a146e61d20e18db7396583242e32e0f120693b67a8de43f1557033e2/asyncpg-0.31.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b44c31e1efc1c15188ef183f287c728e2046abb1d26af4d20858215d50d91fad", size = 662042, upload-time = "2025-11-24T23:25:49.578Z" }, { url = "https://files.pythonhosted.org/packages/36/01/ffaa189dcb63a2471720615e60185c3f6327716fdc0fc04334436fbb7c65/asyncpg-0.31.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0c89ccf741c067614c9b5fc7f1fc6f3b61ab05ae4aaa966e6fd6b93097c7d20d", size = 638504, upload-time = "2025-11-24T23:25:51.501Z" }, { url = "https://files.pythonhosted.org/packages/9f/62/3f699ba45d8bd24c5d65392190d19656d74ff0185f42e19d0bbd973bb371/asyncpg-0.31.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:12b3b2e39dc5470abd5e98c8d3373e4b1d1234d9fbdedf538798b2c13c64460a", size = 3426241, upload-time = "2025-11-24T23:25:53.278Z" }, @@ -107,22 +88,6 @@ version = "3.4.7" source = { registry = "https://pypi.org/simple" } sdist = { url = "https://files.pythonhosted.org/packages/e7/a1/67fe25fac3c7642725500a3f6cfe5821ad557c3abb11c9d20d12c7008d3e/charset_normalizer-3.4.7.tar.gz", hash = "sha256:ae89db9e5f98a11a4bf50407d4363e7b09b31e55bc117b4f7d80aab97ba009e5", size = 144271, upload-time = "2026-04-02T09:28:39.342Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/c2/d7/b5b7020a0565c2e9fa8c09f4b5fa6232feb326b8c20081ccded47ea368fd/charset_normalizer-3.4.7-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:7641bb8895e77f921102f72833904dcd9901df5d6d72a2ab8f31d04b7e51e4e7", size = 309705, upload-time = "2026-04-02T09:26:02.191Z" }, - { url = "https://files.pythonhosted.org/packages/5a/53/58c29116c340e5456724ecd2fff4196d236b98f3da97b404bc5e51ac3493/charset_normalizer-3.4.7-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:202389074300232baeb53ae2569a60901f7efadd4245cf3a3bf0617d60b439d7", size = 206419, upload-time = "2026-04-02T09:26:03.583Z" }, - { url = "https://files.pythonhosted.org/packages/b2/02/e8146dc6591a37a00e5144c63f29fb7c97a734ea8a111190783c0e60ab63/charset_normalizer-3.4.7-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:30b8d1d8c52a48c2c5690e152c169b673487a2a58de1ec7393196753063fcd5e", size = 227901, upload-time = "2026-04-02T09:26:04.738Z" }, - { url = "https://files.pythonhosted.org/packages/fb/73/77486c4cd58f1267bf17db420e930c9afa1b3be3fe8c8b8ebbebc9624359/charset_normalizer-3.4.7-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:532bc9bf33a68613fd7d65e4b1c71a6a38d7d42604ecf239c77392e9b4e8998c", size = 222742, upload-time = "2026-04-02T09:26:06.36Z" }, - { url = "https://files.pythonhosted.org/packages/a1/fa/f74eb381a7d94ded44739e9d94de18dc5edc9c17fb8c11f0a6890696c0a9/charset_normalizer-3.4.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2fe249cb4651fd12605b7288b24751d8bfd46d35f12a20b1ba33dea122e690df", size = 214061, upload-time = "2026-04-02T09:26:08.347Z" }, - { url = "https://files.pythonhosted.org/packages/dc/92/42bd3cefcf7687253fb86694b45f37b733c97f59af3724f356fa92b8c344/charset_normalizer-3.4.7-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:65bcd23054beab4d166035cabbc868a09c1a49d1efe458fe8e4361215df40265", size = 199239, upload-time = "2026-04-02T09:26:09.823Z" }, - { url = "https://files.pythonhosted.org/packages/4c/3d/069e7184e2aa3b3cddc700e3dd267413dc259854adc3380421c805c6a17d/charset_normalizer-3.4.7-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:08e721811161356f97b4059a9ba7bafb23ea5ee2255402c42881c214e173c6b4", size = 210173, upload-time = "2026-04-02T09:26:10.953Z" }, - { url = "https://files.pythonhosted.org/packages/62/51/9d56feb5f2e7074c46f93e0ebdbe61f0848ee246e2f0d89f8e20b89ebb8f/charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:e060d01aec0a910bdccb8be71faf34e7799ce36950f8294c8bf612cba65a2c9e", size = 209841, upload-time = "2026-04-02T09:26:12.142Z" }, - { url = "https://files.pythonhosted.org/packages/d2/59/893d8f99cc4c837dda1fe2f1139079703deb9f321aabcb032355de13b6c7/charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:38c0109396c4cfc574d502df99742a45c72c08eff0a36158b6f04000043dbf38", size = 200304, upload-time = "2026-04-02T09:26:13.711Z" }, - { url = "https://files.pythonhosted.org/packages/7d/1d/ee6f3be3464247578d1ed5c46de545ccc3d3ff933695395c402c21fa6b77/charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:1c2a768fdd44ee4a9339a9b0b130049139b8ce3c01d2ce09f67f5a68048d477c", size = 229455, upload-time = "2026-04-02T09:26:14.941Z" }, - { url = "https://files.pythonhosted.org/packages/54/bb/8fb0a946296ea96a488928bdce8ef99023998c48e4713af533e9bb98ef07/charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:1a87ca9d5df6fe460483d9a5bbf2b18f620cbed41b432e2bddb686228282d10b", size = 210036, upload-time = "2026-04-02T09:26:16.478Z" }, - { url = "https://files.pythonhosted.org/packages/9a/bc/015b2387f913749f82afd4fcba07846d05b6d784dd16123cb66860e0237d/charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:d635aab80466bc95771bb78d5370e74d36d1fe31467b6b29b8b57b2a3cd7d22c", size = 224739, upload-time = "2026-04-02T09:26:17.751Z" }, - { url = "https://files.pythonhosted.org/packages/17/ab/63133691f56baae417493cba6b7c641571a2130eb7bceba6773367ab9ec5/charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ae196f021b5e7c78e918242d217db021ed2a6ace2bc6ae94c0fc596221c7f58d", size = 216277, upload-time = "2026-04-02T09:26:18.981Z" }, - { url = "https://files.pythonhosted.org/packages/06/6d/3be70e827977f20db77c12a97e6a9f973631a45b8d186c084527e53e77a4/charset_normalizer-3.4.7-cp311-cp311-win32.whl", hash = "sha256:adb2597b428735679446b46c8badf467b4ca5f5056aae4d51a19f9570301b1ad", size = 147819, upload-time = "2026-04-02T09:26:20.295Z" }, - { url = "https://files.pythonhosted.org/packages/20/d9/5f67790f06b735d7c7637171bbfd89882ad67201891b7275e51116ed8207/charset_normalizer-3.4.7-cp311-cp311-win_amd64.whl", hash = "sha256:8e385e4267ab76874ae30db04c627faaaf0b509e1ccc11a95b3fc3e83f855c00", size = 159281, upload-time = "2026-04-02T09:26:21.74Z" }, - { url = "https://files.pythonhosted.org/packages/ca/83/6413f36c5a34afead88ce6f66684d943d91f233d76dd083798f9602b75ae/charset_normalizer-3.4.7-cp311-cp311-win_arm64.whl", hash = "sha256:d4a48e5b3c2a489fae013b7589308a40146ee081f6f509e047e0e096084ceca1", size = 147843, upload-time = "2026-04-02T09:26:22.901Z" }, { url = "https://files.pythonhosted.org/packages/0c/eb/4fc8d0a7110eb5fc9cc161723a34a8a6c200ce3b4fbf681bc86feee22308/charset_normalizer-3.4.7-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:eca9705049ad3c7345d574e3510665cb2cf844c2f2dcfe675332677f081cbd46", size = 311328, upload-time = "2026-04-02T09:26:24.331Z" }, { url = "https://files.pythonhosted.org/packages/f8/e3/0fadc706008ac9d7b9b5be6dc767c05f9d3e5df51744ce4cc9605de7b9f4/charset_normalizer-3.4.7-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6178f72c5508bfc5fd446a5905e698c6212932f25bcdd4b47a757a50605a90e2", size = 208061, upload-time = "2026-04-02T09:26:25.568Z" }, { url = "https://files.pythonhosted.org/packages/42/f0/3dd1045c47f4a4604df85ec18ad093912ae1344ac706993aff91d38773a2/charset_normalizer-3.4.7-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e1421b502d83040e6d7fb2fb18dff63957f720da3d77b2fbd3187ceb63755d7b", size = 229031, upload-time = "2026-04-02T09:26:26.865Z" }, @@ -261,6 +226,7 @@ dependencies = [ { name = "openai" }, { name = "pydantic-settings" }, { name = "python-multipart" }, + { name = "pyyaml" }, { name = "requests" }, { name = "uvicorn" }, ] @@ -283,6 +249,7 @@ requires-dist = [ { name = "openai", specifier = ">=1.0" }, { name = "pydantic-settings", specifier = ">=2.14.2" }, { name = "python-multipart", specifier = ">=0.0.9" }, + { name = "pyyaml", specifier = ">=6.0" }, { name = "requests", specifier = ">=2.34.2" }, { name = "uvicorn", specifier = ">=0.49.0" }, ] @@ -371,20 +338,6 @@ version = "0.16.0" source = { registry = "https://pypi.org/simple" } sdist = { url = "https://files.pythonhosted.org/packages/1d/1f/10936e16d8860c70698a1aa939a46aa0224813b782bce4e000e637da0b2d/jiter-0.16.0.tar.gz", hash = "sha256:7b24c3492c5f4f84a37946ad9cf504910cf6a782d6a4e0689b6673c5894b4a1c", size = 176431, upload-time = "2026-06-29T13:05:13.657Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/4e/3f/fae6cc967d120ec89e31c5418a51176d8278b3087fbb384a9176754f353c/jiter-0.16.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:67fddeda1688f0cce2d2ae83ccf8a80f79936f2d2997d6cc2261f82fdb54a4d3", size = 309289, upload-time = "2026-06-29T13:02:52.301Z" }, - { url = "https://files.pythonhosted.org/packages/c8/e3/97c6c3562c077f6247d6e6ce5c82562500b6316c0d928e97e106b7a1321a/jiter-0.16.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c90c0f63df322be920eda6ce622e3083d8906ba267f8220fe7873213b8b4430e", size = 315181, upload-time = "2026-06-29T13:02:53.964Z" }, - { url = "https://files.pythonhosted.org/packages/7b/89/d8d073f8aa2667e46c6c0873f86fe4a512bba4293cc730f626a076211a62/jiter-0.16.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:64c0203212098470032aabcde9356fc168f377aade3e43def61dfe17e92f2037", size = 340939, upload-time = "2026-06-29T13:02:55.412Z" }, - { url = "https://files.pythonhosted.org/packages/87/c9/db4fda3ed73fb864139305e935e5b8b38a5a24692a5a9dd356c22f1b9c8d/jiter-0.16.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:12288303c9844e61e1651d02a9a6f6633e47d39f897d6991d1427161ce6b746e", size = 364932, upload-time = "2026-06-29T13:02:57.28Z" }, - { url = "https://files.pythonhosted.org/packages/a2/74/52b5e86241057f52ddd7c9a580f90effb51f9d06239f6fc612279b91a838/jiter-0.16.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cf109d010b4b05a105afb3d43be36a21322d345ad3111e13d15f680afef0e5b", size = 461132, upload-time = "2026-06-29T13:02:58.994Z" }, - { url = "https://files.pythonhosted.org/packages/a9/87/544a700f7447c1f31c5d7833821a4daa5683165c2d5a094fbf5b5800c3dc/jiter-0.16.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:62c1b7fe1f77925acf5af68b6140b8810fa87dfd4dc0a9c8568ec2fa2a10429c", size = 374857, upload-time = "2026-06-29T13:03:00.455Z" }, - { url = "https://files.pythonhosted.org/packages/40/cd/0fcc3f7d39183674d5bfa9ec640faaeb506c60be7c8f94625dfba366e37c/jiter-0.16.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8597d23c87f59294f83bcb6229b9ed1fccee13dbba967b46930d2f1759466fee", size = 347053, upload-time = "2026-06-29T13:03:02.045Z" }, - { url = "https://files.pythonhosted.org/packages/5c/ae/c7e64e7932ad597fa395b61440b249ada6366716e25c6e08dd2afbd021e6/jiter-0.16.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:3126a5dbad56401989ac769aca0cb56005bfb3e2366eea0ca99d1a91c3c1ee03", size = 356153, upload-time = "2026-06-29T13:03:03.706Z" }, - { url = "https://files.pythonhosted.org/packages/d4/1c/1c719044f14da814e1a060191ab19b96f3e99207bc5b4bfc6d6be34b3f80/jiter-0.16.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c4b4717bdb35ae456f831a6b08d01880fff399887a6bbc526a583a406e484eea", size = 393956, upload-time = "2026-06-29T13:03:05.165Z" }, - { url = "https://files.pythonhosted.org/packages/3b/dc/7b2f303a2847207e265503853a2d964a55354cffd62a5f2936c155486798/jiter-0.16.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:adff21bc78edfe086c15eb495b900306076de378dc2337c132401fc39bd79c91", size = 521081, upload-time = "2026-06-29T13:03:06.886Z" }, - { url = "https://files.pythonhosted.org/packages/c2/5f/501cf6e1e09caeb420195179ffc6f62aca603f1220ec53fd80d0d70b3e56/jiter-0.16.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:dab907db06fc593645e73109acf4581ba5b548897d28b9348dc41ddc8343b2d3", size = 552085, upload-time = "2026-06-29T13:03:08.339Z" }, - { url = "https://files.pythonhosted.org/packages/79/54/aa5be86520113b79455c3877f3d1f07a348098df4083ba3688e9537e52dd/jiter-0.16.0-cp311-cp311-win32.whl", hash = "sha256:560b2cf3fb03240cd34f27409a238547488708f05b7c3924f571a60422251ec7", size = 206755, upload-time = "2026-06-29T13:03:09.653Z" }, - { url = "https://files.pythonhosted.org/packages/64/ec/2feb893eb330bd69b413866f4d5daada33c3962f1c6f270c91ca2d87fdf9/jiter-0.16.0-cp311-cp311-win_amd64.whl", hash = "sha256:e431cfc9caf44c1d5459ff77d4e64cbf85fddb6a35dad836a15c6a9ec23087c1", size = 199155, upload-time = "2026-06-29T13:03:10.979Z" }, - { url = "https://files.pythonhosted.org/packages/b9/9c/ca040d94415048a3666fc237774df8151c96f8d2b661cbe3b184acc95876/jiter-0.16.0-cp311-cp311-win_arm64.whl", hash = "sha256:2a8e9e39cf083016137aa5cadafe3188adc2ba6ba1fbf1e5d18889ad3e9ad056", size = 194403, upload-time = "2026-06-29T13:03:12.341Z" }, { url = "https://files.pythonhosted.org/packages/83/2b/52ace16ed031354f0539749a49e4bf33797d82bea5137910835fa4b09793/jiter-0.16.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:67c3bc1760f8c99d805dcab4e644027142a53b1d5d861f18780ebdbd5d40b72a", size = 306943, upload-time = "2026-06-29T13:03:14.035Z" }, { url = "https://files.pythonhosted.org/packages/94/2e/34957c2c1b661c252ba9bcc60ae0bddc27e0f7202c6073326a13c5390eec/jiter-0.16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5af7780e4a26bd7d0d989592bf9ef12ebf806b74ab709223ecca37c749872ea9", size = 307779, upload-time = "2026-06-29T13:03:15.418Z" }, { url = "https://files.pythonhosted.org/packages/88/6c/59bd309cab4460c54cf1079f3eb7fe7af6a4c895c5c957a53378693bad2b/jiter-0.16.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d5bf78d0e05e45cfdd66558893938d59afe3d1b1a824a202039b20e607d25a72", size = 335826, upload-time = "2026-06-29T13:03:17.11Z" }, @@ -441,10 +394,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/2e/c5/6a0207d90e5f656d95af98ebd0934f382d37674416f215aeda2ff8063e51/jiter-0.16.0-cp314-cp314t-win32.whl", hash = "sha256:de5ba8763e56b793561f43bed197c9ea55776daa5e9a6b91eed68a909bc9cdbf", size = 206523, upload-time = "2026-06-29T13:04:35.068Z" }, { url = "https://files.pythonhosted.org/packages/a5/31/c757d5f30a8980fd945ce7b98be10be9e4ff59c7c42f5fd86804c2e87db8/jiter-0.16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b8a3f9a6008048fe9def7bf465180564a6e458047d2ce499149cfbe73c3ae9db", size = 200366, upload-time = "2026-06-29T13:04:36.61Z" }, { url = "https://files.pythonhosted.org/packages/7c/a2/d88de6d313d734a544a7901353ad5db67cb38dcfcd91713b7979dafc345d/jiter-0.16.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0fa25b09b13075c46f5bc174f2690525a925a4fc2f7c82969a2bbabff22386ce", size = 190516, upload-time = "2026-06-29T13:04:38.004Z" }, - { url = "https://files.pythonhosted.org/packages/06/d3/8e278946d43eeca2585b4dd0834a887cd71136329b837f3a16ed86a8b4b0/jiter-0.16.0-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:850ccb1d7eedb4200f4014b1c0e8a577de114fc3cd88faad646dcc9bc4bb12ad", size = 304518, upload-time = "2026-06-29T13:05:00.172Z" }, - { url = "https://files.pythonhosted.org/packages/72/43/28d4ef495028bf0506a413d4db3f4eb3e7288a382e0f065f306a17bbeb5e/jiter-0.16.0-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:e34e97bda77eb63242a410243c071e28ac7e0d8c0948c5ee658498690a4b2f2f", size = 310207, upload-time = "2026-06-29T13:05:02.123Z" }, - { url = "https://files.pythonhosted.org/packages/e0/ca/c366b1012da1d640de975d9683acd44e4d150d9068845d0ca2610435253f/jiter-0.16.0-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b7dc85ea77d4abbae8bad0d3538678aedee75bceec4e2f6c8dfb1c74772e5aa5", size = 342771, upload-time = "2026-06-29T13:05:03.55Z" }, - { url = "https://files.pythonhosted.org/packages/16/52/50cc4056fc1ae02e7154704e7ecc89df0afb8300222cfe8a52d3f67e4730/jiter-0.16.0-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:17ca7fae79f6d99cd9a042b75f917eaada7b895cfc7dd2ee3a16089dcaec7a85", size = 346468, upload-time = "2026-06-29T13:05:05.452Z" }, { url = "https://files.pythonhosted.org/packages/98/ab/664fd8c4be028b2bedd3d2ff08769c4ede23d0dbc87a77c62384a0515b5d/jiter-0.16.0-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:f17d61a28b4b3e0e3e2ba98490c70501403b4d196f78732439160e7fd3678127", size = 303106, upload-time = "2026-06-29T13:05:07.118Z" }, { url = "https://files.pythonhosted.org/packages/1a/07/421f1d5b65493a76e16027b848aba6a7d28073ae75944fa4289cc914d39f/jiter-0.16.0-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:96e38eea538c8ddf853a35727c7be0741c76c13f04148ac5c116222f50ece3b3", size = 304658, upload-time = "2026-06-29T13:05:08.708Z" }, { url = "https://files.pythonhosted.org/packages/0a/db/bba1155f01a01c3c37a89425d571da751bbedf5c54247b831a04cb971798/jiter-0.16.0-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d284fb8d94d5855d60c44fefcab4bf966f1da6fada73992b01f6f0c9bc0c6702", size = 339719, upload-time = "2026-06-29T13:05:10.41Z" }, @@ -533,21 +482,6 @@ dependencies = [ ] sdist = { url = "https://files.pythonhosted.org/packages/9d/56/921726b776ace8d8f5db44c4ef961006580d91dc52b803c489fafd1aa249/pydantic_core-2.46.4.tar.gz", hash = "sha256:62f875393d7f270851f20523dd2e29f082bcc82292d66db2b64ea71f64b6e1c1", size = 471464, upload-time = "2026-05-06T13:37:06.98Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/5c/fa/6d7708d2cfc1a832acb6aeb0cd16e801902df8a0f583bb3b4b527fde022e/pydantic_core-2.46.4-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:0e96592440881c74a213e5ad528e2b24d3d4f940de2766bed9010ab1d9e51594", size = 2111872, upload-time = "2026-05-06T13:40:27.596Z" }, - { url = "https://files.pythonhosted.org/packages/ae/6f/aa064a3e74b5745afbdf250594f38e7ead05e2d651bcb35994b9417a0d4d/pydantic_core-2.46.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e0d65b8c354be7fb5f720c3caa8bc940bc2d20ce749c8e06135f07f8ed95dd7c", size = 1948255, upload-time = "2026-05-06T13:39:12.574Z" }, - { url = "https://files.pythonhosted.org/packages/43/3a/41114a9f7569b84b4d84e7a018c57c56347dac30c0d4a872946ec4e36c46/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7bfb192b3f4b9e8a89b6277b6ce787564f62cfd272055f6e685726b111dc7826", size = 1972827, upload-time = "2026-05-06T13:38:19.841Z" }, - { url = "https://files.pythonhosted.org/packages/ef/25/1ab42e8048fe551934d9884e8d64daa7e990ad386f310a15981aeb6a5b08/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9037063db01f09b09e237c282b6792bd4da634b5402c4e7f0c61effed7701a04", size = 2041051, upload-time = "2026-05-06T13:38:10.447Z" }, - { url = "https://files.pythonhosted.org/packages/94/c2/1a934597ddf08da410385b3b7aae91956a5a76c635effef456074fad7e88/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fc010ab034c8c7452522748bf937df58020d256ccae0874463d1f4d01758af8e", size = 2221314, upload-time = "2026-05-06T13:40:13.089Z" }, - { url = "https://files.pythonhosted.org/packages/02/6d/9e8ad178c9c4df27ad3c8f25d1fe2a7ab0d2ba0559fad4aee5d3d1f16771/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c5dac79fa1614d1e06ca695109c6105923bd9c7d1d6c918d4e637b7e6b32fd3", size = 2285146, upload-time = "2026-05-06T13:38:59.224Z" }, - { url = "https://files.pythonhosted.org/packages/80/50/540cd3aeefc041beb111125c4bff779831a2111fc6b15a9138cda277d32c/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f9fa868638bf362d3d138ea55829cefb3d5f4b0d7f142234382a15e2485dbec4", size = 2089685, upload-time = "2026-05-06T13:38:17.762Z" }, - { url = "https://files.pythonhosted.org/packages/6b/a4/b440ad35f05f6a38f89fa0f149accb3f0e02be94ca5e15f3c449a61b4bc9/pydantic_core-2.46.4-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:17299feefe090f2caa5b8e37222bb5f663e4935a8bfa6931d4102e5df1a9f398", size = 2115420, upload-time = "2026-05-06T13:37:58.195Z" }, - { url = "https://files.pythonhosted.org/packages/99/61/de4f55db8dfd57bfdfa9a12ec90fe1b57c4f41062f7ca86f08586b3e0ac0/pydantic_core-2.46.4-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4c63ebc82684aa89d9a3bcbd13d515b3be44250dc68dd3bd81526c1cb31286c3", size = 2165122, upload-time = "2026-05-06T13:37:01.167Z" }, - { url = "https://files.pythonhosted.org/packages/f7/52/7c529d7bdb2d1068bd52f51fe32572c8301f9a4febf1948f10639f1436f5/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:aaa2a54443eff1950ba5ddc6b6ccda0d9c84a364276a62f969bdf2a390650848", size = 2182573, upload-time = "2026-05-06T13:38:45.04Z" }, - { url = "https://files.pythonhosted.org/packages/37/b3/7c40325848ba78247f2812dcf9c7274e38cd801820ca6dd9fe63bcfb0eb4/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:18e5ceec2ab67e6d5f1a9085e5a24c9c4e2ac4545730bfe668680bca05e555f3", size = 2317139, upload-time = "2026-05-06T13:37:15.539Z" }, - { url = "https://files.pythonhosted.org/packages/d9/37/f913f81a657c865b75da6c0dbed79876073c2a43b5bd9edbe8da785e4d49/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:a0f62d0a58f4e7da165457e995725421e0064f2255d8eccebc49f41bbc23b109", size = 2360433, upload-time = "2026-05-06T13:37:30.099Z" }, - { url = "https://files.pythonhosted.org/packages/c4/67/6acaa1be2567f9256b056d8477158cac7240813956ce86e49deae8e173b4/pydantic_core-2.46.4-cp311-cp311-win32.whl", hash = "sha256:041bde0a48fd37cf71cab1c9d56d3e8625a3793fef1f7dd232b3ff37e978ecda", size = 1985513, upload-time = "2026-05-06T13:38:15.669Z" }, - { url = "https://files.pythonhosted.org/packages/aa/e6/c505f83dfeda9a2e5c995cfd872949e4d05e12f7feb3dca72f633daefa94/pydantic_core-2.46.4-cp311-cp311-win_amd64.whl", hash = "sha256:6f2eeda33a839975441c86a4119e1383c50b47faf0cbb5176985565c6bb02c33", size = 2071114, upload-time = "2026-05-06T13:40:35.416Z" }, - { url = "https://files.pythonhosted.org/packages/0f/da/7a263a96d965d9d0df5e8de8a475f33495451117035b09acb110288c381f/pydantic_core-2.46.4-cp311-cp311-win_arm64.whl", hash = "sha256:14f4c5d6db102bd796a627bbb3a17b4cf4574b9ae861d8b7c9a9661c6dd3362d", size = 2044298, upload-time = "2026-05-06T13:38:29.754Z" }, { url = "https://files.pythonhosted.org/packages/ce/8c/af022f0af448d7747c5154288d46b5f2bc5f17366eaa0e23e9aa04d59f3b/pydantic_core-2.46.4-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3245406455a5d98187ec35530fd772b1d799b26667980872c8d4614991e2c4a2", size = 2106158, upload-time = "2026-05-06T13:38:57.215Z" }, { url = "https://files.pythonhosted.org/packages/19/95/6195171e385007300f0f5574592e467c568becce2d937a0b6804f218bc49/pydantic_core-2.46.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:962ccbab7b642487b1d8b7df90ef677e03134cf1fd8880bf698649b22a69371f", size = 1951724, upload-time = "2026-05-06T13:37:02.697Z" }, { url = "https://files.pythonhosted.org/packages/8e/bc/f47d1ff9cbb1620e1b5b697eef06010035735f07820180e74178226b27b3/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8233f2947cf85404441fd7e0085f53b10c93e0ee78611099b5c7237e36aacbf7", size = 1975742, upload-time = "2026-05-06T13:37:09.448Z" }, @@ -608,22 +542,10 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/30/a6/9f9f380dbb301f67023bf8f707aaa75daadf84f7152d95c410fd7e81d994/pydantic_core-2.46.4-cp314-cp314t-win32.whl", hash = "sha256:e846ae7835bf0703ae43f534ab79a867146dadd59dc9ca5c8b53d5c8f7c9ef02", size = 1955575, upload-time = "2026-05-06T13:38:51.116Z" }, { url = "https://files.pythonhosted.org/packages/40/1f/f1eb9eb350e795d1af8586289746f5c5677d16043040d63710e22abc43c9/pydantic_core-2.46.4-cp314-cp314t-win_amd64.whl", hash = "sha256:2108ba5c1c1eca18030634489dc544844144ee36357f2f9f780b93e7ddbb44b5", size = 2051624, upload-time = "2026-05-06T13:38:21.672Z" }, { url = "https://files.pythonhosted.org/packages/f6/d2/42dd53d0a85c27606f316d3aa5d2869c4e8470a5ed6dec30e4a1abe19192/pydantic_core-2.46.4-cp314-cp314t-win_arm64.whl", hash = "sha256:4fcbe087dbc2068af7eda3aa87634eba216dbda64d1ae73c8684b621d33f6596", size = 2017325, upload-time = "2026-05-06T13:40:52.723Z" }, - { url = "https://files.pythonhosted.org/packages/ee/a4/73995fd4ebbb46ba0ee51e6fa049b8f02c40daebb762208feda8a6b7894d/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:14d4edf427bdcf950a8a02d7cb44a08614388dd6e1bdcbf4f67504fa7887da9c", size = 2111589, upload-time = "2026-05-06T13:37:10.817Z" }, - { url = "https://files.pythonhosted.org/packages/fb/7f/f37d3a5e8bfcc2e403f5c57a730f2d815693fb42119e8ea48b3789335af1/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:0ce40cd7b21210e99342afafbd4d0f76d784eb5b1d60f3bdc566be4983c6c73b", size = 1944552, upload-time = "2026-05-06T13:36:56.717Z" }, - { url = "https://files.pythonhosted.org/packages/15/3c/d7eb777b3ff43e8433a4efb39a17aa8fd98a4ee8561a24a67ef5db07b2d6/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:90884113d8b48f760e9587002789ddd741e76ab9f89518cd1e43b1f1a52ec44b", size = 1982984, upload-time = "2026-05-06T13:39:06.207Z" }, - { url = "https://files.pythonhosted.org/packages/63/87/70b9f40170a81afd55ca26c9b2acb25c20d64bcfbf888fafecb3ba077d4c/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66ce7632c22d837c95301830e111ad0128a32b8207533b60896a96c4915192ea", size = 2138417, upload-time = "2026-05-06T13:39:45.476Z" }, { url = "https://files.pythonhosted.org/packages/9d/1d/8987ad40f65ae1432753072f214fb5c74fe47ffbd0698bb9cbbb585664f8/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:1d8ba486450b14f3b1d63bc521d410ec7565e52f887b9fb671791886436a42f7", size = 2095527, upload-time = "2026-05-06T13:39:52.283Z" }, { url = "https://files.pythonhosted.org/packages/64/d3/84c282a7eee1d3ac4c0377546ef5a1ea436ce26840d9ac3b7ed54a377507/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:3009f12e4e90b7f88b4f9adb1b0c4a3d58fe7820f3238c190047209d148026df", size = 1936024, upload-time = "2026-05-06T13:40:15.671Z" }, { url = "https://files.pythonhosted.org/packages/d7/ca/eac61596cdeb4d7e174d3dc0bd8a6238f14f75f97a24e7b7db4c7e7340a0/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ad785e92e6dc634c21555edc8bd6b64957ab844541bcb96a1366c202951ae526", size = 1990696, upload-time = "2026-05-06T13:38:34.717Z" }, { url = "https://files.pythonhosted.org/packages/fa/c3/7c8b240552251faf6b3a957db200fcfbbcec36763c050428b601e0c9b83b/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:00c603d540afdd6b80eb39f078f33ebd46211f02f33e34a32d9f053bba711de0", size = 2147590, upload-time = "2026-05-06T13:39:29.883Z" }, - { url = "https://files.pythonhosted.org/packages/11/cb/428de0385b6c8d44b716feba566abfacfbd23ee3c4439faa789a1456242f/pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:0c563b08bca408dc7f65f700633d8442fffb2421fc47b8101377e9fd65051ff0", size = 2112782, upload-time = "2026-05-06T13:37:04.016Z" }, - { url = "https://files.pythonhosted.org/packages/0b/b5/6a17bdadd0fc1f170adfd05a20d37c832f52b117b4d9131da1f41bb097ce/pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:db06ffe51636ffe9ca531fe9023dd64bdd794be8754cb5df57c5498ae5b518a7", size = 1952146, upload-time = "2026-05-06T13:39:43.092Z" }, - { url = "https://files.pythonhosted.org/packages/2a/dc/03734d80e362cd43ef65428e9de77c730ce7f2f11c60d2b1e1b39f0fbf99/pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:133878133d271ade3d41d1bfb2a45ec38dbdbda40bc065921c6b04e4630127e2", size = 2134492, upload-time = "2026-05-06T13:36:58.124Z" }, - { url = "https://files.pythonhosted.org/packages/de/df/5e5ffc085ed07cc22d298134d3d911c63e91f6a0eb91fe646750a3209910/pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:9bc519fbf2b7578398853d815009ae5e4d4603d12f4e3f91da8c06852d3da3e9", size = 2156604, upload-time = "2026-05-06T13:37:49.88Z" }, - { url = "https://files.pythonhosted.org/packages/81/44/6e112a4253e56f5705467cbab7ab5e91ee7398ba3d56d358635958893d3e/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:c7a7bd4e39e8e4c12c39cd480356842b6a8a06e41b23a55a5e3e191718838ddf", size = 2183828, upload-time = "2026-05-06T13:37:43.053Z" }, - { url = "https://files.pythonhosted.org/packages/ac/ad/5565071e937d8e752842ac241463944c9eb14c87e2d269f2658a5bd05e98/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:d396ec2b979760aaf3218e76c24e65bd0aca24983298653b3a9d7a45f9e47b30", size = 2310000, upload-time = "2026-05-06T13:37:56.694Z" }, - { url = "https://files.pythonhosted.org/packages/4f/c3/66883a5cec183e7fba4d024b4cbbe61851a63750ef606b0afecc46d1f2bf/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:86e1a4418c6cd97d60c95c71164158eaf7324fae7b0923264016baa993eba6fc", size = 2361286, upload-time = "2026-05-06T13:40:05.667Z" }, - { url = "https://files.pythonhosted.org/packages/4b/2d/69abac8f838090bbecd5df894befb2c2619e7996a98ddb949db9f3b93225/pydantic_core-2.46.4-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:d51026d73fcfd93610abc7b27789c26b313920fcfb20e27462d74a7f8b06e983", size = 2193071, upload-time = "2026-05-06T13:38:08.682Z" }, ] [[package]] @@ -705,6 +627,52 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/ec/dd/96da98f892250475bdf2328112d7468abdd4acc7b902b6af23f4ed958ea0/pytz-2026.2-py2.py3-none-any.whl", hash = "sha256:04156e608bee23d3792fd45c94ae47fae1036688e75032eea2e3bf0323d1f126", size = 510141, upload-time = "2026-05-04T01:35:27.408Z" }, ] +[[package]] +name = "pyyaml" +version = "6.0.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" }, + { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" }, + { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" }, + { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" }, + { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" }, + { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" }, + { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" }, + { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" }, + { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" }, + { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" }, + { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" }, + { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" }, + { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" }, + { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" }, + { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" }, + { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" }, + { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" }, + { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" }, + { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" }, + { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" }, + { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" }, + { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" }, + { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" }, + { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" }, + { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" }, + { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" }, + { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" }, + { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" }, + { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" }, + { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" }, + { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" }, + { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" }, + { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" }, + { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" }, + { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" }, + { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" }, + { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" }, + { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" }, +] + [[package]] name = "requests" version = "2.34.2" From b5edd5acb94b49dc5cb3ee08b87889f1f51513e8 Mon Sep 17 00:00:00 2001 From: Robert Sandoval Date: Tue, 15 Sep 2026 14:56:45 -0500 Subject: [PATCH 2/8] Enable OpenShift developer deploy without cluster-admin SCC bindings. Run Postgres under restricted SCC with arbitrary UID, use namespace-scoped Neo4j RoleBinding instead of ClusterRoleBinding, and require oc new-project before make deploy instead of Helm --create-namespace. Co-authored-by: Cursor --- Makefile | 32 +++++++++++++------ README.md | 9 ++++-- deploy/helm/README.md | 5 ++- deploy/helm/templates/neo4j/scc-binding.yaml | 9 +++--- .../helm/templates/postgres/scc-binding.yaml | 16 ---------- .../templates/postgres/serviceaccount.yaml | 9 ------ .../helm/templates/postgres/statefulset.yaml | 6 ++-- docs/VALUES_MAPPING.md | 4 +-- 8 files changed, 43 insertions(+), 47 deletions(-) delete mode 100644 deploy/helm/templates/postgres/scc-binding.yaml delete mode 100644 deploy/helm/templates/postgres/serviceaccount.yaml diff --git a/Makefile b/Makefile index f347520..52ce48b 100644 --- a/Makefile +++ b/Makefile @@ -3,6 +3,7 @@ # ============================================================================= # # Primary deploy (umbrella = one Helm release): +# oc new-project general-simulation # once; Helm does not create the namespace # cp deploy/helm/values-secrets.yaml.example deploy/helm/values-secrets.yaml # first time # make build # make deploy @@ -38,7 +39,7 @@ CHART_VALUES_SECRETS := deploy/helm/values-secrets.yaml # Common flags passed to every helm command HELM_RELEASE_NAME ?= general-simulation -HELM_COMMON := --namespace $(NAMESPACE) --create-namespace +HELM_COMMON := --namespace $(NAMESPACE) # Optional helm --set overrides when image vars are passed on the make command line. _helm_image_set := @@ -160,15 +161,27 @@ _remove-orphan-neo4j-resources: _guard-oc fi; \ fi; \ done; \ - crb="$(NAMESPACE)-neo4j-anyuid"; \ - if oc get clusterrolebinding $$crb >/dev/null 2>&1; then \ - owner=$$(oc get clusterrolebinding $$crb \ - -o jsonpath='{.metadata.annotations.meta\.helm\.sh/release-name}' 2>/dev/null); \ + for rb in "rolebinding neo4j-anyuid $(NAMESPACE)" \ + "clusterrolebinding $(NAMESPACE)-neo4j-anyuid"; do \ + set -- $$rb; kind=$$1; name=$$2; ns=$$3; \ + if [ "$$kind" = rolebinding ]; then \ + oc get $$kind $$name -n $$ns >/dev/null 2>&1 || continue; \ + owner=$$(oc get $$kind $$name -n $$ns \ + -o jsonpath='{.metadata.annotations.meta\.helm\.sh/release-name}' 2>/dev/null); \ + else \ + oc get $$kind $$name >/dev/null 2>&1 || continue; \ + owner=$$(oc get $$kind $$name \ + -o jsonpath='{.metadata.annotations.meta\.helm\.sh/release-name}' 2>/dev/null); \ + fi; \ if [ "$$owner" != "$$rel" ]; then \ - echo " Removing orphan clusterrolebinding/$$crb..."; \ - oc delete clusterrolebinding $$crb --ignore-not-found; \ + echo " Removing orphan $$kind/$$name (not owned by Helm release $$rel)..."; \ + if [ "$$kind" = rolebinding ]; then \ + oc delete $$kind $$name -n $$ns --ignore-not-found; \ + else \ + oc delete $$kind $$name --ignore-not-found; \ + fi; \ fi; \ - fi + done # OpenShift Routes — chart uses general-sim-admin; older/manual installs used admin-console. _remove-openshift-routes: _guard-oc @@ -252,9 +265,10 @@ undeploy: _guard-helm _guard-oc _remove-openshift-routes helm uninstall neo4j --namespace $(NAMESPACE) 2>/dev/null || true helm uninstall postgres --namespace $(NAMESPACE) 2>/dev/null || true @echo "==> Removing Neo4j anyuid SCC binding + ServiceAccount..." + @oc delete rolebinding neo4j-anyuid -n $(NAMESPACE) --ignore-not-found >/dev/null @oc delete clusterrolebinding $(NAMESPACE)-neo4j-anyuid --ignore-not-found >/dev/null @oc delete clusterrolebinding $(NAMESPACE)-postgres-anyuid --ignore-not-found >/dev/null - @oc delete serviceaccount neo4j-sa postgres-sa -n $(NAMESPACE) --ignore-not-found >/dev/null + @oc delete serviceaccount neo4j-sa -n $(NAMESPACE) --ignore-not-found >/dev/null @oc delete secret neo4j-auth pgvector -n $(NAMESPACE) --ignore-not-found >/dev/null @echo " Done. PVCs are NOT deleted automatically — remove manually if needed:" @echo " oc delete pvc -n $(NAMESPACE) --all" diff --git a/README.md b/README.md index f30bc6f..6dc9800 100644 --- a/README.md +++ b/README.md @@ -468,8 +468,9 @@ Helm chart under [`deploy/helm/`](deploy/helm/) so components can be upgraded in | Requirement | Notes | |---|---| +| OpenShift project | Create once before deploy: `oc new-project general-simulation` (or `oc project general-simulation` if it already exists). Helm does **not** create the namespace. | | OpenShift 4.13+ | Tested against OCP 4.14/4.15 | -| `oc` CLI logged in | `oc login ...` — needs cluster-admin (or a role covering Deployments, StatefulSets, Services, Routes, Jobs, CronJobs, Secrets, ConfigMaps, ServiceAccounts, and ClusterRoleBindings) | +| `oc` CLI logged in | `oc login ...` — needs project `edit` or `admin` (Deployments, StatefulSets, Services, Routes, Jobs, CronJobs, Secrets, ConfigMaps, ServiceAccounts, RoleBindings) | | `helm` 3.x | [Install Helm](https://helm.sh/docs/intro/install/) | | `podman` | To build and push images | | Python 3.12 | API image is based on UBI9 `python-312` (`deploy/container_files/api/Containerfile`) | @@ -484,6 +485,9 @@ Core platform components (Postgres, Neo4j, API, ingestion) need no extra operato ### Quick start — full deploy ```bash +# 0. Create/switch to the OpenShift project (once; required before make deploy) +oc new-project general-simulation || oc project general-simulation + # 1. Log in to quay.io so podman can push images podman login quay.io @@ -545,7 +549,8 @@ make build REGISTRY=quay.io/myorg TAG=v1.2.3 ### Step 2 — Deploy (recommended) Use the single umbrella release — Postgres, Neo4j, bootstrap, Llama Stack, API, -and ingestion are all in [`deploy/helm/`](deploy/helm/): +and ingestion are all in [`deploy/helm/`](deploy/helm/). Ensure the OpenShift +project exists first (`oc new-project general-simulation`). ```bash make deploy diff --git a/deploy/helm/README.md b/deploy/helm/README.md index a9917c3..bb8100e 100644 --- a/deploy/helm/README.md +++ b/deploy/helm/README.md @@ -18,7 +18,7 @@ templates/ bootstrap/ # Schema bootstrap Job ingestion/ # CronJob + optional hook Job neo4j/ # Secret neo4j-auth, ServiceAccount, SCC binding - postgres/ # StatefulSet, Services, init ConfigMap, SCC binding + postgres/ # StatefulSet, Services, init ConfigMap llamastack-*.yaml # Llama Stack run-config + pgvector Secret bridge _helpers.tpl # Shared DSN, image, and wait-for helpers ``` @@ -26,6 +26,9 @@ templates/ ## Quick start ```bash +# Create/switch to the OpenShift project once (Helm does not create the namespace) +oc new-project general-simulation || oc project general-simulation + cp deploy/helm/values-secrets.yaml.example deploy/helm/values-secrets.yaml # edit deploy/helm/values-secrets.yaml — then: make deploy diff --git a/deploy/helm/templates/neo4j/scc-binding.yaml b/deploy/helm/templates/neo4j/scc-binding.yaml index 6d87374..4050b0a 100644 --- a/deploy/helm/templates/neo4j/scc-binding.yaml +++ b/deploy/helm/templates/neo4j/scc-binding.yaml @@ -1,10 +1,11 @@ {{- if and .Values.neo4j.enabled (.Values.openshift.neo4j.scc.enabled | default false) }} -# ClusterRoleBinding — grants neo4j-sa the anyuid SCC on OpenShift. -# Requires permission to create ClusterRoleBindings (namespace admin on most clusters). +# RoleBinding — grants neo4j-sa the anyuid SCC in this namespace on OpenShift. +# Namespace-scoped so project edit/admin can manage it without cluster-admin. apiVersion: rbac.authorization.k8s.io/v1 -kind: ClusterRoleBinding +kind: RoleBinding metadata: - name: {{ .Release.Namespace }}-neo4j-anyuid + name: neo4j-anyuid + namespace: {{ .Release.Namespace }} labels: app.kubernetes.io/part-of: general-sim app.kubernetes.io/component: neo4j diff --git a/deploy/helm/templates/postgres/scc-binding.yaml b/deploy/helm/templates/postgres/scc-binding.yaml deleted file mode 100644 index e734fc6..0000000 --- a/deploy/helm/templates/postgres/scc-binding.yaml +++ /dev/null @@ -1,16 +0,0 @@ -{{- if .Values.postgres.enabled }} -apiVersion: rbac.authorization.k8s.io/v1 -kind: ClusterRoleBinding -metadata: - name: {{ .Release.Namespace }}-postgres-anyuid - labels: - {{- include "postgres.labels" . | nindent 4 }} -roleRef: - apiGroup: rbac.authorization.k8s.io - kind: ClusterRole - name: system:openshift:scc:anyuid -subjects: - - kind: ServiceAccount - name: postgres-sa - namespace: {{ .Release.Namespace }} -{{- end }} diff --git a/deploy/helm/templates/postgres/serviceaccount.yaml b/deploy/helm/templates/postgres/serviceaccount.yaml deleted file mode 100644 index 2a61c14..0000000 --- a/deploy/helm/templates/postgres/serviceaccount.yaml +++ /dev/null @@ -1,9 +0,0 @@ -{{- if .Values.postgres.enabled }} -apiVersion: v1 -kind: ServiceAccount -metadata: - name: postgres-sa - namespace: {{ .Release.Namespace }} - labels: - {{- include "postgres.labels" . | nindent 4 }} -{{- end }} diff --git a/deploy/helm/templates/postgres/statefulset.yaml b/deploy/helm/templates/postgres/statefulset.yaml index 97b2209..4b0c73b 100644 --- a/deploy/helm/templates/postgres/statefulset.yaml +++ b/deploy/helm/templates/postgres/statefulset.yaml @@ -17,11 +17,10 @@ spec: labels: {{- include "postgres.selectorLabels" . | nindent 8 }} spec: - serviceAccountName: postgres-sa + # OpenShift restricted SCC: no fixed runAsUser/fsGroup — the platform assigns + # a namespace UID and fsGroup; the postgres image supports arbitrary UID. securityContext: - runAsUser: 999 runAsNonRoot: true - fsGroup: 999 containers: - name: postgres image: {{ include "postgres.containerImage" . }} @@ -58,7 +57,6 @@ spec: {{- toYaml . | nindent 12 }} {{- end }} securityContext: - runAsUser: 999 allowPrivilegeEscalation: false capabilities: drop: ["ALL"] diff --git a/docs/VALUES_MAPPING.md b/docs/VALUES_MAPPING.md index a0367ef..38a33fb 100644 --- a/docs/VALUES_MAPPING.md +++ b/docs/VALUES_MAPPING.md @@ -113,7 +113,7 @@ for subchart values. | Parent key | Renders | `enabled` guard | |------------|---------|-----------------| -| `postgres` | Inline StatefulSet, Services, SCC (`templates/postgres/`) | `postgres.enabled` | +| `postgres` | Inline StatefulSet, Services (`templates/postgres/`) | `postgres.enabled` | | `openshift.neo4j` | Inline Secret, SA, SCC (`templates/neo4j/`) | `neo4j.enabled` + `openshift.neo4j.scc.enabled` (SA/SCC) | | `bootstrap` | Inline schema Job (hook) | `bootstrap.enabled` | | `api` | Inline Deployment, Service, Route | `api.enabled` | @@ -159,7 +159,7 @@ defaults to in-cluster `http://-vllm..svc.cluster.local/v1`. |----------|-------|---------| | [`neo4j/secret.yaml`](../deploy/helm/templates/neo4j/secret.yaml) | `global.neo4j.password` | Secret `neo4j-auth` | | [`neo4j/serviceaccount.yaml`](../deploy/helm/templates/neo4j/serviceaccount.yaml) | `openshift.neo4j.scc.enabled` | OpenShift SA `neo4j-sa` | -| [`neo4j/scc-binding.yaml`](../deploy/helm/templates/neo4j/scc-binding.yaml) | `openshift.neo4j.scc.enabled` | SCC ClusterRoleBinding | +| [`neo4j/scc-binding.yaml`](../deploy/helm/templates/neo4j/scc-binding.yaml) | `openshift.neo4j.scc.enabled` | SCC RoleBinding (`anyuid`) | | [`llamastack-pg-secret.yaml`](../deploy/helm/templates/llamastack-pg-secret.yaml) | `global.postgres.*` | Secret `pgvector` | | [`llamastack-run-config.yaml`](../deploy/helm/templates/llamastack-run-config.yaml) | `api.models.embedding`, `global.models.*` | ConfigMap `general-sim-llamastack-config` (mounted by llama-stack) | From 117981201401b5e8582255eab887b20b1c82d9e0 Mon Sep 17 00:00:00 2001 From: Robert Sandoval Date: Tue, 15 Sep 2026 14:57:16 -0500 Subject: [PATCH 3/8] Run Neo4j on OpenShift restricted SCC via custom arbitrary-UID image. Add general-sim-neo4j image wrapper, disable anyuid SCC templates by default, and override neo4j subchart securityContext so developers can deploy without SCC grants. Co-authored-by: Cursor --- Makefile | 23 +++++++++++++++++-- README.md | 14 ++++++----- deploy/container_files/neo4j/Containerfile | 23 +++++++++++++++++++ deploy/helm/README.md | 5 ++-- .../helm/templates/neo4j/serviceaccount.yaml | 2 +- deploy/helm/values.yaml | 21 ++++++++++++++--- docs/VALUES_MAPPING.md | 6 ++--- 7 files changed, 77 insertions(+), 17 deletions(-) create mode 100644 deploy/container_files/neo4j/Containerfile diff --git a/Makefile b/Makefile index 52ce48b..4c7d2f0 100644 --- a/Makefile +++ b/Makefile @@ -24,6 +24,7 @@ NAMESPACE ?= general-simulation TAG ?= latest APP_IMAGE_NAME ?= general-sim-api POSTGRES_IMAGE_NAME ?= general-sim-postgres +NEO4J_IMAGE_NAME ?= general-sim-neo4j DEPLOY_TIMEOUT ?= 25m CHART_REPO_URL ?= https://rh-ai-quickstart.github.io/general-simulation LLM_SERVICE_CHART_REPO ?= https://rh-ai-quickstart.github.io/ai-architecture-charts @@ -32,6 +33,7 @@ LLAMA_STACK_VERSION ?= 0.8.5 # ── Derived image references ────────────────────────────────────────────────── IMG_POSTGRES := $(REGISTRY)/$(POSTGRES_IMAGE_NAME):$(TAG) IMG_APP := $(REGISTRY)/$(APP_IMAGE_NAME):$(TAG) +IMG_NEO4J := $(REGISTRY)/$(NEO4J_IMAGE_NAME):$(TAG) # ── Helm chart paths ────────────────────────────────────────────────────────── CHART_UMBRELLA := deploy/helm @@ -41,6 +43,9 @@ CHART_VALUES_SECRETS := deploy/helm/values-secrets.yaml HELM_RELEASE_NAME ?= general-simulation HELM_COMMON := --namespace $(NAMESPACE) +# Neo4j subchart reads image.customImage directly (not global.registry helpers). +_helm_neo4j_image_set := --set neo4j.image.customImage=$(IMG_NEO4J) + # Optional helm --set overrides when image vars are passed on the make command line. _helm_image_set := ifneq ($(filter command line,$(origin REGISTRY)),) @@ -55,6 +60,9 @@ endif ifneq ($(filter command line,$(origin POSTGRES_IMAGE_NAME)),) _helm_image_set += --set global.images.postgres=$(POSTGRES_IMAGE_NAME) endif +ifneq ($(filter command line,$(origin NEO4J_IMAGE_NAME)),) + _helm_neo4j_image_set := --set neo4j.image.customImage=$(IMG_NEO4J) +endif # Stack model ids (providerKey/model.id) LOCAL_MODEL_KEY ?= deepseek-r1-distill-qwen-1-5b @@ -64,7 +72,7 @@ LOCAL_COMPOSE := deploy/local/composefile.yml # ── Phony declarations ──────────────────────────────────────────────────────── .PHONY: all help \ - build build-postgres build-app \ + build build-postgres build-neo4j build-app \ deploy deploy-umbrella neo4j-connect \ package-chart \ undeploy status lint-charts test-unit smoke-test \ @@ -95,6 +103,7 @@ help: @printf "\nVariables:\n" @printf " %-18s %s\n" "REGISTRY" "$(REGISTRY)" @printf " %-18s %s\n" "APP_IMAGE_NAME" "$(APP_IMAGE_NAME)" + @printf " %-18s %s\n" "NEO4J_IMAGE_NAME" "$(NEO4J_IMAGE_NAME)" @printf " %-18s %s\n" "NAMESPACE" "$(NAMESPACE)" @printf " %-18s %s\n" "TAG" "$(TAG)" @printf " %-18s %s\n" "DEPLOY_TIMEOUT" "$(DEPLOY_TIMEOUT)" @@ -123,9 +132,18 @@ _guard-podman: { echo "ERROR: 'podman' not found. Install Podman or substitute 'docker' by setting PODMAN=docker."; exit 1; } # ── Container image builds ──────────────────────────────────────────────────── -build: _guard-podman build-postgres build-app +build: _guard-podman build-postgres build-neo4j build-app @echo "==> All images built and pushed to $(REGISTRY)." +build-neo4j: _guard-podman + @echo "==> Building Neo4j image: $(IMG_NEO4J)" + podman build \ + --platform=linux/amd64 \ + -f deploy/container_files/neo4j/Containerfile \ + -t $(IMG_NEO4J) \ + deploy/container_files/neo4j + podman push $(IMG_NEO4J) + build-postgres: _guard-podman @echo "==> Building Postgres image: $(IMG_POSTGRES)" podman build \ @@ -222,6 +240,7 @@ deploy-umbrella: _guard-values-secrets \ $(HELM_COMMON) \ -f $(CHART_VALUES_SECRETS) \ $(_helm_image_set) \ + $(_helm_neo4j_image_set) \ --wait --timeout $(DEPLOY_TIMEOUT) @printf "\n==> Deployment complete.\n" @printf " API (same-NS): http://general-sim-api:8000\n" diff --git a/README.md b/README.md index 6dc9800..1da4060 100644 --- a/README.md +++ b/README.md @@ -507,9 +507,10 @@ Default toggles in [`deploy/helm/values.yaml`](deploy/helm/values.yaml): `ingest OpenShift AI unless you disable it). `make deploy` installs the umbrella chart as a **single Helm release**, creates -`templates/neo4j/` resources (`neo4j-sa`, anyuid SCC, Secret `neo4j-auth` when -`openshift.neo4j.scc.enabled`), and wires Llama Stack to enabled `global.models` -providers. +Secret `neo4j-auth`, wires Llama Stack to enabled `global.models` providers, and +deploys Neo4j via the OpenShift-compatible `general-sim-neo4j` image (restricted +SCC; no admin anyuid grant). Set `openshift.neo4j.scc.enabled: true` only when +an admin can grant the legacy anyuid RoleBinding. --- @@ -564,9 +565,10 @@ Component toggles live in [`deploy/helm/values.yaml`](deploy/helm/values.yaml) u ### Neo4j Browser access -Neo4j is deployed by the umbrella chart (`neo4j.enabled` in `deploy/helm/values.yaml`). -OpenShift wiring (`neo4j-sa`, SCC, `neo4j-auth`) is rendered from -`deploy/helm/templates/neo4j/` when `openshift.neo4j.scc.enabled` is true. +Neo4j is deployed by the umbrella chart (`neo4j.enabled` in `deploy/helm/values.yaml`) +using the custom `general-sim-neo4j` image for OpenShift restricted SCC. If you +previously ran Neo4j with UID 7474 (`openshift.neo4j.scc.enabled: true`), delete +the Neo4j PVC before redeploying so data dirs are re-initialized under the new UID. For local Browser + Bolt access (Bolt cannot be proxied through a Route): diff --git a/deploy/container_files/neo4j/Containerfile b/deploy/container_files/neo4j/Containerfile new file mode 100644 index 0000000..8faf81d --- /dev/null +++ b/deploy/container_files/neo4j/Containerfile @@ -0,0 +1,23 @@ +# OpenShift-compatible Neo4j image (restricted-v2 / arbitrary namespace UID). +# +# Wraps the official Neo4j image and applies the same group-0 + g=u pattern used +# by general-sim-api and general-sim-postgres so data/logs/plugins are writable +# when OpenShift overrides the container UID. +# +# Build (from repo root): +# podman build -f deploy/container_files/neo4j/Containerfile \ +# -t quay.io/myorg/general-sim-neo4j:latest deploy/container_files/neo4j +# +# Pin the upstream tag when upgrading the neo4j Helm subchart. +ARG NEO4J_BASE=neo4j:5-community +FROM ${NEO4J_BASE} + +USER root + +# Paths Neo4j writes at runtime (see official image + compose local volume mounts). +RUN mkdir -p /data /logs /plugins \ + && chgrp -R 0 /data /logs /plugins /var/lib/neo4j \ + && chmod -R g=u /data /logs /plugins /var/lib/neo4j + +# OpenShift assigns an arbitrary UID; keep non-root default from base image. +USER neo4j diff --git a/deploy/helm/README.md b/deploy/helm/README.md index bb8100e..9b85fc1 100644 --- a/deploy/helm/README.md +++ b/deploy/helm/README.md @@ -17,7 +17,7 @@ templates/ api/ # Deployment, Service, Route, ConfigMap, Secret bootstrap/ # Schema bootstrap Job ingestion/ # CronJob + optional hook Job - neo4j/ # Secret neo4j-auth, ServiceAccount, SCC binding + neo4j/ # Secret neo4j-auth; optional SA + SCC binding (legacy anyuid) postgres/ # StatefulSet, Services, init ConfigMap llamastack-*.yaml # Llama Stack run-config + pgvector Secret bridge _helpers.tpl # Shared DSN, image, and wait-for helpers @@ -30,7 +30,8 @@ templates/ oc new-project general-simulation || oc project general-simulation cp deploy/helm/values-secrets.yaml.example deploy/helm/values-secrets.yaml -# edit deploy/helm/values-secrets.yaml — then: +# edit deploy/helm/values-secrets.yaml — then build (includes general-sim-neo4j) and deploy: +make build make deploy ``` diff --git a/deploy/helm/templates/neo4j/serviceaccount.yaml b/deploy/helm/templates/neo4j/serviceaccount.yaml index c9d2230..d1c335f 100644 --- a/deploy/helm/templates/neo4j/serviceaccount.yaml +++ b/deploy/helm/templates/neo4j/serviceaccount.yaml @@ -1,5 +1,5 @@ {{- if and .Values.neo4j.enabled (.Values.openshift.neo4j.scc.enabled | default false) }} -# OpenShift: Neo4j runs as UID/GID 7474 — needs anyuid SCC (see scc-binding.yaml). +# Legacy anyuid path — only rendered when openshift.neo4j.scc.enabled is true. apiVersion: v1 kind: ServiceAccount metadata: diff --git a/deploy/helm/values.yaml b/deploy/helm/values.yaml index d99ec0a..c55facb 100644 --- a/deploy/helm/values.yaml +++ b/deploy/helm/values.yaml @@ -6,7 +6,9 @@ openshift: neo4j: scc: - enabled: true + # false: restricted SCC + general-sim-neo4j image (developer self-service). + # true: neo4j-sa + anyuid RoleBinding (requires SCC grant escalation). + enabled: false global: postgres: @@ -32,6 +34,21 @@ neo4j: enabled: true disableLookups: true fullnameOverride: neo4j + image: + customImage: quay.io/rh-ai-quickstart/general-sim-neo4j:latest + securityContext: + runAsNonRoot: true + runAsUser: null + runAsGroup: null + fsGroup: null + fsGroupChangePolicy: null + containerSecurityContext: + runAsNonRoot: true + runAsUser: null + runAsGroup: null + allowPrivilegeEscalation: false + capabilities: + drop: ["ALL"] config: server.bolt.advertised_address: ":443" server.http.advertised_address: ":443" @@ -43,8 +60,6 @@ neo4j: resources: cpu: "2" memory: 4Gi - podSpec: - serviceAccountName: neo4j-sa services: neo4j: enabled: false diff --git a/docs/VALUES_MAPPING.md b/docs/VALUES_MAPPING.md index 38a33fb..30f9ca2 100644 --- a/docs/VALUES_MAPPING.md +++ b/docs/VALUES_MAPPING.md @@ -114,7 +114,7 @@ for subchart values. | Parent key | Renders | `enabled` guard | |------------|---------|-----------------| | `postgres` | Inline StatefulSet, Services (`templates/postgres/`) | `postgres.enabled` | -| `openshift.neo4j` | Inline Secret, SA, SCC (`templates/neo4j/`) | `neo4j.enabled` + `openshift.neo4j.scc.enabled` (SA/SCC) | +| `openshift.neo4j` | Inline Secret; optional SA + SCC RoleBinding (`templates/neo4j/`) | `neo4j.enabled` + `openshift.neo4j.scc.enabled` (SA/SCC only when true) | | `bootstrap` | Inline schema Job (hook) | `bootstrap.enabled` | | `api` | Inline Deployment, Service, Route | `api.enabled` | | `ingestion` | Inline CronJob + hook Job | `ingestion.enabled` | @@ -158,8 +158,8 @@ defaults to in-cluster `http://-vllm..svc.cluster.local/v1`. | Template | Reads | Creates | |----------|-------|---------| | [`neo4j/secret.yaml`](../deploy/helm/templates/neo4j/secret.yaml) | `global.neo4j.password` | Secret `neo4j-auth` | -| [`neo4j/serviceaccount.yaml`](../deploy/helm/templates/neo4j/serviceaccount.yaml) | `openshift.neo4j.scc.enabled` | OpenShift SA `neo4j-sa` | -| [`neo4j/scc-binding.yaml`](../deploy/helm/templates/neo4j/scc-binding.yaml) | `openshift.neo4j.scc.enabled` | SCC RoleBinding (`anyuid`) | +| [`neo4j/serviceaccount.yaml`](../deploy/helm/templates/neo4j/serviceaccount.yaml) | `openshift.neo4j.scc.enabled` | OpenShift SA `neo4j-sa` (legacy anyuid path) | +| [`neo4j/scc-binding.yaml`](../deploy/helm/templates/neo4j/scc-binding.yaml) | `openshift.neo4j.scc.enabled` | SCC RoleBinding (`anyuid`, legacy path) | | [`llamastack-pg-secret.yaml`](../deploy/helm/templates/llamastack-pg-secret.yaml) | `global.postgres.*` | Secret `pgvector` | | [`llamastack-run-config.yaml`](../deploy/helm/templates/llamastack-run-config.yaml) | `api.models.embedding`, `global.models.*` | ConfigMap `general-sim-llamastack-config` (mounted by llama-stack) | From 2886a3fdc03811ff9476495f955069996c2404b5 Mon Sep 17 00:00:00 2001 From: Robert Sandoval Date: Tue, 15 Sep 2026 15:42:42 -0500 Subject: [PATCH 4/8] updated makefile and set llmservice enabled: false --- Makefile | 21 +++++++++++++++------ deploy/helm/values.yaml | 2 +- 2 files changed, 16 insertions(+), 7 deletions(-) diff --git a/Makefile b/Makefile index 4c7d2f0..5f42886 100644 --- a/Makefile +++ b/Makefile @@ -78,7 +78,7 @@ LOCAL_COMPOSE := deploy/local/composefile.yml undeploy status lint-charts test-unit smoke-test \ local-up local-down local-bootstrap \ _guard-values-secrets \ - _guard-oc _guard-helm _guard-podman \ + _guard-oc _guard-helm _guard-podman _guard-namespace \ _remove-orphan-neo4j-resources _remove-openshift-routes # ── Default target ──────────────────────────────────────────────────────────── @@ -123,6 +123,15 @@ _guard-oc: @command -v oc >/dev/null 2>&1 || \ { echo "ERROR: 'oc' CLI not found. Install the OpenShift CLI and run 'oc login'."; exit 1; } +_guard-namespace: _guard-oc + @oc get namespace $(NAMESPACE) >/dev/null 2>&1 || { \ + printf "ERROR: OpenShift project '%s' does not exist or is not visible.\n" "$(NAMESPACE)"; \ + printf " oc new-project %s\n" "$(NAMESPACE)"; \ + printf " # or, if it already exists:\n"; \ + printf " oc project %s\n" "$(NAMESPACE)"; \ + exit 1; \ + } + _guard-helm: @command -v helm >/dev/null 2>&1 || \ { echo "ERROR: 'helm' CLI not found. Install Helm 3+ from https://helm.sh/docs/intro/install/"; exit 1; } @@ -196,7 +205,7 @@ _remove-orphan-neo4j-resources: _guard-oc if [ "$$kind" = rolebinding ]; then \ oc delete $$kind $$name -n $$ns --ignore-not-found; \ else \ - oc delete $$kind $$name --ignore-not-found; \ + oc delete $$kind $$name --ignore-not-found 2>/dev/null || true; \ fi; \ fi; \ done @@ -228,7 +237,7 @@ _remove-openshift-routes: _guard-oc deploy: deploy-umbrella deploy-umbrella: _guard-values-secrets \ - _guard-oc _guard-helm _remove-orphan-neo4j-resources + _guard-oc _guard-helm _guard-namespace _remove-orphan-neo4j-resources @echo "==> Updating umbrella chart dependencies..." helm repo add neo4j https://helm.neo4j.com/neo4j 2>/dev/null || true helm repo update neo4j @@ -283,10 +292,10 @@ undeploy: _guard-helm _guard-oc _remove-openshift-routes helm uninstall bootstrap --namespace $(NAMESPACE) 2>/dev/null || true helm uninstall neo4j --namespace $(NAMESPACE) 2>/dev/null || true helm uninstall postgres --namespace $(NAMESPACE) 2>/dev/null || true - @echo "==> Removing Neo4j anyuid SCC binding + ServiceAccount..." + @echo "==> Removing Neo4j OpenShift resources (legacy SCC bindings best-effort)..." @oc delete rolebinding neo4j-anyuid -n $(NAMESPACE) --ignore-not-found >/dev/null - @oc delete clusterrolebinding $(NAMESPACE)-neo4j-anyuid --ignore-not-found >/dev/null - @oc delete clusterrolebinding $(NAMESPACE)-postgres-anyuid --ignore-not-found >/dev/null + @oc delete clusterrolebinding $(NAMESPACE)-neo4j-anyuid --ignore-not-found 2>/dev/null || true + @oc delete clusterrolebinding $(NAMESPACE)-postgres-anyuid --ignore-not-found 2>/dev/null || true @oc delete serviceaccount neo4j-sa -n $(NAMESPACE) --ignore-not-found >/dev/null @oc delete secret neo4j-auth pgvector -n $(NAMESPACE) --ignore-not-found >/dev/null @echo " Done. PVCs are NOT deleted automatically — remove manually if needed:" diff --git a/deploy/helm/values.yaml b/deploy/helm/values.yaml index c55facb..7589d0c 100644 --- a/deploy/helm/values.yaml +++ b/deploy/helm/values.yaml @@ -96,7 +96,7 @@ llama-stack: name: cache llm-service: - enabled: true + enabled: false models: llama-3-1-8b-instruct-fp8-dynamic: enabled: true From 9a19cf68ef21e28b46cefd32beb2907cffb7c2f0 Mon Sep 17 00:00:00 2001 From: Robert Sandoval Date: Tue, 6 Oct 2026 11:06:20 -0500 Subject: [PATCH 5/8] updated add domain readme --- README.md | 12 +++---- docs/ADD_DOMAIN.md | 62 +++++++++++++++++++++++++++------ docs/ADD_DOMAIN_PROMPT.md | 72 +++++++++++++++++++++++++-------------- 3 files changed, 105 insertions(+), 41 deletions(-) diff --git a/README.md b/README.md index 1da4060..ec14466 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ A **domain-agnostic** simulation and impact-reasoning platform built on: - [Running without hardware (CI / dev laptops)](#running-without-hardware-ci--dev-laptops) - [LLM backend configuration](#llm-backend-configuration) - [OpenShift Deployment](#openshift-deployment) -- [Adding a domain](ADD_DOMAIN.md) · [Cursor prompts](docs/prompts/add-domain/README.md) +- [Adding a domain](docs/ADD_DOMAIN.md) · [Cursor prompts](docs/ADD_DOMAIN_PROMPT.md) --- @@ -112,8 +112,8 @@ optional geometry, timestamp, status, and a free-form attributes field). The shared runner in `lib/ingestion/` upserts into PostGIS only — ground truth, never the simulation overlay. Which domain packages load is controlled by `ENABLED_DOMAINS`; which adapter a CronJob runs is `--adapter` / Helm -`adapterId`. Details: [ADD_DOMAIN.md](ADD_DOMAIN.md). Cursor paste-prompts: -[docs/prompts/add-domain/README.md](docs/prompts/add-domain/README.md). +`adapterId`. Details: [docs/ADD_DOMAIN.md](docs/ADD_DOMAIN.md). Cursor paste-prompts: +[docs/ADD_DOMAIN_PROMPT.md](docs/ADD_DOMAIN_PROMPT.md). Each adapter runs two ways: as a scheduled OpenShift CronJob for steady polling, and as an on-demand callable that the reasoning agent can trigger mid-query when it needs current data. @@ -221,8 +221,8 @@ swap points. The skeleton — OpenShift, vLLM (optional), Postgres, Neo4j, the ReAct pipeline, and the overlay mechanism — stays identical. Domain-specific code lives under top-level **`domain//`** packages (adapters, optional solvers). Which packages load is controlled by **`ENABLED_DOMAINS`** -(see [ADD_DOMAIN.md](ADD_DOMAIN.md); Cursor: -[docs/prompts/add-domain/README.md](docs/prompts/add-domain/README.md)). +(see [docs/ADD_DOMAIN.md](docs/ADD_DOMAIN.md); Cursor: +[docs/ADD_DOMAIN_PROMPT.md](docs/ADD_DOMAIN_PROMPT.md)). ![Fixed core vs. swap seams](docs/images/domain-seams.png) @@ -269,7 +269,7 @@ uv run python scripts/seed_shipping.py # ingest + graph + LA closure scenario 5. **Live data and simulation knowledge stay separate.** The overlay must never mutate ground truth; this is what enables concurrent, reversible what-if scenarios. 6. **The `tool_call_trace` is the reasoning audit trail.** Every `QueryResponse` includes the ordered list of tool calls the agent made — use this to debug or explain any answer. -> In short: a fixed OpenShift-native skeleton handles platform, inference, storage, and agentic reasoning identically across domains, while domain packages under `domain/` — adapters, optional solvers, and related wiring — are all that change to retarget it from supply chains to manufacturing plants. See [ADD_DOMAIN.md](ADD_DOMAIN.md). +> In short: a fixed OpenShift-native skeleton handles platform, inference, storage, and agentic reasoning identically across domains, while domain packages under `domain/` — adapters, optional solvers, and related wiring — are all that change to retarget it from supply chains to manufacturing plants. See [docs/ADD_DOMAIN.md](docs/ADD_DOMAIN.md). --- diff --git a/docs/ADD_DOMAIN.md b/docs/ADD_DOMAIN.md index 99ba903..ffb427a 100644 --- a/docs/ADD_DOMAIN.md +++ b/docs/ADD_DOMAIN.md @@ -10,7 +10,7 @@ manufacturing — without changing core platform logic. > plus one catalog entry. Loading is controlled by `ENABLED_DOMAINS`. Using Cursor? Paste the staged prompts in -[docs/prompts/add-domain/README.md](docs/prompts/add-domain/README.md) +[ADD_DOMAIN_PROMPT.md](ADD_DOMAIN_PROMPT.md) (Prompt 0 → 1 → …) and keep this file as the human checklist. --- @@ -287,8 +287,18 @@ follow the `shipping_demo` fixture + `tests/test_ingestion.py` pattern. ### Step 4 — Wire the dependency graph (optional but recommended) The dependency graph (Neo4j) captures which entities depend on which. -Wire it once at setup time (script or Job), not inside the adapter. Use -helpers in `lib/graph/nodes.py`: +Wire it once at setup time (script or Job), not inside the adapter. + +**Prefer the shipping pattern:** put MERGE logic in +`domain//bootstrap_graph.py` and a thin runner in +`scripts/seed_.py`. See: + +- `domain/shipping/bootstrap_graph.py` — `DEPENDS_ON` / `FEEDS` / `CARRIES` plus + an optional simulation-event / spatial overlay +- `scripts/seed_shipping.py` — CLI that ingests then bootstraps the graph + +Use helpers in `lib/graph/nodes.py` (`create_entity_node`, +`create_dependency_edge`, `EDGE_*`). Sketch: ```python import asyncio @@ -315,6 +325,9 @@ async def bootstrap_flight_graph(): asyncio.run(bootstrap_flight_graph()) ``` +(`scripts/seed_demo.py` is a large aviation demo seed — useful for end-to-end +smoke tests, not the template for a new domain package.) + After ingestion, live entities appear in Postgres; add edges from those ids to infrastructure nodes as needed. Stage 1 traversal picks them up automatically. @@ -391,11 +404,23 @@ No hard-coded swap in `app.py` is required. ### Step 6 — Deploy / schedule ingestion -Set `ENABLED_DOMAINS` (or Helm `enabledDomains`) so the domain package loads, -and set the CronJob `adapterId` to the adapter this job should run: +Set `ENABLED_DOMAINS` so the domain package loads, and point the CronJob at the +adapter this job should run. + +Domain keys are **optional** in `deploy/helm/values.yaml` — defaults live in +`deploy/helm/templates/_helpers.tpl`: + +| Key | Helper default | +|---|---| +| `api.enabledDomains` | `aviation,shipping` | +| `ingestion.enabledDomains` | same as `api.enabledDomains` | +| `ingestion.adapterId` | `opensky_flights` | + +`deploy/helm/values.yaml` currently sets `ingestion.enabled: false` (CronJob +off until you enable it). Explicit values or `--set`: ```yaml -# deploy/helm/values.yaml +# deploy/helm/values.yaml (optional overrides) api: enabledDomains: aviation ingestion: @@ -404,11 +429,25 @@ ingestion: enabledDomains: aviation ``` +```bash +helm upgrade --install ... \ + --set api.enabledDomains=aviation \ + --set ingestion.enabled=true \ + --set ingestion.adapterId=opensky_flights \ + --set ingestion.enabledDomains=aviation +``` + For a second adapter on a different schedule, add another CronJob (or Helm release) with the same `enabledDomains` and a different `adapterId`. -Helm values (`deploy/helm/values.yaml` under `api:` and `ingestion:`, e.g. `enabledDomains`, -`adapterId`) carry `ENABLED_DOMAINS` for deployed workloads. +**Operator smoke (local or deployed API):** + +```bash +uv run ingest-run --adapter opensky_flights +# or via admin (same ENABLED_DOMAINS filter): +# GET /admin/ingestion/adapters +# POST /admin/ingestion/run # body includes adapter_id +``` --- @@ -425,12 +464,15 @@ New domain = these files only: UPDATE lib/ingestion/registry.py ← DomainSpec (+ adapters) UPDATE tests/test_registry.py ← assert catalog entry SET ENABLED_DOMAINS= ← .env / Helm / ConfigMap + CREATE domain//bootstrap_graph.py ← (optional) Neo4j wiring + CREATE scripts/seed_.py ← (optional) thin seed CLI CREATE domain//solver.py ← (optional) real solver - UPDATE deploy/helm/values.yaml (ingestion.adapterId + ingestion.enabledDomains) + SET/UPDATE Helm api.enabledDomains + ingestion.adapterId / enabledDomains + (values.yaml and/or --set; defaults in templates/_helpers.tpl) ``` Cursor paste-prompts for the same checklist: -[docs/prompts/add-domain/README.md](docs/prompts/add-domain/README.md). +[ADD_DOMAIN_PROMPT.md](ADD_DOMAIN_PROMPT.md). **Files you normally never touch for domain logic:** diff --git a/docs/ADD_DOMAIN_PROMPT.md b/docs/ADD_DOMAIN_PROMPT.md index 351c34d..818947a 100644 --- a/docs/ADD_DOMAIN_PROMPT.md +++ b/docs/ADD_DOMAIN_PROMPT.md @@ -1,7 +1,7 @@ # Cursor prompts: add a domain Paste these into Cursor **one at a time** (Prompt 0 → 1 → …). Fill in the -`` before sending. Keep [ADD_DOMAIN.md](../../../ADD_DOMAIN.md) +`` before sending. Keep [ADD_DOMAIN.md](ADD_DOMAIN.md) open as the human checklist — these prompts drive an agent through the same steps without rewriting core platform code. @@ -14,7 +14,8 @@ steps without rewriting core platform code. - Tests must be offline (fixture + `normalize`, no live network/DB) Reference implementations: `domain/shipping/adapters/shipping_demo.py`, -`tests/fixtures/shipping_demo.json`, `tests/test_ingestion.py`. +`domain/shipping/bootstrap_graph.py`, `tests/fixtures/shipping_demo.json`, +`tests/test_ingestion.py`. --- @@ -24,18 +25,22 @@ Reference implementations: `domain/shipping/adapters/shipping_demo.py`, You are helping me add a new domain to this simulation platform. Read and summarize (do not edit yet): -- ADD_DOMAIN.md +- docs/ADD_DOMAIN.md - README.md sections on ingestion and "Why the same design serves multiple domains" - domain/aviation/ and domain/shipping/ as reference packages + (prefer shipping: adapter + bootstrap_graph.py + scripts/seed_shipping.py) - lib/ingestion/registry.py - lib/core/ingestion.py - lib/core/config.py (enabled_domains) - tests/test_registry.py and tests/test_ingestion.py +- deploy/helm/templates/_helpers.tpl (api.enabledDomains, ingestion.adapterId, + ingestion.enabledDomains defaults — values.yaml may omit these keys) Then answer: 1. Exact file checklist for a new domain named 2. What must NOT be changed in lib/core, lib/reasoning, lib/graph, lib/ingestion/runner.py 3. How ENABLED_DOMAINS and adapter_id interact +4. How Helm picks enabledDomains / adapterId when values.yaml leaves them unset Wait for my domain description before writing code. ``` @@ -117,16 +122,22 @@ Run: uv run pytest tests/test_registry.py tests/test_.py -v ```text Wire a minimal Neo4j dependency graph for domain . -Read lib/graph/nodes.py (create_entity_node, create_dependency_edge, EDGE_*). -Read scripts/seed_demo.py only as a pattern — do not aviation-hardcode in core. +Primary pattern (prefer this): +- domain/shipping/bootstrap_graph.py — MERGE edges + optional scenario overlay +- scripts/seed_shipping.py — thin CLI that calls the domain bootstrap after ingest -Create domain//bootstrap_graph.py (or scripts/seed_.py) that: -- Creates a few fixed infrastructure Entity nodes +Also read: +- lib/graph/nodes.py (create_entity_node, create_dependency_edge, EDGE_*) +- scripts/seed_demo.py only as a large aviation demo — do not aviation-hardcode in core + +Create domain//bootstrap_graph.py plus an optional scripts/seed_.py that: +- Creates a few fixed infrastructure Entity nodes (or links to ids the adapter already upserts) - Creates DEPENDS_ON / FEEDS / CARRIES edges as appropriate - Documents how ingested live entity ids should connect to those nodes -- Is idempotent where practical +- Is idempotent where practical (MERGE-style helpers) +- Optionally injects a simulation event / spatial overlay (see shipping bootstrap) -Do not mutate live PostGIS from this script unless seeding demo geometries +Do not mutate live PostGIS from the graph bootstrap unless seeding demo geometries is explicitly required. Explain how Stage-1 traversal will use these edges. ``` @@ -137,7 +148,8 @@ is explicitly required. Explain how Stage-1 traversal will use these edges. ```text Add an optional Stage-2 solver for . -Read lib/core/solver.py (Solver protocol, AffectedSubgraph, LiveState, SolverResult) +Read lib/core/solver.py (Solver protocol, AffectedSubgraph, LiveState, SolverResult — +including total_value_at_risk / recommended_reroutes if you use them) and lib/solver/stub.py. Neither aviation nor shipping ships a solver today — StubSolver is the fallback. @@ -159,17 +171,26 @@ Wire runtime config so this domain can run in local + Helm paths. 1. Document .env: ENABLED_DOMAINS= - # or comma-join with aviation if needed + # or comma-join with aviation,shipping if needed 2. Show CLI: uv run ingest-run --adapter -3. Update `deploy/helm/values.yaml` (`ingestion:` and `api:` sections) OR - document the --set overrides: - enabledDomains= - adapterId= -4. Mention `deploy/helm/values.yaml` (`api.enabledDomains`, `ingestion.adapterId`, `ingestion.enabledDomains`) - `enabledDomains` if relevant -5. Do not invent new CronJob templates unless multiple adapters need different schedules - -End with a short "smoke test" checklist for a human operator. +3. Helm: domain keys are optional in deploy/helm/values.yaml — defaults live in + deploy/helm/templates/_helpers.tpl: + - api.enabledDomains default: aviation,shipping + - ingestion.adapterId default: opensky_flights + - ingestion.enabledDomains default: same as api.enabledDomains + - ingestion.enabled default in values.yaml: false (CronJob off until enabled) + Either set keys under api: / ingestion: in values.yaml OR document --set: + --set api.enabledDomains= + --set ingestion.enabled=true + --set ingestion.adapterId= + --set ingestion.enabledDomains= +4. Do not invent new CronJob templates unless multiple adapters need different schedules +5. Mention admin smoke paths (same ENABLED_DOMAINS): + GET /admin/ingestion/adapters + POST /admin/ingestion/run (body includes adapter_id) + +End with a short "smoke test" checklist for a human operator +(local ingest-run, optional admin endpoints, Helm --set if deploying). ``` --- @@ -179,7 +200,7 @@ End with a short "smoke test" checklist for a human operator. Use this only if you prefer one paste instead of Prompts 0–6: ```text -Implement a new domain for this repo following ADD_DOMAIN.md and the existing +Implement a new domain for this repo following docs/ADD_DOMAIN.md and the existing aviation/shipping packages under domain/. Domain brief: @@ -189,7 +210,8 @@ Domain brief: - entity mapping: - enable locally via ENABLED_DOMAINS - include fixture + pytest -- optional: graph bootstrap script, solver, Helm value notes +- optional: domain//bootstrap_graph.py (+ scripts/seed_.py), + solver, Helm --set / values notes (see _helpers.tpl defaults) Hard rules: - New code lives under domain// @@ -198,7 +220,7 @@ Hard rules: - Domain fields go in CanonicalEntity.attributes only - Tests must be offline -Use domain/shipping/adapters/shipping_demo.py and tests/test_ingestion.py -as the primary implementation/test patterns. After changes, run the new tests -and report the checklist from ADD_DOMAIN.md with done/skipped items. +Use domain/shipping/adapters/shipping_demo.py, domain/shipping/bootstrap_graph.py, +and tests/test_ingestion.py as the primary patterns. After changes, run the new +tests and report the checklist from docs/ADD_DOMAIN.md with done/skipped items. ``` From f34ba5e5d4416c3e97acdd748676bb51425ac7ef Mon Sep 17 00:00:00 2001 From: RJ Johnson Date: Wed, 14 Oct 2026 10:12:20 -0400 Subject: [PATCH 6/8] chore(seeds): changing seed scripts to use yaml to link real data to customer data. (#7) --- lib/cli/seed_network_overlay.py | 30 + lib/importers/network_yaml.py | 746 ++++++++++++++++++ lib/seed/__init__.py | 1 + lib/seed/writers.py | 181 +++++ scripts/seed_demo.py | 553 +++++++++---- scripts/seed_network_overlay.py | 75 ++ .../supply_chain_network.example.yaml | 51 ++ tests/test_network_yaml.py | 120 +++ 8 files changed, 1591 insertions(+), 166 deletions(-) create mode 100644 lib/cli/seed_network_overlay.py create mode 100644 lib/importers/network_yaml.py create mode 100644 lib/seed/__init__.py create mode 100644 lib/seed/writers.py create mode 100644 scripts/seed_network_overlay.py create mode 100644 tests/fixtures/supply_chain_network.example.yaml create mode 100644 tests/test_network_yaml.py diff --git a/lib/cli/seed_network_overlay.py b/lib/cli/seed_network_overlay.py new file mode 100644 index 0000000..37b57ab --- /dev/null +++ b/lib/cli/seed_network_overlay.py @@ -0,0 +1,30 @@ +"""CLI entry point for YAML network overlay seeding.""" +from __future__ import annotations + +import runpy +import sys +from pathlib import Path + + +def _seed_script_path() -> Path: + candidates = [ + Path("/app/scripts/seed_network_overlay.py"), + ] + for parent in Path(__file__).resolve().parents: + candidates.append(parent / "scripts" / "seed_network_overlay.py") + for path in candidates: + if path.is_file(): + return path + raise SystemExit("seed script not found: scripts/seed_network_overlay.py") + + +def main() -> None: + path = _seed_script_path() + root = path.parent.parent + if str(root) not in sys.path: + sys.path.insert(0, str(root)) + runpy.run_path(str(path), run_name="__main__") + + +if __name__ == "__main__": + main() diff --git a/lib/importers/network_yaml.py b/lib/importers/network_yaml.py new file mode 100644 index 0000000..e48f00b --- /dev/null +++ b/lib/importers/network_yaml.py @@ -0,0 +1,746 @@ +"""Parse and compile domain-friendly supply-chain network YAML manifests.""" +from __future__ import annotations + +from dataclasses import dataclass, field +from datetime import datetime, timezone +from pathlib import Path +from typing import Any + +import yaml + +from lib.core.ingestion import CanonicalEntity +from lib.graph.nodes import EDGE_CARRIES, EDGE_DEPENDS_ON +from lib.importers.models import ImportIssue + +_SUPPORTED_VERSIONS = frozenset({"1"}) +_ENTITY_SECTIONS = ( + "airports", + "ports", + "warehouses", + "flights", + "vessels", + "cargo", + "inventory_skus", +) + + +@dataclass +class Neo4jEntityWrite: + """Rich Entity node properties for Neo4j MERGE (mirrors seed_demo.py).""" + + id: str + type: str + props: dict[str, Any] = field(default_factory=dict) + + +@dataclass +class NetworkSeedBundle: + entities: list[CanonicalEntity] = field(default_factory=list) + neo4j_entities: list[Neo4jEntityWrite] = field(default_factory=list) + carries_edges: list[tuple[str, str]] = field(default_factory=list) + dependency_edges: list[tuple[str, str, str]] = field(default_factory=list) + scenarios: list[dict[str, Any]] = field(default_factory=list) + issues: list[ImportIssue] = field(default_factory=list) + dataset_id: str | None = None + + @property + def error_count(self) -> int: + return sum(1 for i in self.issues if i.level == "error") + + @property + def ok(self) -> bool: + return self.error_count == 0 and bool( + self.entities or self.dependency_edges or self.scenarios + ) + + +def load_network_yaml(path: Path | str) -> dict[str, Any]: + """Load and return parsed YAML; raises on missing file or invalid YAML.""" + file_path = Path(path) + if not file_path.is_file(): + raise FileNotFoundError(f"Network YAML not found: {file_path}") + raw = yaml.safe_load(file_path.read_text(encoding="utf-8")) + if not isinstance(raw, dict): + raise ValueError("Network YAML root must be a mapping") + version = str(raw.get("version", "")).strip() + if version not in _SUPPORTED_VERSIONS: + raise ValueError( + f"Unsupported network YAML version {version!r}; " + f"expected one of {sorted(_SUPPORTED_VERSIONS)}" + ) + return raw + + +def compile_network_yaml(raw: dict[str, Any]) -> NetworkSeedBundle: + """Compile a parsed network manifest into entities and graph edges.""" + bundle = NetworkSeedBundle(dataset_id=raw.get("dataset_id")) + default_company_id = raw.get("company_id") + default_company_name = raw.get("company_name") + now = datetime.now(timezone.utc) + entity_ids: set[str] = set() + carrier_ids: set[str] = set() + warehouse_ids: set[str] = set() + sku_by_id: dict[str, dict[str, Any]] = {} + + for section in _ENTITY_SECTIONS: + rows = raw.get(section) or [] + if not isinstance(rows, list): + bundle.issues.append( + ImportIssue( + level="error", + message=f"Section {section!r} must be a list", + ) + ) + continue + for index, row in enumerate(rows, start=1): + if not isinstance(row, dict): + bundle.issues.append( + ImportIssue( + level="error", + message=f"{section}[{index}] must be an object", + row=index, + ) + ) + continue + _compile_row( + section=section, + row=row, + row_num=index, + now=now, + bundle=bundle, + entity_ids=entity_ids, + carrier_ids=carrier_ids, + warehouse_ids=warehouse_ids, + sku_by_id=sku_by_id, + dataset_id=bundle.dataset_id, + default_company_id=default_company_id, + default_company_name=default_company_name, + ) + + _apply_cargo_sku_links(raw.get("cargo") or [], sku_by_id, bundle) + _compile_dependencies(raw.get("dependencies") or [], bundle, entity_ids) + _compile_scenarios(raw.get("scenarios") or [], bundle) + validate_network_bundle(bundle) + return bundle + + +def validate_network_bundle(bundle: NetworkSeedBundle) -> NetworkSeedBundle: + """Append referential integrity issues to the bundle. + + Overlay imports may reference entities from a prior base seed; those + produce warnings rather than errors. + """ + entity_ids = {e.id for e in bundle.entities} + for index, (from_id, to_id, edge_type) in enumerate( + bundle.dependency_edges, start=1 + ): + if from_id not in entity_ids: + bundle.issues.append( + ImportIssue( + level="warning", + message=( + f"dependency from_id {from_id!r} not in this import " + f"(edge_type={edge_type}; may exist from base seed)" + ), + row=index, + ) + ) + if to_id not in entity_ids: + bundle.issues.append( + ImportIssue( + level="warning", + message=( + f"dependency to_id {to_id!r} not in this import " + f"(edge_type={edge_type}; may exist from base seed)" + ), + row=index, + ) + ) + + for index, (carrier_id, cargo_id) in enumerate(bundle.carries_edges, start=1): + if carrier_id not in entity_ids: + bundle.issues.append( + ImportIssue( + level="warning", + message=( + f"cargo carrier_id {carrier_id!r} not in this import " + "(may exist from base seed)" + ), + row=index, + ) + ) + if cargo_id not in entity_ids: + bundle.issues.append( + ImportIssue( + level="error", + message=f"cargo id {cargo_id!r} not found in this import", + row=index, + ) + ) + + for entity in bundle.entities: + if entity.type == "inventory_sku": + warehouse_id = entity.attributes.get("warehouse_id") + if warehouse_id and warehouse_id not in entity_ids: + bundle.issues.append( + ImportIssue( + level="warning", + message=( + f"SKU {entity.id!r} references warehouse_id " + f"{warehouse_id!r} not in this import " + "(may exist from base seed)" + ), + ) + ) + for carrier_id in entity.attributes.get("linked_carrier_ids") or []: + if carrier_id not in entity_ids: + bundle.issues.append( + ImportIssue( + level="warning", + message=( + f"SKU {entity.id!r} linked_carrier_ids " + f"references {carrier_id!r} not in this import " + "(may exist from base seed)" + ), + ) + ) + + return bundle + + +def _compile_row( + *, + section: str, + row: dict[str, Any], + row_num: int, + now: datetime, + bundle: NetworkSeedBundle, + entity_ids: set[str], + carrier_ids: set[str], + warehouse_ids: set[str], + sku_by_id: dict[str, dict[str, Any]], + dataset_id: str | None, + default_company_id: Any = None, + default_company_name: Any = None, +) -> None: + entity_id = _require_str(row, "id", section, row_num, bundle) + if not entity_id: + return + if entity_id in entity_ids: + bundle.issues.append( + ImportIssue( + level="error", + message=f"Duplicate entity id {entity_id!r}", + row=row_num, + ) + ) + return + + if section in {"airports", "ports", "warehouses"}: + _compile_facility( + section, row, entity_id, now, bundle, entity_ids, dataset_id + ) + if section == "warehouses": + warehouse_ids.add(entity_id) + return + + if section == "flights": + _compile_flight( + row, + entity_id, + now, + bundle, + entity_ids, + carrier_ids, + dataset_id, + default_company_id=default_company_id, + default_company_name=default_company_name, + ) + return + + if section == "vessels": + _compile_vessel(row, entity_id, now, bundle, entity_ids, carrier_ids, dataset_id) + return + + if section == "cargo": + _compile_cargo(row, entity_id, now, bundle, entity_ids, dataset_id) + return + + if section == "inventory_skus": + _compile_sku( + row, + entity_id, + now, + bundle, + entity_ids, + sku_by_id, + warehouse_ids, + dataset_id, + ) + + +def _compile_facility( + section: str, + row: dict[str, Any], + entity_id: str, + now: datetime, + bundle: NetworkSeedBundle, + entity_ids: set[str], + dataset_id: str | None, +) -> None: + name = _require_str(row, "name", section, 0, bundle) + lon = _require_float(row, "lon", section, 0, bundle) + lat = _require_float(row, "lat", section, 0, bundle) + if not name or lon is None or lat is None: + return + + facility_kind = { + "airports": "airport", + "ports": "port", + "warehouses": "warehouse", + }[section] + + attrs: dict[str, Any] = { + "name": name, + "facility_kind": facility_kind, + "source": "network_yaml", + } + if dataset_id: + attrs["dataset_id"] = dataset_id + for key in ( + "region", + "iata", + "icao", + "value_usd", + "throughput_teu_day", + "country", + ): + if key in row and row[key] is not None: + attrs[key] = row[key] + + entity = CanonicalEntity( + id=entity_id, + type="facility", + timestamp=now, + status=str(row.get("status") or "operational"), + geometry={"type": "Point", "coordinates": [lon, lat]}, + attributes=attrs, + ) + neo4j_props = { + "name": name, + "facility_kind": facility_kind, + "region": attrs.get("region"), + "value_usd": attrs.get("value_usd"), + } + bundle.entities.append(entity) + bundle.neo4j_entities.append( + Neo4jEntityWrite(id=entity_id, type="facility", props=neo4j_props) + ) + entity_ids.add(entity_id) + + +def _compile_flight( + row: dict[str, Any], + entity_id: str, + now: datetime, + bundle: NetworkSeedBundle, + entity_ids: set[str], + carrier_ids: set[str], + dataset_id: str | None, + *, + default_company_id: Any = None, + default_company_name: Any = None, +) -> None: + callsign = _require_str(row, "callsign", "flights", 0, bundle) + route = _require_str(row, "route", "flights", 0, bundle) + lon = _require_float(row, "lon", "flights", 0, bundle) + lat = _require_float(row, "lat", "flights", 0, bundle) + if not callsign or not route or lon is None or lat is None: + return + + attrs: dict[str, Any] = { + "call_sign": callsign, + "route": route, + "source": "network_yaml", + } + if dataset_id: + attrs["dataset_id"] = dataset_id + for key in ( + "origin", + "origin_country", + "revenue_usd", + "operating_cost_usd", + "depends_on_port", + "promised_delivery_utc", + "eta_utc", + ): + if key in row and row[key] is not None: + mapped = "origin_country" if key == "origin" else key + attrs[mapped] = row[key] + + company_id = row.get("company_id") or default_company_id + company_name = row.get("company_name") or default_company_name + if company_id not in (None, ""): + attrs["company_id"] = str(company_id) + if company_name not in (None, ""): + attrs["company_name"] = str(company_name) + + entity = CanonicalEntity( + id=entity_id, + type="moving_entity", + timestamp=now, + status=str(row.get("status") or "airborne"), + geometry={"type": "Point", "coordinates": [lon, lat]}, + attributes=attrs, + ) + neo4j_props = { + "callsign": callsign, + "origin": attrs.get("origin_country") or attrs.get("origin"), + "route": route, + "revenue_usd": attrs.get("revenue_usd"), + "depends_on_port": attrs.get("depends_on_port"), + "company_id": attrs.get("company_id"), + "company_name": attrs.get("company_name"), + } + bundle.entities.append(entity) + bundle.neo4j_entities.append( + Neo4jEntityWrite(id=entity_id, type="moving_entity", props=neo4j_props) + ) + entity_ids.add(entity_id) + carrier_ids.add(entity_id) + + +def _compile_vessel( + row: dict[str, Any], + entity_id: str, + now: datetime, + bundle: NetworkSeedBundle, + entity_ids: set[str], + carrier_ids: set[str], + dataset_id: str | None, +) -> None: + name = _require_str(row, "name", "vessels", 0, bundle) + route = _require_str(row, "route", "vessels", 0, bundle) + lon = _require_float(row, "lon", "vessels", 0, bundle) + lat = _require_float(row, "lat", "vessels", 0, bundle) + if not name or not route or lon is None or lat is None: + return + + attrs: dict[str, Any] = { + "name": name, + "route": route, + "source": "network_yaml", + } + if dataset_id: + attrs["dataset_id"] = dataset_id + for key in ( + "revenue_usd", + "depends_on_port", + "promised_delivery_utc", + "eta_utc", + ): + if key in row and row[key] is not None: + attrs[key] = row[key] + + entity = CanonicalEntity( + id=entity_id, + type="moving_entity", + timestamp=now, + status=str(row.get("status") or "in_transit"), + geometry={"type": "Point", "coordinates": [lon, lat]}, + attributes=attrs, + ) + neo4j_props = { + "name": name, + "route": route, + "revenue_usd": attrs.get("revenue_usd"), + "depends_on_port": attrs.get("depends_on_port"), + } + bundle.entities.append(entity) + bundle.neo4j_entities.append( + Neo4jEntityWrite(id=entity_id, type="moving_entity", props=neo4j_props) + ) + entity_ids.add(entity_id) + carrier_ids.add(entity_id) + + +def _compile_cargo( + row: dict[str, Any], + entity_id: str, + now: datetime, + bundle: NetworkSeedBundle, + entity_ids: set[str], + dataset_id: str | None, +) -> None: + carrier_id = _require_str(row, "carrier_id", "cargo", 0, bundle) + commodity = _require_str(row, "commodity", "cargo", 0, bundle) + quantity = _require_float(row, "quantity", "cargo", 0, bundle) + unit_price = _require_float(row, "unit_price_usd", "cargo", 0, bundle) + if not carrier_id or not commodity or quantity is None or unit_price is None: + return + + value_usd = float(quantity) * float(unit_price) + attrs: dict[str, Any] = { + "commodity": commodity, + "quantity": quantity, + "unit_price_usd": unit_price, + "value_usd": value_usd, + "carrier_id": carrier_id, + "source": "network_yaml", + } + if dataset_id: + attrs["dataset_id"] = dataset_id + if row.get("sku_ref"): + attrs["sku_ref"] = row["sku_ref"] + + entity = CanonicalEntity( + id=entity_id, + type="cargo_item", + timestamp=now, + status=str(row.get("status") or "in_transit"), + geometry=None, + attributes=attrs, + ) + neo4j_props = { + "commodity": commodity, + "quantity": quantity, + "unit_price_usd": unit_price, + "value_usd": value_usd, + "carrier_id": carrier_id, + } + bundle.entities.append(entity) + bundle.neo4j_entities.append( + Neo4jEntityWrite(id=entity_id, type="cargo_item", props=neo4j_props) + ) + bundle.carries_edges.append((carrier_id, entity_id)) + entity_ids.add(entity_id) + + +def _compile_sku( + row: dict[str, Any], + entity_id: str, + now: datetime, + bundle: NetworkSeedBundle, + entity_ids: set[str], + sku_by_id: dict[str, dict[str, Any]], + warehouse_ids: set[str], + dataset_id: str | None, +) -> None: + sku = _require_str(row, "sku", "inventory_skus", 0, bundle) + warehouse_id = _require_str(row, "warehouse_id", "inventory_skus", 0, bundle) + on_hand_qty = _require_float(row, "on_hand_qty", "inventory_skus", 0, bundle) + unit_price = _require_float(row, "unit_price_usd", "inventory_skus", 0, bundle) + if not sku or not warehouse_id or on_hand_qty is None or unit_price is None: + return + + linked = list(row.get("linked_carrier_ids") or []) + value_usd = float(on_hand_qty) * float(unit_price) + attrs: dict[str, Any] = { + "sku": sku, + "warehouse_id": warehouse_id, + "on_hand_qty": on_hand_qty, + "quantity": on_hand_qty, + "unit_price_usd": unit_price, + "value_usd": value_usd, + "linked_carrier_ids": linked, + "source": "network_yaml", + } + if dataset_id: + attrs["dataset_id"] = dataset_id + for key in ( + "commodity", + "safety_stock", + "reorder_point", + "avg_daily_sales_30d", + ): + if key in row and row[key] is not None: + attrs[key] = row[key] + + entity = CanonicalEntity( + id=entity_id, + type="inventory_sku", + timestamp=now, + status=str(row.get("status") or "in_stock"), + geometry=None, + attributes=attrs, + ) + neo4j_props = { + "sku": sku, + "commodity": attrs.get("commodity"), + "warehouse_id": warehouse_id, + "on_hand_qty": on_hand_qty, + "safety_stock": attrs.get("safety_stock"), + "reorder_point": attrs.get("reorder_point"), + "unit_price_usd": unit_price, + "avg_daily_sales_30d": attrs.get("avg_daily_sales_30d"), + } + bundle.entities.append(entity) + bundle.neo4j_entities.append( + Neo4jEntityWrite(id=entity_id, type="inventory_sku", props=neo4j_props) + ) + bundle.dependency_edges.append((entity_id, warehouse_id, EDGE_DEPENDS_ON)) + entity_ids.add(entity_id) + warehouse_ids.add(warehouse_id) + sku_by_id[entity_id] = row + + +def _apply_cargo_sku_links( + cargo_rows: list[Any], + sku_by_id: dict[str, dict[str, Any]], + bundle: NetworkSeedBundle, +) -> None: + """Auto-link cargo sku_ref to linked_carrier_ids on matching SKUs.""" + if not isinstance(cargo_rows, list): + return + for row in cargo_rows: + if not isinstance(row, dict): + continue + sku_ref = row.get("sku_ref") + carrier_id = row.get("carrier_id") + if not sku_ref or not carrier_id: + continue + for entity in bundle.entities: + if entity.id != sku_ref or entity.type != "inventory_sku": + continue + linked = list(entity.attributes.get("linked_carrier_ids") or []) + if carrier_id not in linked: + linked.append(carrier_id) + entity.attributes["linked_carrier_ids"] = linked + break + else: + bundle.issues.append( + ImportIssue( + level="error", + message=( + f"cargo sku_ref {sku_ref!r} does not match " + "any inventory_skus id in this import" + ), + ) + ) + + +def _compile_dependencies( + rows: list[Any], + bundle: NetworkSeedBundle, + entity_ids: set[str], +) -> None: + if not isinstance(rows, list): + bundle.issues.append( + ImportIssue(level="error", message="dependencies must be a list") + ) + return + for index, row in enumerate(rows, start=1): + if not isinstance(row, dict): + bundle.issues.append( + ImportIssue( + level="error", + message=f"dependencies[{index}] must be an object", + row=index, + ) + ) + continue + from_id = row.get("from") or row.get("from_id") + to_id = row.get("to") or row.get("to_id") + if not from_id or not to_id: + bundle.issues.append( + ImportIssue( + level="error", + message=f"dependencies[{index}] requires from and to", + row=index, + ) + ) + continue + edge_type = str(row.get("edge_type") or EDGE_DEPENDS_ON).strip().upper() + bundle.dependency_edges.append((str(from_id), str(to_id), edge_type)) + + +def _compile_scenarios(rows: list[Any], bundle: NetworkSeedBundle) -> None: + if not isinstance(rows, list): + bundle.issues.append( + ImportIssue(level="error", message="scenarios must be a list") + ) + return + for index, row in enumerate(rows, start=1): + if not isinstance(row, dict): + bundle.issues.append( + ImportIssue( + level="error", + message=f"scenarios[{index}] must be an object", + row=index, + ) + ) + continue + scenario_id = row.get("scenario_id") + event_id = row.get("event_id") + bbox = row.get("bbox") + description = row.get("description") + if not scenario_id or not event_id or not bbox or not description: + bundle.issues.append( + ImportIssue( + level="error", + message=( + f"scenarios[{index}] requires scenario_id, event_id, " + "bbox, description" + ), + row=index, + ) + ) + continue + bundle.scenarios.append( + { + "scenario_id": str(scenario_id), + "event_id": str(event_id), + "bbox": str(bbox), + "description": str(description), + } + ) + + +def _require_str( + row: dict[str, Any], + key: str, + section: str, + row_num: int, + bundle: NetworkSeedBundle, +) -> str | None: + value = row.get(key) + if value is None or str(value).strip() == "": + bundle.issues.append( + ImportIssue( + level="error", + message=f"{section} missing required field {key!r}", + row=row_num or None, + ) + ) + return None + return str(value).strip() + + +def _require_float( + row: dict[str, Any], + key: str, + section: str, + row_num: int, + bundle: NetworkSeedBundle, +) -> float | None: + value = row.get(key) + if value is None or str(value).strip() == "": + bundle.issues.append( + ImportIssue( + level="error", + message=f"{section} missing required field {key!r}", + row=row_num or None, + ) + ) + return None + try: + return float(value) + except (TypeError, ValueError): + bundle.issues.append( + ImportIssue( + level="error", + message=f"{section}.{key} must be numeric", + row=row_num or None, + ) + ) + return None diff --git a/lib/seed/__init__.py b/lib/seed/__init__.py new file mode 100644 index 0000000..372722d --- /dev/null +++ b/lib/seed/__init__.py @@ -0,0 +1 @@ +"""Shared seed helpers for demo and YAML overlay scripts.""" diff --git a/lib/seed/writers.py b/lib/seed/writers.py new file mode 100644 index 0000000..091bb5e --- /dev/null +++ b/lib/seed/writers.py @@ -0,0 +1,181 @@ +"""Shared Postgres + Neo4j writers for demo and YAML overlay seeding.""" +from __future__ import annotations + +import logging +from typing import Any + +import asyncpg +from neo4j import AsyncDriver, AsyncGraphDatabase + +from lib.core.config import Settings +from lib.core.db import create_pool +from lib.core.ingestion import CanonicalEntity +from lib.graph.nodes import EDGE_CARRIES, merge_dependency_edges +from lib.graph.spatial_overlay import sync_event_affected_from_bbox +from lib.importers.network_yaml import Neo4jEntityWrite, NetworkSeedBundle +from lib.ingestion.runner import _insert_state, _upsert_entity + +logger = logging.getLogger(__name__) + + +async def upsert_entities_to_postgres( + settings: Settings, + entities: list[CanonicalEntity], +) -> None: + """Upsert canonical entities into PostGIS live store.""" + if not entities: + logger.info("No entities to upsert into Postgres.") + return + + pool = await create_pool(settings) + try: + async with pool.acquire() as conn: + async with conn.transaction(): + for entity in entities: + await _upsert_entity(conn, entity) + await _insert_state(conn, entity) + logger.info(" ✓ Postgres %s (%s)", entity.id, entity.type) + finally: + await pool.close() + logger.info("Postgres upsert complete: %d entities", len(entities)) + + +async def write_network_bundle_to_neo4j( + settings: Settings, + bundle: NetworkSeedBundle, +) -> None: + """MERGE rich Entity nodes, CARRIES, and dependency edges from a bundle.""" + if not bundle.neo4j_entities and not bundle.dependency_edges: + logger.info("No Neo4j graph updates in bundle.") + return + + driver = AsyncGraphDatabase.driver( + settings.neo4j_uri, + auth=(settings.neo4j_user, settings.neo4j_password), + ) + try: + async with driver.session(database="neo4j") as session: + for node in bundle.neo4j_entities: + await _merge_entity_with_props(session, node) + + for carrier_id, cargo_id in bundle.carries_edges: + await session.run( + "MATCH (carrier:Entity {id: $carrier_id}), " + " (cargo:Entity {id: $cargo_id}) " + f"MERGE (carrier)-[:{EDGE_CARRIES}]->(cargo)", + carrier_id=carrier_id, + cargo_id=cargo_id, + ) + logger.info(" ✓ %s -[%s]-> %s", carrier_id, EDGE_CARRIES, cargo_id) + + if bundle.dependency_edges: + edges = [ + {"from_id": f, "to_id": t, "edge_type": e} + for f, t, e in bundle.dependency_edges + ] + merged = await merge_dependency_edges(driver, edges) + logger.info("Dependency edges merged: %d", merged) + finally: + await driver.close() + + +async def inject_scenarios( + settings: Settings, + scenarios: list[dict[str, Any]], +) -> None: + """MERGE SimulationEvent overlay nodes.""" + if not scenarios: + return + + driver = AsyncGraphDatabase.driver( + settings.neo4j_uri, + auth=(settings.neo4j_user, settings.neo4j_password), + ) + try: + async with driver.session(database="neo4j") as session: + for scenario in scenarios: + await session.run( + "MERGE (e:SimulationEvent {id: $id}) " + "SET e.scenario_id = $scenario_id, " + " e.description = $description, " + " e.affect_bbox = $bbox", + id=scenario["event_id"], + scenario_id=scenario["scenario_id"], + description=str(scenario["description"])[:200], + bbox=scenario["bbox"], + ) + logger.info( + " ✓ SimulationEvent %s (%s)", + scenario["event_id"], + scenario["scenario_id"], + ) + finally: + await driver.close() + + +async def sync_scenario_overlays( + settings: Settings, + scenarios: list[dict[str, Any]], +) -> None: + """Wire AFFECTED_BY from PostGIS bbox for each scenario event.""" + if not scenarios: + return + + pool = await create_pool(settings) + driver = AsyncGraphDatabase.driver( + settings.neo4j_uri, + auth=(settings.neo4j_user, settings.neo4j_password), + ) + try: + for scenario in scenarios: + affected = await sync_event_affected_from_bbox( + driver, + pool, + event_id=scenario["event_id"], + bbox=scenario["bbox"], + ) + logger.info( + "Spatial overlay synced: %d entities in scenario %s", + len(affected), + scenario["scenario_id"], + ) + finally: + await driver.close() + await pool.close() + + +async def write_network_overlay( + settings: Settings, + bundle: NetworkSeedBundle, +) -> None: + """Full overlay write: Postgres, Neo4j graph, scenarios, spatial sync.""" + if not bundle.ok: + errors = [i.message for i in bundle.issues if i.level == "error"] + raise ValueError( + f"Cannot commit network overlay with {bundle.error_count} error(s): " + + "; ".join(errors[:5]) + ) + + await upsert_entities_to_postgres(settings, bundle.entities) + await write_network_bundle_to_neo4j(settings, bundle) + await inject_scenarios(settings, bundle.scenarios) + await sync_scenario_overlays(settings, bundle.scenarios) + + +async def _merge_entity_with_props(session: Any, node: Neo4jEntityWrite) -> None: + """MERGE an Entity node and SET type + non-null props.""" + props = {k: v for k, v in node.props.items() if v is not None} + set_clauses = ["n.type = $type"] + params: dict[str, Any] = {"id": node.id, "type": node.type} + for index, (key, value) in enumerate(props.items()): + param = f"p{index}" + set_clauses.append(f"n.{key} = ${param}") + params[param] = value + + query = ( + "MERGE (n:Entity {id: $id}) " + f"SET {', '.join(set_clauses)} " + "RETURN id(n)" + ) + await session.run(query, **params) + logger.info(" ✓ Neo4j %s (%s)", node.id, node.type) diff --git a/scripts/seed_demo.py b/scripts/seed_demo.py index 1f8ebc8..a581b2e 100644 --- a/scripts/seed_demo.py +++ b/scripts/seed_demo.py @@ -27,11 +27,14 @@ from neo4j import AsyncGraphDatabase from lib.core.config import Settings -from lib.core.db import create_pool from lib.core.ingestion import CanonicalEntity from lib.graph.nodes import EDGE_CARRIES from lib.graph.spatial_overlay import UK_AIRSPACE_BBOX, format_bbox -from lib.ingestion.runner import _insert_state, _upsert_entity +from lib.seed.writers import ( + inject_scenarios, + sync_scenario_overlays, + upsert_entities_to_postgres, +) logging.basicConfig(level=logging.INFO, format="%(levelname)s — %(message)s") logger = logging.getLogger(__name__) @@ -52,6 +55,8 @@ "lon": -0.55, "lat": 51.48, "revenue_usd": 620_000.0, + "promised_delivery_utc": "2026-09-16T14:00:00Z", + "eta_utc": "2026-09-16T13:30:00Z", }, { "id": "opensky-3c6444", @@ -102,6 +107,8 @@ "lon": -0.70, "lat": 51.55, "revenue_usd": 580_000.0, + "promised_delivery_utc": "2026-09-16T16:00:00Z", + "eta_utc": "2026-09-16T17:00:00Z", }, { "id": "opensky-40617d", @@ -288,6 +295,8 @@ "lat": 32.8, "revenue_usd": 890_000.0, "depends_on_port": "port-los-angeles", + "promised_delivery_utc": "2026-09-18T12:00:00Z", + "eta_utc": "2026-09-18T10:00:00Z", }, { "id": "vessel-westbound-express", @@ -298,6 +307,8 @@ "lat": 31.5, "revenue_usd": 720_000.0, "depends_on_port": "port-long-beach", + "promised_delivery_utc": "2026-09-19T08:00:00Z", + "eta_utc": "2026-09-19T09:30:00Z", }, { "id": "vessel-red-sea-carrier", @@ -308,6 +319,8 @@ "lat": 28.8, "revenue_usd": 1_450_000.0, "depends_on_port": "port-suez", + "promised_delivery_utc": "2026-09-22T06:00:00Z", + "eta_utc": "2026-09-22T06:00:00Z", }, { "id": "vessel-med-link", @@ -318,6 +331,228 @@ "lat": 30.1, "revenue_usd": 980_000.0, "depends_on_port": "port-suez", + "promised_delivery_utc": "2026-09-21T18:00:00Z", + "eta_utc": "2026-09-24T12:00:00Z", + }, +] + +# Warehouse SKU inventory for KPI demos (no geometry — queried via /admin/entities). +INVENTORY_SKUS: list[dict] = [ + { + "id": "sku-elec-8842", + "sku": "ELEC-8842", + "commodity": "electronics", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 420, + "safety_stock": 50, + "reorder_point": 80, + "unit_price_usd": 1200.0, + "avg_daily_sales_30d": 12.5, + "linked_carrier_ids": ["vessel-pacific-star", "opensky-a4e301"], + }, + { + "id": "sku-auto-2201", + "sku": "AUTO-2201", + "commodity": "automotive_parts", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 180, + "safety_stock": 40, + "reorder_point": 60, + "unit_price_usd": 850.0, + "avg_daily_sales_30d": 8.0, + "linked_carrier_ids": ["vessel-pacific-star"], + }, + { + "id": "sku-app-5510", + "sku": "APP-5510", + "commodity": "apparel", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 920, + "safety_stock": 120, + "reorder_point": 200, + "unit_price_usd": 85.0, + "avg_daily_sales_30d": 45.0, + "linked_carrier_ids": ["vessel-westbound-express"], + }, + { + "id": "sku-pharma-102", + "sku": "PHARMA-102", + "commodity": "pharmaceuticals", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 65, + "safety_stock": 30, + "reorder_point": 35, + "unit_price_usd": 8500.0, + "avg_daily_sales_30d": 2.1, + "linked_carrier_ids": ["opensky-407290", "opensky-a4e301"], + }, + { + "id": "sku-home-3300", + "sku": "HOME-3300", + "commodity": "home_goods", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 310, + "safety_stock": 60, + "reorder_point": 90, + "unit_price_usd": 220.0, + "avg_daily_sales_30d": 18.0, + "linked_carrier_ids": ["opensky-a19ce0"], + }, + { + "id": "sku-perish-771", + "sku": "PERISH-771", + "commodity": "perishables", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 42, + "safety_stock": 25, + "reorder_point": 30, + "unit_price_usd": 950.0, + "avg_daily_sales_30d": 6.5, + "linked_carrier_ids": ["opensky-a19ce0", "vessel-westbound-express"], + }, + { + "id": "sku-semi-9001", + "sku": "SEMI-9001", + "commodity": "semiconductors", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 28, + "safety_stock": 15, + "reorder_point": 18, + "unit_price_usd": 9800.0, + "avg_daily_sales_30d": 1.2, + "linked_carrier_ids": ["vessel-pacific-star"], + }, + { + "id": "sku-wine-204", + "sku": "WINE-204", + "commodity": "wine", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 540, + "safety_stock": 80, + "reorder_point": 120, + "unit_price_usd": 160.0, + "avg_daily_sales_30d": 22.0, + "linked_carrier_ids": ["vessel-westbound-express"], + }, + { + "id": "sku-eu-elec-441", + "sku": "EU-ELEC-441", + "commodity": "electronics", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 260, + "safety_stock": 45, + "reorder_point": 70, + "unit_price_usd": 1400.0, + "avg_daily_sales_30d": 9.5, + "linked_carrier_ids": ["vessel-red-sea-carrier", "opensky-75804b"], + }, + { + "id": "sku-eu-auto-118", + "sku": "EU-AUTO-118", + "commodity": "automotive_parts", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 140, + "safety_stock": 35, + "reorder_point": 50, + "unit_price_usd": 2100.0, + "avg_daily_sales_30d": 5.8, + "linked_carrier_ids": ["vessel-red-sea-carrier"], + }, + { + "id": "sku-eu-pharma-55", + "sku": "EU-PHARMA-55", + "commodity": "pharmaceuticals", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 38, + "safety_stock": 20, + "reorder_point": 22, + "unit_price_usd": 9200.0, + "avg_daily_sales_30d": 1.4, + "linked_carrier_ids": ["vessel-med-link", "opensky-8961e2"], + }, + { + "id": "sku-eu-lux-88", + "sku": "EU-LUX-88", + "commodity": "luxury_goods", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 72, + "safety_stock": 18, + "reorder_point": 25, + "unit_price_usd": 5600.0, + "avg_daily_sales_30d": 2.8, + "linked_carrier_ids": ["opensky-75804b"], + }, + { + "id": "sku-eu-chem-12", + "sku": "EU-CHEM-12", + "commodity": "industrial_chemicals", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 190, + "safety_stock": 50, + "reorder_point": 65, + "unit_price_usd": 750.0, + "avg_daily_sales_30d": 7.2, + "linked_carrier_ids": ["vessel-med-link"], + }, + { + "id": "sku-uk-pharma-7", + "sku": "UK-PHARMA-7", + "commodity": "pharmaceuticals", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 55, + "safety_stock": 25, + "reorder_point": 30, + "unit_price_usd": 7800.0, + "avg_daily_sales_30d": 1.8, + "linked_carrier_ids": ["opensky-407290", "opensky-471f52"], + }, + { + "id": "sku-uk-app-19", + "sku": "UK-APP-19", + "commodity": "apparel", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 480, + "safety_stock": 90, + "reorder_point": 130, + "unit_price_usd": 95.0, + "avg_daily_sales_30d": 28.0, + "linked_carrier_ids": ["opensky-484161"], + }, + { + "id": "sku-uk-elec-3", + "sku": "UK-ELEC-3", + "commodity": "electronics", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 115, + "safety_stock": 30, + "reorder_point": 40, + "unit_price_usd": 1100.0, + "avg_daily_sales_30d": 6.2, + "linked_carrier_ids": ["opensky-3c6444", "opensky-4ca87e"], + }, + { + "id": "sku-uk-med-44", + "sku": "UK-MED-44", + "commodity": "medical_devices", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 24, + "safety_stock": 12, + "reorder_point": 14, + "unit_price_usd": 15000.0, + "avg_daily_sales_30d": 0.9, + "linked_carrier_ids": ["opensky-4ca87e"], + }, + { + "id": "sku-uk-wine-8", + "sku": "UK-WINE-8", + "commodity": "wine", + "warehouse_id": "port-rotterdam", + "on_hand_qty": 360, + "safety_stock": 70, + "reorder_point": 95, + "unit_price_usd": 170.0, + "avg_daily_sales_30d": 15.0, + "linked_carrier_ids": ["opensky-40617d"], }, ] @@ -333,6 +568,8 @@ "lat": 33.95, "revenue_usd": 410_000.0, "depends_on_port": "port-los-angeles", + "promised_delivery_utc": "2026-09-17T10:00:00Z", + "eta_utc": "2026-09-17T09:00:00Z", }, { "id": "opensky-a19ce0", @@ -344,6 +581,8 @@ "lat": 33.82, "revenue_usd": 365_000.0, "depends_on_port": "port-long-beach", + "promised_delivery_utc": "2026-09-17T12:00:00Z", + "eta_utc": "2026-09-17T14:00:00Z", }, { "id": "opensky-8961e2", @@ -516,6 +755,8 @@ ("opensky-a19ce0", "warehouse-inland-empire"), ] +SKU_DEPENDENCIES = [(sku["id"], sku["warehouse_id"]) for sku in INVENTORY_SKUS] + # Scenario IDs match ai-supply-chain-agent frontend presets # (Port Strike LA, Suez Blockage, Trigger World Event / UK closure). SCENARIOS = [ @@ -565,133 +806,134 @@ EVENT_DESCRIPTION = SCENARIOS[0]["description"] +def _build_demo_entities(now: datetime) -> list[CanonicalEntity]: + """Build CanonicalEntity records for the full demo dataset.""" + all_aircraft = AIRCRAFT + CORRIDOR_AIRCRAFT + all_cargo = CARGO + MARITIME_CARGO + CORRIDOR_CARGO + entities: list[CanonicalEntity] = [] + + for ac in all_aircraft: + attrs = { + "call_sign": ac["callsign"], + "origin_country": ac["origin"], + "route": ac["route"], + "revenue_usd": ac["revenue_usd"], + } + if ac.get("depends_on_port"): + attrs["depends_on_port"] = ac["depends_on_port"] + if ac.get("promised_delivery_utc"): + attrs["promised_delivery_utc"] = ac["promised_delivery_utc"] + if ac.get("eta_utc"): + attrs["eta_utc"] = ac["eta_utc"] + entities.append( + CanonicalEntity( + id=ac["id"], + type="moving_entity", + timestamp=now, + status=ac["status"], + geometry={"type": "Point", "coordinates": [ac["lon"], ac["lat"]]}, + attributes=attrs, + ) + ) + + for facility in FACILITIES: + entities.append( + CanonicalEntity( + id=facility["id"], + type="facility", + timestamp=now, + status="operational", + geometry={ + "type": "Point", + "coordinates": [facility["lon"], facility["lat"]], + }, + attributes={ + "name": facility["name"], + "region": facility["region"], + "value_usd": facility["value_usd"], + }, + ) + ) + + for vessel in VESSELS: + entities.append( + CanonicalEntity( + id=vessel["id"], + type="moving_entity", + timestamp=now, + status=vessel["status"], + geometry={ + "type": "Point", + "coordinates": [vessel["lon"], vessel["lat"]], + }, + attributes={ + "name": vessel["name"], + "route": vessel["route"], + "revenue_usd": vessel["revenue_usd"], + "depends_on_port": vessel["depends_on_port"], + "promised_delivery_utc": vessel.get("promised_delivery_utc"), + "eta_utc": vessel.get("eta_utc"), + }, + ) + ) + + for item in all_cargo: + entities.append( + CanonicalEntity( + id=item["id"], + type="cargo_item", + timestamp=now, + status="in_transit", + geometry=None, + attributes={ + "commodity": item["commodity"], + "quantity": item["quantity"], + "unit_price_usd": item["unit_price_usd"], + "value_usd": item["value_usd"], + "carrier_id": item["carrier_id"], + }, + ) + ) + + for sku in INVENTORY_SKUS: + entities.append( + CanonicalEntity( + id=sku["id"], + type="inventory_sku", + timestamp=now, + status="in_stock", + geometry=None, + attributes={ + "sku": sku["sku"], + "commodity": sku["commodity"], + "warehouse_id": sku["warehouse_id"], + "on_hand_qty": sku["on_hand_qty"], + "safety_stock": sku["safety_stock"], + "reorder_point": sku["reorder_point"], + "unit_price_usd": sku["unit_price_usd"], + "avg_daily_sales_30d": sku["avg_daily_sales_30d"], + "linked_carrier_ids": sku["linked_carrier_ids"], + }, + ) + ) + + return entities + + async def _seed_postgres(settings: Settings) -> None: """Upsert demo aircraft, facilities, vessels, and cargo into PostGIS live store.""" all_aircraft = AIRCRAFT + CORRIDOR_AIRCRAFT all_cargo = CARGO + MARITIME_CARGO + CORRIDOR_CARGO logger.info( - "Upserting %d aircraft + %d facilities + %d vessels + %d cargo into Postgres …", + "Upserting %d aircraft + %d facilities + %d vessels + %d cargo + %d SKUs into Postgres …", len(all_aircraft), len(FACILITIES), len(VESSELS), len(all_cargo), + len(INVENTORY_SKUS), ) - pool = await create_pool(settings) now = datetime.now(tz=timezone.utc) - try: - async with pool.acquire() as conn: - async with conn.transaction(): - for ac in all_aircraft: - attrs = { - "call_sign": ac["callsign"], - "origin_country": ac["origin"], - "route": ac["route"], - "revenue_usd": ac["revenue_usd"], - } - if ac.get("depends_on_port"): - attrs["depends_on_port"] = ac["depends_on_port"] - entity = CanonicalEntity( - id=ac["id"], - type="moving_entity", - timestamp=now, - status=ac["status"], - geometry={ - "type": "Point", - "coordinates": [ac["lon"], ac["lat"]], - }, - attributes=attrs, - ) - await _upsert_entity(conn, entity) - await _insert_state(conn, entity) - logger.info( - " ✓ %s (%s) @ %.2f,%.2f revenue=$%.0f", - ac["id"], - ac["callsign"], - ac["lon"], - ac["lat"], - ac["revenue_usd"], - ) - - for facility in FACILITIES: - entity = CanonicalEntity( - id=facility["id"], - type="facility", - timestamp=now, - status="operational", - geometry={ - "type": "Point", - "coordinates": [facility["lon"], facility["lat"]], - }, - attributes={ - "name": facility["name"], - "region": facility["region"], - "value_usd": facility["value_usd"], - }, - ) - await _upsert_entity(conn, entity) - await _insert_state(conn, entity) - logger.info( - " ✓ %s (%s) value=$%.0f", - facility["id"], - facility["name"], - facility["value_usd"], - ) - - for vessel in VESSELS: - entity = CanonicalEntity( - id=vessel["id"], - type="moving_entity", - timestamp=now, - status=vessel["status"], - geometry={ - "type": "Point", - "coordinates": [vessel["lon"], vessel["lat"]], - }, - attributes={ - "name": vessel["name"], - "route": vessel["route"], - "revenue_usd": vessel["revenue_usd"], - "depends_on_port": vessel["depends_on_port"], - }, - ) - await _upsert_entity(conn, entity) - await _insert_state(conn, entity) - logger.info( - " ✓ %s (%s) @ %.2f,%.2f revenue=$%.0f", - vessel["id"], - vessel["name"], - vessel["lon"], - vessel["lat"], - vessel["revenue_usd"], - ) - - for item in all_cargo: - entity = CanonicalEntity( - id=item["id"], - type="cargo_item", - timestamp=now, - status="in_transit", - geometry=None, - attributes={ - "commodity": item["commodity"], - "quantity": item["quantity"], - "unit_price_usd": item["unit_price_usd"], - "value_usd": item["value_usd"], - "carrier_id": item["carrier_id"], - }, - ) - await _upsert_entity(conn, entity) - await _insert_state(conn, entity) - logger.info( - " ✓ %s (%s) value=$%.0f on %s", - item["id"], - item["commodity"], - item["value_usd"], - item["carrier_id"], - ) - finally: - await pool.close() - logger.info("Postgres seed complete.") + await upsert_entities_to_postgres(settings, _build_demo_entities(now)) async def _seed_neo4j(settings: Settings) -> None: @@ -783,8 +1025,31 @@ async def _seed_neo4j(settings: Settings) -> None: item["id"], ) - logger.info("Wiring %d dependency edges …", len(DEPENDENCIES)) - for from_id, to_id in DEPENDENCIES: + logger.info("Creating %d inventory SKU Entity nodes …", len(INVENTORY_SKUS)) + for sku in INVENTORY_SKUS: + await session.run( + "MERGE (n:Entity {id: $id}) " + "SET n.type = $type, n.sku = $sku, n.commodity = $commodity, " + " n.warehouse_id = $warehouse_id, n.on_hand_qty = $on_hand_qty, " + " n.safety_stock = $safety_stock, n.reorder_point = $reorder_point, " + " n.unit_price_usd = $unit_price_usd, " + " n.avg_daily_sales_30d = $avg_daily_sales_30d", + id=sku["id"], + type="inventory_sku", + sku=sku["sku"], + commodity=sku["commodity"], + warehouse_id=sku["warehouse_id"], + on_hand_qty=sku["on_hand_qty"], + safety_stock=sku["safety_stock"], + reorder_point=sku["reorder_point"], + unit_price_usd=sku["unit_price_usd"], + avg_daily_sales_30d=sku["avg_daily_sales_30d"], + ) + logger.info(" ✓ %s (%s)", sku["id"], sku["sku"]) + + all_dependencies = DEPENDENCIES + SKU_DEPENDENCIES + logger.info("Wiring %d dependency edges …", len(all_dependencies)) + for from_id, to_id in all_dependencies: await session.run( "MATCH (a:Entity {id: $from_id}), (b:Entity {id: $to_id}) " "MERGE (a)-[:DEPENDS_ON]->(b)", @@ -793,53 +1058,8 @@ async def _seed_neo4j(settings: Settings) -> None: ) logger.info(" ✓ %s → %s", from_id, to_id) - logger.info("Injecting %d SimulationEvent overlays …", len(SCENARIOS)) - for scenario in SCENARIOS: - await session.run( - "MERGE (e:SimulationEvent {id: $id}) " - "SET e.scenario_id = $scenario_id, " - " e.description = $description, " - " e.affect_bbox = $bbox", - id=scenario["event_id"], - scenario_id=scenario["scenario_id"], - description=scenario["description"][:200], - bbox=scenario["bbox"], - ) - logger.info( - " ✓ %s (%s) affect_bbox=%s", - scenario["event_id"], - scenario["scenario_id"], - scenario["bbox"], - ) - finally: - await driver.close() - - -async def _sync_spatial_overlay(settings: Settings) -> None: - """Wire AFFECTED_BY from live PostGIS entities inside each scenario bbox.""" - from lib.graph.spatial_overlay import sync_event_affected_from_bbox - - pool = await create_pool(settings) - driver = AsyncGraphDatabase.driver( - settings.neo4j_uri, - auth=(settings.neo4j_user, settings.neo4j_password), - ) - try: - for scenario in SCENARIOS: - affected = await sync_event_affected_from_bbox( - driver, - pool, - event_id=scenario["event_id"], - bbox=scenario["bbox"], - ) - logger.info( - "Spatial overlay synced: %d live entities affected in scenario '%s'.", - len(affected), - scenario["scenario_id"], - ) finally: await driver.close() - await pool.close() async def main() -> None: @@ -852,7 +1072,8 @@ async def main() -> None: await _seed_postgres(settings) await _seed_neo4j(settings) - await _sync_spatial_overlay(settings) + await inject_scenarios(settings, SCENARIOS) + await sync_scenario_overlays(settings, SCENARIOS) logger.info("\nSeeded scenarios (match supply-chain frontend presets):") for scenario in SCENARIOS: diff --git a/scripts/seed_network_overlay.py b/scripts/seed_network_overlay.py new file mode 100644 index 0000000..5ec6dcb --- /dev/null +++ b/scripts/seed_network_overlay.py @@ -0,0 +1,75 @@ +"""Merge a supply-chain network YAML overlay into Postgres + Neo4j. + +Run after seed_demo.py (base demo). Same entity ids upsert; new ids add. + +Usage: + uv run seed-network-overlay data/supply-chain-network.yaml + NETWORK_YAML=path/to/file.yaml uv run seed-network-overlay +""" +from __future__ import annotations + +import asyncio +import logging +import os +import sys +from pathlib import Path + +from lib.core.config import Settings +from lib.importers.network_yaml import compile_network_yaml, load_network_yaml +from lib.seed.writers import write_network_overlay + +logging.basicConfig(level=logging.INFO, format="%(levelname)s — %(message)s") +logger = logging.getLogger(__name__) + + +def _resolve_yaml_path() -> Path: + env_path = os.environ.get("NETWORK_YAML", "").strip() + if env_path: + return Path(env_path) + if len(sys.argv) > 1: + return Path(sys.argv[1]) + raise SystemExit( + "Usage: seed-network-overlay \n" + " or: NETWORK_YAML=path/to/file.yaml seed-network-overlay" + ) + + +async def main() -> None: + settings = Settings() + if not settings.neo4j_password: + raise SystemExit( + "NEO4J_PASSWORD is not set. For local seeding, copy .env.example to .env." + ) + + yaml_path = _resolve_yaml_path() + logger.info("Loading network overlay from %s", yaml_path) + raw = load_network_yaml(yaml_path) + bundle = compile_network_yaml(raw) + + if bundle.issues: + for issue in bundle.issues: + logger.log( + logging.ERROR if issue.level == "error" else logging.WARNING, + "%s%s", + issue.message, + f" (row {issue.row})" if issue.row else "", + ) + + if not bundle.ok: + raise SystemExit( + f"Network overlay has {bundle.error_count} error(s); aborting commit." + ) + + logger.info( + "Committing overlay: entities=%d carries=%d dependencies=%d scenarios=%d", + len(bundle.entities), + len(bundle.carries_edges), + len(bundle.dependency_edges), + len(bundle.scenarios), + ) + await write_network_overlay(settings, bundle) + logger.info("Network overlay seed complete.") + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/tests/fixtures/supply_chain_network.example.yaml b/tests/fixtures/supply_chain_network.example.yaml new file mode 100644 index 0000000..861912f --- /dev/null +++ b/tests/fixtures/supply_chain_network.example.yaml @@ -0,0 +1,51 @@ +# Example overlay network manifest for general-simulation seed-network-overlay. +# Merge onto base seed_demo.py data (same entity ids upsert; new ids add). + +version: "1" +dataset_id: "supply-chain-overlay-example" + +airports: + - id: airport-jfk + name: "John F. Kennedy International" + iata: JFK + icao: KJFK + region: us_east + lon: -73.78 + lat: 40.64 + +flights: + - id: flight-baw177 + callsign: BAW177 + route: LHR-JFK + origin: "United Kingdom" + status: airborne + lon: -0.45 + lat: 51.47 + revenue_usd: 680000 + operating_cost_usd: 420000 + depends_on_port: port-los-angeles + +cargo: + - id: cargo-flight-baw177-pharma + carrier_id: flight-baw177 + sku_ref: sku-overlay-pharma-01 + commodity: pharmaceuticals + quantity: 8 + unit_price_usd: 8500 + +inventory_skus: + - id: sku-overlay-pharma-01 + sku: OVERLAY-PHARMA-01 + commodity: pharmaceuticals + warehouse_id: warehouse-inland-empire + on_hand_qty: 24 + safety_stock: 10 + reorder_point: 15 + unit_price_usd: 8500 + avg_daily_sales_30d: 1.5 + linked_carrier_ids: + - flight-baw177 + +dependencies: + - from: flight-baw177 + to: airport-jfk diff --git a/tests/test_network_yaml.py b/tests/test_network_yaml.py new file mode 100644 index 0000000..c5169a0 --- /dev/null +++ b/tests/test_network_yaml.py @@ -0,0 +1,120 @@ +"""Tests for supply-chain network YAML compilation.""" +from __future__ import annotations + +from pathlib import Path + +import pytest + +from lib.importers.network_yaml import compile_network_yaml, load_network_yaml + +FIXTURE = ( + Path(__file__).resolve().parent / "fixtures" / "supply_chain_network.example.yaml" +) + + +def test_load_example_fixture() -> None: + raw = load_network_yaml(FIXTURE) + assert raw["version"] == "1" + assert raw["dataset_id"] == "supply-chain-overlay-example" + + +def test_compile_example_counts() -> None: + raw = load_network_yaml(FIXTURE) + bundle = compile_network_yaml(raw) + assert bundle.ok + assert bundle.error_count == 0 + assert len(bundle.entities) == 4 + assert len(bundle.carries_edges) == 1 + assert len(bundle.dependency_edges) == 2 # explicit + SKU -> warehouse + + +def test_sku_value_usd_computed() -> None: + raw = load_network_yaml(FIXTURE) + bundle = compile_network_yaml(raw) + sku = next(e for e in bundle.entities if e.id == "sku-overlay-pharma-01") + assert sku.attributes["value_usd"] == 24 * 8500.0 + assert sku.attributes["quantity"] == 24 + + +def test_company_id_from_file_default() -> None: + raw = { + "version": "1", + "company_id": "company-1", + "company_name": "Acme Corp", + "flights": [ + { + "id": "flight-test", + "callsign": "TST001", + "route": "A-B", + "lon": 1.0, + "lat": 2.0, + } + ], + } + bundle = compile_network_yaml(raw) + flight = next(e for e in bundle.entities if e.id == "flight-test") + assert flight.attributes["company_id"] == "company-1" + assert flight.attributes["company_name"] == "Acme Corp" + + +def test_cargo_sku_ref_links_carrier() -> None: + raw = load_network_yaml(FIXTURE) + bundle = compile_network_yaml(raw) + sku = next(e for e in bundle.entities if e.id == "sku-overlay-pharma-01") + assert "flight-baw177" in sku.attributes["linked_carrier_ids"] + + +def test_cargo_value_usd() -> None: + raw = load_network_yaml(FIXTURE) + bundle = compile_network_yaml(raw) + cargo = next(e for e in bundle.entities if e.id == "cargo-flight-baw177-pharma") + assert cargo.attributes["value_usd"] == 8 * 8500.0 + + +def test_validation_catches_missing_cargo_sku_ref() -> None: + raw = load_network_yaml(FIXTURE) + raw = dict(raw) + raw["cargo"] = [ + { + "id": "cargo-bad", + "carrier_id": "flight-baw177", + "sku_ref": "sku-does-not-exist", + "commodity": "test", + "quantity": 1, + "unit_price_usd": 10, + } + ] + bundle = compile_network_yaml(raw) + assert any( + i.level == "error" and "sku-does-not-exist" in i.message + for i in bundle.issues + ) + assert not bundle.ok + + +def test_validation_warns_external_warehouse() -> None: + raw = { + "version": "1", + "inventory_skus": [ + { + "id": "sku-ext-wh", + "sku": "EXT-1", + "warehouse_id": "warehouse-inland-empire", + "on_hand_qty": 5, + "unit_price_usd": 100, + } + ], + } + bundle = compile_network_yaml(raw) + assert bundle.ok + assert any( + i.level == "warning" and "warehouse-inland-empire" in i.message + for i in bundle.issues + ) + + +def test_missing_version_raises(tmp_path: Path) -> None: + bad_file = tmp_path / "bad.yaml" + bad_file.write_text("dataset_id: x\nairports: []\n", encoding="utf-8") + with pytest.raises(ValueError, match="Unsupported network YAML version"): + load_network_yaml(bad_file) From ae0322b072a91ab8a62b36e948b9ea5c213abcf8 Mon Sep 17 00:00:00 2001 From: Ryan Johnson Date: Wed, 7 Oct 2026 16:43:13 -0400 Subject: [PATCH 7/8] fix(helm): allow Kind to set postgres runAsUser via values OpenShift restricted SCC leaves UID unset; Kind rejects runAsNonRoot when the image USER is root. Expose pod/container securityContext overlays so CI can set runAsUser 999 without breaking OpenShift defaults. Co-authored-by: Cursor --- deploy/helm/templates/postgres/statefulset.yaml | 10 ++++++++-- deploy/helm/values.yaml | 3 +++ 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/deploy/helm/templates/postgres/statefulset.yaml b/deploy/helm/templates/postgres/statefulset.yaml index 4b0c73b..0f910af 100644 --- a/deploy/helm/templates/postgres/statefulset.yaml +++ b/deploy/helm/templates/postgres/statefulset.yaml @@ -17,10 +17,13 @@ spec: labels: {{- include "postgres.selectorLabels" . | nindent 8 }} spec: - # OpenShift restricted SCC: no fixed runAsUser/fsGroup — the platform assigns - # a namespace UID and fsGroup; the postgres image supports arbitrary UID. + # OpenShift restricted SCC: leave podSecurityContext empty so the platform + # assigns UID/fsGroup. Kind sets postgres.podSecurityContext.runAsUser=999. securityContext: runAsNonRoot: true + {{- with .Values.postgres.podSecurityContext }} + {{- toYaml . | nindent 8 }} + {{- end }} containers: - name: postgres image: {{ include "postgres.containerImage" . }} @@ -60,6 +63,9 @@ spec: allowPrivilegeEscalation: false capabilities: drop: ["ALL"] + {{- with .Values.postgres.containerSecurityContext }} + {{- toYaml . | nindent 12 }} + {{- end }} livenessProbe: exec: command: diff --git a/deploy/helm/values.yaml b/deploy/helm/values.yaml index 7589d0c..1e896b3 100644 --- a/deploy/helm/values.yaml +++ b/deploy/helm/values.yaml @@ -24,6 +24,9 @@ global: postgres: enabled: true + # Empty on OpenShift (restricted SCC assigns UID). Kind sets runAsUser/fsGroup. + podSecurityContext: {} + containerSecurityContext: {} # ai-architecture-charts pgvector subchart (separate Postgres STS). Disabled — # vector storage uses the general-sim Postgres image above (pgvector extension). From 46ed63f40856b9e812e69874fa5c8c4395f39974 Mon Sep 17 00:00:00 2001 From: RJ Johnson Date: Mon, 26 Oct 2026 17:09:12 -0400 Subject: [PATCH 8/8] E2e work (#9) * Add Kind Helm smoke and API e2e verification. Wire a Kind cluster path with values-kind, CI scripts, Makefile targets, and a GitHub Actions workflow so PRs can deploy and verify /health, seed, and /query with a fake LLM. Co-authored-by: Cursor * Fix Kind pod startup by pinning Postgres and Neo4j UIDs. Kind has no OpenShift SCC, so runAsNonRoot without a numeric UID left Postgres and Neo4j in CreateContainerConfigError and blocked helm --wait. Co-authored-by: Cursor * Refresh architecture diagrams to match ReAct + Neo4j stack. Replace AGE/LangGraph-era PNGs with Mermaid-sourced figures and align README captions. Co-authored-by: Cursor --------- Co-authored-by: Robert Sandoval Co-authored-by: Cursor --- .github/actions/kind/action.yaml | 159 ++++++++++++++++++ .github/workflows/kind-helm-smoke.yml | 71 ++++++++ Makefile | 101 ++++++++++- README.md | 10 +- deploy/helm/README.md | 33 ++++ .../helm/templates/postgres/statefulset.yaml | 21 ++- deploy/helm/values-kind.yaml | 130 ++++++++++++++ docs/images/architecture-overview.mmd | 54 ++++++ docs/images/architecture-overview.png | Bin 180683 -> 182855 bytes docs/images/domain-seams.mmd | 35 ++++ docs/images/domain-seams.png | Bin 184424 -> 206060 bytes docs/images/query-flow.mmd | 40 +++++ docs/images/query-flow.png | Bin 192689 -> 157116 bytes docs/images/simulation-overlay.mmd | 31 ++++ docs/images/simulation-overlay.png | Bin 133460 -> 85702 bytes scripts/ci/kind-preflight.sh | 61 +++++++ scripts/ci/kind-verify-deployment.sh | 131 +++++++++++++++ scripts/ci/kind-with-registry.sh | 66 ++++++++ scripts/local-kind-smoke-test.sh | 152 +++++++++++++++++ scripts/smoke-uk-closure.sh | 44 +++-- 20 files changed, 1109 insertions(+), 30 deletions(-) create mode 100644 .github/actions/kind/action.yaml create mode 100644 .github/workflows/kind-helm-smoke.yml create mode 100644 deploy/helm/values-kind.yaml create mode 100644 docs/images/architecture-overview.mmd create mode 100644 docs/images/domain-seams.mmd create mode 100644 docs/images/query-flow.mmd create mode 100644 docs/images/simulation-overlay.mmd create mode 100755 scripts/ci/kind-preflight.sh create mode 100755 scripts/ci/kind-verify-deployment.sh create mode 100755 scripts/ci/kind-with-registry.sh create mode 100755 scripts/local-kind-smoke-test.sh diff --git a/.github/actions/kind/action.yaml b/.github/actions/kind/action.yaml new file mode 100644 index 0000000..17cbc40 --- /dev/null +++ b/.github/actions/kind/action.yaml @@ -0,0 +1,159 @@ +name: Kind cluster and Helm deploy +description: Create a Kind cluster with a local registry and install the general-simulation Helm chart + +inputs: + namespace: + description: Kubernetes namespace for the release + required: false + default: general-simulation + helm_release: + description: Helm release name + required: false + default: general-simulation + registry: + description: Local registry host:port (Kind registry mirror) + required: false + default: localhost:5001 + helm_extra_args: + description: Extra arguments passed to helm upgrade --install + required: false + default: "" + skip_image_build: + description: Skip building and pushing app images (use tags already in the local registry) + required: false + default: "false" + wait_for_rollout: + description: Wait for general-sim-api Deployment to become Available + required: false + default: "true" + run_builtin_smoke: + description: Run minimal /health check in this action (disable if the workflow runs kind-verify-deployment.sh) + required: false + default: "false" + +runs: + using: composite + steps: + - name: Install Go (Kind CLI) + uses: actions/setup-go@v5 + with: + go-version: "1.22.x" + + - name: Install Kind + shell: bash + run: | + go install sigs.k8s.io/kind@v0.30.0 + echo "$(go env GOPATH)/bin" >> "${GITHUB_PATH}" + + - name: Install Podman + shell: bash + run: | + sudo apt-get update -qq + sudo apt-get install -y podman + podman version + podman info + + - name: Create Kind cluster with local registry + shell: bash + env: + USE_PODMAN: "1" + run: bash ./scripts/ci/kind-with-registry.sh + + - name: Install Helm + uses: azure/setup-helm@v4 + with: + version: v3.19.4 + + - name: Helm dependencies + shell: bash + run: make helm-deps + + - name: Build app images + if: inputs.skip_image_build != 'true' + shell: bash + run: make kind-build-images REGISTRY=${{ inputs.registry }} + + - name: Push app images to local registry + if: inputs.skip_image_build != 'true' + shell: bash + run: make kind-push-images REGISTRY=${{ inputs.registry }} PUSH_EXTRA_ARGS=--tls-verify=false + + - name: Create namespace + shell: bash + run: make k8s-namespace NAMESPACE=${{ inputs.namespace }} + + - name: Helm install (Kind values) + id: helm_install + shell: bash + run: | + set -euo pipefail + make helm-install-kind \ + NAMESPACE=${{ inputs.namespace }} \ + HELM_RELEASE_NAME=${{ inputs.helm_release }} \ + REGISTRY=${{ inputs.registry }} \ + HELM_EXTRA_ARGS="${{ inputs.helm_extra_args }}" + + - name: Dump cluster state on Helm install failure + if: failure() && steps.helm_install.outcome == 'failure' + shell: bash + run: | + set +e + NS="${{ inputs.namespace }}" + REL="${{ inputs.helm_release }}" + echo "=== kubectl get deploy,sts,svc,pvc,job,sa,pods -n ${NS} ===" + kubectl get deploy,sts,svc,pvc,job,sa,pods -n "${NS}" -o wide + echo "=== kubectl get events -n ${NS} (last 50) ===" + kubectl get events -n "${NS}" --sort-by=.lastTimestamp | tail -50 + echo "=== StorageClasses ===" + kubectl get storageclass + echo "=== helm status ===" + helm status "${REL}" -n "${NS}" || true + dump_pod() { + local pod="$1" + echo "=== describe ${pod} ===" + kubectl describe -n "${NS}" "${pod}" | tail -50 + kubectl logs -n "${NS}" "${pod}" --all-containers --tail=80 2>/dev/null || true + } + for dep in general-sim-api neo4j postgres bootstrap; do + echo "=== candidates matching *${dep}* ===" + kubectl get pods -n "${NS}" -o name 2>/dev/null | grep -i "${dep}" | while read -r pod; do + dump_pod "${pod}" + done + done + if kubectl get pod -n "${NS}" "${REL}-0" >/dev/null 2>&1; then + dump_pod "pod/${REL}-0" + fi + kubectl get jobs -n "${NS}" -o name 2>/dev/null | while read -r job; do + echo "=== job describe ${job} ===" + kubectl describe -n "${NS}" "${job}" | tail -40 + kubectl logs -n "${NS}" "job/$(basename "${job}")" --all-containers --tail=80 2>/dev/null || true + done + + - name: Wait for API deployment + if: inputs.wait_for_rollout == 'true' + shell: bash + run: | + kubectl wait --namespace "${{ inputs.namespace }}" \ + --for=condition=available \ + deployment/general-sim-api \ + --timeout=300s + + - name: Smoke test API /health + if: inputs.wait_for_rollout == 'true' && inputs.run_builtin_smoke == 'true' + shell: bash + run: | + set -euo pipefail + kubectl port-forward -n "${{ inputs.namespace }}" \ + svc/general-sim-api 18000:8000 >/tmp/pf.log 2>&1 & + PF_PID=$! + trap 'kill "${PF_PID}" 2>/dev/null || true' EXIT + for _ in $(seq 1 45); do + if curl -sf http://127.0.0.1:18000/health | grep -q '"status"'; then + echo "API /health OK" + exit 0 + fi + sleep 2 + done + echo "API /health did not become ready" + cat /tmp/pf.log || true + exit 1 diff --git a/.github/workflows/kind-helm-smoke.yml b/.github/workflows/kind-helm-smoke.yml new file mode 100644 index 0000000..03837ed --- /dev/null +++ b/.github/workflows/kind-helm-smoke.yml @@ -0,0 +1,71 @@ +name: Kind Helm smoke + +# Helm lint, Kind deploy, and API verification (health + seed + /query with fake LLM). +on: + workflow_dispatch: + pull_request: + types: [opened, synchronize, reopened] + branches: [main, master, development] + paths: + - "apps/**" + - "lib/**" + - "domain/**" + - "deploy/**" + - "scripts/ci/**" + - "scripts/local-kind-smoke-test.sh" + - "scripts/seed_demo.py" + - "scripts/smoke-uk-closure.sh" + - "Makefile" + - ".github/actions/kind/**" + - ".github/workflows/kind-helm-smoke.yml" + push: + branches: [main, master, development] + paths: + - "apps/**" + - "lib/**" + - "domain/**" + - "deploy/**" + - "scripts/ci/**" + - "scripts/local-kind-smoke-test.sh" + - "scripts/seed_demo.py" + - "scripts/smoke-uk-closure.sh" + - "Makefile" + - ".github/actions/kind/**" + - ".github/workflows/kind-helm-smoke.yml" + +concurrency: + group: kind-helm-smoke-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} + cancel-in-progress: true + +env: + KIND_NAMESPACE: general-simulation + HELM_RELEASE: general-simulation + +jobs: + kind-helm-smoke: + name: Helm lint, Kind deploy, API verify + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + + - uses: azure/setup-helm@v4 + with: + version: v3.19.4 + + - name: Helm chart lint + run: make lint-charts + + - name: Deploy chart on Kind + uses: ./.github/actions/kind + with: + namespace: ${{ env.KIND_NAMESPACE }} + helm_release: ${{ env.HELM_RELEASE }} + registry: localhost:5001 + run_builtin_smoke: "false" + + - name: Verify deployment (health, seed, /query) + shell: bash + run: make kind-verify + env: + NAMESPACE: ${{ env.KIND_NAMESPACE }} + HELM_RELEASE_NAME: ${{ env.HELM_RELEASE }} diff --git a/Makefile b/Makefile index 5f42886..4738b0b 100644 --- a/Makefile +++ b/Makefile @@ -37,11 +37,24 @@ IMG_NEO4J := $(REGISTRY)/$(NEO4J_IMAGE_NAME):$(TAG) # ── Helm chart paths ────────────────────────────────────────────────────────── CHART_UMBRELLA := deploy/helm +CHART_VALUES := deploy/helm/values.yaml +CHART_VALUES_KIND := deploy/helm/values-kind.yaml CHART_VALUES_SECRETS := deploy/helm/values-secrets.yaml # Common flags passed to every helm command HELM_RELEASE_NAME ?= general-simulation HELM_COMMON := --namespace $(NAMESPACE) +HELM_EXTRA_ARGS ?= +KIND_DEPLOY_TIMEOUT ?= 15m +# Optional on push, e.g. PUSH_EXTRA_ARGS=--tls-verify=false for Kind (localhost:5001) +PUSH_EXTRA_ARGS ?= +LOCAL_KIND_SMOKE_ARGS ?= + +# Kind: pin images to the local registry via global.registry / neo4j.customImage. +HELM_KIND_IMAGE_SETS = \ + --set global.registry=$(REGISTRY) \ + --set global.imageTag=$(TAG) \ + --set neo4j.image.customImage=$(IMG_NEO4J) # Neo4j subchart reads image.customImage directly (not global.registry helpers). _helm_neo4j_image_set := --set neo4j.image.customImage=$(IMG_NEO4J) @@ -75,10 +88,13 @@ LOCAL_COMPOSE := deploy/local/composefile.yml build build-postgres build-neo4j build-app \ deploy deploy-umbrella neo4j-connect \ package-chart \ - undeploy status lint-charts test-unit smoke-test \ + undeploy status lint-charts helm-deps test-unit smoke-test \ local-up local-down local-bootstrap \ + kind-build-images kind-push-images k8s-namespace \ + helm-install-kind kind-undeploy \ + kind-preflight kind-verify local-kind-smoke-test \ _guard-values-secrets \ - _guard-oc _guard-helm _guard-podman _guard-namespace \ + _guard-oc _guard-helm _guard-podman _guard-namespace _guard-kubectl \ _remove-orphan-neo4j-resources _remove-openshift-routes # ── Default target ──────────────────────────────────────────────────────────── @@ -95,11 +111,21 @@ help: @printf " %-40s %s\n" "undeploy" "Uninstall Helm releases" @printf " %-40s %s\n" "status" "helm list + oc get pods" @printf " %-40s %s\n" "lint-charts" "helm lint" + @printf " %-40s %s\n" "helm-deps" "Update Helm chart dependencies" @printf " %-40s %s\n" "test-unit" "Run unit tests (uv run pytest)" @printf " %-40s %s\n" "smoke-test" "Seed UK demo + POST /query (auto cluster when deployed)" @printf " %-40s %s\n" "local-up" "Start local Postgres + Neo4j (compose --wait)" @printf " %-40s %s\n" "local-down" "Stop local Postgres + Neo4j" @printf " %-40s %s\n" "local-bootstrap" "local-up + schema bootstrap (Postgres + Neo4j)" + @printf "\nKind / local Kubernetes:\n" + @printf " %-40s %s\n" "kind-preflight" "Check Podman VM / Kind node RAM before local smoke" + @printf " %-40s %s\n" "kind-build-images" "Build images for REGISTRY (default quay; use localhost:5001)" + @printf " %-40s %s\n" "kind-push-images" "Push kind-build-images to REGISTRY" + @printf " %-40s %s\n" "k8s-namespace" "Create kubectl namespace (NAMESPACE)" + @printf " %-40s %s\n" "helm-install-kind" "Install on Kind (values-kind.yaml + local REGISTRY)" + @printf " %-40s %s\n" "kind-verify" "Post-deploy checks (port-forward + /health + seed + /query)" + @printf " %-40s %s\n" "local-kind-smoke-test" "Full local Kind smoke (cluster + images + install + verify)" + @printf " %-40s %s\n" "kind-undeploy" "helm uninstall Kind release (kubectl; no oc)" @printf "\nVariables:\n" @printf " %-18s %s\n" "REGISTRY" "$(REGISTRY)" @printf " %-18s %s\n" "APP_IMAGE_NAME" "$(APP_IMAGE_NAME)" @@ -140,6 +166,10 @@ _guard-podman: @command -v podman >/dev/null 2>&1 || \ { echo "ERROR: 'podman' not found. Install Podman or substitute 'docker' by setting PODMAN=docker."; exit 1; } +_guard-kubectl: + @command -v kubectl >/dev/null 2>&1 || \ + { echo "ERROR: 'kubectl' not found. Install kubectl for Kind targets."; exit 1; } + # ── Container image builds ──────────────────────────────────────────────────── build: _guard-podman build-postgres build-neo4j build-app @echo "==> All images built and pushed to $(REGISTRY)." @@ -308,12 +338,15 @@ status: _guard-helm _guard-oc @echo "==> Pod status:" @oc get pods -n $(NAMESPACE) -lint-charts: _guard-helm +helm-deps: _guard-helm + @echo "==> Updating umbrella chart dependencies..." helm repo add neo4j https://helm.neo4j.com/neo4j 2>/dev/null || true helm repo update neo4j helm repo add ai-architecture-charts $(LLM_SERVICE_CHART_REPO) 2>/dev/null || true helm repo update ai-architecture-charts helm dependency update $(CHART_UMBRELLA) + +lint-charts: helm-deps helm lint $(CHART_UMBRELLA) @echo "==> Chart passed lint." @@ -332,3 +365,65 @@ local-bootstrap: local-up smoke-test: @chmod +x scripts/smoke-uk-closure.sh ./scripts/smoke-uk-closure.sh + +# ── Kind / plain Kubernetes ─────────────────────────────────────────────────── + +kind-build-images: _guard-podman + @echo "==> Building Neo4j image: $(IMG_NEO4J)" + podman build \ + --platform=linux/amd64 \ + -f deploy/container_files/neo4j/Containerfile \ + -t $(IMG_NEO4J) \ + deploy/container_files/neo4j + @echo "==> Building Postgres image: $(IMG_POSTGRES)" + podman build \ + --platform=linux/amd64 \ + -f deploy/container_files/postgres/Containerfile \ + -t $(IMG_POSTGRES) \ + deploy/container_files/postgres + @echo "==> Building FastAPI app image: $(IMG_APP)" + podman build \ + --platform=linux/amd64 \ + -f deploy/container_files/api/Containerfile \ + -t $(IMG_APP) \ + . + +kind-push-images: _guard-podman + @echo "==> Pushing images to $(REGISTRY) ($(PUSH_EXTRA_ARGS))" + podman push $(PUSH_EXTRA_ARGS) $(IMG_NEO4J) + podman push $(PUSH_EXTRA_ARGS) $(IMG_POSTGRES) + podman push $(PUSH_EXTRA_ARGS) $(IMG_APP) + +k8s-namespace: _guard-kubectl + @echo "==> Ensuring namespace $(NAMESPACE)" + kubectl create namespace $(NAMESPACE) --dry-run=client -o yaml | kubectl apply -f - + kubectl config set-context --current --namespace=$(NAMESPACE) >/dev/null 2>&1 || true + +helm-install-kind: helm-deps k8s-namespace + @echo "==> Installing $(HELM_RELEASE_NAME) on Kind/Kubernetes (namespace: $(NAMESPACE), registry: $(REGISTRY))" + helm upgrade --install $(HELM_RELEASE_NAME) $(CHART_UMBRELLA) \ + --namespace $(NAMESPACE) \ + -f $(CHART_VALUES) \ + -f $(CHART_VALUES_KIND) \ + $(HELM_KIND_IMAGE_SETS) \ + $(HELM_EXTRA_ARGS) \ + --wait \ + --timeout $(KIND_DEPLOY_TIMEOUT) + +kind-undeploy: _guard-helm _guard-kubectl + @echo "==> Removing Helm release $(HELM_RELEASE_NAME) from namespace $(NAMESPACE)..." + helm uninstall $(HELM_RELEASE_NAME) --namespace $(NAMESPACE) 2>/dev/null || true + +kind-preflight: + @chmod +x scripts/ci/kind-preflight.sh + @bash ./scripts/ci/kind-preflight.sh + +kind-verify: + @chmod +x scripts/ci/kind-verify-deployment.sh + @NAMESPACE=$(NAMESPACE) HELM_RELEASE=$(HELM_RELEASE_NAME) \ + bash ./scripts/ci/kind-verify-deployment.sh + +local-kind-smoke-test: + @chmod +x scripts/local-kind-smoke-test.sh scripts/ci/kind-with-registry.sh \ + scripts/ci/kind-preflight.sh scripts/ci/kind-verify-deployment.sh + @bash ./scripts/local-kind-smoke-test.sh $(LOCAL_KIND_SMOKE_ARGS) diff --git a/README.md b/README.md index ec14466..03eb1f9 100644 --- a/README.md +++ b/README.md @@ -49,11 +49,11 @@ The whole platform is built to run on **OpenShift**, which is a hard constraint ## System at a glance -The platform is a small number of cooperating layers running inside one OpenShift cluster. The diagram below shows how they stack: an API and an orchestrator at the top, the three reasoning stages beneath, the LLM client as the inference/vector backend, and separate Neo4j and Postgres instances for graph and geo/vector state. Two things are worth noticing immediately — the reasoning stages are colour-coded by whether they use the LLM, and both the graph (Neo4j) and geo (PostGIS) paths bypass the LLM client to be queried directly. +The platform is a small number of cooperating layers running inside one OpenShift cluster. The diagram below shows how they stack: FastAPI at the top, an in-process ReAct agent loop that chooses tools, the LLM client as the inference/embedding path, and separate Neo4j and Postgres instances for graph and geo/vector state. Two things are worth noticing immediately — tools are colour-coded by whether they need the LLM, and both the graph (Neo4j) and geo (PostGIS) paths bypass Llama Stack to be queried directly. Vector search hits pgvector via the LLM client (asyncpg), not a Llama Stack vector provider. ![Layered system overview](docs/images/architecture-overview.png) -*Figure 1 — Layered system overview. Everything runs inside OpenShift. The LLM client fronts inference and vector/RAG; graph (Neo4j) and live/geo (PostGIS) are queried directly.* +*Figure 1 — Layered system overview. Everything runs inside OpenShift. ReAct tools drive Neo4j / PostGIS / pgvector; Llama Stack is the inference gateway (optional in-cluster vLLM behind it).* The remaining sections walk through each component: what it is, why it is there, and how it relates to its neighbours. @@ -175,7 +175,7 @@ A `POST /query` request kicks off the ReAct agent loop. The diagram below captur ![The query lifecycle](docs/images/query-flow.png) -*Figure 2 — The ReAct query lifecycle. The LLM decides which tools to call; every tool invocation and its result appear in the `tool_call_trace` field of the response.* +*Figure 2 — The ReAct query lifecycle. After a spatial AFFECTED_BY refresh, the LLM decides which tools to call; every invocation appears in `tool_call_trace`.* **Typical agent sequence for an impact question:** @@ -208,7 +208,7 @@ This is what makes multiple concurrent what-if scenarios trivial — each is an ![The overlay mechanism](docs/images/simulation-overlay.png) -*Figure 3 — The overlay mechanism. Ground truth (left) is read-only at query time. The event and its affected-entity references (right) are injected and removable, leaving the base graph intact.* +*Figure 3 — The overlay mechanism. Ground truth (Neo4j entity graph + PostGIS live snapshot) is read-only at query time. The SimulationEvent, AFFECTED_BY edges, and pgvector narrative (right) are injected and removable.* > **What kind of simulation this is (and isn’t):** This is a **dependency-and-impact reasoning** engine: it propagates effects through a known graph and applies solver logic on top. It is **not** a tick-by-tick discrete-event physics simulation (e.g. AnyLogic). That is an intentional trade: you gain explainability, speed, and concurrent what-if scenarios; you give up stochastic second-by-second temporal dynamics. Because the Stage 2 solver is pluggable, a full discrete-event engine can be dropped into that slot later without changing anything else. @@ -226,7 +226,7 @@ solvers). Which packages load is controlled by **`ENABLED_DOMAINS`** ![Fixed core vs. swap seams](docs/images/domain-seams.png) -*Figure 4 — The fixed core (left) versus the per-domain swap seams (right). Domain adaptation touches only the right-hand column.* +*Figure 4 — The fixed core (left) versus per-domain swap seams under `domain/` (right), selected by `ENABLED_DOMAINS`. Domain adaptation touches only the right-hand column.* The reason this works is that impact propagation is graph traversal in every domain. A port closure cascading through dependent routes and a stopped machine cascading through dependent cells are the **same** Cypher traversal over a **different** schema. The table below makes the mapping concrete. diff --git a/deploy/helm/README.md b/deploy/helm/README.md index 9b85fc1..486ee85 100644 --- a/deploy/helm/README.md +++ b/deploy/helm/README.md @@ -8,6 +8,7 @@ external subchart dependencies. | File | Purpose | |------|---------| | [`values.yaml`](values.yaml) | **Default config** — component toggles, models, images | +| [`values-kind.yaml`](values-kind.yaml) | Kind / plain Kubernetes CI overrides (no Routes, fake LLM, demo secrets) | | [`values-secrets.yaml.example`](values-secrets.yaml.example) | Template for passwords/tokens (copy to `values-secrets.yaml`) | ## Template layout @@ -65,3 +66,35 @@ enable the CronJob. Domain keys (`api.enabledDomains`, `ingestion.adapterId`, et default via `templates/_helpers.tpl`. **Values flow:** see [`VALUES_MAPPING.md`](../../docs/VALUES_MAPPING.md). + +## Kind / local Kubernetes smoke + +CI and local verification use Kind with a local registry (`localhost:5001`), +`values-kind.yaml` (Routes off, Llama Stack off, `api.llm.backend: fake`), then +API checks: `GET /health`, demo seed, `POST /query`. + +**RAM:** Neo4j’s chart requires at least 2Gi. Local Podman VMs should be ≥8Gi — +run `make kind-preflight` first. GitHub `ubuntu-latest` is fine. + +**UIDs:** Kind has no OpenShift SCC, so `values-kind.yaml` pins Postgres to UID +999 and Neo4j to UID 7474. Without that, pods stay in `CreateContainerConfigError` +(`runAsNonRoot` with a root or non-numeric image USER). + +```bash +# One-shot local path (Podman + Kind) +make local-kind-smoke-test + +# Or step by step: +bash scripts/ci/kind-with-registry.sh +make kind-build-images REGISTRY=localhost:5001 +make kind-push-images REGISTRY=localhost:5001 PUSH_EXTRA_ARGS=--tls-verify=false +make helm-install-kind REGISTRY=localhost:5001 +make kind-verify + +# Reuse an existing cluster / images: +make local-kind-smoke-test LOCAL_KIND_SMOKE_ARGS='--skip-build' +make local-kind-smoke-test LOCAL_KIND_SMOKE_ARGS='--recreate --cleanup' +``` + +GitHub Actions: [`.github/workflows/kind-helm-smoke.yml`](../../.github/workflows/kind-helm-smoke.yml) +uses [`.github/actions/kind`](../../.github/actions/kind/action.yaml). diff --git a/deploy/helm/templates/postgres/statefulset.yaml b/deploy/helm/templates/postgres/statefulset.yaml index 0f910af..62c624d 100644 --- a/deploy/helm/templates/postgres/statefulset.yaml +++ b/deploy/helm/templates/postgres/statefulset.yaml @@ -17,13 +17,16 @@ spec: labels: {{- include "postgres.selectorLabels" . | nindent 8 }} spec: - # OpenShift restricted SCC: leave podSecurityContext empty so the platform - # assigns UID/fsGroup. Kind sets postgres.podSecurityContext.runAsUser=999. + # OpenShift restricted SCC: no fixed runAsUser/fsGroup — the platform assigns + # a namespace UID and fsGroup; the postgres image supports arbitrary UID. + # Kind has no SCC: set postgres.podSecurityContext.runAsUser (999) in values-kind.yaml. + {{- if .Values.postgres.podSecurityContext }} + securityContext: + {{- toYaml .Values.postgres.podSecurityContext | nindent 8 }} + {{- else }} securityContext: runAsNonRoot: true - {{- with .Values.postgres.podSecurityContext }} - {{- toYaml . | nindent 8 }} - {{- end }} + {{- end }} containers: - name: postgres image: {{ include "postgres.containerImage" . }} @@ -59,13 +62,15 @@ spec: resources: {{- toYaml . | nindent 12 }} {{- end }} + {{- if .Values.postgres.containerSecurityContext }} + securityContext: + {{- toYaml .Values.postgres.containerSecurityContext | nindent 12 }} + {{- else }} securityContext: allowPrivilegeEscalation: false capabilities: drop: ["ALL"] - {{- with .Values.postgres.containerSecurityContext }} - {{- toYaml . | nindent 12 }} - {{- end }} + {{- end }} livenessProbe: exec: command: diff --git a/deploy/helm/values-kind.yaml b/deploy/helm/values-kind.yaml new file mode 100644 index 0000000..d773893 --- /dev/null +++ b/deploy/helm/values-kind.yaml @@ -0,0 +1,130 @@ +# Kind / plain Kubernetes CI overrides (use with: make helm-install-kind) +# +# Availability contract for helm --wait (must become Ready/Complete): +# postgres, neo4j (Service name neo4j), general-sim-api, then +# general-sim-bootstrap post-install hook. +# +# Kept off so they cannot block --wait or pull heavy images: +# llama-stack, llm-service, OpenSky ingestion CronJob. +# OpenShift Routes disabled (no router on Kind). +# +# Demo passwords so Postgres/Neo4j secret templates render without +# values-secrets.yaml. Local Podman + Kind needs an 8Gi Podman VM +# (Neo4j chart minimum is 2Gi). Run `make kind-preflight` before local smoke. + +openshift: + neo4j: + scc: + enabled: false + +global: + registry: localhost:5001 + imageTag: latest + postgres: + password: kind-demo-password + neo4j: + password: kind-demo-password + models: + openai: + enabled: false + deepseek-r1-distill-qwen-1-5b: + enabled: false + external-model: + enabled: false + +postgres: + enabled: true + postgres: + password: kind-demo-password + # Kind has no OpenShift SCC to assign a UID. The image USER is empty (root), + # so runAsNonRoot alone fails with CreateContainerConfigError — pin UID 999. + podSecurityContext: + runAsNonRoot: true + runAsUser: 999 + runAsGroup: 999 + fsGroup: 999 + containerSecurityContext: + allowPrivilegeEscalation: false + runAsNonRoot: true + runAsUser: 999 + capabilities: + drop: ["ALL"] + +pgvector: + enabled: false + +neo4j: + enabled: true + fullnameOverride: neo4j + disableLookups: true + # SCC off skips ServiceAccount/neo4j-sa; clear the chart default SA. + podSpec: + serviceAccountName: default + # Image USER is the string "neo4j"; Kind cannot verify non-root without a + # numeric runAsUser (UID 7474 matches the image passwd entry). + securityContext: + runAsNonRoot: true + runAsUser: 7474 + runAsGroup: 7474 + fsGroup: 7474 + fsGroupChangePolicy: OnRootMismatch + containerSecurityContext: + runAsNonRoot: true + runAsUser: 7474 + runAsGroup: 7474 + allowPrivilegeEscalation: false + capabilities: + drop: ["ALL"] + neo4j: + resources: + # Official neo4j chart fails helm template below 2Gi — this is the floor. + cpu: "500m" + memory: 2Gi + volumes: + data: + mode: dynamic + dynamic: + accessModes: + - ReadWriteOnce + requests: + storage: 2Gi + # Kind local-path provisioner (default StorageClass name). + storageClassName: standard + +llama-stack: + enabled: false + +llm-service: + enabled: false + +api: + enabled: true + route: + enabled: false + llm: + backend: fake + # Not used by FakeLLMClient; keeps Secret non-empty for Kind. + apiKey: kind-unused + baseUrl: http://127.0.0.1:9/v1 + postgres: + password: kind-demo-password + neo4j: + password: kind-demo-password + # Fake backend ignores the model id; keep a stable placeholder. + models: + generation: fake/canned + embedding: sentence-transformers/nomic-ai/nomic-embed-text-v1.5 + +bootstrap: + enabled: true + postgres: + password: kind-demo-password + neo4j: + password: kind-demo-password + +ingestion: + enabled: false + postgres: + password: kind-demo-password + neo4j: + password: kind-demo-password diff --git a/docs/images/architecture-overview.mmd b/docs/images/architecture-overview.mmd new file mode 100644 index 0000000..3898b78 --- /dev/null +++ b/docs/images/architecture-overview.mmd @@ -0,0 +1,54 @@ +%%{init: {"theme": "base", "themeVariables": {"fontFamily": "Inter, Helvetica, Arial, sans-serif", "fontSize": "14px", "primaryColor": "#e8f0fe", "primaryBorderColor": "#1a73e8", "primaryTextColor": "#202124", "lineColor": "#5f6368", "secondaryColor": "#e6f4ea", "tertiaryColor": "#fce8e6"}}}%% +flowchart TB + subgraph OCP["OpenShift cluster — hard platform constraint"] + direction TB + + API["FastAPI — POST /query · /admin/*"] + REACT["ReAct agent loop — lib/reasoning/pipeline.py
LLM chooses tools · max 6 rounds · tool_call_trace"] + + API --> REACT + + subgraph TOOLS["Agent tools — called in any order"] + direction LR + T1["get_affected_subgraph
NO LLM · Neo4j Cypher"] + T2["solve_impact
NO LLM · PostGIS + Solver"] + T3["search_scenario_context
via LLM client · pgvector"] + T4["run_ingestion_pull
on-demand adapter"] + end + + REACT --> TOOLS + + LLM["LLM client — OpenAI-compatible
inference + embed · pgvector via asyncpg"] + LS["Llama Stack — inference gateway
maas · openai · local vLLM"] + VLLM["vLLM optional — llm-service
OpenShift AI / KServe"] + + T3 --> LLM + REACT --> LLM + LLM --> LS + LS -.-> VLLM + + subgraph DIRECT["Queried directly — not via Llama Stack"] + direction LR + NJ["Neo4j — dependency graph
+ SimulationEvent overlays"] + PG["PostgreSQL StatefulSet
pgvector + PostGIS
no AGE"] + end + + T1 --> NJ + T2 --> PG + LLM --> PG + T4 --> PG + end + + classDef entry fill:#1a73e8,stroke:#174ea6,color:#fff + classDef agent fill:#9334e6,stroke:#681da8,color:#fff + classDef nollm fill:#e6f4ea,stroke:#137333,color:#137333 + classDef llm fill:#f3e8fd,stroke:#9334e6,color:#5b2d8e + classDef infra fill:#fff3e0,stroke:#e37400,color:#b06000 + classDef store fill:#e8f0fe,stroke:#1a73e8,color:#174ea6 + + class API entry + class REACT agent + class T1,T2 nollm + class T3,T4,LLM llm + class LS,VLLM infra + class NJ,PG store diff --git a/docs/images/architecture-overview.png b/docs/images/architecture-overview.png index 9fad42924fb4cc7ba3a21a27280d36ca84b70530..bb431a51517a43d3701a97b54a747685cf2e087d 100644 GIT binary patch literal 182855 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 U8LUk3XbvFr9e)%E{H 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 literal 180683 zcmeFYcQ~9;^DrzuBnW~aNR|*idM9D^7QGWah;H>I5oGlsdRY;@m$3Rq?>2fT(OIk# ztE{!(CVBF_-}m2lz3=bO_jX556>k zt;MDt?tE1mqN{-ZmnQX^^)ZoCEiHwG(o>Z8U}miBB+p;Y1n;!mFcRBZfie)zv2|9J6#&M|v$;cPIKT5apIxtD1!6OLuaM$R=6XIw?I zJOTam>eTk5G2>bD9QhyLw&@r8<%yW;Tws#*zO*ioUk~RzJP*RZfTrt#Tq9F#PgzKg z)fj$yYR;@fRck3NiNZ5@H9qzk!(BLsc$Uu6Q^<7=!mr4(;z6pAq_RroDKhOWh@`Wd zb%9GJ`nrww4JqXJf4a3*FRqE7`eP3HWM5XZgv!T=+< zOEEXc++k!2`6tbmV0ksS#zF^N{`tjSJY_M^C!|C!*jC*N4l_(`3i;|gi_a9!o{fd* zQ)jhqUf$5_(HS{WduyJWZ4snhpC0L+hnV{(kIBvcvJzzVie&2y`fdP1T~Vi|#2wU5 zWIMvHcZU=jl8Tw;A`pf1a3xj#fOFylq;&sQPBj-irFfw8KDp?wS)0ntIoQfq^9*g? z^(i|-<@N)w#4))<|H-XLcYF__1FF;@SL6xT>})*oQaIZSGFl1==f*KPL4`WU8jT1x zW}iV&#D4uG$|Ew*^|-)N`QzEmFtw~*&p4Ljm%Bw+OCrMhH^IdUIb(8iCDJfM)!n2= zifeKF8=|JU14?C5&ANEP62dSn#Q0_M9CP{G7_1B+rFJ7ZBSoUgiouMsu|pW$Yww#N(#uIXZgCbFirF((Y#iG_}pRQKZ!%3IGI zaEl3;V>(NsICiiJ_-KvC+_Jpv4eWZG%GP$eM!GNGNePZ(EGlItw()$O!|2G|bl4ux zW^<2%F&8QDfnnUx?R1H`31M@*Iu?_LH$EhKDAji+Y_1mCYkU1}=8x_43ilJSICJRs z;GWk4;SL#0aYn7t5+=WgdDc|_c#=~z^k|p5@Cn}jU0;EonY5l67j9CGX+2)rt|!>^7hu{CHScALuzfs>0IN?58yms zKsuS(Y|S3iqY3_}Uz9Pu+v?;SQ-1Lu>wK zD-0elep&l5d-S}ay#d!uL&0a#oYkANq%WA+8TBooLMth~t(}Vpxp)MdQ;6-OQM?Iq zTX+~=BmEFBW%yyGj@9)o%(uE3f$PdIk~KiI=+xo?JfW_g*7)~b!%O{j5F$^!ZoAQ< z4T+Bd>7V!bzw1uxd-xc)@i0QzIysp8b*GatyXo_m_OR=|uTn}XH4^+3t<9&wcT7UT zH#npOk|HA9@T46#*y9HTbzpyUpmxbYi!_{#*|R-by+g{%@LjKMhzai)9&@Xc?i#n| z)ZFE@9uZ;;=d4lO(7qbY7W+=gEWF_q#?yI!nSNo;e!8bjC~oN66OB9dtM)|65^6vH z$}or_SwfXv`$U=WftT(NNMCVQpQXc=AGP6hkCQG&IQh+K>w2%3vl9-*`fp=;Ti(WH zJCyn*jbGuY6%$*mV2KwC+3uxBy_5?J<+j}A{^&$(E&K6=e+jAci_!nO0MuNj>JICp z1?m!k^lpm_PWJ1|v@_HawnlsU72;6X!1bbjg&ZCJ@IoQ~8{(<-fBzci2{df~<=B z@)3wHx@(w&Q{Je;34Yytr^2-o&s2A^K*ulG z6G835wdNnEC6UVn$P7{~#wx~K^3Z_}Su(1DvfU*`qjl6_X|hiw_EBQ7Y0$?oAg`V9 zM{LHqhpJFazgQth#A;bWw);d-E_kK#h>`n71@REjfv#m zsoAboz=`s{9{=<`99G}BCiG7}pTjC&7pn*bm{+6I8BXBa+wWKxHgoP^AdtDza{1G1 z|N41~JM)@nB)n|exI(YjQWu?04cPkk@ol7`xDq3^x45G4W>_Vncq%IZoj*vL^|KC* za=7~sgDc@kF1;vve8XFDqr z$S)i9U8AS+^QMUFB+zNl|EoV8H1It}s^Qag!#6I>3U$<4sOd~t`5jEZcWIG0DEmMG z_gG(k$ggt1;lH}<3dd)gz?fc4Lv(w|T!9?58dfFj(A&jHFb(X@P*4)1bt$VDv9jyGnrl@)P$%Egwp-Zd5 zPL^6{_KC&Pl0Tg}hWO#w4Z;6~l1I1VKB_*Xo3S>PwJ}@Eo_c%)SEhR&%n5#x-};E- z^{;X6Lb87ZWY67*&SEDeB7Gnx^=k9FjShmlFwSkbDVz3R4+2+Mc}n+xIYD4b@IQH& z%H1o^eto=gHb6aR&e3jpi+kb69_@c;%uW7b!_4{Va4kHh2{W^q&gkU`awf&RVR=@*9P~_na!p+?k99X}f!AC)M!({5H&%gP}MoVi~fGwzRa(8ywo$e(5I&2MWXd3+~OSuhBkr} z+Nb?8{zd0z4A0(#Xe}&@?BM5TKks+3TM8AXE6p%4=&hOZ8`!j*zuK%Ef4$U9>RuyCQr?}^SI?SWSXql@@_X7;X=8a1Trq0qQzSq3QHL))`&Xi(DwUHY z>_bp~@HT2aw@<%d{-dkeRL3$QW?Y6j4PNTnyH#Z*NHsZ}NzO)v_92#5xV)>9=0Nr4nIY-kE&89F0D$<; z4-0{jS3kF(xwc?t#Zub9^I(~V)1B>S)Vp_^p4g7s)jAHlJCBwdYVjVA-ILBp{UeL6 zef!@l5gA6O@(H;bWE;{4bst|`yML)%&Q&bkQuU_8$O$jsM-kE*R9! z*a0nt(VnYdyOx=w^KkYc9>8*A#%#2UHMnW`)q1BO2+moSc46_7l|-*P#VLl&Czz8t zXU0=uq3%#}jsB@J>}Urk$O4W!W4>tyR(a{3lUxxzl{vwHDf2wi1GhxiPk3&w@h_b) zifmNxrJBx+1cIoHy=GA9Tp5s*j{>ZKkrKMuA6I6l!A=hce@HEWWI&$=yx0ROn&#}V z?P3(HyX(tCGi}1?#_86_f31?qL2o6(cKX!)(%yfx$6)&F;vMP_^3Wzp=u#!k&oS5r zcQgE%scfh3R&fTS^M26lj1Y*A+}g%bWDOUv^IYOPYB4;1TXrpdYCLx%Wysy|^f|7? z_QS6`AomHo-jW5Z@kAe-m{L&aFe&uO>D^2QJ_*g)6m9`F!w082%R6MMP;Kl6DJAQu z>dkP0=Adt<;7F;Tl?u*7teeN;Eni)QLFg`sza1n-xNVzmdtHdTz zJqS-nPI0qCTRAy<&EM zf`cmRz|K2Cy%(;!7%X{BkaW6v##nvOt#pzg%}RUNixmnH6c)lTtRaxq)F{yb1a>xK zSyVlwN;SsIJ>M{?ETa1*#Rcp<)QlvP&-$6PFXRXBZZmS&o9OC@bFD{7E91^pjCGtT zFDSv~cN@8NtrU<0>`o?+iMPraeAIdi2Ug2&bwr>vKS;$r zi$E{C*VGgWUnmb1VwPWC+n#ni0@FOPNCoUCNAG;y!k=FKs%a7c=8@XyY; z9pS|(0rlLx=rtt#X%lj;lkS#a!_L=KjppRbz0oux?F3q(M3>WN@TF!cgf!zlYq6;J_sGL25<=VUbn$Ob5r;Slf@y}Ibo%I}f_vDHz6& zaa1WAZ`9I9#5~JQ;so#S#6(fiRR>@{G+0nrLCt6rf2f>apwFMU9N@H z_KIUFb(ybP8^tPm9c^4O#Wu+|NI-5dDb1$%-gy19vumkHb%Qr*{!MjnhT<QXQaC&NQ2G%%!OTY2%J$|Gq!{BkuRo|`d zc{v1CCc9&x#^6LA$C5<4NWoMB&-GBjEORFpn5`YG;l~?vq=tTyxK?)>7@o8jD6w{| zkQfThZ#nf-%e2zgK^g1TA-7hi81!HXCvJ|D)uk|V4xZP3%ueOgr%Gn4nAeMTd7mh<1;Ha zStw|;zO;c@BdH`c(<tUJ9dNe=lIX7mYHi5?qE#(L8pCFLt z3sV*_keP$Sc(gI1cov24>IK3`01Qh}g^us#?|u@Gx$}aYpXK$h+84>OCnQ@NL1(pB zBx#)!x`K5&%86;gPA@G#m2`$}pvucCVX1^z)a^*`Kv}8BKhIt)IjQ)fCsNoFn!#dj z#Tn&jB&K?|Eu>Q;Rf5guqV(fHj~`|LQjgzGW~Q==3V-H07ntXqRG54e+F3f+mRrJR zyPS}HZf@K|31E~t_uQrRDf;Agm21!&LAe!@&Q)%fW@bub?d44zp063%tU9B^T6prn zEdy@9zK*FoFJj-!R=33DYAlziX5168&YpLF8Z@Hibad@|UJMjC3_)trH6f1MN~;-d zb&-5foWjpOzTxl`9a^bgm;KkE5FRVwyrmR&i60@YtvgofHoNGohSiP%`sf9V zQ~iyMA;0x6^U-v7l9~;_Sg0+*a=H5qlgH5S+9Lx+YJS{M7-c=sWsW-5Q2*FRLk6QP z8!~eZaCY+^_eh1N?CXaArQG1TC{xWEH<0U#_xIS*H5eU$ zL8JCWd(ZSVqr-h|@7f1Sfj6vJ=*S4ozL@WL+XeOXzqh5Gn)f-a!Dc|1!5x=pNo7oWS;z*NtfGbz5)fYg&@C&Weur05#MY`n;mc1^gKK6(X4O>IC);lyH2otyOUIxNNmOS@nz1w&nOoCy$AtI`@P127@lbNH?eXm zOy@o{mjM^!qf6030O#*Ji`E&w@PS)3`-c%cxQfPZc_6a}#9&_=(bfjE9y;UPZP0fV z5E|VXG_R97O||FSejO`z8vfgW&83gjtNpUrx%h^B9y=@H{?I8}QI9QEy(8RsyM|xn z#!B6P44Be>b7ict13O)QrBbsD(_Fm-g-ni3RA~m}&H8pkQl#O_{fy*bnVt0BIn3;h zIAhpGzA>bJcN{7>J0}Z%z;oWR<0(l-mVhz!NN#j%ti*-%5`z1a3*5@fW*WKzCU$H! zljW8@mJ|-YEI%MSBZ&xj6*w_+qm~7~zh(_p9=_0$2dWAkPJ}dZj3qho&)kBia2y9! zOyFATLLezJ48rX}zleWo+n!z*qg%3z6Dk8NzdK8e)?LjP*7>P7uVuVY$#mV<6-hVP zklHXi`ccr`S^T8c&vU2!_@{&-!+p*~7(Y)169%S)+XhvqnzIhkFRE{y2gpWCCQ&s5 ztW2C4d7HGP$~UO(B}K@170bZq+@*p(kg0QvF!Q^uKO-=C^Ad zQqGdeiqDkNsiE;6WW=!A2;TclS8ttVVl*KqjQ5h0v%122Gc?U#=Up%2I(pq<3N39E zJb}*7uBr!4JefCho#f2~)dh`lanX_S38CkUUnHM}C^_tgKL?l9x>YuLsz}go<*8XDP+AJd9UjUa8Km zDWvH$qMq67wuaW%t$ztu@YW!C_)K-d1>&+4c(~6TS0;+UawrjIx*IlC-KyYne8A4y zdsWt?`?jUmlLR87qOxs+iD5O6;S5Xkux+iIx(>Mb=bqnhs`Dm~@4IdQGl0WE2N!^+H=Cmu~g>Er7JuTsQt2CZ=;Funw^EC-V4K zC3qtg9IUg}@xTq^)6(bwNKR-~G`4YzdTF6ms}UK>`Ly-yJ>Lyq#Rr;HWMmb*jv{eG zCNr)~0nWUc3mX?=I{KD;LUW^o!s?%$-6x)&s_2%>D6oWMD^Cai6%jGfw;uU<) zpy@;Gx5Y4=H%Iwm8@Pn zjDvg(IR2=}b743CY1Up!t=bh@-R)iE-Zn(>c5E^~pDUnxn_t7YZ-W1RSy+aEf>#@J zM2g<~m0Yep)^0_BO-zXzKg<>Lv^^}89m=M0y+@=8m3A-BxhnMu7s|Y6Ht1ypkbHDW zIv0+sZwjxkwe~--L#)z2{gKi8$>Wp7-?5;nG^CzZxuLOl@9yvnXm884SU$` zzKM1sS9EQ00`4eh9bcyAacmD|KnUX!zBo6Iu#TI5d^R@%(+U#XWdHJdLVYn;iF|VT ztA!T1!3T;uv<6^fxI!Vv&Ds9pm#0=`-Hw@bkbY5E-NT{j;Y-Ri>Z$q~=FxoZmhf;< zpop+A%b*s^SKm^z=dqn&6O&WIiRK8s^eTRDzl{I_&>iV`I-K%~DeSyb$MDSVJ~5cuQY*N{t8&^1|8=l+Pb~cVs65;h(aT zI5r*9?Z|{m%FBNeCj#3ZzMrB!B&}%kR*3Nul|o9mMb_#KTwv493;C2z6Gt@Q_NP6j zd5J=R^d~$+*6F3qy$of8%OB33!k=y9RVLuIQ(2(Q+p$|rbY4*KftuBF>Bo}%Tb;Ke zB8WI`htuaTRrFUZzenpV2AQE?8|YG{sSJs1Q4iJh!1_Ja{F%Y4%;(A4TnPXQGgyfN@|EOauMtSA@@D!gL@yr@p~pAud4u-ls)kBwg8Y zzO5Rco?#R{>CCKjc*b@qLjyn&d_mh^1bZC~RC5XF;{p*QN^KUkKz7h^`ftqapbn&8 z&?V>VNpv5|-8=NTDcuFs6fSnlx}dh+x< zpmiSKSod69D^zM)Z_|#A7WeU}0DCW)eM0T1+w%n##0bjrL z>7DhXFE28_ba$JLi_qoC9cJ`cuW(P!<8Ao<%-}=v8g2Rx4KnpwW8L19p6j^4K&!o| zR@6cWtd1Dt2b#|&z@SpqcZ$77^F833byyW(r%tr+d5xif;D-6VDcT5Sx|qSh?bGg% zVG}4QU)Cupq^obI=RRzF!&(SynguqQY7=c{-ez_`cg&n*qD~Qz(%joDQc8}SY*x+W zmOL`qbpzO1H$^^*+}ah{ZfLlCqnF_2K5(E>BkjY2d~a7RHtY*L>P?ri%NchV%<7mM$!Ot0b4nbF0G5Oq*GK z%jD*qD*~=M2Yl1-gFxyvVTXI#(DG6Hv`+WNuMr3r4bxPI6=0{qsu~%StjT>j=8!(R zFzi8a?V8;-J&G=d`ts}Kd^Oj62HNV98j%n88|c%R6gKU@_z+^2wfeMo(gFDDD6qi^ zhxbIxL*{w=CTux5Byl3|l@MxktF$UB*kN`(Y9}6hpXzsU;sedbN#j;2vEZP%u1bHo z%vOslJSC@C;T2z1>-%oxqK-Xhcr$FF1nl(FAdaZCE7R*hSClvmW2tyft4_1ASL#(2 zQ)usvW-`W?B033r_yL?@nQ(y_rYDIdRMZu?a%-&j6AV#`va3g|*hYwh$_9P+Mu)w4 zSzbOnrfneP+kO(o`@hD9TQBS6EeQZX1TQ<0KEYx49KM87Od(-749e7n!!P&g)laz` z#Rzp_8rs8K>nQIjOqJ52I#Jv+Y_V_AMQULjI3!IrZwXh>FV+9PPgj3or(P}nupd&S zL^+@_D{|1zGm1lqU#=r{ip3U&yF}^KQ{R{b2?_YPqhd%2$yQgO5R)cW>4E2+Wn0jK zORHM%LsyVah)%atnkD$WwK15zCv)2x+>sx%8~;35Nr%0MU-*rkG90HW=mGhLonXV7 zfIfB&?@D^3`bc3ZZ!&zM*I^%G%P_ENyPRaG@D>rWW>hWuO8m*U&7Q174>81)rXFPJ zt<+AZy*hAmFlWj|$eiD_th5k=Z0et7D1Pf{TAK(Fo)3U34HgXO@$gSWLVkIMay#t2 z3ayAwb&Q?~qQd&Ur641$?j&1`7s9NS<24XCnza~5-v9O9jH>SzmDFm$*!58F*sM1$ z?5u!+%lI`U)|rm&zH>kBG|z!yEstGb`wfs1q!5#aVQ$D0#lshK$SQo$b!PtwZ1yoc zcU*LC5KLbjnlop;J!rcEoIjH!&m{LCH+>zeLodl04#|DbY9A;!u*QsT( zdN=4ZFeLRjSabuiyat_`O<=LF*cW%U_kZ7z>29(b)kbN~Sm(anwUiIfk4hKpnk$hx z+Q^yjpalTdclohq(xPMywF;S@GPSxOyu2)nPk4!gXpUptipXtDc&z_(JSxJ6=3|-7 zR;UVkgGZMz%3rF;$qWU<23x|Y9N92ogV@5UPrw2tnmd^cWKA_bU0(#@0{+IM8=tfI z$!WPSthdt_BQ>Cz9`#Wkkq6(G`9Dwz8|vq!)fH|$nEEm?`-t)WQM=YrNo?}!>u|{6 z+Hue1B>sZi$YlQ-V-K@Wt)%a)1Pp~Rh>z!rYEfsltPpD2dznwti8#Ab%>Z+d! z$e{yfS>fYTa}Wrp;Q6nXb6eyyssOpc1Qjdt3H8X=j}BVTe`bSlrG?dGZe|`|-<*x` z0pfw75@*578~&aXK%lip)WiE)3|qcKF<(J6LdJ$eJh1{x;lR$2eWd?9{-#wOK3^9U zt_aaSA;}%&12_+el?pD=x@LLrCKR(QB5@f030gY0FMF}R3YV2|ddiFGjVt2LgVPmH zoJY#)FTZWSaAV|lIWjmPtltg&))A|xXB2L%+9Ne6f__X!rd?<&k$d52FUQ3SsQxPG z*vRI_I&uTO2`eOFOae0Z_OvWiWOIVfUfh8h)&vfp!J+BGkHt3I5G&^}u&URUqLaZB zf7^xl27ajU0+W|&{sWBsQY!XAT$BH}6044}_2YE zszWDs@QiAvpl;TFl3`{yrLvTEZK=ZXQufB5)yt-+BpK{&3UN!%|Mt?znb#;~UZ0A5 zW39r|t*VeCs4VE*jESsj-G11*vEqsi{9Vb)L<=Cpv)cE+@LY-y^`B#(CoU`Ip`8IReMgn<*|`CHH*I(p5kUa{Jt4x8f2z$M>s8#|E}Q8 zbvhJ1WdOG^@27F-P|fWt5%r7iJn8jbMx|@1=S0N%A#7Hbd0GIz2Q@J?+on#d`C@+L z4SS`941)80BU^ips8`OX3jnZNRo82ZW?6ic#75ou-3 z?93%v&NYQkLwb%{4O|9TMb=6vm>Uk=FgH|;(tnQBcssnUIR{mwc9#hkQ5(iRlR_|v zO1rE2SEJyy^@GaHz1=}xGYM0kEANf|1|!5)gP3xPZy25M}4+F$q>16eE$)-tnNmDD|wT@>q2RZze>*qx1+KahBU1I+-1L2G5^^gOWf6fo^tb+ zM($OTR$YC5qIEi7{fyH@8JIhhhMDl=XPLa_`6cbx4nAY~6R298ap<5beHZzkh`?Rv z{E6Up+%Th-t%&nMc{|t4=R1Yn-SAeH`oYWkFaqb6afC_+(3NndS^rd9I+Tpem*f2I zz2jW^zx;{p%cEzne+Q%z9<6AiyMnVyVSe+`+`t=_Gxh_|+6Q+O_lY<6c0)rca^078sB6e{S99He(}ErqUEjsL->{Fe8vWSVo|_? z>0iR}*uHf!IZVE%GR?%+n)g5T*6$J7*em~+qD4T^NRWT<-^`l-*_winjZMMvpaCNN zz&Am=l;o+0>qOpDxBpGqHBRJgC%XF(fI;Guy2CVD#>yrdBzJ0FJKlZL5W|?#md&~B4|5!BkQ^sCM;-q{-OB)Tj|igOS<_RX85e=SM$a4;b=r!M6prH#N-0kRf0`G z@S{TAh!n_=Pk{#qBNht_5Aj_QAAT>+w`eW?qhxF&XrTN{9;I{8HWk4)xpIAz&a$!c zdZ+b7_Pm^?IXw4%RQ)N;sF!myoDheW8?@M040Sg(aS;$uhnCJSPf4F13_yij4yWl8 zdWg67*6{=Qu*}!sN60?fm5diV&bm<|wDUX7^ScZlg>;tj`6dT6Z76Ba8K0K)_Lj`= z8j$aOdgV*_3j$nG`Gl9ZECB(xS&8s&%SNAEqo1s|Fn*K%Hugt~HdXy&bES^flc^$W zo9M0*xK_=9H-CXOc&ZEz-Vx#vrT(GTGi|xL_=DNSJtanhw~CmU{Fbv3o`r?qr7^L= zzh|F4)_k-@G`M(!VDlsHvfg6jUBchbh&GX)=nniLLF|Qt?PaY8)sJvI&*&4si`y>f z-?{M)^qV>Yi7WEIt5rN>P=N~(xugU?Byw%map;ZKJ!iaj{AcaH6N+pYdod#S^auz{ ziuKCpCKlB2u>Vm3u{QjI#UF0}hWM7}fQtKCY^3H5!*l!_#owu3_m#6*Sh!B`Rwbp& zK{76FY@zHo`1Lg@-Ru|uX6D+>#c@a%X? zLI_`1S23-{)@m%j^w!@%S0XBKPvMte=1qSm*qLyKWQ(HU$D`R^xbDh_KByVvpz=zP zT>9)Ir8G>xi$@OqQ0)X~(BakwIz6Lwv)VjkuGCM>^u^xHHGgy}QZwFp;+SQJ9;O^)oO~nNWDEq<>&^jL&O#9_FCn)ez~`FY9M6 ze0-?X;rFEb`iFBiN^)nRas9+ZyW9eoxkkseyH+~0oe@uXf?6oIer>H;wc1?ZRMrIyMJOD&%Iv-t}ss5xdPt`?&hU0o#zkA z$umbo19dwa;2*BT`x4^K=Yn*m;v!NW9i#8;h(D@Cy={XnenPjYFt&K>jH#vSV4@H9 z+|E1@3u5AZ`u%CmB`-s}e%+4T;`JKMRUnE9JVnEx56i2BI1CqEW?L8~`Eru0w<_Y2 zVH&_@4PXGmErA8Q@+|^`Yx(I@K-zp1qZ~m6fzaL2J}TQSC&AOaFHQ1?*!nxLR6#*M zyN*>zua=|hMxoR?zgs^+(7VDRPsJ?0<=M@Artb#dHskb*W6LJ$QVrZ9%ZI;z=V8%) zs^d;*1?3emavWkn$OKqk@1LK?Cw0=62s{FKJx38FeuF5re^~l;04FMF z_RU$eEG#ZRvUhiU-8LZp{D}>)vq7_9L_m^-v$2l!y1j{sxhNCBF>sNl!`J1v?!LuQ z{*m-=PEjAAjh~O!%e_MG@%=jgOf)%cbV!yECQk$eCgtQbXG5~gRQG9~S$*|e=&lP} zckB4vV<)ghoe=t~Wv7jGubI{G$vwhAHe7S>$9%szjXa&I#+PlCdN zriOU}7lRt*cJgo2Nn?u*SIBQ2-zL!;ctT~RYk07v5Q}YeK%T2+Mk~&`Or9eOj_n_o zv#R*4O;wmZ=G!~9?)AW=4Iy+{h8|EqdJL$}S~xtK0yFr5ax-|lQu^M@3hlZI9!wEB zb4%BtYHt*GGVVQC>w<*rKUM-W+ZQz2uve6H8|1xrZnBpz1QRe;h@FnnBb-Fayf5M> zUizh?K;I)j%B9(AGD=zT9KL=s9z%E;(qrS&Ct{j1N)eeo#5*iO0 z5PpH6_d)iWhGv>>pF_w%mWU_VbD#sCI=!-vR%Ri117hzb21g}!g({%;uhtQ9dfb?x2O=YIP%QN2#U5 z(m%8d-RQ8Ln4Zk(=L7nDn%;O8^T0Pznh8*y;%8RY?JMCe<5$UMzS>n6 z(_h0_|AcV|tk+guA%@Za+7&!KWWC8kYF3?JZE;xH_F4+p8OL^ONeVX>#2l(jODbUV z`VES$s)a>^=IruFCF$Xq8(vZTdc0m~xu9D4Hv)b1tJBD4Ao}#DZn(jpE6p^#IL!`u zf5ru!pz>ee$YjI(cmV+8Cgp)JRwvdeG0Y?KH)D;)DL8)032{+XI ztoP=#$Q`$;NRt9!KE@rV9FAMF2)Mufi1(eT)d%SlB@EKO*>Et4OWRLkJ5C#a5=J36 zfaReSKTC+`MJ#hsa_M6_zVv9P^6fw_I;P!J0l+ujclu2(7}OK)oM)!nheJ=$YCXAC zRyT|AqO1~AfZTnN&b-{87l~?iv{tQbZc!S|l%dMB4l1pv-PehcluZ29YQLuvlZ($m za1X@U9|yJ0H}fj^t-Y@)M}sc1Cj1up0}VG%{iPbDMRnSH^QBuZlY6o*5vGWsOwidx8e^qi z8j8`UN2Sdy{@FpUGyOixWE=Z-5tEcjf%3y3bg>n_t7BH630YNV_Ro`D=( z5f3U{U7f)6w<*g5g?3$Vz9*>*#B6=VU^{B~FW1uYQW-`nR8MuyWNCj)5(zZO1|P^N zJO9?mRR--IxOxlm&>3C?6|}>&Y3o%dG8+0{Ob&b)ph>u!CQ{miaI6uFr|$D3en9vLNGdUIoX%&IBkI-Cu2nqD`lxNsNWNIm9IT+1&_lXP?tX$!`tJQT9olzEigx(|%_G8OZES3=Q$ zFjZVY^%20VVHYWGzGU7P4)NLGyUpGtYq5 z-7(N^bZfxYN<1w^te_g2exF6_4SY<|!^L?O;-=Pp*dIT;%&Dh)UC+zTDw-$Us|4ZM z^U5Py02aasLW;ssWqeuH-2-iwSj7l2pVIFPCo}zUKkG|@~y42Smmydjg|FlHZwTa$-(L(AB);U z{zvDSoOu?yIHkc`Qkd1DT}mN9^=pT4NOh1QRM^g}`4jI_Tt{~iY1srhSpQ-U0Zs>-6@G!5iq_fQ zuSF?Q*h*G|l_$2eQ+qUQ=%w6jm%^LLWfg9^6ShsM?%5&EIqgWxyhHq&EfMd)VV?+< z<>PzpDXgS>2i?-To~`w2z@j}h1*Y=K{T)qplO=`pOsouQ+?-2?XzHUhJKWRDsu-IO zHyMwdm*OP+Izd)i+>GntemLw|K@qlO@d&cZoWiMYzs4Yx>Ja~e*I&fMbcD;@7| z-eq)SbxZ$zK8-F@kzT4SGZ38}tN_TVrVB5+u_CZgq-m~~lb3ylg zYSCNb0t4~J95EF^Z`x3-JYkqhLC3olB_nB~eGkY8KYtD+A8n$oeM-20$9?CHF{rlA z(ABO;ycT>^w3{BD!uJ&Lq-yHpyKwy&IthR>+cQAEVus*J-U^SzVRF95vQ)nECOz{# zGT{Qdq~C60g}H2R?@;2zc|PUAc_WczT%?bob>ijaw%3Q7e4!fI!e3@RP}AG}?nooA zSv{{GJuNlz(fWjg{yQP}m*D6rzvD~+RW3Zfomtny>xRGUTI#R-2{gG16o0j?J7abtPwo1JTq?f^^31piu-V4hoko@);Z{EE;IbSC!^?Cha0PL-+dT) zdTtA{JiYqCL=qWEMp!Xyepq`n;-jW?ZX(Dx6Zb%g9OW-~BxT1DN}4X^y4EJE?k?`k zKcTZt%h1*)3ZvO}IIQOPzNmHVDi5ALQgYqamy&c@^S#L0>`pl(I(pMV&J1M!wY4-C zo2Vm7y2?z*CfQ6k`ZcOli`qB=$q`Ai$1YayxKY4}x!bbRhFE`cg9sRm=ybe!>N01# zz-A8>U@!U*LKath>KS9DFkKq`{=V^4+bl!PbUg6mS3lJJJw-FP{eifOy2u^5hR^lB zMEz*bN-J~VbL{m4p`fmYY#PkJHm7neU*DmoE3e=;&x1Fo_Ta&Xz|AYd*N9W2` zJb3ViQORcb(y}j1G89b^a#onAe#^kn(OnOFa-@s1F}v~;o8Wg>aYyp-@be1hy#GPM zDXTQE%d`v64v5T3aFRyc%F-GWbdB(ezJ{{T%6CFm;m`aGzUX`}nZa_Va^9r*F@NO( zRv-~jRrFVX`U*PGebO*$Ez@zOw&jGz9{Ctt{rw=R7TRdgqz(()u#CaNsQA2d=+^t znKd6FnXn!;<7~^u04@-Nx9v^dwN^0&-l+Ohz4x_7QRw(5(HXQ>=HXMx)Ooh+uv7i) z+5%ZlpPj<0Vs)gWFuxtPS!l@`m7-s9hCn=6A7iJcxL_TIuOzwlkg(w#k&W!?%#25; z;swGyXUG9N9A*|vO6noBWK_JbD{@)9deh2I@{8;ue_d<{q}NY~r{zHO;hEfxn6H}g zDfj0*cMANT%S0r6_Uk?m!-y(dTKQ$F_!>?_-t}?GnwR$t55STUxk}+xY8%%Fz!$+2 z)suo>yWG9H8cq0F$(t3T83Zj}*MGu$*p9-v5yWJ_xgmD@&nerJ(RqB6Go~sa{{Nxu zI|G_(x^+=s6;O%=QHqE(=}PY?NEeVUB}4?IgwR9iQE5syNbk}^liq`L>Am;fI|+n( zcX+?|obTLwZkt~_JCoUaX4b5=Wyxbj zL9F%Z#&$^F>Nua*>~Xz1s6ol=jLUjCfrB2f$&i@tKYpr@mz?XpayR_0-^!~vneM#c zEZ=Ou&CBxiuKUf7hgp@OE#d}ma?G?(52Vq9j}NoLGCa;!B`^4sb$*n+eElYU?Zwf> zXjS)-kiS>Re36@0%^}xl;Y5|4VEK$}0ZEjh6dC_#@+YeD%S4}FCcM0w?DrthqB(tJ zX3DKjd9c(3GX;Yky4WE(M%h?&m&3SgxBVy~tJY>tAF&OS;3D4s1lQeYgds&*m^Zmp zmhi!F8R-y8im?6jW(ynb_iP&bGn>aAu1-?pP@MyMR>9M`bf)BBCv{>{GfHfyx}&|6 zWsb2&m49466X$YqyjW?G3(IX*tD)2N5Beg*?6`#S=D!k7Mzyp4aM~M`^mv2qyQ^*G z&}Ls_vE!mQ5@QX<3J)(rx1;u-$#ut&O}7|9jOtO&C|JO<2yhcQD^oAuqB(39g@DO8uO79i}dbco<7N@UX$qL zX$h*FZ*FCkS*;54V)kyA!bTUEOi{#a1kNb}3;KuJT`$U-i^H#~z)=j@0_?7dBcB-_ zaLe}*(`)KuBd+N>(R=IZYuVUs$kF>v9UOSgorIArO@u_!vh`(v#Kr%7CmU69imJ%W z7>179ZU25Gs~|ts&rL^B?WsQvbS(ioYvGd~U`nF<^k`$Kqcw8s(F=jH^Dr`Da zxBsJD44ZOgXi>s~7Im3TyH$)>hyGnDY%HdI`r9iP>C@hlT)iV>=Z!3dFr9^B2mM%R@2#fJ+=-MtX}Njfy1hV; zHAdhzv-7u5T7c{Y$JuX6o*y2MrejpA%SF3?5-U&(+mAJnO`q5E9-@yHIwiq8V!h9Z z2DN`J&L?_At;_pRk#0;5#I?v9?xt*4y0u>0*Z9IX3vW#weT5{K$}DAoIGH$>pGY;K zyWt|tgo+aL%!Zy_mDZHp8d$Q!(}Te>GEMz%4o8;tpkrQzM3knP)%l=T_t|!Wz_{Eq zEg(kZ!=k-3^o+CUd61{wH@gP)dG)6r`bdeA-Gc;4vGXNLCXXM1mOuT{R~P|N`JT|< zvy@tDOm}gz*bwATE+sz}dS!URzB3FC_H?OsIg_j%>#1ufuVpx7ew|GMxXv;#NfmCXVAd0RJYoDu7c&$#eGZu|010x$@HuGKf6Dy*#3uJw41`UQ zH#j37R5Ke!+mss}s#md&NFaSKE@ak~^xnoOi zy51fn%;ZsK@oj-llu_z|RA$5%kh9f++<@&EULnp2B}-J7@bNq)UB2tZ z+f#=_xN~QQp~q==QyJJ}+|(k=NVfN_r{i$2;55!j`SUa_Cqr|4rVVdVfze?VcgG|z zE*QexP4y`8;aaZN8?7dvn}-{^rS9{`{pktK(aL^^2{rgA{}m*;<@^+M8msjf0AYIW zC}@FBEEo_t_KI!sWg!7sra%u!l~TYpg5R8muImAj)1cKYJ%R*jQfk+Aifdjb$wP}A z7aKdH`UG%!!L_t}I?xY2L+g9X^{ zF|JiBWU{7lvIKB^wl}NX3bURK+r`XIa%0s;GxNvwJASnJ+>!Pw(?}?La+IX zIbAe9*Ck9IQ-Qjg0mnQ5%a!xe=S&J|y)&O!Ze~(GBnj;ZrKi_ZAWYWuz#PXkcpRqk z0xkJn#=kyEFyme;C-TC~*Ug}V$X(nxVobZcSOU<-mcSVhPbsG!i=45w6r}c6R0;ux z_4ip0iK&)y`V%je7vTwQ24_t=h>Il?el_6H7vZvJ9ziI9{FfZ-L3vzVi$;kI**-Lw&tfalye}GT8b2jU-#N$xs4sjud%am8 z?%%W^g!NbC17g_4LXp7PJCg3mlPQN_V`I(wk+RaN%GZBaPD=dax~it3mNzdni_Q2D zDY4Nv=Nw4+_m?~5mmVqb;gjEgV8vp8;hhbSm)UkWo^l`%z(*BSl?~Kj!PiJ4d+mF@ zqKcTn*6tP=kt3V}c-6n~jU0TA`a=%axkA8YJxhOOD-U?rgiiqA_etXU#}NWL?vyIX z6#~kFfrW?oN(8F-F5A?ORHfeB zVgsg;9zT{V)c52vI^#MPBnVbs&~eY_2AEY;JpjPA%RxQv=qEF@=~>64L*;)a-1bkO zJ1qlJ7=jie2<+Ve7!S0lXpF_2p7krq}OmA09Fmb!>^x|+>aKI%`OUZT21WW zG6YGIRQ!yK7)eQ*J5(!M{y=vv@ZGfy2SC;7i)p!O=)^j3`=#XFJ5)z2@c|KrFO;); z%d5D6u0O%clfn8-L0m}fSh4j<-Cmm>eE2%SM03ly^J?R)LwZoOs0T*?5Z0U#!Oxh% z6PdK|>rE8QykyupDN!e}`GqV4`q%0o>O2)Ox*sR?l|D;BqlFCEMFY|_BUM=Scji7Y>^A=?-t~(i zyV@J?K~{C_O4|E=ibpYXSw;jak(Z%sr zhl;uuMk)euN(?1ebWe(xXE}K3LxSm46g_Xg}@NWoH$r`0!-NNhcD>;nhB5n=&|IYEN=W!8oCf%QKxPK58F z1_X7T=sMZi@;P%+`4B#U4nh#8uA^oU1$#?)N8I)YSUwd9HvVS45icM%0+&~BTp4&+ zqcXp>25i`=fZl!D%0j)XC>FY0{hiURP8wuUmv;;z)dNX_L3lY#XuFwbu3_4#6| zp$}IH9DRT}?Fm;MK08`I92(v52XyRAwNUB8j4_>U0d>S(TsN45Xpg1*CV^wyq7k@r zmUhrhP$;$3>Zkqq+dB$gyD&bkqk4z zOF6tG(;ltM#lFh`?4~EAy)G;{WiSqe0hPlQRW%Ha+)W#fL6OioC+K9R|nkq$2qm3s3$;x z$1{`jb59R%rh97fI$|sf`W){e5d7AqC<(%Q0!fI=SIDTW0y_QM1p9EsF4!wK;>wSeGW!9e>)HOJ5AA z^U3oM;?L17U7C=863_nKm%3bd_*(z7mxFKpzrFw*=+I>eF}2Cm&}y;+oWH`UnLhk8 z7r7Bkhc(MIEzOzU1vXIlrMd$uzm&Aw=>?9p`gcY3;xZA7?2lT*#ZDM~Zy|ZT=fb)c zLeyM)62v6<4g#57Ccrjth(bk9jccR?AA zfAsdeXvn&0#?e;Nr7`*5Z6Fs`;6u`dhb|TG_>R zgZ-=%gm%_%N{Z#eybt?79+vIW&CS}pUJEfl`*7K zc7q0)gCQe|e-531-ji}?q-Shc$!0Mu1;P!~6T0meQgy~3(GxKTS&ECTf!w8WLZM(C zv*8-R!dmvEHD=|kbtNduHcto0R9>pnAM@K+4kE;5${ zQ<0&PKOIp}HsORF#dxMPr>m$2$lu=G8$<=cN>~aVhON3=h0IuAwmuZ{ocP_EWkghG zC?R5GZT?3RRPLd=RO;Sek$uDRtRX|?;d8r}=2l5{Ppn{r{JNtq04Gj9A9|>#+&4mL zO-25UC|T1Jw=||@sxIG_1j%3`3*c)@_r3Q>7i|4U*vQgBix#TT+aFeJpwjchLfS0N zNA}qK%^<~1?BnwfU>{b~Qzb#h6Jq)wZQX|86R6B`*zWD!!)Xz|O5s&rI=za$Ue$dz zeQ?6}D$oAUro79wt}VZx1(72?2Y$Baji0T`F|AeToWZ1z!gYe9;}^_2#!mu5R0m4q z8d-RZwi;7=iC!5^71m_Ekj#JIo)@@zeTj6~TvLnQd*ZylNXM$9%R=O^q$@aR%hkZG z6&A2Xok|jPYgkc=kkz&$Q1E9bN_`(w1wlVkkFV^o_5};d6l<5j=W~njzS7DAyaHK) zSk5OfEMi|26p~Bv{B>OHQmIDgzDTPhCNADl*2!ky&wRVarMD4wp^I6kQ`8?0*{6QK zg`kV!5zm>lci?3SsdiB4^}Eo+^?g2$NPSIAEsVjrwFDCl6zfNAA(I6;qn+F*4?_^4 zTDBjTl8r_d9TGqy&ssnM>IswZ&xj} zAq?o~CJF}|i+81MqF@VIX0>3Q!Bbz-vecDT1#j}ouk;9a`>xZkL$_4p_+bluo70j` zLau!?@4U$CnTOyN^D;9dYPT9_wzVOo*6u%{eZw6wMV^>^W9jKA>eM?@Jk16O-A0yn zf2fqaYi*rH!HYt2r^JR=b;Hvhn;H#)h2#&u=Q&hs%?mJqAADo zhtrZcJEz%EvO<)TjOc+sdsoFyO6~D}4BeP)L{~70nX3Wux1dLYM;$joptmCjePaJYjA%u@)%W| zE%gVjRwf~Yuz2l2$lw>^j7=sozQ&IvUqT@_-TG>$A_|1F(_c{_t!Q}M>XdZkR$>E& zNzwMZ>tzBg+^95qQ3kk~tV^^^rj&g1OuJ15Hr&U^Hv;k&>Xgm!_4~oBafWyqpM<=6 zhqeqIm0#T+3x^$yuCbFn?i4k!42c&zQFZVtG3y$WiLUHr zn2*`#NwdblSDR>6iHkN)wtAA6n(i-_e{XH2qW6BA%SjOdOP*(*;2jv*YWQgqWjoK$ z&1t1_+%ahCMz&1LTJ#JR%4f*14B8#zBsw?a|BAA_sdBD#lTu<~STHT2!ZxGD*Fik* zfvIW!r2gBULcP=qKE&i!PKld}DSzgqVY)*@e(Y0Mv8hUH{OD&~TAG6w)2T1WKvWA+ zM`;6#n_|5*$}S|)2S=|Zb?-`Lf%nJcR5u+{KaHO|ESAt2(9Lt6bn1(2NuCJOl`7b2 zG6;brN9$t$g@8t-cCzaOsoYZVy*euO{ebpz5%*TBcjRP5)_Y}yOz>_8&Cu09Wz-H z(coeD)B|y`Zx>O!g3LldsB`P6^u%xsma0bB3aJkot}aY6Eh5np4~vdhB7OKU+a_Vy zjB701qpP8p^G92MRY3R)J3u`I-=M)v{VXRfvu)piS};()@Dq;C=H?hG9Rsqjw{P+M_w7`i}g(NjKzf9sZLGph|oIF?`--zq1aa zj-{&|P>zbAV!cK0t)8&En=pj)EX{%4EaUc%hTf0)I#AK7PiDr3lXMq=)c|vfvMk_h z(Nc7oO(upprZRfd(9wM$Hw}^^-hspuFtwU3{TSUB$gAL&wn61_=N64<(tCd#=(rI4?_Y(4(-KuYTS&YelARAwn@K(6O`8bnX@~ zT*EoCpD^~;95reP4A4o!dUza5UlG!?kOUI{XdCCY&v>vUj$VEP%a!9%%;7z|jU-3bb+>;b=xPo7 zbDmXjyrej^xGgrgWCT*0T}lZO^geOCFwbDL&;zGF1Bq{EvkADZ!%AIr+Vde~G{fyCzJ8z`YG-=(|B3s7L6`fx^mkpdheuG8K*JC;!&iHq7}t>`sNvMQ|((FfdU$>M_FKZ)s0YFB0= zaMl$3GG?alhbrgvw7dajq8y4S=U^MJdCB@L&*J2ogIAUUp%(yX6c({(3)|goJ?TiT zMve73_1FCP*(V|+bO)Oi;Tp!~&FCHKUVXLF{ADZo3PTAxyL2_jQK7Xn_j%db=MCz? zG2cOqX_v2Bmw_``vu~03R*nOg2H~*vGTpQ?Qa$Eu=@7?H`IF$LWROSrV6!9r}a@8cC*szoaos7BY5)z80Ek_0+ z*sMx0$*g0DsD70LcM(fNKJT*NR97Cr=PLj6NGe5N@~VZ0=xNnQu)WI&WyQ?UpX+6n zl|X94%!44)Cbtls;y16_yY&-nTRm7mBSX(_o^CW>88>Vf*?0f>Aq%4E6UpfPHb!wM zXLNW}5w1S-RmM0*a6eb_*J>|3L_o4PQ;lo$*;O@VitNbTcQpod@%MQJ_&>h3Z~XPD z*UJl2$jAtqnMmvq4n1FO315owUFtKX<3{M-FD6Mck^ZEr#7`Y#8UOA}H<7ha)xqVL!`VtYert_(pqHb@_~56?7tk zHT_k>waXSB+rJ!1`rWmx#Tro`7nY44Ki-g(tljNJfG{BqESpk<^s6b%>1#gf-|Z@0 z#%~C7xc{=LDr>v*-K!?nIDf6*v}sFG@5k6_#Ed2>3GK|_k`7Ww4_WJwI6g1|Y9SRa z?FwBO!13CA8;(DD+RCz(p>)$nh)XX^zeu>OeUllm`Xkvz0WofGNlBDnl;Xl^s&|@4 zyC;N~qeaaw>}8|U=MUjss|CI1AQ0Bs24jB|4=M{V!XF1tCW8+m9S7I!g^?Ya2{R*G z&jYOE`SSShs#81Ba={kpkUDc(kw+z-#J!Ed9-BVnk!RRSgc#4h|1*V>5((@x+|fh5 zJ&MVlij?MJv9Kqr#jf<;%;wGYS*lZRi`lj4wNh_^L`zM`)YQQwX9#6`A>%+g)J;WD zNO8Cc!n`_9sZ3<0+AG;*!XF4Vibk2!t>t_pt4T7Je9mpD)Bf$=FEdXVM!6u^?ET=HwCI%Z$IS&3Xtqx6 z{7VIgACRxLmVMDXy+ZFBJ@(}c1tE*k>Dl|u5EKi^eB@t*xGG9Lj)(Lr!qUlK7pL7*V- zn^nef9Aw?TXAFDFxYbOZ@g{gkK`Kgh@gn6-$+}We=hG&ALV6iPp4sMj{%l1O2JYDN zb=+suMc5r9PoUkABi7j#M5b1QUkKWw-0<#)jcfY@i#Op5!^7i@+nefM~hr!%XDmJIOAqdQ-Gns#?j16mw2xC9Rs^?RR=4wWNo@BT-P0z58OIx zJWe#KU?Eth3Za7FmTwbccWhTi){E=uYBQ6ux;Kb|YI#qheQR;L=DU06*)@_va{HGP z@gWm-4$3mFub{agYMMI{z@a52aevg^58yVmn^wBD*n$37I6`oHEnAwAewAga{3xUn znrJ4ll7h4Wi-^2p@FrK(YCaja40o#96@h(ZY4Lr#(REnYbtz(|Zjz0OEB@5kc(DUlC!+A@vx4d= zc8Ud9Dg$OV2-}LSL)Bo_0m4zl%r=XEA%IB_WRNeEZJ#94h>dp#Wo$(K9 zr&Wt6Il@HNhPdtR;qK@utV`lh6=C_7hkeKQ+z_~Yx?2;+Z_<#686SSH^OENs&xjQ0 z+;Om5-0;(C>_DyHBb!*-)eSj8jo$Tc#FXvy7rEveRDgqFM0oqrqlbN4{3vxN_ih`* z$V{2@=Y+;m?RQ8X9k-g52t&{@0A zY4_oEQ_ko>ONdyZ#bizQwvesW1^YNEhVGtLxG!_8Fyf-2R(H2;=*wxdQ|uth$zf`j z0pT{=;HGoGBv00iUHClPOyV3PC>&h^#Uix^eG9*6CFYc$hs45%upW?uP}2(*u-Kjp zHmf;8oJv#QqB(i`47VOmk(;j;KN_h6YKL-Ni7XUI@N7|ruIy19TxTq()UUBJjn?n!8P#@(#A_;_mqOM`(YeR zKH)w=x%v^7R~e-4T{G1%)pCkn?T{!cB1esvxPIC&xPbD;r(xkdB#qf+ zxjE&xL5O^cjU>++I1gF=AjwNNIs-gwSwc7nKau0(j<%$c`J+0K=-Q<}!Ate-rwq%} zYioA_BgLhTRGqs<1{RU!_9kCyrKhLc9JQ@f+q)Huet#UlTL?HLouY#2%VBu7hk=-X z?aA+muegBZD(T*H41#*0fERRD%X?$ZXdhpY(Gt!TLv~Lw@G@%V3odC81qGsofTiJ z^3weF(2Y{9t0bTt@BlV}?f36h2!M=>FP{Rg{C6St|Mvuh|1N0mJv4azub|j044EZY z$9VU@0kZW_)iJ7dnikKjl)tgg#D!#uR%s9j00Qu(hs;N%_E_pci*fbeH~vqtcrLA*44Q3qQ1W1mzg_30rFH zj%^?Qr5zD{Y#TR*LL50R&-j^5*q!ZY*gS4qznCW`__U9g{7)_4uTf5v&ZIMD&Fr8} zPXd%WVrE8CeInDis_hbbi|67wlx%8WwSUWEZMeHveNtR_HYMXa7?WxdM)~@klY8-D zi!6LNjTh)wd^yJ>>kTZ1c=@-3-Fni{wvr}fO&({hE2i@6a02^-N6@pM?D!;EE4!7=;m6uoEH^3#{gJW(weng$!uN0$K zd#-S!cHto%6r}YrT9-n~+~e;2=>bMd*Ytt$TU+;E2GRQ3L%501E`Q#?e3@@TECZB? z_4X-SABK@Xd=h=jKHKugP$G`(D^?rDt}?K8FQ%P8yO3Ut=ZSpAfVL*Z@OafxI*MB8 zw2cwe&>Ph48P|Urgf%(;PBj@I2vFAO&eVojHHL$jAlIa?O4Y!SgPMkF`li}?RE$>c z$jBaN7G@dNq4a*2K@4Yj50wXlw1+#NqA?U|S28;GYSAPy>9@S(r~wG{4x(X_U+(=9 ztfBl-&A2LBflB&a6e8(WlqDnp)uEz-{tlbEV}wTQ>BDrDb^Awo<15#Wc_+v0_MO}Z zWAbiD>of^x1<2aE(kP-80y6$m@^RCl+3wuP%o8cDl7*zKt3-a0RXG{mke{yXr$g7y zR-FnwI{18$FX#=1wJ$1#wMYtOALwK&; zR->t*pa2Up9#9 z@a(4G8?X?f`Ky{+8O?L}qzHg0rAdc$@P;o42hUrdx*Ys;yHxcOO&~Js39FN_a_B()Zd@ zNqV)r0YRHc3AqC0wCspnPNj%_d$t^qp<5Y6#Mxb&TDK2m=>FQd*T2y}+EB_p37;D7*OWi@K@NO>58ww_d|e zO}yd+Rm=(ktW8inP1bilJzYz-6KoirM7~n>vaj9z7rsJmhHT~4_2HWGyz*BtOK-y7 z$)Hit-&R2Ug|OSc*F{&3Mm(*(O39~OllgOh7Y8Iab>;HRIoe(EApqu&QbF_^UNrS} zf~UIa@EEpO%!2rA42~>>=RVB@?lhu$!u1Y$yzOAU-7V{=Z768>V`UK-t64S4<;}&1 zseIOtx^Q=>9x~{iP5C}aVI~ruXr%lo;r?t@MY;+FAgZmsFNS>WtH6555QDcFg!JBA z{7eSM+~PlswJ8Skh(Qx8epds~E+>+r0iCE93w!I!Qv$Agxh%wnBjY1RXPkp+H&II6 zC|z51%^#^h7Ig-kJUhpZdL^qqzMWY$&i9D>u4SQCbE+;Egti!4VEN$-c6ZqkL~zw$ zdWCskFDW6WVI7u&<36E)1>u9(#Vzg}!@x9IIi;<21=sScJ{hy1q}BXwor?#%)f@$SBuy^Eh=) z5Z$sim^rEQ7Zh1%ZWTIS!-WJ2E^LmTZ%xe+H?f;`jKnf4ySBAsvk!UOeeQv#LHlen zv<9#iuh~<%n0rAp2SNu_!i<{PKQ_C~*K~)L-}s5}GRLnt3X2$7{mS|AF|U;eJ|d(D z+QmwnosaI8i0T;05Q64LZhF~Ex?mbWOdo^53yZ@Y)h=rtewNy&Mi3ZewGiAE5BTAb z+6%^fHB3NMjcs2Cmkl4icaLnK{7|eag^44NUs3mV7HNwK_x2Mxo#v3r{?PsH$SFx} z_AhJk2Xr~1)&fdos!YK@TJrWKOJ|qpCW@Zps6T|8golC-?$>q zqzCEC6kSxjj`GEJ7vIvmDk%V0kY-%%3V~QOO}Nu0A)WsD=Zlk#mAd*$)L5m)s+{4; zg8b*5c-PTSgv({F#q3U6=Em--h!Ug4*`GNRZEeAiL)S}%N|IM>(V%;j{J(JB(8}T; z&%Y<4vBmOlzFAGVs^1ggP|J9*M3<#QOID?D1v?4em@u@`_I|5O0TE2hd<)BJO`be& zRoNq!R}Oys!epkNefb=VdZ@ouS0)e+lTcD1Rt~%!xglviTD17u)DGsMpw=5PxPGyV z`ONR~!0Q9VvT#%jP#Xg#7Chq=^xm>;lGu42NGZBt%S6^rS;1v+*UN2sT$i)jnETO4 zHGdYDT~Eg|s77;w&QRPRwrp;$juY3>vF+T?$yD^ILtk!!5ehHQk~z6O!(chZXjGmA zH~ZNnnG;Wkw-PLc}uCU*rYn2Ah^iV10^2*h!5+S&(v zBh84dF55A&z+}Y* z9-`ax9!yS{+dFo=rE^npQe&}8y0w)RJT+J)npwf_(J5Lh;+QkU?^%VM{jKr8h==N{y#^U5W#uwlX<4^gr>%RR(k?HZq0j4^>!T+nql8xL563ke}!pGposatLo+i2afzgOo!#! zp$%fk>w}Ia>xY;k&~()jRPtdLA{CQ#r;^%F3X37*l`s7=hD?x1AMx-j9Z1fWbwKsk z1iC6@VuF^Obe=x?Ip_6-4_dD_s22k^oZ_+B+JL~(^|0$V#~b|>L29lQJbZi{qxx}~ z5S-CsR&Iq^pN2jR>ce)ol8Q+E;M0n2mZgT1F$?cAkew>*ZII#QD^4vAZm}UMVs>RM z692br!HJeNPfOCfQst3lWv>Xsc+1=)1=B;_y;qbq;Jgd2Jy#V$3MFh$&l)gK8y3lc zWk2&6zmp?l_PKFlshO7ZGjH-xt^{4I_x+2z)EQ$hZr^3OaCkt+31gq(&)&iHEM8oU zvsbk(_xsPEH{4=F5^~szDRnx(QQu{v>(G!!{`{Hh%db1A*v|1Rt#zPhi5+dCb6<;4 zVa@4-f6dBBt;C;09;${EQc$HOpP2}#WYh{3TC7(w>9Y8X-8x>h zzpS(SN1-V~AE%{jHoRr!v&j#mfKF#dp{Oj|lQs9_ z=a&==LpqDkiFF=EIheF4f~K=gGM^j*D8ndhZJj!J;T+jU^xF2(fN$qA#^XExYjR> zWN9?VwySy+TJ5hnl)fbgk^>qLPWzen9eUfy;O?<%S`ZB%^3RbS2p2n(bx5(EF5!tT z^rs$lh_}uswf7Ioa(cfNaqhA(aYH+oc3X_Yg1^w!$+zb`PQ}S%JEm;%z0k$?p)lE% zk2E6nl*!M;Ct@2aNTFG3IzdaXGXg5xDsN~J6O!$PDRyzhW@zSJ*f)G%%H>%2(W*h& zSRx5K!LKk>r{_>}j{j5d&|>Jd;>W>%wTfCg=NQz~CS|)saFu6t<;v#+n}~d&W$*Z! zx^HVR5987Yqx-RW*<}Zr*EOp^gbID;T`u%M+8jQfG*dU=D_azLfSwXjD8`ktJUXpr zr0*!%WRWO28{)Pw$=zo^#$*cVuO`#%=e+8@2D^TRwNCNXM_(C2HCHh(Z6e@!rC69( zr_+l{W;c|K#4%VDPZ_$l4!oOQVvOj!S9Pm}ROPEY36iHhTw{Fb%tGI9yHsm2{zzoI zaTwTkevu8Nc3Y2Y)VIl##Jq~hK>m{pFxNG2h8T>P_svK(hqlyCmY;wQm;qUD@d&#b zh__0YX@M?da__2Z`Lk$V+BHp_ieu%kcrKwSKJyPB+8Tcc4r=ArL5#b4?+JHa^o;nu z5fNT_jZ4HV*av#phTp`c)%P;e}T*z*0<$x9aLe*=%PyU>0Xqks6me zDgYR0z8f{c99iYpHxC8!W+PncP+;4I8Z7(vie+KBtbFL z^NS>bX4b-y5AH3Gj~-B`WhPath2Ohde*m4j$7|h|QuZeC9%tNo0D8`381CU~$S2h@ zP??bF3e^3{}er6FB(ePK4#u{<+Iq+^V&ET zv3_-4nyE=s|84*J_oPS9pO1}e@6BiBeQ}|j&{$q;uj^+rLk(ksR)6L{7Pq)E%F?K+ zo*NV{t_viSe+sw-!~lPX@tc0!%6#ydL5|xz=pLi=Sm12R0k;37kcT!TZ)i9oN>kZn zfk3)lDe(I(78%S3Y!z=45j~YXvAt&PfD*F*KzWsg#>h+09aTQ|@P+9IlT1C==gVU0 z)I@I0$@dmf)(3Il`s?-6S=yRE_cwPFhjCtaky{gWNn8+JFHP%~bR4ZNjkG3IArA9N zORiR-Kz-2gHhF$5cwv~8iPB;6_+aqfp+0T*amD*FrZLx8HkT72^lEna=yew-Vb6n} z*{RNq1Akh(_J?5oSoUHQGpnq(x39@g3guwjDwy2|8s%(a53_v=B;x;)NZ-hb=YRVC zXeIk@3@<(O{T_1E;vTXXHs~Mb(OXlLUunDyHrS?04s+02)?%}NXKT=H|JY1q;E@Wf zlDsqrqpw3Ta(YAgymK<_Bct=WUcQ>ZYi1Gy*Y$9Cx`mY%MTRJesjIpXXrq4hjv;4k zooo=b$dJ;2X|EiRnv4Esq)IQ%{fX$I@7>wZL@N=bh>Eml;XIsrfC z-r8W#)2qc*T?^Zyf%i)ft4eCcfFW9rh6O}-b|sb=rfEjZ?nsCG6#MK6bZaeUx4~*yxL`ZYcdS%LAQlsX2VRM;o*C8i(SI=km7X zGCaq^`2#XIX(bNMPy8kZN8V~f3Lu!zpC!;D3L{iSSSt?%OjaesB4+K44=;^Q6nyUW zS{&ugA2h61$g2#pWQ06Ji|8_}qiX5AwH$HKV=9ilLrQJOUVg61j1IF}h@0{>NkX2` z;7p4$uyd2}(2B;!p*;eLdRg_-4ouWo@oUz>!t=0dx}x~g7{Ht(g~DhcXIE45E8FqZ zg|7akYb?PD9CmQdV`Li2cKy6wJ+_(qx8R7JKqMt}s{E{z&R(h8MN8U;OLkg9uiNC_jt>|+VeJ>Z^H37_S)54V^4Iy!9n zAu&3^>KsUf`KKC*_20cgxK7nwCxg5$mKV+A20v=WvrEG)6tMpHbg4shwDs>RWDm9~ zLKSwW#80Nr_I}rKnGKCVluGHIaagOv3=OZKZ`Ay{zi5(gP=N_Eh6w<9gb5N_Y0m4g zdPA^Qbb^+i9=PJdTqY%FpKJ#c*2zM;<*_~<_hqbY!Zp4&QX7&loS>#{Q50zse^gMP z{^H?j5EaDqTo4Ss$m4NdYBZnz8K)%|!)}tzI$C+*_$mc;h$Y4LXJIJZO1E7gi@h7^ zTY4w&?JBgedoLdP2urfh?{k;siuG1Y8J2m>8tf-{3@$3RcqO0Y4IeQ!yXyPz!A*wW zb)RKiMg}yqInn*ijjzZ3hfIsNPEaJ@h%jXWgZdlV>a`3@MWnLlQ@Pvk0ZFa|4 ztY~IRcEr`E3=IQq41TJV#T*taCpSol@8VcgXgEsQx&q1FbOh5ilqb&vxM_std1i#bTy0uX6^U3O|@Nm-oN`d zSg^8id#m*yB<*h+SOK2;W=r21WxE{)uRd&Fy{89<^jzz?Y$M@H+L(k?Ih26{5lA!SdQw zJV|!#H<0vnppRm`IH5J2Um|lpSf-bAU}J+;0;hp~zA|@!-2^9W)b+WnuqthR9u}09 zbQt}iAB?~>+x7e07F=;WkW~MZ*;+>WJ;b957kl@r8Njv^*jpR~n85=0bA!1|B}-f| zVJ@waL4gXyyQD8h*my{7gpnmo*`@1)WOh?l!t29l?QU%w1ztB3MQn502gy$KB-b1V z$3o$SBZdPb>mKmgD~z?}6%4n9^##xsH8I}-n9G?93@}e@?Ti3I7XjDP9N@46p<56< z{|jIKKS(jfd0a`Xl2x;smGke64@jv5`~QuAj9bdL3W5b2*ADdJLB30v)PHmOADHwx z7C0Z2>tFwtzQSTZeG%{v`x_ua{a5<&CnpnKdpwW$QxW5N3kiWap0?7X@-8X=lFAfE zF}Hom{5__;1c%j<&o9Zvw%X3*h%|uMB#q}NnZ3~qY}|hdIF*cde}2KUlKw?rVi6fY zI4l0ZlZpu{DQ6%w{LjZO8B>=OrXo(XW7OY_DM1g%LfHnm2!KDIh5&ZCw29X@qtUy( z>cK_#lt;6Sored3BySZ*jUemQFN9x7WYjilA{m<>+zY~GJPM1#n%`C4e$jki|L#2{ zKFf`o&;DP&{On7W->%`digz*Oc)}K%#+6gM-9pJwC3?8gu@N85YqkZ<$V-ifz6sG{ zZ~N7N>kKawK(56CO{2qa$ytctp;Pm=0VBg2w-HPHrxnLgfXnsiMj+PC!)fh_vK)R| zNq7Z&!4>aQ(^G&k>>_Lh=G}Z`{FWTau2Y{Q{@kIR=d{W1&ti)zb*UgCJl&0`vxk%GVRNyUHG1r4Hp7Vtla`^u=en&wYpBqT_H z5Fi8yg9UfjguyMiGdKZ)>!3*p7TjHeyE_a7m%-fzcXuDynek;N(P^Z8*{hc-+oKTJ_SHsC`Ohhmn&Ko zH)oZj4)1{5Ui7*gXPWl4e6vx(wjhDoizBJM6yVcQ7+$`Pyt{(nkJw4E69bUX--c4+ z@8g8@e@oln_641B5Ce854(1YnY@#)d?AG$arrKgN$oGxy-=6;gvJ$tq^|%&V4^C$^ z5*Nz;E&Tu}%`e7UZZ`lyrvlltjZ&M)j5%-*si-JR8Y-Qf1kzEm)@2($K&djy%6YxI z_A>HZ(sV!T%@= z*trqsl;%<_9&>=~Di3^(NGs#YzU_z2BRGhkps=?U!+P`s(7>xpU-+E0g=GDJjuNk4 z2lK^G*MV0@OSmFDP(rczga1X{0~0O%?vE3azbTFK&vg8ohH(D${onLCz{yKk{LTl- z({-;X8(6s8IB_>U54acqH#y*xr7}h0t>FYLdPVV;zYS`);8)TYm%4<)| z_y1324kSPX^@t?)@ybH(5?ErJ<-hmvKwX*-{}9c;iQ(HH8vL8S#t4`Hft3D}{%=1T zjRH_4{+lWv16}`5`oC@F*=)mu8y+Ud#PcNc1pP3rzmY-!0`2PlnmTaIpOauB>bi#j z!uZ^%hcnWRSRMd=zW+_UWZ!<-igWrY^8F_Vg<*I<+5=^X1qVk-N(!FnDKDj&ZJu7Q ziQ~$)EVQw;H$B?jU5fD?SXWN=Cr(j{JsilCxyIJ|fcxG1Cl4nk0Z-14fyvs-C|7)o z8+(~*T~Hj8OSOEE)opZ~z3|1#WTe0}l=B%T3VZMpRCkmGMVP48mBIZa)osScS2bo` z$o;74)BDeD(1$3(iL=L(^K@ifz>|#Ir_Hyw-#L@WfaS!KrFb=vVEz1g;H*tbNmJ?P z_Ms1!+#)DLujV>mq*2}?-FNG!E0@qWWK#WQNCCH`7wtg-53Bn_Hq~R2IV|0^`Y}*Y zW&(uY#UZj0j$A|q`XcT?8z^ZX0CM__7Gu02lQ^VmUs29Z%F|a_*q@ zmchtF)erxCus(w{YkU$Lnz?r=#!+Ot!M_Iocya!ki;~AI-)w`jfOrEoU))ay#Y$7r zgv|Ms3j%j+xn~_7?*Tyi=Ffk#_PkTszgC;Ab^pyy*JQK%+qGQPkbmAO`e8&06p;P5 z$Hfz`E`I%Kc*p#2Rwa(-IErR&$G`QCXsZ5gim~W#){yF-;r|tb_xH5|3yptks{flM zthMBak(R9a>7Un77>4GS1)~5&`sZ)2|7l4$kZk&CT5^Kc-{*V(^W1O!^`9z*1D9$r z(y9_v{ys1I<@vY%O0kN6hCdAfY%N2Y+xY*qFPxbBcPLOS)BhH%B=Vd`nUU%Lw^c&N zzmt|`Joa~LCq&AzgcI|W{%t-(?%(P|dH?D0kn5$-qtA8s{}e{~s%l1Imw^LW4*Bu{QSiY@YpYVcyYpGxBXGh z>Mn!n&&&u13a}U&bf4K!b_tw1|1*>OhYI2J;(!HZW1u)y%&xaXaw*wj`N=fhO#u z-#sNfIng@RGa>VCbEYfpZ5MuYzzeC4CzR2Ob&8`)C@--!fOuo9Ts$e%AYXlkw{rtN zRG)d@qkurfWEMtgJD&~BP0iA`)HS7P)m}xbu0<=qidCbDZUoM_cObiqZ6zB@2@XpG z14T)(&HG=GL%3+c7>6~r0?w@5`^<0*-4l^5>ig7AFCKVZ-=Hg0~~zMZ4=fHc=RQh^kaLk11QVkH4zW3sZhl;e^Ske9z7eao-s483VzWyo}pq}Mt zMZzM}*sck9LB!l_M1}GeLp{GIW@KeQy0R8ER?)(O@Vz9+6Ar=RWqF|=?VYRKiME_o z{X@xXvryd^YWHO!`h{5fP)X6d=}FXHTFL^hWb_b;q8n*>ak_S1Z-j~`k~`tto+?M`{+G(%Qz2i24%D_+1s`^F0agAwENNM5H;gH>=U^>{*a&PJ;C zto7!TlcS)==h=%#%9><61O#Olw+t%1gTtK;@cf*l`gjZ8V$>uoY4wUVnJQ&D@OtNU zV9u2s$+rHNuLa>ll6bFP1O7Nw@ZZOM?@}^%I)YHQGWt;G-|_W!IUPg-nC(?WLvLG9FVFGe8>h)Em`iFgdzx!X)m)ph?cR$)esrJd`v6* z)Dfa=FhJd$x&j@+ey++ucz=Bx-VNBpR-yqElc*-NH;+j02jSY!FSsY{$arJ!@#7Wu zo@yi#A&>WQM{i+aTaQpa3w-;U%w_uOL5A@dIXwhbG2r7 zx(OlAP=pKA6W-jO4!o7e*8z(`1ka*r?A+JMfW@xsg_<~K+v@D2lOCZs zI3itV?r-;Tfo$+;TS{7DS$slB?h6smd>^Y$6V!PbigZCM#JncE7_hgZd?o`ZK|YjV zb4voO@62|tTbr@v@9$roTC4C$Q4$z4>^h=vb3Yzg-LFozW!3<=je+qNyZ#rr8omm&byZq}V*<5U2`_q@Viuu_ zIunK(>#&X$FfTy}K1!O-v&Xw#_lXAPnc`qz^C>BeFy~D9u6R^Dx&$_|Ha@=XBTK+Q z1M1N^x|?vGO6$@+;r;5rbUgHxqTiU^=y0MZ`d(oEAr9TNK_5*0^5^~3c1 zN%FFRm)Z{_i1eInPoP{cWjc+BfX*%hJ27D0#>vJu;bwKM2cj*?orh|+c{{&-@l!#- z^TKD^)8!C^BHVDihd?w#ut4>1!tLmE+qmranqPhZgNT>PH8d}SBmfa{ZF{P>RME#UvYAdQ}iQcX$!RkVsI<@(FvLr($q z*P)QdD4(4f&tH=aRD)mHoTQ+Vjyjyl{ruR2J?wucz>WvFzcVyWPxad-%iZ|6!a*z@ z3yfLC5r38uKJKtE)>G6CS3smQIDMx!4*u*=pKTy9z_{#^;_uF1Z$XO+NGAPpAFRO2 znhM0Rs%d!y5#>LXalQG6?*UqTtRx~piX}d>+2R!oEQX3`W#t|`DNs45IEE04@KamI zQboMcwO7$VJ>w!S0o|Rg5=tzKKm6Ne-7X zamQP0tMt%Wphvti2!g!n1irh2dSFC317vV@|hywH}3CZ!K$N`5>JtT zK32i;4y;T$tbWfFP4g@n$mtpxE!w(25}tqkUxH%g%^FQ&z)3%9h^lM_Z~D2_pI9;f zq_mUGld}i98cON!**UEN{$F64nzaTyezww??muNvlEaFtJOCkX_CH>|014^;MUeb2 zA^XQ3;_FB4;@tNNvTP5NF+Hc4QG{>8l5dvxRMb|%tt}-UWyUc)#YsS0j|2~q<5)Lr5fCc@zY<0@)`z zSr#KAJ?f~P{|}L-GNv4~Za1`)7RM(E<;fbyd4lG6#$fqH;Mzq#p3}rYzRh*|wQ=hJ zQ|ffGB`309$=bznWM;z9a!(V zxVyJws}X;Nhi6Bbkzs0JvNcmMnTwW@dc0%usYEFXG0(Q+4HuOgy`N`?i=@?sCB9>* zb-kTyl6E#^m7&j;QWdD#YwYtFhgdU}PRwCD;;v@Z4CqV|5fF!KDr@&|5fJdz)?yIx zUB^qpzHm6u7u+pd+Uw|fJgBUi8jO{+8&Mt|kXGdzaD(Y2jxM%P3$q-V(>x+uhv)2U;)VW`=XcEubNlu4 z%X{d6yiRAkrdEA-d{^ecqIM8Evc25c2mBJ%yhCNQsvSE}3KFC-es+iDehlH=Lwmp^ zH*?&=5+Kcnl!6sxBu7=wdr<3-u^B4%`>T(H>K8Ror{lIyqcZWRPju*UYlh3 zYS$iagb_j-`KG%vBk9Lb)mRJ#zwDQU7^L`fIFFfaC+`ivMEM-X%4XALLDV{ub%rU= zqXD(OLoDAm)U;wIr(Un9RiF}%3zGHb|Hl^KHmakB{A0o8fSZ$6^6`dvvsF<3s(Ev8 zdO8Kmwuynm<&m^Kr>9_+vpB@fY#tcNWOEO+T|bXg6?qnM3f7C=w`310Nve%EabAVr z?_QE;EB4@8Y%*JQ`VYejWgMf{>hkdAb(`W;`+EWzzs&GC{N9n*WCLgR1wE5eQrr-r zjPkKW9tXEU6%B%t-v*Ue*s~`cS=4mEY49jsR<~gk@0I_YWza-bNM>oOU^}_eVekvB1k-tQWD@~>HG!#qw)$sl9En8Cp zxd8@ompt*RB}g9ag&?6)_9E@adtMj!%N=<~hqdplD|6Mcoo={YyVTHs5g2>-6H1 zSMKcyS!s&^xL2W-$_`ad@X_&CK? z?D)xO(oRg-%-I(YS!b*jK%*J-PZT&okRiXMX5Hnyz=240K+w*&5j4S;w3X-^xN(_%_U>K8 zUEK3JA}}n}YE5pBd!4n?MPZ9VBXGL{}Qt`GXJ#>DCui6tX?<-Av{Oft28;hR$ zyzqkfH%2Nd(=VO%7s61{-M6=naFfmmK@sA`mh`AnDm7$HN1qW-GS8hJq7L?D*(p+U*s@Ed17nA12lmpQML=yuPOQMm}Yk{hl& zi5K3XsR+_nM9I2}jHYM(Mf}$o3C((~F4VB=X7wi8ozs*Rx9>O+KeHZ2S_x)QH#XJE z_o)>KHRQdUaKEd86z{9K2~jgiVl_0Lv=q zz0zJr?F6ehlMDG?BE@~uvjDq?mgSIOhcC~B7N{oWtx7CbIqVhtIB`gW!z-<(>k-hm zXkTLQE{_r&xti`SA~qt<-C=s-_1_=Q!zZj#v-n}i!(uwgJYy*lx~I*OZ1YJAU2+ob zY9y8pc%zR*wmdeW*&IY7Y;Wv@>P-6axs3VITp2ZygE%=i;(a5zp{cVjg;CTK2J@4t zO+v!pv2;sRlmv=E7?ExVZg|@4W=T^LSLt~dyUAGT5rT_;CZU@!amy$xi%v)MX>(!& z190WWAb;s}M7IzzaEUchLR54ORi%bt%-L?A_qX3ZEK~gad3y|Qv7Kc0;;EM4;ms;- zhJ5Oj-LjmKYMt`uZ9%=w6DAoa*!4=IkP;rnq04?7Vvu`mkD@oy`p*76H#4h1g?jH+ zJh$6<{MBkD^ie+%!*kX3d70JSdJS9)e*LvX>(fyn5S+N%iG}J@m7_*}0od0JOxg21 zm6Z7VYm+wR2O{Uo!u1bl#L!ds4j{VBExSx_UQZAX?^^6-O- z9HEOIe$UOx73|@z~A7 zcw|hNd>;DuSq;Nxq8;N>VuRiD9gde%wu7>JDsGdC#nw!r| zD;+yq=p!Zd8$x<_Yf%|TZb0B`92Na!n(I-ywN9YtT4D|4G*`er%y?J* zW`$|E${8KsSXZEuoY(laHi7QxM+L+KY&B2goxy@o6Xm0J=7%~u9~^C+rmhURN)R4v z1(Ww1zb0+)e6?*;_;c*>WuBXdcDJ@fWbubc&_vQ`m4|7{5xTJ+`o>X%CJYvD zEH=<HaRS&xvn71Ht)1r=tkvIvEnv3VZ$D(?_~&NLq660g1+b;)f<#4Z?m@6ud7A&D@rj3pGY+pKADXe)V#p-d zk1R>30YSI~csb&d=mXjk_OB9Hm6fkf8*%V&+pWn|1`lpd(W)Qhz}Z;uT(iCDCOxLp z*p78UdL`aBZKoSfY)b=;sd3v|pfmJNH|EFASmAf9O#UkItE7Y$cY{{C_>0!PEaI5H z|AmnAVpY_((8S=WY6-Q8x|C4)QLGSdZ|${x*ln4o*xuVQE$ri6FG1brebo-+!FxvO z;JRd2u4RYK#sxu=oeA~t)g7ddH`#5v-Z(sYnD{`K>LF;^Sijj?9eHs!6vZmJmn#AC zo>6{;s8)pgO3qM-B5l%A@|?rwo}pd@ufNw{4t=?UPx z4@N&KKTU(ktxqKR9WDQE#ze)l=V$r2<5}X>blyG?TGKd}v)sOx_#6cCHMWTSIR0z) z?pB~aVujFtA;)PS@zUJ|k+Syai@I)v`_`yXI^7!v*~znb_Rh)jQFOF<;M7z9wf*8K zVzDi@A_*DOTy|Q4r-Wok9PjDQaI)6&$^f^p@nU+bdEE5mC6iiSL+-5}`o^vUaIL{< zoTeUvu}POob1P~<=ks0HV=hP?v<(05)LehJTbDbB1C?#=+1?@=(^1n$&+$A&_%L-& zRe-@Ca{`(VkYqN4$J7jjAjZAbI|dem5Q6a8_I@`{nC(C5@{PutFvgovTer3}*iYPP^E(W!7$e9C<6?!_+M zip%1v%NApGf3lMy)Lhz4Wwnq68khU{n>pX=W4y=JXlmO?CVz(E#n=qf_mDexJw=1jTIpa~w`PHYFUDWucfMV^w&o(%1J@Um?k?L0gEb7KMofDC zE|Mc1&DP3Xu%_+9aqQ*;hF#=Xy7eTz7Ef6NnKZbOg68m`)O?(1OdDH8-_)}~r{$aI%ng%d$~3Mf*tVZU@w48S&xL9gUIwDB*;Ha2lR8mZb~|@$R5&cY zo+s|RVDx~w*D_ACc%*bI(H91abWlDeUl-fHcxD!HaN$yIY>c2#dl;FWi$RY#bc=~} zfEtuPJ&6k;sS_$ymjt)&zknnSb^V}ZJxpTp+KP@lAYZ%s@BtsP$p$Z!)*i49?2xWf z;b|;S+N;&S0_?1Ky2cG{?@J5#jOr=`#``wEKo;Q z^c6WPGdssv-pw>oB0>D*t+;C6lx)0S8?GUj`>oy!GLdz16AW8EH+tO`wJxeo8gcas zu=Y`hbig=2cGec5MKj35JZp@+kkq}?JNvxlAy!N2t`6k<1 zvc}Tj{(z#9@7r1dSV^j;8J}p&UWt$p3C&V~`p)p^IM*xMal7J{$xpsh<7rD z#s2zAw=Wf4Kx|g#D_SvL&W*HBFiLsl$=Tjjgsu)uFFWIFx9j>b4_6x}G2If>%oSXI zOhc!?QgBIDG)Itdc}dPdcoEOvy{H%#r(~jy#-Mwgi6;#%&-_ia_7)qBm@0ISF|&Hk z1SL&y!s$|L5TRSf@au=tYp~9(;Px`Fs*%;f=HA-+=%nGMp1gcuLg2@TIv#AQ5M_H8 zsv#~;))JoL6?m`1btut9ti&S!7hNV1G7&jL@n8gYQ_a^ES|!j(w4uNgaPJQ|SL7-` zHkuB#XT5t|!&iTL)h39?ftOpcw14jYC4|s<-44tl-yRnfS7lcl&4{gWp;6X%(CYUA z8ZjnfI{F$}B0lPo$4b3C*vzb5XG|%5A(| zhel=n@E;W`$ zztZ6|6>Cg9gPjdE>$rn=p!6kysa<)mAcaHiGeoU+hd;?jN43XlamkP#Z0y-0VD&qR zJp_4M32ZQW4UaS{4~`TjW>}FwJ!80gCrtg_h|~e2Fl(@@xl!nNvkr+5vNjD^<1fjj z4QW<->qUM0Tj=J@vT?n+adUi0HpGu&_ipuPmb~C0b!U5fn7+SDN~}aal+{=wKE+eM z7Z*68c@5G&SPC(2ZyZ>9unX19uknf+7(_(@3{F}@jmREj2*=)rF^zwpibSMUC*1U^ zYFbagT}44#3|f$~+QMuSGJqg@BU6g;+8Sm;kMzB&*_;mf*?!3vo&Rms?fRm~gNo3Q z-D9tQiyJre#r_NPC7m(Fh1 zov1M#mRoJVk{I0RG4&w1#kKg7SwGMUr{JgwqODj~iq5~AaW1vc*)Z7NVN<{F)Ubtx zs3h3&DV)g#&I1np?8AQd!#m>oX_wk-$SYoX7T-G_w#Rm)+;0|;s~t!4v-pxkHhWrr zg?b}VndGFqnXGl7UyFT`8~WS0ejbmjtmStVu=&QA1RGVT8x|zcDY`>NRoV{BqFkk$ zNc0E4t?XKmWAi}yUW7!y_m5SHg3oT+R8Es2pLW_@P6=kKiAZxB_nmEi=P~@E5rKf& zXT<>oynU-(ma8OH54>>TiEz)*>w%26w;XWDm~aN zsJf$m0`7BzoAvT{k?t7*p9wF9>Jm-EfJwr3PwCf&0s2P+;9NZrLw3(Cqa;ekB%tVz(+>#T; zZ+X5hx`1ho>q0wAu+wHeXTf8A^01`oEU+f#_drXzu|Qy9ZY99?8_3Eq@NP10pr)&s z@;&%k-SP%1ABXJ!G5s@t+0C|x1uaj3<>Djx=rLuZViInxy;AmRQSx8|r^;(eCYbGZ zU&`0G?w|;}fR8O4hvaJobb(p!-=!1IsMf&fqlh|8@SqPQ8{I$?)njDwG^AkwY={m5Ag(FV546< z3UA5ENUi)N<^z6h2M#K|cUjn{SD5_*a83ljWET_;&WX>8wUbhkaEMdi;3hh(48YnA zcuI1EUQ9JNex1GQ|3M;4%-%a9@~DOs3kz6NxnaF^z9FkFwzl!xrhQXWV+Cb~=nWb> zWy;X|%|s@;Ps!9_%L5ZwPc1!MF6XBYMIE71Mu(lj)ZdSfy`3zt zgpe0Cg426TA>RvXOKlO8&YEZMgno5J0{$4RC@8A%nJk1nK86ZK;u`-fgioI6+LWy< zlb1vvf`j5y7rMoZkJwPNRWIZ-)L}EMg2gRs3okpnN0vO_#B#8YdFf%Ampl_`-lFqE z+^}Yn0rAwyDL7{$`)~^Q8@_ ziI>`L$C=LwfoK0SeZ{X8a!zcFkeGz4wY%R>tRv&?QV7C*yyb;n7?Q#9b980js|eQ4 znz>N7a~(T_#B#08^6tB36(4#;IJfkDdVz240U|!*eSH^xQhF2m+-x)xu$US@`Bb@W z4Y2*bKTu!mK4NG@y&j-kZr3pNTsXgqr$=LIa9&;>e^R`1Ms!7>W_NyLJ^48Ly^HTS z+r_r2brzG+DVxJAn3@*FTG9_Xu_&Hn=-UaBhWk)b%&)Qp- zkE3KSVm-=+Mx}5cRkB`Fsa~V^K$qz%>?j+ZMab+ad3^Fa+SN5VbV8Bc2Ieghrt#-6 z*`g{U5s_2=9CQvI+xnnLswX~ysRWU3ES1WV?f$N^MEbfHj+#~dC|`LU(3APExuK`= zoPiP=g!bF1<65n3c<#myznfVM?@Azs;wimjhKVtjAq-3Y`WSEBp!IQE&vSVhXvsuj z&nv{8aK7wer4F;Puz67|wQX+ZPA)Ki^iXmJ;xS8CWP3SQe2)dEV8XcEs$;WJPwx&o z;M_q+q~+vW`QUh)GpB2QB1xAog5vFOLf_2JZVnT&7VRIBHllX$H)f9OVt<^SwwQ3y zf!Q4@fM6p;}mw3lL3>MH~|& zmE(Ox$*pY_xCNKo4!W1)99#D+z#sm?<;VwlcET5w@-0sy`id4#x8759{zSv}+#C9C zVysW`cUTg2^=$eepg*qSq1J7@T!#oXpIK|-$rqOGR1^Tb($uX`y-f0l1!AwvcfVwx zy=~Nf+y%npX9}#1e@Aj~ve^^I%D11Lubsqkhjx8|eRcdn5gy5EkQ6=PD1;(2*-0IlbBBGH_;MN}PY#=!(^yM&1rOQ}UPjDm1noXIZ(P=|)p_8ms2h9t5MyknC<5 zm)FnmGV(Qi>cPb(cd*^bpv74#u%4GIB773MqD*=GeLqCNF^-;Q5FS}Pk0Vc-RZqYK zv*)NkY^iwiD^UvqgFjH=S4+SNFM7MIed011ak?s#ml6zt#6m_AJXyQoO*ih z4Lor=!}>wu|6$MfP0s!waVxVAR(@S%SoSxnKY!`LT7(WW)ci-Z- z3^QG-*zvPn=#@tPm*_m{=7cWk!;WxUG!7x<;&n{bUogMOMdiZpwfTwqk`XN=u3)fx zPw*@k1(uT`DE4mu`wNBVDez`ot%16UB%$sXY=%F%aSaXaU*OuqP%C)c2YiwXFf&z- z+TWaM9-UbXHtcYmR)@4E1i#&?CZpADJ;`dxai(@@p4(}mqjc}cf_*s3#}561DtD~N zAkaBA^)>5xNbOvE5YBu@0vV`@Vs}Dz>(L7-1myzgOs(wt;L8VzZFY)n0hdPEp?z(+ zx5SR^R03L(?QhUYCok?!YBZbrQG{2b2xlj6OZh^{#TKK?j=K^c749H|0H0Hv+LYMX z8ln+iVd;}{SAer4o$5Eo!5TMoR-zwaX`We-LI%9 z=>pXK6g&ls`p(9+ApL3kKf~}cGpUVMvsB_j6K5KT=-4al2~9Rwzr;b0TALXqp~kk7 z*y0#?i#3U~1-<;_*tX1(~%%Am2vl>LQDc4}x5c+UvWadY8 z$Gv3p^?w{A=dBaWXCAsh6*yU+*M(WJK2KuuJ?dHDKx*!_u`t?P;$R&u=IUQ~dZd?6N&JvivsMxK?rNIq?@HOJHxouz^6Vul;}?UMS+;*0`m3MxgDWFfpgp?*#A$&rq!Zf%u`qP}L5 zi0a=x0jyS*I?lY3nebl9w@i{UeX&I2*0!P6x*NOL+Z0>_L2VGKO0- zam&{I#}o$b?-(fQRp8*?u!JT@wf z8Z$3d^?n!qe!B46KdFo1&OIbQBCzb(!T!~pw8C+3>nxSsg z1{bz`-SW)N5iuZnzcX^8b$nk+&}Od~UV0QLhrHg2$$ZL$ zM_Ykae6#irph%(hHR*$!%4vJ|dnGOUd0W}N?I%bRnNxupuF8mwUIQ+#!(kJUn4aKP z|JDcuOFIJFt65vldT7KLKFVp;sPwD5p=uwgwX^+ks4BV6?&z)7I0(3pJ|i+m-znU8 zGMJm|Ku5vS3!-i+<8QEocOEJ}QA>8(nHkW+f_-Dz=2@@c@|`XR1G-HsWM6#d#}u`7 zV&pkIqp&0Wpvh&>zWd80offWfBgkUVui%`u{p4YTt#nf<5JhJGiw~>y;C&JQW;6X_ z2H61Hx}ckFTeX{_Zi<%^e9*M!B}?Jjq5^JtaZ*qI0ukG5!*wrrt_yEm4He2VEy3$A zaHQHPf2#U*45Uqi$k<6!+h^N744?YPUG(8$4aeJq#!Qh&k9Go=rX#P&15X#;>;$z} z9bc~X`WcD3bTNG&N}Ac($%X&e2=K?Qll8jGK)bO1%6dpFRI;(RfMe8H&aF3k@gNbn zV2CArks^6zYEk+9GNH@knZTI#vG+Ju?Gj+v|7|o+)e0TeoC^#FKP+MKPQpx;QdNx& z4Dhcyzc_JAGq3RZb0rqACy4YpIOg)Od6)G=DJC0CA`{?#h!HeYxN)y4pkt34GBn(! zbpJ^LZxC*P`6bC&`0q`4N=27evXE}tVwSU$C*QvHGIYf8%|(A=Ia70;;%}OCXLruq zDSwC)Bgu@#GM|za%!3v(AiXTV=YI4Go2AuCB;_rR$Kv&)wi~ovaj!}cv_qbYZB_Jv zmKS<1QNTC-zU#hAgEB30AFFGTSO%?_a;R2PTx6^$s&4JQF~LNi+jZATGG8@nPJE!6 zXqWN&;~Ot06DhiOFonZe@`$j3k^n{t6W^I>8o&n1=GSVV#*HHQ zrP9omLNs*PmZSv;BUJG>A(64Ka$Rq~gSn@i8Nk%P5Ji2>$q8%Z7Y`+3@%U5U*N8W=<# z-momVcih$^M>-mw-~~0ov<|jTOc{0i z_|aPFLuC$5sm!JmfiOdekPh2@eN!@vo!40+mb+Zaf*Z{rW08-YZ`9S@&WV^!_b+>j zeRVcn<#+I{M;~KmG~bKW+PVn~J9y?P8m(+|?8N89VDw!rJNp{()4XCe?mzSo@(kS& zf{fnpUI~0tz|N!0Vx5?3?Q}~UEaWkyuAL)&T2n?aW}Q3yX?$J|B`unujYL}L-l#9w z0LSNpjpg|i(Wr&WLIK+HRLAD|#mxb0b54}(BB8r-GzZ1UqK*-CA9w@f<2 zLf|h_8SpLnY*)oxovMEK4M11N%;2VO>Z$|+_|0x!%4N!vt?&+Q32=RJiD%u2dDpN9 z8BP3J(zoc9u%k%TJ`TQ9*H5y{j{0TU84$Mv>(oF#ImB~7OH!!(EU3@b#YHww&}@l$ zwln3`2n~zad+}EEK$?g^n?AH4(ETd)P$xq;Nc{vL@8K6iDRV%GuS3UP2J|i5ta69Th2*R{{;oqQ^ImA}8wIOsKZR+Pn z6w{qiK9MX@mcW9lHaj-5;AW|?datrtw7pq?J_EM>6CXM-R zw)}!m=Xzhz;mp8DRW%Px!(M9dbVkZ&)q_506-;Wx+PM#JhVWhX`5^HPK}vx?DU(9J zmBA`@O3MsWlIP&rE8=%%6U#-&pxIh|j|-AohLr$p*HFT_j1E&ijFJ*DQa`|Tx$2K@ z=q?Zo7>g9M-iD8drlIj;XGJ|~b%@*}-^>0~wyB#XCKpJc(6gb(lWI+y-Rp6vB;cpA zKV|wfZjVSnnpH-(>|RU&CWROr?((IDh&nQgqLie;_~s#G?g7@&(rd3uKJt?GN%+wq z#|a0{Z)@@5`)g}v?7e%}fTAb)d<}xoUHn0$Lunkf{)HNs=V3%(3`v8%N?y(Wo?l*&hWwEOO5MfKCX!8<;T7BVuE$GCEL2hP45MH0?9#QLx_38 zj4~i@CZ)TmW?xqKZsA<|^R6Yj9Ns*}E4uOs!(J$0Aka`ZZEigi$YFDI=G8I@u|1gj z&LvMp6A=44c5}v29Ka9&!bj~$rL=yJS)FK|U5;rA>2l^avGEpm!1EM;b==AQTGCYi zsJxAbCH_!Q=a}_sW+y8B!>v!JmT zw{8@vMO2P%Vvla>l4yJmk z&HP@Gn^I=^X;@W>PhpXp4>nIIq|&^R#vH(I*1zg>nM%6o1fu?weNv4+zQ{?v)j6OP zxj0H~T(r!rTja&G5VXIVOLM+!((XGNY2Bd?g;0ZtOE@w-V5c@Cs3@UK6Rw-HaH}rs z02)PA-~Bmeds75m(C;y1v~!ND^KG1K^0Qc%+fcQT=rR8OpTlQKH+}Z|667cjPM6US z`GZ)_Jgt#8k3y69UPZi&)zvK4JC*6vnR5$H=J#x|aeH+HSfL9Pc0^qW+Prbmzwq%t zZ2z84n4JLmfmXea|@#DO$8KHN5QC!hwm1(T<-tiQph?w{bNn!~A z$$$21ws7tK^w~U=o&C}ZSmIIm+gc742SP60x74>!H3jx_`s#gsQPYoUvwpW1cg4k5 zKvLJt)3(A;7KH@%1@MKv2_7||1;)szXKn#Vg|wnlUl{eko!#;m*{)yupjkoq{9c93 zs6K!IXMMQSlrg`>w@obDHGK8#no)EA1E>~#%^N1 zbUT+1fJgshMxGWaF?&^%UZ~Dtxg^x#J~Z{$GMUk^as!5BdKFVTXpcre*wt zjxH`TbfdnpA!7PZJ^z0|(Enw-{$Bv`)^n@huBUG^bRQ{?7D@n6Zg0lWlEx+r_%Ql~ zXo1Ov+y65aep+wBPblBRE`)`0n;o#7^JZAQrnGJ8@9<5#G{G zvq1QC)x^86*))cjcc;#Uh`veu%S0z%-BqELEs6&g%;?4g(TGGQX=I8HD?($eOx78l zBesbCXzY9s+c)yQ#wL@aIPZ~gMik9P^Q>c+-s#Ascui@=XXIN=(Rkb4Sg((cNQfKs z2TaVB&v<4y_1tI60towSV&`>3Ek~swyE9u?32;9tvcpw-#TK(LnAQV^^!HNI{!+~J z8{_Umkd*j1y6t_djLDW9j-MmDmjD}rXZ~a+iA(4I3#*I(Q>KF&!!6q{BOoJGK-~w7A&SE*-Rh#>50Q`WV_LuAS@E zR=SVGF!qcytj=W&;j#%1%d-pK#*y>H7sA=0v9IS|)RACECn+hDtpKWg#9RKGn~==| zz1zirc=qkX4L=-`8PjJDr$O|)u4gC2eC^|n!{n-rz&Wi|9BmWaMP-v%ejR@&R)na^ zt@|QsWhlm*a(|SAL3K_#=rGz_NsUtZq?ndz-|D-hwPYaHOD!Qk)ujTveM<1o#dhgB z)J)&t=U9ELcf2`PtMqY1-xqfLP zL?-mqO(zHKPA(^H3%ME?j>d1aq5;s=H}j-cnTUTYRVu35%gpyvYF)I9-$`6U9whU}P4x5lxTQsD35c-i?^K>z8I=Yr&57+}}W8 zXCcIz@8=(S&Ca+oi}nHoe;f*j=6G$!xdD;K^1s-}|cl zf)~)jjD^6#f%vJ(&aaf9h}f*hqzlb^t5w0Nu{}aMJZ--`Q6sBJ8+Lc<5Igq)1-%mNIQG-(ABDii-6MPTo9Ae1=&mMv-DHt+jWAW+lg%>G$d1`b6MtILMp1$w=_%hLGL>n}>Afa;Rp z{oa{65LKwbL3q6f*+Rp5a8+Q+D``b~dF|4&XbO2-RO@v5(a5e$d$Qc`eoQhW`HU{2 zm=vovS^fQZnax=$uWe<8`OEriku9_i4pJ{@I`i$+w3aQ@fVFgYjn8TQnW>>K388an z?5Y@~mVhKuL7U7Jy|2FRf|S=*9gFRQ_d<8$@)FC95j0$F@JD;rYc)3CY8Yxr9Oqm| zX23Vv%sTxIMxdvv%whG|wxq7>M;&cC4v{8NLu9(DPC-Hy7|TI%^J>va!V7QNo`d%m+p#hXA7&F{9~ zYmQ%Il#nNldiQpiY;9u}>1G!8AU*j;u1{ZejIGCgt`yh-I$Q)ureHOg=65 z`C#5sHsAI3zKYM3+ddw4o8gNJ>&w|vPN`2{tlkKrA-{C6J%N6gs7YX7Pto&C?K~t6 z80VMcrrE^$cu z=JGDuFp{fJ_qORgfo7A9j}5WQ*LMQuH1Y{ zdktn<3uenU5`9l8>N*yk5+}|=aa_oqw4PY|-qz+H?}ce+dA+v^AP{iU%ui>A#;ZkT z9l3V@OBN+sMUNR?kNVo#H-%a(ADMskeVXDG2-}0(v304|jT3Az8gkyuH0e>X9C zmi2rW-(xm9JI+d??b=AK@m_z_sSjRpX+akc&5)2Ga=o8Q@?@@6kI23jNmI^OHkI1s z$f1^m=EX`%P}iy);0w*vT=oGA23KQ$;2&|=86jN14$SPx5VXoe3ndpL{`kj~SgKFS zI9QNq3BGjI8H_|^hSKixiQt^QEP%KBi+OcepMp(o%LBML_1oAb3GEp^TF9> zGo6GN_aN*0Tq_)Nt1)iW0=3@B%8yO!H1Pr}V~dm9@Yz#inyiJw_Zo$MfCdg$1s!y^ z6Db{ccLO1?ldsM9$dkh|&Jj+AT>8uLKgF4A9o)j}?sL4=;A}PvW{z@Io1XPs?}tbf zPG}|sIzGg6E-zT|1gKM5ZCQ$c{slG>W=aUoFUuRuVD7hVoWQB(qdJaTG$#By!(Q;5 zDY-(7)DELoUg!e19_l@WVkkbWPYe4D$I3>7lzlhQ0$32#SLchfNrHgxmi~nogpS6L zo!W)CKfZ3mR3(j(Y{fwF1eTIxkrl*6tdbYFI}aAL;Z9Yftf{NrTOP>VeCNGjzM-c-0qNN z#?_n#V9B|xgdW~EXS6jP2MhLFc?pMgz;YT#Bk?}; z*M&onBu{1Xkrh5aRjGf>hw>FU8W1joR-y~TD6G2 zxq~c=U28qe{@pA_EB6~#Iu5$lydS6R4#aH0!k4EPY|;Dr&{o|mb60fCaQ4|e4wu`M zlM0iiDa&62?(ecwwPJ!^^-q7)1Pmz>HH2<64K=$`KZjrQf~E`XoPE56y#`ti2z!-GTU!(Prk6mjdEj|EruXBFa86}7=Za}i3anAjNvzUGn&;ifUuTi=~;nP?FN zyI$VO*W(kcQR@%6scV5#FCOwiNd9$-`KCqW7$Vv52`*&_b`8jJ)~AD)={_%Xo-=(xb4JVk{FL{R()x+**T9@ zhpkeZ^(GGsRss?x9Oxkd6*O}4q4JVEO*Wge3m#FwdloMt54BUj4?hOqZN?i7@KRGb zj;E#)?*%m+$cuLqt0tx8LdWUmn}u77h<`AXcgg^h{hZBJEVLX1pwTAVgv_qJLx6Md zC4_q(Pi^|NH|hJSySttzJ2vCPGlGXErgFRw+(FRVs2cKvjV5iV-#%`5N;?^tJ>vIZ?$QuU414>nwE97b`gh0w}&WuB9;>>_M`l{7Ft*g-jC~5t-BIb`Ws^;A;KE)(tR?YAFmRI z73A*MvT%ztS` zqA#RX){wrPR(UfgPyi}L7vIiLD3G|%s%+H5$pjNI5pPbjct6|fuUEoCw!3vbo%(BI zjFtX^1Q((w)CngfgnBI{Ir(!T#n_h(WC0M4#AmZsDn^h0n! z^*q9lygis4_NQ#>F?~2Ta6xwTITo*N!rHy6Jyvd(j&Dxuw!1VwZa=EUS7rcy5^c=c zANHS$W^eWJ8XhE6ee${!;NQnTh zDYxen$T$domRB|(##@D*nl{c^o88to_F5<&PQG<>E-Mv>*Dg&$fV94P+N7%RCD1@* zP(XiUZdj)qS?QL^N=4!|WH<_7XKlo~-lwzn-RUfb^RopIBJ7tq+iYpd@M;i&fB;}B z8V|Bf%Hs0+IGRBUIzj)rcH%gT)|Dc-s2c%DiKBJw-azrDrt{t?;HbhG>HDoD5Mtxg z`KF=Eje`@*MW5p+f~bW}7&`@AA$tj{tfhVbFCx_~SV3s4oadEZ+; zAAZ`z|NOLT$Aqn4HEsHEM|%8zDV}~)cLe5ul_Q2(#22FLoTAb&j zxHw45PJxLJaz=1qV?7Z~cJVsDA{+9(yU5nH+Xn;G6z1Y}t2v)XYj3tqoRv1$h_^qU zp87nPIl2AK(+!z=MX|fwT$hxpI?fSjO0XwKNfsfMeH%>3bxe|jx7wzxrK4_*IebKP zvgL4H%VwXYXufRDt^PWy64UxMbRJCR42m zus%DDr+&QJSN-_tkoY(4ebuXrdBNjM?z57>&?Y9IB~gR*EG#1>jNwA6dxr}B4Zjva z%4>^Z@3o!v{R&RW0H~5&`QF?MAEayf-8M@-c}POR$d)(FTW;c7yU>}|@=`7M9IUz? z{e5-r3Ob1l*l8=NggXMRwJ*h+4uvHOw_)M{ztIj9!iT{)>Mdb#KtALzpI0~Cm(>te z4+Kn7>!Vq1{Xng6SD&v7cL_uQQ=xwMS4}JEzd$(vLwAe&dm_*GGo}~Ul)9 z-+J5YH`+`eTzxT|#2L(dmcmZc4#L!$qm4J#PAtJ|(ZrxncPflm`L`RK%_~%4=mzfH zP{S@Yj!F3lV4+TwD_VgqC&%;DTz(yUOZ~Xjy>dz$EaL5E-`72NPh5bIrkm5(hO93^ z``rYVVP)(s4GT%Heow(|qxtf+GB;utU+WK(>@StDTXD7`zgrawv1O2i-lkv9e@8=*%?8}Q?Isnr-hh2{IKL=D-RU89p*l~ETI~ zLZ2x%O%<(`F-fp;%d-YQH$I(wpI_)NXGl;@pEqUgv+fZ*PiL0~2W)q(R|x)VvF^`U zI;jHoMp$r>x%{PXDZ`wx5$hdXaI&Ax!m@9(^z3AXt3f9UtXmDXXTXeUnf-s|Hjqeu}|C^G1b2Ld6^%#{=o zfT@)`5Z?Oyr~qs5r?!q_KZ!K&uuJ}t0%8;gy2-fI*kjwD3c93W3Np^m@HQ+Tlj}8G zmB1u>?P2)~^H(M%=6q#WL1(y#ydpxs{(bhxb-v@!?P|V;GW$X#K+MddvN$uu9q8Vg z1o4Lm6F0M~bWO?oje=a80zL~8zF=c>$|7DD33$bt%Z_8OEJYxFL`z2A9)ut(b&fqF zWGHVm9&V4qV6a$X>K3WJ*HFZxMMH8!XL36?Q(#~r9UvadvpEFA8IPx|R}#-my*e3k zJzsp+O7i6u2zvF@=Vxkcd1U`@E12y!mXm5LKN2hb@HHwGmx|5DnzBA4NB zd#~;*)AU5#Hulo-v<(RV(m}fvuxPN|M^3K0TxU!fJ{lfs9c>u7M81gynha^D5*Exw|XQIJM(15B`b??f3#+LwvhZ zI@fkW=0Dkb8ZAO3DobAVdFj7yUW9#*Yfp%e`2-nOk6Tn(e$h-zW$f4*1GV)hOY8FZ zMDT^oyb9z}G`zreI4Tsv`# zE8@c$`rphXgP@ zkLL2Fr=YIxkjgb-(lb_P_Y*3ACRAb(WaNip99xKQ-`aus-=pnp?IO-P}Z7C|~cl+a3PIp?!Rf)9(-$$|O0Rdz!w zH#htt&-wk$sG6jA%hUuJVSG&0r#1IdMm<$SZ1+jdTX6{P*;*fwxoY&_r?w zddzo?1G{td zG&ugbu%{{SOOgAl_1&MXA}F!u)vw@oPTMz9K~He#ePDuw;%O5N|04oIB=wj_Ft@LK z12pI7*Ym%r&N2LAewTDpiK(kerP0OAg7;u*Yd$}|g*f;-{<@aawieZbwX=8f(Xo~e z96U0i_oPE1s+9_?3+!vDYQhAob3!^jUGPW|OZ9X;AcqnP&G`E+2Y@`^!D7&~k2&GCQ! z_Vn`8BLgh+;(k$KI+ZY)C0M|RFz%enX1f_UGW0DfFIstyYqivsK>||MPh8Cs`gb@5 z@aImLb+Q{wA8)}=cfP%Oxohm1CRBzm)!Qj^?e~TeQtE!JYz+l`l3G=qF@5`-VM;hj6&wT(UYn9GLQ~pI@Q_N2n*~k2w=|sVJ!bjjLbcqZB4-ty+O^ zqA9gG0q-AT^t0o#%6S7a4oi1TB-FG}WQMY8L)kA(#Mw%CLQp^tKuukD+JJ1Kn;w7) zi-$#y=M>Wd{&;KUO@@rxqNyNG-Y{4)5!6j>UVXaH;L}2@tbK8slC0ZxYAymIr? zD;KZ}tL$BF(aY}orPXj_@MHN$iLa}#uOlJUPh+pvj*3HJ?RI6Ox&TDDbp_J7A#`G7 zLVktp2o=l`XWw?&@1fVjXrj~0UlRg-`(O%e2suU?ZYGA2MW_G%h&r}H_vr5wB)_G% zoLM_yK41@T{yJcHI{V0tr*)jmGejdH?X%6=^kyWvFW23=TDCtR5q0E-rfq-}TxACr zn+M=F6qH*S*PkXwZWJDzRP& z(}3&Kgn66OW+EB1W87wY)SvTu09 zB^AqG`V7%U2UdZ$#^eun+}j1ckw^2-VQGN7&g)lhmq$Sd!oPxFAd#pJ}^1o^5lFTfHWe(|uaZ8JZ-UsG$SQSU;h_ zfcKI9&7%UC8DG?jms_*mEq=YrJO;Fm+?FM`fE@k*e9=vm#NqU2G-027a5A4f|P1IWMOu9wwkK}O%nbOr=L=k~E*J)=anzrYei&J5Jz17y(73{+Y&z@Sk zC`OFD)}w-c4)t^J@eo5w<=A@zRFo8;hyB^m*eF|k{DU%dr3 z5?HFI=O|T0S=H=s)Kq$;TJpicHxBq^jN~%4v9YPL$s9!W$IJ7{(kM9TKg!$fc;zf` zr$iN+=bp&q2!8`iNMLK7+24wBNY1x9`MIoi2j>+aMUv|RbBjqZM%v!}q7a$$Hiu<= zmSQKlTF=e)^}~ANJs@5npg2Cx4{Xf$e*6+Izv?r$mWE=rVymx@koW1t|6|kw z{8)B(p3orb>~+1E2c_K|-?Q*A=*jlR>J&e1{+7~I8c<7*CyAphj~~9mU#=E6YsR~> zsvMalr}6FhsKHRMk@(+a|KocJ7>0`TaF?R87B>=h#L~(}Mp0Pg^M||Io6?7?(w>}w zGpmZ&Y&{9bFhz6DB}M`5NwMD0WF;Rrgjg;l+-}gnTqNnNN;}`#HGr&;DugssBJqxK zx2u5*9_?^1E}(8_x!Sp~J)-ARH6!LXK0GxEVpC@xl_ej>Xs+Hods%_b{3c#zYg-r zk7x1^>A?-#oJHw>02=?wsE7%RJE@+q1J6?psk2i`OJlJX69a)kmGen^J9QZ?m3fV< znbGm6ITOl3PJ#q~j9Dz(!_*9b86p-yt>`p!&>7}^x`4Sd0#$QSc=xT~gpEGVHN#%X&B~Wo@au{N7d!ovC4BG8BpL z+6Dx)X=kf)xI)AO;?^SXdTU#8|zkGv*@Ym45=-lSjNeazo^YjIXMwE z6H*j69!SdSr*x)H+?4+96E28>CMv`N^CgIA;dwHugc|+yuVMqBYKBlZmDT07VwHtQ zjWKzr4BOw|?CjOO1ek#JCk1SdS|~>BZwquxvU1&pe}*K1dSPs zQUFR6m7ORnQK|*_`PcQtuKV($F)~)t0DJAS*^a~o24eevRf^!JK4){yrK>s{@0ZbY z&fQCo-_MgEeRP?)Iw^FfRyd!Oh$CcsdZ*ATJ9(UL*mB|vqG1vw#-QTiIUiPwgm>%K zkw(^@a_(|7;>Ha6VFk4-wFawLb7Q3IYAD2}qrV-8fhky=_JoRPA*kybtvdfkuBO|2 znRRPa{*`?+*a-D|j;SF$Ivt=|Y}~+AMhFA8_2K2h-z{e}n)0RV)(8@b5>x4Vv!t4;2dhZMVXU+@$vimCerudh4Kj5?dSXRv%q6 z2a}(Y`afMR9`n-~4*co33QlQ_n#kD8F-5Bc5RH-~foRC@x+{@?0c#8Mw9n!NiGMIh z^N}hy+`_Nd>{IZO!DYRsRDXLoFP5>o9vWjD4pKKqF|0YYYv4cJaRD9bnW&##1|<=E zKGfBOU}j~g(^mX3^c<|Ke@Mm&^V`yE@9Jqew8O_HrsbjqYHcn{aZ|;VkfD8g2CzUU z&-OVOH|;qDs#_Y!NYDDNrJn+i7ND)k5~xwv3}h%u=ANuNVhmT`J5~PI`+7SgrAv~ye_Ow&}9OvtyjncO!T81Xu}#grUYf_DL#d>s3Iq2Z^8iH8ui zs?T39n!?SdJoZ0Rvtm><%Gu6DZL~o5(nHM#My@wxq@|}BY!2tm8c<*Yz6r@ph<5G! z9B$%CX(-YZEyi;*Q^?2>;SU zd+DnvSA1 z5eWu<`XlQuofbZCH}DBCmKOYL+i^~1^A%a;9Tg=3Cgtv0`pH&>@OYWErlC9F8Er0WVCZDD zL{o0rU3+u2wK-Ctv&Oo+3XWGyuHf6gQNXz5dAdZpU$SZOIT;T5=hvd*(=U*5=ze+r zpj8mwV@?Nh$+O!D6FMH9sdL*;4H#%XEESZ|+(HHfHpN*5*>7wh=dUaIYEJ6(g zKcy@|V&mh+5s}Vn?|#in-8kI0=eqIbM?9V38V5KF(aTcA#hM_J_8QMI31Dxmjqkae zv*8>oV~#_Vu{cwFDg&y08Na30V+#Ww01acsEBj{khHjf>jtZYpE|PjyAhI5P820AN zSE|~Nh$N`Dm!ROP^3mx1+}M*UG64dJDVT0&qzN%4_rebx98xNPLsccM>f09sCgqfDJu2OqT4}s&QJS?pWxg!&iD}Yl$CAd zBoRXJweSnPN=D_U%TT%AxunyN<<*pwGqknx^8z>!pE&Z8=8=o4gmnIl$FHnP(Yqzg z(pf3%2AQoXs4ZC>Q;EAoTu1~OuZTZ=`Hn)*S6PSdmzQ(hjX8#C9OfS7a!3bb-E)0A< zeAF}9KO^47OMkC==Luz*jqw#>`vdvJm>>#Al!r^3**2x`*caG;t{zgiq`A9?#Te;Z8daEkFxWlYU~@;< zo?TyT>#eJKG=|_Vd?b!*<m%g7E?h`86SOq0by$U8#k_lt+~9UR(f`p`e5U;Q$6z@R&~qguxodKMtAMOdT3P8 z(VvLAj*^lB@yR(7TF-Trqx#$hWp^0&MlU>9+w>-HT%{lK)0JSXP>e|V!%K$73PBxe z)<=8SMlTmpF6C2Zf18}k&%-fr2kIMYo0|{LF|sDPS$vni&UUvazDuOvi;Yob@>@Dw z<}NA$H@niGrX4fKwI?@EAD_FS+*2+|?MJfSbg;-*P_oKDb@T~X>YbhHb}X)}v$|fA z?$6;c`DycO>Zr7J;1wAeHNosn8yW-M2Qe(jlGb>~11cwRR8$X+F&6Z48#~J*LsSxr zjT7`z+nW)Ha8Sd~!s%XA92YQ7PX{9seLw-?3URuB z%Jke(HL-Z_IerMr#>`;;W3kuPv9RI(#piYLsD*CtZEvDcs$zA$YaUzs6|XBFK2)j3 z)*D|rI!;|SB&0q3ucrJrua~Oi0SE$$*JBB6qvek;nBzC;vJG#-C`z5gYKhTh@Hl0W23>?H(1t(KYWd)v0FROGWcA2x2VZvB@gK4g+tW69JHk;Fp0^y8?TI+_9p~3vj z-6EiZF=8P@3(fTU%+R0|6V{y8%Uo(>v~~9RspUv1f4>yE4&TI0l4>fQ{wv(t+snz< zLAEpxksJWnlg|81lcsaHGgk_D!kt~V z*K)XgI+UyZ)au72vyT%X^$8U^;2U$`3z%h%l8qwTVu~GMas5TbNS_&jb<#tMc+kG&-h%twOMuOP}f{n#RbgQjj zLdot*o*%`Y*jhNPwu`N2Im-fWqyNAIDUrX_W4I0?qqhy4uG$)`r`$7Zk5^rA?;j)V zb&Qszfix*Ysa;ZQ9<4%O|E!zcz+=` zCaz4K53gRTu3l^hBv6*?kG_h>=_T}o%zOdno_B8)Du;Ms zRIOB@y?nmiV9wfd`99PD;?!8b4w$d@v&FlW(=>mpN4F+5AtJ_c_+LX83AOV*pC*4& zS?=Y^5PwMj2=@l>^92kf^R#_OD(u4tq5y3p@OftJ-K*Tdy9t8LN!}0^Q#O!YeKWlC zCqWq1qgjqPdVir8iQO<`!mR@_FRqAzZVF^*c^;$OEa0F*gM$KR`+xnoN&R%CP`v2df6fy9V|L?o|lt9%lNdK=_ z2d)m(|5@9veJY28H0SOltAJDc6$}wqiNgBV)&A-R?#Wfk^LuDtb zJpvYi-DP>%S^H>M<#mWYwqU#lyM^4M4I(Bq&@0@J-z)8f)p^=xCksGP*_rnmwsfEFTc*ORToPQ{69`+WGzob31K{jowaGqj-s1Kw=4vMSG(T9K?X&#|%CUa$y4haY+FQNnp=<1-+!HnH#fZ*aiPL!7HwrPnyCb70|2t=DFLml4*S2AQm`~j>RkXf%Epg?3XKC$*b|&6v*+d$)nmF~2z*h8C$~Ini4AdDMtK>&8|zc71zA zgxx%-`RYZ~iI+cR!zammy@7{jgs=bU4O`G#QLg|lPytZjhap1;{t4tGuil!NoSx0o z4~SMKSEnY&t?djh#%TUQs!1w8Rn6||V2cj!$F3}Pm#3j(c6mmI(V#)vpLVv_*GGeK zl(x#VCi#kx$8LOA&=B$htD;R2EjyF4`k!B6y}0myoC%Jz0V-NJ*s*eU;)VvtCJe{* zBXcoc*b?bO>R0YWc%Usz%G@eU>=?f=rm1s#TX)1MSxPfSUAj1DfXDyCqb6+bZwD+n z>bMp@S=%-*T|TpaT3W|O9IlGlu@&QDH8vQ+Few@f=q@!F%!^k*KpR%(w3rZ#rY4NF ztb&dXMt|~J`$~ugl6_54SxHTaxCl&P6ry766esTT5!taa%;o1MS>$Qs;ax-rPgP}c zyY_w+NEN-zSQRFho5wFr$-%`|^E-{&^z3{Hs&NN6sf2{WfAyU>2mrsuM2J^0SgE}o zBSxFMK@%FsIY*1YDFKGbzLc_xgg%Yh&hGMpS4cH&h2OumhG8r5Gb%M*Nr%SQVU4B! z(9q&x?#!snd@BDfFNHNb4}%LEN2impI=mppn427w?~ae@uSr@Rt>w#|=&k%D#XJ@6+KP8??W)$&AAT~8l#J40AU{u84g*U+35l0m9!J|G|MwdPf<}vLr{0t zdKiVTt%nv>3tNNYMqHsyRaD(A!VsX+n#V_bV0wlY(BOPR4Sq;19E{|=A37ZUYlmc% z!?5%lANX`@xMK6;B{cHmR0?4aoo5>WskXZ)wL|!`D%ydnX zPPZ%N(1)%y+E3r6C}Io&{M?fK`zgHH3ah2}g>!g-c>|r_r;31w_W)s%V4L_Y&;3Dw zy{9o7MGQ6kdgIIVxp^Zzq-bbHaQAB&FB`_JP(S~K<9~`#l*b>3y`^=9tpwQt*Ajb2hKK5kd}F8BQ~juO>2Dm##6Ol$CAQu%6? zP+(6`DPVKXn4ZVm*?4&lf(Z>snH$OPwiO`KE;C^U?5#pZXK)(|hg6swm+#-<3dN^k zSED{&99ZZbxcVkCbtfx8*vVeZTKnQhPbo9CWrfl{6233B+djqFI}Jw90D3mH$FCHd z(0tww3AR;eT`mjFy9w55Ijh1p>TL!~6JY5fg}mOgY< zaW;~tk^30S$CqjR{_xO|&u^5w$>0i5%D_Se6;a2NIBQOI2` z-u5)-bCj=obF?yf42 zPw)M__sL#rbjKpX(%N{Ktjd^T#hi4$Xt|7_o;GSwZt?U)g7Lpu`1wE9Q_O46vkyFI zDKuae@zum0sVY)v;3afgY^Zoa-U*o$Ff(STxS*I?z{5?R40DqM0!St&$1*6d&BQM; z00e|HT5TJz9`+M$+X1uiR1s-;l6dV;^~6*|ssGTsXZ(13PemUmwDo1@7#PG~KHB8& za9rPYF2C@}VqKZ@nMmfDNa_@v>Cs6?fxsX3X|z>42t(r7dP-@yOaIZtmMk5)$=NZ8K?tE1+hX2J zWcmk$(U-@trkY(>9o6;lCYzGuvjp{vBflI1R12@urMD>D;u?l^8}Ec+34LR|`|}`* z{9F`HkjSzmLL7pn_1Ncg-y*1BJ-uEB`-G%qGL)~z@qKhnJlYEkK_UVVIDWk_UY5IB zm4WOKBOT8Vi2{0yY?FPBoXuC5kTPk{ZRw(#Uhg|m1kX_w{OiW6_fhCV-g~`7$=S3` z*Y{T!rXHZ;+_>q?ubD3wygauE93xr& z>UjF7%Fp#SLF8aHm&%pmW^sK@MNRHy-NxBr42)ZG^u6Nkw8JqSou2k|j7VNamNBtX zWM3{0kNy#iawb5#>oE+w6K1K2brF8#=9!moHd0Kh z70vK^XZO1EO`o!wDsjK|c7!80ug|N2N5jR?S?4@@i!L|gxGhVtV_7v7&E4(3IV#mz z<0)?B^1oCfQq*!wHdZw9`W)a-GPR=$%TW_LfXV%M`KyM!-{huTF#7VsB#QP>A=njv zqt*?B|NA_Yp+WhZ+BUeDL9qS!_xGw2UrSF?*0w!O>Ye-fCJF;SfL?4qWVE~GO>`$A z+XwHA#)LKwsY;{M^m$D%^LX-%!onQ=jI_CW%TDBy^C{Cd*kc`lFQHm-tQEaj~JjS`r}}h0{P*mL27=uObEb_w8^old5^S9H%CxDGcKVN z0s!C;q|Vjg(EH_ALd;&e`%v^Y5MVX5(cK<=)lN?#kN2=jIsN$T=wkm!$n|=tfS5o- zPA&@v=&9lOq=@i6{#+h*b#-m1b-6p?+pT2IORL3+h!uUIXFg{O%JwVh=skj;LXSPK&85_QI22FR|S_XFC_FMMehju0RWElvm3 z!sD~7rgEqIr$*$l+#X2okNwY{;Zn9)ty*CqD}SXas}f+}WZrisdqD(js{Fl&e3>hQ zQ&}EACi#|xa3W!i=Bl)$7en6Vz3&4VBA0C{vgrHRw<0-)C5*AYG^@e%^ zyT!)-F387^>O@v!JS`+$oEo3wP_J!7d!vs*%0%=QJQK>69S0+6aR%r z;y?isV4#pF%fNI$Y=&m4s+JT>C-Toj?-9 z2fWA827xY@Bo?UZAJv`TarJqxCmU}o{gkW=93q05k5;zwnwF&#?ZfrD9gEXa@$Mf^ zd1L78F(X5(3KXIM^yKN|IRLc%E2u!W<(#6hL|^Ndcl)}qv74Lt{6HXm8&+CxNc+Q; zaa2TeCdz9NI>*a@0!MnVN`V~VH}To#HWOP~x++7-h^tCgcyPm~LvWGo>E)|cW+B7q zZv#sP4Si>u0;OovDYB97(q?AKYYCgYv}gus>2bai=xyaKuNs|}p{-Un$Hrt;h6in` zDnjhJ=t@M>kc5cA{$74%yH?n0yOH;*{!;2#o4nf2FG'Lqoo-7W?>9q9^J7{1@LYtwlaeq%ZpKT0YT-~5i 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