gm-skill 2.0.1154 → 2.0.1155

package/README.md

@@ -35,7 +35,7 @@ An earlier generation fanned out fifteen per-platform downstream repos (gm-cc, g
 
 ## Version
 
-`2.0.1154` — auto-bumped from the canonical `gm` repo. Every push to `AnEntrypoint/gm` (or any cascading sibling crate) republishes this package.
+`2.0.1155` — auto-bumped from the canonical `gm` repo. Every push to `AnEntrypoint/gm` (or any cascading sibling crate) republishes this package.
 
 ## Source of truth
 

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

@@ -871,6 +871,7 @@ async function runSpoolWatcher(instance, spoolDir) {
 
   const UPDATE_AVAILABLE_PATH = path.join(spoolDir, '.update-available.json');
   const UPDATE_CHECK_INTERVAL_MS = 5 * 60 * 1000;
+  let _lastKnownDrift = null;
   function checkForUpdate() {
     const installed = resolveVersion(instance);
     const req = https.get({
@@ -879,7 +880,11 @@ async function runSpoolWatcher(instance, spoolDir) {
       headers: { 'user-agent': 'plugkit-watcher', 'accept': 'application/json' },
       timeout: 5000,
     }, (res) => {
-      if (res.statusCode !== 200) { res.resume(); return; }
+      if (res.statusCode !== 200) {
+        res.resume();
+        logEvent('plugkit', 'update.check.error', { installed, status: res.statusCode });
+        return;
+      }
       const chunks = [];
       res.on('data', c => chunks.push(c));
       res.on('end', () => {
@@ -890,21 +895,32 @@ async function runSpoolWatcher(instance, spoolDir) {
           const latest = tag.replace(/^v/, '');
           if (latest === installed) {
             try { fs.unlinkSync(UPDATE_AVAILABLE_PATH); } catch (_) {}
+            if (_lastKnownDrift) {
+              logEvent('plugkit', 'update.cleared', { installed, was: _lastKnownDrift });
+              _lastKnownDrift = null;
+            }
             return;
           }
+          const update_url = `https://github.com/AnEntrypoint/plugkit-bin/releases/tag/v${latest}`;
           fs.writeFileSync(UPDATE_AVAILABLE_PATH, JSON.stringify({
             installed,
             latest,
             checked_at_ms: Date.now(),
             instruction: 'plugkit is out of date. To update, close the running watcher and re-bootstrap with the @latest flag, e.g. node ~/.claude/gm-tools/plugkit-wasm-wrapper.js spool & after running bootstrap with {latest: true}.',
-            update_url: `https://github.com/AnEntrypoint/plugkit-bin/releases/tag/v${latest}`,
+            update_url,
           }, null, 2));
           console.log(`[update] available: installed=${installed} latest=${latest} → wrote ${UPDATE_AVAILABLE_PATH}`);
-        } catch (_) {}
+          if (_lastKnownDrift !== latest) {
+            logEvent('plugkit', 'update.available', { installed, latest, update_url });
+            _lastKnownDrift = latest;
+          }
+        } catch (e) {
+          logEvent('plugkit', 'update.check.error', { error: String(e && e.message || e) });
+        }
       });
     });
-    req.on('timeout', () => req.destroy());
-    req.on('error', () => {});
+    req.on('timeout', () => { req.destroy(); logEvent('plugkit', 'update.check.error', { error: 'timeout' }); });
+    req.on('error', (e) => logEvent('plugkit', 'update.check.error', { error: String(e && e.message || e) }));
   }
   setTimeout(checkForUpdate, 10_000);
   setInterval(checkForUpdate, UPDATE_CHECK_INTERVAL_MS);

package/gm.json

@@ -1,6 +1,6 @@
 {
   "name": "gm",
-  "version": "2.0.1154",
+  "version": "2.0.1155",
   "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.1154",
+  "version": "2.0.1155",
   "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",
@@ -39,7 +39,7 @@
     "gm.json"
   ],
   "dependencies": {
-    "gm-plugkit": "^2.0.1154"
+    "gm-plugkit": "^2.0.1155"
   },
   "engines": {
     "node": ">=16.0.0"

package/skills/gm-skill/SKILL.md

@@ -16,6 +16,8 @@ Do not create documentation files the user did not ask for. No COMPLETED.md, no
 
 Before any apparent stop, dispatch `residual-scan`. If it returns work that fits the spirit of the original ask and is reachable from this session, expand the PRD and execute; only residuals genuinely out-of-spirit or out-of-reach are name-and-stop. A turn that ends with uncommitted changes, an open PRD slice, or unresolved mutables has not actually stopped — it has stalled the chain.
 
+If the `instruction` response carries a non-null `update_available`, plugkit drift has been detected on disk and the running watcher is behind. Rebootstrap before continuing — newer fixes are sitting on disk unused, and every dispatch is wasted on stale code. `bun x gm-plugkit@latest` (or `npx -y gm-plugkit@latest`) is the one-shot: it fetches the new wasm, replaces the artifact, and the watcher reloads. Drift past one version is a deviation.
+
 The wasm artifact lives at `~/.claude/gm-tools/plugkit.wasm`; the spool watcher runs it. The watcher's own stdout/stderr is appended to `.gm/exec-spool/.watcher.log` — Read it to see plugkit's internal trace, dispatch timings, sweep actions, errors.
 
 ## Boot the spool watcher (first turn only)