gm-gc 2.0.77 → 2.0.79

package/agents/gm.md

@@ -365,6 +365,14 @@ Scope: Runtime process execution. Governs how all applications are started, moni
 - Windows 11+: `spawn wmic ENOENT` in daemon logs is cosmetic — app processes work; fix with `npm install -g pm2@latest`
 - Linux watch exhaustion: `echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p`
 
+**Windows Terminal Suppression (CRITICAL)**:
+- All terminal spawning in code MUST use `windowsHide: true` in spawn/exec options
+- Prevents popup windows on Windows during subprocess execution
+- Example: `spawn('node', [...], { windowsHide: true })`
+- Applies to all `child_process.spawn()`, `child_process.exec()`, and similar calls
+- PM2 processes automatically hide windows; code-spawned subprocesses must explicitly set this
+- Forgetting this creates visible popup windows during automation—unacceptable UX
+
 **Log monitoring**:
 ```bash
 pm2 logs <name>              # stream live output

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "gm",
-  "version": "2.0.77",
+  "version": "2.0.79",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "homepage": "https://github.com/AnEntrypoint/gm",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-gc",
-  "version": "2.0.77",
+  "version": "2.0.79",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",

package/scripts/postinstall-kilo.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+function isInsideNodeModules() {
+  return __dirname.includes(path.sep + 'node_modules' + path.sep);
+}
+
+function getProjectRoot() {
+  if (!isInsideNodeModules()) return null;
+  let current = __dirname;
+  while (current !== path.dirname(current)) {
+    current = path.dirname(current);
+    if (path.basename(current) === 'node_modules') {
+      return path.dirname(current);
+    }
+  }
+  return null;
+}
+
+function safeCopyFile(src, dst) {
+  try {
+    const content = fs.readFileSync(src, 'utf-8');
+    const dstDir = path.dirname(dst);
+    if (!fs.existsSync(dstDir)) fs.mkdirSync(dstDir, { recursive: true });
+    fs.writeFileSync(dst, content, 'utf-8');
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function safeCopyDirectory(src, dst) {
+  try {
+    if (!fs.existsSync(src)) return false;
+    fs.mkdirSync(dst, { recursive: true });
+    fs.readdirSync(src, { withFileTypes: true }).forEach(entry => {
+      const srcPath = path.join(src, entry.name);
+      const dstPath = path.join(dst, entry.name);
+      if (entry.isDirectory()) safeCopyDirectory(srcPath, dstPath);
+      else if (entry.isFile()) safeCopyFile(srcPath, dstPath);
+    });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function updateGitignore(projectRoot) {
+  try {
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    const entry = '.gm-stop-verified';
+    let content = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
+    if (content.includes(entry)) return true;
+    if (content && !content.endsWith('\n')) content += '\n';
+    fs.writeFileSync(gitignorePath, content + entry + '\n', 'utf-8');
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function install() {
+  if (!isInsideNodeModules()) return;
+  const projectRoot = getProjectRoot();
+  if (!projectRoot) return;
+  const kiloDir = path.join(projectRoot, '.config', 'kilo');
+  const sourceDir = __dirname.replace(/[/\\]scripts$/, '');
+
+  // Copy files
+  safeCopyDirectory(path.join(sourceDir, 'agents'), path.join(kiloDir, 'agents'));
+  safeCopyDirectory(path.join(sourceDir, 'hooks'), path.join(kiloDir, 'hooks'));
+  safeCopyDirectory(path.join(sourceDir, 'skills'), path.join(kiloDir, 'skills'));
+  safeCopyFile(path.join(sourceDir, 'kilocode.json'), path.join(kiloDir, 'kilocode.json'));
+  safeCopyFile(path.join(sourceDir, '.mcp.json'), path.join(kiloDir, '.mcp.json'));
+  safeCopyFile(path.join(sourceDir, 'gm.mjs'), path.join(kiloDir, 'gm.mjs'));
+  safeCopyFile(path.join(sourceDir, 'index.mjs'), path.join(kiloDir, 'index.mjs'));
+  safeCopyFile(path.join(sourceDir, 'README.md'), path.join(kiloDir, 'README.md'));
+  safeCopyFile(path.join(sourceDir, 'LICENSE'), path.join(kiloDir, 'LICENSE'));
+  safeCopyFile(path.join(sourceDir, 'CONTRIBUTING.md'), path.join(kiloDir, 'CONTRIBUTING.md'));
+  safeCopyFile(path.join(sourceDir, '.gitignore'), path.join(kiloDir, '.gitignore'));
+  safeCopyFile(path.join(sourceDir, '.editorconfig'), path.join(kiloDir, '.editorconfig'));
+
+  // Also write plugin/ directory - Kilo loads from ~/.config/kilo/plugin/ as a local file plugin
+  const pluginDir = path.join(kiloDir, 'plugin');
+  if (!fs.existsSync(pluginDir)) fs.mkdirSync(pluginDir, { recursive: true });
+  const gmMjsSrc = path.join(sourceDir, 'gm.mjs');
+  if (fs.existsSync(gmMjsSrc)) {
+    safeCopyFile(gmMjsSrc, path.join(pluginDir, 'gm.mjs'));
+  }
+  fs.writeFileSync(path.join(pluginDir, 'index.js'), "export { default } from './gm.mjs';\n", 'utf-8');
+
+  // Update .gitignore
+  updateGitignore(projectRoot);
+
+  // Warm bun x cache for packages used by hooks
+  warmBunCache();
+
+  // Silent success
+}
+
+function warmBunCache() {
+  const packages = ['mcp-thorns@latest', 'codebasesearch@latest'];
+  for (const pkg of packages) {
+    try {
+      execSync(`bun x ${pkg} --version`, {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+        timeout: 60000
+      });
+    } catch (e) {
+      // Silent - cache warming is best-effort
+    }
+  }
+}
+
+install();

package/scripts/postinstall-oc.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+function isInsideNodeModules() {
+  return __dirname.includes(path.sep + 'node_modules' + path.sep);
+}
+
+function getProjectRoot() {
+  if (!isInsideNodeModules()) return null;
+  let current = __dirname;
+  while (current !== path.dirname(current)) {
+    current = path.dirname(current);
+    if (path.basename(current) === 'node_modules') {
+      return path.dirname(current);
+    }
+  }
+  return null;
+}
+
+function safeCopyFile(src, dst) {
+  try {
+    const content = fs.readFileSync(src, 'utf-8');
+    const dstDir = path.dirname(dst);
+    if (!fs.existsSync(dstDir)) fs.mkdirSync(dstDir, { recursive: true });
+    fs.writeFileSync(dst, content, 'utf-8');
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function safeCopyDirectory(src, dst) {
+  try {
+    if (!fs.existsSync(src)) return false;
+    fs.mkdirSync(dst, { recursive: true });
+    fs.readdirSync(src, { withFileTypes: true }).forEach(entry => {
+      const srcPath = path.join(src, entry.name);
+      const dstPath = path.join(dst, entry.name);
+      if (entry.isDirectory()) safeCopyDirectory(srcPath, dstPath);
+      else if (entry.isFile()) safeCopyFile(srcPath, dstPath);
+    });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function updateGitignore(projectRoot) {
+  try {
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    const entry = '.gm-stop-verified';
+    let content = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
+    if (content.includes(entry)) return true;
+    if (content && !content.endsWith('\n')) content += '\n';
+    fs.writeFileSync(gitignorePath, content + entry + '\n', 'utf-8');
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function install() {
+  if (!isInsideNodeModules()) return;
+  const projectRoot = getProjectRoot();
+  if (!projectRoot) return;
+  const ocDir = path.join(projectRoot, '.config', 'opencode');
+  const sourceDir = __dirname.replace(/[/\\]scripts$/, '');
+
+  // Copy files
+  safeCopyDirectory(path.join(sourceDir, 'agents'), path.join(ocDir, 'agents'));
+  safeCopyDirectory(path.join(sourceDir, 'hooks'), path.join(ocDir, 'hooks'));
+  safeCopyDirectory(path.join(sourceDir, 'skills'), path.join(ocDir, 'skills'));
+  safeCopyFile(path.join(sourceDir, 'opencode.json'), path.join(ocDir, 'opencode.json'));
+  safeCopyFile(path.join(sourceDir, '.mcp.json'), path.join(ocDir, '.mcp.json'));
+  safeCopyFile(path.join(sourceDir, 'gm.mjs'), path.join(ocDir, 'gm.mjs'));
+  safeCopyFile(path.join(sourceDir, 'index.mjs'), path.join(ocDir, 'index.mjs'));
+  safeCopyFile(path.join(sourceDir, 'README.md'), path.join(ocDir, 'README.md'));
+  safeCopyFile(path.join(sourceDir, 'LICENSE'), path.join(ocDir, 'LICENSE'));
+  safeCopyFile(path.join(sourceDir, 'CONTRIBUTING.md'), path.join(ocDir, 'CONTRIBUTING.md'));
+  safeCopyFile(path.join(sourceDir, '.gitignore'), path.join(ocDir, '.gitignore'));
+  safeCopyFile(path.join(sourceDir, '.editorconfig'), path.join(ocDir, '.editorconfig'));
+
+  // Also write to plugins/gm-oc.mjs - the actual file OpenCode loads
+  const pluginsDir = path.join(ocDir, 'plugins');
+  if (!fs.existsSync(pluginsDir)) fs.mkdirSync(pluginsDir, { recursive: true });
+  const gmMjsSrc = path.join(sourceDir, 'gm.mjs');
+  if (fs.existsSync(gmMjsSrc)) {
+    safeCopyFile(gmMjsSrc, path.join(pluginsDir, 'gm-oc.mjs'));
+  }
+
+  // Update .gitignore
+  updateGitignore(projectRoot);
+
+  // Warm bun x cache for packages used by hooks
+  warmBunCache();
+
+  // Silent success
+}
+
+function warmBunCache() {
+  const packages = ['mcp-thorns@latest', 'codebasesearch@latest'];
+  for (const pkg of packages) {
+    try {
+      execSync(`bun x ${pkg} --version`, {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+        timeout: 60000
+      });
+    } catch (e) {
+      // Silent - cache warming is best-effort
+    }
+  }
+}
+
+install();

package/skills/gm/SKILL.md

@@ -93,6 +93,21 @@ All execution via Bash tool or `agent-browser` skill. Every hypothesis proven by
 - Starting/stopping system services
 - Everything else → Bash tool
 
+**CRITICAL: Windows Terminal Suppression**:
+When code spawns subprocesses, ALWAYS use `windowsHide: true` to prevent popup windows on Windows:
+
+```javascript
+// ❌ WRONG - popup windows on Windows
+const { spawn } = require('child_process');
+spawn('node', ['script.js']);
+
+// ✅ CORRECT - hides windows, works cross-platform
+const { spawn } = require('child_process');
+spawn('node', ['script.js'], { windowsHide: true });
+```
+
+Applies to: `spawn()`, `exec()`, `execFile()`, `fork()`. See `process-management` skill for full details.
+
 ## CHARTER 3: GROUND TRUTH
 
 Scope: Data integrity and testing methodology. Governs what constitutes valid evidence.

package/skills/process-management/SKILL.md

@@ -168,6 +168,26 @@ Get-Command myapp | Select-Object -ExpandProperty Source
 ```
 Point `script` at the resolved `.js` file — never at the `.cmd` wrapper.
 
+### Terminal Suppression on Windows (CRITICAL)
+
+All code that spawns subprocesses MUST use `windowsHide: true` to prevent popup windows.
+
+```javascript
+// ❌ WRONG - will show popup windows on Windows
+spawn('node', ['script.js']);
+
+// ✅ CORRECT - hides windows, safe for all platforms
+spawn('node', ['script.js'], { windowsHide: true });
+```
+
+Applies to all subprocess execution:
+- `child_process.spawn()` → `{ windowsHide: true }`
+- `child_process.exec()` → `{ windowsHide: true }`
+- `child_process.execFile()` → `{ windowsHide: true }`
+- `child_process.fork()` → `{ silent: true }` (alternative for fork)
+
+PM2-started processes automatically hide windows. Code-spawned subprocesses must explicitly set this. Forgetting creates visible popups during automation—unacceptable UX.
+
 ### Windows 11+ wmic Error
 
 PM2 uses `wmic` for process stats — removed in Windows 11+.