gm-kilo 2.0.1059 → 2.0.1061

package/README.md

@@ -4,97 +4,59 @@
 
 ### One-liner (recommended)
 
-Install directly from npm using bun x:
+Install directly from npm:
 
 ```bash
 bun x gm-kilo@latest
 ```
 
-This command will automatically install gm-kilo to the correct location for your platform and restart Kilo to activate.
+This copies the plugin to `~/.config/kilo/` and registers it in your config. Restart Kilo to activate.
 
-### Manual installation
+### Via npm install
 
-**Windows and Unix:**
 ```bash
-git clone https://github.com/AnEntrypoint/gm-kilo ~/.config/kilo/plugin && cd ~/.config/kilo/plugin && bun install
-```
-
-**Windows PowerShell:**
-```powershell
-git clone https://github.com/AnEntrypoint/gm-kilo "\$env:APPDATA\kilo\plugin" && cd "\$env:APPDATA\kilo\plugin" && bun install
-```
-
-### Step 2: Configure MCP Servers
-
-Kilo uses the OpenCode configuration format. Create or update `~/.config/kilo/opencode.json`:
-
-```json
-{
-  "\$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "dev": {
-      "type": "local",
-      "command": ["bun x", "mcp-gm"],
-      "timeout": 360000,
-      "enabled": true
-    },
-    "code-search": {
-      "type": "local",
-      "command": ["bun x", "codebasesearch"],
-      "timeout": 360000,
-      "enabled": true
-    }
-  }
-}
-```
-
-### Step 3: Update Kilo Configuration
-
-Update `~/.config/kilo/kilocode.json` to reference the plugin:
-
-```json
-{
-  "\$schema": "https://kilo.ai/config.json",
-  "default_agent": "gm",
-  "plugin": ["/home/user/.config/kilo/plugin"]
-}
+npm install -g gm-kilo
+gm-kilo
 ```
 
-Replace `/home/user` with your actual home directory path.
+### Manual installation
 
-### Step 4: Verify Installation
+Clone to the global plugin directory:
 
-Start Kilo and verify the tools appear:
 ```bash
-kilo
+git clone https://github.com/AnEntrypoint/gm-kilo ~/.config/kilo/plugin
 ```
 
-Check MCP tools are connected:
-```bash
-kilo mcp list
-```
+## Features
 
-You should see `dev` and `code-search` marked as connected.
+- **State machine agent** — PLAN→EXECUTE→EMIT→VERIFY→COMPLETE orchestration
+- **Skill chain** — gm, planning, gm-execute, gm-emit, gm-complete, update-docs
+- **exec: dispatch** — code execution via spool watcher (nodejs, python, bash, typescript, go, rust)
+- **Code search** — semantic codebase exploration via exec:codesearch
+- **Git enforcement** — blocks session end with uncommitted changes or unpushed commits
+- **Memory** — rs-learn integration for cross-session knowledge retention
 
-## Features
+## How it works
+
+The plugin installs:
+- **Agent** (`agents/gm.md`) — primary orchestrator with skill-chain instructions
+- **Skills** (`skills/`) — PLAN, EXECUTE, EMIT, VERIFY, UPDATE-DOCS skill definitions
+- **Plugin** (`plugins/gm-kilo.mjs`) — hooks for session lifecycle, tool gating, exec: dispatch
+- **Lang runners** (`lang/`) — language-specific execution plugins
 
-- **MCP tools** - Code execution (`dev`) and semantic search (`code-search`)
-- **State machine agent** - Complete `gm` behavioral rule system
-- **Git enforcement** - Blocks uncommitted changes and unpushed commits on session idle
-- **AST analysis** - Automatic codebase analysis via mcp-thorns on session start
-- **.prd enforcement** - Blocks exit if work items remain in .prd file
+All exec: commands route through the spool watcher at `.gm/exec-spool/` for session-isolated task execution.
 
 ## Troubleshooting
 
-**MCP tools not appearing:**
-- Verify `~/.config/kilo/opencode.json` exists with correct MCP server definitions
-- Check that `plugin` path in `kilocode.json` points to the correct directory
-- Run `kilo mcp list` to verify servers are connected
+**Plugin not loading:**
+- Verify `~/.config/kilo/plugins/gm-kilo.mjs` exists
+- Check `kilocode.json` has the plugin path in the `plugin` array
 - Restart Kilo CLI completely
 
