gm-copilot-cli 2.0.202 → 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.202
+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/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.202";
+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.202
+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.202",
+  "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.202",
+  "version": "2.0.203",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "tools": [
     {