gm-skill 2.0.1118 → 2.0.1120

package/README.md

@@ -28,7 +28,7 @@ npx gm-skill-bootstrap
 
 ## Version
 
-`2.0.1118` — auto-bumped from the canonical `gm` repo. Every push to `AnEntrypoint/gm` republishes this package alongside all 15 platform packages.
+`2.0.1120` — auto-bumped from the canonical `gm` repo. Every push to `AnEntrypoint/gm` republishes this package alongside all 15 platform packages.
 
 ## Source of truth
 

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

@@ -2,6 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 import crypto from 'crypto';
+import https from 'https';
 import { watch } from 'fs';
 import { spawn, spawnSync } from 'child_process';
 import net from 'net';
@@ -736,6 +737,46 @@ async function runSpoolWatcher(instance, spoolDir) {
   setInterval(writeStatus, 5000);
   writeStatus();
 
+  const UPDATE_AVAILABLE_PATH = path.join(spoolDir, '.update-available.json');
+  const UPDATE_CHECK_INTERVAL_MS = 5 * 60 * 1000;
+  function checkForUpdate() {
+    const installed = resolveVersion(instance);
+    const req = https.get({
+      host: 'api.github.com',
+      path: '/repos/AnEntrypoint/plugkit-bin/releases/latest',
+      headers: { 'user-agent': 'plugkit-watcher', 'accept': 'application/json' },
+      timeout: 5000,
+    }, (res) => {
+      if (res.statusCode !== 200) { res.resume(); return; }
+      const chunks = [];
+      res.on('data', c => chunks.push(c));
+      res.on('end', () => {
+        try {
+          const rel = JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+          const tag = rel && rel.tag_name;
+          if (!tag) return;
+          const latest = tag.replace(/^v/, '');
+          if (latest === installed) {
+            try { fs.unlinkSync(UPDATE_AVAILABLE_PATH); } catch (_) {}
+            return;
+          }
+          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}`,
+          }, null, 2));
+          console.log(`[update] available: installed=${installed} latest=${latest} → wrote ${UPDATE_AVAILABLE_PATH}`);
+        } catch (_) {}
+      });
+    });
+    req.on('timeout', () => req.destroy());
+    req.on('error', () => {});
+  }
+  setTimeout(checkForUpdate, 10_000);
+  setInterval(checkForUpdate, UPDATE_CHECK_INTERVAL_MS);
+
   const pollInterval = setInterval(async () => {
     const existing = walkDir(inDir);
     for (const fullPath of existing) {

package/gm.json

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

package/lib/skill-bootstrap.js

@@ -10,18 +10,12 @@ const PLUGKIT_TOOLS_DIR = path.join(os.homedir(), '.claude', 'gm-tools');
 const PLUGKIT_VERSION_FILE = path.join(PLUGKIT_TOOLS_DIR, 'plugkit.version');
 const PLUGKIT_WASM_PATH = path.join(PLUGKIT_TOOLS_DIR, 'plugkit.wasm');
 const PLUGKIT_WASM_WRAPPER = path.join(PLUGKIT_TOOLS_DIR, 'plugkit-wasm-wrapper.js');
-const PLUGKIT_LATEST_CACHE = path.join(PLUGKIT_TOOLS_DIR, 'plugkit-latest.json');
-const PLUGKIT_LATEST_TTL_MS = 60 * 60 * 1000;
-const NPM_PACKAGE = '@anentrypoint/plugkit-wasm';
 const BOOTSTRAP_STATUS_FILE = path.join(os.homedir(), '.gm', 'bootstrap-status.json');
 const BOOTSTRAP_ERROR_FILE = path.join(os.homedir(), '.gm', 'bootstrap-error.json');
 const LOG_DIR = path.join(os.homedir(), '.claude', 'gm-log');
 
 function getPlugkitPath() {
-  if (fs.existsSync(PLUGKIT_WASM_WRAPPER) && fs.existsSync(PLUGKIT_WASM_PATH)) {
-    return PLUGKIT_WASM_WRAPPER;
-  }
-  throw new Error(`plugkit WASM not found at ${PLUGKIT_WASM_PATH}`);
+  return PLUGKIT_WASM_PATH;
 }
 
 function emitBootstrapEvent(severity, message, details) {
@@ -127,16 +121,6 @@ function httpGet(url, timeoutMs) {
 }
 
 async function getLatestRemoteVersion() {
-  try {
-    const stat = fs.statSync(PLUGKIT_LATEST_CACHE);
-    if (Date.now() - stat.mtimeMs < PLUGKIT_LATEST_TTL_MS) {
-      const cached = JSON.parse(fs.readFileSync(PLUGKIT_LATEST_CACHE, 'utf-8'));
-      if (cached && cached.version) {
-        emitBootstrapEvent('info', 'Using cached latest version', { version: cached.version, ageMs: Date.now() - stat.mtimeMs });
-        return cached;
-      }
-    }
-  } catch (_) {}
   let version = null;
   let source = null;
   try {
@@ -176,13 +160,8 @@ async function getLatestRemoteVersion() {
   } catch (e) {
     emitBootstrapEvent('warn', 'sha fetch failed; will verify after download', { error: e.message, version });
   }
-  const payload = { version, sha, source, fetchedAt: Date.now() };
-  try {
-    fs.mkdirSync(PLUGKIT_TOOLS_DIR, { recursive: true });
-    fs.writeFileSync(PLUGKIT_LATEST_CACHE, JSON.stringify(payload, null, 2));
-  } catch (_) {}
   emitBootstrapEvent('info', 'Resolved latest plugkit version', { version, source, hasSha: Boolean(sha) });
-  return payload;
+  return { version, sha, source };
 }
 
 function gitignorePath(cwd) { return path.join(cwd, '.gitignore'); }
@@ -272,34 +251,15 @@ function ensureManagedGitignore(cwd) {
 async function downloadPlugkitBinary(version) {
   const binaryName = 'plugkit.wasm';
   const url = `https://github.com/AnEntrypoint/plugkit-bin/releases/download/v${version}/${binaryName}`;
-
   emitBootstrapEvent('info', 'Starting WASM download', { version, url });
-
-  return new Promise((resolve, reject) => {
-    https
-      .get(url, { timeout: 30000 }, (res) => {
-        if (res.statusCode === 404) {
-          reject(new Error(`WASM not found: v${version}`));
-          return;
-        }
-        if (res.statusCode !== 200) {
-          reject(new Error(`HTTP ${res.statusCode} downloading plugkit.wasm`));
-          return;
-        }
-
-        const chunks = [];
-        res.on('data', (chunk) => chunks.push(chunk));
-        res.on('end', () => {
-          const data = Buffer.concat(chunks);
-          emitBootstrapEvent('info', 'WASM download complete', { bytes: data.length });
-          resolve(data);
-        });
-      })
-      .on('error', (e) => {
-        emitBootstrapEvent('error', 'Download failed', { error: e.message });
-        reject(e);
-      });
-  });
+  try {
+    const buf = await httpGet(url, 30000);
+    emitBootstrapEvent('info', 'WASM download complete', { bytes: buf.length });
+    return buf;
+  } catch (e) {
+    emitBootstrapEvent('error', 'Download failed', { error: e.message });
+    throw e;
+  }
 }
 
 function findPlugkitWasmPids() {
@@ -460,21 +420,31 @@ async function spawnPlugkitWatcher(wasmPath) {
   }
 }
 
-async function bootstrapPlugkit(sessionId) {
+async function bootstrapPlugkit(sessionId, options) {
   const startTime = Date.now();
+  const opts = options || {};
+  const forceLatest = Boolean(opts.latest);
 
   try {
-    emitBootstrapEvent('info', 'Bootstrap started');
+    emitBootstrapEvent('info', 'Bootstrap started', { forceLatest });
 
     ensureManagedGitignore(process.cwd());
 
     const manifest = readManifest();
-    const latest = await getLatestRemoteVersion();
-    const targetVersion = (latest && latest.version) || manifest.version;
-    const expectedHash = (latest && latest.sha) || manifest.expectedHash;
-    if (latest && latest.version !== manifest.version) {
-      emitBootstrapEvent('info', 'Latest plugkit newer than manifest pin', { latest: latest.version, manifest: manifest.version });
+    let targetVersion = manifest.version;
+    let expectedHash = manifest.expectedHash;
+
+    if (forceLatest) {
+      const latest = await getLatestRemoteVersion();
+      if (latest && latest.version) {
+        targetVersion = latest.version;
+        expectedHash = latest.sha || expectedHash;
+        if (latest.version !== manifest.version) {
+          emitBootstrapEvent('info', 'forceLatest: using newer remote version', { latest: latest.version, manifest: manifest.version });
+        }
+      }
     }
+
     const installedVersion = getInstalledVersion();
     const plugkitPath = getPlugkitPath();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-skill",
-  "version": "2.0.1118",
+  "version": "2.0.1120",
   "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.1118"
+    "gm-plugkit": "^2.0.1120"
   },
   "engines": {
     "node": ">=16.0.0"

package/skills/gm-skill/SKILL.md

@@ -16,6 +16,10 @@ Check `.gm/exec-spool/.status.json`. If absent or `ts` > 15s old:
 
 Wait 2 seconds, verify `.status.json` is fresh. Then proceed.
 
+## Plugkit version updates
+
+The watcher checks GitHub Releases every 5 minutes for a newer plugkit. If drift is detected, it writes `.gm/exec-spool/.update-available.json` with `{installed, latest, instruction, update_url}`; if no drift, the file is removed. Read this file at session start (and occasionally afterward); if present, kill the current watcher, run `bootstrapPlugkit({latest: true})` once to fetch the new wasm, then restart the watcher. Default bootstrap never hits the network — only `{latest: true}` fetches the newest binary.
+
 ## Dispatch ABI
 
 Write request body to `.gm/exec-spool/in/<verb>/<N>.txt`. Read response from `.gm/exec-spool/out/<verb>-<N>.json` (nested verbs) or `out/<N>.json` (root verbs). Bodies are JSON, raw code, or a single phase name depending on the verb.