hool-cli 0.7.0 → 0.7.1

package/dist/e2e.test.js

@@ -0,0 +1,161 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const exec = promisify(execFile);
+let tmpDir;
+const cliPath = path.resolve(import.meta.dirname, '..', '..', 'cli');
+beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'hool-e2e-'));
+});
+afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+async function runHool(args) {
+    return exec('npx', ['tsx', path.join(cliPath, 'src/index.ts'), ...args], {
+        cwd: tmpDir,
+        env: { ...process.env, NO_COLOR: '1' },
+    });
+}
+describe('hool init (e2e)', () => {
+    it('scaffolds a web-app project with all flags', async () => {
+        const { stdout } = await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        expect(stdout).toContain('HOOL initialized');
+        // Verify structure
+        const ops = await fs.readdir(path.join(tmpDir, '.hool/operations'));
+        expect(ops).toContain('current-phase.md');
+        expect(ops).toContain('task-board.md');
+        expect(ops).toContain('governor-rules.md');
+        // Verify phase dirs
+        await expect(fs.stat(path.join(tmpDir, '.hool/phases/03-design/cards'))).resolves.toBeTruthy();
+        await expect(fs.stat(path.join(tmpDir, '.hool/phases/05-fe-scaffold/pages'))).resolves.toBeTruthy();
+        // Verify memory dirs
+        const memAgents = await fs.readdir(path.join(tmpDir, '.hool/memory'));
+        expect(memAgents).toHaveLength(8);
+        // Verify CLAUDE.md
+        const claudeMd = await fs.readFile(path.join(tmpDir, 'CLAUDE.md'), 'utf-8');
+        expect(claudeMd).toContain('<!-- HOOL:START -->');
+        expect(claudeMd).toContain('<!-- HOOL:END -->');
+        // Verify agents.json
+        const agents = JSON.parse(await fs.readFile(path.join(tmpDir, '.hool/agents.json'), 'utf-8'));
+        expect(agents).toHaveLength(8);
+        // Verify mcps.json
+        const mcps = JSON.parse(await fs.readFile(path.join(tmpDir, '.hool/mcps.json'), 'utf-8'));
+        expect(mcps.domain).toBe('web-app');
+        expect(mcps.servers).toHaveProperty('context7');
+    }, 30000);
+    it('scaffolds a cli-tool project skipping FE phases', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'cli-tool', '-m', 'interactive']);
+        await expect(fs.access(path.join(tmpDir, '.hool/phases/03-design'))).rejects.toThrow();
+        await expect(fs.access(path.join(tmpDir, '.hool/phases/05-fe-scaffold'))).rejects.toThrow();
+        await expect(fs.stat(path.join(tmpDir, '.hool/phases/06-be-scaffold/services'))).resolves.toBeTruthy();
+    }, 30000);
+    it('scaffolds full-hool mode', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'full-hool']);
+        const phase = await fs.readFile(path.join(tmpDir, '.hool/operations/current-phase.md'), 'utf-8');
+        expect(phase).toContain('full-hool');
+        const profile = await fs.readFile(path.join(tmpDir, '.hool/phases/00-init/project-profile.md'), 'utf-8');
+        expect(profile).toContain('full-hool');
+    }, 30000);
+    it('copies per-role settings to .hool/settings/', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const settingsDir = path.join(tmpDir, '.hool/settings');
+        const files = await fs.readdir(settingsDir);
+        // Should have role settings but NOT claude-settings.json
+        expect(files.some(f => f.endsWith('.json'))).toBe(true);
+        expect(files).not.toContain('claude-settings.json');
+        // Each settings file should be valid JSON
+        for (const f of files) {
+            if (!f.endsWith('.json'))
+                continue;
+            const content = await fs.readFile(path.join(settingsDir, f), 'utf-8');
+            expect(() => JSON.parse(content)).not.toThrow();
+        }
+    }, 30000);
+    it('copies agent definitions to .claude/agents/', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const agentsDir = path.join(tmpDir, '.claude/agents');
+        const files = await fs.readdir(agentsDir);
+        expect(files.length).toBeGreaterThan(0);
+        // All should be .md files
+        expect(files.every(f => f.endsWith('.md'))).toBe(true);
+    }, 30000);
+    it('creates .claude/settings.json with hooks', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const settings = JSON.parse(await fs.readFile(path.join(tmpDir, '.claude/settings.json'), 'utf-8'));
+        expect(settings).toHaveProperty('hooks');
+    }, 30000);
+    it('creates executable hooks', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const hooksDir = path.join(tmpDir, '.hool/hooks');
+        const hooks = await fs.readdir(hooksDir);
+        for (const hook of hooks) {
+            if (!hook.endsWith('.sh'))
+                continue;
+            const stat = await fs.stat(path.join(hooksDir, hook));
+            expect(stat.mode & 0o111).toBeGreaterThan(0);
+        }
+    }, 30000);
+    it('scaffolds for cursor platform', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'cursor', '-t', 'web-app', '-m', 'interactive']);
+        const rules = await fs.readFile(path.join(tmpDir, '.cursor/rules/hool.mdc'), 'utf-8');
+        expect(rules).toContain('HOOL');
+        expect(rules).toContain('Product Lead');
+    }, 30000);
+    it('scaffolds for generic platform', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'generic', '-t', 'web-app', '-m', 'interactive']);
+        const instructions = await fs.readFile(path.join(tmpDir, 'HOOL-INSTRUCTIONS.md'), 'utf-8');
+        expect(instructions).toContain('HOOL');
+    }, 30000);
+});
+describe('hool onboard (e2e)', () => {
+    it('scaffolds onboarding structure', async () => {
+        await runHool(['onboard', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const phase = await fs.readFile(path.join(tmpDir, '.hool/operations/current-phase.md'), 'utf-8');
+        expect(phase).toContain('onboarding');
+        const board = await fs.readFile(path.join(tmpDir, '.hool/operations/task-board.md'), 'utf-8');
+        expect(board).toContain('ONBOARD-001');
+        const profile = await fs.readFile(path.join(tmpDir, '.hool/phases/00-init/project-profile.md'), 'utf-8');
+        expect(profile).toContain('onboarded');
+    }, 30000);
+});
+describe('hool status (e2e)', () => {
+    it('shows status for an initialized project', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const { stdout } = await runHool(['status', '-d', tmpDir]);
+        expect(stdout).toContain('Phase');
+        expect(stdout).toContain('Tasks');
+        expect(stdout).toContain('Bugs');
+    }, 30000);
+    it('shows error for non-HOOL directory', async () => {
+        const { stdout } = await runHool(['status', '-d', tmpDir]);
+        expect(stdout).toContain('Not a HOOL project');
+    }, 30000);
+});
+describe('hool mode (e2e)', () => {
+    it('shows current mode', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const { stdout } = await runHool(['mode', '-d', tmpDir]);
+        expect(stdout).toContain('interactive');
+    }, 30000);
+    it('switches mode from interactive to full-hool', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const { stdout } = await runHool(['mode', 'full-hool', '-d', tmpDir]);
+        expect(stdout).toContain('interactive -> full-hool');
+        const profile = await fs.readFile(path.join(tmpDir, '.hool/phases/00-init/project-profile.md'), 'utf-8');
+        expect(profile).toContain('full-hool');
+    }, 30000);
+    it('reports when already in requested mode', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const { stdout } = await runHool(['mode', 'interactive', '-d', tmpDir]);
+        expect(stdout).toContain('Already in');
+    }, 30000);
+    it('rejects invalid mode', async () => {
+        await runHool(['init', '-d', tmpDir, '-p', 'claude-code', '-t', 'web-app', '-m', 'interactive']);
+        const { stdout } = await runHool(['mode', 'invalid', '-d', tmpDir]);
+        expect(stdout).toContain('Invalid mode');
+    }, 30000);
+});
+//# sourceMappingURL=e2e.test.js.map

package/dist/e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.test.js","sourceRoot":"","sources":["../src/e2e.test.ts"],"names":[],"mappings":"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"}

package/dist/mcps/mcps.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcps/mcps.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, vi } from 'vitest';
+import { MCP_REGISTRY, getRequiredMcps, getRequiredMcpNames } from './registry.js';
+import { checkAndInstallMcps } from './installer.js';
+describe('MCP_REGISTRY', () => {
+    it('contains context7, playwright, deepwiki', () => {
+        expect(MCP_REGISTRY).toHaveProperty('context7');
+        expect(MCP_REGISTRY).toHaveProperty('playwright');
+        expect(MCP_REGISTRY).toHaveProperty('deepwiki');
+    });
+    it('each entry has name, installCommand, configEntry', () => {
+        for (const [key, mcp] of Object.entries(MCP_REGISTRY)) {
+            expect(mcp.name).toBe(key);
+            expect(mcp.installCommand).toBeTruthy();
+            expect(mcp.configEntry).toHaveProperty('command');
+            expect(mcp.configEntry).toHaveProperty('args');
+        }
+    });
+});
+describe('getRequiredMcps', () => {
+    it('returns context7 + deepwiki + playwright for web-app', () => {
+        const mcps = getRequiredMcps('web-app');
+        const names = mcps.map(m => m.name);
+        expect(names).toContain('context7');
+        expect(names).toContain('deepwiki');
+        expect(names).toContain('playwright');
+    });
+    it('returns context7 + deepwiki for cli-tool (no playwright)', () => {
+        const mcps = getRequiredMcps('cli-tool');
+        const names = mcps.map(m => m.name);
+        expect(names).toContain('context7');
+        expect(names).toContain('deepwiki');
+        expect(names).not.toContain('playwright');
+    });
+    it('returns context7 + deepwiki + playwright for browser-game', () => {
+        const mcps = getRequiredMcps('browser-game');
+        const names = mcps.map(m => m.name);
+        expect(names).toContain('playwright');
+    });
+    it('returns context7 + deepwiki for api-only', () => {
+        const mcps = getRequiredMcps('api-only');
+        const names = mcps.map(m => m.name);
+        expect(names).toEqual(['context7', 'deepwiki']);
+    });
+    it('returns McpDefinition objects with full config', () => {
+        const mcps = getRequiredMcps('web-app');
+        for (const mcp of mcps) {
+            expect(mcp).toHaveProperty('name');
+            expect(mcp).toHaveProperty('installCommand');
+            expect(mcp).toHaveProperty('configEntry');
+        }
+    });
+});
+describe('getRequiredMcpNames', () => {
+    it('returns string array of MCP names', () => {
+        const names = getRequiredMcpNames('web-app');
+        expect(names).toEqual(['context7', 'deepwiki', 'playwright']);
+    });
+    it('returns context7 + deepwiki for desktop', () => {
+        expect(getRequiredMcpNames('desktop')).toEqual(['context7', 'deepwiki']);
+    });
+});
+describe('checkAndInstallMcps', () => {
+    function createMockAdapter(installed = new Set()) {
+        return {
+            platform: 'claude-code',
+            injectInstructions: vi.fn(),
+            installMcp: vi.fn(),
+            isMcpInstalled: vi.fn(async (name) => installed.has(name)),
+            getCompletionMessage: vi.fn(() => ''),
+        };
+    }
+    const config = {
+        platform: 'claude-code',
+        projectType: 'cli-tool',
+        projectDir: '/tmp/test',
+        promptsDir: '/tmp/test/prompts',
+        mode: 'interactive',
+    };
+    it('returns already-installed for pre-installed MCPs', async () => {
+        const adapter = createMockAdapter(new Set(['context7', 'deepwiki']));
+        const results = await checkAndInstallMcps(adapter, config);
+        expect(results).toHaveLength(2);
+        expect(results.every(r => r.status === 'already-installed')).toBe(true);
+        expect(adapter.installMcp).not.toHaveBeenCalled();
+    });
+    it('installs missing MCPs', async () => {
+        const adapter = createMockAdapter(new Set(['context7'])); // deepwiki missing
+        const results = await checkAndInstallMcps(adapter, config);
+        const deepwikiResult = results.find(r => r.name === 'deepwiki');
+        expect(deepwikiResult?.status).toBe('installed');
+        expect(adapter.installMcp).toHaveBeenCalledOnce();
+    });
+    it('handles install failure gracefully', async () => {
+        const adapter = createMockAdapter();
+        adapter.installMcp.mockRejectedValue(new Error('Network error'));
+        const results = await checkAndInstallMcps(adapter, config);
+        expect(results.every(r => r.status === 'failed')).toBe(true);
+        expect(results[0].error).toBe('Network error');
+    });
+    it('processes all required MCPs for project type', async () => {
+        const webConfig = { ...config, projectType: 'web-app' };
+        const adapter = createMockAdapter();
+        const results = await checkAndInstallMcps(adapter, webConfig);
+        const names = results.map(r => r.name);
+        expect(names).toContain('context7');
+        expect(names).toContain('deepwiki');
+        expect(names).toContain('playwright');
+    });
+});
+//# sourceMappingURL=mcps.test.js.map

package/dist/mcps/mcps.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcps.test.js","sourceRoot":"","sources":["../../src/mcps/mcps.test.ts"],"names":[],"mappings":"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"}

package/hooks/inject-pl-context.sh

@@ -4,6 +4,24 @@
 # Outputs JSON with additionalContext to remind the PL of its identity and state
 
 PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo '.')"
+METRICS_FILE="$PROJECT_ROOT/.hool/operations/metrics.md"
+
+# Ensure metrics file exists with default counters
+if [ ! -f "$METRICS_FILE" ]; then
+  mkdir -p "$(dirname "$METRICS_FILE")"
+  cat > "$METRICS_FILE" <<'EOF'
+# HOOL Metrics
+- Agent dispatches: 0
+- Tool calls: 0
+- User prompts: 0
+EOF
+fi
+
+# Increment user prompts counter
+CURRENT_PROMPTS=$(grep -o 'User prompts: [0-9]*' "$METRICS_FILE" | grep -o '[0-9]*')
+CURRENT_PROMPTS=${CURRENT_PROMPTS:-0}
+NEXT_PROMPTS=$((CURRENT_PROMPTS + 1))
+sed -i '' "s/User prompts: ${CURRENT_PROMPTS}/User prompts: ${NEXT_PROMPTS}/" "$METRICS_FILE"
 
 # Read current phase
 PHASE="unknown"
@@ -80,10 +98,11 @@ if [ -f "$PROJECT_ROOT/.hool/operations/inconsistencies.md" ]; then
   INCONSISTENCIES=$(grep -c '^- ' "$PROJECT_ROOT/.hool/operations/inconsistencies.md" 2>/dev/null | tr -d '\n' || echo "0")
 fi
 
-# Check governor dispatch count
+# Check governor dispatch count from metrics.md
 DISPATCH_COUNT=0
-if [ -f "$PROJECT_ROOT/.hool/metrics/dispatch-count.txt" ]; then
-  DISPATCH_COUNT=$(cat "$PROJECT_ROOT/.hool/metrics/dispatch-count.txt" 2>/dev/null | tr -d '\n' || echo "0")
+if [ -f "$METRICS_FILE" ]; then
+  DISPATCH_COUNT=$(grep -o 'Agent dispatches: [0-9]*' "$METRICS_FILE" | grep -o '[0-9]*' || echo "0")
+  DISPATCH_COUNT=${DISPATCH_COUNT:-0}
 fi
 GOVERNOR_DUE=""
 if [ "$DISPATCH_COUNT" -gt 0 ] && [ $(( DISPATCH_COUNT % 3 )) -ge 2 ]; then

package/hooks/suggest-compact.sh

@@ -5,27 +5,23 @@
 #       Strategic compaction between phases preserves better context.
 
 PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo '.')"
-METRICS_DIR="$PROJECT_ROOT/.hool/metrics"
-mkdir -p "$METRICS_DIR"
-
-COUNTER_FILE="$METRICS_DIR/tool-call-count.txt"
+METRICS_FILE="$PROJECT_ROOT/.hool/operations/metrics.md"
 THRESHOLD="${HOOL_COMPACT_THRESHOLD:-50}"
 
-# Read and increment counter
-CURRENT=$(cat "$COUNTER_FILE" 2>/dev/null || echo "0")
-NEXT=$((CURRENT + 1))
-echo "$NEXT" > "$COUNTER_FILE"
+# Read tool call count from metrics.md (format: "- Tool calls: N")
+COUNT=$(grep -o 'Tool calls: [0-9]*' "$METRICS_FILE" 2>/dev/null | grep -o '[0-9]*')
+COUNT="${COUNT:-0}"
 
 # Suggest at threshold
-if [ "$NEXT" -eq "$THRESHOLD" ]; then
+if [ "$COUNT" -eq "$THRESHOLD" ]; then
   echo "HOOL: ${THRESHOLD} tool calls reached. Consider running /compact if you're between phases or tasks." >&2
 fi
 
 # Suggest every 25 calls after threshold
-if [ "$NEXT" -gt "$THRESHOLD" ]; then
-  OVER=$((NEXT - THRESHOLD))
+if [ "$COUNT" -gt "$THRESHOLD" ]; then
+  OVER=$((COUNT - THRESHOLD))
   if [ $((OVER % 25)) -eq 0 ]; then
-    echo "HOOL: ${NEXT} tool calls. Good checkpoint for /compact if context feels stale." >&2
+    echo "HOOL: ${COUNT} tool calls. Good checkpoint for /compact if context feels stale." >&2
   fi
 fi
 

package/hooks/track-prompt-count.sh

@@ -1,39 +1,41 @@
 #!/bin/bash
-# Hook: Track prompt/tool count and trigger governor every 3 dispatches
+# Hook: Track tool calls + agent dispatches in metrics.md, trigger governor every 3 dispatches
 # Type: PostToolUse
 # Outputs JSON with additionalContext when governor should run
 
 PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo '.')"
-METRICS_DIR="$PROJECT_ROOT/.hool/metrics"
-mkdir -p "$METRICS_DIR"
-
-COUNTER_FILE="$METRICS_DIR/prompt-count.log"
-SESSION_FILE="$METRICS_DIR/current-session.txt"
-DISPATCH_FILE="$METRICS_DIR/dispatch-count.txt"
-
-# Get or create session ID
-if [ ! -f "$SESSION_FILE" ]; then
-  echo "session-$(date +%Y%m%d-%H%M%S)" > "$SESSION_FILE"
+METRICS_FILE="$PROJECT_ROOT/.hool/operations/metrics.md"
+
+# Ensure metrics file exists with default counters
+if [ ! -f "$METRICS_FILE" ]; then
+  mkdir -p "$(dirname "$METRICS_FILE")"
+  cat > "$METRICS_FILE" <<'EOF'
+# HOOL Metrics
+- Agent dispatches: 0
+- Tool calls: 0
+- User prompts: 0
+EOF
 fi
 
-TIMESTAMP=$(date +"%Y-%m-%d %H:%M:%S")
-
-# Append to log
-echo "$TIMESTAMP | tool-call" >> "$COUNTER_FILE"
+# Increment tool calls counter
+CURRENT_TOOLS=$(grep -o 'Tool calls: [0-9]*' "$METRICS_FILE" | grep -o '[0-9]*')
+CURRENT_TOOLS=${CURRENT_TOOLS:-0}
+NEXT_TOOLS=$((CURRENT_TOOLS + 1))
+sed -i '' "s/Tool calls: ${CURRENT_TOOLS}/Tool calls: ${NEXT_TOOLS}/" "$METRICS_FILE"
 
-# Track dispatch count (Agent tool calls specifically)
-# Read from stdin to check tool name
+# Read stdin to check tool name
 INPUT=$(cat)
 TOOL_NAME=$(echo "$INPUT" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"tool_name"[[:space:]]*:[[:space:]]*"//' | sed 's/"$//')
 
 if [ "$TOOL_NAME" = "Agent" ]; then
-  # Increment dispatch counter
-  CURRENT=$(cat "$DISPATCH_FILE" 2>/dev/null || echo "0")
-  NEXT=$((CURRENT + 1))
-  echo "$NEXT" > "$DISPATCH_FILE"
+  # Increment agent dispatches counter
+  CURRENT_DISPATCHES=$(grep -o 'Agent dispatches: [0-9]*' "$METRICS_FILE" | grep -o '[0-9]*')
+  CURRENT_DISPATCHES=${CURRENT_DISPATCHES:-0}
+  NEXT_DISPATCHES=$((CURRENT_DISPATCHES + 1))
+  sed -i '' "s/Agent dispatches: ${CURRENT_DISPATCHES}/Agent dispatches: ${NEXT_DISPATCHES}/" "$METRICS_FILE"
 
   # Check if divisible by 3
-  if [ $((NEXT % 3)) -eq 0 ]; then
+  if [ $((NEXT_DISPATCHES % 3)) -eq 0 ]; then
     # Output JSON to inject governor reminder into conversation
     cat <<'JSONEOF'
 {

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "hool-cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Agent-Driven SDLC — scaffold and configure HOOL for any project",
   "bin": {
     "hool": "./dist/index.js"
   },
   "scripts": {
     "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "dev": "tsx src/index.ts",
     "prepublishOnly": "npm run build && rm -rf ./prompts ./agents ./rules ./hooks ./settings && cp -R ../hool-mini/prompts ./prompts && cp -R ../hool-mini/agents ./agents && cp -R ../hool-mini/rules ./rules && cp -R ../hool-mini/hooks ./hooks && cp -R ../hool-mini/settings ./settings"
   },
@@ -27,7 +29,8 @@
   "devDependencies": {
     "@types/node": "^20.11.0",
     "tsx": "^4.7.0",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "vitest": "^4.0.18"
   },
   "type": "module",
   "license": "MIT",
@@ -35,7 +38,14 @@
     "type": "git",
     "url": "git+https://github.com/the-wise-agents/hool.git"
   },
-  "keywords": ["agent", "sdlc", "ai", "cli", "scaffold", "autonomous"],
+  "keywords": [
+    "agent",
+    "sdlc",
+    "ai",
+    "cli",
+    "scaffold",
+    "autonomous"
+  ],
   "engines": {
     "node": ">=18"
   }

package/prompts/agents/05-fe-tech-lead.md

@@ -156,6 +156,9 @@ How logging works. Where logs go. How to read them.
    - Code inconsistency found -> write to .hool/operations/inconsistencies.md with INC-XXX format
    - Doc inconsistency found (spec says X, contract says Y) -> escalate to Product Lead via .hool/operations/inconsistencies.md
 
+## Forbidden Actions
+- NEVER run git commands (add, commit, push, etc.) — the Product Lead commits your work after you return
+
 ## Work Log
 ### Tags
 - [ARCH-FE] — FE architectural decision -> best-practices.md

package/prompts/agents/06-be-tech-lead.md

@@ -177,6 +177,9 @@ Order matters. List in execution order:
    - Code inconsistency found -> write to .hool/operations/inconsistencies.md with INC-XXX format
    - Doc inconsistency found (spec says X, contract says Y) -> escalate to Product Lead via .hool/operations/inconsistencies.md
 
+## Forbidden Actions
+- NEVER run git commands (add, commit, push, etc.) — the Product Lead commits your work after you return
+
 ## Work Log
 ### Tags
 - [ARCH-BE] — BE architectural decision -> best-practices.md

package/prompts/agents/08-be-dev.md

@@ -58,7 +58,7 @@ If you believe your own process or rules should change based on experience, esca
 5. **Logs**: Every request, DB query, and error gets a log statement.
 6. **Contracts**: Your API responses MUST match .hool/phases/04-architecture/contracts/ exactly. Field names, types, status codes — zero deviation.
 7. **Schema**: Your queries MUST work with .hool/phases/04-architecture/schema.md. Never modify schema without logging an inconsistency.
-8. **Small commits**: Each task = one logical unit of work.
+8. **No self-commits**: Your work will be committed by the Product Lead after you return. Focus on the implementation, not version control.
 9. **Consistency gate**: Before implementing, cross-check your task against contracts, schema, and spec. If you find ANY inconsistency between docs, DO NOT proceed — log to .hool/operations/inconsistencies.md.
 
 ## Test Execution Requirement (MANDATORY)
@@ -133,6 +133,9 @@ logger.info('query result:', result)    // log the shape, not the data (PII risk
 - Need a schema change -> DON'T make it. Log to .hool/operations/inconsistencies.md for BE Tech Lead to review
 - Architecture seems wrong -> DON'T change it. Log to .hool/operations/inconsistencies.md for BE Tech Lead to review
 
+## Forbidden Actions
+- NEVER run git commands (add, commit, push, etc.) — the Product Lead commits your work after you return
+
 ## Work Log
 ### Tags
 - [BE-IMPL] — endpoint/service implemented

package/prompts/agents/08-fe-dev.md

@@ -56,7 +56,7 @@ If you believe your own process or rules should change based on experience, esca
 5. **Logs**: Every significant user action and API call gets a log statement.
 6. **Design fidelity**: Your UI MUST match .hool/phases/03-design/cards/. Compare visually.
 7. **Contracts**: Your API calls MUST use the shapes from .hool/phases/04-architecture/contracts/ exactly.
-8. **Small commits**: Each task = one logical unit of work.
+8. **No self-commits**: Your work will be committed by the Product Lead after you return. Focus on the implementation, not version control.
 9. **Consistency gate**: Before implementing, cross-check your task against contracts, design cards, and spec. If you find ANY inconsistency between docs, DO NOT proceed — log to .hool/operations/inconsistencies.md.
 
 ## Test Execution Requirement (MANDATORY)
@@ -122,6 +122,9 @@ logger.info('useEffect fired')       // use React DevTools
 - Design seems wrong -> DON'T change design. Log to .hool/operations/inconsistencies.md for FE Tech Lead to review
 - Need a BE endpoint that doesn't exist -> DON'T build it. Log to .hool/operations/inconsistencies.md for FE Tech Lead to review
 
+## Forbidden Actions
+- NEVER run git commands (add, commit, push, etc.) — the Product Lead commits your work after you return
+
 ## Work Log
 ### Tags
 - [FE-IMPL] — component/page implemented

package/prompts/agents/10-qa.md

@@ -264,6 +264,7 @@ Log the score in your work log: `[QA-SCORE] [total]/100 — [verdict]`
 - Don't review code quality. That's the Tech Lead's job.
 - Don't suggest architectural changes.
 - Don't modify source code.
+- Don't run git commands (add, commit, push, etc.) — the Product Lead commits your work after you return.
 
 ## MCP Tools Available
 - playwright: E2E testing, screenshot capture, browser automation

package/prompts/agents/11-forensic.md

@@ -108,6 +108,7 @@ Don't fabricate a root cause. Honesty saves time.
 - Don't apply fixes — document them for devs.
 - Don't refactor surrounding code.
 - Don't make architectural recommendations.
+- Don't run git commands (add, commit, push, etc.) — the Product Lead commits your work after you return.
 
 ## MCP Tools Available
 - playwright: reproduce UI bugs in browser

package/prompts/agents/governor.md

@@ -32,6 +32,7 @@ Agents self-enforce rules, but self-enforcement fails (as observed: Product Lead
 - **NEVER** remove or modify existing entries in `.hool/operations/governor-rules.md` — append only (unless a rule is provably wrong, in which case escalate to human)
 - **NEVER** edit application code (`src/`, `tests/`)
 - **NEVER** modify `.hool/operations/task-board.md` or `.hool/operations/current-phase.md` — that's the Product Lead's job
+- **NEVER** run git commands (add, commit, push, etc.) — the Product Lead commits your work after you return
 
 ## Audit Process