gm-skill 2.0.1603 → 2.0.1605

package/AGENTS.md

@@ -52,7 +52,7 @@ Record only non-obvious technical caveats that cost multiple runs to discover; r
 
 **Detail-heavy caveats live in rs-learn (`.gm/rs-learn.db`), not here.** Per-crate runtime quirks, Windows process-spawn mechanics, hook details, ocw/site/workflow specifics, and similar fact-base material are exfiltrated to rs-learn (`exec:recall`); AGENTS.md keeps only top-level rules governing gm-the-repo. In doubt: cross-cutting policy stays here, single-crate/single-platform mechanism goes to rs-learn.
 
-**Every memorize run also drains AGENTS.md -- migration is bidirectional, deflation is the back-pressure.** AGENTS.md bloats past the budget it protects if flow is only inward, so every session firing `memorize-fire` for new facts ALSO exfiltrates a few existing detail-heavy/single-crate/single-platform entries: fire the substance to the default namespace, then delete or compress the paragraph to a one-line pointer in the same commit. Witnessed by the store gaining the fact AND the byte-count dropping. A few entries per run, never a wholesale rewrite; top-level rules stay, everything recall-reachable drains.
+**Every memorize run also drains AGENTS.md -- migration is bidirectional, deflation is the back-pressure.** AGENTS.md bloats past the budget it protects if flow is only inward, so every session firing `memorize-fire` for new facts ALSO exfiltrates a few existing detail-heavy/single-crate/single-platform entries: fire the substance to the default namespace, then delete or compress the paragraph to a one-line pointer in the same commit. Witnessed by the store gaining the fact AND the byte-count dropping. A few entries per run, never a wholesale rewrite; top-level rules stay, everything recall-reachable drains. `test.js checkAgentsMdBudget()` is the structural byte-ceiling backstop so the drain cannot silently lapse (`recall: AGENTS.md byte-ceiling guard looper bloat`).
 
 ## Coding Style
 

package/gm-plugkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-plugkit",
-  "version": "2.0.1603",
+  "version": "2.0.1605",
   "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

@@ -308,6 +308,18 @@ function capInstructionPacks(parsed) {
   }
 }
 
+function injectUpdateWarning(parsed) {
+  if (!parsed || typeof parsed !== 'object') return;
+  let upd;
+  try {
+    upd = JSON.parse(fs.readFileSync(path.join(spoolDir, '.update-available.json'), 'utf-8'));
+  } catch (_) { return; }
+  if (!upd || !upd.installed || !upd.latest || upd.installed === upd.latest) return;
+  const target = (parsed.data && typeof parsed.data === 'object') ? parsed.data : parsed;
+  target.update_available = { installed: upd.installed, latest: upd.latest, update_url: upd.update_url || null };
+  target.update_warning = `STALE RUNTIME: running plugkit ${upd.installed} but ${upd.latest} is published and not yet running. Restart onto the new version now: bun x gm-plugkit@latest --kill-stale-watchers; bun x gm-plugkit@latest spool. This warning repeats every turn until the running version catches up.`;
+}
+
 function mergeAutoRecallIntoInstructionResponse(resultStr, autoRecall) {
   if (!autoRecall) return resultStr;
   let parsed;
@@ -3089,11 +3101,19 @@ async function runSpoolWatcher(instance, spoolDir) {
 
       if (autoRecallPayload) {
         resultStr = mergeAutoRecallIntoInstructionResponse(resultStr, autoRecallPayload);
-      } else if (verb === 'instruction' || verb === 'transition') {
+        try {
+          const parsed = JSON.parse(resultStr);
+          if (parsed && typeof parsed === 'object') {
+            injectUpdateWarning(parsed);
+            resultStr = JSON.stringify(parsed);
+          }
+        } catch (_) {}
+      } else if (verb === 'instruction' || verb === 'transition' || verb === 'phase-status') {
         try {
           const parsed = JSON.parse(resultStr);
           if (parsed && typeof parsed === 'object') {
             capInstructionPacks(parsed);
+            injectUpdateWarning(parsed);
             resultStr = JSON.stringify(parsed);
           }
         } catch (_) {}

package/gm-plugkit/plugkit.version

@@ -1 +1 @@
-0.1.681
+0.1.682

package/gm.json

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

package/lib/spool-dispatch.js

@@ -59,14 +59,15 @@ function hasUnpushedCommits(cwd) {
 
 const TOPLEVEL_DOC_ALLOWLIST = new Set(['AGENTS.md', 'CLAUDE.md', 'README.md', 'SKILLS.md', 'CHANGELOG.md', 'LICENSE', 'LICENSE.md']);
 
-const BROWSER_FILE_EXT_RE = /\.(html?|tsx|jsx|vue|svelte|mjs|cjs|js|ts|css|scss|sass)$/i;
+const BROWSER_FILE_ALWAYS_RE = /\.(html?|tsx|jsx|vue|svelte)$/i;
+const BROWSER_FILE_DIRGATED_RE = /\.(mjs|cjs|js|ts|css|scss|sass)$/i;
 const BROWSER_FILE_DIR_RE = /^(src|public|site|app|pages|components|client|web)[\\/]/i;
 
 function isBrowserRunningFile(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) && BROWSER_FILE_DIR_RE.test(norm)) return true;
+  if (BROWSER_FILE_ALWAYS_RE.test(norm)) return true;
+  if (BROWSER_FILE_DIRGATED_RE.test(norm) && BROWSER_FILE_DIR_RE.test(norm)) return true;
   return false;
 }
 
@@ -160,11 +161,9 @@ function unsolicitedDocs(cwd) {
       const rel = line.slice(3).trim();
       if (!rel) continue;
       if (!/\.(md|txt)$/i.test(rel)) continue;
-      if (rel.includes('/')) {
-        if (rel.startsWith('node_modules/') || rel.startsWith('target/') || rel.startsWith('.gm/') || rel.startsWith('dist/') || rel.startsWith('build/')) continue;
-      } else {
-        if (TOPLEVEL_DOC_ALLOWLIST.has(rel)) continue;
-      }
+      const base = rel.includes('/') ? rel.slice(rel.lastIndexOf('/') + 1) : rel;
+      if (TOPLEVEL_DOC_ALLOWLIST.has(base)) continue;
+      if (rel.startsWith('node_modules/') || rel.startsWith('target/') || rel.startsWith('.gm/') || rel.startsWith('dist/') || rel.startsWith('build/')) continue;
       flagged.push(rel);
     }
     return { count: flagged.length, files: flagged, available: true };
@@ -340,11 +339,15 @@ function checkDispatchGates(sessionId, operation, extra) {
       }
     }
     const dirty = isWorktreeDirty(cwd);
-    if (dirty.available && dirty.dirty) {
+    if (!dirty.available) {
+      residuals.push('worktree git state UNKNOWN (git status failed or timed out) -- cannot confirm a clean tree; re-run git status and commit/push any residual before declaring done');
+    } else if (dirty.dirty) {
       residuals.push(`worktree dirty (${dirty.files.length} file${dirty.files.length === 1 ? '' : 's'}) -- commit and push before declaring done`);
     }
     const unpushed = hasUnpushedCommits(cwd);
-    if (unpushed.available && unpushed.unpushed) {
+    if (!unpushed.available) {
+      residuals.push('unpushed-commit state UNKNOWN (git log @{u}..HEAD failed or timed out) -- cannot confirm origin reflects HEAD; verify and push before declaring done');
+    } else if (unpushed.unpushed) {
       residuals.push(`${unpushed.count} unpushed commit${unpushed.count === 1 ? '' : 's'} -- push to remote before declaring done`);
     }
     const docs = unsolicitedDocs(cwd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-skill",
-  "version": "2.0.1603",
+  "version": "2.0.1605",
   "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/index.js

@@ -1,10 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-const SKILL_MD_PATH = path.join(__dirname, 'SKILL.md');
-
-function loadCanonicalSkill() {
-  return fs.readFileSync(SKILL_MD_PATH, 'utf-8');
-}
-
-module.exports = { loadCanonicalSkill, SKILL_MD_PATH };