gm-skill 2.0.1265 → 2.0.1267

package/README.md

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

package/bin/plugkit.version

@@ -1 +1 @@
-0.1.467
+0.1.468

package/bin/plugkit.wasm.sha256

@@ -1 +1 @@
-21a0c7b54788cec3dc35cbc00c4847ced155a2c8336b0c01d0987d2cc2247f06  plugkit.wasm
+89f0141b6e50ced98a5216b7ed553da3f529bac96f6d9e2927a1ed1737223d62  plugkit.wasm

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

@@ -42,6 +42,7 @@ function emitShutdownReason(reason, err) {
       version: typeof PLUGKIT_VERSION !== 'undefined' ? PLUGKIT_VERSION : null,
     };
     fs.writeFileSync(path.join(spoolDir, '.shutdown-reason.json'), JSON.stringify(body, null, 2));
+    try { fs.unlinkSync(path.join(spoolDir, '.boot-active.json')); } catch (_) {}
   } catch (_) {}
 }
 
@@ -1497,6 +1498,47 @@ async function runSpoolWatcher(instance, spoolDir) {
   acquireLock();
   setInterval(refreshLock, 5000);
 
+  const BOOT_ACTIVE_PATH = path.join(spoolDir, '.boot-active.json');
+  const SHUTDOWN_REASON_PATH_EARLY = path.join(spoolDir, '.shutdown-reason.json');
+  try {
+    let priorBoot = null;
+    let priorShutdownForAbort = null;
+    try { priorBoot = JSON.parse(fs.readFileSync(BOOT_ACTIVE_PATH, 'utf-8')); } catch (_) {}
+    try { priorShutdownForAbort = JSON.parse(fs.readFileSync(SHUTDOWN_REASON_PATH_EARLY, 'utf-8')); } catch (_) {}
+    if (priorBoot && Number.isFinite(priorBoot.ts) && priorBoot.pid !== process.pid) {
+      const ageMs = Date.now() - priorBoot.ts;
+      const shutdownIsNewer = priorShutdownForAbort && Number.isFinite(priorShutdownForAbort.ts) && priorShutdownForAbort.ts >= priorBoot.ts;
+      if (ageMs > 30_000 && !shutdownIsNewer) {
+        logEvent('plugkit', 'watcher.silent-abort', {
+          prior_pid: priorBoot.pid,
+          prior_ts: priorBoot.ts,
+          prior_sha: priorBoot.wrapper_sha || null,
+          prior_version: priorBoot.version || null,
+          detected_at: Date.now(),
+          age_ms: ageMs,
+          shutdown_reason_present: !!priorShutdownForAbort,
+          shutdown_reason_ts: priorShutdownForAbort ? priorShutdownForAbort.ts : null,
+        });
+        try { console.error(`[plugkit-wasm] SILENT ABORT detected: prior watcher pid=${priorBoot.pid} sha=${priorBoot.wrapper_sha} died without writing .shutdown-reason.json (age=${ageMs}ms)`); } catch (_) {}
+      }
+    }
+  } catch (_) {}
+  function writeBootActive() {
+    try {
+      const _v = readInstanceVersion(instance);
+      fs.writeFileSync(BOOT_ACTIVE_PATH, JSON.stringify({
+        pid: process.pid,
+        ts: Date.now(),
+        wrapper_sha: _ownWrapperSha12 || null,
+        version: _v || null,
+      }));
+    } catch (_) {}
+  }
+  function clearBootActive() {
+    try { fs.unlinkSync(BOOT_ACTIVE_PATH); } catch (_) {}
+  }
+  writeBootActive();
+
   const PEER_REGISTRY_PATH = path.join(os.homedir(), '.claude', 'gm-tools', 'peer-registry.json');
   function registerSelfAsPeer() {
     try {
@@ -1593,6 +1635,7 @@ async function runSpoolWatcher(instance, spoolDir) {
     } catch (_) {}
 
     try { fs.unlinkSync(STATUS_PATH_FOR_TEARDOWN); } catch (_) {}
+    try { clearBootActive(); } catch (_) {}
     try { releaseLock(); } catch (_) {}
     process.exit(0);
   }
@@ -1624,6 +1667,7 @@ async function runSpoolWatcher(instance, spoolDir) {
       } catch (_) {}
       try { releaseLock(); } catch (_) {}
       try { fs.unlinkSync(STATUS_PATH_FOR_TEARDOWN); } catch (_) {}
+      try { clearBootActive(); } catch (_) {}
       process.exit(0);
     } catch (e) {
       console.error(`[version-drift-check] error: ${e.message}`);
@@ -1659,6 +1703,7 @@ async function runSpoolWatcher(instance, spoolDir) {
       } catch (_) {}
       try { releaseLock(); } catch (_) {}
       try { fs.unlinkSync(STATUS_PATH_FOR_TEARDOWN); } catch (_) {}
+      try { clearBootActive(); } catch (_) {}
       process.exit(0);
     } catch (e) {
       console.error(`[wrapper-drift-check] error: ${e.message}`);
@@ -1690,9 +1735,21 @@ async function runSpoolWatcher(instance, spoolDir) {
     }
   }, IDLE_CHECK_MS);
 
-  process.on('SIGINT', () => { releaseLock(); process.exit(0); });
-  process.on('SIGTERM', () => { releaseLock(); process.exit(0); });
-  process.on('exit', releaseLock);
+  function handleSignalShutdown(sig) {
+    try {
+      fs.writeFileSync(SHUTDOWN_REASON_PATH, JSON.stringify({
+        reason: sig.toLowerCase(),
+        ts: Date.now(),
+        pid: process.pid,
+      }));
+    } catch (_) {}
+    try { clearBootActive(); } catch (_) {}
+    try { releaseLock(); } catch (_) {}
+    process.exit(0);
+  }
+  process.on('SIGINT', () => handleSignalShutdown('SIGINT'));
+  process.on('SIGTERM', () => handleSignalShutdown('SIGTERM'));
+  process.on('exit', () => { try { clearBootActive(); } catch (_) {} releaseLock(); });
 
   try {
     const wrapperDst = path.join(os.homedir(), '.claude', 'gm-tools', 'plugkit-wasm-wrapper.js');

package/gm.json

@@ -1,6 +1,6 @@
 {
   "name": "gm",
-  "version": "2.0.1265",
+  "version": "2.0.1267",
   "description": "Spool-dispatch orchestration engine with unified state machine, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",
@@ -17,5 +17,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "plugkitVersion": "0.1.467"
+  "plugkitVersion": "0.1.468"
 }

package/package.json

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

package/skills/gm-skill/SKILL.md

@@ -22,6 +22,6 @@ bun x gm-plugkit@latest spool > /dev/null 2>&1 &
 
 **Batch writes, waits, and reads together.** Each agent turn costs cycles; the dispatch shape `Write request → wait → Read response` is one logical step, not three. Issue all three in a single message — the Write tool call and the Read tool call go in the same `<function_calls>` block. The Read may return "file does not exist" if plugkit is mid-verb; that's fine, retry with one more Read in the next message rather than spreading the cycle across three turns. Fan-out is the same shape — dispatching three independent verbs (`prd-add g1`, `prd-add g2`, `prd-add g3`) means three Write tool calls in one block, then three Read tool calls in one block. Serial dispatch when you could be parallel is wasted cycles. The only sequencing constraint is real data dependency: if verb B needs the response of verb A, those go in separate turns; otherwise batch.
 
-Response body is not a mutation surface. Memory writes route through `memorize-fire` only — another verb YOU dispatch.
+Response body is not a mutation surface. Memory writes route through `memorize-fire` only — another verb YOU dispatch. **Never** write persistent memory to platform-specific paths (`~/.claude/projects/*/memory/`, `~/.codex/memory/`, `~/.cursor/*`, etc.) — those don't transport between agent platforms and break the moment a session runs under a different harness. The only two portable surfaces are (a) dispatched `memorize-fire` (which writes through plugkit to the rs-learn store that travels with the project) and (b) `AGENTS.md` for project-tracked rules. If you reach for a `Write` tool on a memory directory under `~/`, stop — that's the lock-in anti-pattern.
 
 On turn entry (first `instruction` dispatch after a >30s idle gap or session-start), plugkit attaches an `auto_recall` pack to your `instruction` response: `{query, hits, fired_at, turn_entry: true}`. The query is derived from `.gm/last-prompt.txt` / `.gm/turn-state.json`; hits are the top recall results plugkit pulled before serving your instruction. Read `auto_recall.hits` alongside the existing `recall_hits` (which is the phase+PRD-subject pack) — both surface prior memory, but `auto_recall` is the per-turn user-prompt pack and only fires on turn entry. Subsequent `instruction` dispatches in the same turn carry no `auto_recall` field (or carry the same pack from the turn-start fire); do not re-trigger it manually.