-**Plugin not loading:**
-- Verify plugin path in `kilocode.json` is absolute (e.g., `/home/user/.config/kilo/plugin`, not relative)
-- Check `index.js` and `gm.mjs` exist in the plugin directory
-- Run `bun install` in the plugin directory to ensure dependencies are installed
+**Skills not appearing:**
+- Verify `~/.config/kilo/skills/` contains skill directories with SKILL.md files
+- Skill names must be lowercase with hyphens (e.g., `gm`, `gm-execute`)
 
-The plugin activates automatically on session start once MCP servers are configured.
+**exec: commands failing:**
+- Check `.gm/exec-spool/` directory exists in your project
+- Verify plugkit binary is present at `~/.config/kilo/bin/`

package/agents/gm.md

@@ -1,6 +1,6 @@
 ---
-name: gm
 description: Agent (not skill) - immutable programming state machine. Always invoke for all work coordination.
+mode: primary
 ---
 
 # GM — Skill-First Orchestrator

package/cli.js

@@ -33,21 +33,27 @@ try {
   copyRecursive(path.join(srcDir, 'lang'), path.join(kiloConfigDir, 'lang'));
   copyRecursive(path.join(srcDir, 'bin'), path.join(kiloConfigDir, 'bin'));
   copyRecursive(path.join(srcDir, 'hooks'), path.join(kiloConfigDir, 'hooks'));
+  copyRecursive(path.join(srcDir, 'scripts'), path.join(kiloConfigDir, 'scripts'));
 
   const kiloJsonPath = path.join(kiloConfigDir, 'kilocode.json');
+  const configExisted = fs.existsSync(kiloJsonPath);
   let kiloConfig = {};
-  try {
-    const raw = fs.readFileSync(kiloJsonPath, 'utf-8');
-    kiloConfig = JSON.parse(raw);
-    if (kiloConfig['']) { delete kiloConfig['']; }
-  } catch (e) {}
-  delete kiloConfig.mcp;
-  kiloConfig['$schema'] = 'https://kilo.ai/config.json';
-  kiloConfig.default_agent = 'gm';
+  if (configExisted) {
+    try {
+      const raw = fs.readFileSync(kiloJsonPath, 'utf-8');
+      kiloConfig = JSON.parse(raw);
+      if (kiloConfig['']) { delete kiloConfig['']; }
+    } catch (e) {}
+  }
+  if (!configExisted) {
+    kiloConfig['$schema'] = 'https://kilo.ai/config.json';
+    kiloConfig.default_agent = 'gm';
+  }
   const kiloPluginPath = path.join(kiloConfigDir, 'plugins', 'gm-kilo.mjs');
   if (!Array.isArray(kiloConfig.plugin)) kiloConfig.plugin = [];
-  kiloConfig.plugin = kiloConfig.plugin.filter(p => !p.includes('gm-kilo'));
-  kiloConfig.plugin.push(kiloPluginPath);
+  if (!kiloConfig.plugin.some(p => typeof p === 'string' && p.includes('gm-kilo'))) {
+    kiloConfig.plugin.push(kiloPluginPath);
+  }
   fs.writeFileSync(kiloJsonPath, JSON.stringify(kiloConfig, null, 2) + '\n');
 
   const oldDir = process.platform === 'win32'

package/gm-kilo.mjs

@@ -15,64 +15,32 @@ function runPlugkit(args) {
   const bin = join(__dirname, '..', 'bin', 'plugkit.js');
   if (!existsSync(bin)) return '';
   try {
-    const r = spawnSync('node', [bin, ...args], { encoding: 'utf-8', timeout: 15000, windowsHide: true });
+    const r = spawnSync('node', [bin, ...args], { encoding: 'utf-8', timeout: 300000, windowsHide: true });
     return (r.stdout || '').trim() || (r.stderr || '').trim();
   } catch(e) { return ''; }
 }
 
 function safePrintf(s) {
-  return "printf '%s' '" + String(s).replace(/\\\\/g,'\\\\\\\\').replace(/'/g,"'\\\\''")+"'";
+  return "printf '%s' '" + String(s).replace(/'/g,"'\\\\''")+"'";
 }
 
 function stripFooter(s) { return s ? s.replace(/\n\[Running tools\][\s\S]*$/, '').trimEnd() : ''; }
 
-function tryLangPlugin(lang, code, cwd) {
-  const projectDir = cwd || process.cwd();
-  const candidates = [join(projectDir, 'lang', lang+'.js'), join(__dirname, '..', 'lang', lang+'.js')];
-  for (const langPluginFile of candidates) {
-    if (!existsSync(langPluginFile)) continue;
-    try {
-      const plugin = require(langPluginFile);
-      if (plugin && plugin.exec && plugin.exec.run) {
-        const result = plugin.exec.run(code, projectDir);
-        if (result && typeof result.then === 'function') continue;
-        return String(result === undefined ? '' : result);
-      }
-    } catch(e) {}
-  }
-  return null;
-}
-
 function runExecSync(rawLang, code, cwd) {
   const lang = LANG_ALIASES[rawLang] || rawLang || 'nodejs';
-  const opts = { encoding: 'utf-8', timeout: 30000, windowsHide: true, ...(cwd && { cwd }) };
-  const out = (r) => { const o = (r.stdout||'').trimEnd(), e = stripFooter(r.stderr||'').trimEnd(); return o && e ? o+'\n[stderr]\n'+e : o||e||'(no output)'; };
-  if (lang === 'codesearch' || lang === 'search') return runPlugkit(['search', '--path', cwd || process.cwd(), code.trim()]);
-  if (lang === 'runner') return runPlugkit(['runner', code.trim()]);
-  if (lang === 'status') return runPlugkit(['status', code.trim()]);
-  if (lang === 'sleep') return runPlugkit(['sleep', code.trim()]);
-  if (lang === 'close') return runPlugkit(['close', code.trim()]);
-  if (lang === 'browser') return runPlugkit(['exec', '--lang', 'browser', '--code', code.trim(), '--cwd', cwd || process.cwd()]);
-  if (lang === 'cmd') return out(spawnSync('cmd',['/c',code],opts));
-  const pluginResult = tryLangPlugin(lang, code, cwd);
-  if (pluginResult !== null) return pluginResult;
-  if (lang === 'python') return out(spawnSync('python3',['-c',code],opts));
-  if (lang === 'bash' || lang === 'sh') {
-    const tmp = join(tmpdir(),'gm-exec-'+Date.now()+'.sh');
-    writeFileSync(tmp,code,'utf-8');
-    const r = spawnSync('bash',[tmp],opts);
-    try { unlinkSync(tmp); } catch(e) {}
-    return out(r);
+  const projectDir = cwd || process.cwd();
+  if (lang === 'codesearch' || lang === 'search') return runPlugkit(['search', '--path', projectDir, code.trim()]);
+  if (['runner','status','sleep','close'].includes(lang)) return runPlugkit([lang, code.trim()]);
+  if (['browser','tail','watch','wait','type','kill-port','health','recall','memorize','forget','feedback','discipline','pause'].includes(lang)) {
+    return runPlugkit(['exec', '--lang', lang, '--code', code.trim(), '--cwd', projectDir]);
+  }
+  if (lang === 'cmd') {
+    const opts = { encoding: 'utf-8', timeout: 30000, windowsHide: true, cwd: projectDir };
+    const r = spawnSync('cmd', ['/c', code], opts);
+    const o = (r.stdout || '').trimEnd(), e = stripFooter(r.stderr || '').trimEnd();
+    return o && e ? o + '\n[stderr]\n' + e : o || e || '(no output)';
   }
-  const ext = lang === 'typescript' ? 'ts' : 'mjs';
-  const tmp = join(tmpdir(),'gm-exec-'+Date.now()+'.'+ext);
-  const src = lang === 'typescript' ? code : 'const __r=await(async()=>{\n'+code+'\n})();if(__r!==undefined){if(typeof __r==="object"){console.log(JSON.stringify(__r,null,2));}else{console.log(__r);}}';
-  writeFileSync(tmp,src,'utf-8');
-  const r = spawnSync('bun',['run',tmp],opts);
-  try { unlinkSync(tmp); } catch(e) {}
-  let result = out(r);
-  if (result) result = result.split(tmp).join('<script>');
-  return result;
+  return runPlugkit(['exec', '--lang', lang, '--code', code.trim(), '--cwd', projectDir]);
 }
 
 const BANNED_BASH = ['grep','rg','find','glob','awk','sed','cat','head','tail'];
@@ -89,7 +57,16 @@ export async function GmPlugin({ directory }) {
   const injectedSessions = new Set();
 
   return {
+    'session.created': async () => {
+      if (!sessionStarted) {
+        sessionStarted = true;
+        try { runPlugkit(['hook', 'session-start']); } catch(e) {}
+        try { runPlugkit(['bootstrap', directory]); } catch(e) {}
+      }
+    },
+
     'experimental.chat.system.transform': async (input, output) => {
+      const gmDir = join(directory, '.gm');
       try {
         const giPath = join(directory, '.gitignore');
         const entry = '.gm-stop-verified';
@@ -113,6 +90,12 @@ export async function GmPlugin({ directory }) {
           if (prd) output.system.push('\nPENDING WORK (.prd):\n'+prd);
         }
       } catch(e) {}
+      try {
+        const needsGmPath = join(gmDir, 'needs-gm');
+        if (existsSync(needsGmPath)) {
+          output.system.push('\nCRITICAL: You MUST invoke the `gm` skill before any other tool. Your current state is BLOCKED by a safety gate until gm runs.');
+        }
+      } catch(e) {}
     },
 
     'experimental.chat.messages.transform': async (input, output) => {
@@ -207,10 +190,10 @@ export async function GmPlugin({ directory }) {
       if (input.tool !== 'bash' && input.tool !== 'Bash' && input.tool !== 'shell' && input.tool !== 'Shell' && input.tool !== 'spawn/exec') return;
       const cmd = (output.args && output.args.command) || '';
       if (!cmd) return;
-      if (/^\s*git(?:\s|$)/.test(cmd)) return;
-      const m = cmd.match(/^exec(?::(\S+))?\n([\s\S]+)$/);
+      if (/^\s*(git|gh)(?:\s|$)/.test(cmd)) return;
+      const m = cmd.match(/^exec(?::(\S+))?\s*\n([\s\S]+)$/);
       if (!m) {
-        throw new Error('Use exec: prefix for Bash. The command must start with `exec` or `exec:<lang>` on its own line, then the body on the next line. Examples:\n\nexec\nls -la\n\nexec:nodejs\nconsole.log("hello")\n\nexec:bash\ngit status\n\nLanguages: nodejs (default), bash, python, typescript, go, rust, deno, cmd. File I/O via exec:nodejs + require("fs"). Raw JIT execution can also bypass Bash entirely: write to `.gm/exec-spool/in/<lang>/<N>.<ext>` (e.g. in/nodejs/42.js) and the spool watcher executes it and writes `.gm/exec-spool/out/<N>.json`. Codebase search: exec:codesearch on its own line, then a two-word query.');
+        throw new Error('Use exec: prefix for Bash. The command must start with `exec` or `exec:<lang>` on its own line, then the body on the next line. Examples:\\n\\nexec\\nls -la\\n\\nexec:nodejs\\nconsole.log("hello")\\n\\nexec:bash\\ngit status\\n\\nLanguages: nodejs (default), bash, python, typescript, go, rust, deno, cmd. File I/O via exec:nodejs + require("fs"). Raw JIT execution can also bypass Bash entirely: write to `.gm/exec-spool/in/<lang>/<N>.<ext>` (e.g. in/nodejs/42.js) and the spool watcher executes it and writes `.gm/exec-spool/out/<N>.json`. Codebase search: exec:codesearch on its own line, then a two-word query.');
       }
       const rawLang = (m[1]||'').toLowerCase();
       if (rawLang === 'bash' || rawLang === 'sh' || rawLang === '') {
@@ -218,7 +201,7 @@ export async function GmPlugin({ directory }) {
         if (banned) throw new Error('`'+banned+'` is blocked in exec:bash. Use exec:codesearch instead. For raw JIT execution, write code to `.gm/exec-spool/in/<lang>/<N>.<ext>` (e.g. in/nodejs/42.js); the spool watcher executes it and writes out/<N>.json.');
       }
       const result = runExecSync(m[1]||'', m[2], output.args.workdir || directory);
-      output.args = { ...output.args, command: safePrintf('exec:'+(m[1]||'nodejs')+' output:\n\n'+result) };
+      throw new Error('exec:'+(m[1]||'nodejs')+' output:\n\n'+result);
     },
     'message.updated': async (input, output) => {
       try {

package/install.js

@@ -33,10 +33,14 @@ function install() {
   if (!isInsideNodeModules()) return;
   const projectRoot = getProjectRoot();
   if (!projectRoot) return;
-  const kiloDir = path.join(projectRoot, '.config', 'kilo', 'plugin');
+  const kiloDir = path.join(projectRoot, '.kilo', 'plugins', 'gm-kilo');
   const sourceDir = __dirname;
   safeCopyDirectory(path.join(sourceDir, 'agents'), path.join(kiloDir, 'agents'));
   safeCopyDirectory(path.join(sourceDir, 'hooks'), path.join(kiloDir, 'hooks'));
+  safeCopyDirectory(path.join(sourceDir, 'bin'), path.join(kiloDir, 'bin'));
+  safeCopyDirectory(path.join(sourceDir, 'skills'), path.join(kiloDir, 'skills'));
+  safeCopyDirectory(path.join(sourceDir, 'lang'), path.join(kiloDir, 'lang'));
+  safeCopyDirectory(path.join(sourceDir, 'scripts'), path.join(kiloDir, 'scripts'));
 }
 
 install();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-kilo",
-  "version": "2.0.1059",
+  "version": "2.0.1061",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",
@@ -30,9 +30,6 @@
     "access": "public"
   },
   "dependencies": {},
-  "scripts": {
-    "postinstall": "node scripts/postinstall-kilo.js"
-  },
   "files": [
     "agents/",
     "bin/",

package/skills/gm/SKILL.md

@@ -2,17 +2,6 @@
 name: gm
 description: Orchestrator dispatching PLAN→EXECUTE→EMIT→VERIFY→UPDATE-DOCS skill chain; spool-driven task execution with session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-cc
-  - gm-gc
-  - gm-oc
-  - gm-kilo
-  - gm-codex
-  - gm-copilot-cli
-  - gm-vscode
-  - gm-cursor
-  - gm-zed
-  - gm-jetbrains
 end-to-end: true
 ---
 

package/skills/gm-cc/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-cc
 description: AI-native software engineering via skill-driven orchestration on cc; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-cc
 ---
 
 # GM — cc Platform

package/skills/gm-codex/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-codex
 description: AI-native software engineering via skill-driven orchestration on codex; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-codex
 ---
 
 # GM — codex Platform

package/skills/gm-copilot-cli/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-copilot-cli
 description: AI-native software engineering via skill-driven orchestration on copilot-cli; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-copilot-cli
 ---
 
 # GM — copilot-cli Platform

package/skills/gm-cursor/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-cursor
 description: AI-native software engineering via skill-driven orchestration on cursor; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-cursor
 ---
 
 # GM — cursor Platform

package/skills/gm-gc/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-gc
 description: AI-native software engineering via skill-driven orchestration on gc; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-gc
 ---
 
 # GM — gc Platform

package/skills/gm-jetbrains/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-jetbrains
 description: AI-native software engineering via skill-driven orchestration on jetbrains; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-jetbrains
 ---
 
 # GM — jetbrains Platform

package/skills/gm-kilo/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-kilo
 description: AI-native software engineering via skill-driven orchestration on kilo; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-kilo
 ---
 
 # GM — kilo Platform

package/skills/gm-oc/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-oc
 description: AI-native software engineering via skill-driven orchestration on oc; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-oc
 ---
 
 # GM — oc Platform

package/skills/gm-vscode/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-vscode
 description: AI-native software engineering via skill-driven orchestration on vscode; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-vscode
 ---
 
 # GM — vscode Platform

package/skills/gm-zed/SKILL.md

@@ -2,8 +2,6 @@
 name: gm-zed
 description: AI-native software engineering via skill-driven orchestration on zed; bootstraps plugkit for task execution and session isolation
 allowed-tools: Skill
-compatible-platforms:
-  - gm-zed
 ---
 
 # GM — zed Platform