@liquiditytech/rapidx-cli 1.0.32 → 1.0.33

package/dist/cli/commands/update.js

@@ -13,6 +13,9 @@ export async function runUpdateCommand(action, input) {
     if (typeof input.maxCacheAgeSeconds === "number") {
         updateInput.maxCacheAgeSeconds = input.maxCacheAgeSeconds;
     }
+    if (typeof input.installedSkillsVersion === "string") {
+        updateInput.installedSkillsVersion = input.installedSkillsVersion;
+    }
     const result = await checkForUpdate(updateInput);
     return ok(result, "rapidx update check --json", envelopeStatusForUpdate(result.status));
 }

package/dist/core/contracts/compatibility.js

@@ -1,7 +1,7 @@
 import { SCHEMA_VERSION } from "./types.js";
 import { RAPIDX_VERSION } from "../version.js";
 export const RAPIDX_SKILLS_DISTRIBUTION = "github";
-export const RAPIDX_SKILLS_VERSION = "1.0.6";
+export const RAPIDX_SKILLS_VERSION = "1.0.8";
 export const RAPIDX_SKILLS_SCHEMA_VERSION = "1.0.0";
 export function buildCompatibilityReport(input = {}) {
     const checks = [

package/dist/core/contracts/input-schema.js

@@ -305,7 +305,7 @@ export function inputSchemaForName(name) {
         case "InvocationCheckInput":
             return objectSchema({ commandLine: stringSchema, preflightError: stringSchema });
         case "UpdateCheckInput":
-            return objectSchema({ force: booleanSchema, manifestUrl: stringSchema, maxCacheAgeSeconds: numberSchema });
+            return objectSchema({ force: booleanSchema, manifestUrl: stringSchema, maxCacheAgeSeconds: numberSchema, installedSkillsVersion: stringSchema });
         case "SchemaQuery":
             return objectSchema({ consumer: stringSchema, consumerVersion: stringSchema, includeExamples: booleanSchema });
         case "SelfCheckInput":

package/dist/core/update/check-update.js

@@ -13,11 +13,14 @@ export async function checkForUpdate(input = {}, env = process.env, cwd = proces
     const cacheFile = resolveUpdateCacheFile(env, cwd);
     const cached = loadCachedUpdateState(cacheFile);
     if (!input.force && cached && !isCacheExpired(cached, cacheTtlSeconds)) {
-        return {
-            ...cached.result,
+        const manifest = cached.manifest ?? manifestFromCachedResult(cached.result);
+        return buildUpdateCheckResult(manifest, {
+            checkedAt: cached.checkedAt,
+            cacheTtlSeconds,
+            manifestUrl,
             manifestSource: "cache",
-            cacheTtlSeconds
-        };
+            installedSkillsVersion: input.installedSkillsVersion
+        });
     }
     try {
         const manifest = await fetchReleaseManifest(manifestUrl);
@@ -25,29 +28,35 @@ export async function checkForUpdate(input = {}, env = process.env, cwd = proces
             checkedAt: new Date().toISOString(),
             cacheTtlSeconds,
             manifestUrl,
-            manifestSource: "remote"
+            manifestSource: "remote",
+            installedSkillsVersion: input.installedSkillsVersion
         });
         saveCachedUpdateState(cacheFile, {
             checkedAt: result.checkedAt,
             cacheTtlSeconds,
+            manifest,
             result
         });
         return result;
     }
     catch (error) {
         if (cached) {
-            return {
-                ...cached.result,
-                manifestSource: "cache",
+            const manifest = cached.manifest ?? manifestFromCachedResult(cached.result);
+            return buildUpdateCheckResult(manifest, {
+                checkedAt: cached.checkedAt,
                 cacheTtlSeconds,
+                manifestUrl,
+                manifestSource: "cache",
+                installedSkillsVersion: input.installedSkillsVersion,
                 error: error instanceof Error ? error.message : String(error)
-            };
+            });
         }
         return buildUnknownUpdateCheckResult({
             checkedAt: new Date().toISOString(),
             cacheTtlSeconds,
             manifestUrl,
             manifestSource: "fallback",
+            installedSkillsVersion: input.installedSkillsVersion,
             error: error instanceof Error ? error.message : String(error)
         });
     }
@@ -62,6 +71,11 @@ export function buildUpdateCheckResult(manifest, metadata) {
         minimumWriteVersion
     });
     const writeAllowed = status !== "WRITE_BLOCKED";
+    const installedSkillsVersion = normalizeInstalledSkillsVersion(metadata.installedSkillsVersion);
+    const skillsInstallStatus = computeSkillsInstallStatus(installedSkillsVersion, manifest.skillsVersion);
+    const skillsUpdateRecommended = manifest.skillsUpdateRecommended
+        || skillsInstallStatus === "UPDATE_AVAILABLE"
+        || (skillsInstallStatus === "NOT_VERIFIED" && compareVersions(RAPIDX_SKILLS_VERSION, manifest.skillsVersion) < 0);
     return {
         currentVersion: RAPIDX_VERSION,
         latestVersion: manifest.latestCliVersion,
@@ -71,6 +85,10 @@ export function buildUpdateCheckResult(manifest, metadata) {
         currentMcpSchemaVersion: SCHEMA_VERSION,
         skillsVersion: manifest.skillsVersion,
         currentSkillsVersion: RAPIDX_SKILLS_VERSION,
+        latestSkillsVersion: manifest.skillsVersion,
+        bundledExpectedSkillsVersion: RAPIDX_SKILLS_VERSION,
+        installedSkillsVersion,
+        skillsInstallStatus,
         skillsSchemaVersion: manifest.skillsSchemaVersion,
         currentSkillsSchemaVersion: RAPIDX_SKILLS_SCHEMA_VERSION,
         updateAvailable: compareVersions(RAPIDX_VERSION, manifest.latestCliVersion) < 0,
@@ -82,9 +100,12 @@ export function buildUpdateCheckResult(manifest, metadata) {
         cacheTtlSeconds: metadata.cacheTtlSeconds,
         manifestUrl: metadata.manifestUrl,
         manifestSource: metadata.manifestSource,
+        updateFreshness: freshnessForSource(metadata.manifestSource),
+        refreshCommand: "rapidx update check --input '{\"force\":true}' --json",
         releaseNotesUrl: manifest.releaseNotesUrl,
-        skillsUpdateRecommended: manifest.skillsUpdateRecommended || compareVersions(RAPIDX_SKILLS_VERSION, manifest.skillsVersion) < 0,
+        skillsUpdateRecommended,
         upgrade: manifest.upgrade,
+        ...(metadata.manifestSource === "cache" ? { cacheWarning: "Result came from local cache. Use force=true to refresh the remote release manifest." } : {}),
         ...(metadata.error ? { error: metadata.error } : {})
     };
 }
@@ -160,6 +181,8 @@ function fallbackManifest() {
 }
 function buildUnknownUpdateCheckResult(metadata) {
     const manifest = fallbackManifest();
+    const installedSkillsVersion = normalizeInstalledSkillsVersion(metadata.installedSkillsVersion);
+    const skillsInstallStatus = computeSkillsInstallStatus(installedSkillsVersion, manifest.skillsVersion);
     return {
         currentVersion: RAPIDX_VERSION,
         latestVersion: RAPIDX_VERSION,
@@ -169,6 +192,10 @@ function buildUnknownUpdateCheckResult(metadata) {
         currentMcpSchemaVersion: SCHEMA_VERSION,
         skillsVersion: manifest.skillsVersion,
         currentSkillsVersion: RAPIDX_SKILLS_VERSION,
+        latestSkillsVersion: manifest.skillsVersion,
+        bundledExpectedSkillsVersion: RAPIDX_SKILLS_VERSION,
+        installedSkillsVersion,
+        skillsInstallStatus,
         skillsSchemaVersion: manifest.skillsSchemaVersion,
         currentSkillsSchemaVersion: RAPIDX_SKILLS_SCHEMA_VERSION,
         updateAvailable: false,
@@ -180,6 +207,8 @@ function buildUnknownUpdateCheckResult(metadata) {
         cacheTtlSeconds: metadata.cacheTtlSeconds,
         manifestUrl: metadata.manifestUrl,
         manifestSource: metadata.manifestSource,
+        updateFreshness: freshnessForSource(metadata.manifestSource),
+        refreshCommand: "rapidx update check --input '{\"force\":true}' --json",
         releaseNotesUrl: "",
         skillsUpdateRecommended: false,
         upgrade: {},
@@ -198,6 +227,41 @@ function computeUpdateStatus(input) {
     }
     return "CURRENT";
 }
+function computeSkillsInstallStatus(installedSkillsVersion, latestSkillsVersion) {
+    if (installedSkillsVersion === "NOT_VERIFIED") {
+        return "NOT_VERIFIED";
+    }
+    return compareVersions(installedSkillsVersion, latestSkillsVersion) < 0 ? "UPDATE_AVAILABLE" : "CURRENT";
+}
+function normalizeInstalledSkillsVersion(value) {
+    return typeof value === "string" && isSemver(value) ? value : "NOT_VERIFIED";
+}
+function freshnessForSource(source) {
+    if (source === "remote") {
+        return "REMOTE";
+    }
+    if (source === "cache") {
+        return "CACHE";
+    }
+    return "FALLBACK";
+}
+function manifestFromCachedResult(result) {
+    return {
+        product: "rapidx",
+        channel: "stable",
+        latestCliVersion: result.latestVersion,
+        minimumSupportedVersion: result.minimumSupportedVersion,
+        minimumWriteVersion: result.minimumWriteVersion,
+        latestMcpSchemaVersion: result.latestMcpSchemaVersion,
+        skillsVersion: result.skillsVersion,
+        skillsSchemaVersion: result.skillsSchemaVersion,
+        skillsUpdateRecommended: result.skillsUpdateRecommended,
+        severity: result.severity,
+        breaking: result.breaking,
+        releaseNotesUrl: result.releaseNotesUrl,
+        upgrade: result.upgrade
+    };
+}
 function compareVersions(left, right) {
     const a = parseVersion(left);
     const b = parseVersion(right);
@@ -220,6 +284,9 @@ function parseVersion(version) {
     }
     return [Number(match[1]), Number(match[2]), Number(match[3])];
 }
+function isSemver(version) {
+    return /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.test(version);
+}
 function assertSemver(version, field) {
     try {
         parseVersion(version);

package/dist/core/version.js

@@ -1 +1 @@
-export const RAPIDX_VERSION = "1.0.32";
+export const RAPIDX_VERSION = "1.0.33";

package/dist/mcp/tool-runner.js

@@ -40,6 +40,9 @@ export async function runMcpTool(toolName, input = {}) {
             if (typeof input.maxCacheAgeSeconds === "number") {
                 updateInput.maxCacheAgeSeconds = input.maxCacheAgeSeconds;
             }
+            if (typeof input.installedSkillsVersion === "string") {
+                updateInput.installedSkillsVersion = input.installedSkillsVersion;
+            }
             const update = await checkForUpdate(updateInput);
             const status = envelopeStatusForUpdate(update.status);
             const auditId = writeMcpAudit("update-check", status, { toolName, updateStatus: update.status });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquiditytech/rapidx-cli",
-  "version": "1.0.32",
+  "version": "1.0.33",
   "description": "RapidX CLI, MCP server mode, registry, and release assets.",
   "type": "module",
   "private": false,

package/packages/distribution/docs/cli.md

@@ -44,6 +44,31 @@ rapidx portfolio set-position-mode --input @/absolute/path/set-position-mode.jso
 
 `rapidx update check --json` reads the RapidX release manifest and caches the result locally. Use it during setup, review, or session startup. Trade submit paths should not perform a fresh network update check.
 
+When checking an existing installation, read the installed RapidX skill `version` from the loaded `SKILL.md` frontmatter and pass it to update check:
+
+```bash
+rapidx update check --input '{"installedSkillsVersion":"1.0.8"}' --json
+```
+
+For upgrade reviews, force a remote manifest refresh:
+
+```bash
+rapidx update check --input '{"installedSkillsVersion":"1.0.8","force":true}' --json
+```
+
+Update output fields:
+
+- `latestVersion`: latest CLI version from the release manifest.
+- `currentVersion`: running CLI version.
+- `latestSkillsVersion` / `skillsVersion`: latest RapidX skills version from the release manifest.
+- `bundledExpectedSkillsVersion` / `currentSkillsVersion`: skills version expected by this CLI build, not proof of locally installed skills.
+- `installedSkillsVersion`: local skill version supplied by the caller, or `NOT_VERIFIED`.
+- `skillsInstallStatus`: `CURRENT`, `UPDATE_AVAILABLE`, or `NOT_VERIFIED`.
+- `manifestSource`: `remote`, `cache`, or `fallback`.
+- `updateFreshness`: `REMOTE`, `CACHE`, or `FALLBACK`.
+- `cacheWarning`: present when the result came from local cache.
+- `refreshCommand`: command for forcing a remote manifest refresh.
+
 `rapidx schema --json` returns `capabilities` plus `inputSchemas`. Agents should read the concrete input schema before constructing write inputs.
 
 `rapidx portfolio assets` reads `/api/v1/trading/portfolio/assets`. It is the canonical CLI command for portfolio asset balances.

package/packages/distribution/docs/skills.md

@@ -137,4 +137,4 @@ The config skill guides the agent to install `@liquiditytech/rapidx-cli`, config
 
 The trading skill guides read flow, preview-first write flow, state confirmation, and small real-trade verification.
 
-For existing installations, run `rapidx update check --json` or call `rapidx/update/check` through MCP before an integration review. Reinstall the GitHub-distributed skills when the update result sets `skillsUpdateRecommended=true`.
+For existing installations, read the installed skill `version` from each loaded `SKILL.md` frontmatter, then run `rapidx update check --input '{"installedSkillsVersion":"<local-skill-version>","force":true}' --json` or call `rapidx/update/check` through MCP with the same input before an integration review. Reinstall the GitHub-distributed skills when `skillsInstallStatus=UPDATE_AVAILABLE`, `installedSkillsVersion=NOT_VERIFIED`, or `skillsUpdateRecommended=true`.

package/packages/distribution/manifests/offline-manifest.json

@@ -1,11 +1,11 @@
 {
-  "version": "1.0.32",
+  "version": "1.0.33",
   "artifacts": [
     {
       "name": "rapidx-mcp-registry",
       "path": "packages/distribution/registry/rapidx.mcp.json",
       "channel": "offline",
-      "checksum": "sha256:b75ee5a765902c45f13614cdaf906633590456480fe91174ecee2422048aaf93",
+      "checksum": "sha256:a78b9c1ad3aa0df1f1e968e68c5ae30dbfcf39d4902e31973cbbfd0e306827ac",
       "status": "ready"
     },
     {

package/packages/distribution/registry/rapidx.mcp.json

@@ -1,7 +1,7 @@
 {
   "name": "rapidx",
   "packageName": "@liquiditytech/rapidx-cli",
-  "version": "1.0.32",
+  "version": "1.0.33",
   "command": "rapidx",
   "args": ["mcp", "serve"],
   "launchCommand": "rapidx",