viepilot 3.12.0 → 3.12.1

package/CHANGELOG.md

@@ -9,6 +9,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [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/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-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.1",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {