gm-skill 2.0.1392 → 2.0.1394

package/gm-plugkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-plugkit",
-  "version": "2.0.1392",
+  "version": "2.0.1394",
   "description": "Bootstrap and daemon-spawn tool for gm plugkit binary. Downloads the correct platform binary, verifies SHA256, and starts the spool watcher daemon. Includes plugkit-wasm-wrapper for WASM-based spool watching.",
   "main": "index.js",
   "bin": {

package/gm-plugkit/plugkit-wasm-wrapper.js

@@ -1868,7 +1868,9 @@ async function runSpoolWatcher(instance, spoolDir) {
         const holderSha = parts[2] || '';
         const lockTs = parseInt(tsStr, 10);
         const age = Date.now() - lockTs;
-        if (age < 15000) {
+        const holderPidNum = parseInt(pidStr, 10);
+        const holderAlive = Number.isFinite(holderPidNum) && isProcessAliveSync(holderPidNum);
+        if (age < 15000 && holderAlive) {
           if (_ownWrapperSha12 && holderSha && holderSha !== _ownWrapperSha12) {
             try { logEvent('plugkit', 'peer.stale-wrapper-takeover', { holder_pid: pidStr, holder_sha: holderSha, own_sha: _ownWrapperSha12, lock_age_ms: age }); } catch (_) {}
             console.error(`[plugkit-wasm] peer wrapper-sha mismatch (holder=${holderSha} own=${_ownWrapperSha12}); killing pid=${pidStr} and taking over`);
@@ -1896,6 +1898,9 @@ async function runSpoolWatcher(instance, spoolDir) {
             } catch (_) {}
             process.exit(75);
           }
+        } else if (!holderAlive) {
+          console.error(`[plugkit-wasm] stale lock (holder pid=${pidStr} dead, age=${age}ms); taking over`);
+          try { logEvent('plugkit', 'watcher.lock-pid-dead-takeover', { stale_pid: pidStr, lock_age_ms: age }); } catch (_) {}
         } else {
           console.error(`[plugkit-wasm] stale lock (age=${age}ms); taking over`);
         }
@@ -2776,6 +2781,13 @@ async function runSpoolWatcher(instance, spoolDir) {
       } catch (_) {}
       const fileV = readFileVersionOnly() || null;
       const instV = _instanceVersionAtBoot || null;
+      let updateAvailable = null;
+      try {
+        const upd = JSON.parse(fs.readFileSync(path.join(spoolDir, '.update-available.json'), 'utf-8'));
+        if (upd && upd.installed && upd.latest && upd.installed !== upd.latest) {
+          updateAvailable = { installed: upd.installed, latest: upd.latest };
+        }
+      } catch (_) {}
       fs.writeFileSync(TURN_SUMMARY_PATH, JSON.stringify({
         ts: Date.now(),
         watcher_pid: process.pid,
@@ -2787,6 +2799,7 @@ async function runSpoolWatcher(instance, spoolDir) {
         last_instruction_age_ms: lastInstructionAgeMs,
         long_gap_threshold_ms: 300000,
         browser_sessions_alive: browserSessions,
+        update_available: updateAvailable,
       }));
     } catch (_) {}
   }

package/gm.json

@@ -1,6 +1,6 @@
 {
   "name": "gm",
-  "version": "2.0.1392",
+  "version": "2.0.1394",
   "description": "Spool-dispatch orchestration engine with unified state machine, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-skill",
-  "version": "2.0.1392",
+  "version": "2.0.1394",
   "description": "Canonical universal harness — AI-native software engineering via skill-driven orchestration; bootstraps plugkit for task execution and session isolation. Install in any AI coding agent host.",
   "author": "AnEntrypoint",
   "license": "MIT",

package/skills/gm-skill/SKILL.md

@@ -22,13 +22,15 @@ Every turn: dispatch `instruction` (you are the one dispatching it), read the re
 
 **Boot before dispatching. Always check first.** Writing to `.gm/exec-spool/in/instruction/N.txt` while the watcher is dead is the canonical cold-start failure — the request sits forever, you read no response, you fabricate the chain from memory of the prose. The spool directory's existence does NOT mean the watcher is alive; `.status.json` mtime within the last 15s does. The leftover `.status.json` from yesterday's dead watcher is the most common trap.
 
-Your first tool call of every session is the boot probe, in one Bash invocation:
+Your first tool call of every session is the boot probe, in one Bash invocation. Read `.status.json` (liveness) and `.turn-summary.json` (orientation) together — the watcher precomputes both every 5s, so the two files give you everything you'd otherwise extract via gmsniff queries, git, yaml-parse, and ports-file scans:
 
 ```bash
-cat .gm/exec-spool/.status.json 2>/dev/null; date +%s%3N
+cat .gm/exec-spool/.status.json 2>/dev/null; echo ---; cat .gm/exec-spool/.turn-summary.json 2>/dev/null; echo ---; date +%s%3N
 ```
 
-Compare the `ts` field to the printed epoch ms. If the gap is >15000, the watcher is dead — boot it:
+`.turn-summary.json` carries `phase`, `last_skill`, `prd_pending`, `last_instruction_ts`, `last_instruction_age_ms`, `long_gap_threshold_ms`, `browser_sessions_alive`, `update_available`. When age exceeds the threshold, your next non-orienting verb will be gated — dispatch `instruction` first. When `update_available` is non-null, the watcher has detected drift: kill the watcher and re-bootstrap before continuing so the next instruction lands on the fresh wasm.
+
+Compare `.status.json` `ts` field to the printed epoch ms. If the gap is >15000, the watcher is dead — boot it:
 
 ```bash
 bun x gm-plugkit@latest spool > /dev/null 2>&1 &