gm-thebird 2.0.1012

package/bin/plugkit.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+'use strict';
+// Hot path: spawnSync to ~/.claude/gm-tools/plugkit.exe with inherited stdio.
+// Cold path (session-start / prompt-submit OR missing binary): synchronously
+// ensure gm-tools/plugkit{.exe} matches the pinned version, then run hook.
+// Cache-aware: when local matches the pin (sha-checked), zero network calls.
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const wrapperDir = __dirname;
+
+function toolsBin() {
+  const home = process.env.USERPROFILE || process.env.HOME || os.homedir();
+  const exe = process.platform === 'win32' ? 'plugkit.exe' : 'plugkit';
+  return path.join(home, '.claude', 'gm-tools', exe);
+}
+
+function sha256OfFileSync(filePath) {
+  try {
+    const crypto = require('crypto');
+    const h = crypto.createHash('sha256');
+    const fd = fs.openSync(filePath, 'r');
+    try {
+      const buf = Buffer.alloc(1 << 20);
+      let n;
+      while ((n = fs.readSync(fd, buf, 0, buf.length, null)) > 0) h.update(buf.subarray(0, n));
+    } finally { fs.closeSync(fd); }
+    return h.digest('hex');
+  } catch (_) { return null; }
+}
+
+function platformAsset() {
+  const p = process.platform;
+  const a = process.arch;
+  if (p === 'win32') return a === 'arm64' ? 'plugkit-win32-arm64.exe' : 'plugkit-win32-x64.exe';
+  if (p === 'darwin') return a === 'arm64' ? 'plugkit-darwin-arm64' : 'plugkit-darwin-x64';
+  return (a === 'arm64' || a === 'aarch64') ? 'plugkit-linux-arm64' : 'plugkit-linux-x64';
+}
+
+function readPinnedVersion() {
+  try { return fs.readFileSync(path.join(wrapperDir, 'plugkit.version'), 'utf8').trim(); } catch (_) { return null; }
+}
+
+function readExpectedSha() {
+  try {
+    const manifest = fs.readFileSync(path.join(wrapperDir, 'plugkit.sha256'), 'utf8');
+    const asset = platformAsset();
+    for (const line of manifest.split(/\r?\n/)) {
+      const parts = line.trim().split(/\s+/);
+      if (parts.length >= 2 && parts[parts.length - 1].replace(/^\*/, '') === asset) {
+        return parts[0].toLowerCase();
+      }
+    }
+  } catch (_) {}
+  return null;
+}
+
+// Returns true if gm-tools binary matches pinned version by sha. Fast: no network.
+function isReady() {
+  const bin = toolsBin();
+  if (!fs.existsSync(bin)) return false;
+  const expected = readExpectedSha();
+  if (!expected) return true; // no manifest to compare against — trust existence
+  const actual = sha256OfFileSync(bin);
+  return actual && actual.toLowerCase() === expected;
+}
+
+// Synchronously run bootstrap.js in a child node. Blocks until install finishes
+// (or fails). Bootstrap itself is cache-aware: re-download only when sha differs
+// from manifest. Wraps stdio:inherit so the user sees progress.
+function ensureReady(silent) {
+  if (isReady()) return true;
+  const bootstrap = path.join(wrapperDir, 'bootstrap.js');
+  const r = spawnSync(process.execPath, [bootstrap], {
+    stdio: silent ? ['ignore', 'pipe', 'pipe'] : ['ignore', 'inherit', 'inherit'],
+    windowsHide: true,
+  });
+  return r.status === 0 && isReady();
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const isHook = args[0] === 'hook';
+  const hookSubcmd = isHook ? (args[1] || '') : '';
+
+  // Synchronous readiness check on these hooks. Hot path: isReady() is sha-match
+  // against pinned manifest, returns true in <50ms with no network.
+  const blocksUntilReady = hookSubcmd === 'session-start' || hookSubcmd === 'prompt-submit';
+
+  if (blocksUntilReady) {
+    if (!ensureReady(false)) {
+      process.stderr.write('[plugkit] bootstrap failed; aborting hook\n');
+      process.exit(1);
+    }
+  } else if (!fs.existsSync(toolsBin())) {
+    // For non-blocking hooks (pre-tool-use, post-tool-use, stop, etc.): if the
+    // binary doesn't exist yet, exit cleanly — session-start will populate it.
+    if (isHook) process.exit(0);
+    process.exit(1);
+  }
+
+  const bin = toolsBin();
+  const r = spawnSync(bin, args, { stdio: 'inherit', windowsHide: true });
+  process.exit(r.status ?? 1);
+}
+
+main();

