gm-skill 2.0.1217 → 2.0.1218

package/README.md

@@ -35,7 +35,7 @@ An earlier generation fanned out fifteen per-platform downstream repos (gm-cc, g
 
 ## Version
 
-`2.0.1217` — auto-bumped from the canonical `gm` repo. Every push to `AnEntrypoint/gm` (or any cascading sibling crate) republishes this package.
+`2.0.1218` — 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

@@ -70,6 +70,32 @@ function isSpoolPollCommand(command) {
   return null;
 }
 
+function isBrowserRunningFileLocal(rel) {
+  if (!rel) return false;
+  const norm = String(rel).replace(/\\\\/g, '/');
+  if (/\\.(html?|tsx|jsx|vue|svelte)$/i.test(norm)) return true;
+  if (/\\.(mjs|cjs|js|ts|css|scss|sass)$/i.test(norm) && /^(src|public|site|app|pages|components|client|web)\\//i.test(norm)) return true;
+  return false;
+}
+
+function recordBrowserEditLocal(cwd, filePath) {
+  try {
+    const fs = require('fs');
+    const path = require('path');
+    let rel = filePath;
+    try { rel = path.relative(cwd, filePath); } catch (_) {}
+    if (!isBrowserRunningFileLocal(rel)) return false;
+    const editsFile = path.join(cwd, '.gm', 'exec-spool', '.turn-browser-edits.json');
+    fs.mkdirSync(path.dirname(editsFile), { recursive: true });
+    let list = [];
+    try { list = JSON.parse(fs.readFileSync(editsFile, 'utf8')); if (!Array.isArray(list)) list = []; } catch (_) {}
+    const entry = { file: rel.replace(/\\\\/g, '/'), ts: Date.now() };
+    if (!list.some(e => e && e.file === entry.file)) list.push(entry);
+    fs.writeFileSync(editsFile, JSON.stringify(list));
+    return true;
+  } catch (_) { return false; }
+}
+
 let raw = '';
 process.stdin.setEncoding('utf8');
 process.stdin.on('data', (chunk) => { raw += chunk; });
@@ -78,6 +104,17 @@ process.stdin.on('end', () => {
   try { event = JSON.parse(raw || '{}'); } catch (_) { event = {}; }
   const tool = event.tool_name || event.tool || '';
   const input = event.tool_input || event.input || {};
+  const cwd = event.cwd || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+  if (tool === 'Write' || tool === 'Edit' || tool === 'MultiEdit') {
+    const fp = input.file_path || input.filePath || input.path || '';
+    if (fp) {
+      try { recordBrowserEditLocal(cwd, fp); } catch (_) {}
+    }
+    process.stdout.write(JSON.stringify({ continue: true }));
+    process.exit(0);
+  }
+
   if (tool !== 'Bash') {
     process.stdout.write(JSON.stringify({ continue: true }));
     process.exit(0);
@@ -165,15 +202,17 @@ function ensureSpoolPollGate(cwd) {
     if (!settings.hooks || typeof settings.hooks !== 'object') settings.hooks = {};
     if (!Array.isArray(settings.hooks.PreToolUse)) settings.hooks.PreToolUse = [];
     const wantCommand = `node "\${CLAUDE_PROJECT_DIR}/.gm/hooks/spool-poll-gate.js"`;
-    let bashEntry = settings.hooks.PreToolUse.find(e => e && e.matcher === 'Bash');
-    if (!bashEntry) {
-      bashEntry = { matcher: 'Bash', hooks: [] };
-      settings.hooks.PreToolUse.push(bashEntry);
-    }
-    if (!Array.isArray(bashEntry.hooks)) bashEntry.hooks = [];
-    const already = bashEntry.hooks.some(h => h && typeof h.command === 'string' && h.command.includes('spool-poll-gate.js'));
-    if (!already) {
-      bashEntry.hooks.push({ type: 'command', command: wantCommand });
+    for (const matcher of ['Bash', 'Write', 'Edit', 'MultiEdit']) {
+      let entry = settings.hooks.PreToolUse.find(e => e && e.matcher === matcher);
+      if (!entry) {
+        entry = { matcher, hooks: [] };
+        settings.hooks.PreToolUse.push(entry);
+      }
+      if (!Array.isArray(entry.hooks)) entry.hooks = [];
+      const already = entry.hooks.some(h => h && typeof h.command === 'string' && h.command.includes('spool-poll-gate.js'));
+      if (!already) {
+        entry.hooks.push({ type: 'command', command: wantCommand });
+      }
     }
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
   } catch (_) {}

package/gm.json

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

package/lib/skill-bootstrap.js

@@ -363,6 +363,32 @@ function isSpoolPollCommand(command) {
   return null;
 }
 
+function isBrowserRunningFileLocal(rel) {
+  if (!rel) return false;
+  const norm = String(rel).replace(/\\\\/g, '/');
+  if (/\\.(html?|tsx|jsx|vue|svelte)$/i.test(norm)) return true;
+  if (/\\.(mjs|cjs|js|ts|css|scss|sass)$/i.test(norm) && /^(src|public|site|app|pages|components|client|web)\\//i.test(norm)) return true;
+  return false;
+}
+
+function recordBrowserEditLocal(cwd, filePath) {
+  try {
+    const fs = require('fs');
+    const path = require('path');
+    let rel = filePath;
+    try { rel = path.relative(cwd, filePath); } catch (_) {}
+    if (!isBrowserRunningFileLocal(rel)) return false;
+    const editsFile = path.join(cwd, '.gm', 'exec-spool', '.turn-browser-edits.json');
+    fs.mkdirSync(path.dirname(editsFile), { recursive: true });
+    let list = [];
+    try { list = JSON.parse(fs.readFileSync(editsFile, 'utf8')); if (!Array.isArray(list)) list = []; } catch (_) {}
+    const entry = { file: rel.replace(/\\\\/g, '/'), ts: Date.now() };
+    if (!list.some(e => e && e.file === entry.file)) list.push(entry);
+    fs.writeFileSync(editsFile, JSON.stringify(list));
+    return true;
+  } catch (_) { return false; }
+}
+
 let raw = '';
 process.stdin.setEncoding('utf8');
 process.stdin.on('data', (chunk) => { raw += chunk; });
@@ -371,6 +397,17 @@ process.stdin.on('end', () => {
   try { event = JSON.parse(raw || '{}'); } catch (_) { event = {}; }
   const tool = event.tool_name || event.tool || '';
   const input = event.tool_input || event.input || {};
+  const cwd = event.cwd || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+  if (tool === 'Write' || tool === 'Edit' || tool === 'MultiEdit') {
+    const fp = input.file_path || input.filePath || input.path || '';
+    if (fp) {
+      try { recordBrowserEditLocal(cwd, fp); } catch (_) {}
+    }
+    process.stdout.write(JSON.stringify({ continue: true }));
+    process.exit(0);
+  }
+
   if (tool !== 'Bash') {
     process.stdout.write(JSON.stringify({ continue: true }));
     process.exit(0);
@@ -417,11 +454,33 @@ function ensureSpoolPollGate(cwd) {
     const gateScript = path.join(gmHooks, 'spool-poll-gate.js');
     const want = spoolPollGateScript();
     let need = true;
+    let oldSha = '';
+    let existed = false;
     try {
       const existing = fs.readFileSync(gateScript, 'utf8');
+      existed = true;
       if (existing === want) need = false;
+      else {
+        try {
+          const _crypto = require('crypto');
+          oldSha = _crypto.createHash('sha256').update(existing).digest('hex').slice(0, 12);
+        } catch (_) {}
+      }
     } catch (_) {}
-    if (need) fs.writeFileSync(gateScript, want);
+    if (need) {
+      fs.writeFileSync(gateScript, want);
+      try {
+        const _crypto = require('crypto');
+        const newSha = _crypto.createHash('sha256').update(want).digest('hex').slice(0, 12);
+        emitBootstrapEvent('info', existed ? 'gate.refreshed' : 'gate.installed', {
+          cwd,
+          path: gateScript,
+          old_sha: oldSha || null,
+          new_sha: newSha,
+          bytes: Buffer.byteLength(want, 'utf8'),
+        });
+      } catch (_) {}
+    }
 
     const claudeDir = path.join(cwd, '.claude');
     fs.mkdirSync(claudeDir, { recursive: true });
@@ -434,18 +493,22 @@ function ensureSpoolPollGate(cwd) {
     if (!settings.hooks || typeof settings.hooks !== 'object') settings.hooks = {};
     if (!Array.isArray(settings.hooks.PreToolUse)) settings.hooks.PreToolUse = [];
     const wantCommand = `node "\${CLAUDE_PROJECT_DIR}/.gm/hooks/spool-poll-gate.js"`;
-    let bashEntry = settings.hooks.PreToolUse.find(e => e && e.matcher === 'Bash');
-    if (!bashEntry) {
-      bashEntry = { matcher: 'Bash', hooks: [] };
-      settings.hooks.PreToolUse.push(bashEntry);
-    }
-    if (!Array.isArray(bashEntry.hooks)) bashEntry.hooks = [];
-    const already = bashEntry.hooks.some(h => h && typeof h.command === 'string' && h.command.includes('spool-poll-gate.js'));
-    if (!already) {
-      bashEntry.hooks.push({ type: 'command', command: wantCommand });
+    let anyAlready = true;
+    for (const matcher of ['Bash', 'Write', 'Edit', 'MultiEdit']) {
+      let entry = settings.hooks.PreToolUse.find(e => e && e.matcher === matcher);
+      if (!entry) {
+        entry = { matcher, hooks: [] };
+        settings.hooks.PreToolUse.push(entry);
+      }
+      if (!Array.isArray(entry.hooks)) entry.hooks = [];
+      const already = entry.hooks.some(h => h && typeof h.command === 'string' && h.command.includes('spool-poll-gate.js'));
+      if (!already) {
+        entry.hooks.push({ type: 'command', command: wantCommand });
+        anyAlready = false;
+      }
     }
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-    emitBootstrapEvent('info', 'Spool-poll gate ensured', { gateScript, settingsPath, hookAlreadyPresent: already });
+    emitBootstrapEvent('info', 'Spool-poll gate ensured', { gateScript, settingsPath, hookAlreadyPresent: anyAlready });
   } catch (e) {
     emitBootstrapEvent('warn', 'ensureSpoolPollGate failed', { error: e.message });
   }

package/package.json

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

package/prompts/prompt-submit.txt

@@ -66,6 +66,10 @@ Asking is permitted only as last resort — destructive-irreversible action with
 
 The size of the task, the cost of context, the duration of CI, and the number of repos involved are never grounds to ask. Neither is "this change touches files the user reads" — your job is to land the change correctly, not to defer to a review you imagine the user wants. Audit findings, prose rewrites, configuration edits, and refactors all ship inside the same turn as the analysis that produced them. Stopping mid-loop to ask "should I apply these?" is itself the deviation pattern: it routes the doubt back to the user instead of executing.
 
+=== AUTO-RECALL ON TURN ENTRY ===
+
+On every first `instruction` dispatch after a >30s idle gap (or at session-start), plugkit derives a 2–6 word recall query from `.gm/last-prompt.txt` / `.gm/turn-state.json` and attaches the resulting hits to the `instruction` response under the top-level field `auto_recall: {query, hits, fired_at, turn_entry: true}`. This is in addition to the existing `recall_hits` field (which is the phase+PRD-subject pack). Plugkit attaches the auto-recall pack to your instruction response on turn entry — YOU read it the same way you read `recall_hits`. Subsequent `instruction` dispatches in the same turn do not re-fire auto-recall; if you need a different query mid-turn, dispatch the `auto-recall` verb explicitly with your prompt as the body.
+
 === NO WAITING FOR PLUGKIT — HARD RULE ===
 
 Plugkit is synchronous from your perspective. You write the request file; the spool watcher processes it; you read the response file. There is no background work happening "while you wait." If you find yourself running `sleep 2; ls .gm/exec-spool/out/`, `Start-Sleep -Milliseconds 2500; Test-Path ...`, or any other poll-wait on the spool, you have misread the architecture. Read the response file directly with the Read tool — if it does not exist yet, the watcher is either dead (check `.gm/exec-spool/.status.json` mtime) or the verb is genuinely slow (check `.gm/exec-spool/.watcher.log` for the dispatch trace). Polling is forbidden. Wait-narration ("the orchestrator is processing, while waiting let me…") is a tell that you have lost the loop.

package/skills/gm-skill/SKILL.md

@@ -21,3 +21,5 @@ bun x gm-plugkit@latest spool > /dev/null 2>&1 &
 (`npx -y gm-plugkit@latest spool > /dev/null 2>&1 &` if `bun` missing.) Heartbeat fresh → YOU dispatch `instruction` — first turn body `{"prompt":"<user request>"}` so orient_nouns and recall_hits derive from the request; subsequent turns may use empty body. Read the response file directly with the Read tool. Never poll the spool dir with `sleep && ls` or `Start-Sleep && Test-Path` — plugkit is synchronous from your view; if the response is not there, the watcher is dead (check `.status.json` mtime) or the verb is slow (check `.watcher.log`), not "still processing."
 
 Response body is not a mutation surface. Memory writes route through `memorize-fire` only — another verb YOU dispatch.
+
+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.