gm-skill 2.0.1266 → 2.0.1268

package/README.md

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

@@ -420,7 +420,84 @@ function writeJsonFile(fp, value) {
   try { fs.writeFileSync(fp, JSON.stringify(value, null, 2)); } catch (_) {}
 }
 
+function msPlaywrightCacheRoots() {
+  const roots = [];
+  if (process.env.PLAYWRIGHT_BROWSERS_PATH) roots.push(process.env.PLAYWRIGHT_BROWSERS_PATH);
+  if (process.platform === 'win32') {
+    if (process.env.LOCALAPPDATA) roots.push(path.join(process.env.LOCALAPPDATA, 'ms-playwright'));
+  } else if (process.platform === 'darwin') {
+    if (process.env.HOME) roots.push(path.join(process.env.HOME, 'Library', 'Caches', 'ms-playwright'));
+  } else {
+    if (process.env.HOME) roots.push(path.join(process.env.HOME, '.cache', 'ms-playwright'));
+  }
+  return roots.filter(r => r && fs.existsSync(r));
+}
+
+function chromiumExeFromCacheRoot(root) {
+  try {
+    const entries = fs.readdirSync(root)
+      .filter(n => /^chromium-\d+$/.test(n))
+      .sort((a, b) => parseInt(b.split('-')[1], 10) - parseInt(a.split('-')[1], 10));
+    const subdirs = process.platform === 'win32'
+      ? ['chrome-win64', 'chrome-win']
+      : process.platform === 'darwin'
+        ? ['chrome-mac/Chromium.app/Contents/MacOS/Chromium']
+        : ['chrome-linux'];
+    const exeName = process.platform === 'win32' ? 'chrome.exe'
+      : process.platform === 'darwin' ? null
+      : 'chrome';
+    for (const e of entries) {
+      for (const sub of subdirs) {
+        const p = exeName ? path.join(root, e, sub, exeName) : path.join(root, e, sub);
+        if (fs.existsSync(p)) return p;
+      }
+    }
+  } catch (_) {}
+  return null;
+}
+
+function findBundledChromium() {
+  for (const root of msPlaywrightCacheRoots()) {
+    const exe = chromiumExeFromCacheRoot(root);
+    if (exe) return exe;
+  }
+  try {
+    const npmR = spawnSync('npm', ['root', '-g'], { encoding: 'utf-8', shell: true, windowsHide: true, timeout: 5000 });
+    if (npmR.status === 0 && npmR.stdout.trim()) {
+      const root = npmR.stdout.trim().split(/\r?\n/).pop();
+      const pwBrowsers = path.join(root, 'playwriter', 'node_modules', '@xmorse', 'playwright-core', '.local-browsers');
+      if (fs.existsSync(pwBrowsers)) {
+        const exe = chromiumExeFromCacheRoot(pwBrowsers);
+        if (exe) return exe;
+      }
+    }
+  } catch (_) {}
+  return null;
+}
+
+function ensureBundledChromium(pw) {
+  const existing = findBundledChromium();
+  if (existing) return { exe: existing, installed: false };
+  const installer = pw && pw.cmd
+    ? { cmd: pw.cmd, args: [...pw.baseArgs, 'install', 'chromium'], shell: pw.shell }
+    : { cmd: 'npx', args: ['-y', 'playwright', 'install', 'chromium'], shell: true };
+  logEvent('bootstrap', 'browser.chromium-install.start', { via: installer.cmd });
+  const r = spawnSync(installer.cmd, installer.args, {
+    encoding: 'utf-8',
+    timeout: 600000,
+    shell: installer.shell,
+    windowsHide: true,
+    env: { ...process.env, PLAYWRIGHT_BROWSERS_PATH: process.env.PLAYWRIGHT_BROWSERS_PATH || '' },
+  });
+  logEvent('bootstrap', 'browser.chromium-install.done', { status: r.status });
+  const after = findBundledChromium();
+  if (after) return { exe: after, installed: true };
+  return { exe: null, installed: false, error: r.stderr || r.stdout || 'install failed' };
+}
+
 function findChrome() {
+  const bundled = findBundledChromium();
+  if (bundled) return bundled;
   if (process.platform === 'win32') {
     const candidates = [
       path.join(process.env.PROGRAMFILES || 'C:\\Program Files', 'Google', 'Chrome', 'Application', 'chrome.exe'),
@@ -630,7 +707,7 @@ function runPlaywriter(pw, args, timeoutMs) {
 function scrubBrowserRunnerText(s) {
   if (!s || typeof s !== 'string') return s;
   let t = s;
-  t = t.replace(/playwriter/gi, 'managed browser session');
+  t = t.replace(/(^|[^A-Za-z0-9_\\/.-])playwriter(?![A-Za-z0-9_\\/.-])/gi, (m, pre) => `${pre}managed browser session`);
   t = t.replace(/Click the[^.\n]*?extension[^.\n]*?icon[^.\n]*?\.?/gi, '');
   t = t.replace(/(connected\s+)?browser\s+extension(\s+is)?\s+not\s+connected\b[^.\n]*\.?/gi, '');
   t = t.replace(/no\s+connected\s+browsers?\b[^.\n]*\.?/gi, '');
@@ -670,8 +747,13 @@ function getOrCreateBrowserSession(cwd, claudeSessionId, pw) {
     }
   }
   cleanDeadProfileFragments(cwd);
-  const chrome = findChrome();
-  if (!chrome) throw new Error('Chrome not found. Please install Google Chrome.');
+  let chrome = findBundledChromium();
+  if (!chrome) {
+    const ensured = ensureBundledChromium(pw);
+    if (ensured.exe) chrome = ensured.exe;
+  }
+  if (!chrome) chrome = findChrome();
+  if (!chrome) throw new Error('No chromium binary available. Run: npx playwright install chromium');
   const profileDir = acquireProfileDir(cwd);
   const port = findFreePortSync();
   const chromeArgs = [
@@ -701,7 +783,7 @@ function getOrCreateBrowserSession(cwd, claudeSessionId, pw) {
     sleepSync(300);
   }
   if (!alive) throw new Error(`Chrome failed to open debug port ${port}`);
-  const newR = runPlaywriter(pw, ['session', 'new', `--direct=localhost:${port}`], 30000);
+  const newR = runPlaywriter(pw, ['session', 'new', '--direct', `localhost:${port}`], 30000);
   if (newR.status !== 0) throw new Error(`managed browser session start failed: ${scrubBrowserRunnerText(newR.stderr || newR.stdout || 'unknown')}`);
   const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, '');
   const out = stripAnsi(newR.stdout || '').trim();

package/gm.json

@@ -1,6 +1,6 @@
 {
   "name": "gm",
-  "version": "2.0.1266",
+  "version": "2.0.1268",
   "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.1266",
+  "version": "2.0.1268",
   "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.1266"
+    "gm-plugkit": "^2.0.1268"
   },
   "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.