package/bin/plugkit.sha256

@@ -0,0 +1,6 @@
+a93716d43136550aa45d03cf50e6f0dac8d7e7f918f5898fa7cc445abb004cb7  plugkit-win32-x64.exe
+049215ba681d8ac9e01b138e425b24e8b7b9f1b4f034f5709d12838a55c63ce6  plugkit-win32-arm64.exe
+d9d2d11d9e6ef1cac046218e2b07b2ddb591523cbce275fe3e9a1af20d55c47f  plugkit-darwin-x64
+8f91a939056f27a56e42cc378a0d6d38e0b4259547852c7954b5758d3315d3b7  plugkit-darwin-arm64
+3d9391b8f674a7bbb4cf380973597a271d9d4ac62d16fb6e40f52d5697ef9f67  plugkit-linux-x64
+af3270e3503400575e29347ea128656a6664fc1f319c4719716ec5fdb0428708  plugkit-linux-arm64

package/bin/plugkit.version

@@ -0,0 +1 @@
+0.1.354

package/bin/rtk.sha256

@@ -0,0 +1,6 @@
+934e8e8b092e56e191807e2eaad90b197444639458d555cfbc09c24e75ea57a0  rtk-win32-x64.exe
+c5c73d0c3669fcd88f199f55f060125d79fd50cbff36674bf95d18c63116db9a  rtk-win32-arm64.exe
+1b1e792767ed0e1e6ca0e2f0a8de02e77b06dea2f5ae667278b94baf239fcdc3  rtk-darwin-x64
+9717978d9d6216ea50c94444e00e359479b6315a17bd48c16064b267c8b0b60d  rtk-darwin-arm64
+a100d3defac54194144e5723aec57e6f286b42298c67145c8428815246c9ee56  rtk-linux-x64
+d3a9990cf468153cfb6ab2a240bf9ce2e22ac4bf7f7fe75c2fbbd5d84ac799eb  rtk-linux-arm64

package/bin/rtk.version

@@ -0,0 +1 @@
+0.39.0

package/cli.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const https = require('https');
+
+const homeDir = process.env.HOME || process.env.USERPROFILE || os.homedir();
+const destDir = path.join(homeDir, '.freddie', 'plugins', 'gm-thebird');
+const srcDir = __dirname;
+const isUpgrade = fs.existsSync(destDir);
+
+console.log(isUpgrade ? 'Upgrading gm-thebird...' : 'Installing gm-thebird...');
+
+function copyRecursive(src, dst) {
+    if (!fs.existsSync(src)) return;
+    if (fs.statSync(src).isDirectory()) {
+      fs.mkdirSync(dst, { recursive: true });
+      fs.readdirSync(src).forEach(f => copyRecursive(path.join(src, f), path.join(dst, f)));
+    } else {
+      fs.copyFileSync(src, dst);
+    }
+  }
+
+function downloadPlugkitWasm(version, target) {
+  return new Promise((resolve, reject) => {
+    const url = 'https://github.com/AnEntrypoint/plugkit-bin/releases/download/v' + version + '/plugkit.wasm';
+    function get(u, redirectsLeft) {
+      https.get(u, { headers: { 'User-Agent': 'gm-thebird-installer' } }, res => {
+        if ([301,302,303,307,308].includes(res.statusCode) && res.headers.location && redirectsLeft > 0) {
+          return get(res.headers.location, redirectsLeft - 1);
+        }
+        if (res.statusCode !== 200) { reject(new Error('plugkit.wasm fetch failed: HTTP ' + res.statusCode)); return; }
+        const out = fs.createWriteStream(target);
+        res.pipe(out);
+        out.on('finish', () => out.close(resolve));
+        out.on('error', reject);
+      }).on('error', reject);
+    }
+    get(url, 5);
+  });
+}
+
+(async () => {
+  try {
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.mkdirSync(path.join(destDir, 'bin'), { recursive: true });
+    copyRecursive(path.join(srcDir, 'agents'), path.join(destDir, 'agents'));
+    copyRecursive(path.join(srcDir, 'hooks'), path.join(destDir, 'hooks'));
+    copyRecursive(path.join(srcDir, 'skills'), path.join(destDir, 'skills'));
+    try { fs.copyFileSync(path.join(srcDir, 'plugin.json'), path.join(destDir, 'plugin.json')); } catch {}
+    try { fs.copyFileSync(path.join(srcDir, 'gm.json'), path.join(destDir, 'gm.json')); } catch {}
+    try { fs.copyFileSync(path.join(srcDir, 'README.md'), path.join(destDir, 'README.md')); } catch {}
+
+    const version = fs.readFileSync(path.join(srcDir, 'bin', 'plugkit.version'), 'utf-8').trim();
+    const wasmTarget = path.join(destDir, 'bin', 'plugkit.wasm');
+    if (!fs.existsSync(wasmTarget)) {
+      console.log('Fetching plugkit.wasm v' + version + '...');
+      await downloadPlugkitWasm(version, wasmTarget);
+    }
+    fs.writeFileSync(path.join(destDir, 'bin', 'plugkit.version'), version);
+
+    console.log('✓ gm-thebird ' + (isUpgrade ? 'upgraded' : 'installed') + ' to ' + destDir);
+    console.log('Restart Freddie to load the plugin.');
+  } catch (e) {
+    console.error('Installation failed:', e.message);
+    process.exit(1);
+  }
+})();

