sequant 1.6.0 → 1.6.1

package/dist/src/commands/doctor.js

@@ -19,7 +19,7 @@ export async function doctorCommand() {
                 message: `Outdated: ${versionResult.currentVersion} → ${versionResult.latestVersion} available`,
             });
             // Show remediation steps
-            console.log(chalk.yellow(`  ⚠️  ${getVersionWarning(versionResult.currentVersion, versionResult.latestVersion)}`));
+            console.log(chalk.yellow(`  ⚠️  ${getVersionWarning(versionResult.currentVersion, versionResult.latestVersion, versionResult.isLocalInstall)}`));
             console.log("");
         }
         else {

package/dist/src/commands/run.js

@@ -742,7 +742,7 @@ export async function runCommand(issues, options) {
         try {
             const versionResult = await checkVersionCached();
             if (versionResult.isOutdated && versionResult.latestVersion) {
-                console.log(chalk.yellow(`  ⚠️  ${getVersionWarning(versionResult.currentVersion, versionResult.latestVersion)}`));
+                console.log(chalk.yellow(`  ⚠️  ${getVersionWarning(versionResult.currentVersion, versionResult.latestVersion, versionResult.isLocalInstall)}`));
                 console.log("");
             }
         }

package/dist/src/lib/version-check.d.ts

@@ -12,6 +12,7 @@ export interface VersionCheckResult {
     currentVersion: string;
     latestVersion: string | null;
     isOutdated: boolean;
+    isLocalInstall?: boolean;
     error?: string;
 }
 /**
@@ -26,6 +27,17 @@ export declare function getCachePath(): string;
  * Get the current version from package.json
  */
 export declare function getCurrentVersion(): string;
+/**
+ * Check if running from a local node_modules install (vs npx cache)
+ *
+ * Local installs are in: <project>/node_modules/sequant/
+ * npx installs are in: ~/.npm/_npx/<hash>/node_modules/sequant/
+ *
+ * This matters because:
+ * - Local installs should be updated with: npm update sequant
+ * - npx installs should be updated with: npx sequant@latest
+ */
+export declare function isLocalNodeModulesInstall(): boolean;
 /**
  * Read the version cache
  */
@@ -53,8 +65,11 @@ export declare function compareVersions(a: string, b: string): number;
 export declare function isOutdated(currentVersion: string, latestVersion: string): boolean;
 /**
  * Get the version warning message
+ *
+ * For local node_modules installs, recommends `npm update sequant`
+ * For npx usage, recommends `npx sequant@latest`
  */
-export declare function getVersionWarning(currentVersion: string, latestVersion: string): string;
+export declare function getVersionWarning(currentVersion: string, latestVersion: string, isLocal?: boolean): string;
 /**
  * Check version freshness (thorough - for doctor command)
  * Always fetches from npm registry

package/dist/src/lib/version-check.js

@@ -54,6 +54,25 @@ export function getCurrentVersion() {
         return "0.0.0";
     }
 }
+/**
+ * Check if running from a local node_modules install (vs npx cache)
+ *
+ * Local installs are in: <project>/node_modules/sequant/
+ * npx installs are in: ~/.npm/_npx/<hash>/node_modules/sequant/
+ *
+ * This matters because:
+ * - Local installs should be updated with: npm update sequant
+ * - npx installs should be updated with: npx sequant@latest
+ */
+export function isLocalNodeModulesInstall() {
+    // Check if our path contains node_modules/sequant but NOT in .npm/_npx
+    const normalizedPath = __dirname.replace(/\\/g, "/");
+    // Running from local node_modules (not npx cache)
+    const inNodeModules = normalizedPath.includes("/node_modules/sequant");
+    const inNpxCache = normalizedPath.includes("/.npm/_npx/") ||
+        normalizedPath.includes("\\.npm\\_npx\\");
+    return inNodeModules && !inNpxCache;
+}
 /**
  * Read the version cache
  */
@@ -158,10 +177,19 @@ export function isOutdated(currentVersion, latestVersion) {
 }
 /**
  * Get the version warning message
+ *
+ * For local node_modules installs, recommends `npm update sequant`
+ * For npx usage, recommends `npx sequant@latest`
  */
-export function getVersionWarning(currentVersion, latestVersion) {
+export function getVersionWarning(currentVersion, latestVersion, isLocal) {
+    const isLocalInstall = isLocal ?? isLocalNodeModulesInstall();
+    if (isLocalInstall) {
+        return `sequant ${latestVersion} is available (you have ${currentVersion})
+   Run: npm update sequant
+   Note: You have sequant as a local dependency. npx uses your node_modules version.`;
+    }
     return `sequant ${latestVersion} is available (you have ${currentVersion})
-   Run: npx sequant@latest or npm update sequant`;
+   Run: npx sequant@latest`;
 }
 /**
  * Check version freshness (thorough - for doctor command)
@@ -169,12 +197,14 @@ export function getVersionWarning(currentVersion, latestVersion) {
  */
 export async function checkVersionThorough() {
     const currentVersion = getCurrentVersion();
+    const isLocal = isLocalNodeModulesInstall();
     const latestVersion = await fetchLatestVersion();
     if (!latestVersion) {
         return {
             currentVersion,
             latestVersion: null,
             isOutdated: false,
+            isLocalInstall: isLocal,
             error: "Could not fetch latest version",
         };
     }
@@ -184,6 +214,7 @@ export async function checkVersionThorough() {
         currentVersion,
         latestVersion,
         isOutdated: isOutdated(currentVersion, latestVersion),
+        isLocalInstall: isLocal,
     };
 }
 /**
@@ -192,6 +223,7 @@ export async function checkVersionThorough() {
  */
 export async function checkVersionCached() {
     const currentVersion = getCurrentVersion();
+    const isLocal = isLocalNodeModulesInstall();
     // Check cache first
     const cache = readCache();
     if (cache && isCacheFresh(cache)) {
@@ -199,6 +231,7 @@ export async function checkVersionCached() {
             currentVersion,
             latestVersion: cache.latestVersion,
             isOutdated: isOutdated(currentVersion, cache.latestVersion),
+            isLocalInstall: isLocal,
         };
     }
     // Fetch new version (with timeout)
@@ -210,12 +243,14 @@ export async function checkVersionCached() {
                 currentVersion,
                 latestVersion: cache.latestVersion,
                 isOutdated: isOutdated(currentVersion, cache.latestVersion),
+                isLocalInstall: isLocal,
             };
         }
         return {
             currentVersion,
             latestVersion: null,
             isOutdated: false,
+            isLocalInstall: isLocal,
         };
     }
     // Update cache
@@ -224,5 +259,6 @@ export async function checkVersionCached() {
         currentVersion,
         latestVersion,
         isOutdated: isOutdated(currentVersion, latestVersion),
+        isLocalInstall: isLocal,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sequant",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Quantize your development workflow - Sequential AI phases with quality gates",
   "type": "module",
   "bin": {