From c8b005c5439a4d7631dce40260cc920c1f645b71 Mon Sep 17 00:00:00 2001
From: Pavel-Tk <110731619+Pavel-Tk@users.noreply.github.com>
Date: Fri, 4 Sep 2026 00:07:55 +0000
Subject: [PATCH] Resolve the v0.3.0 tag to a commit SHA for install

Signed-off-by: Pavel-Tk <110731619+Pavel-Tk@users.noreply.github.com>
---
 README.md                   | 4 +++-
 plugins/substrate/README.md | 4 +++-
 tests/test_packaging.py     | 3 ++-
 3 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index bfcd450..99cd310 100644
--- a/README.md
+++ b/README.md
@@ -22,9 +22,11 @@ hashes, API keys, or TLS workarounds.
 2. Install the plugin subdirectory at the released tag, not the repository root:
 
    ```sh
+   substrate_ref="$(git ls-remote https://github.com/Substrate-memory/Substrate-memory-plugins.git refs/tags/v0.3.0 | awk '{print $1}')"
+   printf '%s\n' "$substrate_ref" | grep -Eq '^[0-9a-f]{40}$'
    hermes plugins install \
      Substrate-memory/Substrate-memory-plugins/plugins/substrate \
-     --ref v0.3.0 --no-enable
+     --ref "$substrate_ref" --no-enable
    ```
 
 3. Run `hermes plugins doctor substrate --ci`. Stop without changing the legacy provider
diff --git a/plugins/substrate/README.md b/plugins/substrate/README.md
index a688d69..22e91a6 100644
--- a/plugins/substrate/README.md
+++ b/plugins/substrate/README.md
@@ -8,9 +8,11 @@ the associative editor, and evidence. The plugin caches no memory and fails clos
 Install this directory, not the repository root:
 
 ```sh
+substrate_ref="$(git ls-remote https://github.com/Substrate-memory/Substrate-memory-plugins.git refs/tags/v0.3.0 | awk '{print $1}')"
+printf '%s\n' "$substrate_ref" | grep -Eq '^[0-9a-f]{40}$'
 hermes plugins install \
   Substrate-memory/Substrate-memory-plugins/plugins/substrate \
-  --ref v0.3.0 --no-enable
+  --ref "$substrate_ref" --no-enable
 ```
 
 No manual credential setup is required. The plugin connects itself on first use:
diff --git a/tests/test_packaging.py b/tests/test_packaging.py
index 9180fda..354e3f5 100644
--- a/tests/test_packaging.py
+++ b/tests/test_packaging.py
@@ -24,7 +24,8 @@ def plugin_version() -> str:
 def test_root_readme_describes_the_released_install() -> None:
     readme = (REPOSITORY_ROOT / "README.md").read_text(encoding="utf-8")
     assert "plugins/substrate" in readme
-    assert "--ref v0.3.0" in readme
+    assert "refs/tags/v0.3.0" in readme
+    assert "--ref \"$substrate_ref\"" in readme
     assert "Hermes 0.21" in readme
     assert "PLUGIN_SHA256_PENDING" not in readme
     assert "is not published yet" not in readme