From 3bd4505026f28a0c5b268d8e51986d503ae6cb63 Mon Sep 17 00:00:00 2001
From: Binay <150876063+bkd-dotcom@users.noreply.github.com>
Date: Mon, 3 Aug 2026 11:01:14 -0400
Subject: [PATCH] fix: install umbra-core/reviewer from source, not PyPI
 (yanked)

umbra-core is source-available (All Rights Reserved) and all PyPI releases are
yanked, so 'pip install umbra-core>=X' fails. Switch every functional install
command (READMEs, prerequisite blocks, provisioning hooks/scripts, guard scripts,
configs) to the git-source install:
  pip install "umbra-core @ git+https://github.com/bkd-dotcom/umbra-core@v0.5.3"
Historical CHANGELOG entries left as-is.
---
 .github/workflows/reviewer.yml | 3 ++-
 README.md                      | 2 +-
 config.toml                    | 2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/reviewer.yml b/.github/workflows/reviewer.yml
index 902ecc6..0161ca2 100644
--- a/.github/workflows/reviewer.yml
+++ b/.github/workflows/reviewer.yml
@@ -23,7 +23,8 @@ jobs:
         with:
           python-version: "3.12"
       - name: Install umbra-reviewer
-        run: pip install "umbra-reviewer>=0.1.0"
+        # source-available (All Rights Reserved); install from source, not PyPI.
+        run: pip install "umbra-reviewer @ git+https://github.com/bkd-dotcom/umbra-reviewer@v0.1.0"
       - name: Compute the PR diff
         env:
           BASE_SHA: ${{ github.event.pull_request.base.sha }}
diff --git a/README.md b/README.md
index a92d123..291acfe 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ with [umbra-core](https://github.com/bkd-dotcom/umbra-core).
 ## Prerequisite
 
 ```bash
-pip install "umbra-core>=0.5.0"
+pip install "umbra-core @ git+https://github.com/bkd-dotcom/umbra-core@v0.5.3"
 ```
 
 Add a `.umbra/admission.yaml` to your repo (allowed/forbidden paths, diff budget,
diff --git a/config.toml b/config.toml
index fd9ff42..0881be1 100644
--- a/config.toml
+++ b/config.toml
@@ -1,5 +1,5 @@
 # Umbra MCP server for Codex — add to ~/.codex/config.toml
-# Requires: pip install "umbra-core>=0.2.0"
+# Requires: pip install "umbra-core @ git+https://github.com/bkd-dotcom/umbra-core@v0.5.3"
 
 [mcp_servers.umbra]
 command = "python"