Resolve the v0.3.0 tag to a commit SHA for install

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

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:

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