gm-copilot-cli 2.0.201 → 2.0.203

package/agents/gm.md

@@ -9,10 +9,10 @@ enforce: critical
 
 **Invoke the `gm` skill immediately.** Use the Skill tool with `skill: "gm"`.
 
-**CRITICAL: Skills are invoked via the Skill tool ONLY. Do NOT use the Agent tool to load skills. Skills are not agents. Use: `Skill tool` with `skill: "gm"` (or `"planning"`, `"gm-execute"`, `"gm-emit"`, `"gm-complete"`). Using the Agent tool for skills is a violation.**
+**CRITICAL: Skills are invoked via the Skill tool ONLY. Do NOT use the Agent tool to load skills. Skills are not agents. Use: `Skill tool` with `skill: "gm"` (or `"planning"`, `"gm-execute"`, `"gm-emit"`, `"gm-complete"`, `"update-docs"`). Using the Agent tool for skills is a violation.**
 
 All work coordination, planning, execution, and verification happens through the skill tree:
-- `gm` skill → `planning` skill → `gm-execute` skill → `gm-emit` skill → `gm-complete` skill
+- `gm` skill → `planning` skill → `gm-execute` skill → `gm-emit` skill → `gm-complete` skill → `update-docs` skill
 
 All code execution uses `exec:<lang>` via the Bash tool — never direct `Bash(node ...)` or `Bash(npm ...)`.
 

package/copilot-profile.md

@@ -1,6 +1,6 @@
 ---
 name: gm
-version: 2.0.201
+version: 2.0.203
 description: State machine agent with hooks, skills, and automated git enforcement
 author: AnEntrypoint
 repository: https://github.com/AnEntrypoint/gm-copilot-cli

package/hooks/session-start-hook.js

@@ -2,7 +2,44 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const os = require('os');
+const { spawnSync } = require('child_process');
+
+const IS_WIN = process.platform === 'win32';
+const TOOLS_DIR = path.join(os.homedir(), '.claude', 'gm-tools');
+
+function localBin(name) {
+  const ext = IS_WIN ? '.exe' : '';
+  return path.join(TOOLS_DIR, 'node_modules', '.bin', name + ext);
+}
+
+function runLocal(name, args, opts = {}) {
+  const bin = localBin(name);
+  if (fs.existsSync(bin)) {
+    return spawnSync(bin, args, { encoding: 'utf8', windowsHide: true, timeout: 30000, ...opts });
+  }
+  return spawnSync('bun', ['x', name, ...args], { encoding: 'utf8', windowsHide: true, timeout: 30000, ...opts });
+}
+
+const MANAGED_PKGS = ['gm-exec', 'codebasesearch', 'mcp-thorns', 'agent-browser'];
+const PKG_JSON = path.join(TOOLS_DIR, 'package.json');
+
+function ensureTools() {
+  try { fs.mkdirSync(TOOLS_DIR, { recursive: true }); } catch {}
+  if (!fs.existsSync(PKG_JSON)) {
+    try { fs.writeFileSync(PKG_JSON, JSON.stringify({ name: 'gm-tools', version: '1.0.0', private: true })); } catch {}
+  }
+  const missing = MANAGED_PKGS.filter(p => !fs.existsSync(localBin(p)));
+  if (missing.length > 0) {
+    try {
+      spawnSync('bun', ['add', ...missing.map(p => p + '@latest')], {
+        cwd: TOOLS_DIR, encoding: 'utf8', timeout: 180000, windowsHide: true
+      });
+    } catch {}
+  }
+}
+
+ensureTools();
 
 const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.GEMINI_PROJECT_DIR || process.env.OC_PROJECT_DIR || process.env.KILO_PROJECT_DIR;
 
