viepilot 3.12.0 → 3.12.2

package/CHANGELOG.md

@@ -9,6 +9,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [3.12.2] - 2026-05-30
+### Fixed
+- BUG-032: `npx viepilot install` silently missed new skills (e.g. `vp-qa`) when the globally-installed package was behind npm latest (2.50.1 vs 3.12.1). `installCommand` now prints a non-blocking version-mismatch warning with the upgrade command when installed < npm latest.
+- BUG-032: `applyInstallPlan` now logs `new: {path}` when a `copy_dir` step creates a directory for the first time, making newly-added skills visible in the install output instead of appearing silently.
+
+---
+
+## [3.12.1] - 2026-05-26
+### Fixed
+- `bin/vp-tools.cjs` `check-update --silent`: OS session guard file (`/tmp/vp-update-check-{today}.done`) — subsequent skill invocations skip npm call entirely, exit with 0 stdout (0 tokens) (DEBT-003)
+- `lib/viepilot-update.cjs`: reduce version cache TTL 24h → 6h for more timely update notices (DEBT-003)
+
+---
+
 ## [3.12.0] - 2026-05-25
 ### Changed
 - `workflows/autonomous.md`: tracker-agent now rewrites Current State block (find-and-replace)

package/bin/viepilot.cjs

@@ -15,6 +15,12 @@ const { buildInstallPlan, applyInstallPlan, resolveViepilotPackageRoot } = requi
   'viepilot-install.cjs',
 ));
 const { adapters: adapterMap } = require(path.join(__dirname, '..', 'lib', 'adapters', 'index.cjs'));
+const { readInstalledVersion, fetchLatestNpmVersion } = require(path.join(
+  __dirname, '..', 'lib', 'viepilot-info.cjs'
+));
+const { compareSemver } = require(path.join(
+  __dirname, '..', 'lib', 'viepilot-update.cjs'
+));
 
 // UI target list — keep cursor-agent and cursor-ide as distinct choices for users.
 const LANGUAGES = [
@@ -362,6 +368,30 @@ async function installCommand(rawArgs) {
 
   console.log(`\nSelected targets: ${selectedTargets.join(', ')}`);
   console.log(`Communication language: ${communicationLang}`);
+
+  // BUG-032: warn when installed version is behind npm latest — new skills may be missing
+  try {
+    const pkgRoot = resolveViepilotPackageRoot(__dirname);
+    const installed = pkgRoot ? readInstalledVersion(pkgRoot) : null;
+    const latest = fetchLatestNpmVersion();
+    if (installed && latest.ok && compareSemver(installed, latest.version) < 0) {
+      const line1 = `⚠  viepilot@${installed} is behind npm@${latest.version}`;
+      const line2 = '   New skills in the latest version may not be installed.';
+      const line3 = '   Upgrade first:';
+      const line4 = '     npm i -g viepilot && vp-tools install';
+      const W = 65;
+      const bar = '─'.repeat(W);
+      console.log(`\n┌${bar}┐`);
+      console.log(`│ ${line1.padEnd(W - 1)}│`);
+      console.log(`│ ${line2.padEnd(W - 1)}│`);
+      console.log(`│ ${line3.padEnd(W - 1)}│`);
+      console.log(`│ ${line4.padEnd(W - 1)}│`);
+      console.log(`└${bar}┘`);
+    }
+  } catch (_) {
+    // non-blocking — network or fs errors must not abort install
+  }
+
   const run = runInstallViaNode(selectedTargets, options.dryRun, communicationLang);
   const results = selectedTargets.map((target) => ({
     ok: run.ok,

package/bin/vp-tools.cjs

@@ -1174,10 +1174,43 @@ ${colors.cyan}Examples:${colors.reset}
     const silent = args.includes('--silent');
     const json = args.includes('--json');
     const force = args.includes('--force');
+
+    // OS session guard — skip npm check if already done today (DEBT-003)
+    if (!force && !json) {
+      const _os = require('os');
+      const _today = new Date().toISOString().split('T')[0];
+      const _guardFile = require('path').join(_os.tmpdir(), `vp-update-check-${_today}.done`);
+      if (fs.existsSync(_guardFile)) {
+        try {
+          const _g = JSON.parse(fs.readFileSync(_guardFile, 'utf8'));
+          if (silent) {
+            if (_g.updateAvailable) { process.stdout.write(_g.latest + '\n'); process.exit(1); }
+            process.exit(0);
+          }
+          process.exit(0);
+        } catch (_) { /* corrupt guard — fall through */ }
+      }
+    }
+
     const { checkLatestVersion } = require('../lib/viepilot-update.cjs');
 
     checkLatestVersion({ force })
       .then(({ upToDate, installed, latest }) => {
+        // Write OS session guard for subsequent skill inits (DEBT-003)
+        if (silent || !json) {
+          try {
+            const _os2 = require('os');
+            const _today2 = new Date().toISOString().split('T')[0];
+            const _gf = require('path').join(_os2.tmpdir(), `vp-update-check-${_today2}.done`);
+            fs.writeFileSync(_gf, JSON.stringify({
+              updateAvailable: !upToDate,
+              latest,
+              installed,
+              checkedAt: new Date().toISOString()
+            }));
+          } catch (_) { /* non-fatal */ }
+        }
+
         const has_update = !upToDate;
         if (json) {
           process.stdout.write(JSON.stringify({ installed, latest, has_update }) + '\n');

package/lib/viepilot-install.cjs

@@ -465,7 +465,9 @@ function applyInstallPlan(plan, options = {}) {
             if (!fs.existsSync(step.from)) {
               throw new Error(`Missing source dir: ${step.from}`);
             }
+            const isNewDir = !fs.existsSync(step.to);
             copyDirRecursive(step.from, step.to);
+            if (isNewDir) logs.push(`new: ${step.to}`);
           }
           break;
         case 'symlink_dir':

package/lib/viepilot-update.cjs

@@ -161,7 +161,7 @@ function runNpmUpdate(plan) {
  */
 async function checkLatestVersion(opts = {}) {
   const SILENT_RESULT = { upToDate: true, installed: '', latest: '' };
-  const TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+  const TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
 
   try {
     const cacheFile =

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "3.12.0",
+  "version": "3.12.2",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {