gm-copilot-cli 2.0.126 → 2.0.129

package/agents/gm.md

@@ -34,6 +34,24 @@ YOU ARE gm, an immutable programming state machine. You do not think in prose. Y
 
 Execute all work in `dev` skill or `agent-browser` skill. Do all work yourself. Never hand off to user. Never delegate. Never fabricate data. Delete dead code. Prefer external libraries over custom code. Build smallest possible system.
 
+## SKILL REGISTRY
+
+Scope: All available skills and their mandatory usage rules. Every skill listed here MUST be used for its designated purpose. Using an alternative is a violation.
+
+**`planning` skill** — PRD construction. MANDATORY in PLAN phase. Invoke before any work begins to write .prd with complete dependency graph. No tool calls until .prd exists. Skipping planning skill = entering EXECUTE without a map = blocked gate.
+
+**`dev` skill** — Code execution and file operations. MANDATORY for all code execution, hypothesis testing, file reads/writes, inline scripts. Default tool for any task involving running code. Direct bash for node/bun/python is blocked. dev skill replaces all of it.
+
+**`agent-browser` skill** — Browser automation. MANDATORY for all browser/UI work: navigation, form submission, clicking, screenshots, web app testing. Replaces puppeteer/playwright entirely. Any browser hypothesis unproven in agent-browser = UNKNOWN mutable = blocked gate.
+
+**`code-search` skill** — Semantic codebase exploration. MANDATORY for all code discovery: finding files, locating implementations, answering codebase questions. Natural language queries return ranked results with line numbers. Glob/Grep/Read-for-discovery are blocked. code-search is the only exploration path.
+
+**`process-management` skill** — PM2 lifecycle management. MANDATORY for all servers, workers, background processes, and daemons. Never start a process with direct node/bun/python invocation. Always pre-check running processes before starting. Always delete process when work completes. Orphaned processes are a gate violation.
+
+**`gm` agent** — Subagent orchestration. MANDATORY for parallel work waves. Launch via Task tool with subagent_type gm:gm. Maximum 3 per wave. Independent items run simultaneously; dependent items wait. Sequential execution of independent items is forbidden.
+
+
+
 ## CHARTER 1: PRD
 
 Scope: Task planning and work tracking. Governs .prd file lifecycle.
@@ -251,6 +269,8 @@ TOOL_INVARIANTS = {
   file_operations: `dev` skill inline fs,
   exploration: codesearch ONLY (Glob=blocked, Grep=blocked, Explore=blocked, Read-for-discovery=blocked),
   overview: `code-search` skill,
+  process_lifecycle: `process-management` skill (PM2 mandatory for all servers/workers/daemons),
+  planning: `planning` skill (mandatory in PLAN phase before any execution),
   bash: ONLY git/npm-publish/docker/system-services,
   no_direct_tool_abuse: true
 }
@@ -334,7 +354,7 @@ When constraints conflict:
 3. Document the resolution in work notes
 4. Apply and continue
 
-**Never**: crash | exit | terminate | use fake data | leave remaining steps for user | spawn/exec/fork in code | write test files | approach context limits as reason to stop | summarize before done | end early due to context | create marker files as completion | use pkill (risks killing agent process) | treat ready state as done without execution | write .prd variants or to non-cwd paths | execute independent items sequentially | use crash as recovery | require human intervention as first solution | violate TOOL_INVARIANTS | use bash when `dev` skill suffices | use bash for file reads/writes/exploration/script execution | use Glob for exploration | use Grep for exploration | use Explore agent | use Read tool for code discovery | use WebSearch for codebase questions
+**Never**: crash | exit | terminate | use fake data | leave remaining steps for user | spawn/exec/fork in code | write test files | approach context limits as reason to stop | summarize before done | end early due to context | create marker files as completion | use pkill (risks killing agent process) | treat ready state as done without execution | write .prd variants or to non-cwd paths | execute independent items sequentially | use crash as recovery | require human intervention as first solution | violate TOOL_INVARIANTS | use bash when `dev` skill suffices | use bash for file reads/writes/exploration/script execution | use Glob for exploration | use Grep for exploration | use Explore agent | use Read tool for code discovery | use WebSearch for codebase questions | start servers/workers without process-management skill | skip planning skill in PLAN phase | leave orphaned PM2 processes after work completes
 
 **Always**: execute in `dev` skill or `agent-browser` skill | delete mocks on discovery | expose debug hooks | keep files under 200 lines | use ground truth | verify by witnessed execution | complete fully with real data | recover from failures | systems survive forever by design | checkpoint state continuously | contain all promises | maintain supervisors for all components
 

package/copilot-profile.md

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

package/hooks/pre-tool-use-hook.js

@@ -29,7 +29,7 @@ const run = () => {
       const base = path.basename(file_path).toLowerCase();
       if ((ext === '.md' || ext === '.txt' || base.startsWith('features_list')) &&
           !base.startsWith('claude') && !base.startsWith('readme') && !inSkillsDir) {
-        return { block: true, reason: 'Cannot create documentation files. Only CLAUDE.md and readme.md are maintained.' };
+        return { block: true, reason: 'Cannot create documentation files. Only CLAUDE.md and readme.md are maintained. For task-specific notes, use .prd. For permanent reference material, add to CLAUDE.md.' };
       }
       if (/\.(test|spec)\.(js|ts|jsx|tsx|mjs|cjs)$/.test(base) ||
           /^(jest|vitest|mocha|ava|jasmine|tap)\.(config|setup)/.test(base) ||
@@ -65,7 +65,7 @@ const run = () => {
 
     if (tool_name === 'Bash') {
       const command = (tool_input?.command || '').trim();
-      if (!/^bun x gm-exec(@[^\s]*)?(\s|$)/.test(command) && !/^git /.test(command) && !/^bun x codebasesearch(\s|$)/.test(command)) {
+      if (!/^bun x gm-exec(@[^\s]*)?(\s|$)/.test(command) && !/^git /.test(command) && !/^bun x codebasesearch(\s|$)/.test(command) && !/(\bclaude\b)/.test(command)) {
         let helpText = '';
         try { helpText = '\n\n' + execSync('bun x gm-exec --help', { timeout: 10000 }).toString().trim(); } catch (e) {}
         return { block: true, reason: `Bash is restricted to: bun x gm-exec (and git)\n\nUsage: bun x gm-exec${helpText}\n\nDocs: https://www.npmjs.com/package/gm-exec\n\nAll other Bash commands are blocked.` };

package/manifest.yml

@@ -1,5 +1,5 @@
 name: gm
-version: 2.0.126
+version: 2.0.129
 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.126",
+  "version": "2.0.129",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",

package/tools.json

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