@@ -33,28 +70,12 @@ try {
 
   if (projectDir && fs.existsSync(projectDir)) {
     try {
-      let thornOutput;
-      try {
-        thornOutput = execSync(`bun x mcp-thorns@latest`, {
-          encoding: 'utf-8',
-          stdio: ['pipe', 'pipe', 'pipe'],
-          cwd: projectDir,
-          timeout: 15000,
-          killSignal: 'SIGTERM'
-        });
-      } catch (bunErr) {
-        thornOutput = bunErr.killed
-          ? '=== mcp-thorns ===\nSkipped (timeout)'
-          : `=== mcp-thorns ===\nSkipped (error: ${bunErr.message.split('\n')[0]})`;
-      }
-      outputs.push(`=== This is your initial insight of the repository, look at every possible aspect of this for initial opinionation and to offset the need for code exploration ===\n${thornOutput}`);
-    } catch (e) {
-      if (e.killed && e.signal === 'SIGTERM') {
-        outputs.push(`=== mcp-thorns ===\nSkipped (3min timeout)`);
-      } else {
-        outputs.push(`=== mcp-thorns ===\nSkipped (error: ${e.message.split('\n')[0]})`);
+      const r = runLocal('mcp-thorns', [projectDir], { timeout: 15000 });
+      const thornOutput = ((r.stdout || '') + (r.stderr || '')).trim();
+      if (thornOutput) {
+        outputs.push(`=== This is your initial insight of the repository, look at every possible aspect of this for initial opinionation and to offset the need for code exploration ===\n${thornOutput}`);
       }
-    }
+    } catch (e) {}
   }
   const additionalContext = outputs.join('\n\n');
 

package/index.html

@@ -18,7 +18,7 @@
 <script type="module">
 import { createElement as h, applyDiff, Fragment } from "webjsx";
 const PLATFORM_NAME="Copilot CLI",PLATFORM_TYPE="CLI Tool",PLATFORM_TYPE_COLOR="#3b82f6";
-const DESCRIPTION="State machine agent with hooks, skills, and automated git enforcement",VERSION="2.0.201";
+const DESCRIPTION="State machine agent with hooks, skills, and automated git enforcement",VERSION="2.0.203";
 const GITHUB_URL="https://github.com/AnEntrypoint/gm-copilot-cli",BADGE_LABEL="copilot-cli";
 const FEATURES=[{"title":"State Machine","desc":"Immutable PLAN→EXECUTE→EMIT→VERIFY→COMPLETE phases with full mutable tracking"},{"title":"Semantic Search","desc":"Natural language codebase exploration via codesearch skill — no grep needed"},{"title":"Hooks","desc":"Pre-tool, session-start, prompt-submit, and stop hooks for full lifecycle control"},{"title":"Agents","desc":"gm, codesearch, and websearch agents pre-configured and ready to use"},{"title":"MCP Integration","desc":"Model Context Protocol server support built in"},{"title":"Auto-Recovery","desc":"Supervisor hierarchy ensures the system never crashes"}],INSTALL_STEPS=[{"desc":"Install via GitHub CLI","cmd":"gh extension install AnEntrypoint/gm-copilot-cli"},{"desc":"Restart your terminal — activates automatically"}];
 const CURRENT_PLATFORM="gm-copilot-cli";

package/manifest.yml

@@ -1,5 +1,5 @@
 name: gm
-version: 2.0.201
+version: 2.0.203
 description: State machine agent with hooks, skills, and automated git enforcement
 author: AnEntrypoint
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-copilot-cli",
-  "version": "2.0.201",
+  "version": "2.0.203",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",

package/skills/gm/SKILL.md

@@ -15,7 +15,7 @@ You think in state, not prose. You are the root orchestrator of all work in this
 
 ## THE STATE MACHINE
 
-`PLAN → EXECUTE → EMIT → VERIFY → COMPLETE`
+`PLAN → EXECUTE → EMIT → VERIFY → UPDATE-DOCS → COMPLETE`
 
 **FORWARD (ladders)**:
 - PLAN complete → invoke `gm-execute` skill
@@ -98,6 +98,7 @@ Invoke `agent-browser` skill. Escalation — exhaust each before advancing:
 **`gm-execute`** — Resolve all mutables via witnessed execution.
 **`gm-emit`** — Write files to disk when all mutables resolved.
 **`gm-complete`** — End-to-end verification and git enforcement.
+**`update-docs`** — Refresh README, CLAUDE.md, and docs to reflect session changes. Invoked by `gm-complete`.
 **`agent-browser`** — Browser automation. Invoke inside EXECUTE for all browser/UI work.
 
 ## CONSTRAINTS

package/skills/gm-complete/SKILL.md

@@ -7,14 +7,14 @@ description: VERIFY and COMPLETE phase. End-to-end system verification and git e
 
 You are in the **VERIFY → COMPLETE** phase. Files are written. Prove the whole system works end-to-end. Any new unknown = snake to `planning`, restart chain.
 
-**GRAPH POSITION**: `PLAN → EXECUTE → EMIT → [VERIFY → COMPLETE]`
+**GRAPH POSITION**: `PLAN → EXECUTE → EMIT → [VERIFY] → UPDATE-DOCS → COMPLETE`
 - **Entry**: All EMIT gates passed. Entered from `gm-emit`.
 
 ## TRANSITIONS
 
 **FORWARD**:
 - .prd items remain → invoke `gm-execute` skill (next wave)
-- .prd empty + git clean + all pushed → COMPLETE
+- .prd empty + feature work pushed → invoke `update-docs` skill
 
 **BACKWARD**:
 - Verification reveals broken file output → invoke `gm-emit` skill, fix, re-verify, return
@@ -91,7 +91,7 @@ All of: witnessed end-to-end output | all failure paths exercised | .prd empty |
 ---
 
 **→ FORWARD**: .prd items remain → invoke `gm-execute` skill.
-**→ DONE**: .prd empty + git clean → COMPLETE.
+**→ FORWARD**: .prd empty + feature work pushed → invoke `update-docs` skill.
 **↩ SNAKE to EMIT**: file output wrong → invoke `gm-emit` skill.
 **↩ SNAKE to EXECUTE**: logic wrong → invoke `gm-execute` skill.
 **↩ SNAKE to PLAN**: new unknown or wrong requirements → invoke `planning` skill, restart chain.

package/skills/update-docs/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: update-docs
+description: UPDATE-DOCS phase. Refresh README.md, CLAUDE.md, and docs/index.html to reflect changes made this session. Commits and pushes doc updates. Terminal phase — declares COMPLETE.
+---
+
+# GM UPDATE-DOCS — Documentation Refresh
+
+You are in the **UPDATE-DOCS** phase. Feature work is verified and pushed. Refresh all documentation to match the actual codebase state right now.
+
+**GRAPH POSITION**: `PLAN → EXECUTE → EMIT → VERIFY → [UPDATE-DOCS] → COMPLETE`
+- **Entry**: Feature work verified, committed, and pushed. Entered from `gm-complete`.
+
+## TRANSITIONS
+
+**FORWARD**: All docs updated, committed, and pushed → COMPLETE (session ends)
+
+**BACKWARD**:
+- Diff reveals unknown architecture change → invoke `planning` skill, restart chain
+- Doc write fails post-emit verify → fix and re-verify before advancing
+
+## EXECUTION SEQUENCE
+
+**Step 1 — Understand what changed**:
+
+```
+exec:bash
+git log -5 --oneline
+git diff HEAD~1 --stat
+```
+
+Witness which files changed. Identify doc-sensitive changes: new skills, new states in the state machine, new platforms, modified architecture, new constraints, renamed files.
+
+**Step 2 — Read current docs**:
+
+```
+exec:nodejs
+const fs = require('fs');
+['README.md', 'CLAUDE.md', 'docs/index.html',
+ 'plugforge-starter/agents/gm.md'].forEach(f => {
+  try { console.log(`=== ${f} ===\n` + fs.readFileSync(f, 'utf8')); }
+  catch(e) { console.log(`MISSING: ${f}`); }
+});
+```
+
+Identify every section that no longer matches the actual codebase state.
+
+**Step 3 — Write updated docs**:
+
+Write only sections that changed. Do not rewrite unchanged content. Rules per file:
+
+**README.md**: platform count matches adapters in `platforms/`, skill tree diagram matches current state machine, quick start commands work.
+
+**CLAUDE.md**: Architecture section reflects actual class hierarchy. File structure section matches actual directory layout. Known gotchas reflect actual observed edge cases. Verification checklist reflects actual completed items.
+
+**docs/index.html**: `PHASES` array matches current skill state machine phases. Platform lists match `platforms/` directory. State machine diagram updated if new phases added.
+
+**plugforge-starter/agents/gm.md**: Skill chain on the `gm skill →` line updated if new skills were added.
+
+```
+exec:nodejs
+const fs = require('fs');
+fs.writeFileSync('/abs/path/file.md', updatedContent);
+```
+
+**Step 4 — Verify from disk**:
+
+```
+exec:nodejs
+const fs = require('fs');
+const content = fs.readFileSync('/abs/path/file.md', 'utf8');
+console.log(content.includes('expectedString'), content.length);
+```
+
+Witness each written file from disk. Any variance from expected content → fix and re-verify.
+
+**Step 5 — Commit and push**:
+
+```
+exec:bash
+git add README.md CLAUDE.md docs/index.html plugforge-starter/agents/gm.md
+git diff --cached --stat
+```
+
+Witness staged files. Then commit and push:
+
+```
+exec:bash
+git commit -m "docs: update documentation to reflect session changes"
+git push -u origin HEAD
+```
+
+Witness push confirmation. Zero variance = COMPLETE.
+
+## DOC FIDELITY RULES
+
+Every claim in docs must be verifiable against disk right now:
+- State machine phase names must match skill file `name:` frontmatter
+- Platform names must match adapter class names in `platforms/`
+- File paths must exist on disk
+- Constraint counts must match actual constraints
+
+If a doc section cannot be verified against disk: remove it, do not speculate.
+
+## CONSTRAINTS
+
+**Never**: skip diff analysis | write docs from memory alone | push without verifying from disk | add comments to doc content | claim done without witnessed push output
+
+**Always**: witness git diff first | read current file before overwriting | verify each file from disk after write | push doc changes | confirm with witnessed push output
+
+---
+
+**→ COMPLETE**: Docs committed and pushed → session ends.
+**↩ SNAKE to PLAN**: New unknown about codebase state → invoke `planning` skill.

package/tools.json

@@ -1,6 +1,6 @@
 {
   "name": "gm",
-  "version": "2.0.201",
+  "version": "2.0.203",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "tools": [
     {