diff --git a/CHANGELOG.md b/CHANGELOG.md
index 139db33..96818d9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.5
+
+- Refine npm search metadata and the Action description for target-aware Shopify API upgrade checks.
+
 ## 0.2.4
 
 - Refresh published npm metadata to the canonical RexCode-Digital repository and issue tracker.
diff --git a/README.md b/README.md
index 98631c2..90c5aab 100644
--- a/README.md
+++ b/README.md
@@ -67,7 +67,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
 
-      - uses: RexCode-Digital/shopify-upgrade-guard@4e288cbc58a3186a7304785615f7255c0e3d0155 # v0.2.3
+      - uses: RexCode-Digital/shopify-upgrade-guard@7a261bfb68bb931250e553f22d7c96142490a35a # v0.2.4
         with:
           target: 2026-10
           fail-on: warning
diff --git a/action.yml b/action.yml
index 6f855da..5ce91a3 100644
--- a/action.yml
+++ b/action.yml
@@ -1,5 +1,5 @@
 name: Shopify Upgrade Guard
-description: Detect documented Shopify API and platform upgrade risks in your repository
+description: Find documented Shopify API and platform upgrade compatibility risks in CI against a target version.
 author: RexCode Digital Ltd (Efe Gökdemir)
 branding:
   icon: shield
diff --git a/package-lock.json b/package-lock.json
index 108d74e..7647baf 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "shopify-upgrade-guard",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "shopify-upgrade-guard",
-      "version": "0.2.4",
+      "version": "0.2.5",
       "license": "MIT",
       "dependencies": {
         "graphql": "16.14.2"
diff --git a/package.json b/package.json
index ab21f90..f115a99 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "shopify-upgrade-guard",
-  "version": "0.2.4",
-  "description": "Offline static analysis for Shopify platform and API upgrade risks.",
+  "version": "0.2.5",
+  "description": "Check documented Shopify API and platform upgrade compatibility risks with an offline CLI and GitHub Action.",
   "type": "module",
   "bin": {
     "shopify-upgrade-guard": "src/cli.js",
@@ -40,11 +40,13 @@
   },
   "keywords": [
     "shopify",
+    "shopify-app",
     "shopify-api",
-    "github-actions",
-    "developer-tools",
+    "upgrade",
     "migration",
-    "deprecation"
+    "compatibility",
+    "github-actions",
+    "ci"
   ],
   "publishConfig": {
     "provenance": true
diff --git a/src/version.js b/src/version.js
index e6993a2..78933e0 100644
--- a/src/version.js
+++ b/src/version.js
@@ -1,2 +1,2 @@
 // Generated from package.json.
-export const TOOL_VERSION = "0.2.4";
+export const TOOL_VERSION = "0.2.5";
diff --git a/tests/cli.test.js b/tests/cli.test.js
index 4db604f..da17669 100644
--- a/tests/cli.test.js
+++ b/tests/cli.test.js
@@ -4,6 +4,6 @@ import { spawnSync } from 'node:child_process';
 import { join } from 'node:path';
 const cli = join(process.cwd(), 'src/cli.js'); const fixture = join(process.cwd(), 'tests/fixtures/healthy');
 function run(...args) { return spawnSync(process.execPath, [cli, ...args], { encoding: 'utf8' }); }
-test('CLI help and version are available', () => { assert.equal(run('--help').status, 0); assert.match(run('--version').stdout, /0\.2\.4/); });
+test('CLI help and version are available', () => { assert.equal(run('--help').status, 0); assert.match(run('--version').stdout, /0\.2\.5/); });
 test('CLI emits JSON and SARIF', () => { const json = run('scan', '--path', fixture, '--format', 'json'); assert.equal(JSON.parse(json.stdout).inventory[0].surface, 'admin_graphql_api'); const sarif = run('scan', '--path', fixture, '--format', 'sarif'); assert.equal(JSON.parse(sarif.stdout).version, '2.1.0'); });
 test('CLI returns 2 for invalid command or target and applies fail policy', () => { assert.equal(run('nope').status, 2); assert.equal(run('scan', '--target', '2026-03').status, 2); const failing = run('scan', '--path', join(process.cwd(), 'tests/fixtures/legacy'), '--fail-on', 'error'); assert.equal(failing.status, 1); });