package/gm.json

@@ -0,0 +1,27 @@
+{
+  "name": "gm",
+  "version": "2.0.1012",
+  "description": "State machine agent with hooks, skills, and automated git enforcement",
+  "author": "AnEntrypoint",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "claude-plugin",
+    "wfgy",
+    "automation"
+  ],
+  "homepage": "https://github.com/AnEntrypoint/gm",
+  "agents": [
+    {
+      "name": "gm",
+      "description": "Agent (not skill) - immutable programming state machine. Always invoke for all work coordination."
+    }
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "plugkitVersion": "0.1.354"
+}

package/hooks/hooks.json

@@ -0,0 +1,102 @@
+{
+  "description": "Hooks for gm thebird extension",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_pre_tool_use",
+            "timeout": 3600
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_post_tool_use",
+            "timeout": 35000
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_session_start",
+            "timeout": 180000
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_prompt_submit",
+            "timeout": 60000
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_pre_compact",
+            "timeout": 30000
+          }
+        ]
+      }
+    ],
+    "PostCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_post_compact",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_stop",
+            "timeout": 15000
+          },
+          {
+            "type": "wasm",
+            "module": "${CLAUDE_PLUGIN_ROOT}/bin/plugkit.wasm",
+            "export": "hook_stop_git",
+            "timeout": 210000
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks.spec.json

@@ -0,0 +1,83 @@
+{
+  "schemaVersion": 1,
+  "description": "Hook spec for gm thebird extension",
+  "envVar": "CLAUDE_PLUGIN_ROOT",
+  "plugkitInvoker": "node",
+  "events": [
+    {
+      "eventKey": "PreToolUse",
+      "commands": [
+        {
+          "kind": "wasm",
+          "subcommand": "pre-tool-use",
+          "timeout": 3600
+        }
+      ]
+    },
+    {
+      "eventKey": "PostToolUse",
+      "commands": [
+        {
+          "kind": "wasm",
+          "subcommand": "post-tool-use",
+          "timeout": 35000
+        }
+      ]
+    },
+    {
+      "eventKey": "SessionStart",
+      "commands": [
+        {
+          "kind": "wasm",
+          "subcommand": "session-start",
+          "timeout": 180000
+        }
+      ]
+    },
+    {
+      "eventKey": "UserPromptSubmit",
+      "commands": [
+        {
+          "kind": "wasm",
+          "subcommand": "prompt-submit",
+          "timeout": 60000
+        }
+      ]
+    },
+    {
+      "eventKey": "PreCompact",
+      "commands": [
+        {
+          "kind": "wasm",
+          "subcommand": "pre-compact",
+          "timeout": 30000
+        }
+      ]
+    },
+    {
+      "eventKey": "PostCompact",
+      "commands": [
+        {
+          "kind": "wasm",
+          "subcommand": "post-compact",
+          "timeout": 5000
+        }
+      ]
+    },
+    {
+      "eventKey": "Stop",
+      "commands": [
+        {
+          "kind": "wasm",
+          "subcommand": "stop",
+          "timeout": 15000
+        },
+        {
+          "kind": "wasm",
+          "subcommand": "stop-git",
+          "timeout": 210000
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "gm-thebird",
+  "version": "2.0.1012",
+  "description": "State machine agent with hooks, skills, and automated git enforcement",
+  "author": "AnEntrypoint",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AnEntrypoint/gm-thebird.git"
+  },
+  "homepage": "https://github.com/AnEntrypoint/gm-thebird#readme",
+  "bugs": {
+    "url": "https://github.com/AnEntrypoint/gm-thebird/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "gm-thebird": "./cli.js"
+  },
+  "files": [
+    "agents/",
+    "bin/",
+    "hooks/",
+    "skills/",
+    "plugin.json",
+    "cli.js",
+    "README.md",
+    "AGENTS.md",
+    "gm.json"
+  ],
+  "keywords": [
+    "thebird",
+    "freddie",
+    "plugsdk",
+    "wasm",
+    "agent",
+    "state-machine",
+    "gm"
+  ]
+}

package/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "gm",
+  "version": "2.0.1012",
+  "description": "State machine agent with hooks, skills, and automated git enforcement",
+  "author": {
+    "name": "AnEntrypoint",
+    "url": "https://github.com/AnEntrypoint"
+  },
+  "homepage": "https://github.com/AnEntrypoint/gm",
+  "hooks": "./hooks/hooks.json",
+  "skills": "./skills",
+  "mcpServers": {}
+}

package/skills/browser/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: browser
+description: Browser automation via playwriter. Use when user needs to interact with websites, navigate pages, fill forms, click buttons, take screenshots, extract data, test web apps, or automate any browser task.
+allowed-tools: Skill, Bash, Read, Write, Edit, Agent
+---
+
+# Browser automation
+
+Two pathways — never mix in the same Bash call.
+
+`exec:browser` runs JS against `page`. Globals available: `page`, `snapshot`, `screenshotWithAccessibilityLabels`, `state`. 15s live window, then backgrounds; output drains automatically on every subsequent plugkit call.
+
+`browser:` prefix is playwriter session management. One command per block.
+
+## Core
+
+```
+exec:browser
+await page.goto('https://example.com')
+await snapshot({ page })
+```
+
+```
+browser:
+playwriter session new --direct
+```
+
+```
+browser:
+playwriter -s 1 -e 'await page.goto("http://example.com")'
+```
+
+Session state persists across `browser:` calls. `-e` arg uses single quotes outside, double inside JS strings.
+
+## Timing
+
+Never `await setTimeout(N)` with N > 10000. Poll instead.
+
+```
+exec:browser
+const start = Date.now()
+while (!state.done && Date.now() - start < 12000) {
+  await new Promise(r => setTimeout(r, 500))
+}
+console.log(state.result)
+```
+
+`Assertion failed: UV_HANDLE_CLOSING` is normal background-on-exit noise; ignore it.
+
+## Patterns
+
+Data extraction:
+
+```
+exec:browser
+const items = await page.$$eval('.title', els => els.map(e => e.textContent))
+console.log(JSON.stringify(items))
+```
+
+Console monitoring — set listeners first, then poll:
+
+```
+exec:browser
+state.logs = []
+page.on('console', msg => state.logs.push({ type: msg.type(), text: msg.text() }))
+```
+
+```
+exec:browser
+console.log(JSON.stringify(state.logs.slice(-20)))
+```
+
+## Constraints
+
+- One playwriter command per `browser:` block
+- `exec:browser` is plain JS, no shell quoting
+- Browser tasks drain automatically on every plugkit interaction
+- Sessions reap after 5–15 min idle; cleaned up on session end
+- Never write standalone `.mjs`/`.js` Playwright scripts as a fallback — `exec:browser` errors must be debugged through `exec:browser` retries, not by creating test files on disk

package/skills/code-search/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: code-search
+description: Mandatory codebase search workflow. Use whenever you need to find anything in the codebase. Start with two words, iterate by changing or adding words until found.
+---
+
+# Codebase search
+
+`exec:codesearch` is the only codebase search tool. Grep, Glob, Find, Explore, raw `grep`/`rg`/`find` inside `exec:bash` are all hook-blocked. No fallback.
+
+A `@<discipline>` first-token after the verb scopes the search to that discipline's index; absent the sigil, results fan across default plus enabled disciplines, prefixed by source.
+
+Handles exact symbols, exact strings, file-name fragments, regex-ish patterns, natural-language queries, and PDF pages (cite `path/doc.pdf:<page>`).
+
+Direct-read exceptions: known absolute path → `Read`. Known directory listing → `exec:nodejs` + `fs.readdirSync`.
+
+## Syntax
+
+```
+exec:codesearch
+<two-word query>
+```
+
+## Iteration
+
+Start at exactly two words. No results → change one word. Still none → add a third. Still none → swap the changed word again. Minimum four attempts before concluding absent. Never one word, never a full sentence, never switch tools.
+
+## Examples
+
+```
+exec:codesearch
+session cleanup idle
+```
+
+No results, then:
+
+```
+exec:codesearch
+cleanup sessions timeout
+```
+
+PDF:
+
+```
+exec:codesearch
+usb descriptor endpoint
+```
+
+Returns `docs/usb-spec.pdf:42` — cite the page; `Read` if surrounding text is needed.