gm-skill 2.0.1127 → 2.0.1129

package/README.md

@@ -1,18 +1,18 @@
 # gm-skill — Canonical Universal Harness
 
-The single canonical body of the gm skill-driven orchestration harness. All 15 platform-specific `gm-<platform>` packages re-export this surface; this is the source of truth.
+The single shipped skill for gm. Install into any harness that loads Claude-style skill directories — Claude Code, OpenCode, Cursor, Zed, VS Code, Codex, Kilo, JetBrains, Copilot CLI, Antigravity, Windsurf, Gemini CLI — and plugkit serves every phase instruction, mutables row, and guardrail on demand via the spool.
 
 ## What this is
 
-AI-native software engineering orchestrated as a continuous chain — PLAN → EXECUTE → EMIT → VERIFY → UPDATE-DOCS — bootstrapped on top of `plugkit` for task execution and session isolation. Spool-driven, daemonize-by-default, end-to-end chained.
+AI-native software engineering orchestrated as a state machine — PLAN → EXECUTE → EMIT → VERIFY → COMPLETE — backed by the `plugkit` WASM orchestrator. Spool-driven dispatch, no daemon, no native binaries.
 
 ## Install
 
 ```bash
-npm install gm-skill
+npm install -g gm-skill
 ```
 
-Then point your AI coding agent host (Claude Code, OpenCode, Cursor, Zed, VS Code, Codex, Kilo, JetBrains, Copilot CLI, Hermes, etc.) at the included `skills/` directory, or invoke the bootstrap directly:
+Then point your AI coding agent host at the included `skills/` directory, or invoke the bootstrap directly:
 
 ```bash
 npx gm-skill-bootstrap
@@ -20,15 +20,20 @@ npx gm-skill-bootstrap
 
 ## What's inside
 
-- `skills/` — every shared skill (gm, gm-execute, gm-emit, gm-complete, planning, update-docs, browser, code-search, create-lang-plugin, governance, pages, research, ssh, textprocessing, gm-skill itself)
-- `bin/bootstrap.js` — plugkit downloader + daemon launcher
-- `gm-plugkit/` — spool watcher and WASM wrapper
-- `lib/` — daemon-bootstrap, skill-bootstrap, spool-dispatch, git, codeinsight modules
-- `agents/`, `prompts/`, `scripts/`, `lang/` — supporting surface
+- `skills/gm-skill/` — the canonical universal harness (`SKILL.md` is the ~12-line entry point)
+- `gm-plugkit/` — WASM bootstrap and spool watcher wrapper
+- `lib/` — skill-bootstrap, spool-dispatch, daemon-bootstrap, git, codeinsight modules
+- `bin/plugkit.wasm.sha256` — pinned hash of the plugkit WASM artifact
+
+## Architecture
+
+All orchestration lives in `rs-plugkit/src/orchestrator/` as native Rust, compiled to a single `plugkit.wasm` (~<200KB). The agent dispatches verbs by writing to `.gm/exec-spool/in/<verb>/<N>.txt` and reading responses from `.gm/exec-spool/out/`. See [AGENTS.md](https://github.com/AnEntrypoint/gm/blob/main/AGENTS.md) for the full design.
+
+An earlier generation fanned out fifteen per-platform downstream repos (gm-cc, gm-gc, gm-oc, gm-kilo, gm-codex, gm-qwen, gm-copilot-cli, gm-hermes, gm-thebird, gm-vscode, gm-cursor, gm-zed, gm-jetbrains, gm-antigravity, gm-windsurf). Those are archived; `gm-skill` is the single source of truth.
 
 ## Version
 
-`2.0.1127` — auto-bumped from the canonical `gm` repo. Every push to `AnEntrypoint/gm` republishes this package alongside all 15 platform packages.
+`2.0.1129` — 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

@@ -90,12 +90,14 @@ function isProfileLocked(profileDir) {
 }
 
 function acquireProfileDir(cwd) {
-  const primary = path.join(cwd, '.plugkit-browser-profile');
-  ensureGitignored(cwd, '.plugkit-browser-profile/');
-  ensureGitignored(cwd, '.plugkit-browser-profile-*/');
+  const gmDir = path.join(cwd, '.gm');
+  try { fs.mkdirSync(gmDir, { recursive: true }); } catch (_) {}
+  const primary = path.join(gmDir, 'browser-profile');
+  ensureGitignored(cwd, '.gm/browser-profile/');
+  ensureGitignored(cwd, '.gm/browser-profile-*/');
   try { fs.mkdirSync(primary, { recursive: true }); } catch (_) {}
   if (!isProfileLocked(primary)) return primary;
-  const fallback = path.join(cwd, `.plugkit-browser-profile-${process.pid}`);
+  const fallback = path.join(gmDir, `browser-profile-${process.pid}`);
   try { fs.mkdirSync(fallback, { recursive: true }); } catch (_) {}
   return fallback;
 }

package/gm.json

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

package/lib/skill-bootstrap.js

@@ -182,6 +182,9 @@ function getManagedGitignoreEntries() {
     '.gm/ingest-drafts/',
     '.gm/prd-state.json',
     '.gm/subagent-*.json',
+    '.gm/browser-profile/',
+    '.gm/browser-profile-*/',
+    '.gm/build-tool-ignores.md',
     '.plugkit-browser-profile/',
     '.plugkit-browser-profile-*/',
   ];
@@ -200,6 +203,123 @@ function getMustStayTracked() {
   ];
 }
 
+function detectBuildToolConfigs(cwd) {
+  const detectors = [
+    { tool: 'vite', patterns: ['vite.config.js', 'vite.config.ts', 'vite.config.mjs', 'vite.config.cjs'] },
+    { tool: 'vitest', patterns: ['vitest.config.js', 'vitest.config.ts', 'vitest.config.mjs'] },
+    { tool: 'astro', patterns: ['astro.config.js', 'astro.config.ts', 'astro.config.mjs'] },
+    { tool: 'next', patterns: ['next.config.js', 'next.config.ts', 'next.config.mjs', 'next.config.cjs'] },
+    { tool: 'jest', patterns: ['jest.config.js', 'jest.config.ts', 'jest.config.mjs', 'jest.config.cjs', 'jest.config.json'] },
+    { tool: 'webpack', patterns: ['webpack.config.js', 'webpack.config.ts', 'webpack.config.cjs', 'webpack.config.mjs'] },
+    { tool: 'rollup', patterns: ['rollup.config.js', 'rollup.config.ts', 'rollup.config.mjs'] },
+    { tool: 'nuxt', patterns: ['nuxt.config.js', 'nuxt.config.ts', 'nuxt.config.mjs'] },
+  ];
+  const found = [];
+  for (const d of detectors) {
+    for (const p of d.patterns) {
+      const fp = path.join(cwd, p);
+      if (fs.existsSync(fp)) {
+        found.push({ tool: d.tool, file: p, fullPath: fp });
+        break;
+      }
+    }
+  }
+  return found;
+}
+
+function patchJestJsonConfig(filePath) {
+  const raw = fs.readFileSync(filePath, 'utf-8');
+  const cfg = JSON.parse(raw);
+  const want = '<rootDir>/.gm/';
+  const existing = Array.isArray(cfg.watchPathIgnorePatterns) ? cfg.watchPathIgnorePatterns : [];
+  if (existing.includes(want)) return false;
+  cfg.watchPathIgnorePatterns = [...existing, want];
+  fs.writeFileSync(filePath, JSON.stringify(cfg, null, 2) + '\n');
+  return true;
+}
+
+function patchPackageJsonJest(cwd) {
+  const pkgPath = path.join(cwd, 'package.json');
+  if (!fs.existsSync(pkgPath)) return null;
+  const raw = fs.readFileSync(pkgPath, 'utf-8');
+  let pkg;
+  try { pkg = JSON.parse(raw); } catch (_) { return null; }
+  if (!pkg.jest || typeof pkg.jest !== 'object') return null;
+  const want = '<rootDir>/.gm/';
+  const existing = Array.isArray(pkg.jest.watchPathIgnorePatterns) ? pkg.jest.watchPathIgnorePatterns : [];
+  if (existing.includes(want)) return false;
+  pkg.jest.watchPathIgnorePatterns = [...existing, want];
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+  return true;
+}
+
+function ensureBuildToolIgnores(cwd) {
+  try {
+    const found = detectBuildToolConfigs(cwd);
+    const automated = [];
+    const advisory = [];
+
+    for (const f of found) {
+      if (f.tool === 'jest' && f.file.endsWith('.json')) {
+        try {
+          const changed = patchJestJsonConfig(f.fullPath);
+          automated.push({ tool: 'jest', file: f.file, changed });
+        } catch (e) {
+          advisory.push({ ...f, reason: `patch failed: ${e.message}` });
+        }
+      } else {
+        advisory.push(f);
+      }
+    }
+
+    try {
+      const pkgChanged = patchPackageJsonJest(cwd);
+      if (pkgChanged !== null) automated.push({ tool: 'jest', file: 'package.json#jest', changed: pkgChanged });
+    } catch (_) {}
+
+    const snippets = {
+      vite: "server: { watch: { ignored: ['**/.gm/**'] } }",
+      vitest: "test: { watchExclude: ['**/.gm/**'] }",
+      astro: "vite: { server: { watch: { ignored: ['**/.gm/**'] } } }",
+      next: "webpack: (config) => { config.watchOptions = { ...config.watchOptions, ignored: ['**/.gm/**', ...(config.watchOptions?.ignored || [])] }; return config; }",
+      jest: "watchPathIgnorePatterns: ['<rootDir>/.gm/']",
+      webpack: "watchOptions: { ignored: ['**/.gm/**', '**/node_modules/**'] }",
+      rollup: "watch: { exclude: ['.gm/**'] }",
+      nuxt: "vite: { server: { watch: { ignored: ['**/.gm/**'] } } }",
+    };
+
+    const gmDir = path.join(cwd, '.gm');
+    const advisoryPath = path.join(gmDir, 'build-tool-ignores.md');
+    if (advisory.length === 0) {
+      try { if (fs.existsSync(advisoryPath)) fs.unlinkSync(advisoryPath); } catch (_) {}
+    } else {
+      fs.mkdirSync(gmDir, { recursive: true });
+      const lines = [
+        '# Build-tool ignore advisories',
+        '',
+        '`.gitignore` already excludes `.gm/`. Tools whose watchers honor `.gitignore` (vite, vitest, astro, nuxt with chokidar defaults) need no further action.',
+        '',
+        'For watchers that do NOT honor `.gitignore` automatically, paste these snippets into the corresponding config file:',
+        '',
+      ];
+      for (const f of advisory) {
+        const snip = snippets[f.tool];
+        if (!snip) continue;
+        lines.push(`## ${f.tool} (\`${f.file}\`)`, '', '```', snip, '```', '');
+      }
+      lines.push('---', '', 'Regenerated each bootstrap. Delete after applying — file is gitignored.');
+      fs.writeFileSync(advisoryPath, lines.join('\n'));
+    }
+
+    emitBootstrapEvent('info', 'Build-tool ignore handling complete', {
+      automated: automated.map(a => ({ tool: a.tool, file: a.file, changed: a.changed })),
+      advisory: advisory.map(a => ({ tool: a.tool, file: a.file })),
+    });
+  } catch (e) {
+    emitBootstrapEvent('warn', 'ensureBuildToolIgnores failed', { error: e.message });
+  }
+}
+
 function ensureManagedGitignore(cwd) {
   try {
     const gi = gitignorePath(cwd);
@@ -429,6 +549,7 @@ async function bootstrapPlugkit(sessionId, options) {
     emitBootstrapEvent('info', 'Bootstrap started', { forceLatest });
 
     ensureManagedGitignore(process.cwd());
+    ensureBuildToolIgnores(process.cwd());
 
     const manifest = readManifest();
     let targetVersion = manifest.version;
@@ -616,9 +737,12 @@ async function getSnapshot(sessionId, cwd) {
   }
 }
 
-module.exports = { 
+module.exports = {
   bootstrapPlugkit,
   bootstrapAcptoapi,
   getSnapshot,
-  checkPortReachable
+  checkPortReachable,
+  ensureBuildToolIgnores,
+  detectBuildToolConfigs,
+  ensureManagedGitignore,
 };

package/package.json

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

package/skills/gm-skill/SKILL.md

@@ -100,8 +100,8 @@ Stop when `next_phase_hint` is null or phase is `COMPLETE`.
 
 ### Browser
 
-Dispatch `.gm/exec-spool/in/browser/<N>.txt` with raw JavaScript as the body. The wrapper spawns Chrome (managed profile at `<cwd>/.plugkit-browser-profile/`) and runs the JS via playwriter. Globals available inside the body: `page` (playwright Page), `snapshot` (accessibility snapshot), `screenshotWithAccessibilityLabels` (screenshot helper), `state` (per-session state object).
+Dispatch `.gm/exec-spool/in/browser/<N>.txt` with raw JavaScript as the body. The wrapper spawns Chrome (managed profile at `<cwd>/.gm/browser-profile/`) and runs the JS via playwriter. Globals available inside the body: `page` (playwright Page), `snapshot` (accessibility snapshot), `screenshotWithAccessibilityLabels` (screenshot helper), `state` (per-session state object).
 
 Special commands (body starts with `session `): `session new`, `session list`, `session close <id>` pass through to playwriter directly.
 
-Chrome is detected from system install paths; profile dir is project-scoped so cookies/login persist per project. The wrapper auto-adds `.plugkit-browser-profile/` to `.gitignore`.
+Chrome is detected from system install paths; profile dir is project-scoped so cookies/login persist per project. The wrapper writes the managed gitignore block (which includes `.gm/browser-profile/`) on first launch.