From b1fb4ec01867a9fce43aaa43da93abea824783c6 Mon Sep 17 00:00:00 2001
From: Thorsten Sommer <SommerEngineering@users.noreply.github.com>
Date: Thu, 4 Jun 2026 14:21:57 +0200
Subject: [PATCH] Updated README.md to include instructions

---
 runtime/patches/README.md | 74 +++++++++++++++++++++++++++++++++++----
 1 file changed, 68 insertions(+), 6 deletions(-)

diff --git a/runtime/patches/README.md b/runtime/patches/README.md
index a23a7181..865e67b2 100644
--- a/runtime/patches/README.md
+++ b/runtime/patches/README.md
@@ -8,13 +8,75 @@ AI Studio temporarily uses a pinned commit from `SommerEngineering/qdrant` for `
 The fork commit exposes Qdrant's internal `lib/edge` crate as `qdrant-edge` and applies the
 trait-solver fix from Qdrant PR #9312.
 
-When updating to a newer Qdrant Edge version:
+When updating to a newer Qdrant Edge version, replace the placeholder values first:
 
-1. Sync the Qdrant fork with upstream.
-2. Apply `qdrant-edge-ai-studio.patch` to the Qdrant fork if upstream has not released the fix yet.
-3. Update the version in `lib/edge/Cargo.toml` in the fork.
-4. Update `runtime/Cargo.toml` in AI Studio to use the new `qdrant-edge` version and fork commit.
-5. Run `cargo update -p qdrant-edge` from `runtime/`.
+```bash
+export QDRANT_EDGE_VERSION="0.7.2"
+export QDRANT_BRANCH="ai-studio-qdrant-edge-${QDRANT_EDGE_VERSION}"
+export AISTUDIO_REPO="xxx/mindwork-ai-studio"
+export QDRANT_REPO="xxx/qdrant"
+```
+
+1. Sync the Qdrant fork with upstream:
+
+```bash
+cd "$QDRANT_REPO"
+git remote add upstream https://github.com/qdrant/qdrant.git 2>/dev/null || true
+git fetch upstream
+git fetch origin
+git switch master
+git merge --ff-only upstream/master
+git push origin master
+```
+
+2. Create a fresh AI Studio branch in the Qdrant fork:
+
+```bash
+cd "$QDRANT_REPO"
+git switch -c "$QDRANT_BRANCH" master
+```
+
+3. Apply the AI Studio patch if upstream has not released the fix yet:
+
+```bash
+cd "$QDRANT_REPO"
+git apply "$AISTUDIO_REPO/runtime/patches/qdrant-edge-ai-studio.patch"
+```
+
+4. Update the exposed `qdrant-edge` version in the fork:
+
+```bash
+cd "$QDRANT_REPO"
+perl -0pi -e "s/name = \"qdrant-edge\"\\nversion = \"[^\"]+\"/name = \"qdrant-edge\"\\nversion = \"$ENV{QDRANT_EDGE_VERSION}\"/" lib/edge/Cargo.toml
+```
+
+5. Commit and push the fork branch:
+
+```bash
+cd "$QDRANT_REPO"
+git diff
+git add lib/edge/Cargo.toml lib/segment/src/common/anonymize.rs
+git commit -m "Expose qdrant-edge ${QDRANT_EDGE_VERSION} package for AI Studio"
+git push origin "$QDRANT_BRANCH"
+export QDRANT_EDGE_COMMIT="$(git rev-parse HEAD)"
+echo "$QDRANT_EDGE_COMMIT"
+```
+
+6. Update AI Studio to use the new Qdrant Edge version and fork commit:
+
+```bash
+cd "$AISTUDIO_REPO"
+perl -0pi -e "s/qdrant-edge = \"[^\"]+\"/qdrant-edge = \"$ENV{QDRANT_EDGE_VERSION}\"/" runtime/Cargo.toml
+perl -0pi -e "s/rev = \"[0-9a-f]+\"/rev = \"$ENV{QDRANT_EDGE_COMMIT}\"/" runtime/Cargo.toml
+```
+
+7. Refresh the AI Studio lock file and verify the Rust runtime:
+
+```bash
+cd "$AISTUDIO_REPO/runtime"
+cargo update -p qdrant-edge
+cargo check
+```
 
 Remove the patch and the `[patch.crates-io]` override once Qdrant publishes a fixed `qdrant-edge`
 release on crates.io.